tmk241/mim
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

NS3: Narrow terminal UI and panel grammar #3

New Issue
Closed
opened 2026-06-20 23:28:11 +00:00 by tmk241 · 1 comment
tmk241 commented 2026-06-20 23:28:11 +00:00
Owner
Copy Link
Copy Source

OUTCOME: The terminal client stays usable on narrow iPhone viewports and every auxiliary surface uses one transient panel model instead of desktop splits.

WHY NOW: PRODUCT.md makes narrow viewport awareness central; panels are the UI seam for files, git, diagnostics, LSP, jobs, terminal, and Pi.

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

SLICES:

  • #18 NS3 slice: Add panel stack state to the session protocol
  • #19 NS3 slice: Render editor-or-panel on narrow terminals
  • #20 NS3 slice: Build the shared list/filter/select panel primitive
  • #21 NS3 slice: Show diagnostics, errors, and job status consistently
  • #22 NS3 slice: Add SSH render responsiveness guardrails

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: On a narrow terminal, users can open, filter, select, close, and return from panels without layout overflow or permanent split assumptions.

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 desktop split-first UI, no full window manager, no theming system, no dashboard surface.

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: The terminal client stays usable on narrow iPhone viewports and every auxiliary surface uses one transient panel model instead of desktop splits. WHY NOW: PRODUCT.md makes narrow viewport awareness central; panels are the UI seam for files, git, diagnostics, LSP, jobs, terminal, and Pi. AUTHORITY: PRODUCT.md; req: ui/001-002; req: session/003 SLICES: - [x] #18 NS3 slice: Add panel stack state to the session protocol - [x] #19 NS3 slice: Render editor-or-panel on narrow terminals - [x] #20 NS3 slice: Build the shared list/filter/select panel primitive - [x] #21 NS3 slice: Show diagnostics, errors, and job status consistently - [x] #22 NS3 slice: Add SSH render responsiveness guardrails 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: On a narrow terminal, users can open, filter, select, close, and return from panels without layout overflow or permanent split assumptions. 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 desktop split-first UI, no full window manager, no theming system, no dashboard surface. 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
tmk241 commented 2026-06-21 00:55:23 +00:00
Author
Owner
Copy Link
Copy Source

NS3 complete.

Children closed:

  • #18 Add panel stack state to the session protocol
  • #19 Render editor-or-panel on narrow terminals
  • #20 Build the shared list/filter/select panel primitive
  • #21 Show diagnostics, errors, and job status consistently
  • #22 Add SSH render responsiveness guardrails

Proof/evidence:

  • zig build test: pass
  • zig build: pass
  • zig build run -- --help: pass
  • redgate lint / redgate health: pass
  • Narrow terminal UI now has protocol/session panel state, editor-or-panel rendering, shared generic list/filter/select primitive, recoverable status/error/empty presentation, and deterministic render diagnostics/guardrails.

Boundary held: no concrete file/git/LSP/job/Pi panels, desktop split-first UI, telemetry, hosted reporting, or broad benchmark suite added.

NS3 complete. Children closed: - #18 Add panel stack state to the session protocol - #19 Render editor-or-panel on narrow terminals - #20 Build the shared list/filter/select panel primitive - #21 Show diagnostics, errors, and job status consistently - #22 Add SSH render responsiveness guardrails Proof/evidence: - `zig build test`: pass - `zig build`: pass - `zig build run -- --help`: pass - `redgate lint` / `redgate health`: pass - Narrow terminal UI now has protocol/session panel state, editor-or-panel rendering, shared generic list/filter/select primitive, recoverable status/error/empty presentation, and deterministic render diagnostics/guardrails. Boundary held: no concrete file/git/LSP/job/Pi panels, desktop split-first UI, telemetry, hosted reporting, or broad benchmark suite added.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
goal
Issue has a Pi goal contract
 northstar
Parent outcome for v1 product work
 ready-for-agent
Scoped and unblocked for agent implementation
 slice
Executable vertical child issue
No Label goal northstar
Milestone
No items
No Milestone v1
Projects
Clear projects
No project
Assignees
Clear assignees
tmk241
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tmk241/mim#3
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?