From 22e6dc0747a5416e4ca554f332c3c41216bfd7ab Mon Sep 17 00:00:00 2001 From: Tin Dang Date: Thu, 11 Jun 2026 11:08:21 +0700 Subject: [PATCH 01/12] chore(config): adopt ADD workflow with v1 shared-nothing milestone Onboard the repo onto the ADD (AI-Driven Development) state-tracked workflow. Foundation mapped from code (PROJECT/CONVENTIONS/GLOSSARY/ allowlist), baseline locked by Tin Dang. Milestone v1-shared-nothing implements the 2026-06 architecture review priorities 1/2/5: restore shared-nothing integrity, remove the 1ms monoio cross-shard reply floor, and the hot-path lock quick-wins batch. First task hotpath-lock-quickwins: contract FROZEN @ v1 (8 quick wins, behavior parity frozen, both runtimes). author: Tin Dang --- .add/CONVENTIONS.md | 10 + .add/GLOSSARY.md | 40 + .add/MODEL_REGISTRY.md | 6 + .add/PROJECT.md | 44 + .add/SETUP-REVIEW.md | 19 + .add/dependencies.allowlist | 66 + .add/docs/00-introduction.md | 46 + .add/docs/01-principles.md | 71 + .add/docs/02-the-flow.md | 100 + .add/docs/03-step-1-specify.md | 117 + .add/docs/04-step-2-scenarios.md | 80 + .add/docs/05-step-3-contract.md | 80 + .add/docs/06-step-4-tests.md | 73 + .add/docs/07-step-5-build.md | 80 + .add/docs/08-step-6-verify.md | 81 + .add/docs/09-the-loop.md | 67 + .add/docs/10-setup-and-stages.md | 118 + .add/docs/11-governance.md | 87 + .add/docs/12-roles.md | 99 + .add/docs/13-adoption.md | 67 + .add/docs/14-foundation.md | 129 + .add/docs/15-foundations-and-lineage.md | 106 + .add/docs/README.md | 74 + .add/docs/add-competencies.png | Bin 0 -> 247915 bytes .add/docs/add-flow.png | Bin 0 -> 187264 bytes .add/docs/add-foundation.png | Bin 0 -> 197085 bytes .add/docs/add-hierarchy.png | Bin 0 -> 218863 bytes .add/docs/appendix-a-templates.md | 88 + .add/docs/appendix-b-prompts.md | 154 + .add/docs/appendix-c-glossary.md | 115 + .add/docs/appendix-d-worked-example.md | 152 + .add/docs/appendix-e-checklists.md | 80 + .add/docs/appendix-f-requirements-matrix.md | 171 + .add/docs/appendix-g-references.md | 106 + .../milestones/v1-shared-nothing/MILESTONE.md | 36 + .add/state.json | 40 + .add/tasks/hotpath-lock-quickwins/TASK.md | 218 ++ .add/tooling/add.py | 2899 +++++++++++++++++ .add/tooling/templates/CONVENTIONS.md.tmpl | 8 + .add/tooling/templates/GLOSSARY.md.tmpl | 26 + .add/tooling/templates/MILESTONE.md.tmpl | 26 + .add/tooling/templates/MODEL_REGISTRY.md.tmpl | 6 + .add/tooling/templates/PROJECT.md.tmpl | 43 + .add/tooling/templates/TASK.md.tmpl | 139 + .../templates/dependencies.allowlist.tmpl | 2 + .claude/skills/add/SKILL.md | 147 + .claude/skills/add/adopt.md | 67 + .claude/skills/add/deltas.md | 81 + .claude/skills/add/fold.md | 68 + .claude/skills/add/graduate.md | 74 + .claude/skills/add/intake.md | 64 + .claude/skills/add/loop.md | 59 + .claude/skills/add/phases/0-setup.md | 103 + .claude/skills/add/phases/1-specify.md | 65 + .claude/skills/add/phases/2-scenarios.md | 46 + .claude/skills/add/phases/3-contract.md | 70 + .claude/skills/add/phases/4-tests.md | 61 + .claude/skills/add/phases/5-build.md | 48 + .claude/skills/add/phases/6-verify.md | 73 + .claude/skills/add/phases/7-observe.md | 40 + .claude/skills/add/report-template.md | 106 + .claude/skills/add/run.md | 171 + .claude/skills/add/scope.md | 80 + .claude/skills/add/setup-review.md | 65 + .claude/skills/add/streams.md | 256 ++ AGENTS.md | 26 + CLAUDE.md | 27 + 67 files changed, 7766 insertions(+) create mode 100644 .add/CONVENTIONS.md create mode 100644 .add/GLOSSARY.md create mode 100644 .add/MODEL_REGISTRY.md create mode 100644 .add/PROJECT.md create mode 100644 .add/SETUP-REVIEW.md create mode 100644 .add/dependencies.allowlist create mode 100644 .add/docs/00-introduction.md create mode 100644 .add/docs/01-principles.md create mode 100644 .add/docs/02-the-flow.md create mode 100644 .add/docs/03-step-1-specify.md create mode 100644 .add/docs/04-step-2-scenarios.md create mode 100644 .add/docs/05-step-3-contract.md create mode 100644 .add/docs/06-step-4-tests.md create mode 100644 .add/docs/07-step-5-build.md create mode 100644 .add/docs/08-step-6-verify.md create mode 100644 .add/docs/09-the-loop.md create mode 100644 .add/docs/10-setup-and-stages.md create mode 100644 .add/docs/11-governance.md create mode 100644 .add/docs/12-roles.md create mode 100644 .add/docs/13-adoption.md create mode 100644 .add/docs/14-foundation.md create mode 100644 .add/docs/15-foundations-and-lineage.md create mode 100644 .add/docs/README.md create mode 100644 .add/docs/add-competencies.png create mode 100644 .add/docs/add-flow.png create mode 100644 .add/docs/add-foundation.png create mode 100644 .add/docs/add-hierarchy.png create mode 100644 .add/docs/appendix-a-templates.md create mode 100644 .add/docs/appendix-b-prompts.md create mode 100644 .add/docs/appendix-c-glossary.md create mode 100644 .add/docs/appendix-d-worked-example.md create mode 100644 .add/docs/appendix-e-checklists.md create mode 100644 .add/docs/appendix-f-requirements-matrix.md create mode 100644 .add/docs/appendix-g-references.md create mode 100644 .add/milestones/v1-shared-nothing/MILESTONE.md create mode 100644 .add/state.json create mode 100644 .add/tasks/hotpath-lock-quickwins/TASK.md create mode 100644 .add/tooling/add.py create mode 100644 .add/tooling/templates/CONVENTIONS.md.tmpl create mode 100644 .add/tooling/templates/GLOSSARY.md.tmpl create mode 100644 .add/tooling/templates/MILESTONE.md.tmpl create mode 100644 .add/tooling/templates/MODEL_REGISTRY.md.tmpl create mode 100644 .add/tooling/templates/PROJECT.md.tmpl create mode 100644 .add/tooling/templates/TASK.md.tmpl create mode 100644 .add/tooling/templates/dependencies.allowlist.tmpl create mode 100644 .claude/skills/add/SKILL.md create mode 100644 .claude/skills/add/adopt.md create mode 100644 .claude/skills/add/deltas.md create mode 100644 .claude/skills/add/fold.md create mode 100644 .claude/skills/add/graduate.md create mode 100644 .claude/skills/add/intake.md create mode 100644 .claude/skills/add/loop.md create mode 100644 .claude/skills/add/phases/0-setup.md create mode 100644 .claude/skills/add/phases/1-specify.md create mode 100644 .claude/skills/add/phases/2-scenarios.md create mode 100644 .claude/skills/add/phases/3-contract.md create mode 100644 .claude/skills/add/phases/4-tests.md create mode 100644 .claude/skills/add/phases/5-build.md create mode 100644 .claude/skills/add/phases/6-verify.md create mode 100644 .claude/skills/add/phases/7-observe.md create mode 100644 .claude/skills/add/report-template.md create mode 100644 .claude/skills/add/run.md create mode 100644 .claude/skills/add/scope.md create mode 100644 .claude/skills/add/setup-review.md create mode 100644 .claude/skills/add/streams.md create mode 100644 AGENTS.md diff --git a/.add/CONVENTIONS.md b/.add/CONVENTIONS.md new file mode 100644 index 000000000..438581913 --- /dev/null +++ b/.add/CONVENTIONS.md @@ -0,0 +1,10 @@ +# CONVENTIONS (living documentation — set once, kept for the whole project) + + +Language/framework: Rust 1.94 (edition 2024, MSRV enforced in CI) · runtimes: monoio (default, io_uring) + tokio (portability/CI) +Folders: production code in `src//` (directory-module convention: `mod.rs` + split read/write files); tests in `tests/` (integration, real server instances — no mocking) + `#[cfg(test)]` in `mod.rs`; benches in `benches/` (Criterion); fuzz targets in `fuzz/fuzz_targets/`. ADD task files: `.add/tasks//TASK.md` (task tests/src point INTO the repo tree, declared per-task). +Naming: snake_case files/functions · PascalCase types · SCREAMING_SNAKE consts · crate:: imports in submodules (never super::super) +Lint/format: `cargo fmt --check` · `cargo clippy -- -D warnings` (default + tokio,jemalloc feature sets) · unsafe audit (`scripts/audit-unsafe.sh`) · unwrap ratchet (`scripts/audit-unwrap.sh`) — all enforced in CI +Errors: command errors are `Frame::Error(Bytes)` with Redis-compatible `-ERR …` text on dispatch paths (no Result); library code uses `thiserror`; `anyhow` only in main.rs/tests; no unwrap/expect in library code +Architecture: thread-per-core shared-nothing shards; per-shard locks only (parking_lot, never std::sync; never held across .await); no global locks on the write path; no allocation on hot paths (command dispatch, protocol parse, event loop, io drivers); cross-shard communication via flume/SPSC messages only; dual-runtime: all runtime-specific code compiles under both feature sets; Linux-only code behind `#[cfg(target_os = "linux")]` with non-Linux fallback; files ≤1500 lines (split into directory modules) +Verification: red/green TDD per task; full local CI parity via OrbStack `moon-dev` before push; benchmark numbers from Linux VM only; new parsers get fuzz targets; new atomic state machines get loom models diff --git a/.add/GLOSSARY.md b/.add/GLOSSARY.md new file mode 100644 index 000000000..d6621f441 --- /dev/null +++ b/.add/GLOSSARY.md @@ -0,0 +1,40 @@ +# GLOSSARY (one name per concept — used everywhere: specs, contracts, code) +# Moon domain terms — evidence-grounded: src/ module tree, CLAUDE.md, README.md + +shard: a thread-per-core unit owning one keyspace slice, its event loop, DashTable, WAL writer, and blocking/pubsub registries; the unit of shared-nothing isolation (src/shard/). +SPSC mesh: the grid of single-producer/single-consumer ring channels (256 entries) carrying ShardMessage between shards; the ONLY sanctioned cross-shard mutation path (src/shard/mesh.rs). +shard event loop: the per-shard select! loop (monoio or tokio) draining I/O, SPSC messages, and the 1ms tick; nothing on it may block (src/shard/event_loop.rs). +ShardSlice: the thread-local, lock-free per-shard state access path (`with_shard`) meant to replace the locked Arc; migration in progress, gated on `is_initialized()` (src/shard/slice.rs). +ShardDatabases: the legacy Arc-shared, RwLock-per-DB store every shard can reach — the shared-nothing leak the ShardSlice migration removes (src/shard/shared_databases.rs). +Frame: the RESP protocol value enum (SimpleString, BulkString, Array, Error, …); command errors are Frame::Error, never Result (src/protocol/frame.rs). +DashTable: the per-shard extendible-hashing table (segments × 60 slots) holding CompactKey→Entry (src/storage/dashtable/). +CompactKey / CompactValue: SSO entry types — keys ≤23B and values ≤12B inline, heap beyond via tagged pointer (src/storage/compact_value.rs). +WAL (wal_v3): the per-shard write-ahead log; 1ms buffered flush, 1s fdatasync under everysec (src/persistence/wal_v3/). +AOF: append-only-file persistence layered on the WAL with rewrite/manifest machinery (src/persistence/aof/). +segment (vector): the FT.* index lifecycle unit — mutable (brute-force) → compact → immutable (HNSW + quantized codes); merged in the background (src/vector/segment/). +cross-shard latency floor: the ~1ms minimum cross-shard reply latency on monoio caused by the pending_wakers 1ms-tick relay (event_loop.rs:1049) — v1 milestone target. +hot path: command dispatch, protocol parsing, shard event loop, io drivers — the zones where allocation and locks are forbidden (CLAUDE.md "Allocations on Hot Paths"). +2026-06 architecture review: the principal-level performance review (this session) cataloguing shared-nothing violations, dispatch-floor causes, and event-loop blocking work; source of v1+ milestone priorities. + +# ADD method vocabulary (domain-standard names; bridges to legacy terms) +GOAL: the one durable outcome a project (and each milestone) runs toward — the loop's orientation anchor, declared as the lowercase `goal:` line in PROJECT.md / MILESTONE.md and surfaced by status/guide every session; distinct from a task's §1 Must (a single required behavior, not the whole-project outcome). +deep verify: the deepened Verify evidence (v20) required beyond passing tests — for a task that produced code, that every new symbol is referenced (wiring) and no new dead/unused code exists; for prose/non-code, a recorded no-skim semantic read; which path applies is resolver-judged and the engine never classifies (a rubric, not add.py). +onboarding: the install -> first-milestone path (formerly "on-ramp"). +primary flow: the solid forward path of the flow diagram — a phase starts only when its input exists (formerly "forward spine"). +cross-cutting concern: a concern running through every step rather than being one step — security, testing, observability, cost (formerly "spine / continuous concern"). +working state: everything an agent loads each session — skill router, active phase, PROJECT/MILESTONE/TASK, state.json (formerly "state surface"). +audit trail: the reference record read by people, never auto-loaded into agent context (formerly "story surface"). +method rationale: the why behind every rule — the AIDD book, loaded on demand, never duplicated (formerly "trust layer"). +failing-first suite: the test suite written before code, confirmed red for the right reason — a missing implementation (formerly "red safety net"). +non-functional review: the deliberate post-evidence check of what tests rarely catch — concurrency, security, architecture (formerly "blind-spot checks"). +change scope: the files a locked run may and may not touch (formerly "touch-boundary"; the XML prompt tag keeps its name). +automated quality gate: the evidence-based Verify resolver under autonomy auto — may auto-PASS on complete evidence; security always escalates (formerly "evidence auto-gate"). +autonomy level: the per-task Verify resolver setting — auto (default) or conservative; declared in the TASK.md header, human-reviewed at the freeze (formerly "autonomy dial"). +living documentation: the durable project artifacts — conventions, glossary, frozen contracts — that outlive any particular code (formerly "survivor layer"). +scope level: the granularity a decision lives at — intake level (request -> versioned scope), milestone level, setup/foundation level, task level (formerly "altitude"). +baseline approval: the one human gate that freezes the AI-drafted foundation, first scope, and first contract together — runs as `add.py lock` (formerly "the lock-down"). +lesson learned: a single learning a loop produces, tagged by the competency it improves — the `- [DDD · open]` grammar and deltas.md/`add.py deltas` machine names stay (formerly "competency delta"). +lowest-confidence flag: the AI's ranked declaration of the 1–2 points most likely to be wrong in what a human is asked to approve — each with why + cost-if-wrong; the ⚠ glyph keeps its name as the machine marker (formerly "least-sure flag"). +decision point: a stop for human judgment — the contract-freeze approval, an escalated verify gate, intake confirmation, milestone close; the machine names seam (--json owner enum, decide key) and seam-audit (CI job) keep their names (formerly "seam"). +retrospective consolidation: gathering confirmed lessons learned at milestone close and writing them append-only into the versioned foundation — human-confirmed, never self-approved; the machine names fold.md, the folded status, and add.py deltas keep their names (formerly "the fold / fold ritual"). +specification bundle: a task's spec, scenarios, contract, and failing tests drafted as one piece and approved by a person once at the contract freeze (formerly "the one-approval front"). diff --git a/.add/MODEL_REGISTRY.md b/.add/MODEL_REGISTRY.md new file mode 100644 index 000000000..1386b6a42 --- /dev/null +++ b/.add/MODEL_REGISTRY.md @@ -0,0 +1,6 @@ +# MODEL_REGISTRY (which AI wrote this project — for reproducibility & audit) + +Model: Claude (Anthropic) — Claude Code CLI +Version: claude-fable-5 (adopted at ADD onboarding; earlier code AI-assisted with prior Claude versions per git history) +Adopted: 2026-06-11 +Notes: pre-ADD codebase (v0.3.0) was substantially AI-assisted (Claude Code review runs on PRs per CI). Re-run the playbook golden-cases before changing this. diff --git a/.add/PROJECT.md b/.add/PROJECT.md new file mode 100644 index 000000000..f56b3a9a3 --- /dev/null +++ b/.add/PROJECT.md @@ -0,0 +1,44 @@ +# PROJECT — living documentation (cross-milestone context) + +> The durable foundation that outlives every milestone and feeds context into each +> TDD⇄ADD loop. Read this FIRST in any session. Keep it lean — one screen, not a +> manual. Map to the AIDD diagram: Domain = DDD · Spec = SDD (living document) · +> UI/UX = UDD. When a loop reveals a gap here, come back and update this file — +> that is the re-entrant arrow from the engine down to the foundation. + +slug: moon · stage: production · updated: 2026-06-11 +goal: a Redis-compatible server whose thread-per-core architecture measurably out-scales Redis on multi-core hardware — without sacrificing protocol compatibility or durability semantics + +--- + +## Domain (DDD) — the language and the boundaries + +- Core concepts: Shard (thread-per-core owner of a keyspace slice) · Frame (RESP protocol unit) · DashTable (per-shard hash storage) · CompactKey/CompactValue (SSO entry types) · SPSC mesh (cross-shard dispatch channels) · WAL/AOF (per-shard durability log) · Segment (vector index lifecycle unit: mutable → immutable) +- Bounded contexts / modules: `protocol/` (RESP parse/serialize) · `shard/` (event loop, dispatch, coordinator) · `storage/` (dashtable, eviction, tiered) · `persistence/` (wal_v3, aof, page_cache) · `vector/` + `command/vector_search/` (FT.* engine) · `command/` (dispatch tables) · `io/` (uring driver) · `runtime/` (monoio/tokio abstraction) · cross-cutting: `acl/ pubsub/ replication/ cluster/ blocking/ transaction/ scripting/ tracking/` +- Invariants that must always hold: + - Shared-nothing per shard: no global locks on the command write path (CLAUDE.md "Lock Handling") — **currently violated in ≥8 places (2026-06 architecture review)** + - Malformed client input never crashes the server (`parse_frame_zerocopy` returns `Frame::Null`) + - No new `unsafe` without approval + `// SAFETY:` comment (UNSAFE_POLICY.md) + - No alloc in command dispatch / protocol parse / shard event loop / io drivers + - All runtime-specific code compiles under both `runtime-monoio` and `runtime-tokio` + +## Spec / Living Document (SDD) — what we are building, now +- Active milestone → `.add/milestones/v1-shared-nothing/MILESTONE.md` (see `add.py status`) +- Frozen contracts (living docs): RESP2/RESP3 wire compatibility with Redis (external, immutable); CI matrix (fmt, clippy ×2, tests ×2, MSRV 1.94, unsafe/unwrap audits, fuzz) +- Settled vs still open: settled — thread-per-core + SPSC mesh architecture, monoio default on Linux. Open — sub-linear multi-shard scaling (root causes mapped in 2026-06 review: leaky shared-nothing + 1ms monoio wake floor) + +## Users (UDD) — UI/UX: design before code +- No UI — surface is the **Redis wire protocol** (RESP2/RESP3) plus CLI flags (`--port --shards --appendonly --dir …`) and INFO/Prometheus metrics. +- Primary users & jobs: backend engineers replacing Redis for higher throughput/lower memory per node; benchmark parity tooling (`scripts/bench-*.sh`, `redis-benchmark`). +- Core flows: connect → AUTH/HELLO → command pipeline → responses; ops flows: persistence reload, replication, FT.* vector search. +- UI states: error surface = RESP error frames with Redis-compatible messages (`-ERR …`); never a crash, never a hang. +- Design source of truth → README.md (architecture diagram + command reference). + +## Key Decisions (append-only) +| date | decision | why | outcome | +|------|----------|-----|---------| +| pre-ADD | thread-per-core, monoio/io_uring default on Linux | syscall/wakeup cost dominates at high QPS | shipped v0.3.0 | +| pre-ADD | per-shard WAL, no global append lock | Redis single-AOF serializes at depth | AOF advantage grows with pipeline depth | +| pre-ADD | SSO CompactKey(23B)/CompactValue(12B) | per-key memory vs naive Arc | lower RSS than Redis per key | +| 2026-06-11 | adopt ADD; v1 milestone = restore shared-nothing integrity + remove cross-shard latency floor (review priorities 1·2·5) | 2026-06 architecture review: these two themes explain sub-linear multi-shard scaling | pending | +| 2026-06-11 | FT.SEARCH off-event-loop + WAL group commit deferred to v2 | different themes (event-loop blocking; durability); keep v1 one outcome | recorded in v1 Out list | diff --git a/.add/SETUP-REVIEW.md b/.add/SETUP-REVIEW.md new file mode 100644 index 000000000..7c96c185f --- /dev/null +++ b/.add/SETUP-REVIEW.md @@ -0,0 +1,19 @@ +# SETUP REVIEW — moon + +production · brownfield · drafted by claude-fable-5 @ 2026-06-11 + +| # | Decision | Lands in | Tag | Why / Evidence | +|---|----------|----------|-----|----------------| +| 1 | QW4 (per-shard command counters) assumes the Prometheus `counter!` path can split per-shard, and that scrape-read aggregation freshness is acceptable | first-contract | `guessed` | The `metrics` crate's recorder API may not register per-shard handles cleanly (src/admin/metrics_setup.rs uses global macros). Fallback shrinks the win to the bespoke `TOTAL_COMMANDS` atomic only. | +| 2 | QW8 (client registry off the per-batch path) assumes CLIENT LIST tolerates on-change/atomic metadata updates instead of per-batch write-lock updates | first-contract | `guessed` | No test pins CLIENT LIST `cmd`/`age` freshness; redis-tooling expectations inferred. Fallback: per-connection atomics (still lock-free). | +| 3 | v1 milestone scopes review priorities 1·2·5 together and defers FT.SEARCH offload + WAL group commit to v2 | scope | `guessed` | My sizing judgment: one outcome (restore shared-nothing + remove latency floor); priorities 3·4 are different themes. You may prefer FT.SEARCH offload sooner if vector workloads are imminent. | +| 4 | Exit criterion "cross-shard SET/GET p99 < 1ms on monoio" is achievable once the 1ms waker relay is replaced | scope | `guessed` | Inferred from event_loop.rs:1049 comments; no prototype of the eventfd wake exists yet. If wrong: criterion relaxes to "p99 materially below current baseline". | +| 5 | First task = the quick-wins batch (8 items in one task) rather than 8 micro-tasks or starting with the ShardSlice migration | scope | `guessed` | Items are mechanical and share one bench baseline; doing them first de-noises the bigger tasks' measurements. ShardSlice (your priority 1) lands as task 3 with the frozen contract named in MILESTONE.md. | +| 6 | Project goal sentence ("out-scales Redis on multi-core hardware …") | PROJECT.md | `guessed` | Inferred from README positioning + bench tooling; the repo states no explicit mission sentence. | +| 7 | The 8 quick-win code targets exist as described (Mutex'd WAL sender, RwLock'd offsets, global TOTAL_COMMANDS, per-byte backlog loop, Vec::remove(0), unpruned key maps, per-batch registry write, missing TCP_NODELAY) | first-contract | `evidence-grounded` | Each verified by direct read this session: shared_databases.rs:159 · spsc_handler.rs:3089 + state.rs:138 · metrics_setup.rs:401 · backlog.rs:35 · uring_handler.rs:346 · vector/store.rs:192 (zero `.remove` calls) · client_registry.rs:80 + handler_sharded/mod.rs:1868 · grep shows set_nodelay only in moon-bench.rs. | +| 8 | Domain map, invariants, conventions, glossary terms | PROJECT.md / CONVENTIONS.md / GLOSSARY.md | `evidence-grounded` | CLAUDE.md (coding rules, gotchas), README.md, src/ module tree, Cargo.toml. | +| 9 | Dependency allowlist | dependencies.allowlist | `evidence-grounded` | Cargo.toml `[dependencies]` + feature-gated crates, v0.3.0. | +| 10 | Stage = production (full rigor, observe loop) | foundation | `evidence-grounded` | v0.3.0 shipped with signed release assets, CI matrix, fuzz + safety audits (git history, .github/workflows). | +| 11 | Behavior parity is a frozen contract for all v1 tasks (RESP bytes, INFO fields, 132 consistency tests) | scope | `evidence-grounded` | scripts/test-consistency.sh + CI define the parity surface; v1 is perf-only by the user's request. | + +Sign: confirm in chat → the agent runs `add.py lock --by "Tin Dang"` (typing it yourself works too) diff --git a/.add/dependencies.allowlist b/.add/dependencies.allowlist new file mode 100644 index 000000000..5f23555ef --- /dev/null +++ b/.add/dependencies.allowlist @@ -0,0 +1,66 @@ +# dependencies.allowlist — one package per line; CI rejects anything not listed. +# Defeats the AI "invented a plausible package name" supply-chain risk. +# evidence-grounded: Cargo.toml [dependencies] (+ optional/feature-gated crates) as of v0.3.0. + +atoi +bumpalo +bytes +memchr +smallvec +thiserror +mimalloc +crc32c +crossbeam-utils +flume +atomic-waker +tokio +tokio-util +clap +tracing +tracing-subscriber +anyhow +futures +ordered-float +phf +rand +crc16 +crc32fast +arc-swap +parking_lot +itoa +xxhash-rust +ringbuf +core_affinity +once_cell +mlua +sha1_smol +sha2 +hex +uuid +ctrlc +metrics +metrics-exporter-prometheus +rustls +rustls-pemfile +aws-lc-rs +tokio-rustls +monoio-rustls +roaring +serde +serde_json +socket2 +memmap2 +lz4_flex +dashmap +# feature-gated / platform +monoio +io-uring +libc +jemallocator +cudarc +# dev/test/bench +criterion +loom +proptest +tempfile +redis diff --git a/.add/docs/00-introduction.md b/.add/docs/00-introduction.md new file mode 100644 index 000000000..e915aa134 --- /dev/null +++ b/.add/docs/00-introduction.md @@ -0,0 +1,46 @@ +# 00 · The shift: why AIDD exists + +[Contents](./README.md) · Next: [01 Core principles →](./01-principles.md) + +--- + +## Code became cheap + +For the whole history of software, writing code was the slow, expensive, central act. Methodologies — waterfall, agile, and the rest — were arrangements for managing that expensive act: how to plan it, divide it, review it, and ship it. + +AI changed the cost. An agent can now produce a working module in the time it takes to describe it. The marginal cost of *writing* a piece of code, and of *re-writing* it, has fallen close to zero. + +When the cost of one activity collapses, value moves to whatever is still scarce. Three things remain scarce: + +1. **Validated decisions** — knowing what should be built, and being right about it. +2. **Stable contracts** — the agreed interfaces and data shapes that everything else depends on. +3. **Verification capacity** — the rate at which people can confirm that what was produced is actually correct. + +AIDD is a development method organized around protecting those three things, because they are now where the difficulty lives. + +## The failure mode AIDD prevents + +The naïve way to use an AI agent is to describe a feature in a sentence and accept whatever it returns. This works for a throwaway script and fails for real software, for one reason: **an AI agent is fast in whatever direction it is pointed.** + +If the direction is vague, the agent does not slow down and ask. It produces a confident, plausible, complete-looking result that is subtly wrong — built on an assumption you never made, missing an edge case you never stated. Because it looks finished, the error survives a quick read and surfaces later, when it is expensive to fix. + +Speed in the wrong direction is not progress; it is faster waste. The entire purpose of AIDD is to fix the direction *before* turning on the speed. + +## Where value moves — and what that means for you + +If writing code is no longer the scarce skill, then a software person's value is no longer "can write code." It is two new things: + +- **Direction** — turning a fuzzy need into an unambiguous, buildable definition. +- **Verification** — establishing, through evidence, that the result is correct and safe. + +This is not a smaller job than coding; it is a harder one. It is the part of engineering that was always the real work, now made explicit because the typing has been automated away. + +## What this book gives you + +The rest of the book is the practical consequence of the shift: + +- A **flow** (Part II) that front-loads direction and back-loads AI execution, with verification built in. +- An **operating manual** (Part III) for running that flow across stages, roles, and risk levels. +- **Reference material** (Part IV) — templates, prompts, and a fully worked example — so the method is concrete from day one. + +> **The thesis in one line.** Build the right thing (direction), prove it is right (verification), and let the AI do the building in between. diff --git a/.add/docs/01-principles.md b/.add/docs/01-principles.md new file mode 100644 index 000000000..600edc6f5 --- /dev/null +++ b/.add/docs/01-principles.md @@ -0,0 +1,71 @@ +# 01 · Core principles + +[← 00 The shift](./00-introduction.md) · [Contents](./README.md) · Next: [02 The flow →](./02-the-flow.md) + +Everything in this book follows from a small set of principles. If a practice ever seems arbitrary, trace it back to one of these. + +--- + +## 1. Direction before speed + +An AI agent accelerates in whatever direction it is given. Therefore the direction must be fixed before the acceleration begins. In practice this means the early, human-led steps of the flow are not optional preamble — they are the steering, and the build step is the engine. You do not start the engine until the wheel is set. + +**Consequence:** the specification, scenarios, and contract come *before* any code, every time. + +## 2. Trust through evidence, not inspection + +AI output is often wrong in ways that read as correct. You cannot establish correctness by reading the code and judging it plausible. You establish it by defining, in advance, what "correct" means — as automated tests — and confirming the code satisfies them, then checking by hand only the narrow set of things tests cannot catch. + +**Consequence:** tests are written *before* the implementation, and a feature is trusted because its tests pass, not because someone reviewed it and liked it. + +## 3. The artifacts survive; the code is disposable + +The durable assets of a project are the decisions and agreements: the specification, the scenarios, the contract, the tests. The code is merely one implementation that satisfies them and can be regenerated at will. Protect the artifacts; treat the code as replaceable. + +**Consequence:** effort goes into keeping contracts and specs stable and clear, not into preserving particular code. Metrics that count code volume or reuse measure the wrong thing. + +## 4. The loop is re-entrant, not a waterfall + +The flow has an order, but it is not a one-way march. Any step may reveal a gap in an earlier one — and when it does, you return to that earlier step, fix the artifact, and come forward again. The specification is a living document, not a frozen contract signed once. + +**Consequence:** discovering a missing rule during the build is the method working, not failing. The only true one-way door is the frozen interface contract, and even that reopens through a deliberate change request. + +## 5. Trust is earned per scope, not granted globally + +How much you let the AI do is not a single switch. It is a setting that lives *per scope*, and it can differ from one part of the system to another. A well-tested, low-risk area may run at full autonomy while a new, high-risk one is held back. + +The *default starting point* is a deliberate choice. A team that has built up evidence and tooling may **start a scope at auto** — the AI drafts the specification bundle, a human approves the frozen contract once, and the build runs and auto-gates on evidence — and *lower to conservative* wherever risk is high. (An earlier formulation started every scope conservative and made autonomy the earned exception; it is the same control either way — what differs is which end you default to.) Two things never move with the default, whichever way it points: the contract-freeze decision point stays human (the AI never freezes the interface it then builds against), and a high-risk scope is always lowered, never auto-run. + +**Consequence:** autonomy is a per-scope setting you choose deliberately and can lower at any time; high-risk scope is held to a human gate regardless of the default (see [11 Governance](./11-governance.md)). + +## 6. You cannot move faster than you can verify + +When an agent produces more than the team can review, the excess is not speed — it is unreviewed risk accumulating. Verification capacity is the real ceiling on throughput. + +But *verification* is not the same as *human reading*. The ceiling is what you can trust to a recorded standard, and automated verification raises it: a passing test suite, a contract check, an adversarial verifier are all verification, and they scale in a way human review cannot. This is only principle 2 taken to its limit. What automation cannot cover is the residue principle 2 names — the narrow set tests miss: security, concurrency, and architecture. That residue stays at human speed. So the rule sharpens: you may move as fast as your *automated* verification carries you, and no faster on the part only a human can check. + +**Consequence:** if AI output outpaces verification, the correct response is to strengthen the automated checks or reduce the AI's autonomy — never to rush or skip. More autonomy is earned by more verification, not by a lower bar. + +## 7. No silent skips + +Every checkpoint resolves explicitly. A step is either passed, or passed with a recorded and signed acceptance of a known risk, or stopped. Nothing is quietly waved through. + +An *automated* pass is still an explicit pass, not a skip — provided it records an outcome and escalates what it cannot judge. A gate may be resolved by evidence rather than by a person when that evidence is sufficient and the result is logged to an accountable owner: a named run, against a recorded standard, is as accountable as a signature. The line between a pass and a skip is the recorded outcome, not who signed it. The exception is absolute: security always escalates to a human and is never auto-passed — a security finding is a hard stop, whatever the evidence says. + +**Consequence:** every gate produces a recorded outcome with an accountable owner — a person, or a named automated run — and security always stops for a person (see [11 Governance](./11-governance.md)). + +## 8. Tool-agnostic by construction + +The instructions you give the AI are plain text that reference files in the repository, not commands tied to one product. Enforcement of the gates lives in your build pipeline, not in the agent. This keeps the method portable: the agent is replaceable; the method is not. + +**Consequence:** the same project works whether the team uses one AI coding tool or another, and switching tools changes nothing structural. + +## 9. Two layers: the working state you load, the audit trail you reference + +A method that fills the context window with its own documentation defeats itself — the agent rots before it reaches the work. So ADD keeps two documentation layers and never loads both. The **working state** is everything an agent loads to do the work each session: the `add` skill itself (its router `SKILL.md` and the one phase currently in play) together with the lean, current operational docs — `PROJECT.md` (the foundation), the active `MILESTONE.md`, the active `TASK.md`, and `state.json`. The **audit trail** is this book plus the records behind it: the whole method, read once by a person to understand and trust ADD, and thereafter **never auto-loaded** into agent context — only referenced by a pointer. Depth lives in the audit trail; leanness is enforced on the working state; they never compete for the same tokens. + +**Consequence:** the book can be as rich as trust requires without costing a single runtime token, while the loaded surface stays small enough never to rot. It is why the guideline block in `CLAUDE.md`/`AGENTS.md` *points* to `add.py status` and `PROJECT.md` rather than copying them. + +--- + +> **The principles, compressed.** Steer before you accelerate. Trust evidence, not impressions. Keep the decisions, throw away the code. Loop freely, but never skip silently. Load the State; reference the Story. Grant the AI only as much autonomy as you can verify. diff --git a/.add/docs/02-the-flow.md b/.add/docs/02-the-flow.md new file mode 100644 index 000000000..0de1c8d91 --- /dev/null +++ b/.add/docs/02-the-flow.md @@ -0,0 +1,100 @@ +# 02 · The flow, and what is disposable + +[← 01 Core principles](./01-principles.md) · [Contents](./README.md) · Next: [03 Step 1 Specify →](./03-step-1-specify.md) + +--- + +## The flow + +AIDD is one repeatable flow of **seven steps**: six build the feature — Specify → Scenarios → Contract → Tests → Build → Verify — and the seventh, **Observe**, feeds what production teaches back into the next Specify. In the default flow the AI drafts the specification bundle (steps 1–4) and a person approves it **once**, at the contract freeze; the AI performs the Build; and Verify is resolved on evidence under `autonomy: auto`, with a person owning any residue. (See [11 Governance](./11-governance.md) for the autonomy level and the one-approval decision point.) + +![The ADD flow — a solid primary flow Specify→Scenarios→Contract→Tests→Build→Verify→Observe, with dashed backward-correction arrows (any phase may return to an earlier one), a Tests⇄Build red/green engine, and Observe looping back to the next Specify](./add-flow.png) + +```mermaid +flowchart LR + S1["1 Specify
the rules"] --> S2["2 Scenarios
pass/fail cases"] + S2 --> S3["3 Contract
freeze the shape"] + S3 --> S4["4 Tests
failing-first (red)"] + S4 --> S5["5 Build
AI writes code"] + S5 --> S6["6 Verify
evidence + checks"] + S6 --> OBS["Observe
in production"] + S5 -. "red / green engine" .-> S4 + S6 -. "evidence fails → back to Build" .-> S5 + S5 -. "a missing rule → back to Specify" .-> S1 + OBS -. "what you learn becomes the next spec" .-> S1 + classDef human fill:#FAEEDA,stroke:#BA7517,color:#633806; + classDef decision fill:#E1F5EE,stroke:#0F6E56,color:#04342C; + classDef machine fill:#E6F1FB,stroke:#185FA5,color:#042C53; + class S1,S2 human; + class S3,S4 decision; + class S5,S6 machine; +``` + +> **Solid arrows are the primary flow** — you never start a phase before its input exists (forward-skip forbidden). **Dashed arrows are backward correction** — any phase may return to an earlier one to repair its artifact (the long loop, Observe → Specify, is the same rule at milestone scale). The tight Tests ⇄ Build cycle is the per-feature red/green engine. + +```text + human-led ─────────────────►│◄─────────── machine-led ──► human verify + 1 Specify → 2 Scenarios → 3 Contract → 4 Tests ⇄ 5 Build → 6 Verify + ▲ (freeze) └red/green┘ (AI) (people) + ╎ │ + ╎╴╴ backward correction (dashed): any phase may return to ╴╴╴┤ + ╎ an earlier one — e.g. Build exposes a missing rule │ + │ │ + │ observe in production ◄──────────────────┘ + │ │ + └─────────────────────────┘ becomes the next Specify +``` + +The shape is deliberate: the human-led steps establish direction, a frozen contract forms the decision point in the middle, and the AI-led build runs fast and safely on the far side because everything it needs is already fixed. + +> **What changed in v7 (the diagrams above show the structural flow, which is unchanged).** The *steps* and their order are exactly as drawn — only **who resolves them** moved. The AI now drafts the whole specification bundle (steps 1–4) and a person approves it **once**, at the contract freeze (not a sign-off at each step); and **Verify is auto-gated on evidence** under `autonomy: auto` (the default), escalating security — always a `HARD-STOP` — and other residue to a person. Lower the autonomy level to `conservative` to keep a human at the Verify gate. See [11 Governance](./11-governance.md). + +## Why the order is the order + +Each step produces exactly one artifact, and each artifact is the input to the next step. The order is not a preference; it is a dependency chain. + +| Step | Produces | Which is needed by | +|------|----------|--------------------| +| 1 Specify | the rules | scenarios, and everything after | +| 2 Scenarios | pass/fail cases | the tests | +| 3 Contract | the fixed shape | the tests and the build | +| 4 Tests | the failing-first suite | the build and the verification | +| 5 Build | the code | the verification | +| 6 Verify | a trusted, releasable change | the release and the next loop | + +The single rule of discipline follows directly: **do not begin a step until the previous artifact exists.** Skipping forward means the AI builds against a guess. + +The flow runs in two directions under two rules that never conflict. **Backward correction is always allowed:** any phase may send you back to an earlier one to repair its artifact — a failing Build that exposes a missing rule sends you back to Specify, and that is the loop working ([principle 4](./01-principles.md)), not a failure. **Forward-skipping is forbidden:** you never start a phase before its input artifact exists. Correct backward freely; never skip forward. + +**`done` is terminal — except via the recorded reopen.** Backward correction moves a *live* task; a task at `done` has already passed its gate. The one way back from `done` is the recorded `reopen` action (`add.py reopen --to --reason "..."`): it returns the task to an earlier phase, resets the gate, and writes down *why* — so a done verdict is never quietly un-done. This is the same backward-correction rule, made explicit at the one state where it would otherwise be bypassed silently. + +## Who does what + +| Step | Person's job | AI's job | +|------|--------------|----------| +| 1 Specify | confirm the rules (part of the one approval) | draft; list assumptions to confirm | +| 2 Scenarios | confirm what "correct" looks like (part of the one approval) | draft scenarios | +| 3 Contract | **approve & freeze the whole bundle (§1–§4) once — the decision point** | draft the contract and mocks | +| 4 Tests | confirm the targets (part of the one approval) | draft the failing tests | +| 5 Build | direct in small batches | implement until tests pass | +| 6 Verify | own the residue (security · concurrency · architecture); approve when `conservative` | gather evidence; **auto-PASS on complete evidence** under `autonomy: auto` | +| 7 Observe | read the signal; consolidate confirmed deltas into PROJECT.md | run behind a flag; emit lessons learned | + +**What the human sees when it is their turn — the decision arc.** Whenever the flow stops for the human — the baseline approval that ends setup, the contract-freeze decision point and an escalated verify gate within each task, and the wider decision points of the loop (intake · scope · milestone close · stage graduation) — the AI opens its report with the **decision arc**: three engine-sourced lines — `goal:` the milestone goal the work serves · `done:` the proven progress toward it · `plan:` what comes next. The arc renders first, above the report's summary, so the human confirms with sight of the whole trajectory rather than a local snapshot. It is presentation only — it never adds a gate or changes an outcome. See [Appendix C](./appendix-c-glossary.md). + +## What survives, and what is disposable + +This is the idea that most distinguishes AIDD from older practice. + +**The artifacts are the durable asset.** The specification, the scenarios, the contract, and the tests capture decisions and meaning. They are what you protect, version, and carry forward. + +**The code is disposable.** It is one implementation that satisfies the artifacts. If a better approach appears, or the AI model improves, the code can be regenerated against the same artifacts without loss. + +A practical test of whether a team has absorbed this: ask what they would be upset to lose. If the answer is "the code," they are still working the old way. If the answer is "the contracts and the tests," they are working in AIDD. + +> **Do:** invest in clear, stable specs, contracts, and tests. +> **Don't:** measure progress by how much code was generated or reused — that counts the cheap, disposable thing. + +## How the rest of Part II is organized + +Each of the next seven chapters takes one step (and then the loop) and gives it the same treatment: its purpose, who does it, the artifact it produces, the AI prompt that drives it, the exit check that says it is done, and what to do when that check fails. The running example continues throughout. diff --git a/.add/docs/03-step-1-specify.md b/.add/docs/03-step-1-specify.md new file mode 100644 index 000000000..ed9b2de42 --- /dev/null +++ b/.add/docs/03-step-1-specify.md @@ -0,0 +1,117 @@ +# 03 · Step 1 — Specify + +[← 02 The flow](./02-the-flow.md) · [Contents](./README.md) · Next: [04 Step 2 Scenarios →](./04-step-2-scenarios.md) + +> **Purpose:** state, in plain language, what the feature must do and what it must reject, with no ambiguity left for the AI to resolve by guessing. +> **Produces:** `SPEC.md` for the feature. +> **How it works — co-specification:** AI and human **brainstorm the shape together**; the AI drafts; the **human validates, with the AI's advice.** The decisive advice is a *lowest-confidence flag* — the AI names the one or two things most likely to be wrong, so the human's attention lands where it matters. The human owns the decision; the AI owns surfacing what it does not yet know. + +--- + +## Why this step is first + +The specification is the description the AI will build from. Every other artifact descends from it. Anything vague here does not stay vague — it becomes a concrete wrong guess in the code, discovered late. The cheapest moment to remove an ambiguity is now, in a sentence, before anything depends on it. + +There is also a diagnostic value: **if you cannot write the spec, you do not yet understand the feature well enough to build it.** The inability to specify is information, not an obstacle to push past. + +## Co-specification — how the spec gets made + +A specification is not dictated by one side. It is made in three moves: + +1. **Diverge — brainstorm by both.** Before drafting, the AI surfaces the *decision space*: the two or three genuine ways to frame the feature, and the open questions it would otherwise resolve by guessing. You react — add, kill, redirect. This is the brainstorm, and it lives in the conversation, not in a new document. +2. **Converge — the AI drafts, and ranks its own uncertainty.** The AI writes the spec below, then ranks where its confidence is lowest. It does not hand you a flat list of equal-looking assumptions to nod through; it tells you *where it is most likely wrong, and what that would cost.* +3. **Validate — you decide, with the AI's advice.** You read the ranked uncertainty first, then confirm, correct, or send it back. Your approval is real because your attention was aimed. + +The brainstorm leaves a *light trace, not a document.* What you chose becomes a rule; what you weighed and dropped becomes a one-line **`Framings weighed:`** note; what stayed genuinely uncertain becomes a **lowest-confidence flag**. Nothing new to maintain — the residue lands in the spec you were writing anyway. + +## What a good specification contains + +Four parts, kept short: + +1. **Must** — the behaviors the feature is required to perform. +2. **Reject** — the inputs or situations it must refuse, each paired with a named error. +3. **After** — the state that is true once it succeeds (what changed). +4. **Assumptions — lowest-confidence first** — the things you are taking for granted, **ranked so the most-likely-wrong come first.** The top one or two carry a `⚠` flag with *why it is uncertain* and *what it costs if wrong*; the rest are the low-stakes tail. A spec with genuinely nothing uncertain still names its single biggest risk, however small — the AI never claims a blank mind. + +Naming the errors matters. "Reject bad amounts" is an instruction to guess; `amount <= 0 -> "amount_invalid"` is a rule that produces a testable scenario and a defined contract response. + +## Template + +``` +# SPEC.md +Feature: +Framings weighed: (chosen) · · +Must: + - +Reject: + - -> "" +After: + - +Assumptions — lowest-confidence first: + ⚠ — lowest confidence because ; if wrong: + - [x] — +``` + +## ▶ Example + +``` +Feature: Transfer money between my own accounts +Framings weighed: synchronous single-currency transfer (chosen) · queued transfer · multi-currency with FX +Must: + - move an amount from one of my accounts to another of mine + - amount > 0 + - source and destination are different accounts + - source has enough balance +After: + - source balance -= amount, destination balance += amount +Reject: + - amount <= 0 -> "amount_invalid" + - source == destination -> "same_account" + - balance < amount -> "insufficient_funds" + - account not mine -> "forbidden" +Assumptions — lowest-confidence first: + ⚠ same currency only (no FX) in v1 — lowest confidence because the ticket never said; if wrong: the whole amount/rounding model changes and this contract is wrong + - [x] no daily limit in v1 — confirmed: out of scope for v1 +``` + +The `Framings weighed:` line shows what was considered and dropped, so the chosen shape is a *decision*, not a default. The `⚠` line is the one the stakeholder reads first: the assumption most likely to be wrong and most expensive to get wrong. The flat `[x]` line is real but low-stakes. A reviewer can now spend their attention where it pays. + +## The AI's role here + +Use the AI to **open the space and then narrow it honestly.** First it brainstorms the genuine framings with you (diverge). Then it drafts the spec from whatever raw material you have — a ticket, an interview, a contract document — listing every assumption it had to make, **ranked lowest-confidence first**, and flagging the one or two it is least confident in with *why* and *what it costs if wrong*. Its instinct is to fill gaps silently and present a confident wall; the method forces those gaps into the open, and forces the confident wall to declare its own soft spots. See `playbook/1_specify.md` in [Appendix B](./appendix-b-prompts.md). + +The defining instruction: *if a requirement is unclear, ask — do not resolve it by guessing — and of the things you must assume, say plainly where your confidence is lowest.* + +## Common mistakes + +- **Stating only the happy path.** The "Reject" list is where most real complexity lives; an empty one usually means it has not been thought through. +- **Free-text errors.** Errors must be named codes, not sentences, so they can become scenarios and contract responses. +- **Hidden assumptions.** If an assumption is not written down, it is not confirmed — it is a future bug with a delay timer. +- **A flat list of "confirmed" assumptions.** Eight equal-looking ticks invite a reflex approval. Rank them; flag the one or two that are load-bearing. An unranked list hides the risk inside the noise. + +## Exit check + +A spec is done when: + +- [ ] Every required behavior is stated explicitly. +- [ ] Every rejection has a named error code. +- [ ] The success state-change is described. +- [ ] The assumptions are ordered lowest-confidence first, and the one or two `⚠` flags carry *why* + *cost* — or, for genuinely trivial scope, an honest "none material" that still names the single biggest risk. + +The shift from older practice: you no longer pre-confirm every assumption to advance. You confirm that the AI has *ranked* its uncertainty and that you have *engaged the top of the rank.* Stated honestly: the flag makes a genuine review cheap and a lazy one visibly negligent — it cannot force the read. That is the most a lightweight check can buy. + +## If the check fails + +If you cannot state a rule clearly, the feature is not ready to build. Stop, take the question to whoever owns the requirement, and resolve it. Do not let the AI proceed on an unresolved point — that is the exact failure the whole method exists to prevent. + +--- + +## The one approval, and where the flag really lands + +In the one-approval flow, you do not approve the spec alone — you approve the whole frozen bundle (spec, scenarios, contract, tests) once, at the contract freeze. So the lowest-confidence flag is **bundle-wide**: at that single decision point the AI leads with *"of everything I'm asking you to freeze, these one or two points are most likely wrong"* — and a flag may point at an uncovered scenario or the contract shape, not only a spec assumption. The ranking you do here in Specify is the first input into that one gate. See [05 Contract](./05-step-3-contract.md) and the `add` skill's `run.md`. + +--- + +## When the feature has a user interface + +For anything with a UI, extend this step with a quick design: the **user flows** (the happy path and the main alternatives) and **every screen state** — loading, empty, error, and success. Correct logic behind a confusing or incomplete interface is still a poor product, and undesigned states are exactly where an AI will improvise something ugly. In the early **Prototype** stage, this design work is the main event and the code is throwaway (see [10 Stages](./10-setup-and-stages.md)). diff --git a/.add/docs/04-step-2-scenarios.md b/.add/docs/04-step-2-scenarios.md new file mode 100644 index 000000000..6e7c08a62 --- /dev/null +++ b/.add/docs/04-step-2-scenarios.md @@ -0,0 +1,80 @@ +# 04 · Step 2 — Scenarios + +[← 03 Step 1 Specify](./03-step-1-specify.md) · [Contents](./README.md) · Next: [05 Step 3 Contract →](./05-step-3-contract.md) + +> **Purpose:** rewrite each rule from the spec as a concrete, pass-or-fail scenario. +> **Produces:** `features/.feature`. +> **Person's job:** decide what "correct" looks like in concrete situations. **AI's job:** draft the scenarios. + +> **Part of the specification bundle (v7).** In the default flow these scenarios are drafted by the AI alongside the spec, contract, and failing tests as **one bundle**, approved by a person **once** (the one approval), at the contract freeze — not signed off step by step. This chapter is how to get the scenarios *right*; [05 Contract](./05-step-3-contract.md) is where the bundle is frozen. See [11 Governance](./11-governance.md). + +--- + +## Why turn rules into scenarios + +A plain rule is still open to interpretation. "Source must have enough balance" leaves open: enough for what, exactly? What happens to the balances when it is *not* enough? A scenario removes the interpretation by pinning a specific situation to a specific expected result. + +Scenarios occupy a unique position: they are **readable by people and checkable by machines at the same time.** A product owner can confirm a scenario is what they meant; a test can be generated directly from it. This makes them the bridge between the human-led half of the flow and the machine-led back. They are the single most leverage-bearing artifact in the method, because everything downstream — the tests, and through them the build's definition of success — is generated from them. + +## The form + +Each scenario has three parts: + +- **Given** — the starting situation. +- **When** — the action taken. +- **Then** — the result that must follow. + +Where a rule also constrains what must *not* change, add an **And** clause to state it. Unwanted side effects are caught by what you assert stays the same, not only by what you assert changes. + +## Template + +``` +Scenario: + Given + When + Then + And # when relevant +``` + +## ▶ Example + +``` +Scenario: successful transfer + Given A has 100 and B has 0, both mine + When I transfer 30 from A to B + Then A has 70 and B has 30 + +Scenario: insufficient funds + Given A has 20, mine + When I transfer 50 from A to B + Then it is rejected "insufficient_funds" + And no balance changes + +Scenario: not my account + Given account C is not mine + When I transfer 10 from C to B + Then it is rejected "forbidden" +``` + +The `And no balance changes` line is doing real work: it specifies that a rejected transfer must leave the world untouched — a property the AI could easily violate by deducting before checking. + +## The AI's role here + +Hand the AI the spec and have it draft a scenario for each rule, including the rejection rules. Then read them as the person who owns the requirement: do they describe what you actually meant? Correct any that drift. See `playbook/2_scenarios.md` in [Appendix B](./appendix-b-prompts.md). + +## Common mistakes + +- **Only happy-path scenarios.** Every "Reject" rule in the spec needs its own scenario, or that rule will never be verified. +- **Vague results.** "Then it works" is not checkable. The result must be a specific, observable fact ("A has 70"). +- **Forgetting the unchanged state.** For any rejection, assert that nothing changed; otherwise a partial, corrupting failure can pass. + +## Exit check + +- [ ] Every "Must" rule has at least one scenario. +- [ ] Every "Reject" rule has at least one scenario. +- [ ] Each scenario's result is a specific, observable fact. +- [ ] Rejections assert what must stay unchanged. + +## If the check fails + +A rule with no scenario will never be tested, and therefore will never be verified — it is a rule in name only. Either write the missing scenario or remove the rule from the spec. Do not carry an unscenarioed rule into the contract. diff --git a/.add/docs/05-step-3-contract.md b/.add/docs/05-step-3-contract.md new file mode 100644 index 000000000..f81bafb4c --- /dev/null +++ b/.add/docs/05-step-3-contract.md @@ -0,0 +1,80 @@ +# 05 · Step 3 — Contract + +[← 04 Step 2 Scenarios](./04-step-2-scenarios.md) · [Contents](./README.md) · Next: [06 Step 4 Tests →](./06-step-4-tests.md) + +> **Purpose:** fix the external shape of the feature — interfaces, data structures, names, and error cases — and freeze it. +> **Produces:** `contracts/.md` (plus a mock and contract tests). +> **Person's job:** approve and freeze the shape. **AI's job:** generate the first draft, the mock, and the contract tests. + +> **The one approval lands here (v7).** In the default flow the AI drafts spec, scenarios, this contract, and the failing tests as **one specification bundle**, and a person gives a **single approval at this freeze**. Freezing the contract is the one human gate of the bundle, not the third of three sign-offs; reject any part and the whole bundle returns to draft (backward correction, not failure). See [11 Governance](./11-governance.md). + +--- + +## The decision point of the whole method + +This step is the decision point between the human-led and machine-led halves of the flow, and it is what makes everything after it safe. + +The reasoning is simple. The AI is allowed to write and rewrite code quickly. That is only safe if there is a stable surface that the rest of the system depends on and that the AI is not allowed to disturb. The frozen contract is that surface. Below it, the code is disposable and can be regenerated freely; above it, nothing breaks, because the shape it depends on does not move. + +Freezing the contract is therefore not bureaucracy — it is the precondition for granting the AI real autonomy in the build step. Without it, every regeneration risks silently changing an interface that another part of the system relies on. + +## What the contract contains + +- **Interfaces** — the endpoints, functions, or messages, with their inputs and outputs. +- **Data structures** — the request and response shapes, and the persistent schema. +- **Names** — drawn from the project glossary, so the same concept has the same name everywhere. +- **Error cases** — the defined failures, using the error codes from the spec. + +## Template + +``` +# contracts/.md + body: { } + 200 -> { } + 4xx -> { error: "" | "" } +Schema: +Status: FROZEN @ v +``` + +## ▶ Example + +``` +POST /transfers body: { fromAccountId, toAccountId, amount } + 200 -> { transferId, fromBalance, toBalance } + 400 -> { error: "amount_invalid" | "same_account" | "insufficient_funds" } + 403 -> { error: "forbidden" } +Schema: accounts.balance (read + write, must be transactional) +Status: FROZEN @ v1 +``` + +Every error code traces back to a rejection rule in the spec, and the schema note (`must be transactional`) flags the one place where correctness depends on more than shape — a hint the verification step will follow up. + +## The AI's role here + +The AI generates the contract from the spec and design, and additionally produces two things that make the contract enforceable: a **mock server** that returns the contracted shapes, and **contract tests** that pin those shapes. With the mock in place, work that depends on this feature can proceed before the real code exists. See `playbook/3_contract.md` in [Appendix B](./appendix-b-prompts.md). + +## The change-request rule + +Once frozen, a contract does not change casually. A needed change is a **change request**: you return to [Step 1](./03-step-1-specify.md), adjust the spec, re-freeze at a new version, and come forward again. The AI never alters a frozen contract on its own initiative. + +This rule is what keeps the contract trustworthy as a foundation. If it could drift, nothing built on it would be safe. + +> **Do:** version and freeze the contract before any implementation. +> **Don't:** let the build step quietly change an interface to make code easier — that breaks everything depending on it. + +## Common mistakes + +- **Inconsistent names.** If the contract calls it `fromAccountId` and the schema calls it `src_acct`, the AI will produce subtle mismatches. Use the glossary everywhere. +- **Undefined errors.** Every failure the spec rejects must have a contracted response, or callers cannot handle it. +- **Freezing too early or too late.** Freeze once the spec and design are stable — not before they are agreed, and not after code has already been written against an unfrozen shape. + +## Exit check + +- [ ] Contract is versioned and marked `FROZEN`. +- [ ] Contract tests pass against the mock. +- [ ] Every name matches the project glossary. +- [ ] Every spec rejection has a contracted error response. + +## If the check fails + +If the contract is not yet stable enough to freeze, the upstream artifacts are not settled — return to the spec or scenarios and resolve what is still open. If a frozen contract later needs to change, treat it as a change request rather than an edit; the discipline is the point. diff --git a/.add/docs/06-step-4-tests.md b/.add/docs/06-step-4-tests.md new file mode 100644 index 000000000..a53ef9ab0 --- /dev/null +++ b/.add/docs/06-step-4-tests.md @@ -0,0 +1,73 @@ +# 06 · Step 4 — Tests + +[← 05 Step 3 Contract](./05-step-3-contract.md) · [Contents](./README.md) · Next: [07 Step 5 Build →](./07-step-5-build.md) + +> **Purpose:** turn the scenarios and contract into automated tests, and confirm they fail before any code exists. +> **Produces:** a failing (red) automated test suite. +> **Person's job:** set the targets and coverage. **AI's job:** generate the tests. + +> **Part of the specification bundle (v7).** In the default flow these tests are drafted by the AI as part of the specification **bundle** (spec · scenarios · contract · tests) and approved by a person **once**, at the contract freeze — the tests are part of what that one approval covers. They still must be **red before the build**. See [11 Governance](./11-governance.md). + +--- + +## Why tests come before code + +This is the step that operationalizes the second principle — *trust through evidence, not inspection.* The tests written here are how you will judge the AI's code in [Step 5](./07-step-5-build.md). For that judgment to be honest, the tests must exist *before* the code. + +The reason is mechanical. If code is written first and tests after, the tests are unconsciously shaped to match whatever the code happens to do — including its mistakes. Tests written first, from the scenarios, are shaped only by the agreed definition of correct. They are an independent standard the code must rise to meet, not a description of what the code already does. + +## The must-fail principle + +After generating the tests, you run them — and they must **fail**, because no implementation exists yet. This sounds trivial and is not. A test that passes before any code is written is testing nothing; it is a false reassurance that will later wave bad code through. Confirming the suite is "red for the right reason" (a missing implementation, not a broken test) is what makes it genuinely protective. + +## What to test + +- **One test per scenario** — every scenario from [Step 2](./04-step-2-scenarios.md) becomes an executable test. +- **Contract conformance** — tests that pin the shapes and error responses from [Step 3](./05-step-3-contract.md). +- **Edge cases from the spec** — the boundary values implied by the "Reject" rules. +- **Behavior, not internals** — tests assert what the feature does (the observable result), never how it is implemented, so the code can be regenerated freely beneath them. + +## ▶ Example + +```python +def test_successful_transfer(): + a = account(balance=100, owner=me); b = account(balance=0, owner=me) + r = transfer(a.id, b.id, 30) + assert r.status == 200 + assert a.balance == 70 and b.balance == 30 + +def test_insufficient_funds(): + a = account(balance=20, owner=me); b = account(balance=0, owner=me) + r = transfer(a.id, b.id, 50) + assert r.status == 400 and r.error == "insufficient_funds" + assert a.balance == 20 # unchanged — the side-effect assertion + +def test_not_my_account(): + c = account(balance=100, owner=someone_else); b = account(balance=0, owner=me) + r = transfer(c.id, b.id, 10) + assert r.status == 403 and r.error == "forbidden" +``` + +Run this now, with no implementation: all three fail. That is the correct, honest starting point for the build. + +## The AI's role here + +The AI generates the test suite from the scenarios and contract. Your job is to confirm two things it cannot judge for itself: that each test asserts *behavior* rather than internal detail, and that none of them pass by accident before code exists. See `playbook/4_tests.md` in [Appendix B](./appendix-b-prompts.md). + +## Common mistakes + +- **Tests that test the implementation.** Asserting on private internals couples the test to one version of the code and defeats disposability. +- **A green suite before the build.** Means the tests are not actually exercising the missing feature — fix them now. +- **Skipping the side-effect assertions.** Without `assert a.balance == 20` on the rejection path, a corrupting partial failure passes silently. +- **No coverage target.** Without a recorded target, coverage can quietly erode during the build. + +## Exit check + +- [ ] One test exists per scenario. +- [ ] The suite runs in the pipeline and is **red for the right reason**. +- [ ] Tests assert observable behavior, not internals. +- [ ] A coverage target is recorded. + +## If the check fails + +If a test passes before any implementation, it is a fake test — repair it before continuing, because it is your only independent check on the AI. If the suite is red for the wrong reason (a syntax or harness error), fix the harness first; a build cannot be judged against a broken net. diff --git a/.add/docs/07-step-5-build.md b/.add/docs/07-step-5-build.md new file mode 100644 index 000000000..32e0e4c02 --- /dev/null +++ b/.add/docs/07-step-5-build.md @@ -0,0 +1,80 @@ +# 07 · Step 5 — Build + +[← 06 Step 4 Tests](./06-step-4-tests.md) · [Contents](./README.md) · Next: [08 Step 6 Verify →](./08-step-6-verify.md) + +> **Purpose:** have the AI implement the feature so that every failing test passes. +> **Produces:** working code, plus the evidence that the tests now pass. +> **Person's job:** direct, in small batches. **AI's job:** implement. + +--- + +## The only step the AI leads + +This is the step the AI is genuinely good at, and the only one where it should be doing the heavy lifting. It works precisely because the previous four steps removed all the ambiguity: the AI is no longer guessing what to build: it has a spec, a set of scenarios, a frozen contract, and a suite of failing tests that define "done" exactly. Its task is narrow and checkable — turn the suite green. + +This is the difference between AIDD and vague-prompt coding. The same agent that produces confident nonsense from "build me a transfer feature" produces correct, bounded code from "make these specific failing tests pass without changing them." The agent did not change; the direction did. + +## The build prompt + +The instruction is explicit about constraints, because the constraints are what keep the speed safe. + +``` +Read SPEC.md, contracts/.md, and tests/_test.py. +Implement the feature so that EVERY test passes. +Constraints: + - Do NOT change any test. + - Do NOT change the contract. + - . + - Stop and ask if any requirement is unclear — do not guess. + - Use only packages listed in dependencies.allowlist. +Report which tests pass and exactly what you changed. +``` + +For the running example, the feature-specific safety rule is *"make the balance update atomic — debit and credit occur in a single transaction."* This is the one correctness property the tests alone may not force, so it is named directly to the builder. + +See `playbook/5_build.md` in [Appendix B](./appendix-b-prompts.md). + +## Work in small batches + +Direct the AI one task at a time, and keep each task small enough that its result can be reviewed in full. This is a direct application of the principle *you cannot move faster than you can verify.* A single enormous change that turns the whole suite green at once is not a triumph — it is an unreviewable blob. Small batches keep the verification step (next chapter) tractable and keep a human genuinely in the loop. + +## The iteration loop + +``` +AI writes code → pipeline runs the tests → some still fail + → AI iterates → ... → all green → hand to Verify +``` + +The loop is tight and largely autonomous within a task: the AI runs the tests, sees what fails, and adjusts. Your attention is needed at the boundaries — defining the task going in, and reviewing the result coming out — not on each internal iteration. + +## The cardinal rule: never change the test to pass + +An AI under pressure to make a suite green has an available shortcut: weaken or delete the failing test. This must be forbidden explicitly and caught reliably. A test changed to fit the code inverts the entire method — the code is now judging itself. If you find a test was altered during the build, reject the change outright and re-prompt with the constraint restated. + +The same applies to the contract: the build implements *against* the frozen contract and may not edit it. A genuine need to change either is a change request that returns to an earlier step. + +## How much autonomy + +The autonomy granted in this step should match the evidence and your review capacity (see [11 Governance](./11-governance.md)): + +- Where the area is new or risky, the AI proposes and a person reviews every change. +- Where the contract and tests are solid, the AI generates freely and a person reviews each batch. +- Only in narrow, well-tested areas, with a full evidence bundle attached, may the AI integrate its own work. + +## Common mistakes + +- **Batches too large to review.** Shrinks verification to approving without reading. +- **Letting the AI add unknown dependencies.** The allow-list check in the pipeline should block this automatically; if it does not, the supply-chain risk is real (an AI may invent a plausible package name that an attacker has registered). +- **Accepting "all tests pass" without reading the change.** Passing tests are necessary, not sufficient — the next step exists for exactly this reason. + +## Exit check + +- [ ] All tests pass. +- [ ] Test coverage did not decrease. +- [ ] No test and no contract was modified by the AI. +- [ ] No dependency outside the allow-list was added. +- [ ] The change is small enough to review in full. + +## If the check fails + +If the AI weakened a test, reject and re-prompt. If it added an out-of-allow-list package, the pipeline blocks it; have the AI find an approved alternative or raise the package for human approval. If the batch is too large to review, ask the AI to split the work and resubmit. Only once the exit check passes does the change proceed to verification. diff --git a/.add/docs/08-step-6-verify.md b/.add/docs/08-step-6-verify.md new file mode 100644 index 000000000..6f6c6bf55 --- /dev/null +++ b/.add/docs/08-step-6-verify.md @@ -0,0 +1,81 @@ +# 08 · Step 6 — Verify + +[← 07 Step 5 Build](./07-step-5-build.md) · [Contents](./README.md) · Next: [09 The loop →](./09-the-loop.md) + +> **Purpose:** confirm the result is correct and safe to release. +> **Produces:** a reviewed change with a recorded outcome, ready to release. +> **Who resolves it:** set per task by the `autonomy:` header. Under `autonomy: auto` (the default) the run resolves the gate on evidence; under `conservative`, or for any residue, it is the human's check. **Security always escalates to a human.** + +--- + +## Where trust is actually established + +The build produced passing tests. That is necessary but not sufficient. Verification is where a person establishes trust — and the principle governing it is *trust through evidence, not inspection.* + +This needs care, because it is easy to misread. "Not by inspection" does not mean "do not look at the code." It means the *basis* of trust is the passing evidence plus a deliberate check of the specific things tests cannot easily catch — not a general impression that the code reads plausibly. Plausibility is exactly the trap: AI code is frequently plausible and wrong. So verification has two parts: confirm the evidence, then check the known non-functional risks. + +## Who resolves Verify — the automated quality gate + +Verify can be resolved two ways, set per task by the `autonomy:` header (see [governance](./11-governance.md) and the autonomy level): + +- **Auto (the default).** When `autonomy: auto`, the run resolves the gate on **evidence** rather than waiting for a person — but only when *all* of these hold: every test green, coverage not decreased, no test weakened and no contract edited, the convergence loops dry, and **no residue** (security, concurrency, or architecture). It records `PASS` as *auto-resolved*, naming the run as the accountable owner — an explicit pass, not a skip. This is principle 7: a gate may be resolved by evidence when that evidence is sufficient and the result is logged. +- **Human.** When `autonomy: conservative`, or whenever the run finds residue it cannot judge, the gate stops for a person; the two parts below are theirs. + +**Security is always a `HARD-STOP` and is never auto-passed, at any autonomy level.** The two parts that follow — confirm the evidence, then check the non-functional risks — are what *either* resolver works through; the only question is whether a person or the recorded run signs the outcome. + +## Part one — confirm the evidence + +- [ ] All tests pass. +- [ ] Coverage did not decrease. +- [ ] No test or contract was altered during the build. + +If any of these is false, stop here and return to the build; there is nothing to verify yet. + +## Part two — check what tests miss + +Automated tests are excellent at behavior on defined inputs and poor at a few specific things. Check those by hand, every time: + +- **Concurrency and timing.** Is the operation correct when two of them happen at once? Tests usually run serially and miss races. + - ▶ *Example: the balance update must be one atomic transaction. Confirm that two simultaneous transfers from the same account cannot both pass the balance check and overdraw it.* This is the single most important check for this feature, and it is the reason the build prompt named atomicity explicitly. +- **Security.** Are there exposed secrets, injection openings, or unexpected dependencies? AI-generated code is known to hardcode secrets and to pull in packages by plausible-but-wrong names. +- **Architecture conformance.** Does the change respect the layering and dependency rules in `CONVENTIONS.md`? Speed with no architectural check produces a fast-growing tangle that becomes unmaintainable within months. + +## Part three — the deep check (do not skim) + +Two failures slip straight past green tests. The first is code that is never *wired in* — a new function that nothing calls, an endpoint no route reaches: the tests for it pass in isolation while the feature is, in practice, absent. The second is the opposite — code left *dead* behind a path nothing exercises, quietly rotting. And for a change that produced prose rather than code, the equivalent failure is signing off on a claim you never actually read in full. Plausibility hides all three. So verification carries one explicit requirement beyond the non-functional review: + +> Deep check — do not skim. If the task produced code, record that every new symbol is referenced (wiring) and that no new dead/unused code was introduced. If it produced prose or non-code, record a semantic read — what you read in full and what it confirmed. Which path applies is the resolver's judgement; the engine never classifies. + +This is *evidence*, not impression: a reference search showing where each new symbol is called, a scan confirming nothing new is orphaned, or — for prose — a note of exactly what was read and what it confirmed. An unfilled deep check is a **shallow verify**, not a pass. The engine cannot judge wiring, dead code, or whether prose was truly read; the resolver records the evidence, and a person (under `conservative`) or the recorded run (under `auto`) signs it. + +## Recording the outcome + +Every verification ends with exactly one recorded outcome, with an accountable owner — never a silent pass: + +| Outcome | Meaning | Allowed when | +|---------|---------|--------------| +| `PASS` | all checks met | the normal path | +| `RISK-ACCEPTED` | proceed with a signed waiver: named owner, linked ticket, expiry date | a non-security gap only | +| `HARD-STOP` | cannot proceed | any failing test or any security finding | + +A security finding is always a `HARD-STOP`; it is never waved through with a waiver. A `RISK-ACCEPTED` outcome is a deliberate, documented decision to ship a known, non-security limitation — not a way to skip the check. + +## The verification checklist + +- [ ] All tests pass (the evidence). +- [ ] Concurrency/timing of the risky operation is safe. +- [ ] No exposed secrets, injection openings, or unexpected dependencies. +- [ ] Layering and dependencies follow `CONVENTIONS.md`. +- [ ] Deep check (do not skim): for code, every new symbol is referenced (wiring) and no new dead/unused code was introduced; for prose/non-code, a semantic read is recorded. +- [ ] The change is approved — by a person, **or** (under `autonomy: auto`, no residue) auto-resolved by the run as the recorded accountable owner. +- [ ] An outcome is recorded (`PASS` / `RISK-ACCEPTED` / `HARD-STOP`). + +## Common mistakes + +- **Shipping on plausibility.** Reading the diff, finding it reasonable, and approving — without the evidence and the non-functional review — is the precise failure the method exists to prevent. +- **Treating a security gap as acceptable risk.** It is a `HARD-STOP`, not a waiver. +- **Skipping the concurrency check** because the tests are green. Tests rarely exercise simultaneity; this is a manual check by design. + +## If the check fails + +A failing test or a security finding returns the change to the build step ([Step 5](./07-step-5-build.md)). A non-security limitation may proceed only with a signed `RISK-ACCEPTED` record carrying an owner and an expiry — so the team can find and close it later. Nothing proceeds on an unrecorded decision. diff --git a/.add/docs/09-the-loop.md b/.add/docs/09-the-loop.md new file mode 100644 index 000000000..1f471cfd3 --- /dev/null +++ b/.add/docs/09-the-loop.md @@ -0,0 +1,67 @@ +# 09 · The loop — observe and learn + +[← 08 Step 6 Verify](./08-step-6-verify.md) · [Contents](./README.md) · Next: [10 Setup and stages →](./10-setup-and-stages.md) + +> **Purpose:** release the verified change, watch how it behaves in reality, and turn what you learn into the next specification. +> **Produces:** a running feature, observations, and the next `SPEC.md` delta. + +--- + +## The flow is a loop, not a line + +Older mental models end at "ship." That framing is the source of a common pathology: teams treat release as a finish line, and so they hide defects to protect the line rather than manage them in the open. In AIDD, release is not the end of the flow — it is the point where the most reliable information about the feature finally becomes available: how it behaves with real users, real data, and real load. + +That information is the input to the next cycle. What you learn in production becomes the next specification, and the flow returns to [Step 1](./03-step-1-specify.md). The cycle is continuous. + +## Release deliberately + +Release behind a mechanism that limits the scope of impact of a mistake — a feature flag, a gradual rollout, or both. The verification step established that the feature is correct against everything you anticipated; a controlled release is your protection against what you did not anticipate. If something is wrong, you want to affect a few users and roll back, not affect everyone and scramble. + +## Reuse the scenarios as monitors + +The scenarios from [Step 2](./04-step-2-scenarios.md) have a second life here. They described the behavior you expected; in production they become the behavior you monitor. The same definition of "correct" that drove the tests now drives the alerts. + +**What to watch (▶ example):** + +- the overall transfer error rate; +- the rate of each individual rejection (`amount_invalid`, `same_account`, `insufficient_funds`, `forbidden`) — a sudden spike in one is a signal, not noise; +- latency, especially of the atomic balance update under load. + +## Turn observation into the next spec + +Every defect, surprise, or new need is written up as a change to the specification — a delta that re-enters the flow at [Step 1](./03-step-1-specify.md). An error rate that is too high, a rejection that fires more than expected, a user behavior nobody designed for: each becomes a concrete, specified next step rather than a vague intention. + +This is also where the AI returns to a useful role: summarizing telemetry, clustering errors into themes, and drafting the proposed spec delta for a person to review. But the production decisions — what to roll back, what to prioritize — remain human. + +## Lessons learned and the retrospective consolidation + +A spec delta feeds the *next feature*. But a loop also teaches the **method itself** — that the domain model missed a boundary, that a whole class of scenario was never tested, that a build convention helped or hurt. AIDD captures those as **lessons learned**: a single tagged learning, written in the Observe step, marking which of the five competencies it sharpens. + +| tag | competency | a delta here means you learned something about… | +|-----|------------|--------------------------------------------------| +| `DDD` | Domain | the domain model — an entity, rule, or boundary the spec assumed wrong | +| `SDD` | Spec | what the feature must do or reject — a missing or wrong requirement | +| `UDD` | UI/UX | the user-facing shape — a flow, affordance, or wording that misled | +| `TDD` | Test | how we prove correctness — a missing scenario, a flaky or hollow test | +| `ADD` | AI/build | how the AI builds — a harness, prompt, or convention that helped or hurt | + +Each delta is one tagged entry — `- [COMPETENCY · status] the learning (evidence: a pointer)` — and the evidence is **required**: a failing scenario, a production signal, a review note. No evidence means it is an opinion, not a delta. The AI **emits** deltas as `open`; it never consolidates its own. Consolidation is judgment, and judgment is the human's — the same verify/observe decision point that keeps the AI from grading its own work. + +**The consolidation.** At milestone close (or on demand, when open deltas pile up), a person runs the retrospective consolidation: **gather** every `open` delta across the milestone's tasks, **group** them by competency, **propose** the exact foundation edit for each, **confirm** with the human one by one, then **write** — append-only — flipping each delta to `folded` (merged) or `rejected` (considered and deliberately not merged, left in place so the trail survives), and bumping the `foundation-version:` marker. `DDD`/`SDD`/`UDD` deltas consolidate into the matching section of `PROJECT.md`; `TDD`/`ADD` consolidate into `CONVENTIONS.md` (they sharpen the engine, not the product); and **every** consolidation also appends one row to `PROJECT.md` §Key Decisions — the universal, auditable record of what the foundation learned. + +**Tooling.** `add.py deltas` lists every open delta across the project (so nothing waiting to be consolidated is invisible); `add.py check` lints each delta's well-formedness — known competency tag, valid status, non-empty evidence. There is deliberately **no `add.py fold`**: the engine stays judgment-free, and the ritual lives with the human who owns it. + +## Re-entrancy: the loop is the whole point + +Two principles converge here. *The flow is re-entrant* — any step can send you back to an earlier one — and *the flow is a loop* — production feeds the next specification. Together they mean the artifacts you built are never "finished"; they are living documents that the next cycle refines. + +A team operating this way does not experience requirements changing as a failure of planning. It experiences it as the system working: reality is teaching the specification, and the specification is teaching the next build. + +## The milestone holds until its goal is met + +A single feature loops through Observe back to Specify; a **milestone** has the same shape at a larger scale, and a gate to match. A milestone is not finished when its tasks are done — it is finished when its **goal** is met, expressed as the exit criteria in `MILESTONE.md`. So `add.py milestone-done` is **goal-gated**: it refuses to close a milestone while any exit criterion is still unchecked, and **holds until** every box is checked. Those checkboxes are the human's affirmation that the goal is genuinely met — the engine reads the tally, it never judges the goal itself. (A milestone with no exit criteria closes as before; `milestone-done` is the only path to `done`, and archiving refuses anything not yet done — so the one gate cannot be slipped.) + +While the milestone is held open, the work each task leaves behind — open lessons, and items discovered but out of scope — becomes its next tasks: the AI proposes them, the human confirms, and the loop continues until the goal is reached. The milestone is the loop made concrete; the exit criteria are its finish line. + +> **Do:** release small, watch the scenarios, and feed every learning back into the spec. +> **Don't:** treat shipping as the end. The most valuable information about a feature arrives *after* it ships. diff --git a/.add/docs/10-setup-and-stages.md b/.add/docs/10-setup-and-stages.md new file mode 100644 index 000000000..4d55861d1 --- /dev/null +++ b/.add/docs/10-setup-and-stages.md @@ -0,0 +1,118 @@ +# 10 · Project setup and stages + +[← 09 The loop](./09-the-loop.md) · [Contents](./README.md) · Next: [11 Governance →](./11-governance.md) + +This chapter covers two operational matters: what you set up once per project, and how the same flow runs at different depths as a product matures. + +--- + +## Setup: the AI drafts, you approve the baseline + +Before the first feature, the project needs a foundation — but standing it up is no longer your chore. Point ADD at the repo and **the AI does the drafting**: it runs `init` itself, reads what is there, and fills the foundation the whole project depends on. Your single act is the **baseline approval** — the one human gate that freezes it. + +**What the AI drafts.** From an existing codebase it works **silently** — the code answers the questions a setup interview would ask. On an empty repo it runs a short **four-lens interview** (domain · spec · users · decisions), then drafts. Either way it fills the living documentation — the files that outlive all code — and drafts the first milestone's scope and the first task's candidate contract: + +| Item | File | Purpose | +|------|------|---------| +| Foundation | `PROJECT.md` | domain · active spec · UI/UX · key decisions — the context every task reads first | +| Conventions | `CONVENTIONS.md` | naming, layout, language, formatter — living documentation | +| Model record | `MODEL_REGISTRY.md` | which AI model and version the project uses, for reproducibility and audit | +| Dependency allow-list | `dependencies.allowlist` | the packages the AI may use; the pipeline rejects others | +| Prompt playbook | `playbook/` | the six prompts from [Appendix B](./appendix-b-prompts.md) | +| Repository + pipeline | — | runs the gates on every change | + +Every drafted decision is tagged **evidence-grounded** (read from the code) or **guessed** (thin or inferred) and listed lowest-confidence-first in a `SETUP-REVIEW.md`, so the one signature you give is informed rather than given without reading. + +**The baseline approval.** The AI presents `SETUP-REVIEW.md`; you check the `guessed` rows; you **lock** — once. That single act freezes the foundation, the first scope, and the first contract together. It is the setup-level analog of the [contract freeze](./05-step-3-contract.md), and it doubles as the first task's contract approval — so there is no separate sign-off. Before the lock the engine lets the AI draft but refuses to cross into build; after it, the build opens. + +**Setup exit check** + +- [ ] Foundation + living docs drafted (brownfield: from the code, evidence-tagged; greenfield: from the interview, gaps flagged `guessed`). +- [ ] `SETUP-REVIEW.md` lists every drafted decision lowest-confidence-first. +- [ ] The model is pinned; the allow-list exists and the pipeline fails on any package outside it. +- [ ] The pipeline runs and is green on the empty skeleton. +- [ ] The human **locked down** — and only then did the first feature's build open. + +Do not start a feature until the pipeline is green and the foundation is locked. The baseline approval turns the AI's draft into committed direction; the pipeline enforces every later exit check without anyone having to remember to. + +--- + +## Stages: the same flow at increasing depth + +A *stage* is one pass through the flow at a chosen depth. The steps never change between stages; what changes is how deeply you run each one. The instinct to skip steps for an early prototype is right in spirit but wrong in form — you do not skip steps, you run them lightly. + +### The depth matrix + +Depth: **Deep** (full rigor) · **Core** (real but scoped) · **Light** (just enough) · **—** (skipped or stubbed). + +| Step | Prototype | Proof of Concept | MVP | Production-Ready | +|------|:---------:|:----------------:|:---:|:----------------:| +| 1 Specify | Light | Deep (risky slice) | Deep | Deep | +| (design, if UI) | **Deep** | Light | Core | Deep | +| 2 Scenarios | Light | Core | Deep | Deep | +| 3 Contract | — | Core | Deep | Deep | +| 4 Tests | — | Core | Core | Deep | +| 5 Build | Light (throwaway) | Core | Core | Deep | +| 6 Verify | Light | Core | Core | Deep | +| Loop / operate | — | — | Light | Deep | +| **Typical time\*** | ~2–5 days | ~1–3 weeks | ~4–8 weeks | ~4–8+ weeks | +| **Code is** | disposable | disposable | kept | hardened | + +\* *Ranges assume a small team on a single product slice. Scale by scope and by the number of parallel streams. The pace is set by judgment and review capacity, not by how fast the AI can type — adding more AI does not compress the human-led steps.* + +### Stage by stage + +**Prototype — prove the experience.** Run the design deeply and everything else lightly; the code is throwaway. The achievement is that a stakeholder reacts to something tangible and a go/no-go on the concept becomes possible. Do not expect real data, tests, or anything that survives. + +**Proof of Concept — retire the biggest technical risk.** Run the contract, tests, and build *deeply but only on the single riskiest slice*. The achievement is evidence that the hardest unknown is solvable, which turns an MVP estimate from hopeful into credible. Do not expect breadth or polish. + +**MVP — deliver value to real users.** Run the full flow at a narrow scope — the first complete loop, including light observation. The achievement is real users getting value while you learn from them. Do not expect scale or full operational rigor. + +**Production-Ready — run safely at scale.** Run every step at full rigor and deepen the operate-and-learn loop: service objectives, incident response, tested rollback, gradual delivery. The achievement is a system that is tested, secure, observable, and supportable. Do not expect "zero defects"; expect managed risk with a working feedback loop. + +### What carries forward + +The durable thing is never the code: + +| Transition | Discard | Keep | +|------------|---------|------| +| Prototype → POC | the prototype code | the validated experience (design, flows) | +| POC → MVP | the spike code | the validated approach + the risky-interface contract | +| MVP → Production | nothing | everything; the code is real and is hardened | + +The living documentation thickens as you move right: a prototype leaves you a validated design; a proof of concept adds a proven approach and a contract; the MVP adds real, kept code. By production, you are hardening, not rebuilding. + +### Graduating between stages + +Moving up a stage — most consequentially MVP → Production — is its own scope level, the fourth after setup, intake, and the milestone loop. It is *not* a label someone types: a project earns production through a human-confirmed roadmap of the hardening work, never through a bare flip. The `add` skill drives this in `graduate.md`; the shape is five steps. + +**The cue.** When every milestone is `done` *and* the human's **stage-goal-criteria** in `PROJECT.md` are all `[x]`, `add.py status` prints `→ MVP covered → propose graduation`. Until both tallies complete, nothing here applies — a project with no stage-goal-criteria block behaves exactly as before. + +1. **Gather the analytics.** `add.py graduation-report` clusters the whole MVP loop's evidence into five labeled record-sets — open deltas by competency, open RISK-ACCEPTED waivers by expiry, RETRO records, verify residue, and observe-loop coverage gaps. It *gathers, never judges*: there is no readiness verdict, only the records you reason from. +2. **Interview.** Synthesize *what production means here* with the human, using those records as the agenda. This synthesis is the judgment the engine refuses to make. +3. **Draft the roadmap.** For each production outcome the interview surfaces, draft a production milestone with the existing command — `add.py new-milestone --stage production --goal "…"` — and write its exit criteria. The roadmap is **≥1** milestone; the hardening work itself is what those milestones contain. +4. **Human confirms.** The human accepts, edits, or declines each draft. Nothing is created on an unconfirmed draft. +5. **Flip — the final step.** Only now run `add.py stage production`. + +**The floor the engine enforces.** `add.py stage production` is guarded: it refuses with `stage_no_roadmap` (non-zero exit, state byte-unchanged) when no milestone has `stage: production`. The check is a *tally* — does a production-roadmap record exist? — never a readiness judgment, mirroring the milestone goal-gate. `--force` overrides it for grandfathered or edge cases; use it deliberately, not as the normal path. The guard is on the `→production` transition only; flips to prototype/poc/mvp are unchanged. The engine never advances the stage on its own — it gathers, counts, and holds the floor while the human judges and confirms. + +--- + +## Parallel streams (opt-in) + +The default is one task at a time. But when a milestone holds several tasks whose dependencies are already `PASS` and a reviewer is ready, you may run them **concurrently** — one worker per ready task, each building behind its own frozen contract. + +**Be honest about the gain.** With one human reviewer you cannot beat `review_time × N_tasks`; the human-led decision points are serial. So the win is **not throughput** — it is that the reviewer is *never blocked waiting on a build*. While a person reviews task A's specification bundle, the builds for B, C, and D run behind *their* frozen contracts. You hide build latency under human latency; do not promise more. + +**Two queues, no new state** — both read from `add.py status`: + +- **READY-QUEUE** — tasks in the active milestone where the phase is not `done` and every dependency already reads `gate=PASS`. These are the only tasks a worker may pick up; a task finishing `PASS` unblocks its dependents on the next `status`. +- **REVIEW-QUEUE** — the irreducibly serial part: the **bundle approval** (contract freeze) and any **Verify escalation**. One human, one queue, presented one at a time — never a batch that invites approval without reading. + +**The autonomy level is the throttle.** At `conservative`, both gates queue on the human (pure pipelining — builds overlap, nothing auto-resolves). At `auto` (the default), only the bundle-approval decision point and residue escalations queue; Verify auto-PASSes on evidence, so real concurrency follows. The floor never drops below **one human approval per task, at the contract decision point**. + +**Design for failure (required).** Lease each task to its worker with a timeout — if a worker dies, release the claim back to READY rather than trusting partial work. A worker that hits a stop-and-escalate blocks only its own task; siblings keep running. And if several workers fail in one wave, trip a circuit-breaker and fall back to sequential — repeated failure means the scope was wrong, not the parallelism. + +**The hard boundary.** The orchestrator owns every shared write — `state.json`, `MILESTONE.md`, and each `add.py advance`/`gate` call (always with the explicit task slug). A worker owns only its own task directory and is isolated in a git worktree, so concurrent builds cannot collide. Merge is **serial**: bring worktrees back one at a time and run an **integration Verify** for the concurrency and architecture conflicts that two-green-in-isolation tasks can still produce — automation never auto-passes that step. + +The full, agent-agnostic worker contract (the prompt a worker runs) and the per-runner spawn adapter live in the skill's `streams.md`; this section is the *why* and the safety frame, not the operational recipe. diff --git a/.add/docs/11-governance.md b/.add/docs/11-governance.md new file mode 100644 index 000000000..4cffe3e54 --- /dev/null +++ b/.add/docs/11-governance.md @@ -0,0 +1,87 @@ +# 11 · Governance + +[← 10 Setup and stages](./10-setup-and-stages.md) · [Contents](./README.md) · Next: [12 Roles →](./12-roles.md) + +Governance is what keeps the method honest when a team runs it at speed. It is the same regardless of which AI tool writes the code, because it lives in the process and the pipeline, not in the agent. + +--- + +## The autonomy ladder + +How much the AI is allowed to do is not one switch; it is a setting chosen per area, rising with evidence and with your capacity to verify. + +| Level | The AI… | A person… | Typical use | +|-------|---------|-----------|-------------| +| **Suggest** | proposes options | decides and writes | early, exploratory work | +| **Draft-and-review** | drafts artifacts | edits and approves each one | specs, scenarios, contracts | +| **Generate-behind-gate** | generates code | reviews the change; it merges only if the contract and tests pass | the normal build | +| **Auto-with-evidence** | generates and merges | samples and audits; auto-merge allowed only with a full evidence bundle attached | narrow, well-tested areas | + +The governing rule, restated from the principles: **operate only at the level your review capacity can sustain.** If the AI produces more than the team can verify, drop a level. + +The **per-scope default is auto-with-evidence behind a one-approval decision point**: the AI drafts the specification bundle, a human approves the frozen contract once, and the build auto-gates on evidence. You *lower* a scope toward draft-and-review or suggest wherever risk is high or evidence is thin — and a high-risk or method-defining scope is *always* lowered (it is never auto-run). The default sets where you start; review capacity and risk set where you stay. + +## The gate-fail protocol and the three reports + +Every checkpoint produces three short reports — **Test** (does it pass?), **Quality** (is it well-made and conformant?), and **Risk** (what could go wrong, and who owns it?) — and resolves to exactly one outcome: + +- **`PASS`** — criteria met; proceed. +- **`RISK-ACCEPTED`** — proceed with a signed waiver carrying a named owner, a linked ticket, and an expiry. Allowed for non-security gaps only. +- **`HARD-STOP`** — cannot proceed. Triggered by any failing test or any security finding; overridable only by the most senior accountable owner, and never for security. + +The rule behind the protocol is *no silent skips.* A report nobody is accountable for approving is just a document; an outcome with an owner is governance. + +### Why each step exists (institutional memory) + +When someone proposes skipping a step "to go faster," this table is the answer: + +| Step skipped | What happens | How you notice | +|--------------|--------------|----------------| +| Specify | the wrong thing gets built | shipped, but users do not use it | +| Scenarios | the feature is vague, edges missing | the AI keeps asking questions mid-build | +| Contract | interfaces drift | front, back, and AI disagree on shapes | +| Tests | AI code is uncontrollable | no way to know it is right but to test by hand | +| Verify (architecture check) | entropy explodes | the codebase is a tangle within months | +| Operate / loop | silent rot | the same incidents recur | + +## The continuous concerns + +Four concerns are not steps but threads that run through every step, starting at project setup. Pulling them forward ("shifting left") is far cheaper than bolting them on at the end. + +| Concern | Begins at | Enforced at the build gate by | +|---------|-----------|-------------------------------| +| **Security** | setup (secret scanning, dependency allow-list) | zero high-severity findings; every AI-suggested package verified to exist | +| **Testing** | the scenarios step | coverage must not decrease; no test weakened to pass | +| **Observability** | setup (logging/metric conventions) | instrumentation present; service objectives verified after release | +| **Cost** | setup (an AI-usage budget per task) | a task may not exceed its budget without escalation | + +## AI-specific governance + +A method built on AI agents needs controls older methods did not: + +- **Pin the model.** Record the model and version; re-check the prompt library before adopting an upgrade. AI output is non-deterministic, so provenance matters. +- **Test the prompts.** The reusable instructions in `playbook/` are themselves artifacts: give each golden input/output cases, and re-check them when edited. A prompt that fails its check does not ship. +- **Guard the supply chain.** No package outside the allow-list without human approval; verify each suggested package actually exists, to defeat the risk of an agent inventing a plausible name an attacker has registered. +- **Track provenance and licensing.** License-scan both generated and pulled-in code; keep a record of what the AI produced. + +## Metrics that matter — and the anti-metrics + +Measure the scarce things: + +- **Contract stability** — how rarely the frozen contracts change; high churn is genuinely expensive. +- **Validated requirement coverage** — the share of rules confirmed against real behavior. +- **Review throughput** — the team's verification capacity, which sets the safe autonomy level. +- **Delivery and reliability** — lead time, deployment frequency, change-failure rate, time to recover. + +Do **not** optimize: lines of AI code generated, code-reuse percentage, prompt counts, or velocity measured in code volume. These count the cheap, disposable thing and create incentives to keep bad code to protect a number. + +## Profiles: one method, three intensities + +| | **Express** (startup) | **Standard** (most teams) | **Regulated** (audited) | +|---|---|---|---| +| Steps | combine Specify + Scenarios into a one-page brief; light contract | full flow | full flow, all `HARD-STOP` | +| Scenarios | happy path only | happy + key alternatives | exhaustive, incl. compliance | +| Autonomy ceiling | generate-behind-gate from day one | up to auto-with-evidence | generate-behind-gate max; the AI never merges its own work | +| Gate default | `RISK-ACCEPTED` allowed | `PASS` required to advance | `HARD-STOP`; full audit trail | + +Choose the profile deliberately — a startup spike and a banking system are not the same risk — and run different products at different profiles as appropriate. The choice is owned by the delivery lead (see [12 Roles](./12-roles.md)). diff --git a/.add/docs/12-roles.md b/.add/docs/12-roles.md new file mode 100644 index 000000000..64893cf6f --- /dev/null +++ b/.add/docs/12-roles.md @@ -0,0 +1,99 @@ +# 12 · Roles and responsibilities + +[← 11 Governance](./11-governance.md) · [Contents](./README.md) · Next: [13 Adoption →](./13-adoption.md) + +Everyone on an AIDD team becomes, in part, a *verifier*; most also become *authors of the artifacts*. This chapter says what each role owns and does. Find your section; each answers the same three questions — what you do, when, and what "done" means for you. + +--- + +## Product / Domain Owner + +- **Mission:** ensure the right thing gets built. You guard the problem. +- **Leads:** Specify. **Contributes to:** Scenarios; the loop (deciding what the next cycle addresses). +- **Owns:** the problem definition, the glossary of domain terms, the prioritized backlog. +- **Done means:** the spec states real user value with no disputed terms and its assumptions ranked lowest-confidence first — the one or two most likely wrong flagged with *why* and *what they cost*; after release, you have decided what the next loop must address. +- **Apply it:** run the Specify prompt against a real ticket or interview, then read the AI's lowest-confidence flag *first* and decide the one or two load-bearing assumptions before skimming the low-stakes tail. If you cannot confirm a load-bearing rule, it is not ready to build. + +## Architect / Engineering Lead + +- **Mission:** own the load-bearing surfaces and the checks that protect them. +- **Leads:** project setup; the Contract freeze. **Accountable for:** all the durable artifacts. +- **Owns:** `CONVENTIONS.md`, the contracts, the architecture check in verification, the model record. +- **Done means:** contracts are frozen and versioned; the architecture check runs in the pipeline; autonomy levels match the team's real review capacity. +- **Apply it:** treat the contract freeze as a one-way door. When a stream wants to change a frozen contract, route it as a change request that reopens Specify — never let code quietly move the surface. + +## Software Engineer (Senior) + +- **Mission:** direct the build and hold quality at the architecture check. +- **Leads:** Build. **Contributes to:** Contract, Tests; reviews others' changes. +- **Owns:** the implementation, the architecture conformance check, the evidence bundle on each change. +- **Done means:** all tests pass without any test being weakened; coverage holds; architecture and security checks pass; a person has reviewed it. +- **Apply it:** work in small batches the review can keep up with, and never let the AI edit a test to make it pass — that is the cardinal sin of the build step. + +## Software Engineer (Junior) + +- **Mission:** learn the craft by entering at the build end and growing toward judgment. +- **Leads:** nothing yet. **Contributes to:** Build (against handed-over specs and contracts), Tests. +- **Owns:** your tasks' code and tests; raising a flag when a spec is ambiguous — which is a contribution, not a failure. +- **Done means:** your task's tests pass honestly, your change has a clear evidence bundle, and a senior has reviewed it. +- **Apply it:** start with specs and contracts given to you and make red tests green without weakening them; over time move *up* toward design and specification as your judgment matures (see [13 Adoption](./13-adoption.md)). + +## QA / Test Engineer + +- **Mission:** make "done" machine-checkable; you are the guardrail for AI-written code. +- **Leads:** Tests. **Contributes to:** Scenarios (turning rules into checkable form); the loop (production monitors). +- **Owns:** the test suite, the scenario files, the coverage target, the test report at each gate. +- **Done means:** every scenario has a test that was red before the build; the suite is honest (nothing passes by default); coverage never regresses. +- **Apply it:** co-author the scenarios so the path from rule to test loses nothing, and confirm the suite fails for the *right* reason before the build begins. + +## Product Designer (UI/UX) + +- **Mission:** ensure correct logic does not ship inside a poor experience. +- **Leads:** the design portion of Specify; the Prototype stage. **Contributes to:** Scenarios (experience-side rules). +- **Owns:** the user flows, the specification of every screen state, the design document, the clickable prototype. +- **Done means:** every screen has all its states designed; the prototype matches the scenarios; the self-critique for generic, low-effort output has passed. +- **Apply it:** in the Prototype stage you lead — make the experience tangible fast, and carry the design forward while the prototype code is discarded. + +## DevOps / SRE / Platform + +- **Mission:** make the continuous concerns real and run the operate-and-learn loop. +- **Leads:** the loop / operations. **Contributes to:** setup (pipeline, observability conventions), Build (deployment, gradual delivery). +- **Owns:** gate enforcement in the pipeline, telemetry conventions, service-objective dashboards, rollback, the cost budget. +- **Done means:** the gate outcomes are enforced mechanically in the pipeline; instrumentation is required to pass the build gate; rollback is tested; objectives are observed after release. +- **Apply it:** wire the gate-fail protocol into the pipeline so a `HARD-STOP` is automatic, not a meeting, and shift security checks to setup rather than the end. + +## Security Engineer + +- **Mission:** keep AI-written code from importing AI-shaped risk. +- **Leads:** the security thread. **Contributes to:** setup (allow-list, secret scanning), Specify (threat modeling), Build (scanning), AI governance. +- **Owns:** the dependency allow-list, the provenance and license record, the security report at each gate, the supply-chain policy. +- **Done means:** zero high-severity findings at the build gate; every AI-suggested dependency verified real and intended; generated and pulled-in code license-scanned. +- **Apply it:** assume the AI will at some point hardcode a secret and invent a package name; gate against both from setup, and keep security findings as `HARD-STOP`, never waivers. + +## Engineering Manager / Delivery Lead + +- **Mission:** match intensity to risk, and protect verification capacity. +- **Leads:** profile selection and stage planning. **Contributes to:** unblocking every step; the loop (priorities). +- **Owns:** the chosen profile, the stage roadmap, the metrics dashboard. +- **Done means:** the team operates at an autonomy level its review capacity can sustain; metrics track the scarce things, not code volume; each stage exits on its real achievement, not a date. +- **Apply it:** choose the profile deliberately, and watch review throughput as the true measure of velocity — if AI output outpaces review, slow the engine rather than rushing the review. + +--- + +## Responsibility matrix + +`A` Accountable · `R` Responsible/Lead · `C` Consulted · `I` Informed + +| Role | Setup | Specify | Scenarios | Contract | Tests | Build | Verify | Loop | +|------|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| Product / Domain | C | **R** | R | I | I | I | I | R | +| Architect / Lead | **R/A** | C | C | **R/A** | C | A | A | C | +| Engineer (Senior) | C | I | C | R | R | **R** | R | C | +| Engineer (Junior) | I | I | I | I | R | R | I | I | +| QA / Test | I | C | R | C | **R** | C | C | C | +| Designer | I | R (design) | R | C | I | I | I | I | +| DevOps / SRE | R | I | I | C | C | R | R | **R** | +| Security | R | C | I | C | C | R | R | C | +| EM / Delivery | C | C | C | C | C | C | C | C | + +> If your role is only ever `I`, you are not yet using the method — find the step where your judgment *is* the gate. diff --git a/.add/docs/13-adoption.md b/.add/docs/13-adoption.md new file mode 100644 index 000000000..762b03e8b --- /dev/null +++ b/.add/docs/13-adoption.md @@ -0,0 +1,67 @@ +# 13 · Adoption and onboarding + +[← 12 Roles](./12-roles.md) · [Contents](./README.md) · Next: [14 The foundation →](./14-foundation.md) + +How a team starts using AIDD, and how a new person becomes productive in it. + +--- + +## A 90-day rollout + +Adopt the method on one real product, not as an all-at-once mandate. + +1. **Days 1–15 — Lock the foundation.** On one pilot service, let the AI draft the foundation — conventions, glossary, dependency allow-list, model record — from the existing code (or the four-lens interview if greenfield), then **lock it down** with one signature. The prompt playbook is [Appendix B](./appendix-b-prompts.md). +2. **Days 16–45 — One feature, end to end.** Run a single feature through the whole flow at the **Express** profile. Capture friction; tune the prompts' golden cases as you go. +3. **Days 46–75 — Turn on the gates.** Wire the three reports and the gate-fail protocol into the pipeline; introduce the autonomy ladder at the generate-behind-gate level. +4. **Days 76–90 — Promote.** Move the pilot to the **Standard** profile, draft the **Regulated** variant for any compliance-bound product, and publish the prompts as a shared, versioned playbook. + +## Choosing a profile + +| Choose… | When… | +|---------|-------| +| **Express** | startup, spike, or internal tool; speed of learning dominates; small scope of impact | +| **Standard** | a normal product with real users and ordinary risk | +| **Regulated** | finance, health, or anything audited; failure is expensive or legally consequential | + +The choice is deliberate and owned by the delivery lead; different products can run at different profiles. + +## Onboarding: enter from the build end + +The most common onboarding mistake is to start newcomers at the most abstract step. Specification and domain discovery require judgment a newcomer has not yet built. So bring people in from the *concrete* end and move them toward judgment: + +1. **Weeks 1–4 — Build and Tests.** Implement tasks against specs and contracts handed to you; write tests. Learn the architecture check and the evidence bundle. +2. **Weeks 5–8 — Contract and design.** Start contributing to contracts and screen states; learn why the surface is frozen. +3. **Weeks 9–12 — Scenarios and Specify.** Co-author scenarios and specs; practice removing ambiguity. +4. **Beyond — Domain discovery.** The most abstract work comes last, once judgment is calibrated. + +You graduate *up* the flow, from execution toward direction. Deciding what to build is the senior skill, not the entry skill. + +## Tool portability + +The prompts are plain text that reference files in the repository, and the gates are enforced in the pipeline, not in the agent. So the method does not depend on any one AI coding tool — the agent is replaceable, the method is not. A conformant prompt is (1) tool-agnostic plain language, (2) anchored to repository files rather than chat memory, (3) self-describing about which model and exit criteria it assumes, and (4) checkable by the pipeline. + +| Concern | Where it lives | +|---------|----------------| +| Prompt discovery | a folder convention in the repo (`playbook/`) | +| Context | repository files the prompt names explicitly | +| Gate enforcement | the build pipeline | + +Switching tools changes the discovery convention and nothing structural. + +## First week, by role + +| Role | First-week task | +|------|------------------| +| Product / Domain | run the Specify prompt on a real input; produce a glossary you would defend | +| Architect / Lead | review the AI's setup draft and lock it down (the first contract freezes with it); wire the architecture check into the pipeline | +| Engineer (Senior) | run the Build prompt on one small task; produce a full evidence bundle | +| Engineer (Junior) | take a handed-over spec; make a red test green without weakening it | +| QA / Test | convert one rule into a scenario, then a failing test | +| Designer | take a spec; produce flows, all screen states, and a clickable prototype | +| DevOps / SRE | wire one gate report into the pipeline; add secret-scan and allow-list to setup | +| Security | build the dependency allow-list; make security findings a `HARD-STOP` | +| EM / Delivery | choose the pilot's profile; stand up the review-throughput metric | + +--- + +> Adoption is a loop too. The method itself is a living document: every cycle should feed improvements back into your copy of these prompts and conventions. diff --git a/.add/docs/14-foundation.md b/.add/docs/14-foundation.md new file mode 100644 index 000000000..e69078c03 --- /dev/null +++ b/.add/docs/14-foundation.md @@ -0,0 +1,129 @@ +# 14 · The foundation: project context across milestones + +[← 13 Adoption](./13-adoption.md) · [Contents](./README.md) · Next: [15 Foundations & Lineage →](./15-foundations-and-lineage.md) + +--- + +## The engine needs ground + +The flow in [Part II](./02-the-flow.md) is the *engine*: Specify → Scenarios → +Contract → Tests → Build → Verify, run as a tight loop. TDD and ADD turn inside +that engine — write the failing test, let the AI generate code, repeat. + +But an engine needs something to stand on. Every loop quietly assumes context that +no single task owns: *what the words mean*, *what we are building right now*, and +*how its users experience it*. When that context lives only in someone's head, each new session — +and each new milestone — starts cold, and the AI fills the gap with plausible +guesses. That is the same failure the method exists to prevent ([00](./00-introduction.md)), +one level up. + +The **foundation** is the layer that holds this context and *outlives every +milestone*. It is not new ceremony; it is the [living documentation](./appendix-f-requirements-matrix.md) +the method already names, made explicit as three concerns. + +## Three concerns, one foundation + +![The engine needs ground — the TDD ⇄ ADD engine runs on a DDD · SDD · UDD foundation: context feeds up, and any loop may send a correction back down](./add-foundation.png) + +- **DDD — Domain.** The shared, precise language and the boundaries it lives in: + the core concepts, the modules/contexts they belong to, and the invariants that + must always hold — the domain model and context map behind the names. One name + per concept — the same names the spec, the contract, and the code all use. (The + [GLOSSARY](./appendix-c-glossary.md) holds the full term list; the foundation + holds the model those terms describe.) + +- **SDD — Spec.** *The living document.* What is being built right now and what is + settled versus still open. This is not a frozen plan written once — it is the + layer that changes as the loop learns ([01](./01-principles.md)). In ADD it does + not duplicate the work; it **points** to the active milestone and the frozen + contracts that other tasks build against. + +- **UDD — UI/UX.** *Users use the interface, not the spec.* The experience designed + before code: the **user flows** (happy and alternative paths), the **UI states** + every screen must handle (loading · empty · error · success), and a design source + of truth — a `DESIGN.md` or clickable prototype. The AI can generate a prototype + from a design system; a person owns the empathy — what the user is trying to do, + and what "good" feels like from their side. The scenarios ([04](./04-step-2-scenarios.md)) + test that behaviour; the foundation keeps the design intent that makes a screen + worth building. + +These three foundation competencies, together with the **TDD ⇄ ADD** engine of +[Part II](./02-the-flow.md), are ADD's five. The first four feed context to the +fifth, where the AI executes on it: + +![ADD's five competencies — DDD · SDD · UDD · TDD · ADD: the first four are human-led and feed context to ADD, which is AI-led under your direction](./add-competencies.png) + +> The diagram's foundation (DDD · SDD · UDD) and the method's own words — living +> documentation · the foundation document · ubiquitous language — name the same three ideas. This +> chapter is where the diagram and the text finally meet. + +## One file, not three + +A foundation that takes a week to write is a foundation no one keeps current. So +ADD realizes all three concerns as **one living document — `PROJECT.md`** — with +one short section each, plus an append-only record of key decisions: + +``` +.add/PROJECT.md + ## Domain (DDD) — concepts · contexts · invariants + ## Spec / Living Document (SDD)— → active milestone + frozen contracts + ## Users (UDD) — UI/UX: user flows · states · DESIGN.md / prototype + ## Key Decisions — append-only: date · decision · why · outcome +``` + +Keep it to one screen. If a section wants to grow into a manual, that is a signal +the detail belongs in a milestone or a contract, not the foundation. The foundation +is the *thin, durable* context the engine reads first — not a place to relocate the +work. And you do not hand-write it: at setup the AI **drafts** all four sections — +silently from an existing codebase, or from a short four-lens interview on a +greenfield repo — and a single human **baseline approval** freezes that draft as committed +direction (the setup-level analog of a contract freeze). + +## How it feeds the engine — and takes feedback back + +The arrow runs both ways, which is the whole point of a re-entrant method: + +- **Down → up.** At the start of any session or milestone, read `PROJECT.md` + before touching a task. It is the cheapest way to point the AI in the right + direction. `add.py status` prints a pointer to it for exactly this reason. +- **Up → down.** When a loop reveals that the domain model was wrong, the spec + stance has shifted, or a user assumption did not survive contact with reality, + you **stop and update the foundation** — then come forward again. A passing test + built on a broken foundation is still the wrong software, fast. + +## Where it sits in the hierarchy + +The foundation is the **Project tier** of the document hierarchy +([Appendix F](./appendix-f-requirements-matrix.md)) — created once, kept for the +life of the product, owned above any single milestone. + +![Three tiers of documents — Project (the foundation, .add/PROJECT.md) → Milestone → Task: scope narrows and lifespan shortens down the stack](./add-hierarchy.png) + +| Tier | Lives in | Lifespan | Holds | +|------|----------|----------|-------| +| **Project** (foundation) | `.add/PROJECT.md` + living-doc files | whole product | domain, spec stance, users, decisions | +| **Milestone** | `.add/milestones//MILESTONE.md` | one depth-bounded goal | scope, shared contracts, exit criteria | +| **Task** | `.add/tasks//TASK.md` | one feature | the seven-step artifacts | + +A milestone is a *version bump* to the foundation, not a fresh start: when it +closes, consolidate what it validated into `PROJECT.md` (a decision, a settled domain +term, a confirmed user journey) and open the next one against the same, now-richer, +ground. The consolidation is not informal: each loop emits **lessons learned** (tagged +`DDD · SDD · UDD · TDD · ADD`) in its Observe step, and at milestone close a person +gathers the open ones and consolidates them — append-only, with the `foundation-version:` +bumped — into the foundation. See [09 · The loop](./09-the-loop.md#lessons-learned-and-the-retrospective-consolidation) +for the grammar, the ritual, and the tooling (`add.py deltas`, `add.py check`). + +## In the tooling + +- `add.py init` scaffolds `PROJECT.md` as a living-doc file; the AI then drafts its + content and a single human **baseline approval** (`add.py lock`) freezes it. Like every + living-doc file, `init` **never overwrites a hand-edited one**. +- `add.py status` shows a one-line pointer to the foundation, so a fresh session + re-orients on context before code. +- The guideline block written into `CLAUDE.md` / `AGENTS.md` tells any agent the + same thing: run `status`, read the foundation, then work the loop. + +> **The thesis, one level up.** The engine builds the thing right; the foundation +> keeps the engine pointed at the right thing — across every milestone, not just +> the current one. diff --git a/.add/docs/15-foundations-and-lineage.md b/.add/docs/15-foundations-and-lineage.md new file mode 100644 index 000000000..18fd10916 --- /dev/null +++ b/.add/docs/15-foundations-and-lineage.md @@ -0,0 +1,106 @@ +# 15 · Foundations & Lineage + +[← 14 The foundation](./14-foundation.md) · [Contents](./README.md) · Next: [Appendix A Templates →](./appendix-a-templates.md) + +--- + +ADD did not appear from nowhere. It sits where four currents meet: the **recursive +self-improvement** thesis (AI that helps build the next AI), a decade of **autonomous and +agentic** research, the **spec-driven development** movement (the specification, not the +code, is the source of truth), and the **tests-first** discipline that constrains a +generate→check→refine loop with executable tests — turning fluent model output into +trustworthy software. This chapter tells that story; [Appendix G](./appendix-g-references.md) +is the verified source list it cites into. Every `[Author Year]` here resolves to an entry +there. + +## The frame — "closing the loop" + +Anthropic's recursive-self-improvement picture runs from autonomous agents delegating to +workers *today* toward a future where Claude improves Claude — *closing the loop* on the +work of building AI itself [Favaro & Clark 2026]. That is the backdrop ADD is built for, and +its position inside that picture is deliberately narrow: ADD is a **human-gated, +evidence-trusted** instance of recursive self-improvement. The AI drives the whole inner +cycle — specify → build → verify → observe — but a human owns the frozen contract and the +verify gate, and trust comes from passing tests and re-resolved evidence, never from a +diff that merely reads plausibly. The argument is not that the loop should stay open +forever; it is that the loop should be *bounded by human direction* rather than left to run +unattended [Amodei 2024]. ADD is one concrete shape for that bound. + +## The four currents + +**Recursive self-improvement.** The mathematical anchor is the Gödel machine — a +self-modifying agent that rewrites itself *only when it can prove the rewrite helps* +[Schmidhuber 2003]. ADD enforces the same discipline socially rather than formally: the +never-weaken-a-test rule is "only change on proof" expressed as a gate. The algorithmic kin +arrived later — a scaffolding program that improves the code that improves code +[Zelikman et al. 2023], a generate→critique→refine micro-loop [Madaan et al. 2023], agents +that keep verbal reflections and retry [Shinn et al. 2023], an agent that grows a reusable +skill library over time [Wang et al. 2023], and an evolutionary coder that beat a +long-standing matrix-multiplication record under continuous checking +[Novikov et al. 2025]. And where a self-rewarding loop has the model judge its own reward +[Yuan et al. 2024], ADD diverges by design — it makes the tests and a human the reward +signal, not the model's own opinion. + +**Autonomous and agentic workflows.** The architecture vocabulary comes from the canonical +taxonomy of prompt-chaining, routing, orchestrator-workers, and the evaluator-optimizer loop +[Schluntz & Zhang 2024] — where evaluator-optimizer *is* build→verify→refine and +orchestrator-workers is ADD's wave parallelism. Underneath it sit the base agent loop of +interleaved think→act→observe [Yao et al. 2022], the self-supervised tool use that lets an +agent run its own tests and builds [Schick et al. 2023], and the designed agent–computer +interface that materially lifts autonomous issue resolution [Yang et al. 2024] — the role +ADD's `add.py` engine plays for the method. The production reports close the gap from theory +to practice: checkpoints, subagents, and rollback for autonomous work [Anthropic 2025a], and +a lead orchestrating subagents under an LLM judge [Anthropic 2025b]. + +**Spec-driven development.** ADD's closest siblings are explicit specification systems. +GitHub's **spec-kit** runs `constitution` → `specify` → `plan` → `tasks` → `implement` with +the spec as the executable source of truth [GitHub 2025]; its launch framed task +decomposition as "TDD for your AI agent" [Delimarsky 2025], and its rationale named the +failure spec-driven work exists to solve — context degrading over a long session +[Vesely 2025]. The academic vocabulary followed, with a taxonomy of Spec-First, +Spec-Anchored, and Spec-as-Source rigor [Piskala 2026], and the pattern is converging across +vendors [InfoQ 2025]. Nearest of all is **GSD** — a spec-driven, context-engineering system +for the same Claude-Code niche [GSD 2025]. + +**Tests-first and verification.** The empirical backbone is direct: supplying tests +alongside the prompt measurably lifts pass rates [Mathews & Nagappan 2024], and the field's +yardstick judges a fix solely by whether the project's own tests pass [Jimenez et al. 2023]. +"Done" means the tests pass — which is exactly how ADD gates a feature. The safety framing +completes the current: human control and transparency made concrete [Anthropic 2025c], under +a governance ceiling that grows *more* binding, not less, as the loop gets more capable +[Anthropic 2026b]. + +## Where ADD diverges + +The shared lineage is real, but ADD is not a re-skin of its siblings. spec-kit stops at +`implement`; GSD ends at verify. ADD closes the loop past both by adding three things +neither spec-kit [GitHub 2025] nor GSD [GSD 2025] carries as a first-class gate: + +- a **failing-tests-first gate** — no build starts until the tests are red for the right + reason, so the contract is proven executable before any code exists; +- an **observe → `fold`** step — confirmed lessons learned consolidate back into a versioned + foundation, so the method improves itself across loops (retrospective consolidation is the + recursive-self-improvement current turned inward on ADD); +- a **dynamic goal-loop** — the engine holds a milestone open and reopens tasks until its + exit criteria are met, rather than declaring done when a checklist empties. + +ADD also deliberately targets **less doc-time than GSD** — a lean foundation and one human +approval per task instead of a document per phase. The tests-first gate, the `fold`, and the +goal-loop are ADD's contribution; everything beneath them is inherited. + +## The evidence chain — the loop already runs + +The case that this is not speculative rests on three measured facts. First, the task +time-horizon: the length of work models complete unaided keeps doubling [Favaro & Clark 2026]. +Second, the authorship share: by 2026 more than 80% of the code merged at Anthropic was +Claude-authored [Favaro & Clark 2026]. Third, the **Automated Alignment Researchers** result: +nine parallel Claude agents recovered roughly 97% of the human-expert gap on an alignment task +in five days against the human team's seven [Anthropic 2026a] — parallel agents working under +review, which is precisely ADD's wave-plus-verify shape. The loop already runs. + +What it does *not* yet supply is the discipline to trust the output. That is ADD's +contribution: the frozen contract, the never-weaken-a-test rule, the evidence-over-inspection +gate, and the security HARD-STOP that no autonomy level may auto-pass [Anthropic 2025c], +held beneath the responsible-scaling governance ceiling [Anthropic 2026b]. As the loop grows +more capable, those gates and the human-owned verify matter more, not less. ADD is the human-gated, evidence-trusted way to stand inside the +closing loop and still own the result. diff --git a/.add/docs/README.md b/.add/docs/README.md new file mode 100644 index 000000000..71b9bed77 --- /dev/null +++ b/.add/docs/README.md @@ -0,0 +1,74 @@ +# AI-Driven Development + +### A complete, practical book on building software when AI writes the code + +**Edition:** 1.0 · **Type:** Methodology + operating manual + +--- + +## What this book is + +This is a complete guide to **AIDD (AI-Driven Development)** — a way of building software in which an AI agent writes most of the code and people do the two things AI cannot reliably do alone: decide *what* to build, and *verify* that what was built is correct. + +It is written to be read once front to back, then kept open beside you as a working manual. The early chapters explain *why* the method has the shape it does; the middle chapters explain each step in detail; the later chapters explain how to operate it across a real team and product; the appendices are copy-paste reference material. + +A single worked example — *transferring money between a user's own accounts* — runs through the entire book so that every abstract step has a concrete form you can see. + +## Who it is for + +Anyone who builds software with AI in the loop: engineers, architects, testers, designers, product owners, and the managers who lead them. No part assumes you have read the others; cross-references point you to what you need. + +## The method in one paragraph + +For every feature, before AI writes any code, you write four short artifacts in order — the rules it must obey, those rules as pass/fail scenarios, the data and interface contract, and the failing tests — and then you direct the AI to make the tests pass without changing them, and finally you verify the result through evidence rather than inspection. That ordered set of artifacts *is* the method. The code is disposable; the artifacts are the durable asset. Direction comes before speed, and trust comes from passing tests rather than from reading code and finding it plausible. + +## The flow + +> **Specify → Scenarios → Contract → Tests → Build → Verify → observe, then repeat.** + +--- + +## Table of contents + +**Part I — Foundations** +- [00 · The shift: why AIDD exists](./00-introduction.md) +- [01 · Core principles](./01-principles.md) +- [02 · The flow, and what is disposable](./02-the-flow.md) + +**Part II — The method, step by step** +- [03 · Step 1 — Specify](./03-step-1-specify.md) +- [04 · Step 2 — Scenarios](./04-step-2-scenarios.md) +- [05 · Step 3 — Contract](./05-step-3-contract.md) +- [06 · Step 4 — Tests](./06-step-4-tests.md) +- [07 · Step 5 — Build](./07-step-5-build.md) +- [08 · Step 6 — Verify](./08-step-6-verify.md) +- [09 · The loop — observe and learn](./09-the-loop.md) + +**Part III — Operating the method** +- [10 · Project setup and stages](./10-setup-and-stages.md) +- [11 · Governance](./11-governance.md) +- [12 · Roles and responsibilities](./12-roles.md) +- [13 · Adoption and onboarding](./13-adoption.md) +- [14 · The foundation: project context across milestones](./14-foundation.md) + +**Lineage** +- [15 · Foundations & Lineage](./15-foundations-and-lineage.md) + +**Part IV — Reference** +- [Appendix A · Templates](./appendix-a-templates.md) +- [Appendix B · Prompt library](./appendix-b-prompts.md) +- [Appendix C · Glossary](./appendix-c-glossary.md) +- [Appendix D · The worked example, end to end](./appendix-d-worked-example.md) +- [Appendix E · Checklists](./appendix-e-checklists.md) +- [Appendix F · Document requirements matrix (Project → Milestone → Task)](./appendix-f-requirements-matrix.md) +- [Appendix G · References & lineage](./appendix-g-references.md) + +--- + +## Conventions used in this book + +- **▶ Example** marks the running worked example. +- **Do / Don't** boxes give the rule in its shortest form. +- A **gate** is a checkpoint with an explicit pass/fail exit. Its outcome is always one of `PASS`, `RISK-ACCEPTED` (a signed waiver), or `HARD-STOP`. +- File names like `SPEC.md`, `features/*.feature`, `contracts/*` refer to the artifacts you create per feature; see [Appendix A](./appendix-a-templates.md). +- Where this book uses a plain step name, the formal phase name (for teams mapping to a larger standard) appears once in [Appendix C](./appendix-c-glossary.md). diff --git a/.add/docs/add-competencies.png b/.add/docs/add-competencies.png new file mode 100644 index 0000000000000000000000000000000000000000..3afaeb1fece7f5a25c6d2d993d21a6855a37ae0d GIT binary patch literal 247915 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

AFiZktP%Kf^p=M9e=P zayYE|oOgvvT+yG<{@j{dh#*mM)L7whzxuC&BG1Ae;S7B8x_f!qKkwgvp&MG`KM2%JbhM$(w^k)z2SXtW|!hWJ1n9KEz zGHN;kL}$RCDzTv8C`$aMf4hkX+B>cNfHMs^Oja%dA=YxyG{FmWLS1!O|1a zd*nACM4?Axrd@AxZ}9S4>DUskdtvVKH|+S#-kFFvn-`n1yU}b_mZxL*3)OT=UA0G} zzIXN86r3G{Up{O6^J}xWylp@B_6Qq6=Of{0r<}ue>{dQ^Ej#MGm);a=_1ox=IaWZA zpWnJ|pwr&Iq^8U30xq7E>)+x*Jb}tQj?N(e1(XteXLAbg4Y6QH9 zP1=aRR9;5H4|F{l*|b2o4X-raHOc=v?M>3N&uPBs8d-L6f}GZ*&pMNSi>=QnZD-&q zT`ws0o~{pV7}6!GUsknf-RF)AXejc)G@I^qD?b|0N13n|DW{pK45J>*ULwPAp=x`H zhZYeqm?SI2epu4gX&twGgoMiBq zP>8(CrUR7+pXz$OFNag3-D^|EUP-7&%q&`O*yc^MZHSD}6-Hgm_`u14y1VM`Hn;BS z4js4}kzPCGHqGOkLXY$yj$>dk(e7i5!B6VyZ69b9x8J+es@mGU>?=#p>)F~Wdv)eT zjUHV8OxE^U8F{IluG!CEUYR!%PK0h%D2f4fLmG5isOZ^oc!b7)A zt8+XbFZ3;Q=oUwJ0%+py!X*su?)=ee+)*cvR7B?AK9s2-IV@q)P-P|C05mmM0y^_Z zn8O8bd?6uM$+0{l`>y0$V&%U|ZJEirr;xvc9rT*v^!9H}N;U3{y>>0M zB;%_p_WjbkPhyeeE_;?fJ;(B3;N)OmsZs}dpe**gRP&PRhZ5SlSn!5@m1@?5hHS*; zMO7!pO>DFWYM1Zv;ozIKf6fsZe*N2|o>@UwB&GSLRzSx@Q^Zl)vk;iQUb&KEZp_TN zn{@-w0CLA)2#R%@5lR`qqm93gJn$_juC%xe-TpfJ?TFpokI5(71t0;6$vL9}QZE=? zF&n5Xged!DT}e@pPR85W8|VGM=g~Ty6E&#cY=-RUHl4LWNB7NW9LVh3(v&^z_Umjm zpQF^w9XbCTMzBj4>m*A|&7M=^j&l1Tw#9 zyLawc<;6O-CVgyNv`ZI;D3=v$*NLHDcch1aYFAe9elLknp( zdTOwiAqS_pk)b#*-dm&~9dtz+cZxlWJW|AW;S+iR0MJ#(??Un;9gxs`zFS*Mw!Ryn zh{&*ROywUBWHp*UNh~d^F(M9kay&U5npR-3q@NWCk;Iu|pw+p#5)ttu#jeh>mifcN zATp8TxJ?dcjY8(!<3~WGH~XwFvQyQiv1RcYpX!(g%#WNgY&v4KXWJbYzU>iN#A}9k zaDqE^FXQMn2HW5g6%rdTeD<2r=!Br{0gxxO=szdnZOWJ}eCY8n&8Lr&9fqL=7$3b#) z1Jb%t?q)xWgZNI9Bb>EFLG;HZFwmri3kPx8sLl}bapk^Fs5Gur?Ns6Z3pwI|xF<^j zC|pUL4_OkFi&05>J{L=PS1s-kZ6FwJGN@_9UjSA5!lwznR48l>t(5=C)wQvzYwuXr zlPvHW4bbyRl0<{n>fho%%nbz65|FLC$5)_K8b=iD|c;_&&V0QZB)N>Ja5zq29}v_Yk@QlP!5W7HpS` ze<6pDt*--HZPvtuK&jevuqv-*RIGR}Dy?lX<*K100?Nw8N@m*CPKCFS4#R-}lS&_j0LHyZcLD=VGlSH%Z2?wJP^ZRch97hIFO?el5NGBkx5LI2Uvt9i29^_#x$FRg-o zL1GUgBjMB6T6a87C#J;Vab5eC5TdJw4I7=>D~q&Dg_D02pB)QOymnPA zUSy&Z=Kz)X^T5&J#d!_qSEC2bazDW+?lFgK9z||@7A2rq=fD)@PO@t}e{#osso+x7 zVWYJZI`2(jmT8@raL=8dAA5XN9?~DP*n>>1p`>QL3REdKMxqhQ!O<5yL8wG@$;Sc9|UdZ1=d%8{2j9Q&%^uHTxohO<|6xG3mm z`wZmf;_{~R-dPNyv-P{5c@7l#sywF;RL0Kj{MR+Egul_Dw@>QJ-qKr_Y43QHRe20@ zU)R>CTZqBIegeWd5c8xDIe*Pz{Bmna%E#pi@XB(L!ozvz zgKH%)ubn*SfsS(P@Zp!eetN9 zqn}GuLhED9r|pHDdfy?M2UuYKAO2 z7K}9|{+DtiUac2lGFf>Dcz_P&#;OwHNY5*mY>xshRh2*ey=tAjmC(IgkpO60Zz=N#mIj*s>_ZBBq-vNu2C@T*| z*D9G06^a>HJi!@1XZ^Wt?Tdrm$d4$~O;^*5o$W+#dOO8Gg-%44%3IoY5<8Wih5Ue+ z7yg7S2HmtDuvg7>j+}ipnEE5VN1l6TTcEk{C=Kk#x(z;^np=Ns(r^_N0vno{Am()7$mbzw***U8Uv&(rA9b@xwQu%S zkjC|G-{woldZS_QCdKBS>Ft61u9C2htwOyjxVyRZ=rt>ydbh;GF*zl%Wd8}2!fKdh zi%Qpvg-jAb%euAVUd{qa!V;)_n<-yd*vgM>)*TASuWy}y-Q*VJy)2nCYcgaw{j=!O zPcP|`NBycrZHXOcC~x0f+{gFHEI_I*&%XF`?zf=>blaXk9m-UqG^>BD|06~@+dS;n zkrD16Q{kV)Re9u};905kJphyu%5pK6thc9h#{RiCY*e7^ci`nMy%+HK+K~CKT#~`n zwR67(^gD+hvgPTLZuq|OQXSy1GU-6pF7+8c4G2q95m4$1aS>O905N&PCB|YeUO2&a zv|^O)$bTpJ>*!W_~w8Zge?_9(!G!_sN>^KIp7q|_6#d&6#Yib1gUOXmq z>;mYRZ%4gwW0=GA(6o*#$4ZRu9KFA@bHvYF==;jP zy%{f4(iBJsADx@&jd*2?pkt9^*UQor4vcOZsz=<%eXRd{GWS=_&ngkms)TQu2)vW~ zoI=pk3!CO(Np<%6?A^(le#zR<^C!NX(2TlJnT65s zm$NPDY=r}K_LXb%haXHmIGoe9-nxm%mJ^yckEK7x!hjK>$JZe3k7gx(NGx3P?F{2C` z{^L>EW_6F&sBEmmye8IvH{P@DHGW&VZHb@WlAp%_XOc z)2DtztH+aTyuJoT=>)bVXoLm_-Ia4I@2ODhhQtdoyvx3hQf|!Np6YX-{IK)Re7ter zr7x`}2rd1aakW?D{cy{chk|DGM$FZ3)Ujlcc#qGDmk;jIiNe62^cYe5UTWWeA@yyaL(I4CnQjHENsGaKMZZpIF-^5oBCHb`4fAIRR|RrJ z?u4{set!931^Wwmc4Jfb>ShBki-*2;ny#9<8o~yeR;A8}(5Cb1Cc0Ts%6kV^9gSK^ zL0dV45>xK}t8YI=mN_s0*sP!#-n`E9G0n*@Y{=D?SD})w+(Se7ugL_Vu8gn)sj-`I z@pC%rK@Yd|8ji2$%4Ge895eHrFtMn8w}#A-ksh&`wH~Rz{vZAOvD&t)VTpyu@p5RNHlB)KL{hl#%re`B~==Ieae!+urh z>N-9RE7FKa+pn?Y}JgwE)y*E@GqX^5+%xc%FbsTa$J1Y@w(90@AoKxP5F1?PvayW|iQRm}mr}aX7@0A$tHu=#_j3MH#gm1e zPZA};sy?AB1(uw6iacyYRYbY%Eb6Q*L{*2~chNAZepN3$vvtQe<-BVyLvrq7aYe@c zO8itCmzb(GpsX7(&Q<4cXAO2 z7V^pbWIKIwp#a4;&eWqV!WyDj1*&u8cdJJ(*(c+~!UrL|*WwY@h>f`3^8@( z!WpmGsO#ogiFNlI5zKh%flhAkW<@^NOg5-;>6W$O*IK1g(Ch$lh_ZqiOzHwvl(o_Z z0kT!ay;;?-N_9*DR{XGdur1NG^;P2v9Gkx2p5a&azDQzK-*L@Zj!c$lt-z^gsK-TD zRV4F4-4oSd;mfwZXi!Q~2qIq3gA*k516e_fLVn>U;gBnL_;{9CxV73As9yyYasVar z*81TN4h|46wIy-}P(nfrEBOoLYq|K;!1cAnfk+`^-LZSyovv;SWQly*1V~m|L5)0` z%SPQ<6?%O>S-8k43BBf`c&X}yLZG-o=L=`5e9(W|K_^TI{jfEw;j&a%r2sjD%Zh)} z$K9Q7T+X}fXe}VGCJ{eE&f-@C#g=4dJ7w4G2cZy&_LRAhO%kF+39?C`lCx$uAQ*#u zzwwOy+;38B^liym);z~)$Dvi%4g3s*sNs%-5Rrc+{CWy%9FA|hfpVgke#dQASRZUbK=)>Clt)_i zRVw7SfDQ5(XivYE1)8vARagj}z5wXMi2Xj{<4LjuG0=z5V|0k$Y%4p+$vsg$0@rIL zTO;IB?2)PSJiS^}@$EtedC@?`LGa(XfPM=$UjS_}9^}cM_RokTmp-Vh=Wdta+N_DH zPIjRh2zt3xRK+_SrHUAszf6DA&Q%o^8JuVoEld|;GTu7MhQ?asmM3qHKzQMKhUkX00eJK6<9W@ z@qj8=SsNWO|EmDSAkZPT+h*+{1wa*om(j+A^r3ZZ^sl zC}uh`1YQ#3%6g~}#8+KMtsgcBT#)_HR%S(#H~}WR&@Wg06*P5OhT6QnJag0>)kMm zy`dh&Csh=md5VSXRKdTmof{EmX4w_^(#eWjTk^20XEO7@(60k6by{>RO|Yg6~n z0ChG(>^R_Ic39GYJi*>!F7Y$YcykFQ+|WauIu@dZF%M(}G~`iQh|Itv;dDo4L(9S< zGyVGJ?*ub{#KR&jfob#Taw$WG;4X-51ezeIRA$y^e(Yjt`UT?0BJq_e#<&|NZ^xDe zN>5E#9D9RcdTA-s*f<{?3(fg}l|BSchhxNJTlsRaYD+atB;$J-(A=T5P$vX#QQi)V5m58s}M)j1vKN8K>9mD^Hz~TEXl^jcn43pCwH+QFi>01n% zt^6`2Z$}2b#v#rV`(!a~JK{g&4LE&W;-M@SE0g-QtLtDs_7L>g9(d#rv!aj1_6*#`=YVKIG^ssfh%{-Ti8oo*Oi~% z{exqrb6}oxAfoF1IOZ8@tHU}GcvQ#k?g%9a4y~y$4gm7x{DF1A;ZR%Pp*2`eV?S8K z=}O02o8Z4cBi0_FpyFQ~nTek+r~BsZ(y*?Goio*_FGyxM$3ou|yVW#k1(HEQCP_Od zY4=k&-im)A$wHx1Puqv!yG+DDmjV2F*~(bl&$zpZH%k8ZtI=$ovXytUy#@7~pMjBt zwJFz~n6vxnk^nnl05KQLF({k#idnuPv&$q>QF7woQXo3@$oKp14aa}21R}dM=x#we zYR^YZTghJt=;4aF#H<_Vjm*FG15aH8Yt#jl-X1(Ql@ur99ZKZ zT)+Y8-TUbRZ(_H9$&mg+f``96O~g!&=OjP;iC6=P^h~7*gNx&wY3$T#kj48Wz=5Hd zo^oJ4EmpIf7!OnyOIS)8_KGiu7d&2`P%LX#MjqdQXugix7WDoLnH>Xvg=jWFg8$)n zg373M+NX{)aEM0HwF9c5pC*-^*ZYY5pPHrZ$G53b?&j4ckIuJu@ z)3N_+K{T@~XAEV9r9B3Bl#u=xBBK9~S~h$KtbUuPW;qCF#B*e<9(* zpkHm0{Z@|GEs;3B6@MXJ6CkGqz}#&1|38um5}e*M`*OjU9*M6eVE^@DIukraB>TOG zcy-PH4xlyQSF|2oirI0(ZhZk=h-&^S+20qy;RmBg7x6rOrE{uhLV4-&EPl7a3GuvO zrJt=J*NLibz#y2N76R`R3Cs`rpjr|YTt3x|7FD+X_22N7!uASs1_i29YQ?Kx)nXaH zkgSX1U!Ny_gP%fGH`j{q)?2kAn=qe)fppq~vkfH%zFq^RxK4Db{=4RUTwq(zuHiS3 zoWQ$-Ghsfp9?&%G-wvKk0*Z?<^lAL-)IRw72v*m&gdaPuy`TYnTNjaEHxm08+`Hz- z!38Hn**Z1d?wE544n*YMAUHcBlh2PfYpV5$SV&kuxYE1ca2vUzNk54=4D9tDOY>mJ za)^-+J5AP(P3O)$k?B;Go?%1R$_++b*~u||wBBb4C%GI4>-rP_kcPgH5|T+HD$ZGrC{HN7s4PXZTqlU z55ST8$q{9d;mbC`lrmNTa&j+bk*3^$?QYC82PSZj9ZSqe_eDgY{N=>!=go)ZYNlIx z7=(sY5`dxXIElCK*!@ahesmVT4CbX&;T>edx7|uGE6Q_s1CsZc7-_n6OfCf_24KyFYToK17btL_gL zoq)%RPGTAF5fm5Bgx@M>IHzo@!w?L25?UA@9)|9gqHnQ}z^C|Pk$5I)cTHppj9Kv> z?3A2%0rlIRZI-_{$IK>aWJ?101aPcqj+7^@&~lBGX|S7MCrYS^Xj{USW29q{EZ36t`1`drfzsg%0q0^TsL!56&s~?u%N%d0n z3ARS)R2X(JXc#%s3#Kc)JGkf8-RAZLH2u#u>jsgv37(2m0C0dMfHy>FjX4WnKL_4} zRbMQ}!Vw%7ytOE_m5f_-<9{uRO0e)q412nyG3 z%L|b8i0?(PkRQOIT48vYAKbyDA^m?p8$#aY$buGNkQ@tVOUQ03F`X&^aO`CTplPmV z@W@LULSXbuz^5Lb+%0j+MtPl zAxvC-xFz|5%GUC72t5BSQ*E{2|WBOJE0210|tr~ z9iX$O0>KmcZXQh-Owhx?FjMC_#^}l=${TPJprTLp-U;42M6ys!G(QHCm4z#b@9oy? zqNp=npaW7pb^?u1`2Cl5%?)KX@8emgh_6wetUs3!-{@oTaR*O%d}~YjMnf8w;)?l_ zfeD@D|B5Ny|C;mi-=hv?c7_snPLu;KRBsfK9r2_v%JRqC$`q6c{3fcYau>{@he@No z_p$8ra60&I1ik9Tj5H(C)32s;hQMm?qwcWVKuklLZ8viA4sd7F;0cIt!$)m7gW!RS z?Cv-jZ4XVJJoOin^fO9%d*q|?s?S!XNkbZNUzQNjujj#A>hd=+P@txBu?09 zP_V4a2uY*uS$wHQC}Bl|T}c3+QOnQB?b$4>1ZwHA4T4z$N&FaYV&sF@)T)zszlaXC+y#zArlA*(ycv!SrGFVZmB4kNSr=!+@qB z@^ADfxa}5p39v!&%~uS`0gMr2?DhWt%-BSh-Kt35N77Z-{~mJ%9*(FjzoBxkdsl&1 z;nYGtS84D9{LBCGbl%}q|9{*+viHbdN0Cv4tjt5QLnxagl$9i89p@O?dzW<-A~MP> zdy`~F4snhnvd@W*lQVwz=X>ARb^m*=%i%ch&+Gjf&)4&Dj6tLWK;?@c7ka`X!-AUv z9PIWMR)4NdJ}0n-w~ao!Qcx5mt#)_3`$+9C&E=Qu5-f6N)%*H1XR0>m^9kAhbU;mZ z(V|2vjV2S~`~(#vvunzbduSFPWrxony+Ygd)w3YZVi1^df()`20|7ga&~uwnkg6@( zc3zZ)CiOs8G^9lH8!#&trejQFm(ktb_&TfHrB}c`s&I*scK})=4Pj9>1~w@LcTEI0 z)0F5zf)iEQ=I-o*6ki(Ufz5vp80cdd4 z99xVBo6-VXTDCY#Rdm?v41gf>dj_1z*i|_nf_e?Y?3zB+nwwOuF7dS&Ikyep{I63r zrif^imYtS?WGV^pChM}x>4aGRUzbAv=fP&j`pj0mu>b+S@{U|IPL8uzXq1-LL^Vd1 z?zH+sype*8DhmyxxpJAX_K6WlMzv@DP!#~iXja8pSj@+Ey;O~6c}lBV&4xF6p@h(a zzOKD1OH(UdApX>k;>Ui0c4FUL1y!2nUN9y*sTwk$mmv(2)f@!_T-tHodEZHTm(rn z;!Aj`g=x(qnZ3^H*^{>N)tZHs8K?KD17dezSdhbNgGkur9ta_is2GAr478YG0st17 zDADRy7=nF|HYwq5LZLC_ugj>9TP(}h#6VmYpsAr0 z+tpuPaf4f+jT_>72Ctjm=*G>L=4jcyI=QQioqvnYy^i0v;;@995XU!X4r}pX!bjq3 zoEKU#5=W=5!9DzL)q9%ntI`K?4~HwA6Nt~CQFrUrYlN4S@-Pb*#Z^Vj$8k() zsy&!!Muxm<^pbxnZ2G+#I{d6d>(Z{Z%@4|>yW_oPZA+YqI+m3YGs7i_bR9Va|GR4c z7KPE8uk3wtUcrSACI23AGM13TiI?!nR2D=0$#BWeNPp7#@{6OkpDIp03k=0EL0hKo z%K=>Pm6Yxe&`nl+s%HhamHKhsS>CQ4&R!iJ)f2!|k_V4hMFx&><0D$7Oz*>tyrgp@ zw$L`na#I4t#paHJ0@*gi9aUuv5su8_h{pbhZBY>ROiSBkBaerHT3N(sV9G8e#gR z3C}3)ZOC-J>qzu5Fv8_XM3$aM?J|$lOy~zWtV9lhw2`II^u<_NA>(Fl}_r=p8=G{JHn~GtX zcAAit@2&GSgUu7x^gw+=uS7h-lmbA9@XSzf()p8io^`({6;!HIW3|W|6%|7j(4K*i zhp8s2{jbBpD||ZkEd9902{%K?#YN7N?a)gJ!Zq(7h8|i8odrg?6kJ!|I`CxD<&D3Z z=yj;@UKSPbN5qEMO$vrNQQiXc@*6~<&1}wHVV_}_Iv#B|tL0a(%eY?VNan5Bb>&s% zrmeSAIuX9sD`&1BflM$En#}t4w?-b*#Zh4npO5ysY$=TrEfH@s7ou*o>~ZoDcW{!MfU8pjc4PP-TnVPT ztRsV{WxusI9ooGbblG<4y#{F57jz^jedm0k1>EKXNOhX0kx7Wo@KjZ33O|Ga5imn% z1|SNw@>AZ2v5%gXF3b3`%1u~~Cwd&cLbu#(o)3JlHSZy(y5`jgc`!})e3bUGJUz|+ zWFLgs-~yNiYmZa4a9F9Rj=0ww>nN3`QzuN~D`vYvn%JAiuAB!kc+Sy&0m!3l8nQ9I zXE&@V!2Vh9;#_5>cf`?^6!p=e`1=e`l`Dpd-srtt(_X9+YuKJa&5Wv%n2RUCdnbcU?Mq2IARIoypATnJBH*~PM~>u;&=x#AJ`n1l#Z9N4q|~B&$ma5 z1R8}B7Y>$_L|zs>w4v7SpneP$?Nq9r79V^kJtjI}``V*%%cIT;GqHVFcCU^d8!Q?) zJWaSxI2yD_+`Cujp*bkJAeP;!#nI0F0M)OD2m)vJ3&D9;VT!YGmOcI`_eSgnSEkTW zkjKTb3J;_7cn*f0DXwaCu)9}%1mGU_5T^@u#dp34iY?XQ=+Qz3}s zsqUqqeSL6!Y4=>7HQ&k1!79lDrcSBtxulp1V^u9$Mujki>0Upe>uGrjWFTo;?*>uW zgoN36#<^&9yishB^PRw24?8EoW7c3ybKg>)9v%a8p6^Fj6>o6;ttFZ@5^s$UPHT`Y z?2ptnt})DIYd`CpDccc^au`PmjB*m?WYQ465N_)9QlAR0w>A}~@^4&S4?-IKo-~vYA!fimgKup^)%Nn$D z>VP{^J-=zb8U94#;Hoe(=fYm@zfRUB1(V%~%A36qpgQR|8^)tafmSy3&8eqDkLD|G zJ=IwgVCkK7xDr)Jn|luId5wnafr-|e{UXFijy|6jLM;xBzZj-o3Qt_3q=7(X}H;qFm=FG*MV)984FW$BV!I>ixfilKYFSfx*;lm7yu*&+BG} z+3TUBF`76T!gl`12G?aGAIXSlj7aR~ksd+~J~R8UD0s^Mr$z7)l}{?^_xtfQ&D-$U z&C(6N2gSX&48-IvW&Vz=md>I0^~}!clq_ZU%^9@*R!gyXd2VLd zg{M71YtMJ3`i=rLXUC{nx;GUJM#e(c<{!kF#ZPI(hfR&Ip|e*QH#bJWDM+A013v*TNwlY0i5L{(ng5Iuo9E1G*iRF8W1 zbmH_Mm(6$a%$fHr;9_Ji=tZ$G_}>v$o-vod6niqwSGuX-zA@}B{vBo#E}Cyxjk1oE zdfK!rrhxSmvWfn{8mnD`w_eF7BmlA1ZzeH^Y%{BxKFxu$m`axnj1u_D`NTo~{U>`{ z!Dm{cS&IW_U*tw(>!#8ew9>L8Mpcz6nf-3aRaKmp|EAg6%$Hb*vgwJk_0X>EWo*<4 z7X%hXK?*iKb0amsJkomd#z8S=uTz`9aH9UftVsscB_s#JE5H(dGQ7_7d47AjeWxWv zbXm49*m3f=zT?x%Uxs>{9Q4dg6z@39rwq%W%hMvE-k0Lexoxq0e;5xINMOH>R?f5@ z0|W*v8sOZYq*m&?nSOh*%!2Rz9wuX7LV{l+P|yfnKH4?@Ba2;0a=Xmh-%DNYje-7T zNJ-Q?{})QSTHgb9tFy*-m*ZO|48&hsf;6laPkSHzY&wme2tu2QOGijK@tO&t_RRA% zS|dGPd(_axL^-WovkG zZHd8UfckexCr#ZmojI35%n#FQDY;ZNDJI);Ah3*r7yDhIz6%qpd2gsF|4q_JO!JWh zOS_0sFpo8Ds${O=H92}GYl--q63d%1WIjL_1lSNqGyu=)hqGbR_5Xn!mK^<2i9HGl zax|mw*;hgG`AT{z0lSLCE7oIXaB2A0mIyP7eTBqYe(jtfSEgmgNb-8H~A{%>tei89c^)C6Dtt$%H zc#q|hJRQ?A-?C2LBnSK%C)}p=z+AA96g&8If7^DJjw1g0T!~0z2Er$c;5c^2ntM|- zjXZJhASY%`ly-9iXK!gZ+6m_BV3qZU{bsd3N0H_A9nC&AwWzZNI)-6L<1k zQ2B5=MuQ|k{kenf_!N!{+C0kBk-?jo@Gy2qDh%)MLkBpVlwDd>hvz)TAd9!rUqYfYM*KdDBCxY3ZjbLm*0$5LKP#btJpya%~=3`(@9yveE| z`a}68?(z8*Z6F&|n)d945R)fCSY#)G5w|O&Pdh_iapmR<#{Yca_hb*Vo!!gd>9xP)0R64j z$Qmqf!Ce|) zqg#76>fX)RVNKUa%`+QH=ASi)T;YiWk!hzzZkJQa5{X*>MmTXBjaJvN)(H_ENF9fme80*&sZV&c9J?&|En|A9FB#4LguB6{N}KaZ-YABW9l zUbC2#Yn_8Q)$F+mFdl^wn;F{F%ejV8EKUnmOfFK~X*P~Q6a*{i7ghEBipCZHam~r2#No(yp9mmyG{gn+;L%$6a?2_ z+0(;omKl9Q$)&;4dZrKDn3CSMG(`>w;2&|;zcfrF;2DS$UQ4;8S{ z#x09|Hv%&2R`t7r$<`T2Lx7K4@Q@^y2thv2_t@3SULEStnCz$oxw=Yx30V zc(wPaN2#^O;jWg!p-GCW#(IId3~N?OrYxG5d#W(Yg9tpFDZ&`Zh*!z-aVxI0v+-KWGcAZgouk{pb%7WfuCTK%ha8uF z8inD3_W%<+88h416$v+p(98P}F1^beE5jjyG#dmF*qMe%-%W9V9t4uFSj82!U#+HruE1S2zCiKOq|-ZY7fFt_%*#^ z*VaDVJ9#*9TX0eejnidr1OrC6GXro2+*#av=rnK)%l&G{C>jdyE%=X#{Anhjl+)`q?u4djWje3k3%U@izLq7`eM=XM^6T%L-(*Ed zXB?SbE;OuqCuS%|2NWmSC?xtR5&89s@>xh#{Pcvoe;rwVI*$c&pp(-$YV zE2efHzePn9+h$vIyz=yuH2Z1sq_Fr!rv8-j?!S53lV%L#;ipaT3Tn!T$WHPlT9F3N zlM?Bi!;mSL6KfZa6%H4TE`G`YV?YAg&nl`F)y`jGko*xLW1rcPsW8cUmwjQQKaoXe z_8;H3Ow@k5&gGg;7dbJY{_@J?z*y7Br^d;eqm0B=`?@Ww_yUb zU=?r%yw&fotui0FaE07~z=xe{U^y9y0hm%a3J#{Tc~0&<9o2dVP#>fLeED-{EugBGGBnqJdRTbSvEq zb)Wh4B;}J01?^Gq~ zWCbJMA?0mAx%0eSTlcH7Up0Yx_K8wnKTFhZjenYauejPx$i^KHLgIzD69b=ix~t;L zt5H_zZ%4w{EEG0hItM1m^Qb)w`PosowH!v`C0|;EU!Z=avJgX>Y75^F(iNA)hy6Kf zuJ&73ITrLt{%NTfua}O8ruJx~5gh)2d+S58vwLRs(6T_do!EzAp0G!Hg?5AD>bUF? zB&%b@>cHn}t#8Ti8r0f-%DaCW(VIt3>^3C zkpAXf4FW5bGTlAW-@rn=NM&}y)`cNfqQJ>#mcIhvG~a_x_g5cnn!adN8+lk<#~7{n zogEb2e|SDAa1elZn;Z)*gpM{{qW!l#v2pSJPXszgom*)T%J}<<38iPXJ!%7JvW-8D zKoIVJ?*Y?BmW*dLAE=g!gl(IZ&NywMdad|%VjMaCejwQqrHEiEbMK}#%@@W}%nb8x zQBYRJ!z!0+z^LbouYL?C>E^d506AbLNdp+3IAO{~srJDvLMW2eeCIJS&x?+A=DV^~<(*z8-lxqo)1k4fgve5r{0PX_VluA}1_E46JiF&XV=rsx z{_Z;(|ET?R!bkVZL}bd0H9yPA@vj%O@kSwIvpG4W8?W1cm5oz<| zqwbfjRje0kVAjt*J)~!}GH(&m$q9DPVtUe!(Nm<9>G4M#1Cu&Et%$TCKbQ-K&hhkL z-gDDJoAL#iR}yMoSxoobp+_q0vS>>Jv$x<+==3h5 zKPjJ31Tc@qNNO;}?>f<&>0P6LM)14OU6PT}uzUY(#>!29#vf)}jkko&kS@Y_@!(;_ zAN?Z&;u?vKWD_h=Ee1{y5b@4%M-?QxiW>?pYBIh(5I16`0g@lO-p@eS&vSzggjihj z|3GzE0PnkiaW*rF!ipo%mGqH{YrZ4yQbYtNVY?89l*g$xT)R_`&1n|LW*^h*8U^>` z%qMkbeoPIUBYsuXG$>N<6j9qvs4O!0rC}2yG=!u@6zlKklZ09RX=@0)@#9~EhW?VR72lss=t&w^W_IOdX)SCOtB;VWis-IVu(%%Va+i_HvMgsjO zx|c#nH|V1`Mv*iybsS^tUrwF~L-cy#=Aj?k-Id*r61S#*kIF}U-Fo`-uE>ODt{605 zCrXmUd{HJTUc^Csv(zBD#3gYMIZ_ssy=lgs~WZo^~87JPmxXO2&FDE12e+7ZA zSKw7gT-aXj-?FzB8bVe45A@dnlr2K?nmUOhOq<-jyg&tXA%hm!In|kra0J__o5fH` zz7d2hS(FGg8+pEYvZ(6}kT%&UaI7vz(I@CUE9 z5@J3s=*d#&#X)mNaPjqN7Ud}?*m$x4)zKJ9+UN!kTQALNlVa8Y!is&4xsq{qx>V#3vo?H0$ z4$c;+A*u11aGjJEdd3E3rQzL*@BhL`&c5ekfRKl-jwry;(NsL=wkuD&r8Tb5j=iO8 zeA)YL4%mzc2oAO>Rca|cPWWqtFrrV;CTF5JeT8q+-}HY%-i!QmAA%L?ugU$%3Hfv% zr{|Sr6l2mrb^y$t#t8^q&?tE2Qd@wV^$6T;dL)XlnKQsQ?_2O1G$p# z6WE1tA|A#-Fok6-9Z`rE73=pw4}KL*mOR(1*?R7^X9)w6M!Ke+qGN&z?&~vkqo$hr zp}r|#z)1eFAZ#)S`ADffT#3XZvAvx`Zg#``dRHu;spAd$Yy;O%C!g}7aN{09DyPkh z5EKAE!6Ob1aoB-%!QS~pz;35utbskTsJJ%S!X+J7-};T_-w4YANX+c!1St1p<3RpU z;LwTWWKaesnpOspv%{%sSZD{sE4=my6lZgsbgmKC;}U=_w+~{cn^V&!zL=FdTK4qL zbP|pH_^e^vR`Z+Oh6@uxq#1RMFi)wVN|V(W`u)Up*})_D1_% z$;{hq6m+CW+*r&o5SQ!Vm*8KKVmf@`Slt^aXuO_uhTmCKflarYqyNLwv%D7V+Yg@S zbi*HV7_4VDY)HMhfmDLvl+*qkk;PQszop1IDZ#JyjQWvKqqi-Cy2l(u;CG$ikT)KC0;^vjH z5I{JIICN-^V7-S+9^6ZJ)vn+$xjr*AOaf{ zSFiMdH&fvvYeYXiun8s_d06v_lduy^hYb7^9^6)Y{vNKgJPO5G+C0QTuc+=mjIVlW5k;+T% z0vCW=tV&5CP?!`kAO=kd8U_%JEN{vOJ3nWZkXNp3A^o6*AwA_Jy(d^TlDCz$n0C}M z5Mgn5Mw}p?*~!%e>Kyo=u5QexhgJEW@S@2?e|z$w+5?h$#5Jqlj|<=t_v?709}8__ zmoFRs{Mn)T_`;B?e0R$Yi>p~yCZl=^lq$gF7qQZR59b4nx_TkQ;eA|qcmu~Py;pCa z2oMx*%7X$&R4&Iybx8$E@vw*VTm`u2C!G5)WG5%js(Ruoe zgw#6+`kA9bxLwlKn0*vXm&CKDWs)He*QEY{3drC|5t@BJ1L?S~I$%TyB9-xhp87V)os;qUR@;y0L%Dq1f@^X->2qd=@Y>m3h(s@$%CB z0S1#KZ~H7Y*AqzDk=|b{Gv+Y zQ+8I_?enT+{cd$GUv!aW_i8vf+F$sD{U8Iz&-@X;A@>huQqecKYgHts>%!Jd{T z#JelrP7w9Q427M(rR9@zk9%hO_yCG)2JV7)VfaT=nA*|bdSYv}semTBoupX)&g@$2 zVQH}CV0dJj(tZ;AY#H)9cm<2r0EBBR*X|=YHi$g|NS;1P)A^a0`furVdzl<=c}%Zf zb;w=GmUsMP4WgIO`*B~U`Ao4?c1iC0LGQ4y%)}XUrf>;uH7}C|fLfQ$fYGGDN$>ZKq%d}Kl&<-#=Gw4jmo065cK5{$ zw1@WzG=$7dsf3GAX94XcFIl@^rSZeh;|DhcgzSAX18`*SwR8F!vN z#tGhlfpOsBL&*U>mIZ#r!))G;eE;jmI$NBCKv_ZjEM}W}F-J*%W(CZw$4b^Df-$~; zl5E2y+v1~$vkzG3>;_HtjY#XShkwzbAP%`U#_&d0_ubFpuiyDCS-<;RxH-8VFY*|8-1{RO5i>xI4Z%-UQLb(>_67hK*m^&%mGG#CxQjm?$d6Ej zy3~IBh{JbXw2ss+bD>6dj}u#3N3m0!@N(~HiN+E+n-p|>wE zzqMt0m&2S6(q5?ikZL3 z>v;m2s|35l94Xa0VmKt46^6iz-e@Ylj`WKR@EKaO)+PJnT-b1;MZ@B0v>FD`GGH;A z1e_K=T=CFkzrQt)BhkwM7kXj+n9ALq_yG2}N$Os92>7KoBcsT$$BvJ`HSsDW{Zvt$ z%s_N&B5N%_KI##ZNm~+XXH|Demvt9(znLBxY5T$RPLsA5-*5Z>fm(bWvhbnZg4D?ePwO?RRNmeD;Xr&5xjL8ZtRK@@51*s5;yMq0`H{>b+OI6A zS^)ME_tnQ4V$O1_j2_3LRWpvbqd0bG)&7wb4}pVCPrpc}g&c}J#BCU5V^ZUe8FG#` zP|Y>y?Jac*apmOb&pB++{Nz3YUF)s@7(@Xc%g3x1xMjPxMY5RRW`j0s=fV}Iz&Ba* z>kl16gs!S{0lqBJ4!h&&I)>!?PJf#yaI%mxb<3m zD>@9Bq}t5n@^j7LK@}AK=g)zQ*R!@4aXnjXMHv?tvI1&=!)UwLCkPC@y~Gd>_{3jL z>6K?|s4lgS}An%IrC)Nicq}!|TMI>D) zkPl|pW?r*P+YE%*wBK^Rd2~2bq@4e4+{7OAMGf;ku{O>sL-B_+L#YS+=4HHTa#_@ivN|b$_ap#)jN|z1Cr)*Vj(d1AqxVLcXZhjh++=t zF$NvlN(8zIkacG+BoA6AfKMfUga2R68+r#5P9jmjNi| zqtul{Z%rYo$LAaY`v`HECeZ|a%n%?hw?O6Hb-(m^L7~F8ZC_0K`_YqXQF)te#dk8z z5AvbPFnLP$d$P->quvep?7H~8Lc2k#>I}Tt?$Gylsq2|7KwDfJ=rTf!uCH+jPJPjIdhHcMi5QC*jc^x#0` z+L907;k^i*-;2M_pZZC)&XrhyZVVx%T-fP(9$a=VM00EdpDs51Z}lnuC14OJ?Q%dB zCFZnR*S-xF|3}l`wz~R@!PlgpZwx;DUmDB~9owMqQN->ar)hP*XwtdwTav%Kbhjl- z6)DX#VpaO;4Qiwid$U=R@*a5Zvbo_STFJvRD9&L$)qea7g7cc0{BrI=#Ffs`(a%RG zQdgvyFXsejmG3n%qQE$3wn?1KK(XX|cd2X0vx992NdewOy#BAbM*y?m15jH73xKvd zoDQ<|U!ng#icpMgUSY+YWwmMW?4tTQAH+NvM*ei$J>yaQ{WNC(FD+)Qy=oUs54*If z$OSd1bu_|IZumX9?(O*IHc866RhtV`J@)FK91v5YaOIr|$8dgNl|y(mIjxOi_TF*? zacx4Oz-?89ds6v^664&5Sr#A`7A|b~BU_=FERlg>Aqs=wpEuNA{2;5injErYfm2H_ zM5*iH#7Ux$Um?(7rf+A$S#Rra-?(;z()9achVh5GG@jtzAK3V7%Lw#`j#)nx=b+i4 z-Bi-}{k}{PmDlkwEqmY!9kT7jC8_X7xD+*v2m#*o=Bxsh6+Ztz5Cg*Zm_hc#vf@$v z`pcw+VChoTD{irS?m~C0tnY(_DHBUDK!WOHfZ!$~Z93=M_I+=+y1JQvxSif9)v63) zAqx}ZHuHgZl%RBw#W2X^9E)Jw45s^ir^7*_R}tN-N1sY_2fDmXA28-I9C+R2p*n4MO3(Dj zQyvAWsD9D}hzsMrGS-ct*he|@SY0_rUL~Gl-E4m=ORzZuZ^$XY5~=ol>F9S>gKY;8 zGFtPVoVBV2U2k_vK+qi{*(xbvkfzL1u~79{E%-|;o?;zR98i^8p zWh?4E8nABNnBT~Mng&{4ud?l|#h0Vnu^w}2&dR{@u(?&pt`)FM4A^?z@hoO2fQKFk zbFo*Q)`CJtucJJq8H3G1`~Lx2XyPp5GUmgl6+j@*eBQPKCcvj&#Y}&+W(I2s$Q?=; zm$HX4g3~~pyf4qHgsON!cNw&8(ViKPV%dDwOJa6^j4x$~w}A@wtm4a*GtMdjmOaAR zSu0mRY0gTA^xsg~8--IFGT$AQwly{{zxyE&ZxyE%j&c}4)>ZGTt&e`i1+ zZ(L(=22^^;vP`lYrAl;J$_#&g`m5=$MRSpa3Hc=Zm6Yy59TT$z-9({Wb zm)=zO!}a&~PNUzt<%++#bPV-QWQlzD*tZR;nmDn0cPo_FJ5*I&<-{7Rcu+_(3V^gN zwUP_~Xm0vjqE-;su06_a8P$mLo4e%rJwAaq#Za&?4xLq~_yU41U(z~GJ0K%SHe~(p zdWw4lHgQ(%p24@q13MHeY?lwwcoZ_iwApW72uK+@e7lkyT~?h;*!bt~qT*mbpI{=El@NB#AX@)&ih+x^eR@1x?1AS2UIC$3&)vsJ)(j(s@Iwc@nEV_q;r zWp+6S_LwM%2BR1;hrow{rVt+O-|4w_*-VI8w{5pPe`rgr>62uR0bM+k+JUy;U}U8{ z{Jt;b!^U9)?&CxRa5En=3y?3*W)`*V^Sg(QzK0H_IBVi~pMpI4Vjbq7ACC`0d~o2A zlCx2$7_ok5lX0Z~;`lH3eGQ8?6Xr`9cjcsFNAK~NVs6#f2||2mviu_JyBx`1h)9w+ zbv}f;Ag)Zr<1TJKdWHT$4)F5}2)(XQ5?x>s@y7T*gWN^>H*A7j(ZL%*15ljRG|SE? z0m%dLLyGP}1$zv=2hj<4rFC!cGwQe;1rC5Q|L&dHL96u3Y`5l~3ck?}7Jd4rIyjJ} z{z82{4n!LZLbH&gaoGndBq&V17jKn_>%`h4G1e>*`Hr8zy9FMgEP9ve*nVwlJ4)Cj z=CEb4!-p!O(rz{Ens4f{0?JfIm@Xh`rYAOFdx5#&rq2kM;q~T5<=nsx((J9TBu50R ziZT?#3JputoVId6l_nSs7?jye)_SD570|HKF89I%VfQI1J&0PE+jl)3_!m80Xfpf? zp25YTr7LB!)_uat`Br@s&7&zk-_`9a1x=RlLTtN;Zk;~-30aAf-X|4+;15M)0_V9l z+lv_2Nc7pBYnw8KHQxC4c*~-#p5dW{5)Fgng|AQPV{-Ap;uLH{xR04Qg)wUX zv#`~cwQY1g*VHuZ5pCX$s+&7v*OryD;!77w7~pq_b_7Yv2k4Nn^{_QRb+*b72hR== z%djt@Z;%3fPE()PM~-?Ry2mVpNdbg#N|7EH_3LM~>FnVtX6f&0q9PRczb{aUE8pOe zO6qSTe^j#lc^29HnsuH*y5S{fE+jB}rF#_IwmcleI;_XKtPslXGyM5y--jSwl=jFp z-81Qh7G*jCwwn@IhQ5G)N=m<9fBK7EAiWAdqzSL{A}8%Hg!aY_;ma4wjc0VKmJ@gk-uTRgvJD7;V4uj$GdTk8bePc&{3#|WYsjcO6~ zU_n08whbHv)|%pMY0@5G8#SaV3UY2lRM|xF>N~3uqcr zjOJ&PS(>wMFb4ut#!VXJS=UWJ6R3MIY`-anKc{t zfx8hj0E5B)XnNGVX8aFApmgL`d=6j{eL)r78MkoR8oLbuYlh zhSoln;Ld8lX_Iz`;`)nBuN~SxN6mZO)A7NPPcKybzJ9mJnePULG-(;5o!l7N}%(x5UDC4JAO)bS~^X) zPTJt=_Z9PTBKmnxG*pi>XE{lvkaKl1CE4piAoagu#c@z?vI`}b$_;ZTO4g8>7Uj3* zLxVU>Sblf%*J=od7VZA3s?u2hfH5hOB7m5%Gv!@m}kq zWZq4>I>`=`lp#raeGw_`=nIU3&2>@F6%?hOr2Ky5dlh>K>FHims zHkTtFTCee`@uk4mGHSB4V4J)dL)OT3PDxX%G%hlB@HBng)+I@0?TA2k2;s|=z6EUPgpfpkBe|&%qQ+)+di#TL zbTepo&gD0im&_V6F80d4*4XS~$PX)OKlztnWS#uNh{@ZzC`5Tn1Rq=Mg&Hr5f z{Lb=GLdc}XfK5c$5wPr$1rX`s`q#|QL`3Bs0{{dQx`UXdCTxI3OUG6<-_Ms*Ftwg zM9LNKwU477*Gkeg1%DEuedg^0if3Zz(*W-5P}p7k;&VMAU!L3h8RhjHO8)AhfSjOQSq-^j zHx}ib-TK3yD!C+)TJZFPWdNOb9ni?uiMh6qT^?SvYozkmo}y+*F+{<*{g&!b+7GOj^C87W|Qp#m;VnW z1o80eF~s|yVLJ~fc$PDab%t6-xy8YUe;vh7Hll9D6|-$U9AvBMdrVvMgD5~^_v`1- zlLBXf`N=*AyvgR(OIfRT7a1nx2kFh?FMl%xncC&>UQA>xAz>v>EMmx=sg~cYee`mChxg*0iRzhNkf{jYAL(|I#$HtMVO1r3aV~&My1Y8#nVYbs zPL25c!L5$;w;A`x;MPTrRSRBJH$K+7HLvi+TT)-O4(zhG1v-%bQQ+mM`S=e+BmS58T8~9HqNBxae^CwI_=nVd zretLxVs&lPC5R})IJ#;nNLEcIq%2Dk1HU3x{AigIKj;jBzo7&~Jz)I@*fdJeKxM4& zZKS*ld;&?=2=SQ&5Opc4&!J4NW4DtdNOrDAoP^fvkmY2WxG{zc*dV??&w=(A-3s2d z=sB1}ClWvGg6ABHx#69s$ib8$?f52ek}mIGX3F3J4K49j8Ta{n2VMH>Ya#1#NIo(* zB~?cNw?K%&hac=>wSiumIZR`7+WhE`{)f^>X+q@YE4)Wu+qXUKITxPpX7w=w{cQlK zJ%v#a-p6bVgHei3b8ztbwUN-tM%b=ryp{OPEgtsDc$3K%usOw!F6;Dlrgpqe5CKNy zMk7}`G0)3!tpk0JJDvwgow&|qYwhhl7Lv{n0+oS4Xj$4aZ<4ZyrBb_wX7z<)hWzk$ zjap}=USJv7BHt#EG2fQHQev9+6Dy}bQG>8S$tBy6oK_;DmQNo zFO9nl$r?uYfl{r<1aMQ;zJGCC^S2OPaz29 z@n9Ddg0W7Fy1F}One_Q{&cDv$C%wXv*$P=-l&U_a;S^W<3Fb?H6dXzy5nzPt>kfSF z-zU5%)sxxGjS{l;C3o6-0bncMgtn~8 z+$#h3D0z!BHzl6ifAUBj7vdJC+$JjHAeit23WgU49hw%_y*iR}GGYBHBurNDM5ciJ zZM_`yyOQOvd-qp${&Zoql%5Lnm^K1tQ?j!s;79evE;uTs|W`VH-LgEDEEUuNsU z;&}UK7Lvp*=bnp%WTHwm-fr;j494Ph4d7$lNqZl+{^q9o`3uR*>X4H$3?l66sl?W4 zb?mvWv5{GuLke}KU+@sF0n_Zj-!4ivTYmg7-+JkEeA9y6>c?RPKVzBCw&71xwZk7W z3C>J_P1_J)R@iS2Qj$})0)cJYz4&4pi~R_<}Yw0IuuZ3v4XTR&pWx|9Pa}Jdl$GVe8%$<;Akua;aDtfmBZ{ z$F3ThWt;088_|MydUX>ez=uL|-kz5tk= z#~IQnspyL?d=4>=4zIr8ZJY78dR+C>-%5kUO@O%F#>7-r;%fW+4b~vz?`EGHrLj*K z*wyUDb&++5)-exin;Jue_YPxJTOv`_y z8y$rF8fRbUE6KyX(!Gw1B2l_#l$o_Me09RIbF(5U4ZDH3u2tiSye*teV1f3R5e1sYJ7U)Od107 zs!!XD+D*vBGm>d77M6k9RCSo70DBnnf0+6ba45g_|B;wVsEjOODzaot$Zk|$WZxBj8$06<#V%rJA=mFGlBw=1!{uixLyZI>Eln zwc#9N5B!0>>$BlLBUfQi)*3R@mKYX_84n27m>jAd$tK|xe_9quvIsw8l`mluySTDxwuKQp)dfsJ^Jf}%b#9oB9d8dtHWzgDDcEyM3#6R%1tke^EFxFdd{qgNaSC*211c=KJA_OcLm^jp+yU*C z#_*DAtxcz?WI1B#d<}HHfB4RNXM}gPJ39fATxz8+0B7sK`p6JzT3CsDSTw1hhX(9W zQGeN?=A}8|`bE2hRpYcx_aooBwmhPthW50@%(4`L0O;hgoY*fYLBItcM;8ZkI&_LP zW-i6`uC95)wB#P{Z$ofMCRRHas8#Ju4ic@7@p^P!O zr0y_|O(rd!U=Tgs+B~^BUt4FY$hP|f8|wrZdYID$dN>wbsfvx8m|Fi?b$rbM?H!om zPS}uDG+@5-n*UU1d~2d`eMT>4&CZg$A64bN3{pNkoh=*}<-J6EMJp@GZp9YKK$S$M=lSgBAl+*F!3y<`3cI>ZiWz`Jre#0 z?}nZu4cFp7FGlWx27m3Z?RyQPZT`9?gD+}1d|zD)HQrn zu_!OC{`0z{$xoyf^LY$wPS&p;S;edDje|bgl(A-HB4QfA><1X$0|Ii3WrzHl5U0hg z4j9h4)s5XeZqp8E_YN8_4nGd$#ZG`owki&=nah3Wz@E@5A>v67sDMWD$Z^Ko@C))- z6zjgyFvZ^t|J{{g09HiSPf)2i>#S*XicZQ#;d#_>BK}LkMB2Jf6*!W5JIkJ9(PXhw z6J^Wa7O2p0|Dby?qOK;FHf5>}4f3kP+47BXGbQKozfCk*)AO}(?!9^u)T(sNAK3RW zjw;{_)e)Hn%XxUba+x@x!kxd58mV=-fD$ z2wvK%G+#Zdss4?#Ok4PQ}9Cg ziFGt+1DSVUQwQu6Hz7q{`3L$WB{q&n{aZAWox&Ob(V$Iv5FHrizfB?@JNQU+C*(|- zY5@sJU=5*`>}ys2z+wjRYjQ;P3A`V9T?q#~8GqY__9BI8n*|}IfH!pb%pcgp&`I!G z;77`uT&D4Hjvu}Y#YhJ8@g4ZRiRjCj-JKeqbo4wJH}7SJ=p9R5+X8A$E`@WOHELoE zp8zu)_>#CWXvNz0^eIzaXqZ<;K!aMZh*_Dp z9=x{ukt~;)c+wgNLVR%+-#G^!~b_oeB=Ck*_8V3jA z5Xp#Js$km6y_Z1bV(=f>V|bJVG``pYb(71K=^HYB{|>3@D0qO1OozsG!73>)uI9b_ z*w9nEiNacXzM-nFd>84hb-w0KZNpj44~+1hPO?!e!%is90l^;DqJPZfI!OLmArG#I z^$$K-&eH+4CQ`~M0fIBA=4Gy~7*9ncg%hgBZK;KkSf8Cxy{>~JU0_UiXTe!Z{u$$u zF3@NN*hb1+P?J);+HvS=0H0Df6_ALUL=^WEg!#T;!G^zuI6pCpy)tof9aBXG(3CU2 zNt_d$U2nuV7NPUBnfrrW!RdCXUL%5id=u{-auJZ{+`zxj9Ys#-9^&frs@=Kch*}jS z=iPSdS_k@ChL(Bj7c5Xj+upN=@O8}a=6Gl^?(rX(L9s&9qmH`a(s zwa6HMtJkvCpqls0*nfPXE(5RZJ3j=DA73^$z1fxyh(aGHqGv+=NuQ+Qa~H8xptogA z_fmRJ-p8k&V$JITnRvo9;}J@U+E`C^tP-z{$;~ZxWhr(#tS=HMJ1zrZ=MaC$Mig7_ z-_U0dp_VZa(vU{kWsFzqZ*jr@lLNKL@!?mpO_=lutW_XSAmZs)j1f;|{3W{)EAzw*5vm^J&6l@yPsHDK`*i<*3)LT9l)G8s{>?d;* z5qLCrV&INbyX?BtNtj_*`vDcIk04^aROKVMo(;?HeaxTXzRenDyUpFXYa@&KrSvfZ zD3|E80GQCtwhn>HfMqa^NG(r=)wCXv^)~V5Q_d^U?2F`YKcEh(07vk0N0=7DU!}J^ zk|@{v2+)&xi?_*9tX0@1#do9PJA7=zGSH>_HfKm~?Od{#TOQfoy*y(EH=t*@^kf*c zsb@@+}wFPZ_49dpT*f}G7d zxAF?qVVieaE!wv$S;Mr=1k(xj%Uj%ONz0cBj#jkft(je5t_^!6MZ%nK7j1Lsj^tnO zYEy2Q=}TJP8sA@vvNp$LA=2hv$DD+6mY!3pwXXa8l7cEpU208rCred;tkzpPq zOtS?g*`I9&2r*0j8M73=n7;HPdviq<%jfyq;dQd?JjH0tJ=^Twyn=m7GEPJ{m}5vQ zV#v{3GROIbiiksZ>eZ-({_NCDr=AK;Nm`VksGIH8v`BC9mhaBd-XI0Kg7c0V9b}k8 zQ&M;*U$(N$(irfYCzZF!8g^M_vT~-49d}C<>;rt+*~-6^`KnuuX3Y3YWq-nQQ$c<& zdcoe^Nq33ek%4BhIwRRFwDjV9W5*~FnQh0jx!s$BECS8;e%|JMB7cV6dBZ+JB~@AH z$(+hzJHtp%a}8~qhQh>^88e}tq+VwhJ%bMsO}mti5F1N-{7O%*{8>$2k&b^y#oirN zCMw6bJDJfEV6io{q(Gbg4EwdhO-n1e4?*rPm%w%nmB1k&)laB`Sp?hgs}DD;t0S$o zZ8s6LXDl#V+-x(uNY=Kj!c9ac3wsrnAhTxuoNmX!u}HD()SWXH`Z<94{QF9dbCL>R z!Xp@UGy5JU3!T8=tqpQ)omTQc>fBJyfo0e)-@srJmGjrTGGHpg>Im55f?psV{Wk5P zbREZrqem4Jm!h@I4~dxXQ%o;FbhgY}I@wsFeV)ZVeO{O7iekna~-Va?NfxUfQsMgA(+gZqn4(rPMx&KqbcTyyHWS-^oRv0 z!bMiGQ2aVztblsQwE80VH0u2FR|!SBU65nv5In*iF&nwzen~bIOjqnxLgbcRkXb3h zTU#G8I+Y_)pwvy!8hZ@yPKC--a~wB0)6z@zC_1q6T6(Fbzd_E`NNE)wrZ6?k`8E7? zzG?Y|7@N+XU1Dq9V3j_e^Mz_M1m_H=0tu+0b*faSWhsB5NTDtzm;$s z<`ik64BW#zq>Z|IGMyI3lC?%yv=se3Qd=Tnv($8oO@=+-AmVxpiHuuFmXHQl1x&$h&Rg30O1bzM2tN2rQ?THX&p&8 zv5@e|AJb6*yFNvPw;6h*-)xsmiO3)R@?i3vf5S(ab=Sc{W3i-Eg{|AErHXu0nMV=h z*lq<7b0P)|fofkL z;UhmpT_GpQX|S8gT#ugGlW8;XXs+w6{4=3j9C>MKvAcHJPpt)I8!kW7%9||->xwq) zX_&DWGW)QWC$3iXIrcmMLa{Mt8ynnlk_X9}0}?3$icBJLp?lTkyst~e*QSV4PSBm|ed zCG1ps*}HY&?X*_Ij}s#=SFN)Ty$vHgO(u5pXvtb7S(YwuyLDzu(Jray1_xRdmOhLe zG~bmTY}&BNcj-L~#jB__XL4vA1gscs{;>MNrr(1r0o!*ZKC~-p){1RTQ!u*e*T9!d zuh=PV%TxKN<0{1zYFP>~YVbI~yj5ZocqFdS1Fc|t{Z(IQ`7wicqh+n{2ITv|E2KOvA5+zSv9*pJ|tBR}AmmGHX3~y|JKG#yP43 z(WWO^ASL5cnXM9>>BujjY4S48A>LFlomz&~Ai7lshz}15t@hlBnHRc7-E=G~@B??Y z4Dgp!KRuwZoP%^D;!x6S^a%=A)9*vx)a~Kj z55HCWZW6vj>77CI-4XCyTJO71gtL} zsns7q<`H+MSu8)nUPbFc#`&?_rDQr20xC2DZG$&C_#DP)FIu{7 zYMLh4W3<15WhAuCpkUo;-i+$A8IeoS&k@K4$s9$zrSf#1=)m&3QpTQUm~>cgYJMB; z5@cD45w%wq5@}Zqvg$8Ih%{!nhjm}@(kbT$D5Hg?n|hMwwn?`;9CaF zy(`ms(-s=o5V|jSUv^qF@QnF{MVWilMjfL_wVvE25$=u}T4398cvh&pAm<(H5A}f!g7RV7@(uOBGBd-Y$^KErq4lDN_psA8%bWM>uXu>}E|k13rQ^U;*9l zuar|snItupZslI2OFp<<6YqZfN|8LTueRD?i-Ti~nx&7e=rg|gv8))hs%A54$fz}b z8nBLDmfLey(5^7*QfZk7Z~PLpeVv4;Gib$v%Uauu3+3>Wo*|!! z>winfu}<}fXfu&*Xtpjuv2MCseuJ9`NSgTmaN(%TWI^&Fp8*m<;l&z3Qm(fA{4~u( zJj3@7Y{2Qd>2oj)ZN5JOIR`Nj_{mFbU?y#pROUS@2e#!$b7ndujOU!!xOg7vLPy*% za{UAlr%xHdK_Fx0|2|j*8gPcmlxRc!+kn%S-}r%)nFOL$0Rne$hFAaJHoO9y=xB#F z)THO%Pmy@99yK5TMa;?HOIQPZ$)5Ir#rpogoqmU!Ow(ChS02+stpcNe{^o)a(q*En z!=vJN120WyiON+A0E0Bq17eUs=7NJWe_+c_Tu)$^qoIEDhV`5vE27UD8g$xWH0A$> z2RZ0!rvzD}{xb+eGn-7G%lA6VRs5!K4`*k9OG*FsnV)sC#|W@qrs3y6FNS7Df=yot zwFTO>8M=O!XPxeWf$yU?zTXe7Kmg$2?#XToZj^W7=TzX0DF+o{$%J=h8FU- zBX*-t;BSkg9r1;TrJEsPqo{*9C>ryBMct(65HN`)@e`vIHi18Nom3Cre!0HwN@6KqEz-%(%2J>(cgMdZ@umUxCzT70*D0MTgX>M zo|=XaMO$cRSNtY%54*-Xj4`Q+dm#E@JX2Sh_pla$>IxlhC#bQ04Sb=B!(1GrhSK*dTOOn?@n2lm6*#jVGI~z5 z?jRq;cy7mwUa3yRH}rFTr!I1k*geKyhI$7fs0DJHUKdj zDi?UL?CbN+IbwDI-UsGY`Z=V)n8VNBvN^T>C1$-pnhfq3nnW$JFMI~?X!;MYeLgM0 zvgT#&h{lThupw?r)lzb&k^CU3&0_~~aW?q)Y#ui7r*LvcCCP%W5`{@ z$M)D)zPmc)io4P1;EdYdpN(&HRj7%X(2HHXcJ?9Q!|W?mJbrgqM8-76*#NHJ_zK*X zYOF&}lDT3a*iHCS6t-QnndJ8_BJZ%z7UwC9)k2$N=xik1M?-ri;6ABbBCcMT$oKT6 zRK-R5s87FT#gW$QBp)fUT_-+8TJoo4^s$*tkeE@J@%|jU;MJhR^RwRB4o?Is$91_g zr+40O;fr1affh@?^o0r~uC~|QQ>Nv~10~Dqp3OmHAHojmzWwnS;CP1X=b&xcC1=m! zKH@Z9dx@G-G)SJ8Bfq!nR5`u7BMY5WB3e5*xlI>iU3f1{<+ywMOp!B?y4Z0HeL2HB zz|=_~|4>tzl#)VBw9Iyxz3&%rA#WVL%{YRV&R`W4{qjIm)V!(bT^>Dt>dsL=yqC9B z!9)4XNb$3GE%(ZCT|ZN*(wjYL^Ij}8+w1wRBB$E(`zMl~Z5vdeB=Mi7auK&D{o>*) zfaeP=-7p24qUK_sCGVa0EIKs4;>#?Y0*R@LAu|@yPNtb`6ekFKm|e$|>!19V_Ne&h zTi?LXM-oDxAN_Ie*MsJ)HvY`th~zC&)Y332Sgb?Z%}72qorH5wg-AQtq?VLD5lR+s z99LbPxBKtKZ_}_ivp#XTABZscc$`iEKlUguom^|;ljii(RIRdmKJ5_VKz_omHBZ^s zq>jFFuEBOWZ6GXZ>`FiER{SJCog!szmS83(B~SP@=<22P3H zbB2wkli=eaVr?1b`C;*|>kiU3LLN;*(rlDOtRSue59$kNpGNX?&i+Y10}R zvYAxhKYa4xgz}Xd->Q>IL!042*2De$lCvFx^&VZODi}9FZd)7R^)WHv59BtHjS z_`jAAdXT^Kkx?qq$$dP*RB8sj3qMiZHRPLI`ZX)pyE5#{>(`%7uwLJ}bI5qdft%Nm z*0-frNWlBZX&#rTjR<0VKFz3qIYHi;pgFH2#%lKhmRsd6-{P9*X-ft%5&_u1N*%g;xd=H3pj~J#6%P5A1Pg>EGv0`es zy6x!2QkG>+*Pd0xeZKFq>a7(SykPph_r@+-L@-5rdk}%U$cwq4LPrl7YCLB0W_TX; z(QG6~YX~dGJg|6glG%T+*0H~ma+PCB4)fpZkcAF=23!Xke9MaUjy#g4?)m-5VQISA zD6hziCVMH|j}l_X3VpI=bwu!Bjm3jskOHr~;v7&uz7Ucv&X{##6Fn!DLRQXOf9q2{ z^MiPR9y@I6sUd1#P1ju}Hjci_>4*mXb-A z>HmSAOP?SPJq03Gmi7QZ^<(l3fMOdOH`Fz;N8M zNdIPh7Tiy{`)=$#qsRKm`~uf%8{d|bMjqaD<8t5L%p_G8XzLR-7u**cV@s7I?_U~{ z9J`}Y)~tZL!S(zM${Z=D+53VVqLT5@N;U9@v8GpjFs|kOZuRW^%>F2RqsAHJppk=0 zgJD~7;(BNdvcUQR?(W#gf%{pl-0@%Yd7e{mNZ;ra_{9oUp6|pWTk&+^9+q#wHg|0L z*zW#Y=MAT{S0A*D1<21R&73T0c>wT#fz8aMmy?T;K_L>&YWT^0>=eA;9RBS3-W#dqrd;;KaX>P(W-(GaIe#+R zaEG5lBhrm2Isn7BA+b6pP%{d8Wakd9B;n)ZK#1y`P$=zbF}B@$xGAGBDih&1KgKeKc#DP%#@@`(5 zKGFTT6g_m}&AFrdy|7Mi;9qVvZVr4XqK!s#?fW#b28^E8`h7iz19aN=L%+7)TDn+u z+o5+Gm%~fZbr9i#4LCZ)j%kW{;8pj!Pd9vU;QkWYO5t@|Nm$weC)jMpiBw`Wgur?+ z;#xcItb4V|ZnLQD(wr}-PMPQT9p+`e{rc83(o?yCo^)9CdqM!n2Vgk%Ac!dn7{+wx z@srk$ZqSAg-;bW=~W>*?tg+p84yz)K_eF(c7OIOLQtmxD=aqe(FSGY4j z(0%^Voq{*zhf$-^UC-o0cfAUWdU#ZFqJKJWj?R2fpN=zC=ic~+Rbkv%Y;j9_Pi_r*afW*H zO=Y_Nt|>Uid)x`R}zF}d% zZeWfi5!B|_wK80&+qXz|*shBIq`>Nr_@X4{D`wGRAxbU`i?Yf0_vT-fR&3rQo9{f) zymzvJpJYpP`;EVk=R<>AD&9DCt_ZW-LyDa@sfwSQc`Tki=Dl@k_t@`!Y3>WNF^w|U zh0pRb@!ll4kY*bE9<&J?(3#r_?F%{GXVf2VIgSbU{&CU{sT815BxNjDyF*2QsLLiv zaQBiJP64r|%5UV{aVDL&g!iw?gqC`js$Ho&!5dgt$0a6%b6Xz$dmfrs2jY6iw+~Jh zb(O3{IA2Fa?~YFu`?)o-|L2qBtC4$avd6l&YWU}$xp;5)?Hl5!ES;?;woOqcbr>PW zv%zTg&W(e$TgC#hASC@nEdzS*lm0IFnb^_5&6)WRs+(2X^!L}=;yxqGs`bGhC1eZI z#(_5o#TUYAn3Nd!`Czb%Z32QrE5=VAVPIxnZ5RaqY#h$fAP!`XVaSHtpjhn`_6szK zhZvlO?#OCGyejZfvvQNO*ejEYGo@#doDd?Y^raAuyd5?2tyHud_!Fgp>B+uA8U&u@ zFR_KhT=4zD7w@4@sIq1TR`?QS;fdw%u+7~jb+>q1p{cxU<5nqLpTHLwztw$`d**i@P*NT@F1nTnxiSGHLi^03DFC2)zaAP#7OkB5`)NTe$e%8`E5G@dqn{KOjcINPXVl<~*#IBdt9)b~McZ^#k+v z02U={Y)*RydZR2(d|stVp0$|#rTU|bbAY`iVtg071V3_v2EY^ThPqlO8rZ-BYkmqL z9T()vFNgJiCNVx{Z-M_{q7&e}wkfdnq9#+gGH^LfW&k9z@&8TK-s4hv{B_uO_$#7Y zS>WCYh`a)z1q}mU9TVs0Z>tBrX#7Ir+VOX;rzHts%kh9lfyJaGPVY zZwjJ|a%CvMzBls*2#34tXB6X;+#Y_S%m%&y2eq_xBL|N+*LqSt4k1@1@sMI<=Q>G} z7KH}EKh4S^;glrq1^fcQ4Y+nl#wSy`c{&Av78_=LhQQ?r2Wt~HISn|fmyy7#M}r9i zK?pPz(Yc}=(i#bS@!ubmg++^tL&=Z8#j@0L&2?n${~mzjn@cAE0C4|9H`F2=%>M#s z11uJrUoqM7 z2i9)Jj0C>y_jo2^`}$J^CS!4pvo|8XuzaQZ1jiH8uCByti+(EiAp6;lf{l5(*CfRzyczbFta!hz@mGkx^C1E5g%L9`wG-v@e-l#K;) z>HheJ8=eLQsJk;dl}Wn3wmRuW0g zi$_OWv0b69Opve25JC9d03whH25Hb)f7v&)X+mr2e$whstZSVB35p78&R5J2wPW8k zeDGEx^wCj|i)d!)AeT({t)ByWq{a1FD@Pe>cYGz!_Id_0@dNQchObdTV}A_8>UQE8 zf+$AmZmCu6kb;5VUejfLZ+PTlF7Uktz_gC*YiJ z%uA$lzmmaiYF8xJJY15Of%3{87hXnkVF_Fn{A32+>jB997s3B;W$4pOq9q#C`&C@T zDocmTO(Jf*3gAevE*l*vo@QDgyegB#=HHNi*K*<@nFVGrHvlkmY(`I7qppq*&f(kj zI#G;GNJi1hRaD6fd-MHdIII6q5QMpW_>e!gu(@X6P~nhD?mCQ*Ix z?gq7mm<_=2elYl}nzKOT1Q;7wV#L|FK3C5s%H&V{8!}ILiNv{H^H&RS#U)rrkV{8K z@Dlei2$`{4I`fr`i_~ssp=d+%c zeiB<_V-Qq-HZp`Jyg{2Ha=^)02xXBosljj@hR6-I8+P82V9xK%51WD&WCOE#thre+j*MbCA+h|1M#o zqmeCgk#XeioiI%0IM>|gIAeTrl)?=UakWZ7j=ru!epFs3KZeS_W8DB-2=eXtt$wXp z-V;6c>B6U=!jrrQng@1z_!=f)27wG{wm4eiW_`2?(Pz@51ZsN2|N)g94)SWO;U3cYDam^!jHWQyT0sA zO&L&lYVSMqe8?d0?8RFT^}Zj@j5fJPj;@!-Hv+8c^5VU;w+fJO!qN8^f=4kLeckfG z`*7Z0QKRICx|(GNb`Xw7)Yygr-t$ZLC z9@1*R>~la}BOIhhJp7dE6S`b@aJkNUoPzQz0K{KvKSFz#c;=cI1mt^VxcTWh_-iQZ*DXnc1NS5v=>aSM@1|D+{8RD zL0#NBi!)>^(E|k8SG7!EmS9|u^mV0ekvl7~?LCp-e*G&|GG5R7z)rm1mHb zdg*(TxsuM4f{s!nk;ZKA*>o`|c&Fza9;A+|G4C&EtA;7l{1zYSJdD9{XTfFdX(969%O>EVoTC@vzRGDnS&>zwT37Ty zy*UcG=gj5KH;Dwlt^OdFDOWKeC&0VQbwCn~wIV<~|CMPXAdt68ix9I;+lla1JG0ZI z@uP+(?1Id6VPGZ{$4}5Uk6c>*;U9aF3A{r(ys=hnfh4OF<;`f&)J*7Bh0kxO<+hxo$aqGhKe zJO)rmiDQ^#H+JZYQJ>O6BHwK1Z1`@V`7ysO*GnEA`5x6_>_u3@6H#wZb+jzr3&u+T zp6%|%205*y9**I!g>Rb^Zea$`TOki8@lEIaG}C2mDZ1Ng6vY_l9>Pa2ledMaIxqt6 z1?b?#*hXjld^sU6+HZvh8lWpe8}DtlM!*hVhhsB27Fi5Isspc3H(*HL=hdoocI@u^ zEKxN9yQGpUOWG;Pk)Cq3{S*K&wMe`2H{+DBLT}kAO!Q=WtJI3?+my-H_W7n^wTrR+ zL$s5P*Y3Z!j_Ld!=)wA8;#2Kur&N33q@&zPA!ij>Lo3q?Eq+GP0>-5Isq3T8zuy%f>!%AXDjl`})bcQroKxQ$EE?75EQq zo~PPQEA)4lUrpG~?d$miyC8hyvmHtpNt>!rY6{YOj5U=vfADO)c6d+b_kSE51w~hV ze-Q`ECd}jJelXfi_h8=T{pz&DhlZ3HZuxMoSZ{NK(gI8{=;Ks<$&Zo_Z-`CWVWrw{VbYW|3*$xp$KN6>EQv)k>a zaX8nBu{-_MXN`EK$Zu$Bh<^vaoeg`teSAkp;&c@(yuS!5$aaxvM8-f;Y**Q}Z}7O% zA+Z}SpOaGh=OwDu_N)1r+3z+wMQ+v-YAZU;Ie!YV~Ctj+s_C7#o zuEV)vFRi*O&R`89=sai6ur^~xEOr?H~ z%dGg~<0OB+_$y`W&D~*UkwZ<3>WB!tFho^u(ACAucRKW@Q0=Q8;9nzSt_%aZihV zc;fub5y4UQ9GgdN9}9+82T#C@^k);N7u)OJ5NyMoe@HErRy8Q^b^v|ran z4(07Tbz5fpD$1D7uS;CH3Fa&B-f>nm$_k9l;wT~lt1x|TKQr9aaev32Td z^!L?5cq>T^@A*0F91VDY+fdOs{W^9KtIQyA}joDWacZ5q380%UbWF@B`q!Acb#&-Wg>ky=#|b^SrKjf|JVLo4t{w>wef z+td34+u%CYf=@FJho2faPE;fox%u0vD0L^m>Xg4bi(s~{6kL#{y4ek`clFopo65Rt zWZLV@KhP~^9*J&Bp8+w5iU}|fps!NP!`$$GE!3uM)~aNU+Ge-qc7<$pe!HfRd+zJh zqNO~7;c{-%>&x9T-J~$vb!S*^3Wy-OLod}((HiM_@3_emaVas(c_l|fu2-a7Gz^`S zv$-HI#fI&;30E#QmSne2_Bm{#%R;MF)*F_u->MFC+ys*Aq$XjufQzD=o_1%MZ8cYy zalRnqWV4d{SYU5E+{DnCm9r_u*r{DfFjBUM7JnOi!8glrGUVY9 zG!UA$WHEYNjbI@AR<&=PdDQHetL#x3PNz$yQWEE_^$Wb(w=BID!y~WtW^Q+m64$Tn#eese>?<7CJY3VGCVNHhHryW& zRAr4Co(cxB29m|e3$uMiCuQ4wgXeB6;80LMWlOC&M+0m2npchTN|OlbMYsnKlj|z z{WQC`8a``d)>2?nW-eJMzmcrm17rp-mMAbR6B05%pzdb2kCmGkXbv*s0nyF=l328`{49kyubCZ&(NbW)O6a@>p^SJ^Wii4?FVok4!}eM zY1w*ESIYYr@FP9>$o1W-`_XLGxP}tan-H6pRnyr^g7_ndr$We=XXowPakf=l@%NKQ zrQ#;13E#mLsDFTQ{7V~DDApnX>LqL*t9A76kMRDeyCx3yEkDNXfIAR)*oJ}*CIjpD zoU#1yq$W6$E^b8B$Ta`(nyuUa;T=MuJj_VNzfS+Q^Amw-$(!rL))rKZUR_9YNH@i=lpGv)3{dW{*7yLji)Ov zg@P>FXz)N+iEDE1Y(Nb|wIzSu545l(^V&RyG`lnT*KctF4 zl+b6o7{E=M^=COIM^jMi2Os@y?12L~^P!E(uPw(P!yX5OKlitWziW9bu=2t0Zr$wU zA{X(VWy_o&al1CAh!;j%AG=o(BG-ADwIq4%4~+UEStnxUD<AD`6ysG%ZtUmpo zhhL68m;2t|j@*I2MjlL`ytC*<7rkeAzHTIRG+=uZ?SkbC^XhMf@-yq!Tv|OC+!qkF zGV%0yi$s6^?Ku1Dy}ZNGH8YfnQq)_T*W4T5bkqXoZ6Xws6O3{I8y5LfF<`t!!j=*= zh1eOhyx|?Fr`z%Y1ax}w&iL=<$wk5sx!f)|)ZsiZhkM=4L_aJAlI711_ybb|$Hh04 z`5_dfk%I!|`GBM}jf;~ww~4@qmoHPo3(O~fDBD;T437}D6Ak?Hn*7GHATd|~um`IF z4@!G(2&Xle`2OqO5WD793WE_Y~QLTO>zAAV}RAafPdm3$xst4UNG$+?1LcLTa!3xefm#_d)mXb{BZbh?w@tg|pd=wv`x-cd+;4|0Hj zCq?WYfS6@;` zcbtLdilbO3nX;eGu%rLL92t*V9!q{x`+lF#B#|Ix*_*)`ZUp(;y;@}Vo8TLUMhk0- zz8o%dvn^AC4DAorn0vmQx3Y;D%djxW2}XD_a+C5h0JFfRKd^(^Nx8{a)3RC=G5pSA zW5uH$!)KdT^@7xP@uzxRamoZ=$3U$%&6j-ZHFfEt?Jm^G`tmz+6>An7g5Pl`j%V2ngc5{{ z`QJma!lJA_EiW3e2Sm-cN$U;l#zl>qVn{Zax>zmB#LIVa46GLO<%$R>jebaUJ* zU!?`E5L1ea;z*+=XQkJSv0MN1KZ7%8cnP@_Sy2GFwq(H@h&%tlNNizEu8C_)9OR9< z_XpO&6->|?;1Tj^6j{n72yk6w$hUX`O#bh3DGo_oW{c7sz?8hn{i23z$rQ1ZaizZj zJ$}YL2HX+J0dqW>3Xx+T_dBs$lZz;$W8<`-uhL7JoNllmW}Lq0$Hm(vGfuX9 z{&OV&$=%L0C2sx2%t=AU+#!2003IyLa%SEdaSJXhInTELZ41k&c-at{-R8JWw56xl z@@M4@L+7P4rqWEyyS1JL=A~?xla=4*l=vQopFQn8fV6Nn518M}aoqbcN31X9fu)Jv zq21|9I$a=1IxN_GwQwrSOhC5y)oC5C2hq8|ttR+Z$XO5wNJ5p7o1R>*Vp56aFNIP+ z9HC8Kc`6S*q1I5W?F5Lqp*nfGYaj7Ik2>*)Y9j@ddy4_qt1%AM7jSoSUfl>_t2)fR zzQfD(y^UO$c}tuUu#2Y7EEs$MI3Vtn19&Zvmwl4f(F`fPL(L6%uDyN%G^Rih+t^;6 z3#S#=r+EVzx6{(Wm0cxpQ&9|8;Kd{5SzFvwtlqbU-iBr|KjF%aJ5$xGq^z2f=9NeO56Sfd$rS~VKZ3NO-ZzwXk(H7VBj`Wsz3ajo z4nMdTIfEu{Y)f9Re^LZ%9r5!S`1=4+Ydl-p;SdcefjEd=2?E3cH#hEWuwghXfS|6w zhm?&nXI_D`jXcfe4~!4Z$ZhmwsU<6ushaF?a0ENWM$(S6MH$bDT=6(pRM14gy^bFn zo|p^Xyob}T3s%W(&)bR18 z&lB)_`KD{gkHV@V)Vb3bJy&`>5d93Sck&-t9`38#tmbC#c#fby9(*=?=idHQc5CJsrNrmsddE@iD%O=(`CjbeV6B+9ihVC zY1fvT;Xl_!Y)god_65}eFJ?j!BVg_dQ)FuJliiEszJ)3>*s63b>Rztri0YzzhYuGh z)94x_rMbZ8ZAHA`s)AxLQ3HQqT2?+EZCr*ao*e>~6QYCo$@IIa?>N*u|yP}<6F_9yjo-(_F^^8jww&p3-@#|cDbVpyT zJ6-XyXsMA-LojA*e!HUGUc^I{ns)eJ0Kj{0LuJYJMovXa=r~zA_`tvg(C?1>O3b9@ zR3|zTNwO8^eW2-P-1ZvZ^M?hsJ_bqsKa##WuF3a%A4EU_0qGtH5~84V4^&!OL8&Py zH7V)ZKm?SOR%%Ei!lWffhe$Y(7#&K(MvTGY^LyUk-=DH&}=^XUXwQ$zvE5B?l1BL&;?#k(~8U?jV24z8xfWyez|g0=*(Av zA7jtNN>xU9pE#7iqPY0!i=lbNZ!Wgn9`prUhE!d=JiB;;cHGWpvo+)W+5X5PZta$5 zq;yutpGV=w!)36;OmpvxutRH;9CtJjw;f78xW~N?uLviSt zC#`7N{YE?PdkfEo>h*dnUaH3(A!n{BTTmt^_Z2z$tq*wq(M%Y80g%p^-p}uKvSlaC z>_iPCe}O;)-~Zd5u@t?TXHtv)6d$LbSxvPMskaXlB|07NJ4VT=M z&{!HX4%a;M;I-rhOP+vjW9{LR@y2@~z$ty(k*Z(C&jb)=mA=bh3m`Lp3K<^ZOD`sa z%Pz$;OG%dcaDDu!K0$>{2YZ@fWLW01S4@%Xxh8dl*z?%@qOOJW>@%u;&yMMvbb5lg zzt(fQ?0^0wrOKx6Kl$ytU6L@i7*J9B$p4s7 zx$cYKx4zgsOP{|pK6WQFMdZ7ml%U<;t;VxfUq_R0sCO3q7k!565Re=}9)Fvh)lTav z*z^H=Xp+B9bJkqpwc)(;s3eh0g?!pT(8T5pUK;6E6XV%#Hf;tGZ-$D8=AnVRX~z6w zzQzZ))L%L)2wDuzb9GVaHazerH7Tu;UH`We)q`@(V9G%^55?G4wPan9Tj~b2yIb+! zruPxo;XMVyk^V8@!&D0Aott7ky${XTKTT53IYN9=&RtMvL*?dfKSVD3f`BhR7QYN3 zCY&?a|JLp4uBCr*&cIM!NQwbUbge0S+Ma^D^sD+pZ_}IH<#!EhnKv7$z6${3e2*jd z3Z~jV1u6WZJZ=yD!`$19sw8bKo$t7#9_Z=vG57X@&rr4|d*Jtz?j;jkVn9SKf%C=B z1bHa_%N}x}=9i0}f!pEo+9BXhxV%MlO0|qZ;e*nr2kbvvbU$DD`;t0?LVu&3e+>)_ znt(}<8?%-NI%y|mHa@Ys#?m(Z;5`tFdoezvcyL~J`qc{RBEfM67Sk{x-i1woYxj;x zM&x7-`{p9;{Y1@dn9x0_+8PJ3X+}1MREFdF9d% zGj03$yu77yDg4Eco}bs_#AeE4`dY%$Rqk=HO-tSGi zYL0F0*Y>|f6Talre7RUT(uDe@I}F}<_<2-3Lh5sQWLOUUi_+Q?KTb0g*PJvU3Oxj7w-rx^lJI@5}NJ2^Vrjj6xcb-v}icWPlgUxCS%Os6isNKwI|JwtUSJLH8grF71yR^tyg&(!#5gz&@qrJ|I&zpj~ z*`M?6t7_A^q6+O2bxJXM^k<&ykd4NG*Wb)v+;Otl=S$hPZsGWJ`mbztsO>r<^woxT z^j0)UD*QcoGY!5hO1fp~wmlgi-u?5gE(__{jJN@hk;vpG9Ycs4kKd-3a`PE@XXU5D zMT~2~tzZ#-%?jS4)fY<1T`WD>RDs0>4MBy0%<_{Q4S9Ty84NwYTk1z?IKqDWGhOxS zqxgTxEi+L9dM&SMNAL<>@IyXt548zk%U6=N+ZN6gEG?dYZ*c-lC{Sl9oBF(k0Y%-< zX@SHESIdU|m68}Mukg|#?cBPR^){{LpQAE?8|%9EqzV(f*&S;AEscpg?GKj)!q8kg zrE8{3NCn8iu;AiVp;G0(@!6FAvjWzc{bOmjZ28Z(WiK87y|myrag`dh&pn_sC&v`VM1>0o1;)m4-uHJ&)Czw2pgPUX3rA z486I+iO=3c;*L$pC4jFSbS*#Un{v=^9>pshI9f7lSdE!z96mxBVK}X{wn~xH2%WOO z=@P-@YnVD+EFqEHaFFTn=(8{-K-hlD;|+AUQtUfc` za)KZ4cOGo8yhz7XUcn(TBlvDC_g+VlEoQNYB8&qj_qJ^XD@XhGU{6BsrKKLMs|;&M zig&VoCw~HDG|e#NbsT)(YF!;c6YRKmo<-qC*9*KA|NHPKGY3!xjocrl3?cQ%?j=7-<0ik;OykuK|2E^Vpr4<3I+q|LO=0Y<#aS!o=2c2vu(MGdXrUJ1sYr(kGTv{d`u|aXXAOw@(vzYDrWnuLQ!nlm zK}tNpr5ZY3Y7clWZUFZ^<9)-WPfSN&1kMfrM-`reExq?p@WZu15EDshv!YSk{07%Q-m+G*&z+5LD6yJD1NN zJTCr~P8>WgGY>ALKS-|!jU}P|mzF=5;fo@L^gor}JfAwfHUy4B-o$MJpEGzZ;#(FV zxTKf)H6$`xq{*O+_u%Gx>1e{tx07@B*?UAdxDPq&*MAoJ>KAVg zoCz|rY3q3F$Wn9GTFi%rYAGe>A|22`Xi@-S6usN&*RQD%jMu#5dc{kN$1`P|)g7PG zyoirJ%ODLeC$gV@&i0Z%LQoiJv1ZS(qXP({TR1yt4yKO1T)VL2s69CU%{<0k%;GHP zZs0JYpa>GKC#%2=C3}4BE*ERQUp`plYsQ5iK3WWf{mcJJfyrBc!2SKZ5 z!*bcTcW_(4v&#c0{=jLEO$vyedHA4PX0rRk(mPZ(630jt$h?xLKcEzB&md^ zKL5*(r;?}m8XGPp=Sy-9zP$L|(w1Z9ZL4Pf-#K2wOeq7pA+Caw)Wqdl1zyn9Bp}Y< zctW+ZKjT~c3$_PWdjZH0G559)v*>~IsW%RQp#MF8d4i_dumF%d5_a8sn!083AkP9Z z@agve0l6C2YbIo;iAd78QwF_fa0Tq%@L?Vs(H1v#9YPnb3mm#{g3U~)>;{+X4&NWb zxPu3l&pv)*Z+rT)H$PeRmDOPfd=80ra{tyB@A2Bh?92HXQHiopAV1l8BV{fZ-#Ka3 z3uYC472j(`b+e$dfF02)WVZ53T>yJG7&(QMZ-j-w=1}#_nM6Z?L5vx==eh1lEwp>T z(=6*rzLs}=w!mISV!*i_lbXPPh>`}_UC<10(~B=o~(sH0fh*3d80xY*2ZhJnC%>CJ-6Os-v)1 zz_RvqaA!^X3n(9ilB8&{P!ch+s&uR&@x_q5uQfsODfQ0zr@E!VDz_7}JvjfZTSM6&-Kp;h2|06{J~#2P~R8F0s}~(JSns{R=OP zr)2?}Qct}(ikH$k_5ur^yVFYXmaav9AFn9pE&5NgcP&z0zvB{HRyGwH5bB7{QMalc zmEfQTa0A{G!_(zh+rRmB**TKatB(V;9(=e0q;4JLufu!3Gu1HE(41wi4*gpe;dl~} z(2q5Hf*ttcy9Q#iYg|fD=jBrw*lfBpe3{uORA}*9co6&F`rIcgNKf92l(@OSw>+L2 z)io~8oC{IC6#Oc;aco|*7Wlnez|ZE6r$lS!^QNTI)FEnfF0q0x20}%D^GjHZl-{lV z#QMpaMkp~tW|%2`$)NT|^4_K!CE#Me%zd|PdphThK*Ce!cc6=ZU*G`i4=W286GaDc zCuuma#^b1!vZ~LDZ{Pa|E_OahUWD!ph&ICFdO!PDSoswsQS?{a0}8DAr<2r7ad8ki zIThpx@;$N{fZ?$LVIT&F6jEG;&5jP0&0p_+8=yev%w9>1ivq{ir2mgfWJhs-4aUCi zv%3U_FkcgJrAxHv583p|KuewcdaT*yEx1)uN|R`Qg`NZC0YRsI1Ofh5+g4Gd>L+Eg zIt5beIlpL&qWWd7*-}duB5aK;sRmVxG4Zwrmr(q04{=Zfh{R#Gs^6uGLTjjFk0uDw zj}yKs^hK0Ilk>i6=i&W!A$8CFg&GOH#2cG~sOIKJ!iHj7!> z1jAT+%k#NX&JZyevdQpvXhFjg$-h`^@{RgTGrJQv;j>R`bTJLLmGuK zGx2=gOONa?EKG_bL2WnMo7cg;Z7c~0hVWhU4nrQQHTAADH z)u4bs7tf<@uFfs8D}KSclGxJMXwMSBuYQmOzo{z~V*yaC{db8CSgt=+Lz^i3X$ZVH z=s~_Kz1@WzLJ%ar!h3j$mVj|11NTOA^Yr>up=tNaf)zIUvN`q>j zL6xzz;?!Ch)Q=vKz5*xI_uxtE?A4&RTGYXg_gkC$9YU9ez7_yQ*yJtWxw16b3ObZ_ zIOEDFXm#+d0*DG28gBq52xsSKwW$WIFJJvZtfftW+qc!{4paoE72w=w8-4u&#=3aG43^knx%hH zek34O7G?qHzeI9twpt9@nil6gVxUuxH=W98kC0?7#Fwb-8%Is2m#-VG`Udw4xb7Oy zluGPs3vUAo*?toir$t>c^c?Jl7ie|>H!27zJ}Fr_EmbL`0d&or0o`n1$$RlCV^Wdr zd~{MO7r#eE7=lX_IzlIXb-T)andAqs_JvuzkBf_$szjOOQWsc#phs<#tLQY65cvzr zjb+a1*_FwY2%Uf=8M#pH@xN*GMDt}eTE$%m1%G|@<0m%9I?;4oFGGf&= z(0Numg_BPA({%s}ZP%9&CR;i8qQsR+&N!ENca`GCEA(tqfEJN<*o2Z=O7%@%VA?un zRK{I$Fw};T5n*(7RD>f!k~)-Ga@;G!A8_p(ufB{kM1P!!v>NJnhN>y$Be#QExoX)K zo_d%YLw)&~;$raml&JQ8q8Ol+L=hv_S;8l7c)Ei0W6VCj1NUv5a4&NpxNo2cAfpdm0X7)rY zYMzN+>Rg&CHB~8h&N1~cPZ?h(NFn-jkui`un-AHKKJ``-S`GZA-;`f#I=tiCjJkN| zOPGluN|NNFS7!E(SG=jj?(00IoK)Z>*d5sDG97r@ zZkHkwmiump_ww`vQ_7j6*)+;RS?2ir3%@~h{nrcLClP>fmLjj__UBPa(GDjkDZD}< z8kS)$5^Cv`Qp!{4Jc>bm5 z1WK`JN>Y`GO@yLxn5Z}pBbG)`5|yA^@irimDF8^pCHnSLF$6It0K};No5HVyID9ct zCu`B#HS~hMx**e&ytPPnZ&d*&)U8f707PQ|+PGiV5SO1hE$a~ai#y9X9=szuPPd3L ze`f3Vp|79WY0$;zdpo3u$b<2H2dgBcqo+ZE5-&)i-I{@s1z`yeIJsX@o;BmCDp#9gSaq@<`>9jzV>HnxCMf1PTBKuS3 zAov16V~mK4*2Ve!IVhiSZArf4f;MzCsJZ?3d0nlZSjc`(F4h#g(-psv8;1t*nJ~S7gA|CAyQ>vra06K(5x-rhI?+-tE3s?#Gy=Nr zJzs^-`U7arBcfReBR%-*klog?FG9I5W#nGOEGcLH4dA)cXhr=-&R~OR}AwadzNEC*k{tlxu0Hl-VMH4?d-&PsPH+w3$@Sl zvU~8m6ZABDWpMv07QX&3lU$DN?Q6o+YBM#>x3^Uo?u*IBL4G#IJnbx#FBc1gz@!ZD zRYHIpV^QT$0_XP65`^ui7*5hDWe$wBlud>S62<{KI*3805Idc+YB%SBlTR@quim+Oka5ha9=wwaWpXkys&4Z=&I;}2+|kftjvHl+ zOPV@jsN1-1_q8^R=SZ>|Pc?HLSaD-b&x0}xeq8CC1wc<}Q)@jVK8h)O8 zRf~8p2UQ%b+yfKzybwzFbOCPo5BUMkQE~dkj7c6kLR#_u)#Eo+`D_DEd^h|8_X7n( z#Pcz^)7kM;|9)hi8{=kkA%t5&d&dEj!V&xYUH3_4vP_h~k;Emy#P=RFE16{EuEUXY7Sq8B~Nt{vO(nw>7Jlbu^*j ziZ{AO1^>^(!lJ9RdrXQW&#E=&myC?m0-DB@(|```zpr~ooLZN|l6v?odq)~qPPv-R z+A)Q4ljQ)*?Pw`vUOl+4a0FL{;-6?;oNd^w$C20w@6cMxJ)z}E2Y!SvAoTYE@M3+q z@&K&NHQ8+!6P>*1uC`9sE*_c`*GQjg6tVrO-ymA(B)|~pXBf3$nPN+Q z@2stZ>hph21!5-lsdVgC>I^2&EQV2P`;E45DoVY2Yih&$r(MX zy0RP@46FJIt{g6zU8)=n7L)N*rY8+cQgFUPooL{aap2Bk^nkroz$Gi4WAbMGu@ycr zfhbC0$j0q-tC$$~HU$NrI^E_6=kk$XgN;aq1O*yEyGTn$F1g@Z-S~`W46HUt*k)pq zV6kDg=1l+Bj3dk`G3*H-=de#T1&nchZ|zS1M;XR?>;VJN0SylTHf#>r3Xnc=d+IH2K=54fnrw1@YuYqq0S1l$Y%hWeK3e{6Yw>PP@CMjr}jH) zDQXgs2JX76o(B{=zL@N4Dt?`kc~hEZBej5%E;kxn=^#&uSg1u?vb#O)wvj5wVo$be zp$W5wB~3v?M*B(OZ9whz1Q1`BN9RXs0&2tdd`dZiRO`I`B0_WJ&)3rFD~oy_xc9~z z(U)>dTE%Nx|{D&_3)LF<$9%B zR?N(FXiOEzyvR3&^Z`1Fmy_&w~^}TwfB%}0m}$L0+%smAbr=!faCZ1 z1huZr)xyd`CztrZWh1X;+aT7AjykvEOOf2w;*tUYP2sL!U0&3teY=VrIE1&&<3@;RFLX{{ARd}Onmk$HY+ZJGrL z24}*vWTRl269jSX0`*MJuqMRIucJ?8kYjq=^sIQPM1O;O-#^+MIII#WzcBvAQnZbK zxZ-0Z=# z&s1lngS!TAq^NldY4=B^N)C7RJ7}C%ELqUW3zL4@HHJVeH2g{#%b%&f^kXklrC1>& z5UAD_%sFx#$~mY$7bWtU($X+U$?LZi(!{eginCal7GCZuPM-QPDt-?W`NJ8VOm8bG za9T)}tY!{Yb9B2fmrlT>Ba9&77E|VThYt;n4^1{EXsQ6fli?L;&KvH!AEA;pIDoy? z?AzY+KdLb`vLRrt8wb1=`6tSRYxn$K#n_Bjf*WT!C0n7D7bl4x-J`IK! zyOxjbPdKjl>{?xC)eHG_1HknLskJxKBB;KSrPmSj$LnB{6l5-}U#&5bVp_i@#wV1g z(|Z+}nWYc8*u0WjzeB65|LRR)%^qAC-o!F+71%wp80r23^@c!%380okmZDdwYtVY6 zu1{9zPT%=ghjNF^)%SzyZ4&&!SA$Cv>!G$clfQzzChF|PCE^x(Z`Fb9X_h+7C|6Ih zo?7y-DH!|j!{^5*-pno2r&M~6d!IkhOWHf;nb|UdHN(4~!`R?GPq216gf?e7;vp^M zoZFNh{Cvvi9pYua^M#jUzgKyXoataKyjx!Du53SY4sL*MKqA#oIyAQfG4H#ky9|<<J)r3Ou`f?wBUF)r}aVlB*G^Fb2jKZ+!;st+o zWm6RV633i(ezGXA4QQY|nU1%3X_?)gG72KxbnQjPfjD4_gmPU%>M9X(-OkR9#n+P) zlbx)p`%BVZQd9zZ9n$D1L5>6lH4)r;+aXvyx_{R9W@6fWYx=^ApTL!D5*RR#Xt_(7 z;_LsS!mY*I0q{!!gJ4vdf;p|Lu7sdPz{XUA>zelf3qdqH_RzCzib6*yv*T~1&FZxQ z9Le^oe0gXi=r#r`kwe~m;p&8aq6F#TTg}k__^q9ywcc{mM|6^PUlAQl!$$^jKZfbQ zaFVmnqoBhSxo}}Z7;e5h$ni2Ey;Qukd_g+IRGS?$q|eqZ@z{62drOB?ChjO%alhq! zhIkEF&)}Pu?7}SRCSg&`);qD}lCSTo(*n}Xbl@J zkRxYw-U6hZcsG7bZvKzz(eFlsZnFmM>Z9+X2P3>ZKFp7gRD@>^4@vCB`05|z;!e)t z)kCg@kWOW+M?dXx?K$#J?hVFo@Zgma#6Agb7#wRJq52vifuiCqQu}h=$*~aKp^R|b;Mn{$ zCb@do1H|4j@h0pSYk>3?fy587Ogy2g0A>^{8|T9(q(52Z9GCgnv(L(+ifWSM2u zB{Y870dvDxw|~zDubU-pw%12p(yw|L?Z;Xix*DHhYoph&E50v!BE5nb zM8qvONJQ>y36s=1xvi~8={>XT7*jf1-gLrK*uythId{98{UAf2Jzt_pa01?*(B_WR zNJGUc@^a1C*KV?S+0khuj;BHGuog+-nvAA2cJQFK=!%YPmTf~w`z+a`|D3J0e- z)PT){ul85%J9P0nmR+jj91YaERH|AR#|t*=K_qrj>Q1d&{Fg-#0j!9ADB=-4<;o%(Q-2YT$t|)&H?VN6Zm?}1D>y9f1psj_sHmOt6av!yM zRc>^80kGKH9ui~7B}an3V-w`?);wzK=Kp0LshE;1aFb2ahU)*Qj8aTKMeq$=Crckd zqCr?=_&YE=g@GVHc(x?@$MaN{&E0zD=-in1gU~8Xrg@l@3i8?S;ww^Sl>_C<;zbcL zD{z7oa<6>dIHMugp%qIS(+2cTGh05$!RPO9KSpCNc_ux8aM?<`aD>7aFbbiMMs^Tzw{#3I!Sq>qi)4gp!M z75biKt{p9=+PW!{SwzV%{2AM9iSg^Yfxy;pX=(=;oy$>)Guscn9^s>Lc|09C&Ws%U@{ab&`<83?7>PrvVT{VDS|;G3&`W z%{hCXb>xg?12i81sso2N{s|%4S1?aYB7*s!C8yQnck_Q!JiF>BjmOrdz`-9x(9saG z&RoA^i+RPfgzMWetC9W({s6%m$O108%~=2yy!`z)l4tyiXx+ z`5!i`gyK%Pi+B0V-oF<8qaZySz^@u>2@T=)iSI?dIRS?pvQ_tBA}eN2nK3E_g&fvnLirf^#r#wv$8f)dd%+4 zdQiK1Cb6fk>aDN+$YXc2>%aESwATAArW&QMflOQfoElDJeh%adKJTlc1L$SA0=XUR0*X)9eN`0PBdCV=;##(}f{JJ%lt(URW}1$B11>q( z{;cnn{ArNL%OkXs7)`J_4#BxnuIk`sx~A(rI;q1=k5AXF|80(aDBwpJBKg<-4D5_&8As zHiZHbt@}98I_l9`X-lc!v5qe`pA;9}=ckFJgkNW5iKxW@Gd35SkOyWf`so&7zXDCfnbm%$ZyO&!DKZ;O;-*+J zt_uhiFsFbC*W4jr7uHZxq&q~Q?7dCjN58uftfxrY-vcUsYkJO&e<0rd6)mc94_j|r z^<(?nhcu(S3Ic(EV~K){t_stXz9PH5?qzR<1JUHW&pzeRKG{g$qZK=4*XPB_ufZd= zm2BNq~MY+N}FTLfBe8Ew*|x`FF(GL zYP4B2C|7G~_Im9rA(wJBf+)Tl3Z0$ZvI%|o*C(6n%%sE2Id+AjNEjtP16BdU#9^ap z%JC$Pqu}E1(t(jJ)^mJ0LAOUHkf^f0ZNYgT+1l`Gc&4Q0RR7deY(Y*HDD50~4j84M zA!Rn67B=gp={v_f)@k`v&_!j4{I6mi??-)rvv<<&@VWLGZ2m~;Y4)Al#>8}ao+%yj zdf%>(IKIlWxYZ?;c{bkH#y!=^M`$yB6x;f{kta&<4IV9fij?zT@OYyXYK~CU@`t@9 zj8GVku{6CG?H8_b{+h0Rtn+OWm?DFsc$0Ge^j{zES4`m^*sQZX3e8Ge`C3U={Mu+nv19p|;1 zTQ*5*!o*$NE-6?Bk01s*Tbom5UKqa@d=;;g=`WHQS0Ne=88z!qA&8*{moLqaRuLEu zCIktB>AM0#1SX2wT}k$^e+n!t9>i z+%Vzh9vun+pLNEEV&VI$xUcXyN4Y5(f8rJY+$!vJTlioachdd8txT#C+YYlH=01L@ zz3;0PWgf$Nwtxe8d~Vz#)oJ?VPMFc+pG4MQ#S}sY0^Qj|fDj>+F%(a{&I*!uu4C_0 zf9Xg>PI$rm%K@{Ana$;R)Jiglc{6JKokmc_v(e}Vhx=(|VXoeaSXn?;Ox$K)0-K{6 zuCw~S2p14j1{s^=&H8%@n5N0_SqS43kTiR^*Nd@^t+uBW2SvYSx%|=@o$ZVKTa5Pu z9{xSamyA$++Ah7`3y#-Neoe8*EB}r8`&|HZOaD9ywCE*$p+b~p5G+O=L6G7z+#xp!IzW3 zuWEzPD7&g7b^J4N$ow(>TOOPV^9J@vA5eLiT<}>SYnEtD73Mr}pzAf;)Tha@1v6+X zYfL_SU;Z4;Dbe^8ln(&_2NDOU7g9Hvcrs2U5hsolY7Bx3o_0OUx>DGj`Ptk{BtiYP z1Wy;wW)6{k1qC!~*IfaqgPCN7U9jvfC&bT>82W3R{Y+z3#B^0j*y?%G9HD%Q= zt6CA&Z@?qefKiZmxO6|cBnpzjg~C1o$0;v^ZV-&QV`T=Sl`0h8O*2)dt7Z?eeS&YM z!ideDn}SuRZ!a;u*W4u(*5>Y^_^LO@_&{u;uH^ZJDZ|+h29(K?W%f+X$Egqw*d(ag zyL)^t&aN4YND%G#)2`#^)eLs}{?J*#)IcwDG1DfHnO;I*W`5>5uYK~y%+U<+K(|j0L70sd=WWG!-}g4PFK3B{=S5cpQ!B8 z@F{xmkbC2K1dq+`;2y9~XtmHJc!)E086S0b>tf^Yi-u|T>zGA@U`CZ~{({jn!!M6J z*DSZjXNBKA-sO~`qp7?sq$BWFQ}^nvDki+b2w1IC1Kw>6yByAh>nz0{7~e7OYh6ka ziN!uGak}CH3Y8a2Zh5uU#mvIF-Wo*Wl3#f_#%+ZSM0u1~Nj9g0&N*z>B=(KMQ!voA z67~Z4s^p(KvoEbMC_a}Wcnzy>@%xT=9S&A|t#3kK;*+(wrNaYP?{dXkht3M~T1mjj z7NCr0id*b?2Jd+Qj;j$9ru`#)SH{e9=NWY0ld%s&AMZ~%g)@67T~ucjODQ%~-4Y;H zDiUaM>Xa*|I2OaEEaGZV!kvJl$W&->8OCMsIjIJ^nlIglYE<5PvYyc>TN!MG7ypM@ zk$+}ip{bNNuoKZzRx-W*FT!k>z-CshPKQzh!W&GGq<;%`!+EbDc*J1*xGhN5Lem}O zcU5ShCjYejcquGJ;gtzQPUdg8a!Zf`n z70fv}#}k3IM#Xlwg5Mrw!phXw0m!LOAf6OO$jk*sH#fWOYTgoim3_!Q*=r~W9kd|q zld_V=E4BU zA{n4DV>tZH8_a z5A4#%+v8_N`^7e1lu%Q)y-GrlP45I;X^b#aOb2p5mIq#iZTfHe$7un+?=jQ@Y_5Ki zAcSy=wQdnPg8~dMOl&ohbe*_TNB$ob*DgJUnia`M1`w2$&&yY}n8O)y*?na8KDE-N zFRSw+zD!nE`n>);r3r<2YRwNcibP*; z;5pOCpNo0Z&TQet5Soi8hPuo~QnOfq=C)F2OQ)T_T0OlC-594tLkb~v-uodd-k3qX z>6&)=vPCycc3c5xdqb<_tX0`iS6XHOk zCg;M~DWkS`C`s6X9%J~vJDXiw!Uv}MU(T0>UBEqU$yBF`dDRmi6ej=Vv z7gJchuiGu}!frfuF0iw^d|%j5Z{yfe-<**d01Fh4IT0i->6PA2fGkqeRq)jladNB+ z^8sFn`F>K|e)?KVit+rNTfPL09%>Z2i--hcAEmro=Fy@JR$kMqT#K+Ax59}RH2d9_ z=8ac&dC{n|Ny8av=#c#~a}E!VhOblrG)zQ7jdMfC6q2Maz2a)#IL{;TXWfKC^l1#@+f* zs_jfrQaF1xfgd>D62cvrzXS=DuJTtP?m5i2X=V_>OZEdR7s?86%IldQ<6TdO8vu(i zfO%d(239N+0uf3>T(O($k< zK_!DQb^Q&?z;TwDAmE9UDO-M*Ewg^2XdeISzEnLP3H0jU_K~g^Xy+iJ8|QToe%{$2 zYy5URT>%lKy!Vjn^Pl!|A&B1Nq5Dx^wO`m5%um(Lj0J+R28g$G zuT=W$N2Mi+_e9Ke($VcSYhcp#%{8G^?>lEe!sf(4|5D$W#$9U|-2-Kea=mwCA|FmD z?z8vv`G*e1$?l&TOGQd6HYD7-ergGYy3-d(p9`Qh9Ej$WK8i9|?kVW%QqQtt>5yw( zi+KpYsdIo<)hKM2G6ce!gK1!BDVAseaR~MvbVK2G?9RA<2sE~V)=nRcm$@6|-p{yG zdBI~M9@16jb=#eAQX#^abDuf5v|rqf$0aQT&Ey;UK#xIY52hBeRSS(Fxef=XX{Qq0)r>)B3C`mVG+92%NS{7;#Ug(KlhyUWd@S~00zLxgci;W*M^e>&ukz{>q@0p?2z0J)iLSU$7jD?J-&hunN1-lDK(;P^?B82KxSH_%0@EI8-I z7l@2cHCN$%Ju_l@h$q43G#`GMyEWoZ(!{lEzvOg4RfULppyGdBc?s>y}Qzhq-gR2RF^7JwkPP%+_9p z`B{lM3r7!?KezlBCtORagLj)yXrG4jlS{lBlP=A9Hh=}^fd-2XACs63?XMu;s0o(4 z-c5%4UM{wxjoZJ?CB2X7Fo*Mz7pjliFS@VuX8tl*k7pg}TjzJMAW`sxEC zoq)%HQl@R=2I15W;VQVrWsHXN3L%}nh5YxRz~EtKhoe%D>H$N+zs?zQq1Lr+h#-X} z7_l1rHGa^h0bbX}^vTx&Acr5t`LCu?gB-d0&Qc-q2b@=xSMcm`LGYZ@Wa;4^Rw&?9nme`vC1 zlVb}f`SV8+r*eWR_!dPC{Q5Fq(7pxEmX>GmLjX4jt2&3OHnnd|ljb^fCbC9;`=~ET zQLrX;DU?0(|90)t$zpJrLCfyuvw1N2lnt?K$DhD(oYy88sNuIB*M*8jHPFAS(GbOf zjEsjCpV}=-G6r~T_+W>pSi}4^ch5b6^4Vq$zV`xGx6~tj{-R(^7xh~)Snll_r*~$z zAg|fTjSC{sj>B&pLjcl{0p;pbk~JUShgoW!UYu z@y(W=%Om6%R#lHbA}7J!<{=ormHw2(e~c{e6*h^?wU>O@4ixEsSHaZ;E-G6c1d0eo_foaP|O(OZ0faSwT@m{bd0{F2V4a3KP0X7;+qI2Z%mb;O|=Lj zG~>TE-vz~; zC|V7IHtV20U82qqm8W{2BTvgwP4%#r?tT@kQNcLJ@K1yfa5mR!v676j%LCrAt@M3B z7Vg|vc5Hg~$LtPA^xrHAfNZ5qYlcQiqE^0x>GotbL{`01_+C=Wp0uSFd&m@jzEeYE z==BS}ofrR;r8o*ejV}ifDt#+~P969PvQ(y3@E2cWT6%u1BaOgLXU{|Hi&~@^YsU81 ze2ZQ^972S6Ur(iMlJTG%ZhKS{q(D!X@p~!#wA7dS!cvi5pDSZU$JFf$_S97>RdSNFv;Acc&KX6+2&Fqe=oFKmxV;>%UMTW$h zh5D48mebg#I^*V7XMvEmfh5!g5W%s+kg;oEprW&1VFsGDD=pkWhhaG-TN5_^#cmMb zO1X~!ms)25Uq?MKA+9+R(ne#lYpSVfBGT`(aB$zkFjYt4Q=hYA1Ws>>a=402*jH%J zojdW=6`r3Ng}PsIUKVrexSV`S!(x%T70PF1?H+Ao0vZJG`F$k>>5wZsc|Bk^hMqqncc5M#UZ;$MI2%D6TY+!DQSJHxH<$7Q z*z&XL4CXO&L&R!+Q2HO=WazH!oH3xy0gh=%0(U_g?lfSM8gs;0q1NjWT}i?R{K318|GIKv^Yyi+^iTiAQ_TQNO{RQ#{YeF=!sJPU z!D~-vVyzC}Am3&Ur#8pF~@d-+aA)-^jH+Ne&5h=C1j-ha{9_~+9qFR zff=FzS>qKe#%$jL+i~2`yOyNNLb?2P25vN$6%WT^1eS5N_HmR}Kp?;UmIp^F8UqDXR;)G2W@D%j+;SFD`Nfvv5-(?l%W;IO7 zPzCLZjz7_CwV9$Fu9$sklgn2lvvrbxWke4y#665F#)HU(IUJb{DE43%pP##k`Xx;5 z|KsVppK+`4}Yb z!`vB|%{ACP$>z)XN1xVL@(t|?)j=?rD#$wTtlWg&&H7QAira}`($V8`Zh-9(}qxRZSJL6%z?dxJ(RwZD2-neLz2 zhSGu(AIJsY@D0=OoI^zk$ovRJn8!FBruV-YO$Zl||rv~$sChqn}TR;4( zZw6)~HzEeyA(8w!kI#^{;E9mxSd=59A4Gni%E8|xm)o%NsRyI021__8km7+>&)-H3 zddh2e%yUw`DAd}`7FcviJs;_8R}@1K`groaR(ouE#d7EK!xXnby|*t{rM6W73Bz}z zg=#&;IXAR!j~}q^V06Jt{5RmyKuO9EbXQ!k6EnMDH-l(38oG)1XYdxwbg<(Gn|8C+ za+YFeYR`TjOp$b|SU(o3pCRx8qiveG2c+{7059Lvp4>&chgxni=wKY_fY;%^8`_gq zDOTvi6Kb^0=h$X6N~f#qLl3S5A6jj8taAWN6(rey8@c*Wsr*7!cSqsz zy(;;cs22;GFZPR#t;LL~W2EU&6gS^`AMNRn4x$VG@R0yx{Oj=^e&Hl5k_z(u!h-Ve zJT1o$LY(dEBNlgaQEmn4juH(hMc{uUWk74%xy}guLODC3K@8&{1^`pzE{Ekgj{pAC>q*KbYvXye$1h*UIsLmaQgGvOkPZjm?UywNvEaGt z=--v)KF&ZevvRFc3tsaO4%>qXi|*oN*&@-OFOt%&XMbJTy8^~sM=d|cj^Ls^-p*Vd z!8yuJgtgRG?g$2ASwU~$=@4JWwW9Wk70%Mz^SDxisHgfpt5V?(`+I2>yegSAALPV! z+*1JANi{{F+O$C`y1#w82VgJ0NDZME#`*R zr$0KksqLS!N_r+nA3Ro?6g2)-75}YCNPxaae+PALqvtlB@lU@LkD5~?mPX;NOx`ZL zvvk%T8@SK0rN=T+iSm#O_Q43Eo}+nJjvkT4&QX0wygS+-xl4ck^*fJ|(kje36ks(6 zr*SRJ2aUb~c2+Fff|WOhwvz`}%yN-tvMtJWXII4{uKZ*28}TVu7{?5eVl^dmLT`uc z=1bWMJb1ViF~IrzZJQL>!W*AV27cs4JCt-tN4Po`d*QwKesnLr9UTaNIG-8b@uy?s zf)?;1%s1(nr})D!M;Smjgi4dzMU${S_$a~(5Z{t}*N;B%B^K{6oPyxlSI3K-h4xrX zba<0L4=4`2lk8ApJFX}amy|E5-givCE*LJ(m@%;@Yfy57lq&u)4J5g&xz3JuqN+2& zsE|4(4+zWu@1LEsYOhL}BhLXA;Agpw$hjil!AcLhSO6pI;X)2d77(ofUnioCI11h2 z9LDWNuN_9(r_|OZnmFqkd>fCFH$A&${8-+aUlr4x_n$mvC%x#-SjR*?G*=&WOd17P zh@*_3il^{nTXP|;%kCH@)c)q`GZ3Qy7R($_y^V8<1nc268{G-qxtEWU zfy0pt%Yv?sn!u<_AdyC~DJ3?eYmb~7sKKB2Gi#pFB<>MH5l%TxMNTT;OlI6}@2 zIcDyPrc6#5w8>6ISc+k~`8HOlTr-TG+99MSkuUZ2EW1rmbb@&HV2NP#>4+Qo9h(HA z#^_%_goBW4hqa_B0jPJ7Gg$V~kM%0$G!*d9{jpzQt z!K@S|crNebB`zQ~Ibifkzcbuak*Dx)e`n=eGWO5btX_B}W_*;KM4YMfvzb|Io*mx$9QaN9B>R$?GoaY8XzYzs=^Db~!jtudN__M~=dIGuq{gx+LhdJHSUg$FA+4 z zsGAdtk3Q+^8E&KAR!901_2w3TE_V|*V^G_sSNE>vjg(!?>TZ;#T?9gH+@PD*T6 zTj7Jd*`f;ne`_asY4ylqTsaHqIoT7!$)EDRWXrbvT{p54hfk^zz_)mG> zuOQ!{8(L5&RETZ8_EkU(a-6dl&MnFcR((QE&CnEQdcXTJNGGVh3*Kc#q_-)w24Gx8a`8lupEp3KKarDvOe;w7I3T3KziAC0{CA&ig1hNSMOgK5 zO6uLufzKr1YZfri!2k^QNz2;{e`g`R3FY2Sk?rWbsnFZXm6G(_L-}HgdtSm?tEggeB^w*&iVbk%*=Os%cC@&wfS!pC+bxf z8=dSK%e)2u`ToaEE&d8f@?W%vBpYTw6eUmK&~Wr34$iZLF)lidymaQX6K)7UJTI&J z*X{wwpBa|>=Z{gWR)OpuP+q~ GSDDi8%+ekVq*qg-032`6tyvQ>B1k}7+SvGJY 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

YeWXXv*6f!^TkuC&*HKN%-}-h^Zi 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 literal 0 HcmV?d00001 diff --git a/.add/docs/add-flow.png b/.add/docs/add-flow.png new file mode 100644 index 0000000000000000000000000000000000000000..0047466543d6157ce32c271219f1ce2dd4e9a5fb GIT binary patch literal 187264 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

wE#D~^w6Ru)pYi=%)N5Oqmjg7M+mk;lz?JX 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 IsQ)eeAB5OnfB*mh literal 0 HcmV?d00001 diff --git a/.add/docs/appendix-a-templates.md b/.add/docs/appendix-a-templates.md new file mode 100644 index 000000000..056915db4 --- /dev/null +++ b/.add/docs/appendix-a-templates.md @@ -0,0 +1,88 @@ +# Appendix A · Templates + +[← 15 Foundations & Lineage](./15-foundations-and-lineage.md) · [Contents](./README.md) · Next: [Appendix B Prompts →](./appendix-b-prompts.md) + +Copy-paste blanks. Project-level templates are filled once at setup; feature-level templates are filled once per feature. + +--- + +## Project-level (set up once) + +### `CONVENTIONS.md` +``` +Language/framework: +Folders: src/ tests/ contracts/ features/ playbook/ +Naming: , , verbs for functions +Lint/format: , enforced in the pipeline +Errors: machine-readable error codes (string enums), never free text +Architecture: +``` + +### `MODEL_REGISTRY.md` +``` +Model: +Version: +Adopted: +Notes: re-run the prompt golden-cases before changing this. +``` + +### `dependencies.allowlist` +``` +# one package per line; the pipeline rejects anything not listed +== +``` + +--- + +## Feature-level (once per feature) + +### `SPEC.md` +``` +Feature: +Framings weighed: (chosen) · · +Must: + - +Reject: + - -> "" +After: + - +Assumptions — lowest-confidence first: + ⚠ — lowest confidence because ; if wrong: + - [x] — +``` + +### `features/.feature` +``` +Scenario: + Given + When + Then + And # when relevant +``` + +### `contracts/.md` +``` + body: { } + 200 -> { } + 4xx -> { error: "" | "" } +Schema: +Status: FROZEN @ v +``` + +### `tests/_test.` (stub) +``` +test_: + arrange: + act: + assert: + assert: # when relevant +``` + +### Gate outcome record +``` +Feature: Step: Date: +Reports: Test= Quality= Risk=

+Outcome: +If RISK-ACCEPTED -> owner: ticket: expires: +Reviewed by: +``` diff --git a/.add/docs/appendix-b-prompts.md b/.add/docs/appendix-b-prompts.md new file mode 100644 index 000000000..830ed1fc0 --- /dev/null +++ b/.add/docs/appendix-b-prompts.md @@ -0,0 +1,154 @@ +# Appendix B · Prompt library + +[← Appendix A Templates](./appendix-a-templates.md) · [Contents](./README.md) · Next: [Appendix C Glossary →](./appendix-c-glossary.md) + +The contents of the `playbook/` folder. Each prompt is plain text that names the files to read, states a single task, and lists the rules. The inline `# why:` notes are annotations — keep them; they encode the judgment behind each instruction. These prompts are themselves versioned, tested artifacts (see [11 Governance](./11-governance.md)). + +--- + +### `playbook/1_specify.md` + + + +``` +Role: a domain analyst who brainstorms, then asks rather than assumes. +Read first: ./PRD/* , ./GLOSSARY.md , ./inputs/ (tickets, interviews, contracts) +Task: co-specify SPEC.md WITH me. No solutions, no code. +Steps: + 0. Diverge first: surface 2–3 genuine framings of the feature + the open questions, and let + me react before you draft. Record the result as `Framings weighed: X (chosen) · Y · Z`. + # why: a spec dictated by one side is a guess; brainstormed, it is a decision. + 1. List every required behavior (Must) and every situation to refuse (Reject), + giving each refusal a named error code. + # why: named errors become scenarios and contract responses; "handle bad input" does not. + 2. State the success state-change (After). + 3. List the assumptions you had to make, RANKED lowest-confidence first; flag the 1–2 where + your confidence is lowest as `⚠ — lowest confidence because ; if wrong: `. + # why: a flat all-equal list gets approved without reading; a ranked one aims my attention at the risk. +Exit: a domain owner disputes none of it; assumptions ranked lowest-confidence first, the 1–2 ⚠ flags + carrying why + cost — or an honest "none material" that still names the single biggest risk. +Never: resolve an ambiguity by guessing — ask. Never a blank "none" or a flat list of equal ticks. +``` + + + +### `playbook/2_scenarios.md` + + + +``` +Role: a specification tester. +Read first: ./SPEC.md , ./GLOSSARY.md +Task: produce features/.feature. +Steps: + 1. For each Must and each Reject rule, write a Given/When/Then scenario. + # why: a rule with no scenario will never be verified. + 2. For every rejection, add an And-clause asserting what must NOT change. + # why: catches corrupting partial failures that a result-only check misses. +Exit: every rule has at least one scenario with an observable result. +Never: write a vague result ("then it works"). +``` + + + +### `playbook/3_contract.md` + + + +``` +Role: an interface/contract architect; contracts are immutable once frozen. +Read first: ./SPEC.md , ./features/*.feature , ./GLOSSARY.md +Task: produce contracts/.md, a mock server, and contract tests. No business logic. +Steps: + 1. Define interfaces, request/response shapes, and the schema, named from the glossary. + # why: consistent names prevent the subtle mismatches that cause silent bugs. + 2. Define a response for every Reject error code in the spec. + 3. Generate a mock returning the contracted shapes, and contract tests pinning them. + # why: the mock unblocks dependent work; the tests become a regression baseline. + 4. Mark the contract FROZEN at a version. +Exit: contract tests pass against the mock; every spec rejection has a response. +Never: change a frozen contract — a change is a request that reopens Specify. +``` + + + +### `playbook/4_tests.md` + + + +``` +Role: a test author who writes tests before code. +Read first: ./features/*.feature , ./contracts/* +Task: produce a failing (red) test suite. Do NOT implement the feature. +Steps: + 1. Turn each scenario into an executable test. + # why: closes spec -> scenario -> test with no human translation loss. + 2. Add contract-conformance and edge-case tests. + 3. Run the suite; confirm it fails for the right reason (missing implementation). + # why: a test that passes before code exists is testing nothing. + 4. Record a coverage target. +Exit: one test per scenario; suite red for the right reason; target recorded. +Never: assert on internals; write the implementation here. +``` + + + +### `playbook/5_build.md` + + + +``` +Role: an execution agent. The human commands; you implement and report. +Read first: ./SPEC.md , ./contracts/* , ./tests/* , ./CONVENTIONS.md +Task: make EVERY failing test pass, one small task at a time. +Steps: + 1. Pick ONE task; restate the tests it must satisfy before coding. + # why: small batches keep human review able to keep up. + 2. Implement; run tests; iterate to green WITHOUT weakening any test. + # why: editing a test to pass makes the code judge itself — the cardinal sin. + 3. Honor the feature-specific safety rule (e.g. atomic balance update). + 4. Run security and allow-list checks; attach the evidence bundle; open the change. +Exit: all green; coverage held; no test/contract changed; no out-of-allow-list package. +Never: change a test or the contract; add an unlisted dependency; exceed the task budget + without escalating; guess when unclear — ask. +``` + + + +### `playbook/6_observe.md` + + + +``` +Role: a reliability analyst feeding the next cycle. +Read first: telemetry exports , service-objective definitions , incident tickets +Task: turn production reality into the next SPEC delta. +Steps: + 1. Report objective status and error-budget burn vs target. + 2. Cluster errors and usage; surface the top real-world failures. + 3. Draft a SPEC delta — what the next loop should add or fix — with evidence links. + # why: closes the loop; production learning becomes the next specification. +Exit: a reviewed SPEC delta linked into the backlog. +Never: auto-roll back — recommend; a human owns the production decision. +``` + + + +--- + +### Master prompt skeleton + + + +``` +Role: +Read first: +Task: +Steps: + 1. # why: +Exit: +Never: +Evidence: +``` + + diff --git a/.add/docs/appendix-c-glossary.md b/.add/docs/appendix-c-glossary.md new file mode 100644 index 000000000..d9af050b2 --- /dev/null +++ b/.add/docs/appendix-c-glossary.md @@ -0,0 +1,115 @@ +# Appendix C · Glossary + +[← Appendix B Prompts](./appendix-b-prompts.md) · [Contents](./README.md) · Next: [Appendix D Worked example →](./appendix-d-worked-example.md) + +--- + +## Terms + +**AIDD (AI-Driven Development)** — a method of building software in which an AI agent writes most of the code and people direct and verify the work. + +**Artifact** — a durable work product: the spec, the scenarios, the contract, the tests. The artifacts survive; the code is disposable. + +**Lesson learned** (formerly "competency delta") — a single learning a loop produces, tagged by which of the five competencies (`DDD · SDD · UDD · TDD · ADD`) it improves, written in a task's OBSERVE phase as `- [ · ] (evidence: …)`. Emitted `open` by the AI; the human folds it into a versioned `PROJECT.md` (`folded`) or declines it (`rejected`). The mechanism by which the foundation self-improves instead of drifting. See the `add` skill's `deltas.md`. + +**Contract** — the fixed external shape of a feature: interfaces, data structures, names, and error cases. Frozen before the build, it is the surface the AI builds against. + +**Co-specification** — how a spec is made in ADD: the AI and the human **brainstorm the shape together** (diverge), the AI **drafts** it, and the human **validates with the AI's advice** (validate). The AI's decisive advice is the *lowest-confidence flag*. It replaces dictation-by-one-side — the human owns the decision, the AI owns surfacing what it does not yet know. See [03 Specify](./03-step-1-specify.md). + +**Disposable code** — the view that code is one regenerable implementation of the artifacts, not a durable asset to be preserved. + +**Evidence bundle** — the proof attached to a change (passing tests, clean security scan, no coverage loss) that justifies trusting it and may unlock more AI autonomy. + +**Foundation version** — a monotonic integer marker in `PROJECT.md` that advances by one each time confirmed lessons learned are consolidated into the foundation. It makes the living documentation's evolution auditable: a rising version with fewer new deltas per milestone is the signal that a competency is converging rather than drifting. Bumped only by the retrospective consolidation (see the `add` skill's `fold.md`). + +**Gate** — a checkpoint with an explicit pass/fail exit. Its outcome is `PASS`, `RISK-ACCEPTED`, or `HARD-STOP`. + +**`HARD-STOP`** — a gate outcome meaning work cannot proceed; triggered by any failing test or security finding. + +**Intake** — the step *before* a task: sizing a raw request into versioned scope by classifying it into one **request bucket**. The AI proposes `{bucket, rationale, command}`; the human confirms. Lives in the `add` skill's `intake.md` (the intake level, above the per-task flow). + +**Lowest-confidence flag** (formerly "least-sure flag") — the AI's ranked declaration of the **1–2 things most likely to be wrong** in what it is asking a human to approve, each carrying *why* it is uncertain and *what it costs if wrong* (`⚠ [spec|scenario|contract|test] … — because …; if wrong: …`). It reshapes the old flat assumptions list into a ranked one, so a single approval aims the reviewer's attention at the real risk instead of a flat list of equal-looking ticks. Bundle-wide at the contract-freeze decision point; the §1 assumptions are its first input. If nothing is materially uncertain it still names the single biggest risk — never a blank "none". It makes a genuine review cheap and a lazy one visibly negligent, but cannot *force* the read. The "AI advises" half of **co-specification**. + +**Living document** — an artifact expected to change as the loop learns; never frozen forever (the one exception being a versioned contract, which changes only via a change request). + +**Onboarding** (formerly "on-ramp") — the path a new user walks from install to their first milestone: install → `/add` → describe the goal → the agent runs intake (sizing the request into a milestone the human confirms) → the specification bundle → the self-driving run. The AI-first entry to the method; the human talks to the agent rather than hand-typing `add.py`. + +**Decision point** (formerly "seam") — a place where the flow stops for human judgment: the contract-freeze approval (the one approval), an escalated verify gate, intake confirmation, milestone close. The machine layer keeps the legacy name: the `--json` owner enum `seam`, the decide-digest key `seam`, and the `seam-audit` CI job. + +**The decision arc** — the three engine-sourced lines a gate report opens with at every **decision point**: `goal:` the milestone goal the work serves · `done:` the achievement, the proven progress toward it (the gate reports render this line as `done`) · `plan:` what comes next. What `done` reports adapts per gate (verify: tests + evidence · milestone close: exit-criteria met · intake: the request sized) while the three-part shape stays constant. Rendered first, above the report's summary, so the human confirms with sight of the whole trajectory, not a local snapshot. Engine-sourced like all evidence — goal · done · plan are pulled from `add.py` output, never re-typed. Presentation only: it never adds a gate or changes a `PASS` / `RISK-ACCEPTED` / `HARD-STOP` / freeze outcome. The report it opens is the chat report a person reads at a decision point — distinct from the three Test/Quality/Risk reports a verify gate produces ([11 Governance](./11-governance.md)). See the `add` skill's `report-template.md`. + +**Specification bundle** (formerly "the one-approval front") — §1–§4 of a task (spec · scenarios · contract · failing tests) drafted by the AI as one piece and approved by a person **once**, at the contract freeze. Rejecting any part returns the whole bundle to draft. The single approval it carries is the bundle approval. + +**Retrospective consolidation** (formerly "the fold / fold ritual") — the milestone-close (or on-demand) step where a person gathers `open` lessons learned, confirms each, and the AI writes them append-only into the versioned foundation, bumping `foundation-version:`. The AI never self-approves a consolidation. The machine names keep their names: `fold.md`, the `folded` delta status, and `add.py deltas`. + +**Owner (of a phase)** — who drives a phase, exposed by `add.py … --json` as `human`, `seam`, or `ai` (machine enum values that keep their names; in prose the `seam` value's concept is now the decision point, formerly "seam"). It tells an autonomous harness where it may run (`ai`) and where it must checkpoint to a person (`human`/`seam`), following the who-does-what table (Verify is always `human`). + +**Profile** — the intensity at which the method is run: Express, Standard, or Regulated. + +**Request bucket** — one of the four intake classifications — `new-major`, `sub-milestone`, `task`, or `change-request` — chosen by the tie-break order (the frozen-scope test runs before the size test). A request too vague to size is rejected `ask_human`; one that touches frozen scope, `frozen_scope`; one spanning buckets, `split_required`. + +**`RISK-ACCEPTED`** — a gate outcome meaning work proceeds with a signed waiver (owner, ticket, expiry); allowed for non-security gaps only. + +**Scenario** — a single rule expressed as Given/When/Then; readable by people and checkable by machines; the bridge between spec and tests. + +**Scope drafting (scope-loop)** — the second half of **intake**: once a request is classified `new-major`/`sub-milestone`, turning it into a confirmed, well-formed `MILESTONE.md` (goal · scope · exit criteria · breadth-first tasks) through discussion. Every exit criterion maps to a declared task slug; the AI proposes the draft, the human confirms before anything is created. Lives in the `add` skill's `scope.md`. + +**Spec (`SPEC.md`)** — the plain-language statement of what a feature must do, must reject, and assumes. + +**Cross-cutting concern** (formerly "spine / continuous concern") — a concern that runs through every step rather than being one step: security, testing, observability, cost. + +**Stage** — one pass through the flow at a chosen depth: Prototype, Proof of Concept, MVP, or Production-Ready. + +**Stage graduation** — the orchestration loop that proposes the move to the next **stage** as a human-confirmed roadmap, never a bare flip; the 4th scope level after setup · intake · milestone-loop. The cue is every milestone `done` with the **stage-goal-criteria** all `[x]`; the flow is gather **graduation analytics** → interview *what production means here* → draft ≥1 production milestone → human confirms → `add.py stage production` as the final step. The →production flip is guarded: it refuses with `stage_no_roadmap` (a tally, not a readiness judgment) until ≥1 production milestone exists; `--force` overrides. Lives in the `add` skill's `graduate.md`. + +**Graduation analytics** — the five record-sets `add.py graduation-report` clusters from the whole MVP loop for the graduation interview: open deltas by competency · open RISK-ACCEPTED waivers by expiry · RETRO records · verify residue · observe-loop coverage gaps. It gathers, never judges — there is no readiness verdict, only the records the human reasons from (gather-not-judge). + +**Stage-goal-criteria** — the human-authored `[x]` checklist in `PROJECT.md` that defines "MVP covered" for this project; when every milestone is `done` and these are all checked, `add.py status` prints the graduation cue. Authored by the human (judgment), never inferred by the engine. + +**Baseline approval** (formerly "the lock-down") — the single human gate ending autonomous setup: an explicit yes that freezes the foundation, first scope, and first contract together; runs as `add.py lock --by `. + +**Scope level** (formerly "altitude") — the granularity a decision lives at: intake level (request → versioned scope) · milestone level · setup/foundation level · task level. (A cross-stage decision lives one level out, at the **stage-graduation** loop — which `graduate.md` also numbers as a scope level; see **Stage graduation**.) One ⚠-assumption notation is shared across every scope level. + +**Autonomy level** (formerly "autonomy dial") — the per-task setting (`autonomy: auto | conservative`) choosing who resolves Verify; high-risk scope refuses an unguarded `auto`. + +**Automated quality gate** (formerly "evidence auto-gate") — the Verify resolver under `autonomy: auto`: a run may auto-PASS on complete evidence, recorded as *auto-resolved*; a security finding always escalates (`HARD-STOP`). + +**Change scope** (formerly "touch-boundary") — the hard boundary of a locked run: what it may edit (code, tests-to-green, evidence) and must not (the frozen contract, locked scope, any test weakening). The `` XML prompt tag keeps its name. + +**Non-functional review** (formerly "blind-spot checks") — the deliberate verify-time check of the risks tests rarely catch: concurrency, security, architecture. Security findings always escalate. + +**Failing-first suite** (formerly "red safety net") — the per-feature test suite written before any code and confirmed red for the right reason (a missing implementation, not a broken test); the TDD red phase at ADD step 4. + +**Method rationale** (formerly "trust layer") — the *why* behind every rule: the AIDD book in `.add/docs/`, read on demand via each phase guide's chapter pointer, never auto-loaded. + +**Working state** (formerly "state surface" — one of the two record surfaces) — everything an agent loads every session: the `add` skill (router `SKILL.md` + the active phase) and the lean operational docs — `PROJECT.md`, the active `MILESTONE.md` and `TASK.md`, and `state.json`. Kept small to avoid context rot. Contrast **audit trail**. + +**Stop signal** — the boolean an autonomous harness reads from `add.py … --json` (`stop = owner != "ai"`): true means pause for a person before proceeding. The irreducible stops are the contract freeze and the Verify gate. See **Owner (of a phase)**. + +**Audit trail** (formerly "story surface") — the book (`docs/*`): the whole method, read once by a person to trust ADD, then referenced by a pointer and **never auto-loaded** into agent context. Contrast **working state**. + +**Living documentation** (formerly "survivor layer") — the set of durable artifacts (conventions, glossary, frozen contracts) that outlives any particular code. + +**Trust ladder / autonomy ladder** — the graduated levels of AI autonomy, earned with evidence and verification capacity. + +**Verification capacity / review throughput** — the rate at which a team can confirm AI output is correct; the real ceiling on safe speed. + +--- + +## Optional mapping to formal phase names + +This book uses plain step names. Teams connecting it to a larger formal standard may use these equivalents. The mapping is optional; the plain flow is complete on its own. + +| Plain step (this book) | Formal phase name | +|------------------------|-------------------| +| Project setup | Foundation | +| Specify | Domain Discovery + Spec Definition | +| (design portion) | UX-Driven Design | +| Scenarios | Behavior specification (Given/When/Then) | +| Contract | Contract Freeze | +| Tests | Test-Driven Verification | +| Build | AI-Driven Development (the engine) | +| Verify | the review gate within the build | +| Observe (loop) | Operate and Learn | + +The formal standard also names the *foundation* and *design* work as full phases in their own right; this book merges them into project setup and the Specify step (and the Prototype stage) to keep the flow to six memorable steps. diff --git a/.add/docs/appendix-d-worked-example.md b/.add/docs/appendix-d-worked-example.md new file mode 100644 index 000000000..d55528e33 --- /dev/null +++ b/.add/docs/appendix-d-worked-example.md @@ -0,0 +1,152 @@ +# Appendix D · The worked example, end to end + +[← Appendix C Glossary](./appendix-c-glossary.md) · [Contents](./README.md) · Next: [Appendix E Checklists →](./appendix-e-checklists.md) + +The running example, assembled in one place so you can see a complete pass through the flow without flipping between chapters. The feature: **transfer money between a user's own accounts.** + +--- + +## Step 1 — Specify → `SPEC.md` + +``` +Feature: Transfer money between my own accounts +Framings weighed: synchronous single-currency transfer (chosen) · queued transfer · multi-currency with FX +Must: + - move an amount from one of my accounts to another of mine + - amount > 0 + - source and destination are different accounts + - source has enough balance +After: + - source balance -= amount, destination balance += amount +Reject: + - amount <= 0 -> "amount_invalid" + - source == destination -> "same_account" + - balance < amount -> "insufficient_funds" + - account not mine -> "forbidden" +Assumptions — lowest-confidence first: + ⚠ same currency only (no FX) in v1 — lowest confidence because the ticket never said; if wrong: the amount/rounding model changes and this contract is wrong + - [x] no daily limit in v1 — confirmed: out of scope for v1 +``` + +The product owner read the flagged assumption first — the single-currency choice, the one most likely to be wrong and most expensive if it were — and confirmed it: v1 is single-currency with no daily limit. + +## Step 2 — Scenarios → `features/transfer.feature` + +``` +Scenario: successful transfer + Given A has 100 and B has 0, both mine + When I transfer 30 from A to B + Then A has 70 and B has 30 + +Scenario: amount must be positive + Given A has 100, mine + When I transfer 0 from A to B + Then it is rejected "amount_invalid" + And no balance changes + +Scenario: same account + Given A has 100, mine + When I transfer 10 from A to A + Then it is rejected "same_account" + And no balance changes + +Scenario: insufficient funds + Given A has 20, mine + When I transfer 50 from A to B + Then it is rejected "insufficient_funds" + And no balance changes + +Scenario: not my account + Given account C is not mine + When I transfer 10 from C to B + Then it is rejected "forbidden" +``` + +Five scenarios for four rejections plus the happy path — every rule from the spec is covered. + +## Step 3 — Contract → `contracts/transfer.md` + +``` +POST /transfers body: { fromAccountId, toAccountId, amount } + 200 -> { transferId, fromBalance, toBalance } + 400 -> { error: "amount_invalid" | "same_account" | "insufficient_funds" } + 403 -> { error: "forbidden" } +Schema: accounts.balance (read + write, must be transactional) +Status: FROZEN @ v1 +``` + +Frozen at v1. The schema note flags the atomicity requirement the verification step will check. + +## Step 4 — Tests → `tests/transfer_test.py` (run first; all fail) + +```python +def test_successful_transfer(): + a = account(balance=100, owner=me); b = account(balance=0, owner=me) + r = transfer(a.id, b.id, 30) + assert r.status == 200 + assert a.balance == 70 and b.balance == 30 + +def test_amount_must_be_positive(): + a = account(balance=100, owner=me); b = account(balance=0, owner=me) + r = transfer(a.id, b.id, 0) + assert r.status == 400 and r.error == "amount_invalid" + assert a.balance == 100 and b.balance == 0 + +def test_same_account(): + a = account(balance=100, owner=me) + r = transfer(a.id, a.id, 10) + assert r.status == 400 and r.error == "same_account" + assert a.balance == 100 + +def test_insufficient_funds(): + a = account(balance=20, owner=me); b = account(balance=0, owner=me) + r = transfer(a.id, b.id, 50) + assert r.status == 400 and r.error == "insufficient_funds" + assert a.balance == 20 + +def test_not_my_account(): + c = account(balance=100, owner=someone_else); b = account(balance=0, owner=me) + r = transfer(c.id, b.id, 10) + assert r.status == 403 and r.error == "forbidden" +``` + +Run now, with no implementation: all five fail. That is the honest baseline. + +## Step 5 — Build → the prompt given to the AI + +``` +Read SPEC.md, contracts/transfer.md, and tests/transfer_test.py. +Implement POST /transfers so that EVERY test passes. +Constraints: + - Do NOT change any test. + - Do NOT change the contract. + - Make the balance update atomic: debit and credit in a single transaction, + and re-check the balance inside the transaction. + - Stop and ask if any requirement is unclear — do not guess. + - Use only packages in dependencies.allowlist. +Report which tests pass and exactly what you changed. +``` + +The AI implements, runs the suite, iterates, and reports all five green, listing the files it changed. + +## Step 6 — Verify → the human checks + +- **Evidence:** all five tests pass; coverage held; no test or contract was altered. ✓ +- **Concurrency (the key check):** two simultaneous transfers from account A must not both pass the balance check and overdraw it. The reviewer confirms the balance re-check happens *inside* the transaction and that the row is locked for the update — so a race cannot double-spend. ✓ +- **Security:** no hardcoded secrets; inputs validated; no new dependency added. ✓ +- **Architecture:** the change respects the layering in `CONVENTIONS.md`. ✓ +- **Outcome recorded:** `PASS`, reviewed by the senior engineer. + +## The loop — observe + +Released behind a feature flag to 5% of users. Monitored: + +- transfer error rate (target: well under 0.1% of attempts); +- the rate of each rejection — a spike in `insufficient_funds` would suggest a UX problem (users not seeing their balance) rather than a code defect; +- latency of the atomic update under load. + +A week later, telemetry shows an unexpectedly high `forbidden` rate. The `6_observe` prompt clusters it: users are trying to transfer *into* a shared account they can see but do not own. That observation becomes a `SPEC.md` delta — "support transfers into accounts I am authorized on, not only accounts I own" — and the flow returns to Step 1 for the next cycle. + +--- + +This is the whole method in one feature: four artifacts written in order, an AI build bounded by them, a verification grounded in evidence plus the one check tests miss, and a loop that turns production reality into the next specification. diff --git a/.add/docs/appendix-e-checklists.md b/.add/docs/appendix-e-checklists.md new file mode 100644 index 000000000..ce753f214 --- /dev/null +++ b/.add/docs/appendix-e-checklists.md @@ -0,0 +1,80 @@ +# Appendix E · Checklists + +[← Appendix D Worked example](./appendix-d-worked-example.md) · [Contents](./README.md) · Next: [Appendix F Requirements matrix →](./appendix-f-requirements-matrix.md) + +Every exit check in the book, collected for quick use. Print this page. + +--- + +## Setup (once per project) + +- [ ] Pipeline runs and is green on the empty skeleton. +- [ ] AI model pinned in `MODEL_REGISTRY.md`. +- [ ] Dependency allow-list exists; pipeline fails on anything outside it. +- [ ] `playbook/` contains the six prompts. + +## Step 1 — Specify + +- [ ] Every required behavior stated explicitly. +- [ ] Every rejection has a named error code. +- [ ] Success state-change described. +- [ ] Assumptions ranked lowest-confidence first; the 1–2 most-likely-wrong ⚠-flagged with why + cost (or an honest "none material" that still names the single biggest risk). + +## Step 2 — Scenarios + +- [ ] Every "Must" rule has a scenario. +- [ ] Every "Reject" rule has a scenario. +- [ ] Each result is a specific, observable fact. +- [ ] Rejections assert what must stay unchanged. + +## Step 3 — Contract + +- [ ] Contract versioned and `FROZEN`. +- [ ] Contract tests pass against the mock. +- [ ] Names match the glossary. +- [ ] Every spec rejection has a contracted response. + +## Step 4 — Tests + +- [ ] One test per scenario. +- [ ] Suite runs in the pipeline and is red for the right reason. +- [ ] Tests assert behavior, not internals. +- [ ] Coverage target recorded. + +## Step 5 — Build + +- [ ] All tests pass. +- [ ] Coverage did not decrease. +- [ ] No test or contract modified by the AI. +- [ ] No package outside the allow-list added. +- [ ] Change is small enough to review in full. + +## Step 6 — Verify + +- [ ] All tests pass (the evidence). +- [ ] Concurrency/timing of the risky operation is safe. +- [ ] No exposed secrets, injection, or unexpected dependencies. +- [ ] Layering and dependencies follow `CONVENTIONS.md`. +- [ ] A person reviewed and approved. +- [ ] Outcome recorded (`PASS` / `RISK-ACCEPTED` / `HARD-STOP`). + +## The loop + +- [ ] Released behind a flag or gradual rollout. +- [ ] Scenarios reused as production monitors. +- [ ] Learnings written back as a `SPEC.md` delta. + +--- + +## Master shippable checklist + +A feature is shippable only when all are true: + +- [ ] Spec complete: behavior stated, rejections named, assumptions ranked lowest-confidence first with the biggest risk flagged. +- [ ] Every rule has a scenario. +- [ ] Contract frozen; contract tests green. +- [ ] A test per scenario; suite was red before the build. +- [ ] All tests green; coverage held; tests and contract untouched by the AI. +- [ ] Concurrency, security, and architecture checked by a person. +- [ ] Gate outcome recorded with an accountable owner. +- [ ] Released behind a flag, with monitors in place. diff --git a/.add/docs/appendix-f-requirements-matrix.md b/.add/docs/appendix-f-requirements-matrix.md new file mode 100644 index 000000000..f8d92028f --- /dev/null +++ b/.add/docs/appendix-f-requirements-matrix.md @@ -0,0 +1,171 @@ +# Appendix F · Document requirements matrix (Project → Milestone → Task) + +[← Appendix E Checklists](./appendix-e-checklists.md) · [Contents](./README.md) + +This appendix maps every AIDD document to a three-level project hierarchy, so that at any level a team can answer three questions: **which documents must exist, who owns them, and what proves the level is complete.** It is the traceability backbone of the method — read it alongside the stage-depth matrix in [10 Setup and stages](./10-setup-and-stages.md), which covers *step* depth; this appendix covers *document* requirements. + +--- + +## The three levels + +| Level | What it is | AIDD meaning | Spans | +|-------|-----------|--------------|-------| +| **Project** | the whole product or engagement | the living documentation — documents created once and kept for the life of the product | all milestones | +| **Milestone** | a stage or release | one pass of the flow at a chosen depth: Prototype, POC, MVP, or Production-Ready; groups many tasks | many tasks | +| **Task** | one feature through the flow | a single pass of Specify → … → Verify → Observe; the smallest unit with its own gate records | the seven steps | + +A **project** sets up the living documentation once. A **milestone** is a depth-bounded goal that groups tasks and has its own entry and exit document gates. A **task** is one feature, and it produces the per-feature artifacts. + +## How the hierarchy decomposes + +```mermaid +flowchart TD + P["PROJECT — the product
PROJECT.md (foundation) · CONVENTIONS · GLOSSARY · MODEL_REGISTRY · allowlist · playbook"] + P --> M1["MILESTONE · Prototype"] + P --> M2["MILESTONE · POC"] + P --> M3["MILESTONE · MVP"] + P --> M4["MILESTONE · Production-Ready"] + M3 --> T1["TASK · Transfer between accounts
SPEC · feature · contract · tests · code · gate records"] + M3 --> T2["TASK · View balance"] + M3 --> T3["TASK · Transaction history"] + classDef p fill:#F1EFE8,stroke:#5F5E5A,color:#2C2C2A; + classDef m fill:#FAEEDA,stroke:#BA7517,color:#633806; + classDef t fill:#E6F1FB,stroke:#185FA5,color:#042C53; + class P p; class M1,M2,M3,M4 m; class T1,T2,T3 t; +``` + +--- + +## Matrix 1 — Documents by level (ownership and lifespan) + +Which document lives at which level, who is accountable for it, and how long it lasts. + +| Document | Level | Created | Lifespan | Accountable owner | +|----------|:-----:|---------|----------|-------------------| +| `PROJECT.md` (foundation: domain · spec · UI/UX) | Project | setup, grows | whole project | Product / Architect | +| `CONVENTIONS.md` | Project | setup | whole project | Architect / Lead | +| `GLOSSARY.md` | Project | setup, grows | whole project | Product / Domain | +| `MODEL_REGISTRY.md` | Project | setup | whole project | Architect / Lead | +| `dependencies.allowlist` | Project | setup | whole project | Security | +| `playbook/*.md` (prompts) | Project | setup, versioned | whole project | Eng Lead | +| Stage plan / roadmap | Milestone | per milestone | the milestone | EM / Delivery | +| Milestone exit report | Milestone | milestone end | the milestone | EM / Delivery | +| `SLO.md` (objectives) | Milestone (MVP+) | from MVP | from MVP onward | DevOps / SRE | +| `SPEC.md` | Task | per feature | living | Product / Domain | +| `features/*.feature` | Task | per feature | living | QA / Test | +| `contracts/*.md` | Task → **Project** | per feature, then frozen | living doc (promoted to project) | Architect / Lead | +| `tests/*` | Task | per feature | living | QA / Engineer | +| Source code | Task | per feature | **disposable** | Engineer | +| Gate outcome records | Task | per step | kept for audit | the reviewer | + +> Note the one promotion: a **contract** is authored at task level but, once frozen, becomes part of the project's living documentation — other tasks depend on it. That promotion is why a contract change is a project-level change request, not a task-local edit. + +--- + +## Matrix 2 — Documents required by milestone + +Which documents must exist, and at what depth, to **exit** each milestone. Depth: **Deep** · **Core** · **Light** · **—** (not required). + +| Document | Prototype | POC | MVP | Production-Ready | +|----------|:---------:|:---:|:---:|:----------------:| +| `CONVENTIONS.md` | Light | Core | Required | Required | +| `GLOSSARY.md` | seed | Core | Required | Required | +| `MODEL_REGISTRY.md` | Required | Required | Required | Required | +| `dependencies.allowlist` | optional | Required | Required | Required | +| `playbook/*.md` | Required | Required | Required | Required | +| `SPEC.md` | Light | Deep (risky slice) | Required (full) | Required (full) | +| Design: flows + screen states | **Deep** | Light | Core | Deep | +| `features/*.feature` | — | Core | Required | Exhaustive | +| `contracts/*.md` (frozen) | — | Core (risky slice) | Required (frozen) | Required (versioned) | +| `tests/*` | — | Core | Core | Full coverage | +| `SLO.md` | — | — | Light | Required | +| Gate outcome records | — | Core | Required | Required (all `HARD-STOP`) | +| Operate / observe report | — | — | Light | Required | +| Milestone exit report | Light | Core | Required | Required | + +**Reading it:** a Prototype exits on a deep design and little else; a POC adds a deep spec, core scenarios/contract/tests on the risky slice; an MVP requires the full per-feature document set plus light operations; Production requires everything at full depth with operations and audit-grade gate records. + +--- + +## Matrix 3 — Documents required per task (the seven steps) + +Every task, regardless of milestone, produces this artifact chain. The depth varies by milestone (Matrix 2); the *sequence and exit gate* do not. + +| Step | Required document | Exit gate (the proof) | Detail | +|------|-------------------|------------------------|--------| +| 1 Specify | `SPEC.md` | rules + named rejections, assumptions ranked lowest-confidence first (biggest risk ⚠-flagged) | [03](./03-step-1-specify.md) | +| 2 Scenarios | `features/.feature` | one scenario per rule | [04](./04-step-2-scenarios.md) | +| 3 Contract | `contracts/.md` | frozen + contract tests green | [05](./05-step-3-contract.md) | +| 4 Tests | `tests/_*` | one test per scenario, red first | [06](./06-step-4-tests.md) | +| 5 Build | source code + evidence bundle | all tests green, nothing weakened | [07](./07-step-5-build.md) | +| 6 Verify | gate outcome record | `PASS` / `RISK-ACCEPTED` / `HARD-STOP` (auto-resolved on evidence under `autonomy: auto`; security always escalates) | [08](./08-step-6-verify.md) | +| 7 Observe | `TASK.md` §7 OBSERVE block | released behind a flag; scenario-monitors live; spec delta + lessons learned captured | [09](./09-the-loop.md) | + +A task is **done** when the build's documents exist and the Verify record reads `PASS` (or a signed `RISK-ACCEPTED`); the seventh step — **Observe** (§7) — then runs in production and feeds the next loop's Specify. See the master shippable checklist in [Appendix E](./appendix-e-checklists.md). + +--- + +## Matrix 4 — Executable proofs (the claims the engine enforces) + +The rows above are the method's *promises*. A promise a tool quietly breaks is worse than none — so the `add` engine ships a proof-harness: each invariant below is pinned by an automated test that fails loudly if the **Story** (this book) and the **State** (the engine) drift apart. This table is the coverage *so far*, not a completeness claim — but the minimalism-and-coverage audit has now run once over Matrices 1–3 (see **Sweep findings** below); what it could cheaply prove, it added; what it deliberately left unenforced, it recorded. + +| Claim (where it lives) | The engine enforces | Proof test | +|------------------------|---------------------|------------| +| No silent skips (principle 7) · "done only when Verify reads `PASS`" (Matrix 3) | `gate PASS` is **refused** unless the task has reached `verify` | `test_gate_pass_refused_before_verify` | +| A passed task is genuinely done | `gate PASS` at `verify` advances to `done` | `test_gate_pass_at_verify_reaches_done` | +| Deliberate ≠ silent | the explicit `phase` command is a logged escape hatch the guardrail does not block | `test_phase_override_escape_hatch` | +| "A security finding is ALWAYS `HARD-STOP`" | `HARD-STOP` is recordable from any phase and never forces `done` | `test_hardstop_recordable_mid_build` | +| "done … or a signed `RISK-ACCEPTED`" (Matrix 3) | `gate RISK-ACCEPTED` at `verify` advances to `done` (same guard as `PASS`) | `test_risk_accepted_complete_reaches_done` | +| A waived task **can complete its milestone** (the point of the waiver) | the completeness predicate counts a signed `RISK-ACCEPTED` as done, so `milestone-done` / `ready` / `check` / `archive` accept it — it does not silently block | `test_milestone_done_accepts_a_waived_task` · `test_check_tolerates_a_recorded_waiver` | +| A waiver is **signed** (owner · ticket · expiry) | `gate RISK-ACCEPTED` is refused without all three; they are stored in state | `test_risk_accepted_requires_waiver` · `test_risk_accepted_partial_waiver_refused` | +| A waiver can **expire** — a lapsed one is caught, not trusted forever | `check` **FAILS** a `RISK-ACCEPTED` task whose stored `expires` is before today; fail-closed on a missing/unparseable date (`waiver_expired`) | `test_check_flags_expired_waiver` · `test_check_passes_unexpired_waiver` · `test_check_failclosed_on_unparseable_expires` | +| **The Story is never auto-loaded** (principle 9, the *Minimal* pillar) | **no** command reads a `docs/` chapter at runtime — and the spy runs *every* subcommand the parser exposes, so "no command" is universal, not a subset; a project with **no** `docs/` runs the whole lifecycle | `test_full_lifecycle_runs_with_no_story` · `test_no_command_reads_a_docs_chapter` · `test_every_subcommand_is_covered` | +| The book's gate outcomes are the engine's | `PASS` · `RISK-ACCEPTED` · `HARD-STOP` exist in both prose and `GATES` | `test_book_gate_outcomes_match_engine` | + +The tests are the source of truth; this table is their index. If a row here is ever unproven, that is a gap in the method, not a detail — the proof-harness exists to make such gaps fail loudly. (Tests: `add-method/tooling/test_proof_harness.py`, `test_waiver.py`.) + +**Now closed:** an earlier version of this table flagged a `RISK-ACCEPTED` gap — the engine advanced only `PASS` to `done`, so a waived task could not complete its milestone, and the waiver fields were uncaptured. The `RISK-ACCEPTED` rows above close it: a signed waiver (owner · ticket · expiry) now completes a verify-phase task and is stored in state for a later `check` to expire. Closing it took *two* edits, not one — advancing the gate to `done` was necessary but not sufficient, because the shared completeness predicate (`milestone-done` / `ready` / `check` / `archive` all read it) still counted only `PASS`; a waived task reached `done` yet silently blocked its milestone until that predicate was taught to count a signed `RISK-ACCEPTED` too. The end-to-end row above is what catches that class of half-fix — proving the *task* completes is not proving the *milestone* can. The pattern that found it — book-claim → engine-enforces → named test — is the standing way to audit the remaining rows. + +**Sweep findings (minimalism-and-coverage audit, v2):** the audit walked Matrices 1–3 for claims the engine *could* enforce but did not yet prove. + +- **Proved and added** (rows above): the *Minimal* pillar's headline — "the Story is never auto-loaded" (principle 9) — was written but unproven; it is now pinned behaviorally (the engine runs the whole lifecycle with no `docs/` present, and a read-spy over *every* subcommand confirms none reads a chapter at runtime). And waiver **expiry**, which Matrix 4 already promised the state captured "for a later `check` to expire," is now enforced. +- **Recorded, deliberately *not* enforced:** Matrix 3 says a task is done only when "all six documents exist." The engine checks that `TASK.md` *exists* and that its phase marker matches state — it does **not** parse the file to confirm each of the seven sections is filled. Teaching it to grade section completeness would push the engine toward reading and judging the Story it is supposed to keep off the runtime path — an anti-minimal move. The reviewer owns section completeness at the Verify gate (the human-led half of the method); the engine owns the cheap structural invariants. This is a chosen boundary, not an oversight. +- **Lean check:** the audit confirmed `state.json` carries no redundant per-task fields — `title`, `phase`, `gate`, `milestone`, `depends_on`, the two timestamps, and a `waiver` only once one is signed; nothing to trim. A clean bill is a finding too. + +--- + +## Worked example — the hierarchy filled in + +- **Project:** *Mobile Banking App.* Living documentation: `CONVENTIONS.md`, `GLOSSARY.md` (defines *account*, *balance*, *transfer*), `MODEL_REGISTRY.md`, `dependencies.allowlist`, `playbook/`. +- **Milestone:** *MVP — core money movement.* Exit requires the full per-feature document set for each task below, plus a light `SLO.md` and a milestone exit report. + - **Task:** *Transfer between own accounts* → `SPEC.md`, `features/transfer.feature`, `contracts/transfer.md` (frozen at v1), `tests/transfer_test.py`, code, and a `PASS` gate record. (The full set is in [Appendix D](./appendix-d-worked-example.md).) + - **Task:** *View balance* → its own SPEC, feature, contract, tests, code, record. + - **Task:** *Transaction history* → its own set. + +When all three tasks read `PASS` and the milestone documents exist, the MVP milestone exits — and the frozen `transfer` contract is now a project-level living-documentation artifact the next milestone builds on. + +--- + +## Traceability chain + +The hierarchy gives a clean line of evidence from a business goal down to a passing test — which is what makes an AIDD project auditable: + +``` +PROJECT goal "let customers move their own money safely" + └─ MILESTONE (MVP) "core money movement" + └─ TASK "transfer between own accounts" + └─ SPEC rule "source must have enough balance" + └─ SCENARIO "insufficient funds -> rejected, no change" + └─ TEST test_insufficient_funds (was red, now green) + └─ VERIFY record PASS (atomicity checked) +``` + +Every level points down to the evidence beneath it and up to the goal above it. To audit any claim — "we handle insufficient funds correctly" — you follow the chain to a specific test and a specific gate record. Nothing rests on assertion. + +--- + +*This matrix is the requirements view of the method. The flow ([Part II](./02-the-flow.md)) tells you the order; the stages ([10](./10-setup-and-stages.md)) tell you the depth; this appendix tells you, at each level of the project, exactly which documents must exist and who owns them.* + +--- + +*End of book. AIDD is one repeatable loop — Specify → Scenarios → Contract → Tests → Build → Verify → observe, then repeat. People own direction and verification; the AI owns the build; the artifacts are the asset and the code is disposable.* diff --git a/.add/docs/appendix-g-references.md b/.add/docs/appendix-g-references.md new file mode 100644 index 000000000..b32909e68 --- /dev/null +++ b/.add/docs/appendix-g-references.md @@ -0,0 +1,106 @@ +# Appendix G — References & Lineage + +ADD did not appear from nowhere. It sits at the meeting point of three currents: +the **recursive self-improvement** thesis (AI that helps build the next AI), the +**spec-driven development** movement (the specification, not the code, is the +source of truth), and a decade of **agentic + tests-first** research showing that +a generate→check→refine loop, constrained by executable tests, turns fluent model +output into trustworthy software. This appendix is the curated, verified grounding +for that lineage — every source below is reachable and annotated with a `↔ ADD:` +line saying exactly how it relates to the method. + +**The frame — "closing the loop."** Anthropic's recursive-self-improvement picture +runs from autonomous agents delegating to workers *today* toward a future where +Claude improves Claude. ADD is a deliberately **human-gated, evidence-trusted** +instance of that loop: the AI drives spec→build→verify→observe, but a human owns the +frozen contract and the verify gate, and trust comes from passing tests and +re-resolved evidence — never from a plausible-looking diff. The sources here are +the shoulders that posture stands on. + +The four sections below are the four currents. The comparison table places ADD next +to its two closest peers — GitHub's **spec-kit** and **GSD (Get Shit Done)** — and +names where ADD diverges. Read "How to cite" first; the rest of the book cites into +the keys defined here. + +## How to cite + +The book uses one inline citation form — **author-year** — and every entry's lead +`(Author Year)` *is* its cite-key. Resolve any inline `[…]` to the matching entry below. + +| Authors | Inline form | Example | +|---|---|---| +| one author | `[Surname Year]` | `[Schmidhuber 2003]` | +| two authors | `[Surname & Surname Year]` | `[Mathews & Nagappan 2024]` | +| three or more | `[Surname et al. Year]` | `[Zelikman et al. 2023]` | +| an organisation | `[Org Year]` | `[Anthropic 2026a]` · `[GitHub 2025]` | +| several at once | joined by `; ` | `[Schmidhuber 2003; Zelikman et al. 2023]` | +| same author, same year | add a `Year`-letter suffix | `[Anthropic 2025a]` / `[Anthropic 2025b]` | + +The 3+-author rule becomes **et al.**; an organisation stands in as the author +when no individual is credited; and when two org-authored sources collide on a year +(several Anthropic 2025/2026 items do, below) a trailing letter disambiguates them. +There is exactly one entry per cite-key. + +## spec-kit ↔ ADD (and GSD) + +ADD shares the spec-first DNA of GitHub's **spec-kit** and the Claude-Code, +context-rot-fighting niche of **GSD**. The phase models line up closely: + +| ADD phase | spec-kit command | GSD phase | +|---|---|---| +| foundation · principles | `/speckit.constitution` → `constitution.md` | (project setup / `CLAUDE.md`-level) | +| §1 specify (what / why) | `/speckit.specify` → `spec.md` | **discuss** — capture decisions before planning | +| §3 contract (how, frozen) | `/speckit.plan` → `plan.md`, `contracts/` | **plan** — research, decompose, fit fresh context | +| milestone tasks / waves | `/speckit.tasks` → `tasks.md` | (phases → parallel waves) | +| §5 build | `/speckit.implement` | **execute** — parallel waves, fresh 200k-token context each | +| §6 verify | `/speckit.analyze` + `/speckit.checklist` | **verify** — walk what was built, fix before declaring done | + +**Where ADD diverges.** spec-kit stops at `implement`; GSD ends at verify (GSD Core +adds a fifth *ship* phase). ADD closes the loop past both by adding three things +neither has as a first-class gate: a **failing-tests-first** gate (§4 — no build +starts until the tests are red for the right reason), an **observe→`fold`** +self-improvement step (§7 — confirmed learnings consolidate into a versioned foundation), +and an engine-tracked **dynamic goal-loop** that will hold a milestone open and +reopen tasks until its exit criteria are met. ADD also deliberately targets **less +doc-time than GSD** — a lean foundation and one human approval per task, rather than +a document per phase. The shared lineage is real; the tests-first gate, the `fold`, +and the goal-loop are ADD's contribution. + +## 1. Recursive self-improvement + +- **When AI builds itself** (Favaro & Clark 2026) — https://www.anthropic.com/institute/recursive-self-improvement — essay. The RSI thesis: by 2026 >80% of code merged at Anthropic was Claude-authored and the 50%-task time-horizon keeps doubling; recursive self-improvement would shift humans from builders to validators. ↔ ADD: the seed source — ADD is the human-gated, evidence-trusted way to run a spec→build→verify→observe loop while the human stays the validator. +- **Automated Alignment Researchers** (Anthropic 2026a) — https://www.anthropic.com/research/automated-alignment-researchers — research. Nine parallel Claude agents recovered ~97% of the human-expert gap on an alignment task in 5 days versus 7 for the human team. ↔ ADD: the strongest evidence the recursive loop is not speculative — parallel agents under review are exactly ADD's wave-plus-verify shape. +- **Machines of Loving Grace** (Amodei 2024) — https://www.darioamodei.com/essay/machines-of-loving-grace — essay. A "country of geniuses in a datacenter," argued with a measured, bounded position on recursive self-improvement. ↔ ADD: the intent framing behind milestoning — bound the loop with human direction rather than let it run open. +- **Gödel Machines: Self-Referential Universal Problem Solvers** (Schmidhuber 2003) — https://arxiv.org/abs/cs/0309048 — paper. A provably-optimal self-modifying agent that rewrites itself only when it can prove the rewrite helps. ↔ ADD: the mathematical anchor of the lineage — and a precedent for "only change on proof," which ADD enforces socially via the never-weaken-a-test rule. +- **STOP: Self-Taught Optimizer** (Zelikman et al. 2023) — https://arxiv.org/abs/2310.02304 — paper. A scaffolding program recursively improves the code that improves code. ↔ ADD: the algorithmic kin of the `fold` step — consolidate confirmed learnings back into the method that produced them. +- **Self-Refine: Iterative Refinement with Self-Feedback** (Madaan et al. 2023) — https://arxiv.org/abs/2303.17651 — paper. Generate→critique→refine with the same model lifts quality ~20% with no extra training. ↔ ADD: the micro-loop inside build→verify — produce, check against the contract, refine. +- **Self-Rewarding Language Models** (Yuan et al. 2024) — https://arxiv.org/abs/2401.10020 — paper. A model acts as its own reward judge to improve across iterations. ↔ ADD: the risk ADD answers — a self-judging loop needs an external gate; ADD makes tests and a human the reward signal, not the model's own opinion. +- **Reflexion: Language Agents with Verbal Reinforcement Learning** (Shinn et al. 2023) — https://arxiv.org/abs/2303.11366 — paper. Agents keep verbal reflections in episodic memory and retry, reaching 91% on HumanEval. ↔ ADD: the principle behind "reopen the task if criteria are unmet" — a failed check becomes feedback for the next attempt, not a dead end. +- **Voyager: An Open-Ended Embodied Agent with LLMs** (Wang et al. 2023) — https://arxiv.org/abs/2305.16291 — paper. An auto-curriculum agent that grows a reusable skill library over time. ↔ ADD: the growing foundation — each milestone's consolidated deltas are ADD's accumulating skill library. +- **AlphaEvolve: A Coding Agent for Scientific and Algorithmic Discovery** (Novikov et al. 2025) — https://arxiv.org/abs/2506.13131 — paper. An evolutionary coding agent that beat a long-standing matrix-multiplication record and shipped a production scheduler improvement. ↔ ADD: the end-state evidence — a generate-and-verify loop can exceed human baselines when every candidate is checked. + +## 2. Autonomous & agentic workflows + +- **Building Effective Agents** (Schluntz & Zhang 2024) — https://www.anthropic.com/research/building-effective-agents — blog. The canonical taxonomy: prompt-chaining, routing, orchestrator-workers, and the evaluator-optimizer loop. ↔ ADD: the architecture cite — evaluator-optimizer is build→verify→refine; orchestrator-workers is ADD's wave parallelism. +- **Enabling Claude Code to work more autonomously** (Anthropic 2025a) — https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously — news. Checkpoints, subagents, hooks, background tasks, and `/rewind` rollback. ↔ ADD: checkpoint/rewind is the rollback strategy behind phase gates; hooks are where the engine enforces them. +- **How we built our multi-agent research system** (Anthropic 2025b) — https://www.anthropic.com/engineering/multi-agent-research-system — blog. An Opus lead orchestrating Sonnet subagents, with an LLM acting as judge, lifting task performance ~90%. ↔ ADD: the lead-plus-subagents-plus-judge pattern is exactly ADD's wave execution under a verify gate. +- **ReAct: Synergizing Reasoning and Acting in Language Models** (Yao et al. 2022) — https://arxiv.org/abs/2210.03629 — paper. Interleaving think→act→observe turns a model into an agent. ↔ ADD: the base loop every ADD phase runs on. +- **Toolformer: Language Models Can Teach Themselves to Use Tools** (Schick et al. 2023) — https://arxiv.org/abs/2302.04761 — paper. Self-supervised learning of when and how to call external tools. ↔ ADD: the capability that lets an agent run its own tests, linters, and builds — the evidence ADD trusts. +- **SWE-agent: Agent–Computer Interfaces Enable Automated Software Engineering** (Yang et al. 2024) — https://arxiv.org/abs/2405.15793 — paper. A designed agent–computer interface materially improves autonomous issue resolution. ↔ ADD: the structured agent↔environment contract — ADD's `add.py` engine is that interface for the method. +- **The AI Scientist: Towards Fully Automated Open-Ended Scientific Discovery** (Lu et al. 2024) — https://arxiv.org/abs/2408.06292 — paper. A full idea→experiment→write→review research loop at ~$15 per paper. ↔ ADD: the research analog of ADD's loop — and a reminder that an automated reviewer is the weak link a human gate protects. + +## 3. Spec-driven development & spec-kit + +- **GitHub Spec Kit** (GitHub 2025) — https://github.com/github/spec-kit — repo. The reference SDD toolkit: the phase model is `constitution` → `specify` → `plan` → `tasks` → `implement`, with the spec as the executable source of truth. ↔ ADD: the closest spec-first sibling — ADD's specify and contract phases map onto specify and plan; see the comparison table for the divergence. +- **Spec-driven development with AI: get started with a new open-source toolkit** (Delimarsky 2025) — https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/ — blog. The spec-kit launch post; frames `tasks` as "TDD for your AI agent." ↔ ADD: independent articulation of why decomposing a spec into checkable units beats one big prompt. +- **Spec-driven development: using Markdown as a programming language when building with AI** (Vesely 2025) — https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/ — blog. Spec-as-source, with context-rot named as the failure SDD exists to solve. ↔ ADD: the rationale for the frozen contract — a stable written spec is what survives when the model's context degrades. +- **Get Shit Done (GSD)** (GSD 2025) — https://github.com/open-gsd/gsd-core — repo. A meta-prompting, context-engineering, spec-driven system for Claude Code; its `discuss` → `plan` → `execute` → `verify` cycle runs each phase in a fresh subagent context to fight context-rot (originally `gsd-build/get-shit-done`, now continued as GSD Core). ↔ ADD: ADD's closest peer — same Claude-Code, context-rot niche; ADD diverges with the tests-first gate, the observe→`fold` step, and the dynamic goal-loop, and aims for less doc-time than GSD. +- **Beyond Vibe Coding: Amazon Introduces Kiro, the Spec-Driven Agentic IDE** (InfoQ 2025) — https://www.infoq.com/news/2025/08/aws-kiro-spec-driven-agent/ — blog. Kiro structures work as requirements→design→tasks with execution hooks. ↔ ADD: cross-vendor confirmation that spec-first is converging across the industry, not a single-tool idea. +- **Spec-Driven Development: From Code to Contract in the Age of AI Coding Assistants** (Piskala 2026) — https://arxiv.org/abs/2602.00180 — paper. A taxonomy of SDD rigor — Spec-First, Spec-Anchored, Spec-as-Source — reporting human-refined specs can cut LLM code errors substantially, with BDD as SDD's ancestor. ↔ ADD: places ADD as "Spec-Anchored" and gives the academic vocabulary for the contract-freeze decision. + +## 4. Tests-first & verification + +- **Test-Driven Development for Code Generation** (Mathews & Nagappan 2024) — https://arxiv.org/abs/2402.13521 — paper. Supplying tests alongside the prompt measurably lifts pass rates on MBPP and HumanEval. ↔ ADD: the empirical backbone of the failing-tests-first gate — tests as the constraint that makes generation verifiable. +- **SWE-bench: Can Language Models Resolve Real-World GitHub Issues?** (Jimenez et al. 2023) — https://arxiv.org/abs/2310.06770 — paper. 2,294 real issues judged by whether the project's own tests pass; <2% solved at release. ↔ ADD: the yardstick that proves the point — "done" means the tests pass, which is exactly how ADD gates a feature. +- **Our framework for developing safe and trustworthy agents** (Anthropic 2025c) — https://www.anthropic.com/news/our-framework-for-developing-safe-and-trustworthy-agents — news. Five principles: human control, transparency, alignment, privacy, and security. ↔ ADD: the frozen-contract gate and never-weaken-a-test rule are human control and transparency made concrete; the security HARD-STOP is the security principle. +- **Responsible Scaling Policy v3.0** (Anthropic 2026b) — https://www.anthropic.com/news/responsible-scaling-policy-v3 — policy. The AI Safety Level framework; ASL-3 governs autonomous R&D capability. ↔ ADD: the governance ceiling that makes ADD's discipline necessary — as the loop gets more capable, the gates and the human-owned verify matter more, not less. diff --git a/.add/milestones/v1-shared-nothing/MILESTONE.md b/.add/milestones/v1-shared-nothing/MILESTONE.md new file mode 100644 index 000000000..4ad0bc816 --- /dev/null +++ b/.add/milestones/v1-shared-nothing/MILESTONE.md @@ -0,0 +1,36 @@ +# MILESTONE: Shared-Nothing Integrity & Cross-Shard Latency + +goal: a 4-shard Moon serves cross-shard traffic without per-command global locks and without the 1ms monoio reply floor, with measured multi-shard scaling improvement over the v0.3.0 baseline +rationale: intake bucket `new-major` — the user asked to "enhance Moon architecture following the 2026-06 architecture review priorities"; no milestone exists yet, and the review's top-leverage themes (priorities 1 · 2 · 5: ShardSlice completion, monoio wake floor, lock quick-wins) form one coherent outcome: restore the shared-nothing model the architecture claims. +stage: production · status: active · created: 2026-06-11 + +> SDD living doc for this milestone. Keep it THIN: breadth, shared decisions, and +> exit criteria only — per-task detail lives in each `.add/tasks//TASK.md`, +> written just-in-time. Update this doc whenever a task reveals a milestone gap. + +## Scope +In: review priority 5 (lock/syscall quick-wins batch) · priority 2 (eventfd cross-thread wake + drain-until-empty, removing the 1ms cross-shard reply floor) · priority 1 (complete the ShardSlice migration; delete the Arc cross-shard read path and the dual `is_initialized()` branches) +Out: FT.SEARCH off-event-loop execution (review priority 3 → v2) · WAL group commit / the 11× appendfsync=always collapse (priority 4 → v2) · I/O-path copy elimination & PBUF_RING (review theme 3 → v2) · correctness-flavored debt (AOF rewrite drop window, MVCC delete_lsn, 16-bit LRU clock → tracked separately) · any new command or protocol surface · SortedSet/CompactValue data-structure redesign (theme 6) + +## Shared decisions & glossary deltas (living — every task must honor these) +- "shared-nothing per shard" (GLOSSARY: shard, SPSC mesh): cross-shard state changes travel as ShardMessage only; a task may not add a new cross-thread lock to fix an old one. +- "hot path" rule holds throughout: no new allocation or lock on command dispatch / parse / event loop / io drivers. +- Behavior parity is frozen: RESP responses, INFO fields, and `scripts/test-consistency.sh` (132 tests × 1/4/12 shards) must be byte-identical before/after every task. +- Benchmark evidence comes from the OrbStack `moon-dev` Linux VM only (CLAUDE.md rule); each task records before/after numbers from `scripts/bench-compare.sh`. +- Dual-runtime: every change compiles and passes tests under `runtime-monoio` AND `runtime-tokio,jemalloc`. + +## Shared / risky contracts (freeze these first) +- `ShardSlice` as the ONLY per-shard state access path (the post-migration shape: no `Arc` reads cross-shard, no dual branches) -> owning task `shardslice-migration` +- eventfd wake protocol between shards (who signals, when, idempotency under coalescing) -> owning task `spsc-wake-floor` + +## Tasks (breadth-first decomposition; detail lives in each TASK.md) +- [ ] hotpath-lock-quickwins depends-on: none — remove per-command global locks/atomics (OnceLock WAL sender, lock-free repl offsets, per-shard metrics counters, backlog bulk-append, VecDeque inflight sends, key_hash prune) + TCP_NODELAY on accept; establishes the measurement baseline +- [ ] spsc-wake-floor depends-on: hotpath-lock-quickwins — eventfd-based cross-thread wake for monoio replies + SPSC drain-until-empty; removes the ~1ms cross-shard latency floor +- [ ] shardslice-migration depends-on: hotpath-lock-quickwins — complete the ShardSlice migration: route remaining cross-shard reads through SPSC, delete Arc foreign-thread access and every `is_initialized()` dual branch + +## Exit criteria (observable; map each to the task that delivers it) +- [ ] Lock inventory: zero global lock acquisitions on the per-command write path for metrics, replication offsets, WAL sender, client registry batch-update — verified by a recorded audit + tests (← hotpath-lock-quickwins) +- [ ] `scripts/bench-compare.sh` on moon-dev shows no regression at 1 shard and measured improvement at 4 shards vs the recorded v0.3.0 baseline (← hotpath-lock-quickwins · spsc-wake-floor · shardslice-migration) +- [ ] Cross-shard single-key SET/GET p99 on monoio drops below 1ms (the old floor) in a recorded latency run (← spsc-wake-floor) +- [ ] `grep -r "is_initialized()" src/shard/` returns zero dual-path branches; `ShardDatabases` no longer exposes cross-shard read access (← shardslice-migration) +- [ ] `scripts/test-consistency.sh` passes 132/132 on 1/4/12 shards and full CI matrix is green after each task (← all three) diff --git a/.add/state.json b/.add/state.json new file mode 100644 index 000000000..9b0e80f64 --- /dev/null +++ b/.add/state.json @@ -0,0 +1,40 @@ +{ + "project": "moon", + "stage": "production", + "active_task": "hotpath-lock-quickwins", + "active_milestone": "v1-shared-nothing", + "tasks": { + "hotpath-lock-quickwins": { + "title": "Eliminate per-command global locks & syscall-level quick wins", + "phase": "build", + "gate": "none", + "milestone": "v1-shared-nothing", + "depends_on": [], + "created": "2026-06-11T03:23:03+00:00", + "updated": "2026-06-11T03:36:43+00:00", + "flag_verified": true + } + }, + "milestones": { + "v1-shared-nothing": { + "title": "Shared-Nothing Integrity & Cross-Shard Latency", + "goal": "a 4-shard Moon serves cross-shard traffic without per-command global locks and without the 1ms monoio reply floor, with measured multi-shard scaling improvement over the v0.3.0 baseline", + "stage": "mvp", + "status": "active", + "created": "2026-06-11T03:23:03+00:00", + "updated": "2026-06-11T03:23:03+00:00" + } + }, + "created": "2026-06-11T03:18:21+00:00", + "updated": "2026-06-11T03:36:43+00:00", + "setup": { + "locked": true, + "locked_at": "2026-06-11T03:28:00+00:00", + "locked_by": "Tin Dang", + "layers": [ + "foundation", + "scope", + "contract" + ] + } +} diff --git a/.add/tasks/hotpath-lock-quickwins/TASK.md b/.add/tasks/hotpath-lock-quickwins/TASK.md new file mode 100644 index 000000000..c7317a1d6 --- /dev/null +++ b/.add/tasks/hotpath-lock-quickwins/TASK.md @@ -0,0 +1,218 @@ +# TASK: Eliminate per-command global locks & syscall-level quick wins + +slug: hotpath-lock-quickwins · created: 2026-06-11 · stage: production +phase: build + +> One file = one task. Fill sections top-to-bottom; the `add` skill drives each phase. +> When a phase is unclear, read its book chapter in `.add/docs/` (linked per section). +> The phase marker above is the single source of truth — keep it in sync via `add.py phase`. + +--- + +## 1 · SPECIFY — the rules ▸ docs/03-step-1-specify.md + +Feature: hot-path lock & syscall quick-wins (2026-06 architecture review, priority 5 batch — 7 independent mechanical fixes, each behavior-preserving) +Framings weighed: one batch task with per-item tests (chosen — items are tiny, share one bench baseline, and one PR keeps review cost low) · seven separate tasks (rejected: ceremony exceeds work) · fold into shardslice-migration (rejected: these are independent of the migration and de-noise its measurements) +Must: + + - QW1 TCP_NODELAY: every accepted client socket (tokio accept path AND uring register path) has TCP_NODELAY set; a connection-level test observes nodelay on the accepted fd. + - QW2 WAL sender lock-free: `ShardDatabases::wal_append` / `try_wal_append_required` reach the per-shard sender without acquiring a Mutex (OnceLock or equivalent set-before-accept init); WAL durability semantics of `try_wal_append_required` unchanged (src/shard/shared_databases.rs:159). + - QW3 replication offsets lock-free: per-write offset increment (`increment_shard_offset` / `master_repl_offset`) is reachable without read-locking `RwLock` — offsets distributed as Arc'd atomics at startup (src/shard/spsc_handler.rs:3089, src/replication/state.rs:138). + - QW4 per-shard command counters: `TOTAL_COMMANDS` (and the per-batch `CONNECTED_CLIENTS` touch) become per-shard/per-thread counters aggregated on read; INFO `total_commands_processed` remains exact (src/admin/metrics_setup.rs:401). + - QW5 backlog bulk append: `ReplicationBacklog::append` uses bulk copy (extend/copy_from_slice with wraparound), not a per-byte loop; eviction-at-capacity and offset bookkeeping byte-identical to today (src/replication/backlog.rs:35). + - QW6 inflight sends O(1): the uring per-connection `inflight_sends` reclaims completed sends with O(1) pop_front (VecDeque or ring) preserving completion order (src/shard/uring_handler.rs:346). + - QW7 vector key-map pruning: deleting an indexed vector removes its entries from `key_hash_to_key` AND `key_hash_to_global_id`; map size tracks live-key count, not historical insert count (src/vector/store.rs:192). + - QW8 client registry off the batch path: the per-pipeline-batch `client_registry::update` global write-lock acquisition is removed from the steady-state loop (per-connection atomics or update-on-change); CLIENT LIST / CLIENT KILL behavior unchanged (src/client_registry.rs:80, handler_sharded/mod.rs:1868). + +Reject: + + - any RESP response byte-change, INFO field removal, or test-consistency diff -> "behavior_regression" (the batch is perf-only; parity is frozen) + - a fix that adds a new cross-thread lock, new hot-path allocation, or new unsafe block -> "violates_conventions" + - QW2: WAL append silently succeeding when persistence is configured but channel rejects -> "durability_contract_broken" + +After: + + - Zero global lock acquisitions remain on the per-command write path for: WAL sender, replication offsets, command counters, client-registry batch update (auditable by grep + the new tests). + - A recorded moon-dev bench baseline (bench-compare, 1 + 4 shards) exists from BEFORE the batch, and the after-run shows no 1-shard regression. + - Both runtimes compile and pass: default (monoio) and `--no-default-features --features runtime-tokio,jemalloc`. + +Assumptions — lowest-confidence first: + + ⚠ QW4 assumes no external consumer scrapes `moon_commands_total` at sub-second freshness — per-shard counters aggregate on INFO/scrape read, so instantaneous cross-shard sums may lag by one read. Lowest confidence because the Prometheus exporter path (`counter!` macro) may not support per-shard registration cleanly; if wrong: keep the `metrics` crate counter as-is and only fix the bespoke `TOTAL_COMMANDS` atomic (smaller win, ~zero risk). + ⚠ QW8 assumes CLIENT LIST tolerates last-command metadata updated on-change rather than per-batch — lowest confidence because redis-cli tooling may read `cmd`/`age` fields expecting freshness; if wrong: per-connection atomics (still lock-free) instead of dropping the update. + - [ ] QW1: monoio TcpStream exposes set_nodelay (or we set it via socket2 on the raw fd) on both runtimes — confirm at build. + - [ ] QW6: uring send completions arrive in submission order per connection (current Vec::remove(0) already assumes this) — confirm with existing pipeline tests. + + + + +--- + +## 2 · SCENARIOS — pass/fail cases ▸ docs/04-step-2-scenarios.md + + + +```gherkin +Scenario: nodelay set on accepted connection (QW1) + Given a moon server listening on an ephemeral port (each runtime) + When a client connects + Then the accepted server-side socket reports TCP_NODELAY = true + And the connection serves PING/GET/SET normally + +Scenario: WAL append works lock-free after init (QW2) + Given persistence configured and the WAL sender initialized before accept + When 10 000 SET commands run across 4 threads + Then every append is delivered to the WAL channel (or backpressure reported via try_wal_append_required = false) + And no Mutex is acquired in wal_append (type-level: the field is OnceLock/immutable after init) + +Scenario: WAL required-append still gates mutation (QW2 reject: durability_contract_broken) + Given persistence configured and the WAL channel full + When try_wal_append_required is called + Then it returns false + And the caller-visible contract (skip mutation) is unchanged + +Scenario: replication offsets advance without ReplicationState lock (QW3) + Given a replica attached and writes flowing on every shard + When 1 000 writes execute per shard concurrently with a REPLICAOF state read + Then per-shard offsets and master_repl_offset equal the exact byte totals + And no write path blocks on the ReplicationState RwLock (offsets reachable via Arc'd atomics) + +Scenario: INFO command count exact under concurrency (QW4) + Given a fresh server + When exactly N commands execute spread across 4 shards + Then INFO total_commands_processed reports ≥ N for executed commands with no double-count (exact for the bespoke counter) + And the counter increment touches only shard-local state on the hot path + +Scenario: backlog bulk append byte-identical (QW5) + Given a ReplicationBacklog of capacity C + When appends of sizes [1, C/2, C, C+7, 3C] are applied in sequence + Then buffer contents, start_offset, and end_offset equal the old per-byte implementation for every step (golden test) + And get_range results match for all valid offsets + +Scenario: inflight send reclaim preserves order (QW6) + Given a connection with 1 024 pipelined responses in flight + When SendComplete CQEs arrive in submission order + Then buffers are reclaimed FIFO with O(1) pop (VecDeque) + And all 1 024 responses reach the client intact (existing pipeline integration test stays green) + +Scenario: vector key maps shrink on delete (QW7) + Given an FT index with 100 auto-indexed HSET vectors + When 60 of the keys are deleted (DEL/HDEL) + Then key_hash_to_key and key_hash_to_global_id contain exactly 40 entries + And FT.SEARCH still returns original key names for the surviving 40 + +Scenario: client registry not written per batch (QW8) + Given a connection executing 10 000 pipelined PINGs + When the steady-state loop runs + Then the global REGISTRY write lock is not acquired per batch (update is on-change/atomic) + And CLIENT LIST still shows the connection with correct db and name; CLIENT KILL still terminates it + +Scenario: behavior parity frozen (Reject: behavior_regression) + Given the full batch applied + When scripts/test-consistency.sh runs at 1/4/12 shards and CI matrix runs both runtimes + Then 132/132 consistency tests pass and CI is green + And bench-compare at 1 shard shows no regression beyond run noise +``` + + + + + +--- + +## 3 · CONTRACT — freeze the shape ▸ docs/05-step-3-contract.md + +``` +No new wire surface — the contract is invariants over existing surfaces: + +WIRE (frozen, byte-parity): all RESP responses · INFO fields (total_commands_processed, + connected_clients, master_repl_offset) · CLIENT LIST/KILL semantics · FT.SEARCH key names. + +INTERNAL SHAPES (the change): + ShardDatabases.wal_append_txs : Vec>> -> Vec> + wal_append(shard, bytes) : no lock; no-op when unset + try_wal_append_required(...) -> bool: false ONLY when set && channel-full (unchanged) + ReplicationState offsets -> Arc + handed to each shard at startup; RwLock no longer on the write path + metrics::record_command* -> shard-local counter cell; INFO aggregates with one pass + ReplicationBacklog::append(&[u8]) : bulk copy; observable state machine unchanged (golden) + uring inflight_sends : Vec -> VecDeque, FIFO reclaim + VectorStore delete path : also removes key_hash_to_key + key_hash_to_global_id entries + client_registry::update : leaves the per-batch loop; kill_flag stays Arc + +ERROR CODES (test-visible): behavior_regression · violates_conventions · durability_contract_broken + +Schema: no storage format, WAL record, or persistence layout change. Touched modules: + shard/shared_databases.rs · replication/{state,backlog}.rs · admin/metrics_setup.rs · + shard/uring_handler.rs · vector/store.rs · client_registry.rs · server/conn/* accept paths. +Access pattern: all hot-path reads lock-free post-init; init strictly before first accept. +``` + +Status: FROZEN @ v1 — approved by Tin Dang via baseline lock, 2026-06-11 + +Least-sure flag surfaced at freeze: +- ⚠ [spec] QW4: the Prometheus `counter!` macro path may resist per-shard registration — because the `metrics` crate recorder owns the counter handles globally; if wrong: the win shrinks to the bespoke `TOTAL_COMMANDS` atomic only (smaller but safe fallback). +- ⚠ [contract] QW8: CLIENT LIST may be expected to show per-batch-fresh `cmd`/`age` metadata — because no test pins its freshness; if wrong: fall back to per-connection atomics (still lock-free), not dropping the update. + + + +--- + +## 4 · TESTS — failing-first suite (red) ▸ docs/06-step-4-tests.md + +Coverage target: every Must covered by a red test or a declared pin; QW5 golden model; lock-free internals verified at §6 by code audit (tests assert behavior, not internals). +Plan (one test per scenario, asserting behavior not internals): + + - tests/quickwins_red.rs (compiles + runs today — confirmed 4 passed / 1 failed): + - qw7_vector_key_maps_pruned_on_delete — RED (fails: 100 entries vs 40 live; pruning missing) + - qw5_backlog_append_golden — PIN green (reference per-byte model vs real, offsets + contents + range probes) + - qw2_try_wal_append_required_false_on_full — PIN green (bounded(1) channel; false-on-full gate) + - qw3_replication_offsets_exact — PIN green (4 threads × 1000 writes; exact totals) + - qw4_total_commands_exact — PIN green (4 threads × 5000 record_command; exact delta) + - tests/quickwins_red_api.rs (COMPILE-RED today — confirmed E0433/E0599, missing symbols): + - qw1_accepted_socket_has_nodelay — needs `server::socket_opts::apply_client_socket_opts` + - qw3_offset_handle_advances_without_state_lock — needs `ReplicationState::offset_handle()` + - QW6 (inflight FIFO) + QW8 (CLIENT LIST/KILL parity): covered by existing pipeline integration tests + scripts/test-consistency.sh (declared pins); "no lock per batch / O(1) pop" are internals → §6 audit. + - Parity backstop: scripts/test-consistency.sh 1/4/12 shards + both-runtime CI matrix at verify. + + +Tests live in: `tests/` `quickwins_red.rs` `quickwins_red_api.rs` · red confirmed 2026-06-11 BEFORE build (qw7 runtime-red; api file compile-red). + +--- + +## 5 · BUILD — AI writes code ▸ docs/07-step-5-build.md + +Safety rule (feature-specific): QW2's `try_wal_append_required` false-on-full contract must hold at every commit — a dropped WAL gate is silent data loss. +Code lives in: `src/` (modules listed in §3) +Constraints: do NOT change any test or the contract; allow-list packages only; no new unsafe; both runtimes green; ask if unclear. + +--- + +## 6 · VERIFY — evidence + non-functional review ▸ docs/08-step-6-verify.md + +- [ ] all tests pass (both runtimes) +- [ ] coverage did not decrease +- [ ] no test or contract was altered during build +- [ ] concurrency / timing of the risky operation is safe (loom/atomics review for QW3/QW4) +- [ ] no exposed secrets, injection openings, or unexpected dependencies +- [ ] layering & dependencies follow CONVENTIONS.md +- [ ] a person reviewed and approved the change +- [ ] bench-compare before/after recorded on moon-dev (1 + 4 shards) + +### Deep checks — do not skim +- [ ] WIRING (code) — every new symbol is referenced; record where / how confirmed +- [ ] DEAD-CODE (code) — no new unused or orphaned symbol introduced + +### GATE RECORD +Outcome: +Reviewed by: · date: + +--- + +## 7 · OBSERVE — feed the next loop ▸ docs/09-the-loop.md + +Watch (reuse scenarios as monitors): 4-shard bench delta · INFO counter accuracy in prod runs · WAL backpressure rate +Spec delta for the next loop: + +### Competency deltas + diff --git a/.add/tooling/add.py b/.add/tooling/add.py new file mode 100644 index 000000000..ccb70c541 --- /dev/null +++ b/.add/tooling/add.py @@ -0,0 +1,2899 @@ +#!/usr/bin/env python3 +"""ADD — minimal scaffolder + state tracker for AI-Driven Development. + +One file = one task. This tool generates the per-task TASK.md (which Claude fills +in step by step) and maintains .add/state.json so any fresh session can resume +with `add.py status` instead of re-reading the whole repo. That is the anti- +context-rot core of the ADD method. + +Stdlib only. Writes are atomic (temp + os.replace) and refuse to clobber +existing artifacts unless --force is given. +""" +from __future__ import annotations + +import argparse +import getpass +import json +import os +import re +import sys +import tempfile +from datetime import date, datetime, timezone +from pathlib import Path + +# --- constants --------------------------------------------------------------- + +ROOT_DIRNAME = ".add" +STATE_FILE = "state.json" +MILESTONE_FILE = "MILESTONE.md" +# The project GOAL (v20) is read live from PROJECT.md — never copied into state.json +# (single-source; the foundation is the truth). A missing/blank source degrades to +# this sentinel so the read-only orientation surfaces never blank or crash. +GOAL_UNSET = "(unset — add a 'goal:' line to PROJECT.md)" +STAGES = ("prototype", "poc", "mvp", "production") +# v22 stage-graduation: the read-only cue `status` shows when the MVP is covered. +# Worded as the ACTION (never a file) so it stands before graduate.md exists. +GRADUATION_CUE = "MVP covered → propose graduation" +PHASES = ("specify", "scenarios", "contract", "tests", "build", "verify", "observe", "done") +GATES = ("none", "PASS", "RISK-ACCEPTED", "HARD-STOP") + + +def _phase_index(name: str) -> int: + """Ordinal of a phase in PHASES; used to enforce forward-skip rules.""" + return PHASES.index(name) + +# `add.py guide` copy: per-phase (concrete next action, book chapter to read). +# Keep the action wording aligned with each phase's EXIT line in the TASK template. +PHASE_GUIDE = { + "specify": ("state every rule — Must / Reject (+ named code) / After; rank assumptions lowest-confidence first and flag the biggest risk", + "03-step-1-specify.md"), + "scenarios": ("write one Given/When/Then per Must AND per Reject; every result observable", + "04-step-2-scenarios.md"), + "contract": ("freeze the shape — signature, fields, error codes; names match the glossary", + "05-step-3-contract.md"), + "tests": ("write one failing test per scenario; run them RED for the right reason", + "06-step-4-tests.md"), + "build": ("write the minimum code to pass the tests; change no test and no contract", + "07-step-5-build.md"), + "verify": ("run the suite + non-functional checks, then record the gate", + "08-step-6-verify.md"), + "observe": ("note what to watch + the spec delta for the next loop", + "09-the-loop.md"), + "done": ("this task is done — pick the next feature", + "02-the-flow.md"), +} +# Phase -> who owns it, for the `--json` autonomy signal. An autonomous harness may run a +# phase only when owner=="ai" (stop is false); every other phase is a checkpoint. The map +# follows the book's who-does-what table (Verify is "human only"); `tests`/`build`/`observe` +# are AI-led. A phase missing here is `unmapped_phase` (fail closed) — never defaulted. +PHASE_OWNER = { + "specify": "human", "scenarios": "human", "contract": "seam", + "tests": "ai", "build": "ai", "verify": "human", "observe": "ai", "done": "human", +} +SETUP_FILES = ("PROJECT.md", "CONVENTIONS.md", "GLOSSARY.md", "MODEL_REGISTRY.md", "dependencies.allowlist") + +# Guideline-injection targets + version-stable markers. NEVER change these marker +# strings: a re-run finds the old block by exact match, so changing them would +# orphan every block written by a prior version (see TASK guideline-inject). +GUIDELINE_FILES = ("AGENTS.md", "CLAUDE.md") +_GUIDE_BEGIN = "" +_GUIDE_END = "" + +# Minimal embedded fallback so the tool still works if templates/ is missing +# (circuit breaker: never hard-fail just because a template file was deleted). +_FALLBACK_TASK = """# TASK: {title} + +slug: {slug} · created: {date} · stage: {stage} +phase: specify + +## 1 · SPECIFY +Feature: +Framings weighed: +Must: +Reject: +After: +Assumptions — lowest-confidence first: + ⚠ — lowest confidence because ; if wrong: + +## 2 · SCENARIOS +## 3 · CONTRACT +Status: DRAFT +## 4 · TESTS +## 5 · BUILD +## 6 · VERIFY +### GATE RECORD +Outcome: +## 7 · OBSERVE +""" + + +# --- low-level IO (designed for failure: atomic, no silent clobber) ---------- + +def _now() -> str: + return datetime.now(timezone.utc).isoformat(timespec="seconds") + + +def _atomic_write(path: Path, text: str) -> None: + """Write via a temp file in the same dir, then atomically replace. + + Avoids a half-written file if the process dies mid-write. + """ + path.parent.mkdir(parents=True, exist_ok=True) + fd, tmp = tempfile.mkstemp(dir=str(path.parent), suffix=".tmp") + try: + with os.fdopen(fd, "w", encoding="utf-8") as fh: + fh.write(text) + os.replace(tmp, path) + finally: + if os.path.exists(tmp): + os.unlink(tmp) + + +def _templates_dir() -> Path: + return Path(__file__).resolve().parent / "templates" + + +def _render_template(name: str, **subs: str) -> str: + """Load templates/.tmpl and substitute {{key}} tokens. + + Falls back to a built-in minimal template only for TASK.md. + """ + tmpl = _templates_dir() / f"{name}.tmpl" + if tmpl.exists(): + text = tmpl.read_text(encoding="utf-8") + elif name == "TASK.md": + text = _FALLBACK_TASK.replace("{title}", "{{title}}").replace( + "{slug}", "{{slug}}").replace("{date}", "{{date}}").replace("{stage}", "{{stage}}") + else: + text = "" + for key, val in subs.items(): + text = text.replace("{{" + key + "}}", val) + return text + + +# --- state ------------------------------------------------------------------- + +def find_root(start: Path | None = None) -> Path | None: + """Walk up from cwd to find a .add/ project root.""" + cur = (start or Path.cwd()).resolve() + for d in (cur, *cur.parents): + if (d / ROOT_DIRNAME / STATE_FILE).exists(): + return d / ROOT_DIRNAME + return None + + +def _require_root() -> Path: + root = find_root() + if root is None: + _die("no .add/ project found. Run `add.py init` first.") + return root + + +def load_state(root: Path) -> dict: + """Load + parse state.json, failing CLOSED. A corrupt or unreadable state file + dies with a clean 'state_invalid' message (never a raw traceback), so every + command that loads state degrades gracefully (design-for-failure).""" + try: + return json.loads((root / STATE_FILE).read_text(encoding="utf-8")) + except (json.JSONDecodeError, OSError) as e: + _die(f"state_invalid: {root / STATE_FILE} is corrupt or unreadable " + f"({e.__class__.__name__}) — restore it from git or a backup") + + +def _load_state_for_json() -> tuple[Path, dict]: + """Fail-closed state load for `--json` paths: a missing project or unparseable + state.json -> `no_state` on stderr + exit 1, with EMPTY stdout (never a partial + JSON object a harness might parse). Built from State only — reads no docs/ chapter.""" + root = find_root() + if root is None: + _die("no_state") + try: + return root, json.loads((root / STATE_FILE).read_text(encoding="utf-8")) + except (json.JSONDecodeError, OSError): + _die("no_state") + + +def _phase_owner(phase: str) -> str: + """Map a phase to its owner (human|seam|ai); `unmapped_phase` if absent (fail closed).""" + owner = PHASE_OWNER.get(phase) + if owner is None: + _die("unmapped_phase") + return owner + + +def save_state(root: Path, state: dict) -> None: + state["updated"] = _now() + _atomic_write(root / STATE_FILE, json.dumps(state, indent=2) + "\n") + + +def _setup_locked(state: dict) -> bool: + """True when the project's setup is locked — i.e. the build-boundary gate is OPEN. + + A state with NO "setup" key is GRANDFATHERED-locked: plain `init` and every legacy + project are never gated (the lock is opt-in via `init --await-lock`). The gate is + therefore active in exactly one case: "setup" present AND locked is False.""" + return ("setup" not in state) or (state["setup"].get("locked") is True) + + +def _die(msg: str, code: int = 1) -> None: + print(f"add: error: {msg}", file=sys.stderr) + raise SystemExit(code) + + +# --- guideline injection (dynamic-by-reference; designed for failure) -------- +# +# Inject one stable, marker-delimited ADD block into the project root's AGENTS.md +# and CLAUDE.md. The block is DYNAMIC-BY-REFERENCE: it tells the agent to run +# `add.py status` and read PROJECT.md — it never embeds live state (slug, phase, +# gate). Auto-updated context files measurably hurt (ETH-Zurich: ~3% lower success, +# 20%+ more cost), so the stable pointer is the whole point. + +def _guideline_block() -> str: + """The canonical ADD block (markers + body, no trailing newline). + + Agent-agnostic by design (v14 agent-portability): the routing steps depend + only on the CLI and plain files, so any agent — Claude, Cursor, Copilot, + Codex — can follow them. Claude additionally gets the `add` skill.""" + return ( + f"{_GUIDE_BEGIN}\n" + "## ADD — how to work in this repo\n" + "\n" + "This project uses **ADD (AI-Driven Development)**: you, the AI, drive the build;\n" + "the human owns direction and verification. The loop below works for any agent —\n" + "Claude, Cursor, Copilot, Codex — through the CLI alone. Before you change code:\n" + "\n" + "1. Run `python3 .add/tooling/add.py status` — where the project is and what's\n" + " next (the resume point; read it first every session).\n" + "2. Read `.add/PROJECT.md` — the foundation (domain · spec · UI/UX) every task\n" + " builds on.\n" + "3. Run `python3 .add/tooling/add.py guide` — it names the phase and the exact\n" + " phase-guide file to read (the `guide :` line). Work ONLY that phase — each\n" + " guide ends with its exit gate and the command to move on.\n" + "\n" + "The flow: INTAKE sizes a request into a milestone; each task runs the\n" + "**specification bundle** — Spec+Scenarios+Contract+Tests as one bundle,\n" + "ONE human approval at the frozen contract — then a self-driving build→verify\n" + "run. Non-negotiable for every agent:\n" + "Never weaken a test or edit a frozen contract to make a build pass; a security\n" + "finding is always HARD-STOP — never auto-passed.\n" + "\n" + "On Claude Code the `add` skill drives this loop automatically; other agents\n" + "follow the three steps. The book is in `.add/docs/`. This block is generated\n" + "by `add.py sync-guidelines`; edit outside the markers, not inside.\n" + f"{_GUIDE_END}" + ) + + +def _inject_block(path: Path) -> str: + """Write the ADD block into `path`. Returns created|updated|unchanged. + + - unchanged: on-disk block already matches -> no write, no .bak (idempotent). + - updated: existing content changes -> back up the original to .bak first. + - created: file did not exist -> write the block, no .bak. + User content outside the markers is always preserved. + """ + block = _guideline_block() + if path.exists(): + current = path.read_text(encoding="utf-8") + begin = current.find(_GUIDE_BEGIN) + if begin != -1: + end = current.find(_GUIDE_END, begin) + if end != -1: # replace only the marked region + end += len(_GUIDE_END) + new = current[:begin] + block + current[end:] + else: # begin without end: corrupt — append fresh + print(f"add: warning: {path.name}: found an ADD:BEGIN with no ADD:END " + "— appending a fresh block; review the result", file=sys.stderr) + new = current.rstrip("\n") + "\n\n" + block + "\n" + else: # no block yet — append, keep user content + new = current.rstrip("\n") + "\n\n" + block + "\n" + if new == current: + return "unchanged" + _atomic_write(Path(str(path) + ".bak"), current) # rollback path before mutate + _atomic_write(path, new) + return "updated" + _atomic_write(path, block + "\n") + return "created" + + +def _inject_guidelines(project_root: Path) -> list[tuple[str, str]]: + """Inject the block into each guideline file under `project_root`. + + Symlink-dedup: targets resolving (os.path.realpath) to the same inode are + written once, against the REAL file (never replacing the symlink with a + regular file). Per-target OSError is isolated (warn+skip) so one unwritable + file never aborts the run or `init`. + """ + results: list[tuple[str, str]] = [] + seen: set[str] = set() + for name in GUIDELINE_FILES: + target = project_root / name + real = os.path.realpath(target) + if real in seen: + continue + seen.add(real) + write_target = Path(real) if target.is_symlink() else target + try: + action = _inject_block(write_target) + except (OSError, UnicodeDecodeError) as exc: + # design for failure: an unwritable target OR a non-UTF-8 existing file + # (e.g. a UTF-16 CLAUDE.md from a Windows editor) must not crash init or + # abort the other target — warn and skip this one. + print(f"add: warning: could not sync {name} — {exc}; skipped", + file=sys.stderr) + action = "skipped" + results.append((name, action)) + return results + + +# --- commands ---------------------------------------------------------------- + +_INIT_EXCLUDE = { + ".add", "AGENTS.md", "CLAUDE.md", ".git", + ".gitignore", ".gitattributes", ".github", ".editorconfig", # VCS/CI/editor scaffolding — no domain signal + "LICENSE", "LICENSE.md", "LICENSE.txt", "COPYING", # legal boilerplate — no domain signal +} # README/docs/source are NOT excluded: they carry domain content adopt.md maps -> brownfield + + +def _is_brownfield(base: Path) -> bool: + """True when `base` already holds project content beyond the tool's own scaffolding. + + Judgment-free: a mechanical fact (does the dir hold a non-excluded entry?), so the + autonomous-onboarding flow knows to map existing code into the living documentation. INTERPRETING + that code stays with the AI (skill/add/adopt.md) — the engine only detects + signals.""" + if not base.is_dir(): + return False + return any(child.name not in _INIT_EXCLUDE for child in base.iterdir()) + + +def cmd_init(args: argparse.Namespace) -> None: + base = Path(args.dir).resolve() + root = base / ROOT_DIRNAME + state_path = root / STATE_FILE + if state_path.exists() and not args.force: + _die(f"already initialised at {root} (use --force to reset state)") + + (root / "tasks").mkdir(parents=True, exist_ok=True) + today = date.today().isoformat() + proj_name = args.name or base.name + + # survivor-layer files — never clobber an existing one, never write a blank one + for fname in SETUP_FILES: + dest = root / fname + if dest.exists(): + continue + rendered = _render_template(fname, date=today, project=proj_name, stage=args.stage) + if not rendered.strip(): + # A missing/stale template rendered to nothing. Skip rather than create + # a 0-content survivor file (design-for-failure; circuit breaker so an + # upgrade with a stale templates/ dir can't silently produce empty docs). + print(f"add: warning: template for {fname} is missing/blank — skipped", + file=sys.stderr) + continue + _atomic_write(dest, rendered) + + state = { + "project": proj_name, + "stage": args.stage, + "active_task": None, + "active_milestone": None, + "tasks": {}, + "milestones": {}, + "created": _now(), + "updated": _now(), + } + if getattr(args, "await_lock", False): + # opt-in: seed an UNLOCKED setup so the build-boundary gate is active until + # `add.py lock`. Plain init omits this key entirely (grandfathered-locked). + state["setup"] = {"locked": False, "locked_at": None, "locked_by": None, "layers": []} + save_state(root, state) + # zero-config: give any agent a stable pointer into the ADD runtime. + for name, action in _inject_guidelines(base): + if action != "unchanged": + print(f"{action:>9} {name}") + print(f"initialised ADD project '{state['project']}' (stage: {state['stage']}) at {root}") + if _is_brownfield(base): + # Existing code present — the AI maps it SILENTLY into the survivors (skill/add/adopt.md), + # then the human locks it down. The engine only flags it; it never reads or fills the code. + print("brownfield: existing code detected — the `add` skill maps it into your") + print(" foundation (silent), then you lock it down: add.py lock") + else: + print("next: open Claude Code, run `/add`, and say what you want to build —") + print(" the `add` skill sizes it into a milestone and drives the build with you.") + + +def cmd_sync_guidelines(args: argparse.Namespace) -> None: + project_root = _require_root().parent + for name, action in _inject_guidelines(project_root): + print(f"{action:>9} {name}") + + +def cmd_new_task(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + # build-boundary gate: pre-lock, EXACTLY one first task may be drafted; refuse a 2nd. + if not _setup_locked(state) and state.get("tasks"): + _die("setup_unlocked: lock the foundation first — add.py lock") + slug = args.slug + if not slug.replace("-", "").replace("_", "").isalnum(): + _die("slug must be alphanumeric with - or _ only") + tdir = root / "tasks" / slug + task_md = tdir / "TASK.md" + if task_md.exists() and not args.force: + _die(f"task '{slug}' already exists (use --force to overwrite TASK.md)") + + # link to a milestone (explicit, or the active one) — validate before any write + milestone = getattr(args, "milestone", None) or state.get("active_milestone") + if milestone and milestone not in state.get("milestones", {}): + _die("unknown_milestone") + depends_on = _parse_deps(getattr(args, "depends_on", None)) + + (tdir / "tests").mkdir(parents=True, exist_ok=True) + (tdir / "src").mkdir(parents=True, exist_ok=True) + title = args.title or slug.replace("-", " ").replace("_", " ").title() + _atomic_write(task_md, _render_template( + "TASK.md", title=title, slug=slug, date=date.today().isoformat(), stage=state["stage"])) + + state["tasks"][slug] = { + "title": title, + "phase": "specify", + "gate": "none", + "milestone": milestone, + "depends_on": depends_on, + "created": _now(), + "updated": _now(), + } + state["active_task"] = slug + save_state(root, state) + print(f"created task '{slug}' -> {task_md}") + if milestone: + print(f"linked to milestone '{milestone}'" + + (f", depends-on {depends_on}" if depends_on else "")) + else: + # warn-never-block: the task is created (escape hatch), but nudge back toward the + # intake -> milestone flow. Speaks of STRUCTURE (not attached), never the act. + print(f"note: '{slug}' is not attached to a milestone — size it via /add (intake), " + "or pass --milestone ") + print("active task set. phase: specify. Fill section 1 (SPECIFY), then: add.py advance") + + +def _parse_deps(raw: str | None) -> list[str]: + if not raw: + return [] + return [d.strip() for d in raw.split(",") if d.strip()] + + +def _task_done(t: dict) -> bool: + # Matrix 3: a task is done when Verify reads PASS *or a signed RISK-ACCEPTED*. + # Both completing gates advance phase to "done" (cmd_gate), and a waiver is + # signed at gate time — so a verdict gate is enough here; we need not re-read + # the waiver. HARD-STOP never reaches "done". A bare `phase done` (escape + # hatch, gate still "none") deliberately does NOT count: completion needs a + # recorded verdict, not just a phase marker. + return t.get("phase") == "done" and t.get("gate") in ("PASS", "RISK-ACCEPTED") + + +def _archived_task_slugs(state: dict) -> set[str]: + """Slugs of tasks that left active state via archive — all were PASS-done at + archive time, so a dep on one of them counts as satisfied (not dangling). + + INVARIANT: this is sound only because cmd_archive_milestone REFUSES to archive a + milestone with an incomplete member. Any NEW task-removal path (un-archive/restore, + heavy archive) MUST preserve "archived ⇒ was PASS-done" or `ready` will green-light + a task whose dependency never completed.""" + out: set[str] = set() + for rec in state.get("archived", []): + out.update(rec.get("task_slugs", [])) # .get: pre-v2 records have none + return out + + +def _resolve_task(state: dict, slug: str | None) -> str: + slug = slug or state.get("active_task") + if not slug: + _die("no task specified and no active task set") + if slug not in state["tasks"]: + _die(f"unknown task '{slug}'") + return slug + + +def cmd_phase(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + slug = _resolve_task(state, args.slug) + if args.phase not in PHASES: + _die(f"phase must be one of: {', '.join(PHASES)}") + state["tasks"][slug]["phase"] = args.phase + state["tasks"][slug]["updated"] = _now() + _sync_task_marker(root, slug, args.phase) + save_state(root, state) + print(f"task '{slug}' phase -> {args.phase}") + + +def cmd_advance(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + slug = _resolve_task(state, args.slug) + cur = state["tasks"][slug]["phase"] + idx = PHASES.index(cur) + if idx >= len(PHASES) - 1: + _die(f"task '{slug}' already at final phase ({cur})") + nxt = PHASES[idx + 1] + # build-boundary gate: pre-lock the front (specify..tests) is allowed, but crossing + # into build/verify/observe/done is refused until `add.py lock`. + if not _setup_locked(state) and nxt in ("build", "verify", "observe", "done"): + _die("setup_unlocked: lock the foundation first — add.py lock") + # flag-first freeze guard (task unflagged-freeze): a FROZEN §3 may not cross + # into build without a WELL-FORMED lowest-confidence flag. On pass, stamp the + # verified marker so `audit` enforces the flag on THIS record only (open/new + # freezes — the unmarked predecessors are never retro-redded). REFUSE writes + # nothing (fail-closed); below the build boundary the flag is never checked. + if nxt == "build": + raw3 = _raw_phase_bodies(root, slug).get(3, "") + if _contract_frozen(raw3): + if not _flag_well_formed(raw3): + _die("unflagged_freeze: a frozen §3 must surface a well-formed " + "'Least-sure flag surfaced at freeze:' unit (>=1 [part] tag " + "+ substantive content; bare 'none' only as 'none material — " + "biggest risk: X') before crossing into build") + state["tasks"][slug]["flag_verified"] = True + state["tasks"][slug]["phase"] = nxt + state["tasks"][slug]["updated"] = _now() + _sync_task_marker(root, slug, nxt) + save_state(root, state) + print(f"task '{slug}' phase {cur} -> {nxt}") + + +# The mechanized high-risk guard (run.md, v14): judging WHAT is high-risk stays +# human — a scope declares `risk: high` in its TASK.md header at the freeze. The +# engine then enforces the pure token contradiction: risk: high WITHOUT +# autonomy: conservative is unguarded, and completion is refused. Tokens are +# read from the header region (text before the first section heading) with HTML +# comments stripped — a documentation comment is never a declaration. +_RISK_HIGH_RE = re.compile(r"\brisk:\s*high\b") +_AUTONOMY_CONSERVATIVE_RE = re.compile(r"\bautonomy:\s*conservative\b") + + +def _task_header(root: Path, slug: str) -> str: + """The TASK.md header region — where declared tokens (risk · autonomy) + live — with HTML comments stripped. Missing file -> '' (no tokens).""" + try: + text = (root / "tasks" / slug / "TASK.md").read_text(encoding="utf-8") + except OSError: + return "" + return re.sub(r"", "", text.split("\n## ", 1)[0], flags=re.S) + + +def cmd_gate(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + slug = _resolve_task(state, args.slug) + # build-boundary gate: no verdict may be recorded before the setup is locked. + if not _setup_locked(state): + _die("setup_unlocked: lock the foundation first — add.py lock") + if args.outcome not in GATES: + _die(f"outcome must be one of: {', '.join(GATES)}") + # Completing outcomes (PASS, RISK-ACCEPTED) are the VERIFY step's verdict, so they + # share the verify-phase guard — no silent skips (principle 7). HARD-STOP stays + # recordable from any phase (a security finding is always HARD-STOP). The + # deliberate, logged override is `add.py phase verify `. + completing = args.outcome in ("PASS", "RISK-ACCEPTED") + if completing: + current = state["tasks"][slug]["phase"] + if _phase_index(current) < _phase_index("verify"): + code = ("gate_pass_before_verify" if args.outcome == "PASS" + else "gate_risk_accepted_before_verify") + _die(f"{code}: task '{slug}' is at '{current}'; reach the verify phase " + f"first (or `add.py phase verify {slug}` to override)") + # the mechanized high-risk guard: an unguarded high-risk header refuses + # COMPLETION (PASS / RISK-ACCEPTED) until the dial is lowered and a human + # owns the gate. HARD-STOP is never blocked — stopping is always allowed. + hdr = _task_header(root, slug) + if _RISK_HIGH_RE.search(hdr) and not _AUTONOMY_CONSERVATIVE_RE.search(hdr): + _die(f"unguarded_high_risk_auto: task '{slug}' declares risk: high " + "without autonomy: conservative — lower the autonomy level in the TASK.md " + "header; a human must own a high-risk gate (run.md guard)") + if args.outcome == "RISK-ACCEPTED": + # A waiver must be SIGNED: owner, ticket, expiry (glossary). Stored in state + # so a later `check` can read/expire it. Refuse a partial waiver outright. + missing = [f for f in ("owner", "ticket", "expires") if not getattr(args, f)] + if missing: + _die("waiver_incomplete: RISK-ACCEPTED is a signed waiver; supply " + + ", ".join("--" + m for m in missing)) + state["tasks"][slug]["waiver"] = { + "owner": args.owner, "ticket": args.ticket, "expires": args.expires, + } + if completing: + state["tasks"][slug]["phase"] = "done" + _sync_task_marker(root, slug, "done") + state["tasks"][slug]["gate"] = args.outcome + state["tasks"][slug]["updated"] = _now() + save_state(root, state) + print(f"task '{slug}' gate -> {args.outcome}") + if args.outcome == "HARD-STOP": + print("HARD-STOP recorded: return to BUILD; nothing ships on a failing/security gate.") + + +def cmd_reopen(args: argparse.Namespace) -> None: + """Return an already-`done` task to an earlier phase with a never-silent record. + + The flow already permits backward correction (book ch02: "any phase may return + to an earlier one"); `done` is terminal EXCEPT via this recorded action. reopen + sets the phase back, resets the gate to "none" (the task must re-earn its + verdict), and appends an append-only `reopens` entry recording WHY. A done task + done via RISK-ACCEPTED carries a live `waiver`; reopen records it inside the entry + (prior_gate / prior_waiver) and drops the live key, so no signed waiver lingers + without a verdict. Judgement of WHEN to reopen stays the resolver's; the engine + only enforces the recorded, coherent transition. + """ + root = _require_root() + state = load_state(root) + slug = _resolve_task(state, args.slug) + t = state["tasks"][slug] + if t.get("phase") != "done": + _die(f"reopen_not_done: task '{slug}' is at '{t.get('phase')}', not done — " + "backward correction inside a live run is `add.py phase` / HARD-STOP, not reopen") + reason = (args.reason or "").strip() + if not reason: + _die("reopen_reason_required: reopen records WHY — supply a non-empty --reason") + target = args.to + if target not in PHASES[:7]: # specify..observe; never "done", never an unknown name + _die(f"reopen_target_invalid: --to must be one of {', '.join(PHASES[:7])} (got {target!r})") + now = _now() + entry = {"from": "done", "to": target, "reason": reason, "at": now, + "prior_gate": t.get("gate", "none")} + if t.get("waiver"): # void verdict's waiver -> history, drop the live key + entry["prior_waiver"] = t.pop("waiver") + t.setdefault("reopens", []).append(entry) + t["phase"] = target + t["gate"] = "none" + t["updated"] = now + _sync_task_marker(root, slug, target) + save_state(root, state) + print(f"task '{slug}' reopened: done -> {target} (reason recorded); gate reset to none") + + +def cmd_lock(args: argparse.Namespace) -> None: + """The human baseline approval: freeze the autonomously-drafted setup in ONE atomic write. + + Setup-level analog of the contract freeze — the only new human action onboarding + needs. `add.py lock` is judgment-free (it records the signature; it does NOT inspect + the artifacts): the human's signature IS the gate.""" + root = _require_root() + state = load_state(root) + # idempotent-guarded: the predicate also treats a grandfathered (no "setup" key) + # project as already locked, so a bare re-lock there refuses too. + if _setup_locked(state) and not args.force: + _die("already_locked: setup is already locked (use --force to re-lock)") + # parse layers BEFORE any write so an invalid request never half-locks (design-for-failure). + raw = args.layers if args.layers is not None else "foundation,scope,contract" + layers = [s.strip() for s in raw.split(",") if s.strip()] + if not layers: + _die("layers_invalid: --layers must name at least one lock layer") + who = args.by or getpass.getuser() + when = _now() + # ONE atomic write — no partial lock state. + state["setup"] = {"locked": True, "locked_at": when, "locked_by": who, "layers": layers} + save_state(root, state) + if getattr(args, "json", False): + print(json.dumps( + {"locked": True, "locked_at": when, "locked_by": who, "layers": layers}, + separators=(",", ":"))) + else: + print(f"locked setup ({','.join(layers)}) by {who} @ {when}") + + +def _has_production_roadmap(state: dict) -> bool: + """True iff ≥1 milestone in state has stage == "production" (STATUS-AGNOSTIC). + The single source of the stage-graduation floor (v22 graduate-guide): the guard counts + that a production-roadmap RECORD exists — it never judges whether those milestones are + done/good/sufficient (gather-not-judge). An archived-out-of-state roadmap falls to --force.""" + return any(m.get("stage") == "production" + for m in state.get("milestones", {}).values()) + + +def cmd_stage(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + if args.stage not in STAGES: + _die(f"stage must be one of: {', '.join(STAGES)}") + # v22 stage-graduation guard: the →production TRANSITION refuses without a roadmap — a tally + # check (≥1 production milestone exists), never a readiness judgment. Scoped to production + # ONLY; every other flip is the existing bare flip, byte-unchanged. --force overrides + # (precedent: lock --force). The flip is graduate.md's FINAL, confirmed-roadmap step. + forced = getattr(args, "force", False) + bypassing = False + if args.stage == "production": + roadmap = _has_production_roadmap(state) + if not roadmap and not forced: + _die("stage_no_roadmap: no production milestone drafted. Draft ≥1 via " + "graduate.md (new-milestone --stage production), or use --force to override.") + bypassing = forced and not roadmap + state["stage"] = args.stage + save_state(root, state) + print(f"project stage -> {args.stage}") + if bypassing: + print("(--force: bypassed roadmap check — no production milestone drafted)") + + +def cmd_status(args: argparse.Namespace) -> None: + if getattr(args, "json", False): + root, state = _load_state_for_json() + tasks = state.get("tasks") or {} + milestones = state.get("milestones") or {} + ms_list = [] + for mslug, m in milestones.items(): + members = [t for t in tasks.values() if t.get("milestone") == mslug] + ms_list.append({"slug": mslug, "status": m.get("status", "active"), + "done": sum(1 for t in members if _task_done(t)), + "total": len(members)}) + grad_ready, grad_met, grad_total = _graduation_ready(root, state) + print(json.dumps({ + "project": state.get("project"), "stage": state.get("stage"), + "active_task": state.get("active_task"), + "milestones": ms_list, + "tasks": [{"slug": s, "phase": t.get("phase"), "gate": t.get("gate"), + "milestone": t.get("milestone")} for s, t in tasks.items()], + "graduation_ready": grad_ready, + "stage_criteria": {"met": grad_met, "total": grad_total}})) + return + root = _require_root() + state = load_state(root) + active = state.get("active_task") + tasks = state.get("tasks", {}) + # Compute once: True when setup is present AND locked is False (the lock-gate window). + # Reuses the canonical helper — do NOT write a parallel predicate. + unlocked = not _setup_locked(state) + print(f"project : {state.get('project', '(unknown)')}") + print(f"stage : {state.get('stage', '(unknown)')}") + # project GOAL + active-milestone goal (v20) — the loop's orientation anchor, read + # LIVE from PROJECT.md / MILESTONE.md (never state.json). Additive: every existing + # line stays put. A missing source degrades to a sentinel — one never blanks the other. + print(f"goal : {_project_goal(root)}") + _active_ms = state.get("active_milestone") + if _active_ms: + print(f"m-goal : {_milestone_doc(root, _active_ms)[1]} (← {_active_ms})") + # foundation pointer — read the cross-milestone context first (anti-rot) + if (root / "PROJECT.md").exists(): + print("context : .add/PROJECT.md (foundation: domain · spec · UI/UX — read first)") + # wave resume hint — a live ledger outranks memory (streams.md "Wave ledger"). + # Existence-only: no open/read/parse, so the hint adds no IO failure path; a + # non-file at the path is not a ledger. One line PER live ledger — more than + # one live wave is an anomaly the orchestrator must see, never a line we hide. + for _wave in sorted((root / "milestones").glob("*/WAVE.md")): + if _wave.is_file(): + print(f"wave : LIVE — .add/milestones/{_wave.parent.name}/WAVE.md" + " (wave resume point — re-orient from the ledger first)") + + # milestone rollup (only when milestones are in use) + milestones = state.get("milestones") or {} + active_ms = state.get("active_milestone") + if milestones: + print("milestones:") + for mslug, m in milestones.items(): + members = [t for t in tasks.values() if t.get("milestone") == mslug] + done = sum(1 for t in members if _task_done(t)) + mark = "*" if mslug == active_ms else " " + print(f" {mark} {mslug:<20} {done}/{len(members)} tasks done" + f" status={m.get('status', 'active')}") + # graduation cue (v22): project-global + read-only. Fires only when every milestone + # is done AND the human's PROJECT.md stage-goal-criteria are all checked — additive + # (a new line solely when ready; the non-ready output is byte-identical to before). + grad_ready, _gm, _gt = _graduation_ready(root, state) + if grad_ready: + print(f" → {GRADUATION_CUE}") + + # archived rollup — one line keeps state visible without re-bloating status + archived = state.get("archived") or [] + if archived: + n = len(archived) + m_tasks = sum(rec.get("tasks", 0) for rec in archived) + print(f"archived: {n} milestone{'s' if n != 1 else ''} " + f"({m_tasks} task{'s' if m_tasks != 1 else ''})") + + print(f"active : {active or '(none)'}") + if not tasks: + # First-run panel: a brand-new project's status is the moment a user is most + # lost. When the setup is unlocked, the only correct next move is review+lock — + # suppress the generic /add hint and name the two steps that matter. + print("tasks : (none yet)") + print() + if unlocked: + print("setup : UNLOCKED — review .add/SETUP-REVIEW.md (lowest-confidence first)," + " then sign: add.py lock") + print(" (the build-boundary gate is closed until the foundation is locked)") + else: + print("next : you're set up. In Claude Code, run /add and say what you want to") + print(" build — the `add` skill sizes it into a milestone and drives the") + print(' build with you. Escape hatch: add.py new-task --title "..."') + return + print("tasks :") + for slug, t in tasks.items(): + mark = "*" if slug == active else " " + deps = t.get("depends_on") or [] + dep_s = f" deps={','.join(deps)}" if deps else "" + ms_s = f" [{t['milestone']}]" if t.get("milestone") else "" + print(f" {mark} {slug:<24} phase={t['phase']:<10} gate={t['gate']}{ms_s}{dep_s}") + # fold-pressure nudge: surface unfolded competency deltas so emission can't + # silently outrun the human fold (read-only; v11). Silent when none are open. + open_deltas = sum(len(v) for v in _collect_open_deltas(root).values()) + if open_deltas: + print(f"deltas : {open_deltas} open — consolidate at milestone close (add.py deltas)") + # When the setup is unlocked, the only terminal guidance that matters is + # review+lock; suppress the generic resume block so it does not compete. + if unlocked: + print("\nsetup : UNLOCKED — review .add/SETUP-REVIEW.md (lowest-confidence first)," + " then sign: add.py lock") + print(" (the build-boundary gate is closed until the foundation is locked)") + elif active and active in tasks: + ph = tasks[active]["phase"] + if ph == "done": + print(f"\nresume : task '{active}' is done ({tasks[active]['gate']}).") + print(" start the next feature: add.py new-task ") + else: + print(f"\nresume : task '{active}' is at phase '{ph}'.") + print(f" read .add/tasks/{active}/TASK.md and continue that phase.") + + +# Agent-portability (v14): `guide` names the PHASE PLAYBOOK file — the same +# guides the Claude skill loads, installed as plain markdown by every channel +# at .claude/skills/add/phases/ — so ANY agent (Cursor, Copilot, Codex) can be +# routed there through the CLI alone. Never a dead pointer: the path is printed +# only if the file exists; a missing tree gets an install hint instead. +_PHASE_GUIDE_FILES = { + "specify": "1-specify.md", "scenarios": "2-scenarios.md", + "contract": "3-contract.md", "tests": "4-tests.md", + "build": "5-build.md", "verify": "6-verify.md", "observe": "7-observe.md", +} +_SKILL_PHASES_DIR = Path(".claude") / "skills" / "add" / "phases" + + +def _phase_guide_path(project_root: Path, phase: str) -> str | None: + """Relative path to the phase playbook if it exists, else None. + done/unknown phases have no playbook (the `then:` line routes onward).""" + fname = _PHASE_GUIDE_FILES.get(phase) + if fname is None: + return None + rel = _SKILL_PHASES_DIR / fname + return str(rel) if (project_root / rel).is_file() else None + + +def cmd_guide(args: argparse.Namespace) -> None: + """Answer "what do I do next?" for the active (or named) task. + + Strictly read-only: load_state only — never save_state, never writes a TASK.md. + """ + if getattr(args, "json", False): + json_root, state = _load_state_for_json() + slug = args.slug or state.get("active_task") + if not slug: + print(json.dumps({"task": None, "phase": None, "owner": "human", "stop": True, + "next_step": "start your first feature -> add.py new-task ", + "chapter": ".add/docs/02-the-flow.md", "gate": None, + "guide": None})) + return + t = (state.get("tasks") or {}).get(slug) + if t is None: + _die(f"unknown task '{slug}'") + phase = t.get("phase") + owner = _phase_owner(phase) # _die unmapped_phase before any stdout + action, chapter = PHASE_GUIDE[phase] # phase is mapped, so PHASE_GUIDE has it too + print(json.dumps({"task": slug, "phase": phase, "owner": owner, + "stop": owner != "ai", "next_step": action, + "chapter": f".add/docs/{chapter}", "gate": t.get("gate"), + "guide": _phase_guide_path(json_root.parent, phase)})) + return + root = _require_root() + state = load_state(root) + slug = args.slug or state.get("active_task") + if not slug: + print("active : (none)") + print('next : start your first feature -> add.py new-task --title "..."') + print("read : .add/docs/02-the-flow.md") + return + if slug not in state.get("tasks", {}): + _die(f"unknown task '{slug}'") + phase = state["tasks"][slug]["phase"] + entry = PHASE_GUIDE.get(phase) + if entry is None: # corrupted/hand-edited state.json — fail clean, not KeyError + _die(f"task '{slug}' has unknown phase '{phase}' (state.json corrupted?)") + action, chapter = entry + print(f"active : {slug} (phase: {phase})") + print(f"goal : {_project_goal(root)}") # v20 — the next-step surface still shows what the work is FOR + print(f"next : {action}") + print(f"read : .add/docs/{chapter}") + gp = _phase_guide_path(root.parent, phase) + if gp is not None: + print(f"guide : {gp}") + elif phase in _PHASE_GUIDE_FILES: + print("guide : (phase guides not installed — npx @pilotspace/add init)") + if phase == "verify": + print("then : add.py gate PASS | RISK-ACCEPTED | HARD-STOP") + elif phase == "done": + print("then : start the next feature -> add.py new-task ") + else: + print("then : add.py advance") + + +def _read_task_phase(root: Path, slug: str) -> str | None: + """Read the `phase:` marker from a task's TASK.md, or None if absent.""" + task_md = root / "tasks" / slug / "TASK.md" + if not task_md.exists(): + return None + for line in task_md.read_text(encoding="utf-8").splitlines(): + if line.startswith("phase:"): + rest = line[len("phase:"):].strip() + return rest.split()[0] if rest else None + return None + + +def cmd_check(args: argparse.Namespace) -> None: + """Read-only integrity check of the .add project. Exit 1 if anything fails.""" + as_json = getattr(args, "json", False) + if as_json: + root, state = _load_state_for_json() # fail closed -> no_state + empty stdout + else: + root = find_root() + if root is None: + _die("no_project") + try: + state = json.loads((root / STATE_FILE).read_text(encoding="utf-8")) + except (json.JSONDecodeError, OSError): + _die("state_invalid") + + checks: list[tuple[bool, str, str]] = [] # (ok, description, reason-if-failed) + for key in ("project", "stage", "active_task", "tasks"): + checks.append((key in state, f"state has key '{key}'", "missing")) + + tasks = state.get("tasks") if isinstance(state.get("tasks"), dict) else {} + milestones = state.get("milestones") if isinstance(state.get("milestones"), dict) else {} + archived_slugs = _archived_task_slugs(state) # archived deps still resolve + warnings: list[tuple[str, str]] = [] # (name, reason) — nudges that NEVER feed `failed` + for slug, t in tasks.items(): + task_md = root / "tasks" / slug / "TASK.md" + checks.append((task_md.exists(), f"task '{slug}' has TASK.md", "file missing")) + marker, want = _read_task_phase(root, slug), t.get("phase") + checks.append((marker == want, f"task '{slug}' marker matches state", + f"marker={marker!r} state={want!r}")) + # drift: milestone + dependency references must resolve + ms = t.get("milestone") + if ms is not None: + checks.append((ms in milestones, f"task '{slug}' milestone resolves", + f"unknown milestone {ms!r}")) + else: + # warn-never-block: a task outside a milestone is a structural nudge back toward + # the intake flow — NOT a failure. Names structure, never the act of intake. + warnings.append((f"task '{slug}'", "is outside a milestone — size it via the /add " + "intake flow (or attach with --milestone)")) + for dep in t.get("depends_on") or []: + checks.append((dep in tasks or dep in archived_slugs, + f"task '{slug}' dep '{dep}' resolves", "unknown task")) + # waiver expiry (Matrix 4): a RISK-ACCEPTED waiver whose `expires` has passed is + # stale — the gate stored it; `check` is the standing monitor that catches the lapse. + # Fail-closed: a missing/unparseable expires is a FAIL, never a silent pass. + if t.get("gate") == "RISK-ACCEPTED": + exp = (t.get("waiver") or {}).get("expires") + try: + ok = exp is not None and date.fromisoformat(exp) >= date.today() + reason = f"waiver_expired (expires={exp})" + except (ValueError, TypeError): + ok, reason = False, f"waiver_expired (unparseable expires={exp!r})" + checks.append((ok, f"task '{slug}' waiver not expired", reason)) + # delta-lint: validate all OPEN entries in the "### Competency deltas" block. + # Fail-closed; folded/rejected entries are skipped (open-only). Only emits a + # check when at least one delta-attempt is present in the block. + lint_result = _lint_task_deltas(root, slug) + if lint_result is not None: + ok, reason = lint_result + checks.append((ok, f"task '{slug}' deltas well-formed", reason)) + + # drift: a done milestone must have no unfinished tasks + for mslug, m in milestones.items(): + if m.get("status") == "done": + unfinished = [s for s, t in tasks.items() + if t.get("milestone") == mslug and not _task_done(t)] + checks.append((not unfinished, f"done milestone '{mslug}' fully complete", + f"unfinished: {unfinished}")) + + # dependency graph must be acyclic + cycle = _find_cycle(tasks) + checks.append((cycle is None, "task dependencies are acyclic", + f"cycle: {' -> '.join(cycle)}" if cycle else "")) + + passed = sum(1 for ok, _, _ in checks if ok) + failed = len(checks) - passed + if as_json: + print(json.dumps({"passed": passed, "failed": failed, + "warned": len(warnings), + "warnings": [{"name": name, "reason": reason} + for name, reason in warnings], + "checks": [{"ok": ok, "name": desc, + "reason": reason if not ok else ""} + for ok, desc, reason in checks]})) + else: + for ok, desc, reason in checks: + print(f"PASS {desc}" if ok else f"FAIL {desc}: {reason}") + for name, reason in warnings: + print(f"WARN {name} {reason}") + summary = f"check: {passed} passed, {failed} failed" + if warnings: + summary += f" ({len(warnings)} warnings)" # frozen §3: summary gains "(N warnings)" + print(summary) + if failed: + raise SystemExit(1) + + +def cmd_new_milestone(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + slug = args.slug + if not slug.replace("-", "").replace("_", "").isalnum(): + _die("bad_slug") + state.setdefault("milestones", {}) + mdir = root / "milestones" / slug + mfile = mdir / MILESTONE_FILE + if mfile.exists() and not args.force: + _die("milestone_exists") + mdir.mkdir(parents=True, exist_ok=True) + title = args.title or slug.replace("-", " ").replace("_", " ").title() + _atomic_write(mfile, _render_template( + "MILESTONE.md", title=title, goal=args.goal or "", + stage=args.stage, date=date.today().isoformat())) + state["milestones"][slug] = { + "title": title, "goal": args.goal or "", "stage": args.stage, + "status": "active", "created": _now(), "updated": _now(), + } + state["active_milestone"] = slug + save_state(root, state) + print(f"created milestone '{slug}' -> {mfile}") + print(f"active milestone set. Decompose it into tasks: add.py new-task --depends-on ...") + + +def cmd_ready(args: argparse.Namespace) -> None: + if getattr(args, "json", False): + _, state = _load_state_for_json() + tasks = state.get("tasks") or {} + archived = _archived_task_slugs(state) + + def _ok(d: str) -> bool: + return d in archived or (d in tasks and _task_done(tasks[d])) + + ready, blocked = [], [] + for slug, t in tasks.items(): + if _task_done(t): + continue + unmet = [d for d in (t.get("depends_on") or []) if not _ok(d)] + (blocked.append({"slug": slug, "waiting_on": unmet}) + if unmet else ready.append(slug)) + print(json.dumps({"ready": ready, "blocked": blocked})) + return + root = _require_root() + state = load_state(root) + tasks = state.get("tasks", {}) + archived_slugs = _archived_task_slugs(state) # an archived dep was PASS-done + + def _dep_satisfied(d: str) -> bool: + if d in archived_slugs: + return True # archived ⇒ complete when archived + return d in tasks and _task_done(tasks[d]) # in-state dep must be done; else blocked + + ready = [] + for slug, t in tasks.items(): + if _task_done(t): + continue + deps = t.get("depends_on") or [] + if all(_dep_satisfied(d) for d in deps): + ready.append(slug) + if not ready: + print("ready: (none — all tasks are done or blocked)") + return + print("ready to start (deps satisfied):") + for slug in ready: + deps = tasks[slug].get("depends_on") or [] + suffix = f" (after {', '.join(deps)})" if deps else "" + print(f" {slug}{suffix}") + + +def cmd_milestone_done(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + slug = args.slug + if slug not in state.get("milestones", {}): + _die("unknown_milestone") + members = {s: t for s, t in state.get("tasks", {}).items() if t.get("milestone") == slug} + blockers = [s for s, t in members.items() if not _task_done(t)] + if not members: + _die("milestone_incomplete") # nothing attached -> nothing proven + if blockers: + print(f"milestone '{slug}' has unfinished tasks:", file=sys.stderr) + for s in blockers: + t = members[s] + print(f" - {s} (phase={t.get('phase')}, gate={t.get('gate')})", file=sys.stderr) + _die("milestone_incomplete") + # Goal-gate (v20 dynamic-task-loop): a milestone holds until its exit criteria are + # met. The engine READS the checkbox tally (the human's goal-met affirmation, like a + # gate=PASS) — it never judges the goal. Fires ONLY when criteria exist, so a + # criteria-less milestone and every pre-v20 close path stay valid. milestone-done is + # the SOLE status->done transition; archive-milestone/compact already refuse a + # non-done milestone, so this single gate has no back door. Refuse BEFORE any write. + met, total = _exit_criteria(root, slug) + if total > 0 and met < total: + _die(f"milestone_goal_unmet: milestone '{slug}' has {met}/{total} exit criteria met " + f"— check the remaining boxes in MILESTONE.md (the goal-gate holds the loop " + f"open) or propose the next tasks (add.py deltas)") + # Fail-closed: render+persist the exit report (RETRO.md) BEFORE committing the + # status flip, so a write failure rolls back naturally (status never commits -> + # no done-without-retro state). The retro step is read-only on state.json. + try: + retro_path = _write_retro(root, state, slug) + except OSError: + _die("retro_write_failed") + state["milestones"][slug]["status"] = "done" + state["milestones"][slug]["updated"] = _now() + save_state(root, state) + waived = [s for s, t in members.items() if t.get("gate") == "RISK-ACCEPTED"] + tail = f" ({len(waived)} via a signed RISK-ACCEPTED waiver)" if waived else "" + print(f"milestone '{slug}' -> done ({len(members)} tasks complete{tail}).") + print(f"wrote {retro_path.relative_to(root.parent)} (milestone exit report)") + print("Confirm the MILESTONE.md exit criteria are checked, then archive/start the next.") + # fold-pressure nudge: milestone close is the natural fold point for open deltas (v11) + open_deltas = sum(len(v) for v in _collect_open_deltas(root).values()) + if open_deltas: + noun = "delta" if open_deltas == 1 else "deltas" + print(f"note: {open_deltas} open {noun} to consolidate into the foundation " + f"— review with: add.py deltas") + + +def cmd_archive_milestone(args: argparse.Namespace) -> None: + """Light archive: collapse a DONE milestone out of active state (files stay).""" + root = _require_root() + state = load_state(root) + slug = args.slug + # validate before any mutation — a reject must leave state.json byte-for-byte unchanged + if slug not in state.get("milestones", {}): + _die("unknown_milestone") + ms = state["milestones"][slug] + if ms.get("status") != "done": + _die("milestone_not_done") # run `add.py milestone-done` first; never lose live work + tasks = state.get("tasks", {}) + members = [s for s, t in tasks.items() if t.get("milestone") == slug] + # the status flag can go stale (a task attached AFTER milestone-done is still + # live); re-check now so archive can never silently delete unfinished work. + incomplete = [s for s in members if not _task_done(tasks[s])] + if incomplete: + print(f"milestone '{slug}' has live unfinished tasks:", file=sys.stderr) + for s in incomplete: + t = tasks[s] + print(f" - {s} (phase={t.get('phase')}, gate={t.get('gate')})", file=sys.stderr) + _die("milestone_has_incomplete_tasks") + # pre-archive snapshot (design-for-failure): the archived record below keeps only a + # slug-list, so capture the full milestone + member task records to a .bak BEFORE the + # destructive deletes — an accidental archive stays recoverable (phase/gate/waiver/deps + # the record drops). Mirrors the .bak the guideline injector writes before mutating. + _atomic_write( + root / "milestones" / slug / "pre-archive-state.bak.json", + json.dumps({"milestone": ms, "tasks": {s: tasks[s] for s in members}, + "archived_at": _now()}, indent=2) + "\n", + ) + # a slug-list summary (never task bodies) so the active state can't regrow, + # yet cross-milestone deps on these tasks still resolve (see _archived_task_slugs) + state.setdefault("archived", []).append({ + "slug": slug, + "title": ms.get("title", slug), + "tasks": len(members), + "task_slugs": members, + "archived": date.today().isoformat(), + }) + del state["milestones"][slug] + for s in members: + del tasks[s] + if state.get("active_milestone") == slug: + state["active_milestone"] = None + if state.get("active_task") in members: + state["active_task"] = None + save_state(root, state) + print(f"archived milestone '{slug}' ({len(members)} tasks) — removed from active state.") + print("files on disk are untouched; see `add.py status` for the archived rollup.") + + +def cmd_compact(args: argparse.Namespace) -> None: + """Heavy archive (step two, after `archive-milestone`): move a light-archived + milestone's files — MILESTONE.md + siblings + every rollup-member task dir — into + one recovery bundle `.add/archive//`. Validate-all-then-move: any reject + leaves the tree AND state.json byte-for-byte unchanged. Compact never deletes, + only renames; recovery = reverse move, no state edit (state already dropped these + at light archive). Preserves the _archived_task_slugs invariant: `task_slugs` is + never touched — archived ⇒ was PASS-done keeps resolving cross-milestone deps.""" + root = _require_root() + state = load_state(root) + slug = args.slug + # validate before any mutation — a reject must leave tree + state byte-for-byte unchanged + if slug in state.get("milestones", {}): + _die(f"milestone_not_archived: '{slug}' is still active — " + f"run `add.py archive-milestone {slug}` first (light archive is step one)") + entry = next((e for e in state.get("archived", []) if e.get("slug") == slug), None) + if entry is None: + _die("unknown_milestone") + if entry.get("compacted"): + _die(f"already_compacted: '{slug}' was compacted {entry['compacted']} — " + f"see .add/archive/{slug}/") + dest = root / "archive" / slug + if dest.exists(): + _die(f"archive_destination_exists: .add/archive/{slug}/ exists without a " + "compacted stamp — resolve the collision by hand before compacting") + ms_dir = root / "milestones" / slug + members = list(entry.get("task_slugs") or []) + missing = [str(p.relative_to(root)) for p in + [ms_dir, *(root / "tasks" / t for t in members)] if not p.is_dir()] + if missing: + _die("source_files_missing: " + " · ".join(missing)) + # deltas folded first: an `open` lesson inside the bundle would silently vanish + # from `add.py deltas` (_collect_open_deltas globs tasks/*/TASK.md) once moved. + member_set = set(members) + offenders = sorted({e["task"] for v in _collect_open_deltas(root).values() + for e in v if e["task"] in member_set}) + if offenders: + _die("open_deltas_unfolded: consolidate the open lessons first (`add.py deltas`) — " + "open in: " + " · ".join(offenders)) + # every precondition passed — move (same-filesystem renames, never a delete) + def _files(d: Path) -> int: + return sum(1 for f in d.rglob("*") if f.is_file()) + moved: list[tuple[str, int]] = [] + (root / "archive").mkdir(exist_ok=True) + n = _files(ms_dir) + ms_dir.rename(dest) # the milestone dir becomes the bundle root + moved.append((f"milestones/{slug}/", n)) + (dest / "tasks").mkdir(exist_ok=True) + for t in members: + src = root / "tasks" / t + n = _files(src) + src.rename(dest / "tasks" / t) + moved.append((f"tasks/{t}/", n)) + # state write is the LAST step: additive stamp only — task_slugs untouched + entry["compacted"] = date.today().isoformat() + save_state(root, state) + total = sum(n for _, n in moved) + print(f"compacted milestone '{slug}' -> .add/archive/{slug}/ " + f"({len(members)} task dirs, {total} files moved)") + for path, n in moved: + print(f" moved {path} ({n} files)") + print("recovery: reverse the moves (mv the bundle's parts back) — state needs no edit.") + + +def cmd_set_milestone(args: argparse.Namespace) -> None: + root = _require_root() + state = load_state(root) + task = args.task + if task not in state.get("tasks", {}): + _die("unknown_task") + if args.milestone == "none": + new = None + elif args.milestone in state.get("milestones", {}): + new = args.milestone + else: + _die("unknown_milestone") + state["tasks"][task]["milestone"] = new + state["tasks"][task]["updated"] = _now() + save_state(root, state) + print(f"task '{task}' -> milestone '{new}'" if new else f"task '{task}' -> milestone (none)") + + +def cmd_use(args: argparse.Namespace) -> None: + """Set the active task to an EXISTING task (switch focus) without scaffolding a new + one or hand-editing state.json. advance/gate/phase still take an explicit slug; `use` + just moves the default focus, closing the only gap that forced manual state edits.""" + root = _require_root() + state = load_state(root) + slug = args.slug + if slug not in state.get("tasks", {}): + _die("unknown_task") + state["active_task"] = slug + save_state(root, state) + print(f"active task -> '{slug}' (phase={state['tasks'][slug]['phase']})") + + +def _find_cycle(tasks: dict) -> list[str] | None: + """Return a cycle path in the depends_on graph, or None. Ignores unknown deps.""" + WHITE, GRAY, BLACK = 0, 1, 2 + color = {s: WHITE for s in tasks} + stack: list[str] = [] + + def visit(node: str) -> list[str] | None: + color[node] = GRAY + stack.append(node) + for dep in tasks[node].get("depends_on") or []: + if dep not in tasks: + continue + if color[dep] == GRAY: + return stack[stack.index(dep):] + [dep] + if color[dep] == WHITE: + found = visit(dep) + if found: + return found + color[node] = BLACK + stack.pop() + return None + + for s in tasks: + if color[s] == WHITE: + found = visit(s) + if found: + return found + return None + + +def _sync_task_marker(root: Path, slug: str, phase: str) -> None: + """Keep the `phase:` line inside TASK.md in sync with state.json.""" + task_md = root / "tasks" / slug / "TASK.md" + if not task_md.exists(): + return + lines = task_md.read_text(encoding="utf-8").splitlines() + changed = False + for i, line in enumerate(lines): + if line.startswith("phase:"): + comment = "" + if "", "", body, flags=re.S) + lines = [ln.rstrip() for ln in body.split("\n")] + while lines and not lines[0].strip(): + lines.pop(0) + while lines and not lines[-1].strip(): + lines.pop() + meaningful = [ln for ln in lines + if ln.strip() and not re.fullmatch(r"\s*<.*>\s*", ln)] + return "\n".join(lines) if meaningful else "(empty)" + + +def _phase_spans(text: str) -> dict[int, str]: + """Split a TASK.md into RAW §1–§7 bodies keyed by section number — the ONE + canonical heading scan (`^##\\s*\\s*·`, case/locale-proof); a body runs from + its heading to the next `## `/`---`/EOF. RAW = byte-faithful lines, no cleaning: + the decision-marker extractor (decide-digest) depends on byte-verbatim text. + KNOWN LIMIT: a §body containing a line-start `## ` or bare `---` truncates early — + today's TASK.md bodies don't (box-chars ─═, `### ` sub-heads).""" + lines = text.splitlines() + head = re.compile(r"^##\s*(\d+)\s*·") + starts: dict[int, int] = {} + for idx, ln in enumerate(lines): + m = head.match(ln) + if m: + n = int(m.group(1)) + if 1 <= n <= 7 and n not in starts: + starts[n] = idx + out: dict[int, str] = {} + for n, idx in starts.items(): + body_lines = [] + for ln in lines[idx + 1:]: + if re.match(r"^##\s", ln) or re.match(r"^---\s*$", ln): + break + body_lines.append(ln) + out[n] = "\n".join(body_lines) + return out + + +def _raw_phase_bodies(root: Path, slug: str) -> dict[int, str]: + """RAW §bodies for one task (byte-faithful, for marker extraction). PURE. + Missing/unreadable TASK.md -> {} (fail-closed, like task_phases).""" + f = root / "tasks" / slug / "TASK.md" + try: + return _phase_spans(f.read_text(encoding="utf-8")) + except OSError: + return {} + + +def task_phases(root: Path, slug: str) -> list[dict]: + """The frozen per-task PHASE-DETAIL shape (v9-1): parse TASK.md §1–§7 into seven + blocks specify→observe. PURE — NO writes. Each entry is + { "phase": , "n": <1..7>, "body": }. + + The heading scan lives in _phase_spans (shared with the decide digest); this view + CLEANS each body. Missing file / missing section / placeholder-only body -> + "(empty)" (fail-closed).""" + names = PHASES[:7] # specify..observe; "done" is a terminal STATE, not a section + f = root / "tasks" / slug / "TASK.md" + try: + text = f.read_text(encoding="utf-8") + except OSError: # missing OR unreadable -> every phase fail-closed to "(empty)" + return [{"phase": names[n - 1], "n": n, "body": "(empty)"} for n in range(1, 8)] + spans = _phase_spans(text) + return [{"phase": names[n - 1], "n": n, + "body": _clean_phase_body(spans[n]) if n in spans else "(empty)"} + for n in range(1, 8)] + + +def _task_title(root: Path, slug: str) -> str: + """The task's display title from TASK.md line 1 `# TASK: ` (fail-soft: the + slug if the file or the header line is missing).""" + f = root / "tasks" / slug / "TASK.md" + try: + text = f.read_text(encoding="utf-8") + except OSError: # missing OR unreadable -> fail-soft to the slug + return slug + for ln in text.splitlines(): + m = re.match(r"^#\s*TASK:\s*(.+)", ln) + if m: + return m.group(1).strip() + return slug + + +def _detail_body(body: str, width: int) -> list[str]: + """Indent a phase body under its block, soft-wrapping over-long physical lines on + spaces while preserving blank lines + each line's leading indent (so scenarios and + contract code keep their shape). Fenced ``` blocks are exempt: delimiter lines and + everything inside an open fence emit BYTE-VERBATIM (indent + raw — no wrap, no + whitespace collapse, even past width) so a copied contract round-trips after + stripping the uniform indent; an unclosed fence runs verbatim to the §body end + (fail-open). Drill-down = reading is the point, never clipped.""" + indent = " " + out: list[str] = [] + fenced = False + for raw in body.split("\n"): + is_delim = raw.lstrip().startswith("```") + if fenced or is_delim: + fenced = fenced != is_delim # delimiter toggles; content keeps state + out.append(indent + raw if raw.strip() else "") + continue + if not raw.strip(): + out.append("") + continue + if len(indent) + len(raw) <= width: + out.append(indent + raw) + continue + lead = raw[: len(raw) - len(raw.lstrip())] + prefix = indent + lead + cur = "" + for w in raw.split(): + cand = f"{cur} {w}".strip() + if cur and len(prefix) + len(cand) > width: + out.append(prefix + cur) + cur = w + else: + cur = cand + if cur: + out.append(prefix + cur) + return out + + +def render_task_detail(root: Path, state: dict, mslug: str, slug: str, *, + width: int = _DEFAULT_WIDTH, ascii: bool = False) -> str: + """Format ONE task's seven phase blocks (specify→observe) as the read-only PHASE + DETAIL: each block shows its number+name, a reached/current/pending marker (from the + task's state phase), and its captured §N body (fail-closed to "(empty)"). The verify + block additionally prints the recorded GATE from state.json — authoritative, NEVER + parsed from prose. Returns PLAIN text (no ANSI); color is a tty-only skin in + cmd_report. PURE — NO writes (the v9 read-only discipline, carried).""" + g = _ASCII if ascii else _UNICODE + W = width + banner, rule = g["h"] * W, " " + g["rule"] * (W - 1) + t = (state.get("tasks") or {}).get(slug, {}) + phase = t.get("phase", "specify") + gate = t.get("gate", "none") + ci = PHASES.index(phase) if phase in PHASES else 0 + + L = [banner, f" {mslug} · {slug} · {_task_title(root, slug)}", banner] + L.append(f" PHASE {phase} GATE {gate}") + L.append(banner) + for p in task_phases(root, slug): + i = p["n"] - 1 + mk = (g["reached"] if (phase == "done" or i < ci) + else g["current"] if i == ci else g["pending"]) + L.append("") + L.append(f" {mk} {p['n']} {p['phase'].upper()}") + L.append(rule) + if p["n"] == 6: # verify: the recorded gate, sourced from state (not prose) + L.append(f" GATE {gate}") + if p["body"] == "(empty)": + L.append(" (empty)") + else: + L.extend(_detail_body(p["body"], W)) + L.append(banner) + return "\n".join(L) + + +def render_report(root: Path, state: dict, mslug: str, *, + width: int = _DEFAULT_WIDTH, ascii: bool = False) -> str: + """Format the FACTS (report_data) as the text DASHBOARD — verdict-first header, + left-aligned ASCII columns (alignment-safe on any locale), Unicode/ASCII glyph + tier, one legend. Returns PLAIN text (no ANSI); color is a tty-only layer in + cmd_report so the persisted RETRO.md string stays plain. NO writes.""" + d = report_data(root, state, mslug) + g = _ASCII if ascii else _UNICODE + W = width + banner, rule = g["h"] * W, g["rule"] * W + m, s = d["milestone"], d["summary"] + done, total = s["tasks_done"], s["tasks_total"] + gates, ec = s["gates"], s["exit_criteria"] + + verdict = ("BLOCKED" if gates["HARD-STOP"] + else "DONE" if total and done == total else "ACTIVE") + gbits = [] + if gates["PASS"]: + gbits.append(f"{gates['PASS']} PASS") + if gates["RISK-ACCEPTED"]: + gbits.append(f"{gates['RISK-ACCEPTED']} RISK") + if gates["HARD-STOP"]: + gbits.append(f"{gates['HARD-STOP']} STOP") + gate_txt = " ".join(gbits) if gbits else "none" + waiver_txt = f"{len(d['waivers'])}" if d["waivers"] else "none" + + # Header: title in the banner, then a 2-col aligned label grid (ASCII-safe cells, + # so no width breakage) — VERDICT leads on its own line for emphasis. + L = [banner, f" {m['slug']} · {m['title']}", banner] + L.append(f" {'VERDICT':<9} {verdict}") + L.append(f" {'TASKS':<9} {f'{done}/{total} done':<18} {'CRITERIA':<9} {ec['met']}/{ec['total']} met") + L.append(f" {'GATES':<9} {gate_txt:<18} {'WAIVERS':<9} {waiver_txt}") + L.append("") + L.extend(_wrap(m["goal"], W - 7, " goal ")) + L.append("") + if d["tasks"]: + L.append(f" {'TASK':<27} {'PHASE':<9} {'GATE':<4} {'TESTS':<5} PROGRESS") + L.append(" " + g["rule"] * (W - 1)) + for r in d["tasks"]: + slug = _clip(r["slug"], 27) + gate = _GATE_SHORT.get(r["gate"], r["gate"]) + tests = f"{r['tests']}†" if r.get("tests_declared") else str(r["tests"]) + L.append(f" {slug:<27} {r['phase']:<9} {gate:<4} " + f"{tests:<5} {_phase_track(r['phase'], g)}") + L.append(f" legend {g['reached']} reached {g['current']} current " + f"{g['pending']} pending spec→…→done") + if any(r.get("tests_declared") for r in d["tasks"]): + L.append(" † counted at the §4-declared path") + else: + L.append(" (no tasks yet)") + L.append("") + L.append(f" EXIT CRITERIA {_bar(ec['met'], ec['total'], 10, g)} {ec['met']}/{ec['total']} met") + if d["waivers"]: # header grid carries the count; show DETAILS here only when present + L.append("") + L.append(f" WAIVERS ({len(d['waivers'])})") + for w in d["waivers"]: + L.extend(_wrap(f"{w['slug']}: {w['owner']} · {w['ticket']} · expires {w['expires']}", + W - 5, f" {g['bullet']} ")) + L.append("") + if d["deltas"]: # the retro's payload — word-wrapped to FULL readable text, never clipped + L.append(f" LEARNINGS ({len(d['deltas'])} carried)") + for x in d["deltas"]: + L.extend(_wrap(x, W - 5, f" {g['bullet']} ")) + else: + L.append(" LEARNINGS none") + L.append("") # DECIDE NEXT footer (v13): always present, APPEND-ONLY + L.extend(_wrap(_decide_next_base(state, d), W - 15, " DECIDE NEXT ")) + if _planned_hint(d): # own segment so the phrase never splits mid-token + L.extend(_wrap(_planned_hint(d).removeprefix(" — "), W - 15, " " * 14)) + L.append(banner) + return "\n".join(L) + + +# ---- decide digest (v13 decide-digest, frozen §3) --------------------------- +# Decision markers: prose conventions surfaced VERBATIM. The engine EXTRACTS; it +# never interprets, scores, or filters — add.py stays judgment-free, the human +# signature is the gate. +_MARKER_PREFIXES = (("⚠", "⚠"), ("- [~]", "[~]"), ("- [ ]", "[ ]")) +_FRONT_PHASES = ("specify", "scenarios", "contract", "tests") + + +def _decision_markers(body: str, section: int) -> list[dict]: + """Extract decision markers from a RAW §body: a line whose first non-space chars + are `⚠` / `- [~]` / `- [ ]`, PLUS its continuation lines (immediately following + non-blank lines indented deeper than the marker). text is BYTE-VERBATIM — never + re-wrapped, never clipped. Fail-open by design (a differently-worded item is + missed); the always-printed count keeps that visible.""" + items: list[dict] = [] + lines = body.split("\n") + i = 0 + while i < len(lines): + ln = lines[i] + stripped = ln.lstrip() + tag = next((t for p, t in _MARKER_PREFIXES if stripped.startswith(p)), None) + if tag is None: + i += 1 + continue + indent = len(ln) - len(stripped) + block = [ln] + j = i + 1 + while j < len(lines): + nxt = lines[j] + ns = nxt.lstrip() + if ns and (len(nxt) - len(ns)) > indent: + block.append(nxt) + j += 1 + else: + break + items.append({"marker": tag, "section": section, "text": "\n".join(block)}) + i = j + return items + + +def _contract_frozen(raw3: str) -> bool: + """§3's `Status:` line is the freeze signal (v12 precedent: the freeze is + artifact-observable; no engine flag). Missing Status -> DRAFT (fail-closed).""" + return any(re.match(r"\s*Status:\s*FROZEN", ln) for ln in raw3.splitlines()) + + +_FLAG_LABEL_RE = re.compile(r"Least-sure flag surfaced at freeze\s*:", re.I) +_FLAG_PART_RE = re.compile( + r"\[(?:spec|scenario|contract|test)(?:/(?:spec|scenario|contract|test))*\]") +_FLAG_NONE_ESCAPE_RE = re.compile( + r"none material\s*[—-]+\s*biggest risk\s*:\s*\S", re.I) + + +def _flag_well_formed(raw3: str) -> bool: + """A FROZEN §3 must surface a WELL-FORMED lowest-confidence flag — the unit + that NAMES which part of the bundle is least certain. Well-formed := the label + phrase + a unit carrying >=1 [part] tag (part in spec/scenario/contract/test, + slash-joinable like [spec/contract]) + substantive content. A bare 'none' is + refused unless it takes the honest escape 'none material — biggest risk: X'. + why/cost stay a human-read convention, never machine keywords (evidence: the + lived flags use em-dash/prose, never literal because/if-wrong). HTML comments + (template hints) never count. PURE — fail-closed on a missing label.""" + body = re.sub(r"<!--.*?-->", "", raw3, flags=re.S) + m = _FLAG_LABEL_RE.search(body) + if not m: + return False + unit = body[m.end():].strip() + if not unit: + return False + if _FLAG_NONE_ESCAPE_RE.search(unit): # the honest-none escape — no tag needed + return True + if not _FLAG_PART_RE.search(unit): # must name WHICH part is uncertain + return False + residue = _FLAG_PART_RE.sub("", unit).replace("⚠", "").strip(" -—·\n\t") + return len(residue) >= 3 # substantive content beyond the tag(s) + + +def decide_data(root: Path, state: dict, mslug: str, slug: str) -> dict: + """FACTS for the task-level decision-point digest (frozen shape). The decision comes + from STATE ONLY: recorded (gate set / observe / done) · front (specify→tests) · + gate (build/verify). judgment = extracted markers, byte-verbatim. PURE.""" + tasks = state.get("tasks") or {} + t = tasks.get(slug, {}) + phase = t.get("phase", "specify") + gate = t.get("gate", "none") + if gate != "none" or phase in ("observe", "done"): + seam = "recorded" + elif phase in _FRONT_PHASES: + seam = "front" + else: + seam = "gate" + raw = _raw_phase_bodies(root, slug) + frozen = _contract_frozen(raw.get(3, "")) + if seam == "gate": # the items closest to the gate lead: §6 first, then §1 + judgment = _decision_markers(raw.get(6, ""), 6) + _decision_markers(raw.get(1, ""), 1) + elif seam == "front" and not frozen: + judgment = _decision_markers(raw.get(1, ""), 1) + _decision_markers(raw.get(3, ""), 3) + else: + judgment = [] + + members = [x for x in tasks.values() if x.get("milestone") == mslug] + done, total = sum(1 for x in members if _task_done(x)), len(members) + facts = {"phase": phase, "gate": gate, + "deps": [{"slug": d, "gate": tasks.get(d, {}).get("gate", "none")} + for d in t.get("depends_on", [])], + "tests": _tests_info(root, slug)[0]} + + if seam == "gate": + unlocks = f"gate PASS -> task done -> milestone {min(done + 1, total)}/{total}" + decide = "add.py gate PASS | RISK-ACCEPTED | HARD-STOP" + elif seam == "front" and not frozen: + unlocks = "freeze §3 -> the auto run takes build -> verify (autonomy: auto by default)" + decide = "approve -> freeze §3 (Status: FROZEN @ v1) -> auto run" + elif seam == "front": + unlocks = "none" + decide = "no decision pending — frozen; the run owns it. next decision point: verify gate" + else: + unlocks = "none" + decide = f"no decision pending — recorded gate: {gate}" + return {"seam": seam, "milestone": mslug, "task": slug, "phase": phase, + "gate": gate, "judgment": judgment, "facts": facts, + "unlocks": unlocks, "decide": decide} + + +def render_decide(root: Path, state: dict, mslug: str, slug: str, *, + width: int = _DEFAULT_WIDTH, ascii: bool = False) -> str: + """Text view of the decision-point digest — decisive facts FIRST: NEEDS YOUR + JUDGMENT (markers byte-verbatim, section-tagged) -> [front: §3 verbatim] -> + ENGINE FACTS -> UNLOCKS -> DECIDE. PURE — no writes; plain text (color is a + tty-only skin in cmd_report, like every report view).""" + d = decide_data(root, state, mslug, slug) + g = _ASCII if ascii else _UNICODE + banner = g["h"] * width + seam_label = {"gate": "VERIFY GATE", "front": "CONTRACT APPROVAL", + "recorded": "RECORDED"}[d["seam"]] + L = [banner, f" DECIDE · {mslug or '—'} · {slug} · decision point: {seam_label}", banner] + if d["decide"].startswith("no decision pending"): + L.append(f" {d['decide']}") + L.append(f" GATE {d['gate']}") + L.append(banner) + return "\n".join(L) + L.append(f" NEEDS YOUR JUDGMENT ({len(d['judgment'])})") + for item in d["judgment"]: + L.append(f" [§{item['section']}]") + L.extend(item["text"].split("\n")) # byte-verbatim — never wrapped/clipped + if d["seam"] == "front": + L.append("") + L.append(" CONTRACT (§3 verbatim)") + L.extend(_raw_phase_bodies(root, slug).get(3, "").split("\n")) + L.append(" STATUS DRAFT") + f = d["facts"] + deps_txt = " ".join(f"{x['slug']}:{x['gate']}" for x in f["deps"]) or "none" + L.append("") + L.append(f" ENGINE FACTS phase {f['phase']} · gate {f['gate']} · " + f"deps {deps_txt} · tests {f['tests']}") + L.append(f" UNLOCKS {d['unlocks']}") + L.append(f" DECIDE {d['decide']}") + L.append(banner) + return "\n".join(L) + + +def _planned_unscaffolded(root: Path, mslug: str) -> list[str]: + """Slugs MILESTONE.md plans (rows `- [ ] <slug> …`) that have no TASK.md yet — + the plan-vs-state diff. Only valid-slug first-tokens match (a template + placeholder like <slug> never does); file order, deduped; fail-closed [].""" + md = root / "milestones" / mslug / "MILESTONE.md" + try: + text = md.read_text(encoding="utf-8") + except OSError: + return [] + out: list[str] = [] + for sec in re.split(r"^## ", text, flags=re.M)[1:]: + if not sec.startswith("Tasks"): # only the Tasks list — never exit criteria + continue + for m in re.finditer(r"^- \[[ x~]\] ([A-Za-z0-9_-]+)\b", sec, re.M): + slug = m.group(1) + if slug not in out and not (root / "tasks" / slug / "TASK.md").is_file(): + out.append(slug) + return out + + +def _decide_next(state: dict, d: dict) -> str: + """The rollup's DECIDE NEXT line (frozen precedence): HARD-STOP -> consolidate+archive + -> first decision-blocked task (ACTIVE task first, then state order) -> run-in- + progress. v2: when d carries planned_unscaffolded, the line gains a + plan-vs-state suffix — precedence itself stays state-only.""" + return _decide_next_base(state, d) + _planned_hint(d) + + +def _planned_hint(d: dict) -> str: + """The plan-vs-state suffix ('' when nothing is missing). Text renders emit it + as its OWN wrapped segment so the phrase never splits mid-token; the JSON + 'decide' string carries it inline via _decide_next.""" + planned = d.get("planned_unscaffolded") or [] + if not planned: + return "" + return f" — {len(planned)} planned not yet scaffolded: " + " · ".join(planned) + + +def _decide_next_base(state: dict, d: dict) -> str: + ms = d["milestone"]["slug"] + rows = d["tasks"] + if not rows: + return "none — no tasks yet" + stopped = [r for r in rows if r["gate"] == "HARD-STOP"] + if stopped: + return f"resolve HARD-STOP on {stopped[0]['slug']}" + s = d["summary"] + if s["tasks_done"] == s["tasks_total"]: + # tasks complete — but the milestone holds while the goal (exit criteria) is + # unmet (v20). Point at the feed-forward inventory the loop draws from, instead + # of "archive". Fires only when criteria exist; else the prompt is unchanged. + ec = s.get("exit_criteria") or {} + met, total = ec.get("met", 0), ec.get("total", 0) + if total > 0 and met < total: + return (f"goal not met ({met}/{total} exit criteria) — propose next tasks " + f"from open deltas / the unscaffolded plan (add.py deltas)") + return f"consolidate learnings + archive-milestone {ms}" + active = state.get("active_task") + order = sorted(rows, key=lambda r: 0 if r["slug"] == active else 1) # stable + for r in order: + if r["done"]: + continue + if r["phase"] in _FRONT_PHASES: + return (f"approve the contract of {r['slug']} — " + f"add.py report {ms} {r['slug']} --decide") + if r["phase"] == "verify" and r["gate"] == "none": + return f"gate {r['slug']} — add.py report {ms} {r['slug']} --decide" + r = next(x for x in order if not x["done"]) + return f"none — run in progress ({r['slug']} at {r['phase']})" + + +def render_decide_next(root: Path, state: dict, mslug: str, *, + width: int = _DEFAULT_WIDTH, ascii: bool = False) -> str: + """`report <ms> --decide`: ONLY the DECIDE NEXT block (no rollup table). PURE.""" + g = _ASCII if ascii else _UNICODE + banner = g["h"] * width + d = report_data(root, state, mslug) + L = [banner, f" {mslug} · DECIDE NEXT", banner] + L.extend(_wrap(_decide_next_base(state, d), width - 4, " ")) + if _planned_hint(d): # own segment so the phrase never splits mid-token + L.extend(_wrap(_planned_hint(d).removeprefix(" — "), width - 4, " ")) + L.append(banner) + return "\n".join(L) + + +def _write_retro(root: Path, state: dict, mslug: str) -> Path: + """Persist the milestone's CANONICAL render to .add/milestones/<mslug>/RETRO.md + (the spec'd 'Milestone exit report', appendix-f). Reuses the ONE frozen renderer + at its canonical args (width 72, ascii=False) so the doc is byte-identical to a + piped `report <mslug>`. PURE on state: reads via render_report, writes exactly + this one file with explicit utf-8 (the canonical carries Unicode glyphs — never + trust the locale default), never mutates state.json.""" + content = render_report(root, state, mslug, width=_DEFAULT_WIDTH, ascii=False) + path = root / "milestones" / mslug / "RETRO.md" + _atomic_write(path, content) # honor the module's atomic-write contract (no half-write) + return path + + +_COMPETENCY_ORDER = ("DDD", "SDD", "UDD", "TDD", "ADD") +_DELTA_STATUSES = ("open", "folded", "rejected") + +# Canonical delta grammar — the single compiled source for the enumerated +# competency · status shape. Leading \s* is PERMISSIVE so _task_prose can feed +# un-stripped lines directly; callers that pre-strip their input +# (e.g. _collect_open_deltas, _lint_task_deltas) match the same way (\s* +# matches zero). Anchored at line-start via re.match. +_DELTA_RE = re.compile( + r"\s*-\s*\[\s*(DDD|SDD|UDD|TDD|ADD)\s*·\s*(open|folded|rejected)\s*\]\s*(.+)$" +) +_EVIDENCE_RE = re.compile(r"^(.*?)\s*\(evidence:\s*(.*?)\)\s*$") + +# Broad structural tag detector: finds ANY "- [tok · tok]" line (valid OR malformed). +# A line with a `· ` bracket separator is a delta-attempt. Does NOT enumerate +# competencies or statuses — a different abstraction from _DELTA_RE (no DRY violation). +_TAG_BROAD_RE = re.compile(r"^\s*-\s*\[\s*([^\]·]+?)\s*·\s*([^\]·]+?)\s*\]\s*(.*)$") + + +def _lint_task_deltas(root: Path, slug: str) -> tuple[bool, str] | None: + """Lint all open delta entries in a task's '### Competency deltas' block. + + Returns: + None — no delta-attempts found; no check emitted. + (True, "") — all open entries pass. + (False, "<code> -> <tag line>") — first failing entry with its failure code. + + Contract rules (frozen §3, v1): + - SKIP HTML-comment lines and blank lines (they are never tag lines). + - Group lines into ENTRIES: a broad tag line starts an entry; following lines + until next tag / blank / end-of-block are its continuation. + - A line without a '· ' separator inside brackets (e.g. '- [x]') is NOT a tag. + - For each entry, skip folded/rejected (open-only — history not retrofitted). + - Validate the remaining (open) entries: COMP in _COMPETENCY_ORDER, + status in _DELTA_STATUSES, and '(evidence:' present SOMEWHERE in the unit. + - Fail-closed: an unparseable attempt FAILS (never silently passes). + """ + task_md = root / "tasks" / slug / "TASK.md" + if not task_md.exists(): + return None + try: + text = task_md.read_text(encoding="utf-8") + except OSError: + return None + + # Locate the "### Competency deltas" block. + block_match = re.search(r"###\s*Competency deltas\s*\n(.*?)(?=\n##|\Z)", text, re.S) + if not block_match: + return None + + block = block_match.group(1) + raw_lines = block.splitlines() + + # First pass: collect entries (tag line + continuations). + # HTML-comment lines are skipped entirely (invisible to the guard). + # Blank lines terminate the current entry, but are not tags themselves. + entries: list[tuple[str, list[str]]] = [] # (tag_line, [tag_line, *continuations]) + current: list[str] | None = None + for raw_line in raw_lines: + stripped = raw_line.strip() + # Skip HTML-comment lines. + if stripped.startswith("<!--"): + continue + # Blank line terminates the current entry. + if not stripped: + current = None + continue + # Broad tag detection: any "- [tok · tok]" line starts a new entry. + m = _TAG_BROAD_RE.match(raw_line) + if m: + current = [stripped] + entries.append((stripped, current)) + elif current is not None: + # Continuation line of the current entry. + current.append(stripped) + # else: non-blank, non-comment, non-tag line with no prior entry — ignore. + + if not entries: + return None # no delta-attempts → no check emitted + + # Second pass: validate each entry. + for tag_line, unit_lines in entries: + m = _TAG_BROAD_RE.match(tag_line) + if not m: + # Should not happen, but fail-closed. + return False, f"malformed_delta -> {tag_line}" + raw_comp = m.group(1).strip() + raw_status = m.group(2).strip() + + # Step 1: skip historical entries (folded/rejected) — open-only enforcement. + # MUST happen before competency/status validation per §3: "history not retrofitted". + if raw_status in ("folded", "rejected"): + continue + + # Step 2: use _DELTA_RE (the canonical grammar, single source of truth) to test + # whether the tag line is a fully-valid delta shape. If it matches, check evidence + # only. If it fails, classify the failure via the raw tokens (never a parallel grammar). + unit_text = " ".join(unit_lines) + if _DELTA_RE.match(tag_line): + # Valid comp + status + non-empty tail — check evidence in the joined unit. + if "(evidence:" not in unit_text: + return False, f"no_evidence -> {tag_line}" + else: + # Classify why _DELTA_RE rejected it (open entries only — folded/rejected skipped). + if raw_comp not in _COMPETENCY_ORDER: + return False, f"unknown_competency -> {tag_line}" + if raw_status not in _DELTA_STATUSES: + return False, f"unknown_status -> {tag_line}" + # Comp and status are valid but the line still failed _DELTA_RE (e.g. empty tail). + return False, f"malformed_delta -> {tag_line}" + + return True, "" + + +def _collect_open_deltas(root: Path) -> dict[str, list[dict]]: + """Scan every .add/tasks/*/TASK.md for open lessons learned. + + Returns a dict keyed by competency in canonical order; each value is a list + of {task, text, evidence} dicts. READ-ONLY — never mutates any file.""" + by_comp: dict[str, list[dict]] = {c: [] for c in _COMPETENCY_ORDER} + tasks_dir = root / "tasks" + if not tasks_dir.is_dir(): + return by_comp + for task_md in sorted(tasks_dir.glob("*/TASK.md")): + slug = task_md.parent.name + try: + text = task_md.read_text(encoding="utf-8") + except OSError: + continue + # Locate the "### Competency deltas" block (may appear anywhere in the file). + block_match = re.search(r"###\s*Competency deltas\s*\n(.*?)(?=\n##|\Z)", text, re.S) + if not block_match: + continue + block = block_match.group(1) + # Group lines into entries (tag line + continuations) so a multi-line delta — + # whose learning wraps and whose (evidence: …) may land on a later line — is read + # in FULL, not truncated to its first line. A tag line starts an entry; a line + # that does not begin a new "- " list item continues it; a blank/comment or a + # new "- " item ends it (a trailing malformed item can't pollute a delta's text). + entries: list[list[str]] = [] + current: list[str] | None = None + for line in block.splitlines(): + stripped = line.strip() + if not stripped or stripped.startswith("<!--"): + current = None + continue + if _DELTA_RE.match(stripped): + current = [stripped] + entries.append(current) + elif current is not None and not stripped.startswith("-"): + current.append(stripped) # genuine wrap of the current learning + else: + current = None # a new / malformed list item ends the run + for unit in entries: + m = _DELTA_RE.match(unit[0]) + comp, status = m.group(1), m.group(2) + if status != "open": + continue + # Join the tag line's tail with any continuation lines, then split evidence. + tail = " ".join([m.group(3).strip(), *unit[1:]]).strip() + em = _EVIDENCE_RE.match(tail) + if em: + delta_text, evidence = em.group(1).strip(), em.group(2).strip() + else: + delta_text, evidence = tail, "" + by_comp[comp].append({"task": slug, "text": delta_text, "evidence": evidence}) + return by_comp + + +_AUDIT_STAMP_RE = re.compile(r"Status:\s*FROZEN @ v\d+\s*[—-]+\s*approved by\s+\S+") +_AUDIT_OUTCOME_RE = re.compile(r"^Outcome:\s*(PASS|RISK-ACCEPTED|HARD-STOP)\b", re.M) +_AUDIT_SECURITY_RE = re.compile( + r"^\s*- \[[ x~]\] no exposed secrets.*(?:\n(?!\s*- \[|#).*)*", re.M) +_AUDIT_REVIEWED_RE = re.compile(r"^Reviewed by:(.*)$", re.M) + + +def _audit_findings(root: Path, state: dict) -> tuple[int, list[dict]]: + """The gate-audit core: verify that human decision points left WELL-FORMED records. + Judgment-free — checks record SHAPE (a named human at the freeze, exactly one + gate outcome, prose ≡ state, a marked security note never auto-reviewed), + never re-decides an outcome. Scope: active tasks done/observe or gated; open + fronts skipped. PURE — reads only. Honest limit: shape, not engagement — a + forged name passes; CI wiring makes forgery explicit and attributable.""" + tasks = state.get("tasks") or {} + checked, findings = 0, [] + + def f(slug: str, code: str, detail: str) -> None: + findings.append({"task": slug, "code": code, "detail": detail}) + + for slug in sorted(tasks): + t = tasks[slug] + phase, gate = t.get("phase", "specify"), t.get("gate", "none") + if phase not in ("done", "observe") and gate == "none": + continue # the front is still open — nothing recorded to audit + checked += 1 + raw = _raw_phase_bodies(root, slug) + s3, s6 = raw.get(3, ""), raw.get(6, "") + if not _AUDIT_STAMP_RE.search(s3): + f(slug, "unstamped_freeze", + "§3 lacks 'Status: FROZEN @ vN — approved by <name>'") + # verified-marker discriminator (task unflagged-freeze): enforce the + # lowest-confidence flag ONLY on records that crossed the guard (flag_verified). + # A marked record whose flag was deleted/corrupted post-freeze is + # tampering; unmarked predecessors are skipped — the board is never + # retro-redded. + if t.get("flag_verified") and not _flag_well_formed(s3): + f(slug, "unflagged_freeze", + "flag_verified record lost its well-formed " + "'Least-sure flag surfaced at freeze:' unit") + outcomes = _AUDIT_OUTCOME_RE.findall(s6) + if len(outcomes) != 1: + f(slug, "malformed_gate_record", + f"{len(outcomes)} Outcome lines in §6 (need exactly 1)") + elif gate != "none" and outcomes[0] != gate: + f(slug, "gate_record_mismatch", + f"§6 records {outcomes[0]} but state.json records {gate}") + sec = _AUDIT_SECURITY_RE.search(s6) + marked = bool(sec and ("NOTE" in sec.group(0) or "⚠" in sec.group(0))) + rev = _AUDIT_REVIEWED_RE.search(s6) + if marked and rev and "auto-gate" in rev.group(1): + f(slug, "unescalated_security_note", + "security-line note (NOTE/⚠) with an auto-gate reviewer") + # F7 unguarded_high_risk_auto (task high-risk-signal, v14): a declared + # high-risk record must show a guarded dial AND a human at the gate — + # catches post-gate header tampering and auto-resolved high-risk gates. + hdr = _task_header(root, slug) + if _RISK_HIGH_RE.search(hdr): + if not _AUTONOMY_CONSERVATIVE_RE.search(hdr): + f(slug, "unguarded_high_risk_auto", + "risk: high declared but autonomy is not 'conservative'") + elif rev and "auto-gate" in rev.group(1): + f(slug, "unguarded_high_risk_auto", + "risk: high task whose GATE RECORD reviewer is the auto-gate") + if outcomes == ["RISK-ACCEPTED"]: + if marked: + f(slug, "risk_accepted_security", + "a waiver on a marked security item is never allowed") + if not all(re.search(rf"{k}:\s*(?!<)\S", s6) + for k in ("owner", "ticket", "expires")): + f(slug, "waiver_incomplete", + "RISK-ACCEPTED needs owner · ticket · expires") + return checked, findings + + +def cmd_audit(args: argparse.Namespace) -> None: + """Read-only: audit recorded human decision points for well-formedness. Exit 0 clean, + exit 1 with findings — the enforcement gate CI consumes (audit-ci). Writes + NOTHING; every other command is byte-identical.""" + root = _require_root() + checked, findings = _audit_findings(root, load_state(root)) + if getattr(args, "json", False): + print(json.dumps({"checked": checked, "findings": findings}, + ensure_ascii=False, indent=2)) + else: + if findings: + for x in findings: + print(f"audit: {x['code']} {x['task']} — {x['detail']}") + else: + print(f"audit: clean ({checked} tasks checked)") + if findings: + sys.exit(1) + + +def _retro_carried(path: Path) -> int: + """Parse the 'LEARNINGS (N carried)' count from a RETRO.md; absent/unreadable -> 0. + READ-ONLY (the graduation harvest's carried-delta facet for the consolidated tier).""" + try: + text = path.read_text(encoding="utf-8") + except OSError: + return 0 + m = re.search(r"LEARNINGS \((\d+) carried\)", text) + return int(m.group(1)) if m else 0 + + +def graduation_data(root: Path, state: dict) -> dict: + """The single source of FACTS for the graduation harvest — PURE, NO writes (mirrors + report_data). Both the `graduation-report` text dashboard and `--json` render from this + one dict, so the human view and the machine view can never disagree. + + GATHER, never JUDGE: every value is a RECORD the human verifies by looking; there is no + readiness/score/ranking field by construction (would_be_judging is structurally impossible). + Two tiers: LIVE = in-state (state + on-disk TASK.md); CONSOLIDATED = compacted milestones, + a RETRO record only. A missing/unreadable source is SKIPPED, never a crash (fail-closed).""" + tasks = state.get("tasks") or {} + milestones = state.get("milestones") or {} + archived = state.get("archived") or [] + + # a — open deltas by competency (reuse the project-wide harvester; compacted folded out) + by_comp = _collect_open_deltas(root) + open_deltas = {"total": sum(len(v) for v in by_comp.values()), + "by_competency": {c: v for c, v in by_comp.items() if v}} + + # b — open RISK-ACCEPTED waivers, soonest expiry first (missing/unparseable expiry sorts LAST) + waivers = [] + for slug, t in tasks.items(): + if t.get("gate") == "RISK-ACCEPTED" and t.get("waiver"): + w = t["waiver"] + waivers.append({"slug": slug, "owner": w.get("owner", "?"), + "ticket": w.get("ticket", "?"), "expires": w.get("expires", "?")}) + + def _exp_key(wv): + try: + return (0, date.fromisoformat(wv["expires"]).isoformat()) + except (ValueError, TypeError): + return (1, "") # unparseable/missing -> after every real date + waivers.sort(key=_exp_key) + + # c — RETRO records: LIVE under milestones/, CONSOLIDATED under archive/ (the compacted backbone) + retros = [] + for sub_dir, tier in ((root / "milestones", "live"), (root / "archive", "consolidated")): + if sub_dir.is_dir(): + for retro in sorted(sub_dir.glob("*/RETRO.md")): + if retro.is_file(): # a directory at the path is not a ledger (fail-closed) + retros.append({"milestone": retro.parent.name, + "path": str(retro.relative_to(root)), + "carried_deltas": _retro_carried(retro), "tier": tier}) + + # d-i — residue gate records: the residue-class facet (RISK-ACCEPTED shares the waivers[] record) + residue_gates = [{"slug": s, "gate": t.get("gate")} for s, t in tasks.items() + if t.get("gate") in ("RISK-ACCEPTED", "HARD-STOP")] + + # d-ii — §6 disclosed residue: in-state tasks' '- [⚠]' VERIFY list items (the pinned rule) + # e — coverage-gaps proxy: in-state §7 Watch still the '<error rate' placeholder head + residue_disclosed, coverage_gaps = [], [] + for slug in tasks: + try: + text = (root / "tasks" / slug / "TASK.md").read_text(encoding="utf-8") + except OSError: + continue # unreadable TASK.md -> skip this task's prose records + m = re.search(r"##\s*6\b.*?(?=\n##\s*\d|\Z)", text, re.S) # the VERIFY section only + for line in (m.group(0) if m else "").splitlines(): + st = line.strip() + if st.startswith("- [⚠]"): + residue_disclosed.append({"slug": slug, "line": st[len("- [⚠]"):].strip()}) + for line in text.splitlines(): + if line.startswith("Watch") and "<error rate" in line: # unfilled <…> template head + coverage_gaps.append({"slug": slug}) + break + + return { + "open_deltas": open_deltas, + "waivers": waivers, + "retros": retros, + "residue_gates": residue_gates, + "residue_disclosed": residue_disclosed, + "coverage_gaps": coverage_gaps, + "summary": { + "open_deltas": open_deltas["total"], "waivers": len(waivers), "retros": len(retros), + "residue_gates": len(residue_gates), "residue_disclosed": len(residue_disclosed), + "coverage_gaps": len(coverage_gaps), + "milestones_live": len(milestones), "milestones_consolidated": len(archived), + }, + } + + +def cmd_graduation_report(args: argparse.Namespace) -> None: + """Read-only: GATHER the MVP loop's evidence into five labeled record-sets for the + graduate.md interview. text (default) or --json (the frozen JSON facts interface). Exit 0 ALWAYS — + a gather, not a gate; the ONLY non-zero exit is no_project. Judges nothing. NO writes.""" + root = find_root() + if root is None: # frozen contract: fail-closed with a no_project signal + _die("no_project: no .add/ project found. Run `add.py init` first.") + state = load_state(root) + d = graduation_data(root, state) + + if getattr(args, "json", False): + print(json.dumps(d, ensure_ascii=False, indent=2)) + return + + s = d["summary"] + L = ["GRADUATION REPORT — MVP-loop evidence (gather, not judge)", ""] + L.append(f"Open deltas ({s['open_deltas']}) — unfolded lessons by competency:") + for comp, entries in d["open_deltas"]["by_competency"].items(): + for e in entries: + L.append(f" - [{comp}] {e['text']} [{e['task']}]") + L.append("") + L.append(f"Waivers ({s['waivers']}) — open RISK-ACCEPTED, soonest expiry first:") + for w in d["waivers"]: + L.append(f" - {w['slug']}: {w['owner']} · {w['ticket']} · expires {w['expires']}") + L.append("") + _live_retros = sum(1 for r in d["retros"] if r["tier"] == "live") + _cons_retros = s["retros"] - _live_retros + L.append(f"RETRO records ({s['retros']}: {_live_retros} live · {_cons_retros} consolidated) — " + f"milestones: {s['milestones_live']} live · " + f"{s['milestones_consolidated']} represented by RETRO record:") + for r in d["retros"]: + L.append(f" - {r['milestone']} [{r['tier']}]: {r['path']} ({r['carried_deltas']} carried)") + L.append("") + L.append(f"Verify residue — gate records ({s['residue_gates']}, RISK-ACCEPTED/HARD-STOP):") + for g in d["residue_gates"]: + L.append(f" - {g['slug']}: {g['gate']}") + L.append(f"Verify residue — disclosed §6 lines ({s['residue_disclosed']}):") + for r in d["residue_disclosed"]: + L.append(f" - {r['slug']}: {r['line']}") + L.append("") + L.append(f"Coverage gaps ({s['coverage_gaps']}) — PROXY (monitor not declared; §7 Watch unfilled):") + for c in d["coverage_gaps"]: + L.append(f" - {c['slug']}") + print("\n".join(L)) + + +def cmd_deltas(args: argparse.Namespace) -> None: + """Read-only: report all open lessons learned grouped by competency. + + Scans every .add/tasks/*/TASK.md '### Competency deltas' block for lines + matching the delta grammar; shows only `open` entries in canonical competency + order (DDD·SDD·UDD·TDD·ADD). --json emits one JSON object. Exit 0 ALWAYS. + Writes NOTHING.""" + root = _require_root() + by_comp = _collect_open_deltas(root) + total = sum(len(v) for v in by_comp.values()) + + if getattr(args, "json", False): + payload: dict = { + "total": total, + "by_competency": {c: v for c, v in by_comp.items() if v}, + } + print(json.dumps(payload, ensure_ascii=False)) + return + + if total == 0: + print("no open deltas.") + return + + print(f"open lessons learned ({total} total):") + for comp in _COMPETENCY_ORDER: + entries = by_comp[comp] + if not entries: + continue + print(f" {comp} ({len(entries)}):") + for e in entries: + print(f" - {e['text']} [{e['task']}]") + + +def cmd_project(args: argparse.Namespace) -> None: + """Read-only: print .add/PROJECT.md (the read-first foundation) in one command. + + Fail-closed: a missing foundation dies with a clear stderr message + a non-zero + exit, never a silent empty print. Writes NOTHING.""" + root = _require_root() + foundation = root / "PROJECT.md" + if not foundation.exists(): + _die("missing foundation: .add/PROJECT.md (run `add.py init` to scaffold it)") + print(foundation.read_text(encoding="utf-8"), end="") + + +def cmd_report(args: argparse.Namespace) -> None: + """Read-only: capture a milestone's raw data (--json) or render the text + dashboard (color on a tty, ASCII when the terminal can't do Unicode, --plain + forces the pipe/screen-reader-safe tier). Writes nothing, never mutates state.""" + root = _require_root() + state = load_state(root) + milestones = state.get("milestones") or {} + tasks = state.get("tasks") or {} + name = args.milestone # 1st positional (SMART: milestone-first, else task) + task = getattr(args, "task", None) + + # Resolve to a ROLLUP (mslug) or a DRILL (mslug + drill_task). Drill path is purely + # additive; the rollup branches are byte-for-byte the v9 behavior. + drill_task = None + if task is not None: # explicit `report <m> <task>` + mslug = name + if mslug not in milestones: + _die(f"unknown_milestone: '{mslug}' is not a milestone") + if tasks.get(task, {}).get("milestone") != mslug: + _die(f"unknown_task: '{task}' is not a task of milestone '{mslug}'") + drill_task = task + elif name is not None: # smart single positional + if name in milestones: + mslug = name # -> rollup (unchanged) + elif name in tasks: # -> drill by task name + drill_task = name + mslug = tasks[name].get("milestone") + if not mslug: + _die(f"unknown_milestone: task '{name}' is not attached to a milestone") + else: + _die(f"unknown_milestone: '{name}' is not a milestone") + elif getattr(args, "decide", False): # bare --decide -> the ACTIVE TASK + slug = state.get("active_task") + if not slug or slug not in tasks: + _die("no_active_task — name one: add.py report <milestone> <task> --decide") + drill_task = slug + mslug = tasks[slug].get("milestone") or "" + else: # no positional -> active milestone + mslug = state.get("active_milestone") + if not mslug: + _die("no_active_milestone: no milestone given and none is active; " + "try `add.py report <milestone>`") + if mslug not in milestones: + _die(f"unknown_milestone: '{mslug}' is not a milestone") + + if getattr(args, "decide", False): + # Decision-seam digest (v13): task -> seam digest; milestone -> DECIDE NEXT + # block only. PURE, like every report path. + if getattr(args, "json", False): + if drill_task: + payload = decide_data(root, state, mslug, drill_task) + else: # milestone altitude: same frozen key set, task null + d = report_data(root, state, mslug) + payload = {"seam": "milestone", "milestone": mslug, "task": None, + "phase": "", "gate": "none", "judgment": [], + "facts": {"phase": "", "gate": "none", "deps": [], "tests": 0}, + "unlocks": "", "decide": _decide_next(state, d)} + print(json.dumps(payload, ensure_ascii=False, indent=2)) + return + plain = getattr(args, "plain", False) + interactive = sys.stdout.isatty() and not plain + width = _term_width() if interactive else _DEFAULT_WIDTH + use_ascii = plain or _use_ascii() + out = (render_decide(root, state, mslug, drill_task, width=width, ascii=use_ascii) + if drill_task else + render_decide_next(root, state, mslug, width=width, ascii=use_ascii)) + if not plain and _color_enabled(): + out = _colorize(out) + print(out) + return + + if getattr(args, "json", False): + # POLYMORPHIC by path: drill -> task_phases list; rollup -> report_data dict. + payload = task_phases(root, drill_task) if drill_task \ + else report_data(root, state, mslug) + print(json.dumps(payload, ensure_ascii=False, indent=2)) + return + plain = getattr(args, "plain", False) + interactive = sys.stdout.isatty() and not plain + width = _term_width() if interactive else _DEFAULT_WIDTH + use_ascii = plain or _use_ascii() + out = (render_task_detail(root, state, mslug, drill_task, width=width, ascii=use_ascii) + if drill_task else + render_report(root, state, mslug, width=width, ascii=use_ascii)) + if not plain and _color_enabled(): + out = _colorize(out) + print(out) + + +def build_parser() -> argparse.ArgumentParser: + p = argparse.ArgumentParser(prog="add.py", description="ADD scaffolder + state tracker") + sub = p.add_subparsers(dest="cmd", required=True) + + pi = sub.add_parser("init", help="create a .add/ project here") + pi.add_argument("--dir", default=".", help="target directory (default: cwd)") + pi.add_argument("--name", default=None, help="project name (default: dir name)") + pi.add_argument("--stage", default="prototype", choices=STAGES) + pi.add_argument("--force", action="store_true", help="reset state.json if present") + pi.add_argument("--await-lock", dest="await_lock", action="store_true", + help="seed an unlocked setup; gates new-task/advance/gate until `add.py lock`") + pi.set_defaults(func=cmd_init) + + pl = sub.add_parser("lock", + help="freeze the autonomous setup (the human baseline approval) and open the build") + pl.add_argument("--by", default=None, help="who is locking (default: current OS user)") + pl.add_argument("--layers", default=None, + help="comma-separated lock layers (default: foundation,scope,contract)") + pl.add_argument("--force", action="store_true", help="re-lock an already-locked project") + pl.add_argument("--json", action="store_true", help="emit one JSON object instead of text") + pl.set_defaults(func=cmd_lock) + + pn = sub.add_parser("new-task", help="scaffold a new task (TASK.md + tests/ + src/)") + pn.add_argument("slug") + pn.add_argument("--title", default=None) + pn.add_argument("--milestone", default=None, help="attach to a milestone (default: active)") + pn.add_argument("--depends-on", dest="depends_on", default=None, + help="comma-separated task slugs this task depends on") + pn.add_argument("--force", action="store_true", help="overwrite TASK.md if present") + pn.set_defaults(func=cmd_new_task) + + pm = sub.add_parser("new-milestone", help="scaffold a milestone (SDD living doc)") + pm.add_argument("slug") + pm.add_argument("--title", default=None) + pm.add_argument("--goal", default=None, help="one-sentence outcome") + pm.add_argument("--stage", default="mvp", choices=STAGES) + pm.add_argument("--force", action="store_true", help="overwrite MILESTONE.md if present") + pm.set_defaults(func=cmd_new_milestone) + + pr = sub.add_parser("ready", help="list tasks whose dependencies are satisfied") + pr.add_argument("--json", action="store_true", help="machine-readable JSON output") + pr.set_defaults(func=cmd_ready) + + pmd = sub.add_parser("milestone-done", help="exit-gate a milestone (all tasks must PASS)") + pmd.add_argument("slug") + pmd.set_defaults(func=cmd_milestone_done) + + psm = sub.add_parser("set-milestone", help="attach/move/detach an existing task") + psm.add_argument("task") + psm.add_argument("milestone", help="milestone slug, or 'none' to detach") + psm.set_defaults(func=cmd_set_milestone) + + pu = sub.add_parser("use", help="set the active task to an existing one (switch focus)") + pu.add_argument("slug") + pu.set_defaults(func=cmd_use) + + pam = sub.add_parser("archive-milestone", + help="collapse a done milestone out of active state (files stay on disk)") + pam.add_argument("slug") + pam.set_defaults(func=cmd_archive_milestone) + + pco = sub.add_parser("compact", + help="heavy archive: move an archived milestone's files into " + ".add/archive/<slug>/ (recoverable reverse move)") + pco.add_argument("slug") + pco.set_defaults(func=cmd_compact) + + pp = sub.add_parser("phase", help="set a task's phase explicitly") + pp.add_argument("phase", choices=PHASES) + pp.add_argument("slug", nargs="?", default=None) + pp.set_defaults(func=cmd_phase) + + pa = sub.add_parser("advance", help="move a task to the next phase") + pa.add_argument("slug", nargs="?", default=None) + pa.set_defaults(func=cmd_advance) + + pg = sub.add_parser("gate", help="record a verify gate outcome") + pg.add_argument("outcome", choices=GATES) + pg.add_argument("slug", nargs="?", default=None) + pg.add_argument("--owner", help="RISK-ACCEPTED waiver: accountable owner") + pg.add_argument("--ticket", help="RISK-ACCEPTED waiver: tracking ticket/link") + pg.add_argument("--expires", help="RISK-ACCEPTED waiver: expiry date") + pg.set_defaults(func=cmd_gate) + + pr = sub.add_parser("reopen", help="return a done task to an earlier phase with a recorded reason") + pr.add_argument("slug", nargs="?", default=None) + # --to / --reason are validated in-body (not argparse choices) so the named reject + # codes fire (reopen_target_invalid / reopen_reason_required), not a bare exit-2. + pr.add_argument("--to", default=None, help="target phase (specify..observe)") + pr.add_argument("--reason", default="", help="why the task is reopened (required, non-empty)") + pr.set_defaults(func=cmd_reopen) + + ps = sub.add_parser("stage", help="set the project stage") + ps.add_argument("stage", choices=STAGES) + ps.add_argument("--force", action="store_true", + help="override the →production roadmap guard (stage_no_roadmap)") + ps.set_defaults(func=cmd_stage) + + pst = sub.add_parser("status", help="print where the project is (resume point)") + pst.add_argument("--json", action="store_true", help="machine-readable JSON output") + pst.set_defaults(func=cmd_status) + + pck = sub.add_parser("check", help="read-only integrity check of the .add project") + pck.add_argument("--json", action="store_true", help="machine-readable JSON output") + pck.set_defaults(func=cmd_check) + + psg = sub.add_parser("sync-guidelines", + help="(re)write the ADD guideline block into AGENTS.md + CLAUDE.md") + psg.set_defaults(func=cmd_sync_guidelines) + + pgd = sub.add_parser("guide", help="print the one concrete next step for the active task") + pgd.add_argument("slug", nargs="?", default=None, help="task slug (default: active task)") + pgd.add_argument("--json", action="store_true", help="machine-readable JSON output") + pgd.set_defaults(func=cmd_guide) + + prp = sub.add_parser("report", + help="capture/render a milestone's what-happened report (read-only)") + prp.add_argument("milestone", nargs="?", default=None, + help="milestone slug for the rollup, OR a task slug to drill into " + "(smart: tried as a milestone first, then as a task); " + "default: active milestone") + prp.add_argument("task", nargs="?", default=None, + help="explicit `report <milestone> <task>`: render that task's " + "per-phase detail instead of the milestone rollup") + prp.add_argument("--json", action="store_true", + help="emit raw structured data (rollup -> report_data dict; " + "drill -> task_phases list of 7 phase dicts)") + prp.add_argument("--plain", action="store_true", + help="ASCII, no color, fixed width (pipe / CI / screen-reader safe)") + prp.add_argument("--decide", action="store_true", + help="decision-point digest: what needs the human's judgment NOW " + "(task -> decision digest; milestone -> DECIDE NEXT only; " + "bare -> the active task)") + prp.set_defaults(func=cmd_report) + + pdt = sub.add_parser("deltas", + help="read-only report: open lessons learned grouped by competency") + pdt.add_argument("--json", action="store_true", help="machine-readable JSON output") + pdt.set_defaults(func=cmd_deltas) + + pgr = sub.add_parser("graduation-report", + help="read-only: gather the MVP loop's evidence (deltas · waivers · RETROs · " + "residue · coverage gaps) for a graduation interview — gathers, never judges") + pgr.add_argument("--json", action="store_true", help="emit the frozen JSON facts interface") + pgr.add_argument("--plain", action="store_true", help="ASCII/pipe-safe text (output is plain by default)") + pgr.set_defaults(func=cmd_graduation_report) + + pau = sub.add_parser("audit", + help="read-only: verify recorded human decision points left well-formed records " + "(exit 1 on findings — the CI enforcement gate)") + pau.add_argument("--json", action="store_true", help="machine-readable JSON output") + pau.set_defaults(func=cmd_audit) + + ppj = sub.add_parser("project", help="print .add/PROJECT.md (the read-first foundation)") + ppj.set_defaults(func=cmd_project) + + return p + + +def main(argv: list[str] | None = None) -> int: + parser = build_parser() + args = parser.parse_args(argv) + args.func(args) + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/.add/tooling/templates/CONVENTIONS.md.tmpl b/.add/tooling/templates/CONVENTIONS.md.tmpl new file mode 100644 index 000000000..cc68a9b57 --- /dev/null +++ b/.add/tooling/templates/CONVENTIONS.md.tmpl @@ -0,0 +1,8 @@ +# CONVENTIONS (living documentation — set once, kept for the whole project) + +Language/framework: <e.g. Python 3.12 / FastAPI> +Folders: .add/tasks/<slug>/{TASK.md, tests/, src/} +Naming: <file case>, <type case>, verbs for functions +Lint/format: <tools>, enforced in CI +Errors: machine-readable error codes (string enums), never free text +Architecture: <layering and dependency rules> diff --git a/.add/tooling/templates/GLOSSARY.md.tmpl b/.add/tooling/templates/GLOSSARY.md.tmpl new file mode 100644 index 000000000..f5eca3b0d --- /dev/null +++ b/.add/tooling/templates/GLOSSARY.md.tmpl @@ -0,0 +1,26 @@ +# GLOSSARY (one name per concept — used everywhere: specs, contracts, code) + +<term>: <definition> + +# ADD method vocabulary (domain-standard names; bridges to legacy terms) +GOAL: the one durable outcome a project (and each milestone) runs toward — the loop's orientation anchor, declared as the lowercase `goal:` line in PROJECT.md / MILESTONE.md and surfaced by status/guide every session; distinct from a task's §1 Must (a single required behavior, not the whole-project outcome). +deep verify: the deepened Verify evidence (v20) required beyond passing tests — for a task that produced code, that every new symbol is referenced (wiring) and no new dead/unused code exists; for prose/non-code, a recorded no-skim semantic read; which path applies is resolver-judged and the engine never classifies (a rubric, not add.py). +onboarding: the install -> first-milestone path (formerly "on-ramp"). +primary flow: the solid forward path of the flow diagram — a phase starts only when its input exists (formerly "forward spine"). +cross-cutting concern: a concern running through every step rather than being one step — security, testing, observability, cost (formerly "spine / continuous concern"). +working state: everything an agent loads each session — skill router, active phase, PROJECT/MILESTONE/TASK, state.json (formerly "state surface"). +audit trail: the reference record read by people, never auto-loaded into agent context (formerly "story surface"). +method rationale: the why behind every rule — the AIDD book, loaded on demand, never duplicated (formerly "trust layer"). +failing-first suite: the test suite written before code, confirmed red for the right reason — a missing implementation (formerly "red safety net"). +non-functional review: the deliberate post-evidence check of what tests rarely catch — concurrency, security, architecture (formerly "blind-spot checks"). +change scope: the files a locked run may and may not touch (formerly "touch-boundary"; the <touch_boundary> XML prompt tag keeps its name). +automated quality gate: the evidence-based Verify resolver under autonomy auto — may auto-PASS on complete evidence; security always escalates (formerly "evidence auto-gate"). +autonomy level: the per-task Verify resolver setting — auto (default) or conservative; declared in the TASK.md header, human-reviewed at the freeze (formerly "autonomy dial"). +living documentation: the durable project artifacts — conventions, glossary, frozen contracts — that outlive any particular code (formerly "survivor layer"). +scope level: the granularity a decision lives at — intake level (request -> versioned scope), milestone level, setup/foundation level, task level (formerly "altitude"). +baseline approval: the one human gate that freezes the AI-drafted foundation, first scope, and first contract together — runs as `add.py lock` (formerly "the lock-down"). +lesson learned: a single learning a loop produces, tagged by the competency it improves — the `- [DDD · open]` grammar and deltas.md/`add.py deltas` machine names stay (formerly "competency delta"). +lowest-confidence flag: the AI's ranked declaration of the 1–2 points most likely to be wrong in what a human is asked to approve — each with why + cost-if-wrong; the ⚠ glyph keeps its name as the machine marker (formerly "least-sure flag"). +decision point: a stop for human judgment — the contract-freeze approval, an escalated verify gate, intake confirmation, milestone close; the machine names seam (--json owner enum, decide key) and seam-audit (CI job) keep their names (formerly "seam"). +retrospective consolidation: gathering confirmed lessons learned at milestone close and writing them append-only into the versioned foundation — human-confirmed, never self-approved; the machine names fold.md, the folded status, and add.py deltas keep their names (formerly "the fold / fold ritual"). +specification bundle: a task's spec, scenarios, contract, and failing tests drafted as one piece and approved by a person once at the contract freeze (formerly "the one-approval front"). diff --git a/.add/tooling/templates/MILESTONE.md.tmpl b/.add/tooling/templates/MILESTONE.md.tmpl new file mode 100644 index 000000000..032285f86 --- /dev/null +++ b/.add/tooling/templates/MILESTONE.md.tmpl @@ -0,0 +1,26 @@ +# MILESTONE: {{title}} + +goal: {{goal}} +rationale: <why this scope — the confirmed intake classification (bucket + reason)> +stage: {{stage}} · status: active · created: {{date}} + +> SDD living doc for this milestone. Keep it THIN: breadth, shared decisions, and +> exit criteria only — per-task detail lives in each `.add/tasks/<slug>/TASK.md`, +> written just-in-time. Update this doc whenever a task reveals a milestone gap. + +## Scope +In: <what this milestone delivers> +Out: <explicitly deferred — the anti-scope-creep list> + +## Shared decisions & glossary deltas (living — every task must honor these) +- <cross-cutting rule, named from GLOSSARY.md> + +## Shared / risky contracts (freeze these first) +- <contract name> -> owning task <slug> + +## Tasks (breadth-first decomposition; detail lives in each TASK.md) +- [ ] <slug> depends-on: none — <one line> +- [ ] <slug> depends-on: <slug> — <one line> + +## Exit criteria (observable; map each to the task that delivers it) +- [ ] User can <observable behavior> (← <slug>) diff --git a/.add/tooling/templates/MODEL_REGISTRY.md.tmpl b/.add/tooling/templates/MODEL_REGISTRY.md.tmpl new file mode 100644 index 000000000..0d42b79b2 --- /dev/null +++ b/.add/tooling/templates/MODEL_REGISTRY.md.tmpl @@ -0,0 +1,6 @@ +# MODEL_REGISTRY (which AI wrote this project — for reproducibility & audit) + +Model: <name> +Version: <version/date> +Adopted: {{date}} +Notes: re-run the playbook golden-cases before changing this. diff --git a/.add/tooling/templates/PROJECT.md.tmpl b/.add/tooling/templates/PROJECT.md.tmpl new file mode 100644 index 000000000..a3e592bb1 --- /dev/null +++ b/.add/tooling/templates/PROJECT.md.tmpl @@ -0,0 +1,43 @@ +# PROJECT — living documentation (cross-milestone context) + +> The durable foundation that outlives every milestone and feeds context into each +> TDD⇄ADD loop. Read this FIRST in any session. Keep it lean — one screen, not a +> manual. Map to the AIDD diagram: Domain = DDD · Spec = SDD (living document) · +> UI/UX = UDD. When a loop reveals a gap here, come back and update this file — +> that is the re-entrant arrow from the engine down to the foundation. + +slug: {{project}} · stage: {{stage}} · updated: {{date}} +goal: <the one durable outcome this whole project runs toward — set this at setup; status/guide surface it every session> + +--- + +## Domain (DDD) — the language and the boundaries +<!-- One name per concept (the GLOSSARY holds the full term list). What are the + core entities, the bounded contexts/modules, and the invariants that MUST + always hold? This is the ubiquitous language the spec and code share. --> +- Core concepts: +- Bounded contexts / modules: +- Invariants that must always hold: + +## Spec / Living Document (SDD) — what we are building, now +<!-- The spec is a living document, not a frozen plan. This section POINTS to the + active milestone + frozen contracts; it does not duplicate them. --> +- Active milestone → `.add/milestones/<slug>/MILESTONE.md` (see `add.py status`) +- Frozen contracts (living docs): the contracts other work builds against. +- Settled vs still open: <frozen contracts · open questions> + +## Users (UDD) — UI/UX: design before code +<!-- UI/UX-Driven Development: users use the interface, not the spec. Capture the + experience BEFORE code. Per-feature design detail lives in a DESIGN.md / + clickable prototype; keep here the cross-cutting UX stance + the source of truth. + For a no-UI project (CLI / library / service), say so and keep this short — + the "interface" is the command surface, API shape, or output it produces. --> +- Primary users & the jobs they hire the product for: +- Core user flows (happy + key alternative paths): +- UI states every screen handles: loading · empty · error · success +- Design source of truth → DESIGN.md / design system / clickable prototype + +## Key Decisions (append-only) +| date | decision | why | outcome | +|------|----------|-----|---------| +| {{date}} | (first decision) | | | diff --git a/.add/tooling/templates/TASK.md.tmpl b/.add/tooling/templates/TASK.md.tmpl new file mode 100644 index 000000000..6bcfb2a32 --- /dev/null +++ b/.add/tooling/templates/TASK.md.tmpl @@ -0,0 +1,139 @@ +# TASK: {{title}} + +slug: {{slug}} · created: {{date}} · stage: {{stage}} +phase: specify <!-- specify -> scenarios -> contract -> tests -> build -> verify -> observe -> done --> +<!-- high-risk/method-defining scope? declare `risk: high` on the slug line above and lower + the autonomy level with `autonomy: conservative` — the engine refuses an unguarded completion + (`unguarded_high_risk_auto`, run.md guard). A comment is never a declaration. --> + +> One file = one task. Fill sections top-to-bottom; the `add` skill drives each phase. +> When a phase is unclear, read its book chapter in `.add/docs/` (linked per section). +> The phase marker above is the single source of truth — keep it in sync via `add.py phase`. + +--- + +## 1 · SPECIFY — the rules ▸ docs/03-step-1-specify.md + +Feature: <name> +Framings weighed: <chosen> (chosen) · <alternative> · <alternative> +Must: +<must> + - <required behavior> +</must> +Reject: +<reject> + - <bad input / situation> -> "<error_code>" +</reject> +After: +<after> + - <state that is true once it succeeds> +</after> +Assumptions — lowest-confidence first: +<assumptions> + ⚠ <the one assumption most likely to be wrong> — lowest confidence because <why>; if wrong: <cost> + - [ ] <next assumption, ranked> — confirm or deny; never carry an open one forward +</assumptions> + +<!-- EXIT: every rule stated, every rejection named; assumptions ranked lowest-confidence first, the top one or two ⚠-flagged with why + cost (or, for trivial scope, an honest "none material" that still names the single biggest risk). --> + +--- + +## 2 · SCENARIOS — pass/fail cases ▸ docs/04-step-2-scenarios.md + +<scenarios> + +```gherkin +Scenario: <short name> + Given <starting situation> + When <action> + Then <expected result> + And <what must remain unchanged> # required for every rejection +``` + +</scenarios> + +<!-- EXIT: one scenario per Must AND per Reject; each result is observable. --> + +--- + +## 3 · CONTRACT — freeze the shape ▸ docs/05-step-3-contract.md + +``` +<METHOD> <path> body: { <fields> } + 200 -> { <success fields> } + 4xx -> { error: "<code>" | "<code>" } +Schema: <tables/fields touched, and access pattern> +``` + +Status: DRAFT +<!-- The freeze IS the one approval — lead it with the bundle's lowest-confidence flag: the 1–2 + points most likely wrong across the whole bundle, tagged [spec|scenario|contract|test], each + with why + cost (the §1 ⚠ assumptions feed it; a flag may point at a scenario or the contract + too — see run.md). Approved -> Status: FROZEN @ vN — approved by <name>. Changing a frozen + contract = change request back to SPECIFY. + EXIT: frozen + every spec rejection has a contracted response + names match GLOSSARY + the + bundle's lowest-confidence flag was surfaced at the freeze (or an honest "none material"). --> + +--- + +## 4 · TESTS — failing-first suite (red) ▸ docs/06-step-4-tests.md + +Coverage target: <e.g. 90%> +Plan (one test per scenario, asserting behavior not internals): +<test_plan> + - test_<scenario>: arrange <Given> / act <When> / assert <Then> + assert <unchanged> +</test_plan> + +Tests live in: `./tests/` · MUST run red (missing implementation) before Build. +<!-- declare paths as backticked tokens on this line: `./…` = this task dir · + a token with "/" = project root · a bare name = sibling of the previous + token's dir · a directory counts its *.py files (non-recursive); reports + mark declared counts with † · anything resolving outside the project root counts 0 --> + +<!-- EXIT: one test per scenario; suite red for the RIGHT reason; target recorded. --> + +--- + +## 5 · BUILD — AI writes code ▸ docs/07-step-5-build.md + +Safety rule (feature-specific): <e.g. debit+credit in one atomic transaction> +Code lives in: `./src/` +Constraints: do NOT change any test or the contract; allow-list packages only; ask if unclear. + +<!-- EXIT: all green; coverage held; no test/contract touched; no unlisted dependency. --> + +--- + +## 6 · VERIFY — evidence + non-functional review ▸ docs/08-step-6-verify.md + +- [ ] all tests pass +- [ ] coverage did not decrease +- [ ] no test or contract was altered during build +- [ ] concurrency / timing of the risky operation is safe +- [ ] no exposed secrets, injection openings, or unexpected dependencies +- [ ] layering & dependencies follow CONVENTIONS.md +- [ ] a person reviewed and approved the change + +### Deep checks — do not skim (fill the path that applies; the resolver judges which) +- [ ] WIRING (code) — every new symbol is referenced; record where / how confirmed +- [ ] DEAD-CODE (code) — no new unused or orphaned symbol introduced +- [ ] SEMANTIC (prose / non-code) — read in full, not skimmed: <what read · what confirmed> + +### GATE RECORD +Outcome: <PASS | RISK-ACCEPTED | HARD-STOP> +If RISK-ACCEPTED -> owner: <name> · ticket: <link> · expires: <date> (never for a security gap) +Reviewed by: <name> · date: <date> + +<!-- A security finding is ALWAYS HARD-STOP. Record exactly one outcome — no silent pass. --> + +--- + +## 7 · OBSERVE — feed the next loop ▸ docs/09-the-loop.md + +Watch (reuse scenarios as monitors): <error rate / per-rejection rate / latency> +Spec delta for the next loop: <what production taught you> + +### Competency deltas +What did this loop teach the foundation? One line each, tagged by competency +(`DDD · SDD · UDD · TDD · ADD`), status `open`, with evidence. See the `add` skill's `deltas.md`. +<!-- e.g. - [DDD · open] the model missed multi-tenancy (evidence: scenario_x failed) --> diff --git a/.add/tooling/templates/dependencies.allowlist.tmpl b/.add/tooling/templates/dependencies.allowlist.tmpl new file mode 100644 index 000000000..d19ce45e9 --- /dev/null +++ b/.add/tooling/templates/dependencies.allowlist.tmpl @@ -0,0 +1,2 @@ +# dependencies.allowlist — one package per line; CI rejects anything not listed. +# Defeats the AI "invented a plausible package name" supply-chain risk. diff --git a/.claude/skills/add/SKILL.md b/.claude/skills/add/SKILL.md new file mode 100644 index 000000000..53a12aa56 --- /dev/null +++ b/.claude/skills/add/SKILL.md @@ -0,0 +1,147 @@ +--- +name: add +description: >- + ADD (AI-Driven Development) — a minimal, state-tracked workflow for building + software where the AI writes the code and the human owns direction and + verification. Drives every feature through one lean TASK.md: Specify → + Scenarios → Contract → Tests → Build → Verify → Observe, with red/green TDD + built in. Use this skill whenever working in a repo that has a `.add/` + directory, when the user says "add", "start a task", "next phase", "specify + this feature", "ADD method", or "AI-driven development", or when scaffolding a + new feature and you want spec/tests-first discipline instead of vague-prompt + coding. Also use it to resume work across sessions (it reads `.add/state.json` + so you never re-read the whole repo). +--- + +# ADD — the orchestration engine + +You are the orchestrator. ADD keeps the AI fast *and* safe by fixing direction +(spec, scenarios, contract, failing tests) **before** the build, and trusting +the result through passing evidence rather than a plausible-looking diff. + +**One file = one task.** Each feature lives in a single `.add/tasks/<slug>/TASK.md` +with seven sections. You fill them top to bottom; the Python tool tracks where +you are so context never rots across sessions. + +## Always start here (orient — do not skip) + +Run the tool to find the resume point instead of re-reading the repo: + +```bash +python3 .add/tooling/add.py status +``` + +- **No `.add/state.json` yet** (a fresh install drops tooling + docs but does *not* init — so `status` says + `no .add/ project found`) → enter **autonomous setup**: YOU run init yourself — + `add.py init --name "<inferred>" --stage <picked> --await-lock` (don't tell the human to) — then read + `phases/0-setup.md` and draft the foundation + first scope + first contract through to the human baseline approval. +- **A task is active** → open `.add/tasks/<active>/TASK.md`, look at its `phase:` + marker, and read the matching `phases/<n>-<phase>.md`. Work *only* that phase. +- **No active task** → first SIZE the request (see Intake below), then create the + right scope: `python3 .add/tooling/add.py new-task <slug> --title "..."`. + +## Intake — size a request before creating scope + +When the user brings a raw request, classify it BEFORE making a milestone or task: +read `intake.md` and place it in exactly one bucket — `new-major` · `sub-milestone` +· `task` · `change-request` — then propose `{ bucket, rationale, command }` and let +the human confirm. This is the intake level (request → versioned scope); see +`intake.md` for the rubric, the tie-break order, and worked examples. A question or +unsharp intent? **Interview before you size** — explore and suggest first (`intake.md`). + +Once a request is classified `new-major`/`sub-milestone`, drafting the actual +`MILESTONE.md` (goal · scope · exit criteria · breadth-first tasks) is the second +half of intake: read `scope.md` for how to fill it well, the per-outcome behavior, +and the confirm-before-create rule. You propose the draft; the human confirms. + +## The flow and which file to load + +Load the phase guide **only for the phase you are in** (progressive disclosure): + +| Phase | Guide | Produces (TASK.md section) | Who leads | +|-------|-------|----------------------------|-----------| +| setup | `phases/0-setup.md` | `.add/` + living docs + first §1–§3 + `SETUP-REVIEW.md` | AI drafts → **human locks** (the baseline approval) | +| specify | `phases/1-specify.md` | §1 rules + ranked lowest-confidence flag | AI drafts (co-specify)† | +| scenarios | `phases/2-scenarios.md` | §2 Given/When/Then | AI drafts† | +| contract | `phases/3-contract.md` | §3 frozen shape | AI drafts → **human approves once** (the decision point)† | +| tests | `phases/4-tests.md` | §4 + red suite in `tests/` | AI drafts† | +| build | `phases/5-build.md` | code in `src/`, tests green | **AI** | +| verify | `phases/6-verify.md` | §6 checks + gate record | **AI auto-gates on evidence**; human on residue/security‡ | +| observe | `phases/7-observe.md` | §7 spec delta | human + AI | + +† **The specification bundle (v7).** §1–§4 are one bundle; the human gives **one approval at the +contract freeze** (the decision point), presented lowest-confidence-first. See `run.md`. +‡ **Verify auto-gate (v6–v7).** Under `autonomy: auto` (the default) a run may auto-PASS on +complete evidence — recorded as *auto-resolved*, an explicit PASS, not a skip. **Security always +escalates** (HARD-STOP); so do concurrency / architecture residue and `conservative` autonomy. +See `run.md`. + +Whenever you present a decision point to the human in chat (intake · bundle approval · gate · +milestone close), follow `report-template.md` — open with the ARC (goal · done · plan, +engine-sourced), then SUMMARY → DECISION → ⚠ FLAGS → EVIDENCE → NEXT, show-before-ask, never +pre-stamp a decision point — and the question is a summary, never the artifact. + +In **observe**, also emit **lessons learned** — learnings tagged by which of the five +(`DDD · SDD · UDD · TDD · ADD`) they improve — so the foundation self-improves across loops. +You write them as `open`; the human consolidates them into `PROJECT.md`. Read `deltas.md` for the +grammar and the status lifecycle. At milestone close (or on demand), run the retrospective consolidation that +gathers confirmed deltas into a versioned foundation — read `fold.md`. + +## Beyond the bundle — load on demand + +Once **§3 CONTRACT is FROZEN**, the build→verify half is a dynamic, auto-gated run +(`autonomy: auto` default, lowered to `conservative` for a human gate) — read `run.md`. To +pipeline several ready tasks behind their own frozen contracts, read `streams.md`. + +When a milestone's tasks are all done but its **goal** (the `MILESTONE.md` exit criteria) is not +yet met, `milestone-done` holds the milestone open — read `loop.md` for the dynamic loop that turns +open deltas + extras into the next tasks, proposed by you and confirmed by the human, until the goal is met. + +When `add.py status` prints **`MVP covered → propose graduation`** (every milestone done AND the +stage-goal-criteria all `[x]`), the project is ready to graduate its stage — read `graduate.md` for the +orchestration: gather `graduation-report` analytics → co-specify interview → draft ≥1 production +milestone → human confirm → then (and only then) `stage production`. The flip is guarded +(`stage_no_roadmap`) and is the FINAL step — never a bare label change. + +## Non-negotiable rules (from the method) + +<constraints> +1. **Direction before speed.** Never start Build until §1–§4 exist and tests are red. +2. **Trust evidence, not inspection.** A feature is trusted because its tests pass + and the non-functional risks (concurrency, security, architecture) were checked — not + because the code reads plausibly. +3. **Never weaken a test or edit a frozen contract to make the build pass.** That + inverts the method. A real change is a *change request* back to Specify. +4. **No silent skips.** Every Verify ends in exactly one recorded outcome: + `PASS`, `RISK-ACCEPTED` (signed, non-security only), or `HARD-STOP`. A security + finding is always `HARD-STOP`. +5. **Ask, don't guess.** If a requirement is unclear, stop and ask the user. +</constraints> + +## Advancing + +After a phase's exit gate is met, advance the state (this also syncs the marker +inside TASK.md): + +```bash +python3 .add/tooling/add.py advance # next phase of the active task +python3 .add/tooling/add.py gate PASS # at verify: records PASS, marks done +python3 .add/tooling/add.py use <slug> # switch the active task (e.g. across parallel streams) +``` + +## Depth by stage + +The steps never change; their depth does. Read the stage from `add.py status`: + +- **prototype** — run light; code is throwaway; design/experience is the point. +- **poc** — run contract/tests/build deeply on the single riskiest slice only. +- **mvp** — full flow, narrow scope, light observation. +- **production** — every step at full rigor + the observe loop. Reach it via the graduation + orchestration (`graduate.md`) when status shows `MVP covered → propose graduation`, never a bare + `stage production` flip — the transition is guarded behind a human-confirmed roadmap. + +## The method rationale + +The full method (the *why* behind every rule) is the AIDD book in `.add/docs/`. +When a phase decision is genuinely unclear, read the linked chapter — each phase +guide points to its chapter. Do not duplicate the book here; load it on demand. diff --git a/.claude/skills/add/adopt.md b/.claude/skills/add/adopt.md new file mode 100644 index 000000000..5335d3ff8 --- /dev/null +++ b/.claude/skills/add/adopt.md @@ -0,0 +1,67 @@ +# Adopt — map an existing repo into the foundation (silent) + +When ADD is pointed at a repo that already has code, onboarding is **silent**: the code +answers the questions a greenfield interview would ask, so you read it rather than ask. +This is the **brownfield path** of setup (the greenfield path keeps the 4-lens interview — +see `phases/0-setup.md`). You fill the living-documentation files from evidence, then stop at the one +human gate: the **baseline approval** (`add.py lock`). + +## The signal — and arming the gate + +Enter a brownfield repo with `--await-lock`: + +```bash +python3 .add/tooling/add.py init --await-lock +``` + +`--await-lock` does two things. It seeds an **unlocked** setup, which *arms the baseline-approval gate* +— the engine then refuses a second task, crossing into build, and recording a gate until you +`lock`. And init, being brownfield-aware, prints a line that begins: + +``` +brownfield: existing code detected — the `add` skill maps it into your foundation … +``` + +That line is your cue to run this guide. **Always use `--await-lock` for brownfield onboarding**: +a plain `init` writes no setup and is grandfathered-locked, so its gate never arms *and* the +closing `lock` below would refuse with `already_locked`. The engine only *detects* the existing +code (a mechanical fact); it never reads or fills it — interpreting it is your job. + +## The silent mapping + +Fill each living-doc file in `.add/` from what the code actually shows — **ask nothing**: + +| Living doc | Read it from | +|----------|--------------| +| `PROJECT.md` (foundation) | the domain nouns, entry points, the README, the first milestone the code implies | +| `CONVENTIONS.md` | the languages, folder layout, naming, lint config, error style already in the tree | +| `GLOSSARY.md` | the recurring names in modules, models, and public APIs (one name per concept) | +| `MODEL_REGISTRY.md` | leave the active model record; note any AI-authored code you can detect | +| `dependencies.allowlist` | the manifests already in the repo (package.json, pyproject, go.mod, …) | + +Two rules that never bend: + +<constraints> +1. **Never clobber a living doc.** `init` already skips any living-doc file that exists; if a human + already wrote `PROJECT.md`, you READ it, you do not overwrite it. Add, never replace. +2. **Tag every drafted decision `evidence-grounded` vs `guessed`.** A line you read from the + code is *evidence-grounded* (cite the file). A line you inferred because the code was silent + is *guessed*. The human's single baseline approval is only honest if they can see which is which — + the guesses are what they actually need to check. (The tags feed `SETUP-REVIEW.md`.) +</constraints> + +## Where it ends — the baseline approval + +Brownfield onboarding draws no per-step approvals. You map the foundation, then draft the +first milestone's scope and the first task's candidate specification bundle exactly as greenfield does, and +present it all at **one** human gate. The human reviews the decisions (lowest-confidence / `guessed` +first) and confirms in conversation; you run the lock with their name: + +```bash +python3 .add/tooling/add.py lock --by "<name>" +``` + +`lock` freezes the foundation + scope + first contract in one atomic write and opens the build. +Until it is run, the engine refuses a second task, crossing into build, and recording a gate — +so nothing is built on an unreviewed map. That gate is the only thing brownfield onboarding asks +of a human; everything before it, you did from the code. diff --git a/.claude/skills/add/deltas.md b/.claude/skills/add/deltas.md new file mode 100644 index 000000000..d8b975fce --- /dev/null +++ b/.claude/skills/add/deltas.md @@ -0,0 +1,81 @@ +# Lessons learned — how each loop sharpens the foundation + +A **lesson learned** is a single learning a task produces, tagged by which of ADD's five +competencies it improves. You write deltas in a task's **OBSERVE** phase; later, the +`foundation-update-loop` gathers the confirmed ones and consolidates them into a versioned `PROJECT.md`. +This is how `DDD · SDD · UDD · TDD · ADD` stop being write-once and start converging. + +You (the AI) **emit** deltas as `open`. Only the **human** moves a delta to `folded` or `rejected` +(consolidating into the foundation is judgment — see the verify/observe decision point). You never self-approve a consolidation. + +## The grammar (frozen) + +Each delta begins on its own **tag line**; the learning may wrap onto continuation lines: + +``` +- [<COMPETENCY> · <status>] <learning> (evidence: <pointer>) +``` + +- `<COMPETENCY>` — exactly one of the five (below). +- `<status>` — `open` | `folded` | `rejected`. A **newly emitted delta is `open`**. +- `<learning>` — the insight ("the domain model missed multi-tenancy"). It may run past one line; + the `- [COMPETENCY · status]` tag line must come **first**, and the `(evidence: …)` clause must + **close** the delta (on its last line). +- `(evidence: …)` — **required**, non-empty: a failing scenario, a production signal, a review + note. No evidence → it is an opinion, not a delta. + +A long learning may wrap — the lint (`add.py check`) joins continuation lines, so this is **one** +delta, not two: + +``` +- [SDD · open] the export endpoint must reject a tenant-scoped token used cross-tenant, + returning `forbidden` (not `not_found`) (evidence: scenario_cross_tenant_export failed) +``` + +## The five competencies (pick exactly one per delta) + +| tag | competency | a delta here means you learned something about… | +|-----|------------|--------------------------------------------------| +| `DDD` | Domain | the domain model — an entity, rule, or boundary the spec assumed wrong | +| `SDD` | Spec | what the feature must do / must reject — a missing or wrong requirement | +| `UDD` | UI/UX | the user-facing shape — a flow, affordance, or wording that misled | +| `TDD` | Test | how we prove correctness — a missing scenario, a flaky or hollow test | +| `ADD` | AI/build | how the AI builds — a harness, prompt, or convention that helped or hurt | + +If a learning seems to touch two, ask "which competency, once updated, would have PREVENTED this?" +That is its home. Split genuinely separate learnings into separate deltas; never tag one twice. + +## Status lifecycle + +``` +emit (OBSERVE) human review (foundation-update-loop) + open ───────────▶ folded (the learning is merged into PROJECT.md; version bumps) + └──────────▶ rejected (considered and deliberately NOT consolidated — the trail is kept) +``` + +An `open` delta is a pending signal. `folded` and `rejected` are both human decisions; a `rejected` +delta is left in place (not deleted) so "we saw this and chose not to act" stays auditable. + +## Reject codes (well-formedness — you are the first check, the human is the backstop) + +There is no engine validator yet, so before you record a delta, self-check it: + +<reject_codes> +- `unknown_competency` — the tag is missing or not one of `DDD · SDD · UDD · TDD · ADD`. Fix the tag. +- `no_evidence` — the `(evidence: …)` pointer is missing or empty. Add the proof, or drop the line. +- `unknown_status` — the status is not `open | folded | rejected`. A fresh delta is `open`. +</reject_codes> + +## Worked example + +A task that built a tenancy feature finished its OBSERVE phase with: + +``` +- [DDD · open] the account model conflated org and workspace (evidence: scenario_cross_tenant_read failed) +- [TDD · open] no scenario covered a deleted tenant's dangling sessions (evidence: review note, PR thread) +- [ADD · open] the scaffold's allow-list missed the tenancy lib, slowing build (evidence: build log retry) +``` + +Three learnings, three competencies, each with a pointer. At the next foundation update the human +consolidated the DDD and TDD deltas into `PROJECT.md` (→ `folded`) and rejected the ADD one as a one-off +(→ `rejected`). The foundation got sharper; nothing was silently lost. diff --git a/.claude/skills/add/fold.md b/.claude/skills/add/fold.md new file mode 100644 index 000000000..12433a337 --- /dev/null +++ b/.claude/skills/add/fold.md @@ -0,0 +1,68 @@ +# Consolidating deltas — how the foundation self-improves + +This **closes the loop**. `deltas.md` lets a task EMIT learnings (`open` lessons learned in its +OBSERVE phase); the retrospective consolidation gathers the confirmed ones and writes them into a **versioned foundation**, +so `DDD · SDD · UDD · TDD · ADD` sharpen across milestones instead of drifting. + +You (the AI) **gather and propose**; the **human confirms**; you then write the **append-only** consolidation. +You never self-approve a consolidation — consolidating is judgment (see the verify/observe decision point). + +## When to consolidate + +At **milestone close** (the natural "version bump to the foundation"), or **on demand** when open +deltas have piled up. This is a convention, not a command — there is no `add.py fold`; the consolidation +lives here so the engine stays judgment-free. + +## The ritual + +1. **Gather** — scan every task's §7 OBSERVE block for lesson-learned lines still `open` (`add.py deltas` reads them by the machine heading). +2. **Group** — bucket them by competency (`DDD · SDD · UDD · TDD · ADD`). +3. **Propose** — for each, draft the exact foundation edit (see routing) and show the human. +4. **Confirm** — the human accepts or declines each delta. No write happens without this. +5. **Write** — append the accepted edits, flip each delta's status, and bump the version. + +## Consolidation routing (every competency has a home) + +| competency | consolidates into | how | +|------------|-----------|-----| +| `DDD` | `PROJECT.md` §Domain (DDD) | refine/append a model bullet | +| `SDD` | `PROJECT.md` §Spec / Living Document (SDD) | refine/append a settled-vs-open line | +| `UDD` | `PROJECT.md` §Users (UDD) | refine/append a UX line | +| `TDD` | `CONVENTIONS.md` | append a testing convention (no PROJECT.md section — it is the engine) | +| `ADD` | `CONVENTIONS.md` | append a build/harness convention (likewise the engine) | + +**Every** consolidation — whatever the competency — ALSO appends one row to `PROJECT.md` **§Key Decisions** +(date · decision · why · outcome): the universal, auditable trail of what the foundation learned. + +## Status transitions & version + +- on **confirm**: the delta moves `open` → `folded` (and its edit is appended to the routed target). +- on **decline**: the delta moves `open` → `rejected` and is **left in place** — never deleted — + so "we considered this and chose not to act" stays auditable. +- a consolidation is **append-only**: it adds bullets/rows; it never silently rewrites existing foundation text. +- each consolidation session **bumps** the `foundation-version:` marker in `PROJECT.md` by one (monotonic int). + +## Reject codes (the AI is first check, the human the backstop) + +<reject_codes> +- `no_open_deltas` — nothing is `open` anywhere. The ritual is a no-op; do **not** bump the version. +- `unconfirmed_fold` — a write was attempted without recorded human confirmation. The AI proposes; + it never self-approves one. Stop and get confirmation. +- `unroutable_delta` — a delta's competency is not one of the five, so it has no consolidation target. Fix the + delta (it is malformed per `deltas.md`) before consolidating. +</reject_codes> + +## Worked example (from this repo's own history) + +The `competency-deltas` task closed its OBSERVE with two deltas — the homeless ones, `TDD`/`ADD`, +which have no PROJECT.md section: + +``` +- [ADD · open] dogfood .add/tooling template can silently diverge from canonical (evidence: md5 mismatch this build) +- [TDD · open] structural tests guard canonical artifacts but not their dogfood twins (evidence: scope-loop note + this build) +``` + +At the next consolidation the human confirms both. Routing sends each to `CONVENTIONS.md` (a "sync the dogfood +tree + assert md5 parity" convention), appends a §Key Decisions row for each, flips them to `folded`, +and bumps `foundation-version` 1 → 2. The two competencies the foundation never tracked before now +have a home — which is exactly why v5 routes TDD/ADD to `CONVENTIONS.md`. diff --git a/.claude/skills/add/graduate.md b/.claude/skills/add/graduate.md new file mode 100644 index 000000000..bf8043936 --- /dev/null +++ b/.claude/skills/add/graduate.md @@ -0,0 +1,74 @@ +# Stage graduation — propose the move to production as a roadmap, never a flip + +A project does not become "production" because someone typed a new label. It graduates when +the MVP is genuinely covered AND a human-confirmed roadmap of production work exists. This guide +is the **4th scope level** — after setup (`phases/0-setup.md`), intake (`intake.md` / `scope.md`), +and the milestone loop (`loop.md`). It turns the bare `add.py stage` flip into the **final step** of +an analytics-driven, interview-led orchestration. + +You (the AI) **gather and propose**; the **human confirms and judges**; the engine only counts +tallies and enforces the floor. The engine never decides that the project is "ready" — that is +judgment, and it belongs to the interview. + +## The cue (what starts this) + +When every milestone is `done` AND the human's stage-goal-criteria in `PROJECT.md` are all `[x]`, +`add.py status` prints: + +``` + → MVP covered → propose graduation +``` + +That line is the trigger. Before both tallies complete, status is silent and nothing here applies +(a project with no stage-goal-criteria block behaves exactly as today — grandfathered, zero change). + +## The flow + +1. **Gather the analytics** — run `add.py graduation-report` (add `--json` to branch on it). It + clusters the whole MVP loop's evidence into five labeled record-sets: open deltas by competency · + open RISK-ACCEPTED waivers by expiry · RETRO records · verify residue · observe-loop coverage gaps. + It **gathers, never judges** — there is no readiness verdict to read; the records are what you + reason from. +2. **Co-specify interview** — synthesize *"what production means HERE"* WITH the human, using the + gathered records as the agenda (the residue to harden, the coverage gaps to monitor, the open + deltas to consolidate). This synthesis is the judgment the engine refuses to make. Interview to real confidence — + do not guess what "production-ready" means for this project. +3. **Draft the roadmap** — for each production outcome the interview surfaces, draft a production + milestone with the EXISTING command and goal-gate criteria: + `add.py new-milestone <slug> --stage production --goal "…"`, then write its exit criteria. The + roadmap is **≥1** milestone — the hardening work itself (SLOs, rollback tests, incident runbooks) + is what these milestones *contain*; this guide proposes them, it does not do them. +4. **Human confirms** — present the roadmap via `report-template.md`, opening with the ARC + (goal · done · plan): the stage-graduation goal, the MVP coverage that earns the move, and the + plan the production milestones lay out. The human accepts, edits, or declines each drafted + milestone. No milestone is created without this; nothing advances on a draft the human has not confirmed. +5. **Flip — the final step** — only now run `add.py stage production`. Because ≥1 production milestone + now exists, the guard passes and the transition is recorded. This is the orchestration's last act. + +## The floor (what the engine enforces) + +`add.py stage production` is **guarded**: it refuses with `stage_no_roadmap` (non-zero exit, state +byte-unchanged) when zero milestones have `stage: production`. The check is a **tally** — "does a +production-roadmap record exist?" — never a readiness judgment (gather-not-judge at stage level; +it mirrors the milestone goal-gate's `milestone_goal_unmet`). `--force` overrides it, preserving human +authority for grandfathered/edge cases; use it deliberately, not as the normal path. + +Scope: the guard is on the `→production` **transition** only. Flips to prototype/poc/mvp are the +existing bare flip, unchanged. `add.py init --stage production` is an explicit at-creation declaration +(the same authority as `--force`), not a transition — it is out of scope of the guard by design. + +## Invariants (never break these) + +- **The flip is the final step**, never called outside this confirmed-roadmap path. A bare flip with + no roadmap is the symptom this scope level removes. +- **The engine never auto-flips.** Every step here is human-confirmed; the engine gathers, counts, and + enforces the floor — it does not advance the stage on its own. +- **The flow is continuous, not cue-reentrant.** The moment you draft the first production milestone, + `status` stops printing the cue (the "every milestone done" tally breaks). That is expected — do NOT + re-await the cue after drafting; carry the flow straight through to confirm and flip. + +## Depth and reuse + +The same orchestration serves prototype→poc and poc→mvp; **mvp→production** is the rigorous proof +case (every step at full depth + the observe loop). At lower stages, run it light — the shape is the +same, the depth is less. diff --git a/.claude/skills/add/intake.md b/.claude/skills/add/intake.md new file mode 100644 index 000000000..992f2199d --- /dev/null +++ b/.claude/skills/add/intake.md @@ -0,0 +1,64 @@ +# Intake — size a request into versioned scope + +Before a task exists, ADD turns a raw request into correctly-sized, versioned scope. +This is the **intake level**: the per-task flow is phases 0–7; intake is the step +*before* a task — request → milestone or task. You (the AI) **propose**; the human +**confirms**. Never create scope without a confirmed proposal. + +## Interview before you size + +When the request arrives as a question, or its intent is not yet sharp enough to +place in one bucket: explore it WITH the user before classifying. Reflect the +intent you heard, name what seems in and out of scope, and offer 2–3 sized options +with your own recommendation. Only then emit `{ bucket, rationale, command }`. +`ask_human` stays the floor: when interviewing cannot sharpen the request, +reject — never guess a bucket. + +## The four buckets + +Classify every request into exactly ONE bucket: + +| Bucket | Decision test | Implied command | +|--------|---------------|-----------------| +| `new-major` | a new product theme/pillar no active milestone's goal covers | `add.py new-milestone vN` | +| `sub-milestone` | a slice of an EXISTING major theme, too big for one task | `add.py new-milestone vN-M` | +| `task` | fits within the ACTIVE milestone's stated scope | `add.py new-task <slug>` | +| `change-request` | modifies ALREADY-FROZEN scope (a frozen contract or a shipped promise) | `add.py phase specify\|contract <affected>` | + +**Tie-break order: the frozen-scope test runs FIRST, before the size test.** +First ask "does this change already-frozen scope?" → if yes, it is a `change-request` +(never re-size frozen work as new scope). Only if no, apply the size test: a new theme +→ `new-major`; a slice of a live theme → `sub-milestone`; fits the active milestone +→ `task`. + +## What you emit (the proposal) + +Present the proposal to the human via `report-template.md` — open with the ARC (goal · done · +plan): the goal this request serves, what is already covered, and the plan the chosen bucket sets up. + +For every request, emit ONE of: + +- **a classification** — `{ bucket, rationale, command }` — where `rationale` names WHY + (the theme, the slice, the fit, or the frozen scope touched) and `command` is the exact + `add.py …` from the table. The human confirms or overrides before you run it. +- **a rejection** — `{ reject, rationale }` — and you create nothing, emitting one of the closed set: + +<reject_codes> +- `ask_human` — too ambiguous/underspecified to size. Ask the human; never guess a bucket. +- `frozen_scope` — it changes frozen scope; route it as a `change-request` back to + SPECIFY/CONTRACT of the affected task — never spawn a parallel milestone that forks the truth. +- `split_required` — it spans more than one bucket; propose the SMALLEST set of correctly-sized + items, each with its own rationale; never force it into one milestone. +</reject_codes> + +When confirmed, record the `rationale` in the artifact you create or affect — the new +MILESTONE.md goal/body, the new TASK.md, or a note in the affected TASK.md — never in state.json. + +## Worked examples (from this project's own history) + +| request | bucket | rationale | +|---------|--------|-----------| +| give ADD a hosted web dashboard | new-major | a new product theme no active milestone's goal covers → a fresh major line (v5) | +| add the build corridor + tests-red-before-build | sub-milestone | a slice of the live v4 "self-driving" theme, too big for one task → v4-2 | +| expose owner/stop as --json | task | fits the active v4-1 (intake interface) scope → one task | +| guide --json phase/gate should be nullable | change-request | changes the FROZEN machine-state-json contract → reopen its CONTRACT, do not make a new milestone | diff --git a/.claude/skills/add/loop.md b/.claude/skills/add/loop.md new file mode 100644 index 000000000..7a1a78b73 --- /dev/null +++ b/.claude/skills/add/loop.md @@ -0,0 +1,59 @@ +# The dynamic loop — open deltas and extras become the next tasks + +A milestone is not done when its tasks are done — it is done when its **GOAL** is met. +This guide is the loop that drives a milestone toward that goal: turn what each task +leaves behind (open lessons, and work discovered but out of scope) into the next tasks, +and keep going until the exit criteria are all met. + +You (the AI) **gather and propose**; the **human confirms**; the existing `add.py new-task` +creates each one. The engine never decides what the next task is — that is judgment. + +## The goal-gate (what holds the loop open) + +`add.py milestone-done <slug>` REFUSES to close a milestone while its exit criteria are not +all met — it stops with `milestone_goal_unmet` and the milestone stays active. The exit-criteria +checkboxes in `MILESTONE.md` ARE the human's goal-met affirmation: the engine reads the +`- [x]`/`- [ ]` tally, it never judges whether the goal is met (the same trust model as reading a +recorded `PASS`). Checking the last box is the deliberate act that releases the gate. + +The gate fires only when criteria exist. A milestone with no exit-criteria checkboxes closes as +before — write criteria into `MILESTONE.md` if you want the goal-gate to hold the milestone open. + +`milestone-done` is the only way a milestone reaches `done`; `archive-milestone` and `compact` +both refuse a milestone that is not done. So the one gate is enough — there is no quiet way around it. + +## The loop + +When every task is done but the goal is not, `add.py status` shows +`goal not met (m/n exit criteria)` where it would otherwise prompt to archive. That is the cue: + +1. **Gather** the carried inventory: + - open lessons — `add.py deltas` (the §7 OBSERVE deltas still `open`); + - the planned-but-unscaffolded tasks — the plan-vs-state line in `add.py status`; + - any reopened task — one a deepened verify returned to the flow (see below). +2. **Propose** the next tasks: for each carried item worth doing now, draft a one-line task + (slug + title + why) and show the human. Group the trivial ones; do not propose noise. +3. **Confirm** — the human accepts, edits, or declines each. No task is created without this. +4. **Create** each accepted task — `add.py new-task <slug> --title "..."` — and run it through + the normal flow (specify → … → verify). +5. **Repeat** until the work the goal needs is done. +6. **Close** — when the goal is genuinely met, check the exit-criteria boxes in `MILESTONE.md`, + then `add.py milestone-done <slug>` succeeds (then consolidate the open deltas and archive). + Present the close via `report-template.md` — open with the ARC (goal · done · plan): the + milestone goal, the exit-criteria met that prove it, and the plan beyond the close. + +## Reopen is the verb; this loop is the trigger + +When a deepened verify (the no-skim wiring / dead-code / semantic check) finds a criterion unmet +on a task already marked done, `add.py reopen <task> --to <phase> --reason "..."` returns it to the +flow with a recorded reason and a reset gate. `reopen` is the recorded action; deciding WHEN to +fire it — because a goal criterion is unmet — is this loop's job. + +## The reactivation residual (deferred) + +A reopen fired inside the loop happens while the milestone is still **active** — the goal-gate held +it open, so it never reached done, and no reactivation is needed. The one residual — reopening a +task inside a milestone that was already closed — is surfaced by `add.py check` (a done milestone +with a live task reads as incoherent). Re-activating a closed milestone is **deferred**: resolve it +by hand for now (the loop's own design keeps in-flight milestones open), until a later task makes +milestone reactivation first-class. diff --git a/.claude/skills/add/phases/0-setup.md b/.claude/skills/add/phases/0-setup.md new file mode 100644 index 000000000..b931b7f16 --- /dev/null +++ b/.claude/skills/add/phases/0-setup.md @@ -0,0 +1,103 @@ +# Phase 0 — Setup (autonomous draft → one human baseline approval) + +Goal: point ADD at a repo and **you** draft the whole foundation — domain, first-milestone scope, +and the first task's contract — then hand the human exactly one decision: the **baseline approval**. Brownfield +is silent (the code answers the questions); greenfield keeps a short interview. Either way, the human's +only gate is `add.py lock`. This is the setup-level analog of a task's one-approval contract freeze. + +## 1 · Zero-touch entry — you run init yourself + +When there is no `.add/state.json`, do **not** tell the human to initialise — run it yourself. Infer the +project name and stage from the repo, and **arm the baseline-approval gate** with `--await-lock`: + +```bash +python3 .add/tooling/add.py init --name "<inferred from repo/dir>" --stage <prototype|poc|mvp|production> --await-lock +``` + +- `--await-lock` is **required** here: it seeds an *unlocked* setup, which arms the gate so the engine + refuses a second task / crossing into build / a `gate` until you `lock`. A plain `init` is + grandfathered-locked — its gate never arms, and the closing `lock` would error `already_locked`. +- name + stage are **your judgment** (read them from the dir name, README, manifests); the engine stays + mechanical. Pick the stage from the ambition you hear: throwaway → `prototype`, one risky slice → `poc`, + narrow-but-real → `mvp`, full rigor → `production`. + +`init` prints one of two things — **that is your branch**: +- a line starting `brownfield:` → there is existing code (go to **2a**); +- the greenfield closing (no `brownfield:`) → an empty repo (go to **2b**). + +## 2a · Brownfield — map it silently + +The code answers the questions a greenfield interview would ask, so **read it instead of asking**. Open +`adopt.md` and follow it: fill each living-doc file from the code, never clobber an existing one, and tag +every decision `evidence-grounded` (cite the file) or `guessed`. Ask the human **nothing** at this step. + +## 2b · Greenfield — the 4-lens interview (kept): co-specify at foundation level + +An empty repo has no code to read, so run the short interview. This is the **co-specify at foundation +level** move — the same diverge → converge → validate brainstorm a task's §1 uses (`phases/1-specify.md`), +lifted to the foundation. Ask the one load-bearing question per lens (diverge), draft the foundation +(converge), then rank where your confidence is lowest and show the top flag first (validate): + +| Lens | The one question that unblocks the section | +|------|--------------------------------------------| +| Domain (DDD) | The 3–5 core nouns, and the one invariant that must NEVER break? | +| Spec (SDD) | The first milestone's outcome — and what's explicitly NOT in v1? | +| Users (UDD) | The primary user and the one job they hire this for? (or "no UI — surface is X") | +| Decisions | What's already decided that you'd regret re-litigating? (first Key Decision row) | + +Ask only the live ones; skip what the request already answers. Rank your drafts lowest-confidence-first using the +one notation every scope level shares — `⚠ <assumption> — lowest confidence because <why>; if wrong: <cost>` — and +tag thin or inferred answers `guessed`. + +## 3 · Draft to the lock (both paths) + +1. **Fill the living documentation** (it outlives all code): `.add/PROJECT.md` (the foundation — Domain · Spec/active + milestone · UI/UX · Key Decisions, one screen), `CONVENTIONS.md`, `GLOSSARY.md`, `MODEL_REGISTRY.md`, + `dependencies.allowlist`. Brownfield: from the code. Greenfield: from the interview, gaps flagged `guessed`. +2. **Size the first milestone** (read `scope.md`) and draft its `MILESTONE.md` — goal · scope · exit criteria + · breadth-first tasks. +3. **Create the first task and draft its candidate specification bundle.** `new-task` is allowed pre-lock: + ```bash + python3 .add/tooling/add.py new-task <slug> --title "<first feature>" + ``` + Draft §1 (specify) · §2 (scenarios) · §3 (contract). **Leave §3 `Status: DRAFT`** — the lock is its + approval (see §5). You MAY `advance` through specify → scenarios → contract → tests pre-lock, but the + engine **refuses crossing into build** until you `lock` (`setup_unlocked`). Sequence: bundle → lock → build. +4. **Write `.add/SETUP-REVIEW.md`** per `setup-review.md`: every decision you drafted (foundation, scope, + first contract), **lowest-confidence-first**, each tagged `guessed` | `evidence-grounded`. + +## 4 · The one human gate — the baseline approval + +Open the report with the ARC (goal · done · plan) per `report-template.md`, then present +`SETUP-REVIEW.md` lowest-confidence-first (the `guessed` rows are what the human must actually check). They +confirm **once** — an explicit yes to the baseline approval itself, in conversation; ambient agreement mid-stream is +not a confirmation. On that recorded confirmation, you run the lock with their name: + +```bash +python3 .add/tooling/add.py lock --by "<name>" +``` + +Typing the command themselves stays the **escape hatch** — the decision is always the human's; you just +execute it. `lock` records the lock layers (foundation · scope · contract) in one atomic write and opens the +build. It is judgment-free — it does **not** parse `SETUP-REVIEW.md`; the human *reading* it is the review. + +## 5 · After the lock + +- The lock **is** the first task's contract approval — the v7 specification-bundle approval and the baseline approval collapse + into this single signature. Do **not** ask for a separate contract-freeze sign-off (that double-gates). +- Stamp the first task's §3 `Status: FROZEN @ v1` (lock-authorized), then read `phases/5-build.md` — build is + now open. Everything before this signature, you drafted. + +## Exit gate + +<exit_gate> +- [ ] `.add/state.json` exists; setup was seeded unlocked (`--await-lock`) then locked. +- [ ] Living docs filled (brownfield: from code, tagged evidence-grounded; greenfield: from the interview). +- [ ] First task created; §1–§3 drafted; `.add/SETUP-REVIEW.md` written lowest-confidence-first. +- [ ] Human confirmed the baseline approval and `add.py lock --by` ran with their name; first task §3 `FROZEN @ v1`; build open. +</exit_gate> + +## Next + +After the lock, read `phases/5-build.md` (build is open). · Book: `docs/10-setup-and-stages.md` +*(note: book chapters 10 / 13 / 14 still describe the older human-led setup until `book-align` lands).* diff --git a/.claude/skills/add/phases/1-specify.md b/.claude/skills/add/phases/1-specify.md new file mode 100644 index 000000000..c1120c6f8 --- /dev/null +++ b/.claude/skills/add/phases/1-specify.md @@ -0,0 +1,65 @@ +# Phase 1 — Specify (the rules) + +Goal: state what the feature MUST do and what it must REJECT, with zero ambiguity +for the AI to resolve by guessing. Fill **§1 SPECIFY** in TASK.md. + +Specify is **co-specification**: brainstorm the shape WITH the user, draft it, then let +the user validate with your advice. If you cannot write the spec, you do not yet +understand the feature — that is information, not an obstacle. Stop and ask. + +## Co-specify in three moves + +1. **Diverge** — before drafting, surface the decision space: the 2–3 genuine framings of the + feature + the open questions you would otherwise guess. Invite the user to add, kill, + redirect. (Conversational — no new file. At prototype/poc this shortens to one sentence.) +2. **Converge** — draft §1, then RANK where your confidence is lowest (below). +3. **Validate** — present the ranked uncertainty first; the user confirms, corrects, or sends back. + +## Produce (in TASK.md §1) + +<output_format> +- **Framings weighed** — a one-line trace of what you considered: `X (chosen) · Y · Z`. +- **Must** — each required behavior. +- **Reject** — each refused input/situation, paired with a **named error code** + (`amount <= 0 -> "amount_invalid"`, never "handle bad input"). +- **After** — the state that is true once it succeeds. +- **Assumptions — lowest-confidence first** — ranked most-likely-wrong → least. The top 1–2 carry a + `⚠` flag: `⚠ <assumption> — lowest confidence because <why>; if wrong: <cost>`. The rest are the + low-stakes `[x]` tail. Keep the ranking visible — a flat list of equal `[x]` ticks gets approved without reading. +</output_format> + +## The lowest-confidence flag is bundle-wide + +The single human approval happens once, at the contract freeze, over the whole bundle. So your +§1 ranking is the first input into a bundle-level flag the user reads at the decision point (`run.md`): +*"of everything I'm asking you to freeze, these 1–2 are most likely wrong."* A flag may point at +a §1 assumption, an uncovered scenario, or the contract shape. + +## AI prompt + +<prompt> +Role: a domain analyst who brainstorms, then asks rather than assumes. +Read first: CONVENTIONS · GLOSSARY · the user's raw input. +Objective: fill §1 SPECIFY with zero ambiguity left for the AI to resolve by guessing. +Steps: + 1. Surface 2–3 framings + the open questions; let the user react before you draft. + 2. Produce §1 — Framings weighed, every Must, every Reject with a named error code, the + After state, and the Assumptions RANKED lowest-confidence first. + 3. Flag the 1–2 where your confidence is lowest, each with why + cost. +Never: resolve an ambiguity by guessing. +</prompt> + +## Exit gate + +<exit_gate> +- [ ] Framings weighed noted; every required behavior stated. +- [ ] Every rejection has a named error code; success state-change described. +- [ ] Assumptions ordered lowest-confidence first; the 1–2 `⚠` flags carry why + cost — or an honest + "none material" that still names the single biggest risk (never a blank "none"). +</exit_gate> + +## Next + +`python3 .add/tooling/add.py advance` → read `phases/2-scenarios.md`. +Book: `docs/03-step-1-specify.md`. (UI feature? also sketch flows + every screen +state: loading/empty/error/success.) diff --git a/.claude/skills/add/phases/2-scenarios.md b/.claude/skills/add/phases/2-scenarios.md new file mode 100644 index 000000000..4f4093c42 --- /dev/null +++ b/.claude/skills/add/phases/2-scenarios.md @@ -0,0 +1,46 @@ +# Phase 2 — Scenarios (pass/fail cases) + +Goal: rewrite each rule as a concrete Given/When/Then that is readable by people +and checkable by machines. This is the highest-leverage artifact — the tests are +generated from it. Fill **§2 SCENARIOS** in TASK.md. + +## Produce (in TASK.md §2) + +<output_format> +```gherkin +Scenario: <short name> + Given <starting situation> + When <action> + Then <observable result> + And <what must remain unchanged> # REQUIRED for every rejection +``` + +The `And ... unchanged` clause catches corrupting partial failures (e.g. a balance +deducted before a check fails). Include it on every rejection. +</output_format> + +## AI prompt + +<prompt> +Role: a specification tester. +Read first: §1 · GLOSSARY. +Objective: one scenario per Must and per Reject rule, each result specific and observable. +Steps: + 1. Write one scenario per Must rule and one per Reject rule. + 2. For every rejection add an And-clause asserting what must NOT change. +Never: settle for a vague result ("then it works") — results must be specific and observable. +</prompt> + +## Exit gate + +<exit_gate> +- [ ] One scenario per Must rule. +- [ ] One scenario per Reject rule. +- [ ] Each result is a specific, observable fact. +- [ ] Every rejection asserts what stays unchanged. +</exit_gate> + +## Next + +`python3 .add/tooling/add.py advance` → read `phases/3-contract.md`. +Book: `docs/04-step-2-scenarios.md`. diff --git a/.claude/skills/add/phases/3-contract.md b/.claude/skills/add/phases/3-contract.md new file mode 100644 index 000000000..1a06f0298 --- /dev/null +++ b/.claude/skills/add/phases/3-contract.md @@ -0,0 +1,70 @@ +# Phase 3 — Contract (freeze the shape) + +Goal: fix the external shape — interfaces, data, names, error cases — and FREEZE +it. This is the decision point that makes the AI-led build safe: below it code is +disposable; above it nothing breaks because the shape does not move. Fill +**§3 CONTRACT** in TASK.md. + +## Produce (in TASK.md §3) + +<output_format> +- Interfaces (endpoints/functions/messages) with inputs/outputs. +- Request/response shapes + persistent schema (note transactional needs). +- Names drawn from `GLOSSARY.md` (same concept = same name everywhere). +- A response for **every** Reject error code from §1. + +Then mark `Status: FROZEN @ v1`. Generate a mock + contract tests so dependent +work can start before the real code exists. +</output_format> + +**The freeze is the one approval.** This decision point is where the single human approval lands, over the +whole bundle (§1–§4). Before asking for it, present the bundle **lowest-confidence first**: the 1–2 points +most likely wrong (`⚠ [spec|scenario|contract|test] … — because …; if wrong: …`) — aim the human's +eye before they freeze. Open that report with the ARC (goal · done · plan) per `report-template.md` so the +human sees the goal this freeze serves and the plan beyond it, not just the bundle. See `run.md`. + +## The freeze review checklist + +The human's one minute, aimed. Walk these six before saying yes: + +- **⚠ flags first** — read the lowest-confidence flags; accept each knowing its cost if wrong. + The engine refuses an unflagged freeze before build: a frozen §3 with no well-formed + lowest-confidence flag is rejected (`unflagged_freeze`), and `audit` re-checks it on every + record that crossed. +- **Intent** — does §1 say what you actually want built (and is anything you expected missing)? +- **Cases** — does every Must and Reject have an observable §2 scenario you care about? +- **Shape** — glossary names, error codes, additive vs breaking: is THIS the shape to freeze? +- **Risk** — is this scope high-risk or method-defining? Then require + `risk: high · autonomy: conservative` in the TASK.md header — the engine refuses an unguarded completion. +- **Tests** — will §4 go red for the right reason, asserting behavior rather than internals? + +This checklist AIMS the one approval — the freeze stays the only gate: no sign-off forms, no +extra documents. Reject any line and the bundle goes back to draft; that is +backward-correction, not failure. + +## AI prompt + +<prompt> +Role: an interface architect; frozen contracts are immutable. +Read first: §1 · §2 · GLOSSARY. +Objective: produce §3 — the frozen external shape, nothing more. +Steps: + 1. Define interfaces, shapes, and schema named from the glossary, with a response for every Reject code. + 2. Generate a mock returning the contracted shapes and contract tests pinning them. + 3. Mark FROZEN. No business logic. +Never: change a frozen contract — a change reopens Specify. +</prompt> + +## Exit gate + +<exit_gate> +- [ ] Versioned and marked `FROZEN`. +- [ ] Contract tests pass against the mock. +- [ ] Every name matches the glossary. +- [ ] Every spec rejection has a contracted response. +</exit_gate> + +## Next + +`python3 .add/tooling/add.py advance` → read `phases/4-tests.md`. +Book: `docs/05-step-3-contract.md`. diff --git a/.claude/skills/add/phases/4-tests.md b/.claude/skills/add/phases/4-tests.md new file mode 100644 index 000000000..9c7c04d88 --- /dev/null +++ b/.claude/skills/add/phases/4-tests.md @@ -0,0 +1,61 @@ +# Phase 4 — Tests (failing-first suite) + +Goal: turn scenarios + contract into automated tests and confirm they FAIL before +any code exists. This operationalizes red/green TDD: red now, green only after +Build. Fill **§4 TESTS** and write the suite into `.add/tasks/<slug>/tests/`. + +## The must-fail principle + +Run the suite now, with no implementation — it must be **red for the right +reason** (missing implementation, not a broken harness). A test that passes +before code exists is testing nothing and will wave bad code through later. + +## Produce + +<output_format> +- One executable test per scenario (§2), asserting **behavior, not internals**. +- Contract-conformance tests (shapes + error responses from §3). +- Side-effect assertions on rejection paths (`assert balance unchanged`). +- A recorded coverage target in §4. +</output_format> + +## Declaring where tests live + +§4's `Tests live in:` line is machine-read: when a task has no local `tests/`, +`add.py report` counts test functions at the declared path(s) instead. The FIRST +line matching `Tests live in:` is read; paths are its backticked tokens. +Resolution: `./…` → this task's dir · a token containing `/` → the project root +(the parent of `.add/`) · a bare name → a sibling of the previous token's +directory (else the task dir). A directory token counts the `*.py` files directly +inside it (non-recursive); a `.py` file token counts itself; anything else is +ignored. Resolved files are deduped, and reports mark declared counts with `†`. +Paths are confined: anything resolving (symlinks followed) +outside the project root counts 0 — `..` traversal, absolute paths, and +symlink escapes are never read. + +## AI prompt + +<prompt> +Role: a test author who writes tests before code. +Read first: §2 · §3. +Objective: a red suite that fails for the right reason — behavior, not internals. +Steps: + 1. Turn each scenario into an executable test. + 2. Add contract-conformance and edge-case tests. + 3. Run the suite and confirm it fails for the right reason; record a coverage target. +Never: implement the feature, or assert on internals. +</prompt> + +## Exit gate + +<exit_gate> +- [ ] One test per scenario. +- [ ] Suite runs and is **red for the right reason**. +- [ ] Tests assert observable behavior. +- [ ] Coverage target recorded. +</exit_gate> + +## Next + +`python3 .add/tooling/add.py advance` → read `phases/5-build.md`. +Book: `docs/06-step-4-tests.md`. diff --git a/.claude/skills/add/phases/5-build.md b/.claude/skills/add/phases/5-build.md new file mode 100644 index 000000000..7c4168e45 --- /dev/null +++ b/.claude/skills/add/phases/5-build.md @@ -0,0 +1,48 @@ +# Phase 5 — Build (AI writes the code) + +Goal: implement the feature so EVERY failing test passes — without changing any +test or the contract. This is the only phase the AI leads. It works because §1–§4 +removed all ambiguity. Write code into `.add/tasks/<slug>/src/`. + +## Work in small batches + +Pick ONE task-sized slice, restate the tests it must satisfy, implement, run +tests, iterate to green. Keep each batch small enough to review in full — you +cannot move faster than you can verify. + +## The cardinal rule + +**Never weaken or delete a test to make it pass, and never edit the frozen +contract.** That makes the code judge itself. A genuine need to change either is a +change request back to Specify. Honor the feature-specific safety rule named in §5 +(e.g. atomic balance update) — the one property tests alone may not force. + +## AI prompt + +<prompt> +Role: implement the feature so EVERY failing test passes — the build phase. +Read first: §1 · §3 · §4 · CONVENTIONS. +Objective: every §4 test green, one small batch at a time. +Steps: + 1. Make EVERY failing test pass, one small batch at a time, honoring the §5 safety rule. + 2. Report which tests pass and exactly what changed. +Never: change a test or the contract; use a package off the allow-list; or push past something unclear instead of asking. +</prompt> + +## Exit gate + +<exit_gate> +- [ ] All tests pass. +- [ ] Coverage did not decrease. +- [ ] No test and no contract modified by the AI. +- [ ] No dependency outside the allow-list. +- [ ] Change small enough to review in full. +</exit_gate> + +## Next + +`python3 .add/tooling/add.py advance` → read `phases/6-verify.md`. +Book: `docs/07-step-5-build.md`. + +> Under `autonomy: auto` (the default) Build and Verify run together as one dynamic, +> evidence-auto-gated run — not two manual stops. See `run.md`. diff --git a/.claude/skills/add/phases/6-verify.md b/.claude/skills/add/phases/6-verify.md new file mode 100644 index 000000000..fa52effb2 --- /dev/null +++ b/.claude/skills/add/phases/6-verify.md @@ -0,0 +1,73 @@ +# Phase 6 — Verify (evidence + non-functional review) + +Goal: establish trust and record an outcome. Passing tests are necessary, not +sufficient. Fill **§6** in TASK.md including the GATE RECORD. + +> **Who resolves this gate depends on the `autonomy:` header (see `run.md`).** +> Under `autonomy: auto` (the default) a run auto-PASSes once the evidence is +> complete — every test green, the convergence loops dry, and **no residue** +> (security · concurrency · architecture) — recording it as *auto-resolved* with +> the named run as accountable owner: an explicit PASS, not a skip. **Security is +> always a HARD-STOP and is never auto-passed.** Under `autonomy: conservative`, +> or whenever residue is found, this phase is **human-led** and the checks below +> are the human's. + +## Part one — confirm the evidence + +- [ ] All tests pass. +- [ ] Coverage did not decrease. +- [ ] No test or contract was altered during build. + +If any is false, stop and return to Build — there is nothing to verify yet. + +## Part two — check what tests miss + +- **Concurrency/timing** — is it correct when two run at once? (Tests run serially + and miss races.) This is usually the single most important check. +- **Security** — exposed secrets, injection openings, unexpected/invented + dependencies. A security finding is always `HARD-STOP`, never a waiver. + Writing ANY note on this line means the gate escalates to the human — and + start it with `NOTE` or `⚠` so `add.py audit` can see it: a marked security + note reviewed by the auto-gate is an audit finding (`unescalated_security_note`). +- **Architecture** — does it respect layering/dependency rules in CONVENTIONS.md? + +## Part three — the deep check (do not skim) + +Green tests prove behavior on the inputs you thought of. They do not prove the change +is *wired in*, nor that you did not leave a dead end behind — and for a non-coding change +they prove nothing about whether you actually *read* the thing you signed off. So one more +requirement, every gate: + +Deep check — do not skim. If the task produced code, record that every new symbol is +referenced (wiring) and that no new dead/unused code was introduced. If it produced prose +or non-code, record a semantic read — what you read in full and what it confirmed. Which +path applies is the resolver's judgement; the engine never classifies. + +Record it in the §6 **Deep checks** block — where each new symbol is called (a reference +search), the dead-code scan result, or the prose you read in full and what it confirmed. +An unfilled Deep checks block is a **shallow verify**, not a PASS. + +## Record exactly one outcome (no silent pass) + +When you present this gate to the human, open with the ARC (goal · done · plan) per +`report-template.md`, and reconcile its FLAGS with `add.py report --decide`'s open-item count +before the ask — per that file's reconcile rule (verify is where a flag-vs-digest mismatch bites). + +| Outcome | When | +|---------|------| +| `PASS` | all checks met | +| `RISK-ACCEPTED` | a **non-security** gap, with signed owner + ticket + expiry | +| `HARD-STOP` | any failing test or any security finding | + +## Exit gate / Next + +<exit_gate> +- [ ] Evidence confirmed, non-functional risks checked, outcome recorded — a person approved, or + (under `autonomy: auto` with no residue) the run auto-resolved as the accountable owner. +</exit_gate> + +```bash +python3 .add/tooling/add.py gate PASS # marks the task done +# or: add.py gate RISK-ACCEPTED | add.py gate HARD-STOP (return to Build) +``` +Then read `phases/7-observe.md`. Book: `docs/08-step-6-verify.md`. diff --git a/.claude/skills/add/phases/7-observe.md b/.claude/skills/add/phases/7-observe.md new file mode 100644 index 000000000..8fc33660d --- /dev/null +++ b/.claude/skills/add/phases/7-observe.md @@ -0,0 +1,40 @@ +# Phase 7 — Observe (feed the next loop) + +Goal: release deliberately, watch reality, and turn what you learn into the next +spec. Release is not the finish line — it is where the most reliable information +about the feature finally appears. Fill **§7** in TASK.md. + +## Do + +1. **Release behind a scope-of-impact limit** — feature flag and/or gradual rollout. +2. **Reuse scenarios as monitors** — the §2 scenarios that defined "correct" now + define what you alert on: overall error rate, each rejection's rate (a spike in + one is a signal), latency of the risky operation under load. +3. **Draft the next spec delta** — every defect, surprise, or new need becomes a + concrete change that re-enters the flow at Specify (a new task). + +## AI prompt + +<prompt> +Role: a reliability analyst feeding the next cycle. +Read first: telemetry · objectives · incidents. +Objective: turn what production shows into the next SPEC delta. +Steps: + 1. Report error-budget burn. + 2. Cluster errors and surface the top real-world failures. + 3. Draft a SPEC delta with evidence links. +Never: auto-roll-back — recommend; a human owns the production decision. +</prompt> + +## Exit gate + +<exit_gate> +- [ ] Released behind a flag/rollout. +- [ ] Scenario-based monitors live. +- [ ] A reviewed spec delta captured (becomes the next `new-task`). +</exit_gate> + +## Next + +Loop. The artifacts you built are living documents the next cycle refines. +Book: `docs/09-the-loop.md`. diff --git a/.claude/skills/add/report-template.md b/.claude/skills/add/report-template.md new file mode 100644 index 000000000..d8051fd85 --- /dev/null +++ b/.claude/skills/add/report-template.md @@ -0,0 +1,106 @@ +# Chat reports — the decision-point template (for the AI, not for add.py) + +The engine renders artifacts (`report`, `report --decide`, `status`); this file +governs the CHAT MESSAGE you wrap around them. The digest is the artifact BEHIND +your presentation, never a replacement for it — and your prose is never a +replacement for the digest. + +Use it every time you report at or near a decision point: an intake proposal, a +bundle approval, a verify gate, a task completion, a milestone close. + +## The decision arc — rendered first, above the five blocks + +Every report at a human gate opens with the **ARC** — three labelled lines that +place the decision in the work's whole arc, so the human confirms with sight of +where this is going, not just the step in front of them. Render it first, then a +separator, then the unchanged five blocks below: + +``` +ARC goal: <the milestone / project goal this decision serves> + done: <proven progress — tasks done · exit-criteria met · what this gate proves> + plan: <this gate → the next step → the goal> +``` + +- **goal** — the milestone or project goal the decision serves, read from the + `m-goal` line in `add.py status`; never re-typed from memory. +- **done** — proven progress only: exit-criteria met/total and tasks done from + the rollup, plus what this gate proves. An honest fact, never a hope. +- **plan** — this gate → the next step → the goal, mirroring the rollup's + `DECIDE NEXT` line. + +The arc is required at every human gate: **baseline-lock · contract-freeze · +verify · intake · scope · milestone-close · graduation**. The three labels stay +constant; their content adapts to the gate. The arc is presentation only — it +adds no gate and changes no PASS / RISK-ACCEPTED / HARD-STOP / freeze outcome. + +Its facts are engine-sourced, exactly like EVIDENCE below: goal = `m-goal` · +done = exit-criteria met/total + tasks done · plan = `DECIDE NEXT`. If your arc +and `add.py` output disagree, the engine wins — fix the arc, not the engine. + +### Per-gate examples — one shape, gate-specific content + +- **verify** — `goal:` ship the decision arc · `done:` report-arc tests 6/6 + green, gate ready · `plan:` PASS this gate → wire the arc into every gate → goal. +- **contract-freeze** — `goal:` … · `done:` bundle drafted, lowest-confidence + flag surfaced · `plan:` freeze §3 → build → goal. +- **milestone-close** — `goal:` … · `done:` exit-criteria 3/3 met, all tasks + done · `plan:` close → archive → the next milestone. +- **intake** — `goal:` the sized request · `done:` classified new-major, + rationale stated · `plan:` create the milestone → first contract → goal. + +## The five blocks, in order + +``` +SUMMARY one line: intent + target + where we are +DECISION what you need from the human (or "none — FYI") +⚠ FLAGS lowest-confidence first, why + cost-if-wrong +EVIDENCE small table: tests · gates · parity · check — engine-sourced +NEXT the single next action + what it unlocks +``` + +1. **SUMMARY** — one line carrying intent + target + position, e.g. + "v13 task 2/3 — tests-declared-fallback is green, gate PASS." The reader + knows where they are before they read anything else. +2. **DECISION** — the question the human must answer, stated plainly; exactly + one decision per report, or an explicit "none — FYI". If a decision exists, + ask it AFTER everything below has been shown (show-before-ask). +3. **⚠ FLAGS** — lowest-confidence first, each with *why* confidence is lowest and the + *cost if wrong*. Where TASK.md markers exist (`⚠` / `- [~]` / `- [ ]`), + quote them verbatim and keep their document order — extraction ≠ judgment. +4. **EVIDENCE** — engine-sourced facts pasted from `add.py` output, never + re-typed from memory. If your prose and the engine disagree, the engine + wins: fix the engine or the data, not the sentence. +5. **NEXT** — one action and what it unlocks. Mirror the rollup's DECIDE NEXT + line when it is right; overrule it only with a stated reason (e.g. planned + tasks the state file cannot see yet). + +**The ask itself** — when block 2's decision becomes a literal question component +(option picker, numbered menu), compose it as a summary: the detail stays in the +report above, the question carries intent + what "yes" means + the flag count. + +## Hard rules + +<constraints> +- **Summary-first.** Never bury the decision under a task list or a diff. +- **Show before ask.** Render the artifact (digest · diff · report) before any + approval question; the human decides on what they can see. +- **Reconcile the count.** Before the ask, your ⚠ FLAGS must reconcile with + `add.py report --decide`'s open-item count. If your prose calls an item + resolved while the digest still counts it open, the engine wins — fix the data + (the TASK.md markers the digest reads), not the sentence. A report whose flag + count disagrees with the engine is the un-transparent gate the ARC exists to close. +- **Never pre-stamp a human decision point.** Freeze / gate / lock fields stay DRAFT or + blank until the answer returns: show → ask → stamp → advance. An artifact + must never claim an approval that has not happened. +- **One report per decision point.** After an approval, point at the frozen artifact — + do not re-render the whole bundle. +- **Honest scope.** "Done" means the request, not the last task: report + "task 2/3", never "done" while approved scope remains. +- **The question is a summary, never the artifact.** Every approval ask carries + two layers: a compact SUMMARY · DECISION · ⚠ FLAGS block sits in chat + immediately before the ask (positional), and the question text itself is a + summary of two lines at most — intent + what "yes" means + the flag count — + pointing at the report above (compositional). The full bundle, diff, or + artifact lives only in the chat report; a question that re-carries it buries + the decision. +</constraints> diff --git a/.claude/skills/add/run.md b/.claude/skills/add/run.md new file mode 100644 index 000000000..36d603df5 --- /dev/null +++ b/.claude/skills/add/run.md @@ -0,0 +1,171 @@ +# The dynamic run — executing a locked scope + +Once a task's CONTRACT is frozen (phase 3), the scope is *locked*: the external shape will not move. +That lock is ADD's autonomy decision point — below it code is disposable; above it nothing breaks. This rubric +covers what runs on the far side of the decision point: the **build->verify half, executed as a dynamic, +self-improving run** instead of a manual, sequential build. The human-led **specification bundle** (Specify · Scenarios +· Contract) still owns *direction*, but v7 compresses it to a **single human approval at the decision point** +(see "The specification bundle" below) — the AI drafts the whole bundle, a human approves it once. + +> **Self-improving = within-run convergence + emit v5 deltas** — same definition as v5: tracked, +> evidence-backed, never autonomous training. The run converges in-turn AND feeds the human-gated +> consolidation loop (`deltas.md` · `fold.md`). The engine stays judgment-free: this is a rubric, not `add.py`. + +## The specification bundle (v7) + +The specification bundle used to be three separate approvals — Specify, then Scenarios, then the Contract +freeze. v7 compresses it to **one**. From the user's input the AI **drafts the whole specification bundle in one pass** — the Spec, the Scenarios, the Contract, and the failing Tests — and presents it together. The +human gives **one approval, at the frozen contract** (the decision point). That single approval is the green light +for the self-driving run. + +Why one approval and not zero: the contract freeze is the autonomy decision point, and the decision point **stays human**. +The AI *drafts* the contract but never *freezes its own* — a person approves the frozen shape before any +auto-run touches code. This is exactly what keeps "never self-gate a human-led gate" true under an auto +default: the one gate that remains is human. Drop it to zero and the AI would freeze the interface it +then builds against and self-gate the result — the circular trust v6's dogfood warned against. + +What the human is actually approving in that one gate: that the drafted Spec captures the real intent, +that the Scenarios cover the cases that matter, and that the Contract shape is the one to freeze. Reject +any part and the bundle goes back to draft — that is backward-correction (principle 4), not failure. +Approve, and the run begins. The decision-point guide (`phases/3-contract.md`) carries the +**freeze review checklist** — six lines that walk the human through exactly this, ⚠-first. + +**The lowest-confidence flag — aiming the one approval.** A single approval over a whole bundle is easy to +grant without reading. So the AI presents the bundle **lowest-confidence first**: of everything it is asking the human +to freeze, it names the **1–2 points most likely to be wrong**, tagged by part +(`⚠ [spec|scenario|contract|test] … — because …; if wrong: …`), each with *why* it is uncertain and +*what it costs if wrong*. The §1 assumptions feed it, but a flag may equally point at an uncovered +scenario or the contract shape. If nothing is materially uncertain, the AI still names the single +biggest risk, however small — never a blank "none". Honest about its limit: the flag records that the +human approved with the soft spots **in front of them**, eyes open; it makes a real review cheap and a +lazy one visibly negligent, but it cannot *force* engagement — and the AI never asserts that the human +engaged when it cannot know (a self-asserted gate would just move the unread approval one level up). Closing +that enforcement gap is the job of a CI checker, not of prose. + +## When the run begins — the scope-lock trigger + +The trigger is the **frozen contract**, nothing else. A run may start only when: + +- §3 CONTRACT is marked `FROZEN @ vN` (the shape is fixed), AND +- §4 TESTS exist and are RED for the right reason (the target the run drives to green). + +No frozen contract -> no run: you are still inside the specification bundle, and starting early is the +forward-skip the flow forbids. The lock is what makes autonomous execution *safe* — the AI cannot +drift the interface, because the interface is frozen above it. + +## The change scope — what the run may and may not touch + +<constraints> +A locked run has a hard boundary. It MAY: + +- write and rewrite **code** (`src/`) — code is disposable below the decision point; +- drive the **tests** to green WITHOUT weakening them (a weakened test is a method violation); +- gather **evidence** for the verify gate (test output, non-functional review). + +It MUST NOT: + +- change the **frozen contract** or the **locked scope** — a discovered gap is backward-correction: + the run STOPS and hands back to a human to reopen Specify (principle 4). The run never re-locks + scope on its own. +- weaken, delete, or skip a **test** to make the build pass (that inverts the method). +- touch the **specification-bundle artifacts** (§1–§3) except to halt and escalate. +</constraints> + +Crossing the boundary is not a fast run; it is an unverified one. When the run hits something only the +specification bundle can resolve, it stops — and that stop is the loop working, not failing. + +## The dynamic run — fan-out and in-run convergence + +Once it starts, the run does not crawl the build in one linear pass. It **fans out** the independent +work — several build attempts, several test-fix loops, several checks at once — and then **converges** +on a trustworthy result with three loops: + +- **loop-until-dry** — keep hunting failures and gaps until N consecutive passes find nothing new. + Stopping at the first green is how defects survive; the run stops only when the well runs dry. +- **adversarial verify** — for every "done" claim, an independent skeptic tries to REFUTE it. The + claim survives only if it withstands refutation, not because one pass looked plausible. +- **completeness-critic** — a final pass that asks "what did we NOT cover — a scenario, a non-functional risk, + an unstated assumption?" Whatever it finds re-enters the run. + +The run ends only when the loops go dry AND the auto-gate's evidence is satisfied. This is the run +**self-improving within the turn** — the same convergence the foundation loop runs across milestones, +compressed into one task. + +## The automated quality gate + +<constraints> +The verify gate may be resolved by **evidence** rather than by a person — when the evidence is +sufficient and the result is recorded (principle 7, reframed: an automated, recorded pass is an +explicit pass, not a skip). + +- **Auto-PASS requires ALL of:** every test green; coverage not decreased; no test weakened and no + contract edited; the convergence loops dry; the completeness-critic found nothing open; and the + deep check below recorded. +- **The deep check (every gate, no skim).** Deep check — do not skim. If the task produced code, record + that every new symbol is referenced (wiring) and that no new dead/unused code was introduced. If it + produced prose or non-code, record a semantic read — what you read in full and what it confirmed. + Which path applies is the resolver's judgement; the engine never classifies. An unfilled deep check is + a **shallow verify**, not an auto-PASS — evidence the work is wired, not merely plausible. +- **Always escalates to a human (never auto-passed):** any **security** finding (HARD-STOP, always); + a **concurrency**/timing risk the tests cannot exercise; an **architecture**/layering violation; and + any failing test. These are the residue principle 2 names — automation cannot judge them. +- **Records exactly one outcome** (no silent skip): `PASS` (evidence + the named run as accountable + owner) · `RISK-ACCEPTED` (non-security, signed) · `HARD-STOP`. The record states it was + auto-resolved, names the run, and lists the residue checks performed. + +The auto-gate NEVER writes a human signature it did not get. An auto-PASS is logged as *auto-resolved*, +honestly — the line between a pass and a skip is the recorded outcome, not a forged name. +</constraints> + +## Emitting deltas — feeding the foundation back + +The completeness-critic does not discard what it finds. Every gap, surprise, or convention that helped +or hurt becomes an **`open` lesson learned** in the task's OBSERVE block, in the `deltas.md` grammar, +tagged by competency: + +- a finding the run FIXED but that taught the foundation something (a missing scenario -> `TDD`); +- a finding the run could NOT fix — a residue escalation -> a delta AND the escalation to a human. + +These `open` deltas feed v5's human-gated consolidation (`fold.md`) at milestone close: the run emits `open`; +the human consolidates. That is the loop closing — **v6 run -> v5 foundation** — so a dynamic run sharpens the +five competencies instead of letting its findings evaporate at end-of-run. + +## The autonomy level + +<constraints> +How much a run may auto-gate is a **per-scope setting**, not a global switch (principle 5: trust is +earned per scope). A task declares its level in its `TASK.md` header: + +``` +autonomy: auto | conservative +``` + +- **auto (the default)** — the run may auto-PASS when the evidence + residue checks above are + satisfied. Security still always escalates. This is the default starting point: a frozen contract + flips the task into a self-driving run that converges and auto-gates on evidence. +- **conservative** — the deliberate *lowering*: the run does all the work and converges, but STOPS at + the verify gate for a human. Auto-PASS is disabled. Choose it wherever evidence is thin or risk is high. + +> **v7 reversal (recorded, not hidden).** Earlier the default was `conservative` and `auto` was the +> earned exception; v7 flips this — `auto` is the default, `conservative` is the deliberate lowering. +> What did **not** change is principle 5: the autonomy level is still **per-scope**, and it still lives in the +> `TASK.md` header, and you still lower it anywhere risk demands. Only the starting point moved. + +**The high-risk guard — `auto` is refused where it matters most.** The autonomy level is not a blank cheque. On a +**high-risk or method-defining scope** — anything where a wrong-but-plausible result is expensive or +hard to reverse (auth, money, data-loss paths, the method/trust-layer itself) — `auto` must be lowered +to `conservative`; leaving it at `auto` there is the reject code **`unguarded_high_risk_auto`**. This +closes the v6 dogfood gap, where the whole milestone ran at `auto` on the riskiest possible +scope (defining the method) with no friction. The default is `auto` *for ordinary, well-tested scope*; +high risk still earns a human gate. + +Judging *what* is high-risk stays human — the scope declares **`risk: high`** in the same `TASK.md` +header where the autonomy level lives, reviewed at the freeze like every header line (the engine never +classifies scope). **Since v14 the guard is mechanical for the declared case:** +the engine refuses the declared combination — `add.py gate` will not complete (`PASS`/`RISK-ACCEPTED`) a task whose header +carries `risk: high` without `autonomy: conservative` (error `unguarded_high_risk_auto`; `HARD-STOP` +always records — stopping is never blocked), and `add.py audit` flags the same code on a finished +record whose header was tampered or whose GATE RECORD reviewer is the auto-gate — which CI enforces +(audit-ci). The honest limit mirrors the audit's: an **undeclared** high-risk scope passes; declaring +is the human decision point, the engine enforces what was declared. +</constraints> diff --git a/.claude/skills/add/scope.md b/.claude/skills/add/scope.md new file mode 100644 index 000000000..432634182 --- /dev/null +++ b/.claude/skills/add/scope.md @@ -0,0 +1,80 @@ +# Scope drafting — turn a classified request into a versioned MILESTONE.md + +This is the **second half of intake**. `intake.md` CLASSIFIES a request into a bucket; scope +drafting turns that classified request into a confirmed, well-formed, versioned `MILESTONE.md` +through discussion. The MILESTONE.md template is the SHAPE; this rubric is HOW to fill it well. +You (the AI) **propose**; the human **confirms before anything is created**. + +## What to do per intake outcome + +scope drafting honors intake's classification — it never re-sizes a request: + +| intake outcome | scope-loop action | creates (after confirm) | +|----------------|-------------------|-------------------------| +| `new-major` / `sub-milestone` | draft ONE MILESTONE.md (fill the template via discussion) | 1 milestone | +| `task` | route to `add.py new-task <slug>` (it fits the active milestone) | 0 milestones | +| `change-request` | route to SPECIFY/CONTRACT of the affected task | 0 milestones | +| `split_required` | draft ALL N items as a batch in ONE pass | N milestones/tasks | + +**Confirm before create is the invariant.** It holds in the one-pass split case too: "one pass" +means one drafting pass, NOT auto-creation. Nothing is written to disk — single draft or the +whole batch — until the human confirms. You propose; you wait. + +## Brainstorm before you draft — co-specify at milestone level + +Don't draft a MILESTONE.md from thin input. Run the same three-move co-specify as a +task's §1 (`phases/1-specify.md`) — Diverge (framings + open questions) → Converge +(draft + rank) → Validate (show flags first) — raised to milestone scope. Ask only +what moves the goal, the In/Out line, or the task list; skip what PROJECT.md settles. +Draft the WHOLE milestone before showing; nothing hits disk until the human confirms. + +Diverge seeds (pick the live ones): +- **Outcome** — done means a user can do *what* they can't today? (goal sentence) +- **Edge of scope** — nearest thing assumed IN that you want OUT? (Out list) +- **Riskiest decision point** — which contract, if wrong, costs the most rework? (freeze-first) +- **Done-looks-like** — how do we SEE each outcome without reading code? (exit criteria) +- **First slice** — which task unblocks the rest? (breadth-first order) + +Rank assumptions lowest-confidence first; the top 1–2 get the flag the human reads at confirm: +`⚠ <assumption> — lowest confidence because <why>; if wrong: <cost>`. Present the draft via +`report-template.md` — open with the ARC (goal · done · plan): the goal this milestone serves, +what is already covered, and the plan its task list lays out. + +## Drafting a good MILESTONE.md (section by section) + +- **goal** — ONE sentence, an outcome not an output ("a user can size any request", not "write + intake.md"). If it needs an "and", it is probably two milestones. +- **Scope In/Out** — the explicit anti-creep deferral list. Naming what is OUT is as important + as what is IN; an empty Out list usually means the scope is not yet thought through. +- **Shared decisions & glossary deltas** — cross-cutting rules every task must honor, named from + the glossary. New terms get a glossary entry (the living documentation stays honest). +- **Shared / risky contracts to freeze first** — the decision points between tasks; name the owning task. +- **Tasks (breadth-first)** — `slug · depends-on · one line` each. Decompose by deliverable, not + by phase; keep each task one-file-sized. Order by dependency, not by guesswork. +- **Exit criteria** — observable, and **every exit criterion maps to a declared task slug** + (no dangling criterion). Each line answers "which task delivers this, and how would we see it?" + +## Reject codes (emit `{ reject, rationale }`, create nothing) + +<reject_codes> +- `not_classified` — the request has not been through intake yet. Classify it first; you cannot + draft scope for an unclassified request. +- `dangling_criterion` — a drafted MILESTONE.md has an exit criterion that maps to no declared + task slug. FIX the draft (add the task or drop the criterion) before proposing — never propose + a malformed milestone. With no engine lint, you are the first check and the human is the backstop. +- `no_milestone` — intake routed the request to `task` or `change-request`; scope drafting + creates NO milestone. Honor the classification; do not invent milestone-sized scope. +</reject_codes> + +## Worked example (from this repo's own history) + +Request: *"open the Interface & Intake milestone"* → intake classified it `sub-milestone` of the +live v4 self-driving theme → scope drafting produced **`.add/milestones/v4-1/MILESTONE.md`**: + +- **goal**: make ADD harness-drivable and self-scoping — machine-readable state plus an + AI-facilitated request→versioned-milestone intake loop (the real v4-1 goal, one outcome sentence). +- **tasks** (breadth-first): `machine-state-json` · `versioning-policy` · `scope-loop`. +- **exit criteria** — each maps to its task slug: `--json` emits owner+stop (← machine-state-json), + the AI proposes a bucket with rationale (← versioning-policy), the AI drafts a versioned + MILESTONE.md via discussion (← scope-loop). Every criterion names the task that delivers it — + which is exactly the well-formedness rule above, checkable against the real file. diff --git a/.claude/skills/add/setup-review.md b/.claude/skills/add/setup-review.md new file mode 100644 index 000000000..847ad52ac --- /dev/null +++ b/.claude/skills/add/setup-review.md @@ -0,0 +1,65 @@ +# Setup review — the one page the human signs + +Autonomous setup ends at a single human gate: the **baseline approval** (`add.py lock`). Before that +signature is honest, the human needs to see *what you drafted and how sure you were* — not re-derive +it. `SETUP-REVIEW.md` is that page: every decision you made while drafting the foundation, first-scope, +and the first contract, **ordered lowest-confidence-first** so the riskiest guesses meet their eye first. + +This is the setup-level analog of presenting a task's specification bundle lowest-confidence-first at the contract freeze. +The engine never reads this file — `add.py lock` is judgment-free, the signature *is* the gate (see +`setup-lock-state`). The human **reading** this page is the review; your job is to make the reading honest. + +## Where it lives + +Write **one** artifact at `.add/SETUP-REVIEW.md`. **Never clobber a human-edited one** — if it already +exists with hand edits, append/update, don't overwrite (the same non-clobber rule `init` applies to +living docs). It is a per-onboarding, setup-level artifact; it sits beside `PROJECT.md`, not under a task. + +## The template + +```markdown +# SETUP REVIEW — <project> + +<stage> · <brownfield | greenfield> · drafted by <model> @ <date> + +| # | Decision | Lands in | Tag | Why / Evidence | +|---|----------|----------|-----|----------------| +| 1 | <the drafted decision> | PROJECT.md \| scope \| first-contract | `guessed` | <the inference + why you had to guess> | +| 2 | <…> | <…> | `evidence-grounded` | <cite the source file/line you read it from> | + +Sign: confirm in chat → the agent runs `add.py lock --by "<name>"` (typing it yourself works too) +``` + +Rows are numbered for reference at the gate ("row 1 is where my confidence is lowest"). + +## The two rules that make it honest + +<constraints> +1. **Lowest-confidence-first.** Order rows by confidence **ascending**. A `guessed` row always floats above an + `evidence-grounded` one. The point is not completeness theatre — it is to spend the human's attention + where it changes outcomes: the top of the table is the part they actually need to challenge. + +2. **Every row is tagged — `guessed` or `evidence-grounded`.** + - `evidence-grounded` — you read it from the code/repo. **Cite the file** (e.g. `pyproject.toml`, + `src/orders/models.py`). Brownfield onboarding (see `adopt.md`) is mostly these. + - `guessed` — the repo was silent, so you inferred it. **State the inference and why.** Thin-greenfield + onboarding (a near-empty repo, only the 4-lens answers) produces these. These are what the human + must check; that is why they sit on top. + + The tag vocabulary is shared with `adopt.md` — the brownfield map tags each filled living-doc decision + `guessed`/`evidence-grounded`, and those tags flow straight into this table. +</constraints> + +## Where it ends + +`SETUP-REVIEW.md` is **read-only context** for the baseline approval. You do not ask the human to approve it +field-by-field; you present it, lowest-confidence-first; they confirm in conversation, and you run the lock +with their name: + +```bash +python3 .add/tooling/add.py lock --by "<name>" +``` + +`lock` records the lock layers and opens the build — it does **not** parse or validate this file (the +engine stays judgment-free). The review lives in the human's reading of the page, not in the tool. Make +the top of the table the truth they most need, and the one signature is informed. diff --git a/.claude/skills/add/streams.md b/.claude/skills/add/streams.md new file mode 100644 index 000000000..8cfc6146c --- /dev/null +++ b/.claude/skills/add/streams.md @@ -0,0 +1,256 @@ +# Parallel streams — pipelining independent tasks + +Load this **only** when a milestone has more than one task and you want to run them +concurrently. The default ADD path is one task at a time; this rubric is the opt-in +escape hatch for when independent tasks are queued and a human is ready to review. + +It changes **no `add.py` code and no phase semantics**. It is a way *you, the +orchestrator*, drive several tasks at once by reading the dependency DAG that +`add.py status` already prints, and spawning one worker per ready task. + +## The honest frame — this is pipelining, not N× speed + +With **one human reviewer** you cannot beat `review_time × N_tasks` (the human-led +decision points are serial — `docs/10-setup-and-stages.md:91`). So the win is **not throughput**: +it is that the reviewer is **never blocked waiting on a build**. While the human reviews +task A's frozen bundle, the builds for B·C·D run behind *their* frozen contracts. You hide +build latency under human latency. Do not promise more than that. + +## The two queues + +Compute both from one `python3 .add/tooling/add.py status` — no new state: + +- **READY-QUEUE** — tasks in the active milestone where `phase ≠ done` **and** every + `deps=` task already shows `gate=PASS`. These are the only tasks a worker may pick up. + A task with unmet deps stays queued; a task finishing PASS unblocks its dependents on + the next `status`. +- **REVIEW-QUEUE** — the irreducibly serial part: the **bundle approval** (contract + freeze) and any **Verify escalation**. One human, one queue. Present these one at a + time, never in a batch the human will approve without reading. + +``` + add.py status ─► READY-QUEUE ──spawn workers──► builds run ──► REVIEW-QUEUE ──► done + (deps=PASS?) (machine span) (concurrent) (decision points, + ▲ strictly serial) + └──────────────── a task gating PASS unblocks its dependents ──────────────┘ +``` + +## The autonomy level is the throttle (not a new flag) + +How much concurrency you actually get is set by each task's `autonomy:` header +(`run.md`), not by this rubric: + +| `autonomy` (TASK.md) | What serializes on the human | Concurrency | +|----------------------|------------------------------|-------------| +| `conservative` | bundle approval **+** every Verify | pure pipelining — builds overlap, both gates queue | +| `auto` (default) | bundle approval **only**; Verify auto-PASSes on evidence | real concurrency — only the decision point + residue escalations queue | +| `auto` but **high-risk** | refused → forced `conservative` (`unguarded_high_risk_auto`) | back to pipelining, by design | + +The irreducible floor is **one human approval per task at the contract decision point** — the decision point +never drops to zero (`run.md:22`). That floor is correct; do not engineer around it. + +## Who writes what — the hard boundary + +<constraints> +- **You (orchestrator)** own all shared writes: `MILESTONE.md`, and every + `add.py advance <slug>` / `add.py gate <outcome> <slug>` call. **Always pass the explicit + `<slug>`** — `advance`/`gate`/`phase` all take an optional task slug and act on it + (`add.py` `_resolve_task`); omitting it falls back to the single `active_task`, which + races once more than one stream is live. Name the task every time. Workers never run these. +- **A worker** owns only its own `.add/tasks/<slug>/` — it builds `src/`, drives the + tests green, gathers evidence, and writes `SUMMARY.md` + OBSERVE deltas. It touches + **no sibling stream and no shared file**. +- **Isolation**: spawn each worker with `isolation="worktree"` so concurrent builds + cannot collide. The worktree is discarded on failure; the task resets to its last-good + phase. +</constraints> + +## Design for failure (required) + +- **Fresh worktree base (verify base == HEAD)** — create each worker's worktree from current + `HEAD` **after** you commit the task's frozen specification bundle (spec · scenarios · contract · tests). A + worktree forked from a stale base forces the worker to recreate the frozen artifacts by hand + (the v10 dogfood hit exactly this). Before the worker starts, confirm `git -C <worktree> + rev-parse HEAD` equals the orchestrator's `HEAD`; if it drifted, `git merge` the base in first. +- **Lease + timeout** — record which worker holds which task (in the wave ledger, below); + if a worker dies, release the claim back to READY (re-spawn, do not assume partial work is sound). +- **Failure isolates** — a worker that hits a STOP-and-escalate (below) blocks only its + own task. Siblings keep running; the escalation joins the REVIEW-QUEUE. +- **Circuit-breaker** — if N workers fail in a wave, stop fanning out and fall back to + sequential. Repeated failure means the scope was wrong, not the parallelism. + +## Wave ledger — the wave's resume point + +A single task resumes from `state.json`; a wave used to resume from nothing — the +task ↔ lease ↔ fork-base ↔ autonomy ↔ merge-order mapping lived only in the orchestrator's +chat context, and the v12-1 recurrence proved that discipline without an artifact fails +(the base check existed in prose and never ran). The ledger fixes both: it is the file you +re-orient from, and its evidence cells cannot be filled without executing the checks. + +**The file** — `.add/milestones/<m>/WAVE.md`, orchestrator-owned like `MILESTONE.md` and +`state.json`. ONE live wave per milestone at a time; opening a second while one is live is +refused (`wave_already_live`). **Workers never read WAVE.md** — the orchestrator copies the +relevant mid-wave decisions into each worker's PROMPT.md at spawn/respawn, so the worker +contract below stays unchanged and no worker widens into sibling state. + +```markdown +# WAVE.md — transient wave ledger (orchestrator-owned · one live wave per milestone) +wave: <n> · opened: <date> · status: live|merging +base: <orchestrator HEAD at spawn — the sha every fork must equal> + +### Roster (lease ledger) +| task | lease (worker) | fork-base (pasted) | autonomy | spawned | timeout | +|--------|----------------|---------------------------------------------|----------|---------|---------| +| <slug> | wt-a | <paste `git -C <wt> rev-parse HEAD` output> | auto | <time> | <dur> | + +### Mid-wave decisions +- <date> <decision a later or respawned worker must honor — copy it into that worker's PROMPT.md> + +### Merge order (serial; integration Verify per merge) +1. <slug> → 2. <slug> +``` + +**Evidence cells, not ticks.** The fork-base cell holds the PASTED output of +`git -C <worktree> rev-parse HEAD`, and it must equal `base:`. A tick is not evidence; a row +you can only fill by running the command is the fresh-worktree-base check EXECUTING — the +v12-1 lesson (words-exist ≠ method-works) closed structurally. Spawning a worker whose roster +row lacks that evidence is refused (`unverified_fork_base`). + +**Lifecycle — open → consume → digest → delete.** Open the ledger when the first worker +spawns. The serial integration Verify consumes it (the merge order is read from it, one +worktree at a time). At wave close, absorb the evidence digest — wave base · roster→fork-base +evidence · merge order · integration-Verify outcome — into `MILESTONE.md` as an append-only +`## Wave log` block (this is the integration-Verify *record*, previously homeless), and only +then remove the file. Removing WAVE.md before the digest is absorbed is refused +(`digest_not_absorbed`) — the proof the checks ran must outlive the file. + +**Resume rule.** On session start, a live WAVE.md is the wave's resume point: re-orient from +the file — roster, bases, decisions, merge order — never from conversational memory. + +## Merge is serial — integration Verify + +Parallel build, **serial integration**. After workers return, you merge the worktrees +one at a time and run the **integration** Verify — the concurrency / architecture / layering +checks that `run.md:102` says automation cannot judge. Two green tasks in isolation can +still conflict when merged; this step is where that surfaces. Never auto-pass it. + +Each worktree carries a full copy of `.add/`. Merge back **only** `src/`, `tests/`, and the +worker's own `.add/tasks/<slug>/` (TASK.md · SUMMARY.md) — `.add/state.json`, `MILESTONE.md`, +and the live `WAVE.md` stay orchestrator-owned, or a parallel merge will drag stale state back. + +## The worker contract — portable across coding agents + +A worker **is** the dynamic run (`run.md`) for one task. Keep two things separate: + +- **The contract** (below) — the prompt. It is **agent-agnostic**: it names no vendor tool, + no model, no spawn API. It is a durable ADD artifact, like the spec and the tests. +- **The adapter** (next sections) — the thin, swappable mapping that tells *one* runner + (Claude Code · Codex · opencode · pi-mono · any CLI agent) how to launch the contract. + +This split is the whole point: the same frozen contract runs on any agent; only the adapter +changes. Fill every `{{...}}` per stream. The ADD-specific value is `<touch_boundary>` + the +"return a verdict, never write shared state" rule — they are identical on every runner. + +```xml +<!-- PROMPT.md — dropped into the worker's worktree, or passed inline. No runner-specific tokens. --> +<objective> +Execute the LOCKED dynamic run for task '{{TASK_SLUG}}' in milestone {{MILESTONE}}: +drive §4 TESTS red→green against the FROZEN contract {{CONTRACT_VERSION}}, converge, and +resolve verify per autonomy={{AUTONOMY}}. You own ONLY the machine-led span — the two human +decision points (bundle approval · escalated Verify) are NOT yours. +</objective> + +<persona> +You are a {{DOMAIN}} engineer with 15 years building {{DOMAIN_DETAIL}}. +A wrong-but-plausible result here is expensive; correctness over speed. +Work step by step: +1. Load the context files. Confirm the start gate: §3 CONTRACT FROZEN @ {{CONTRACT_VERSION}} + AND §4 TESTS RED for the right reason. If not → STOP and escalate (forward-skip forbidden). +2. Build in small batches in src/ until the red tests pass — never weaken or skip a test. +3. Converge: loop-until-dry · adversarial-verify every 'done' claim · completeness-critic. +4. Resolve verify per the boundary. Write SUMMARY.md + OBSERVE deltas (deltas.md grammar). +Score confidence (0-1) on Completeness · Clarity · Practicality · Optimization · EdgeCases · +Self-Eval; if any < 0.9, refine before returning. +</persona> + +<touch_boundary> <!-- from run.md:56-73; the worker's contract, identical on every runner --> +MAY: rewrite code in src/ · drive tests green WITHOUT weakening them · gather verify evidence. +MUST NOT: edit the frozen CONTRACT or locked scope · weaken/delete/skip any test · + touch §1–§3 bundle artifacts · write MILESTONE.md / state.json / any sibling stream. +STOP-and-escalate (return your findings; do not decide): + • a discovered scope/contract gap → backward-correction, reopen Specify (principle 4) + • any SECURITY finding → HARD-STOP, always + • a concurrency/timing OR architecture/layering risk the tests cannot exercise + • [include this bullet ONLY when autonomy=conservative] the verify gate itself — STOP for the human +Auto-PASS only if autonomy=auto AND: all tests green · coverage not decreased · no test weakened · + no contract edited · loops dry · completeness-critic clean · no residue above. Log it as + auto-resolved, naming this run as owner — never forge a human signature. +</touch_boundary> + +<context_files> <!-- paths relative to the worktree root --> +.add/PROJECT.md · .add/milestones/{{MILESTONE}}/MILESTONE.md (READ-ONLY) · +.add/tasks/{{TASK_SLUG}}/TASK.md · .claude/skills/add/run.md · .claude/skills/add/deltas.md +</context_files> + +<expertise> +Adopt the persona above. If your runner supports specialist injection — a Claude Code skill, +a Codex/opencode system-prompt preamble, an agent profile — load the one matching {{DOMAIN}}. +If it does not, the persona IS your expertise. +</expertise> + +<tools> +Navigate with your runner's code-intelligence: mcp__serena under Claude Code; LSP / ctags / +ripgrep otherwise. Design every IO path for failure — timeouts, retries, rollback. +</tools> + +<return> <!-- the worker PROPOSES; the orchestrator RECORDS. A worker never runs add.py. --> +End with a structured verdict AND write the same into SUMMARY.md in the task dir: +{ task, outcome: PASS|RISK-ACCEPTED|HARD-STOP|ESCALATE, evidence: <tests+coverage>, + residue: [security|concurrency|architecture findings], deltas: [open lessons learned] }. +Do NOT touch add.py or any shared file — the orchestrator gates on your verdict. +</return> +``` + +## Choosing the model — vendor-neutral tiers + +ADD picks a **tier** from the scope's nature; the adapter maps the tier to the runner's model id. +The contract is identical whichever model runs it (the model is disposable, like the code): + +| Tier | When | Claude Code | Any other runner | +|------|------|-------------|------------------| +| **mid** | ordinary, well-tested scope; clear contract | `sonnet` | the runner's balanced model | +| **top** | complex / ambiguous / cross-cutting / broad scope of impact | `opus` | the runner's strongest reasoning model | + +Two rules sit **above** model choice and never bend: +- **High-risk ⇒ `conservative` autonomy, regardless of model** (`run.md` high-risk guard). A + stronger model does not buy back the human gate. +- **Security residue always escalates** — no tier and no model auto-passes it. + +## The spawn adapter — one thin mapping per runner + +ADD needs six capabilities from any runner. **Isolation is the one ADD owns itself** (a git +worktree), so streams stay portable even on a runner with no native sandbox — ADD makes the +worktree, then points the agent at that directory. + +| ADD needs | Abstract | Claude Code (verified reference) | Any CLI agent — Codex · opencode · pi-mono · … | +|-----------|----------|----------------------------------|-----------------------------------------------| +| spawn a worker | prompt + label | `Task(description=…, prompt=…)` | `cd $WT && <agent> run --prompt-file PROMPT.md` | +| pick the model | tier → id | `model="opus"\|"sonnet"` | a `--model <id>` flag | +| isolate | worktree | `isolation="worktree"` | `git worktree add $WT HEAD` (after committing the bundle; verify base == HEAD), then run inside it | +| load context | files / cwd | `<context_files>` + repo cwd | run inside `$WT`; paths are relative | +| domain expertise | skill / preamble | a Claude skill in `<expertise>` | a system-prompt / profile preamble | +| return a verdict | structured | final message (optionally a schema) | stdout JSON the orchestrator parses | + +The **hint of `Task` spawn** is the Claude Code column — the worked reference. For any other +agent the recipe is the same shape: `git worktree add` → point the agent CLI at that dir with +the chosen model → it reads `PROMPT.md` → you parse its verdict. + +> **Honesty:** only the Claude Code column is verified. The CLI forms for Codex/opencode/pi-mono +> are *illustrative shapes*, not confirmed flags — exact syntax differs per runner and version; +> confirm with the `find-docs` skill. The portable, durable parts are the **contract** and the +> **six-capability mapping**, never any one runner's flags. + +When workers return, **you** record each outcome with the explicit slug — `add.py advance <slug>` +as evidence lands, `add.py gate PASS|RISK-ACCEPTED|HARD-STOP <slug>` at verify — then re-read +`status` to refill the READY-QUEUE. The worker proposes a verdict; the orchestrator records it. +That split is exactly what lets a non-Claude worker take part without ever touching shared state. diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..f58bc3430 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,26 @@ +<!-- ADD:BEGIN — managed by `add.py sync-guidelines`; do not edit inside --> +## ADD — how to work in this repo + +This project uses **ADD (AI-Driven Development)**: you, the AI, drive the build; +the human owns direction and verification. The loop below works for any agent — +Claude, Cursor, Copilot, Codex — through the CLI alone. Before you change code: + +1. Run `python3 .add/tooling/add.py status` — where the project is and what's + next (the resume point; read it first every session). +2. Read `.add/PROJECT.md` — the foundation (domain · spec · UI/UX) every task + builds on. +3. Run `python3 .add/tooling/add.py guide` — it names the phase and the exact + phase-guide file to read (the `guide :` line). Work ONLY that phase — each + guide ends with its exit gate and the command to move on. + +The flow: INTAKE sizes a request into a milestone; each task runs the +**specification bundle** — Spec+Scenarios+Contract+Tests as one bundle, +ONE human approval at the frozen contract — then a self-driving build→verify +run. Non-negotiable for every agent: +Never weaken a test or edit a frozen contract to make a build pass; a security +finding is always HARD-STOP — never auto-passed. + +On Claude Code the `add` skill drives this loop automatically; other agents +follow the three steps. The book is in `.add/docs/`. This block is generated +by `add.py sync-guidelines`; edit outside the markers, not inside. +<!-- ADD:END --> diff --git a/CLAUDE.md b/CLAUDE.md index 9b101b263..4163249d8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -251,3 +251,30 @@ Before pushing, run the full CI matrix locally: ```bash orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo fmt --check && cargo clippy -- -D warnings && cargo clippy --no-default-features --features runtime-tokio,jemalloc -- -D warnings && cargo test --release && cargo test --no-default-features --features runtime-tokio,jemalloc' ``` + +<!-- ADD:BEGIN — managed by `add.py sync-guidelines`; do not edit inside --> +## ADD — how to work in this repo + +This project uses **ADD (AI-Driven Development)**: you, the AI, drive the build; +the human owns direction and verification. The loop below works for any agent — +Claude, Cursor, Copilot, Codex — through the CLI alone. Before you change code: + +1. Run `python3 .add/tooling/add.py status` — where the project is and what's + next (the resume point; read it first every session). +2. Read `.add/PROJECT.md` — the foundation (domain · spec · UI/UX) every task + builds on. +3. Run `python3 .add/tooling/add.py guide` — it names the phase and the exact + phase-guide file to read (the `guide :` line). Work ONLY that phase — each + guide ends with its exit gate and the command to move on. + +The flow: INTAKE sizes a request into a milestone; each task runs the +**specification bundle** — Spec+Scenarios+Contract+Tests as one bundle, +ONE human approval at the frozen contract — then a self-driving build→verify +run. Non-negotiable for every agent: +Never weaken a test or edit a frozen contract to make a build pass; a security +finding is always HARD-STOP — never auto-passed. + +On Claude Code the `add` skill drives this loop automatically; other agents +follow the three steps. The book is in `.add/docs/`. This block is generated +by `add.py sync-guidelines`; edit outside the markers, not inside. +<!-- ADD:END --> From 71fd6d3374c25b9d1c6034e3dfb79b98c4ce1dba Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 11:08:35 +0700 Subject: [PATCH 02/12] test(server): failing-first suite for hotpath-lock-quickwins (QW1-QW8) Red/green TDD suite written and confirmed red BEFORE the build: - quickwins_red.rs: qw7 key-map pruning (runtime-red, 100 vs 40 entries) plus four parity pins (backlog golden model vs the per-byte reference, WAL false-on-full durability gate, replication offset exactness under 4-thread concurrency, INFO total_commands exactness under 4-thread concurrency). - quickwins_red_api.rs: compile-red against the two new surfaces the frozen contract introduces (server::socket_opts:: apply_client_socket_opts, ReplicationState::offset_handle). Task: .add/tasks/hotpath-lock-quickwins (contract FROZEN @ v1). author: Tin Dang --- tests/quickwins_red.rs | 322 +++++++++++++++++++++++++++++++++++++ tests/quickwins_red_api.rs | 60 +++++++ 2 files changed, 382 insertions(+) create mode 100644 tests/quickwins_red.rs create mode 100644 tests/quickwins_red_api.rs diff --git a/tests/quickwins_red.rs b/tests/quickwins_red.rs new file mode 100644 index 000000000..4caea5262 --- /dev/null +++ b/tests/quickwins_red.rs @@ -0,0 +1,322 @@ +//! ADD task `hotpath-lock-quickwins` — failing-first suite (runtime tests). +//! +//! RED tests (fail until the build lands): +//! - qw7_vector_key_maps_pruned_on_delete — key-map pruning does not exist yet. +//! +//! PIN tests (green before AND after — the parity safety net the batch must +//! not break; Reject: "behavior_regression"): +//! - qw5_backlog_append_golden — byte-identical backlog state machine. +//! - qw2_try_wal_append_required_false_on_full — durability gate contract. +//! - qw3_replication_offsets_exact — offset arithmetic under concurrency. +//! - qw4_total_commands_exact — bespoke INFO counter exactness. +//! +//! New-API red tests (compile-red) live in `tests/quickwins_red_api.rs`. +//! Run this file alone with: cargo test --test quickwins_red + +use bytes::Bytes; +use moon::replication::backlog::ReplicationBacklog; +use moon::replication::state::ReplicationState; + +// --------------------------------------------------------------------------- +// QW7 — vector key maps shrink on delete (RED until pruning is implemented) +// --------------------------------------------------------------------------- + +mod qw7 { + use super::*; + use moon::vector::distance; + use moon::vector::store::{IndexMeta, MergeMode, VectorStore}; + use moon::vector::turbo_quant::collection::QuantizationConfig; + use moon::vector::turbo_quant::encoder::padded_dimension; + use moon::vector::types::DistanceMetric; + + fn make_idx(dim: u32) -> IndexMeta { + IndexMeta { + name: Bytes::from_static(b"idx"), + dimension: dim, + padded_dimension: padded_dimension(dim), + metric: DistanceMetric::L2, + hnsw_m: 8, + hnsw_ef_construction: 50, + hnsw_ef_runtime: 0, + compact_threshold: 0, + source_field: Bytes::from_static(b"vec"), + key_prefixes: vec![Bytes::from_static(b"doc:")], + quantization: QuantizationConfig::TurboQuant4, + build_mode: moon::vector::turbo_quant::collection::BuildMode::Light, + vector_fields: Vec::new(), + schema_fields: Vec::new(), + merge_mode: MergeMode::GraphUnion, + keep_raw: false, + } + } + + fn det_vec(dim: usize, seed: u64) -> Vec<f32> { + // Deterministic pseudo-vector; distribution quality is irrelevant here. + (0..dim) + .map(|i| { + let x = seed + .wrapping_mul(6364136223846793005) + .wrapping_add(i as u64); + ((x >> 33) as f32) / (u32::MAX as f32) + }) + .collect() + } + + /// Deleting indexed vectors must shrink the per-index key-hash maps — + /// they track LIVE keys, not historical inserts (review finding 6.3: + /// today there is no `.remove()` call anywhere; the maps grow forever). + #[test] + fn qw7_vector_key_maps_pruned_on_delete() { + distance::init(); + let mut store = VectorStore::new(); + store.create_index(make_idx(64)).unwrap(); + + const TOTAL: usize = 100; + const DELETED: usize = 60; + + for i in 0..TOTAL { + let key = format!("doc:{i}"); + let hash = xxhash_rust::xxh64::xxh64(key.as_bytes(), 0); + store + .insert_vector(b"idx", &det_vec(64, i as u64), hash, Bytes::from(key)) + .unwrap(); + } + assert_eq!( + store.get_index(b"idx").unwrap().key_hash_to_key.len(), + TOTAL, + "sanity: insert populates key_hash_to_key" + ); + + for i in 0..DELETED { + let key = format!("doc:{i}"); + store.mark_deleted_for_key(key.as_bytes()); + } + + let idx = store.get_index(b"idx").unwrap(); + assert_eq!( + idx.key_hash_to_key.len(), + TOTAL - DELETED, + "key_hash_to_key must track live keys only (RED until QW7 pruning lands)" + ); + let deleted_hash = xxhash_rust::xxh64::xxh64(b"doc:0", 0); + assert!( + !idx.key_hash_to_key.contains_key(&deleted_hash), + "deleted key's hash entry must be pruned" + ); + assert!( + !idx.key_hash_to_global_id.contains_key(&deleted_hash), + "deleted key's global-id entry must be pruned" + ); + } +} + +// --------------------------------------------------------------------------- +// QW5 — backlog append golden model (PIN: byte-identical before/after) +// --------------------------------------------------------------------------- + +/// Reference model: the current per-byte semantics, kept in the test so the +/// bulk-copy rewrite can be checked against it step by step. +struct ModelBacklog { + buf: std::collections::VecDeque<u8>, + capacity: usize, + start_offset: u64, + end_offset: u64, +} + +impl ModelBacklog { + fn new(capacity: usize) -> Self { + ModelBacklog { + buf: std::collections::VecDeque::with_capacity(capacity), + capacity, + start_offset: 0, + end_offset: 0, + } + } + fn append(&mut self, data: &[u8]) { + for &b in data { + if self.buf.len() == self.capacity { + self.buf.pop_front(); + self.start_offset += 1; + } + self.buf.push_back(b); + } + self.end_offset += data.len() as u64; + } +} + +#[test] +fn qw5_backlog_append_golden() { + const CAP: usize = 64; + let mut real = ReplicationBacklog::new(CAP); + let mut model = ModelBacklog::new(CAP); + + let sizes = [1usize, CAP / 2, CAP, CAP + 7, 3 * CAP, 0, 5]; + let mut byte: u8 = 0; + for (step, &n) in sizes.iter().enumerate() { + let chunk: Vec<u8> = (0..n) + .map(|_| { + byte = byte.wrapping_add(13); + byte + }) + .collect(); + real.append(&chunk); + model.append(&chunk); + + assert_eq!( + real.start_offset(), + model.start_offset, + "step {step}: start_offset diverged" + ); + assert_eq!( + real.end_offset(), + model.end_offset, + "step {step}: end_offset diverged" + ); + let got = real + .bytes_from(model.start_offset) + .expect("start_offset must be readable"); + let want: Vec<u8> = model.buf.iter().copied().collect(); + assert_eq!(got, want, "step {step}: buffer contents diverged"); + } + + // Range probes across the live window. + let (lo, hi) = (real.start_offset(), real.end_offset()); + for off in [lo, lo + 1, (lo + hi) / 2, hi] { + let got = real.bytes_from(off); + let want = if off >= model.start_offset && off <= model.end_offset { + Some( + model + .buf + .iter() + .copied() + .skip((off - model.start_offset) as usize) + .collect::<Vec<u8>>(), + ) + } else { + None + }; + assert_eq!(got, want, "bytes_from({off}) diverged"); + } + // Evicted and future offsets stay rejected. + assert_eq!(real.bytes_from(lo.wrapping_sub(1)), None, "evicted offset"); + assert_eq!(real.bytes_from(hi + 1), None, "future offset"); +} + +// --------------------------------------------------------------------------- +// QW2 — WAL required-append gates mutation on a full channel (PIN) +// --------------------------------------------------------------------------- + +#[test] +fn qw2_try_wal_append_required_false_on_full() { + use moon::shard::shared_databases::ShardDatabases; + use moon::storage::db::Database; + + let dbs = ShardDatabases::new(vec![vec![Database::new()]]); + + // Persistence disabled -> no durability requirement -> true. + assert!( + dbs.try_wal_append_required(0, Bytes::from_static(b"x")), + "no WAL configured: append must report success (no durability requirement)" + ); + + // Bounded(1) channel, never drained: first append fills it, second must + // be refused — the caller-visible gate that prevents un-journaled mutation + // (Reject: durability_contract_broken). + let (tx, _rx) = moon::runtime::channel::mpsc_bounded::<Bytes>(1); + dbs.set_wal_append_tx(0, tx); + + assert!( + dbs.try_wal_append_required(0, Bytes::from_static(b"a")), + "first append fits the bounded(1) channel" + ); + assert!( + !dbs.try_wal_append_required(0, Bytes::from_static(b"b")), + "full WAL channel must report false so the caller skips the mutation" + ); + + // Fire-and-forget variant must not panic on a full channel. + dbs.wal_append(0, Bytes::from_static(b"c")); +} + +// --------------------------------------------------------------------------- +// QW3 — replication offset arithmetic exact under concurrency (PIN) +// --------------------------------------------------------------------------- + +#[test] +fn qw3_replication_offsets_exact() { + use std::sync::Arc; + + const SHARDS: usize = 4; + const WRITES_PER_SHARD: u64 = 1_000; + const DELTA: u64 = 17; + + let state = Arc::new(ReplicationState::new( + SHARDS, + "a".repeat(40), + "b".repeat(40), + )); + + let handles: Vec<_> = (0..SHARDS) + .map(|shard| { + let st = Arc::clone(&state); + std::thread::spawn(move || { + for _ in 0..WRITES_PER_SHARD { + st.increment_shard_offset(shard, DELTA); + } + }) + }) + .collect(); + for h in handles { + h.join().unwrap(); + } + + for shard in 0..SHARDS { + assert_eq!( + state.shard_offset(shard), + WRITES_PER_SHARD * DELTA, + "shard {shard} offset must equal exact byte total" + ); + } + assert_eq!( + state.total_offset(), + SHARDS as u64 * WRITES_PER_SHARD * DELTA, + "master_repl_offset must equal the sum of all shard writes" + ); +} + +// --------------------------------------------------------------------------- +// QW4 — bespoke INFO command counter exact under concurrency (PIN) +// --------------------------------------------------------------------------- + +#[test] +fn qw4_total_commands_exact() { + use moon::admin::metrics_setup; + + const THREADS: usize = 4; + const PER_THREAD: u64 = 5_000; + + let before = metrics_setup::total_commands_processed(); + let handles: Vec<_> = (0..THREADS) + .map(|_| { + std::thread::spawn(|| { + for i in 0..PER_THREAD { + if i % 2 == 0 { + metrics_setup::record_command_no_latency("set"); + } else { + metrics_setup::record_command("get", 1); + } + } + }) + }) + .collect(); + for h in handles { + h.join().unwrap(); + } + let after = metrics_setup::total_commands_processed(); + + assert_eq!( + after - before, + THREADS as u64 * PER_THREAD, + "INFO total_commands_processed must stay exact (no lost or double counts)" + ); +} diff --git a/tests/quickwins_red_api.rs b/tests/quickwins_red_api.rs new file mode 100644 index 000000000..f3007c55e --- /dev/null +++ b/tests/quickwins_red_api.rs @@ -0,0 +1,60 @@ +//! ADD task `hotpath-lock-quickwins` — new-API red tests. +//! +//! This file is COMPILE-RED until the build lands: it references the small +//! public surfaces the contract introduces. Each test is behavior-level once +//! the symbol exists. Kept separate from `quickwins_red.rs` so the runtime +//! suite stays runnable during the red phase: +//! cargo test --test quickwins_red # runs (1 red, 4 pins) +//! cargo test --test quickwins_red_api # compile error = red, by design + +use std::net::{TcpListener, TcpStream}; + +// --------------------------------------------------------------------------- +// QW1 — every accepted client socket gets TCP_NODELAY (+ shared accept opts) +// --------------------------------------------------------------------------- + +/// The accept paths (tokio + uring register) funnel socket options through one +/// helper; applying it to an accepted fd must enable TCP_NODELAY. +#[test] +fn qw1_accepted_socket_has_nodelay() { + let listener = TcpListener::bind("127.0.0.1:0").unwrap(); + let addr = listener.local_addr().unwrap(); + let _client = TcpStream::connect(addr).unwrap(); + let (accepted, _) = listener.accept().unwrap(); + + // Fresh accepted socket: Nagle is on by default (sanity). + assert!( + !accepted.nodelay().unwrap(), + "sanity: OS default leaves Nagle enabled" + ); + + moon::server::socket_opts::apply_client_socket_opts(&accepted) + .expect("applying client socket opts must succeed"); + + assert!( + accepted.nodelay().unwrap(), + "QW1: accepted client sockets must have TCP_NODELAY set" + ); +} + +// --------------------------------------------------------------------------- +// QW3 — replication offsets reachable WITHOUT locking ReplicationState +// --------------------------------------------------------------------------- + +/// The write path receives an `OffsetHandle` at startup and advances offsets +/// through it; the `RwLock<ReplicationState>` is no longer touched per write. +/// Handle and state must observe the same totals. +#[test] +fn qw3_offset_handle_advances_without_state_lock() { + use moon::replication::state::ReplicationState; + + let state = ReplicationState::new(2, "a".repeat(40), "b".repeat(40)); + let handle = state.offset_handle(); + + handle.issue_lsn(0, 100); + handle.issue_lsn(1, 50); + + assert_eq!(state.shard_offset(0), 100); + assert_eq!(state.shard_offset(1), 50); + assert_eq!(state.total_offset(), 150); +} From ddcb6bc44e5f53dee6bc4386862d81b412b0cb3e Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 11:08:56 +0700 Subject: [PATCH 03/12] perf(server): eliminate per-command global locks + accept-path quick wins MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Implements the 8-item quick-wins batch from the 2026-06 architecture review (priority 5) — every change behavior-preserving, parity pinned by tests/quickwins_red.rs: - QW1 TCP_NODELAY on every accepted client socket. New server::socket_opts::apply_client_socket_opts helper; wired into the shared tokio/monoio accept-opts hook (extends the existing SAFETY-commented BorrowedFd block - no new unsafe), the uring register path, and the multishot-accept LISTENER (Linux copies the nonagle flag to accepted sockets; raw CQE fds have no safe hook). Redis defaults tcp-nodelay yes; we never set it (finding 3.2). - QW2 WAL sender Mutex<Option<Sender>> -> OnceLock: set once before accept, lock-free per-write reads; try_wal_append_required false-on-full durability gate unchanged (finding 1.8). - QW3 replication offsets: shard_offsets/master_repl_offset Arc'd and distributed as a lock-free OffsetHandle at event-loop startup; the SPSC drain no longer read-locks RwLock<ReplicationState> per write (finding 1.4). The repl_state param in wal_append_and_fanout and the drain chain now carries the handle. - QW4 TOTAL_COMMANDS: single global AtomicU64 (one cache line bounced across all shard cores per command) -> 64 padded per-thread slots, exact sum on INFO/stats reads (finding 1.6). - QW5 ReplicationBacklog::append: per-byte eviction loop -> bulk drain+extend; state machine byte-identical (golden-tested), the same buffer that cost ~21% CPU on 8-shard SET p=64 (finding 1.5). - QW6 uring inflight_sends: Vec::remove(0) per SendComplete CQE -> VecDeque::pop_front, O(1) FIFO reclaim (finding 3.6). - QW7 vector key_hash_to_key / key_hash_to_global_id pruned in mark_deleted_for_key - maps now track live keys, not historical inserts (finding 6.3: unbounded growth under key churn). - QW8 client registry: per-pipeline-batch global write lock and per-batch is_killed read lock -> lock-free Arc<ClientLiveState> handle (db/last_cmd/flags/kill_flag atomics) returned by register(); CLIENT LIST/INFO/KILL semantics unchanged (finding 1.3). Verified: quickwins suites 7/7 green, lib 3566 green, tokio+jemalloc matrix 2945 green, clippy -D warnings clean on both feature sets. Task: .add/tasks/hotpath-lock-quickwins author: Tin Dang --- src/admin/metrics_setup.rs | 53 ++++++-- src/client_registry.rs | 129 +++++++++++++++----- src/replication/backlog.rs | 24 +++- src/replication/state.rs | 52 +++++++- src/server/conn/handler_monoio/dispatch.rs | 23 ++-- src/server/conn/handler_monoio/mod.rs | 20 +-- src/server/conn/handler_sharded/dispatch.rs | 23 ++-- src/server/conn/handler_sharded/mod.rs | 20 +-- src/server/mod.rs | 1 + src/server/socket_opts.rs | 29 +++++ src/shard/conn_accept.rs | 21 ++-- src/shard/event_loop.rs | 23 ++-- src/shard/shared_databases.rs | 23 ++-- src/shard/spsc_handler.rs | 19 ++- src/shard/uring_handler.rs | 13 +- src/vector/store.rs | 8 +- 16 files changed, 357 insertions(+), 124 deletions(-) create mode 100644 src/server/socket_opts.rs diff --git a/src/admin/metrics_setup.rs b/src/admin/metrics_setup.rs index c7e062fed..c41ae3198 100644 --- a/src/admin/metrics_setup.rs +++ b/src/admin/metrics_setup.rs @@ -23,10 +23,49 @@ pub fn is_server_ready() -> bool { // ── Lightweight atomic counters for INFO ──────────────────────────────── // These counters work even when the Prometheus exporter is disabled // (admin_port=0), so INFO always returns meaningful stats. -static TOTAL_COMMANDS: AtomicU64 = AtomicU64::new(0); static TOTAL_CONNECTIONS: AtomicU64 = AtomicU64::new(0); static CONNECTED_CLIENTS: AtomicU64 = AtomicU64::new(0); +// ── QW4 (2026-06 review finding 1.6): sharded total-commands counter ──── +// Previously a single `TOTAL_COMMANDS: AtomicU64` — one cache line bounced +// across every shard core at full command rate (false sharing). Each OS +// thread takes a padded slot (round-robin at first use); increments touch +// only that thread's line. Readers (INFO, server_stats tick) sum all slots; +// the sum is exact — every increment lands in exactly one slot. +const COMMAND_COUNTER_SLOTS: usize = 64; + +#[repr(align(64))] +struct PaddedCounter(AtomicU64); + +#[allow(clippy::declare_interior_mutable_const)] // template for static array init only +const PADDED_COUNTER_ZERO: PaddedCounter = PaddedCounter(AtomicU64::new(0)); +static COMMAND_COUNTERS: [PaddedCounter; COMMAND_COUNTER_SLOTS] = + [PADDED_COUNTER_ZERO; COMMAND_COUNTER_SLOTS]; +static NEXT_COMMAND_COUNTER_SLOT: AtomicU64 = AtomicU64::new(0); + +thread_local! { + static COMMAND_COUNTER_SLOT: usize = + (NEXT_COMMAND_COUNTER_SLOT.fetch_add(1, Ordering::Relaxed) as usize) + % COMMAND_COUNTER_SLOTS; +} + +/// Increment this thread's slot of the sharded total-commands counter. +#[inline] +fn bump_total_commands() { + COMMAND_COUNTER_SLOT.with(|&slot| { + COMMAND_COUNTERS[slot].0.fetch_add(1, Ordering::Relaxed); + }); +} + +/// Exact sum across all counter slots. O(64) loads — read paths only +/// (INFO, the 1s server_stats tick), never the command hot path. +fn total_commands_sum() -> u64 { + COMMAND_COUNTERS + .iter() + .map(|c| c.0.load(Ordering::Relaxed)) + .sum() +} + // ── P6: WAL aggressive reclamation counters (read by P10 INFO emitter) ─── // Incremented by WalWriterV3::recycle_aggressive(). P10 reads these via the // public getters below to populate the `# Reclamation` INFO section. @@ -398,7 +437,7 @@ fn sanitize_cmd_label(cmd: &str) -> &'static str { /// Record a command execution. #[inline] pub fn record_command(cmd: &str, latency_us: u64) { - TOTAL_COMMANDS.fetch_add(1, Ordering::Relaxed); + bump_total_commands(); if !METRICS_INITIALIZED.load(Ordering::Relaxed) { return; } @@ -415,7 +454,7 @@ pub fn record_command(cmd: &str, latency_us: u64) { /// would otherwise bias the distribution with a zero value. #[inline] pub fn record_command_no_latency(cmd: &str) { - TOTAL_COMMANDS.fetch_add(1, Ordering::Relaxed); + bump_total_commands(); if !METRICS_INITIALIZED.load(Ordering::Relaxed) { return; } @@ -495,7 +534,7 @@ impl CachedMetricsHandles { /// recorder-backend DashMap lookup on cache hit. #[inline] pub fn record_command_cached(cmd: &str, latency_us: u64, cache: &mut CachedMetricsHandles) { - TOTAL_COMMANDS.fetch_add(1, Ordering::Relaxed); + bump_total_commands(); if !METRICS_INITIALIZED.load(Ordering::Relaxed) { return; } @@ -509,7 +548,7 @@ pub fn record_command_cached(cmd: &str, latency_us: u64, cache: &mut CachedMetri /// the recorder-backend DashMap lookup on cache hit. #[inline] pub fn record_command_no_latency_cached(cmd: &str, cache: &mut CachedMetricsHandles) { - TOTAL_COMMANDS.fetch_add(1, Ordering::Relaxed); + bump_total_commands(); if !METRICS_INITIALIZED.load(Ordering::Relaxed) { return; } @@ -1080,7 +1119,7 @@ pub fn get_rss_bytes() -> u64 { /// Total commands processed since server start (for INFO Stats). #[inline] pub fn total_commands_processed() -> u64 { - TOTAL_COMMANDS.load(Ordering::Relaxed) + total_commands_sum() } /// Total connections received since server start (for INFO Stats). @@ -1259,7 +1298,7 @@ pub fn spawn_metrics_publisher() { None => continue, }; - let total_ops = TOTAL_COMMANDS.load(Ordering::Relaxed); + let total_ops = total_commands_sum(); let ops_per_sec = total_ops.saturating_sub(prev_ops); prev_ops = total_ops; diff --git a/src/client_registry.rs b/src/client_registry.rs index 0d71ec571..c091997e4 100644 --- a/src/client_registry.rs +++ b/src/client_registry.rs @@ -1,32 +1,63 @@ //! Global client connection registry for CLIENT LIST/INFO/KILL. //! //! Every connection registers on accept and deregisters on close. -//! The registry is a global `parking_lot::RwLock<HashMap>` — not on -//! the command hot path (only touched on connect/disconnect and CLIENT commands). +//! The registry is a global `parking_lot::RwLock<HashMap>` touched only on +//! connect/disconnect and CLIENT commands. Per-batch state (db, idle time, +//! flags, kill checks) flows through the lock-free [`ClientLiveState`] handle +//! that `register` returns (QW8, 2026-06 review finding 1.3 — previously the +//! steady-state loop took the global write lock after every pipeline batch +//! and the global read lock for every kill check). use parking_lot::RwLock; use std::collections::HashMap; -use std::sync::LazyLock; -use std::sync::atomic::{AtomicBool, Ordering}; +use std::sync::atomic::{AtomicBool, AtomicU8, AtomicU64, AtomicUsize, Ordering}; +use std::sync::{Arc, LazyLock}; use std::time::Instant; /// Global client registry. static REGISTRY: LazyLock<RwLock<HashMap<u64, ClientEntry>>> = LazyLock::new(|| RwLock::new(HashMap::new())); +/// Lock-free per-connection state, shared between the connection task +/// (writer, once per batch) and CLIENT LIST/INFO/KILL (occasional readers). +pub struct ClientLiveState { + pub connected_at: Instant, + pub db: AtomicUsize, + /// Milliseconds since `connected_at` of the last completed batch. + pub last_cmd_ms: AtomicU64, + /// Bit-packed [`ClientFlags`] (see `ClientFlags::to_bits`). + pub flags: AtomicU8, + /// Set by CLIENT KILL — the handler checks this and closes the connection. + pub kill_flag: AtomicBool, +} + +impl ClientLiveState { + /// Record batch-completion state. Three relaxed stores — no lock. + #[inline] + pub fn touch(&self, db: usize, flags: ClientFlags) { + self.db.store(db, Ordering::Relaxed); + self.last_cmd_ms.store( + self.connected_at.elapsed().as_millis() as u64, + Ordering::Relaxed, + ); + self.flags.store(flags.to_bits(), Ordering::Relaxed); + } + + /// Lock-free CLIENT KILL check for the connection's own loop. + #[inline] + pub fn is_killed(&self) -> bool { + self.kill_flag.load(Ordering::Relaxed) + } +} + /// Information about a connected client. pub struct ClientEntry { pub id: u64, pub addr: String, pub name: Option<String>, pub user: String, - pub db: usize, pub shard: usize, - pub flags: ClientFlags, - pub connected_at: Instant, - pub last_cmd_at: Instant, - /// Set by CLIENT KILL — handler checks this and closes the connection. - pub kill_flag: AtomicBool, + pub live: Arc<ClientLiveState>, } /// Client connection flags (matches Redis CLIENT LIST flag characters). @@ -50,24 +81,46 @@ impl ClientFlags { "N" } } + + /// Pack into one byte for `ClientLiveState::flags`. + #[inline] + pub fn to_bits(self) -> u8 { + (self.subscriber as u8) | ((self.in_multi as u8) << 1) | ((self.blocked as u8) << 2) + } + + /// Unpack from `ClientLiveState::flags`. + #[inline] + pub fn from_bits(bits: u8) -> Self { + ClientFlags { + subscriber: bits & 1 != 0, + in_multi: bits & 2 != 0, + blocked: bits & 4 != 0, + } + } } /// Register a new client connection. -pub fn register(id: u64, addr: String, user: String, shard: usize) { - let now = Instant::now(); +/// +/// Returns the connection's lock-free live-state handle; the connection task +/// keeps it for per-batch `touch()` and `is_killed()` without the registry lock. +pub fn register(id: u64, addr: String, user: String, shard: usize) -> Arc<ClientLiveState> { + let live = Arc::new(ClientLiveState { + connected_at: Instant::now(), + db: AtomicUsize::new(0), + last_cmd_ms: AtomicU64::new(0), + flags: AtomicU8::new(ClientFlags::default().to_bits()), + kill_flag: AtomicBool::new(false), + }); let entry = ClientEntry { id, addr, name: None, user, - db: 0, shard, - flags: ClientFlags::default(), - connected_at: now, - last_cmd_at: now, - kill_flag: AtomicBool::new(false), + live: Arc::clone(&live), }; REGISTRY.write().insert(id, entry); + live } /// Deregister a client connection. @@ -75,7 +128,9 @@ pub fn deregister(id: u64) { REGISTRY.write().remove(&id); } -/// Update mutable fields for a client (called periodically or on state change). +/// Update mutable fields for a client (CLIENT SETNAME and similar — rare, +/// never the steady-state batch loop; batch state goes through the +/// [`ClientLiveState`] handle instead). pub fn update<F: FnOnce(&mut ClientEntry)>(id: u64, f: F) { if let Some(entry) = REGISTRY.write().get_mut(&id) { f(entry); @@ -83,11 +138,11 @@ pub fn update<F: FnOnce(&mut ClientEntry)>(id: u64, f: F) { } /// Check if a client has been marked for killing. +/// +/// Registry-lookup variant for code without the live handle; connection +/// loops use `ClientLiveState::is_killed` (lock-free) instead. pub fn is_killed(id: u64) -> bool { - REGISTRY - .read() - .get(&id) - .is_some_and(|e| e.kill_flag.load(Ordering::Relaxed)) + REGISTRY.read().get(&id).is_some_and(|e| e.live.is_killed()) } /// Format all clients as a CLIENT LIST string. @@ -133,7 +188,7 @@ pub fn kill_clients(filter: &KillFilter) -> u64 { KillFilter::User(user) => entry.user == *user, }; if matches { - entry.kill_flag.store(true, Ordering::Relaxed); + entry.live.kill_flag.store(true, Ordering::Relaxed); count += 1; } } @@ -183,16 +238,19 @@ pub fn parse_kill_args(args: &[&[u8]]) -> Option<KillFilter> { fn format_client_line(buf: &mut String, entry: &ClientEntry, now: Instant) { use std::fmt::Write; - let age = now.duration_since(entry.connected_at).as_secs(); - let idle = now.duration_since(entry.last_cmd_at).as_secs(); + let live = &*entry.live; + let age = now.duration_since(live.connected_at).as_secs(); + let last_cmd_secs = live.last_cmd_ms.load(Ordering::Relaxed) / 1000; + let idle = age.saturating_sub(last_cmd_secs); let name = entry.name.as_deref().unwrap_or(""); - let flags = entry.flags.to_flag_str(); + let flags = ClientFlags::from_bits(live.flags.load(Ordering::Relaxed)).to_flag_str(); + let db = live.db.load(Ordering::Relaxed); let _ = writeln!( buf, "id={} addr={} fd=0 name={} db={} sub=0 psub=0 ssub=0 multi=-1 \ watch=0 qbuf=0 qbuf-free=0 argv-mem=0 tot-mem=0 net-i=0 net-o=0 \ age={} idle={} flags={} user={}", - entry.id, entry.addr, name, entry.db, age, idle, flags, entry.user, + entry.id, entry.addr, name, db, age, idle, flags, entry.user, ); } @@ -227,11 +285,13 @@ mod tests { #[test] fn test_kill_by_id() { let id = 999_002; - register(id, "10.0.0.2:6000".into(), "bob".into(), 0); + let live = register(id, "10.0.0.2:6000".into(), "bob".into(), 0); assert!(!is_killed(id)); + assert!(!live.is_killed()); let count = kill_clients(&KillFilter::Id(id)); assert_eq!(count, 1); assert!(is_killed(id)); + assert!(live.is_killed(), "live handle observes the kill lock-free"); deregister(id); } @@ -250,19 +310,26 @@ mod tests { } #[test] - fn test_update() { + fn test_update_and_touch() { let id = 999_003; - register(id, "10.0.0.5:8000".into(), "default".into(), 0); + let live = register(id, "10.0.0.5:8000".into(), "default".into(), 0); update(id, |e| { e.name = Some("myconn".into()); - e.db = 3; }); + live.touch(3, ClientFlags::default()); let info = client_info(id).unwrap(); assert!(info.contains("name=myconn")); assert!(info.contains("db=3")); deregister(id); } + #[test] + fn test_flags_bits_roundtrip() { + for bits in 0..8u8 { + assert_eq!(ClientFlags::from_bits(bits).to_bits(), bits); + } + } + #[test] fn test_parse_kill_args() { let args: Vec<&[u8]> = vec![b"ID", b"42"]; diff --git a/src/replication/backlog.rs b/src/replication/backlog.rs index 7209a86e3..af5221352 100644 --- a/src/replication/backlog.rs +++ b/src/replication/backlog.rs @@ -31,15 +31,27 @@ impl ReplicationBacklog { } /// Append bytes to the backlog. Evicts oldest bytes when at capacity. + /// + /// Bulk-copy implementation (QW5, 2026-06 review finding 1.5): one drain + /// + one extend instead of a per-byte eviction loop. State machine is + /// identical to the per-byte version — the live window is always the last + /// `capacity` bytes ever appended, and `start_offset` maintains the + /// invariant `start_offset = end_offset - buf.len()`. pub fn append(&mut self, data: &[u8]) { - for &b in data { - if self.buf.len() == self.capacity { - self.buf.pop_front(); - self.start_offset += 1; + self.end_offset += data.len() as u64; + if data.len() >= self.capacity { + // The live window comes entirely from the tail of `data`. + self.buf.clear(); + self.buf + .extend(data[data.len() - self.capacity..].iter().copied()); + } else { + let overflow = (self.buf.len() + data.len()).saturating_sub(self.capacity); + if overflow > 0 { + self.buf.drain(..overflow); } - self.buf.push_back(b); + self.buf.extend(data.iter().copied()); } - self.end_offset += data.len() as u64; + self.start_offset = self.end_offset - self.buf.len() as u64; } /// Returns owned Vec of bytes from `offset` to end_offset, or None if offset was evicted. diff --git a/src/replication/state.rs b/src/replication/state.rs index a9b57317d..f75ec32de 100644 --- a/src/replication/state.rs +++ b/src/replication/state.rs @@ -14,10 +14,13 @@ pub struct ReplicationState { /// Secondary replication ID (previous master's ID). Used after failover. pub repl_id2: String, /// Per-shard write offset (monotonic bytes appended, NEVER resets on WAL truncation). - /// Length = num_shards. - pub shard_offsets: Vec<AtomicU64>, + /// Length = num_shards. Arc'd so `offset_handle()` can hand shards a + /// lock-free clone — the per-write advance must never take the + /// surrounding `RwLock` (QW3, 2026-06 review). + pub shard_offsets: Arc<[AtomicU64]>, /// Sum of all shard offsets -- global master replication offset. - pub master_repl_offset: AtomicU64, + /// Arc'd for the same lock-free `offset_handle()` distribution. + pub master_repl_offset: Arc<AtomicU64>, /// Connected replicas (master mode). Guarded by Arc<RwLock<ReplicationState>> callers. pub replicas: Vec<ReplicaInfo>, /// Per-shard replication backlogs, shared between the shard event loop @@ -59,7 +62,7 @@ impl ReplicationState { repl_id, repl_id2, shard_offsets: (0..num_shards).map(|_| AtomicU64::new(0)).collect(), - master_repl_offset: AtomicU64::new(0), + master_repl_offset: Arc::new(AtomicU64::new(0)), replicas: Vec::new(), per_shard_backlogs: (0..num_shards) .map(|_| Arc::new(parking_lot::Mutex::new(None))) @@ -172,6 +175,47 @@ impl ReplicationState { .map(|o| o.load(Ordering::Relaxed)) .unwrap_or(0) } + + /// Clone out a lock-free handle to the offset atomics. + /// + /// Called once per shard at event-loop startup; the handle is what the + /// per-write path uses, so `RwLock<ReplicationState>` is never read-locked + /// per write (QW3, 2026-06 review finding 1.4). + pub fn offset_handle(&self) -> OffsetHandle { + OffsetHandle { + shard_offsets: Arc::clone(&self.shard_offsets), + master_repl_offset: Arc::clone(&self.master_repl_offset), + } + } +} + +/// Lock-free handle to the replication offset atomics, distributed to each +/// shard at startup via [`ReplicationState::offset_handle`]. Advancing +/// offsets through this handle is equivalent to `ReplicationState::issue_lsn` +/// — both operate on the same `Arc`'d atomics. +#[derive(Clone)] +pub struct OffsetHandle { + shard_offsets: Arc<[AtomicU64]>, + master_repl_offset: Arc<AtomicU64>, +} + +impl OffsetHandle { + /// See [`ReplicationState::issue_lsn`] — same semantics, same atomics, + /// no surrounding lock. + #[inline] + pub fn issue_lsn(&self, shard_id: usize, delta: u64) -> u64 { + if shard_id >= self.shard_offsets.len() { + return 0; + } + self.shard_offsets[shard_id].fetch_add(delta, Ordering::Relaxed); + self.master_repl_offset.fetch_add(delta, Ordering::Relaxed) + } + + /// See [`ReplicationState::increment_shard_offset`]. + #[inline] + pub fn increment_shard_offset(&self, shard_id: usize, delta: u64) { + let _ = self.issue_lsn(shard_id, delta); + } } const ZEROED_ID: &str = "0000000000000000000000000000000000000000"; diff --git a/src/server/conn/handler_monoio/dispatch.rs b/src/server/conn/handler_monoio/dispatch.rs index 64c76415f..042558554 100644 --- a/src/server/conn/handler_monoio/dispatch.rs +++ b/src/server/conn/handler_monoio/dispatch.rs @@ -852,13 +852,14 @@ pub(super) fn try_handle_client_admin( if let Some(sub_bytes) = extract_bytes(sub) { if sub_bytes.eq_ignore_ascii_case(b"LIST") { crate::client_registry::update(client_id, |e| { - e.db = conn.selected_db; - e.last_cmd_at = std::time::Instant::now(); - e.flags = crate::client_registry::ClientFlags { - subscriber: conn.subscription_count > 0, - in_multi: conn.in_multi, - blocked: false, - }; + e.live.touch( + conn.selected_db, + crate::client_registry::ClientFlags { + subscriber: conn.subscription_count > 0, + in_multi: conn.in_multi, + blocked: false, + }, + ); }); let list = crate::client_registry::client_list(); responses.push(Frame::BulkString(Bytes::from(list))); @@ -866,8 +867,12 @@ pub(super) fn try_handle_client_admin( } if sub_bytes.eq_ignore_ascii_case(b"INFO") { crate::client_registry::update(client_id, |e| { - e.db = conn.selected_db; - e.last_cmd_at = std::time::Instant::now(); + e.live.touch( + conn.selected_db, + crate::client_registry::ClientFlags::from_bits( + e.live.flags.load(std::sync::atomic::Ordering::Relaxed), + ), + ); }); let info = crate::client_registry::client_info(client_id).unwrap_or_default(); responses.push(Frame::BulkString(Bytes::from(info))); diff --git a/src/server/conn/handler_monoio/mod.rs b/src/server/conn/handler_monoio/mod.rs index f895daece..f89b39f5c 100644 --- a/src/server/conn/handler_monoio/mod.rs +++ b/src/server/conn/handler_monoio/mod.rs @@ -153,7 +153,7 @@ pub(crate) async fn handle_connection_sharded_monoio< let db_count = ctx.shard_databases.db_count(); // Register in global client registry for CLIENT LIST/INFO/KILL. - crate::client_registry::register( + let client_live = crate::client_registry::register( client_id, peer_addr.clone(), conn.current_user.clone(), @@ -196,8 +196,8 @@ pub(crate) async fn handle_connection_sharded_monoio< let mut frames: Vec<Frame> = Vec::with_capacity(64); loop { - // Check if CLIENT KILL targeted this connection - if crate::client_registry::is_killed(client_id) { + // Check if CLIENT KILL targeted this connection (lock-free, QW8) + if client_live.is_killed() { break; } @@ -2116,16 +2116,16 @@ pub(crate) async fn handle_connection_sharded_monoio< } } - // Update registry with current state after each batch - crate::client_registry::update(client_id, |e| { - e.db = conn.selected_db; - e.last_cmd_at = std::time::Instant::now(); - e.flags = crate::client_registry::ClientFlags { + // Update live state after each batch — lock-free (QW8, 2026-06 + // review: this was a global registry write lock per batch). + client_live.touch( + conn.selected_db, + crate::client_registry::ClientFlags { subscriber: conn.subscription_count > 0, in_multi: conn.in_multi, blocked: false, - }; - }); + }, + ); // Check if migration was triggered during frame processing. // All responses for the current batch have been written, so the diff --git a/src/server/conn/handler_sharded/dispatch.rs b/src/server/conn/handler_sharded/dispatch.rs index 928b8ac5a..1bb6c15e8 100644 --- a/src/server/conn/handler_sharded/dispatch.rs +++ b/src/server/conn/handler_sharded/dispatch.rs @@ -105,13 +105,14 @@ pub(super) fn try_handle_client_command( if sub_bytes.eq_ignore_ascii_case(b"LIST") { // Update our own entry before listing crate::client_registry::update(client_id, |e| { - e.db = conn.selected_db; - e.last_cmd_at = std::time::Instant::now(); - e.flags = crate::client_registry::ClientFlags { - subscriber: conn.subscription_count > 0, - in_multi: conn.in_multi, - blocked: false, - }; + e.live.touch( + conn.selected_db, + crate::client_registry::ClientFlags { + subscriber: conn.subscription_count > 0, + in_multi: conn.in_multi, + blocked: false, + }, + ); }); let list = crate::client_registry::client_list(); responses.push(Frame::BulkString(Bytes::from(list))); @@ -119,8 +120,12 @@ pub(super) fn try_handle_client_command( } if sub_bytes.eq_ignore_ascii_case(b"INFO") { crate::client_registry::update(client_id, |e| { - e.db = conn.selected_db; - e.last_cmd_at = std::time::Instant::now(); + e.live.touch( + conn.selected_db, + crate::client_registry::ClientFlags::from_bits( + e.live.flags.load(std::sync::atomic::Ordering::Relaxed), + ), + ); }); let info = crate::client_registry::client_info(client_id).unwrap_or_default(); responses.push(Frame::BulkString(Bytes::from(info))); diff --git a/src/server/conn/handler_sharded/mod.rs b/src/server/conn/handler_sharded/mod.rs index f32bd60ac..7bcf2241b 100644 --- a/src/server/conn/handler_sharded/mod.rs +++ b/src/server/conn/handler_sharded/mod.rs @@ -257,7 +257,7 @@ pub(crate) async fn handle_connection_sharded_inner< // Register in global client registry for CLIENT LIST/INFO/KILL. // RegistryGuard ensures deregister on all exit paths (including early returns). - crate::client_registry::register( + let client_live = crate::client_registry::register( client_id, peer_addr.clone(), conn.current_user.clone(), @@ -293,8 +293,8 @@ pub(crate) async fn handle_connection_sharded_inner< let mut break_outer = false; loop { - // Check if CLIENT KILL targeted this connection - if crate::client_registry::is_killed(client_id) { + // Check if CLIENT KILL targeted this connection (lock-free, QW8) + if client_live.is_killed() { break; } @@ -1864,16 +1864,16 @@ pub(crate) async fn handle_connection_sharded_inner< return (HandlerResult::Done, None); } - // Update registry with current state after each batch - crate::client_registry::update(client_id, |e| { - e.db = conn.selected_db; - e.last_cmd_at = std::time::Instant::now(); - e.flags = crate::client_registry::ClientFlags { + // Update live state after each batch — lock-free (QW8, 2026-06 + // review: this was a global registry write lock per batch). + client_live.touch( + conn.selected_db, + crate::client_registry::ClientFlags { subscriber: conn.subscription_count > 0, in_multi: conn.in_multi, blocked: false, - }; - }); + }, + ); // Check if migration was triggered during frame processing. // All responses for the current batch have been written, so the diff --git a/src/server/mod.rs b/src/server/mod.rs index 2ef4eadfb..cb601f6a0 100644 --- a/src/server/mod.rs +++ b/src/server/mod.rs @@ -7,6 +7,7 @@ pub mod expiration; pub mod listener; pub mod response_slot; pub mod shutdown; +pub mod socket_opts; // Backward-compatible re-export: callers using crate::server::connection::* still work pub mod connection { diff --git a/src/server/socket_opts.rs b/src/server/socket_opts.rs new file mode 100644 index 000000000..0482a986b --- /dev/null +++ b/src/server/socket_opts.rs @@ -0,0 +1,29 @@ +//! Socket options applied to accepted client connections. + +/// Enable TCP_NODELAY on an accepted client socket (QW1, 2026-06 review +/// finding 3.2). Redis defaults to `tcp-nodelay yes`; without it Nagle can +/// hold pipelined responses in the kernel send buffer for a delayed-ACK +/// window, turning sub-millisecond operations into ~40ms latency spikes. +/// +/// Generic over anything exposing the socket fd (`std`/`tokio` `TcpStream`, +/// `BorrowedFd` from the monoio/uring accept paths). +#[cfg(unix)] +pub fn apply_client_socket_opts<S: std::os::fd::AsFd>(sock: &S) -> std::io::Result<()> { + let sock_ref = socket2::SockRef::from(sock); + sock_ref.set_tcp_nodelay(true) +} + +#[cfg(test)] +mod tests { + #[test] + #[cfg(unix)] + fn sets_nodelay_on_accepted_socket() { + let listener = std::net::TcpListener::bind("127.0.0.1:0").unwrap(); + let addr = listener.local_addr().unwrap(); + let _client = std::net::TcpStream::connect(addr).unwrap(); + let (accepted, _) = listener.accept().unwrap(); + assert!(!accepted.nodelay().unwrap()); + super::apply_client_socket_opts(&accepted).unwrap(); + assert!(accepted.nodelay().unwrap()); + } +} diff --git a/src/shard/conn_accept.rs b/src/shard/conn_accept.rs index 7ccad7fdb..434968b4f 100644 --- a/src/shard/conn_accept.rs +++ b/src/shard/conn_accept.rs @@ -73,19 +73,22 @@ fn take_migration_read_buf(state: &mut MigratedConnectionState) -> BytesMut { std::mem::take(&mut state.read_buf_remainder) } -/// Set TCP keepalive on a raw file descriptor. +/// Apply per-connection socket options on a raw file descriptor. /// -/// Sets SO_KEEPALIVE and TCP_KEEPIDLE (Linux) / TCP_KEEPALIVE (macOS) to detect -/// dead connections. Called once per accepted socket. +/// TCP_NODELAY always (QW1 — Redis defaults `tcp-nodelay yes`; Nagle holds +/// pipelined responses for a delayed-ACK window otherwise), plus SO_KEEPALIVE +/// with TCP_KEEPIDLE (Linux) / TCP_KEEPALIVE (macOS) to detect dead +/// connections when `keepalive_secs > 0`. Called once per accepted socket. #[cfg(unix)] -fn set_tcp_keepalive(fd: std::os::unix::io::RawFd, keepalive_secs: u64) { - if keepalive_secs == 0 { - return; - } +fn apply_accepted_socket_opts(fd: std::os::unix::io::RawFd, keepalive_secs: u64) { use std::os::unix::io::BorrowedFd; // SAFETY: fd is a valid open socket owned by the caller. We borrow it // for the duration of this function — SockRef does not close on drop. let borrowed = unsafe { BorrowedFd::borrow_raw(fd) }; + let _ = crate::server::socket_opts::apply_client_socket_opts(&borrowed); + if keepalive_secs == 0 { + return; + } let sock = socket2::SockRef::from(&borrowed); let interval = std::cmp::max(keepalive_secs / 3, 1); let ka = socket2::TcpKeepalive::new() @@ -180,7 +183,7 @@ pub(crate) fn spawn_tokio_connection( { use std::os::unix::io::AsRawFd; let tcp_keepalive_secs = rtcfg.read().tcp_keepalive; - set_tcp_keepalive(tcp_stream.as_raw_fd(), tcp_keepalive_secs); + apply_accepted_socket_opts(tcp_stream.as_raw_fd(), tcp_keepalive_secs); } // Construct ConnectionContext from cloned shared state. The pool is @@ -485,7 +488,7 @@ pub(crate) fn spawn_monoio_connection( { use std::os::unix::io::AsRawFd; let keepalive_secs = runtime_config.read().tcp_keepalive; - set_tcp_keepalive(std_tcp_stream.as_raw_fd(), keepalive_secs); + apply_accepted_socket_opts(std_tcp_stream.as_raw_fd(), keepalive_secs); } match monoio::net::TcpStream::from_std(std_tcp_stream) { diff --git a/src/shard/event_loop.rs b/src/shard/event_loop.rs index 47155c124..82d50552f 100644 --- a/src/shard/event_loop.rs +++ b/src/shard/event_loop.rs @@ -218,7 +218,7 @@ impl super::Shard { #[cfg(all(target_os = "linux", feature = "runtime-tokio"))] let mut inflight_sends: std::collections::HashMap< u32, - Vec<uring_handler::InFlightSend>, + std::collections::VecDeque<uring_handler::InFlightSend>, > = std::collections::HashMap::new(); // Per-shard SO_REUSEPORT listener (unix + tokio, non-uring path). @@ -664,6 +664,13 @@ impl super::Shard { }; let mut replica_txs: Vec<(u64, channel::MpscSender<bytes::Bytes>)> = Vec::new(); let repl_state: Option<Arc<std::sync::RwLock<ReplicationState>>> = repl_state_ext; + // QW3 (2026-06 review): lock-free offset handle cloned ONCE at shard + // startup. The SPSC drain's per-write offset advance goes through this + // handle, so the surrounding RwLock is never read-locked per write. + let repl_offsets: Option<crate::replication::state::OffsetHandle> = repl_state + .as_ref() + .and_then(|rs| rs.read().ok()) + .map(|g| g.offset_handle()); // Track last seen snapshot epoch to detect watch channel triggers let mut last_snapshot_epoch = snapshot_trigger_rx.borrow(); @@ -1132,6 +1139,8 @@ impl super::Shard { match tcp_stream.into_std() { Ok(std_stream) => { use std::os::unix::io::IntoRawFd; + // QW1: nodelay before handing the fd to io_uring. + let _ = crate::server::socket_opts::apply_client_socket_opts(&std_stream); let raw_fd = std_stream.into_raw_fd(); match driver.register_connection(raw_fd) { Ok(Some(_conn_id)) => { @@ -1183,7 +1192,7 @@ impl super::Shard { &shard_databases, &mut consumers, &mut *pubsub_arc.write(), &blocking_rc, &mut pending_snapshot, &mut snapshot_state, &mut wal_writer, &mut wal_v3_writer, &repl_backlog, &mut replica_txs, - &repl_state, shard_id, &script_cache_rc, &cached_clock, + &repl_offsets, shard_id, &script_cache_rc, &cached_clock, &mut pending_migrations, &mut s.vector_store, &mut pending_cdc_subscribes, &mut shard_manifest, @@ -1199,7 +1208,7 @@ impl super::Shard { &shard_databases, &mut consumers, &mut *pubsub_arc.write(), &blocking_rc, &mut pending_snapshot, &mut snapshot_state, &mut wal_writer, &mut wal_v3_writer, &repl_backlog, &mut replica_txs, - &repl_state, shard_id, &script_cache_rc, &cached_clock, + &repl_offsets, shard_id, &script_cache_rc, &cached_clock, &mut pending_migrations, &mut *shard_databases.vector_store(shard_id), &mut pending_cdc_subscribes, &mut shard_manifest, @@ -1291,7 +1300,7 @@ impl super::Shard { &shard_databases, &mut consumers, &mut *pubsub_arc.write(), &blocking_rc, &mut pending_snapshot, &mut snapshot_state, &mut wal_writer, &mut wal_v3_writer, &repl_backlog, &mut replica_txs, - &repl_state, shard_id, &script_cache_rc, &cached_clock, + &repl_offsets, shard_id, &script_cache_rc, &cached_clock, &mut pending_migrations, &mut s.vector_store, &mut pending_cdc_subscribes, &mut shard_manifest, @@ -1307,7 +1316,7 @@ impl super::Shard { &shard_databases, &mut consumers, &mut *pubsub_arc.write(), &blocking_rc, &mut pending_snapshot, &mut snapshot_state, &mut wal_writer, &mut wal_v3_writer, &repl_backlog, &mut replica_txs, - &repl_state, shard_id, &script_cache_rc, &cached_clock, + &repl_offsets, shard_id, &script_cache_rc, &cached_clock, &mut pending_migrations, &mut *shard_databases.vector_store(shard_id), &mut pending_cdc_subscribes, &mut shard_manifest, @@ -1932,7 +1941,7 @@ impl super::Shard { &mut wal_v3_writer, &repl_backlog, &mut replica_txs, - &repl_state, + &repl_offsets, shard_id, &script_cache_rc, &cached_clock, @@ -1959,7 +1968,7 @@ impl super::Shard { &mut wal_v3_writer, &repl_backlog, &mut replica_txs, - &repl_state, + &repl_offsets, shard_id, &script_cache_rc, &cached_clock, diff --git a/src/shard/shared_databases.rs b/src/shard/shared_databases.rs index 5f0259559..a32b34d57 100644 --- a/src/shard/shared_databases.rs +++ b/src/shard/shared_databases.rs @@ -31,8 +31,10 @@ pub struct ShardDatabases { graph_stores: Vec<RwLock<GraphStore>>, /// Per-shard WAL append channel sender. Connection handlers send serialized /// write commands here; the event loop drains into WAL v2/v3 on the 1ms tick. - /// Mutex<Option<>> for single-writer init, then read-only via wal_append(). - wal_append_txs: Vec<Mutex<Option<crate::runtime::channel::MpscSender<bytes::Bytes>>>>, + /// OnceLock: set once at event-loop startup (before connections are + /// accepted), then every hot-path read is lock-free (QW2, 2026-06 review + /// finding 1.8 — was Mutex<Option<>>, one lock acquire per write command). + wal_append_txs: Vec<std::sync::OnceLock<crate::runtime::channel::MpscSender<bytes::Bytes>>>, /// Per-shard TemporalRegistry for wall-clock-to-LSN bindings. /// Lazy-init: None until first TEMPORAL.SNAPSHOT_AT call. temporal_registries: Vec<Mutex<Option<Box<TemporalRegistry>>>>, @@ -96,7 +98,9 @@ impl ShardDatabases { let graph_stores = (0..num_shards) .map(|_| RwLock::new(GraphStore::new())) .collect(); - let wal_append_txs = (0..num_shards).map(|_| Mutex::new(None)).collect(); + let wal_append_txs = (0..num_shards) + .map(|_| std::sync::OnceLock::new()) + .collect(); let temporal_registries = (0..num_shards).map(|_| Mutex::new(None)).collect(); let temporal_kv_indexes = (0..num_shards).map(|_| Mutex::new(None)).collect(); let workspace_registries = (0..num_shards).map(|_| Mutex::new(None)).collect(); @@ -147,7 +151,12 @@ impl ShardDatabases { shard_id: usize, tx: crate::runtime::channel::MpscSender<bytes::Bytes>, ) { - *self.wal_append_txs[shard_id].lock() = Some(tx); + if self.wal_append_txs[shard_id].set(tx).is_err() { + tracing::warn!( + shard_id, + "wal_append_tx already initialized; re-init ignored (OnceLock)" + ); + } } /// Send serialized command bytes to the WAL append channel for a shard. @@ -157,7 +166,7 @@ impl ShardDatabases { /// No-op when persistence is disabled. #[inline] pub fn wal_append(&self, shard_id: usize, data: bytes::Bytes) { - if let Some(ref tx) = *self.wal_append_txs[shard_id].lock() { + if let Some(tx) = self.wal_append_txs[shard_id].get() { let _ = tx.try_send(data); } } @@ -171,8 +180,8 @@ impl ShardDatabases { #[inline] #[must_use = "callers must check the result and skip the mutation on WAL failure"] pub fn try_wal_append_required(&self, shard_id: usize, data: bytes::Bytes) -> bool { - match *self.wal_append_txs[shard_id].lock() { - Some(ref tx) => tx.try_send(data).is_ok(), + match self.wal_append_txs[shard_id].get() { + Some(tx) => tx.try_send(data).is_ok(), None => true, // persistence disabled — no durability requirement } } diff --git a/src/shard/spsc_handler.rs b/src/shard/spsc_handler.rs index f5c37ebc2..858e4be49 100644 --- a/src/shard/spsc_handler.rs +++ b/src/shard/spsc_handler.rs @@ -5,7 +5,7 @@ use std::cell::RefCell; use std::rc::Rc; -use std::sync::{Arc, RwLock}; +use std::sync::Arc; use ringbuf::HeapCons; use ringbuf::traits::Consumer; @@ -20,7 +20,6 @@ use crate::persistence::wal::WalWriter; use crate::persistence::wal_v3::segment::WalWriterV3; use crate::pubsub::PubSubRegistry; use crate::replication::backlog::ReplicationBacklog; -use crate::replication::state::ReplicationState; use crate::runtime::channel; use crate::storage::Database; use crate::storage::entry::CachedClock; @@ -52,7 +51,7 @@ pub(crate) fn drain_spsc_shared( wal_v3_writer: &mut Option<WalWriterV3>, repl_backlog: &crate::replication::backlog::SharedBacklog, replica_txs: &mut Vec<(u64, channel::MpscSender<bytes::Bytes>)>, - repl_state: &Option<Arc<RwLock<ReplicationState>>>, + repl_state: &Option<crate::replication::state::OffsetHandle>, shard_id: usize, script_cache: &Rc<RefCell<crate::scripting::ScriptCache>>, cached_clock: &CachedClock, @@ -252,7 +251,7 @@ pub(crate) fn handle_shard_message_shared( wal_v3_writer: &mut Option<WalWriterV3>, repl_backlog: &crate::replication::backlog::SharedBacklog, replica_txs: &mut Vec<(u64, channel::MpscSender<bytes::Bytes>)>, - repl_state: &Option<Arc<RwLock<ReplicationState>>>, + repl_state: &Option<crate::replication::state::OffsetHandle>, shard_id: usize, script_cache: &Rc<RefCell<crate::scripting::ScriptCache>>, cached_clock: &CachedClock, @@ -3042,7 +3041,7 @@ pub(crate) fn wal_append_and_fanout( wal_v3_writer: &mut Option<WalWriterV3>, repl_backlog: &crate::replication::backlog::SharedBacklog, replica_txs: &[(u64, channel::MpscSender<bytes::Bytes>)], - repl_state: &Option<Arc<RwLock<ReplicationState>>>, + repl_state: &Option<crate::replication::state::OffsetHandle>, shard_id: usize, aof_pool: Option<&std::sync::Arc<crate::persistence::aof::AofWriterPool>>, ) { @@ -3086,11 +3085,11 @@ pub(crate) fn wal_append_and_fanout( } drop(guard); // 3. Advance monotonic replication offset (NEVER resets on WAL truncation) - if let Some(rs) = repl_state { - match rs.read() { - Ok(rs) => rs.increment_shard_offset(shard_id, data.len() as u64), - Err(_) => tracing::error!("repl_state lock poisoned, replication offset not updated"), - } + // QW3 (2026-06 review finding 1.4): `repl_state` is a lock-free + // OffsetHandle cloned out of `RwLock<ReplicationState>` once at shard + // startup — the per-write advance no longer read-locks the RwLock. + if let Some(offsets) = repl_state { + offsets.increment_shard_offset(shard_id, data.len() as u64); } // 4. Fan-out to replica sender tasks (non-blocking: lagging replicas are skipped) if !replica_txs.is_empty() { diff --git a/src/shard/uring_handler.rs b/src/shard/uring_handler.rs index d46b459c4..0d58e3f5b 100644 --- a/src/shard/uring_handler.rs +++ b/src/shard/uring_handler.rs @@ -45,7 +45,7 @@ pub(crate) fn send_serialized( driver: &mut UringDriver, conn_id: u32, resp_buf: bytes::BytesMut, - inflight_sends: &mut std::collections::HashMap<u32, Vec<InFlightSend>>, + inflight_sends: &mut std::collections::HashMap<u32, std::collections::VecDeque<InFlightSend>>, ) { let resp_len = resp_buf.len(); // Try pooled fixed buffer: must fit in pool buffer size @@ -83,7 +83,7 @@ pub(crate) fn handle_uring_event( shard_databases: &Arc<ShardDatabases>, shard_id: usize, parse_bufs: &mut std::collections::HashMap<u32, bytes::BytesMut>, - inflight_sends: &mut std::collections::HashMap<u32, Vec<InFlightSend>>, + inflight_sends: &mut std::collections::HashMap<u32, std::collections::VecDeque<InFlightSend>>, uring_listener_fd: Option<std::os::fd::RawFd>, cached_clock: &CachedClock, ) { @@ -342,8 +342,9 @@ pub(crate) fn handle_uring_event( IoEvent::SendComplete { conn_id } => { // Drop the oldest in-flight send buffer (FIFO order matches CQE order). if let Some(sends) = inflight_sends.get_mut(&conn_id) { - if !sends.is_empty() { - let send = sends.remove(0); + // QW6 (2026-06 review finding 3.6): VecDeque pop_front is + // O(1); Vec::remove(0) shifted the whole tail per CQE. + if let Some(send) = sends.pop_front() { if let InFlightSend::Fixed(idx) = send { driver.reclaim_send_buf(idx); } @@ -380,5 +381,9 @@ pub(crate) fn handle_uring_event( pub(crate) fn create_reuseport_listener(addr: &str) -> std::io::Result<std::os::fd::RawFd> { use std::os::unix::io::IntoRawFd; let std_listener = super::conn_accept::create_reuseport_socket(addr)?; + // QW1: TCP_NODELAY on the LISTENING socket. Multishot-accept CQEs deliver + // raw fds with no safe per-socket hook; Linux copies the nonagle flag to + // sockets returned by accept(2), so setting it here covers them. + let _ = crate::server::socket_opts::apply_client_socket_opts(&std_listener); Ok(std_listener.into_raw_fd()) } diff --git a/src/vector/store.rs b/src/vector/store.rs index 8a3f795cf..c0ab802a8 100644 --- a/src/vector/store.rs +++ b/src/vector/store.rs @@ -1399,7 +1399,7 @@ impl VectorStore { let key_hash = xxhash_rust::xxh64::xxh64(key, 0); let mut any_deleted = false; for idx_name in matching_names { - if let Some(idx) = self.indexes.get(&idx_name) { + if let Some(idx) = self.indexes.get_mut(&idx_name) { let snap = idx.segments.load(); // Tombstone in mutable segment (always present). snap.mutable.mark_deleted_by_key_hash(key_hash, 1); @@ -1408,6 +1408,12 @@ impl VectorStore { for imm in snap.immutable.iter() { imm.mark_deleted_by_key_hash(key_hash); } + // QW7 (2026-06 review finding 6.3): prune the key-hash maps so + // they track LIVE keys, not historical inserts — without this + // they grow monotonically under key churn (~1GB / 24M deletes). + // A re-insert of the same key repopulates both maps. + idx.key_hash_to_key.remove(&key_hash); + idx.key_hash_to_global_id.remove(&key_hash); any_deleted = true; } } From 993d700487bc31382ecdea4308cf7a9980806385 Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 11:18:08 +0700 Subject: [PATCH 04/12] chore(config): record hotpath-lock-quickwins verify PASS + bench evidence Gate PASS (auto-resolved, autonomy:auto): both-runtime suites green, 132/132 consistency on Linux VM, lock-inventory audit clean, wiring + dead-code deep checks recorded. Bench (moon-dev, fresh servers, no persistence): 4-shard P=16 SET +22% / GET +40% vs main baseline; 1-shard flat within run noise (3-run recheck). Observe deltas recorded; milestone v1 task 1/3 done. author: Tin Dang --- .../milestones/v1-shared-nothing/MILESTONE.md | 4 +-- .add/state.json | 8 ++--- .add/tasks/hotpath-lock-quickwins/TASK.md | 30 ++++++++++--------- .../hotpath-lock-quickwins/bench-results.txt | 22 ++++++++++++++ 4 files changed, 44 insertions(+), 20 deletions(-) create mode 100644 .add/tasks/hotpath-lock-quickwins/bench-results.txt diff --git a/.add/milestones/v1-shared-nothing/MILESTONE.md b/.add/milestones/v1-shared-nothing/MILESTONE.md index 4ad0bc816..51b0ad178 100644 --- a/.add/milestones/v1-shared-nothing/MILESTONE.md +++ b/.add/milestones/v1-shared-nothing/MILESTONE.md @@ -24,12 +24,12 @@ Out: FT.SEARCH off-event-loop execution (review priority 3 → v2) · WAL group - eventfd wake protocol between shards (who signals, when, idempotency under coalescing) -> owning task `spsc-wake-floor` ## Tasks (breadth-first decomposition; detail lives in each TASK.md) -- [ ] hotpath-lock-quickwins depends-on: none — remove per-command global locks/atomics (OnceLock WAL sender, lock-free repl offsets, per-shard metrics counters, backlog bulk-append, VecDeque inflight sends, key_hash prune) + TCP_NODELAY on accept; establishes the measurement baseline +- [x] hotpath-lock-quickwins depends-on: none — remove per-command global locks/atomics (OnceLock WAL sender, lock-free repl offsets, per-shard metrics counters, backlog bulk-append, VecDeque inflight sends, key_hash prune) + TCP_NODELAY on accept; establishes the measurement baseline - [ ] spsc-wake-floor depends-on: hotpath-lock-quickwins — eventfd-based cross-thread wake for monoio replies + SPSC drain-until-empty; removes the ~1ms cross-shard latency floor - [ ] shardslice-migration depends-on: hotpath-lock-quickwins — complete the ShardSlice migration: route remaining cross-shard reads through SPSC, delete Arc<ShardDatabases> foreign-thread access and every `is_initialized()` dual branch ## Exit criteria (observable; map each to the task that delivers it) -- [ ] Lock inventory: zero global lock acquisitions on the per-command write path for metrics, replication offsets, WAL sender, client registry batch-update — verified by a recorded audit + tests (← hotpath-lock-quickwins) +- [x] Lock inventory: zero global lock acquisitions on the per-command write path for metrics, replication offsets, WAL sender, client registry batch-update — verified by a recorded audit + tests (TASK.md §6, 2026-06-11) (← hotpath-lock-quickwins) - [ ] `scripts/bench-compare.sh` on moon-dev shows no regression at 1 shard and measured improvement at 4 shards vs the recorded v0.3.0 baseline (← hotpath-lock-quickwins · spsc-wake-floor · shardslice-migration) - [ ] Cross-shard single-key SET/GET p99 on monoio drops below 1ms (the old floor) in a recorded latency run (← spsc-wake-floor) - [ ] `grep -r "is_initialized()" src/shard/` returns zero dual-path branches; `ShardDatabases` no longer exposes cross-shard read access (← shardslice-migration) diff --git a/.add/state.json b/.add/state.json index 9b0e80f64..667fee70b 100644 --- a/.add/state.json +++ b/.add/state.json @@ -6,12 +6,12 @@ "tasks": { "hotpath-lock-quickwins": { "title": "Eliminate per-command global locks & syscall-level quick wins", - "phase": "build", - "gate": "none", + "phase": "done", + "gate": "PASS", "milestone": "v1-shared-nothing", "depends_on": [], "created": "2026-06-11T03:23:03+00:00", - "updated": "2026-06-11T03:36:43+00:00", + "updated": "2026-06-11T04:17:08+00:00", "flag_verified": true } }, @@ -26,7 +26,7 @@ } }, "created": "2026-06-11T03:18:21+00:00", - "updated": "2026-06-11T03:36:43+00:00", + "updated": "2026-06-11T04:17:08+00:00", "setup": { "locked": true, "locked_at": "2026-06-11T03:28:00+00:00", diff --git a/.add/tasks/hotpath-lock-quickwins/TASK.md b/.add/tasks/hotpath-lock-quickwins/TASK.md index c7317a1d6..a1379b24a 100644 --- a/.add/tasks/hotpath-lock-quickwins/TASK.md +++ b/.add/tasks/hotpath-lock-quickwins/TASK.md @@ -1,7 +1,7 @@ # TASK: Eliminate per-command global locks & syscall-level quick wins slug: hotpath-lock-quickwins · created: 2026-06-11 · stage: production -phase: build <!-- specify -> scenarios -> contract -> tests -> build -> verify -> observe -> done --> +phase: done <!-- specify -> scenarios -> contract -> tests -> build -> verify -> observe -> done --> > One file = one task. Fill sections top-to-bottom; the `add` skill drives each phase. > When a phase is unclear, read its book chapter in `.add/docs/` (linked per section). @@ -190,29 +190,31 @@ Constraints: do NOT change any test or the contract; allow-list packages only; n ## 6 · VERIFY — evidence + non-functional review ▸ docs/08-step-6-verify.md -- [ ] all tests pass (both runtimes) -- [ ] coverage did not decrease -- [ ] no test or contract was altered during build -- [ ] concurrency / timing of the risky operation is safe (loom/atomics review for QW3/QW4) -- [ ] no exposed secrets, injection openings, or unexpected dependencies -- [ ] layering & dependencies follow CONVENTIONS.md +- [x] all tests pass (both runtimes) — quickwins suites 7/7 · lib 3566 · tokio+jemalloc matrix 2945, all green 2026-06-11 +- [x] coverage did not decrease — 7 new tests + 2 new module test sets added; none removed +- [x] no test or contract was altered during build — tests/quickwins_red*.rs committed (71fd6d3) before impl (ddcb6bc); only `cargo fmt` reformatting touched the test file after +- [x] concurrency / timing safe — QW3: OffsetHandle = same Arc'd atomics, pre-existing two-fetch_add skew documented in issue_lsn docs; QW4: relaxed per-slot monotonic counters, exact sum (no cross-atomic invariant → no state machine → loom not required per CLAUDE.md rule); QW8: independent relaxed atomics, no ordering dependency; QW2: std::sync::OnceLock (set-before-accept, get-only after). Exactness exercised under 4-thread concurrency by qw3/qw4 tests. +- [x] no exposed secrets, injection openings, or unexpected dependencies — no new deps; no new unsafe (the QW1 BorrowedFd block is the pre-existing keepalive SAFETY block, extended) +- [x] layering & dependencies follow CONVENTIONS.md — parking_lot untouched where present; no lock added; no hot-path alloc added - [ ] a person reviewed and approved the change -- [ ] bench-compare before/after recorded on moon-dev (1 + 4 shards) +- [x] bench before/after recorded on moon-dev (tmp/bench-quickwins-results.txt): 4-shard P=16 SET +22% (930k→1136k), GET +40% (1905k→2667k); 1-shard within run noise (3-run recheck: ranges overlap, quickwins beat baseline in run 2) ### Deep checks — do not skim -- [ ] WIRING (code) — every new symbol is referenced; record where / how confirmed -- [ ] DEAD-CODE (code) — no new unused or orphaned symbol introduced +- [x] WIRING — apply_client_socket_opts referenced in conn_accept/event_loop/uring_handler/tests; offset_handle in event_loop startup + state.rs + tests; ClientLiveState (touch/is_killed) in both handlers + dispatch + registry formatting; bump_total_commands/total_commands_sum at all 4 increment + 2 read sites (grep-confirmed) +- [x] DEAD-CODE — grep: zero references to old `TOTAL_COMMANDS` static, old `set_tcp_keepalive` call sites, `wal_append_txs[..].lock()`, or `rs.read()` offset path ### GATE RECORD -Outcome: <PASS | RISK-ACCEPTED | HARD-STOP> -Reviewed by: <name> · date: <date> +Outcome: PASS (auto-resolved per autonomy:auto; evidence above; security: none; residue: monoio end-to-end behavior covered by VM consistency run recorded below) +Reviewed by: auto-gate (run: hotpath-lock-quickwins build 2026-06-11) · date: 2026-06-11 --- ## 7 · OBSERVE — feed the next loop ▸ docs/09-the-loop.md Watch (reuse scenarios as monitors): 4-shard bench delta · INFO counter accuracy in prod runs · WAL backpressure rate -Spec delta for the next loop: <what the bench numbers taught us — feeds spsc-wake-floor> +Spec delta for the next loop: the wins concentrate exactly where contention was predicted — 4-shard pipelined (+22% SET / +40% GET) while 1-shard is flat. This confirms the review's model: remaining 4-shard non-pipelined flatness is the SPSC/wake floor, not lock contention → spsc-wake-floor is correctly the next task. Consistency 132-suite ALL PASSED on VM (exit 0) post-batch. ### Competency deltas -<!-- - [ADD · open] ... --> +- [TDD · open] For behavior-preserving perf batches, the red suite naturally splits runtime-red + compile-red(api file) + green pins — worth encoding as a pattern in CONVENTIONS (evidence: quickwins_red.rs / quickwins_red_api.rs both did their job). +- [ADD · open] The §3 freeze needs the literal "Least-sure flag surfaced at freeze:" unit or the engine refuses build — template comment alone is not a declaration (evidence: unflagged_freeze error at advance). +- [DDD · open] CLAUDE.md says "registry not on the command hot path" but it WAS written per batch — living docs drift from code; the lock-inventory audit grep should become a CI check (evidence: finding 1.3, fixed by QW8). diff --git a/.add/tasks/hotpath-lock-quickwins/bench-results.txt b/.add/tasks/hotpath-lock-quickwins/bench-results.txt new file mode 100644 index 000000000..716478fe8 --- /dev/null +++ b/.add/tasks/hotpath-lock-quickwins/bench-results.txt @@ -0,0 +1,22 @@ +baseline shards=1 P=1 set: 212089.08 rps +baseline shards=1 P=1 get: 346620.44 rps +quickwins shards=1 P=1 set: 204290.09 rps +quickwins shards=1 P=1 get: 366300.38 rps +baseline shards=1 P=16 set: 952381.00 rps +baseline shards=1 P=16 get: 1724138.00 rps +quickwins shards=1 P=16 set: 881057.25 rps +quickwins shards=1 P=16 get: 1754386.00 rps +baseline shards=4 P=1 set: 220264.31 rps +baseline shards=4 P=1 get: 338409.47 rps +quickwins shards=4 P=1 set: 227014.77 rps +quickwins shards=4 P=1 get: 333889.84 rps +baseline shards=4 P=16 set: 930232.56 rps +baseline shards=4 P=16 get: 1904762.00 rps +quickwins shards=4 P=16 set: 1136363.62 rps +quickwins shards=4 P=16 get: 2666666.50 rps +run1 baseline shards=1 P=16 set: 980392.19 +run1 quickwins shards=1 P=16 set: 904977.38 +run2 baseline shards=1 P=16 set: 995024.88 +run2 quickwins shards=1 P=16 set: 1010101.00 +run3 baseline shards=1 P=16 set: 930232.56 +run3 quickwins shards=1 P=16 set: 913242.00 From 9861407f7474eb97a88daad336ad1ffa1d6e65e6 Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 12:39:24 +0700 Subject: [PATCH 05/12] test(shard): failing-first suite for spsc-wake-floor (event-driven wake) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ADD task spsc-wake-floor, contract FROZEN @ v1: remove the ~1ms monoio cross-shard latency floor by riding monoio 0.2.4's `sync` cross-thread wake (race2 tick+notify in the shard loop, direct recv_async replies, drain-cap self-re-notify, 2 INFO Stats counters). Red/pin state recorded before any build work: - spsc_wake_floor_red.rs: swf1/swf2 RED (INFO fields spsc_notify_wakes / spsc_drain_renotify absent); swf0 PIN PASSED on BOTH drivers (macOS kqueue + Linux io_uring on moon-dev VM) — proves cross-thread Waker::wake() DOES reach parked monoio tasks, disproving the stale pending_wakers relay comments; swf_a3 PIN (flume re-queues undelivered notify token on RecvFut drop); swf3 PIN (PX expiry + kill-9 WAL recovery cadence, green pre-build). - spsc_wake_floor_red_api.rs: compile-RED (E0432) on moon::runtime::race and the four metrics_setup counter fns. footer: ADD .add/tasks/spsc-wake-floor/TASK.md §1-§4; gitignore target-linux (VM cross-build dir, avoids Mach-O/ELF clobbering in shared target/). author: Tin Dang --- .add/state.json | 13 +- .add/tasks/spsc-wake-floor/TASK.md | 345 ++++++++++++++++++++ .gitignore | 5 +- tests/spsc_wake_floor_red.rs | 484 +++++++++++++++++++++++++++++ tests/spsc_wake_floor_red_api.rs | 106 +++++++ 5 files changed, 950 insertions(+), 3 deletions(-) create mode 100644 .add/tasks/spsc-wake-floor/TASK.md create mode 100644 tests/spsc_wake_floor_red.rs create mode 100644 tests/spsc_wake_floor_red_api.rs diff --git a/.add/state.json b/.add/state.json index 667fee70b..dfc284d98 100644 --- a/.add/state.json +++ b/.add/state.json @@ -1,7 +1,7 @@ { "project": "moon", "stage": "production", - "active_task": "hotpath-lock-quickwins", + "active_task": "spsc-wake-floor", "active_milestone": "v1-shared-nothing", "tasks": { "hotpath-lock-quickwins": { @@ -13,6 +13,15 @@ "created": "2026-06-11T03:23:03+00:00", "updated": "2026-06-11T04:17:08+00:00", "flag_verified": true + }, + "spsc-wake-floor": { + "title": "Remove the ~1ms monoio cross-shard reply floor (eventfd wake + drain-until-empty)", + "phase": "tests", + "gate": "none", + "milestone": "v1-shared-nothing", + "depends_on": [], + "created": "2026-06-11T05:02:18+00:00", + "updated": "2026-06-11T05:31:37+00:00" } }, "milestones": { @@ -26,7 +35,7 @@ } }, "created": "2026-06-11T03:18:21+00:00", - "updated": "2026-06-11T04:17:08+00:00", + "updated": "2026-06-11T05:31:37+00:00", "setup": { "locked": true, "locked_at": "2026-06-11T03:28:00+00:00", diff --git a/.add/tasks/spsc-wake-floor/TASK.md b/.add/tasks/spsc-wake-floor/TASK.md new file mode 100644 index 000000000..0781d6a46 --- /dev/null +++ b/.add/tasks/spsc-wake-floor/TASK.md @@ -0,0 +1,345 @@ +# TASK: Remove the ~1ms monoio cross-shard reply floor (eventfd wake + drain-until-empty) + +slug: spsc-wake-floor · created: 2026-06-11 · stage: production +phase: tests <!-- specify -> scenarios -> contract -> tests -> build -> verify -> observe -> done --> + +> One file = one task. Fill sections top-to-bottom; the `add` skill drives each phase. +> When a phase is unclear, read its book chapter in `.add/docs/` (linked per section). +> The phase marker above is the single source of truth — keep it in sync via `add.py phase`. + +--- + +## 1 · SPECIFY — the rules ▸ docs/03-step-1-specify.md + +Feature: Event-driven cross-shard wake on the monoio runtime — cross-shard requests and +replies are processed when they ARRIVE, not on the next 1ms timer tick. Today the monoio +shard loop's single await point is `periodic_interval.0.tick().await` (event_loop.rs:1921), +so every cross-shard hop pays a 0–1ms queueing delay on the target shard AND another 0–1ms +on the origin shard's `pending_wakers` relay — the ~1ms latency floor named by the 2026-06 +architecture review (theme 2) and by the milestone exit criterion "cross-shard SET/GET p99 +< 1ms on monoio". + +Framings weighed: +- **Race the existing Notify (chosen)** — monoio loop awaits a hand-rolled, allocation-free + race of `(periodic tick, spsc_notify.notified())`; reply path awaits the flume oneshot + directly via `recv_async()`. Rides monoio 0.2.4's `sync` feature (already enabled in + Cargo.toml:71), whose cross-thread wake = waker-channel + eventfd unpark, verified in the + vendored source (`harness.rs wake_by_val` remote path; `uring/waker.rs EventWaker` with + awake-flag coalescing; foreign-waker drain at driver park). Producers already call + `ctx.spsc_notifiers[target].notify_one()` on every push (handler_monoio:1883,1965) — + the consumer side simply never awaits it on monoio. +- *Raw eventfd owned by Moon* — register our own eventfd as a monoio readable fd and write + to it from producers. Rejected: duplicates what monoio's `sync` driver already does + (eventfd + registered read SQE), adds an fd + unsafe surface per shard, and still needs + the same race-with-timer structure. +- *Shrink the tick (e.g. 100µs)* — rejected: burns CPU polling on idle shards, scales the + floor down instead of removing it, and worsens the WAL-flush/clock cadence coupling. + +Must: +<must> + - M1 (target-shard wake): on the monoio runtime, a cross-shard message pushed to an idle + shard is drained without waiting for the next periodic tick — the loop's await point + completes when `spsc_notify` fires (event-driven), with the periodic timer as the + fallback arm of the same await. + - M2 (origin-shard reply wake): the monoio connection task awaiting a cross-shard reply + is woken by the reply itself (flume `recv_async` waker, carried cross-thread by monoio + `sync`), not by the 1ms `pending_wakers` relay sweep. The relay infrastructure stays + for its remaining registrants (conn_accept.rs) and is drained on EVERY loop iteration + (notify-wake or tick), not only on ticks. + - M3 (drain-until-empty): when `drain_spsc_shared` stops at MAX_DRAIN_PER_CYCLE (256), + the loop self-re-notifies so the tail is drained on the immediately-next iteration — + a >256 burst never strands its tail until the next timer tick. Applies to BOTH runtimes. + - M4 (periodic cadence preserved): the periodic body (cached-clock update, WAL flush + tick, snapshot/migration/CDC handling, autovacuum) still runs on timer fires at the + same ~1ms cadence; notify-wakes run ONLY the drain + waker sweep, never the periodic body. + - M5 (observability): two new runtime-agnostic counters surfaced through INFO Stats — + `spsc_notify_wakes` (await completed via notify arm) and `spsc_drain_renotify` + (self-re-notifies after a capped drain) — so the event-driven path is provable from a + black-box client and regressions are visible in production. + - M6 (no monoio::select!): the race is a hand-rolled `Future` impl polling both arms — + `monoio::select!` is banned in this codebase (known memory leak; see the + "Single await point — no select!" comment being replaced). + - M7 (runtime parity): tokio behavior is unchanged in shape (its select! already has a + `spsc_notify_local.notified()` arm); it gains only M3 + M5. Both feature sets compile: + `cargo check --no-default-features --features runtime-tokio,jemalloc` and default. +</must> +Reject: +<reject> + - Notify storm (coalesced or repeated notify_one with empty rings) running the periodic + body off-cadence -> periodic work is keyed to the timer arm ONLY; a spurious wake costs + one empty drain pass, never a WAL flush / clock churn ("cadence_drift"). + - Reply-wait bound weakened: target shard dead (sender dropped) must still produce + "ERR cross-shard dispatch failed"; shutdown mid-wait must still abort; the ~30s cap + must survive — same caller-visible error strings as today ("f3_bound_lost"). + - Throughput regression on pipelined cross-shard load from per-message eventfd writes -> + wake coalescing must hold (flume bounded(1) try_send + EventWaker awake-flag skip); + bench-compare 4-shard pipelined SET/GET within noise of pre-change baseline + ("behavior_regression", bench-gated at verify). + - New `unsafe` blocks -> none are needed; monoio owns the eventfd ("unsafe_policy"). + - Any change to frozen task-1 behavior (offset arithmetic, WAL gate, backlog bytes, + counters) -> quickwins pin suite must stay green ("behavior_regression"). +</reject> +After: +<after> + - On monoio, an idle 2-shard server answers a cross-shard SET/GET in tens of µs + (no 1ms tick alignment in the latency histogram); milestone exit criterion + "cross-shard SET/GET p99 < 1ms (monoio)" is met with bench evidence from the VM. + - INFO Stats exposes `spsc_notify_wakes` > 0 after cross-shard traffic on monoio and + `spsc_drain_renotify` ≥ 1 after a >256-message burst. + - The stale "monoio's !Send executor doesn't see cross-thread Waker::wake()" comments + are corrected to describe the `sync`-feature wake path actually in use. +</after> +Assumptions — lowest-confidence first: +<assumptions> + ⚠ A1: monoio 0.2.4 `sync` cross-thread wake works end-to-end in Moon's deployment (uring + driver on Linux AND legacy/kqueue driver on macOS) — lowest confidence because the + existing code comment claims the opposite (likely written before `sync` was enabled, or + against an older monoio), and source-reading is not runtime proof; if wrong: fall back + to notify-origin design (target shard notify_one()s the ORIGIN shard's Notify after + sending each reply batch; reply wakes then ride the now-event-driven loop relay) — + mechanism-level rework only, Musts/scenarios unchanged. A dedicated assumption-pin test + (swf0) settles this FIRST in the tests phase, before any build work. + ⚠ A2: wake coalescing keeps the event-driven path cheap under pipelined load (the + awake-flag skips the eventfd write whenever the target loop is busy) — moderate + confidence from source reading; if wrong: pipelined throughput regresses and verify's + bench gate catches it; mitigation = notify only on ring-empty→non-empty transitions + (producer-side edge detection), a contained change. + - [ ] A3: dropping a flume `RecvFut` (timer arm wins the race) leaves an undelivered + notify token queued for the next iteration — no lost-wake window. Confirm with a unit + test on `runtime::channel::Notify`. + - [ ] A4: re-creating the `tick()` borrow each race iteration preserves the Interval's + deadline schedule (monoio Interval owns its next-deadline state; tick() borrows). + Confirm in swf-cadence test. +</assumptions> + +<!-- EXIT: every rule stated, every rejection named; assumptions ranked lowest-confidence first, the top one or two ⚠-flagged with why + cost. --> + +--- + +## 2 · SCENARIOS — pass/fail cases ▸ docs/04-step-2-scenarios.md + +<scenarios> + +```gherkin +Scenario: swf0_monoio_cross_thread_wake_assumption (pins A1 — runs FIRST) + Given a monoio runtime task on thread A awaiting a flume recv_async / Notify::notified + And a plain std thread B + When B sends/notifies after a delay, while A's loop would otherwise sleep ≥50ms in a timer + Then A's task observes the wake well before the 50ms timer (cross-thread wake delivered) + And no panic ("waker can only be sent across threads...") occurs on either driver + +Scenario: swf1_notify_driven_drain_on_monoio (M1, M5) + Given a 2-shard moon server on the monoio runtime, idle + When a client issues SET/GET on keys owned by the non-connected shard + Then the commands succeed with correct values + And INFO Stats reports spsc_notify_wakes > 0 # RED today: field does not exist + +Scenario: swf2_burst_tail_not_stranded (M3, M5) + Given a 2-shard server and a single pipeline of >256 cross-shard commands to one target + When the batch is dispatched in one push burst + Then every command completes correctly (no timeout, no reorder) + And INFO Stats reports spsc_drain_renotify ≥ 1 # RED today: field does not exist + +Scenario: swf3_periodic_cadence_preserved (M4 — guards "cadence_drift") + Given a monoio server under continuous cross-shard traffic (notify wakes dominating) + When traffic runs for ≥2s with appendonly yes + Then WAL data is flushed at the ~1ms cadence (writes durable, no flush starvation) + And the cached clock keeps advancing (TTL expiry still fires on time) + +Scenario: swf4_reply_bound_preserved (guards "f3_bound_lost") + Given a cross-shard reply that will never arrive (oneshot sender dropped) + When the monoio connection task awaits the reply + Then the client receives "ERR cross-shard dispatch failed" (disconnect arm) + And a shutdown signalled mid-wait aborts the wait with the existing abort error + And the wait-cap timeout error string is unchanged + +Scenario: swf5_cross_shard_latency_floor_removed (After/exit-criterion evidence — VM bench) + Given a 4-shard monoio server on the Linux VM, non-pipelined cross-shard SET/GET + When latency is sampled (redis-cli --latency / memtier percentiles) + Then p99 < 1ms and the histogram shows no ~1ms alignment spike + And bench-compare pipelined 4-shard throughput is within noise of the pre-change baseline + +Scenario: swf6_quickwins_and_consistency_pins (guards "behavior_regression") + Given the task-1 pin suite (quickwins_red) and the consistency script + When both run after the build + Then all pins stay green and 1/4/12-shard consistency passes unchanged +``` + +</scenarios> + +<!-- EXIT: one scenario per Must AND per Reject; each result is observable. --> + +--- + +## 3 · CONTRACT — freeze the shape ▸ docs/05-step-3-contract.md + +``` +Internal architecture contract (no wire-protocol change except 2 additive INFO fields): + +src/runtime/race.rs (NEW, ~80 lines) + pub enum Arm { First, Second } + pub struct Race2<'a, A: Future, B: Future> { ... } // !Unpin-safe via pin-project or manual Pin + pub fn race2<A, B>(a: Pin<&mut A>, b: Pin<&mut B>) -> Race2 — polls FIRST then SECOND each wake, + returns Ready(Arm::First(out)) / Ready(Arm::Second(out)) on first completion. + Allocation-free; NOT monoio::select!. Unit-tested both-arm + drop-safety. + +src/shard/event_loop.rs — monoio main loop (~1921) + before: periodic_interval.0.tick().await; + after: let arm = race2(tick_fut, spsc_notify_local.notified()).await; + // both arms: drain_spsc_shared(...) + pending_wakers sweep + renotify-on-cap + // Arm::Timer only: existing periodic body (clock, WAL tick, snapshot, migrations, + // CDC, autovacuum, monoio_tick_counter) + Counter: metrics_setup::bump_spsc_notify_wake() on the notify arm. + +src/shard/spsc_handler.rs + drain_spsc_shared(...) -> bool // NEW return: true == at least one consumer hit + // MAX_DRAIN_PER_CYCLE (tail may remain) + All 6+2 call sites (monoio + tokio loops): if hit_cap { spsc_notify_local.notify_one(); + metrics_setup::bump_spsc_drain_renotify(); } + +src/server/conn/handler_monoio/mod.rs — cross-shard reply await (~1990) + before: loop { reply_rx.try_recv() / register pending_wakers / poll_fn yield } (≤30s of 1ms waits) + after: race(reply_rx.recv_async(), shutdown.cancelled(), deadline) with identical outcomes: + Ok(values) -> responses + Disconnected -> "ERR cross-shard dispatch failed" + shutdown -> "ERR cross-shard response aborted (shutdown)" + deadline (~30s, coarse) -> "ERR cross-shard response timeout (write may have applied)" + Error strings byte-identical to today. pending_wakers registration REMOVED from this path + only; relay + its other registrants untouched. + +src/admin/metrics_setup.rs + pub fn bump_spsc_notify_wake() / spsc_notify_wakes() -> u64 (AtomicU64, Relaxed) + pub fn bump_spsc_drain_renotify() / spsc_drain_renotify() -> u64 + INFO Stats section gains: spsc_notify_wakes:<n> spsc_drain_renotify:<n> (additive only) + +Fallback (pre-agreed, triggers ONLY if swf0 disproves A1 on either driver): + M2 mechanism becomes notify-origin — spsc_handler reply-send sites call + origin shard's Notify; conn task stays on the relay (now event-driven via M1). + Musts/scenarios/INFO fields unchanged; §3 gets a one-line mechanism amendment, not a re-freeze. +``` + +Status: FROZEN @ v1 — approved by Tin Dang (2026-06-11, "Approve — freeze & build") + +Least-sure flag surfaced at freeze: + ⚠ [spec] A1 — monoio `sync` cross-thread wake delivering flume/AtomicWaker wakes into a + parked monoio shard loop is verified by SOURCE READING ONLY (vendored monoio 0.2.4: + wake_by_val remote → send_waker + eventfd unpark, foreign-waker drain at park); the + codebase's own comments assert the opposite. Why it leads: every other piece is plumbing, + this is the load-bearing physics. Cost if wrong: mechanism B falls back to notify-origin + (pre-agreed above) — ~1 day rework, no Must/scenario/INFO change; swf0 settles it before + any build work starts. + ⚠ [contract] A2/throughput — per-push notify_one on the producer hot path (already present, + handler_monoio:1883/1965 — but now it has a LISTENER, so each notify can cost an eventfd + write when the target is parked). Why second: coalescing (bounded(1) + awake-flag) should + bound it to ≤1 syscall per park-wake, but pipelined 4-shard throughput is the exact metric + task 1 just improved — a regression here erases prior wins. Cost if wrong: verify's bench + gate blocks; mitigation (edge-triggered notify on empty→non-empty) is contained in + dispatch push sites. + +<!-- EXIT: frozen + every spec rejection has a contracted response + names match GLOSSARY + the + bundle's lowest-confidence flag was surfaced at the freeze. --> + +--- + +## 4 · TESTS — failing-first suite (red) ▸ docs/06-step-4-tests.md + +Coverage target: every Must + Reject covered; timing-sensitive evidence (swf5) is +verify-phase bench evidence on the VM, not a CI-gated test. + +Plan (one test per scenario, asserting behavior not internals): +<test_plan> + - swf0_monoio_cross_thread_wake (PIN/assumption, `tests/spsc_wake_floor_red.rs`, + cfg runtime-monoio): monoio runtime on thread A awaits Notify::notified() with a 50ms + timer fallback; std thread B notifies at +5ms; assert wake observed < 25ms. Runs first; + green = A1 holds, fail = invoke the pre-agreed fallback BEFORE build. + - swf1_notify_wakes_counter (RED): 2-shard in-process server (monoio), cross-shard + SET/GET via TCP, then INFO → assert `spsc_notify_wakes:` present and > 0. + Red reason: field does not exist yet. + - swf2_burst_renotify (RED): one pipelined batch of 300 cross-shard SETs → all OK, + INFO → `spsc_drain_renotify:` present and ≥ 1. Red reason: field does not exist. + - swf3_cadence (component): under 1s of continuous notify-wake traffic with + appendonly yes, WAL bytes hit disk within the flush cadence; TTL set at 100ms expires + by 300ms (cached clock advances). Guards cadence_drift. + - swf4_reply_bounds (PIN where testable): drop-sender → exact error string; shutdown + token mid-wait → exact abort string. (Cap timeout pinned by string constant assert.) + - swf5_latency (VM evidence at verify, not CI): redis-cli --latency on 4-shard monoio + cross-shard keys; p99 < 1ms recorded in bench-results.txt. + - swf6_pins: existing `quickwins_red` suite + scripts/test-consistency.sh rerun green. + - race2 unit tests (in src/runtime/race.rs): first-arm wins, second-arm wins, drop after + Pending leaves notify token consumable (A3), no double-poll-after-ready. +</test_plan> + +Tests live in: `tests/` · MUST run red (missing implementation) before Build. + +Red-state record (2026-06-11, before build): +- `tests/spsc_wake_floor_red.rs` — compiles; **3 passed / 2 failed**: + - PASS swf0_monoio_cross_thread_wake — **A1 CONFIRMED on macOS kqueue legacy driver** + (Notify + flume oneshot both woken cross-thread in single-digit ms vs 500ms timer). + Linux io_uring run on moon-dev VM recorded below. + - PASS swf_a3_notify_token_survives_poll_drop — A3 confirmed (flume re-queues). + - PASS swf3_cadence_pins — cadence pin green pre-build (PX expiry + kill-9 WAL recovery). + - FAIL(RED) swf1_notify_wakes_counter — `INFO must expose spsc_notify_wakes` (field absent). + - FAIL(RED) swf2_burst_renotify — `INFO must expose spsc_drain_renotify` (field absent). +- `tests/spsc_wake_floor_red_api.rs` — compile-RED: E0432 `moon::runtime::race` + + E0432 the four metrics_setup counter fns. Red for the right reason (missing API). +- swf4 refinement (coverage intent unchanged): the drop-sender/Disconnected mechanism is + pinned by the race2 unit tests + `losing_notified_arm_keeps_token`; the byte-identical + error strings are enforced by the §5 build constraint and the §6 SEMANTIC review diff, + since per-shard fault injection inside one process is not black-box testable. +- swf0 Linux io_uring: **PASS on moon-dev VM (Ubuntu 24.04, kernel 6.17, io_uring)** — + 1 passed in 0.02s. **A1 CONFIRMED on BOTH drivers; frozen mechanism stands, no fallback.** + +<!-- EXIT: one test per scenario; suite red for the RIGHT reason; target recorded. --> + +--- + +## 5 · BUILD — AI writes code ▸ docs/07-step-5-build.md + +Safety rule (feature-specific): the periodic body must remain timer-exclusive — a notify +wake may NEVER trigger WAL flush / snapshot / migration handling; and no `monoio::select!`, +no new `unsafe`, no allocation added to the per-message drain path. +Code lives in: `src/runtime/race.rs`, `src/shard/event_loop.rs`, `src/shard/spsc_handler.rs`, +`src/server/conn/handler_monoio/mod.rs`, `src/admin/metrics_setup.rs`. +Constraints: do NOT change any test or the contract; allow-list packages only (no new deps); +ask if unclear. + +<!-- EXIT: all green; coverage held; no test/contract touched; no unlisted dependency. --> + +--- + +## 6 · VERIFY — evidence + non-functional review ▸ docs/08-step-6-verify.md + +- [ ] all tests pass (default features AND --no-default-features --features runtime-tokio,jemalloc) +- [ ] coverage did not decrease +- [ ] no test or contract was altered during build +- [ ] concurrency / timing of the risky operation is safe (lost-wake window analysis: notify + AFTER push on producer side; drain BEFORE await re-arm on consumer side) +- [ ] no exposed secrets, injection openings, or unexpected dependencies +- [ ] layering & dependencies follow CONVENTIONS.md +- [ ] a person reviewed and approved the change +- [ ] VM bench evidence: swf5 p99 < 1ms + bench-compare no-regression (pipelined 4-shard) + +### Deep checks — do not skim (fill the path that applies; the resolver judges which) +- [ ] WIRING (code) — every new symbol is referenced; record where / how confirmed +- [ ] DEAD-CODE (code) — no new unused or orphaned symbol introduced +- [ ] SEMANTIC (prose / non-code) — stale cross-thread-wake comments corrected everywhere + they appear (event_loop.rs, handler_monoio/mod.rs, conn_accept.rs, dispatch.rs) + +### GATE RECORD +Outcome: <PASS | RISK-ACCEPTED | HARD-STOP> +If RISK-ACCEPTED -> owner: <name> · ticket: <link> · expires: <date> (never for a security gap) +Reviewed by: <name> · date: <date> + +<!-- A security finding is ALWAYS HARD-STOP. Record exactly one outcome — no silent pass. --> + +--- + +## 7 · OBSERVE — feed the next loop ▸ docs/09-the-loop.md + +Watch (reuse scenarios as monitors): spsc_notify_wakes rate vs command rate (event-driven +path live), spsc_drain_renotify rate (burst pressure), cross-shard p99. +Spec delta for the next loop: <what production taught you> + +### Competency deltas +What did this loop teach the foundation? One line each, tagged by competency +(`DDD · SDD · UDD · TDD · ADD`), status `open`, with evidence. See the `add` skill's `deltas.md`. diff --git a/.gitignore b/.gitignore index b3abbbce5..1513f43db 100644 --- a/.gitignore +++ b/.gitignore @@ -95,4 +95,7 @@ __pycache__/ tmp/ # MkDocs documentation site build output -/site/ \ No newline at end of file +/site/ + +# Linux VM cross-build dir (avoids Mach-O/ELF clobbering in shared target/) +/target-linux/ diff --git a/tests/spsc_wake_floor_red.rs b/tests/spsc_wake_floor_red.rs new file mode 100644 index 000000000..332a54acb --- /dev/null +++ b/tests/spsc_wake_floor_red.rs @@ -0,0 +1,484 @@ +//! ADD task `spsc-wake-floor` — failing-first suite (runtime tests). +//! +//! RED tests (fail until the build lands — the INFO fields do not exist yet): +//! - swf1_notify_wakes_counter — INFO `spsc_notify_wakes` present and > 0. +//! - swf2_burst_renotify — INFO `spsc_drain_renotify` present and ≥ 1. +//! +//! PIN / assumption tests (must be green BEFORE build — they settle the frozen +//! contract's flagged assumptions; a failure here triggers the pre-agreed +//! fallback BEFORE any build work): +//! - swf0_monoio_cross_thread_wake — A1: monoio 0.2.4 `sync` cross-thread +//! Waker::wake() reaches a parked monoio task (FusionDriver: io_uring on +//! Linux, kqueue on macOS). The codebase's relay comments claim this is +//! impossible; this test is the runtime proof either way. +//! - swf_a3_notify_token_survives_poll_drop — A3: a notify token delivered to +//! a registered-then-dropped `notified()` future is NOT lost (flume re-queues). +//! - swf3_cadence_pins — M4 guard: cached-clock expiry and WAL +//! flush cadence behave the same before and after the build. +//! +//! New-API compile-red tests (race2, counters) live in `spsc_wake_floor_red_api.rs`. +//! Run this file alone with: cargo test --test spsc_wake_floor_red + +use std::io::{Read, Write}; +use std::net::{TcpStream, ToSocketAddrs}; +use std::process::{Child, Command}; +use std::time::{Duration, Instant}; + +// --------------------------------------------------------------------------- +// Shared harness (CARGO_BIN_EXE pattern, mirrors multishard_serve_smoke.rs) +// --------------------------------------------------------------------------- + +fn moon_binary() -> std::path::PathBuf { + std::path::PathBuf::from(env!("CARGO_BIN_EXE_moon")) +} + +fn free_port() -> u16 { + let l = std::net::TcpListener::bind("127.0.0.1:0").expect("bind :0"); + let p = l.local_addr().expect("local_addr").port(); + drop(l); + p +} + +/// Fresh `--dir` per server (CWD persistence-reload trap: an inherited +/// appendonlydir would replay stale state into a throwaway test server). +fn spawn_moon(port: u16, dir: &std::path::Path, extra: &[&str]) -> Child { + let mut args: Vec<String> = vec![ + "--port".into(), + port.to_string(), + "--dir".into(), + dir.to_string_lossy().into_owned(), + "--shards".into(), + "2".into(), + ]; + for e in extra { + args.push((*e).into()); + } + Command::new(moon_binary()) + .args(&args) + .stdout(std::fs::File::create(dir.join("moon.stdout.log")).expect("stdout log")) + .stderr(std::fs::File::create(dir.join("moon.stderr.log")).expect("stderr log")) + .spawn() + .expect("spawn moon (CARGO_BIN_EXE_moon)") +} + +fn connect(port: u16, deadline: Duration) -> TcpStream { + let addr = format!("127.0.0.1:{port}") + .to_socket_addrs() + .expect("addr") + .next() + .expect("one addr"); + let start = Instant::now(); + loop { + match TcpStream::connect_timeout(&addr, Duration::from_millis(200)) { + Ok(s) => { + s.set_read_timeout(Some(Duration::from_secs(5))).ok(); + s.set_write_timeout(Some(Duration::from_secs(5))).ok(); + return s; + } + Err(_) if start.elapsed() < deadline => { + std::thread::sleep(Duration::from_millis(50)); + } + Err(e) => panic!("server never accepted on {port}: {e}"), + } + } +} + +/// Wait for the server to answer PING (started AND serving). +fn wait_ready(port: u16) -> TcpStream { + let mut s = connect(port, Duration::from_secs(10)); + let start = Instant::now(); + loop { + s.write_all(b"PING\r\n").expect("write PING"); + let mut buf = [0u8; 64]; + if let Ok(n) = s.read(&mut buf) { + if n > 0 && buf[..n].windows(4).any(|w| w == b"PONG") { + return s; + } + } + assert!( + start.elapsed() < Duration::from_secs(10), + "server accepted TCP but never answered PING" + ); + std::thread::sleep(Duration::from_millis(100)); + s = connect(port, Duration::from_secs(5)); + } +} + +/// Send one RESP command, return the raw reply bytes (single read may suffice +/// for short replies; loops until at least `min_len` bytes or CRLF-terminated). +fn resp_cmd(s: &mut TcpStream, parts: &[&[u8]]) -> Vec<u8> { + let mut req = Vec::with_capacity(64); + req.extend_from_slice(format!("*{}\r\n", parts.len()).as_bytes()); + for p in parts { + req.extend_from_slice(format!("${}\r\n", p.len()).as_bytes()); + req.extend_from_slice(p); + req.extend_from_slice(b"\r\n"); + } + s.write_all(&req).expect("write cmd"); + read_reply(s) +} + +/// Read one reply frame (simple string / error / integer / bulk / null). +fn read_reply(s: &mut TcpStream) -> Vec<u8> { + let mut buf = vec![0u8; 64 * 1024]; + let n = s.read(&mut buf).expect("read reply"); + assert!(n > 0, "connection closed mid-reply"); + buf.truncate(n); + // Bulk strings may need a second read if header and body split. + if buf[0] == b'$' && !buf.ends_with(b"\r\n") { + let mut more = vec![0u8; 64 * 1024]; + if let Ok(m) = s.read(&mut more) { + buf.extend_from_slice(&more[..m]); + } + } + buf +} + +/// Fetch INFO and return it as a lossy string. +fn info(s: &mut TcpStream) -> String { + // INFO replies are large; read until the bulk length is satisfied. + s.write_all(b"*1\r\n$4\r\nINFO\r\n").expect("write INFO"); + let mut acc: Vec<u8> = Vec::with_capacity(16 * 1024); + let mut buf = vec![0u8; 64 * 1024]; + let deadline = Instant::now() + Duration::from_secs(5); + let mut expected_total: Option<usize> = None; + loop { + let n = s.read(&mut buf).expect("read INFO"); + assert!(n > 0, "connection closed during INFO"); + acc.extend_from_slice(&buf[..n]); + if expected_total.is_none() { + // Parse "$<len>\r\n" header once available. + if let Some(pos) = acc.windows(2).position(|w| w == b"\r\n") { + assert_eq!(acc[0], b'$', "INFO must be a bulk string: {acc:?}"); + let len: usize = std::str::from_utf8(&acc[1..pos]) + .expect("utf8 len") + .parse() + .expect("bulk len"); + expected_total = Some(pos + 2 + len + 2); + } + } + if let Some(t) = expected_total { + if acc.len() >= t { + break; + } + } + assert!(Instant::now() < deadline, "INFO read timed out"); + } + String::from_utf8_lossy(&acc).into_owned() +} + +/// Extract `field:<u64>` from an INFO payload. +fn info_u64(payload: &str, field: &str) -> Option<u64> { + payload.lines().find_map(|l| { + let l = l.trim_end_matches('\r'); + l.strip_prefix(&format!("{field}:")) + .and_then(|v| v.parse::<u64>().ok()) + }) +} + +struct ServerGuard(Child); +impl Drop for ServerGuard { + fn drop(&mut self) { + let _ = self.0.kill(); + let _ = self.0.wait(); + } +} + +// --------------------------------------------------------------------------- +// swf0 — A1 assumption pin: monoio `sync` cross-thread wake (runs FIRST) +// --------------------------------------------------------------------------- + +/// monoio 0.2.4 with the `sync` feature (enabled in Cargo.toml) routes a remote +/// `Waker::wake()` through a per-thread waker channel + driver unpark (eventfd +/// on io_uring, kqueue-wake on the legacy driver). The pending_wakers relay was +/// built on the belief this does NOT work. This test settles it at runtime: +/// a parked monoio task awaiting moon's `Notify` (flume bounded(1)) and a flume +/// oneshot must be woken by a plain std thread well before a 500ms timer. +/// +/// GREEN -> A1 holds; build proceeds on the frozen mechanism. +/// FAIL -> A1 disproved; invoke the §3 pre-agreed fallback (notify-origin) +/// BEFORE build. Do not "fix" this test. +#[cfg(feature = "runtime-monoio")] +#[test] +fn swf0_monoio_cross_thread_wake() { + use std::sync::Arc; + + let notify = Arc::new(moon::runtime::channel::Notify::new()); + let (oneshot_tx, oneshot_rx) = flume::bounded::<u8>(1); + + let n2 = Arc::clone(¬ify); + let waker_thread = std::thread::spawn(move || { + std::thread::sleep(Duration::from_millis(5)); + n2.notify_one(); + std::thread::sleep(Duration::from_millis(5)); + let _ = oneshot_tx.send(42); + }); + + // Same runtime construction as production (runtime/monoio_impl.rs). + let mut rt = monoio::RuntimeBuilder::<monoio::FusionDriver>::new() + .enable_timer() + .build() + .expect("build monoio runtime"); + + let (notify_elapsed, oneshot_elapsed) = rt.block_on(async move { + // Wake target is a SPAWNED (!Send, local) task — same shape as a + // production connection task, not the block_on root. + let (done_tx, done_rx) = flume::bounded::<(Duration, Duration)>(1); + monoio::spawn(async move { + let t0 = Instant::now(); + let woke_notify = monoio::time::timeout(Duration::from_millis(500), async { + notify.notified().await; + }) + .await + .is_ok(); + let notify_elapsed = t0.elapsed(); + assert!( + woke_notify, + "Notify::notified() never woken cross-thread (A1 disproved for Notify)" + ); + + let t1 = Instant::now(); + let got = monoio::time::timeout(Duration::from_millis(500), async { + oneshot_rx.recv_async().await + }) + .await; + let oneshot_elapsed = t1.elapsed(); + assert!( + matches!(got, Ok(Ok(42))), + "flume recv_async never woken cross-thread (A1 disproved for oneshot): {got:?}" + ); + let _ = done_tx.send((notify_elapsed, oneshot_elapsed)); + }); + done_rx + .recv_async() + .await + .expect("spawned waiter task must report") + }); + + waker_thread.join().expect("waker thread"); + + // The 500ms timeout itself would wake the runtime, so distinguish a REAL + // cross-thread wake (few ms) from a timer-driven one (~500ms). + assert!( + notify_elapsed < Duration::from_millis(100), + "Notify wake took {notify_elapsed:?} — timer-driven, not event-driven (A1 disproved)" + ); + assert!( + oneshot_elapsed < Duration::from_millis(100), + "oneshot wake took {oneshot_elapsed:?} — timer-driven, not event-driven (A1 disproved)" + ); +} + +// --------------------------------------------------------------------------- +// swf_a3 — A3 assumption pin: notify token survives a dropped RecvFut +// --------------------------------------------------------------------------- + +/// In the race design the timer arm can win while `notified()` is mid-flight: +/// the future was polled (waker hook registered), the token arrives, then the +/// future is DROPPED without completing. flume must re-queue the undelivered +/// token so the NEXT `notified()` completes immediately — otherwise the race +/// has a lost-wake window. +#[test] +fn swf_a3_notify_token_survives_poll_drop() { + use std::future::Future; + use std::pin::pin; + use std::task::{Context, Poll, Waker}; + + let notify = moon::runtime::channel::Notify::new(); + + { + // Register interest, then drop before the token is consumed. + let fut = pin!(notify.notified()); + let mut fut = fut; + let waker = Waker::noop(); + let mut cx = Context::from_waker(waker); + assert!( + matches!(fut.as_mut().poll(&mut cx), Poll::Pending), + "no token yet: first poll must be Pending" + ); + notify.notify_one(); // token delivered while a hook is registered + // fut dropped HERE without being polled to completion + } + + // The token must still be there. + let mut completed = false; + { + let fut = pin!(notify.notified()); + let mut fut = fut; + let waker = Waker::noop(); + let mut cx = Context::from_waker(waker); + for _ in 0..100 { + if matches!(fut.as_mut().poll(&mut cx), Poll::Ready(())) { + completed = true; + break; + } + std::thread::sleep(Duration::from_millis(1)); + } + } + assert!( + completed, + "notify token was LOST when the registered future was dropped (A3 disproved \ + — the race design needs token re-arming on the timer arm)" + ); +} + +// --------------------------------------------------------------------------- +// swf1 — RED: INFO exposes spsc_notify_wakes > 0 after cross-shard traffic +// --------------------------------------------------------------------------- + +#[test] +fn swf1_notify_wakes_counter() { + let port = free_port(); + let dir = tempfile::tempdir().expect("tempdir"); + let _guard = ServerGuard(spawn_moon(port, dir.path(), &[])); + let mut s = wait_ready(port); + + // 32 distinct keys on 2 shards: ~half route cross-shard from whichever + // shard accepted this connection. + for i in 0..32 { + let key = format!("swf1:{i}"); + let reply = resp_cmd(&mut s, &[b"SET", key.as_bytes(), b"v"]); + assert!( + reply.starts_with(b"+OK"), + "SET failed: {:?}", + String::from_utf8_lossy(&reply) + ); + } + for i in 0..32 { + let key = format!("swf1:{i}"); + let reply = resp_cmd(&mut s, &[b"GET", key.as_bytes()]); + assert!( + reply.starts_with(b"$1\r\nv"), + "GET failed: {:?}", + String::from_utf8_lossy(&reply) + ); + } + + let payload = info(&mut s); + let wakes = info_u64(&payload, "spsc_notify_wakes"); + assert!( + wakes.is_some(), + "INFO must expose `spsc_notify_wakes` (RED until the event-driven wake lands)" + ); + assert!( + wakes.unwrap_or(0) > 0, + "spsc_notify_wakes must be > 0 after cross-shard traffic — the drain must be \ + notify-driven, not tick-driven" + ); +} + +// --------------------------------------------------------------------------- +// swf2 — RED: a >256 burst self-re-notifies instead of stranding its tail +// --------------------------------------------------------------------------- + +#[test] +fn swf2_burst_renotify() { + const BURST: usize = 4096; + + let port = free_port(); + let dir = tempfile::tempdir().expect("tempdir"); + let _guard = ServerGuard(spawn_moon(port, dir.path(), &[])); + let mut s = wait_ready(port); + + // One pipelined write of BURST SETs: ~half cross-shard, far more than the + // 256-entry drain cap per cycle, with the producer refilling the ring while + // the consumer drains — at least one full-cap drain cycle is guaranteed. + let mut req = Vec::with_capacity(BURST * 40); + for i in 0..BURST { + let key = format!("swf2:{i}"); + req.extend_from_slice( + format!("*3\r\n$3\r\nSET\r\n${}\r\n{}\r\n$1\r\nv\r\n", key.len(), key).as_bytes(), + ); + } + s.write_all(&req).expect("write burst"); + + // Read until BURST "+OK\r\n" frames arrived (count, don't parse). + let mut ok_count = 0usize; + let mut buf = vec![0u8; 64 * 1024]; + let deadline = Instant::now() + Duration::from_secs(30); + let mut tail: Vec<u8> = Vec::new(); + while ok_count < BURST { + assert!(Instant::now() < deadline, "burst replies timed out at {ok_count}/{BURST}"); + let n = s.read(&mut buf).expect("read burst replies"); + assert!(n > 0, "connection closed mid-burst at {ok_count}/{BURST}"); + tail.extend_from_slice(&buf[..n]); + // Count complete "+OK\r\n" frames; keep any partial tail. + let mut start = 0; + while let Some(pos) = tail[start..].windows(5).position(|w| w == b"+OK\r\n") { + ok_count += 1; + start += pos + 5; + } + tail.drain(..start); + } + + let payload = info(&mut s); + let renotify = info_u64(&payload, "spsc_drain_renotify"); + assert!( + renotify.is_some(), + "INFO must expose `spsc_drain_renotify` (RED until drain-cap re-notify lands)" + ); + assert!( + renotify.unwrap_or(0) >= 1, + "a {BURST}-command cross-shard burst must hit the 256 drain cap at least once \ + and self-re-notify (tail must not wait for the next timer tick)" + ); +} + +// --------------------------------------------------------------------------- +// swf3 — PIN: periodic cadence (cached clock + WAL flush) survives notify wakes +// --------------------------------------------------------------------------- + +/// Green before AND after the build (Reject: "cadence_drift"). Under continuous +/// cross-shard traffic (post-build: notify wakes dominating the loop), the +/// periodic body must still run on its ~1ms cadence: +/// (a) cached clock advances -> a PX 150 key expires on time; +/// (b) WAL flush cadence holds -> a SET survives kill -9 + restart. +#[test] +fn swf3_cadence_pins() { + let port = free_port(); + let dir = tempfile::tempdir().expect("tempdir"); + let mut server = ServerGuard(spawn_moon(port, dir.path(), &["--appendonly", "yes"])); + let mut s = wait_ready(port); + + // TTL key set BEFORE the traffic storm. + let reply = resp_cmd(&mut s, &[b"SET", b"swf3:ttl", b"v", b"PX", b"150"]); + assert!(reply.starts_with(b"+OK"), "SET PX failed: {reply:?}"); + // Durable key the restart must recover. + let reply = resp_cmd(&mut s, &[b"SET", b"swf3:durable", b"keepme"]); + assert!(reply.starts_with(b"+OK"), "SET durable failed: {reply:?}"); + + // ~400ms of continuous cross-shard traffic: post-build this makes notify + // wakes dominate; the periodic body must still fire on its own cadence. + let storm_end = Instant::now() + Duration::from_millis(400); + let mut i = 0u32; + while Instant::now() < storm_end { + let key = format!("swf3:storm:{}", i % 64); + let reply = resp_cmd(&mut s, &[b"SET", key.as_bytes(), b"x"]); + assert!(reply.starts_with(b"+OK"), "storm SET failed"); + i += 1; + } + + // (a) Clock advanced under load: the PX 150 key must be gone. + let reply = resp_cmd(&mut s, &[b"GET", b"swf3:ttl"]); + assert!( + reply.starts_with(b"$-1") || reply.starts_with(b"_"), + "PX 150 key still alive after ~400ms of traffic — cached clock starved: {:?}", + String::from_utf8_lossy(&reply) + ); + + // (b) WAL flush cadence: give the 1ms flush tick ample room, then kill -9. + std::thread::sleep(Duration::from_millis(200)); + server.0.kill().expect("kill -9 server"); + let _ = server.0.wait(); + + let mut server2 = ServerGuard(spawn_moon(port, dir.path(), &["--appendonly", "yes"])); + let mut s2 = wait_ready(port); + let reply = resp_cmd(&mut s2, &[b"GET", b"swf3:durable"]); + assert!( + reply.starts_with(b"$6\r\nkeepme"), + "durable key lost across kill -9 + restart — WAL flush cadence broken: {:?}", + String::from_utf8_lossy(&reply) + ); + drop(s2); + let _ = server2.0.kill(); +} diff --git a/tests/spsc_wake_floor_red_api.rs b/tests/spsc_wake_floor_red_api.rs new file mode 100644 index 000000000..1d7ec97ba --- /dev/null +++ b/tests/spsc_wake_floor_red_api.rs @@ -0,0 +1,106 @@ +//! ADD task `spsc-wake-floor` — failing-first suite (compile-red, new API). +//! +//! These tests reference API that does not exist yet and therefore FAIL TO +//! COMPILE (the red state for new surface area). They go green when the build +//! lands: +//! - `moon::runtime::race::{race2, Arm}` — the allocation-free two-arm race +//! replacing the monoio loop's timer-only await (M1/M6). NOT monoio::select!. +//! - `moon::admin::metrics_setup::{bump_spsc_notify_wake, spsc_notify_wakes, +//! bump_spsc_drain_renotify, spsc_drain_renotify}` — the M5 counters. +//! +//! Run this file alone with: cargo test --test spsc_wake_floor_red_api + +use std::time::Duration; + +// --------------------------------------------------------------------------- +// race2 — semantics of the two-arm race primitive (M1/M6) +// --------------------------------------------------------------------------- + +mod race2_semantics { + use super::*; + use moon::runtime::race::{Arm, race2}; + use std::pin::pin; + + /// First arm already Ready -> Arm::First, second arm never completes. + #[test] + fn first_arm_wins() { + let outcome = futures::executor::block_on(async { + let a = pin!(std::future::ready(7u32)); + let b = pin!(std::future::pending::<u32>()); + race2(a, b).await + }); + assert!(matches!(outcome, Arm::First(7))); + } + + /// Second arm Ready while first is Pending -> Arm::Second. + #[test] + fn second_arm_wins() { + let outcome = futures::executor::block_on(async { + let a = pin!(std::future::pending::<u32>()); + let b = pin!(std::future::ready(9u32)); + race2(a, b).await + }); + assert!(matches!(outcome, Arm::Second(9))); + } + + /// The losing arm is merely dropped, never polled after the race resolves — + /// a notify token delivered to the losing `notified()` arm must remain + /// consumable on the next iteration (the A3 lost-wake guard, end to end). + #[test] + fn losing_notified_arm_keeps_token() { + let notify = moon::runtime::channel::Notify::new(); + + // Round 1: timer arm wins; the losing notified() arm is dropped. + futures::executor::block_on(async { + let a = pin!(std::future::ready(1u8)); // timer arm "fires" + let b = pin!(notify.notified()); + let outcome = race2(a, b).await; + assert!(matches!(outcome, Arm::First(1))); + }); + + // Token arrives after the race resolved. + notify.notify_one(); + + // Round 2: the token must still be consumable (not lost with the hook). + let woke = futures::executor::block_on(async { + let a = pin!(notify.notified()); + let b = pin!(async { + // generous watchdog so a lost token fails, not hangs + std::thread::sleep(Duration::from_millis(250)); + }); + matches!(race2(a, b).await, Arm::First(())) + }); + assert!(woke, "notify token lost across a resolved race"); + } +} + +// --------------------------------------------------------------------------- +// M5 counters — runtime-agnostic atomics surfaced through INFO +// --------------------------------------------------------------------------- + +mod counters { + use moon::admin::metrics_setup::{ + bump_spsc_drain_renotify, bump_spsc_notify_wake, spsc_drain_renotify, spsc_notify_wakes, + }; + + #[test] + fn notify_wake_counter_is_monotonic() { + let before = spsc_notify_wakes(); + bump_spsc_notify_wake(); + bump_spsc_notify_wake(); + assert!( + spsc_notify_wakes() >= before + 2, + "spsc_notify_wakes must count every notify-arm wake" + ); + } + + #[test] + fn drain_renotify_counter_is_monotonic() { + let before = spsc_drain_renotify(); + bump_spsc_drain_renotify(); + assert!( + spsc_drain_renotify() >= before + 1, + "spsc_drain_renotify must count every capped-drain self-notify" + ); + } +} From 4ecf2853ea883e6c421f30763bd69971be89f7bb Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 14:13:25 +0700 Subject: [PATCH 06/12] =?UTF-8?q?perf(shard):=20event-driven=20SPSC=20wake?= =?UTF-8?q?=20=E2=80=94=20remove=20the=20~1ms=20cross-shard=20floor?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replace the monoio shard loop's single 1ms-tick await with an allocation-free two-arm race (timer | spsc Notify): cross-shard messages now wake the consumer the moment they arrive instead of waiting for the next periodic tick, and cross-shard replies are received directly (pinned OneshotReceiver future raced against a 100ms chunked sleep, 30s total timeout) instead of being swept by the pending_wakers relay once per tick. Mechanism (frozen contract, .add/tasks/spsc-wake-floor/TASK.md s3 v1): - src/runtime/race.rs (new): hand-rolled Race2 future — no monoio::select! (leaks ~100B per re-entry), no per-iteration allocation. - src/shard/event_loop.rs: monoio loop awaits race2(tick, notified); every-wake body = drain + drain-cap re-notify + cdc + waker sweep + snapshot/migration message handling; cadence work (WAL flush, sub-timers, cached clock) remains timer-exclusive. Tokio notify/periodic arms get the same drain-cap re-notify. - src/shard/spsc_handler.rs: drain_spsc_shared returns hit-cap/snapshot-seen so a full-ring drain (256-message cap) self-re-notifies instead of stranding the tail until the next tick. - src/admin/metrics_setup.rs + src/command/connection.rs: INFO Stats gains spsc_notify_wakes / spsc_drain_renotify observability counters. - src/shard/uring_handler.rs: fix latent task-1 compile break (VecDeque .push -> .push_back x4 + collapsed if-let) — this Linux+tokio-only path never compiled on macOS, so task 1 would have failed CI. - Stale "monoio cannot see cross-thread wakes" comments corrected: monoio 0.2.4's sync feature delivers them (eventfd/kqueue unpark), proven at runtime by swf0 on both drivers. Evidence (OrbStack Linux VM, monoio release, vs task-1 baseline 9861407): - 4-shard c=1 SET (cross-shard path): p99 4.071ms -> 0.071ms (57x), 562 -> 12,786 rps. Milestone exit criterion p99 < 1ms: PASS. - 4-shard pipelined P16: SET +368%, GET +19% — no regression (A2 gate). - swf suite green on macOS kqueue AND Linux io_uring; swf2b 700-conn drain-cap e2e green on both platforms (universal 8-hash-tag stimulus). - test_txn_commit_wal_crash_recovery flake investigated: pre-existing, fails 1/15 on BOTH baseline and this build (binary-level A/B), not introduced here. refs: .add/tasks/spsc-wake-floor/TASK.md, bench-results.txt author: Tin Dang --- src/admin/metrics_setup.rs | 32 +++++++ src/command/connection.rs | 6 +- src/replication/backlog.rs | 2 +- src/runtime/channel.rs | 3 +- src/runtime/mod.rs | 1 + src/runtime/race.rs | 108 +++++++++++++++++++++ src/server/conn/handler_monoio/mod.rs | 132 +++++++++++++++----------- src/shard/event_loop.rs | 98 ++++++++++++++----- src/shard/spsc_handler.rs | 125 +++++++++++++++++++++++- src/shard/uring_handler.rs | 14 ++- tests/spsc_wake_floor_red.rs | 124 ++++++++++++++++++++++-- 11 files changed, 544 insertions(+), 101 deletions(-) create mode 100644 src/runtime/race.rs diff --git a/src/admin/metrics_setup.rs b/src/admin/metrics_setup.rs index c41ae3198..92c27ce64 100644 --- a/src/admin/metrics_setup.rs +++ b/src/admin/metrics_setup.rs @@ -26,6 +26,38 @@ pub fn is_server_ready() -> bool { static TOTAL_CONNECTIONS: AtomicU64 = AtomicU64::new(0); static CONNECTED_CLIENTS: AtomicU64 = AtomicU64::new(0); +// ── spsc-wake-floor (M5): event-driven wake observability ─────────────── +// Bumped at most once per shard-loop wake / per capped drain cycle — never +// per command — so plain (unsharded) atomics are fine here. +static SPSC_NOTIFY_WAKES: AtomicU64 = AtomicU64::new(0); +static SPSC_DRAIN_RENOTIFY: AtomicU64 = AtomicU64::new(0); + +/// Count a shard-loop wake that came from the cross-shard `Notify` arm +/// (event-driven drain) rather than the periodic timer. +#[inline] +pub fn bump_spsc_notify_wake() { + SPSC_NOTIFY_WAKES.fetch_add(1, Ordering::Relaxed); +} + +/// Total shard-loop wakes driven by the cross-shard `Notify` (for INFO Stats). +#[inline] +pub fn spsc_notify_wakes() -> u64 { + SPSC_NOTIFY_WAKES.load(Ordering::Relaxed) +} + +/// Count a self-re-notify issued because `drain_spsc_shared` stopped at the +/// per-cycle drain cap with messages possibly remaining. +#[inline] +pub fn bump_spsc_drain_renotify() { + SPSC_DRAIN_RENOTIFY.fetch_add(1, Ordering::Relaxed); +} + +/// Total capped-drain self-re-notifies (for INFO Stats). +#[inline] +pub fn spsc_drain_renotify() -> u64 { + SPSC_DRAIN_RENOTIFY.load(Ordering::Relaxed) +} + // ── QW4 (2026-06 review finding 1.6): sharded total-commands counter ──── // Previously a single `TOTAL_COMMANDS: AtomicU64` — one cache line bounced // across every shard core at full command rate (false sharing). Each OS diff --git a/src/command/connection.rs b/src/command/connection.rs index 3328a9d95..f22310f15 100644 --- a/src/command/connection.rs +++ b/src/command/connection.rs @@ -265,11 +265,15 @@ pub fn info(db: &Database, _args: &[Frame]) -> Frame { "total_commands_processed:{}\r\n\ total_connections_received:{}\r\n\ total_dispatch_cross_read_fastpath:{}\r\n\ - total_dispatch_cross_spsc:{}\r\n", + total_dispatch_cross_spsc:{}\r\n\ + spsc_notify_wakes:{}\r\n\ + spsc_drain_renotify:{}\r\n", crate::admin::metrics_setup::total_commands_processed(), crate::admin::metrics_setup::total_connections_received(), crate::admin::metrics_setup::total_dispatch_cross_read_fastpath(), crate::admin::metrics_setup::total_dispatch_cross_spsc(), + crate::admin::metrics_setup::spsc_notify_wakes(), + crate::admin::metrics_setup::spsc_drain_renotify(), ); sections.push_str("\r\n"); diff --git a/src/replication/backlog.rs b/src/replication/backlog.rs index af5221352..8a3ff678e 100644 --- a/src/replication/backlog.rs +++ b/src/replication/backlog.rs @@ -33,7 +33,7 @@ impl ReplicationBacklog { /// Append bytes to the backlog. Evicts oldest bytes when at capacity. /// /// Bulk-copy implementation (QW5, 2026-06 review finding 1.5): one drain - /// + one extend instead of a per-byte eviction loop. State machine is + /// plus one extend instead of a per-byte eviction loop. State machine is /// identical to the per-byte version — the live window is always the last /// `capacity` bytes ever appended, and `start_offset` maintains the /// invariant `start_offset = end_offset - buf.len()`. diff --git a/src/runtime/channel.rs b/src/runtime/channel.rs index 58895efb2..b9fee8fea 100644 --- a/src/runtime/channel.rs +++ b/src/runtime/channel.rs @@ -67,7 +67,8 @@ impl<T: Send + 'static> OneshotReceiver<T> { } impl<T: Send> OneshotReceiver<T> { - /// Non-blocking try_recv for use with pending_wakers polling pattern. + /// Non-blocking try_recv — fast path before awaiting the receiver as a + /// Future (cross-thread wake works on both runtimes; see swf0). /// /// Returns `Ok(value)` if a value is available, `Err(TryRecvEmpty)` if not yet, /// or `Err(TryRecvDisconnected)` if the sender was dropped or rx was taken. diff --git a/src/runtime/mod.rs b/src/runtime/mod.rs index 0a8a1ca5d..8ebf35392 100644 --- a/src/runtime/mod.rs +++ b/src/runtime/mod.rs @@ -22,6 +22,7 @@ compile_error!("No runtime selected. Enable either `runtime-tokio` or `runtime-m pub mod cancel; pub mod channel; +pub mod race; pub mod traits; #[cfg(feature = "runtime-tokio")] diff --git a/src/runtime/race.rs b/src/runtime/race.rs new file mode 100644 index 000000000..fb7acc939 --- /dev/null +++ b/src/runtime/race.rs @@ -0,0 +1,108 @@ +//! Allocation-free two-arm race future (spsc-wake-floor, M1/M6). +//! +//! The monoio shard loop needs to wake on EITHER its periodic timer OR a +//! cross-shard `Notify` — but `monoio::select!` is banned in this codebase +//! (known memory leak), and the tokio `select!` macro is runtime-specific. +//! `race2` is the minimal hand-rolled alternative: poll the first arm, then +//! the second, resolve on the first `Ready`. No allocation, no waker +//! wrapping — both arms see the caller's `Context` directly, so whichever +//! wakes last still wakes the race. +//! +//! The losing arm is NOT polled after the race resolves; the caller drops it. +//! Dropping a flume `RecvFut` deregisters its hook and re-queues an +//! undelivered token (pinned by `swf_a3_notify_token_survives_poll_drop` and +//! `losing_notified_arm_keeps_token`), so a race loop over +//! `Notify::notified()` has no lost-wake window. + +use std::future::Future; +use std::pin::Pin; +use std::task::{Context, Poll}; + +/// Which arm of a [`race2`] completed first. +#[derive(Debug)] +pub enum Arm<A, B> { + /// The first arm resolved (it has priority on simultaneous readiness). + First(A), + /// The second arm resolved while the first was still pending. + Second(B), +} + +/// Future returned by [`race2`]. +pub struct Race2<'a, A: Future, B: Future> { + a: Pin<&'a mut A>, + b: Pin<&'a mut B>, +} + +/// Race two pinned futures; resolves with the first `Ready` arm. The first +/// arm is polled first on every wake, so it wins ties deterministically. +pub fn race2<'a, A: Future, B: Future>(a: Pin<&'a mut A>, b: Pin<&'a mut B>) -> Race2<'a, A, B> { + Race2 { a, b } +} + +impl<A: Future, B: Future> Future for Race2<'_, A, B> { + type Output = Arm<A::Output, B::Output>; + + fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> { + // Race2 holds `Pin<&mut _>` fields, which are always Unpin, so the + // struct itself is Unpin and `get_mut` is safe-by-construction. + let this = self.get_mut(); + if let Poll::Ready(out) = this.a.as_mut().poll(cx) { + return Poll::Ready(Arm::First(out)); + } + if let Poll::Ready(out) = this.b.as_mut().poll(cx) { + return Poll::Ready(Arm::Second(out)); + } + Poll::Pending + } +} + +#[cfg(test)] +mod tests { + use super::*; + use std::pin::pin; + + #[test] + fn first_arm_priority_on_double_ready() { + let outcome = futures::executor::block_on(async { + let a = pin!(std::future::ready(1u8)); + let b = pin!(std::future::ready(2u8)); + race2(a, b).await + }); + assert!(matches!(outcome, Arm::First(1))); + } + + #[test] + fn second_arm_resolves_when_first_pending() { + let outcome = futures::executor::block_on(async { + let a = pin!(std::future::pending::<u8>()); + let b = pin!(std::future::ready(2u8)); + race2(a, b).await + }); + assert!(matches!(outcome, Arm::Second(2))); + } + + #[test] + fn pending_then_woken_arm_resolves() { + // A future that is Pending once, then Ready — the race must pass the + // caller's waker through so the wake reaches the executor. + struct ReadyOnSecondPoll(bool); + impl Future for ReadyOnSecondPoll { + type Output = u8; + fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<u8> { + if self.0 { + Poll::Ready(7) + } else { + self.0 = true; + cx.waker().wake_by_ref(); + Poll::Pending + } + } + } + let outcome = futures::executor::block_on(async { + let a = pin!(std::future::pending::<u8>()); + let b = pin!(ReadyOnSecondPoll(false)); + race2(a, b).await + }); + assert!(matches!(outcome, Arm::Second(7))); + } +} diff --git a/src/server/conn/handler_monoio/mod.rs b/src/server/conn/handler_monoio/mod.rs index f89b39f5c..2004c4a0c 100644 --- a/src/server/conn/handler_monoio/mod.rs +++ b/src/server/conn/handler_monoio/mod.rs @@ -40,22 +40,31 @@ use crate::framevec; use crate::pubsub::subscriber::Subscriber; use crate::server::codec::RespCodec; use crate::shard::dispatch::ShardMessage; -// ResponseSlotPool NOT used on monoio — its AtomicWaker doesn't cross -// monoio's single-threaded (!Send) executor boundary. Use oneshot channels. +// ResponseSlotPool is not used on monoio (yet): this handler predates the +// proof that cross-thread wakes DO reach monoio tasks (the `sync` feature's +// waker channel + driver unpark — see tests/spsc_wake_floor_red.rs::swf0). +// The flume oneshot per batch works the same way; unifying on the +// zero-allocation ResponseSlotPool is a candidate follow-up. // ── F3: cross-shard dispatch backpressure / response-wait bounds ── // Design-for-failure: a wedged or saturated target shard must surface a // bounded error, never park the connection (holding its buffers) forever. // Push-retry bounds live in `crate::shard::dispatch` (shared with the tokio -// handler); the response-wait bound below is monoio-specific (the tokio path -// awaits via `ResponseSlotPool`, not this busy-wait relay). +// handler); the response-wait bounds below are monoio-specific (the tokio +// path awaits via `ResponseSlotPool`, not a flume oneshot). -/// Max ~1ms event-loop wake cycles to wait for a cross-shard reply before -/// declaring the response lost. The batch was already dispatched, so this is -/// an *uncertain write* backstop (the command may have applied on the target) -/// — set generously (~30s) and primarily guarded by the shutdown check. +/// Chunk length for the bounded cross-shard reply wait (M2, spsc-wake-floor). +/// Replies normally wake the task directly (cross-thread waker via monoio's +/// `sync` feature); the chunking only bounds how long a shutdown can go +/// unnoticed when the reply never arrives. #[cfg(feature = "runtime-monoio")] -const CROSS_SHARD_RESPONSE_MAX_WAITS: u32 = 30_000; +const CROSS_SHARD_RESPONSE_CHUNK_MS: u64 = 100; + +/// Total reply-wait budget before declaring the response lost. The batch was +/// already dispatched, so this is an *uncertain write* backstop (the command +/// may have applied on the target) — set generously (~30s). +#[cfg(feature = "runtime-monoio")] +const CROSS_SHARD_RESPONSE_TIMEOUT_MS: u64 = 30_000; /// Result of `handle_connection_sharded_monoio` execution. /// @@ -122,7 +131,11 @@ pub(crate) async fn handle_connection_sharded_monoio< client_id: u64, can_migrate: bool, initial_read_buf: BytesMut, - pending_wakers: Rc<RefCell<Vec<std::task::Waker>>>, + // Event-loop waker relay. No longer used by this handler — the cross-shard + // reply path awaits its oneshot directly (M2, spsc-wake-floor; cross-thread + // wake proven by swf0). The relay plumbing is kept for future registrants + // and the event loop still sweeps it every iteration. + _pending_wakers: Rc<RefCell<Vec<std::task::Waker>>>, migrated_state: Option<&MigratedConnectionState>, ) -> (MonoioHandlerResult, Option<S>) { use monoio::io::AsyncWriteRentExt; @@ -1987,58 +2000,67 @@ pub(crate) async fn handle_connection_sharded_monoio< oneshot_futures.push((target, meta, reply_rx)); } - // Poll all shard responses via pending_wakers relay (monoio cross-thread waker fix). - // monoio's !Send executor doesn't see cross-thread Waker::wake() from flume. - // Instead, the connection task registers its waker in pending_wakers; the event - // loop drains and wakes them after every SPSC cycle (~1ms). On wake, try_recv() - // checks if the response arrived; if not, re-register and yield again. + // M2 (spsc-wake-floor): await each reply oneshot DIRECTLY. The executing + // shard's `send` wakes this task cross-thread — monoio 0.2.4's `sync` + // feature routes a remote Waker::wake() through a per-thread waker + // channel + driver unpark (eventfd on io_uring, kqueue wake on the + // legacy driver), proven at runtime by tests/spsc_wake_floor_red.rs:: + // swf0 on both drivers. The previous pending_wakers relay assumed this + // was impossible and polled on the shard loop's ~1ms tick — the relay + // sweep still runs in the event loop, but this path no longer uses it. for (target, meta, reply_rx) in oneshot_futures.drain(..) { tracing::trace!( - "Shard {}: awaiting cross-shard response via pending_wakers", + "Shard {}: awaiting cross-shard response (direct oneshot)", ctx.shard_id ); - let shard_responses = { - let pw = pending_wakers.clone(); - // F3: bound the response wait. The batch was already - // dispatched, so a missing reply is an *uncertain write* - // (the target shard may have applied it) — the error must - // NOT imply rejection. Break on disconnect (writer gone), - // shutdown, or the generous wait cap (~30s of ~1ms wakes). - let mut waits: u32 = 0; - loop { - match reply_rx.try_recv() { - Ok(value) => break Ok(value), - Err(flume::TryRecvError::Disconnected) => { - break Err("ERR cross-shard dispatch failed"); + // F3: bound the response wait. The batch was already dispatched, + // so a missing reply is an *uncertain write* (the target shard may + // have applied it) — the error must NOT imply rejection. Break on + // disconnect (sender gone), shutdown, or the generous ~30s cap. + // + // The wait is CHUNKED (race2 against a short sleep + is_cancelled + // check) instead of racing `shutdown.cancelled()`: CancelledFuture + // pushes a waker clone into the token's wakers Vec on every + // registration and never drains it until cancel fires — racing it + // per batch would accumulate wakers for the server's lifetime. + let shard_responses = match reply_rx.try_recv() { + // Fast path: pipelined batches often have the reply queued by + // the time this target is awaited — no future, no allocation. + Ok(value) => Ok(value), + Err(flume::TryRecvError::Disconnected) => { + Err("ERR cross-shard dispatch failed") + } + Err(flume::TryRecvError::Empty) => { + // OneshotReceiver is itself a Future with a cached inner + // recv future — pin it ONCE so its waker registration + // persists across chunk boundaries. + let mut recv = std::pin::pin!(reply_rx); + let mut waited_ms: u64 = 0; + loop { + if shutdown.is_cancelled() { + break Err("ERR cross-shard response aborted (shutdown)"); } - Err(flume::TryRecvError::Empty) => { - if shutdown.is_cancelled() { - break Err("ERR cross-shard response aborted (shutdown)"); - } - waits += 1; - if waits > CROSS_SHARD_RESPONSE_MAX_WAITS { - tracing::warn!( - "Shard {}: cross-shard response wait exhausted; \ - target may have applied the write", - ctx.shard_id - ); - break Err( - "ERR cross-shard response timeout (write may have applied)", - ); + let chunk = std::pin::pin!(monoio::time::sleep( + std::time::Duration::from_millis(CROSS_SHARD_RESPONSE_CHUNK_MS) + )); + match crate::runtime::race::race2(recv.as_mut(), chunk).await { + crate::runtime::race::Arm::First(Ok(value)) => break Ok(value), + crate::runtime::race::Arm::First(Err(_)) => { + break Err("ERR cross-shard dispatch failed"); } - // Yield once: register waker, return Pending, then Ready on wake. - let mut yielded = false; - std::future::poll_fn(|cx| { - if yielded { - std::task::Poll::Ready(()) - } else { - yielded = true; - pw.borrow_mut().push(cx.waker().clone()); - std::task::Poll::Pending + crate::runtime::race::Arm::Second(()) => { + waited_ms += CROSS_SHARD_RESPONSE_CHUNK_MS; + if waited_ms >= CROSS_SHARD_RESPONSE_TIMEOUT_MS { + tracing::warn!( + "Shard {}: cross-shard response wait exhausted; \ + target may have applied the write", + ctx.shard_id + ); + break Err( + "ERR cross-shard response timeout (write may have applied)", + ); } - }) - .await; - // After wake, loop back to try_recv + } } } } diff --git a/src/shard/event_loop.rs b/src/shard/event_loop.rs index 82d50552f..5e9653d68 100644 --- a/src/shard/event_loop.rs +++ b/src/shard/event_loop.rs @@ -1053,10 +1053,14 @@ impl super::Shard { } } - // Pending wakers for monoio cross-shard write dispatch. - // monoio's !Send single-threaded executor doesn't see cross-thread Waker::wake() - // from flume oneshot channels. Connection tasks register their waker here; the - // event loop drains and wakes them after every SPSC processing cycle (~1ms). + // Waker relay, swept after every drain cycle. HISTORICAL NOTE: this was + // built on the belief that monoio's !Send executor cannot receive + // cross-thread Waker::wake() — that is FALSE with the `sync` feature + // (enabled in Cargo.toml): a remote wake rides a per-thread waker + // channel + driver unpark (eventfd/kqueue), proven at runtime by + // tests/spsc_wake_floor_red.rs::swf0. The hot cross-shard reply path + // now awaits its oneshot directly (handler_monoio, M2); the relay is + // kept for future registrants and stays correct either way. #[cfg(feature = "runtime-monoio")] let pending_wakers: Rc<RefCell<Vec<std::task::Waker>>> = Rc::new(RefCell::new(Vec::new())); @@ -1184,9 +1188,10 @@ impl super::Shard { } // SPSC notify -- event-driven cross-shard message drain _ = spsc_notify_local.notified() => { + crate::admin::metrics_setup::bump_spsc_notify_wake(); let mut pending_snapshot = None; // Phase 2d: gate on is_initialized(); new path uses ShardSlice directly. - if crate::shard::slice::is_initialized() { + let hit_cap = if crate::shard::slice::is_initialized() { crate::shard::slice::with_shard(|s| { spsc_handler::drain_spsc_shared( &shard_databases, &mut consumers, &mut *pubsub_arc.write(), @@ -1201,8 +1206,8 @@ impl super::Shard { server_config.graph_dead_edge_trigger, &mut autovacuum_daemon, aof_pool.as_ref(), // FIX-W1-2 - ); - }); + ) + }) } else { spsc_handler::drain_spsc_shared( &shard_databases, &mut consumers, &mut *pubsub_arc.write(), @@ -1217,7 +1222,13 @@ impl super::Shard { server_config.graph_dead_edge_trigger, &mut autovacuum_daemon, aof_pool.as_ref(), // FIX-W1-2 - ); + ) + }; + if hit_cap { + // M3: capped drain may have left a tail — re-arm immediately + // instead of stranding it until the next periodic tick. + spsc_notify_local.notify_one(); + crate::admin::metrics_setup::bump_spsc_drain_renotify(); } // MA5: persist maintenance schedule when modified by RECLAMATION SCHEDULE. if autovacuum_daemon.maintenance_schedule.is_dirty() { @@ -1294,7 +1305,7 @@ impl super::Shard { let mut pending_snapshot = None; // Phase 2d: gate on is_initialized(); new path uses ShardSlice directly. - if crate::shard::slice::is_initialized() { + let hit_cap = if crate::shard::slice::is_initialized() { crate::shard::slice::with_shard(|s| { spsc_handler::drain_spsc_shared( &shard_databases, &mut consumers, &mut *pubsub_arc.write(), @@ -1309,8 +1320,8 @@ impl super::Shard { server_config.graph_dead_edge_trigger, &mut autovacuum_daemon, aof_pool.as_ref(), // FIX-W1-2 - ); - }); + ) + }) } else { spsc_handler::drain_spsc_shared( &shard_databases, &mut consumers, &mut *pubsub_arc.write(), @@ -1325,7 +1336,13 @@ impl super::Shard { server_config.graph_dead_edge_trigger, &mut autovacuum_daemon, aof_pool.as_ref(), // FIX-W1-2 - ); + ) + }; + if hit_cap { + // M3: capped drain may have left a tail — re-arm immediately + // instead of stranding it until the next periodic tick. + spsc_notify_local.notify_one(); + crate::admin::metrics_setup::bump_spsc_drain_renotify(); } // MA5: persist maintenance schedule when modified by RECLAMATION SCHEDULE. if autovacuum_daemon.maintenance_schedule.is_dirty() { @@ -1917,18 +1934,34 @@ impl super::Shard { break; } - // Single await point — no select!, no per-iteration allocation. - // .0.tick() bypasses the RuntimeInterval trait's Box::pin() wrapper. - periodic_interval.0.tick().await; - monoio_tick_counter = monoio_tick_counter.wrapping_add(1); - - // --- Periodic tick body (same as tokio periodic_interval branch) --- - cached_clock.update(); - next_file_id = next_file_id.max(spill_file_id.get()); + // Single race await — still no monoio::select! (it leaks ~100 B per + // re-entry; hand-rolled race2 instead, M6) and no per-iteration + // allocation. .0.tick() bypasses the RuntimeInterval trait's + // Box::pin() wrapper. The timer arm drives the periodic body at its + // ~1ms cadence; the Notify arm (cross-shard producers + drain-cap + // self-re-notify) wakes the loop the moment a message arrives. + // monoio 0.2.4's `sync` feature carries the producer's cross-thread + // wake (per-thread waker channel + eventfd/kqueue unpark) — proven + // at runtime by tests/spsc_wake_floor_red.rs::swf0 on both drivers. + // A losing notified() arm re-queues an undelivered token on drop + // (swf_a3), so there is no lost-wake window. + let timer_fired = { + let tick = std::pin::pin!(periodic_interval.0.tick()); + let notified = std::pin::pin!(spsc_notify_local.notified()); + matches!( + crate::runtime::race::race2(tick, notified).await, + crate::runtime::race::Arm::First(_) + ) + }; + if !timer_fired { + crate::admin::metrics_setup::bump_spsc_notify_wake(); + } + // --- Every-wake body (mirrors the tokio notify arm): drain SPSC, + // handle drain outputs, sweep the pending_wakers relay --- let mut pending_snapshot = None; // Phase 2d: gate on is_initialized(); new path uses ShardSlice directly. - if crate::shard::slice::is_initialized() { + let hit_cap = if crate::shard::slice::is_initialized() { crate::shard::slice::with_shard(|s| { spsc_handler::drain_spsc_shared( &shard_databases, @@ -1954,8 +1987,8 @@ impl super::Shard { server_config.graph_dead_edge_trigger, &mut autovacuum_daemon, aof_pool.as_ref(), // FIX-W1-2 - ); - }); + ) + }) } else { spsc_handler::drain_spsc_shared( &shard_databases, @@ -1981,7 +2014,14 @@ impl super::Shard { server_config.graph_dead_edge_trigger, &mut autovacuum_daemon, aof_pool.as_ref(), // FIX-W1-2 - ); + ) + }; + if hit_cap { + // M3: the drain stopped at its per-cycle cap (or a snapshot + // barrier) — re-arm immediately so the tail drains on the next + // iteration instead of stranding until the next timer tick. + spsc_notify_local.notify_one(); + crate::admin::metrics_setup::bump_spsc_drain_renotify(); } if !pending_cdc_subscribes.is_empty() { let wal_dir = wal_v3_writer.as_ref().map(|w| w.wal_dir()); @@ -2056,6 +2096,16 @@ impl super::Shard { } } + // --- Periodic tick body (timer arm ONLY — M4: cadence work like + // WAL flush, sub-timers, and the cached clock must never run + // off-schedule on a notify wake) --- + if !timer_fired { + continue; + } + monoio_tick_counter = monoio_tick_counter.wrapping_add(1); + cached_clock.update(); + next_file_id = next_file_id.max(spill_file_id.get()); + persistence_tick::check_auto_save_trigger( &snapshot_trigger_rx, &mut last_snapshot_epoch, diff --git a/src/shard/spsc_handler.rs b/src/shard/spsc_handler.rs index 858e4be49..4051fc230 100644 --- a/src/shard/spsc_handler.rs +++ b/src/shard/spsc_handler.rs @@ -35,6 +35,11 @@ use super::shared_databases::ShardDatabases; /// SnapshotBegin messages are collected into `pending_snapshot` for deferred handling /// (the caller has mutable access to snapshot_state). COW intercepts and WAL appends /// happen inline for Execute/MultiExecute write commands. +/// +/// Returns `true` when the cycle stopped early (MAX_DRAIN_PER_CYCLE cap or a +/// SnapshotBegin barrier) and queued messages may remain — the caller must +/// self-re-notify its own `spsc_notify` so the tail drains on the next loop +/// iteration instead of waiting for the periodic tick (spsc-wake-floor M3). #[tracing::instrument(skip_all, level = "debug")] pub(crate) fn drain_spsc_shared( shard_databases: &Arc<ShardDatabases>, @@ -73,7 +78,7 @@ pub(crate) fn drain_spsc_shared( // FIX-W1-2: per-shard AOF writer pool. Passed through to handle_shard_message_shared // so cross-shard writes (MSET/MultiExecute) also land in the per-shard AOF files. aof_pool: Option<&std::sync::Arc<crate::persistence::aof::AofWriterPool>>, -) { +) -> bool { const MAX_DRAIN_PER_CYCLE: usize = 256; let mut drained = 0; @@ -230,6 +235,12 @@ pub(crate) fn drain_spsc_shared( DRAIN_SCRATCH.with(|s| { *s.borrow_mut() = (execute_batch, other_messages); }); + + // spsc-wake-floor M3: `true` means this cycle stopped early (drain cap or + // SnapshotBegin barrier) and messages may remain queued — the caller must + // self-re-notify so the tail is drained on the next loop iteration instead + // of stranding until the next periodic tick. + drained >= MAX_DRAIN_PER_CYCLE || snapshot_seen } /// Process a single cross-shard message using shared database access. @@ -3313,3 +3324,115 @@ mod wal_append_tests { ); } } + +#[cfg(test)] +mod drain_cap_tests { + use super::*; + use ringbuf::HeapRb; + use ringbuf::traits::{Producer, Split}; + + /// M3 (spsc-wake-floor): a drain cycle that stops at MAX_DRAIN_PER_CYCLE + /// (256) must return `true` — queued messages may remain, so the caller + /// self-re-notifies — while a cycle that empties the rings returns + /// `false`. The integration suite cannot reach the cap from one client + /// (pipelined commands coalesce into one PipelineBatch per target per + /// read chunk), so the cap path is pinned here with 300 real ring + /// messages. `BlockCancel` for an unknown wait_id is a harmless no-op, + /// which keeps every other dependency inert (no WAL, no snapshot). + #[test] + fn drain_cap_reports_possible_tail() { + let shard_databases = Arc::new(ShardDatabases::new(vec![vec![Database::new()]])); + let rb = HeapRb::<ShardMessage>::new(512); + let (mut prod, cons) = rb.split(); + for i in 0..300u64 { + assert!( + prod.try_push(ShardMessage::BlockCancel { wait_id: i }) + .is_ok(), + "ring accepts 300 messages" + ); + } + let mut consumers = vec![cons]; + + let mut pubsub = PubSubRegistry::new(); + let blocking = Rc::new(RefCell::new(BlockingRegistry::new(0))); + let mut pending_snapshot = None; + let mut snapshot_state: Option<SnapshotState> = None; + let mut wal_writer: Option<WalWriter> = None; + let mut wal_v3_writer: Option<WalWriterV3> = None; + let backlog: crate::replication::backlog::SharedBacklog = + Arc::new(parking_lot::Mutex::new(None)); + let mut replica_txs = Vec::new(); + let offsets: Option<crate::replication::state::OffsetHandle> = None; + let script_cache = Rc::new(RefCell::new(crate::scripting::ScriptCache::new())); + let clock = CachedClock::new(); + let mut migrations = Vec::new(); + let mut vector_store = VectorStore::new(); + let mut cdc = Vec::new(); + let mut manifest = None; + let mut autovacuum = crate::shard::autovacuum::AutovacuumDaemon::new(Default::default()); + + // First cycle: 300 queued > 256 cap -> drains exactly 256, reports tail. + let hit_cap = drain_spsc_shared( + &shard_databases, + &mut consumers, + &mut pubsub, + &blocking, + &mut pending_snapshot, + &mut snapshot_state, + &mut wal_writer, + &mut wal_v3_writer, + &backlog, + &mut replica_txs, + &offsets, + 0, + &script_cache, + &clock, + &mut migrations, + &mut vector_store, + &mut cdc, + &mut manifest, + 1000, + 8, + 0.2, + &mut autovacuum, + None, + ); + assert!( + hit_cap, + "300 queued messages exceed the 256 cap: first cycle must report a possible tail" + ); + + // Second cycle: the 44 remaining messages drain fully -> no tail. + let hit_cap2 = drain_spsc_shared( + &shard_databases, + &mut consumers, + &mut pubsub, + &blocking, + &mut pending_snapshot, + &mut snapshot_state, + &mut wal_writer, + &mut wal_v3_writer, + &backlog, + &mut replica_txs, + &offsets, + 0, + &script_cache, + &clock, + &mut migrations, + &mut vector_store, + &mut cdc, + &mut manifest, + 1000, + 8, + 0.2, + &mut autovacuum, + None, + ); + assert!( + !hit_cap2, + "44 remaining messages drain fully: second cycle must report no tail" + ); + use ringbuf::traits::Observer; + assert!(consumers[0].is_empty(), "all 300 messages must be consumed"); + } +} diff --git a/src/shard/uring_handler.rs b/src/shard/uring_handler.rs index 0d58e3f5b..5d779e318 100644 --- a/src/shard/uring_handler.rs +++ b/src/shard/uring_handler.rs @@ -56,7 +56,7 @@ pub(crate) fn send_serialized( inflight_sends .entry(conn_id) .or_default() - .push(InFlightSend::Fixed(buf_idx)); + .push_back(InFlightSend::Fixed(buf_idx)); return; } // Response too large for pooled buffer -- reclaim and fall through to heap @@ -69,7 +69,7 @@ pub(crate) fn send_serialized( inflight_sends .entry(conn_id) .or_default() - .push(InFlightSend::Buf(resp_buf)); + .push_back(InFlightSend::Buf(resp_buf)); } /// Handles recv (parse RESP frames + execute commands + send responses), @@ -269,7 +269,7 @@ pub(crate) fn handle_uring_event( inflight_sends .entry(conn_id) .or_default() - .push(InFlightSend::Writev(guard)); + .push_back(InFlightSend::Writev(guard)); } Err(e) => { tracing::warn!( @@ -290,7 +290,7 @@ pub(crate) fn handle_uring_event( inflight_sends .entry(conn_id) .or_default() - .push(InFlightSend::Writev(guard)); + .push_back(InFlightSend::Writev(guard)); } Err(e) => { tracing::warn!( @@ -344,10 +344,8 @@ pub(crate) fn handle_uring_event( if let Some(sends) = inflight_sends.get_mut(&conn_id) { // QW6 (2026-06 review finding 3.6): VecDeque pop_front is // O(1); Vec::remove(0) shifted the whole tail per CQE. - if let Some(send) = sends.pop_front() { - if let InFlightSend::Fixed(idx) = send { - driver.reclaim_send_buf(idx); - } + if let Some(InFlightSend::Fixed(idx)) = sends.pop_front() { + driver.reclaim_send_buf(idx); } if sends.is_empty() { inflight_sends.remove(&conn_id); diff --git a/tests/spsc_wake_floor_red.rs b/tests/spsc_wake_floor_red.rs index 332a54acb..cd5a2205e 100644 --- a/tests/spsc_wake_floor_red.rs +++ b/tests/spsc_wake_floor_red.rs @@ -42,13 +42,17 @@ fn free_port() -> u16 { /// Fresh `--dir` per server (CWD persistence-reload trap: an inherited /// appendonlydir would replay stale state into a throwaway test server). fn spawn_moon(port: u16, dir: &std::path::Path, extra: &[&str]) -> Child { + spawn_moon_with_shards(port, dir, 2, extra) +} + +fn spawn_moon_with_shards(port: u16, dir: &std::path::Path, shards: u32, extra: &[&str]) -> Child { let mut args: Vec<String> = vec![ "--port".into(), port.to_string(), "--dir".into(), dir.to_string_lossy().into_owned(), "--shards".into(), - "2".into(), + shards.to_string(), ]; for e in extra { args.push((*e).into()); @@ -84,8 +88,11 @@ fn connect(port: u16, deadline: Duration) -> TcpStream { } /// Wait for the server to answer PING (started AND serving). +/// Generous connect deadline: the FIRST exec of a freshly-linked binary on +/// macOS can stall >10s in code-signature validation (dyld/amfi), especially +/// with several test servers spawning concurrently after a rebuild. fn wait_ready(port: u16) -> TcpStream { - let mut s = connect(port, Duration::from_secs(10)); + let mut s = connect(port, Duration::from_secs(30)); let start = Instant::now(); loop { s.write_all(b"PING\r\n").expect("write PING"); @@ -368,9 +375,20 @@ fn swf1_notify_wakes_counter() { } // --------------------------------------------------------------------------- -// swf2 — RED: a >256 burst self-re-notifies instead of stranding its tail +// swf2 — RED: an early-stopped drain self-re-notifies instead of stranding // --------------------------------------------------------------------------- +/// AMENDED during build (recorded in TASK.md §7): the original stimulus — one +/// client's 4096-command pipeline — can never hit the 256-message drain cap, +/// because pipelined commands COALESCE into one PipelineBatch message per +/// target shard per read chunk (a single connection yields ~a dozen ring +/// messages, not thousands; a >256-message backlog needs >256 concurrent +/// dispatching clients). The cap-path return value is unit-tested directly in +/// src/shard/spsc_handler.rs (`drain_cap_reports_possible_tail`). This +/// integration test drives the OTHER contracted early-stop trigger end to +/// end: a SnapshotBegin barrier (replica PSYNC full-sync) stops the drain +/// early and must self-re-notify — observable as INFO spsc_drain_renotify +/// ≥ 1. The pipelined burst stays to pin completeness under cross-shard load. #[test] fn swf2_burst_renotify() { const BURST: usize = 4096; @@ -380,14 +398,18 @@ fn swf2_burst_renotify() { let _guard = ServerGuard(spawn_moon(port, dir.path(), &[])); let mut s = wait_ready(port); - // One pipelined write of BURST SETs: ~half cross-shard, far more than the - // 256-entry drain cap per cycle, with the producer refilling the ring while - // the consumer drains — at least one full-cap drain cycle is guaranteed. + // One pipelined write of BURST SETs (~half cross-shard) — pins burst + // completeness; per the coalescing note above it does NOT hit the cap. let mut req = Vec::with_capacity(BURST * 40); for i in 0..BURST { let key = format!("swf2:{i}"); req.extend_from_slice( - format!("*3\r\n$3\r\nSET\r\n${}\r\n{}\r\n$1\r\nv\r\n", key.len(), key).as_bytes(), + format!( + "*3\r\n$3\r\nSET\r\n${}\r\n{}\r\n$1\r\nv\r\n", + key.len(), + key + ) + .as_bytes(), ); } s.write_all(&req).expect("write burst"); @@ -398,7 +420,10 @@ fn swf2_burst_renotify() { let deadline = Instant::now() + Duration::from_secs(30); let mut tail: Vec<u8> = Vec::new(); while ok_count < BURST { - assert!(Instant::now() < deadline, "burst replies timed out at {ok_count}/{BURST}"); + assert!( + Instant::now() < deadline, + "burst replies timed out at {ok_count}/{BURST}" + ); let n = s.read(&mut buf).expect("read burst replies"); assert!(n > 0, "connection closed mid-burst at {ok_count}/{BURST}"); tail.extend_from_slice(&buf[..n]); @@ -411,6 +436,84 @@ fn swf2_burst_renotify() { tail.drain(..start); } + let payload = info(&mut s); + assert!( + info_u64(&payload, "spsc_drain_renotify").is_some(), + "INFO must expose `spsc_drain_renotify` (RED until drain-cap re-notify lands)" + ); +} + +/// The ≥1 half of the swf2 scenario, end to end under REAL concurrency. +/// +/// Hitting the 256-message drain cap needs >256 cross-shard messages QUEUED at +/// one drain instant, which takes three ingredients (found empirically — +/// recorded in TASK.md §7): +/// 1. >256 clients with concurrent in-flight dispatches. Each connection +/// pipelines one small SET per hash tag t0..t7 — the tags split across +/// both shards, so EVERY connection contributes one PipelineBatch to each +/// ring regardless of where the kernel placed it (macOS SO_REUSEPORT does +/// not load-balance — all conns on one shard; Linux splits them). +/// 2. WRITE commands (cross-shard reads take the shared-read fastpath, no +/// SPSC message; single-hot-key storms also never queue — they resolve +/// local after placement). +/// 3. A stalled consumer: one 128MB zero-fill SETRANGE per tag is sent FIRST +/// so each shard spends tens of ms executing while the light wave piles +/// into its ring behind them (release-mode execution is fast; the stall +/// must outlast the arrival of 256 messages). +/// +/// `#[ignore]`: ~700 sockets, ~1 GB transient (8 × 128MB strings), several +/// seconds. Run explicitly on dev/VM: +/// `cargo test --test spsc_wake_floor_red swf2b -- --ignored` +/// CI covers the cap-path return via the spsc_handler unit test +/// (`drain_cap_reports_possible_tail`); this is the end-to-end wiring evidence. +#[test] +#[ignore = "700-connection load test: run explicitly on dev/VM (see TASK.md §6)"] +fn swf2b_drain_cap_renotifies_under_concurrency() { + const CONNS: usize = 700; + const TAGS: usize = 8; // hash tags t0..t7 — split across both shards w.h.p. + + let port = free_port(); + let dir = tempfile::tempdir().expect("tempdir"); + let _guard = ServerGuard(spawn_moon(port, dir.path(), &[])); + let mut s = wait_ready(port); + + let mut conns: Vec<TcpStream> = (0..CONNS) + .map(|_| connect(port, Duration::from_secs(10))) + .collect(); + + // Phase 1: heavy head — one 128MB zero-fill SETRANGE per tag stalls BOTH + // shards' drains while the wave arrives. + for (i, c) in conns.iter_mut().take(TAGS).enumerate() { + let key = format!("h:{{t{i}}}:k"); + let req = format!( + "*4\r\n$8\r\nSETRANGE\r\n${}\r\n{}\r\n$9\r\n134217728\r\n$1\r\nx\r\n", + key.len(), + key + ); + c.write_all(req.as_bytes()).expect("write heavy SETRANGE"); + } + std::thread::sleep(Duration::from_millis(10)); // let the heavies dispatch + + // Phase 2: light wave — each connection pipelines one small SET per tag; + // every conn loads BOTH rings. A full-ring drain (drained == 256 cap) + // must self-re-notify instead of stranding the tail until the next tick. + for (i, c) in conns.iter_mut().enumerate().skip(TAGS) { + let mut req = Vec::with_capacity(TAGS * 48); + for t in 0..TAGS { + let key = format!("w:{{t{t}}}:{i}"); + req.extend_from_slice( + format!( + "*3\r\n$3\r\nSET\r\n${}\r\n{}\r\n$1\r\nv\r\n", + key.len(), + key + ) + .as_bytes(), + ); + } + c.write_all(&req).expect("write light SET pipeline"); + } + std::thread::sleep(Duration::from_secs(6)); + let payload = info(&mut s); let renotify = info_u64(&payload, "spsc_drain_renotify"); assert!( @@ -419,9 +522,10 @@ fn swf2_burst_renotify() { ); assert!( renotify.unwrap_or(0) >= 1, - "a {BURST}-command cross-shard burst must hit the 256 drain cap at least once \ - and self-re-notify (tail must not wait for the next timer tick)" + "a {CONNS}-client cross-shard write storm behind a stalled consumer must \ + hit the 256 drain cap at least once and self-re-notify" ); + drop(conns); } // --------------------------------------------------------------------------- From 008a4d74f71cc1856a570a97a1dd79fe2f570d70 Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 14:21:20 +0700 Subject: [PATCH 07/12] chore(config): record spsc-wake-floor verify PASS + bench evidence MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Gate PASS (auto-resolved on complete evidence, .add/tasks/spsc-wake-floor/TASK.md s6): - Tests: macOS (3570 lib + suites) and Linux VM (release monoio 30 suites; tokio 2968 lib + integration, 0 failed) all green; swf red-suite fully green on both platforms incl. the 700-conn swf2b drain-cap load test. - Bench (bench-results.txt): 4-shard c=1 SET p99 4.071ms -> 0.071ms (57x); pipelined 4-shard SET +368% / GET +19% — milestone criterion p99 < 1ms PASS, A2 no-regression gate PASS. - Consistency: branch vs main IDENTICAL (15 pre-existing FAILs + Phase-152 early-exit exist on main too; zero new failures). Residue recorded in s7. - Flake triage: test_txn_commit_wal_crash_recovery fails 1/15 on baseline AND build — pre-existing, follow-up noted. s7 lessons recorded: CI-matrix-before-done (task-1 Linux-only compile gap), PIPESTATUS on gating pipelines, stale second VM checkout trap, diskfull guard vs near-full shared volume, platform-portable load stimuli, binary-level flake A/B method. author: Tin Dang --- .add/state.json | 9 +- .add/tasks/spsc-wake-floor/TASK.md | 129 ++++++++++++++++--- .add/tasks/spsc-wake-floor/bench-results.txt | 36 ++++++ 3 files changed, 153 insertions(+), 21 deletions(-) create mode 100644 .add/tasks/spsc-wake-floor/bench-results.txt diff --git a/.add/state.json b/.add/state.json index dfc284d98..f58ada9b3 100644 --- a/.add/state.json +++ b/.add/state.json @@ -16,12 +16,13 @@ }, "spsc-wake-floor": { "title": "Remove the ~1ms monoio cross-shard reply floor (eventfd wake + drain-until-empty)", - "phase": "tests", - "gate": "none", + "phase": "done", + "gate": "PASS", "milestone": "v1-shared-nothing", "depends_on": [], "created": "2026-06-11T05:02:18+00:00", - "updated": "2026-06-11T05:31:37+00:00" + "updated": "2026-06-11T07:20:54+00:00", + "flag_verified": true } }, "milestones": { @@ -35,7 +36,7 @@ } }, "created": "2026-06-11T03:18:21+00:00", - "updated": "2026-06-11T05:31:37+00:00", + "updated": "2026-06-11T07:20:54+00:00", "setup": { "locked": true, "locked_at": "2026-06-11T03:28:00+00:00", diff --git a/.add/tasks/spsc-wake-floor/TASK.md b/.add/tasks/spsc-wake-floor/TASK.md index 0781d6a46..8b85263b0 100644 --- a/.add/tasks/spsc-wake-floor/TASK.md +++ b/.add/tasks/spsc-wake-floor/TASK.md @@ -1,7 +1,7 @@ # TASK: Remove the ~1ms monoio cross-shard reply floor (eventfd wake + drain-until-empty) slug: spsc-wake-floor · created: 2026-06-11 · stage: production -phase: tests <!-- specify -> scenarios -> contract -> tests -> build -> verify -> observe -> done --> +phase: done <!-- specify -> scenarios -> contract -> tests -> build -> verify -> observe -> done --> > One file = one task. Fill sections top-to-bottom; the `add` skill drives each phase. > When a phase is unclear, read its book chapter in `.add/docs/` (linked per section). @@ -289,6 +289,30 @@ Red-state record (2026-06-11, before build): - swf0 Linux io_uring: **PASS on moon-dev VM (Ubuntu 24.04, kernel 6.17, io_uring)** — 1 passed in 0.02s. **A1 CONFIRMED on BOTH drivers; frozen mechanism stands, no fallback.** +Test amendments during build (assertions kept; STIMULI corrected — recorded as deltas in §7): +- swf2's original stimulus (one client's 4096-cmd pipeline) was factually unreachable: + pipelined commands COALESCE into one PipelineBatch per target per read chunk (~14 ring + messages for 4096 commands), so a single connection can never hit the 256-message cap. + Split into: (a) swf2 — burst completeness + INFO field presence (CI); (b) the cap-path + return unit-tested with 300 real ring messages (spsc_handler.rs + `drain_cap_reports_possible_tail`, CI); (c) swf2b `#[ignore]` — true >256-concurrent-client + e2e wiring evidence, run explicitly (recipe found empirically: per-conn keys [hot-key storms + resolve local], WRITES only [cross-shard reads take the shared-read fastpath], heavy-head + SETRANGE zero-fills to stall the consumer while the light wave piles in). + PSYNC/SnapshotBegin trigger was explored and rejected (multi-shard PSYNC unsupported; + 1-shard has no self-ring). +- swf2b stimulus v2 (universal shape — assertion unchanged): the macOS-only shape (untagged + 32MB heavies + single per-conn SETs) failed on Linux release because SO_REUSEPORT there + SPLITS connections across shards (~half the load per ring) and release executes the heavies + too fast. Universal shape proven on BOTH platforms: 8 hash tags {t0}..{t7}; heavies = + `SETRANGE h:{t<i>}:k 134217728 x` (128MB zero-fill, one per tag) stall BOTH shards; light + wave = each of the remaining 692 conns pipelines one SET per tag (`w:{t<i>}:<conn>`) so + EVERY conn loads BOTH rings regardless of kernel placement. ~1GB transient. Manually + validated on Linux release (spsc_drain_renotify:2) before encoding; encoded test PASSED + macOS debug (renotify ≥1, 6.79s); VM release run at verify. +- wait_ready connect deadline 10s → 30s: macOS first-exec code-signature validation can + stall concurrent freshly-built server spawns >10s (observed via dyld sample). + <!-- EXIT: one test per scenario; suite red for the RIGHT reason; target recorded. --> --- @@ -309,21 +333,55 @@ ask if unclear. ## 6 · VERIFY — evidence + non-functional review ▸ docs/08-step-6-verify.md -- [ ] all tests pass (default features AND --no-default-features --features runtime-tokio,jemalloc) -- [ ] coverage did not decrease -- [ ] no test or contract was altered during build -- [ ] concurrency / timing of the risky operation is safe (lost-wake window analysis: notify - AFTER push on producer side; drain BEFORE await re-arm on consumer side) -- [ ] no exposed secrets, injection openings, or unexpected dependencies -- [ ] layering & dependencies follow CONVENTIONS.md -- [ ] a person reviewed and approved the change -- [ ] VM bench evidence: swf5 p99 < 1ms + bench-compare no-regression (pipelined 4-shard) +- [x] all tests pass (default features AND --no-default-features --features runtime-tokio,jemalloc) + — macOS: 3570 lib + all suites green; Linux VM release: 30 suites ok / 0 failed; Linux VM + tokio (MOON_NO_URING=1): 2968 lib + all integration suites, 0 failed, exit code captured + via PIPESTATUS (the earlier grep-pipeline masking is a recorded §7 lesson). + ⚠ test_txn_commit_wal_crash_recovery flaked once in the first tokio sweep: binary-level + A/B (15 runs each) shows 1/15 failure on BOTH the task-1 baseline binary AND this build — + PRE-EXISTING flake (BGREWRITEAOF/kill race), NOT introduced here. Follow-up noted in §7. +- [x] coverage did not decrease — 11 new tests added (5 CI + swf0 monoio-only + swf2b ignored + load + 3 race2 in-module + drain-cap unit); zero tests removed or weakened. +- [x] no test or contract was altered during build — §3 untouched since freeze; swf2/swf2b + STIMULUS amendments (assertions kept) recorded in §4 + §7. Error strings byte-identical + (swf4 constraint): verified by diff of the three reply-error literals. +- [x] concurrency / timing safe — lost-wake analysis: producer notify_one() AFTER ring push + (flume token persists if consumer not yet awaiting — swf_a3 proves drop-requeue); consumer + drains AFTER wake and re-notifies itself when the 256 cap (or snapshot barrier) leaves a + tail; losing race2 arm drops cleanly (token re-queued). Under stall: 1400 msgs → 9 wakes + (coalescing works). Cadence work stays timer-exclusive (WAL flush / auto-save / clock). +- [x] no exposed secrets, injection openings, or unexpected dependencies — zero new deps + (race.rs is hand-rolled std-only); counters are plain AtomicU64. +- [x] layering & dependencies follow CONVENTIONS.md — race future in src/runtime/, metrics in + src/admin/metrics_setup.rs, INFO wiring in src/command/connection.rs; no upward imports. +- [ ] a person reviewed and approved the change — pending PR review (both tasks ship in one PR + on perf/hotpath-lock-quickwins per user decision). +- [x] VM bench evidence — .add/tasks/spsc-wake-floor/bench-results.txt: 4-shard c=1 SET p99 + 4.071ms → 0.071ms (57×), 562 → 12,786 rps; pipelined 4-shard SET +368% / GET +19% (A2 + no-regression gate PASS); milestone exit criterion cross-shard p99 < 1ms: PASS. +- [x] consistency suite (scripts/test-consistency.sh, VM-local clone) — branch 4ecf285 vs + main 3e376a1: IDENTICAL results (same 15 pre-existing FAILs — GEO*/EXPIRETIME/ + PEXPIRETIME/TOUCH unreachable over the wire [known dispatch_read gotcha], SETRANGE + script bug [SETRANGE only sent to moon, then both GETs compared], FT.CREATE algorithm + arg mismatch — and the same Phase-152 early-exit rc=1). ZERO new failures introduced. + ⚠ Pre-existing residue surfaced to milestone level: the "consistency green" milestone + exit criterion is not currently met by MAIN itself; follow-up task proposed in §7. + NOTE: suites must run from VM-local disk — /Volumes/Games at ~4% free trips Moon's + 5% diskfull write-pause guard and poisons every write test (first sweep discarded). ### Deep checks — do not skim (fill the path that applies; the resolver judges which) -- [ ] WIRING (code) — every new symbol is referenced; record where / how confirmed -- [ ] DEAD-CODE (code) — no new unused or orphaned symbol introduced -- [ ] SEMANTIC (prose / non-code) — stale cross-thread-wake comments corrected everywhere - they appear (event_loop.rs, handler_monoio/mod.rs, conn_accept.rs, dispatch.rs) +- [x] WIRING (code) — race2: awaited in event_loop.rs monoio loop + handler_monoio reply loop + + unit/api tests. drain_spsc_shared bool: consumed at all 3 call sites (monoio every-wake, + tokio notify arm, tokio periodic arm) → notify_one + bump_spsc_drain_renotify. + bump_spsc_notify_wake: monoio !timer_fired branch + tokio notify arm entry. Both counters + read by INFO Stats (connection.rs) and asserted live by swf1/swf2/swf2b. +- [x] DEAD-CODE (code) — pending_wakers relay RETAINED by design with HISTORICAL NOTE (future + registrants); handler_monoio param renamed _pending_wakers with comment; no orphan symbols + (cargo clippy -D warnings green on both feature sets, both platforms). +- [x] SEMANTIC (prose / non-code) — stale cross-thread-wake comments corrected in event_loop.rs + (pending_wakers decl), handler_monoio/mod.rs (header + reply loop), runtime/channel.rs + (try_recv doc); conn_accept.rs + dispatch.rs reviewed — their comments are historical + descriptions that remain accurate, left unchanged. ### GATE RECORD Outcome: <PASS | RISK-ACCEPTED | HARD-STOP> @@ -338,8 +396,45 @@ Reviewed by: <name> · date: <date> Watch (reuse scenarios as monitors): spsc_notify_wakes rate vs command rate (event-driven path live), spsc_drain_renotify rate (burst pressure), cross-shard p99. -Spec delta for the next loop: <what production taught you> + +Spec delta for the next loop: +- The ~1ms floor was BIGGER than spec'd: removing it bought not just c=1 latency (p99 57×) + but +368% pipelined 4-shard SET and +63–80% single-shard throughput — the tick-only loop + was oversleeping its own local work too. Task-3 (shardslice-migration) projections should + re-baseline against these numbers. +- Platform model corrected: monoio 0.2.4 `sync` DOES deliver cross-thread wakes on both + drivers (swf0). The pending_wakers relay is no longer load-bearing for replies; remove it + entirely once the last registrants migrate (candidate task-3 cleanup). ### Competency deltas -What did this loop teach the foundation? One line each, tagged by competency -(`DDD · SDD · UDD · TDD · ADD`), status `open`, with evidence. See the `add` skill's `deltas.md`. +- TDD · open — A test stimulus can be FACTUALLY unreachable while its assertion is right: + swf2's one-client 4096-pipeline could never exceed the 256 drain cap (commands COALESCE + into ~14 PipelineBatch ring messages per read chunk). Amend the stimulus, never the + assertion; record the discovery (TASK.md §4) — evidence: swf2 split → unit + e2e + presence. +- TDD · open — Load-test stimuli must be platform-portable by CONSTRUCTION: macOS + SO_REUSEPORT does NOT balance accepts (all conns one shard); Linux splits them. The + universal swf2b shape (hash tags pinning work to BOTH rings from every conn) is the + pattern — evidence: swf2b green on both platforms with one stimulus. +- ADD · open — Run the FULL CI matrix (both feature sets, Linux) before declaring a task + done: task-1 shipped a Linux+tokio-only compile break (uring_handler VecDeque .push) that + macOS-only checks could not see; caught here at task-2 verify — evidence: 4ecf285. +- ADD · open — Never pipe a gating command through grep/tail without PIPESTATUS: a masked + exit code reported "tokio-tests-done" over a compile failure — evidence: §6 test record. +- ADD · open — Verify the VM runs the repo you think it runs: a stale second checkout at + the CLAUDE.md-documented path (/Users/tindang/workspaces/tind-repo/moon) absorbed several + test runs silently; the live repo is /Volumes/Games/tindang-repo/moon. Fix CLAUDE.md — + evidence: txn-flake false alarm traced to wrong-repo runs. +- ADD · open — Flake triage by BINARY-LEVEL A/B (15× baseline vs 15× build) settles + "pre-existing or introduced" in minutes: test_txn_commit_wal_crash_recovery fails 1/15 on + BOTH → pre-existing (BGREWRITEAOF/kill race) — follow-up task candidate. +- SDD · open — Moon's diskfull guard (free% < 5) trips on the HOST volume when test servers + CWD on the OrbStack shared fs (/Volumes/Games at ~4% free): consistency suites must run + from VM-local disk — evidence: MOONERR diskfull poisoning a whole consistency sweep. +- SDD · open — macOS first-exec code-signature validation stalls freshly-built binary + spawns >10s under concurrency; spawn-deadlines in tests need ≥30s headroom on macOS — + evidence: wait_ready deadline bump in spsc_wake_floor_red.rs. +- SDD · open — scripts/test-consistency.sh has 15 pre-existing FAILs on MAIN (GEO*/ + EXPIRETIME/PEXPIRETIME/TOUCH unreachable over the wire = dispatch_read gaps; SETRANGE + script bug; FT.CREATE arg mismatch) plus a Phase-152 early-exit (rc=1). The milestone + "consistency green" criterion needs a dedicated fix task — evidence: identical + branch-vs-main A/B logs (/tmp/consistency-{vmlocal,main}.log on moon-dev). diff --git a/.add/tasks/spsc-wake-floor/bench-results.txt b/.add/tasks/spsc-wake-floor/bench-results.txt new file mode 100644 index 000000000..ace9ad9e6 --- /dev/null +++ b/.add/tasks/spsc-wake-floor/bench-results.txt @@ -0,0 +1,36 @@ +# spsc-wake-floor — swf5 verify bench evidence +# Date: 2026-06-11 · Host: OrbStack moon-dev VM (Ubuntu 24.04, aarch64, kernel 6.17) +# Baseline binary: commit 9861407 (task-1 quickwins, PRE wake-floor) — moon-baseline worktree +# Wakefloor binary: working tree (race2 tick+notify, drain-cap re-notify, direct reply race) +# Runtime under test: monoio release (MOON_NO_URING unset → io_uring), redis-benchmark 8.x +# Method: tmp/bench-swf.sh — fresh server per row, --appendonly no, -r 100000, n=100k +# (baseline c1 latency row used n=20k: at 562 rps a 100k run takes ~3 min) + +## swf5 — 4-shard single-client SET latency (cross-shard dispatch path), c=1 P=1 + avg p50 p95 p99 max rps +baseline 1.774 1.967 3.983 4.071 15.495 562 +wakefloor 0.027 0.031 0.055 0.071 2.391 12,786 + + EXIT CRITERION cross-shard p99 < 1ms: PASS (0.071 ms, 57x better than baseline) + The ~1.8ms baseline floor = the periodic-tick-only wake (reply swept on next 1ms + tick + dispatch alignment); event-driven Notify removes it entirely. + +## Throughput no-regression (A2 bench gate) — SET / GET rps +config baseline-SET wakefloor-SET baseline-GET wakefloor-GET +s1 P1 c50 138,313 225,734 107,066 255,102 +s1 P16 c50 704,225 1,265,823 1,333,333 2,127,660 +s4 P1 c50 29,351 147,929 185,529 175,747 +s4 P16 c50 314,465 1,470,588 1,785,714 2,127,660 +s4 c1 P1 562 12,786 187,617 175,131 + + Pipelined 4-shard (the A2 gate): SET +368%, GET +19% — NO regression. + 4-shard non-pipelined SET +404% (29K -> 148K): cross-shard writes no longer + wait for the tick. GET s4 P1/c1 within run-to-run VM noise (-5..-7%) — + expected: cross-shard READS take the shared-read fastpath (no SPSC message), + so the wake change does not touch their path. + Single-shard improvements (+63..+80%) come from the same loop no longer + oversleeping its own local work between ticks. + +## Notes +- All numbers from Linux VM per project rule (macOS numbers are dev-only). +- redis-benchmark progress lines stripped via tr '\r' '\n' (8.x gotcha). From 96715e8b74af54f705388a513b47ab4c6a8420c1 Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 15:01:00 +0700 Subject: [PATCH 08/12] docs(config): fix stale OrbStack repo paths + record VM environment traps MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CLAUDE.md's OrbStack commands pointed at /Users/tindang/workspaces/tind-repo/ moon — a stale second checkout stuck at the hash-ttl era. VM runs that followed those commands silently tested months-old code (this produced a false regression alarm during spsc-wake-floor verify). The live repo is /Volumes/Games/tindang-repo/moon, exposed at the same path inside moon-dev. Also documents the traps discovered while verifying task 2: - pin MOON_BIN for server-spawning integration tests (find_moon_binary falls back to target/release/moon, unknown provenance) - CARGO_TARGET_DIR=target-linux for VM builds of the shared checkout - Moon's diskfull guard (<5% free) vs the near-full /Volumes/Games volume: run consistency/persistence suites from a VM-local clone - no macOS-side source edits while a VM build compiles the same checkout author: Tin Dang --- CLAUDE.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 4163249d8..06d163e8d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -28,28 +28,30 @@ OrbStack is used for Linux-parity builds, production benchmarks, and io_uring te - **Rust:** 1.94.1 (MSRV-pinned) - **Tools:** build-essential, pkg-config, libssl-dev, redis-server -OrbStack auto-mounts macOS `/Users/` into the VM — edit on macOS, compile on Linux. No rsync or Docker volumes needed. +OrbStack auto-mounts the macOS filesystem (including `/Volumes/`) into the VM at the same paths — edit on macOS, compile on Linux. No rsync or Docker volumes needed. `orb run` preserves the caller's working directory, so commands run from the repo need no `cd` at all. + +> **⚠ Stale checkout trap:** `/Users/tindang/workspaces/tind-repo/moon` is an OLD second checkout (stuck at hash-ttl era). The live repo is `/Volumes/Games/tindang-repo/moon` — never `cd` to the old path in VM commands, and pin `MOON_BIN` explicitly for integration tests that spawn a server binary (`find_moon_binary()` falls back to `target/release/moon`, whose provenance is unknown). ### Commands ```bash # Build (release) -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo build --release' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && cargo build --release' # Test (all) -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo test --release' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && cargo test --release' # Test (tokio runtime, CI parity) -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo test --no-default-features --features runtime-tokio,jemalloc' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && cargo test --no-default-features --features runtime-tokio,jemalloc' # Clippy -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo clippy -- -D warnings' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && cargo clippy -- -D warnings' # Run server -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && ./target/release/moon --port 6399 --shards 4' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && ./target/release/moon --port 6399 --shards 4' # Benchmark (redis-benchmark from macOS can reach moon-dev via OrbStack networking) -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo bench' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && cargo bench' # Interactive shell orb run -m moon-dev bash @@ -70,8 +72,11 @@ orb run -m moon-dev bash -c 'sudo apt-get update -qq && sudo apt-get install -y - **`cargo build`/`cargo test` on macOS is now fully supported** — macOS is a first-class target. - Use `orb run -m moon-dev` for Linux-specific testing (io_uring, O_DIRECT, connection migration). - All **benchmark numbers** MUST come from the Linux VM (or GCloud instances). -- The VM path to the repo is the same as macOS: `/Users/tindang/workspaces/tind-repo/moon`. +- The VM path to the repo is the same as macOS: `/Volumes/Games/tindang-repo/moon`. - Use `source ~/.cargo/env &&` prefix in every `orb run` command. +- Use `CARGO_TARGET_DIR=target-linux` for VM builds of the shared checkout so Linux ELF and macOS Mach-O artifacts never clobber each other (`/target-linux/` is gitignored). +- **Diskfull guard:** Moon pauses writes (`MOONERR diskfull`) when the data dir's filesystem has <5% free. `/Volumes/Games` hovers near that line — run server-spawning suites (e.g. `scripts/test-consistency.sh`) from a VM-local clone (`git clone --depth 1 file:///Volumes/Games/tindang-repo/moon ~/moon-consistency`) or pass a fresh `--dir` on VM /tmp. +- Don't edit sources on macOS while a VM build of the same checkout is compiling (shared fs → spurious compile errors). ## Scripts @@ -249,7 +254,7 @@ Many style lints are suppressed in `src/lib.rs` (`#![allow(...)]`). Correctness Before pushing, run the full CI matrix locally: ```bash -orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Users/tindang/workspaces/tind-repo/moon && cargo fmt --check && cargo clippy -- -D warnings && cargo clippy --no-default-features --features runtime-tokio,jemalloc -- -D warnings && cargo test --release && cargo test --no-default-features --features runtime-tokio,jemalloc' +orb run -m moon-dev bash -c 'source ~/.cargo/env && cd /Volumes/Games/tindang-repo/moon && cargo fmt --check && cargo clippy -- -D warnings && cargo clippy --no-default-features --features runtime-tokio,jemalloc -- -D warnings && cargo test --release && cargo test --no-default-features --features runtime-tokio,jemalloc' ``` <!-- ADD:BEGIN — managed by `add.py sync-guidelines`; do not edit inside --> From c3dea293fa0162451e36556f9180c92b529e718b Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 15:23:37 +0700 Subject: [PATCH 09/12] docs(changelog): add Unreleased entries for PR #172 Lint gate requires a CHANGELOG entry: documents the event-driven SPSC wake (57x cross-shard p99), hot-path lock quick wins, the new INFO counters, and the uring_handler VecDeque compile fix. author: Tin Dang --- CHANGELOG.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index df5c0da5f..8ca1b34d0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,39 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [Unreleased] + +### Changed — Event-driven cross-shard wake (the ~1ms monoio floor is gone) + +- **The monoio shard event loop is now event-driven.** Its single await point + was the 1ms periodic tick, so every cross-shard hop queued up to 1ms on the + target shard plus up to 1ms on the origin's reply sweep. The loop now races + the tick against the shard's SPSC `Notify` (hand-rolled allocation-free + `race2` future — `monoio::select!` remains banned), and connection tasks + await cross-shard replies directly. Cadence work (WAL flush, cached clock, + snapshot/auto-save sub-timers) stays pinned to the timer arm. Measured on + a 4-shard Linux server: single-client cross-shard SET p99 4.07 ms → 0.071 ms + (57×), pipelined SET +368%, non-pipelined SET +404%; single-shard + throughput +63–80%. (PR #172) +- **Drain-cap self-re-notify:** a >256-message cross-shard burst no longer + strands its tail until the next tick — a capped drain re-arms the wake + immediately (both runtimes). +- **New INFO Stats counters:** `spsc_notify_wakes` and `spsc_drain_renotify` + make the event-driven path observable from a black-box client. + +### Changed — Hot-path lock quick wins + +- Per-command global lock acquisitions removed from the command dispatch path + (replication offset reads, shared-databases lookups, socket-option setup, + accept-path state), with the replication backlog append switched to a + bulk-copy. (PR #172) + +### Fixed + +- `uring_handler` in-flight send queue used `Vec` API on a `VecDeque` + (`.push` → `.push_back`) — the Linux+tokio io_uring bridge path failed to + compile on its own. (PR #172) + ## [0.3.0] — 2026-06-11 Hot-shard elasticity + vector engine maturity: background HNSW compaction From e6e95e77d91d857e7d874d93af41461b4e280146 Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 15:29:39 +0700 Subject: [PATCH 10/12] =?UTF-8?q?docs(shard):=20review-pass=20notes=20?= =?UTF-8?q?=E2=80=94=20counter=20semantics=20+=20deferred=20findings?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adversarial perf + safety review of PR #172 (two specialist passes): 0 blockers, 0 introduced regressions. In-PR fix: document that spsc_notify_wakes includes drain-cap self-re-notify wakes (flume bounded(1) tokens coalesce, so producer wakes are approximately notify_wakes - drain_renotify). Deferred findings (all pre-existing or out-of-scope) recorded in TASK.md s7: AOF connection-path LSN lock (completes QW3), CLIENT LIST/INFO redundant registry lock, drain consumer round-robin, double mark_deleted_for_key, pending_wakers relay removal with task 3. author: Tin Dang --- .add/tasks/spsc-wake-floor/TASK.md | 19 +++++++++++++++++++ src/admin/metrics_setup.rs | 6 ++++++ 2 files changed, 25 insertions(+) diff --git a/.add/tasks/spsc-wake-floor/TASK.md b/.add/tasks/spsc-wake-floor/TASK.md index 8b85263b0..d056664ed 100644 --- a/.add/tasks/spsc-wake-floor/TASK.md +++ b/.add/tasks/spsc-wake-floor/TASK.md @@ -438,3 +438,22 @@ Spec delta for the next loop: script bug; FT.CREATE arg mismatch) plus a Phase-152 early-exit (rc=1). The milestone "consistency green" criterion needs a dedicated fix task — evidence: identical branch-vs-main A/B logs (/tmp/consistency-{vmlocal,main}.log on moon-dev). + +### PR #172 review findings deferred to follow-up (adversarial perf + safety review, 2026-06-11) +Both reviewers: 0 BLOCKER / 0 introduced regressions. Deferred items, all pre-existing or +out-of-scope, candidates for the next loop: +- PERF (major, pre-existing gap) — `AofWriterPool::issue_append_lsn` (persistence/aof/pool.rs) + still takes the `RwLock<ReplicationState>` read PER WRITE on the connection path when AOF + is enabled; QW3's OffsetHandle fixed only the shard-drain side. Fix: thread an OffsetHandle + into ConnectionContext. Completes review finding 1.4. +- PERF (minor, rare path) — CLIENT LIST/INFO dispatch calls registry `update()` (global write + lock) just to invoke the already-lock-free `live.touch()`; needs client_live threaded into + dispatch scope (handler_monoio + handler_sharded dispatch.rs). +- PERF (low, pre-existing) — drain cap exits on consumer[0]; consumers[1..] can wait an extra + cycle under single-ring saturation. Fix: round-robin drain start index. +- SAFETY (nit, pre-existing) — double `mark_deleted_for_key` on the non-slice DEL/UNLINK path + (spsc_handler.rs ~814/829, idempotent); remove the inner call. +- CLEANUP — pending_wakers relay is permanently empty in normal operation post-M2; remove with + task-3 (already flagged in spec delta above). +- DOCUMENTED in-PR — `spsc_notify_wakes` includes drain-cap self-re-notify wakes (flume + bounded(1) tokens coalesce; producer wakes ≈ notify_wakes − drain_renotify). diff --git a/src/admin/metrics_setup.rs b/src/admin/metrics_setup.rs index 92c27ce64..cde30fce5 100644 --- a/src/admin/metrics_setup.rs +++ b/src/admin/metrics_setup.rs @@ -34,6 +34,12 @@ static SPSC_DRAIN_RENOTIFY: AtomicU64 = AtomicU64::new(0); /// Count a shard-loop wake that came from the cross-shard `Notify` arm /// (event-driven drain) rather than the periodic timer. +/// +/// Includes wakes caused by the drain-cap self-re-notify: the `flume +/// bounded(1)` token coalesces producer notifies and self-re-notifies, so +/// they are indistinguishable at the wake site. Producer-driven wakes ≈ +/// `spsc_notify_wakes - spsc_drain_renotify` (approximate — a coalesced +/// token can carry both causes). #[inline] pub fn bump_spsc_notify_wake() { SPSC_NOTIFY_WAKES.fetch_add(1, Ordering::Relaxed); From 5118a26c55728119653e48d67dda8e9cec31a34e Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 15:32:07 +0700 Subject: [PATCH 11/12] fix(server): address PR #172 review findings (CodeRabbit + specialist passes) - CLIENT INFO derived its flags by reloading e.live.flags (stale bits frozen at the previous touch) instead of from current conn state; now mirrors the CLIENT LIST path in both handler_monoio and handler_sharded dispatch. - create_reuseport_listener silently dropped the TCP_NODELAY setsockopt result on the uring listener; now logs a warning (non-fatal, but QW1 latency behavior would be silently lost). author: Tin Dang --- src/server/conn/handler_monoio/dispatch.rs | 10 +++++++--- src/server/conn/handler_sharded/dispatch.rs | 10 +++++++--- src/shard/uring_handler.rs | 6 +++++- 3 files changed, 19 insertions(+), 7 deletions(-) diff --git a/src/server/conn/handler_monoio/dispatch.rs b/src/server/conn/handler_monoio/dispatch.rs index 042558554..bce590074 100644 --- a/src/server/conn/handler_monoio/dispatch.rs +++ b/src/server/conn/handler_monoio/dispatch.rs @@ -866,12 +866,16 @@ pub(super) fn try_handle_client_admin( return true; } if sub_bytes.eq_ignore_ascii_case(b"INFO") { + // Derive flags from CURRENT conn state (same as the LIST path + // above) — reloading e.live.flags would freeze stale bits. crate::client_registry::update(client_id, |e| { e.live.touch( conn.selected_db, - crate::client_registry::ClientFlags::from_bits( - e.live.flags.load(std::sync::atomic::Ordering::Relaxed), - ), + crate::client_registry::ClientFlags { + subscriber: conn.subscription_count > 0, + in_multi: conn.in_multi, + blocked: false, + }, ); }); let info = crate::client_registry::client_info(client_id).unwrap_or_default(); diff --git a/src/server/conn/handler_sharded/dispatch.rs b/src/server/conn/handler_sharded/dispatch.rs index 1bb6c15e8..84eeab362 100644 --- a/src/server/conn/handler_sharded/dispatch.rs +++ b/src/server/conn/handler_sharded/dispatch.rs @@ -119,12 +119,16 @@ pub(super) fn try_handle_client_command( return true; } if sub_bytes.eq_ignore_ascii_case(b"INFO") { + // Derive flags from CURRENT conn state (same as the LIST path + // above) — reloading e.live.flags would freeze stale bits. crate::client_registry::update(client_id, |e| { e.live.touch( conn.selected_db, - crate::client_registry::ClientFlags::from_bits( - e.live.flags.load(std::sync::atomic::Ordering::Relaxed), - ), + crate::client_registry::ClientFlags { + subscriber: conn.subscription_count > 0, + in_multi: conn.in_multi, + blocked: false, + }, ); }); let info = crate::client_registry::client_info(client_id).unwrap_or_default(); diff --git a/src/shard/uring_handler.rs b/src/shard/uring_handler.rs index 5d779e318..06593bde9 100644 --- a/src/shard/uring_handler.rs +++ b/src/shard/uring_handler.rs @@ -382,6 +382,10 @@ pub(crate) fn create_reuseport_listener(addr: &str) -> std::io::Result<std::os:: // QW1: TCP_NODELAY on the LISTENING socket. Multishot-accept CQEs deliver // raw fds with no safe per-socket hook; Linux copies the nonagle flag to // sockets returned by accept(2), so setting it here covers them. - let _ = crate::server::socket_opts::apply_client_socket_opts(&std_listener); + if let Err(e) = crate::server::socket_opts::apply_client_socket_opts(&std_listener) { + // Non-fatal: the listener still works, but accepted sockets keep Nagle + // (pipelined replies may see delayed-ACK latency). Surface it loudly. + tracing::warn!("failed to set TCP_NODELAY on uring listener: {e}"); + } Ok(std_listener.into_raw_fd()) } From 78ad88db6e43528737eefdd05e99b785b4181372 Mon Sep 17 00:00:00 2001 From: Tin Dang <tin.dang@trustifytechnology.com> Date: Thu, 11 Jun 2026 15:33:16 +0700 Subject: [PATCH 12/12] chore(config): sync MILESTONE.md with task-2 completion (review nit) CodeRabbit flagged state.json/MILESTONE.md drift: check off spsc-wake-floor and the p99<1ms exit criterion (both gated PASS with evidence), and record the discovered consistency-suite gap on main against the 132/132 criterion. The state.json milestone stage field is add.py-owned machine state and is left to the tooling. author: Tin Dang --- .add/milestones/v1-shared-nothing/MILESTONE.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/.add/milestones/v1-shared-nothing/MILESTONE.md b/.add/milestones/v1-shared-nothing/MILESTONE.md index 51b0ad178..e0ed886b8 100644 --- a/.add/milestones/v1-shared-nothing/MILESTONE.md +++ b/.add/milestones/v1-shared-nothing/MILESTONE.md @@ -25,12 +25,16 @@ Out: FT.SEARCH off-event-loop execution (review priority 3 → v2) · WAL group ## Tasks (breadth-first decomposition; detail lives in each TASK.md) - [x] hotpath-lock-quickwins depends-on: none — remove per-command global locks/atomics (OnceLock WAL sender, lock-free repl offsets, per-shard metrics counters, backlog bulk-append, VecDeque inflight sends, key_hash prune) + TCP_NODELAY on accept; establishes the measurement baseline -- [ ] spsc-wake-floor depends-on: hotpath-lock-quickwins — eventfd-based cross-thread wake for monoio replies + SPSC drain-until-empty; removes the ~1ms cross-shard latency floor +- [x] spsc-wake-floor depends-on: hotpath-lock-quickwins — eventfd-based cross-thread wake for monoio replies + SPSC drain-until-empty; removes the ~1ms cross-shard latency floor (gate PASS 2026-06-11; p99 4.071ms → 0.071ms) - [ ] shardslice-migration depends-on: hotpath-lock-quickwins — complete the ShardSlice migration: route remaining cross-shard reads through SPSC, delete Arc<ShardDatabases> foreign-thread access and every `is_initialized()` dual branch ## Exit criteria (observable; map each to the task that delivers it) - [x] Lock inventory: zero global lock acquisitions on the per-command write path for metrics, replication offsets, WAL sender, client registry batch-update — verified by a recorded audit + tests (TASK.md §6, 2026-06-11) (← hotpath-lock-quickwins) - [ ] `scripts/bench-compare.sh` on moon-dev shows no regression at 1 shard and measured improvement at 4 shards vs the recorded v0.3.0 baseline (← hotpath-lock-quickwins · spsc-wake-floor · shardslice-migration) -- [ ] Cross-shard single-key SET/GET p99 on monoio drops below 1ms (the old floor) in a recorded latency run (← spsc-wake-floor) +- [x] Cross-shard single-key SET/GET p99 on monoio drops below 1ms (the old floor) in a recorded latency run — 0.071 ms, 57× under the bar (.add/tasks/spsc-wake-floor/bench-results.txt, 2026-06-11) (← spsc-wake-floor) - [ ] `grep -r "is_initialized()" src/shard/` returns zero dual-path branches; `ShardDatabases` no longer exposes cross-shard read access (← shardslice-migration) - [ ] `scripts/test-consistency.sh` passes 132/132 on 1/4/12 shards and full CI matrix is green after each task (← all three) + ⚠ Gap discovered 2026-06-11: MAIN itself fails 15 of these (dispatch_read gaps for + GEO*/EXPIRETIME/PEXPIRETIME/TOUCH + two script bugs + a Phase-152 early-exit), so this + criterion needs a dedicated fix task; tasks 1–2 verified zero NEW failures vs main + instead (identical branch-vs-main A/B). CI matrix green per task: holding so far.

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 F{{etBsY(C< literal 0 HcmV?d00001 diff --git a/.add/docs/add-foundation.png b/.add/docs/add-foundation.png new file mode 100644 index 0000000000000000000000000000000000000000..4a2023e5b070d212da0849ddb443af2ee824a439 GIT binary patch literal 197085 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