Skip to content

dream-loop: extend ontology for technical-systems docs + fix 2 critical library entries - #64

Open
karx wants to merge 1 commit into
masterfrom
kaaro/dream-loop/technical-systems-ontology
Open

karx wants to merge 1 commit into
masterfrom
kaaro/dream-loop/technical-systems-ontology

Conversation

@karx

@karx karx commented Sep 7, 2026

Copy link
Copy Markdown
Owner

Summary

Dream Loop #2 - closes the technical-systems ontology gap flagged repeatedly since the 2026-07-13 gardening pass (grok-harness, pkm-engineering-prompt, esp-ecosystem all hit it). While investigating, found pkm-engineering-prompt.json and esp-ecosystem.json at validator exit 2 - loader-breaking cross-reference errors (both report_card.protagonists/antagonists referenced display-name strings instead of real node IDs). Both entries are registered in LIBRARY and were shipping broken.

  • Schema (atomic three-part update): +6 VALID_TYPES (framework, tool, process, system, hardware, prompt), +6 VALID_RELS (transforms, updates, contains, visualizes, underpins, simplifies) across validate-library-json.py, ontology.mjs, canvas/node-factory.mjs (new types reuse existing geometry buckets - no new THREE.js primitives), and sop-reference.md.
  • Library fixes: both entries' cross-references fixed; missing antagonist nodes added as real issue-typed nodes wired into the graph; ~19 non-canonical edge rels remapped; esp-ecosystem given a climax beat it was missing. pkm-engineering-prompt: exit 2 -> 1 (density warning only). esp-ecosystem: exit 2 -> 0 (clean).
  • New: GENERATIONS.md (Phase 5 ledger, didn't exist yet) and library/handoffs/dream-loop-2026-09-07.md per LIFE.md's protocol.
  • Hygiene: gitignored .kaaro-vid/ (untracked 435MB video-pipeline output) and health.json (a point-in-time snapshot that was drifting stale on master).

health-check.mjs: critical 2 -> 0, degraded 3 -> 2 (remaining signals are edge-density only, flagged for a follow-up Alone-Time re-encode pass - out of scope for a schema-only Dream Loop run).

Test plan

  • pnpm test - 168/168 pass, no regressions
  • python .claude/hooks/validate-library-json.py library/pkm-engineering-prompt.json - exit 1 (was exit 2)
  • python .claude/hooks/validate-library-json.py library/esp-ecosystem.json - exit 0 (was exit 2)
  • node scripts/health-check.mjs - critical 2 -> 0

Generated with Claude Code (https://claude.com/claude-code)

https://claude.ai/code/session_012gm77cqV1SEmaLqFHKubsu

…al library entries

Trigger: the technical-systems ontology gap (missing framework/tool/process/
system/hardware/prompt types) recurred across 3+ library entries over two
months (grok-harness, pkm-engineering-prompt, esp-ecosystem — first flagged
in the 2026-07-13 gardening pass), meeting the Dream Loop trigger condition
in LIFE.md. On this pass pkm-engineering-prompt and esp-ecosystem were found
at validator exit 2 (loader-breaking cross-reference errors), compounding the
ontology gap with a separate encoding defect.

Schema (atomic three-part update):
- validate-library-json.py: +6 VALID_TYPES, +6 VALID_RELS
- ontology.mjs: entity/rel visual grammar for all 12 new values
- node-factory.mjs: new types mapped onto existing geometry buckets by
  nearest analogue (no new THREE.js primitives)
- sop-reference.md: semantic + visual docs for all 12 new values

Library fixes:
- pkm-engineering-prompt.json: report_card protagonists/antagonists were
  referencing display-name strings instead of node IDs (5 cross-ref errors);
  added isolated-notes/uncrystallized-pipelines as real issue nodes with
  mitigates edges; remapped 16 edge rels to valid vocabulary. exit 2 -> 1.
- esp-ecosystem.json: same protagonist/antagonist defect (5 errors); added
  physical-access-constraint/framework-lock-in as real issue nodes with
  causes edges; promoted the OTA beat to climax (arc had none). exit 2 -> 0.

health-check.mjs: critical 2 -> 0, degraded 3 -> 2 (remaining signals are
edge-density only, flagged for a follow-up Alone-Time re-encode pass).
Tests: 168/168, no regressions.

Repo hygiene: gitignore .kaaro-vid/ (untracked 435MB video pipeline output)
and health.json (a point-in-time snapshot that goes stale immediately and
was drifting on master).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012gm77cqV1SEmaLqFHKubsu
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Preview deployed

🔗 https://karx.github.io/kaaroViewer/previews/pr-64/

Updates on every push to this PR.

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