feat: deliver installable local alpha sessions
Some checks failed
tamq-ci / test (push) Failing after 6s

Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a03397-4d51-7fd1-8ff2-946eb22ea2bc
This commit is contained in:
tegwick 2026-08-24 16:10:59 +02:00
parent d56bd3c79f
commit 5774fbd548
18 changed files with 890 additions and 94 deletions

View file

@ -4,7 +4,7 @@ type: workplan
title: "Operator-installable local alpha session"
domain: communication
repo: tmux-amq
status: active
status: finished
owner: codex
topic_slug: coulomb-social
planning_priority: P0
@ -100,7 +100,7 @@ tamq attach
```task
id: TAMQ-WP-0004-T01
status: todo
status: done
priority: high
state_hub_task_id: "017c4c30-3e1c-5939-b700-e73912e4a01e"
```
@ -111,11 +111,16 @@ installs. Verify `command -v tamq`, `tamq --version`, and invocation from outsid
the checkout. Document the corresponding uninstall command and executable-path
expectation.
Completed with a cache-refreshing `uv tool install` target and matching
uninstall target. The installed command resolves from the user tool bin, reports
version `0.1.0`, and is exercised from an isolated directory by the installed
package smoke test.
## Make session startup match the CLI contract
```task
id: TAMQ-WP-0004-T02
status: todo
status: done
priority: high
state_hub_task_id: "8e926f2b-b7b2-53f5-81e1-9bdd3c4b7d3e"
```
@ -130,11 +135,16 @@ new window and preserve idempotent reuse of existing windows. Define and test
`--no-service` as an explicitly degraded tmux-only mode or remove it from the
alpha surface.
Completed with canonical `--command`, compatible `--cmd`, default Codex,
attach-by-default, working detached and explicit no-service modes, exact first
and subsequent window paths, tmux-scoped endpoint identity, and idempotent
window/process reuse.
## Add installation and startup preflight
```task
id: TAMQ-WP-0004-T03
status: todo
status: done
priority: high
state_hub_task_id: "479dd94e-e21f-512d-80e7-2453cf163b67"
```
@ -145,11 +155,15 @@ and session conflicts. Return concise remediation for every failure and avoid
leaving boot windows, sockets, pidfiles, or processes behind after a failed
start.
Completed with command, gita target/path, runtime-path, agent, and managed-session
checks before mutation. Registration failures roll back newly created tmux
resources, and foreign same-named sessions are rejected rather than adopted.
## Prove the installed local session end to end
```task
id: TAMQ-WP-0004-T04
status: wait
status: done
priority: high
state_hub_task_id: "76990b5d-b0d7-562f-8316-1b9cc452cadf"
```
@ -162,11 +176,19 @@ same-named windows open in their registered paths with Codex running
automatically, along with attach/detach semantics, idempotent reuse, message
injection/history, shutdown, and cleanup. This task follows T01-T03.
Completed with both a real isolated-tmux integration test and an isolated uv
tool installation smoke test. The latter starts the two required repository
windows through the installed CLI, verifies exact paths and stable pane PIDs on
repeat, routes a message into `activity-core`, observes `injected` history,
checks status, stops the service, and bounds tmux cleanup. The local operator
acceptance used the same repository operands with Codex and left both live panes
ready for attachment.
## Publish the alpha quickstart and evidence
```task
id: TAMQ-WP-0004-T05
status: wait
status: done
priority: medium
state_hub_task_id: "e98eda1e-6200-5bfb-8873-c0a210484fc1"
```
@ -176,3 +198,8 @@ upgrade, start, attach, status, stop, and uninstall commands. Record the exact
local acceptance commands and results. Clearly retain the reliability caveats
owned by `TAMQ-WP-0003` and do not claim coordination-engine integration from
`TAMQ-WP-0002`. This task follows T04.
Completed in `README.md`, `AGENTS.md`, the stack command rules, and `SCOPE.md`.
The quickstart documents install/upgrade, exact Codex start, detached start,
attach, status, stop, tmux cleanup, and uninstall while retaining the bounded
retry, acknowledgement, and coordination-adapter caveats.