Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
8c955f9
docs(cli): plan bounded read-only contributor TUI slice
Oct 23, 2026
06e7d3e
docs(cli): reconcile first TUI slice scope and provenance
Oct 23, 2026
bf7e83e
docs(cli): describe bounded contributor terminal workspace
Oct 23, 2026
3560cf9
docs(cli): bound native terminal proof on existing runners
Oct 23, 2026
c064849
docs: tighten native TUI execution and dependency proof plan
Oct 23, 2026
6f2dab2
docs: separate terminal teardown and program-error proof
Oct 23, 2026
f947ae3
docs: assign terminal error evidence to exact test boundaries
Oct 23, 2026
879770c
test(cli): exercise read-only TUI over PTY and public API
Oct 23, 2026
9cec690
docs(cli): reconcile implemented scope and native proof requirements
Oct 23, 2026
1429511
test(cli): revoke TUI reader grant through distinct manager
Oct 23, 2026
e5c63dd
feat(cli): add read-only contributor terminal workbench
Oct 23, 2026
0034598
test(cli): require actor binding on TUI startup retry
Oct 23, 2026
67e9420
Merge remote-tracking branch 'origin/main' into codex/cli-tui-first-s…
Oct 23, 2026
a3c6769
test(cli): verify exact native terminal execution receipts
Oct 23, 2026
d9c5eaf
test(cli): drive native Windows terminal proof with ConPTY
Oct 23, 2026
b9e8ead
Merge remote-tracking branch 'origin/main' into codex/cli-tui-first-s…
Oct 23, 2026
67c3d59
fix(cli): purge session selectors and reconcile terminal proof claims
Oct 23, 2026
f35c6bd
test(cli): verify POSIX SIGTERM restores TUI terminal
Oct 23, 2026
590a4e9
test(cli): report TUI child exit code on premature exit
Oct 23, 2026
bc63320
test(cli): expose numeric terminal restoration differences
Oct 23, 2026
bf037ef
ci(cli): isolate terminal proof without widening test budgets
Oct 23, 2026
1908f47
docs(cli): record exact Darwin terminal observation boundary
Oct 23, 2026
a292251
test(cli): observe Darwin pending input before mode comparison
Oct 23, 2026
e71b786
docs(cli): reconcile terminal regression partition inventory
Oct 23, 2026
1eb0895
ci(cli): group task guide deadline proof with guide contracts
Oct 23, 2026
7dcf522
docs(cli): bound parallel contract proof repair
Oct 23, 2026
a9178a0
ci(cli): run HTTP and API proof in bounded parallel jobs
Oct 23, 2026
19023fb
test(cli): disclose bounded native proof rejection reasons
Oct 23, 2026
e5dc863
Merge branch 'main' into codex/cli-tui-first-slice-plan
abiorh-claw Oct 24, 2026
f1ff451
Merge main preserving catalogue and read-only TUI boundaries
Oct 24, 2026
bb8b145
docs(cli): preserve terminal next boundary after main reconciliation
Oct 24, 2026
00e03e6
docs(cli): reconcile merged catalogue and release prerequisites
Oct 24, 2026
add5bfc
docs(cli): remove pending catalogue wording from scope
Oct 24, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .commitrail/INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ for current product capability.
| [WS-AGENT-001](initiatives/WS-AGENT-001/OVERVIEW.md) | Planned | Neutral document tools plus OpenAI Agents SDK and OmniCoreAgent original-guide qualifications are delivered through the same public API, durable worker, parser and MinIO path. Retain the exact external provider/account and selected-image AWS evidence, then prove the broader hosted Flow contribution journey before deployment claims. |
| [WS-DB-002](initiatives/WS-DB-002/OVERVIEW.md) | Complete | Shared UUIDv7 record generation, native-UUID relationships and fresh v0.1 baseline; natural-owner retry custody and aligned CI/local setup |
| [WS-MCP-002](initiatives/WS-MCP-002/OVERVIEW.md) | Planned | Forty-seven tools through WS-MCP-002-10 cover the original access/setup catalogue plus contributor workspace, contribution evidence and contribution policies; four larger domain batches and assembled release proof remain. |
| [WS-CLI-001](initiatives/WS-CLI-001/OVERVIEW.md) | Planned | Public Go CLI setup, contributor/manager workflows, administrative and operational commands, Finance policies and contribution exports are detailed in the overview; -43 completes the artifact Operator client and proves the connected local unpaid automated-acceptance journey. -44 prepares four native release archives and a gated manual publisher; protected environment and immutable-tag ruleset verification, first tag/publication and public-asset audit remain. Public human-review controls, hosted proof and optional TUI are separate. Current revision context never substitutes for historical evidence. |
| [WS-CLI-001](initiatives/WS-CLI-001/OVERVIEW.md) | Planned | Public Go CLI setup, contributor/manager workflows, administrative and operational commands, Finance policies and contribution exports are detailed in the overview; -43 proves the connected local unpaid automated-acceptance journey. -44 prepares four native release archives and a gated manual publisher; -47 hardens its administrator-bypass guard. Protected release-environment and immutable-tag ruleset configuration/verification, first publication and public-asset audit remain. -46 adds the separate system-reader project catalogue; -48 adds the opt-in read-only contributor TUI. Detailed findings/Evidence remain manual CLI handoffs; TUI writes/management, public human-review controls and hosted proof are separate. Current revision context never substitutes for historical evidence. |
| [WS-ARCH-001](initiatives/WS-ARCH-001/OVERVIEW.md) | Planned | Public admission-backed initial/remediation Submission entry and supported false-policy guide activation are implemented over selected production delivery. New false/pass effects require LIVE REV; a known pre-effect non-live refusal has bounded retry, with exhausted delivery dead-lettered. The [bounded local public/worker drill](initiatives/WS-ARCH-001/planning/PLAN.md#first-complete-contributor-milestone) starts from public guide inputs with recorded inference; hosted operation and live human review remain. |
| [WS-ART-001](initiatives/WS-ART-001/OVERVIEW.md) | Planned | Verified input/output custody, exact-cause replacement and public admission-backed ZIP/Submission entry are delivered. The bounded local public/worker drill passed; hosted operation and setup-fault handling remain separate. |
| [WS-AUTH-001](initiatives/WS-AUTH-001/OVERVIEW.md) | Planned | Exact fixed-router custody, checker remediation and checker retry are delivered. The ART Operator backend prerequisite adds exact system-Operator artifact reads and independently guarded verification retry; WS-CLI-001-43 consumes all nine public ART operations, while hosted S3 proof remains separate. Public entry and supported false-guide activation use current exact AUTH/SQL custody; human decision authority remains later work. |
Expand Down
31 changes: 21 additions & 10 deletions .commitrail/initiatives/WS-CLI-001/OVERVIEW.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,13 @@ integrity metadata and a separately gated manual GitHub Releases publisher;
the environment and immutable tag ruleset remain external prerequisites.
It does not claim a tag, published binary or signed/notarized artifact.

[WS-CLI-001-48](WS-CLI-001-48.md) adds the opt-in read-only contributor
workbench: exact-grant projects, one-page Ready/active Mine/own Submissions,
fresh details and explicit Mine context/intake reads. Detailed findings and
contribution evidence remain inert CLI handoffs. All mutations, management
screens and operation-specific recovery remain separate TUI boundaries; this
interface does not depend on first binary publication or system-wide discovery.

## Current boundary

[WS-CLI-001-26](WS-CLI-001-26.md) adds deliberate draft-guide summary editing
Expand All @@ -66,7 +73,7 @@ and separate guide-bound review/revision policy configuration. The commands
the existing public writes with caller-owned replay keys and policy `If-Match`.
The backend owns manager authorization for new writes, policy semantics, replay and activation;
editing/configuring a guide does not approve or activate it. Other public API
client gaps and the optional TUI remain separate work. Binary distribution's
client gaps and the broader TUI beyond -48 remain separate work. Binary distribution's
workflow is prepared by -44; a protected release run and public-asset audit
remain operational work.

Expand Down Expand Up @@ -316,14 +323,15 @@ that human's credential, not a registered agent identity.

Make every operation complete without a terminal: stable JSON output, safe
errors, exit status, and no required prompts. Add optional terminal assistance
only where it improves an actual workflow. A future `workstream ui` can browse
public queues and evidence when enough of that lifecycle is ready; it must use
the same client operations and never become a second state machine. Prefer
only where it improves an actual workflow. The opt-in `workstream tui` browses
the bounded contributor reads in -48 using the same client operations and never
becomes a second state machine. Further screens require stable public contracts
and their own proof. Prefer
purposeful commands over generating a flag mirror of every OpenAPI route.

Go is the chosen implementation language. Cobra owns command parsing/help and
completion. Bubble Tea is a candidate for a later, bounded TUI change, not a
dependency of the foundation. Do not add Python, TypeScript, or Rust duplicate
completion. The bounded -48 workbench uses Bubble Tea, Bubbles and Lip Gloss;
noninteractive commands retain their existing behavior. Do not add Python, TypeScript, or Rust duplicate
CLIs. Keep the package independent of backend and MCP runtime dependencies.

## Delivered and later boundaries
Expand Down Expand Up @@ -414,8 +422,11 @@ CLIs. Keep the package independent of backend and MCP runtime dependencies.
journey through contribution export, with negative intake and authority checks.
Hosted and human-review journey proof remain separate.
Unfinished human review/revision is not current CLI implementation scope.
26. **Optional TUI:** Add a focused public queue/evidence view after its API
workflow is complete. Never require a TUI for agents or scripts.
26. **Optional TUI:** -48 supplies read-only contributor navigation through
existing typed reads. In-TUI findings/Evidence, writes and management remain
separate boundaries; Evidence first needs a shared typed single-page client
port without changing complete CLI exports. Never require a TUI for agents
or scripts.

## Risks and proof

Expand All @@ -437,6 +448,6 @@ cannot create a private CLI dependency.

The CLI is a separate client package, not an ADR 0014 backend adapter. It does
not change backend authority or deploy an external provider. Protected first CLI
publication, optional package-manager installers and signing, and a full
contribution journey remain future boundaries; source build and CI are not
publication, optional package-manager installers and signing, broader TUI
journeys and hosted contribution proof remain separate boundaries; source build and CI are not
claims of public distribution.
Loading
Loading