NS10 slice: Gate terminal E2E in the developer verification path #72

Closed
opened 2026-06-21 14:50:34 +00:00 by tmk241 · 1 comment
Owner

OBJECTIVE: Make the completed browser-terminal E2E suite part of the repo’s documented verification path with clear local commands, artifact retention, runtime budget, and failure triage guidance.

AUTHORITY: Parent #65; AGENTS.md verification section; REQUIREMENTS.md req: testing/001-004 and governance/004; build.zig verification commands.

AGENT AUTHORITY:

  • Delivery authority: local-commit
  • Tracker authority: this issue may be commented and closed when acceptance passes; comment/update parent #65.
  • Handoff state: committed clean, tracker commented/closed.

PARENT: #65 NS10 via explicit parent link and parent checklist.

SCOPE: build steps, docs/AGENTS.md verification wording if needed, artifact path/reporting, local/CI-friendly command behavior.

BOUNDARIES:

  • Do not require cloud services.
  • Do not make slow/flaky screenshot tests mandatory for every tiny unit-test run if a separate explicit command is more stable.
  • Do not replace real iPhone dogfood where tracker acceptance requires it.

REGRESSION CLASS: catches process regressions where E2E exists but is not run, produces dirty artifacts, times out unpredictably, or lacks actionable failure triage.

EVIDENCE ARTIFACTS: clean-tree before/after receipt, terminal-e2e command receipt, artifact directory listing, failure-output sample or documented format, and canonical gate receipts.

REQUIREMENT IMPACT: requires authority attention because terminal-e2e may become a canonical verification command; update AGENTS.md and requirement authority consistently if adopted as durable governance.

ACCEPTANCE:

  • Repo documents exactly when to run zig build terminal-e2e relative to zig build test, zig build v1-smoke, and install verification.
  • The command has a predictable time budget and clean failure output with artifact paths.
  • Artifacts are written outside tracked source or under ignored build output; generated artifacts do not dirty a clean tree.
  • A final local run demonstrates terminal-e2e plus canonical checks on a clean tree.
  • Parent #65 can be closed only after all child slices are closed and this gate proves the suite is usable by future agents.

VERIFICATION:

  • git status --short --untracked-files=all before/after terminal-e2e shows no unintended tracked/untracked artifacts.
  • zig build terminal-e2e
  • zig build test
  • zig build v1-smoke
  • zig build --prefix /tmp/mim-install verify-install-code
  • redgate list /opt/repositories/mim/REQUIREMENTS.md && redgate lint /opt/repositories/mim/REQUIREMENTS.md && redgate health /opt/repositories/mim/REQUIREMENTS.md

BLOCKERS: depends on meaningful terminal-e2e scenarios from prior NS10 slices.

SLICE_CONTRACT:
objective: Document and gate terminal-e2e as a reliable developer verification command.
authority: #65, AGENTS.md, REQUIREMENTS.md testing/governance rows.
acceptance: terminal-e2e is documented, bounded, artifact-safe, and run with canonical gates on clean tree.
verification: terminal-e2e, canonical build/test/install/redgate gates, clean-tree artifact check.
non_goals: cloud CI, replacing real iPhone dogfood, forcing slow tests into every unit run.
blockers: useful terminal-e2e scenarios exist.

