okf: align with upstream OKF v0.2 — vault→bundle vocabulary migration + conformance audit (ADR-009)
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- リファクタリング
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- javascript
- 領域
- backend, cli, documentation
調査の方向性
okf/docs/decisions/ADR-009-okf-v02-alignment.mdから始め、次にokf-vault.jsonマーカー、CLI文字列、引数名、識別子、GLOSSARY、およびSPECの文章を一覧化します。generated、sources、lifecycle、credibilityフィールドを含め、okf/OKF.SPEC.v2.mdに照らしてemissionとingestをセクションごとに監査します。完了とは、マーカーに後方互換性のあるオープンパスがあり、すべての相違が修正されるかDEVIATIONS.mdに記録されていることです。
索引モデルが issue の本文から書いたものです。
説明
Implements the accepted ADR-009 (okf/docs/decisions/ADR-009-okf-v02-alignment.md), deliberately kept out of the ADR-001–008 PR stack because it touches on-disk contract.
Two parts, one deliberate pass:
-
Vocabulary migration (okf only) — finish what ADR-008 started: the API class is now
Bundle, butokf-vault.json(marker), CLI strings ("not a vault"),<vault-dir>argument names, local identifiers (withVault,vaultDir,VAULT_*error codes), GLOSSARY entries, and SPEC prose still say vault. Inventory each surface, decide migrate/keep item-by-item. The marker rename must move in lockstep with ADR-006's wrong-tool guardrail and needs a back-compat open path for existing on-disk stores. vault-ld keeps its vocabulary throughout. -
v0.2 conformance audit — upstream (pinned by
okf/OKF.SPEC.v2.md, checked 2026-08-01) made breaking changes affecting what we emit/ingest:timestamp→generated: { by, at }; body# Citations→ frontmattersources; plus the new actor convention,status/stale_afterlifecycle fields, and credibility signals. Audit emission + ingest against v0.2 §-by-§; every divergence either gets fixed or lands in DEVIATIONS.md with rationale — no silent drift.
Acceptance criteria are in the ADR. Blocked-by: the ADR-001–008 stack landing (starts at #54), so the migration sweeps final code.
- 主要言語
- JavaScript
- スター
- 0
- フォーク
- 0
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
似ている issue
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
メンテナーはふだん 1 日以内に返信
-
bug needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
apex-dev-tools/apex-log-parser#199 ·
メンテナーはふだん 1 日以内に返信
-
enhancement good first issue hacktoberfest help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
-
ReadBufferStream.addBuffer adds the full ArrayBuffer of a typed array view, and ignores its byteOffset対応中かも @wayfarer3130 が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
Expo 57 example: pnpm install fails with ERR_PNPM_TRUST_DOWNGRADE対応中かも @github-actions が今日担当しました。 オープンbug react-native team/client-libraries
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
PostHog/posthog-js#5442 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信