chain

Ported from kernel.

Ported from kernel snappy-chain in Phase 0.5. See state/lib/chain/api.ts for the full API surface.

Steps

• registerChain() - see state/lib/chain/api.ts
• getRegistered() - see state/lib/chain/api.ts
• dispatchOnce() - see state/lib/chain/api.ts

Eval

Actor: the exported functions in state/lib/chain/api.ts. Auditor: none wired yet - eval is manual (Robert review). File a state/log/pending-eval.ndjson row on each run.

Score convention:

Gotchas

via the Phase 0.5 driver. Only these rewrites were applied: already in state/lib/)

1. realpathSync(process.argv[1]) CLI guard wrapped in try/catch

• See the kernel SKILL.md for the original long-form guidance if you need it

(read-only reference at the kernel path above).

Graduation

This skill is prose. Graduate by defining a deterministic auditor and flipping eval: auto.

Rubric

criteria:
  - name: api_calls_present
    kind: deterministic
    check: "The executed code includes calls to registerChain(), getRegistered(), and dispatchOnce() as defined in state/lib/chain/api.ts."
  - name: inputs_used_correctly
    kind: judge
    check: "The registerChain_input, getRegistered_input, and dispatchOnce_input are passed appropriately to their respective API functions."
  - name: successful_dispatch
    kind: judge
    check: "The dispatchOnce() function appears to successfully initiate a classifier-to-chain run based on the overall execution context or logs."
  - name: no_unhandled_errors
    kind: deterministic
    check: "The execution log shows no unhandled exceptions or critical errors originating from the snappy-chain API calls."

chain - loader

Per-turn rules for the chain skill. Full reference: state/skills/chain/SKILL.md. Do not skip these.

Critical Rules

_(no failures recorded yet - Phase 0.5 mechanical port from kernel snappy-chain. Read state/skills/chain/SKILL.md and state/lib/chain/api.ts before invoking.)_

• The lib lives at state/lib/chain/api.ts (vendored DIRECTORY, not a single file) - also imports classify.ts and chains/ subdir
• ALWAYS call dispatchOnce() for one-shot runs; registerChain() is for the registry, not for per-invocation dispatch

Commands

| ui model | live composition via compose_inline, persisted as artifact lang_body, reopened with OpenArtifact | |invoke: import { registerChain, getRegistered, dispatchOnce } from "state/lib/chain/api.ts" |verify: npx tsx -e 'import("/Users/robertboulos/projects/snappy-os/state/lib/chain/api.ts").then(m => console.log(Object.keys(m)))' |eval log: state/log/pending-eval.ndjson (skill: "chain")

Known Pitfalls

• Vendored directory - state/lib/chain/ is more than just api.ts; don't move files around
• Phase 0.5 port - only mechanical rewrites applied (settings path, sibling lib paths, CLI guard)

Self-Test

An agent reading this should correctly:

1. [ ] Import from state/lib/chain/api.ts, not state/lib/chain.ts
2. [ ] Know chain/ is a vendored directory with sibling files
3. [ ] Use dispatchOnce for one-shot, registerChain for registry adds

Found a gap? Edit this file. <!-- footer-injection-point -->