@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,604 @@
1
+ #!/usr/bin/env node
2
+ 'use strict';
3
+
4
+ /*
5
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
6
+ * (Business Source License 1.1; SPDX BUSL-1.1; see LICENSE.)
7
+ *
8
+ * Phase 94.1-01 -- /mos:heal command orchestrator fence.
9
+ *
10
+ * Why this fixture exists.
11
+ *
12
+ * The /mos:heal command wraps the 10-step room wiring heal recipe
13
+ * dog-fooded on the mindrianOS room on 2026-04-29 (see
14
+ * ~/MindrianRooms/mindrianOS/methodology/2026-04-29-v1-11-0-room-
15
+ * wiring-heal-process.md). The orchestrator is the v1.11.1 GA closing
16
+ * artifact: any user upgrading from v1.10.x to v1.11.x can self-heal
17
+ * their room without manual intervention.
18
+ *
19
+ * This test fixture proves the orchestrator runs idempotently on a
20
+ * deliberately-degraded room, writes a valid heal-log envelope, makes
21
+ * a backup before any mutation, gracefully degrades on the FEYNMINTO-01
22
+ * mega-section budget rejection, and never throws on a per-section
23
+ * failure.
24
+ *
25
+ * Test map (6 cases, one-to-one with the PLAN <behavior> block).
26
+ *
27
+ * T1 Dry-run on degraded fixture: runHeal(roomDir, {dryRun: true})
28
+ * returns plan envelope with 10 step entries; .mindrian/ NOT
29
+ * created; no files mutated.
30
+ *
31
+ * T2 Full heal on degraded fixture: runHeal(roomDir) on a
32
+ * deliberately-degraded room. Assert post-heal: 8 canonical section
33
+ * directories present; every section has ROOM.md + STATE.md;
34
+ * .mindrian/room.db nodes COUNT > 0; root STATE.md regenerated;
35
+ * backup directory populated.
36
+ *
37
+ * T3 heal-log envelope shape: <room>/.mindrian/heal-log.json present;
38
+ * valid JSON; schema_version + started_at + ended_at + room_dir +
39
+ * backup_dir + steps[10] + summary keys present; every step has
40
+ * step + status + duration_ms + details keys.
41
+ *
42
+ * T4 Backup created: .heal-backup/<TS>/ directory present; <TS>
43
+ * matches YYYYMMDD-HHMMSS pattern; pre-heal STATE.md preserved
44
+ * verbatim in backup.
45
+ *
46
+ * T5 Mega-section graceful degradation: a section with 50+ artifacts
47
+ * triggers FEYNMINTO-01 budget rejection. runHeal completes step 7
48
+ * for that section with status='blocked_feynminto_01'; no
49
+ * exception propagates; tier-0 fallback MINTO written or skipped
50
+ * gracefully. Other steps proceed normally.
51
+ *
52
+ * T6 Idempotence: runHeal twice on the same room. Second run
53
+ * completes; nothing destructive. Second-run heal-log shows step
54
+ * statuses 'ok' or 'skipped' (no 'error_*').
55
+ *
56
+ * Registered in lib/memory/run-feynman-tests.cjs.
57
+ */
58
+
59
+ const assert = require('node:assert/strict');
60
+ const fs = require('node:fs');
61
+ const os = require('node:os');
62
+ const path = require('node:path');
63
+
64
+ const REPO = path.resolve(__dirname, '..', '..');
65
+ const ORCHESTRATOR_PATH = path.join(REPO, 'scripts', 'heal-command.cjs');
66
+
67
+ // ---------- Fixture helpers ----------
68
+
69
+ const TMP_ROOTS = [];
70
+ function mkTmp(prefix) {
71
+ const d = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
72
+ TMP_ROOTS.push(d);
73
+ return d;
74
+ }
75
+
76
+ function cleanupTmp() {
77
+ for (const d of TMP_ROOTS) {
78
+ try { fs.rmSync(d, { recursive: true, force: true }); } catch (_e) { /* best effort */ }
79
+ }
80
+ TMP_ROOTS.length = 0;
81
+ }
82
+
83
+ process.on('exit', cleanupTmp);
84
+
85
+ const CANONICAL_SECTIONS = [
86
+ 'problem-definition',
87
+ 'market-analysis',
88
+ 'solution-design',
89
+ 'business-model',
90
+ 'competitive-analysis',
91
+ 'team-execution',
92
+ 'legal-ip',
93
+ 'financial-model',
94
+ ];
95
+
96
+ /**
97
+ * Build a deliberately-degraded fixture room.
98
+ *
99
+ * Degradations applied (one per recipe step that should heal):
100
+ * - missing legal-ip directory entirely (Step 2 should create it)
101
+ * - missing ROOM.md in 3 sections (Step 5 should backfill)
102
+ * - missing per-section STATE.md (Step 6 should write)
103
+ * - missing per-section MINTO.md (Step 7 should generate)
104
+ * - root STATE.md present but stale / minimal (Step 9 regenerates)
105
+ * - brain-derivation-queue.json with 1 stale entry (Step 8 reads, does NOT drain)
106
+ * - .mindrian/room.db absent (Step 4 rebuilds)
107
+ *
108
+ * The fixture has 7 of the 8 canonical sections (legal-ip missing) and
109
+ * each present section has 1 seed artifact so the local graph rebuild
110
+ * has something to index.
111
+ */
112
+ function buildDegradedFixtureRoom(tmpDir) {
113
+ // Create 7 of 8 canonical sections (legal-ip deliberately absent).
114
+ for (const s of CANONICAL_SECTIONS) {
115
+ if (s === 'legal-ip') continue;
116
+ fs.mkdirSync(path.join(tmpDir, s), { recursive: true });
117
+
118
+ // One seed artifact per section so graph rebuild has nodes.
119
+ const artifactBody =
120
+ '---\n' +
121
+ 'title: ' + s + '-seed\n' +
122
+ 'section: ' + s + '\n' +
123
+ 'date: 2026-04-29\n' +
124
+ '---\n\n' +
125
+ '# ' + s + ' seed\n\n' +
126
+ 'Seed artifact for the ' + s + ' section.\n' +
127
+ 'Captures placeholder evidence so the local graph indexes it.\n';
128
+ fs.writeFileSync(
129
+ path.join(tmpDir, s, '01-section-seed.md'),
130
+ artifactBody,
131
+ 'utf8'
132
+ );
133
+ }
134
+
135
+ // Backfill ROOM.md only on a subset of sections (3 missing).
136
+ // problem-definition + market-analysis + solution-design + business-model
137
+ // get a ROOM.md; competitive-analysis + team-execution + financial-model
138
+ // do NOT (Step 5 should backfill).
139
+ const sectionsWithRoomMd = [
140
+ 'problem-definition',
141
+ 'market-analysis',
142
+ 'solution-design',
143
+ 'business-model',
144
+ ];
145
+ for (const s of sectionsWithRoomMd) {
146
+ const roomMd =
147
+ '---\n' +
148
+ 'section: ' + s + '\n' +
149
+ 'purpose: existing ' + s + ' identity\n' +
150
+ 'methodology: bono-six-hats\n' +
151
+ 'parent: ../STATE.md\n' +
152
+ 'status: active\n' +
153
+ '---\n\n' +
154
+ '# ' + s + '\n\nThis section is wired.\n';
155
+ fs.writeFileSync(path.join(tmpDir, s, 'ROOM.md'), roomMd, 'utf8');
156
+ }
157
+
158
+ // Root STATE.md: present but minimal (Step 9 will recompute).
159
+ fs.writeFileSync(
160
+ path.join(tmpDir, 'STATE.md'),
161
+ '# Pre-heal STATE.md\n\nminimal placeholder content\n',
162
+ 'utf8'
163
+ );
164
+
165
+ // brain-derivation-queue.json with 1 stale entry (Step 8 reads).
166
+ // Use the Phase 90-02 canonical schema {version:1, entries:[...]} so
167
+ // downstream MINTO regeneration does not flag the shape as invalid
168
+ // (the writer's auto-reset on bad shape is correct behavior; we want
169
+ // to test heal Step 8's READ-ONLY contract on a well-formed queue).
170
+ fs.mkdirSync(path.join(tmpDir, '.mindrian'), { recursive: true });
171
+ fs.writeFileSync(
172
+ path.join(tmpDir, '.mindrian', 'brain-derivation-queue.json'),
173
+ JSON.stringify(
174
+ {
175
+ version: 1,
176
+ entries: [
177
+ {
178
+ section: 'problem-definition',
179
+ reason: 'governing_thought_changed',
180
+ enqueued_at: '2026-04-24T08:11:00Z',
181
+ previous_governing_thought_hash: 'sha256:' + 'a'.repeat(64),
182
+ new_governing_thought_hash: 'sha256:' + 'b'.repeat(64),
183
+ },
184
+ ],
185
+ },
186
+ null,
187
+ 2
188
+ ),
189
+ 'utf8'
190
+ );
191
+
192
+ return tmpDir;
193
+ }
194
+
195
+ /**
196
+ * Build a mega-section fixture: a room where one section has 50+
197
+ * artifacts so MINTO write triggers the FEYNMINTO-01 budget rejection
198
+ * deterministically.
199
+ */
200
+ function buildMegaSectionFixtureRoom(tmpDir) {
201
+ buildDegradedFixtureRoom(tmpDir);
202
+ // Inflate solution-design with 60 large artifacts so the rendered
203
+ // source list pushes the MINTO body over the 1500-token budget.
204
+ const inflateDir = path.join(tmpDir, 'solution-design');
205
+ for (let i = 0; i < 60; i++) {
206
+ const num = String(i + 2).padStart(2, '0');
207
+ const body =
208
+ '---\n' +
209
+ 'title: solution-artifact-' + num + '\n' +
210
+ 'section: solution-design\n' +
211
+ 'date: 2026-04-29\n' +
212
+ '---\n\n' +
213
+ '# Solution artifact ' + num + '\n\n' +
214
+ // Pad with content so each artifact contributes meaningfully to
215
+ // any rendered list / excerpt that the MINTO writer pulls in.
216
+ 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. '.repeat(40) +
217
+ '\n';
218
+ fs.writeFileSync(
219
+ path.join(inflateDir, num + '-artifact.md'),
220
+ body,
221
+ 'utf8'
222
+ );
223
+ }
224
+ return tmpDir;
225
+ }
226
+
227
+ // ---------- Tests ----------
228
+
229
+ async function runTests() {
230
+ let failures = 0;
231
+ function pass(label) { console.log('PASS ' + label); }
232
+ function fail(label, err) {
233
+ console.error('FAIL ' + label);
234
+ console.error(' ' + (err && err.message ? err.message : String(err)));
235
+ if (err && err.stack) {
236
+ console.error(err.stack.split('\n').slice(1, 4).join('\n'));
237
+ }
238
+ failures++;
239
+ }
240
+
241
+ // Defensive load. If the orchestrator does not exist yet (RED phase),
242
+ // every test fails with MODULE_NOT_FOUND, which is the desired RED
243
+ // signal. Any other failure also surfaces.
244
+ let healMod;
245
+ try {
246
+ healMod = require(ORCHESTRATOR_PATH);
247
+ } catch (e) {
248
+ // RED expected outcome: print one structured failure for each of the
249
+ // 6 cases and exit with non-zero so the runner records FAIL.
250
+ const msg = 'orchestrator not loadable: ' + (e && e.message ? e.message : String(e));
251
+ fail('T1 dry-run on degraded fixture', new Error(msg));
252
+ fail('T2 full heal on degraded fixture', new Error(msg));
253
+ fail('T3 heal-log envelope shape', new Error(msg));
254
+ fail('T4 backup created (timestamp + verbatim STATE.md preserved)', new Error(msg));
255
+ fail('T5 mega-section graceful degradation (FEYNMINTO-01)', new Error(msg));
256
+ fail('T6 idempotence (heal twice; second run no errors)', new Error(msg));
257
+ console.log('heal-command: 0/6 passed (' + failures + ' failed)');
258
+ process.exit(1);
259
+ }
260
+
261
+ if (typeof healMod.runHeal !== 'function') {
262
+ const msg = 'orchestrator missing runHeal export';
263
+ fail('T1 dry-run on degraded fixture', new Error(msg));
264
+ fail('T2 full heal on degraded fixture', new Error(msg));
265
+ fail('T3 heal-log envelope shape', new Error(msg));
266
+ fail('T4 backup created (timestamp + verbatim STATE.md preserved)', new Error(msg));
267
+ fail('T5 mega-section graceful degradation (FEYNMINTO-01)', new Error(msg));
268
+ fail('T6 idempotence (heal twice; second run no errors)', new Error(msg));
269
+ console.log('heal-command: 0/6 passed (' + failures + ' failed)');
270
+ process.exit(1);
271
+ }
272
+
273
+ const { runHeal } = healMod;
274
+
275
+ // ---------- T1 dry-run on degraded fixture ----------
276
+
277
+ try {
278
+ const roomDir = buildDegradedFixtureRoom(mkTmp('mos-heal-t1-'));
279
+ const env = await runHeal(roomDir, { dryRun: true });
280
+
281
+ assert.ok(env, 'dry-run returns envelope');
282
+ assert.ok(Array.isArray(env.steps), 'envelope.steps is array');
283
+ assert.equal(env.steps.length, 10, 'envelope.steps has 10 entries');
284
+ assert.equal(typeof env.schema_version, 'string', 'schema_version present');
285
+
286
+ // Critical: NO mutation. .mindrian/ may pre-exist from fixture builder
287
+ // (we wrote brain-derivation-queue.json there), but heal-log.json
288
+ // must NOT have been written, and .mindrian/room.db must NOT exist.
289
+ assert.equal(
290
+ fs.existsSync(path.join(roomDir, '.mindrian', 'heal-log.json')),
291
+ false,
292
+ 'dry-run does not write heal-log.json'
293
+ );
294
+ assert.equal(
295
+ fs.existsSync(path.join(roomDir, '.mindrian', 'room.db')),
296
+ false,
297
+ 'dry-run does not create room.db'
298
+ );
299
+
300
+ // No backup directory created in dry-run.
301
+ const backupRoot = path.join(roomDir, '.heal-backup');
302
+ assert.equal(
303
+ fs.existsSync(backupRoot),
304
+ false,
305
+ 'dry-run does not create .heal-backup'
306
+ );
307
+
308
+ // legal-ip section was missing pre-heal; dry-run must NOT create it.
309
+ assert.equal(
310
+ fs.existsSync(path.join(roomDir, 'legal-ip')),
311
+ false,
312
+ 'dry-run does not create missing canonical section'
313
+ );
314
+
315
+ pass('T1 dry-run on degraded fixture');
316
+ } catch (e) {
317
+ fail('T1 dry-run on degraded fixture', e);
318
+ }
319
+
320
+ // ---------- T2 full heal on degraded fixture ----------
321
+
322
+ try {
323
+ const roomDir = buildDegradedFixtureRoom(mkTmp('mos-heal-t2-'));
324
+ const env = await runHeal(roomDir, {});
325
+
326
+ assert.ok(env, 'full-heal returns envelope');
327
+ assert.ok(Array.isArray(env.steps), 'envelope.steps is array');
328
+ assert.equal(env.steps.length, 10, 'envelope.steps has 10 entries');
329
+
330
+ // Step 2 result: all 8 canonical sections present.
331
+ for (const s of CANONICAL_SECTIONS) {
332
+ assert.equal(
333
+ fs.existsSync(path.join(roomDir, s)),
334
+ true,
335
+ 'canonical section directory exists: ' + s
336
+ );
337
+ }
338
+
339
+ // Step 5 result: every present section has ROOM.md.
340
+ for (const s of CANONICAL_SECTIONS) {
341
+ const roomMdPath = path.join(roomDir, s, 'ROOM.md');
342
+ assert.equal(
343
+ fs.existsSync(roomMdPath),
344
+ true,
345
+ 'every canonical section has ROOM.md: ' + s
346
+ );
347
+ }
348
+
349
+ // Step 6 result: every present section has STATE.md.
350
+ let stateMdCount = 0;
351
+ for (const s of CANONICAL_SECTIONS) {
352
+ if (fs.existsSync(path.join(roomDir, s, 'STATE.md'))) {
353
+ stateMdCount++;
354
+ }
355
+ }
356
+ assert.ok(
357
+ stateMdCount >= CANONICAL_SECTIONS.length - 1,
358
+ 'most canonical sections have per-section STATE.md (got ' + stateMdCount + ')'
359
+ );
360
+
361
+ // Step 4 result: .mindrian/room.db nodes COUNT > 0.
362
+ const dbPath = path.join(roomDir, '.mindrian', 'room.db');
363
+ assert.equal(fs.existsSync(dbPath), true, 'room.db exists');
364
+ let nodeCount = 0;
365
+ try {
366
+ const { DatabaseSync } = require('node:sqlite');
367
+ const db = new DatabaseSync(dbPath);
368
+ const row = db.prepare('SELECT COUNT(*) AS c FROM nodes').get();
369
+ nodeCount = row && typeof row.c === 'number' ? row.c : 0;
370
+ db.close();
371
+ } catch (sqliteErr) {
372
+ // If node:sqlite is not available, fall back to file-existence
373
+ // assertion. In CI this still proves Step 4 fired.
374
+ nodeCount = fs.statSync(dbPath).size > 0 ? 1 : 0;
375
+ }
376
+ assert.ok(nodeCount > 0, 'room.db nodes COUNT > 0 (got ' + nodeCount + ')');
377
+
378
+ // Step 9 result: root STATE.md regenerated. The pre-heal placeholder
379
+ // was 'minimal placeholder content'; post-heal must differ.
380
+ const rootStatePost = fs.readFileSync(path.join(roomDir, 'STATE.md'), 'utf8');
381
+ assert.ok(
382
+ !rootStatePost.includes('minimal placeholder content'),
383
+ 'root STATE.md regenerated (no longer placeholder)'
384
+ );
385
+
386
+ // Step 1 result: backup directory populated.
387
+ const backupRoot = path.join(roomDir, '.heal-backup');
388
+ assert.equal(fs.existsSync(backupRoot), true, '.heal-backup directory exists');
389
+ const backupChildren = fs.readdirSync(backupRoot);
390
+ assert.ok(
391
+ backupChildren.length > 0,
392
+ '.heal-backup has at least one timestamped child'
393
+ );
394
+
395
+ // Step 8 result: queue read, NOT drained (read-only contract).
396
+ // Note: Step 7's MINTO regeneration legitimately enqueues NEW
397
+ // governing_thought_changed entries via the Phase 90-02 post-regen
398
+ // hook (this is the canonical enqueue path; heal does NOT drain).
399
+ // The drain hook is the v1.12 candidate item. So we assert: queue
400
+ // file exists post-heal AND at least one entry remains. We do NOT
401
+ // assert the original stale entry survives byte-for-byte because
402
+ // the Phase 90-02 writer is the canonical authority on the queue.
403
+ const queuePath = path.join(roomDir, '.mindrian', 'brain-derivation-queue.json');
404
+ assert.equal(fs.existsSync(queuePath), true, 'queue file preserved (not drained)');
405
+ const queueRaw = JSON.parse(fs.readFileSync(queuePath, 'utf8'));
406
+ const entries = Array.isArray(queueRaw.entries)
407
+ ? queueRaw.entries
408
+ : (Array.isArray(queueRaw.queue) ? queueRaw.queue : []);
409
+ assert.ok(
410
+ entries.length >= 1,
411
+ 'queue has entries (heal Step 8 read-only; drain deferred to v1.12)'
412
+ );
413
+
414
+ pass('T2 full heal on degraded fixture');
415
+ } catch (e) {
416
+ fail('T2 full heal on degraded fixture', e);
417
+ }
418
+
419
+ // ---------- T3 heal-log envelope shape ----------
420
+
421
+ try {
422
+ const roomDir = buildDegradedFixtureRoom(mkTmp('mos-heal-t3-'));
423
+ await runHeal(roomDir, {});
424
+
425
+ const logPath = path.join(roomDir, '.mindrian', 'heal-log.json');
426
+ assert.equal(fs.existsSync(logPath), true, 'heal-log.json written');
427
+
428
+ const raw = fs.readFileSync(logPath, 'utf8');
429
+ const log = JSON.parse(raw);
430
+
431
+ assert.equal(typeof log.schema_version, 'string', 'schema_version is string');
432
+ assert.equal(typeof log.started_at, 'string', 'started_at is ISO-8601 string');
433
+ assert.equal(typeof log.ended_at, 'string', 'ended_at is ISO-8601 string');
434
+ assert.equal(typeof log.room_dir, 'string', 'room_dir is string');
435
+ assert.equal(typeof log.backup_dir, 'string', 'backup_dir is string');
436
+ assert.ok(Array.isArray(log.steps), 'steps is array');
437
+ assert.equal(log.steps.length, 10, 'steps has 10 entries');
438
+
439
+ // Every step has the contract keys.
440
+ for (let i = 0; i < log.steps.length; i++) {
441
+ const s = log.steps[i];
442
+ assert.equal(typeof s.step, 'string', 'step[' + i + '].step is string');
443
+ assert.equal(typeof s.status, 'string', 'step[' + i + '].status is string');
444
+ assert.equal(typeof s.duration_ms, 'number', 'step[' + i + '].duration_ms is number');
445
+ assert.ok(s.details && typeof s.details === 'object', 'step[' + i + '].details is object');
446
+ }
447
+
448
+ // Step names match the recipe contract.
449
+ const expectedStepNames = [
450
+ 'step_01_backup',
451
+ 'step_02_scaffold_sections',
452
+ 'step_03_section_seed',
453
+ 'step_04_lazygraph_rebuild',
454
+ 'step_05_backfill_room_md',
455
+ 'step_06_section_state',
456
+ 'step_07_section_minto',
457
+ 'step_08_queue_check',
458
+ 'step_09_root_state',
459
+ 'step_10_invariant_scan',
460
+ ];
461
+ for (let i = 0; i < expectedStepNames.length; i++) {
462
+ assert.equal(
463
+ log.steps[i].step,
464
+ expectedStepNames[i],
465
+ 'step[' + i + '].step name matches recipe'
466
+ );
467
+ }
468
+
469
+ // Summary block.
470
+ assert.ok(log.summary && typeof log.summary === 'object', 'summary present');
471
+ assert.equal(typeof log.summary.ok_count, 'number', 'summary.ok_count is number');
472
+ assert.equal(typeof log.summary.exit_code, 'number', 'summary.exit_code is number');
473
+
474
+ pass('T3 heal-log envelope shape');
475
+ } catch (e) {
476
+ fail('T3 heal-log envelope shape', e);
477
+ }
478
+
479
+ // ---------- T4 backup created ----------
480
+
481
+ try {
482
+ const roomDir = buildDegradedFixtureRoom(mkTmp('mos-heal-t4-'));
483
+ const preHealStateMd = fs.readFileSync(path.join(roomDir, 'STATE.md'), 'utf8');
484
+
485
+ await runHeal(roomDir, {});
486
+
487
+ const backupRoot = path.join(roomDir, '.heal-backup');
488
+ const tsChildren = fs.readdirSync(backupRoot);
489
+ assert.ok(tsChildren.length >= 1, 'at least one timestamp child');
490
+
491
+ const ts = tsChildren[0];
492
+ // <TS> matches YYYYMMDD-HHMMSS pattern.
493
+ assert.match(ts, /^\d{8}-\d{6}$/, '<TS> matches YYYYMMDD-HHMMSS pattern');
494
+
495
+ // pre-heal STATE.md preserved verbatim (somewhere under the backup
496
+ // tree). The backup may live at .heal-backup/<TS>/STATE.md or
497
+ // .heal-backup/<TS>/<file basename>.
498
+ let preserved = false;
499
+ function walk(dir) {
500
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
501
+ const full = path.join(dir, entry.name);
502
+ if (entry.isDirectory()) {
503
+ walk(full);
504
+ } else if (entry.isFile() && entry.name === 'STATE.md') {
505
+ const body = fs.readFileSync(full, 'utf8');
506
+ if (body === preHealStateMd) {
507
+ preserved = true;
508
+ return;
509
+ }
510
+ }
511
+ }
512
+ }
513
+ walk(path.join(backupRoot, ts));
514
+ assert.equal(preserved, true, 'pre-heal STATE.md preserved verbatim in backup');
515
+
516
+ pass('T4 backup created (timestamp + verbatim STATE.md preserved)');
517
+ } catch (e) {
518
+ fail('T4 backup created (timestamp + verbatim STATE.md preserved)', e);
519
+ }
520
+
521
+ // ---------- T5 mega-section graceful degradation ----------
522
+
523
+ try {
524
+ const roomDir = buildMegaSectionFixtureRoom(mkTmp('mos-heal-t5-'));
525
+
526
+ let env;
527
+ let threw = false;
528
+ try {
529
+ env = await runHeal(roomDir, {});
530
+ } catch (e) {
531
+ threw = true;
532
+ }
533
+ assert.equal(threw, false, 'heal NEVER throws even on FEYNMINTO-01 budget');
534
+ assert.ok(env, 'envelope returned');
535
+
536
+ // Step 7 entry must exist with at least one section showing the
537
+ // 'blocked_feynminto_01' status, OR (if the writer chose to not
538
+ // attempt the mega-section because budget is pre-checked) details
539
+ // record the budget block in some form. The contract is: heal does
540
+ // not throw, log shows the block, other steps continue.
541
+ const step07 = env.steps.find(function (s) { return s.step === 'step_07_section_minto'; });
542
+ assert.ok(step07, 'step_07_section_minto entry present');
543
+
544
+ const stringified = JSON.stringify(step07);
545
+ assert.match(
546
+ stringified,
547
+ /blocked_feynminto_01|budget exceeded|FEYNMINTO-01/,
548
+ 'step_07 records budget block (blocked_feynminto_01 or budget exceeded)'
549
+ );
550
+
551
+ // Remaining steps still log their statuses (heal completed all 10).
552
+ assert.equal(env.steps.length, 10, 'all 10 steps logged');
553
+
554
+ // Heal completed successfully overall (exit 0 if any-step-success).
555
+ assert.equal(typeof env.summary.exit_code, 'number', 'summary.exit_code is number');
556
+ assert.ok(env.summary.exit_code === 0 || env.summary.exit_code === 2,
557
+ 'exit_code is 0 (any-step-success) or 2 (no-step-success)');
558
+
559
+ pass('T5 mega-section graceful degradation (FEYNMINTO-01)');
560
+ } catch (e) {
561
+ fail('T5 mega-section graceful degradation (FEYNMINTO-01)', e);
562
+ }
563
+
564
+ // ---------- T6 idempotence ----------
565
+
566
+ try {
567
+ const roomDir = buildDegradedFixtureRoom(mkTmp('mos-heal-t6-'));
568
+ await runHeal(roomDir, {});
569
+ const env2 = await runHeal(roomDir, {});
570
+
571
+ assert.ok(env2, 'second run returns envelope');
572
+ assert.equal(env2.steps.length, 10, 'second-run envelope has 10 entries');
573
+
574
+ // Second-run statuses: every step is 'ok' or 'skipped' or
575
+ // 'blocked_*' (acceptable). NO 'error_*' on a clean idempotent
576
+ // re-run because every degradation was already healed.
577
+ let errorStepCount = 0;
578
+ for (const s of env2.steps) {
579
+ if (typeof s.status === 'string' && s.status.startsWith('error_')) {
580
+ errorStepCount++;
581
+ }
582
+ }
583
+ assert.equal(
584
+ errorStepCount, 0,
585
+ 'second-run has zero error_* statuses (idempotent)'
586
+ );
587
+
588
+ pass('T6 idempotence (heal twice; second run no errors)');
589
+ } catch (e) {
590
+ fail('T6 idempotence (heal twice; second run no errors)', e);
591
+ }
592
+
593
+ cleanupTmp();
594
+
595
+ const passed = 6 - failures;
596
+ console.log('heal-command: ' + passed + '/6 passed (' + failures + ' failed)');
597
+ if (failures > 0) process.exit(1);
598
+ }
599
+
600
+ runTests().catch(function (e) {
601
+ console.error('runTests crashed: ' + (e && e.message));
602
+ console.error(e && e.stack ? e.stack : '');
603
+ process.exit(1);
604
+ });