@geraldmaron/construct 1.1.1 → 1.2.0

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 (408) hide show
  1. package/README.md +29 -19
  2. package/bin/construct +311 -81
  3. package/bin/construct-postinstall.mjs +30 -2
  4. package/examples/distribution/README.md +42 -0
  5. package/examples/distribution/manifest.json +53 -0
  6. package/examples/distribution/sources/adr.md +84 -0
  7. package/examples/distribution/sources/deck-one-pager.md +65 -0
  8. package/examples/distribution/sources/prd-platform.md +161 -0
  9. package/examples/distribution/sources/research-brief.md +80 -0
  10. package/examples/distribution/sources/rfc-platform.md +82 -0
  11. package/examples/distribution/sources/runbook.md +103 -0
  12. package/examples/distribution/sources/strategy.md +88 -0
  13. package/lib/adapters-sync.mjs +67 -0
  14. package/lib/artifact-gate-notice.mjs +38 -0
  15. package/lib/artifact-manifest.mjs +112 -0
  16. package/lib/artifact-release-gate.mjs +171 -0
  17. package/lib/artifact-reviewers.mjs +68 -0
  18. package/lib/artifact-type-from-path.mjs +79 -0
  19. package/lib/audit-skills.mjs +4 -0
  20. package/lib/audit-specialists.mjs +285 -0
  21. package/lib/audit-trail.mjs +1 -1
  22. package/lib/auto-docs.mjs +87 -18
  23. package/lib/beads/drift.mjs +27 -6
  24. package/lib/beads-client.mjs +49 -121
  25. package/lib/beads-optimistic.mjs +5 -12
  26. package/lib/brand-fonts.mjs +93 -0
  27. package/lib/brand-prose.mjs +214 -0
  28. package/lib/brand-tokens.mjs +92 -0
  29. package/lib/bridges/copilot-proxy.mjs +13 -26
  30. package/lib/capability-ledger.mjs +156 -0
  31. package/lib/certification/artifact-fixtures.mjs +132 -0
  32. package/lib/certification/artifact-gates.mjs +63 -0
  33. package/lib/certification/artifact-provenance.mjs +97 -0
  34. package/lib/certification/canonical-scenarios.mjs +78 -0
  35. package/lib/certification/cli.mjs +191 -0
  36. package/lib/certification/dashboard-api.mjs +71 -0
  37. package/lib/certification/demo-parity.mjs +116 -0
  38. package/lib/certification/document-io-fixtures.mjs +246 -0
  39. package/lib/certification/document-workflow.mjs +97 -0
  40. package/lib/certification/eval-bridge.mjs +77 -0
  41. package/lib/certification/model-routing.mjs +149 -0
  42. package/lib/certification/prompt-budget.mjs +119 -0
  43. package/lib/certification/rc-gate.mjs +206 -0
  44. package/lib/certification/real-llm-scenarios.mjs +303 -0
  45. package/lib/certification/role-cards.mjs +113 -0
  46. package/lib/certification/role-overlays.mjs +117 -0
  47. package/lib/certification/run.mjs +122 -0
  48. package/lib/certification/runner.mjs +323 -0
  49. package/lib/certification/scenarios.mjs +51 -0
  50. package/lib/certification/skill-inventory.mjs +289 -0
  51. package/lib/certification/skill-scenarios.mjs +147 -0
  52. package/lib/certification/specialist-contracts.mjs +85 -0
  53. package/lib/certification/specialist-scenarios.mjs +175 -0
  54. package/lib/certification/stale-impact.mjs +146 -0
  55. package/lib/certification/status.mjs +252 -0
  56. package/lib/certification/store.mjs +77 -0
  57. package/lib/chat/cli.mjs +333 -0
  58. package/lib/chat/command-suggest.mjs +161 -0
  59. package/lib/chat/commands.mjs +215 -0
  60. package/lib/chat/config.mjs +142 -0
  61. package/lib/chat/context-compactor.mjs +250 -0
  62. package/lib/chat/context-continuation.mjs +253 -0
  63. package/lib/chat/continuation-source.mjs +58 -0
  64. package/lib/chat/demo-guide.mjs +61 -0
  65. package/lib/chat/design-tokens.mjs +91 -0
  66. package/lib/chat/desktop-binary.mjs +79 -0
  67. package/lib/chat/desktop-build.mjs +130 -0
  68. package/lib/chat/desktop-launcher.mjs +133 -0
  69. package/lib/chat/evidence.mjs +145 -0
  70. package/lib/chat/export.mjs +74 -0
  71. package/lib/chat/harness/driver.mjs +91 -0
  72. package/lib/chat/list-picker.mjs +112 -0
  73. package/lib/chat/model-picker.mjs +356 -0
  74. package/lib/chat/openrouter-fallback.mjs +151 -0
  75. package/lib/chat/permission-prompt.mjs +33 -0
  76. package/lib/chat/picker-catalog.mjs +45 -0
  77. package/lib/chat/policy-telemetry.mjs +34 -0
  78. package/lib/chat/present.mjs +245 -0
  79. package/lib/chat/session-context.mjs +39 -0
  80. package/lib/chat/session-persist.mjs +73 -0
  81. package/lib/chat/session-restore.mjs +71 -0
  82. package/lib/chat/session-settings.mjs +53 -0
  83. package/lib/chat/system-prompt.mjs +52 -0
  84. package/lib/chat/transparency.mjs +93 -0
  85. package/lib/chat/tui/color-scheme.mjs +42 -0
  86. package/lib/chat/tui/markdown.mjs +123 -0
  87. package/lib/chat/tui/presentation.mjs +100 -0
  88. package/lib/chat/tui/render.mjs +500 -0
  89. package/lib/chat/tui/turn-block.mjs +284 -0
  90. package/lib/chat/tui/turn-present.mjs +18 -0
  91. package/lib/chat/tui/turn-state.mjs +88 -0
  92. package/lib/chat/tui/usage.mjs +122 -0
  93. package/lib/chat/web-commands.mjs +146 -0
  94. package/lib/chat/web-launcher.mjs +63 -0
  95. package/lib/chat/web-picker-keys.mjs +46 -0
  96. package/lib/chat/web-session.mjs +159 -0
  97. package/lib/cli-commands.mjs +129 -15
  98. package/lib/comment-lint.mjs +6 -4
  99. package/lib/config/schema.mjs +36 -5
  100. package/lib/contract-schemas/decision.json +50 -0
  101. package/lib/contract-schemas/implementation.json +51 -0
  102. package/lib/contract-schemas/review-report.json +32 -0
  103. package/lib/contract-schemas/test-report.json +43 -0
  104. package/lib/contracts/construct-handoff.mjs +60 -0
  105. package/lib/contracts/validate.mjs +32 -3
  106. package/lib/contracts/violation-log.mjs +58 -5
  107. package/lib/dashboard-demo.mjs +71 -0
  108. package/lib/dashboard-static.mjs +19 -5
  109. package/lib/decisions/registry.mjs +5 -3
  110. package/lib/deck-export-pptx.mjs +1152 -0
  111. package/lib/demo-recording.mjs +142 -0
  112. package/lib/demo-script.mjs +114 -0
  113. package/lib/demo-surface.mjs +249 -0
  114. package/lib/demo.mjs +598 -140
  115. package/lib/diagram-export.mjs +192 -0
  116. package/lib/diagram.mjs +13 -11
  117. package/lib/docs-verify.mjs +25 -7
  118. package/lib/doctor/index.mjs +3 -1
  119. package/lib/doctor/project-adapters.mjs +44 -0
  120. package/lib/doctor/watchers/cx-budget.mjs +98 -0
  121. package/lib/doctor/watchers/graph-staleness.mjs +52 -0
  122. package/lib/doctor/watchers/process-pressure.mjs +4 -3
  123. package/lib/document-export.mjs +360 -36
  124. package/lib/document-extract.mjs +44 -4
  125. package/lib/document-ingest.mjs +29 -20
  126. package/lib/embed/cli.mjs +2 -2
  127. package/lib/embed/daemon.mjs +18 -46
  128. package/lib/embed/worker.mjs +2 -2
  129. package/lib/embedded-contract/model-resolve.mjs +10 -9
  130. package/lib/env-config.mjs +26 -0
  131. package/lib/evals/dataset.mjs +137 -0
  132. package/lib/evals/gates.mjs +175 -0
  133. package/lib/graph/build-co-change.mjs +54 -0
  134. package/lib/graph/build-from-registry.mjs +136 -0
  135. package/lib/graph/build-import-graph.mjs +153 -0
  136. package/lib/graph/cli.mjs +110 -0
  137. package/lib/graph/impact-cli.mjs +89 -0
  138. package/lib/graph/impact.mjs +108 -0
  139. package/lib/graph/staleness.mjs +44 -0
  140. package/lib/graph/store.mjs +172 -0
  141. package/lib/health-check.mjs +90 -76
  142. package/lib/hooks/artifact-release-gate.mjs +43 -0
  143. package/lib/hooks/brand-prose-lint.mjs +38 -0
  144. package/lib/hooks/graph-impact-advisory.mjs +62 -0
  145. package/lib/hooks/session-optimize.mjs +84 -207
  146. package/lib/hooks/session-start.mjs +4 -5
  147. package/lib/host-disposition.mjs +7 -0
  148. package/lib/improvement/cli.mjs +189 -0
  149. package/lib/improvement/controller.mjs +137 -0
  150. package/lib/improvement/proposal.mjs +120 -0
  151. package/lib/improvement/specialist-loop.mjs +192 -0
  152. package/lib/improvement/store.mjs +89 -0
  153. package/lib/improvement/surface.mjs +219 -0
  154. package/lib/ingest-tooling.mjs +97 -0
  155. package/lib/init/doc-lanes.mjs +165 -0
  156. package/lib/init-docs.mjs +31 -178
  157. package/lib/init-unified.mjs +27 -97
  158. package/lib/init-update-guide.mjs +102 -0
  159. package/lib/init-update.mjs +32 -1
  160. package/lib/init.mjs +8 -0
  161. package/lib/install/desktop-binary-download.mjs +85 -0
  162. package/lib/install/legacy-global-cleanup.mjs +189 -0
  163. package/lib/intake/daemon.mjs +2 -0
  164. package/lib/intake/git-queue.mjs +9 -8
  165. package/lib/intake/queue.mjs +2 -1
  166. package/lib/intake/session-prelude.mjs +90 -1
  167. package/lib/libreoffice-export.mjs +97 -0
  168. package/lib/logging/rotate.mjs +9 -0
  169. package/lib/maintenance/docker-reclaim.mjs +206 -0
  170. package/lib/mcp/external-schema-cost.mjs +74 -0
  171. package/lib/mcp/server.mjs +84 -9
  172. package/lib/mcp/stdio-mcp-probe.mjs +188 -0
  173. package/lib/mcp/tool-budget.mjs +55 -4
  174. package/lib/mcp/tools/document.mjs +18 -4
  175. package/lib/mcp/tools/skills.mjs +32 -3
  176. package/lib/mcp/tools/workflow.mjs +13 -1
  177. package/lib/model-free-selector.mjs +18 -0
  178. package/lib/model-registry.mjs +13 -229
  179. package/lib/model-router.mjs +373 -92
  180. package/lib/models/behavior-matrix.mjs +289 -0
  181. package/lib/models/catalog.mjs +209 -0
  182. package/lib/models/execution-capability-profile.mjs +196 -0
  183. package/lib/models/execution-policy.mjs +307 -0
  184. package/lib/models/provider-poll.mjs +383 -0
  185. package/lib/npm-spawn-env.mjs +17 -0
  186. package/lib/ollama/installed-models.mjs +129 -0
  187. package/lib/oracle/actions.mjs +187 -0
  188. package/lib/oracle/artifact-gate.mjs +99 -0
  189. package/lib/oracle/cli.mjs +204 -0
  190. package/lib/oracle/daemon-entry.mjs +14 -0
  191. package/lib/oracle/dispatch.mjs +81 -0
  192. package/lib/oracle/execute.mjs +143 -0
  193. package/lib/oracle/gaps.mjs +76 -0
  194. package/lib/oracle/index.mjs +84 -0
  195. package/lib/oracle/issues.mjs +164 -0
  196. package/lib/oracle/org-graph.mjs +170 -0
  197. package/lib/oracle/policy.mjs +80 -0
  198. package/lib/oracle/read-model.mjs +398 -0
  199. package/lib/oracle/reconcile.mjs +191 -0
  200. package/lib/oracle/routing.mjs +89 -0
  201. package/lib/oracle/synthesize.mjs +384 -0
  202. package/lib/oracle/verdicts.mjs +51 -0
  203. package/lib/orchestration/worker.mjs +88 -27
  204. package/lib/orchestration-policy.mjs +50 -0
  205. package/lib/parity.mjs +96 -2
  206. package/lib/playwright-demo.mjs +252 -0
  207. package/lib/project-init-shared.mjs +4 -1
  208. package/lib/prompt-composer.js +7 -3
  209. package/lib/prompt-validation-contract.mjs +24 -0
  210. package/lib/provider-capabilities.js +57 -11
  211. package/lib/providers/contract/adapters/confluence/index.mjs +181 -0
  212. package/lib/providers/contract/adapters/git/index.mjs +115 -0
  213. package/lib/providers/contract/adapters/github/index.mjs +166 -0
  214. package/lib/providers/contract/adapters/jira/index.mjs +187 -0
  215. package/lib/providers/contract/adapters/slack/index.mjs +175 -0
  216. package/lib/providers/contract/contract-tests.mjs +57 -0
  217. package/lib/providers/contract/errors.mjs +48 -0
  218. package/lib/providers/contract/interface.mjs +50 -0
  219. package/lib/providers/contract/registry.mjs +102 -0
  220. package/lib/providers/copilot-auth.mjs +297 -0
  221. package/lib/providers/credential-bootstrap.mjs +178 -0
  222. package/lib/providers/credential-catalog.mjs +46 -0
  223. package/lib/providers/credential-sources.mjs +63 -0
  224. package/lib/providers/creds.mjs +5 -2
  225. package/lib/providers/op-run.mjs +59 -0
  226. package/lib/providers/secret-resolver.mjs +159 -0
  227. package/lib/publish-template.mjs +163 -0
  228. package/lib/publish-tooling.mjs +119 -0
  229. package/lib/publish.mjs +305 -0
  230. package/lib/registry/cli.mjs +82 -0
  231. package/lib/registry/consolidation.mjs +147 -0
  232. package/lib/registry/generate-docs.mjs +75 -0
  233. package/lib/registry/skill-verification.mjs +57 -0
  234. package/lib/registry/surface-map.mjs +76 -0
  235. package/lib/registry/validate.mjs +135 -0
  236. package/lib/resources/budget.mjs +82 -0
  237. package/lib/resources/process-budget.mjs +45 -0
  238. package/lib/rules-delivery.mjs +9 -2
  239. package/lib/rules-read.mjs +26 -0
  240. package/lib/runtime-env.mjs +23 -0
  241. package/lib/runtime-pressure.mjs +51 -7
  242. package/lib/schema-infer.mjs +13 -2
  243. package/lib/server/chat-loop.mjs +622 -0
  244. package/lib/server/demo-preview.mjs +63 -0
  245. package/lib/server/index.mjs +228 -7
  246. package/lib/service-manager.mjs +60 -8
  247. package/lib/setup.mjs +70 -7
  248. package/lib/specialists/prompt-schema.mjs +19 -10
  249. package/lib/specialists/roster.mjs +43 -0
  250. package/lib/specialists/scaffold.mjs +56 -0
  251. package/lib/storage/backend.mjs +6 -6
  252. package/lib/storage/hybrid-query.mjs +7 -4
  253. package/lib/storage/state-source.mjs +5 -5
  254. package/lib/storage/sync.mjs +2 -3
  255. package/lib/telemetry/rule-calls.mjs +52 -0
  256. package/lib/template-registry.mjs +2 -2
  257. package/lib/templates/visual-requirements.mjs +27 -51
  258. package/lib/test-corpus-inventory.mjs +313 -0
  259. package/lib/uninstall/uninstall.mjs +19 -7
  260. package/lib/update.mjs +12 -0
  261. package/lib/upgrade.mjs +14 -0
  262. package/lib/wireframe.mjs +20 -14
  263. package/lib/worker/run.mjs +17 -4
  264. package/lib/worker/trace.mjs +11 -3
  265. package/package.json +28 -14
  266. package/personas/construct.md +2 -2
  267. package/platforms/claude/settings.template.json +36 -0
  268. package/rules/common/patterns.md +1 -1
  269. package/rules/common/release-gates.md +4 -3
  270. package/scripts/sync-specialists.mjs +41 -28
  271. package/skills/devops/data-engineering.md +1 -1
  272. package/skills/docs/adr-workflow.md +1 -0
  273. package/skills/docs/backlog-proposal-workflow.md +1 -0
  274. package/skills/docs/codebase-research-workflow.md +40 -0
  275. package/skills/docs/customer-profile-workflow.md +1 -0
  276. package/skills/docs/document-ingest-workflow.md +1 -0
  277. package/skills/docs/evidence-ingest-workflow.md +1 -0
  278. package/skills/docs/init-docs.md +2 -2
  279. package/skills/docs/init-project.md +7 -2
  280. package/skills/docs/prd-workflow.md +24 -1
  281. package/skills/docs/prfaq-workflow.md +1 -0
  282. package/skills/docs/product-intelligence-workflow.md +1 -0
  283. package/skills/docs/product-signal-workflow.md +1 -0
  284. package/skills/docs/research-workflow.md +54 -37
  285. package/skills/docs/runbook-workflow.md +1 -0
  286. package/skills/docs/strategy-workflow.md +1 -0
  287. package/skills/docs/user-research-workflow.md +40 -0
  288. package/skills/operating/orchestration-reference.md +1 -1
  289. package/skills/roles/architect.md +5 -0
  290. package/skills/roles/operator.docs.md +4 -0
  291. package/skills/routing.md +4 -2
  292. package/specialists/artifact-manifest.json +480 -0
  293. package/specialists/artifact-manifest.schema.json +53 -0
  294. package/specialists/audit-enrichments.json +454 -0
  295. package/specialists/contracts.json +37 -25
  296. package/specialists/prompts/_shared/validation-contract.md +26 -0
  297. package/specialists/prompts/cx-accessibility.md +21 -2
  298. package/specialists/prompts/cx-ai-engineer.md +24 -1
  299. package/specialists/prompts/cx-architect.md +4 -1
  300. package/specialists/prompts/cx-business-strategist.md +23 -2
  301. package/specialists/prompts/cx-data-analyst.md +22 -1
  302. package/specialists/prompts/cx-data-engineer.md +23 -2
  303. package/specialists/prompts/cx-debugger.md +21 -2
  304. package/specialists/prompts/cx-designer.md +26 -3
  305. package/specialists/prompts/cx-devil-advocate.md +19 -2
  306. package/specialists/prompts/cx-docs-keeper.md +28 -1
  307. package/specialists/prompts/cx-engineer.md +22 -1
  308. package/specialists/prompts/cx-evaluator.md +18 -1
  309. package/specialists/prompts/cx-explorer.md +21 -2
  310. package/specialists/prompts/cx-legal-compliance.md +21 -2
  311. package/specialists/prompts/cx-operations.md +21 -2
  312. package/specialists/prompts/cx-oracle.md +94 -0
  313. package/specialists/prompts/cx-orchestrator.md +20 -1
  314. package/specialists/prompts/cx-platform-engineer.md +25 -2
  315. package/specialists/prompts/cx-product-manager.md +32 -1
  316. package/specialists/prompts/cx-qa.md +24 -2
  317. package/specialists/prompts/cx-rd-lead.md +23 -2
  318. package/specialists/prompts/cx-release-manager.md +23 -2
  319. package/specialists/prompts/cx-researcher.md +22 -2
  320. package/specialists/prompts/cx-reviewer.md +18 -1
  321. package/specialists/prompts/cx-security.md +22 -2
  322. package/specialists/prompts/cx-sre.md +30 -3
  323. package/specialists/prompts/cx-test-automation.md +7 -1
  324. package/specialists/prompts/cx-trace-reviewer.md +22 -3
  325. package/specialists/prompts/cx-ux-researcher.md +21 -2
  326. package/specialists/registry.json +52 -173
  327. package/specialists/tone-profiles.json +42 -0
  328. package/templates/demos/playwright/demo-recording.config.mjs +47 -0
  329. package/templates/demos/recordings/agentic-platforms-prd.json +19 -0
  330. package/templates/demos/scripts/agentic-platforms-prd.json +44 -0
  331. package/templates/demos/specs/_helpers/scroll-artifact.ts +89 -0
  332. package/templates/demos/tapes/agentic-platforms-prd.tape +49 -0
  333. package/templates/demos/tapes/resource-guard-rails.tape +49 -0
  334. package/templates/demos/vhs/construct-cockpit.json +24 -0
  335. package/templates/distribution/construct-brand.typ +446 -0
  336. package/templates/distribution/construct-decision.typ +38 -0
  337. package/templates/distribution/construct-deck.html +95 -0
  338. package/templates/distribution/construct-pdf.typ +38 -0
  339. package/templates/distribution/construct-prd.typ +38 -0
  340. package/templates/distribution/construct-research.typ +38 -0
  341. package/templates/distribution/construct-web.html +92 -0
  342. package/templates/distribution/fonts/Geist-Bold.ttf +0 -0
  343. package/templates/distribution/fonts/Geist-Medium.ttf +0 -0
  344. package/templates/distribution/fonts/Geist-Regular.ttf +0 -0
  345. package/templates/distribution/fonts/Geist-SemiBold.ttf +0 -0
  346. package/templates/distribution/fonts/GeistMono-Medium.ttf +0 -0
  347. package/templates/distribution/fonts/GeistMono-Regular.ttf +0 -0
  348. package/templates/distribution/fonts/GeistMono-SemiBold.ttf +0 -0
  349. package/templates/distribution/fonts/IBMPlexMono-Regular.otf +0 -0
  350. package/templates/distribution/fonts/JetBrainsMono-Medium.ttf +0 -0
  351. package/templates/distribution/fonts/JetBrainsMono-Regular.ttf +0 -0
  352. package/templates/distribution/fonts/JetBrainsMono-SemiBold.ttf +0 -0
  353. package/templates/distribution/fonts/PlusJakartaSans-Bold.ttf +0 -0
  354. package/templates/distribution/fonts/PlusJakartaSans-Medium.ttf +0 -0
  355. package/templates/distribution/fonts/PlusJakartaSans-Regular.ttf +0 -0
  356. package/templates/distribution/fonts/PlusJakartaSans-SemiBold.ttf +0 -0
  357. package/templates/distribution/fonts/README.md +36 -0
  358. package/templates/distribution/fonts/SpaceGrotesk-Variable.ttf +0 -0
  359. package/templates/distribution/fonts/handwritten/Caveat.ttf +0 -0
  360. package/templates/distribution/fonts/legacy/IBMPlexMono-Regular.otf +0 -0
  361. package/templates/distribution/fonts/legacy/Inter-Medium.otf +0 -0
  362. package/templates/distribution/fonts/legacy/Inter-Regular.otf +0 -0
  363. package/templates/distribution/fonts/legacy/Inter-SemiBold.otf +0 -0
  364. package/templates/distribution/fonts/legacy/InterDisplay-SemiBold.otf +0 -0
  365. package/templates/distribution/fonts/legacy/SourceSerif4-Regular.otf +0 -0
  366. package/templates/distribution/fonts/legacy/SourceSerif4-Semibold.otf +0 -0
  367. package/templates/distribution/icons/activity.svg +15 -0
  368. package/templates/distribution/icons/alert-triangle.svg +17 -0
  369. package/templates/distribution/icons/book-open.svg +16 -0
  370. package/templates/distribution/icons/bot.svg +20 -0
  371. package/templates/distribution/icons/brain.svg +22 -0
  372. package/templates/distribution/icons/circle-check.svg +16 -0
  373. package/templates/distribution/icons/clipboard-check.svg +17 -0
  374. package/templates/distribution/icons/cpu.svg +28 -0
  375. package/templates/distribution/icons/database.svg +17 -0
  376. package/templates/distribution/icons/eye.svg +16 -0
  377. package/templates/distribution/icons/file-text.svg +19 -0
  378. package/templates/distribution/icons/gauge.svg +16 -0
  379. package/templates/distribution/icons/git-branch.svg +17 -0
  380. package/templates/distribution/icons/key.svg +17 -0
  381. package/templates/distribution/icons/layers.svg +17 -0
  382. package/templates/distribution/icons/list-checks.svg +19 -0
  383. package/templates/distribution/icons/lock.svg +16 -0
  384. package/templates/distribution/icons/message-square.svg +15 -0
  385. package/templates/distribution/icons/network.svg +19 -0
  386. package/templates/distribution/icons/route.svg +17 -0
  387. package/templates/distribution/icons/scale.svg +19 -0
  388. package/templates/distribution/icons/search.svg +16 -0
  389. package/templates/distribution/icons/send.svg +16 -0
  390. package/templates/distribution/icons/server.svg +18 -0
  391. package/templates/distribution/icons/shield-check.svg +16 -0
  392. package/templates/distribution/icons/users.svg +18 -0
  393. package/templates/distribution/icons/webhook.svg +17 -0
  394. package/templates/distribution/icons/workflow.svg +17 -0
  395. package/templates/distribution/icons/wrench.svg +15 -0
  396. package/templates/distribution/run.mjs +18 -1
  397. package/templates/docs/adr.md +7 -0
  398. package/templates/docs/construct_guide.md +8 -8
  399. package/templates/docs/customer-profile.md +4 -0
  400. package/templates/docs/one-pager.md +4 -0
  401. package/templates/docs/postmortem.md +31 -0
  402. package/templates/docs/prd-platform.md +19 -0
  403. package/templates/docs/prd.md +15 -0
  404. package/templates/docs/prfaq.md +7 -0
  405. package/templates/docs/qa-strategy.md +103 -0
  406. package/templates/docs/research-brief.md +8 -0
  407. package/templates/docs/rfc-platform.md +12 -0
  408. package/templates/docs/test-plan.md +7 -0
@@ -0,0 +1,85 @@
1
+ /**
2
+ * lib/install/desktop-binary-download.mjs — downloads the Construct chat desktop binary.
3
+ *
4
+ * Fetches the platform-matching construct-chat binary from the latest GitHub
5
+ * release and writes it to ~/.construct/bin/. Called by `construct install --scope=user`.
6
+ * Network failures are non-fatal: returns { status: 'skipped', reason } so the
7
+ * rest of setup can proceed without the desktop binary.
8
+ */
9
+
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+
13
+ const GITHUB_REPO = 'geraldmaron/construct';
14
+
15
+ function assetName() {
16
+ const plat = process.platform;
17
+ const arch = process.arch === 'arm64' ? 'arm64' : 'x64';
18
+ if (plat === 'win32') return 'construct-chat-windows-x64.exe';
19
+ if (plat === 'darwin') return `construct-chat-darwin-${arch}`;
20
+ return `construct-chat-linux-${arch}`;
21
+ }
22
+
23
+ function destBinaryName() {
24
+ return process.platform === 'win32' ? 'construct-chat.exe' : 'construct-chat';
25
+ }
26
+
27
+ async function fetchRelease(env) {
28
+ const headers = { 'User-Agent': 'construct-installer/1.0' };
29
+ if (env.GITHUB_TOKEN) headers['Authorization'] = `Bearer ${env.GITHUB_TOKEN}`;
30
+ const res = await fetch(`https://api.github.com/repos/${GITHUB_REPO}/releases/latest`, { headers });
31
+ if (!res.ok) throw new Error(`GitHub API ${res.status}: ${await res.text().then((t) => t.slice(0, 120))}`);
32
+ return res.json();
33
+ }
34
+
35
+ async function downloadAsset(url, dest, env) {
36
+ const headers = {
37
+ 'User-Agent': 'construct-installer/1.0',
38
+ 'Accept': 'application/octet-stream',
39
+ };
40
+ if (env.GITHUB_TOKEN) headers['Authorization'] = `Bearer ${env.GITHUB_TOKEN}`;
41
+ const res = await fetch(url, { headers, redirect: 'follow' });
42
+ if (!res.ok) throw new Error(`Download ${res.status}: ${url}`);
43
+ const buf = await res.arrayBuffer();
44
+ fs.writeFileSync(dest, Buffer.from(buf));
45
+ }
46
+
47
+ // Returns { status: 'downloaded'|'skipped'|'failed' }; 'skipped' and 'failed' are both non-fatal.
48
+ export async function downloadDesktopBinary({ homeDir, env = process.env } = {}) {
49
+ const binDir = path.join(homeDir, '.construct', 'bin');
50
+ const dest = path.join(binDir, destBinaryName());
51
+ const name = assetName();
52
+
53
+ let release;
54
+ try {
55
+ release = await fetchRelease(env);
56
+ } catch (err) {
57
+ return { status: 'skipped', reason: `GitHub API unreachable: ${err.message}` };
58
+ }
59
+
60
+ const asset = release.assets?.find((a) => a.name === name);
61
+ if (!asset) {
62
+ return {
63
+ status: 'skipped',
64
+ reason: `No desktop binary in ${release.tag_name} for this platform (looked for ${name})`,
65
+ };
66
+ }
67
+
68
+ fs.mkdirSync(binDir, { recursive: true });
69
+
70
+ try {
71
+ await downloadAsset(asset.browser_download_url, dest, env);
72
+ } catch (err) {
73
+ return { status: 'failed', reason: err.message };
74
+ }
75
+
76
+ if (process.platform !== 'win32') {
77
+ try {
78
+ fs.chmodSync(dest, 0o755);
79
+ } catch {
80
+ /* best effort */
81
+ }
82
+ }
83
+
84
+ return { status: 'downloaded', dest, version: release.tag_name };
85
+ }
@@ -0,0 +1,189 @@
1
+ /**
2
+ * Removes pre-project-scope Construct footprints from user-global tool config.
3
+ *
4
+ * Opt-in only: strips legacy ambient adapters/MCP/state that can slow unrelated
5
+ * Claude/Codex/OpenCode sessions, but never uninstalls a current global
6
+ * `construct` CLI package.
7
+ */
8
+
9
+ import fs from 'node:fs';
10
+ import path from 'node:path';
11
+
12
+ import { removeTomlTables, tomlString } from '../codex-config.mjs';
13
+
14
+ const CONSTRUCT_MCP_KEYS = ['memory', 'cass', 'construct-mcp'];
15
+
16
+ function exists(p) {
17
+ try { fs.statSync(p); return true; } catch { return false; }
18
+ }
19
+
20
+ function rm(p, { dryRun, removed, label }) {
21
+ if (!exists(p)) return false;
22
+ removed.push(label || p);
23
+ if (!dryRun) fs.rmSync(p, { recursive: true, force: true });
24
+ return true;
25
+ }
26
+
27
+ function readJson(filePath) {
28
+ if (!exists(filePath)) return null;
29
+ try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return null; }
30
+ }
31
+
32
+ function writeJson(filePath, value, { dryRun, removed, label }) {
33
+ removed.push(label || filePath);
34
+ if (!dryRun) fs.writeFileSync(filePath, JSON.stringify(value, null, 2) + '\n', 'utf8');
35
+ }
36
+
37
+ function hasConstructText(value) {
38
+ return /construct|\.cx|\.construct/i.test(JSON.stringify(value ?? ''));
39
+ }
40
+
41
+ function stripClaudeSettings(homeDir, opts) {
42
+ const filePath = path.join(homeDir, '.claude', 'settings.json');
43
+ const settings = readJson(filePath);
44
+ if (!settings || typeof settings !== 'object') return;
45
+ let changed = false;
46
+
47
+ if (settings.hooks && hasConstructText(settings.hooks)) {
48
+ delete settings.hooks;
49
+ changed = true;
50
+ }
51
+
52
+ if (settings.mcpServers && typeof settings.mcpServers === 'object') {
53
+ for (const key of CONSTRUCT_MCP_KEYS) {
54
+ if (key in settings.mcpServers) {
55
+ delete settings.mcpServers[key];
56
+ changed = true;
57
+ }
58
+ }
59
+ if (Object.keys(settings.mcpServers).length === 0) delete settings.mcpServers;
60
+ }
61
+
62
+ if (changed) writeJson(filePath, settings, { ...opts, label: '~/.claude/settings.json Construct entries' });
63
+ }
64
+
65
+ function stripOpenCode(homeDir, opts) {
66
+ const filePath = path.join(homeDir, '.config', 'opencode', 'opencode.json');
67
+ const config = readJson(filePath);
68
+ if (!config || typeof config !== 'object') return;
69
+ let changed = false;
70
+
71
+ if (config.agent?.construct) {
72
+ delete config.agent.construct;
73
+ changed = true;
74
+ if (Object.keys(config.agent).length === 0) delete config.agent;
75
+ }
76
+
77
+ if (config.mcp && typeof config.mcp === 'object') {
78
+ for (const key of CONSTRUCT_MCP_KEYS) {
79
+ if (key in config.mcp) {
80
+ delete config.mcp[key];
81
+ changed = true;
82
+ }
83
+ }
84
+ if (Object.keys(config.mcp).length === 0) delete config.mcp;
85
+ }
86
+
87
+ if (Array.isArray(config.plugin)) {
88
+ const next = config.plugin.filter((entry) => !/construct/i.test(String(entry)));
89
+ if (next.length !== config.plugin.length) {
90
+ config.plugin = next;
91
+ changed = true;
92
+ }
93
+ if (config.plugin.length === 0) delete config.plugin;
94
+ }
95
+
96
+ if (changed) writeJson(filePath, config, { ...opts, label: '~/.config/opencode/opencode.json Construct entries' });
97
+ }
98
+
99
+ function stripVsCode(homeDir, opts) {
100
+ const userDir = path.join(homeDir, 'Library', 'Application Support', 'Code', 'User');
101
+ const mcpPath = path.join(userDir, 'mcp.json');
102
+ const mcp = readJson(mcpPath);
103
+ if (mcp?.servers && typeof mcp.servers === 'object') {
104
+ let changed = false;
105
+ for (const key of CONSTRUCT_MCP_KEYS) {
106
+ if (key in mcp.servers) {
107
+ delete mcp.servers[key];
108
+ changed = true;
109
+ }
110
+ }
111
+ if (changed) writeJson(mcpPath, mcp, { ...opts, label: 'VS Code mcp.json Construct servers' });
112
+ }
113
+
114
+ const settingsPath = path.join(userDir, 'settings.json');
115
+ const settings = readJson(settingsPath);
116
+ const copilotServers = settings?.['github.copilot.mcpServers'];
117
+ if (copilotServers && typeof copilotServers === 'object') {
118
+ let changed = false;
119
+ for (const key of CONSTRUCT_MCP_KEYS) {
120
+ if (key in copilotServers) {
121
+ delete copilotServers[key];
122
+ changed = true;
123
+ }
124
+ }
125
+ if (Object.keys(copilotServers).length === 0) delete settings['github.copilot.mcpServers'];
126
+ if (changed) writeJson(settingsPath, settings, { ...opts, label: 'VS Code settings.json Construct Copilot MCP servers' });
127
+ }
128
+ }
129
+
130
+ function stripCodex(homeDir, opts) {
131
+ const filePath = path.join(homeDir, '.codex', 'config.toml');
132
+ if (!exists(filePath)) return;
133
+ const existing = fs.readFileSync(filePath, 'utf8');
134
+ let next = existing
135
+ .replace(/\n?# BEGIN CONSTRUCT MCP SERVERS[\s\S]*?(?=\n# END CONSTRUCT MCP SERVERS\n)/g, '\n')
136
+ .replace(/\n# END CONSTRUCT MCP SERVERS\n?/g, '\n')
137
+ .replace(/\n?# BEGIN CONSTRUCT AGENTS[\s\S]*?(?=\n# END CONSTRUCT AGENTS\n)/g, '\n')
138
+ .replace(/\n# END CONSTRUCT AGENTS\n?/g, '\n');
139
+ const tables = [
140
+ ...CONSTRUCT_MCP_KEYS.flatMap((key) => [`mcp_servers.${key}`, `mcp_servers.${tomlString(key)}`]),
141
+ 'agents.construct',
142
+ `agents.${tomlString('construct')}`,
143
+ ];
144
+ next = removeTomlTables(next, tables);
145
+ if (next.trimEnd() === existing.trimEnd()) return;
146
+ opts.removed.push('~/.codex/config.toml Construct tables');
147
+ if (!opts.dryRun) fs.writeFileSync(filePath, `${next.trimEnd()}\n`, 'utf8');
148
+ }
149
+
150
+ function rmConstructNamedChildren(dir, opts, labelPrefix) {
151
+ if (!exists(dir)) return;
152
+ for (const entry of fs.readdirSync(dir)) {
153
+ if (/construct/i.test(entry)) rm(path.join(dir, entry), { ...opts, label: `${labelPrefix}/${entry}` });
154
+ }
155
+ }
156
+
157
+ export function cleanupLegacyGlobalConstruct({ homeDir, dryRun = false } = {}) {
158
+ const removed = [];
159
+ const opts = { dryRun, removed };
160
+
161
+ rm(path.join(homeDir, '.construct'), { ...opts, label: '~/.construct' });
162
+ rm(path.join(homeDir, '.local', 'share', 'construct'), { ...opts, label: '~/.local/share/construct' });
163
+ rm(path.join(homeDir, 'Library', 'LaunchAgents', 'dev.construct.pressure-release.plist'), {
164
+ ...opts,
165
+ label: 'Construct pressure-release LaunchAgent',
166
+ });
167
+
168
+ rm(path.join(homeDir, '.github', 'prompts', 'construct.prompt.md'), { ...opts, label: '~/.github/prompts/construct.prompt.md' });
169
+ rm(path.join(homeDir, '.github', 'prompts', '.construct-manifest'), { ...opts, label: '~/.github/prompts/.construct-manifest' });
170
+ rm(path.join(homeDir, '.config', 'opencode', 'plugin', 'construct-fallback.js'), {
171
+ ...opts,
172
+ label: '~/.config/opencode/plugin/construct-fallback.js',
173
+ });
174
+
175
+ stripClaudeSettings(homeDir, opts);
176
+ stripOpenCode(homeDir, opts);
177
+ stripVsCode(homeDir, opts);
178
+ stripCodex(homeDir, opts);
179
+
180
+ rmConstructNamedChildren(path.join(homeDir, '.claude', 'projects'), opts, '~/.claude/projects');
181
+ rmConstructNamedChildren(path.join(homeDir, '.claude', 'plans'), opts, '~/.claude/plans');
182
+ rmConstructNamedChildren(path.join(homeDir, '.cursor', 'projects'), opts, '~/.cursor/projects');
183
+ rmConstructNamedChildren(path.join(homeDir, '.cursor', 'plans'), opts, '~/.cursor/plans');
184
+ rm(path.join(homeDir, '.gemini', 'history', 'construct'), { ...opts, label: '~/.gemini/history/construct' });
185
+ rm(path.join(homeDir, '.gemini', 'tmp', 'construct'), { ...opts, label: '~/.gemini/tmp/construct' });
186
+ rmConstructNamedChildren(path.join(homeDir, 'Library', 'Caches', 'claude-cli-nodejs'), opts, 'Claude cache');
187
+
188
+ return { removed, dryRun };
189
+ }
@@ -15,6 +15,7 @@ import { join, basename } from 'node:path';
15
15
  import { homedir } from 'node:os';
16
16
 
17
17
  import { createDaemon, classifyPacket } from '../daemons/contract.mjs';
18
+ import { memoryCapMbFor } from '../resources/process-budget.mjs';
18
19
 
19
20
  const KILLSWITCH_ENV = 'CONSTRUCT_INTAKE_DAEMON';
20
21
 
@@ -107,6 +108,7 @@ export function buildIntakeDaemon({ cwd = process.cwd(), intervalMs = 60_000, cl
107
108
  heartbeatPath: heartbeatPath(),
108
109
  maxRuntimeMs: 24 * 60 * 60 * 1000,
109
110
  maxIdleTicks: 6,
111
+ memoryCapMb: memoryCapMbFor('intake', cwd),
110
112
  async tick() {
111
113
  const files = listInboxFiles(cwd);
112
114
  if (files.length === 0) return { didWork: false };
@@ -1,9 +1,8 @@
1
1
  /**
2
2
  * lib/intake/git-queue.mjs — Git-backed adapter for the IntakeQueue interface.
3
3
  *
4
- * This implementation replaces the PostgresIntakeQueue for team/enterprise
5
- * modes. It uses the filesystem and Git for state synchronization and
6
- * conflict resolution, removing the dependency on a central database server.
4
+ * Backs team/enterprise modes with the filesystem and Git for state
5
+ * synchronization and conflict resolution, with no central database server.
7
6
  *
8
7
  * Structure:
9
8
  * .cx/team-inbox/
@@ -111,7 +110,8 @@ export class GitIntakeQueue {
111
110
  async claim({ claimedBy }) {
112
111
  if (!claimedBy) throw new Error('claim: claimedBy is required');
113
112
 
114
- // 1. Pull latest to minimize conflicts
113
+ // Pull latest to minimize conflicts
114
+
115
115
  try { execSync('git pull --rebase', { stdio: 'ignore' }); } catch (e) {}
116
116
 
117
117
  const pendingDir = path.join(this.inboxRoot, 'pending');
@@ -136,16 +136,17 @@ export class GitIntakeQueue {
136
136
  data.claimedAt = new Date().toISOString();
137
137
  fs.writeFileSync(claimedPath, JSON.stringify(data, null, 2));
138
138
 
139
- // 2. Commit and Push
139
+ // Commit and push the claim so peers see it
140
+
140
141
  execSync(`git add .cx/team-inbox/pending/${fileName} .cx/team-inbox/claimed/${claimedBy}/${fileName}`, { stdio: 'ignore' });
141
142
  execSync(`git commit -m "Claim task ${data.id} by ${claimedBy}"`, { stdio: 'ignore' });
142
143
  execSync('git push', { stdio: 'ignore' });
143
144
 
144
145
  return data;
145
146
  } catch (err) {
146
- // If push fails, someone else probably claimed it first or Git is out of sync.
147
- // We should ideally rollback the local move, but for this first pass
148
- // we'll let the next 'git pull --rebase' fix the state.
147
+ // A push failure means another worker claimed it first or Git is out of
148
+ // sync; the local move is left for the next 'git pull --rebase' to reconcile.
149
+
149
150
  console.error(`Failed to claim ${fileName}: ${err.message}`);
150
151
  return null;
151
152
  }
@@ -68,7 +68,8 @@ export function createIntakeQueue(rootDir, env = process.env, opts = {}) {
68
68
  const backend = opts.backend || resolveBackend(env);
69
69
  if (backend === 'filesystem') return new FilesystemIntakeQueue(rootDir);
70
70
  if (backend === 'git' || backend === 'postgres') {
71
- // We treat 'postgres' as an alias for 'git' now to avoid breaking existing configs
71
+ // 'postgres' aliases to 'git' so existing configs keep resolving
72
+
72
73
  const project = opts.project ?? resolveProject(rootDir, env);
73
74
  return new GitIntakeQueue({ project, rootDir });
74
75
  }
@@ -14,6 +14,11 @@ import { createIntakeQueue } from './queue.mjs';
14
14
  import { formatTriageLine } from './classify.mjs';
15
15
  import { isBrokered } from '../mcp/broker.mjs';
16
16
  import { getRebrand } from '../profiles/rebrand.mjs';
17
+ import { homedir as osHomedir } from 'node:os';
18
+ import { readLastTick } from '../oracle/index.mjs';
19
+ import { listPending } from '../oracle/actions.mjs';
20
+ import { readLatestVerdict } from '../oracle/verdicts.mjs';
21
+ import { isVerdictOnlyGap } from '../oracle/policy.mjs';
17
22
 
18
23
  export function buildIntakePrelude({ cwd, env = process.env } = {}) {
19
24
  if (!cwd) return '';
@@ -48,9 +53,93 @@ export function buildBrokerStatusLine({ env = process.env } = {}) {
48
53
  export function buildSessionPrelude({ cwd, env = process.env } = {}) {
49
54
  const intake = buildIntakePrelude({ cwd, env });
50
55
  const broker = buildBrokerStatusLine({ env });
51
- if (!intake && !broker) return '';
56
+ const oracle = buildOraclePrelude({ cwd, env });
57
+ if (!intake && !broker && !oracle) return '';
52
58
  const parts = [];
53
59
  if (intake) parts.push(intake.trim());
60
+ if (oracle) parts.push(oracle.trim());
54
61
  if (broker) parts.push(broker);
55
62
  return parts.join('\n\n');
56
63
  }
64
+
65
+ /**
66
+ * Oracle verdict + pending queue for session-start (mirror doctor warnings).
67
+ */
68
+ export function buildOraclePrelude({ cwd, env = process.env, homeDir } = {}) {
69
+ if (!cwd) return '';
70
+ if (env.CONSTRUCT_ORACLE === 'off' || env.CONSTRUCT_ORACLE === '0') return '';
71
+ try {
72
+ const home = homeDir ?? osHomedir();
73
+ const last = readLastTick(home);
74
+ const verdict = readLatestVerdict(cwd);
75
+ const pending = listPending(cwd).filter((p) => p.status === 'pending');
76
+ const v = verdict?.verdict ?? last?.verdict ?? 'unknown';
77
+ if (v === 'healthy' && pending.length === 0) return '';
78
+ const lines = [`\n## Oracle overseer · verdict: **${v}**`];
79
+ const gapSource = verdict?.gaps ?? last?.gaps ?? [];
80
+ const top = gapSource.filter((g) => g.severity === 'high').slice(0, 3);
81
+ for (const g of top) {
82
+ if (isVerdictOnlyGap(g)) {
83
+ const hint = g.id === 'beads-hygiene'
84
+ ? 'run `construct beads drift`'
85
+ : g.id === 'workflow-misaligned'
86
+ ? 'run `construct workflow init` or `construct init`'
87
+ : 'see `construct oracle gaps`';
88
+ lines.push(`- [${g.severity}] ${g.id} (verdict-only): ${g.detail} — ${hint}`);
89
+ } else {
90
+ lines.push(`- [${g.severity}] ${g.id}: ${g.detail}`);
91
+ }
92
+ }
93
+ if (pending.length) {
94
+ lines.push(`Pending approvals (${pending.length}): \`construct oracle pending\``);
95
+ }
96
+ lines.push('Review: `construct oracle review` · Gaps: `construct oracle gaps` · Approve: `construct oracle approve <id>`\n');
97
+ return lines.join('\n');
98
+ } catch {
99
+ return '';
100
+ }
101
+ }
102
+
103
+ export function readOracleDockState({ cwd, env = process.env, homeDir } = {}) {
104
+ if (!cwd || env.CONSTRUCT_ORACLE === 'off' || env.CONSTRUCT_ORACLE === '0') {
105
+ return { visible: false, verdict: null, pendingCount: 0, topGaps: [], summary: '' };
106
+ }
107
+ try {
108
+ const home = homeDir ?? osHomedir();
109
+ const last = readLastTick(home);
110
+ const verdictDoc = readLatestVerdict(cwd);
111
+ const pending = listPending(cwd).filter((p) => p.status === 'pending');
112
+ const verdict = verdictDoc?.verdict ?? last?.verdict ?? 'unknown';
113
+ const gapSource = verdictDoc?.gaps ?? last?.gaps ?? [];
114
+ const topGaps = gapSource.filter((g) => g.severity === 'high').slice(0, 3);
115
+ const visible = verdict !== 'healthy' || pending.length > 0;
116
+ const parts = [`verdict ${verdict}`];
117
+ if (pending.length) parts.push(`${pending.length} pending`);
118
+ return {
119
+ visible,
120
+ verdict,
121
+ pendingCount: pending.length,
122
+ topGaps,
123
+ summary: parts.join(' · '),
124
+ };
125
+ } catch {
126
+ return { visible: false, verdict: null, pendingCount: 0, topGaps: [], summary: '' };
127
+ }
128
+ }
129
+
130
+ export function formatOracleDockDetail(state) {
131
+ if (!state?.visible) return 'Oracle: healthy — no pending approvals.';
132
+ const lines = [`Oracle overseer · ${state.summary}`];
133
+ for (const g of state.topGaps || []) {
134
+ if (isVerdictOnlyGap(g)) {
135
+ lines.push(` [${g.severity}] ${g.id} (verdict-only): ${g.detail}`);
136
+ } else {
137
+ lines.push(` [${g.severity}] ${g.id}: ${g.detail}`);
138
+ }
139
+ }
140
+ if (state.pendingCount > 0) {
141
+ lines.push(' Pending: construct oracle pending');
142
+ }
143
+ lines.push(' Review: construct oracle review · Gaps: construct oracle gaps');
144
+ return lines.join('\n');
145
+ }
@@ -0,0 +1,97 @@
1
+ /**
2
+ * lib/libreoffice-export.mjs — LibreOffice headless conversion for legacy .doc export.
3
+ *
4
+ * Pandoc has no `.doc` writer; Construct exports DOCX first, then down-converts via
5
+ * `soffice --headless --convert-to doc`. Binary is optional (ADR-0024).
6
+ */
7
+
8
+ import fs from 'node:fs';
9
+ import path from 'node:path';
10
+ import { spawnSync } from 'node:child_process';
11
+
12
+ const SOFFICE_CANDIDATES = [
13
+ 'soffice',
14
+ 'libreoffice',
15
+ '/Applications/LibreOffice.app/Contents/MacOS/soffice',
16
+ ];
17
+
18
+ function whichBin(name) {
19
+ const cmd = process.platform === 'win32' ? 'where' : 'which';
20
+ const result = spawnSync(cmd, [name], { encoding: 'utf8' });
21
+ if (result.status !== 0) return null;
22
+ return (result.stdout || '').trim().split('\n')[0] || null;
23
+ }
24
+
25
+ export function resolveLibreOfficeBin(env = process.env) {
26
+ const fromEnv = (env.CONSTRUCT_LIBREOFFICE_BIN || env.SOFFICE_BIN || '').trim();
27
+ if (fromEnv && fs.existsSync(fromEnv)) return fromEnv;
28
+ for (const candidate of SOFFICE_CANDIDATES) {
29
+ if (candidate.includes('/') && fs.existsSync(candidate)) return candidate;
30
+ const found = whichBin(candidate);
31
+ if (found) return found;
32
+ }
33
+ return null;
34
+ }
35
+
36
+ export function libreOfficePresent(env = process.env) {
37
+ return Boolean(resolveLibreOfficeBin(env));
38
+ }
39
+
40
+ export function libreOfficeInstallHint() {
41
+ return 'Install LibreOffice to enable legacy .doc export (e.g. `brew install --cask libreoffice` on macOS, `apt install libreoffice` on Debian/Ubuntu, or https://www.libreoffice.org/download/). Override with CONSTRUCT_LIBREOFFICE_BIN.';
42
+ }
43
+
44
+ export function convertDocxToDoc({
45
+ docxPath,
46
+ outputPath,
47
+ env = process.env,
48
+ spawnFn = spawnSync,
49
+ } = {}) {
50
+ const soffice = resolveLibreOfficeBin(env);
51
+ if (!soffice) {
52
+ return {
53
+ ok: false,
54
+ message: libreOfficeInstallHint(),
55
+ missing: ['libreoffice'],
56
+ };
57
+ }
58
+ if (!fs.existsSync(docxPath)) {
59
+ return { ok: false, message: `DOCX intermediate missing: ${docxPath}` };
60
+ }
61
+
62
+ const outDir = path.dirname(outputPath);
63
+ fs.mkdirSync(outDir, { recursive: true });
64
+
65
+ const result = spawnFn(soffice, [
66
+ '--headless',
67
+ '--convert-to', 'doc',
68
+ '--outdir', outDir,
69
+ path.resolve(docxPath),
70
+ ], { encoding: 'utf8', env });
71
+
72
+ if (result.status !== 0) {
73
+ return {
74
+ ok: false,
75
+ message: `LibreOffice conversion failed (exit ${result.status}): ${(result.stderr || result.stdout || '').trim().slice(0, 400)}`,
76
+ };
77
+ }
78
+
79
+ const expected = path.join(outDir, `${path.parse(docxPath).name}.doc`);
80
+ if (!fs.existsSync(expected)) {
81
+ return {
82
+ ok: false,
83
+ message: `LibreOffice did not produce expected output: ${expected}`,
84
+ };
85
+ }
86
+
87
+ if (path.resolve(expected) !== path.resolve(outputPath)) {
88
+ fs.renameSync(expected, outputPath);
89
+ }
90
+
91
+ return {
92
+ ok: true,
93
+ outputPath,
94
+ engine: 'libreoffice',
95
+ message: `Wrote ${path.relative(process.cwd(), outputPath)}`,
96
+ };
97
+ }
@@ -231,6 +231,15 @@ export const LIMITS = {
231
231
  envOverride: 'CONSTRUCT_HOOK_CALLS_MAX_MB',
232
232
  },
233
233
 
234
+ // Rule path reference telemetry. ~/.cx/rule-calls.jsonl.
235
+
236
+ 'rule-calls': {
237
+ maxBytes: 10 * 1024 * 1024,
238
+ maxSegments: 2,
239
+ gzip: true,
240
+ envOverride: 'CONSTRUCT_RULE_CALLS_MAX_MB',
241
+ },
242
+
234
243
  // Legacy-lock fallback firings on the beads write path. ~/.cx/beads-fallback.jsonl.
235
244
 
236
245
  'beads-fallback': {