@mindrian_os/install 1.13.0-beta.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +21 -0
- package/.mcp.json +9 -0
- package/CHANGELOG.md +3333 -0
- package/LICENSE +123 -0
- package/README.md +673 -0
- package/agents/brain-query.md +80 -0
- package/agents/framework-runner.md +237 -0
- package/agents/grading.md +188 -0
- package/agents/investor.md +128 -0
- package/agents/larry-extended.md +135 -0
- package/agents/opportunity-scanner.md +91 -0
- package/agents/persona-analyst.md +132 -0
- package/agents/research.md +89 -0
- package/agents/reverse-salient-agent.md +27 -0
- package/bin/cli.js +142 -0
- package/bin/mindrian-mcp-server.cjs +182 -0
- package/bin/mindrian-tools.cjs +765 -0
- package/commands/act.md +439 -0
- package/commands/admin.md +404 -0
- package/commands/analyze-needs.md +42 -0
- package/commands/analyze-systems.md +39 -0
- package/commands/analyze-timing.md +42 -0
- package/commands/auto-explore.md +64 -0
- package/commands/beautiful-question.md +40 -0
- package/commands/brain-derive.md +78 -0
- package/commands/build-knowledge.md +42 -0
- package/commands/build-thesis.md +46 -0
- package/commands/causal.md +234 -0
- package/commands/challenge-assumptions.md +33 -0
- package/commands/compare-ventures.md +83 -0
- package/commands/dashboard.md +110 -0
- package/commands/deep-grade.md +82 -0
- package/commands/diagnose.md +58 -0
- package/commands/diagnostics.md +151 -0
- package/commands/doctor.md +151 -0
- package/commands/dominant-designs.md +40 -0
- package/commands/explain-decision.md +87 -0
- package/commands/explore-domains.md +42 -0
- package/commands/explore-futures.md +40 -0
- package/commands/explore-trends.md +42 -0
- package/commands/export.md +103 -0
- package/commands/file-meeting.md +724 -0
- package/commands/find-analogies.md +188 -0
- package/commands/find-bottlenecks.md +62 -0
- package/commands/find-connections.md +76 -0
- package/commands/funding.md +81 -0
- package/commands/grade.md +203 -0
- package/commands/graph.md +128 -0
- package/commands/hat-briefing.md +125 -0
- package/commands/heal.md +196 -0
- package/commands/help.md +399 -0
- package/commands/hmi-status.md +172 -0
- package/commands/jtbd.md +241 -0
- package/commands/leadership.md +73 -0
- package/commands/lean-canvas.md +40 -0
- package/commands/macro-trends.md +40 -0
- package/commands/map-unknowns.md +40 -0
- package/commands/memory.md +173 -0
- package/commands/models.md +175 -0
- package/commands/mos-reason.md +285 -0
- package/commands/mullins.md +120 -0
- package/commands/new-project.md +481 -0
- package/commands/onboard.md +434 -0
- package/commands/operator.md +149 -0
- package/commands/opportunities.md +144 -0
- package/commands/organize.md +497 -0
- package/commands/persona.md +198 -0
- package/commands/pipeline.md +112 -0
- package/commands/present.md +91 -0
- package/commands/publish.md +201 -0
- package/commands/query.md +124 -0
- package/commands/radar.md +72 -0
- package/commands/reanalyze.md +91 -0
- package/commands/research.md +196 -0
- package/commands/room.md +352 -0
- package/commands/rooms.md +598 -0
- package/commands/root-cause.md +40 -0
- package/commands/rs-experts.md +85 -0
- package/commands/rs-explain.md +100 -0
- package/commands/rs-fetch.md +94 -0
- package/commands/rs-thesis.md +85 -0
- package/commands/scenario-plan.md +40 -0
- package/commands/scheduled-tasks.md +285 -0
- package/commands/score-innovation.md +43 -0
- package/commands/scout.md +239 -0
- package/commands/setup.md +618 -0
- package/commands/snapshot.md +147 -0
- package/commands/speakers.md +84 -0
- package/commands/splash.md +28 -0
- package/commands/status.md +75 -0
- package/commands/structure-argument.md +42 -0
- package/commands/suggest-next.md +80 -0
- package/commands/systems-thinking.md +40 -0
- package/commands/think-hats.md +42 -0
- package/commands/update.md +181 -0
- package/commands/user-needs.md +40 -0
- package/commands/validate.md +40 -0
- package/commands/value-proposition.md +61 -0
- package/commands/vault.md +180 -0
- package/commands/visualize.md +52 -0
- package/commands/whitespace.md +507 -0
- package/commands/wiki.md +69 -0
- package/hooks/hooks.json +381 -0
- package/hooks/run-hook.cmd +64 -0
- package/lib/__init__.py +0 -0
- package/lib/__pycache__/__init__.cpython-312.pyc +0 -0
- package/lib/agents/auto-explore-agent.cjs +1043 -0
- package/lib/agents/reverse-salient-agent.cjs +679 -0
- package/lib/agents/tension-hook-agent.cjs +544 -0
- package/lib/brain/ROOM.md +44 -0
- package/lib/brain/chain-recommender.cjs +301 -0
- package/lib/chat/chat-context.js +185 -0
- package/lib/chat/chat-panel.js +721 -0
- package/lib/chat/fabric-chat.cjs +288 -0
- package/lib/chat/generative-tools.js +219 -0
- package/lib/conversation/ROOM.md +39 -0
- package/lib/conversation/classifier-rules.json +38 -0
- package/lib/conversation/classifier.cjs +264 -0
- package/lib/conversation/operator.cjs +287 -0
- package/lib/copy/115-spec-strings.cjs +55 -0
- package/lib/core/__init__.py +0 -0
- package/lib/core/__nav-stub.cjs +14 -0
- package/lib/core/__pycache__/__init__.cpython-312.pyc +0 -0
- package/lib/core/__pycache__/rs-math.cpython-312.pyc +0 -0
- package/lib/core/__pycache__/rs_cache.cpython-312.pyc +0 -0
- package/lib/core/__pycache__/rs_corpus.cpython-312.pyc +0 -0
- package/lib/core/__pycache__/rs_hybrid.cpython-312.pyc +0 -0
- package/lib/core/__pycache__/rs_math.cpython-312.pyc +0 -0
- package/lib/core/__pycache__/rs_rooms.cpython-312.pyc +0 -0
- package/lib/core/artifact-id.cjs +148 -0
- package/lib/core/asset-ops.cjs +151 -0
- package/lib/core/auto-commit-throttle.cjs +129 -0
- package/lib/core/bearer-token.cjs +199 -0
- package/lib/core/brain-client.cjs +865 -0
- package/lib/core/brain-derivation-prompts.cjs +326 -0
- package/lib/core/brain-derivation-queue.cjs +431 -0
- package/lib/core/brain-derivation.cjs +580 -0
- package/lib/core/brain-md-schema.cjs +528 -0
- package/lib/core/brain-md-staleness.cjs +357 -0
- package/lib/core/brain-response-sanitize.cjs +188 -0
- package/lib/core/bridge-writer.cjs +477 -0
- package/lib/core/chat-context-builder.cjs +253 -0
- package/lib/core/cross-room-aggregator.cjs +762 -0
- package/lib/core/daily-briefing.cjs +438 -0
- package/lib/core/decision-capture.cjs +618 -0
- package/lib/core/deep-links.cjs +82 -0
- package/lib/core/dispatch-optimizer.cjs +354 -0
- package/lib/core/dual-path-detector.cjs +84 -0
- package/lib/core/dual-path-detector.test.cjs +334 -0
- package/lib/core/exports-log.cjs +79 -0
- package/lib/core/feynman-minto-invariants.cjs +605 -0
- package/lib/core/folder-memory-async.cjs +338 -0
- package/lib/core/folder-memory-shared.cjs +890 -0
- package/lib/core/folder-memory.cjs +416 -0
- package/lib/core/framework-chain-composer.cjs +411 -0
- package/lib/core/frontmatter-schemas.cjs +330 -0
- package/lib/core/git-ops.cjs +141 -0
- package/lib/core/graph-ops.cjs +258 -0
- package/lib/core/hat-persistence.cjs +362 -0
- package/lib/core/index.cjs +60 -0
- package/lib/core/integration-registry.cjs +232 -0
- package/lib/core/intelligence-cascade.cjs +661 -0
- package/lib/core/lazygraph-ops.cjs +1057 -0
- package/lib/core/lru-cache.cjs +139 -0
- package/lib/core/mcp-profiles.cjs +182 -0
- package/lib/core/meeting-ops.cjs +54 -0
- package/lib/core/memory-ops.cjs +600 -0
- package/lib/core/migrations/ROOM.md +33 -0
- package/lib/core/migrations/phase-109-nodes-provenance.cjs +339 -0
- package/lib/core/migrations/phase-109-session-focus.cjs +99 -0
- package/lib/core/model-profiles.cjs +246 -0
- package/lib/core/mullins-scaffold.cjs +160 -0
- package/lib/core/nav-dial.cjs +316 -0
- package/lib/core/navigation/ROOM.md +15 -0
- package/lib/core/navigation/explanation.cjs +43 -0
- package/lib/core/navigation/focus.cjs +135 -0
- package/lib/core/navigation/ingestion.cjs +82 -0
- package/lib/core/navigation/insights.cjs +350 -0
- package/lib/core/navigation/memory-events.cjs +118 -0
- package/lib/core/navigation/neighborhood.cjs +78 -0
- package/lib/core/navigation/packet.cjs +182 -0
- package/lib/core/navigation/room-home.cjs +127 -0
- package/lib/core/navigation/transitions.cjs +82 -0
- package/lib/core/navigation-engine-shared.cjs +242 -0
- package/lib/core/navigation-engine.cjs +664 -0
- package/lib/core/navigation.cjs +60 -0
- package/lib/core/nl-graph-queries.cjs +164 -0
- package/lib/core/offer-presenter.cjs +406 -0
- package/lib/core/opportunity-extractor.cjs +183 -0
- package/lib/core/opportunity-ops.cjs +1371 -0
- package/lib/core/persona-ops.cjs +537 -0
- package/lib/core/persona-taxonomy.cjs +190 -0
- package/lib/core/platform-gates.cjs +120 -0
- package/lib/core/platform.cjs +257 -0
- package/lib/core/proactive-intelligence.cjs +528 -0
- package/lib/core/problem-type-router.cjs +315 -0
- package/lib/core/reasoning-ops.cjs +639 -0
- package/lib/core/reverse-salient-persona-suffix.cjs +115 -0
- package/lib/core/room-classifier-strict-mode.cjs +229 -0
- package/lib/core/room-db.cjs +127 -0
- package/lib/core/room-ops-async.cjs +92 -0
- package/lib/core/room-ops-shared.cjs +64 -0
- package/lib/core/room-ops-sync.cjs +70 -0
- package/lib/core/room-ops.cjs +32 -0
- package/lib/core/room-type-detector.cjs +386 -0
- package/lib/core/rs-brain-substrate-prompts.cjs +129 -0
- package/lib/core/rs-brain-substrate.cjs +570 -0
- package/lib/core/rs-breakthrough-scorer.cjs +255 -0
- package/lib/core/rs-canon-violations.cjs +82 -0
- package/lib/core/rs-chain-feeder.cjs +343 -0
- package/lib/core/rs-commercial-assessor.cjs +280 -0
- package/lib/core/rs-differential-scorer.cjs +376 -0
- package/lib/core/rs-domain-analyzer.cjs +385 -0
- package/lib/core/rs-egress-prompts.cjs +113 -0
- package/lib/core/rs-egress-telemetry.cjs +225 -0
- package/lib/core/rs-egress-violations.cjs +53 -0
- package/lib/core/rs-expert-mapper.cjs +467 -0
- package/lib/core/rs-fetcher-academic.cjs +697 -0
- package/lib/core/rs-fetcher-experts.cjs +314 -0
- package/lib/core/rs-fetcher-industry.cjs +731 -0
- package/lib/core/rs-fetcher-patents.cjs +564 -0
- package/lib/core/rs-innovation-classifier.cjs +194 -0
- package/lib/core/rs-mind-map.cjs +656 -0
- package/lib/core/rs-neo4j-writer.cjs +388 -0
- package/lib/core/rs-nl-to-query.cjs +425 -0
- package/lib/core/rs-pinecone-bridge.cjs +303 -0
- package/lib/core/rs-preprocessor.cjs +350 -0
- package/lib/core/rs-query-matrix.cjs +316 -0
- package/lib/core/rs-query-to-text.cjs +438 -0
- package/lib/core/rs-sqlite-mirror.cjs +443 -0
- package/lib/core/rs-thesis-generator.cjs +188 -0
- package/lib/core/rs_cache.py +479 -0
- package/lib/core/rs_corpus.py +468 -0
- package/lib/core/rs_hybrid.py +586 -0
- package/lib/core/rs_math.py +287 -0
- package/lib/core/rs_rooms.py +193 -0
- package/lib/core/scheduled-scanner.cjs +463 -0
- package/lib/core/scratchpad-ops.cjs +201 -0
- package/lib/core/section-8-trace-schema.cjs +138 -0
- package/lib/core/section-registry.cjs +111 -0
- package/lib/core/session-state.cjs +144 -0
- package/lib/core/shallow-doc-parser.cjs +174 -0
- package/lib/core/shallow-doc-parser.test.cjs +226 -0
- package/lib/core/skill-activation-router.cjs +284 -0
- package/lib/core/state-ops.cjs +46 -0
- package/lib/core/statusline-cache.cjs +266 -0
- package/lib/core/token-estimator.cjs +348 -0
- package/lib/core/user-archetype.cjs +239 -0
- package/lib/core/user-md-ops.cjs +524 -0
- package/lib/core/visual-ops.cjs +624 -0
- package/lib/core/write-lock.cjs +149 -0
- package/lib/graph/canvas-graph.js +467 -0
- package/lib/graph/constellation-config.cjs +299 -0
- package/lib/graph/graph-detail-panel.js +165 -0
- package/lib/hmi/ROOM.md +47 -0
- package/lib/hmi/across-session-memory.cjs +604 -0
- package/lib/hmi/cross-room-memory.cjs +575 -0
- package/lib/hmi/decoy-tier.cjs +395 -0
- package/lib/hmi/jtbd-classifier.cjs +219 -0
- package/lib/hmi/jtbd-state.cjs +199 -0
- package/lib/hmi/jtbd-taxonomy.json +392 -0
- package/lib/hmi/selector-dispatcher.cjs +546 -0
- package/lib/hmi/selector-telemetry.cjs +263 -0
- package/lib/hmi/shape-f0-renderer.cjs +139 -0
- package/lib/hmi/shape-f1-fallback.cjs +80 -0
- package/lib/hmi/shape-f1-renderer.cjs +138 -0
- package/lib/hmi/shape-f2-renderer.cjs +132 -0
- package/lib/hmi/shape-f3-renderer.cjs +66 -0
- package/lib/hmi/shape-f4-renderer.cjs +72 -0
- package/lib/hmi/shape-f5-renderer.cjs +155 -0
- package/lib/hmi/shape-f6-plan-review-renderer.cjs +312 -0
- package/lib/hmi/shape-f6-renderer.cjs +144 -0
- package/lib/hmi/shape-g-renderer.cjs +219 -0
- package/lib/hmi/shape-h-renderer.cjs +222 -0
- package/lib/hmi/tier-check.cjs +63 -0
- package/lib/import/PRECONDITIONS.md +41 -0
- package/lib/import/branding.cjs +210 -0
- package/lib/import/branding.test.cjs +235 -0
- package/lib/import/classifications-sync.cjs +104 -0
- package/lib/import/classifications-sync.test.cjs +129 -0
- package/lib/import/enricher.cjs +296 -0
- package/lib/import/enricher.test.cjs +273 -0
- package/lib/import/integration.test.cjs +376 -0
- package/lib/import/manifest.cjs +129 -0
- package/lib/import/manifest.schema.json +185 -0
- package/lib/import/manifest.test.cjs +123 -0
- package/lib/import/meeting-detector.cjs +92 -0
- package/lib/import/meeting-detector.test.cjs +100 -0
- package/lib/import/person-detector.cjs +229 -0
- package/lib/import/person-detector.test.cjs +149 -0
- package/lib/import/report.cjs +186 -0
- package/lib/import/report.test.cjs +186 -0
- package/lib/import/room-md-scaffolder.cjs +49 -0
- package/lib/import/router.cjs +224 -0
- package/lib/import/router.test.cjs +356 -0
- package/lib/import/run-all-tests.cjs +36 -0
- package/lib/import/smoke-test.cjs +213 -0
- package/lib/import/smoke-test.test.cjs +148 -0
- package/lib/import/test-fixtures/collision-vault/preexisting-room/STATE.md +8 -0
- package/lib/import/test-fixtures/collision-vault/preexisting-room/problem-definition/onboarding/onboarding.md +7 -0
- package/lib/import/test-fixtures/collision-vault/source/onboarding.md +5 -0
- package/lib/import/test-fixtures/obsidian-vault/.obsidian/workspace.json +1 -0
- package/lib/import/test-fixtures/obsidian-vault/notes/with-wikilinks.md +4 -0
- package/lib/import/test-fixtures/tiny-vault/notes/2026-01-15-team-sync.md +9 -0
- package/lib/import/test-fixtures/tiny-vault/notes/empty.md +3 -0
- package/lib/import/test-fixtures/tiny-vault/notes/onboarding.md +5 -0
- package/lib/import/test-fixtures/tiny-vault/notes/pricing.md +5 -0
- package/lib/import/test-fixtures/tiny-vault/notes/random.md +4 -0
- package/lib/import/undo.test.cjs +199 -0
- package/lib/import/vault-scanner.cjs +105 -0
- package/lib/import/vault-scanner.test.cjs +67 -0
- package/lib/mcp/app-html/dashboard.html +316 -0
- package/lib/mcp/app-html/graph.html +428 -0
- package/lib/mcp/app-html/mindrian-platform.html +1841 -0
- package/lib/mcp/app-html/wiki.html +383 -0
- package/lib/mcp/app-views.cjs +322 -0
- package/lib/mcp/brain-router.cjs +418 -0
- package/lib/mcp/capability-registry.cjs +62 -0
- package/lib/mcp/larry-context.cjs +46 -0
- package/lib/mcp/larry-server-instructions.md +114 -0
- package/lib/mcp/pipeline-state.cjs +275 -0
- package/lib/mcp/prompts.cjs +302 -0
- package/lib/mcp/resources.cjs +227 -0
- package/lib/mcp/session-catchup.cjs +327 -0
- package/lib/mcp/surface-detect.cjs +75 -0
- package/lib/mcp/tool-router.cjs +1034 -0
- package/lib/memory/aaak-compress.cjs +403 -0
- package/lib/memory/aaak-compress.test.cjs +288 -0
- package/lib/memory/async-artifact-auto-commit.test.cjs +223 -0
- package/lib/memory/bearer-token.test.cjs +315 -0
- package/lib/memory/brain-cache-lru.test.cjs +259 -0
- package/lib/memory/brain-client-query-shape.test.cjs +160 -0
- package/lib/memory/brain-derivation-graceful-degradation.test.cjs +1019 -0
- package/lib/memory/brain-derivation-queue.test.cjs +539 -0
- package/lib/memory/brain-derivation.test.cjs +634 -0
- package/lib/memory/brain-derive-command.test.cjs +534 -0
- package/lib/memory/brain-md-invariants-validator.test.cjs +704 -0
- package/lib/memory/brain-md-schema.test.cjs +467 -0
- package/lib/memory/brain-md-staleness.test.cjs +525 -0
- package/lib/memory/brain-server-resolution.test.cjs +314 -0
- package/lib/memory/chain-recommender.test.cjs +233 -0
- package/lib/memory/chat-context.test.cjs +128 -0
- package/lib/memory/command-registry.test.cjs +220 -0
- package/lib/memory/cross-room-aggregator.test.cjs +909 -0
- package/lib/memory/dashboard-server.test.cjs +256 -0
- package/lib/memory/debouncer-drain-at-prompt.test.cjs +389 -0
- package/lib/memory/decision-capture.test.cjs +632 -0
- package/lib/memory/decision-capture.worker.cjs +70 -0
- package/lib/memory/explain-decision-command.test.cjs +521 -0
- package/lib/memory/explain-decision-footer.test.cjs +316 -0
- package/lib/memory/explored-materials-store.cjs +392 -0
- package/lib/memory/feynman-minto-guardian.test.cjs +736 -0
- package/lib/memory/feynman-minto-invariants.test.cjs +511 -0
- package/lib/memory/feynman-prompts-drift.test.cjs +144 -0
- package/lib/memory/feynman-prompts.cjs +151 -0
- package/lib/memory/feynman-prompts.test.cjs +96 -0
- package/lib/memory/folder-memory-quadruple.test.cjs +548 -0
- package/lib/memory/folder-memory.test.cjs +503 -0
- package/lib/memory/framework-chain-composer.test.cjs +515 -0
- package/lib/memory/frontmatter-schema-validator.test.cjs +290 -0
- package/lib/memory/heal-command.test.cjs +604 -0
- package/lib/memory/index-artifact-transaction.test.cjs +333 -0
- package/lib/memory/lazygraph-rs-discoveries-view.test.cjs +122 -0
- package/lib/memory/mcp-input-validation.test.cjs +240 -0
- package/lib/memory/mcp-server-brain-deps.test.cjs +270 -0
- package/lib/memory/mcp-stack-fallback.test.cjs +433 -0
- package/lib/memory/minto-debouncer.test.cjs +407 -0
- package/lib/memory/minto-debouncer.worker.cjs +46 -0
- package/lib/memory/minto-migration-v88.test.cjs +265 -0
- package/lib/memory/minto-schema-v88.test.cjs +390 -0
- package/lib/memory/mos-status-renderer.test.cjs +631 -0
- package/lib/memory/narrative-schema.cjs +376 -0
- package/lib/memory/narrative-schema.test.cjs +209 -0
- package/lib/memory/nav-dial.test.cjs +414 -0
- package/lib/memory/navigation-engine-core.test.cjs +722 -0
- package/lib/memory/navigation-invariants.test.cjs +483 -0
- package/lib/memory/offer-presenter.test.cjs +554 -0
- package/lib/memory/on-stop-snapshot.test.cjs +404 -0
- package/lib/memory/pending-tension-store.cjs +373 -0
- package/lib/memory/post-compact-reinjection.test.cjs +854 -0
- package/lib/memory/post-write-triple.test.cjs +317 -0
- package/lib/memory/pre-compact-snapshot.test.cjs +495 -0
- package/lib/memory/problem-type-router.test.cjs +656 -0
- package/lib/memory/query-efficiency-telemetry.test.cjs +370 -0
- package/lib/memory/recompile-room-references.test.cjs +392 -0
- package/lib/memory/recompile-room-references.worker.cjs +42 -0
- package/lib/memory/record-decision-dual-write.test.cjs +454 -0
- package/lib/memory/room-classifier-strict-mode.test.cjs +417 -0
- package/lib/memory/room-minto-hook.test.cjs +398 -0
- package/lib/memory/rs-discovery-engine.test.cjs +323 -0
- package/lib/memory/run-feynman-tests.cjs +1247 -0
- package/lib/memory/security-trifecta.test.cjs +312 -0
- package/lib/memory/session-start-brain-staleness.test.cjs +363 -0
- package/lib/memory/session-start-triple-injection.test.cjs +514 -0
- package/lib/memory/sessionstart-banner-formatter.cjs +318 -0
- package/lib/memory/sessionstart-minto-banner.test.cjs +373 -0
- package/lib/memory/skill-activation-router.test.cjs +419 -0
- package/lib/memory/stamp-artifact-write.test.cjs +304 -0
- package/lib/memory/statusline-active-room.test.cjs +315 -0
- package/lib/memory/statusline-minto-segment.test.cjs +292 -0
- package/lib/memory/sync-async-entry-points.test.cjs +204 -0
- package/lib/memory/test-bridge-writer-enhanced.cjs +452 -0
- package/lib/memory/test-rs-brain-substrate-shape.cjs +529 -0
- package/lib/memory/test-rs-brain-substrate.cjs +636 -0
- package/lib/memory/test-rs-breakthrough-scorer.cjs +375 -0
- package/lib/memory/test-rs-canon-violations.cjs +218 -0
- package/lib/memory/test-rs-chain-feeder-core.cjs +344 -0
- package/lib/memory/test-rs-chain-feeder-skill-spawn.cjs +297 -0
- package/lib/memory/test-rs-commercial-assessor.cjs +385 -0
- package/lib/memory/test-rs-differential-scorer.cjs +480 -0
- package/lib/memory/test-rs-discovery-engine.cjs +603 -0
- package/lib/memory/test-rs-domain-analyzer.cjs +492 -0
- package/lib/memory/test-rs-egress-primitives.cjs +420 -0
- package/lib/memory/test-rs-expert-mapper.cjs +547 -0
- package/lib/memory/test-rs-explain-command.cjs +443 -0
- package/lib/memory/test-rs-fetcher-academic.cjs +848 -0
- package/lib/memory/test-rs-fetcher-experts.cjs +496 -0
- package/lib/memory/test-rs-fetcher-industry.cjs +702 -0
- package/lib/memory/test-rs-fetcher-patents.cjs +674 -0
- package/lib/memory/test-rs-innovation-classifier.cjs +301 -0
- package/lib/memory/test-rs-mind-map.cjs +646 -0
- package/lib/memory/test-rs-neo4j-writer.cjs +518 -0
- package/lib/memory/test-rs-nl-to-query.cjs +449 -0
- package/lib/memory/test-rs-pinecone-bridge.cjs +277 -0
- package/lib/memory/test-rs-preprocessor.cjs +433 -0
- package/lib/memory/test-rs-query-matrix.cjs +391 -0
- package/lib/memory/test-rs-query-to-text.cjs +551 -0
- package/lib/memory/test-rs-sqlite-mirror.cjs +649 -0
- package/lib/memory/test-rs-thesis-generator.cjs +360 -0
- package/lib/memory/triple-context-formatter.cjs +473 -0
- package/lib/memory/triple-context-formatter.test.cjs +442 -0
- package/lib/memory/user-md-persona.test.cjs +565 -0
- package/lib/memory/userpromptsubmit-integration.test.cjs +690 -0
- package/lib/memory/validators/README.md +157 -0
- package/lib/memory/validators/brain-md-invariants.cjs +475 -0
- package/lib/memory/validators/brain-substrate-invariants.cjs +285 -0
- package/lib/memory/validators/external-academic-invariants.cjs +249 -0
- package/lib/memory/validators/external-industry-invariants.cjs +271 -0
- package/lib/memory/validators/external-patents-invariants.cjs +266 -0
- package/lib/memory/validators/minto-invariants.cjs +62 -0
- package/lib/memory/validators/navigation-invariants.cjs +340 -0
- package/lib/memory/validators/queue-health.cjs +95 -0
- package/lib/memory/validators/snapshot-integrity.cjs +129 -0
- package/lib/memory/validators/stale-lifecycle.cjs +116 -0
- package/lib/memory/vault-section-minto-generator-atomic.test.cjs +556 -0
- package/lib/memory/vault-section-minto-generator-atomic.worker.cjs +73 -0
- package/lib/memory/write-lock-atomic.test.cjs +137 -0
- package/lib/memory/write-lock-atomic.worker.cjs +55 -0
- package/lib/parity/check-parity.cjs +83 -0
- package/lib/presentation/presentation-server.cjs +101 -0
- package/lib/presentation/presentation-watcher.cjs +123 -0
- package/lib/quickview/hub-server.cjs +719 -0
- package/lib/quickview/server.cjs +533 -0
- package/lib/render/JTBD-PALETTES.md +145 -0
- package/lib/render/ROOM.md +59 -0
- package/lib/render/render-v2.cjs +486 -0
- package/lib/render/render-v2.test.cjs +267 -0
- package/lib/render/render.cjs +65 -0
- package/lib/state/ROOM.md +46 -0
- package/lib/state/state-md-parser.cjs +215 -0
- package/lib/statusline/ROOM.md +38 -0
- package/lib/statusline/banner-suppression.cjs +50 -0
- package/lib/statusline/surface-detect.cjs +85 -0
- package/lib/update-bootstrap.sh.template +145 -0
- package/lib/vault/frontmatter-schema.cjs +297 -0
- package/lib/vault/room-scanner.cjs +352 -0
- package/lib/vault/wikilink-builder.cjs +231 -0
- package/lib/vault/wikilink-builder.test.cjs +182 -0
- package/lib/wiki/graph-links.cjs +281 -0
- package/lib/wiki/page-renderer.cjs +229 -0
- package/lib/wiki/wiki-chat.cjs +81 -0
- package/lib/wiki/wiki-layout.cjs +1459 -0
- package/lib/wiki/wiki-search.cjs +142 -0
- package/lib/wiki/wiki-server.cjs +678 -0
- package/lib/wiki/wiki-watcher.cjs +105 -0
- package/lib/workflow/ROOM.md +47 -0
- package/lib/workflow/command-resolver.cjs +155 -0
- package/lib/workflow/command-resolver.test.cjs +235 -0
- package/package.json +44 -0
- package/pipelines/analogy/01-decompose.md +80 -0
- package/pipelines/analogy/02-abstract.md +87 -0
- package/pipelines/analogy/03-search.md +135 -0
- package/pipelines/analogy/04-transfer.md +101 -0
- package/pipelines/analogy/05-validate.md +106 -0
- package/pipelines/analogy/CHAIN.md +56 -0
- package/pipelines/discovery/01-explore-domains.md +44 -0
- package/pipelines/discovery/02-think-hats.md +50 -0
- package/pipelines/discovery/03-analyze-needs.md +54 -0
- package/pipelines/discovery/CHAIN.md +37 -0
- package/pipelines/thesis/01-structure-argument.md +45 -0
- package/pipelines/thesis/02-challenge-assumptions.md +48 -0
- package/pipelines/thesis/03-build-thesis.md +54 -0
- package/pipelines/thesis/CHAIN.md +37 -0
- package/references/brain/causal-directives.md +91 -0
- package/references/brain/causal-enrichment.cypher +165 -0
- package/references/brain/command-triggers-schema.md +226 -0
- package/references/brain/graph-architecture.md +317 -0
- package/references/brain/query-patterns.md +460 -0
- package/references/brain/room-hierarchy-schema.md +218 -0
- package/references/brain/schema.md +76 -0
- package/references/capability-radar/capabilities-index.md +241 -0
- package/references/capability-radar/changelog-cache.md +81 -0
- package/references/causal/causal-schema.md +103 -0
- package/references/design/email-template-standard.md +155 -0
- package/references/design/graph-visualization-standard.md +178 -0
- package/references/document-generation.md +179 -0
- package/references/hsi/HSI-TOOLS-REFERENCE.md +222 -0
- package/references/import-config.md +141 -0
- package/references/integrations/detection-patterns.md +101 -0
- package/references/meeting/artifact-template.md +377 -0
- package/references/meeting/cross-meeting-intelligence.md +216 -0
- package/references/meeting/cross-relationship-patterns.md +202 -0
- package/references/meeting/live-join-interface.md +244 -0
- package/references/meeting/section-mapping.md +192 -0
- package/references/meeting/segment-classification.md +258 -0
- package/references/meeting/speaker-profile-template.md +219 -0
- package/references/meeting/summary-template.md +348 -0
- package/references/meeting/transcript-patterns.md +226 -0
- package/references/methodology/analyze-needs.md +135 -0
- package/references/methodology/analyze-systems.md +121 -0
- package/references/methodology/analyze-timing.md +149 -0
- package/references/methodology/beautiful-question.md +109 -0
- package/references/methodology/build-knowledge.md +161 -0
- package/references/methodology/build-thesis.md +237 -0
- package/references/methodology/challenge-assumptions.md +127 -0
- package/references/methodology/diagnose.md +169 -0
- package/references/methodology/dominant-designs.md +212 -0
- package/references/methodology/explore-domains.md +147 -0
- package/references/methodology/explore-futures.md +163 -0
- package/references/methodology/explore-trends.md +129 -0
- package/references/methodology/find-bottlenecks.md +131 -0
- package/references/methodology/grade.md +211 -0
- package/references/methodology/index.md +97 -0
- package/references/methodology/leadership.md +200 -0
- package/references/methodology/lean-canvas.md +116 -0
- package/references/methodology/macro-trends.md +192 -0
- package/references/methodology/map-unknowns.md +137 -0
- package/references/methodology/mullins-7-domains.md +104 -0
- package/references/methodology/problem-types.md +65 -0
- package/references/methodology/root-cause.md +178 -0
- package/references/methodology/sapphire-encoding.md +355 -0
- package/references/methodology/scenario-plan.md +178 -0
- package/references/methodology/score-innovation.md +154 -0
- package/references/methodology/structure-argument.md +158 -0
- package/references/methodology/systems-thinking.md +159 -0
- package/references/methodology/think-hats.md +147 -0
- package/references/methodology/triz-matrix.json +751 -0
- package/references/methodology/triz-principles.md +501 -0
- package/references/methodology/user-needs.md +199 -0
- package/references/methodology/validate.md +163 -0
- package/references/methodology/value-proposition.md +244 -0
- package/references/opportunities/funding-lifecycle.md +103 -0
- package/references/opportunities/grant-api-patterns.md +99 -0
- package/references/opportunities/opportunity-template.md +84 -0
- package/references/personality/assessment-philosophy.md +72 -0
- package/references/personality/lexicon.md +100 -0
- package/references/personality/persona-chains.md +56 -0
- package/references/personality/pws-lexicon-full.md +499 -0
- package/references/personality/voice-dna.md +156 -0
- package/references/personas/hat-perspectives.md +76 -0
- package/references/personas/persona-template.md +63 -0
- package/references/pipeline/act-output-contract.md +88 -0
- package/references/pipeline/chains-index.md +39 -0
- package/references/pws-profile-generation.md +79 -0
- package/references/reasoning/reasoning-schema.md +143 -0
- package/references/reasoning/reasoning-template.md +68 -0
- package/references/reasoning/run-template.md +38 -0
- package/references/research/RESEARCH_14_CLAUDE_CODE_SOURCE_ARCHITECTURE.md +209 -0
- package/references/research/RESEARCH_15_V1.8_OPTIMIZATION_JTBD.md +375 -0
- package/references/research/RESEARCH_16_NATIVE_FIRST_PLUGIN_ARCHITECTURE.md +575 -0
- package/references/research/RESEARCH_17_MCP_UI_FRAMEWORKS.md +272 -0
- package/references/taxonomy/TAXONOMY.md +192 -0
- package/references/templates/MINTO.md +36 -0
- package/references/user-research/2026-04-05-leah-lawrence-session.md +202 -0
- package/references/vault-kit/README.md +35 -0
- package/references/vault-kit/app.json +12 -0
- package/references/vault-kit/appearance.json +12 -0
- package/references/vault-kit/graph.json +35 -0
- package/references/vault-kit/snippets/mindrian-destijl.css +297 -0
- package/references/vault-kit/templates/new-artifact.md +37 -0
- package/references/vault-kit/templates/new-meeting-note.md +35 -0
- package/references/vault-kit/templates/new-team-profile.md +29 -0
- package/references/vault-kit/templates/new-xref.md +35 -0
- package/references/visual/symbol-system.md +151 -0
- package/skills/MOSDeckEngine/SKILL.md +325 -0
- package/skills/brain-connector/SKILL.md +114 -0
- package/skills/context-engine/SKILL.md +147 -0
- package/skills/conversation-mode/SKILL.md +102 -0
- package/skills/larry-personality/SKILL.md +219 -0
- package/skills/larry-personality/framework-chains.md +92 -0
- package/skills/larry-personality/mode-engine.md +185 -0
- package/skills/mullins-scaffold/SKILL.md +61 -0
- package/skills/mullins-scaffold/scaffold.json +146 -0
- package/skills/pws-methodology/SKILL.md +49 -0
- package/skills/room-passive/SKILL.md +165 -0
- package/skills/room-proactive/SKILL.md +250 -0
- package/skills/ui-system/SKILL.md +277 -0
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Feynman-MINTO Guardian Validators
|
|
2
|
+
|
|
3
|
+
Phase 88-13 ships the guardian at `scripts/feynman-minto-guardian.cjs` with a
|
|
4
|
+
plugin registry that loads every `.cjs` file dropped into this directory.
|
|
5
|
+
Adding a new validator means dropping a file here. The guardian does not
|
|
6
|
+
need to change.
|
|
7
|
+
|
|
8
|
+
## Contract
|
|
9
|
+
|
|
10
|
+
Every validator must export the following shape:
|
|
11
|
+
|
|
12
|
+
```cjs
|
|
13
|
+
module.exports = {
|
|
14
|
+
id: 'my-validator', // unique, sortable, snake or kebab
|
|
15
|
+
severity_map: { critical: 3, error: 2, warning: 1, info: 0 },
|
|
16
|
+
scope: 'section', // 'section' | 'room' (default: 'section')
|
|
17
|
+
validate: function (path, ctx) { // path is sectionDir OR roomDir
|
|
18
|
+
// ctx = { roomDir, kind, now, validators } -- optional but guardian provides
|
|
19
|
+
return {
|
|
20
|
+
severity: 'warning' | 'error' | 'critical' | 'info' | null,
|
|
21
|
+
violations: [ // zero or more
|
|
22
|
+
{
|
|
23
|
+
validator: 'my-validator',
|
|
24
|
+
category: 'string key',
|
|
25
|
+
severity: 'warning',
|
|
26
|
+
message: 'human-readable explanation',
|
|
27
|
+
action_hint: 'optional_slug_like_this', // optional
|
|
28
|
+
section: 'market-analysis', // optional
|
|
29
|
+
field: 'governing_thought', // optional
|
|
30
|
+
},
|
|
31
|
+
],
|
|
32
|
+
};
|
|
33
|
+
},
|
|
34
|
+
};
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Scope modes
|
|
38
|
+
|
|
39
|
+
- `'section'` (default): guardian invokes `validate(sectionDir, ctx)` once per
|
|
40
|
+
section directory that holds ROOM.md. Use this for per-section content
|
|
41
|
+
invariants (MINTO content checks, cross-ref presence, local graph edges).
|
|
42
|
+
- `'room'`: guardian invokes `validate(roomDir, ctx)` once per room. Use this
|
|
43
|
+
for room-wide invariants that do not partition cleanly by section. The
|
|
44
|
+
three lifecycle validators shipped in Phase 88 (snapshot-integrity,
|
|
45
|
+
queue-health, stale-lifecycle) are all room-scoped because the file they
|
|
46
|
+
inspect lives at `.mindrian/*.json`, not per-section.
|
|
47
|
+
|
|
48
|
+
### Severity semantics
|
|
49
|
+
|
|
50
|
+
The guardian aggregates violations into `.mindrian/invariant-report.json`
|
|
51
|
+
during `on-stop` mode and writes them as `systemMessage` during
|
|
52
|
+
`session-start`. Severity has two distinct enforcement points:
|
|
53
|
+
|
|
54
|
+
- **Runtime (session-start + on-stop):** advisory only. No exit code
|
|
55
|
+
indicates blocking. The user sees a TRIPLE_CONTEXT footer that surfaces
|
|
56
|
+
violations, but the session continues.
|
|
57
|
+
- **pre-commit:** blocking. Any violation whose severity is `critical` or
|
|
58
|
+
`error` causes the guardian to exit 2 and the commit to fail. Warnings
|
|
59
|
+
and info are visible but never block.
|
|
60
|
+
|
|
61
|
+
### Fail-open
|
|
62
|
+
|
|
63
|
+
If your validator's `validate` function throws, the guardian catches it,
|
|
64
|
+
logs to stderr, and continues with the remaining validators. If the module
|
|
65
|
+
itself throws at require time (syntax error, missing import), the guardian
|
|
66
|
+
skips the file with a stderr warning and keeps loading the rest. One
|
|
67
|
+
broken validator never breaks the whole registry.
|
|
68
|
+
|
|
69
|
+
### Id collision
|
|
70
|
+
|
|
71
|
+
If two validators declare the same `id`, the first one loaded wins
|
|
72
|
+
(alphabetical by filename). The second is logged as a collision and
|
|
73
|
+
skipped. This lets downstream phases override a shipped validator simply
|
|
74
|
+
by ordering their file before it (e.g. `00-custom-minto-invariants.cjs`
|
|
75
|
+
shadows `01-minto-invariants.cjs`).
|
|
76
|
+
|
|
77
|
+
### Testing registration
|
|
78
|
+
|
|
79
|
+
Your validator is automatically loaded the next time
|
|
80
|
+
`scripts/feynman-minto-guardian.cjs` runs in any mode. To test the loader
|
|
81
|
+
without spawning the hook, set `GUARDIAN_VALIDATORS_DIR=/abs/path/to/my/validators`
|
|
82
|
+
in the environment and point at a fresh directory containing only the
|
|
83
|
+
file under test.
|
|
84
|
+
|
|
85
|
+
## Seed validators (reference implementations)
|
|
86
|
+
|
|
87
|
+
### 1. `minto-invariants.cjs` (core)
|
|
88
|
+
|
|
89
|
+
Wraps `lib/core/feynman-minto-invariants.cjs` (88-00-B). Flags schema,
|
|
90
|
+
freshness, coherence, and atomicity violations in the section's MINTO.md.
|
|
91
|
+
This is the first-in validator that proves the registry pattern; the
|
|
92
|
+
guardian does not require the invariants module directly, it goes through
|
|
93
|
+
this adapter.
|
|
94
|
+
|
|
95
|
+
### 2. `snapshot-integrity.cjs` (MEM-GUARDIAN-SNAPSHOT-01)
|
|
96
|
+
|
|
97
|
+
Reads `.mindrian/session-snapshot.json` and cross-checks its `sections[]`
|
|
98
|
+
array against the sections discovered on disk (via ROOM.md presence).
|
|
99
|
+
|
|
100
|
+
- Partial snapshot (disk section missing from snapshot) -> `warning`
|
|
101
|
+
`partial_snapshot_detected` per missing section.
|
|
102
|
+
- Empty snapshot with non-empty room -> `error` `snapshot_empty` with
|
|
103
|
+
`action_hint: rerun_on_stop`.
|
|
104
|
+
- Missing snapshot file -> silent (healthy first-session state).
|
|
105
|
+
- Unparseable snapshot -> `error` `snapshot_unparseable`.
|
|
106
|
+
|
|
107
|
+
Converts "on-stop crashed mid-walk, nobody notices for 20 sessions" into
|
|
108
|
+
"visible at the very next session-start footer."
|
|
109
|
+
|
|
110
|
+
### 3. `queue-health.cjs` (MEM-GUARDIAN-QUEUE-01)
|
|
111
|
+
|
|
112
|
+
Reads `.mindrian/minto-queue.json` (written by 88-02 debouncer). Enforces
|
|
113
|
+
size ceilings:
|
|
114
|
+
|
|
115
|
+
- `< 500 entries` -> healthy (no violation).
|
|
116
|
+
- `500-999 entries` -> `warning` `queue_approaching_ceiling`.
|
|
117
|
+
- `>= 1000 entries` -> `error` `queue_ceiling_exceeded` with
|
|
118
|
+
`action_hint: halt_enqueue_until_drained`.
|
|
119
|
+
|
|
120
|
+
Emits at most ONE aggregate violation per invocation, not N per entry.
|
|
121
|
+
Converts "debouncer drain never fires, queue grows unbounded" into a
|
|
122
|
+
visible health signal.
|
|
123
|
+
|
|
124
|
+
### 4. `stale-lifecycle.cjs` (MEM-GUARDIAN-STALE-01)
|
|
125
|
+
|
|
126
|
+
Re-validates `.mindrian/minto-stale.json` entries against the current
|
|
127
|
+
MINTO state. A stale entry whose section now has an invariant-clean
|
|
128
|
+
MINTO is a GHOST: the ledger lies. Emits `warning` `stale_ghost` with
|
|
129
|
+
`action_hint: prune_stale_entry` and `section: <name>`. The guardian
|
|
130
|
+
`on-stop` mode consumes these signals and atomically rewrites
|
|
131
|
+
`minto-stale.json` with ghost sections removed (tmp + rename).
|
|
132
|
+
|
|
133
|
+
Converts "stale entries never clear, footer shows phantom staleness
|
|
134
|
+
forever" into self-pruning behavior.
|
|
135
|
+
|
|
136
|
+
## Downstream extension points
|
|
137
|
+
|
|
138
|
+
Phase 88.3 (Brain cognitive-loop contract) will drop
|
|
139
|
+
`cognitive-loop-contract.cjs` here. Phase 90 (Navigation Engine) will drop
|
|
140
|
+
`navigation-invariants.cjs`. Neither modifies the guardian. The registry
|
|
141
|
+
is the integration point.
|
|
142
|
+
|
|
143
|
+
## Authoring checklist
|
|
144
|
+
|
|
145
|
+
- [ ] `id` is unique and stable (shipped IDs appear in telemetry and
|
|
146
|
+
reports; renaming breaks downstream consumers)
|
|
147
|
+
- [ ] `severity_map` is present even if unused (guardian validates the
|
|
148
|
+
shape at load time)
|
|
149
|
+
- [ ] `validate` returns the documented shape in all paths, including
|
|
150
|
+
error paths
|
|
151
|
+
- [ ] Your validator is fail-safe: throwing is acceptable (guardian
|
|
152
|
+
catches), but infinite loops are not (cap every loop)
|
|
153
|
+
- [ ] Every violation carries `{validator: '<your id>'}` even though the
|
|
154
|
+
guardian also tags them (belt + suspenders for report traceability)
|
|
155
|
+
- [ ] README entry above (add yours after a shipping commit)
|
|
156
|
+
|
|
157
|
+
_Three-surface by construction: CJS, Node built-ins, zero new deps._
|
|
@@ -0,0 +1,475 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* Copyright (c) 2026 Mindrian. BSL 1.1.
|
|
3
|
+
* Phase 90-05 -- BRAIN.md invariants validator.
|
|
4
|
+
*
|
|
5
|
+
* Registry-compatible drop-in for the Phase 88-13 guardian. Auto-
|
|
6
|
+
* discovered by scripts/feynman-minto-guardian.cjs's validator loader.
|
|
7
|
+
* Zero guardian.cjs edits required; the guardian's loadValidators()
|
|
8
|
+
* walks lib/memory/validators/*.cjs on every invocation.
|
|
9
|
+
*
|
|
10
|
+
* Contract (see lib/memory/validators/README.md):
|
|
11
|
+
* module.exports = {
|
|
12
|
+
* id: 'brain-md-invariants',
|
|
13
|
+
* severity_map: { critical, error, warning, info },
|
|
14
|
+
* scope: 'section',
|
|
15
|
+
* validate(sectionDir, ctx) -> { severity, violations[] },
|
|
16
|
+
* }
|
|
17
|
+
*
|
|
18
|
+
* This is the THIRD independent Canon Part 8 enforcement layer:
|
|
19
|
+
* 1. Plan 90-00 validateSchema (documents + scans frontmatter leaks).
|
|
20
|
+
* 2. Plan 90-01 prompt-builder allow-list (hard block at emission).
|
|
21
|
+
* 3. THIS validator (body-text scan at read-time / commit-time).
|
|
22
|
+
*
|
|
23
|
+
* Defense-in-depth by design: a bug in any ONE detector still produces
|
|
24
|
+
* detection via the other two.
|
|
25
|
+
*
|
|
26
|
+
* Three checks beyond the wrapped 90-00 schema validation:
|
|
27
|
+
* A) Staleness vs triple. Compare BRAIN.md governing_thought_hash
|
|
28
|
+
* against sha256 of the current triple.reasoning.governing_thought.
|
|
29
|
+
* Mismatch -> staleness/warning with action_hint 'enqueue_regen'.
|
|
30
|
+
* B) brain_graph_version drift. Compare BRAIN.md brain_graph_version
|
|
31
|
+
* against .mindrian/brain-schema-cache.json.current_graph_version.
|
|
32
|
+
* Drift -> staleness/warning.
|
|
33
|
+
* C) Cross-file Canon Part 8 body scan. Run a frozen regex set over
|
|
34
|
+
* the BRAIN.md body text. Each distinct hit -> canon_boundary/
|
|
35
|
+
* warning with action_hint 'canon_part8_review'. Capped at 5 per
|
|
36
|
+
* BRAIN.md to avoid spam.
|
|
37
|
+
*
|
|
38
|
+
* Fail-open: any unexpected throw is caught by the guardian's
|
|
39
|
+
* validator runner (Phase 88-13 Test 12). This validator does NOT
|
|
40
|
+
* swallow its own exceptions; the guardian owns that contract. Internal
|
|
41
|
+
* best-effort reads (cache file, triple field access) are guarded
|
|
42
|
+
* individually so a missing cache never produces a violation.
|
|
43
|
+
*
|
|
44
|
+
* BRAIN.md absent -> {violations:[]}. Absence is a valid default
|
|
45
|
+
* state (mirrors Phase 88-13 stale-lifecycle.cjs behavior for missing
|
|
46
|
+
* ledger files).
|
|
47
|
+
*
|
|
48
|
+
* Pure CJS, node built-ins only (fs, path, crypto). Zero npm deps.
|
|
49
|
+
*/
|
|
50
|
+
|
|
51
|
+
'use strict';
|
|
52
|
+
|
|
53
|
+
const crypto = require('node:crypto');
|
|
54
|
+
const fs = require('node:fs');
|
|
55
|
+
const path = require('node:path');
|
|
56
|
+
|
|
57
|
+
const schema = require('../../core/brain-md-schema.cjs');
|
|
58
|
+
|
|
59
|
+
// folder-memory is loaded lazily so the validator's top-level require
|
|
60
|
+
// graph stays minimal and a hypothetical unavailability never crashes
|
|
61
|
+
// require-time. When the guardian runs in on-stop / session-start mode
|
|
62
|
+
// it does NOT pre-populate ctx.triple for section-scoped validators, so
|
|
63
|
+
// we read the triple ourselves via readTriple. Every I/O path stays
|
|
64
|
+
// fail-open: a missing MINTO.md simply skips Check A silently.
|
|
65
|
+
let _folderMemory = null;
|
|
66
|
+
function lazyFolderMemory() {
|
|
67
|
+
if (_folderMemory !== null) return _folderMemory;
|
|
68
|
+
try {
|
|
69
|
+
_folderMemory = require('../../core/folder-memory.cjs');
|
|
70
|
+
} catch (_e) {
|
|
71
|
+
_folderMemory = false;
|
|
72
|
+
}
|
|
73
|
+
return _folderMemory;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
// ---------- Constants ----------
|
|
77
|
+
|
|
78
|
+
const SEVERITY_MAP = Object.freeze({
|
|
79
|
+
critical: 3,
|
|
80
|
+
error: 2,
|
|
81
|
+
warning: 1,
|
|
82
|
+
info: 0,
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
// Violation categories this validator emits. Kept in sync with the
|
|
86
|
+
// schema module's CATEGORIES. Declared here so `severity_map` (required
|
|
87
|
+
// by the guardian registry loader) is stable and auditable.
|
|
88
|
+
const SEVERITY_BY_CATEGORY = Object.freeze({
|
|
89
|
+
existence: 'critical',
|
|
90
|
+
schema: 'error',
|
|
91
|
+
staleness: 'warning',
|
|
92
|
+
attribution: 'error',
|
|
93
|
+
canon_boundary: 'warning',
|
|
94
|
+
coherence: 'warning',
|
|
95
|
+
});
|
|
96
|
+
|
|
97
|
+
// Hard cap on canon_boundary violations per BRAIN.md to prevent one
|
|
98
|
+
// noisy file from drowning the invariant report.
|
|
99
|
+
const CANON_BOUNDARY_CAP = 5;
|
|
100
|
+
|
|
101
|
+
// Frozen regex set -- MUST mirror the spirit of the Plan 90-00 scanner
|
|
102
|
+
// but applies to BRAIN.md BODY text (not just frontmatter scalars). The
|
|
103
|
+
// canon_boundary message carries the human-readable `hint` so downstream
|
|
104
|
+
// reviewers know which pattern matched.
|
|
105
|
+
const FORBIDDEN_PATTERNS = Object.freeze([
|
|
106
|
+
{ re: /@[a-zA-Z0-9._-]+\.[a-zA-Z]{2,}/, hint: 'email-like pattern' },
|
|
107
|
+
{ re: /\$[0-9][\d,.]*[KMB]?\b/, hint: 'currency magnitude' },
|
|
108
|
+
{
|
|
109
|
+
re: /\b(Lawrence|Jonathan|Nimrod|Oren|Dror)\s+said\b/i,
|
|
110
|
+
hint: 'quoted-person attribution',
|
|
111
|
+
},
|
|
112
|
+
{ re: /\bmeeting with\b/i, hint: 'meeting fragment' },
|
|
113
|
+
{ re: /\b\d{3}-\d{2}-\d{4}\b/, hint: 'SSN-like pattern' },
|
|
114
|
+
{
|
|
115
|
+
re: /\b\+?1?[\s.\-]?\(?\d{3}\)?[\s.\-]?\d{3}[\s.\-]?\d{4}\b/,
|
|
116
|
+
hint: 'phone-like pattern',
|
|
117
|
+
},
|
|
118
|
+
]);
|
|
119
|
+
|
|
120
|
+
// Categories that REQUIRE a parsed frontmatter (cannot run if we never
|
|
121
|
+
// got a usable fm object). If the schema wrapping short-circuits on a
|
|
122
|
+
// parse error, the validator skips these checks.
|
|
123
|
+
const STALENESS_CATEGORY = 'staleness';
|
|
124
|
+
const CANON_BOUNDARY_CATEGORY = 'canon_boundary';
|
|
125
|
+
const SCHEMA_CATEGORY = 'schema';
|
|
126
|
+
|
|
127
|
+
// ---------- Helpers ----------
|
|
128
|
+
|
|
129
|
+
function safeReadText(p) {
|
|
130
|
+
try {
|
|
131
|
+
return fs.readFileSync(p, 'utf8');
|
|
132
|
+
} catch (_e) {
|
|
133
|
+
return null;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
function safeReadJson(p) {
|
|
138
|
+
const raw = safeReadText(p);
|
|
139
|
+
if (raw === null) return null;
|
|
140
|
+
try {
|
|
141
|
+
return JSON.parse(raw);
|
|
142
|
+
} catch (_e) {
|
|
143
|
+
return null;
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
// Best-effort frontmatter extractor. Returns { fm, body } on success;
|
|
148
|
+
// { fm: null, body: '' } if the file is malformed. We do NOT emit a
|
|
149
|
+
// schema violation from here (the wrapped validateSchema already
|
|
150
|
+
// reports that with a precise message); we just bail out of the checks
|
|
151
|
+
// that depend on parsed frontmatter.
|
|
152
|
+
function splitFrontmatterAndBody(raw) {
|
|
153
|
+
if (typeof raw !== 'string' || raw.length === 0) {
|
|
154
|
+
return { fm: null, body: '' };
|
|
155
|
+
}
|
|
156
|
+
const re = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
|
|
157
|
+
const m = raw.match(re);
|
|
158
|
+
if (!m) return { fm: null, body: '' };
|
|
159
|
+
|
|
160
|
+
const fm = {};
|
|
161
|
+
const fmText = m[1];
|
|
162
|
+
const body = m[2] || '';
|
|
163
|
+
const lines = fmText.split(/\r?\n/);
|
|
164
|
+
for (let i = 0; i < lines.length; i++) {
|
|
165
|
+
const line = lines[i];
|
|
166
|
+
if (line.length === 0 || /^\s*$/.test(line) || /^\s*#/.test(line)) continue;
|
|
167
|
+
const match = line.match(/^([A-Za-z_][A-Za-z0-9_-]*):(.*)$/);
|
|
168
|
+
if (!match) {
|
|
169
|
+
return { fm: null, body: body };
|
|
170
|
+
}
|
|
171
|
+
const key = match[1];
|
|
172
|
+
const rest = match[2].trim();
|
|
173
|
+
fm[key] = unquoteOrCast(rest);
|
|
174
|
+
}
|
|
175
|
+
return { fm: fm, body: body };
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
function unquoteOrCast(raw) {
|
|
179
|
+
if (raw.length === 0) return '';
|
|
180
|
+
if (raw[0] === '"') {
|
|
181
|
+
if (raw.length < 2 || raw[raw.length - 1] !== '"') return raw;
|
|
182
|
+
return raw.slice(1, -1);
|
|
183
|
+
}
|
|
184
|
+
if (raw[0] === "'") {
|
|
185
|
+
if (raw.length < 2 || raw[raw.length - 1] !== "'") return raw;
|
|
186
|
+
return raw.slice(1, -1);
|
|
187
|
+
}
|
|
188
|
+
if (raw === 'null' || raw === '~') return null;
|
|
189
|
+
if (raw === 'true') return true;
|
|
190
|
+
if (raw === 'false') return false;
|
|
191
|
+
if (/^-?\d+$/.test(raw)) {
|
|
192
|
+
const n = parseInt(raw, 10);
|
|
193
|
+
if (Number.isSafeInteger(n)) return n;
|
|
194
|
+
}
|
|
195
|
+
if (/^-?\d+\.\d+$/.test(raw)) {
|
|
196
|
+
const f = parseFloat(raw);
|
|
197
|
+
if (Number.isFinite(f)) return f;
|
|
198
|
+
}
|
|
199
|
+
return raw;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
function gthHashOf(text) {
|
|
203
|
+
const s = typeof text === 'string' ? text : '';
|
|
204
|
+
return 'sha256:' + crypto.createHash('sha256').update(s).digest('hex');
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
function pushViolation(list, category, severity, message, extras) {
|
|
208
|
+
const v = { category: category, severity: severity, message: message };
|
|
209
|
+
if (extras && typeof extras === 'object') {
|
|
210
|
+
for (const k of Object.keys(extras)) {
|
|
211
|
+
if (extras[k] !== undefined) v[k] = extras[k];
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
list.push(v);
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
function aggregateSeverity(violations) {
|
|
218
|
+
const order = ['info', 'warning', 'error', 'critical'];
|
|
219
|
+
let max = -1;
|
|
220
|
+
for (const v of violations) {
|
|
221
|
+
const i = order.indexOf(v.severity);
|
|
222
|
+
if (i > max) max = i;
|
|
223
|
+
}
|
|
224
|
+
return max === -1 ? null : order[max];
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
// ---------- Schema wrapping (Plan 90-00) ----------
|
|
228
|
+
//
|
|
229
|
+
// Wraps validateSchema and copies its violation records through. The
|
|
230
|
+
// schema module already normalizes severity + category; we just
|
|
231
|
+
// forward. The field + action_hint properties are preserved.
|
|
232
|
+
|
|
233
|
+
function runSchemaCheck(brainMdPath, violations) {
|
|
234
|
+
let res;
|
|
235
|
+
try {
|
|
236
|
+
res = schema.validateSchema(brainMdPath);
|
|
237
|
+
} catch (_e) {
|
|
238
|
+
// Defensive: if the schema validator itself throws, surface a
|
|
239
|
+
// single schema/error so the downstream audit is visible. The
|
|
240
|
+
// guardian's fail-open still protects session-start and
|
|
241
|
+
// pre-commit.
|
|
242
|
+
pushViolation(
|
|
243
|
+
violations,
|
|
244
|
+
SCHEMA_CATEGORY,
|
|
245
|
+
'error',
|
|
246
|
+
'brain-md-schema.validateSchema threw unexpectedly'
|
|
247
|
+
);
|
|
248
|
+
return { shortCircuit: true };
|
|
249
|
+
}
|
|
250
|
+
if (!res || !Array.isArray(res.violations)) {
|
|
251
|
+
return { shortCircuit: false };
|
|
252
|
+
}
|
|
253
|
+
// Copy violations into our list byte-identically (preserving field +
|
|
254
|
+
// action_hint). The guardian auto-stamps validator id later.
|
|
255
|
+
for (const v of res.violations) {
|
|
256
|
+
if (!v || typeof v !== 'object') continue;
|
|
257
|
+
const extras = {};
|
|
258
|
+
if (v.field !== undefined) extras.field = v.field;
|
|
259
|
+
if (v.action_hint !== undefined) extras.action_hint = v.action_hint;
|
|
260
|
+
pushViolation(violations, v.category, v.severity, v.message, extras);
|
|
261
|
+
}
|
|
262
|
+
// If the schema validator returned CRITICAL (existence) or a parse-
|
|
263
|
+
// delimiter error, we short-circuit the staleness + canon_boundary
|
|
264
|
+
// checks: without a parsed frontmatter we can't compare hashes, and
|
|
265
|
+
// without a parsed frontmatter+body we risk double-reporting the
|
|
266
|
+
// same shape break. The short-circuit also prevents cascading noise
|
|
267
|
+
// in Test 13 (parse-failure case).
|
|
268
|
+
const isFatal = res.violations.some(function (v) {
|
|
269
|
+
if (!v || typeof v !== 'object') return false;
|
|
270
|
+
if (v.category === 'existence') return true;
|
|
271
|
+
if (v.category === 'schema' && v.severity === 'error') {
|
|
272
|
+
// Only delimiter / parse-failure messages warrant short-circuit;
|
|
273
|
+
// missing-field errors are still informative alongside runtime
|
|
274
|
+
// checks. We treat messages that mention "delimiter" or "parse"
|
|
275
|
+
// as fatal-for-runtime-checks.
|
|
276
|
+
return /delimiter|parse/i.test(v.message || '');
|
|
277
|
+
}
|
|
278
|
+
return false;
|
|
279
|
+
});
|
|
280
|
+
return { shortCircuit: isFatal };
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
// ---------- Check A: staleness vs triple ----------
|
|
284
|
+
|
|
285
|
+
function runStalenessCheck(fm, triple, violations) {
|
|
286
|
+
if (!fm || !triple || !triple.reasoning) return;
|
|
287
|
+
const fileHash = fm.governing_thought_hash;
|
|
288
|
+
if (typeof fileHash !== 'string' || fileHash.length === 0) return;
|
|
289
|
+
const currentGt = triple.reasoning.governing_thought;
|
|
290
|
+
// If there's no current governing_thought (e.g. MINTO absent), we
|
|
291
|
+
// cannot meaningfully compare. Skip silently; the 90-00 schema layer
|
|
292
|
+
// already flags missing fields.
|
|
293
|
+
if (typeof currentGt !== 'string' || currentGt.length === 0) return;
|
|
294
|
+
const expected = gthHashOf(currentGt);
|
|
295
|
+
if (expected === fileHash) return;
|
|
296
|
+
pushViolation(
|
|
297
|
+
violations,
|
|
298
|
+
STALENESS_CATEGORY,
|
|
299
|
+
'warning',
|
|
300
|
+
'BRAIN.md governing_thought_hash does not match current triple (derivation stale, enqueue regen)',
|
|
301
|
+
{
|
|
302
|
+
field: 'governing_thought_hash',
|
|
303
|
+
action_hint: 'enqueue_regen',
|
|
304
|
+
}
|
|
305
|
+
);
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
// ---------- Check B: brain_graph_version drift ----------
|
|
309
|
+
|
|
310
|
+
function runGraphVersionDriftCheck(fm, roomDir, violations) {
|
|
311
|
+
if (!fm || !roomDir) return;
|
|
312
|
+
const fileVersion = fm.brain_graph_version;
|
|
313
|
+
if (typeof fileVersion !== 'number' || !Number.isSafeInteger(fileVersion)) {
|
|
314
|
+
return;
|
|
315
|
+
}
|
|
316
|
+
const cachePath = path.join(roomDir, '.mindrian', 'brain-schema-cache.json');
|
|
317
|
+
const cache = safeReadJson(cachePath);
|
|
318
|
+
if (!cache || typeof cache !== 'object') return;
|
|
319
|
+
const currentVersion = cache.current_graph_version;
|
|
320
|
+
if (
|
|
321
|
+
typeof currentVersion !== 'number' ||
|
|
322
|
+
!Number.isSafeInteger(currentVersion)
|
|
323
|
+
) {
|
|
324
|
+
return;
|
|
325
|
+
}
|
|
326
|
+
if (currentVersion === fileVersion) return;
|
|
327
|
+
pushViolation(
|
|
328
|
+
violations,
|
|
329
|
+
STALENESS_CATEGORY,
|
|
330
|
+
'warning',
|
|
331
|
+
'BRAIN.md brain_graph_version ' +
|
|
332
|
+
fileVersion +
|
|
333
|
+
' does not match current Brain graph version ' +
|
|
334
|
+
currentVersion +
|
|
335
|
+
' (graph_version drift)',
|
|
336
|
+
{
|
|
337
|
+
field: 'brain_graph_version',
|
|
338
|
+
action_hint: 'enqueue_regen',
|
|
339
|
+
}
|
|
340
|
+
);
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
// ---------- Check C: cross-file canon boundary scan ----------
|
|
344
|
+
|
|
345
|
+
function runCanonBoundaryScan(body, violations) {
|
|
346
|
+
if (typeof body !== 'string' || body.length === 0) return;
|
|
347
|
+
let count = 0;
|
|
348
|
+
for (const p of FORBIDDEN_PATTERNS) {
|
|
349
|
+
if (count >= CANON_BOUNDARY_CAP) break;
|
|
350
|
+
if (p.re.test(body)) {
|
|
351
|
+
pushViolation(
|
|
352
|
+
violations,
|
|
353
|
+
CANON_BOUNDARY_CATEGORY,
|
|
354
|
+
'warning',
|
|
355
|
+
'Possible Canon Part 8 leak in BRAIN.md body: ' +
|
|
356
|
+
p.hint +
|
|
357
|
+
' matched. Review for user-content seepage.',
|
|
358
|
+
{
|
|
359
|
+
field: 'body',
|
|
360
|
+
action_hint: 'canon_part8_review',
|
|
361
|
+
}
|
|
362
|
+
);
|
|
363
|
+
count += 1;
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
// ---------- validate ----------
|
|
369
|
+
|
|
370
|
+
function validate(sectionDir, ctx) {
|
|
371
|
+
const violations = [];
|
|
372
|
+
// Guardian always passes a string sectionDir. Be defensive anyway.
|
|
373
|
+
if (typeof sectionDir !== 'string' || sectionDir.length === 0) {
|
|
374
|
+
return { severity: null, violations: violations };
|
|
375
|
+
}
|
|
376
|
+
|
|
377
|
+
const brainMdPath = path.join(sectionDir, 'BRAIN.md');
|
|
378
|
+
// Absence is valid (mirrors stale-lifecycle.cjs behavior on missing
|
|
379
|
+
// ledger files). Return zero violations.
|
|
380
|
+
let stat;
|
|
381
|
+
try {
|
|
382
|
+
stat = fs.statSync(brainMdPath);
|
|
383
|
+
} catch (_e) {
|
|
384
|
+
return { severity: null, violations: violations };
|
|
385
|
+
}
|
|
386
|
+
if (!stat || !stat.isFile()) {
|
|
387
|
+
return { severity: null, violations: violations };
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
// --- Schema wrapping (Plan 90-00 validateSchema) ---
|
|
391
|
+
const schemaOutcome = runSchemaCheck(brainMdPath, violations);
|
|
392
|
+
if (schemaOutcome.shortCircuit) {
|
|
393
|
+
// Existence-critical or delimiter/parse-error. The staleness and
|
|
394
|
+
// canon_boundary checks need a parsed frontmatter; running them
|
|
395
|
+
// against a malformed file produces noise, not signal.
|
|
396
|
+
return {
|
|
397
|
+
severity: aggregateSeverity(violations),
|
|
398
|
+
violations: violations,
|
|
399
|
+
};
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
// --- Local parse for runtime checks ---
|
|
403
|
+
const raw = safeReadText(brainMdPath);
|
|
404
|
+
if (raw === null) {
|
|
405
|
+
return {
|
|
406
|
+
severity: aggregateSeverity(violations),
|
|
407
|
+
violations: violations,
|
|
408
|
+
};
|
|
409
|
+
}
|
|
410
|
+
const parsed = splitFrontmatterAndBody(raw);
|
|
411
|
+
const fm = parsed.fm;
|
|
412
|
+
const body = parsed.body;
|
|
413
|
+
|
|
414
|
+
// If fm is null here, the wrapped schema already emitted an error;
|
|
415
|
+
// runtime checks would double-report. Bail.
|
|
416
|
+
if (!fm) {
|
|
417
|
+
return {
|
|
418
|
+
severity: aggregateSeverity(violations),
|
|
419
|
+
violations: violations,
|
|
420
|
+
};
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
// --- Check A: staleness vs live triple ---
|
|
424
|
+
//
|
|
425
|
+
// When called by the Phase 88-13 guardian in session-start / on-stop
|
|
426
|
+
// / pre-commit mode, ctx does NOT carry a pre-computed triple (the
|
|
427
|
+
// guardian passes {roomDir, kind, now}). We fall back to reading the
|
|
428
|
+
// section's MINTO.md via folder-memory.readTriple. If folder-memory
|
|
429
|
+
// is unavailable or readTriple throws unexpectedly, we skip the
|
|
430
|
+
// check rather than synthesize a false violation -- fail-open.
|
|
431
|
+
let triple = ctx && ctx.triple ? ctx.triple : null;
|
|
432
|
+
if (!triple) {
|
|
433
|
+
const fm2 = lazyFolderMemory();
|
|
434
|
+
if (fm2 && typeof fm2.readTriple === 'function') {
|
|
435
|
+
try {
|
|
436
|
+
triple = fm2.readTriple(sectionDir);
|
|
437
|
+
} catch (_e) {
|
|
438
|
+
triple = null;
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
}
|
|
442
|
+
runStalenessCheck(fm, triple, violations);
|
|
443
|
+
|
|
444
|
+
// --- Check B: brain_graph_version drift ---
|
|
445
|
+
// Prefer ctx.roomDir (set by the guardian); fall back to the
|
|
446
|
+
// section's parent directory as a sensible default when called
|
|
447
|
+
// outside the guardian (e.g. direct unit tests with only a roomDir
|
|
448
|
+
// in context).
|
|
449
|
+
const roomDir =
|
|
450
|
+
(ctx && typeof ctx.roomDir === 'string' && ctx.roomDir.length > 0)
|
|
451
|
+
? ctx.roomDir
|
|
452
|
+
: path.dirname(sectionDir);
|
|
453
|
+
runGraphVersionDriftCheck(fm, roomDir, violations);
|
|
454
|
+
|
|
455
|
+
// --- Check C: canon_boundary body scan ---
|
|
456
|
+
runCanonBoundaryScan(body, violations);
|
|
457
|
+
|
|
458
|
+
return {
|
|
459
|
+
severity: aggregateSeverity(violations),
|
|
460
|
+
violations: violations,
|
|
461
|
+
};
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
module.exports = {
|
|
465
|
+
id: 'brain-md-invariants',
|
|
466
|
+
severity_map: SEVERITY_MAP,
|
|
467
|
+
scope: 'section',
|
|
468
|
+
validate: validate,
|
|
469
|
+
// Exported for downstream introspection + traceability. Not required
|
|
470
|
+
// by the registry loader, but useful to Phase 91 and the 90-08
|
|
471
|
+
// graceful-degradation suite.
|
|
472
|
+
SEVERITY_BY_CATEGORY: SEVERITY_BY_CATEGORY,
|
|
473
|
+
FORBIDDEN_PATTERNS: FORBIDDEN_PATTERNS,
|
|
474
|
+
CANON_BOUNDARY_CAP: CANON_BOUNDARY_CAP,
|
|
475
|
+
};
|