to-do.json

{
  "schema_version": 1,
  "source_files": [
    "README.md",
    "AI_CLI_COMPARISON.md",
    "SPECS_v1.md",
    "SPECS_v2.md"
  ],
  "tasks": [
    {
      "id": "T001",
      "title": "Define core domain structs and shared constants",
      "priority": 1,
      "status": "done",
      "details": "Create canonical Go structs for task, iteration, verification, loop state, proof events, config, and CLI payloads.",
      "steps": [
        "Define JSON tags matching schema contracts",
        "Keep status/result/enums as constants",
        "Add lightweight constructors for zero-value safety"
      ],
      "updated_at": "2026-02-13T00:18:14Z",
      "files": [
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T002",
      "title": "Implement config loading with precedence and schema support",
      "priority": 1,
      "status": "done",
      "details": "Load `.bare/config.json` with validation and precedence: flags > env > config file > defaults.",
      "depends_on": [
        "T001"
      ],
      "steps": [
        "Parse defaults and config file",
        "Merge explicit flags and environment overrides",
        "Expose effective config object to commands"
      ],
      "updated_at": "2026-02-13T00:19:47Z",
      "files": [
        "internal/domain/config.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T003",
      "title": "Implement atomic file write helper",
      "priority": 1,
      "status": "done",
      "details": "Create safe write pattern helper using temp file, fsync on file+parent directory, and atomic rename.",
      "depends_on": [
        "T001"
      ],
      "steps": [
        "Write temp file in same directory",
        "Fsync file and parent directory",
        "Atomically rename temp -> target"
      ],
      "updated_at": "2026-02-13T00:20:19Z",
      "files": [
        "internal/storage/atomic.go",
        "to-do.json"
      ]
    },
    {
      "id": "T004",
      "title": "Build filesystem-backed task store and CRUD helpers",
      "priority": 1,
      "status": "done",
      "details": "Implement read/write of `.bare/state/todo.json`, validation, and deterministic ID/title/status handling.",
      "depends_on": [
        "T003",
        "T001"
      ],
      "steps": [
        "Load and validate task list",
        "Support add/update/list/get by id",
        "Persist with atomic writer"
      ],
      "updated_at": "2026-02-13T00:20:57Z",
      "files": [
        "internal/storage/task_store.go",
        "to-do.json"
      ]
    },
    {
      "id": "T005",
      "title": "Implement dependency-aware deterministic task selector",
      "priority": 1,
      "status": "done",
      "details": "Select next task by smallest priority, then lexicographically smallest id; skip blocked or waiting on missing dependencies.",
      "depends_on": [
        "T004",
        "T001"
      ],
      "steps": [
        "Filter runnable status states",
        "Validate depends_on completion",
        "Stable sort by priority then id"
      ],
      "updated_at": "2026-02-13T00:35:00Z",
      "files": [
        "internal/storage/task_store.go"
      ]
    },
    {
      "id": "T006",
      "title": "Implement O_CREATE|O_EXCL lock lifecycle",
      "priority": 1,
      "status": "done",
      "details": "Create `.bare/state/lock.json` lock with pid/host/start time, exclusive creation, and stale-lock detection.",
      "depends_on": [
        "T003",
        "T001"
      ],
      "steps": [
        "Create lock acquisition path",
        "Detect stale lock via PID check",
        "Release lock on exit and on fatal error"
      ],
      "updated_at": "2026-02-13T00:22:16Z",
      "files": [
        "internal/storage/lock.go",
        "to-do.json"
      ]
    },
    {
      "id": "T007",
      "title": "Create `.bare` bootstrap skeleton command",
      "priority": 1,
      "status": "done",
      "details": "Implement `bare init` to create directory structure and starter files, with safe overwrite behavior using `--force`.",
      "depends_on": [
        "T002",
        "T003"
      ],
      "steps": [
        "Create .bare directories and required placeholder files",
        "Write default config",
        "Create default verify/script hook templates"
      ],
      "updated_at": "2026-02-13T00:23:13Z",
      "files": [
        "/home/niko/bare/cmd/bare/main.go",
        "/home/niko/bare/go.mod",
        "/home/niko/bare/internal/bootstrap/bootstrap.go",
        "/home/niko/bare/to-do.json",
        "cmd/bare/main.go",
        "go.mod",
        "internal/bootstrap/bootstrap.go"
      ]
    },
    {
      "id": "T008",
      "title": "Implement shell command execution engine",
      "priority": 1,
      "status": "done",
      "details": "Implemented shell command execution engine with timeout handling, stdout/stderr capture paths, cwd resolution, and persisted execution records.",
      "depends_on": [
        "T001",
        "T003"
      ],
      "steps": [
        "Capture stdout/stderr paths",
        "Apply command timeout",
        "Persist execution metadata to run artifacts"
      ],
      "updated_at": "2026-02-13T00:24:02Z",
      "files": [
        "internal/domain/types.go",
        "internal/execution/executor.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T009",
      "title": "Implement model adapter with retries and token reporting",
      "priority": 1,
      "status": "done",
      "details": "Build stdlib HTTP provider client for prompt/send, backoff retries, cache hints, and usage parsing.",
      "depends_on": [
        "T002",
        "T001"
      ],
      "steps": [
        "Support timeout and retry budget",
        "Parse response and command extraction",
        "Surface model/tokens in iteration record"
      ],
      "updated_at": "2026-02-13T00:24:51Z",
      "files": [
        "internal/model/model.go",
        "internal/domain/types.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T010",
      "title": "Implement `bare tick` deterministic work cycle",
      "priority": 1,
      "status": "done",
      "details": "Execute selection, model call, command execution, persistence, verification, and status transition in one deterministic loop body. Executed deterministic tick loop with CLI tick command, model turns, lock-aware no_task/idle handling, status transitions, and run artifacts (iteration/events).",
      "depends_on": [
        "T002",
        "T004",
        "T005",
        "T006",
        "T007",
        "T008",
        "T009",
        "T011",
        "T014"
      ],
      "steps": [
        "Respect --task and --max-model-turns",
        "Emit run artifacts (iteration + events)",
        "Handle no_task/idle and lock outcomes deterministically"
      ],
      "updated_at": "2026-02-13T00:26:49Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T011",
      "title": "Create proof append-only log primitives",
      "priority": 1,
      "status": "done",
      "details": "Implement `proof.jsonl` event writing, immutable append behavior, sequence numbering, prev_hash chain, and hashing.",
      "depends_on": [
        "T001",
        "T003"
      ],
      "steps": [
        "Define event types",
        "Implement canonical JSON + sha256 chaining",
        "Persist per-task proof files"
      ],
      "updated_at": "2026-02-13T00:27:44Z",
      "files": [
        "internal/proof/proof.go",
        "to-do.json"
      ]
    },
    {
      "id": "T012",
      "title": "Implement verification pipeline with blocking semantics",
      "priority": 1,
      "status": "done",
      "details": "Discover and run `.bare/verify.d` scripts lexicographically, capture outputs, and aggregate blocking failures. | implemented blocking metadata parsing, fail-fast support, and verify.json persistence",
      "depends_on": [
        "T003",
        "T001",
        "T008"
      ],
      "steps": [
        "Implement # bare:blocking=false parsing",
        "Support fail-fast mode",
        "Persist `.bare/state/verify.json`"
      ],
      "updated_at": "2026-02-13T00:28:43Z",
      "files": [
        "cmd/bare/tick.go"
      ],
      "blockers": []
    },
    {
      "id": "T013",
      "title": "Implement hook execution and environment contract",
      "priority": 1,
      "status": "done",
      "details": "Run configured shell hooks with required env vars, capture output, and enforce require_success behavior.",
      "depends_on": [
        "T006",
        "T001",
        "T003"
      ],
      "steps": [
        "Build common hook env map",
        "Handle optional hook absence safely",
        "Record hook success/failure in iteration log"
      ],
      "updated_at": "2026-02-13T00:30:32Z",
      "files": [
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T014",
      "title": "Build stable command dispatch and global flag parser",
      "priority": 1,
      "status": "done",
      "details": "Implement CLI entrypoint and subcommands with stdlib flags, including --json/non-interactive/quiet/no-color/emit-progress with shared global flag parser and stable dispatch to typed handlers.",
      "depends_on": [
        "T002",
        "T001"
      ],
      "steps": [
        "Parse global flags first",
        "Route subcommands to typed handlers",
        "Keep output format consistent across commands"
      ],
      "updated_at": "2026-02-13T00:31:35Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T015",
      "title": "Implement `bare run` loop controller",
      "priority": 1,
      "status": "done",
      "details": "Wrap tick with scheduler-safe stop conditions and optional resume/max-tokens/timeout constraints. Implemented run command wrapper in cmd/bare/main.go and new cmd/bare/run.go.",
      "depends_on": [
        "T010",
        "T006",
        "T001",
        "T014"
      ],
      "steps": [
        "Honor --max-iterations, --timeout, --until-done",
        "Propagate no-task/idle and token budget outcomes",
        "Reuse tick selection and persistence semantics"
      ],
      "updated_at": "2026-02-13T00:32:45Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/run.go",
        "to-do.json"
      ]
    },
    {
      "id": "T016",
      "title": "Implement task command set: list/next/add/set-status",
      "priority": 1,
      "status": "done",
      "details": "Create CLI UX for task operations with JSON and filtering.",
      "depends_on": [
        "T004",
        "T005",
        "T014"
      ],
      "steps": [
        "List by status and/or all",
        "Add with explicit id/title/priority",
        "Transition status with validation"
      ],
      "updated_at": "2026-02-13T00:33:52Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/task.go",
        "to-do.json"
      ]
    },
    {
      "id": "T017",
      "title": "Implement bare proof command subcommands",
      "priority": 1,
      "status": "done",
      "details": "Expose `proof init/note/exec/decision/error/done/render` and integrate with run loop where appropriate.",
      "depends_on": [
        "T011",
        "T014"
      ],
      "steps": [
        "Append typed events from CLI",
        "Record outputs and resolutions",
        "Render markdown artifact from proof chain"
      ],
      "updated_at": "2026-02-13T00:36:03Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/proof.go",
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T018",
      "title": "Implement verify command",
      "priority": 1,
      "status": "done",
      "details": "Expose manual `bare verify --only --fail-fast` to reuse the same verification runner as tick.",
      "depends_on": [
        "T012",
        "T014"
      ],
      "steps": [
        "Support pattern filtering",
        "Return deterministic pass/fail summary",
        "Persist verify state"
      ],
      "updated_at": "2026-02-13T00:36:43Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/tick.go",
        "cmd/bare/verify.go",
        "to-do.json"
      ]
    },
    {
      "id": "T019",
      "title": "Implement state command and validation",
      "priority": 1,
      "status": "done",
      "details": "Build `bare state show` for human-readable and JSON snapshots, and `state validate` consistency checks.",
      "depends_on": [
        "T004",
        "T012",
        "T014",
        "T001"
      ],
      "steps": [
        "Include lock/task/progress/verify snapshots",
        "Check file-level invariants",
        "Report actionable validation errors"
      ],
      "updated_at": "2026-02-13T00:38:11Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/state.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T020",
      "title": "Implement stable machine-readable output envelope",
      "priority": 1,
      "status": "done",
      "details": "Implemented stable machine-readable JSON envelope behavior with deterministic result/message normalization and non-JSON-proof-output guard in proof render.",
      "depends_on": [
        "T014",
        "T001",
        "T024"
      ],
      "steps": [
        "Define envelope fields",
        "Emit ok/code/result/message consistently",
        "Keep non-zero codes deterministic"
      ],
      "updated_at": "2026-02-13T00:47:02Z",
      "files": [
        "cmd/bare/proof.go",
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T021",
      "title": "Implement error taxonomy and documented exit-code mapping",
      "priority": 1,
      "status": "done",
      "details": "Map domain errors to required exit codes including 10/11 informational scheduler outcomes.",
      "depends_on": [
        "T001",
        "T020"
      ],
      "steps": [
        "Define custom error types",
        "Centralize code translation",
        "Cover lock contention and token timeout paths"
      ],
      "updated_at": "2026-02-13T00:45:50Z",
      "files": [
        "cmd/bare/run.go",
        "cmd/bare/tick.go",
        "cmd/bare/verify.go",
        "internal/domain/errors.go",
        "to-do.json"
      ]
    },
    {
      "id": "T022",
      "title": "Add lock semantics for tick with fail-on-lock support",
      "priority": 1,
      "status": "done",
      "details": "Implement branch where --fail-on-lock returns exit 4 immediately, else returns exit 11 no-op.",
      "depends_on": [
        "T006",
        "T021",
        "T010",
        "T014"
      ],
      "steps": [
        "Differentiate lock-owned and stale-lock replacement",
        "Record no-op and exit semantics in result"
      ],
      "updated_at": "2026-02-13T00:47:50Z",
      "files": [
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T023",
      "title": "Implement run/tick iteration artifacts",
      "priority": 1,
      "status": "done",
      "details": "Persist loop artifacts under `.bare/outputs/runs/<run_id>/` including iteration JSON, events log, and run log path references.",
      "depends_on": [
        "T003",
        "T010",
        "T008"
      ],
      "steps": [
        "Create per-run directories",
        "Append iteration record",
        "Write structured run.log and event stream"
      ],
      "updated_at": "2026-02-13T00:49:04Z",
      "files": [
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T024",
      "title": "Persist current loop state and progress tracking",
      "priority": 2,
      "details": "Persisted resumable loop state across iterations into loop.json/current.json plus verify.json/metrics.jsonl with atomic writes at deterministic checkpoints.",
      "status": "done",
      "depends_on": [
        "T003",
        "T001",
        "T023"
      ],
      "steps": [
        "Define progress schema",
        "Update at predictable checkpoints",
        "Keep writes atomic"
      ],
      "updated_at": "2026-02-13T00:50:35Z",
      "blockers": [],
      "files": [
        "internal/domain/types.go",
        "cmd/bare/tick.go",
        "cmd/bare/state.go"
      ]
    },
    {
      "id": "T025",
      "title": "Implement crash recovery and stale lock handling",
      "priority": 2,
      "status": "done",
      "details": "On startup and before run loops, detect stale lock and recover from interrupted iterations safely.",
      "depends_on": [
        "T006",
        "T024",
        "T010"
      ],
      "steps": [
        "Check lock freshness",
        "Load latest run artifact and loop state",
        "Require operator acknowledgement when ambiguous"
      ],
      "updated_at": "2026-02-13T00:51:57Z",
      "files": [
        "cmd/bare/tick.go"
      ]
    },
    {
      "id": "T026",
      "title": "Implement proof hash-chain verification in render",
      "priority": 2,
      "status": "done",
      "details": "`bare proof render` must verify hash chain integrity before markdown generation.",
      "depends_on": [
        "T011",
        "T017"
      ],
      "steps": [
        "Validate prev_hash/hash order",
        "Fail if chain breaks",
        "Generate deterministic demo.md"
      ],
      "updated_at": "2026-02-13T00:52:54Z",
      "files": [
        "cmd/bare/proof.go"
      ]
    },
    {
      "id": "T027",
      "title": "Implement optional source control commit path",
      "priority": 2,
      "status": "done",
      "details": "Support `--commit` in tick/run and config-driven commit_on_verify_pass behavior.",
      "depends_on": [
        "T010",
        "T013",
        "T020"
      ],
      "steps": [
        "Run git add/commit when allowed",
        "Protect against empty commit",
        "Surface failures in deterministic result"
      ],
      "updated_at": "2026-02-13T00:54:33Z",
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/run.go",
        "cmd/bare/main.go",
        "to-do.json"
      ]
    },
    {
      "id": "T028",
      "title": "Implement metrics and structured run log events",
      "priority": 2,
      "status": "done",
      "details": "Write `.bare/state/metrics.jsonl` and include timing/token model metrics in iteration artifacts.",
      "depends_on": [
        "T023",
        "T021",
        "T009"
      ],
      "steps": [
        "Emit per-iteration metrics",
        "Enable append-only JSONL semantics",
        "Keep schemas stable"
      ],
      "updated_at": "2026-02-13T00:56:53Z",
      "files": [
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T029",
      "title": "Implement task repair gate and repeat behavior",
      "priority": 2,
      "status": "done",
      "details": "When verify fails, drive repair cycles up to configured max_repair_cycles and then block task if unresolved.",
      "depends_on": [
        "T010",
        "T012",
        "T021"
      ],
      "steps": [
        "Track repair count per iteration",
        "Reuse selected task for retries",
        "Set task blocked on exhausted repair budget"
      ],
      "updated_at": "2026-02-13T00:57:56Z",
      "files": [
        "cmd/bare/tick.go",
        "to-do.json"
      ]
    },
    {
      "id": "T030",
      "title": "Create deterministic ordering and status transition tests",
      "priority": 3,
      "status": "done",
      "details": "Add unit tests for comparator ordering, deterministic selection, and state transitions.",
      "depends_on": [
        "T005",
        "T004",
        "T021"
      ],
      "steps": [
        "Test tie-breakers by id",
        "Test depends_on and blocked resolution",
        "Test no-op transitions are deterministic"
      ],
      "updated_at": "2026-02-13T01:03:48Z",
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/tick_status_test.go",
        "internal/storage/task_store_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T031",
      "title": "Add CLI envelope and exit-code golden tests",
      "priority": 3,
      "status": "done",
      "details": "Verify `--json` output shape and exit code mapping for command outcomes.",
      "depends_on": [
        "T020",
        "T021",
        "T014"
      ],
      "steps": [
        "Add table-driven CLI tests",
        "Cover no_task/idle and lock outcomes",
        "Ensure envelope fields stable"
      ],
      "updated_at": "2026-02-13T01:05:07Z",
      "files": [
        "cmd/bare/cli_envelope_golden_test.go",
        "cmd/bare/testdata/cli/tick-lock-fail.golden",
        "cmd/bare/testdata/cli/tick-lock-idle.golden",
        "cmd/bare/testdata/cli/tick-no-task.golden",
        "to-do.json"
      ]
    },
    {
      "id": "T032",
      "title": "Build end-to-end tick/run integration tests",
      "priority": 3,
      "status": "done",
      "details": "Create fixture repositories with `.bare/verify.d` and validate behavior for tick, run, lock contention, and no_task cases.",
      "depends_on": [
        "T010",
        "T018",
        "T022",
        "T025"
      ],
      "steps": [
        "Test with temporary repos",
        "Assert artifact paths and proof records",
        "Assert deterministic JSON output"
      ],
      "updated_at": "2026-02-13T01:06:49Z",
      "files": [
        "cmd/bare/integration_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T033",
      "title": "Implement determinism tests for verify and JSON payloads",
      "priority": 3,
      "status": "done",
      "details": "Prove reproducible ordering and payload stability across repeated runs with the same state.",
      "depends_on": [
        "T012",
        "T020",
        "T010"
      ],
      "steps": [
        "Sort verify scripts by filename",
        "Stabilize command iteration ordering",
        "Golden-check serialized JSON"
      ],
      "updated_at": "2026-02-13T01:08:23Z",
      "files": [
        "cmd/bare/testdata/cli/verify-pass.golden",
        "cmd/bare/verify_determinism_test.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T034",
      "title": "Enforce zero external dependencies policy",
      "priority": 3,
      "status": "done",
      "details": "Enforce zero external dependencies by standardizing docs, adding a zero-dependency verify script template, and requiring a dependency check in contributing guidance.",
      "depends_on": [
        "T001",
        "T014"
      ],
      "steps": [
        "Audit go.mod dependencies",
        "Block accidental additions in contributing docs",
        "Run static check for imported third-party packages"
      ],
      "updated_at": "2026-02-13T01:09:24Z",
      "files": [
        "CONTRIBUTING.md",
        "SPECS_v1.md",
        "internal/bootstrap/bootstrap.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T035",
      "title": "Add hook config and default template generation",
      "priority": 2,
      "status": "done",
      "details": "Generate default `.agents/hooks/*.sh` files in init and parse per-hook require_success and timeout settings.",
      "depends_on": [
        "T007",
        "T013",
        "T002"
      ],
      "steps": [
        "Template include env var exports",
        "Store hook config in config.json",
        "Support disable/enable behavior"
      ],
      "updated_at": "2026-02-13T00:58:34Z",
      "files": [
        "internal/bootstrap/bootstrap.go",
        "internal/domain/types.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T036",
      "title": "Add deterministic proof rendering markdown",
      "priority": 2,
      "status": "done",
      "details": "Generate task-readable demo markdown from proof chain with command and decision sections.",
      "depends_on": [
        "T011",
        "T026"
      ],
      "steps": [
        "Format events in stable order",
        "Render errors and decisions",
        "Reference output artifacts"
      ],
      "updated_at": "2026-02-13T00:59:38Z",
      "files": [
        "cmd/bare/proof.go",
        "to-do.json"
      ]
    },
    {
      "id": "T037",
      "title": "Prepare default verification scripts and docs",
      "priority": 3,
      "status": "done",
      "details": "Ship starter `.bare/verify.d/01-tests.sh` and `02-types.sh` templates and document editable behavior.",
      "depends_on": [
        "T007",
        "T012",
        "T034"
      ],
      "steps": [
        "Create scripts with executable bits",
        "Document required exit codes",
        "Include optional non-blocking header usage"
      ],
      "updated_at": "2026-02-13T01:10:03Z",
      "files": [
        "CONTRIBUTING.md",
        "internal/bootstrap/bootstrap.go",
        "to-do.json"
      ]
    },
    {
      "id": "T038",
      "title": "Add project docs for bootstrap and command usage",
      "priority": 3,
      "status": "done",
      "details": "Added README.md with bootstrap/install guidance, command usage, deterministic behavior, exit codes, and machine-readable examples for tick/task/proof/verify.",
      "depends_on": [
        "T007",
        "T014",
        "T010",
        "T017",
        "T019",
        "T020"
      ],
      "steps": [
        "Describe deterministic behavior",
        "Document exit codes and statuses",
        "Include examples for machine-readable mode"
      ],
      "updated_at": "2026-02-13T01:10:44Z",
      "files": [
        "README.md",
        "to-do.json"
      ]
    },
    {
      "id": "T039",
      "title": "Track token budget and stop-on-limit behavior",
      "priority": 2,
      "status": "done",
      "details": "Implement token accounting in loops with exit code 13 and clear recovery messages.",
      "depends_on": [
        "T009",
        "T015",
        "T021"
      ],
      "steps": [
        "Parse token usage from model response",
        "Sum across model turns",
        "Stop loop before violating config limit"
      ],
      "updated_at": "2026-02-13T01:00:26Z",
      "files": [
        "cmd/bare/run.go",
        "to-do.json"
      ]
    },
    {
      "id": "T040",
      "title": "Implement timeout budget and enforcement in tick/run",
      "priority": 2,
      "status": "done",
      "details": "Respect command-level and loop-level timeout budgets and emit timeout exceeded exit code 12.",
      "depends_on": [
        "T008",
        "T015",
        "T010",
        "T021"
      ],
      "steps": [
        "Per-command timeout from config/flag",
        "Aggregate elapsed loop time",
        "Report where timeout occurred"
      ],
      "updated_at": "2026-02-13T01:02:57Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/run.go",
        "cmd/bare/tick.go",
        "cmd/bare/verify.go",
        "to-do.json"
      ]
    },
    {
      "id": "T041",
      "title": "Build v2 skill runtime scaffold (manual invoke)",
      "priority": 4,
      "status": "done",
      "details": "Create optional markdown-defined runtime that can list/validate/invoke skills outside core loop.",
      "depends_on": [
        "T014",
        "T001"
      ],
      "steps": [
        "Parse skill front-matter metadata",
        "Expose bare skill commands",
        "Store produced artifacts deterministically"
      ],
      "updated_at": "2026-02-13T01:13:04Z",
      "files": [
        "README.md",
        "cmd/bare/main.go",
        "cmd/bare/skill.go",
        "internal/bootstrap/bootstrap.go",
        "internal/skill/skill.go",
        "to-do.json"
      ]
    },
    {
      "id": "T042",
      "title": "Design branch execution primitives for v2",
      "priority": 4,
      "status": "done",
      "details": "Plan branch state/worktree model and compare-result persistence for speculative parallel execution. Added v2 branch ID/layout/result primitives in internal/branch/branch.go.",
      "depends_on": [
        "T041",
        "T024"
      ],
      "steps": [
        "Model branch IDs and state layout",
        "Define isolation directories",
        "Define branch result schema"
      ],
      "updated_at": "2026-02-13T01:13:35Z",
      "files": [
        "internal/branch/branch.go",
        "to-do.json"
      ]
    },
    {
      "id": "T043",
      "title": "Add heartbeat and cron helper commands for v2",
      "priority": 5,
      "status": "done",
      "details": "Implement optional `heartbeat` and `cron` commands for scheduled execution ergonomics.",
      "depends_on": [
        "T015",
        "T024"
      ],
      "steps": [
        "Add heartbeat status/state",
        "Generate sample cron commands",
        "Persist heartbeat health state"
      ],
      "updated_at": "2026-02-13T01:22:23Z",
      "files": [
        "cmd/bare/cron.go",
        "cmd/bare/heartbeat.go",
        "cmd/bare/main.go",
        "internal/bootstrap/bootstrap.go",
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T044",
      "title": "Build trace management and archival tools",
      "priority": 5,
      "status": "done",
      "details": "Implement trace management and archival command tools with retention/summary/search/restore support.",
      "depends_on": [
        "T023",
        "T034"
      ],
      "steps": [
        "Implement rotation policy",
        "Support search and restoration",
        "Generate summary indexes"
      ],
      "updated_at": "2026-02-13T01:27:02Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/trace.go",
        "internal/domain/config.go",
        "to-do.json"
      ]
    },
    {
      "id": "T045",
      "title": "Expose health/doctor and explicit checkpoint APIs",
      "priority": 5,
      "status": "done",
      "details": "Add observability commands for state health and explicit checkpoint create/list/restore flow.",
      "depends_on": [
        "T024",
        "T019"
      ],
      "steps": [
        "Build doctor checks",
        "Define checkpoint artifact format",
        "Document manual restore workflow"
      ],
      "updated_at": "2026-02-13T01:31:37Z",
      "files": [
        "README.md",
        "cmd/bare/checkpoint.go",
        "cmd/bare/health.go",
        "cmd/bare/main.go",
        "cmd/bare/state.go",
        "to-do.json"
      ]
    },
    {
      "id": "T046",
      "title": "Implement run resume behavior for `--resume` flag",
      "priority": 1,
      "status": "done",
      "details": "Implemented --resume by resolving existing run artifacts, preloading token usage cursor, and forcing run reuse for tick iterations",
      "steps": [
        "Resolve and validate the requested run ID",
        "Load existing run artifacts, loop state, and token budget cursor",
        "Continue scheduling from the loaded state without recreating a new run directory"
      ],
      "updated_at": "2026-02-13T07:44:14Z",
      "files": [
        "cmd/bare/integration_test.go",
        "cmd/bare/run.go",
        "cmd/bare/state.go",
        "cmd/bare/tick.go"
      ]
    },
    {
      "id": "T047",
      "title": "Harden stale lock detection for false-positive liveness",
      "priority": 1,
      "status": "done",
      "details": "Lock checking treats non-`ESRCH` process-signal errors as alive, which can misclassify stale locks under transient or permission-based failures.",
      "steps": [
        "Map process-liveness checks to explicit existence semantics per platform",
        "Only treat clearly valid signals as alive and handle error classes conservatively",
        "Add tests or integration coverage for stale-lock scenarios"
      ],
      "updated_at": "2026-02-13T07:44:49Z",
      "files": [
        "internal/storage/lock.go",
        "internal/storage/lock_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T048",
      "title": "Apply retention policy to archived trace artifacts",
      "priority": 2,
      "status": "done",
      "details": "Apply retention consistently across hot runs and archive/ artifacts: hot runs continue to be archived by archive-after policy, and both hot and archive locations are eligible for delete-after retention; archive summaries are not removed when a hot copy still exists.",
      "steps": [
        "Include archive directories in retention candidate discovery",
        "Enforce retention consistently with trace age and path policies",
        "Document retention behavior across hot and archive stores"
      ],
      "updated_at": "2026-02-13T07:56:36Z",
      "files": [
        "cmd/bare/trace.go",
        "to-do.json"
      ]
    },
    {
      "id": "T049",
      "title": "Normalize tick max model-turn handling across config and CLI",
      "priority": 2,
      "status": "done",
      "details": "Nested loop budgets and both `cfg.Loop.MaxRepairCycles` and `--max-model-turns` can diverge, producing non-obvious stop conditions.",
      "steps": [
        "Define one authoritative model-turn budget for run/tick",
        "Refactor budget checks to share a single counter path",
        "Add coverage for boundary and limit-edge behavior"
      ],
      "updated_at": "2026-02-13T07:57:32Z",
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/run.go",
        "to-do.json"
      ]
    },
    {
      "id": "T050",
      "title": "Track tick success state in heartbeat metadata",
      "priority": 2,
      "status": "done",
      "details": "Heartbeat currently updates `LastTickAt` even when tick fails, which can mask repeated execution failures in health reporting.",
      "steps": [
        "Separate last-attempt and last-successful tick timestamps",
        "Expose tick error metadata in heartbeat result",
        "Keep health output consistent with the new semantics"
      ],
      "updated_at": "2026-02-13T08:00:17Z",
      "files": [
        "cmd/bare/health.go",
        "cmd/bare/heartbeat.go",
        "cmd/bare/state.go",
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T051",
      "title": "Fix trace summary run-log path mapping",
      "priority": 3,
      "status": "done",
      "details": "Trace summary builders assign run-log path into `ArchivePath`, which conflates artifact metadata and may mislead archive consumers.",
      "steps": [
        "Use a dedicated field for run-log path in summaries",
        "Preserve archive path for actual archive file references only",
        "Adjust render/search/serialization code to consume the explicit field"
      ],
      "updated_at": "2026-02-13T08:21:03Z",
      "files": [
        "cmd/bare/trace.go",
        "to-do.json"
      ]
    },
    {
      "id": "T052",
      "title": "Reduce proof append cost by avoiding full-chain revalidation",
      "priority": 3,
      "status": "done",
      "details": "Append proof events using a checkpoint file to avoid full-chain reads on every append; keep full chain verification as a bounded corruption guard.",
      "steps": [
        "Persist last-hash/sequence checkpoint state efficiently",
        "Validate only incremental constraints when appending new events",
        "Add safety checks to detect corruption while bounding write cost"
      ],
      "updated_at": "2026-02-13T08:21:49Z",
      "files": [
        "internal/proof/proof.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T053",
      "title": "Expose command output truncation as execution metadata",
      "priority": 3,
      "status": "done",
      "details": "Output-limiter truncation is currently mostly silent in persisted execution state, making truncated command output hard to detect from summaries.",
      "steps": [
        "Record truncation/warn flags in execution records",
        "Surface truncation in run/iteration result summaries",
        "Document and test troubleshooting behavior when output is capped"
      ],
      "updated_at": "2026-02-13T08:23:37Z",
      "files": [
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "internal/execution/executor.go",
        "internal/execution/executor_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T054",
      "title": "Fix syntax error in config parsing code",
      "priority": 1,
      "status": "done",
      "details": "A syntax error in `internal/domain/config.go` (escaped-character issue) blocks `go test ./...` and prevents compile for all packages.",
      "steps": [
        "Inspect line ~250 in `internal/domain/config.go` for invalid escape character",
        "Remove or replace the malformed token",
        "Re-run tests and verify package compilation"
      ],
      "updated_at": "2026-02-13T07:45:03Z",
      "files": [
        "internal/domain/config.go",
        "to-do.json"
      ]
    },
    {
      "id": "T055",
      "title": "Re-run full test suite after todo-tasked fixes",
      "priority": 2,
      "status": "done",
      "details": "Re-ran go test ./... after prior todo-tasked fixes. Suite still fails: 18 failing tests in github.com/niko/bare/cmd/bare, centered on run score/compare/patch command contracts and policy/JSON schema output consistency. See output for exact mismatches.",
      "steps": [
        "Run `go test ./...` from repo root",
        "Record failures and triage next tasks",
        "Mark regression checks resolved when green"
      ],
      "updated_at": "2026-02-13T20:43:36Z",
      "files": [
        "to-do.json"
      ],
      "blockers": [
        "`run patch` path behavior is still unstable (missing-task/format validation and no-task mode exit codes do not match expected outcomes)",
        "`run patch` returns unexpected exit codes and argument/format validation behavior in no-task and export paths",
        "patch apply and score JSON envelopes are empty or missing in several code paths, causing JSON parse failures",
        "patch-apply and score/reporting paths return missing/empty JSON envelopes in several branches, causing JSON parse failures",
        "run compare/score/patch command contracts still mismatch expected schema and output semantics",
        "run compare/score/patch command contracts still mismatch expected schema/output semantics and are failing golden/schema assertions",
        "run score/compare tests report scoring and duration metric deltas that do not match expected values (duration totals, failure counts, weighted components)",
        "run score/compare tests report scoring and duration metric mismatches against golden expectations"
      ]
    },
    {
      "id": "T056",
      "title": "Add hook environment contract tests for v1",
      "priority": 3,
      "status": "done",
      "details": "Added v1 hook env integration coverage for task and verify hooks with scoped contract assertions.",
      "steps": [
        "Add integration tests for `on_task_start` and `on_verify_*` hooks",
        "Assert task fields are non-empty for task-scoped hooks and empty where expected",
        "Validate verify-only env (`BARE_VERIFY_RESULT`, `BARE_VERIFY_FAILURES`) behavior"
      ],
      "updated_at": "2026-02-13T08:24:46Z",
      "files": [
        "cmd/bare/integration_test.go"
      ]
    },
    {
      "id": "T057",
      "title": "Add exhaustive exit-code mapping tests",
      "priority": 3,
      "status": "done",
      "details": "SPECS v1 requires all domain errors map to documented exit codes. Add tests to guarantee deterministic mapping for all defined error paths.",
      "steps": [
        "Create table-driven tests for `ExitCodeForError` and `ResultForExitCode`",
        "Add CLI-level tests to ensure stable JSON envelope on non-zero exits",
        "Guard against regressions in mapping coverage when new errors are introduced"
      ],
      "updated_at": "2026-02-13T08:26:14Z",
      "files": [
        "cmd/bare/cli_envelope_golden_test.go",
        "internal/domain/errors.go",
        "internal/domain/errors_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T058",
      "title": "Define example fixture contract for real E2E tasks",
      "priority": 2,
      "status": "done",
      "details": "Create a minimal `examples/` structure for realistic tasks that validates bare end-to-end behavior using real model APIs.",
      "steps": [
        "Define per-example layout with `TASK.md`, `seed/`, and `check.sh`",
        "Document required checks contract and expected exit behavior",
        "Add fixtures path conventions that can be discovered by test code deterministically"
      ],
      "updated_at": "2026-02-13T08:01:34Z",
      "files": [
        "examples/README.md",
        "README.md",
        "to-do.json"
      ]
    },
    {
      "id": "T059",
      "title": "Implement opt-in real API E2E test runner for examples",
      "priority": 2,
      "status": "done",
      "details": "Add Go integration test that runs the actual `bare` CLI in temp repos against example tasks using live provider API keys from environment.",
      "steps": [
        "Gate execution with `BARE_REAL_E2E=1` and skip otherwise",
        "Require model API key env and fail with actionable setup message when missing",
        "Copy example `seed/` into `t.TempDir()`, run `bare init`, enqueue task, run `bare run --json`, and execute checks"
      ],
      "updated_at": "2026-02-13T08:02:52Z",
      "files": [
        "cmd/bare/examples_real_e2e_test.go",
        "cmd/bare/integration_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T060",
      "title": "Add first real E2E scenario fixture (landing page)",
      "priority": 2,
      "status": "done",
      "details": "Provide an initial example project fixture that exercises agent-driven implementation and post-run repository assertions through `check.sh`.",
      "steps": [
        "Create `examples/landing-page/TASK.md` with concrete acceptance criteria",
        "Create `examples/landing-page/seed/` starter project files",
        "Create `examples/landing-page/check.sh` that validates expected outputs deterministically"
      ],
      "updated_at": "2026-02-13T08:03:19Z",
      "files": [
        "examples/landing-page/TASK.md",
        "examples/landing-page/check.sh",
        "examples/landing-page/seed/index.html",
        "examples/landing-page/seed/style.css",
        "to-do.json"
      ]
    },
    {
      "id": "T061",
      "title": "Support optional hidden checks for private evaluation",
      "priority": 3,
      "status": "done",
      "details": "Extend real E2E runner with optional hidden checker scripts from external directory so public fixtures remain stable while private validation can run in CI/evaluation.",
      "steps": [
        "Add `BARE_HIDDEN_CHECKS_DIR` lookup in test runner",
        "Run hidden `<example>.sh` after public `check.sh` when present",
        "Keep hidden checks optional and non-blocking when env is not set"
      ],
      "updated_at": "2026-02-13T08:26:33Z",
      "files": [
        "cmd/bare/examples_real_e2e_test.go",
        "README.md",
        "to-do.json"
      ]
    },
    {
      "id": "T062",
      "title": "Document execution model for real example E2E suite",
      "priority": 3,
      "status": "done",
      "details": "Document how to run real API-backed examples locally and in scheduled CI, including env prerequisites and recommended timeout limits.",
      "steps": [
        "Document command invocation and env vars in README",
        "Add contributor guidance for writing new examples and checks",
        "Clarify that suite is opt-in and not part of default fast test path"
      ],
      "updated_at": "2026-02-13T08:32:36Z",
      "files": [
        "README.md",
        "CONTRIBUTING.md",
        "to-do.json"
      ]
    },
    {
      "id": "T063",
      "title": "Align v1 spec with transcript-first provenance direction",
      "priority": 2,
      "status": "done",
      "details": "Updated SPECS v1 with a transcript-first amendment section so change context includes full agent attempts and not only final diffs.",
      "steps": [
        "Document transcript artifact contract under `.bare/transcripts/`",
        "Define review zoom levels (event stream, run summary, milestone summary)",
        "Clarify local-first review and integration relationship with PR/CI"
      ],
      "updated_at": "2026-02-13T01:45:20Z",
      "files": [
        "SPECS_v1.md",
        "to-do.json"
      ]
    },
    {
      "id": "T064",
      "title": "Design transcript storage schema with failed-attempt retention",
      "priority": 2,
      "status": "done",
      "details": "Define stable event schema for `session.jsonl` that captures prompts, responses, commands, verification outcomes, and failed attempts.",
      "steps": [
        "Specify event types and required fields with timestamps",
        "Include explicit failure/retry metadata for model and command attempts",
        "Define compatibility and append-only guarantees"
      ],
      "updated_at": "2026-02-13T08:04:02Z",
      "files": [
        "SPECS_v1.md",
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T065",
      "title": "Build code-to-transcript pointer index for review",
      "priority": 2,
      "status": "done",
      "details": "Create `.bare/transcripts/index.json` mapping changed files (and line anchors when available) to relevant transcript events.",
      "steps": [
        "Define index structure keyed by file path and run id",
        "Emit pointers during or after iteration persistence",
        "Ensure deterministic pointer ordering for stable reviews"
      ],
      "updated_at": "2026-02-13T08:08:36Z",
      "files": [
        "SPECS_v1.md",
        "cmd/bare/tick.go",
        "cmd/bare/trace.go",
        "internal/domain/types.go",
        "to-do.json"
      ]
    },
    {
      "id": "T066",
      "title": "Add transcript-linked review command UX",
      "priority": 3,
      "status": "done",
      "details": "Implement a review-oriented CLI mode that surfaces code pointers with the most relevant transcript context for each changed file.",
      "steps": [
        "Design command surface (for example `bare review run <id>`)",
        "Render concise file-first view with transcript pointers",
        "Support JSON output for machine consumption"
      ],
      "updated_at": "2026-02-13T08:32:04Z",
      "files": [
        "SPECS_v1.md",
        "cmd/bare/main.go",
        "cmd/bare/trace.go",
        "to-do.json"
      ]
    },
    {
      "id": "T067",
      "title": "Introduce SCM adapter boundary with git default",
      "priority": 2,
      "status": "done",
      "details": "Decouple core runtime from direct git assumptions while preserving git as the v1 default adapter for compatibility.",
      "steps": [
        "Define adapter interface for status/add/commit/tag operations",
        "Implement git adapter and migrate existing commit code paths",
        "Document adapter contract and fallback behavior"
      ],
      "updated_at": "2026-02-13T08:10:14Z",
      "files": [
        "SPECS_v1.md",
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "internal/scm/scm.go"
      ]
    },
    {
      "id": "T068",
      "title": "Spike optional jj adapter compatibility",
      "priority": 4,
      "status": "done",
      "details": "Evaluate an initial `jj` adapter implementation and identify contract gaps relative to the git adapter.",
      "steps": [
        "Prototype key operations used by bare workflows",
        "Document behavior differences and migration risks",
        "Define minimum compatibility bar before enabling by config"
      ],
      "updated_at": "2026-02-13T08:42:50Z",
      "files": [
        "SPECS_v1.md",
        "internal/domain/types.go",
        "internal/scm/scm.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T069",
      "title": "Remove worktree-first assumptions from workflow UX",
      "priority": 2,
      "status": "done",
      "details": "Make worktrees optional and ensure default flows prioritize low-friction local iteration with checkpoints/snapshots.",
      "steps": [
        "Audit commands/docs for implicit worktree-first behavior",
        "Set default isolation strategy to non-worktree local flow",
        "Document when worktrees are useful but optional"
      ],
      "updated_at": "2026-02-13T08:12:01Z",
      "files": [
        "README.md",
        "SPECS_v1.md",
        "cmd/bare/tick.go",
        "to-do.json"
      ],
      "blockers": []
    },
    {
      "id": "T070",
      "title": "Define summary zoom levels across run, commit, and tag context",
      "priority": 3,
      "status": "done",
      "details": "Implemented run-level summary zoom levels, deterministic commit/tag milestones, and proof rendering integration for task-scoped run summaries.",
      "steps": [
        "Specify summary schema for run-level and milestone-level views",
        "Map transcript events to summary sections deterministically",
        "Integrate summary generation with existing trace/proof artifacts"
      ],
      "updated_at": "2026-02-13T08:37:00Z",
      "files": [
        "cmd/bare/trace.go",
        "cmd/bare/proof.go",
        "to-do.json"
      ]
    },
    {
      "id": "T071",
      "title": "Add end-to-end tests for transcript-first review workflows",
      "priority": 3,
      "status": "done",
      "details": "Extend integration coverage to assert transcript persistence, pointer index generation, and review command output across realistic example tasks.",
      "steps": [
        "Add fixture scenarios that produce multi-step and failed-attempt histories",
        "Assert transcript files and pointer indices are generated correctly",
        "Validate deterministic review output and JSON mode stability"
      ],
      "updated_at": "2026-02-13T08:41:57Z",
      "files": [
        "cmd/bare/integration_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T072",
      "title": "Implement transcript redaction and privacy controls",
      "priority": 1,
      "status": "done",
      "details": "Add mandatory redaction before transcript persistence so secrets from prompts, command output, and environment do not leak into `.bare/transcripts/` artifacts.",
      "steps": [
        "Define redaction patterns for API keys, bearer tokens, and common credential forms",
        "Support user-defined sensitive pattern configuration in `.bare/config.json`",
        "Apply redaction in transcript write paths and add regression tests for leak prevention"
      ],
      "updated_at": "2026-02-13T07:55:56Z",
      "files": [
        "cmd/bare/integration_test.go",
        "cmd/bare/tick.go",
        "cmd/bare/verify.go",
        "cmd/bare/verify_determinism_test.go",
        "internal/domain/config.go",
        "internal/domain/types.go",
        "internal/execution/executor.go",
        "internal/redaction/redaction.go",
        "internal/redaction/redaction_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T073",
      "title": "Add transcript retention budget and deterministic pruning",
      "priority": 2,
      "status": "done",
      "details": "Bound transcript growth with configurable retention-by-age and size-budget pruning, plus auditable prune summaries.",
      "steps": [
        "Add config fields for transcript retention days and max size budget",
        "Implement deterministic oldest-first pruning with stable tie-breakers",
        "Emit prune summary metadata and verify behavior with integration tests"
      ],
      "updated_at": "2026-02-13T08:16:52Z",
      "files": [
        "SPECS_v1.md",
        "internal/domain/config.go",
        "internal/domain/types.go",
        "cmd/bare/trace.go",
        "cmd/bare/state.go",
        "to-do.json"
      ]
    },
    {
      "id": "T074",
      "title": "Version transcript schemas and enforce compatibility rules",
      "priority": 2,
      "status": "done",
      "details": "Add explicit schema version fields to transcript artifacts and enforce reader compatibility/backward-compatibility behavior.",
      "steps": [
        "Define transcript schema version field(s) for `session.jsonl` and `index.json`",
        "Implement reader behavior for unknown optional fields and version mismatch handling",
        "Add validation/migration guidance and tests for one-version backward compatibility"
      ],
      "updated_at": "2026-02-13T08:19:17Z",
      "files": [
        "SPECS_v1.md",
        "internal/domain/types.go",
        "cmd/bare/trace.go",
        "cmd/bare/trace_test.go",
        "to-do.json",
        "cmd/bare/state.go"
      ]
    },
    {
      "id": "T075",
      "title": "Add metadata tags to run/tick via --meta key=value",
      "priority": 1,
      "status": "done",
      "details": "Introduce repeatable metadata flags so skill orchestrators can tag campaign_id/candidate_id/strategy and carry those tags through artifacts.",
      "steps": [
        "Add repeatable --meta key=value parsing to `bare run` and `bare tick` with deterministic key validation and duplicate-key handling.",
        "Persist run metadata in a stable artifact for each run and include it in machine-readable outputs where appropriate.",
        "Propagate metadata into transcript/proof/summary artifacts used by review and selection flows.",
        "Add argument-validation tests for malformed metadata and duplicate keys."
      ],
      "tags": [
        "cli",
        "metadata",
        "skills"
      ],
      "updated_at": "2026-02-13T20:10:24Z",
      "files": [
        "SPECS_v1.md",
        "SPECS_v2.md",
        "cmd/bare/metadata.go",
        "cmd/bare/metadata_test.go",
        "cmd/bare/run.go",
        "cmd/bare/tick.go",
        "cmd/bare/trace.go",
        "cmd/bare/trace_test.go",
        "internal/domain/types.go",
        "internal/proof/proof.go",
        "to-do.json"
      ]
    },
    {
      "id": "T076",
      "title": "Implement campaign-aware run listing with metadata filters",
      "priority": 1,
      "status": "done",
      "details": "Add a queryable run listing primitive so skills can collect candidate runs by campaign metadata.",
      "steps": [
        "Add `bare run list [--meta key=value] [--json]` to enumerate historical runs.",
        "Load and filter run records using persisted metadata from run artifacts/summaries.",
        "Ensure deterministic ordering and stable JSON schema for automation consumers.",
        "Include pagination/limit controls if needed to keep large repos responsive."
      ],
      "tags": [
        "cli",
        "campaign",
        "skills"
      ],
      "depends_on": [
        "T075"
      ],
      "updated_at": "2026-02-13T20:12:35Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/run.go",
        "to-do.json"
      ]
    },
    {
      "id": "T077",
      "title": "Implement `bare run score <run_id> --json` baseline scorer",
      "priority": 1,
      "status": "done",
      "details": "Expose a stable scoring payload that summarizes run quality for skill-driven winner selection.",
      "steps": [
        "Add scorer command and schema fields: result, verify_overall, failed checks, token totals, durations, command failures, changed file count, and patch stats.",
        "Compute score deterministically from persisted artifacts only (no hidden in-memory state).",
        "Emit `score_version` and per-metric components so selection logic is explainable.",
        "Add unit tests for metric extraction edge cases and missing-artifact handling."
      ],
      "tags": [
        "cli",
        "scoring",
        "skills"
      ],
      "updated_at": "2026-02-13T20:14:50Z",
      "files": [
        "cmd/bare/run.go",
        "cmd/bare/main.go",
        "cmd/bare/run_score_test.go"
      ]
    },
    {
      "id": "T078",
      "title": "Add policy-based scoring via `--policy .bare/score-policy.json`",
      "priority": 2,
      "status": "done",
      "details": "Allow score weighting/gating customization without changing runtime code so advanced skills can tune selection behavior.",
      "steps": [
        "Define score policy file schema (weights, hard gates, tie-breakers) and validation errors.",
        "Apply policy overrides in `bare run score` when `--policy` is supplied.",
        "Include applied-policy provenance in output for auditability.",
        "Add deterministic tests showing policy changes alter winner ordering predictably."
      ],
      "tags": [
        "cli",
        "scoring",
        "policy"
      ],
      "depends_on": [
        "T077"
      ],
      "updated_at": "2026-02-13T20:32:40Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/run_compare.go",
        "cmd/bare/run_score.go",
        "cmd/bare/run_score_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T079",
      "title": "Implement `bare run patch <run_id> --format unified`",
      "priority": 1,
      "status": "done",
      "details": "Provide first-class patch export for candidate runs so skills can promote winners without custom diff scraping.",
      "steps": [
        "Add `bare run patch` command with deterministic unified diff output.",
        "Resolve changed files from run artifacts/transcript pointers and generate reproducible ordering.",
        "Support writing patch output to stdout and optional file path.",
        "Return clear machine-readable errors when patch extraction is unavailable."
      ],
      "tags": [
        "cli",
        "patch",
        "skills"
      ],
      "updated_at": "2026-02-13T20:20:04Z",
      "files": [
        "cmd/bare/run.go",
        "cmd/bare/main.go",
        "cmd/bare/run_patch.go",
        "cmd/bare/run_patch_test.go"
      ]
    },
    {
      "id": "T080",
      "title": "Add `bare patch apply` with --check and --apply modes",
      "priority": 1,
      "status": "done",
      "details": "Enable safe winner promotion by validating patch applicability before mutating the main workspace.",
      "steps": [
        "Implement `bare patch apply --check <patch_file>` dry-run conflict detection.",
        "Implement `bare patch apply --apply <patch_file>` with atomic behavior and explicit failure semantics.",
        "Emit deterministic JSON envelopes for both check and apply paths.",
        "Add regression tests for conflict detection, no-op patches, and partial-failure rollback."
      ],
      "tags": [
        "cli",
        "patch",
        "safety"
      ],
      "depends_on": [
        "T079"
      ],
      "updated_at": "2026-02-13T20:22:52Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/patch.go",
        "cmd/bare/patch_apply_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T081",
      "title": "Implement `bare run compare <run_a> <run_b> --json`",
      "priority": 1,
      "status": "done",
      "details": "Expose side-by-side candidate comparison with explicit winner rationale so orchestration skills can choose outcomes confidently.",
      "steps": [
        "Add compare command that loads score payloads for two run IDs.",
        "Return per-metric deltas and recommended winner with reason codes.",
        "Use deterministic tie-breakers and include tie diagnostics when no clear winner exists.",
        "Add tests for compare ordering, ties, and missing-run behavior."
      ],
      "tags": [
        "cli",
        "compare",
        "skills"
      ],
      "depends_on": [
        "T077"
      ],
      "updated_at": "2026-02-13T20:27:05Z",
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/run.go",
        "cmd/bare/run_compare.go",
        "cmd/bare/run_compare_test.go",
        "to-do.json"
      ]
    },
    {
      "id": "T082",
      "title": "Add integration and golden tests for new selection primitives",
      "priority": 1,
      "status": "done",
      "details": "Validate end-to-end skill-facing reliability for metadata, scoring, patching, and compare workflows.",
      "steps": [
        "Add integration tests covering metadata-tagged campaign runs and filtered run listing.",
        "Add golden tests for run score/compare output schema stability.",
        "Add end-to-end tests for patch export + patch apply check/apply promotion flow.",
        "Verify exit-code and single-envelope JSON behavior across all new commands."
      ],
      "tags": [
        "tests",
        "integration",
        "golden"
      ],
      "depends_on": [
        "T075",
        "T076",
        "T077",
        "T078",
        "T079",
        "T080",
        "T081"
      ],
      "updated_at": "2026-02-13T20:30:26Z",
      "files": [
        "cmd/bare/run_selection_primitives_integration_test.go",
        "cmd/bare/testdata/cli/run-compare-schema.golden",
        "cmd/bare/testdata/cli/run-score-schema.golden",
        "to-do.json"
      ]
    },
    {
      "id": "T083",
      "title": "Document skill-only orchestration workflow using new primitives",
      "priority": 2,
      "status": "done",
      "details": "Provide operator guidance for candidate-run orchestration without adding core multi-agent scheduler complexity.",
      "steps": [
        "Document campaign/candidate tagging conventions and examples in README/docs.",
        "Document reference flow: run list -> run score -> run compare -> run patch -> patch apply.",
        "Include failure handling guidance for non-applicable patches and missing artifacts.",
        "Add a concise runbook that advanced skills can follow deterministically."
      ],
      "tags": [
        "docs",
        "skills",
        "workflow"
      ],
      "depends_on": [
        "T075",
        "T076",
        "T077",
        "T079",
        "T080",
        "T081"
      ],
      "updated_at": "2026-02-13T20:33:03Z",
      "files": [
        "SPECS_v2.md",
        "to-do.json"
      ]
    },
    {
      "id": "T084",
      "title": "Define provider/model architecture contracts and maintainer ADR",
      "priority": 1,
      "status": "done",
      "details": "Create a stable architecture contract so adding providers or model families requires adding modules, not editing fragile switch statements.",
      "steps": [
        "Write an ADR describing provider registry boundaries, wire protocol abstraction, and normalized response events.",
        "Define Go interfaces and DTOs for provider transport, auth/header injection, and response normalization.",
        "Document invariants for endpoint composition, retries, timeout behavior, and transcript persistence."
      ],
      "tags": [
        "architecture",
        "providers",
        "models",
        "maintainability"
      ],
      "files": [
        "docs/adr/0001-provider-model-architecture.md",
        "internal/model/provider.go",
        "internal/model/types.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:15:00Z",
      "updated_at": "2026-02-14T12:08:19Z"
    },
    {
      "id": "T085",
      "title": "Refactor model adapter into provider registry and endpoint builder",
      "priority": 1,
      "status": "done",
      "details": "Replace provider conditionals with a registry + builder pattern so each provider owns its own URL/auth/request wiring.",
      "steps": [
        "Introduce provider registry keyed by provider ID with deterministic lookup and explicit unknown-provider errors.",
        "Extract endpoint normalization/composition into provider-scoped builders with strict URL validation.",
        "Move auth/header composition behind provider adapters to reduce shared branching logic."
      ],
      "tags": [
        "refactor",
        "providers",
        "runtime"
      ],
      "depends_on": [
        "T084"
      ],
      "files": [
        "internal/model/registry.go",
        "internal/model/openai_provider.go",
        "internal/model/model.go"
      ],
      "created_at": "2026-02-14T12:16:00Z",
      "updated_at": "2026-02-14T12:09:21Z"
    },
    {
      "id": "T086",
      "title": "Implement OpenAI Responses API transport and SSE parser",
      "priority": 1,
      "status": "done",
      "details": "Add first-class Responses API support to remove brittle Chat Completions assumptions for GPT-5 class models.",
      "steps": [
        "Implement request builder for `/v1/responses` with model/instructions/input/tools/reasoning controls.",
        "Implement SSE event parsing for output items, text deltas, completion, and failure events.",
        "Map parsed events to normalized internal response items usable by command extraction and transcript writers."
      ],
      "tags": [
        "openai",
        "responses-api",
        "streaming"
      ],
      "depends_on": [
        "T084",
        "T085"
      ],
      "files": [
        "internal/model/model.go",
        "internal/model/openai_provider.go",
        "internal/model/openai_responses.go",
        "internal/model/openai_sse.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:17:00Z",
      "updated_at": "2026-02-14T12:12:05Z"
    },
    {
      "id": "T087",
      "title": "Harden assistant text extraction to handle structured outputs",
      "priority": 1,
      "status": "done",
      "details": "Eliminate false `model response text is missing` failures by deriving final assistant text from completed structured output items.",
      "steps": [
        "Prefer completed message/output-item content over transient delta-only buffers.",
        "Support extraction from structured content blocks while preserving raw payload for diagnostics.",
        "Only emit missing-text errors when response is complete and no usable assistant text exists."
      ],
      "tags": [
        "parsing",
        "reliability",
        "models"
      ],
      "depends_on": [
        "T086"
      ],
      "files": [
        "internal/model/model.go",
        "internal/model/model_test.go",
        "internal/model/response_parser.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:18:00Z",
      "updated_at": "2026-02-14T12:13:03Z"
    },
    {
      "id": "T088",
      "title": "Introduce model capability resolver and metadata source",
      "priority": 1,
      "status": "done",
      "details": "Drive behavior from model capabilities instead of name-prefix heuristics to make new model onboarding predictable.",
      "steps": [
        "Define model capability schema (reasoning support, verbosity, preferred wire API, context window).",
        "Load capabilities from bundled metadata with optional remote refresh path.",
        "Resolve model metadata by exact or longest-prefix matching with deterministic fallback behavior."
      ],
      "tags": [
        "metadata",
        "models",
        "capabilities"
      ],
      "depends_on": [
        "T084"
      ],
      "files": [
        "internal/model/capabilities.go",
        "internal/model/models.json",
        "internal/model/model.go",
        "internal/model/openai_provider.go",
        "internal/model/model_test.go"
      ],
      "created_at": "2026-02-14T12:19:00Z",
      "updated_at": "2026-02-14T12:13:56Z"
    },
    {
      "id": "T089",
      "title": "Select transport by model capability with deterministic fallback",
      "priority": 1,
      "status": "done",
      "details": "Choose chat/responses transport from resolved model capabilities and fail over safely when server capabilities differ.",
      "steps": [
        "Add transport selection layer that maps provider+model capability to wire API implementation.",
        "Implement fallback from preferred transport on known compatibility errors.",
        "Emit deterministic transcript events indicating selected transport and fallback reason."
      ],
      "tags": [
        "transport",
        "fallback",
        "models"
      ],
      "depends_on": [
        "T086",
        "T088"
      ],
      "files": [
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "internal/model/model.go",
        "internal/model/model_test.go",
        "internal/model/transport_router.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:20:00Z",
      "updated_at": "2026-02-14T12:18:23Z"
    },
    {
      "id": "T090",
      "title": "Normalize provider error taxonomy and retry policy",
      "priority": 1,
      "status": "done",
      "details": "Create a stable cross-provider error model so retry and user-facing diagnostics remain consistent as providers expand.",
      "steps": [
        "Classify provider errors into auth, rate-limit, quota, context-window, invalid-request, and transient classes.",
        "Map each class to deterministic retry/no-retry behavior and domain error codes.",
        "Add structured diagnostics fields for status code, provider code, and remediation hint."
      ],
      "tags": [
        "errors",
        "retries",
        "providers"
      ],
      "depends_on": [
        "T085"
      ],
      "files": [
        "internal/model/errors.go",
        "internal/model/model.go",
        "internal/model/retry.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:21:00Z",
      "updated_at": "2026-02-14T12:31:23Z"
    },
    {
      "id": "T091",
      "title": "Expand config schema for multi-provider model support",
      "priority": 1,
      "status": "done",
      "details": "Make provider/model configuration explicit and extensible so new providers can be onboarded via config, not code edits.",
      "steps": [
        "Add provider map in config with base_url, wire_api, env_key, headers, and retry options.",
        "Implement startup validation with actionable errors for malformed provider config.",
        "Add migration compatibility for existing flat env vars and config keys."
      ],
      "tags": [
        "config",
        "schema",
        "providers"
      ],
      "depends_on": [
        "T084",
        "T085"
      ],
      "files": [
        "internal/domain/config.go",
        "internal/domain/config_test.go",
        "internal/model/model.go",
        "internal/model/transport_router.go",
        "cmd/bare/tick.go",
        "SPECS_v1.md",
        "README.md"
      ],
      "created_at": "2026-02-14T12:22:00Z",
      "updated_at": "2026-02-14T12:39:05Z"
    },
    {
      "id": "T092",
      "title": "Build provider contract test harness with request/stream fixtures",
      "priority": 1,
      "status": "done",
      "details": "Add contract tests that lock endpoint composition, payload fields, stream parsing, and error mapping behavior across providers.",
      "steps": [
        "Create local mock server fixture layer for unary and SSE flows.",
        "Add tests for endpoint normalization, payload shape, and transport fallback behavior.",
        "Add regression tests for GPT-5 token-field handling and empty-text structured responses."
      ],
      "tags": [
        "tests",
        "contracts",
        "regression"
      ],
      "depends_on": [
        "T086",
        "T087",
        "T089",
        "T090"
      ],
      "files": [
        "cmd/bare/integration_test.go",
        "internal/model/openai_responses_test.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:23:00Z",
      "updated_at": "2026-02-14T12:51:33Z"
    },
    {
      "id": "T093",
      "title": "Add opt-in real API smoke suite for provider/model matrix",
      "priority": 2,
      "status": "done",
      "details": "Provide a lightweight real-API validation path to catch integration drift before release without forcing default test runs.",
      "steps": [
        "Add env-gated smoke tests for OpenAI GPT-5 mini and GPT-4o with deterministic mini prompts.",
        "Assert successful assistant text extraction, command parsing, and non-empty usage metadata.",
        "Document required env vars and expected costs/time for smoke runs."
      ],
      "tags": [
        "tests",
        "smoke",
        "real-api"
      ],
      "depends_on": [
        "T086",
        "T087",
        "T089"
      ],
      "files": [
        "README.md",
        "cmd/bare/integration_real_model_test.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:24:00Z",
      "updated_at": "2026-02-14T13:10:59Z"
    },
    {
      "id": "T094",
      "title": "Write maintainer docs for adding providers and models",
      "priority": 1,
      "status": "done",
      "details": "Produce explicit, teachable documentation so future contributors can add providers/models with minimal tribal knowledge.",
      "steps": [
        "Document architecture flow from config -> provider registry -> transport -> normalized response.",
        "Create `Adding a Provider` guide with required interfaces, config keys, tests, and common pitfalls.",
        "Create `Adding a Model` guide describing capability metadata and validation checklist."
      ],
      "tags": [
        "docs",
        "maintainers",
        "onboarding"
      ],
      "depends_on": [
        "T084",
        "T091",
        "T092"
      ],
      "files": [
        "docs/model-architecture.md",
        "docs/adding-provider.md",
        "docs/adding-model.md",
        "README.md"
      ],
      "created_at": "2026-02-14T12:25:00Z",
      "updated_at": "2026-02-14T12:52:02Z"
    },
    {
      "id": "T095",
      "title": "Publish troubleshooting runbook for model/provider failures",
      "priority": 2,
      "status": "done",
      "details": "Create an operator-facing troubleshooting matrix for endpoint, auth, payload, and streaming issues; add expected debug snippets and artifact checklists for 400/401/404/429 and empty-response failures.",
      "steps": [
        "Document symptom -> cause -> fix mappings for 400/401/404/429 and empty-response failures.",
        "Add reproducible debug command snippets and expected outputs for each failure class.",
        "Define logging/event fields maintainers should inspect first during incident response."
      ],
      "tags": [
        "docs",
        "operations",
        "troubleshooting"
      ],
      "depends_on": [
        "T090",
        "T094"
      ],
      "files": [
        "README.md",
        "docs/model-troubleshooting.md",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:26:00Z",
      "updated_at": "2026-02-14T13:13:02Z"
    },
    {
      "id": "T096",
      "title": "Migrate OpenAI default path to Responses-first and deprecate legacy branch",
      "priority": 1,
      "status": "done",
      "details": "Finalize migration by making Responses transport the default for OpenAI while preserving controlled fallback and clear deprecation messaging.",
      "steps": [
        "Switch OpenAI default transport to Responses API in runtime config defaults.",
        "Gate legacy chat path behind explicit compatibility flag and emit deprecation notice.",
        "Remove obsolete model-prefix token parameter heuristics after migration confidence is established."
      ],
      "tags": [
        "migration",
        "openai",
        "cleanup"
      ],
      "depends_on": [
        "T086",
        "T087",
        "T089",
        "T092",
        "T094"
      ],
      "files": [
        "SPECS_v1.md",
        "cmd/bare/integration_test.go",
        "cmd/bare/tick.go",
        "internal/domain/config.go",
        "internal/domain/types.go",
        "internal/model/model.go",
        "internal/model/model_test.go",
        "internal/model/transport_router.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T12:27:00Z",
      "updated_at": "2026-02-14T12:55:41Z"
    },
    {
      "id": "T097",
      "title": "Add Z.AI GLM capability metadata and support checks",
      "priority": 1,
      "status": "done",
      "details": "Extend the existing capability catalog with Z.AI GLM metadata so model behavior is capability-driven and provider modules stay declarative for `zai`.",
      "steps": [
        "Add a `zai` provider section to `internal/model/models.json` with default capability and exact/family-prefix entries for GLM-5 and GLM-4.x families plus aliases.",
        "Include all known GLM variants from the findings: `glm-5`, `glm-4.7`, `glm-4.7-flash`, `glm-4.7-flashx`, `glm-4.6`, `glm-4.5*`, `glm-4-32b-0414-128k` with deterministic context-window and wire-choice metadata.",
        "Align metadata fields with current schema (`preferred_wire_api`, `supports_reasoning`, `supports_verbosity`, `context_window`) and ensure deterministic longest-prefix fallback behavior for unknown suffixes.",
        "Add/extend capability tests (create `internal/model/capabilities_test.go` if absent, otherwise extend `internal/model/model_test.go`) for exact hit, family-prefix hit, and unsupported-name guard for ZAI."
      ],
      "tags": [
        "zai",
        "models",
        "capabilities"
      ],
      "depends_on": [
        "T088"
      ],
      "files": [
        "internal/model/capabilities.go",
        "internal/model/capabilities_test.go",
        "internal/model/models.json",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T12:50:38Z",
      "created_at": "2026-02-14T12:32:00Z"
    },
    {
      "id": "T098",
      "title": "Add ZAI provider transport module and registry wiring",
      "priority": 1,
      "status": "done",
      "details": "Introduce Z.AI as a first-class provider module so runtime behavior stays provider-agnostic and provider modules own endpoint/auth/payload/parse behavior.",
      "steps": [
        "Create `internal/model/zai_provider.go` with `providerZAI` constant, provider spec (`APIKeyEnvVar: ZAI_API_KEY`), endpoint normalization, payload builder, auth, and response parser.",
        "Set `defaultZAIEndpoint` to `https://api.z.ai/api/paas/v4/chat/completions`, with deterministic normalization for host-only and root-style base URLs plus proxy-path passthrough.",
        "Register ZAI in `internal/model/registry.go` default registry initialization, and add tests that assert provider discoverability and spec shape through the registry.",
        "Keep `NewAdapter` and `SendPrompt` generic; verify no provider-specific request-shaping/auth/parsing logic remains in `internal/model/model.go`."
      ],
      "tags": [
        "zai",
        "providers",
        "runtime"
      ],
      "depends_on": [
        "T085"
      ],
      "files": [
        "internal/model/model.go",
        "internal/model/model_test.go",
        "internal/model/registry.go",
        "internal/model/zai_provider.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T12:56:45Z",
      "created_at": "2026-02-14T12:33:00Z"
    },
    {
      "id": "T099",
      "title": "Implement GLM-5/GLM-4.x payload and response compatibility",
      "priority": 1,
      "status": "done",
      "details": "Coordinate GLM payload parsing and response handling work in the ZAI provider module, split into composable delivery tasks.",
      "steps": [
        "Complete T103 and T104, then validate provider-level GLM-5 and GLM-4.x smoke coverage before closing this parent task."
      ],
      "tags": [
        "zai",
        "models",
        "api"
      ],
      "depends_on": [
        "T103",
        "T104"
      ],
      "files": [
        "internal/model/model_test.go",
        "internal/model/zai_provider.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T12:58:03Z",
      "created_at": "2026-02-14T12:34:00Z"
    },
    {
      "id": "T103",
      "title": "Build Z.AI GLM request payload matrix",
      "priority": 1,
      "status": "done",
      "details": "Implement deterministic Z.AI payload shaping in `zai_provider.go` with model-aware optional fields and defaults.",
      "steps": [
        "Implement `BuildPayload` for Z.AI chat-completion schema and confirm current prompt field mapping.",
        "Set `max_tokens` in a model-agnostic way and only add capability-gated options (`thinking`, `tool_stream`) when supported.",
        "Add unit tests for `glm-5`, `glm-4.7`, `glm-4.6`, and `glm-4.5` payload shapes from capability metadata.",
        "Document behavior for unsupported fields to prevent accidental schema leakage from non-Z.AI models."
      ],
      "tags": [
        "zai",
        "models",
        "api"
      ],
      "depends_on": [
        "T097",
        "T098"
      ],
      "files": [
        "ZAI-PLAN.md",
        "internal/model/capabilities.go",
        "internal/model/capabilities_test.go",
        "internal/model/model_test.go",
        "internal/model/models.json",
        "internal/model/zai_provider.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T12:58:58Z",
      "created_at": "2026-02-14T14:10:00Z"
    },
    {
      "id": "T104",
      "title": "Build Z.AI GLM response parsing matrix",
      "priority": 1,
      "status": "done",
      "details": "Normalize Z.AI response handling by extracting assistant text safely across normal and tool-call payload variants.",
      "steps": [
        "Implement parser in the ZAI provider module to convert chat-completion responses into `NormalizedModelResponse`.",
        "Add fallback extraction for plain text, structured `content` items, and tool-related response shapes without dropping valid model output.",
        "Add regression tests for malformed/edge payloads that should still return actionable parsing errors and diagnostics.",
        "Keep parser behavior provider-local with no branching in generic adapter response handling."
      ],
      "tags": [
        "zai",
        "models",
        "parser"
      ],
      "depends_on": [
        "T097",
        "T098"
      ],
      "files": [
        "internal/model/zai_provider.go",
        "internal/model/model_test.go"
      ],
      "updated_at": "2026-02-14T13:00:11Z",
      "created_at": "2026-02-14T14:10:00Z"
    },
    {
      "id": "T100",
      "title": "Add GLM model compatibility validation and deterministic fallback policy",
      "priority": 1,
      "status": "done",
      "details": "Coordinate ZAI fallback/validation and model observability wiring after parser payload work is in place.",
      "steps": [
        "Complete this task after T105 and T106 are finished; keep model selection and transport routing deterministic across attempts."
      ],
      "tags": [
        "zai",
        "fallback",
        "reliability"
      ],
      "depends_on": [
        "T105",
        "T106"
      ],
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/trace.go",
        "internal/domain/types.go",
        "internal/model/model.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T13:19:26Z",
      "created_at": "2026-02-14T12:35:00Z",
      "blockers": []
    },
    {
      "id": "T105",
      "title": "Add deterministic GLM model validation and fallback resolver",
      "priority": 1,
      "status": "done",
      "details": "Implement strict candidate resolution and fail-fast behavior for ZAI model names before network attempts, including deterministic glm fallback resolution and model tests in internal/model/model_test.go.",
      "steps": [
        "Build ordered candidate list resolver (`primary` -> `glm-4.7` -> `glm-4.6` -> `glm-4.5` -> config fallback).",
        "Reject unsupported primary models with clear non-retryable validation error and preserve configured fallback for explicit chains.",
        "Preserve provider-local behavior and only vary model/transports in deterministic adapter selection.",
        "Add model tests for valid, fallback, and unsupported primary-model paths."
      ],
      "tags": [
        "zai",
        "fallback",
        "reliability"
      ],
      "depends_on": [
        "T099",
        "T097"
      ],
      "files": [
        "internal/model/capabilities.go",
        "internal/model/model.go",
        "internal/model/model_test.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T13:02:55Z",
      "created_at": "2026-02-14T14:10:00Z"
    },
    {
      "id": "T106",
      "title": "Add fallback attempt observability to model response artifacts",
      "priority": 1,
      "status": "done",
      "details": "Persist model selection and fallback attempts in transcript and iteration artifacts for deterministic postmortems.",
      "steps": [
        "Add selected/attempted model fields to model response metadata in adapter output.",
        "Surface attempted/selected model fields in `model.response` transcript events and iteration-level summaries.",
        "Expose fallback metadata in response-level error diagnostics so retry/failure telemetry remains actionable.",
        "Update `domain`/trace record types and tests to cover fields are present when fallback occurs."
      ],
      "tags": [
        "zai",
        "observability",
        "telemetry"
      ],
      "depends_on": [
        "T105"
      ],
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/trace.go",
        "cmd/bare/trace_test.go",
        "internal/domain/types.go",
        "internal/domain/types_test.go",
        "internal/model/errors.go",
        "internal/model/model.go",
        "internal/model/model_test.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T13:08:38Z",
      "created_at": "2026-02-14T14:10:00Z"
    },
    {
      "id": "T101",
      "title": "Add Z.AI run-time integration test coverage and key detection",
      "priority": 2,
      "status": "done",
      "details": "Exercise the ZAI path in both mocked and optional real API flows, with explicit `ZAI_API_KEY` and model defaults.",
      "steps": [
        "Update model-key requirement checks to accept `ZAI_API_KEY` alongside existing provider keys.",
        "Add ZAI-aware defaults in example runtime configuration helper (`BARE_MODEL_PROVIDER=zai`, `BARE_MODEL_NAME=glm-5`).",
        "Add a dedicated mock ZAI success path test in `internal/model/model_test.go` and a fixture-style real-run smoke path in `cmd/bare/examples_real_e2e_test.go` that only runs under opt-in env.",
        "Avoid references to non-existent test files; keep real API smoke path discoverable and documented as opt-in."
      ],
      "tags": [
        "zai",
        "tests",
        "real-api"
      ],
      "depends_on": [
        "T099",
        "T100"
      ],
      "files": [
        "README.md",
        "cmd/bare/examples_real_e2e_test.go",
        "cmd/bare/integration_test.go",
        "internal/model/model_test.go",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T13:16:33Z",
      "created_at": "2026-02-14T12:36:00Z"
    },
    {
      "id": "T102",
      "title": "Document Z.AI onboarding, feature matrix, and operational runbook updates",
      "priority": 2,
      "status": "done",
      "details": "Publish practical operator guidance for GLM model selection, migration, and failure handling, aligned with the ADR provider/model contract.",
      "steps": [
        "Update README with Z.AI config examples, env var guidance, and model recommendation tiers (glm-5 vs older variants).",
        "Add model-family docs including token window/capability differences for 200k vs 128k variants.",
        "Add troubleshooting entries for 400/401/404/429-style responses and empty-response edge cases in Z.AI context.",
        "Cross-link docs from existing provider/model architecture and troubleshooting resources, and document model fallback observability expectations."
      ],
      "tags": [
        "docs",
        "operations",
        "zai"
      ],
      "depends_on": [
        "T100",
        "T101",
        "T095",
        "T094"
      ],
      "files": [
        "README.md",
        "docs/adding-model.md",
        "docs/adding-provider.md",
        "docs/model-troubleshooting.md",
        "to-do.json"
      ],
      "updated_at": "2026-02-14T13:17:30Z",
      "created_at": "2026-02-14T12:37:00Z"
    },
    {
      "id": "T108",
      "title": "Add OpenAI tool schema and tool-call-compatible request payload shaping",
      "priority": 1,
      "status": "done",
      "details": "Add minimal, deterministic tool definitions to OpenAI-compatible requests so the server knows exactly which functions are expected without introducing broad tool DSLs.",
      "steps": [
        "Extend `openAIResponseTool` to include type/name/description and typed arguments schema for a minimal `local_shell` tool.",
        "Add `tools` + `tool_choice` handling in `buildOpenAIResponsesPayload` keyed off `supports_tool_stream` and/or explicit model capability flags.",
        "Keep tool schema small and deterministic: same tool list/order/order of fields on every call.",
        "Add tests in `openai_responses_test.go` that assert tool schema is omitted/added only for configured tool-capable models."
      ],
      "depends_on": [
        "T088",
        "T086",
        "T097",
        "T107"
      ],
      "files": [
        "internal/model/openai_provider.go",
        "internal/model/openai_responses.go",
        "internal/model/openai_responses_test.go",
        "internal/model/types.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T22:57:16Z",
      "updated_at": "2026-02-14T23:05:06Z"
    },
    {
      "id": "T109",
      "title": "Implement deterministic tool execution loop between model turns in tick",
      "priority": 1,
      "status": "done",
      "details": "Extend `bare tick` so a task can drive a bounded tool-use cycle across multiple model turns without losing determinism. After each model response, collect ordered tool-call items, execute each tool synchronously in deterministic ID/input order, feed stable tool results back as a response item stream, and continue looping up to the existing max-model-turns boundary with explicit scheduler outcomes.",
      "steps": [
        "Parse and retain deterministic tool-call ordering from every normalized model item set and persist per-turn execution context.",
        "Execute tools in strict sequence with a bounded retry/no-retry policy and stable stdout/stderr capture paths.",
        "Append tool-call execution results to model transcript/input as structured assistant/tool messages in a single, reproducible JSON payload.",
        "Add termination rules for: no tool calls, unsupported item kinds, exhausted tool turns, and explicit model/tool-call errors.",
        "Keep task status/result transitions reproducible by moving to `in_progress` only when at least one executable tool result is produced."
      ],
      "depends_on": [
        "T107",
        "T108",
        "T010"
      ],
      "tags": [
        "model",
        "loop",
        "determinism",
        "execution"
      ],
      "files": [
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "internal/execution/executor.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T23:10:00Z",
      "updated_at": "2026-02-14T23:17:00Z"
    },
    {
      "id": "T110",
      "title": "Capture tool-call lifecycle in transcripts and iteration artifacts",
      "priority": 1,
      "status": "done",
      "details": "Persist full tool-call lifecycle evidence for every tick iteration, including planned tool calls, execution request/response material, and model follow-up calls, so run diagnostics can reconstruct exactly how and why a model loop moved from one turn to another without relying on ephemeral console logs.",
      "steps": [
        "Extend iteration artifacts to include a normalized tool_call_items block per turn with stable indices, IDs, names, and input snapshots.",
        "Record per-tool execution result artifacts that include command, exit status, duration, stdout/stderr file paths, and normalized error text.",
        "Add transcript entries for tool-turn boundaries (`tool_call_planned`, `tool_call_started`, `tool_call_completed`, `tool_turn_ended`) with deterministic event schema and ordering.",
        "Expose tool-call summaries in run metadata (counts, first-failure class, last-tool-turn index) for quick operator triage.",
        "Ensure transcript writes remain append-only and backward-compatible when tool-loop is not enabled."
      ],
      "depends_on": [
        "T109"
      ],
      "tags": [
        "transcripts",
        "artifacts",
        "observability",
        "model"
      ],
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/trace.go",
        "internal/domain/types.go",
        "internal/storage/atomic.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T23:12:00Z",
      "updated_at": "2026-02-14T23:19:01Z"
    },
    {
      "id": "T111",
      "title": "Add target model and capability entries for glm-5, gpt-5.2, sonnet, and opus tool-capability matrix",
      "priority": 1,
      "status": "done",
      "details": "Populate provider capability metadata for the new generation and legacy-capability coverage set so capability-driven transport, schema inclusion, and parser behavior are stable for all target models. This must avoid heuristic overreach and ensure tool features are only enabled when explicitly known.",
      "steps": [
        "Add deterministic capability rows for `glm-5`, `gpt-5.2`, `sonnet`, and `opus` in `internal/model/models.json` and any cached resolution path.",
        "Assign explicit flags for supports_tool_stream, supports_tool_calls, preferred_wire_api, max_output_tokens policy, and tool-call compatibility notes.",
        "Add fallback-safe tests in capability loading/parsing that reject unknown defaults and validate exact model lookup precedence (exact > longest-prefix > wildcard > global defaults).",
        "Document any known differences in default wire API and payload fields per provider/model pair for operators and test harness maintainability."
      ],
      "depends_on": [
        "T107",
        "T108"
      ],
      "tags": [
        "model",
        "capability",
        "provider"
      ],
      "files": [
        "README.md",
        "internal/model/capabilities.go",
        "internal/model/capabilities_test.go",
        "internal/model/models.json",
        "to-do.json"
      ],
      "created_at": "2026-02-14T23:14:00Z",
      "updated_at": "2026-02-14T23:21:25Z"
    },
    {
      "id": "T112",
      "title": "Align OpenAI/Anthropic transport compatibility for target models",
      "priority": 1,
      "status": "done",
      "details": "Make transport selection explicit and stable for models that should use tool-capable responses vs responses-style chat compatibility, preventing silent fallback drift between model families and providers. The result should be deterministic even under partial provider support.",
      "steps": [
        "Add transport compatibility matrix cases for OpenAI and Anthropic target families currently using partial legacy compatibility.",
        "Restrict fallback paths to known-safe transitions only when capability negotiation or explicit config permits.",
        "Normalize model->provider wire API decision logging so each tick records both requested and effective route.",
        "Add unit coverage for the critical boundary cases (unsupported transport, feature-gated capability mismatch, and explicit override scenarios).",
        "Verify fallback reason messaging is user-visible and non-invasive to existing non-tool-call workloads."
      ],
      "depends_on": [
        "T111",
        "T109"
      ],
      "tags": [
        "model",
        "transport",
        "provider",
        "compatibility"
      ],
      "files": [
        "internal/model/adapter_test.go",
        "internal/model/capabilities.go",
        "internal/model/model_test.go",
        "internal/model/transport_router.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T23:16:00Z",
      "updated_at": "2026-02-14T23:25:08Z",
      "blockers": []
    },
    {
      "id": "T113",
      "title": "Add integration tests for codex/opencode/PI-inspired model tool-loop behavior",
      "priority": 1,
      "status": "done",
      "details": "Create end-to-end model-loop integration coverage that exercises full multi-turn tool execution in `bare tick`, including mixed command/tool/fail patterns, to prevent regressions in deterministic extraction, execution order, and artifact emission.",
      "steps": [
        "Add fixture-driven tests that emulate codex/opencode/PI-style tool-call payloads and responses for OpenAI, Anthropic-compatible, and Z.AI endpoints.",
        "Assert bounded turn behavior (tool round-trips stop correctly), explicit state progression, and no hidden retries beyond configured limits.",
        "Validate transcript and iteration artifacts include tool_call_lifecycle records and stable event ordering under success, timeout, and malformed-tool-call scenarios.",
        "Exercise model transport fallback and capability mismatch paths to ensure loop chooses expected transport while preserving deterministic outputs.",
        "Integrate tests into existing `internal/model` and `cmd/bare` test suites according to package responsibility."
      ],
      "depends_on": [
        "T109",
        "T110",
        "T112"
      ],
      "tags": [
        "test",
        "integration",
        "model",
        "tool-loop"
      ],
      "files": [
        "cmd/bare/integration_test.go",
        "internal/model/model_test.go",
        "internal/model/openai_test.go",
        "internal/model/zai_provider_test.go",
        "to-do.json"
      ],
      "created_at": "2026-02-14T23:18:00Z",
      "updated_at": "2026-02-14T23:29:47Z"
    },
    {
      "id": "T114",
      "title": "Publish migration guidance for model compatibility and tool-loop behavior",
      "priority": 2,
      "status": "done",
      "details": "Ship operator-facing documentation that explains how the new tool-loop affects existing workflows, when to use which model families, how to migrate configs, and what to do when transport/tool-calls or transcripts diverge during rollout.",
      "steps": [
        "Update `README.md` with a practical migration section: old behavior, new tool-loop behavior, and rollback notes.",
        "Document model matrix changes, capability implications per target model, and recommended defaults for reliability vs capability.",
        "Add troubleshooting entries for dropped tool call turns, missing transcripts, compatibility fallbacks, and malformed tool payloads.",
        "Publish upgrade checklist and verification steps including run artifacts you should inspect before/after migration.",
        "Add references to new model/transcript tests so operators can verify local behavior from `go test` and CI expectations."
      ],
      "depends_on": [
        "T111",
        "T113"
      ],
      "tags": [
        "docs",
        "migration",
        "operator-guide"
      ],
      "files": [
        "README.md",
        "docs/adding-provider.md",
        "docs/model-troubleshooting.md",
        "to-do.json"
      ],
      "created_at": "2026-02-14T23:20:00Z",
      "updated_at": "2026-02-14T23:30:57Z"
    },
    {
      "id": "T115",
      "title": "Update README run resume and run-command documentation",
      "priority": 2,
      "status": "done",
      "details": "Updated run/resume docs and added run selection command guidance in README.md and SPECS_v1.md.",
      "steps": [
        "Update --resume docs to describe token/cursor reuse and resumed artifact loading behavior",
        "Clarify that resume should force run continuation rather than starting a new run",
        "Add or link docs for run list/score/compare/patch workflows if these commands are now part of the supported surface",
        "Validate README and SPECS_v1 command references for consistency"
      ],
      "files": [
        "README.md",
        "SPECS_v1.md"
      ],
      "tags": [
        "docs",
        "documentation-consistency"
      ],
      "updated_at": "2026-02-14T23:32:18Z"
    },
    {
      "id": "T116",
      "title": "Implement AGENTS.md support for ecosystem compatibility",
      "priority": 1,
      "status": "done",
      "details": "Add support for AGENTS.md standard to enable project context discovery. This is critical for ecosystem compatibility - all major AI CLIs (Claude Code, Codex, OpenCode, Crush, AmpCode, Pi-Agent) support this standard. Without it, Bare is invisible to the agent ecosystem.\n\n# notes:\nAGENTS.md is the industry standard (created by Sourcegraph/AmpCode). Reference: https://agents.md/. Fallback to CLAUDE.md ensures compatibility with Claude Code projects. This is the #1 gap identified in competitive analysis - without this, Bare cannot interoperate with projects configured for other agents.",
      "steps": [
        "Define AGENTS.md parsing schema (markdown with optional YAML frontmatter)",
        "Implement file discovery: check project root, then parent directories up to $HOME",
        "Parse sections: Build, Test, Lint, Conventions, and custom sections",
        "Integrate AGENTS.md content into system prompt or context injection",
        "Add 'bare init' command to generate AGENTS.md from codebase analysis",
        "Support fallback: CLAUDE.md if AGENTS.md not found (Claude Code compatibility)",
        "Add glob patterns support in frontmatter for targeted file context"
      ],
      "files": [
        "cmd/bare/init.go",
        "cmd/bare/main.go",
        "cmd/bare/tick.go",
        "internal/context/agents_md.go",
        "internal/context/agents_md_test.go",
        "to-do.json"
      ],
      "tags": [
        "ecosystem",
        "context",
        "compatibility",
        "high-priority"
      ],
      "updated_at": "2026-02-16T21:35:37Z"
    },
    {
      "id": "T117",
      "title": "Implement conversation history loading from transcripts",
      "priority": 1,
      "status": "done",
      "details": "Enable Bare to load previous conversation turns from session.jsonl transcripts and build a proper message array for the LLM. Currently SendPrompt() only accepts a single prompt string - it needs to accept a conversation history to enable session resumption.\n\n# acceptance_criteria:\n- Given a session.jsonl with 10 turns, BuildConversationHistory returns 10 messages\n- History is correctly ordered (oldest first)\n- Tool calls and results are properly formatted\n- Truncation keeps system prompt + first 5 + last 45 turns when max=50\n\n# notes:\nThis is foundational for all session resumption features. The message array format must match what each provider expects (Anthropic vs OpenAI have slight differences in tool result formatting).",
      "steps": [
        "Create internal/session/history.go with TranscriptLoader struct",
        "Define Message struct with Role (user/assistant/tool) and Content fields",
        "Implement LoadTranscriptEvents(path string) to parse session.jsonl",
        "Implement BuildConversationHistory(events []TranscriptEvent) []Message",
        "Filter events: only include model.prompt (user) and model.response (assistant) turns",
        "Handle tool results: include tool role messages with proper content",
        "Add max_turns config to limit history size (default: 50 turns)",
        "Add truncate_middle strategy: keep first N and last M turns, summarize middle if needed",
        "Update Adapter.SendPrompt to accept optional []Message history parameter",
        "Add Adapter.SendConversation(ctx, systemPrompt string, history []Message, newUserMessage string) method",
        "Write unit tests for history loading and truncation"
      ],
      "files": [
        "internal/session/history.go",
        "internal/session/history_test.go",
        "internal/session/types.go",
        "internal/model/model.go",
        "internal/model/model_test.go",
        "cmd/bare/tick.go",
        "internal/model/openai_provider.go",
        "internal/model/openai_responses.go",
        "internal/model/anthropic_provider.go",
        "internal/model/zai_provider.go",
        "to-do.json"
      ],
      "tags": [
        "session",
        "context",
        "core-feature"
      ],
      "updated_at": "2026-02-16T21:43:18Z",
      "blockers": []
    },
    {
      "id": "T118",
      "title": "Add resume/continue CLI flags to tick command",
      "priority": 1,
      "status": "done",
      "details": "Add --continue and --resume flags to 'bare tick' command to enable session resumption. --continue resumes the most recent incomplete session. --resume=<run_id> resumes a specific session by run ID.\n\n# acceptance_criteria:\n- 'bare tick --continue' resumes last incomplete session\n- 'bare tick --resume=run_abc123' resumes specific session\n- Resume fails gracefully if session has no history\n- Loop state shows resumed_from_run in state show output\n\n# notes:\nThe --continue flag should be the primary UX. Users shouldn't need to remember run IDs. The flag should 'just work' for the common case.",
      "depends_on": [
        "T117"
      ],
      "steps": [
        "Add --continue flag to tick command: boolean, default false",
        "Add --resume=<run_id> flag: string, specifies exact run to resume",
        "Implement findLatestIncompleteRun(stateDir string) (runID string, error)",
        "Implement loadSessionContext(runID string) ([]Message, error) using T117's history loader",
        "When --continue: find latest run with loop_state != 'done', load its history",
        "When --resume=XYZ: load specific run's history, error if not found",
        "When neither flag: check if auto-resume conditions met (see T119)",
        "Inject loaded history into model request via new SendConversation method",
        "Update tick.go to pass conversation history to model adapter",
        "Add resume_metadata to loop.json: resumed_from_run, resumed_at, resume_count",
        "Write integration tests for resume scenarios"
      ],
      "files": [
        "cmd/bare/cli_arg_parse.go",
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "internal/session/resume.go",
        "internal/session/resume_test.go",
        "to-do.json"
      ],
      "tags": [
        "cli",
        "session",
        "ux"
      ],
      "updated_at": "2026-02-16T21:49:52Z"
    },
    {
      "id": "T119",
      "title": "Implement auto-resume logic for incomplete sessions",
      "priority": 1,
      "status": "done",
      "details": "When 'bare tick' is run without explicit resume flags, automatically check if the last session is incomplete and resume it. This enables the async/cron use case where you just run 'bare tick' repeatedly and it naturally continues work.\n\n# acceptance_criteria:\n- Running 'bare tick' with incomplete session auto-resumes without flags\n- Auto-resume skipped if session is > 24h stale (configurable)\n- --no-auto-resume flag prevents auto-resume\n- Auto-resume reason logged and visible in state show\n\n# notes:\nThis is the key feature for cron/systemd automation. Combined with tick's exit codes, it enables: 'while true; do bare tick; sleep 60; done' pattern.",
      "depends_on": [
        "T117",
        "T118"
      ],
      "steps": [
        "Define 'incomplete session' criteria: loop_state not in ['done', 'finalizing']",
        "Add auto_resume config option (default: true) in config.json under loop section",
        "Implement shouldAutoResume(stateDir string) (bool, runID string, reason string)",
        "Check loop.json: if active=true and last_update < max_age (default 24h), resume",
        "Check transcripts: if last run incomplete and not stale, offer to resume",
        "Add --no-auto-resume flag to disable auto-resume for explicit control",
        "Log auto-resume decision with reason in run.log",
        "Handle stale sessions: if heartbeat stale for > stale_threshold, clear lock first",
        "Update README docs with auto-resume behavior explanation",
        "Add state show output: auto_resume_enabled, last_resume_reason"
      ],
      "files": [
        ".bare/config.json",
        "README.md",
        "cmd/bare/help.go",
        "cmd/bare/tick.go",
        "internal/domain/config.go",
        "internal/domain/types.go",
        "internal/session/auto_resume.go",
        "internal/session/auto_resume_test.go",
        "to-do.json"
      ],
      "tags": [
        "session",
        "async",
        "automation"
      ],
      "updated_at": "2026-02-16T21:57:23Z"
    },
    {
      "id": "T120",
      "title": "Integrate prompt caching for cost reduction",
      "priority": 2,
      "status": "done",
      "details": "Implement prompt caching (Anthropic) and response reuse (OpenAI Responses API) to reduce inference costs. Caching can save 90% on repeated context like system prompts, tool definitions, and conversation history.\n\n# acceptance_criteria:\n- Anthropic requests include cache_control on system prompt\n- OpenAI Responses API uses previous_response_id when resuming\n- Cache hit/miss metrics reported in transcript and usage output\n- Cost savings calculated and displayed\n\n# notes:\nAnthropic caches for 5 minutes by default. OpenAI Responses caches for 1 hour. Need to handle cache invalidation when system prompt or tools change. Reference: https://docs.anthropic.com/claude/docs/prompt-caching",
      "depends_on": [
        "T117"
      ],
      "steps": [
        "Research Anthropic cache_control format: ephemeral caches on system/tools/messages",
        "Research OpenAI Responses API: previous_response_id for context reuse",
        "Add cache_control to system prompt in Anthropic provider",
        "Add cache_control to tool definitions in Anthropic provider",
        "Track cache key metadata: hash of cached content, creation timestamp",
        "Implement CacheMetadata struct in internal/session/cache.go",
        "For Anthropic: add cache_control to last user message for conversation caching",
        "For OpenAI Responses: store previous_response_id in session metadata",
        "Add cache metrics to ModelUsage: cache_read_tokens, cache_write_tokens",
        "Report cache savings in tick output: 'Cache hit: saved $X.YY'",
        "Add enable_prompt_cache config (already exists, ensure it's used correctly)",
        "Write tests with mock providers to verify cache headers are sent"
      ],
      "files": [
        "internal/model/anthropic_provider.go",
        "internal/model/openai_responses.go",
        "internal/session/cache.go",
        "internal/session/cache_test.go",
        "internal/domain/types.go",
        "cmd/bare/tick.go"
      ],
      "tags": [
        "performance",
        "cost",
        "providers"
      ],
      "updated_at": "2026-02-17T09:40:04Z"
    },
    {
      "id": "T121",
      "title": "Add session list and status commands",
      "priority": 2,
      "status": "done",
      "details": "Add CLI commands to list sessions, show session status, and manage session history. Users need visibility into what sessions exist, their state, and ability to clean up old sessions.\n\n# acceptance_criteria:\n- 'bare session list' shows all sessions in chronological order\n- 'bare session current' identifies the session that would be resumed\n- 'bare session show run_abc' shows detailed session state\n- 'bare session clean' removes old completed sessions safely\n\n# notes:\nThis is essential UX for understanding what Bare has been doing. Should integrate with existing state show command for unified visibility.",
      "depends_on": [
        "T117"
      ],
      "steps": [
        "Add 'bare session list' command: list all runs with status, task, timestamps",
        "Add 'bare session show <run_id>' command: detailed session info",
        "Add 'bare session current' command: show active/resumable session",
        "List output: run_id, task_id, task_title, state, started_at, updated_at, message_count",
        "Show output: full loop state, task details, last N messages, token usage",
        "Add --json flag for machine-readable output",
        "Add 'bare session clean --older-than=7d --status=done' to remove old sessions",
        "Implement session pruning: keep last N complete sessions (configurable)",
        "Add session list to state show output",
        "Write tests for session commands"
      ],
      "files": [
        "cmd/bare/help.go",
        "cmd/bare/session.go",
        "cmd/bare/session_test.go",
        "cmd/bare/state.go",
        "internal/session/list.go",
        "internal/session/list_test.go"
      ],
      "tags": [
        "cli",
        "ux",
        "session"
      ],
      "updated_at": "2026-02-17T09:49:58Z"
    },
    {
      "id": "T122",
      "title": "Enable async/cron-friendly operation mode",
      "priority": 2,
      "status": "done",
      "details": "Optimize Bare for unattended async operation via cron, systemd timers, or CI/CD. This includes exit codes, idempotency, and documentation for automation patterns.\n\n# acceptance_criteria:\n- Exit codes are stable and documented\n- Cron example runs tick every minute without manual intervention\n- Systemd example works with 'systemctl start bare-tick'\n- Repeated invocations don't cause double-execution of commands\n\n# notes:\nThis is Bare's unique differentiator vs interactive agents. The async model enables use cases that TUI agents can't support: scheduled maintenance, CI pipelines, multi-repo automation.",
      "depends_on": [
        "T118",
        "T119"
      ],
      "steps": [
        "Document exit codes: 0=success, 10=no_task, 11=idle, 12=timeout, 13=token_budget",
        "Add --exit-on-idle flag: exit immediately if no task (for cron efficiency)",
        "Add --max-runtime=<duration> flag: graceful exit after time limit",
        "Add --max-tokens=<n> flag: exit when token budget exhausted",
        "Ensure idempotent tick: running twice produces same result (no double-execution)",
        "Add lock timeout handling: if lock stale > N minutes, auto-clear",
        "Create examples/cron/bare-tick for cron integration",
        "Create examples/systemd/bare-tick.service and bare-tick.timer",
        "Document CI/CD integration pattern in README",
        "Add --quiet flag to suppress all output except errors",
        "Add --on-fail=<command> hook for alerting on failure",
        "Test with rapid repeated invocations"
      ],
      "files": [
        "README.md",
        "cmd/bare/main.go",
        "cmd/bare/tick.go",
        "examples/cron/bare-tick",
        "examples/systemd/bare-tick.service",
        "examples/systemd/bare-tick.timer",
        "internal/domain/types.go",
        "internal/storage/lock.go",
        "internal/storage/task_store.go"
      ],
      "tags": [
        "automation",
        "ops",
        "integration"
      ],
      "updated_at": "2026-02-17T10:30:40Z"
    },
    {
      "id": "T123",
      "title": "Implement configurable system prompt with per-provider override",
      "priority": 1,
      "status": "done",
      "details": "Allow users to customize the system prompt and switch prompts based on which LLM provider is being used. Different models respond better to different prompting styles - Claude prefers different instructions than GPT. Users should also be able to bring their own prompt files.\n\n# acceptance_criteria:\n- Default system prompt works without any configuration\n- --system-prompt='...' overrides config for single run\n- --system-prompt-file=prompt.md loads from file\n- Provider override activates when model.provider matches\n- Template variables are substituted correctly\n- Prompt hash logged in transcript for reproducibility\n\n# notes:\nReference Pi-Agent's ~1000 token minimal prompt as inspiration for a lean alternative. Consider prompt versioning for A/B testing different prompts. This is essential for users who want to optimize for specific models or use cases.\n\n# config_schema:\n{\"system_prompt\":{\"template\":\"string (optional, inline prompt text)\",\"file\":\"string (optional, path to .md file)\",\"provider_overrides\":{\"anthropic\":{\"template\":\"...\",\"file\":\"...\"},\"openai\":{\"template\":\"...\",\"file\":\"...\"},\"zai\":{\"template\":\"...\",\"file\":\"...\"}},\"variables\":{\"PROJECT_NAME\":\"my-project\",\"CUSTOM_INSTRUCTION\":\"...\"}}}",
      "steps": [
        "Create internal/prompt/system.go with SystemPromptManager struct",
        "Define default system prompt in code (current behavior as baseline)",
        "Add system_prompt config section to config.json with template, file, and provider_overrides fields",
        "Implement prompt template with variable substitution: {{TASK_TITLE}}, {{TASK_ID}}, {{PROJECT_NAME}}, {{ITERATION}}",
        "Add --system-prompt flag to tick command for ad-hoc override",
        "Add --system-prompt-file flag to load prompt from external file",
        "Implement provider-specific overrides: system_prompt.provider_overrides.anthropic, .openai, .zai",
        "Add .bare/prompts/ directory for user prompt files (auto-discovered)",
        "Support prompt inheritance: base prompt + provider-specific additions",
        "Include prompt hash in transcript metadata for reproducibility",
        "Add 'bare prompt show' command to display effective system prompt",
        "Add 'bare prompt list' to list available prompt templates",
        "Validate prompt size against model context limits",
        "Write tests for prompt loading, template substitution, and provider overrides"
      ],
      "files": [
        "internal/prompt/system.go",
        "internal/prompt/system_test.go",
        "internal/prompt/template.go",
        "internal/prompt/types.go",
        "internal/domain/config.go",
        "cmd/bare/tick.go",
        "cmd/bare/prompt.go",
        "cmd/bare/help.go",
        "cmd/bare/completion.go",
        "internal/bootstrap/bootstrap.go"
      ],
      "tags": [
        "prompt",
        "config",
        "providers",
        "customization"
      ],
      "updated_at": "2026-02-16T22:31:45Z"
    },
    {
      "id": "T124",
      "title": "Implement session branching with DAG structure",
      "priority": 1,
      "status": "done",
      "details": "Add Pi-Agent-style session branching where sessions form a DAG (Directed Acyclic Graph) instead of a linear history. Users can fork from any point in a session, explore different approaches, and navigate between branches. This enables experimental development without losing context.\n\n# acceptance_criteria:\n- 'bare session fork' creates new branch from current point\n- 'bare session fork evt_045' forks from specific event in history\n- 'bare session checkout sess_002' switches to different branch\n- 'bare session log' shows tree visualization of all branches\n- Branch history is preserved even after switching\n- Merge combines tool executions from source into current branch\n\n# notes:\nPi-Agent's DAG approach is one of its most powerful features. It enables 'what if' experimentation without losing work. Key insight from Pi: session structure should be append-only (never delete), only mark as abandoned. Reference: https://github.com/badlogic/pi-mono\n\n# session_dag_schema:\n{\"sessions\":{\"sess_001\":{\"id\":\"sess_001\",\"parent_id\":null,\"children\":[\"sess_002\",\"sess_005\"],\"branch_name\":\"main\",\"run_id\":\"run_abc123\",\"created_at\":\"2026-02-15T06:00:00Z\",\"status\":\"active\"},\"sess_002\":{\"id\":\"sess_002\",\"parent_id\":\"sess_001\",\"children\":[],\"branch_name\":\"experiment-refactor\",\"forked_at_event\":\"evt_045\",\"status\":\"abandoned\"}},\"active_session\":\"sess_005\",\"branches\":{\"main\":\"sess_001\",\"experiment-refactor\":\"sess_002\",\"experiment-tests\":\"sess_005\"}}",
      "depends_on": [
        "T117",
        "T121"
      ],
      "steps": [
        "Design session DAG schema: SessionNode with id, parent_id, children[], created_at, branch_name",
        "Create internal/session/dag.go with SessionDAG struct",
        "Implement session DAG storage in .bare/sessions/dag.json",
        "Add 'bare session fork [from_event_id]' command to create branch",
        "Add 'bare session branch <name>' to name current branch",
        "Add 'bare session checkout <session_id>' to switch to different branch",
        "Add 'bare session log' to show DAG as tree visualization",
        "Implement merge capability: 'bare session merge <source_branch>'",
        "Add --branch flag to tick command: 'bare tick --branch=experiment-a'",
        "Track branch metadata: name, description, created_from, status (active/merged/abandoned)",
        "Implement garbage collection for abandoned branches older than N days",
        "Add branch visualization in 'bare session list --tree'",
        "Handle concurrent branch modifications with merge conflict detection",
        "Store branch point context separately for efficient resume",
        "Write comprehensive tests for DAG operations"
      ],
      "files": [
        "cmd/bare/help.go",
        "cmd/bare/main.go",
        "cmd/bare/session.go",
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "internal/session/branch.go",
        "internal/session/branch_test.go",
        "internal/session/dag.go",
        "internal/session/dag_test.go",
        "to-do.json"
      ],
      "tags": [
        "session",
        "dag",
        "branching",
        "experimentation"
      ],
      "updated_at": "2026-02-17T00:57:35Z"
    },
    {
      "id": "T125",
      "title": "Add cost budget and token limit controls for long-running agents",
      "priority": 1,
      "status": "done",
      "details": "For autonomous long-running agents, costs can spiral out of control. Add hard limits on spending and token usage that halt execution when exceeded. Essential for cron-deployed agents that run unattended.\n\n# acceptance_criteria:\n- Tick fails with clear error when daily budget exceeded\n- Tick fails when run budget exceeded mid-execution\n- Budget state persists across runs\n- Daily reset happens automatically at midnight UTC\n- Cost reporting accurate to within 1 cent\n\n# notes:\nCritical for unattended agents. Without this, a runaway agent could rack up $1000s in API costs overnight.",
      "steps": [
        "Add budget config section to config.json with daily_limit, run_limit, total_limit in USD",
        "Add token_limits config: max_input_per_run, max_output_per_run, max_total_per_day",
        "Implement CostTracker in internal/budget/tracker.go with running totals",
        "Store budget state in .bare/state/budget.json (spent_today, total_spent, run_count)",
        "Check budget before each model API call, return error if exceeded",
        "Add --budget-limit flag to tick for per-run override",
        "Add --dry-run flag to estimate cost without executing",
        "Implement budget reset logic (daily reset at midnight UTC)",
        "Add budget alerts: warn at 80%, hard stop at 100%",
        "Report cost in tick output: 'Run cost: $0.12 (daily: $2.34 / $10.00 limit)'",
        "Add 'bare budget show' command to display spending",
        "Add 'bare budget reset' to clear daily counters",
        "Integrate with existing ModelUsage tracking",
        "Write tests for budget enforcement and reset logic"
      ],
      "files": [
        "internal/budget/tracker.go",
        "internal/budget/tracker_test.go",
        "internal/budget/types.go",
        "internal/domain/config.go",
        "cmd/bare/tick.go",
        "cmd/bare/budget.go",
        "cmd/bare/help.go",
        "cmd/bare/completion.go",
        "cmd/bare/main.go"
      ],
      "tags": [
        "budget",
        "cost-control",
        "automation",
        "safety"
      ],
      "updated_at": "2026-02-17T00:40:00Z"
    },
    {
      "id": "T126",
      "title": "Add notification hooks for long-running agent events",
      "priority": 2,
      "status": "done",
      "details": "For autonomous agents running via cron/CI, users need visibility into what's happening. Add notification hooks that fire on key events: task completion, budget warning, error, verification failure, etc.\n\n# acceptance_criteria:\n- Webhook receives POST on task completion\n- Slack message appears in channel\n- Throttle prevents notification spam\n- 'bare notify test' sends test payload successfully\n\n# notes:\nIntegration with PagerDuty/OpsGenie would be valuable for production use.",
      "steps": [
        "Add notifications config section with webhook_url, slack_webhook fields",
        "Define event types: task_done, task_blocked, verify_pass, verify_fail, budget_warning, budget_exceeded, error, idle",
        "Implement NotificationDispatcher in internal/notify/dispatcher.go",
        "Add webhook POST with JSON payload: event_type, run_id, task_id, message, timestamp",
        "Add Slack webhook support with formatted message blocks",
        "Throttle notifications: max N per hour to avoid spam",
        "Add --notify flag to tick for one-off notification override",
        "Store notification log in .bare/logs/notifications.log",
        "Add 'bare notify test' command to verify webhook connectivity",
        "Support custom notification templates",
        "Write tests for all notification channels"
      ],
      "files": [
        "cmd/bare/main.go",
        "cmd/bare/notify.go",
        "cmd/bare/tick.go",
        "internal/domain/config.go",
        "internal/notify/dispatcher.go",
        "internal/notify/dispatcher_test.go",
        "internal/notify/types.go"
      ],
      "tags": [
        "notifications",
        "observability",
        "automation"
      ],
      "updated_at": "2026-02-17T10:51:02Z"
    },
    {
      "id": "T127",
      "title": "Add checkpoint and rollback for task recovery",
      "priority": 2,
      "status": "done",
      "details": "Implemented checkpoint and rollback for task recovery. Added bare checkpoint create, bare checkpoint list, and bare checkpoint restore commands. Checkpoints are stored in .bare/state/checkpoints/ with manifest.json containing metadata and file catalog. Auto-checkpoint on verification pass when --checkpoint flag is used. Config supports checkpoint_retention_days. All tests passing.",
      "steps": [
        "Design checkpoint schema: checkpoint_id, timestamp, git_commit_sha, task_id, iteration, files_changed, verification_status",
        "Implement CheckpointManager in internal/checkpoint/manager.go",
        "Add 'bare checkpoint create' to capture current state",
        "Add 'bare checkpoint list' to show available checkpoints",
        "Add 'bare checkpoint restore <id>' to rollback to checkpoint",
        "Auto-checkpoint before risky operations (file modifications, shell commands)",
        "Auto-checkpoint on verification pass (known good state)",
        "Integrate with git: checkpoint creates stash or commit",
        "Add --checkpoint flag to tick to enable auto-checkpointing",
        "Add checkpoint_retention_days config to auto-cleanup old checkpoints",
        "Store checkpoints in .bare/checkpoints/ directory",
        "Handle checkpoint restore when files have uncommitted changes",
        "Write tests for checkpoint create, list, restore, cleanup"
      ],
      "files": [
        "cmd/bare/checkpoint.go",
        "cmd/bare/tick.go",
        "internal/checkpoint/manager.go",
        "internal/checkpoint/manager_test.go",
        "internal/checkpoint/types.go"
      ],
      "tags": [
        "recovery",
        "safety",
        "automation"
      ],
      "updated_at": "2026-02-17T11:21:53Z"
    },
    {
      "id": "T128",
      "title": "Create ProviderCompat types in internal/model/compat.go",
      "priority": 2,
      "status": "done",
      "details": "Define ProviderCompat struct with fields for provider-level compatibility settings: MaxTokensField, ToolIDFormat, ThinkingFormat, and boolean flags for various provider quirks.",
      "steps": [
        "Create internal/model/compat.go",
        "Define ProviderCompat struct with all compatibility fields",
        "Define MaxTokensField enum (max_tokens, max_completion_tokens, max_output_tokens)",
        "Define ToolIDFormat enum (standard, mistral, piped)",
        "Define ThinkingFormat enum (none, openai, zai, qwen)",
        "Add JSON tags for config serialization"
      ],
      "files": [
        "internal/model/compat.go",
        "to-do.json"
      ],
      "tags": [
        "provider",
        "compatibility",
        "architecture"
      ],
      "updated_at": "2026-02-17T11:23:28Z"
    },
    {
      "id": "T129",
      "title": "Implement DetectCompat() for auto-detection of provider settings",
      "priority": 2,
      "status": "done",
      "details": "Create DetectCompat(providerID, baseURL) function that auto-detects provider compatibility settings based on provider ID and URL patterns. Returns deterministic ProviderCompat. -- already implemented, all tests pass",
      "depends_on": [
        "T128"
      ],
      "steps": [
        "Implement DetectCompat() with provider ID matching",
        "Add isNonStandardProvider() helper for URL pattern detection",
        "Handle OpenAI-specific settings (max_output_tokens, openai thinking)",
        "Handle Anthropic-specific settings",
        "Handle ZAI-specific settings (zai thinking format)",
        "Handle Mistral-specific settings (9-char tool IDs)",
        "Handle non-standard providers (cerebras, xai, deepseek, chutes)"
      ],
      "files": [
        "internal/model/compat.go",
        "internal/model/compat_test.go",
        "to-do.json"
      ],
      "tags": [
        "provider",
        "detection"
      ],
      "updated_at": "2026-02-17T11:27:21Z"
    },
    {
      "id": "T130",
      "title": "Implement GetCompat() with override support",
      "priority": 2,
      "status": "done",
      "details": "Create GetCompat() that combines auto-detection with explicit overrides. Resolution order: model override > auto-detect > defaults.",
      "depends_on": [
        "T129"
      ],
      "steps": [
        "Implement GetCompat(providerID, baseURL, overrides)",
        "Apply non-zero override values to detected settings",
        "Add unit tests for override precedence",
        "Document resolution order in code comments"
      ],
      "files": [
        "internal/model/compat.go",
        "internal/model/compat_test.go"
      ],
      "tags": [
        "provider",
        "overrides"
      ],
      "updated_at": "2026-02-17T11:31:16Z"
    },
    {
      "id": "T131",
      "title": "Implement tool call ID normalization per provider",
      "priority": 2,
      "status": "done",
      "details": "Create NormalizeToolCallID() function that transforms tool call IDs to provider-specific formats. Mistral needs 9 alphanumeric chars, OpenAI has pipe-separated IDs.",
      "depends_on": [
        "T128"
      ],
      "steps": [
        "Implement NormalizeToolCallID(id, format) main function",
        "Implement normalizeMistralToolID() for 9-char format",
        "Implement normalizePipedToolID() for OpenAI pipe format",
        "Implement sanitizeToolID() helper with max length",
        "Add comprehensive unit tests for each format",
        "Add unit tests for edge cases (empty, special chars, long IDs)"
      ],
      "files": [
        "internal/model/compat.go",
        "internal/model/tool_id.go",
        "internal/model/tool_id_test.go"
      ],
      "tags": [
        "provider",
        "tools",
        "normalization"
      ],
      "updated_at": "2026-02-17T11:40:42Z",
      "blockers": []
    },
    {
      "id": "T132",
      "title": "Implement TransformMessages() for cross-provider compatibility",
      "priority": 2,
      "status": "done",
      "details": "Create TransformMessages() that converts messages for cross-provider use, handling tool ID normalization and thinking block transformation.",
      "depends_on": [
        "T129",
        "T131"
      ],
      "steps": [
        "Implement TransformMessages(messages, fromCompat, toCompat)",
        "Add transformToolIDsInMessage() helper",
        "Add transformThinkingBlocks() helper",
        "Handle provider-specific message quirks",
        "Add unit tests for message transformation scenarios"
      ],
      "files": [
        "internal/model/message_transform.go",
        "internal/model/message_transform_test.go"
      ],
      "tags": [
        "provider",
        "messages",
        "transformation"
      ],
      "updated_at": "2026-02-17T11:47:56Z"
    },
    {
      "id": "T133",
      "title": "Add ProviderCompat to ProviderRequest",
      "priority": 2,
      "status": "done",
      "details": "Extend ProviderRequest struct to include ProviderCompat field so providers have access to resolved compatibility settings.",
      "depends_on": [
        "T130"
      ],
      "steps": [
        "Add Compat field to ProviderRequest in types.go",
        "Update adapter to populate Compat field before calling provider",
        "Update any code that constructs ProviderRequest",
        "Add tests for Compat field population"
      ],
      "files": [
        "internal/model/compat.go",
        "internal/model/model.go",
        "internal/model/types.go"
      ],
      "tags": [
        "provider",
        "request"
      ],
      "updated_at": "2026-02-17T11:50:27Z"
    },
    {
      "id": "T134",
      "title": "Update OpenAI provider to use ProviderCompat",
      "priority": 2,
      "status": "done",
      "details": "Refactor openai_provider.go to use ProviderCompat settings for token field naming, thinking format, and tool handling.",
      "depends_on": [
        "T133"
      ],
      "steps": [
        "Use compat.MaxTokensField for token parameter selection",
        "Use compat.ThinkingFormat for reasoning content handling",
        "Use compat.ToolIDFormat for tool call ID normalization",
        "Handle supportsReasoningEffort setting",
        "Update openai_responses.go similarly",
        "Add integration tests"
      ],
      "files": [
        "internal/model/compat.go",
        "internal/model/message_transform.go",
        "internal/model/openai_compat_test.go",
        "internal/model/openai_provider.go",
        "internal/model/openai_responses.go",
        "internal/model/tool_id.go"
      ],
      "tags": [
        "provider",
        "openai"
      ],
      "updated_at": "2026-02-17T12:12:57Z"
    },
    {
      "id": "T135",
      "title": "Update Anthropic provider to use ProviderCompat",
      "priority": 2,
      "status": "done",
      "details": "Refactor anthropic_provider.go to use ProviderCompat settings for consistent compatibility handling.",
      "depends_on": [
        "T133"
      ],
      "steps": [
        "Use compat.MaxTokensField for token parameter",
        "Apply any Anthropic-specific compatibility settings",
        "Ensure consistent message format handling",
        "Add integration tests"
      ],
      "files": [
        "internal/model/anthropic_compat_test.go",
        "internal/model/anthropic_provider.go",
        "to-do.json"
      ],
      "tags": [
        "provider",
        "anthropic"
      ],
      "updated_at": "2026-02-17T12:18:15Z"
    },
    {
      "id": "T136",
      "title": "Update ZAI provider to use ProviderCompat",
      "priority": 2,
      "status": "done",
      "details": "Refactor zai_provider.go to use ProviderCompat settings for thinking format and token handling.",
      "depends_on": [
        "T133"
      ],
      "steps": [
        "Use compat.MaxTokensField for token parameter",
        "Use compat.ThinkingFormat (zai) for thinking blocks",
        "Handle tool streaming compatibility",
        "Add integration tests"
      ],
      "files": [
        "internal/model/compat.go",
        "internal/model/zai_compat_test.go",
        "internal/model/zai_provider.go",
        "to-do.json"
      ],
      "tags": [
        "provider",
        "zai"
      ],
      "updated_at": "2026-02-17T12:27:08Z"
    },
    {
      "id": "T137",
      "title": "Add compat overrides to provider config and models.json",
      "priority": 3,
      "status": "todo",
      "details": "Allow users to override detected compatibility settings via config.json and extend models.json schema to support compat field.",
      "depends_on": [
        "T130",
        "T134",
        "T135",
        "T136"
      ],
      "steps": [
        "Extend models.json schema with optional 'compat' field",
        "Update ModelCapability to include ProviderCompat",
        "Add provider-level compat overrides in config.json",
        "Update config loading to merge compat settings",
        "Add documentation for compat overrides",
        "Add tests for override scenarios"
      ],
      "files": [
        "internal/model/models.json",
        "internal/model/capabilities.go",
        "internal/domain/config.go"
      ],
      "tags": [
        "provider",
        "config",
        "overrides"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T139",
      "title": "Audit and slim default system prompt for minimal token footprint",
      "priority": 1,
      "status": "done",
      "details": "Adopted a compact default system prompt focused on strict JSON command output, added deterministic contract tests, and updated user-facing prompt documentation.",
      "depends_on": [
        "T123"
      ],
      "steps": [
        "Capture baseline prompt token usage and response quality across representative tasks.",
        "Design and ship a smaller default prompt profile with strict command contract guidance and minimal repetition.",
        "Add regression tests comparing extraction reliability and determinism before and after prompt reduction."
      ],
      "files": [
        "README.md",
        "cmd/bare/tick_model_diagnostics_test.go",
        "internal/prompt/system.go",
        "internal/prompt/system_test.go",
        "internal/prompt/types.go",
        "to-do.json"
      ],
      "tags": [
        "prompt",
        "determinism",
        "cost"
      ],
      "updated_at": "2026-02-17T00:58:27Z"
    },
    {
      "id": "T140",
      "title": "Feed tool validation failures back to model as structured turn input",
      "priority": 1,
      "status": "done",
      "details": "Turn tool validation failures into normalized feedback so the model can repair invalid tool calls in the next deterministic turn.",
      "depends_on": [
        "T109",
        "T110"
      ],
      "steps": [
        "Extend tool execution results with structured validation payloads (field, reason, expected shape).",
        "Inject validation payloads into the next model call using a stable schema instead of raw stderr blobs.",
        "Add transcript and integration tests for repair attempts after malformed tool arguments."
      ],
      "files": [
        "cmd/bare/tick.go",
        "cmd/bare/tick_model_diagnostics_test.go",
        "internal/domain/types.go",
        "internal/model/model.go",
        "internal/model/model_test.go",
        "to-do.json"
      ],
      "tags": [
        "tool-loop",
        "validation",
        "feedback"
      ],
      "updated_at": "2026-02-17T01:01:27Z"
    },
    {
      "id": "T141",
      "title": "Ship oracle second-opinion as an optional skill (not core runtime)",
      "priority": 2,
      "status": "done",
      "details": "Implement oracle review as a skill-level capability so users can opt in without adding core tick/runtime complexity.",
      "depends_on": [
        "T041",
        "T083"
      ],
      "steps": [
        "Define a skill contract for oracle review input/output (plan, risk flags, approve/revise/block decision).",
        "Implement an oracle skill entrypoint that can call a secondary model and return machine-readable decisions.",
        "Expose deterministic policy handling in the skill runner and document how to attach oracle checks to workflows."
      ],
      "files": [
        ".agents/skills/oracle-second-opinion.md",
        "README.md",
        "cmd/bare/skill.go",
        "internal/bootstrap/bootstrap.go",
        "to-do.json"
      ],
      "tags": [
        "safety",
        "skills",
        "oracle"
      ],
      "updated_at": "2026-02-17T12:35:48Z"
    },
    {
      "id": "T142",
      "title": "Implement run handoff workflow as alternative to aggressive compaction",
      "priority": 2,
      "status": "todo",
      "details": "Prefer explicit handoff to a fresh run context when history gets large, instead of relying only on in-place compaction.",
      "depends_on": [
        "T117",
        "T118",
        "T119"
      ],
      "steps": [
        "Define a handoff manifest linking parent run, carry-forward summary, unresolved items, and artifact pointers.",
        "Add CLI support to start continuation runs from a handoff packet with clear provenance.",
        "Update resume heuristics to prefer handoff chains once context or token thresholds are exceeded."
      ],
      "files": [
        "cmd/bare/run.go",
        "cmd/bare/run_compare.go",
        "internal/domain/types.go",
        "internal/storage/task_store.go",
        "README.md",
        "to-do.json"
      ],
      "tags": [
        "context",
        "handoff",
        "continuation"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T143",
      "title": "Add language-agnostic toolbox runner for custom tools",
      "priority": 2,
      "status": "todo",
      "details": "Enable custom toolboxes in any language via manifest-defined subprocess contracts and deterministic JSON I/O.",
      "depends_on": [
        "T041",
        "T109"
      ],
      "steps": [
        "Define toolbox manifest schema (command, args template, input schema, output schema, timeout, env allowlist).",
        "Implement toolbox runtime with deterministic serialization, timeout handling, and stable exit-code mapping.",
        "Expose toolbox commands to the tool loop and capture invocation traces in transcripts and proofs."
      ],
      "files": [
        "internal/execution/executor.go",
        "internal/domain/types.go",
        "cmd/bare/skill.go",
        "cmd/bare/tick.go",
        "README.md",
        "to-do.json"
      ],
      "tags": [
        "tools",
        "extensibility",
        "runtime"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T144",
      "title": "Integrate LSP-backed code context and diagnostics",
      "priority": 2,
      "status": "todo",
      "details": "Provide opt-in LSP context retrieval so model decisions can use symbol and diagnostic evidence instead of only raw file snippets.",
      "depends_on": [
        "T143"
      ],
      "steps": [
        "Implement an LSP session manager for workspace indexing and on-demand symbol/diagnostic queries.",
        "Add bounded LSP query tools (definitions, references, diagnostics) with deterministic truncation rules.",
        "Add tests and docs for stable behavior on large repositories and partial LSP failures."
      ],
      "files": [
        "internal/domain/types.go",
        "internal/execution/executor.go",
        "cmd/bare/tick.go",
        "docs/model-architecture.md",
        "README.md",
        "to-do.json"
      ],
      "tags": [
        "lsp",
        "context",
        "quality"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T145",
      "title": "Add signed provider/model metadata auto-update workflow",
      "priority": 3,
      "status": "todo",
      "details": "Allow controlled updates to provider/model capability metadata without code changes while preserving deterministic rollback behavior.",
      "depends_on": [
        "T088",
        "T111"
      ],
      "steps": [
        "Define remote metadata bundle format with versioning and signature verification.",
        "Add CLI sync flow to fetch, verify, and persist metadata overrides under `.bare` state.",
        "Record metadata version fingerprints in run artifacts and troubleshooting output."
      ],
      "files": [
        "internal/model/capabilities.go",
        "internal/model/models.json",
        "cmd/bare/health.go",
        "docs/adding-model.md",
        "docs/model-troubleshooting.md",
        "to-do.json"
      ],
      "tags": [
        "metadata",
        "providers",
        "operations"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T146",
      "title": "Prototype optional SQLite state backend behind storage interfaces",
      "priority": 4,
      "status": "todo",
      "details": "Evaluate whether SQLite can improve complex session/query workflows while preserving deterministic filesystem defaults.",
      "depends_on": [
        "T004",
        "T024"
      ],
      "steps": [
        "Define semantic parity checklist for todo/current/loop/progress/metrics between filesystem and SQLite backends.",
        "Implement an opt-in SQLite task/state store with deterministic ordering, transaction boundaries, and lock behavior.",
        "Benchmark and document operational tradeoffs; keep filesystem as default unless parity and reproducibility targets are met."
      ],
      "files": [
        "internal/storage/task_store.go",
        "internal/storage/lock.go",
        "internal/domain/config.go",
        "README.md",
        "docs/adr/0001-provider-model-architecture.md",
        "to-do.json"
      ],
      "tags": [
        "storage",
        "sqlite",
        "architecture"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T147",
      "title": "Define parent-child run contract for nested bare orchestration",
      "priority": 1,
      "status": "done",
      "details": "Establish a deterministic contract for agent-in-agent execution so parent and child runs can coordinate purely through filesystem artifacts.",
      "depends_on": [
        "T117",
        "T076"
      ],
      "steps": [
        "Define run lineage fields (`parent_run_id`, `orchestration_id`, `agent_role`, `depth`) in run metadata and transcript events.",
        "Persist a deterministic child-run index per orchestration campaign for machine consumption by other agents.",
        "Add integration tests that prove parent/child linkage remains stable across resume and crash-recovery flows."
      ],
      "files": [
        "README.md",
        "cmd/bare/integration_test.go",
        "cmd/bare/tick.go",
        "internal/domain/types.go",
        "to-do.json"
      ],
      "tags": [
        "orchestration",
        "contracts",
        "autonomy"
      ],
      "updated_at": "2026-02-17T01:08:03Z"
    },
    {
      "id": "T148",
      "title": "Implement namespace isolation for spawned bare agents",
      "priority": 1,
      "status": "done",
      "details": "Ensure concurrently spawned agents do not collide on locks, state, outputs, proofs, or transcript paths.",
      "depends_on": [
        "T147",
        "T006"
      ],
      "steps": [
        "Define deterministic per-agent namespace paths for state, outputs, proofs, transcripts, and checkpoints.",
        "Update lock and path resolution logic to guarantee isolation by namespace while preserving root-level discoverability.",
        "Add tests for parallel invocations in one repository that verify zero lock/state cross-talk."
      ],
      "files": [
        "README.md",
        "cmd/bare/main.go",
        "cmd/bare/tick.go",
        "cmd/bare/tick_path_test.go",
        "internal/domain/config.go",
        "internal/domain/config_test.go",
        "internal/domain/types.go",
        "internal/session/resume.go",
        "internal/storage/lock.go",
        "internal/storage/lock_test.go",
        "to-do.json"
      ],
      "tags": [
        "orchestration",
        "isolation",
        "runtime"
      ],
      "updated_at": "2026-02-17T01:15:22Z"
    },
    {
      "id": "T149",
      "title": "Add task lease protocol for multi-agent execution",
      "priority": 1,
      "status": "done",
      "details": "Prevent duplicate task execution when many agents run in parallel by introducing deterministic task leasing semantics.",
      "depends_on": [
        "T148",
        "T005"
      ],
      "steps": [
        "Add lease records with holder identity, acquired timestamp, expiry timestamp, and heartbeat metadata.",
        "Implement atomic acquire/renew/release flow and selector behavior that skips leased tasks unless lease is stale.",
        "Add deterministic stale-lease reclaim behavior and tests for race conditions under concurrent agents."
      ],
      "files": [
        "cmd/bare/task.go",
        "cmd/bare/tick.go",
        "internal/storage/task_store.go",
        "internal/storage/task_store_test.go",
        "to-do.json"
      ],
      "tags": [
        "orchestration",
        "leasing",
        "concurrency"
      ],
      "updated_at": "2026-02-17T01:21:24Z"
    },
    {
      "id": "T150",
      "title": "Add orchestration governor limits for unattended agent spawning",
      "priority": 1,
      "status": "done",
      "details": "Protect isolated VM deployments from runaway recursion by enforcing hard limits on child agents and execution budgets.",
      "depends_on": [
        "T147",
        "T125"
      ],
      "steps": [
        "Add config limits for `max_children`, `max_depth`, `max_parallel_children`, and per-child runtime/token ceilings.",
        "Enforce governor checks before child-agent spawn with deterministic blocked outcomes in JSON artifacts.",
        "Add tests for boundary conditions and deterministic error classification when limits are exceeded."
      ],
      "files": [
        "README.md",
        "cmd/bare/help.go",
        "cmd/bare/run.go",
        "cmd/bare/tick.go",
        "cmd/bare/tick_orchestration_test.go",
        "internal/domain/config.go",
        "to-do.json"
      ],
      "tags": [
        "orchestration",
        "safety",
        "automation"
      ],
      "updated_at": "2026-02-17T02:07:46Z"
    },
    {
      "id": "T151",
      "title": "Define deterministic merge and arbitration policy for child outputs",
      "priority": 2,
      "status": "todo",
      "details": "Codify how parent agents choose winners and resolve conflicts when multiple children produce competing patches.",
      "depends_on": [
        "T147",
        "T081"
      ],
      "steps": [
        "Define winner selection precedence across verification, score, and stable tie-break keys.",
        "Define conflict policy for overlapping file edits and ensure policy emits machine-readable reasons.",
        "Add regression tests proving repeated arbitration over the same child set yields identical outcomes."
      ],
      "files": [
        "cmd/bare/run_compare.go",
        "cmd/bare/run_score.go",
        "cmd/bare/patch.go",
        "README.md",
        "to-do.json"
      ],
      "tags": [
        "orchestration",
        "selection",
        "determinism"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T152",
      "title": "Pin skill snapshots for reproducible child-agent behavior",
      "priority": 2,
      "status": "todo",
      "details": "Guarantee reproducibility by binding each orchestration run to immutable skill digests passed to all child agents.",
      "depends_on": [
        "T041",
        "T147"
      ],
      "steps": [
        "Generate a skill snapshot manifest (path + digest) at orchestration start and persist it in run artifacts.",
        "Require child runs to resolve skills from the snapshot and fail closed when local skill content drifts.",
        "Expose snapshot fingerprint in run/troubleshooting outputs and add compatibility tests."
      ],
      "files": [
        "internal/skill/skill.go",
        "cmd/bare/skill.go",
        "internal/domain/types.go",
        "README.md",
        "to-do.json"
      ],
      "tags": [
        "skills",
        "reproducibility",
        "orchestration"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T153",
      "title": "Add orphaned-child reaper and stale-run recovery for orchestration",
      "priority": 2,
      "status": "todo",
      "details": "Recover automatically when child agents crash or disappear by cleaning stale locks, releasing leases, and marking child outcomes deterministically.",
      "depends_on": [
        "T148",
        "T149",
        "T150"
      ],
      "steps": [
        "Detect orphaned child runs using heartbeat/pid evidence and stale thresholds.",
        "Release or reclaim associated lock and lease state with explicit audit events.",
        "Add retry/abandon policy outputs so parent agents can continue without manual intervention."
      ],
      "files": [
        "cmd/bare/health.go",
        "cmd/bare/state.go",
        "internal/storage/lock.go",
        "internal/storage/task_store.go",
        "README.md",
        "to-do.json"
      ],
      "tags": [
        "orchestration",
        "recovery",
        "automation"
      ],
      "updated_at": "2026-02-16T00:00:00Z"
    },
    {
      "id": "T154",
      "title": "Fix task_store_test.go compilation errors - Get() method returns 3 values",
      "priority": 1,
      "status": "todo",
      "details": "The TaskStore.Get() method returns (Task, bool, error) but tests on lines 255 and 269 only capture 2 values. Fix assignment to capture all 3 return values.",
      "steps": [
        "Update line 255: capture (refreshed, found, err) instead of (refreshed, err)",
        "Update line 269: capture (refreshed, found, err) instead of (refreshed, err)",
        "Run tests to verify fixes: go test ./internal/storage -count=1"
      ],
      "files": [
        "internal/storage/task_store_test.go"
      ],
      "tags": [
        "bug",
        "tests",
        "compilation"
      ],
      "updated_at": "2026-02-17T12:45:00Z"
    },
    {
      "id": "T155",
      "title": "Investigate and fix multiple integration test failures",
      "priority": 1,
      "status": "todo",
      "details": "Integration tests showing failures in TestIntegrationTickEndToEndWritesArtifacts and others. Tests returning exit code 1 instead of expected 0/10/11/3. Need to diagnose root cause and fix.",
      "steps": [
        "Run tests individually to isolate failure patterns",
        "Check test model server setup and mock responses",
        "Verify test environment setup is correct",
        "Fix underlying issues causing test failures"
      ],
      "files": [
        "cmd/bare/integration_test.go"
      ],
      "tags": [
        "tests",
        "integration",
        "bug"
      ],
      "updated_at": "2026-02-17T12:45:00Z"
    }
  ]
}