Skip to content

docs: merge is not ship (#45) and evidence hygiene - #49

Merged
jamesfgibbons merged 1 commit into
mainfrom
docs/merge-is-not-ship-evidence-hygiene
Oct 2, 2026
Merged

jamesfgibbons merged 1 commit into
mainfrom
docs/merge-is-not-ship-evidence-hygiene

Conversation

@jamesfgibbons

Copy link
Copy Markdown
Owner

LANE: doctrine · merge_is_not_ship + evidence_hygiene
IS: Two short docs pages. Merged ≠ served ≠ accepted, with exact-head evidence, 202 Accepted ≠ merged, stacked PRs, and per-surface wire verification. Six evidence-hygiene rules that apply the consuming-layer law to the instrument. Cross-links from CLI, CONTRIBUTING, README, PROTOCOL_MAP, CONSTITUTION, CHANGELOG.
IS-NOT: A new CheckCatalogV1 check; a receipt schema; a release-gate list; a G0–G5 change; the BLOCKED_BY_TARGET evaluator (#46); a GitHub Action (#29); a PyPI release (#42).

Closes #45.

PR Intent

  • Problem: Adopters can read green CI or a merged PR as "published". Evidence rules (scoped absence, two-sided guards, honest probes, visible failure) are implied across contracts but not stated in one place.
  • Change: Add docs/MERGE_IS_NOT_SHIP.md and docs/EVIDENCE_HYGIENE.md. Each page cites only existing public contracts (promotion_protocol_v1, proof_ledger, outcome_record, work_order_v1, cache_materialization, sensor_integrity, signal_projection, evidence_bundle_v1, entity_lifecycle). Add one-line cross-links.
  • Non-goals: No contract, schema, catalog, evaluator, or CLI behavior change.

Importance

Lane / Collision

  • Lane: doctrine (docs only).
  • Collision: Touches the README reference list, CHANGELOG [Unreleased], and PROTOCOL_MAP. A concurrent docs PR may need a one-line rebase there. No open PRs at branch time.
  • Risk surface: none (no code, contracts, cache, sitemap, cron, DB, or deploy).

Required Evidence

  • Contracts: python scripts/validate_contracts.py → PASSED; --check links → PASSED.
  • Web conformance: python scripts/validate_web_conformance.py → passed.
  • Tests: python -m unittest discover -s tests → 141 tests OK.
  • Links: every relative link in the 8 changed Markdown files resolves (116 checked, 0 broken).
  • Done when: merged to main and both pages render on GitHub at the merged commit.

🤖 Generated with Claude Code

Two doctrine pages plus cross-links. Merged != served != accepted; evidence
binds to an exact head; 202 Accepted is not merged; each delivery surface is
verified on the wire separately. Evidence hygiene: absence in a partial map is
unknown; an always-red guard is a false signal; evaluated URL must equal the
requested URL; probes identify themselves; typed UNAVAILABLE over silent
substitutes; failure is visible in headers and metadata.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jamesfgibbons
jamesfgibbons force-pushed the docs/merge-is-not-ship-evidence-hygiene branch from 2048f32 to f9fc91c Compare October 2, 2026 03:23
@jamesfgibbons
jamesfgibbons merged commit 33e534c into main Oct 2, 2026
2 checks passed
@jamesfgibbons
jamesfgibbons deleted the docs/merge-is-not-ship-evidence-hygiene branch October 2, 2026 03:25
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.

P2: Docs — merge ≠ ship / live receipt proves done (portable, no private SHAs)

1 participant