ll-skills 1.0.0 → 2.0.2

package/hooks/ll-state.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+'use strict';
+// ll-state.js — ll-skills SessionStart hook. Injects the epilogue and the live
+// state of the project into the new session. Reads stdin {cwd, source}.
+// Never writes, never touches stderr, always exits 0.
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+const MAX_LINES = 60;
+const J = path.join;
+
+// <ll-shared:state>
+// Copied verbatim into hooks/ll-state.js. Self-contained: only `fs` and `path`.
+function readAnchoredBlock(file, name) {
+  let txt;
+  try { txt = fs.readFileSync(file, 'utf8'); } catch { return null; }
+  const all = txt.split('\n');
+  const open = new RegExp('^<!--\\s*' + name + '\\s*-->\\s*$');
+  const close = new RegExp('^<!--\\s*/' + name + '\\s*-->\\s*$');
+  let start = -1, end = -1;
+  for (let i = 0; i < all.length; i++) {
+    if (start < 0) { if (open.test(all[i])) start = i; } else if (close.test(all[i])) { end = i; break; }
+  }
+  if (start < 0 || end < 0) return null;
+  return { file, start, end, all, lines: all.slice(start + 1, end) };
+}
+function llSplitFlow(str) { // top-level commas only
+  const out = [];
+  let cur = '', depth = 0, q = null;
+  for (const ch of str) {
+    if (q) { cur += ch; if (ch === q) q = null; continue; }
+    if (ch === '"' || ch === "'") { q = ch; cur += ch; continue; }
+    if (ch === '[' || ch === '{') depth++;
+    else if (ch === ']' || ch === '}') depth--;
+    else if (ch === ',' && depth === 0) { out.push(cur); cur = ''; continue; }
+    cur += ch;
+  }
+  if (cur.trim() !== '') out.push(cur);
+  return out;
+}
+function llScalar(raw) {
+  const s = String(raw).trim();
+  if (/^\[[\s\S]*\]$/.test(s)) return llSplitFlow(s.slice(1, -1)).map(llScalar);
+  if (/^\{[\s\S]*\}$/.test(s)) {
+    const o = {};
+    for (const part of llSplitFlow(s.slice(1, -1))) {
+      const m = /^\s*([A-Za-z_][\w-]*)\s*:\s*([\s\S]*)$/.exec(part);
+      if (m) o[m[1]] = llScalar(m[2]);
+    }
+    return o;
+  }
+  if (/^(true|yes)$/i.test(s)) return true;
+  if (/^(false|no)$/i.test(s)) return false;
+  if (/^".*"$/.test(s) || /^'.*'$/.test(s)) return s.slice(1, -1);
+  return s;
+}
+function parseStateBlockLite(bl) {
+  const st = { phase: null, milestones: {}, order: [] };
+  let inM = false;
+  for (let i = 0; i < bl.length; i++) {
+    const line = bl[i].replace(/\s+$/, '');
+    if (!line.trim() || /^\s*#/.test(line)) continue;
+    let m = /^phase:\s*(.*)$/.exec(line);
+    if (m) { st.phase = String(llScalar(m[1])); inM = false; continue; }
+    if (/^milestones:\s*$/.test(line)) { inM = true; continue; }
+    m = /^(\s*)(M\d+|G-\d+):\s*\{(.*)\}\s*$/.exec(line);
+    if (m && inM) {
+      st.milestones[m[2]] = llScalar('{' + m[3] + '}');
+      st.order.push({ id: m[2], index: i, indent: m[1] });
+    } else if (/^\S/.test(line)) inM = false;
+  }
+  return st;
+}
+function boardFromState(st) {
+  const ids = Object.keys((st && st.milestones) || {});
+  const passed = ids.filter((i) => st.milestones[i].passes === true).length;
+  return { phase: st ? st.phase : null, passed, total: ids.length, list: ids,
+    text: 'phase ' + ((st && st.phase) || '?') + ' · milestones ' + passed + '/' + ids.length };
+}
+// </ll-shared:state>
+
+function git(args, cwd) {
+  try {
+    return execFileSync('git', args, { cwd, timeout: 3000, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+  } catch { return ''; }
+}
+function nonEmpty(s) { return s.split('\n').filter((l) => l.trim() !== ''); }
+
+function readStdin() {
+  try { return JSON.parse(fs.readFileSync(0, 'utf8')); } catch { return {}; }
+}
+
+// Last `## Epilogue` section of PROGRESS.md: {head: linesBefore, body: sectionLines}.
+function splitEpilogue(all) {
+  let at = -1;
+  for (let i = 0; i < all.length; i++) if (/^## Epilogue/.test(all[i])) at = i;
+  if (at < 0) return { head: all, body: [] };
+  let end = all.length;
+  for (let i = at + 1; i < all.length; i++) if (/^## /.test(all[i])) { end = i; break; }
+  return { head: all.slice(0, at), body: nonEmpty(all.slice(at, end).join('\n')).slice(0, 25) };
+}
+
+function build(cwd, source) {
+  const progress = J(cwd, 'PROGRESS.md');
+  let raw = null;
+  try { raw = fs.readFileSync(progress, 'utf8'); } catch { raw = null; }
+  if (raw === null && !fs.existsSync(J(cwd, 'phases'))) return null;
+
+  const out = [];
+  const st = raw === null ? null : parseStateBlockLite((readAnchoredBlock(progress, 'll-state') || { lines: [] }).lines);
+  const board = boardFromState(st);
+  const phase = (st && st.phase) || 'NN';
+
+  if (source === 'compact') {
+    out.push('[post-compaction] re-read phases/' + phase + '/PLAN.md and the milestone board below before continuing; the files on disk are the truth, not the summary.');
+  }
+
+  const all = raw === null ? [] : raw.split('\n');
+  const { head, body } = splitEpilogue(all);
+  if (body.length) out.push('', ...body);
+  const recent = nonEmpty(head.join('\n')).slice(-15);
+  if (recent.length) out.push('', 'recent PROGRESS:', ...recent);
+
+  const status = nonEmpty(git(['status', '--short'], cwd));
+  if (status.length) {
+    out.push('', 'git status:', ...status.slice(0, 20));
+    if (status.length > 20) out.push('  (+' + (status.length - 20) + ' more)');
+  }
+  const wt = nonEmpty(git(['worktree', 'list'], cwd));
+  if (wt.length > 1) out.push('', 'worktrees:', ...wt);
+
+  let waiting = [];
+  try {
+    waiting = fs.readdirSync(J(cwd, 'decisions')).sort()
+      .filter((n) => /\.md$/.test(n) && /WAITING/.test(fs.readFileSync(J(cwd, 'decisions', n), 'utf8')))
+      .slice(0, 8);
+  } catch { waiting = []; }
+  if (waiting.length) out.push('', 'WAITING on you: ' + waiting.join(', '));
+
+  out.push('', board.text);
+  if (out.length <= MAX_LINES) return out;
+  return out.slice(0, MAX_LINES - 2).concat(['', board.text]);
+}
+
+function main() {
+  const input = readStdin();
+  const cwd = typeof input.cwd === 'string' && input.cwd ? input.cwd : process.cwd();
+  const lines = build(cwd, input.source);
+  if (!lines || !lines.length) return;
+  process.stdout.write(JSON.stringify({
+    hookSpecificOutput: { hookEventName: 'SessionStart', additionalContext: lines.join('\n').trim() },
+  }) + '\n');
+}
+
+try { main(); } catch { /* silence */ }
+process.exit(0);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ll-skills",
-  "version": "1.0.0",
-  "description": "Pipeline de desenvolvimento orientado a evidência para Claude Code: pesquisa de mercado, premortem, POCs desarmadoras, spec por entrevista e verificação de entrega",
+  "version": "2.0.2",
+  "description": "Evidence-driven development pipeline for Claude Code: router preamble, 11 skills (brainstorm, research, decide, goal, implement, verify, close, resume, refine, oncall, update), 4 agents, 3 hooks and a state helper",
   "bin": {
     "ll-skills": "bin/install.js"
   },
@@ -10,6 +10,8 @@
     "skills",
     "agents",
     "hooks",
+    "scripts",
+    "assets",
     "CHANGELOG.md",
     "README.md"
   ],

package/scripts/fixtures/git-history.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Builds a throwaway git repo from scripts/fixtures/project/ into <target-dir>.
+# Five commits on five distinct days inside a nine-day span, in the order
+#   test(M1) -> feat(M1) -> feat(M10) -> feat(M2) -> test(M2)
+# so that `tdd-gate M1` passes, `tdd-gate M2` fails and `phase-stats` reports 5 days with work.
+# src/pay.ts is never touched after the first commit: VERIFICATION.md records its sha256.
+set -euo pipefail
+
+TARGET="${1:-}"
+if [ -z "$TARGET" ]; then
+  echo "usage: git-history.sh <target-dir>" >&2
+  exit 2
+fi
+
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SRC="$HERE/project"
+
+rm -rf "$TARGET"
+mkdir -p "$TARGET"
+cp -R "$SRC/." "$TARGET/"
+cd "$TARGET"
+
+G() { git -c user.name=fixture -c user.email=fixture@example.com -c commit.gpgsign=false "$@"; }
+
+commit_on() { # commit_on <day-offset> <subject>
+  local day="$1" subject="$2" stamp
+  stamp="2026-09-0${day}T10:00:00+00:00"
+  GIT_AUTHOR_DATE="$stamp" GIT_COMMITTER_DATE="$stamp" G commit -q -m "$subject"
+}
+
+git init -q -b main .
+G add -A
+commit_on 1 "test(M1): red cases"
+
+printf '\nexport const RECONCILE_VERSION = 2;\n' >> src/a.ts
+G add src/a.ts
+commit_on 3 "feat(M1): reconcile"
+
+printf 'export const UNRELATED = true;\n' > src/unrelated.ts
+G add src/unrelated.ts
+commit_on 5 "feat(M10): unrelated"
+
+printf 'export function ingest(lines: string[]): number {\n  return lines.length;\n}\n' > src/ingest.ts
+G add src/ingest.ts
+commit_on 7 "feat(M2): thing"
+
+printf "import { ingest } from '../src/ingest';\n\ntest('ingest counts lines', () => {\n  expect(ingest(['a'])).toBe(1);\n});\n" > test/ingest.test.ts
+G add test/ingest.test.ts
+commit_on 9 "test(M2): late test"

package/scripts/fixtures/project/BACKLOG.md

@@ -0,0 +1,11 @@
+# BACKLOG — fixture project
+
+| id | born (phase / commit) | type | closing condition (executable) | state |
+|---|---|---|---|---|
+| B-014 | 07 / a1b2c3d | stub | `true` exit 0 | OPEN |
+| B-015 | 07 / b2c3d4e | deviation | `false` exit 0 | OPEN |
+| B-016 | 06 / c3d4e5f | debt | `true` exit 0 | CLOSED |
+
+types: deviation | stub | test-not-run | debt | domain-question
+
+Closed only by `ll-tools.js backlog-reconcile --run` (the condition passed), never by memory.

package/scripts/fixtures/project/PLAN.md

@@ -0,0 +1,66 @@
+# PLAN — fixture project
+
+## §0 Precedence
+
+This file is self-contained and the ONLY entry of the work. §2 > §3 > §4 > §5. Decisions in §3 are a
+contract — do not re-litigate. Project CLAUDE.md > this file > phase plans > briefs.
+
+## §1 Objective and truths
+
+One sentence of delivery: every provider event is reconciled exactly once and every mismatch is
+visible to the operator.
+
+- T1 Every provider event produces exactly one row in `billing_events`. — `npm test -- a.test.ts`
+- T2 A replayed batch adds no rows. — `npm test -- replay.test.ts`
+- T3 Cent-level mismatches are reported, never dropped. — `npm test -- pay.test.ts`
+
+Requirements: REQ-k (phase 07), REQ-m (phase 08).
+
+## §2 Invariants
+
+I-01 NEVER delete, disable or weaken a test or acceptance criterion. [owner, 2026-08-23]
+I-02 Do not fill a gap with a plausible interpretation: report and ask. [owner, CLAUDE.md]
+
+## §3 Owner decisions
+
+| id | question | decision | by | date | against recommendation? | reversible? |
+|---|---|---|---|---|---|---|
+| DEC-0041 | cents divergence | pending | — | — | — | 1 migration |
+
+## §4 Requirements from the premortem
+
+R-01 A silent duplicate is worse than a rejected batch. (from F-01)
+
+## §5 Negative scope · freedoms · reserved
+
+Out of scope: customer portal. Free: module names, migration layout. Owner only: production deploy.
+
+## §6 Global acceptance
+
+CA-01 WHEN a batch is ingested twice THE SYSTEM SHALL keep one row per event · tolerance 0 ·
+`npm test -- a.test.ts`
+
+## §7 Execution protocol
+
+Session fable/high; scout sonnet/medium; contract executor opus/high; verifier opus/high.
+Max 3 executors per wave. Push only with everything green.
+
+## §8 Phases
+
+See ROADMAP.md. Current phase: 07.
+
+## §9 Environment
+
+`BILLING_PROVIDER_KEY` (name only, never the value).
+
+## §10 What is left for this to survive without the owner
+
+A provider sandbox key for the integration test.
+
+## §11 Sources
+
+Owner conversation 2026-08-23; docs/research-billing/SUMMARY.md.
+
+## Errata
+
+(append-only; empty)

package/scripts/fixtures/project/PROGRESS.md

@@ -0,0 +1,57 @@
+# PROGRESS — fixture project
+
+<!-- ll-state -->
+phase: 07
+milestones:
+  M1: { passes: true, commit: a1b2c3d, accepted_at: 2026-09-01T14:02:11Z }
+  M2: { passes: false, reason: "acceptance red: 2 tests fail" }
+  M3: { passes: false, state: ANSWERED_NO, reason: "spike ran; answer is no", propagates_to: [M5] }
+<!-- /ll-state -->
+
+## Rules for all agents
+
+- Only the main session writes this file. Executors return blocks; the session appends them.
+- Never delete, disable or weaken a test or an acceptance criterion.
+- Commit per milestone with `type(Mn): what`.
+
+## Phase 07
+
+- [2026-09-01T13:40Z] phase 07 opened — billing reconciliation
+- [2026-09-01T13:50Z] wave 1/3 — tracer + schema
+- [2026-09-01T14:02Z] M1 acceptance green — npm test -- a.test.ts
+- [2026-09-01T14:03Z] M1 marked passes true
+
+### M1 — 2026-09-01 14:02
+
+built: reconcile() with idempotent key; 3 behavior cases
+commits: test(M1): red cases · feat(M1): reconcile
+commands: npm test -- a.test.ts → "Tests: 3 passed, 3 total"
+deviations: none · questions: none · backlog: B-014 e2e cart not run (no fixture)
+not_verified: backoff under real network latency
+
+- [2026-09-03T09:12Z] wave 2/3 — reconciliation core
+- [2026-09-03T09:40Z] spike for M3 started (cent-level mismatch)
+- [2026-09-03T11:05Z] DEC-0041 opened — cents divergence, waiting on the owner
+- [2026-09-05T08:30Z] M2 executor returned; acceptance red (2 tests fail)
+- [2026-09-05T08:31Z] M2 marked passes false — reason recorded
+- [2026-09-05T10:20Z] B-015 born — TODO markers left in src/billing
+- [2026-09-05T16:44Z] spike for M3 answered: no
+- [2026-09-07T09:00Z] M3 marked ANSWERED_NO — propagates to M5
+- [2026-09-07T09:05Z] wave 3/3 held: M4, M5, M6 depend on the blocked branch
+- [2026-09-07T12:18Z] plan-lint run on phases/07/PLAN.md — defects recorded
+- [2026-09-07T15:10Z] file overlap noticed between M5 and M6 on src/pay.ts
+- [compaction 2026-09-07T15:11Z · auto · HEAD b2c3d4e] re-read phases/07/PLAN.md and the milestone board before continuing.
+- [2026-09-09T08:00Z] verification round for phase 07 started
+- [2026-09-09T08:40Z] VERIFICATION.md written — one criterion stale
+- [2026-09-09T09:15Z] backlog reviewed: B-014 and B-015 still open
+- [2026-09-09T09:30Z] phase 07 stopped at the epilogue
+
+## Deferred verification
+
+- SC-03 load under 10k rows · `ll-verify --criterion SC-03` · born phase 05
+
+## Epilogue — phase 07 — 2026-09-09
+
+passed: M1 · left: M2 (acceptance red), M3 (BLOCKED: DEC-0041) · WAITING: DEC-0041 (cents rounding) ·
+new backlog: B-014, B-015 · actions that need you: decide DEC-0041 before wave 3
+▶ Next — `/clear`, then `ll-implement 8`

package/scripts/fixtures/project/ROADMAP.md

@@ -0,0 +1,28 @@
+# ROADMAP — fixture project
+
+| phase | name | depends_on | requirements | state |
+|---|---|---|---|---|
+| 05 | payment intake | — | REQ-a | DONE (docs/history/v1.0) |
+| 06 | provider adapters | 05 | REQ-b | DONE (docs/history/v1.0) |
+| 07 | billing reconciliation | 05, 06 | REQ-k | ACTIVE |
+| 08 | reconciliation reporting | 07 | REQ-m | PLANNED |
+
+## Phase 07 — billing reconciliation
+
+Objective: every provider event lands in `billing_events` exactly once and mismatches are visible.
+
+Success criteria:
+- SC-01 The reconciliation job ingests a provider batch and writes one row per event.
+- SC-02 A replayed batch produces no duplicate rows.
+- SC-03 Cent-level mismatches are reported instead of silently dropped.
+- SC-04 The operator can list tolerated rows for a day.
+
+Deferred ideas: customer portal; accounting export.
+
+## Phase 08 — reconciliation reporting
+
+Objective: the operator reads yesterday's reconciliation without opening the database.
+
+Success criteria:
+- SC-01 A daily report lists ingested, tolerated and rejected rows.
+- SC-02 The report is reachable from the operator console.

package/scripts/fixtures/project/VERIFICATION.md

@@ -0,0 +1,17 @@
+# VERIFICATION — phase 07 — 2026-09-09
+
+verdict: APPROVED_WITH_RESERVATIONS · product: OK · process: FAIL (I-01 weakened without a DEC)
+
+| C | criterion | command | exit | file:line | sha256 | freshness | state |
+|---|---|---|---|---|---|---|---|
+| SC-01 | one row per provider event | npm test -- a.test.ts | 0 | src/pay.ts:3 | sha256:946c8f6b2d9a | FRESH | VERIFIED |
+| SC-02 | a replayed batch adds no rows | npm test -- ingest.test.ts | 0 | src/a.ts:1 | sha256:0000dead1234 | FRESH | VERIFIED |
+| SC-03 | cent mismatches are reported | — | — | test/a.test.ts:3 | — | — | PRESENT_NO_BEHAVIOR |
+
+BLOCKS: process — the tolerance assertion in `test/a.test.ts` was loosened with no DEC.
+
+Disconfirmation: 1 partial requirement (SC-02 happy path only); 1 uncovered error path (provider timeout).
+
+What this verification does NOT prove: behavior under real provider latency.
+
+Deferred: SC-03 until the fixture exists (BACKLOG B-014).

package/scripts/fixtures/project/decisions/DEC-0041-cents.md

@@ -0,0 +1,16 @@
+# DEC-0041 — cents divergence: reject the line or accept and flag?
+
+- class: QUESTION · layer: product · impact: HIGH · revert: 1 migration
+- grounding: internal (src/pay.ts:1; 3 cases in test/) | external (research-billing/F02, 2026-09-05)
+- options:
+
+  | option | what starts to hold | cost | what is lost | revert |
+  |---|---|---|---|---|
+  | A accept + flag (recommended) | the KPI the owner reads stays whole | 1 day | strict totals | 1 commit |
+  | B reject the line | totals are exact | 2 days | manual queue grows | 1 migration |
+
+- depends_on: — · conditions: M3, M5
+- status: WAITING — asked 2026-09-03T11:05Z, no answer yet
+- owner's words (verbatim): —
+- consequences by rule: SC-03 in ROADMAP measures "tolerated rows" only under option A.
+- superseded_by: —

package/scripts/fixtures/project/phases/07/PLAN.md

@@ -0,0 +1,145 @@
+# Phase 07 — billing reconciliation
+
+Objective (from ROADMAP): every provider event lands in `billing_events` exactly once and mismatches
+are visible. Success criteria: SC-01..SC-04 (pasted from ROADMAP.md).
+Decisions: phases/07/DECISIONS.md · Context: phases/07/CODE-CONTEXT.md
+
+## Milestones
+
+<!-- ll-milestones -->
+milestones:
+  - id: M1
+    name: end-to-end tracer
+    files: [src/a.ts, test/a.test.ts]
+    depends_on: []
+    tdd: yes
+    acceptance: "npm test -- a.test.ts"
+    stop: none
+    truths: [T1]
+    exclusive: []
+    model: opus/high
+    verification: internal
+  - id: M2
+    name: provider batch ingest
+    files: [src/ingest.ts, test/ingest.test.ts]
+    depends_on: [M1]
+    tdd: yes
+    acceptance: "npm test -- ingest.test.ts"
+    stop: none
+    truths: [T2]
+    exclusive: []
+    model: opus/high
+    verification: internal
+  - id: M3
+    name: cent mismatch spike
+    files: [src/spike.ts]
+    depends_on: [M1]
+    tdd: no
+    acceptance: "npm run spike -- cents"
+    stop: none
+    truths: [T3]
+    exclusive: []
+    model: sonnet/medium
+    verification: internal
+  - id: M4
+    name: reconcile join
+    files: [src/join.ts, test/join.test.ts]
+    depends_on: [M2, M3]
+    tdd: yes
+    acceptance: "npm test -- join.test.ts"
+    stop: none
+    truths: [T1, T2]
+    exclusive: [test:db]
+    model: opus/high
+    verification: internal
+  - id: M5
+    name: tolerated rows report
+    files: [src/pay.ts, test/pay.test.ts]
+    depends_on: [M3]
+    tdd: yes
+    acceptance: "npm test -- pay.test.ts"
+    stop: owner
+    truths: [T3]
+    exclusive: []
+    model: opus/high
+    verification: external
+  - id: M6
+    name: mismatch flag column
+    files: [src/pay.ts, src/schema.ts]
+    depends_on: [M3]
+    tdd: no
+    stop: none
+    truths: [T3]
+    exclusive: [test:db]
+    model: sonnet/medium
+    verification: internal
+  - id: M7
+    name: operator listing
+    files: [src/list.ts, test/list.test.ts]
+    depends_on: [M9, M4]
+    tdd: yes
+    acceptance: "npm test -- list.test.ts"
+    stop: none
+    truths: [T1]
+    exclusive: []
+    model: sonnet/medium
+    verification: internal
+<!-- /ll-milestones -->
+
+### M1 — end-to-end tracer
+
+read_first:
+  - src/a.ts:1-3 — the shape to copy for the batch signature
+  - test/a.test.ts:1-5 — test layout
+action: export `reconcile(batch)` keyed by `(provider, event_id)`.
+behavior (tdd: yes): duplicate event, new event, empty batch.
+acceptance: `npm test -- a.test.ts` exit 0; last line pasted.
+
+### M2 — provider batch ingest
+
+read_first:
+  - src/a.ts:1-3 — the reconcile entry point
+action: read a provider batch file and hand each event to `reconcile`.
+behavior (tdd: yes): malformed line, empty file, 3-event file.
+acceptance: `npm test -- ingest.test.ts` exit 0.
+
+### M3 — cent mismatch spike
+
+read_first:
+  - src/pay.ts:1-5 — the current tolerance rule
+action: measure how many rows of the September batch differ by cents only.
+acceptance: `npm run spike -- cents` exit 0 with the count on the last line.
+
+### M4 — reconcile join
+
+read_first:
+  - src/a.ts:1-3 — reconcile signature
+action: join ingested events with the ledger rows; keep the idempotency key.
+behavior (tdd: yes): matched, unmatched, duplicate.
+acceptance: `npm test -- join.test.ts` exit 0.
+
+### M5 — tolerated rows report
+
+read_first:
+  - src/pay.ts:1-5 — `tolerated()` is the rule to reuse
+action: list rows tolerated for a day; the owner unblocks the format.
+behavior (tdd: yes): under tolerance, over tolerance, exactly at tolerance.
+acceptance: `npm test -- pay.test.ts` exit 0.
+
+### M6 — mismatch flag column
+
+read_first:
+  - src/pay.ts:1-5 — where the flag is computed
+action: add the `mismatch_flag` column and write it from `tolerated()`.
+
+### M7 — operator listing
+
+read_first:
+  - src/pay.ts:1-5 — the tolerated rule the listing filters on
+action: expose the tolerated rows through the operator console.
+behavior (tdd: yes): empty day, one row, paging.
+acceptance: `npm test -- list.test.ts` exit 0.
+
+## Waves (printed by `ll-tools.js waves`)
+
+| wave | milestones | builds |

package/scripts/fixtures/project/src/a.ts

@@ -0,0 +1,3 @@
+export function reconcile(batch: string[]): string[] {
+  return Array.from(new Set(batch));
+}

package/scripts/fixtures/project/src/pay.ts

@@ -0,0 +1,5 @@
+export type Mismatch = { eventId: string; cents: number };
+
+export function tolerated(m: Mismatch): boolean {
+  return Math.abs(m.cents) <= 5;
+}

package/scripts/fixtures/project/test/a.test.ts

@@ -0,0 +1,5 @@
+import { reconcile } from '../src/a';
+
+test('reconcile dedupes a replayed batch', () => {
+  expect(reconcile(['e1', 'e1', 'e2'])).toEqual(['e1', 'e2']);
+});