Skip to content

promote: doc-surface truth-in-docs refresh + drift guards (#93)#94

Merged
ericckzhou merged 1 commit into
mainfrom
dev
Jun 8, 2026
Merged

promote: doc-surface truth-in-docs refresh + drift guards (#93)#94
ericckzhou merged 1 commit into
mainfrom
dev

Conversation

@ericckzhou

Copy link
Copy Markdown
Owner

Promotes devmain. One topic PR has accumulated since the last promotion.

Included

  • docs: refresh stale phase/MVP prose and add doc-surface drift guards #93 — docs: refresh stale phase/MVP prose and add doc-surface drift guards.
    • EVIDENCE.md lifecycle diagram: stale archive leaf → replay (boxes now replay/inspect/diff, matching §9).
    • render.py / protocol.py: dropped MVP/Week-2/Week-3 framing; describe the shipped surface.
    • 9 test files: RED-phase docstrings → present tense.
    • New guards: lifecycle-diagram leaf-box check, README command-surface check, release-gate↔CI coverage-floor sync.

Verification

  • uv run pytest: 788 passed (23 meta-tests). ruff check/format: clean.
  • Documentation- and test-only; no runtime code paths change.

…93)

Fix truth-in-docs drift and lock it out:

- EVIDENCE.md lifecycle diagram: replace non-command 'archive' leaf node with 'replay'; the three leaf boxes are now replay/inspect/diff, matching the three operations in section 9.

- render.py / protocol.py: drop MVP/Week-2/Week-3 framing; describe the shipped surface (render covers run/replay/diff/verify/export; store surface is save/load/query/close with history/timeline/matrix/diff as consumer-side layers).

- 9 test files: rewrite RED-phase 'does not exist yet' docstrings to present tense.

Guards (all behind the decision surface):

- test_evidence_doc_freshness.py: new check asserts every lifecycle-diagram leaf box is a real CLI command (locks out 'archive' drift; prose 'archive' still allowed).

- test_readme_command_surface.py: every build_parser subcommand is referenced in README.

- test_release_gate_coverage_sync.py: release_gate COVERAGE_FLOOR equals CI --cov-fail-under.

- test_cli_store_lifecycle.py: clarify minimize opens no ReplayStore.
@ericckzhou ericckzhou merged commit 3d729a7 into main Jun 8, 2026
2 checks passed
ericckzhou added a commit that referenced this pull request Jun 12, 2026
Promote the post-0.6.4 evidence-preservation hardening to a tagged patch release.

- Read-only commands no longer load the model stack (#84, #87)

- doctor is store-backend aware; fails exit 3 on unregistered scheme (#85)

- Anti-entropy guards + doc-freshness tripwires (#90, #92, #94); agent-context fix (#86)

Bumps pyproject.toml, falsifyai/__init__.py, test_version.py, uv.lock; reconciles CHANGELOG [Unreleased] into [0.6.5] and refreshes README status/roadmap.
ericckzhou added a commit that referenced this pull request Jun 12, 2026
CLI hygiene (read-only commands off the model stack, #84/#87), store-aware doctor (#85), anti-entropy guards + doc-freshness tripwires (#90/#92/#94), agent-context fix (#86). Version 0.6.5; release gate green.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant