open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Activity

docs(okf): retract false okr verdict-parity claim + fold in 7 distilled notes

Browse source 
The shared checker (scripts/okf-check.mjs) was lifted from okr once (c06e4d7,
2026-06-29) and never updated; okr hardened its checker afterward (skip
innboks/dot-dirs + scoped checkBundle @ 3b45be7, 2026-06-30; BOM/CRLF
normalization @ 482effb, 2026-07-17). The two have diverged and are NOT
verdict-identical. Retract the "byte-identical / verdict parity is verified"
claim everywhere it stood (spec.md section 7, log.md incl. a handed-out
conformance flag, and both script headers), replacing it with a precise, dated
provenance note. Establishing parity is tracked separate work
(check-okf-parity.mjs); fixes go upstream-first (drift is two-way). No code
behavior changed. Also folds the round's 7 distilled architecture notes into
log.md. Tests 33/33.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-07-23 22:05:13 +02:00
commit 548a9abab3
4 changed files with 68 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

11
scripts/okf-check.mjs
View file

@ -10,10 +10,13 @@
// - the bundle-root index.md's `okf_version` is echoed for human comparison
// (no auto-fetch — offline by design).
//
// Lifted faithfully from okr/scripts/okf-check.mjs (the de-facto reference
// implementation; spec §7), with English output + a vendored frontmatter reader so
// the catalog copy is self-contained. Verdict logic is byte-identical, so a bundle's
// pass/fail is the same here as under okr's checker. Run per bundle root.
// Provenance: lifted from okr/scripts/okf-check.mjs (the de-facto reference
// implementation; spec §7) at c06e4d7 (2026-06-29), with English output + a vendored
// frontmatter reader so the catalog copy is self-contained. okr has since hardened its
// checker (skip innboks/dot-dirs + scoped checkBundle @ 3b45be7; BOM/CRLF normalization
// @ 482effb); this copy has NOT, so it has DIVERGED and is not verdict-identical with
// okr's current checker. Parity is a gate's output over a corpus, not a claim in this
// header — see docs/okf-second-brain/log.md. Run per bundle root.
// Zero npm dependencies (node: builtins).
import { readdirSync, readFileSync, existsSync } from 'node:fs';

10
scripts/okf-frontmatter.mjs
View file

@ -1,9 +1,11 @@
// okf-frontmatter.mjs
// Minimal flat-frontmatter reader for the shared OKF conformance checker.
// Vendored from okr's lib/frontmatter.mjs (the reference implementation) so the
// catalog-hosted checker is self-contained — zero npm dependencies, no cross-repo
// import. The checker only reads (never writes), so only parseFrontmatter().get is
// vendored. Parsing logic is kept byte-identical to okr's so verdicts stay in parity.
// Provenance: vendored from okr's lib/frontmatter.mjs at c06e4d7 so the catalog-hosted
// checker is self-contained — zero npm dependencies, no cross-repo import. The checker
// only reads (never writes), so only parseFrontmatter().get is vendored. okr has since
// added BOM/CRLF normalization here (lib/frontmatter.mjs:23); this copy has not, so the
// two have diverged and are no longer byte-identical (parity is the parity-gate's job,
// not this file's).
const FM_RE = /^---\n([\s\S]*?)\n---/;