NS4: Repository workbench #4

Closed
opened 2026-06-20 23:28:11 +00:00 by tmk241 · 1 comment
Owner

OUTCOME: A mobile SSH session can navigate files, search code, inspect git state, run builds/tests, and use a terminal escape hatch without leaving the editor workflow.

WHY NOW: PRODUCT.md says real coding means repo awareness, build feedback, git, file tree/search, and terminal access without thumb-killing context switches.

AUTHORITY: PRODUCT.md; req: repo/001-002; req: ui/002

SLICES:

  • #23 NS4 slice: Add gitignore-aware file picker and tree
  • #24 NS4 slice: Add project text search with jump-to-result
  • #25 NS4 slice: Add read-only git status and diff panels
  • #26 NS4 slice: Add build/test job output panel
  • #27 NS4 slice: Add one terminal escape-hatch panel

MEMBERSHIP MECHANISM: Gitea fallback via this parent checklist plus explicit parent link in each child issue body.

AGENT AUTHORITY DEFAULTS:

  • Delivery authority: local-commit
  • Tracker authority: child issues may be commented and closed when their acceptance passes; this parent may be commented as children complete.
  • Handoff state: committed clean, tracker commented/closed for completed child slices.

BLOCKERS: none

PROOF: In a fixture repo, a user can find ignored/non-ignored files intentionally, search text, inspect changed files/diffs, run a failing build/test, jump to a parseable error, and run one shell command via a panel.

TEST STANDARD: Each child slice must carry its test weight: regular tests prove the intended payoff works, and adversarial tests cover realistic failure, boundary, or regression cases. Prefer protocol/headless/replay/fixture tests over brittle UI snapshots unless rendering behavior is the claim. See req: testing/001 through req: testing/004.

NON-GOALS: No hidden git mutations, no commit/stage/reset workflow for v1 unless separately proven, no tmux replacement, no project-management features.

GOAL: Implement this Northstar by completing its linked child slices without leaving the product/refusal boundary in PRODUCT.md. Close this parent only when every child is closed and the PROOF above is demonstrated.

OUTCOME: A mobile SSH session can navigate files, search code, inspect git state, run builds/tests, and use a terminal escape hatch without leaving the editor workflow. WHY NOW: PRODUCT.md says real coding means repo awareness, build feedback, git, file tree/search, and terminal access without thumb-killing context switches. AUTHORITY: PRODUCT.md; req: repo/001-002; req: ui/002 SLICES: - [x] #23 NS4 slice: Add gitignore-aware file picker and tree - [x] #24 NS4 slice: Add project text search with jump-to-result - [x] #25 NS4 slice: Add read-only git status and diff panels - [x] #26 NS4 slice: Add build/test job output panel - [x] #27 NS4 slice: Add one terminal escape-hatch panel MEMBERSHIP MECHANISM: Gitea fallback via this parent checklist plus explicit parent link in each child issue body. AGENT AUTHORITY DEFAULTS: - Delivery authority: local-commit - Tracker authority: child issues may be commented and closed when their acceptance passes; this parent may be commented as children complete. - Handoff state: committed clean, tracker commented/closed for completed child slices. BLOCKERS: none PROOF: In a fixture repo, a user can find ignored/non-ignored files intentionally, search text, inspect changed files/diffs, run a failing build/test, jump to a parseable error, and run one shell command via a panel. TEST STANDARD: Each child slice must carry its test weight: regular tests prove the intended payoff works, and adversarial tests cover realistic failure, boundary, or regression cases. Prefer protocol/headless/replay/fixture tests over brittle UI snapshots unless rendering behavior is the claim. See req: testing/001 through req: testing/004. NON-GOALS: No hidden git mutations, no commit/stage/reset workflow for v1 unless separately proven, no tmux replacement, no project-management features. GOAL: Implement this Northstar by completing its linked child slices without leaving the product/refusal boundary in PRODUCT.md. Close this parent only when every child is closed and the PROOF above is demonstrated.
tmk241 added this to the v1 milestone 2026-06-20 23:28:11 +00:00
tmk241 added the northstargoal labels 2026-06-20 23:28:11 +00:00
Author
Owner

All current NS4 child slices are implemented and closed: #23 file picker/tree, #24 project text search, #25 read-only git panels, #26 explicit job output panel, and #27 terminal escape hatch. Clean-tree verification after final child: zig build test, zig build, zig build run -- --help, redgate lint/health all pass at 2ec9840837.

All current NS4 child slices are implemented and closed: #23 file picker/tree, #24 project text search, #25 read-only git panels, #26 explicit job output panel, and #27 terminal escape hatch. Clean-tree verification after final child: zig build test, zig build, zig build run -- --help, redgate lint/health all pass at 2ec98408372e.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tmk241/mim#4