Repository navigation
chore(okf): refresh repository skills and reconcile filesystem profiles - #340
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
There was a problem hiding this comment.
ℹ️ Two evidence paths still fail to resolve; otherwise no concerns found.
Reviewed changes — Reviewed the skill refresh and filesystem knowledge reconciliation against repository sources.
- Repository skills: Adds dedicated cleanup and validation skills and replaces the authoring guidance.
- Filesystem profiles: Updates engine ownership, Node integration, persistence, and NFS capability boundaries.
- Knowledge maintenance: Consolidates validation and release guidance, repairs citations, and completes section indexes.
okf-graph@0.4.0 validate .okf --json passes with no issues. A separate filesystem check of all 523 local source references found the two unresolved paths noted inline.
gpt-6.1-sol | 𝕏
| - id: effect-crypto | ||
| resource: https://github.com/Effect-TS/effect/blob/main/packages/effect/src/Crypto.ts | ||
| title: Effect platform-neutral Crypto service | ||
| resource: ../../packages/core/node_modules/effect/src/crypto/Digest.ts |
There was a problem hiding this comment.
These new Effect evidence paths assume a workspace-local node_modules/effect, which is absent in the installed checkout. Both this citation and the corresponding PubSub.ts citation therefore remain unresolved even though graph validation passes.
Technical details
# Resolve Effect evidence independently of the workspace-local install assumption
## Affected sites
- .okf/contracts/snapshot-deltas.md:30 — ../../packages/core/node_modules/effect/src/crypto/Digest.ts does not exist.
- .okf/decisions/core/watch-event-overflow.md:30 — ../../../packages/core/node_modules/effect/src/PubSub.ts does not exist.
## Required outcome
- Both source references resolve in the supported dependency installation layout.
- Recheck local sources separately from graph validation, which reported no issues for these missing files.
## Suggested approach
The installed files are node_modules/effect/src/crypto/Digest.ts and node_modules/effect/src/PubSub.ts at the repository root. Use the appropriate concept-relative paths, or stable version-specific upstream URLs if the references must remain portable across installation layouts.
Goal/Scope
Give maintainers the three skills bundled with okf-graph 0.4.0 and bring the repository's knowledge bundle into line with the filesystem it ships.
Description
Install the authoring, validation, and dream skills. Consolidate CI guidance in the validation workflow and distinguish the local read-only NFS preview from the experimental networked and writable profiles. Update the engine ownership and adapter descriptions, repair evidence references, and add four missing entries to the contract and decision indexes.
Comment
All 116 concept IDs are preserved. The section indexes cover every concept, and all 523 local source references resolve.