@mindrian_os/cli 1.13.0-beta.10 → 1.13.0-beta.44

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