Skip to content

chore(okf): refresh repository skills and reconcile filesystem profiles - #340

Merged
lloydrichards merged 3 commits into
mainfrom
refresh-okf-skills
Nov 16, 2026
Merged

lloydrichards merged 3 commits into
mainfrom
refresh-okf-skills

Conversation

@lloydrichards

Copy link
Copy Markdown
Owner

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.

@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
effect-vfs-docs Ready Ready Preview Nov 16, 2026 10:07pm UTC

Request Review

@changeset-bot

changeset-bot Bot commented Nov 16, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 019e7c9

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ 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.

Pullfrog  | Fix all ➔ | Fix 👍s ➔ | View workflow run | Using 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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@lloydrichards
lloydrichards merged commit be9f1aa into main Nov 16, 2026
10 checks passed
@lloydrichards
lloydrichards deleted the refresh-okf-skills branch November 16, 2026 22:17

This branch was successfully deployed

1 active deployment
Preview — 019e7c9a Deployed Nov 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant