llm-ingestion-okf/docs
Kjell Tore Guttormsen 9bffc92abc docs(okf-v0.2): read upstream's reference bundles, not just its spec
V-A1 is discharged: everything is now read at pinned commit 3fcbb9f, not off
main. v0.2 itself landed in 780fe9d; SPEC.md was edited after it, so "the v0.2
commit" and "the current spec text" are different objects.

Session 19 read the spec. It never read the four bundles the tooling migrated
to v0.2, and reading them corrected things a spec reading had settled wrongly.
okf/samples/ga4_merch_store is not a bundle -- it is a runner config that
generates one, so it says nothing about output shape.

- U1 No reference bundle declares okf_version. All four root index.md files
  have no frontmatter at all. A-E6 is therefore a stricter posture than
  upstream's own implementation -- defensible, but a decision rather than an
  assumption. po-claude's "deviation" #2 was conformance. catalog's gate reports
  MISSING on every official Google bundle.
- U2 Root index.md is the ONLY index permitted to carry frontmatter (12).
  Constrains the fixture and the index policy.
- U3 `generated` is used for HUMAN-authored content upstream, so it cannot be a
  machine-generated or ownership predicate. Empirical confirmation of commons'
  axis finding, stronger than their spec-text argument.
- U4 Real v0.2 frontmatter is multi-line block YAML: flow sequences, block lists
  of flow mappings, nested mappings, block lists of multi-key mappings, booleans,
  dates. Requirement 1 was scoped against a list of strings; the canonical shape
  is a list of five-key mappings. The one-session sizing must be redone.
- U5 7's actor convention gives `<producer>/<version>` for tools, and upstream
  uses it. That is real evidence for (b), against the (d) we recommended to
  commons today. Sent to them as a correction.
- U6 Conformance and the consumer-tolerance MUSTs quoted verbatim, including the
  bare-`verified`-as-one-element-list requirement on D1's reader.
- U7 An undocumented `not:` family observed in a bundle, unresolved, recorded so
  it is not mistaken for checked.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A2aKJxLejT9S8jYwoZ9fut
2026-07-26 19:09:03 +02:00
..
plan docs(okf-v0.2): read upstream's reference bundles, not just its spec 2026-07-26 19:09:03 +02:00
phase-3-split-table.md feat(phase-3): the index policy becomes configurable, with the reader that judges it 2026-07-25 20:30:54 +02:00