OBJECTIVE: Make the completed browser-terminal E2E suite part of the repo’s documented verification path with clear local commands, artifact retention, runtime budget, and failure triage guidance. AUTHORITY: Parent #65; AGENTS.md verification section; REQUIREMENTS.md req: testing/001-004 and governance/004; build.zig verification commands. AGENT AUTHORITY: - Delivery authority: local-commit - Tracker authority: this issue may be commented and closed when acceptance passes; comment/update parent #65. - Handoff state: committed clean, tracker commented/closed. PARENT: #65 NS10 via explicit parent link and parent checklist. SCOPE: build steps, docs/AGENTS.md verification wording if needed, artifact path/reporting, local/CI-friendly command behavior. BOUNDARIES: - Do not require cloud services. - Do not make slow/flaky screenshot tests mandatory for every tiny unit-test run if a separate explicit command is more stable. - Do not replace real iPhone dogfood where tracker acceptance requires it. REGRESSION CLASS: catches process regressions where E2E exists but is not run, produces dirty artifacts, times out unpredictably, or lacks actionable failure triage. EVIDENCE ARTIFACTS: clean-tree before/after receipt, terminal-e2e command receipt, artifact directory listing, failure-output sample or documented format, and canonical gate receipts. REQUIREMENT IMPACT: requires authority attention because terminal-e2e may become a canonical verification command; update AGENTS.md and requirement authority consistently if adopted as durable governance. ACCEPTANCE: - Repo documents exactly when to run `zig build terminal-e2e` relative to `zig build test`, `zig build v1-smoke`, and install verification. - The command has a predictable time budget and clean failure output with artifact paths. - Artifacts are written outside tracked source or under ignored build output; generated artifacts do not dirty a clean tree. - A final local run demonstrates terminal-e2e plus canonical checks on a clean tree. - Parent #65 can be closed only after all child slices are closed and this gate proves the suite is usable by future agents. VERIFICATION: - `git status --short --untracked-files=all` before/after terminal-e2e shows no unintended tracked/untracked artifacts. - `zig build terminal-e2e` - `zig build test` - `zig build v1-smoke` - `zig build --prefix /tmp/mim-install verify-install-code` - `redgate list /opt/repositories/mim/REQUIREMENTS.md && redgate lint /opt/repositories/mim/REQUIREMENTS.md && redgate health /opt/repositories/mim/REQUIREMENTS.md` BLOCKERS: depends on meaningful terminal-e2e scenarios from prior NS10 slices. SLICE_CONTRACT: objective: Document and gate terminal-e2e as a reliable developer verification command. authority: #65, AGENTS.md, REQUIREMENTS.md testing/governance rows. acceptance: terminal-e2e is documented, bounded, artifact-safe, and run with canonical gates on clean tree. verification: terminal-e2e, canonical build/test/install/redgate gates, clean-tree artifact check. non_goals: cloud CI, replacing real iPhone dogfood, forcing slow tests into every unit run. blockers: useful terminal-e2e scenarios exist.
tmk241 added the slice label 2026-06-21 14:50:34 +00:00
Author
Owner

Implemented in bdc9de0 (Document terminal E2E verification gate).

What changed:

  • AGENTS.md now names zig build terminal-e2e as the canonical terminal/browser E2E check for terminal UI, input, panels, KEYMAP workflow routing, LSP/tool reachability, viewport/chrome/color behavior, and NS10 work.
  • tools/TERMINAL_E2E.md now documents when to run the gate, expected runtime target, artifact location, failure triage order, semantic artifacts, key budget handling, and clean-tree expectations.

Clean-tree verification after commit:

  • git status --short --untracked-files=all before gates: clean
  • zig build terminal-e2e
  • zig build test
  • zig build
  • zig build v1-smoke
  • zig build run -- --help
  • zig build --prefix /tmp/mim-install verify-install-code
  • redgate list /opt/repositories/mim/REQUIREMENTS.md && redgate lint /opt/repositories/mim/REQUIREMENTS.md && redgate health /opt/repositories/mim/REQUIREMENTS.md
  • git status --short --untracked-files=all after terminal E2E artifacts: clean

Evidence:

  • .zig-cache/terminal-e2e/matrix.tsv lists the current 18-scenario terminal matrix, including multi-file and LSP-assisted coding rows plus key budgets.
  • All generated terminal E2E artifacts remain under ignored .zig-cache/terminal-e2e/.
Implemented in `bdc9de0` (`Document terminal E2E verification gate`). What changed: - `AGENTS.md` now names `zig build terminal-e2e` as the canonical terminal/browser E2E check for terminal UI, input, panels, KEYMAP workflow routing, LSP/tool reachability, viewport/chrome/color behavior, and NS10 work. - `tools/TERMINAL_E2E.md` now documents when to run the gate, expected runtime target, artifact location, failure triage order, semantic artifacts, key budget handling, and clean-tree expectations. Clean-tree verification after commit: - `git status --short --untracked-files=all` before gates: clean ✅ - `zig build terminal-e2e` ✅ - `zig build test` ✅ - `zig build` ✅ - `zig build v1-smoke` ✅ - `zig build run -- --help` ✅ - `zig build --prefix /tmp/mim-install verify-install-code` ✅ - `redgate list /opt/repositories/mim/REQUIREMENTS.md && redgate lint /opt/repositories/mim/REQUIREMENTS.md && redgate health /opt/repositories/mim/REQUIREMENTS.md` ✅ - `git status --short --untracked-files=all` after terminal E2E artifacts: clean ✅ Evidence: - `.zig-cache/terminal-e2e/matrix.tsv` lists the current 18-scenario terminal matrix, including multi-file and LSP-assisted coding rows plus key budgets. - All generated terminal E2E artifacts remain under ignored `.zig-cache/terminal-e2e/`.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tmk241/mim#72