tmux-amq/workplans/TAMQ-WP-0003-delivery-reliability.md
tegwick 68475922bb
Some checks failed
tamq-ci / test (push) Failing after 6s
fix: restore interactive PTY behavior
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a03397-4d51-7fd1-8ff2-946eb22ea2bc
2026-08-24 19:28:49 +02:00

2.6 KiB

id type title domain repo status owner topic_slug created updated state_hub_workstream_id
TAMQ-WP-0003 workplan Delivery reliability and practical integration evidence communication tmux-amq active codex coulomb-social 2026-08-24 2026-08-24 7961275b-8f1f-5827-b9fc-46b3ac35fb73

Delivery reliability and practical integration evidence

Close the reliability gaps found during the 2026-08-24 intent and usability assessment before treating tmux-amq as an unattended local transport or as a stable coordination-engine dependency.

Enforce bounded delivery attempts

id: TAMQ-WP-0003-T01
status: todo
priority: high
state_hub_task_id: "52c43745-5c28-599e-b74c-0386d5b51e68"

Persist attempt counts and failure reasons, apply the selected policy profile's retry cap, define lease-expiry behavior, and introduce an inspectable terminal failure state. Prove restart-safe behavior and avoid tight retry loops.

Enforce acknowledgement semantics

id: TAMQ-WP-0003-T02
status: wait
priority: high
state_hub_task_id: "ff88d6c9-f4d7-52c7-9645-7c3a7a34ccb4"

Make delivery_ack_mode control whether injection completes delivery or waits for explicit recipient acknowledgement. Specify timeout, redelivery, duplicate, and late-acknowledgement behavior. This task follows the state model from T01.

Add real tmux and PTY lifecycle coverage

id: TAMQ-WP-0003-T03
status: done
priority: high
state_hub_task_id: "9a3d84b4-55a5-5d18-b4ee-99ac4f111875"

Exercise a real tmux server, managed windows, control-mode injection, tamq tap, service shutdown, endpoint disappearance, and restart recovery without starting an external coding agent. Keep fast unit tests while adding a bounded integration suite.

Completed with a real isolated-tmux PTY fixture that proves initial dimensions, SIGWINCH resize propagation, raw mouse-sequence forwarding without newline buffering, and bounded cleanup. The installed-package lifecycle smoke now also proves service shutdown/restart, stable pane reuse, disappeared-session endpoint retirement, and clean recovery into a new tmux instance. The PTY proxy restores terminal state and forwards termination signals; --no-service bypasses the tap entirely as documented.

Align CI and operator documentation

id: TAMQ-WP-0003-T04
status: wait
priority: medium
state_hub_task_id: "44939829-a52e-582a-b06b-60337b36080e"

Run the integration suite in Forgejo CI with explicit tmux and gita setup. Update README claims about retries, acknowledgement, prerequisites, and maturity from verified behavior. This task follows T01-T03.