feat(knowledge)!: migrate the knowledge base to OKF v0.2 #3

Merged
crapougnax merged 1 commit from feat/okf-v0.2 into develop 2026-11-08 21:26:25 +00:00
Collaborator

Summary

Migrates AGENTS.okf to OKF v0.2 (normative spec: GoogleCloudPlatform/open-knowledge-format SPEC.md).

  • 47 rule units: timestamp → generated: { by: human:crapougnax, at }; verified: [{ by: human:crapougnax, at }] = the maintainer review; status: active → stable.
    • Dates come from Git, not from the hand-set v0.1 timestamps (often round values later than the real commit): generated.at = author date of the last commit that changed the unit; verified.at = date it landed on develop (merge or direct commit, all by the maintainer). 39 units have equal dates (direct commits).
  • Root content/index.md declares okf_version: "0.2".
  • OKF unit rewritten and renamed okf-v02-open-knowledge-format.md: provenance (sources + footnotes), trust (generated/verified, actor convention, derived tiers), lifecycle (status, stale_after), house rules. It is generated by the agent and left unverified until you review it.
  • bin/okf-v02.ts: v0.2 checks shared by validate and the tests (required keys, status vocabulary, actors, UTC offsets, sources[].resource, no timestamp, no # Citations, index frontmatter); bin/okf-v02.test.ts unit tests. Frontmatter parsed with Bun.YAML.
  • skills/agents-okf/SKILL.md description quoted (it was invalid YAML).
  • README, AGENTS.md, routers, package.json and CI label say OKF v0.2. RFCs and journal keep their historical v0.1 wording.

Breaking: consumers reading timestamp must read generated.at.

Checks

  • bun run validate: 57 files, 0 errors
  • bun test: 65 pass
  • bun run build: OK
  • gitleaks: no leaks

After merge

  • Release (minor or major per the version matrix) and bun run sync:local.

🤖 Generated with Claude Code

## Summary Migrates AGENTS.okf to OKF v0.2 (normative spec: GoogleCloudPlatform/open-knowledge-format `SPEC.md`). - **47 rule units**: `timestamp` → `generated: { by: human:crapougnax, at }`; `verified: [{ by: human:crapougnax, at }]` = the maintainer review; `status: active` → `stable`. - Dates come from Git, not from the hand-set v0.1 timestamps (often round values later than the real commit): `generated.at` = author date of the last commit that changed the unit; `verified.at` = date it landed on `develop` (merge or direct commit, all by the maintainer). 39 units have equal dates (direct commits). - Root `content/index.md` declares `okf_version: "0.2"`. - OKF unit rewritten and renamed `okf-v02-open-knowledge-format.md`: provenance (`sources` + footnotes), trust (`generated`/`verified`, actor convention, derived tiers), lifecycle (`status`, `stale_after`), house rules. It is `generated` by the agent and left **unverified** until you review it. - `bin/okf-v02.ts`: v0.2 checks shared by `validate` and the tests (required keys, status vocabulary, actors, UTC offsets, `sources[].resource`, no `timestamp`, no `# Citations`, index frontmatter); `bin/okf-v02.test.ts` unit tests. Frontmatter parsed with `Bun.YAML`. - `skills/agents-okf/SKILL.md` description quoted (it was invalid YAML). - README, AGENTS.md, routers, package.json and CI label say OKF v0.2. RFCs and journal keep their historical v0.1 wording. **Breaking**: consumers reading `timestamp` must read `generated.at`. ## Checks - `bun run validate`: 57 files, 0 errors - `bun test`: 65 pass - `bun run build`: OK - gitleaks: no leaks ## After merge - Release (minor or major per the version matrix) and `bun run sync:local`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(knowledge)!: migrate the knowledge base to OKF v0.2
All checks were successful
CI - OKF Conformance & Link Audit / Validate OKF v0.2 & Links (pull_request) Successful in 24s
1601ce8fd1
- 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>
crapougnax merged commit 404977dc48 into develop 2026-11-08 21:26:25 +00:00
crapougnax deleted branch feat/okf-v0.2 2026-11-08 21:26:25 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
crapougnax/AGENTS.okf!3
No description provided.