@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.
Files changed (597) hide show
  1. package/.claude-plugin/plugin.json +21 -0
  2. package/.mcp.json +9 -0
  3. package/CHANGELOG.md +3333 -0
  4. package/LICENSE +123 -0
  5. package/README.md +673 -0
  6. package/agents/brain-query.md +80 -0
  7. package/agents/framework-runner.md +237 -0
  8. package/agents/grading.md +188 -0
  9. package/agents/investor.md +128 -0
  10. package/agents/larry-extended.md +135 -0
  11. package/agents/opportunity-scanner.md +91 -0
  12. package/agents/persona-analyst.md +132 -0
  13. package/agents/research.md +89 -0
  14. package/agents/reverse-salient-agent.md +27 -0
  15. package/bin/cli.js +142 -0
  16. package/bin/mindrian-mcp-server.cjs +182 -0
  17. package/bin/mindrian-tools.cjs +765 -0
  18. package/commands/act.md +439 -0
  19. package/commands/admin.md +404 -0
  20. package/commands/analyze-needs.md +42 -0
  21. package/commands/analyze-systems.md +39 -0
  22. package/commands/analyze-timing.md +42 -0
  23. package/commands/auto-explore.md +64 -0
  24. package/commands/beautiful-question.md +40 -0
  25. package/commands/brain-derive.md +78 -0
  26. package/commands/build-knowledge.md +42 -0
  27. package/commands/build-thesis.md +46 -0
  28. package/commands/causal.md +234 -0
  29. package/commands/challenge-assumptions.md +33 -0
  30. package/commands/compare-ventures.md +83 -0
  31. package/commands/dashboard.md +110 -0
  32. package/commands/deep-grade.md +82 -0
  33. package/commands/diagnose.md +58 -0
  34. package/commands/diagnostics.md +151 -0
  35. package/commands/doctor.md +151 -0
  36. package/commands/dominant-designs.md +40 -0
  37. package/commands/explain-decision.md +87 -0
  38. package/commands/explore-domains.md +42 -0
  39. package/commands/explore-futures.md +40 -0
  40. package/commands/explore-trends.md +42 -0
  41. package/commands/export.md +103 -0
  42. package/commands/file-meeting.md +724 -0
  43. package/commands/find-analogies.md +188 -0
  44. package/commands/find-bottlenecks.md +62 -0
  45. package/commands/find-connections.md +76 -0
  46. package/commands/funding.md +81 -0
  47. package/commands/grade.md +203 -0
  48. package/commands/graph.md +128 -0
  49. package/commands/hat-briefing.md +125 -0
  50. package/commands/heal.md +196 -0
  51. package/commands/help.md +399 -0
  52. package/commands/hmi-status.md +172 -0
  53. package/commands/jtbd.md +241 -0
  54. package/commands/leadership.md +73 -0
  55. package/commands/lean-canvas.md +40 -0
  56. package/commands/macro-trends.md +40 -0
  57. package/commands/map-unknowns.md +40 -0
  58. package/commands/memory.md +173 -0
  59. package/commands/models.md +175 -0
  60. package/commands/mos-reason.md +285 -0
  61. package/commands/mullins.md +120 -0
  62. package/commands/new-project.md +481 -0
  63. package/commands/onboard.md +434 -0
  64. package/commands/operator.md +149 -0
  65. package/commands/opportunities.md +144 -0
  66. package/commands/organize.md +497 -0
  67. package/commands/persona.md +198 -0
  68. package/commands/pipeline.md +112 -0
  69. package/commands/present.md +91 -0
  70. package/commands/publish.md +201 -0
  71. package/commands/query.md +124 -0
  72. package/commands/radar.md +72 -0
  73. package/commands/reanalyze.md +91 -0
  74. package/commands/research.md +196 -0
  75. package/commands/room.md +352 -0
  76. package/commands/rooms.md +598 -0
  77. package/commands/root-cause.md +40 -0
  78. package/commands/rs-experts.md +85 -0
  79. package/commands/rs-explain.md +100 -0
  80. package/commands/rs-fetch.md +94 -0
  81. package/commands/rs-thesis.md +85 -0
  82. package/commands/scenario-plan.md +40 -0
  83. package/commands/scheduled-tasks.md +285 -0
  84. package/commands/score-innovation.md +43 -0
  85. package/commands/scout.md +239 -0
  86. package/commands/setup.md +618 -0
  87. package/commands/snapshot.md +147 -0
  88. package/commands/speakers.md +84 -0
  89. package/commands/splash.md +28 -0
  90. package/commands/status.md +75 -0
  91. package/commands/structure-argument.md +42 -0
  92. package/commands/suggest-next.md +80 -0
  93. package/commands/systems-thinking.md +40 -0
  94. package/commands/think-hats.md +42 -0
  95. package/commands/update.md +181 -0
  96. package/commands/user-needs.md +40 -0
  97. package/commands/validate.md +40 -0
  98. package/commands/value-proposition.md +61 -0
  99. package/commands/vault.md +180 -0
  100. package/commands/visualize.md +52 -0
  101. package/commands/whitespace.md +507 -0
  102. package/commands/wiki.md +69 -0
  103. package/hooks/hooks.json +381 -0
  104. package/hooks/run-hook.cmd +64 -0
  105. package/lib/__init__.py +0 -0
  106. package/lib/__pycache__/__init__.cpython-312.pyc +0 -0
  107. package/lib/agents/auto-explore-agent.cjs +1043 -0
  108. package/lib/agents/reverse-salient-agent.cjs +679 -0
  109. package/lib/agents/tension-hook-agent.cjs +544 -0
  110. package/lib/brain/ROOM.md +44 -0
  111. package/lib/brain/chain-recommender.cjs +301 -0
  112. package/lib/chat/chat-context.js +185 -0
  113. package/lib/chat/chat-panel.js +721 -0
  114. package/lib/chat/fabric-chat.cjs +288 -0
  115. package/lib/chat/generative-tools.js +219 -0
  116. package/lib/conversation/ROOM.md +39 -0
  117. package/lib/conversation/classifier-rules.json +38 -0
  118. package/lib/conversation/classifier.cjs +264 -0
  119. package/lib/conversation/operator.cjs +287 -0
  120. package/lib/copy/115-spec-strings.cjs +55 -0
  121. package/lib/core/__init__.py +0 -0
  122. package/lib/core/__nav-stub.cjs +14 -0
  123. package/lib/core/__pycache__/__init__.cpython-312.pyc +0 -0
  124. package/lib/core/__pycache__/rs-math.cpython-312.pyc +0 -0
  125. package/lib/core/__pycache__/rs_cache.cpython-312.pyc +0 -0
  126. package/lib/core/__pycache__/rs_corpus.cpython-312.pyc +0 -0
  127. package/lib/core/__pycache__/rs_hybrid.cpython-312.pyc +0 -0
  128. package/lib/core/__pycache__/rs_math.cpython-312.pyc +0 -0
  129. package/lib/core/__pycache__/rs_rooms.cpython-312.pyc +0 -0
  130. package/lib/core/artifact-id.cjs +148 -0
  131. package/lib/core/asset-ops.cjs +151 -0
  132. package/lib/core/auto-commit-throttle.cjs +129 -0
  133. package/lib/core/bearer-token.cjs +199 -0
  134. package/lib/core/brain-client.cjs +865 -0
  135. package/lib/core/brain-derivation-prompts.cjs +326 -0
  136. package/lib/core/brain-derivation-queue.cjs +431 -0
  137. package/lib/core/brain-derivation.cjs +580 -0
  138. package/lib/core/brain-md-schema.cjs +528 -0
  139. package/lib/core/brain-md-staleness.cjs +357 -0
  140. package/lib/core/brain-response-sanitize.cjs +188 -0
  141. package/lib/core/bridge-writer.cjs +477 -0
  142. package/lib/core/chat-context-builder.cjs +253 -0
  143. package/lib/core/cross-room-aggregator.cjs +762 -0
  144. package/lib/core/daily-briefing.cjs +438 -0
  145. package/lib/core/decision-capture.cjs +618 -0
  146. package/lib/core/deep-links.cjs +82 -0
  147. package/lib/core/dispatch-optimizer.cjs +354 -0
  148. package/lib/core/dual-path-detector.cjs +84 -0
  149. package/lib/core/dual-path-detector.test.cjs +334 -0
  150. package/lib/core/exports-log.cjs +79 -0
  151. package/lib/core/feynman-minto-invariants.cjs +605 -0
  152. package/lib/core/folder-memory-async.cjs +338 -0
  153. package/lib/core/folder-memory-shared.cjs +890 -0
  154. package/lib/core/folder-memory.cjs +416 -0
  155. package/lib/core/framework-chain-composer.cjs +411 -0
  156. package/lib/core/frontmatter-schemas.cjs +330 -0
  157. package/lib/core/git-ops.cjs +141 -0
  158. package/lib/core/graph-ops.cjs +258 -0
  159. package/lib/core/hat-persistence.cjs +362 -0
  160. package/lib/core/index.cjs +60 -0
  161. package/lib/core/integration-registry.cjs +232 -0
  162. package/lib/core/intelligence-cascade.cjs +661 -0
  163. package/lib/core/lazygraph-ops.cjs +1057 -0
  164. package/lib/core/lru-cache.cjs +139 -0
  165. package/lib/core/mcp-profiles.cjs +182 -0
  166. package/lib/core/meeting-ops.cjs +54 -0
  167. package/lib/core/memory-ops.cjs +600 -0
  168. package/lib/core/migrations/ROOM.md +33 -0
  169. package/lib/core/migrations/phase-109-nodes-provenance.cjs +339 -0
  170. package/lib/core/migrations/phase-109-session-focus.cjs +99 -0
  171. package/lib/core/model-profiles.cjs +246 -0
  172. package/lib/core/mullins-scaffold.cjs +160 -0
  173. package/lib/core/nav-dial.cjs +316 -0
  174. package/lib/core/navigation/ROOM.md +15 -0
  175. package/lib/core/navigation/explanation.cjs +43 -0
  176. package/lib/core/navigation/focus.cjs +135 -0
  177. package/lib/core/navigation/ingestion.cjs +82 -0
  178. package/lib/core/navigation/insights.cjs +350 -0
  179. package/lib/core/navigation/memory-events.cjs +118 -0
  180. package/lib/core/navigation/neighborhood.cjs +78 -0
  181. package/lib/core/navigation/packet.cjs +182 -0
  182. package/lib/core/navigation/room-home.cjs +127 -0
  183. package/lib/core/navigation/transitions.cjs +82 -0
  184. package/lib/core/navigation-engine-shared.cjs +242 -0
  185. package/lib/core/navigation-engine.cjs +664 -0
  186. package/lib/core/navigation.cjs +60 -0
  187. package/lib/core/nl-graph-queries.cjs +164 -0
  188. package/lib/core/offer-presenter.cjs +406 -0
  189. package/lib/core/opportunity-extractor.cjs +183 -0
  190. package/lib/core/opportunity-ops.cjs +1371 -0
  191. package/lib/core/persona-ops.cjs +537 -0
  192. package/lib/core/persona-taxonomy.cjs +190 -0
  193. package/lib/core/platform-gates.cjs +120 -0
  194. package/lib/core/platform.cjs +257 -0
  195. package/lib/core/proactive-intelligence.cjs +528 -0
  196. package/lib/core/problem-type-router.cjs +315 -0
  197. package/lib/core/reasoning-ops.cjs +639 -0
  198. package/lib/core/reverse-salient-persona-suffix.cjs +115 -0
  199. package/lib/core/room-classifier-strict-mode.cjs +229 -0
  200. package/lib/core/room-db.cjs +127 -0
  201. package/lib/core/room-ops-async.cjs +92 -0
  202. package/lib/core/room-ops-shared.cjs +64 -0
  203. package/lib/core/room-ops-sync.cjs +70 -0
  204. package/lib/core/room-ops.cjs +32 -0
  205. package/lib/core/room-type-detector.cjs +386 -0
  206. package/lib/core/rs-brain-substrate-prompts.cjs +129 -0
  207. package/lib/core/rs-brain-substrate.cjs +570 -0
  208. package/lib/core/rs-breakthrough-scorer.cjs +255 -0
  209. package/lib/core/rs-canon-violations.cjs +82 -0
  210. package/lib/core/rs-chain-feeder.cjs +343 -0
  211. package/lib/core/rs-commercial-assessor.cjs +280 -0
  212. package/lib/core/rs-differential-scorer.cjs +376 -0
  213. package/lib/core/rs-domain-analyzer.cjs +385 -0
  214. package/lib/core/rs-egress-prompts.cjs +113 -0
  215. package/lib/core/rs-egress-telemetry.cjs +225 -0
  216. package/lib/core/rs-egress-violations.cjs +53 -0
  217. package/lib/core/rs-expert-mapper.cjs +467 -0
  218. package/lib/core/rs-fetcher-academic.cjs +697 -0
  219. package/lib/core/rs-fetcher-experts.cjs +314 -0
  220. package/lib/core/rs-fetcher-industry.cjs +731 -0
  221. package/lib/core/rs-fetcher-patents.cjs +564 -0
  222. package/lib/core/rs-innovation-classifier.cjs +194 -0
  223. package/lib/core/rs-mind-map.cjs +656 -0
  224. package/lib/core/rs-neo4j-writer.cjs +388 -0
  225. package/lib/core/rs-nl-to-query.cjs +425 -0
  226. package/lib/core/rs-pinecone-bridge.cjs +303 -0
  227. package/lib/core/rs-preprocessor.cjs +350 -0
  228. package/lib/core/rs-query-matrix.cjs +316 -0
  229. package/lib/core/rs-query-to-text.cjs +438 -0
  230. package/lib/core/rs-sqlite-mirror.cjs +443 -0
  231. package/lib/core/rs-thesis-generator.cjs +188 -0
  232. package/lib/core/rs_cache.py +479 -0
  233. package/lib/core/rs_corpus.py +468 -0
  234. package/lib/core/rs_hybrid.py +586 -0
  235. package/lib/core/rs_math.py +287 -0
  236. package/lib/core/rs_rooms.py +193 -0
  237. package/lib/core/scheduled-scanner.cjs +463 -0
  238. package/lib/core/scratchpad-ops.cjs +201 -0
  239. package/lib/core/section-8-trace-schema.cjs +138 -0
  240. package/lib/core/section-registry.cjs +111 -0
  241. package/lib/core/session-state.cjs +144 -0
  242. package/lib/core/shallow-doc-parser.cjs +174 -0
  243. package/lib/core/shallow-doc-parser.test.cjs +226 -0
  244. package/lib/core/skill-activation-router.cjs +284 -0
  245. package/lib/core/state-ops.cjs +46 -0
  246. package/lib/core/statusline-cache.cjs +266 -0
  247. package/lib/core/token-estimator.cjs +348 -0
  248. package/lib/core/user-archetype.cjs +239 -0
  249. package/lib/core/user-md-ops.cjs +524 -0
  250. package/lib/core/visual-ops.cjs +624 -0
  251. package/lib/core/write-lock.cjs +149 -0
  252. package/lib/graph/canvas-graph.js +467 -0
  253. package/lib/graph/constellation-config.cjs +299 -0
  254. package/lib/graph/graph-detail-panel.js +165 -0
  255. package/lib/hmi/ROOM.md +47 -0
  256. package/lib/hmi/across-session-memory.cjs +604 -0
  257. package/lib/hmi/cross-room-memory.cjs +575 -0
  258. package/lib/hmi/decoy-tier.cjs +395 -0
  259. package/lib/hmi/jtbd-classifier.cjs +219 -0
  260. package/lib/hmi/jtbd-state.cjs +199 -0
  261. package/lib/hmi/jtbd-taxonomy.json +392 -0
  262. package/lib/hmi/selector-dispatcher.cjs +546 -0
  263. package/lib/hmi/selector-telemetry.cjs +263 -0
  264. package/lib/hmi/shape-f0-renderer.cjs +139 -0
  265. package/lib/hmi/shape-f1-fallback.cjs +80 -0
  266. package/lib/hmi/shape-f1-renderer.cjs +138 -0
  267. package/lib/hmi/shape-f2-renderer.cjs +132 -0
  268. package/lib/hmi/shape-f3-renderer.cjs +66 -0
  269. package/lib/hmi/shape-f4-renderer.cjs +72 -0
  270. package/lib/hmi/shape-f5-renderer.cjs +155 -0
  271. package/lib/hmi/shape-f6-plan-review-renderer.cjs +312 -0
  272. package/lib/hmi/shape-f6-renderer.cjs +144 -0
  273. package/lib/hmi/shape-g-renderer.cjs +219 -0
  274. package/lib/hmi/shape-h-renderer.cjs +222 -0
  275. package/lib/hmi/tier-check.cjs +63 -0
  276. package/lib/import/PRECONDITIONS.md +41 -0
  277. package/lib/import/branding.cjs +210 -0
  278. package/lib/import/branding.test.cjs +235 -0
  279. package/lib/import/classifications-sync.cjs +104 -0
  280. package/lib/import/classifications-sync.test.cjs +129 -0
  281. package/lib/import/enricher.cjs +296 -0
  282. package/lib/import/enricher.test.cjs +273 -0
  283. package/lib/import/integration.test.cjs +376 -0
  284. package/lib/import/manifest.cjs +129 -0
  285. package/lib/import/manifest.schema.json +185 -0
  286. package/lib/import/manifest.test.cjs +123 -0
  287. package/lib/import/meeting-detector.cjs +92 -0
  288. package/lib/import/meeting-detector.test.cjs +100 -0
  289. package/lib/import/person-detector.cjs +229 -0
  290. package/lib/import/person-detector.test.cjs +149 -0
  291. package/lib/import/report.cjs +186 -0
  292. package/lib/import/report.test.cjs +186 -0
  293. package/lib/import/room-md-scaffolder.cjs +49 -0
  294. package/lib/import/router.cjs +224 -0
  295. package/lib/import/router.test.cjs +356 -0
  296. package/lib/import/run-all-tests.cjs +36 -0
  297. package/lib/import/smoke-test.cjs +213 -0
  298. package/lib/import/smoke-test.test.cjs +148 -0
  299. package/lib/import/test-fixtures/collision-vault/preexisting-room/STATE.md +8 -0
  300. package/lib/import/test-fixtures/collision-vault/preexisting-room/problem-definition/onboarding/onboarding.md +7 -0
  301. package/lib/import/test-fixtures/collision-vault/source/onboarding.md +5 -0
  302. package/lib/import/test-fixtures/obsidian-vault/.obsidian/workspace.json +1 -0
  303. package/lib/import/test-fixtures/obsidian-vault/notes/with-wikilinks.md +4 -0
  304. package/lib/import/test-fixtures/tiny-vault/notes/2026-01-15-team-sync.md +9 -0
  305. package/lib/import/test-fixtures/tiny-vault/notes/empty.md +3 -0
  306. package/lib/import/test-fixtures/tiny-vault/notes/onboarding.md +5 -0
  307. package/lib/import/test-fixtures/tiny-vault/notes/pricing.md +5 -0
  308. package/lib/import/test-fixtures/tiny-vault/notes/random.md +4 -0
  309. package/lib/import/undo.test.cjs +199 -0
  310. package/lib/import/vault-scanner.cjs +105 -0
  311. package/lib/import/vault-scanner.test.cjs +67 -0
  312. package/lib/mcp/app-html/dashboard.html +316 -0
  313. package/lib/mcp/app-html/graph.html +428 -0
  314. package/lib/mcp/app-html/mindrian-platform.html +1841 -0
  315. package/lib/mcp/app-html/wiki.html +383 -0
  316. package/lib/mcp/app-views.cjs +322 -0
  317. package/lib/mcp/brain-router.cjs +418 -0
  318. package/lib/mcp/capability-registry.cjs +62 -0
  319. package/lib/mcp/larry-context.cjs +46 -0
  320. package/lib/mcp/larry-server-instructions.md +114 -0
  321. package/lib/mcp/pipeline-state.cjs +275 -0
  322. package/lib/mcp/prompts.cjs +302 -0
  323. package/lib/mcp/resources.cjs +227 -0
  324. package/lib/mcp/session-catchup.cjs +327 -0
  325. package/lib/mcp/surface-detect.cjs +75 -0
  326. package/lib/mcp/tool-router.cjs +1034 -0
  327. package/lib/memory/aaak-compress.cjs +403 -0
  328. package/lib/memory/aaak-compress.test.cjs +288 -0
  329. package/lib/memory/async-artifact-auto-commit.test.cjs +223 -0
  330. package/lib/memory/bearer-token.test.cjs +315 -0
  331. package/lib/memory/brain-cache-lru.test.cjs +259 -0
  332. package/lib/memory/brain-client-query-shape.test.cjs +160 -0
  333. package/lib/memory/brain-derivation-graceful-degradation.test.cjs +1019 -0
  334. package/lib/memory/brain-derivation-queue.test.cjs +539 -0
  335. package/lib/memory/brain-derivation.test.cjs +634 -0
  336. package/lib/memory/brain-derive-command.test.cjs +534 -0
  337. package/lib/memory/brain-md-invariants-validator.test.cjs +704 -0
  338. package/lib/memory/brain-md-schema.test.cjs +467 -0
  339. package/lib/memory/brain-md-staleness.test.cjs +525 -0
  340. package/lib/memory/brain-server-resolution.test.cjs +314 -0
  341. package/lib/memory/chain-recommender.test.cjs +233 -0
  342. package/lib/memory/chat-context.test.cjs +128 -0
  343. package/lib/memory/command-registry.test.cjs +220 -0
  344. package/lib/memory/cross-room-aggregator.test.cjs +909 -0
  345. package/lib/memory/dashboard-server.test.cjs +256 -0
  346. package/lib/memory/debouncer-drain-at-prompt.test.cjs +389 -0
  347. package/lib/memory/decision-capture.test.cjs +632 -0
  348. package/lib/memory/decision-capture.worker.cjs +70 -0
  349. package/lib/memory/explain-decision-command.test.cjs +521 -0
  350. package/lib/memory/explain-decision-footer.test.cjs +316 -0
  351. package/lib/memory/explored-materials-store.cjs +392 -0
  352. package/lib/memory/feynman-minto-guardian.test.cjs +736 -0
  353. package/lib/memory/feynman-minto-invariants.test.cjs +511 -0
  354. package/lib/memory/feynman-prompts-drift.test.cjs +144 -0
  355. package/lib/memory/feynman-prompts.cjs +151 -0
  356. package/lib/memory/feynman-prompts.test.cjs +96 -0
  357. package/lib/memory/folder-memory-quadruple.test.cjs +548 -0
  358. package/lib/memory/folder-memory.test.cjs +503 -0
  359. package/lib/memory/framework-chain-composer.test.cjs +515 -0
  360. package/lib/memory/frontmatter-schema-validator.test.cjs +290 -0
  361. package/lib/memory/heal-command.test.cjs +604 -0
  362. package/lib/memory/index-artifact-transaction.test.cjs +333 -0
  363. package/lib/memory/lazygraph-rs-discoveries-view.test.cjs +122 -0
  364. package/lib/memory/mcp-input-validation.test.cjs +240 -0
  365. package/lib/memory/mcp-server-brain-deps.test.cjs +270 -0
  366. package/lib/memory/mcp-stack-fallback.test.cjs +433 -0
  367. package/lib/memory/minto-debouncer.test.cjs +407 -0
  368. package/lib/memory/minto-debouncer.worker.cjs +46 -0
  369. package/lib/memory/minto-migration-v88.test.cjs +265 -0
  370. package/lib/memory/minto-schema-v88.test.cjs +390 -0
  371. package/lib/memory/mos-status-renderer.test.cjs +631 -0
  372. package/lib/memory/narrative-schema.cjs +376 -0
  373. package/lib/memory/narrative-schema.test.cjs +209 -0
  374. package/lib/memory/nav-dial.test.cjs +414 -0
  375. package/lib/memory/navigation-engine-core.test.cjs +722 -0
  376. package/lib/memory/navigation-invariants.test.cjs +483 -0
  377. package/lib/memory/offer-presenter.test.cjs +554 -0
  378. package/lib/memory/on-stop-snapshot.test.cjs +404 -0
  379. package/lib/memory/pending-tension-store.cjs +373 -0
  380. package/lib/memory/post-compact-reinjection.test.cjs +854 -0
  381. package/lib/memory/post-write-triple.test.cjs +317 -0
  382. package/lib/memory/pre-compact-snapshot.test.cjs +495 -0
  383. package/lib/memory/problem-type-router.test.cjs +656 -0
  384. package/lib/memory/query-efficiency-telemetry.test.cjs +370 -0
  385. package/lib/memory/recompile-room-references.test.cjs +392 -0
  386. package/lib/memory/recompile-room-references.worker.cjs +42 -0
  387. package/lib/memory/record-decision-dual-write.test.cjs +454 -0
  388. package/lib/memory/room-classifier-strict-mode.test.cjs +417 -0
  389. package/lib/memory/room-minto-hook.test.cjs +398 -0
  390. package/lib/memory/rs-discovery-engine.test.cjs +323 -0
  391. package/lib/memory/run-feynman-tests.cjs +1247 -0
  392. package/lib/memory/security-trifecta.test.cjs +312 -0
  393. package/lib/memory/session-start-brain-staleness.test.cjs +363 -0
  394. package/lib/memory/session-start-triple-injection.test.cjs +514 -0
  395. package/lib/memory/sessionstart-banner-formatter.cjs +318 -0
  396. package/lib/memory/sessionstart-minto-banner.test.cjs +373 -0
  397. package/lib/memory/skill-activation-router.test.cjs +419 -0
  398. package/lib/memory/stamp-artifact-write.test.cjs +304 -0
  399. package/lib/memory/statusline-active-room.test.cjs +315 -0
  400. package/lib/memory/statusline-minto-segment.test.cjs +292 -0
  401. package/lib/memory/sync-async-entry-points.test.cjs +204 -0
  402. package/lib/memory/test-bridge-writer-enhanced.cjs +452 -0
  403. package/lib/memory/test-rs-brain-substrate-shape.cjs +529 -0
  404. package/lib/memory/test-rs-brain-substrate.cjs +636 -0
  405. package/lib/memory/test-rs-breakthrough-scorer.cjs +375 -0
  406. package/lib/memory/test-rs-canon-violations.cjs +218 -0
  407. package/lib/memory/test-rs-chain-feeder-core.cjs +344 -0
  408. package/lib/memory/test-rs-chain-feeder-skill-spawn.cjs +297 -0
  409. package/lib/memory/test-rs-commercial-assessor.cjs +385 -0
  410. package/lib/memory/test-rs-differential-scorer.cjs +480 -0
  411. package/lib/memory/test-rs-discovery-engine.cjs +603 -0
  412. package/lib/memory/test-rs-domain-analyzer.cjs +492 -0
  413. package/lib/memory/test-rs-egress-primitives.cjs +420 -0
  414. package/lib/memory/test-rs-expert-mapper.cjs +547 -0
  415. package/lib/memory/test-rs-explain-command.cjs +443 -0
  416. package/lib/memory/test-rs-fetcher-academic.cjs +848 -0
  417. package/lib/memory/test-rs-fetcher-experts.cjs +496 -0
  418. package/lib/memory/test-rs-fetcher-industry.cjs +702 -0
  419. package/lib/memory/test-rs-fetcher-patents.cjs +674 -0
  420. package/lib/memory/test-rs-innovation-classifier.cjs +301 -0
  421. package/lib/memory/test-rs-mind-map.cjs +646 -0
  422. package/lib/memory/test-rs-neo4j-writer.cjs +518 -0
  423. package/lib/memory/test-rs-nl-to-query.cjs +449 -0
  424. package/lib/memory/test-rs-pinecone-bridge.cjs +277 -0
  425. package/lib/memory/test-rs-preprocessor.cjs +433 -0
  426. package/lib/memory/test-rs-query-matrix.cjs +391 -0
  427. package/lib/memory/test-rs-query-to-text.cjs +551 -0
  428. package/lib/memory/test-rs-sqlite-mirror.cjs +649 -0
  429. package/lib/memory/test-rs-thesis-generator.cjs +360 -0
  430. package/lib/memory/triple-context-formatter.cjs +473 -0
  431. package/lib/memory/triple-context-formatter.test.cjs +442 -0
  432. package/lib/memory/user-md-persona.test.cjs +565 -0
  433. package/lib/memory/userpromptsubmit-integration.test.cjs +690 -0
  434. package/lib/memory/validators/README.md +157 -0
  435. package/lib/memory/validators/brain-md-invariants.cjs +475 -0
  436. package/lib/memory/validators/brain-substrate-invariants.cjs +285 -0
  437. package/lib/memory/validators/external-academic-invariants.cjs +249 -0
  438. package/lib/memory/validators/external-industry-invariants.cjs +271 -0
  439. package/lib/memory/validators/external-patents-invariants.cjs +266 -0
  440. package/lib/memory/validators/minto-invariants.cjs +62 -0
  441. package/lib/memory/validators/navigation-invariants.cjs +340 -0
  442. package/lib/memory/validators/queue-health.cjs +95 -0
  443. package/lib/memory/validators/snapshot-integrity.cjs +129 -0
  444. package/lib/memory/validators/stale-lifecycle.cjs +116 -0
  445. package/lib/memory/vault-section-minto-generator-atomic.test.cjs +556 -0
  446. package/lib/memory/vault-section-minto-generator-atomic.worker.cjs +73 -0
  447. package/lib/memory/write-lock-atomic.test.cjs +137 -0
  448. package/lib/memory/write-lock-atomic.worker.cjs +55 -0
  449. package/lib/parity/check-parity.cjs +83 -0
  450. package/lib/presentation/presentation-server.cjs +101 -0
  451. package/lib/presentation/presentation-watcher.cjs +123 -0
  452. package/lib/quickview/hub-server.cjs +719 -0
  453. package/lib/quickview/server.cjs +533 -0
  454. package/lib/render/JTBD-PALETTES.md +145 -0
  455. package/lib/render/ROOM.md +59 -0
  456. package/lib/render/render-v2.cjs +486 -0
  457. package/lib/render/render-v2.test.cjs +267 -0
  458. package/lib/render/render.cjs +65 -0
  459. package/lib/state/ROOM.md +46 -0
  460. package/lib/state/state-md-parser.cjs +215 -0
  461. package/lib/statusline/ROOM.md +38 -0
  462. package/lib/statusline/banner-suppression.cjs +50 -0
  463. package/lib/statusline/surface-detect.cjs +85 -0
  464. package/lib/update-bootstrap.sh.template +145 -0
  465. package/lib/vault/frontmatter-schema.cjs +297 -0
  466. package/lib/vault/room-scanner.cjs +352 -0
  467. package/lib/vault/wikilink-builder.cjs +231 -0
  468. package/lib/vault/wikilink-builder.test.cjs +182 -0
  469. package/lib/wiki/graph-links.cjs +281 -0
  470. package/lib/wiki/page-renderer.cjs +229 -0
  471. package/lib/wiki/wiki-chat.cjs +81 -0
  472. package/lib/wiki/wiki-layout.cjs +1459 -0
  473. package/lib/wiki/wiki-search.cjs +142 -0
  474. package/lib/wiki/wiki-server.cjs +678 -0
  475. package/lib/wiki/wiki-watcher.cjs +105 -0
  476. package/lib/workflow/ROOM.md +47 -0
  477. package/lib/workflow/command-resolver.cjs +155 -0
  478. package/lib/workflow/command-resolver.test.cjs +235 -0
  479. package/package.json +44 -0
  480. package/pipelines/analogy/01-decompose.md +80 -0
  481. package/pipelines/analogy/02-abstract.md +87 -0
  482. package/pipelines/analogy/03-search.md +135 -0
  483. package/pipelines/analogy/04-transfer.md +101 -0
  484. package/pipelines/analogy/05-validate.md +106 -0
  485. package/pipelines/analogy/CHAIN.md +56 -0
  486. package/pipelines/discovery/01-explore-domains.md +44 -0
  487. package/pipelines/discovery/02-think-hats.md +50 -0
  488. package/pipelines/discovery/03-analyze-needs.md +54 -0
  489. package/pipelines/discovery/CHAIN.md +37 -0
  490. package/pipelines/thesis/01-structure-argument.md +45 -0
  491. package/pipelines/thesis/02-challenge-assumptions.md +48 -0
  492. package/pipelines/thesis/03-build-thesis.md +54 -0
  493. package/pipelines/thesis/CHAIN.md +37 -0
  494. package/references/brain/causal-directives.md +91 -0
  495. package/references/brain/causal-enrichment.cypher +165 -0
  496. package/references/brain/command-triggers-schema.md +226 -0
  497. package/references/brain/graph-architecture.md +317 -0
  498. package/references/brain/query-patterns.md +460 -0
  499. package/references/brain/room-hierarchy-schema.md +218 -0
  500. package/references/brain/schema.md +76 -0
  501. package/references/capability-radar/capabilities-index.md +241 -0
  502. package/references/capability-radar/changelog-cache.md +81 -0
  503. package/references/causal/causal-schema.md +103 -0
  504. package/references/design/email-template-standard.md +155 -0
  505. package/references/design/graph-visualization-standard.md +178 -0
  506. package/references/document-generation.md +179 -0
  507. package/references/hsi/HSI-TOOLS-REFERENCE.md +222 -0
  508. package/references/import-config.md +141 -0
  509. package/references/integrations/detection-patterns.md +101 -0
  510. package/references/meeting/artifact-template.md +377 -0
  511. package/references/meeting/cross-meeting-intelligence.md +216 -0
  512. package/references/meeting/cross-relationship-patterns.md +202 -0
  513. package/references/meeting/live-join-interface.md +244 -0
  514. package/references/meeting/section-mapping.md +192 -0
  515. package/references/meeting/segment-classification.md +258 -0
  516. package/references/meeting/speaker-profile-template.md +219 -0
  517. package/references/meeting/summary-template.md +348 -0
  518. package/references/meeting/transcript-patterns.md +226 -0
  519. package/references/methodology/analyze-needs.md +135 -0
  520. package/references/methodology/analyze-systems.md +121 -0
  521. package/references/methodology/analyze-timing.md +149 -0
  522. package/references/methodology/beautiful-question.md +109 -0
  523. package/references/methodology/build-knowledge.md +161 -0
  524. package/references/methodology/build-thesis.md +237 -0
  525. package/references/methodology/challenge-assumptions.md +127 -0
  526. package/references/methodology/diagnose.md +169 -0
  527. package/references/methodology/dominant-designs.md +212 -0
  528. package/references/methodology/explore-domains.md +147 -0
  529. package/references/methodology/explore-futures.md +163 -0
  530. package/references/methodology/explore-trends.md +129 -0
  531. package/references/methodology/find-bottlenecks.md +131 -0
  532. package/references/methodology/grade.md +211 -0
  533. package/references/methodology/index.md +97 -0
  534. package/references/methodology/leadership.md +200 -0
  535. package/references/methodology/lean-canvas.md +116 -0
  536. package/references/methodology/macro-trends.md +192 -0
  537. package/references/methodology/map-unknowns.md +137 -0
  538. package/references/methodology/mullins-7-domains.md +104 -0
  539. package/references/methodology/problem-types.md +65 -0
  540. package/references/methodology/root-cause.md +178 -0
  541. package/references/methodology/sapphire-encoding.md +355 -0
  542. package/references/methodology/scenario-plan.md +178 -0
  543. package/references/methodology/score-innovation.md +154 -0
  544. package/references/methodology/structure-argument.md +158 -0
  545. package/references/methodology/systems-thinking.md +159 -0
  546. package/references/methodology/think-hats.md +147 -0
  547. package/references/methodology/triz-matrix.json +751 -0
  548. package/references/methodology/triz-principles.md +501 -0
  549. package/references/methodology/user-needs.md +199 -0
  550. package/references/methodology/validate.md +163 -0
  551. package/references/methodology/value-proposition.md +244 -0
  552. package/references/opportunities/funding-lifecycle.md +103 -0
  553. package/references/opportunities/grant-api-patterns.md +99 -0
  554. package/references/opportunities/opportunity-template.md +84 -0
  555. package/references/personality/assessment-philosophy.md +72 -0
  556. package/references/personality/lexicon.md +100 -0
  557. package/references/personality/persona-chains.md +56 -0
  558. package/references/personality/pws-lexicon-full.md +499 -0
  559. package/references/personality/voice-dna.md +156 -0
  560. package/references/personas/hat-perspectives.md +76 -0
  561. package/references/personas/persona-template.md +63 -0
  562. package/references/pipeline/act-output-contract.md +88 -0
  563. package/references/pipeline/chains-index.md +39 -0
  564. package/references/pws-profile-generation.md +79 -0
  565. package/references/reasoning/reasoning-schema.md +143 -0
  566. package/references/reasoning/reasoning-template.md +68 -0
  567. package/references/reasoning/run-template.md +38 -0
  568. package/references/research/RESEARCH_14_CLAUDE_CODE_SOURCE_ARCHITECTURE.md +209 -0
  569. package/references/research/RESEARCH_15_V1.8_OPTIMIZATION_JTBD.md +375 -0
  570. package/references/research/RESEARCH_16_NATIVE_FIRST_PLUGIN_ARCHITECTURE.md +575 -0
  571. package/references/research/RESEARCH_17_MCP_UI_FRAMEWORKS.md +272 -0
  572. package/references/taxonomy/TAXONOMY.md +192 -0
  573. package/references/templates/MINTO.md +36 -0
  574. package/references/user-research/2026-04-05-leah-lawrence-session.md +202 -0
  575. package/references/vault-kit/README.md +35 -0
  576. package/references/vault-kit/app.json +12 -0
  577. package/references/vault-kit/appearance.json +12 -0
  578. package/references/vault-kit/graph.json +35 -0
  579. package/references/vault-kit/snippets/mindrian-destijl.css +297 -0
  580. package/references/vault-kit/templates/new-artifact.md +37 -0
  581. package/references/vault-kit/templates/new-meeting-note.md +35 -0
  582. package/references/vault-kit/templates/new-team-profile.md +29 -0
  583. package/references/vault-kit/templates/new-xref.md +35 -0
  584. package/references/visual/symbol-system.md +151 -0
  585. package/skills/MOSDeckEngine/SKILL.md +325 -0
  586. package/skills/brain-connector/SKILL.md +114 -0
  587. package/skills/context-engine/SKILL.md +147 -0
  588. package/skills/conversation-mode/SKILL.md +102 -0
  589. package/skills/larry-personality/SKILL.md +219 -0
  590. package/skills/larry-personality/framework-chains.md +92 -0
  591. package/skills/larry-personality/mode-engine.md +185 -0
  592. package/skills/mullins-scaffold/SKILL.md +61 -0
  593. package/skills/mullins-scaffold/scaffold.json +146 -0
  594. package/skills/pws-methodology/SKILL.md +49 -0
  595. package/skills/room-passive/SKILL.md +165 -0
  596. package/skills/room-proactive/SKILL.md +250 -0
  597. 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
+ };