Clayton Kim 4cd3ea0a1e Make the adversarial-refresh promise operational ...

Plan 013: the Growth promise in docs/PRODUCT.md relied on someone
remembering to run wiki_sync, re-run the parity bench, and funnel misses
through contribute. This lands the three missing pieces:

- references/refresh.md: the agent-runnable refresh procedure — staleness
  check, wiki-sync flow, parity-bench flow with the eval-gating rule,
  every-miss-becomes-a-row routing through contribute, and result-recording
  conventions (pipeline.md tables, TUNE-RESULTS.md style).
- scripts/refresh_status.py: stdlib, network-free staleness reporter.
  JSON with wiki_sync / parity_bench / newest_pattern_row, each carrying
  last/days/stale. Sources: .wiki_sync_state.json (last_timestamp, mtime
  fallback), the "Live matrix recorded **YYYY-MM-DD**" line in
  references/pipeline.md, and git log -1 --format=%cs on
  evals/adversarial-evals.json (argv list, no shell). Thresholds (90/180/60
  days) are commented guidance; always exits 0 — reporter, not gate.
- docs/DECISIONS.md: durable home for decided tradeoffs, each entry with
  Decision / Why / Revisit-when / Source. Seeds the PRODUCT.md decisions
  (agent-invoked only, English-only, no packaging, no rights checks,
  removal-dominant axis) plus the commit-message-only ones: WP8 fixture
  word-floor/length-balance queue (05f2363), voice impostor/background
  calibration queue (41b60d1), protects-grain + build_report deferrals
  (d6f6321), and FP-06 as the single intentional xfail (efd7e0e,
  evals/CRITIQUE.md).
- One-line pointers to references/refresh.md from references/maintenance.md
  and docs/PRODUCT.md (Growth).

All four touched/new docs pass banned_phrase_scan and
structure_scan --genre docs. Suite: 439 PASS / 1 XFAIL (FP-06) / 0 FAIL.

New decisions go in DECISIONS.md at decision time; the reporter is the
building block if the operator ever wants scheduled refresh outside this
repo.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K6CYksdLbXbTAxcAQjvHz5

2026-07-07 06:37:22 -07:00

4.7 KiB

Raw Permalink Blame History

View Raw