Skip to content

docs: correct stale test-coverage linking and predicate-analysis wording - #62

Merged
undergroundrap merged 3 commits into
mainfrom
wip/docs-coverage-linking
Sep 29, 2026
Merged

undergroundrap merged 3 commits into
mainfrom
wip/docs-coverage-linking

Conversation

@undergroundrap

Copy link
Copy Markdown
Owner

Docs-only correction on the Researcher lane.

  • docs/LANGUAGE_REFERENCE.md: hum graph links obligations and evidence obligations to tests including app-nested tests (was: top-level tests only). src/graph.rs collect_test_coverages recurses into app items; src/json.rs and src/test_skeletons.rs consume it. Distinguishes collected covers: declarations from matched obligations and from executed evidence.
  • docs/research/wordfreq-friction-ledger.md: dated (2026-09-29) superseding notes on entries feat(ci): fixed validation profiles (Language/Runtime/Compiler/Full) #4 and docs: 0026 comparative-evidence study design (linear resources vs forget) #18 -- decision 0030 Option B brought predicate analysis into hum check (full_type_check stage, gated on no earlier errors). Historical observations preserved; static validation vs runtime checking vs proof of contract truth distinguished.

No source, fixture, Work Order, or policy changes. Local checks: git diff --check clean; tools/check_text_hygiene.ps1 657 files passed; tools/check_public_readiness.ps1 657 files passed.

docs/LANGUAGE_REFERENCE.md: 'hum graph' links obligations and evidence
obligations to tests including app-nested tests, not top-level tests
only (src/graph.rs collect_test_coverages recurses into app items; both
json.rs and test_skeletons.rs consume it). Distinguish collected
covers: declarations from matched obligations and from executed
evidence: linkage records a shared coverage target, nothing about
whether the test ran or passed.

docs/research/wordfreq-friction-ledger.md: dated superseding notes on
entries #4 and #18 — decision 0030 (Option B) brought predicate
analysis into hum check's full_type_check stage when preceding stages
permit; static predicate validation is distinct from runtime contract
checking and from proof of contract truth. Historical observations
preserved.

Docs-only; no source, fixture, or Work Order changes.
Ledger superseding notes (#4, #18): decision 0030 accepted 2026-09-26
(not 09-27). Drop H0701 (unchecked prose contract) from the malformed
predicate rejection list; H0704 and H0638 stay distinguished.
…fresh)

Merge base 037f62b (Codex-accepted docs head 7562839) with main
0cd5e46 (WO29 Slice B, PR #61). Both reviewed documentation blobs
preserved exactly; no wording changes in this refresh.
@undergroundrap
undergroundrap marked this pull request as ready for review September 29, 2026 16:20
@undergroundrap
undergroundrap merged commit 0e215d3 into main Sep 29, 2026
4 checks passed
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