feat(knowledge)!: migrate the knowledge base to OKF v0.2 #3
No reviewers
Labels
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
crapougnax/AGENTS.okf!3
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feat/okf-v0.2"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Summary
Migrates AGENTS.okf to OKF v0.2 (normative spec: GoogleCloudPlatform/open-knowledge-format
SPEC.md).timestamp→generated: { by: human:crapougnax, at };verified: [{ by: human:crapougnax, at }]= the maintainer review;status: active→stable.generated.at= author date of the last commit that changed the unit;verified.at= date it landed ondevelop(merge or direct commit, all by the maintainer). 39 units have equal dates (direct commits).content/index.mddeclaresokf_version: "0.2".okf-v02-open-knowledge-format.md: provenance (sources+ footnotes), trust (generated/verified, actor convention, derived tiers), lifecycle (status,stale_after), house rules. It isgeneratedby the agent and left unverified until you review it.bin/okf-v02.ts: v0.2 checks shared byvalidateand the tests (required keys, status vocabulary, actors, UTC offsets,sources[].resource, notimestamp, no# Citations, index frontmatter);bin/okf-v02.test.tsunit tests. Frontmatter parsed withBun.YAML.skills/agents-okf/SKILL.mddescription quoted (it was invalid YAML).Breaking: consumers reading
timestampmust readgenerated.at.Checks
bun run validate: 57 files, 0 errorsbun test: 65 passbun run build: OKAfter merge
bun run sync:local.🤖 Generated with Claude Code
- Every rule unit replaces `timestamp` with `generated: { by, at }` and records the maintainer review in `verified`, both derived from Git: `generated.at` is the author date of the last commit that changed the unit, `verified.at` the date it landed on develop. - `status: active` becomes `status: stable` (v0.2 lifecycle vocabulary). - The root `content/index.md` declares `okf_version: "0.2"`. - The OKF unit is rewritten for v0.2 (provenance, trust tiers, actors, sources and footnotes) and renamed `okf-v02-open-knowledge-format.md`. - `bin/okf-v02.ts` holds the v0.2 checks shared by `validate` and the tests, with its own unit tests; frontmatter is parsed with Bun.YAML. - The agents-okf skill description is quoted: it was invalid YAML. BREAKING CHANGE: rule units no longer carry `timestamp`; consumers read `generated.at` instead, and `status` uses draft | stable | deprecated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>