Polish fleet waves spawn timeline (#192)

Co-authored-by: NagyVikt <nagy.viktordp@gmail.com>

Author: NagyVikt

openspec/changes/agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/.openspec.yaml

@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-18

openspec/changes/agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/proposal.md

@@ -0,0 +1,13 @@
+## Why
+
+The fleet-waves dashboard needs to match the design-I spawn timeline reference more closely so operators can scan wave sequencing, task completion, and agent assignment in one pass.
+
+## What Changes
+
+- Polish `rust/fleet-waves/src/main.rs` Gantt rows with proportional timeline bars.
+- Add timeline tick markers and right-side `TASKS` / `AGENTS` columns.
+- Add an active-wave shimmer sweep and regression coverage for active-wave and proportional-width helpers.
+
+## Impact
+
+Risk is limited to the `fleet-waves` TUI binary. Verification is `RUSTC_WRAPPER= cargo test -p fleet-waves`.

openspec/changes/agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/specs/design-i-match-fleet-waves-spawn-timeline-polish/spec.md

@@ -0,0 +1,11 @@
+## ADDED Requirements
+
+### Requirement: Fleet Waves Spawn Timeline Polish
+The fleet-waves dashboard SHALL render wave progress as a Gantt-style spawn timeline that includes proportional bars, timeline tick markers, and task/agent summary columns.
+
+#### Scenario: Wave rows expose timeline, task, and agent state
+- **WHEN** a plan has topological waves with completed, claimed, and idle tasks
+- **THEN** the Gantt card shows a top tick-marker row above the wave bars
+- **AND** each wave row shows a proportional bar width based on its task count
+- **AND** each wave row shows right-aligned `TASKS` and `AGENTS` values
+- **AND** the active claimed wave receives a tint shimmer sweep without changing row geometry.

openspec/changes/agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/tasks.md

@@ -0,0 +1,34 @@
+## Definition of Done
+
+This change is complete only when **all** of the following are true:
+
+- Every checkbox below is checked.
+- The agent branch reaches `MERGED` state on `origin` and the PR URL + state are recorded in the completion handoff.
+- If any step blocks (test failure, conflict, ambiguous result), append a `BLOCKED:` line under section 4 explaining the blocker and **STOP**. Do not tick remaining cleanup boxes; do not silently skip the cleanup pipeline.
+
+## Handoff
+
+- Handoff: change=`agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22`; branch=`agent/<your-name>/<branch-slug>`; scope=`TODO`; action=`continue this sandbox or finish cleanup after a usage-limit/manual takeover`.
+- Copy prompt: Continue `agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22` on branch `agent/<your-name>/<branch-slug>`. Work inside the existing sandbox, review `openspec/changes/agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/tasks.md`, continue from the current state instead of creating a new sandbox, and when the work is done run `gx branch finish --branch agent/<your-name>/<branch-slug> --base dev --via-pr --wait-for-merge --cleanup`.
+
+## 1. Specification
+
+- [x] 1.1 Finalize proposal scope and acceptance criteria for `agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22`.
+- [x] 1.2 Define normative requirements in `specs/design-i-match-fleet-waves-spawn-timeline-polish/spec.md`.
+
+## 2. Implementation
+
+- [x] 2.1 Implement scoped behavior changes.
+- [x] 2.2 Add/update focused regression coverage.
+
+## 3. Verification
+
+- [x] 3.1 Run targeted project verification commands.
+- [x] 3.2 Run `openspec validate agent-codex-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22 --type change --strict`.
+- [x] 3.3 Run `openspec validate --specs`.
+
+## 4. Cleanup (mandatory; run before claiming completion)
+
+- [ ] 4.1 Run the cleanup pipeline: `gx branch finish --branch agent/<your-name>/<branch-slug> --base dev --via-pr --wait-for-merge --cleanup`. This handles commit -> push -> PR create -> merge wait -> worktree prune in one invocation.
+- [ ] 4.2 Record the PR URL and final merge state (`MERGED`) in the completion handoff.
+- [ ] 4.3 Confirm the sandbox worktree is gone (`git worktree list` no longer shows the agent path; `git branch -a` shows no surviving local/remote refs for the branch).

openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/README.md

@@ -0,0 +1,30 @@
+# Plan Workspace: agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22
+
+This folder stores durable planning artifacts before implementation changes.
+
+## Shared files
+- `summary.md`
+- `checkpoints.md`
+- `phases.md`
+- `open-questions.md`
+- `coordinator-prompt.md`
+- `kickoff-prompts.md`
+
+## Role folders
+- `planner/`
+- `architect/`
+- `critic/`
+- `executor/`
+- `writer/`
+- `verifier/`
+
+When Codex or Claude hits an unresolved question that should survive chat, add it to `open-questions.md` as an unchecked `- [ ]` item.
+
+Each role folder contains OpenSpec-style artifacts:
+- `.openspec.yaml`
+- `prompt.md` (copy/paste role prompt)
+- `proposal.md`
+- `tasks.md` (Spec / Tests / Implementation / Checkpoints checklists)
+- `specs/<role>/spec.md`
+Planner also gets `plan.md`; executor also gets `checkpoints.md`.
+Planner plans should follow `openspec/plan/PLANS.md`.

openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/.openspec.yaml

@@ -0,0 +1,9 @@
+schema: 1
+plan: agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22
+role: architect
+status: draft
+artifacts:
+  prompt: prompt.md
+  proposal: proposal.md
+  tasks: tasks.md
+  spec: specs/architect/spec.md

openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/README.md

@@ -0,0 +1,12 @@
+# architect
+
+Role workspace for `architect`.
+
+Default artifacts:
+- `.openspec.yaml`
+- `prompt.md`
+- `proposal.md`
+- `tasks.md`
+- `specs/<role>/spec.md`
+
+Use this folder for role notes, artifacts, and status updates.

openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/prompt.md

@@ -0,0 +1,34 @@
+# architect Prompt
+
+You are the `architect` role for OpenSpec plan `agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22`.
+
+## Objective
+
+Complete only this role's assigned checklist and leave compact evidence for the coordinator.
+
+## Source of truth
+
+- `openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/summary.md`
+- `openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/checkpoints.md`
+- `openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/open-questions.md`
+- `openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/tasks.md`
+- `openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/proposal.md`
+
+## Before edits
+
+1. Confirm branch/worktree with `git status --short --branch`.
+2. Claim every touched file before editing:
+   - Prefer Colony `task_claim_file` when an active task exists.
+   - Otherwise run `gx locks claim --branch <agent-branch> <file...>`.
+3. Stay inside assigned files/modules; coordinate before touching shared paths.
+
+## Working rules
+
+- Update `architect/tasks.md` as each item completes.
+- Record durable unresolved questions in `open-questions.md`.
+- Keep handoffs short: files changed, behavior touched, verification, risks.
+- Do not revert another agent's edits.
+
+## Cleanup
+
+Only the owner/finalizer lane runs `gx branch finish --branch <agent-branch> --base dev --via-pr --wait-for-merge --cleanup`. If blocked, append `BLOCKED:` with branch, task, blocker, next, evidence.

openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/proposal.md

@@ -0,0 +1,15 @@
+# Proposal: architect (agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22)
+
+## Why
+
+Summarize why this role's work is required for plan `agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22`.
+
+## What Changes
+
+- [ ] List the planned role-specific changes
+
+## Impact
+
+- Scope:
+- Risks:
+- Dependencies:

openspec/plan/agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22/architect/specs/architect/spec.md

@@ -0,0 +1,10 @@
+# Capability Spec: architect
+
+## ADDED Requirements
+
+### Requirement: architect responsibilities for `agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22`
+This role MUST define and deliver its scoped outputs with evidence.
+
+#### Scenario: Role executes assigned scope
+- **WHEN** the role begins execution for `agent-codex-masterplan-design-i-match-fleet-waves-spawn-timelin-2026-05-18-14-22`
+- **THEN** it follows `tasks.md` and records evidence for completion