From f1e58b08344f276df7f0201d14a26d01793a7981 Mon Sep 17 00:00:00 2001 From: Sage Date: Tue, 21 Jul 2026 22:20:47 -0500 Subject: [PATCH] docs: sweep stale version claims in conformance/validator docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Post-merge code review of 65622c0..710036e found current-version claims the v0.3.0 sweep missed (CHANGELOG sweep list omitted these files): - tests/conformance/README.md: suite titled/defined as v0.2 while RFC-0001 §6.1 defines this exact suite as the v0.3.0 conformance criterion (Medium) - validators/README.md: claimed v0.1.0 compliance + stale sample output, two bumps behind the binary it documents (Low, pre-existing) - negative/09-missing-memory/CASE.md: said missing MEMORY.md 'is a warning only' — false since v0.2.0 promoted it to a violation (Low, pre-existing) Docs only; validator and fixtures untouched. Suite re-verified: 5/5 positive + 10/10 negative, READY. Refs coven-threads bead threads-auu. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- tests/conformance/README.md | 6 +++--- tests/conformance/negative/09-missing-memory/CASE.md | 2 +- validators/README.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/tests/conformance/README.md b/tests/conformance/README.md index cc86966..a3def53 100644 --- a/tests/conformance/README.md +++ b/tests/conformance/README.md @@ -1,6 +1,6 @@ -# Familiar Contract v0.2 Conformance Suite +# Familiar Contract v0.3.0 Conformance Suite -This directory is the testable form of the Familiar Contract: a set of fixture familiars that encode the five normative properties as executable validator expectations. It uses the current repository validator as the conformance oracle while documenting where v0.2 expectations are stricter than the current implementation. +This directory is the testable form of the Familiar Contract: a set of fixture familiars that encode the five normative properties as executable validator expectations. It uses the current repository validator as the conformance oracle while documenting where v0.3.0 expectations are stricter than the current implementation. Run the full suite from the repository root: @@ -10,4 +10,4 @@ bash tests/conformance/run-conformance.sh Convention: `positive/-/` cases should PASS when run with `node validators/validate.js `. `negative/-/` cases should FAIL for the documented reason in that case's `CASE.md`. -A claim of v0.2 compliance = passing every positive case and failing every negative case. +A claim of v0.3.0 compliance = passing every positive case and failing every negative case. diff --git a/tests/conformance/negative/09-missing-memory/CASE.md b/tests/conformance/negative/09-missing-memory/CASE.md index 9e50b0e..7b20a0e 100644 --- a/tests/conformance/negative/09-missing-memory/CASE.md +++ b/tests/conformance/negative/09-missing-memory/CASE.md @@ -1,3 +1,3 @@ # 09 Missing MEMORY.md -Violated property: Persistent Memory. Validator check: `checkMemory` should reject this because `MEMORY.md` is absent, but the current implementation reports it as a warning only. Expected behavior for v0.2 conformance: `node validators/validate.js ` exits non-zero with an error pattern like `MEMORY.md does not exist`. +Violated property: Persistent Memory. Validator check: `checkMemory` rejects this because `MEMORY.md` is absent (promoted from warning to violation in v0.2.0; RFC-0001 §3.4 makes file presence a MUST). Expected behavior: `node validators/validate.js ` exits non-zero with an error pattern like `MEMORY.md does not exist`. diff --git a/validators/README.md b/validators/README.md index b7977fd..0634574 100644 --- a/validators/README.md +++ b/validators/README.md @@ -1,6 +1,6 @@ # Validator — familiar-contract -A zero-dependency Node.js CLI that checks a familiar directory for familiar-contract v0.1.0 compliance. +A zero-dependency Node.js CLI that checks a familiar directory for familiar-contract v0.3.0 compliance. ## Requirements @@ -44,7 +44,7 @@ node validate.js --help ## Output ``` -familiar-contract validator v0.1.0 +familiar-contract validator v0.3.0 Checking: /path/to/familiar Property Coverage: