@geraldmaron/construct 1.2.3 → 1.3.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 (504) hide show
  1. package/README.md +7 -10
  2. package/bin/construct +235 -209
  3. package/bin/construct-postinstall.mjs +0 -21
  4. package/commands/work/optimize-prompts.md +1 -1
  5. package/examples/distribution/sources/adr.md +2 -2
  6. package/examples/seed-observations/decisions.md +1 -1
  7. package/lib/artifact-loop-core.mjs +412 -0
  8. package/lib/artifact-manifest.mjs +6 -0
  9. package/lib/artifact-release-gate.mjs +115 -49
  10. package/lib/audit-rules.mjs +2 -4
  11. package/lib/audit-skills.mjs +32 -20
  12. package/lib/audit-specialists.mjs +44 -26
  13. package/lib/auto-docs.mjs +6 -5
  14. package/lib/brand-prose.mjs +3 -3
  15. package/lib/brand-tokens.mjs +2 -2
  16. package/lib/certification/artifact-fixtures.mjs +4 -1
  17. package/lib/certification/demo-parity.mjs +6 -32
  18. package/lib/certification/real-llm-scenarios.mjs +58 -13
  19. package/lib/certification/role-cards.mjs +7 -6
  20. package/lib/certification/role-overlays.mjs +4 -4
  21. package/lib/certification/runner.mjs +9 -2
  22. package/lib/certification/skill-inventory.mjs +34 -22
  23. package/lib/certification/skill-scenarios.mjs +21 -8
  24. package/lib/certification/specialist-contracts.mjs +4 -3
  25. package/lib/certification/specialist-scenarios.mjs +7 -6
  26. package/lib/certification/status.mjs +5 -4
  27. package/lib/cli-commands.mjs +55 -54
  28. package/lib/comment-lint.mjs +1 -5
  29. package/lib/completions.mjs +20 -2
  30. package/lib/config/legacy-config-migration.mjs +90 -24
  31. package/lib/config/schema.mjs +5 -5
  32. package/lib/config/source-targets.mjs +80 -0
  33. package/lib/contracts/validate.mjs +119 -51
  34. package/lib/decisions/golden.mjs +3 -2
  35. package/lib/decisions/registry.mjs +11 -6
  36. package/lib/demo-project.mjs +188 -0
  37. package/lib/demo-recording.mjs +9 -34
  38. package/lib/demo-script.mjs +2 -2
  39. package/lib/demo-surface.mjs +13 -131
  40. package/lib/demo-tour-renderer.mjs +92 -0
  41. package/lib/demo.mjs +69 -54
  42. package/lib/diagram-export.mjs +63 -14
  43. package/lib/doctor/source-checkout.mjs +3 -4
  44. package/lib/doctor/watchers/consistency.mjs +90 -22
  45. package/lib/doctor/watchers/credential-parity.mjs +97 -0
  46. package/lib/doctor/watchers/mcp-protocol.mjs +1 -1
  47. package/lib/doctor/watchers/service-health.mjs +4 -32
  48. package/lib/document-export.mjs +73 -9
  49. package/lib/document-extract.mjs +10 -198
  50. package/lib/embed/artifact.mjs +2 -3
  51. package/lib/embed/cli.mjs +1 -1
  52. package/lib/embed/config.mjs +1 -2
  53. package/lib/embed/customer-profiles.mjs +1 -1
  54. package/lib/embed/daemon.mjs +5 -6
  55. package/lib/embed/demand-fetch.mjs +114 -2
  56. package/lib/embed/docs-lifecycle.mjs +9 -5
  57. package/lib/embed/intake-metrics.mjs +2 -2
  58. package/lib/embed/notifications.mjs +2 -3
  59. package/lib/embed/recommendation-store.mjs +25 -22
  60. package/lib/embed/role-framing.mjs +4 -9
  61. package/lib/embedded-contract/capability.mjs +4 -2
  62. package/lib/embedded-contract/contract-version.mjs +1 -1
  63. package/lib/env-config.mjs +2 -2
  64. package/lib/flavors/loader.mjs +21 -19
  65. package/lib/graph/build-from-registry.mjs +31 -7
  66. package/lib/graph/staleness.mjs +1 -1
  67. package/lib/headhunt.mjs +82 -35
  68. package/lib/hooks/agent-tracker.mjs +2 -2
  69. package/lib/hooks/config-protection.mjs +1 -1
  70. package/lib/hooks/registry-sync.mjs +3 -3
  71. package/lib/host-capabilities.mjs +5 -5
  72. package/lib/improvement/controller.mjs +2 -2
  73. package/lib/init-unified.mjs +19 -21
  74. package/lib/intake/classify.mjs +26 -0
  75. package/lib/intake/daemon.mjs +2 -3
  76. package/lib/intake/prepare.mjs +10 -3
  77. package/lib/intake/session-prelude.mjs +1 -1
  78. package/lib/intake/tables/creative.mjs +9 -9
  79. package/lib/intake/tables/operations.mjs +4 -4
  80. package/lib/intake/tables/research.mjs +2 -2
  81. package/lib/integrations/intake-integrations.mjs +9 -10
  82. package/lib/knowledge/research-store.mjs +2 -2
  83. package/lib/mcp/server.mjs +104 -61
  84. package/lib/mcp/tool-budget.mjs +1 -46
  85. package/lib/mcp/tool-recovery.mjs +44 -0
  86. package/lib/mcp/tools/artifact-author.mjs +36 -0
  87. package/lib/mcp/tools/find-tool.mjs +86 -0
  88. package/lib/mcp/tools/orchestration-run.mjs +107 -69
  89. package/lib/mcp/tools/project.mjs +4 -3
  90. package/lib/mcp/tools/{profile.mjs → scope.mjs} +54 -52
  91. package/lib/mcp/tools/skills.mjs +39 -22
  92. package/lib/mcp/tools/telemetry.mjs +2 -1
  93. package/lib/mcp/tools/workflow.mjs +1 -1
  94. package/lib/mcp-platform-config.mjs +7 -5
  95. package/lib/migrations/index.mjs +4 -2
  96. package/lib/migrations/v2-unified-registry.mjs +35 -0
  97. package/lib/model-router.mjs +203 -36
  98. package/lib/models/catalog.mjs +25 -9
  99. package/lib/models/execution-capability-profile.mjs +3 -3
  100. package/lib/models/execution-policy.mjs +7 -6
  101. package/lib/models/provider-poll.mjs +18 -4
  102. package/lib/opencode-config.mjs +56 -1
  103. package/lib/opencode-runtime-plugin.mjs +13 -10
  104. package/lib/oracle/artifact-gate.mjs +14 -4
  105. package/lib/oracle/cli.mjs +2 -0
  106. package/lib/oracle/dispatch.mjs +18 -1
  107. package/lib/oracle/execute.mjs +39 -7
  108. package/lib/oracle/index.mjs +1 -1
  109. package/lib/oracle/org-graph.mjs +10 -5
  110. package/lib/oracle/policy.mjs +6 -0
  111. package/lib/oracle/read-model.mjs +103 -6
  112. package/lib/oracle/reconcile.mjs +31 -4
  113. package/lib/oracle/remediation-dispatch.mjs +53 -0
  114. package/lib/oracle/routing.mjs +5 -0
  115. package/lib/oracle/synthesize.mjs +80 -3
  116. package/lib/orchestration/routing-tables.mjs +44 -10
  117. package/lib/orchestration/runtime.mjs +2 -0
  118. package/lib/orchestration/worker.mjs +1 -1
  119. package/lib/orchestration-policy.mjs +351 -62
  120. package/lib/overrides/resolver.mjs +1 -12
  121. package/lib/parity.mjs +37 -11
  122. package/lib/policy/engine.mjs +80 -15
  123. package/lib/prompt-composer.js +51 -15
  124. package/lib/prompt-metadata.mjs +3 -2
  125. package/lib/providers/connection-probe.mjs +58 -0
  126. package/lib/providers/copilot-auth.mjs +1 -1
  127. package/lib/providers/credential-bootstrap.mjs +1 -1
  128. package/lib/providers/op-run.mjs +3 -4
  129. package/lib/providers/secret-resolver.mjs +31 -0
  130. package/lib/publish-tooling.mjs +3 -11
  131. package/lib/publish.mjs +12 -29
  132. package/lib/reconcile/mcp-entry-reconcile.mjs +14 -9
  133. package/lib/reflect.mjs +2 -2
  134. package/lib/registry/agent-manifest.mjs +190 -0
  135. package/lib/registry/assemble.mjs +133 -0
  136. package/lib/registry/catalog.mjs +171 -0
  137. package/lib/registry/cli.mjs +590 -6
  138. package/lib/registry/consolidation.mjs +5 -4
  139. package/lib/registry/docs-sync.mjs +67 -0
  140. package/lib/registry/loader.mjs +147 -0
  141. package/lib/registry/org-io.mjs +76 -0
  142. package/lib/registry/retired-paths.mjs +71 -0
  143. package/lib/registry/surface-map.mjs +5 -7
  144. package/lib/registry/validator.mjs +438 -0
  145. package/lib/research-execution-policy.mjs +173 -0
  146. package/lib/roles/catalog.mjs +4 -9
  147. package/lib/roles/fence.mjs +107 -1
  148. package/lib/roles/flavor-bindings.mjs +68 -0
  149. package/lib/roles/gateway.mjs +140 -29
  150. package/lib/roles/manifest.mjs +22 -13
  151. package/lib/roles/router.mjs +1 -1
  152. package/lib/scopes/enrich.mjs +67 -0
  153. package/lib/scopes/hooks.mjs +12 -0
  154. package/lib/{profiles → scopes}/lifecycle.mjs +70 -70
  155. package/lib/scopes/loader.mjs +104 -0
  156. package/lib/scopes/rebrand.mjs +32 -0
  157. package/lib/scopes/research-profile.mjs +16 -0
  158. package/lib/scopes/teams.mjs +98 -0
  159. package/lib/service-manager.mjs +1 -117
  160. package/lib/setup-prompts.mjs +1 -1
  161. package/lib/setup.mjs +6 -26
  162. package/lib/skills/composition-graph.mjs +98 -0
  163. package/lib/skills/router.mjs +80 -0
  164. package/lib/specialist-contracts.mjs +17 -18
  165. package/lib/specialists/postconditions.mjs +2 -2
  166. package/lib/specialists/prompt-schema.mjs +6 -5
  167. package/lib/specialists/roster.mjs +7 -12
  168. package/lib/specialists/schema.mjs +9 -6
  169. package/lib/status.mjs +25 -90
  170. package/lib/storage/file-lock.mjs +6 -3
  171. package/lib/telemetry/skill-calls.mjs +1 -1
  172. package/lib/templates/doc-presentation.mjs +63 -0
  173. package/lib/templates/visual-requirements.mjs +35 -2
  174. package/lib/term-format.mjs +107 -2
  175. package/lib/test-env-setup.mjs +21 -0
  176. package/lib/ui/components.mjs +42 -0
  177. package/lib/ui/glyphs.mjs +58 -0
  178. package/lib/ui/links.mjs +115 -0
  179. package/lib/ui/theme.mjs +108 -0
  180. package/lib/uninstall/uninstall.mjs +2 -1
  181. package/lib/validator.mjs +45 -8
  182. package/lib/validators/skill-effectiveness.mjs +174 -0
  183. package/lib/validators/skills.mjs +1 -1
  184. package/package.json +12 -8
  185. package/personas/construct.md +12 -3
  186. package/platforms/claude/CLAUDE.md +1 -1
  187. package/rules/common/beads-hygiene.md +52 -0
  188. package/rules/common/neurodivergent-output.md +4 -7
  189. package/rules/common/research.md +2 -0
  190. package/scripts/sync-specialists.mjs +260 -49
  191. package/skills/ai/prompt-optimizer.md +3 -3
  192. package/skills/brand/output-vibe.md +48 -0
  193. package/skills/docs/adr-workflow.md +3 -0
  194. package/skills/docs/backlog-proposal-workflow.md +3 -0
  195. package/skills/docs/codebase-research-workflow.md +5 -2
  196. package/skills/docs/customer-profile-workflow.md +3 -0
  197. package/skills/docs/document-ingest-workflow.md +3 -0
  198. package/skills/docs/evidence-ingest-workflow.md +4 -1
  199. package/skills/docs/init-project.md +1 -1
  200. package/skills/docs/prd-workflow.md +1 -1
  201. package/skills/docs/prfaq-workflow.md +3 -0
  202. package/skills/docs/product-intelligence-workflow.md +4 -1
  203. package/skills/docs/product-signal-workflow.md +3 -0
  204. package/skills/docs/research-workflow.md +13 -6
  205. package/skills/docs/runbook-workflow.md +3 -0
  206. package/skills/docs/strategy-workflow.md +3 -0
  207. package/skills/docs/user-research-workflow.md +6 -3
  208. package/skills/operating/orchestration-reference.md +1 -1
  209. package/skills/roles/{engineer.ai.md → ai-engineer.md} +2 -2
  210. package/skills/roles/architect.ai-systems.md +1 -1
  211. package/skills/roles/architect.data.md +1 -1
  212. package/skills/roles/architect.enterprise.md +1 -1
  213. package/skills/roles/architect.integration.md +1 -1
  214. package/skills/roles/architect.md +1 -1
  215. package/skills/roles/architect.platform.md +1 -1
  216. package/skills/roles/{product-manager.business-strategy.md → business-strategist.md} +3 -3
  217. package/skills/roles/data-analyst.experiment.md +1 -1
  218. package/skills/roles/data-analyst.md +1 -1
  219. package/skills/roles/data-analyst.product-intelligence.md +1 -1
  220. package/skills/roles/data-analyst.product.md +1 -1
  221. package/skills/roles/data-analyst.telemetry.md +1 -1
  222. package/skills/roles/{engineer.data.md → data-engineer.md} +2 -2
  223. package/skills/roles/data-engineer.pipeline.md +2 -2
  224. package/skills/roles/data-engineer.vector-retrieval.md +2 -2
  225. package/skills/roles/data-engineer.warehouse.md +2 -2
  226. package/skills/roles/debugger.md +1 -1
  227. package/skills/roles/designer.accessibility.md +1 -1
  228. package/skills/roles/designer.md +1 -1
  229. package/skills/roles/{reviewer.devil-advocate.md → devil-advocate.md} +2 -2
  230. package/skills/roles/{operator.docs.md → docs-keeper.md} +3 -3
  231. package/skills/roles/engineer.md +3 -7
  232. package/skills/roles/{reviewer.evaluator.md → evaluator.md} +2 -2
  233. package/skills/roles/{researcher.explorer.md → explorer.md} +2 -2
  234. package/skills/roles/{operator.md → operations.md} +2 -5
  235. package/skills/roles/orchestrator.md +1 -1
  236. package/skills/roles/{engineer.platform.md → platform-engineer.md} +2 -2
  237. package/skills/roles/product-manager.ai-product.md +1 -1
  238. package/skills/roles/product-manager.enterprise.md +1 -1
  239. package/skills/roles/product-manager.growth.md +1 -2
  240. package/skills/roles/product-manager.md +1 -2
  241. package/skills/roles/product-manager.platform.md +1 -1
  242. package/skills/roles/product-manager.product.md +1 -1
  243. package/skills/roles/qa.ai-eval.md +1 -1
  244. package/skills/roles/qa.api-contract.md +1 -1
  245. package/skills/roles/qa.data-pipeline.md +1 -1
  246. package/skills/roles/qa.md +1 -1
  247. package/skills/roles/qa.web-ui.md +1 -1
  248. package/skills/roles/{operator.release.md → release-manager.md} +3 -3
  249. package/skills/roles/researcher.md +1 -1
  250. package/skills/roles/reviewer.md +1 -1
  251. package/skills/roles/security.ai.md +1 -1
  252. package/skills/roles/security.appsec.md +1 -1
  253. package/skills/roles/security.cloud.md +1 -1
  254. package/skills/roles/security.legal-compliance.md +1 -1
  255. package/skills/roles/security.md +1 -1
  256. package/skills/roles/security.privacy.md +1 -1
  257. package/skills/roles/security.supply-chain.md +1 -1
  258. package/skills/roles/{operator.sre.md → sre.md} +3 -3
  259. package/skills/roles/{qa.test-automation.md → test-automation.md} +2 -2
  260. package/skills/roles/{reviewer.trace.md → trace-reviewer.md} +2 -2
  261. package/skills/roles/{researcher.ux.md → ux-researcher.md} +2 -2
  262. package/skills/routing.json +18 -0
  263. package/skills/routing.md +1 -1
  264. package/specialists/artifact-manifest.json +2 -1
  265. package/specialists/audit-enrichments.json +14 -14
  266. package/specialists/org/contracts/accessibility-to-qa.json +37 -0
  267. package/specialists/org/contracts/any-to-business-strategist.json +57 -0
  268. package/specialists/org/contracts/any-to-debugger.json +38 -0
  269. package/specialists/org/contracts/any-to-designer.json +33 -0
  270. package/specialists/org/contracts/any-to-docs-keeper.json +34 -0
  271. package/specialists/org/contracts/any-to-explorer.json +39 -0
  272. package/specialists/org/contracts/any-to-sre-incident.json +33 -0
  273. package/specialists/org/contracts/any-to-trace-reviewer.json +32 -0
  274. package/specialists/org/contracts/architect-to-ai-engineer.json +32 -0
  275. package/specialists/org/contracts/architect-to-data-engineer.json +52 -0
  276. package/specialists/org/contracts/architect-to-devil-advocate.json +38 -0
  277. package/specialists/org/contracts/architect-to-engineer.json +34 -0
  278. package/specialists/org/contracts/architect-to-evaluator.json +59 -0
  279. package/specialists/org/contracts/architect-to-legal-compliance.json +55 -0
  280. package/specialists/org/contracts/architect-to-operations.json +45 -0
  281. package/specialists/org/contracts/architect-to-platform-engineer.json +42 -0
  282. package/specialists/org/contracts/business-strategist-to-product-manager.json +39 -0
  283. package/specialists/org/contracts/construct-to-orchestrator.json +36 -0
  284. package/specialists/org/contracts/construct-to-rd-lead.json +53 -0
  285. package/specialists/org/contracts/data-analyst-to-product-manager.json +43 -0
  286. package/specialists/org/contracts/data-engineer-to-platform-engineer.json +36 -0
  287. package/specialists/org/contracts/designer-to-accessibility.json +36 -0
  288. package/specialists/org/contracts/engineer-to-qa.json +34 -0
  289. package/specialists/org/contracts/engineer-to-reviewer.json +52 -0
  290. package/specialists/org/contracts/explorer-to-engineer.json +38 -0
  291. package/specialists/org/contracts/legal-compliance-to-release-manager.json +43 -0
  292. package/specialists/org/contracts/platform-engineer-to-engineer.json +31 -0
  293. package/specialists/org/contracts/product-manager-to-architect.json +71 -0
  294. package/specialists/org/contracts/product-manager-to-data-analyst.json +49 -0
  295. package/specialists/org/contracts/product-manager-to-ux-researcher.json +51 -0
  296. package/specialists/org/contracts/qa-to-release-manager.json +42 -0
  297. package/specialists/org/contracts/qa-to-test-automation.json +42 -0
  298. package/specialists/org/contracts/rd-lead-to-architect.json +38 -0
  299. package/specialists/org/contracts/researcher-to-architect.json +40 -0
  300. package/specialists/org/contracts/researcher-to-product-manager.json +57 -0
  301. package/specialists/org/contracts/reviewer-to-security.json +41 -0
  302. package/specialists/org/contracts/sre-to-release-manager.json +36 -0
  303. package/specialists/org/contracts/test-automation-to-engineer.json +34 -0
  304. package/specialists/org/contracts/trace-reviewer-to-sre.json +41 -0
  305. package/specialists/org/contracts/user-to-construct.json +30 -0
  306. package/specialists/org/groups/engineering-group.json +43 -0
  307. package/specialists/org/groups/governance-group.json +38 -0
  308. package/specialists/org/groups/operations-group.json +41 -0
  309. package/specialists/org/groups/product-group.json +46 -0
  310. package/specialists/org/groups/quality-group.json +42 -0
  311. package/specialists/org/groups/strategy-group.json +41 -0
  312. package/specialists/org/policies/action-approval.json +13 -0
  313. package/specialists/org/policies/agents-routing.json +13 -0
  314. package/specialists/org/policies/architecture.json +20 -0
  315. package/specialists/org/policies/bash-safety.json +13 -0
  316. package/specialists/org/policies/beads-hygiene.json +13 -0
  317. package/specialists/org/policies/bootstrap-state.json +13 -0
  318. package/specialists/org/policies/code-review.json +13 -0
  319. package/specialists/org/policies/coding-style.json +13 -0
  320. package/specialists/org/policies/comments.json +13 -0
  321. package/specialists/org/policies/commit-approval.json +13 -0
  322. package/specialists/org/policies/contract-preconditions.json +13 -0
  323. package/specialists/org/policies/deployment.json +20 -0
  324. package/specialists/org/policies/description.json +14 -0
  325. package/specialists/org/policies/design-approval.json +19 -0
  326. package/specialists/org/policies/doc-ownership.json +13 -0
  327. package/specialists/org/policies/file-path-fence.json +13 -0
  328. package/specialists/org/policies/framing.json +13 -0
  329. package/specialists/org/policies/git-workflow.json +13 -0
  330. package/specialists/org/policies/incident-response.json +15 -0
  331. package/specialists/org/policies/intake-triage.json +15 -0
  332. package/specialists/org/policies/neurodivergent-output.json +13 -0
  333. package/specialists/org/policies/no-fabrication.json +13 -0
  334. package/specialists/org/policies/patterns.json +13 -0
  335. package/specialists/org/policies/quality-gate-approval.json +17 -0
  336. package/specialists/org/policies/release-gates.json +13 -0
  337. package/specialists/org/policies/research-evidence.json +13 -0
  338. package/specialists/org/policies/review-before-change.json +13 -0
  339. package/specialists/org/policies/rollback.json +15 -0
  340. package/specialists/org/policies/scope-change.json +20 -0
  341. package/specialists/org/policies/secret-scan.json +13 -0
  342. package/specialists/org/policies/security-approval.json +17 -0
  343. package/specialists/org/policies/security.json +13 -0
  344. package/specialists/org/policies/session-efficiency.json +13 -0
  345. package/specialists/org/policies/skill-routing.json +13 -0
  346. package/specialists/org/policies/strategic-prioritization.json +17 -0
  347. package/specialists/org/policies/testing.json +13 -0
  348. package/specialists/org/policies/tool-invisibility.json +14 -0
  349. package/specialists/org/scopes/creative.json +54 -0
  350. package/specialists/org/scopes/operations.json +51 -0
  351. package/specialists/org/scopes/research.json +60 -0
  352. package/specialists/org/scopes/rnd.json +81 -0
  353. package/specialists/org/specialists/cx-accessibility.json +69 -0
  354. package/specialists/org/specialists/cx-ai-engineer.json +75 -0
  355. package/specialists/org/specialists/cx-architect.json +89 -0
  356. package/specialists/org/specialists/cx-business-strategist.json +72 -0
  357. package/specialists/org/specialists/cx-data-analyst.json +68 -0
  358. package/specialists/org/specialists/cx-data-engineer.json +71 -0
  359. package/specialists/org/specialists/cx-debugger.json +75 -0
  360. package/specialists/org/specialists/cx-designer.json +85 -0
  361. package/specialists/org/specialists/cx-devil-advocate.json +71 -0
  362. package/specialists/org/specialists/cx-docs-keeper.json +82 -0
  363. package/specialists/org/specialists/cx-engineer.json +106 -0
  364. package/specialists/org/specialists/cx-evaluator.json +69 -0
  365. package/specialists/org/specialists/cx-explorer.json +69 -0
  366. package/specialists/org/specialists/cx-legal-compliance.json +74 -0
  367. package/specialists/org/specialists/cx-operations.json +72 -0
  368. package/specialists/org/specialists/cx-oracle.json +46 -0
  369. package/specialists/org/specialists/cx-orchestrator.json +81 -0
  370. package/specialists/org/specialists/cx-platform-engineer.json +80 -0
  371. package/specialists/org/specialists/cx-product-manager.json +102 -0
  372. package/specialists/org/specialists/cx-qa.json +79 -0
  373. package/specialists/org/specialists/cx-rd-lead.json +73 -0
  374. package/specialists/org/specialists/cx-release-manager.json +77 -0
  375. package/specialists/org/specialists/cx-researcher.json +82 -0
  376. package/specialists/org/specialists/cx-reviewer.json +71 -0
  377. package/specialists/org/specialists/cx-security.json +91 -0
  378. package/specialists/org/specialists/cx-sre.json +94 -0
  379. package/specialists/org/specialists/cx-test-automation.json +69 -0
  380. package/specialists/org/specialists/cx-trace-reviewer.json +69 -0
  381. package/specialists/org/specialists/cx-ux-researcher.json +68 -0
  382. package/specialists/org/teams/accessibility-team.json +39 -0
  383. package/specialists/org/teams/design-team.json +40 -0
  384. package/specialists/org/teams/engineering-team.json +50 -0
  385. package/specialists/org/teams/governance-team.json +41 -0
  386. package/specialists/org/teams/operations-team.json +46 -0
  387. package/specialists/org/teams/product-management-team.json +45 -0
  388. package/specialists/org/teams/quality-team.json +49 -0
  389. package/specialists/org/teams/research-team.json +39 -0
  390. package/specialists/org/teams/strategy-team.json +48 -0
  391. package/specialists/org/teams/ux-research-team.json +39 -0
  392. package/specialists/prompts/_shared/validation-contract.md +1 -1
  393. package/specialists/prompts/_team-template.md +10 -0
  394. package/specialists/prompts/cx-accessibility.md +1 -0
  395. package/specialists/prompts/cx-ai-engineer.md +1 -1
  396. package/specialists/prompts/cx-business-strategist.md +1 -1
  397. package/specialists/prompts/cx-data-engineer.md +1 -1
  398. package/specialists/prompts/cx-designer.md +1 -0
  399. package/specialists/prompts/cx-devil-advocate.md +1 -1
  400. package/specialists/prompts/cx-docs-keeper.md +1 -1
  401. package/specialists/prompts/cx-evaluator.md +1 -1
  402. package/specialists/prompts/cx-explorer.md +1 -1
  403. package/specialists/prompts/cx-operations.md +1 -1
  404. package/specialists/prompts/cx-oracle.md +7 -3
  405. package/specialists/prompts/cx-orchestrator.md +17 -1
  406. package/specialists/prompts/cx-platform-engineer.md +1 -1
  407. package/specialists/prompts/cx-product-manager.md +2 -0
  408. package/specialists/prompts/cx-release-manager.md +1 -1
  409. package/specialists/prompts/cx-researcher.md +7 -4
  410. package/specialists/prompts/cx-sre.md +1 -1
  411. package/specialists/prompts/cx-test-automation.md +2 -2
  412. package/specialists/prompts/cx-trace-reviewer.md +3 -3
  413. package/specialists/prompts/cx-ux-researcher.md +2 -1
  414. package/templates/demos/scripts/architecture-review-adr.json +30 -0
  415. package/templates/demos/scripts/capability-contract.json +25 -0
  416. package/templates/demos/scripts/intake-triage.json +25 -0
  417. package/templates/demos/scripts/profile-doctor-health.json +25 -0
  418. package/templates/demos/tapes/agentic-platforms-prd.tape +2 -2
  419. package/templates/demos/tapes/architecture-review-adr.tape +44 -0
  420. package/templates/demos/tapes/capability-contract.tape +39 -0
  421. package/templates/demos/tapes/intake-triage.tape +39 -0
  422. package/templates/demos/tapes/profile-doctor-health.tape +39 -0
  423. package/templates/distribution/construct-brand.typ +23 -18
  424. package/templates/distribution/construct-decision.typ +1 -1
  425. package/templates/distribution/construct-pdf.typ +1 -1
  426. package/templates/distribution/construct-prd.typ +1 -1
  427. package/templates/distribution/construct-research.typ +1 -1
  428. package/templates/distribution/mermaid-puppeteer.json +8 -0
  429. package/templates/docs/persona-artifact.md +1 -1
  430. package/templates/docs/prd.md +6 -0
  431. package/apps/chat/engine/ai-sdk-agent.mjs +0 -183
  432. package/apps/chat/engine/loop-driver.mjs +0 -211
  433. package/apps/chat/engine/models.mjs +0 -122
  434. package/apps/chat/engine/provider-adapters.mjs +0 -171
  435. package/apps/chat/engine/tools/permission.mjs +0 -54
  436. package/apps/chat/engine/tools/primitives.mjs +0 -180
  437. package/apps/chat/engine/tools/registry.mjs +0 -122
  438. package/apps/chat/engine/turn-controls.mjs +0 -70
  439. package/lib/boundary.mjs +0 -127
  440. package/lib/certification/dashboard-api.mjs +0 -71
  441. package/lib/chat/cli.mjs +0 -333
  442. package/lib/chat/command-suggest.mjs +0 -161
  443. package/lib/chat/commands.mjs +0 -215
  444. package/lib/chat/config.mjs +0 -142
  445. package/lib/chat/context-compactor.mjs +0 -250
  446. package/lib/chat/context-continuation.mjs +0 -253
  447. package/lib/chat/continuation-source.mjs +0 -58
  448. package/lib/chat/demo-guide.mjs +0 -61
  449. package/lib/chat/design-tokens.mjs +0 -91
  450. package/lib/chat/desktop-binary.mjs +0 -81
  451. package/lib/chat/desktop-build.mjs +0 -130
  452. package/lib/chat/desktop-launcher.mjs +0 -133
  453. package/lib/chat/evidence.mjs +0 -145
  454. package/lib/chat/export.mjs +0 -74
  455. package/lib/chat/harness/driver.mjs +0 -91
  456. package/lib/chat/list-picker.mjs +0 -112
  457. package/lib/chat/model-picker.mjs +0 -356
  458. package/lib/chat/openrouter-fallback.mjs +0 -151
  459. package/lib/chat/permission-prompt.mjs +0 -33
  460. package/lib/chat/picker-catalog.mjs +0 -45
  461. package/lib/chat/policy-telemetry.mjs +0 -34
  462. package/lib/chat/present.mjs +0 -246
  463. package/lib/chat/session-context.mjs +0 -39
  464. package/lib/chat/session-persist.mjs +0 -73
  465. package/lib/chat/session-restore.mjs +0 -71
  466. package/lib/chat/session-settings.mjs +0 -53
  467. package/lib/chat/system-prompt.mjs +0 -52
  468. package/lib/chat/transparency.mjs +0 -93
  469. package/lib/chat/tui/color-scheme.mjs +0 -42
  470. package/lib/chat/tui/markdown.mjs +0 -123
  471. package/lib/chat/tui/presentation.mjs +0 -100
  472. package/lib/chat/tui/render.mjs +0 -500
  473. package/lib/chat/tui/turn-block.mjs +0 -284
  474. package/lib/chat/tui/turn-present.mjs +0 -18
  475. package/lib/chat/tui/turn-state.mjs +0 -88
  476. package/lib/chat/tui/usage.mjs +0 -122
  477. package/lib/chat/web-commands.mjs +0 -146
  478. package/lib/chat/web-launcher.mjs +0 -63
  479. package/lib/chat/web-picker-keys.mjs +0 -46
  480. package/lib/chat/web-session.mjs +0 -159
  481. package/lib/config/alias.mjs +0 -57
  482. package/lib/dashboard-demo.mjs +0 -71
  483. package/lib/dashboard-static.mjs +0 -175
  484. package/lib/install/desktop-binary-download.mjs +0 -88
  485. package/lib/profiles/loader.mjs +0 -123
  486. package/lib/profiles/rebrand.mjs +0 -46
  487. package/lib/server/auth.mjs +0 -169
  488. package/lib/server/chat-loop.mjs +0 -622
  489. package/lib/server/chat.mjs +0 -336
  490. package/lib/server/cors.mjs +0 -77
  491. package/lib/server/csrf.mjs +0 -103
  492. package/lib/server/demo-preview.mjs +0 -63
  493. package/lib/server/index.mjs +0 -2641
  494. package/lib/server/insights.mjs +0 -780
  495. package/lib/server/langfuse-login.mjs +0 -58
  496. package/lib/server/rate-limit.mjs +0 -93
  497. package/lib/server/telemetry-login.mjs +0 -100
  498. package/lib/server/webhook.mjs +0 -512
  499. package/specialists/contracts.json +0 -1032
  500. package/specialists/contracts.schema.json +0 -83
  501. package/specialists/policy-inventory.json +0 -188
  502. package/specialists/registry.json +0 -1412
  503. package/specialists/role-manifests.json +0 -217
  504. package/specialists/teams.json +0 -94
@@ -1,284 +0,0 @@
1
- /**
2
- * lib/chat/tui/turn-block.mjs — discriminated turn blocks for construct chat.
3
- *
4
- * Each user prompt opens a TurnBlock: user message, policy overlay (turn_context),
5
- * optional thinking/tools streams, assistant answer, turn usage footer, and system
6
- * notices. Pure data — no React — so Ink and the linear renderer share one model.
7
- * Sources in turn_context are populated only from recorded tool events (no-fabrication).
8
- */
9
-
10
- import { formatUsageFooter } from './usage.mjs';
11
- import { deriveEvidenceVerdict, evidenceNotice, evidenceTarget, isSuccessfulEvidenceTool, migrateEvidenceVerdict } from '../evidence.mjs';
12
-
13
- export const BLOCK_TYPES = [
14
- 'user', 'turn_context', 'thinking', 'tool', 'assistant', 'turn_usage', 'system_notice',
15
- ];
16
-
17
- export function createTurnBlock(userText) {
18
- return {
19
- id: `turn-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
20
- userText: String(userText),
21
- overlay: null,
22
- thinking: '',
23
- tools: [],
24
- assistant: '',
25
- usage: null,
26
- sources: [],
27
- evidence: null,
28
- notices: [],
29
- continuation: null,
30
- closed: false,
31
- };
32
- }
33
-
34
- export function overlayToContext(overlay) {
35
- if (!overlay) return null;
36
- return {
37
- intent: overlay.intent || null,
38
- workCategory: overlay.workCategory || null,
39
- specialists: Array.isArray(overlay.specialists) ? [...overlay.specialists] : [],
40
- externalResearch: overlay.externalResearch || null,
41
- riskFlags: overlay.riskFlags || [],
42
- track: overlay.track || null,
43
- contractChain: Array.isArray(overlay.contractChain)
44
- ? overlay.contractChain.map((edge) => ({ ...edge }))
45
- : [],
46
- dispatchReasons: overlay.dispatchReasons ? { ...overlay.dispatchReasons } : null,
47
- triggers: Array.isArray(overlay.triggers)
48
- ? overlay.triggers.map((t) => ({ ...t }))
49
- : [],
50
- dispatchSummary: overlay.dispatchSummary || null,
51
- };
52
- }
53
-
54
- export function applyOverlayToTurn(turn, overlay) {
55
- if (!turn || !overlay) return turn;
56
- turn.overlay = overlayToContext(overlay);
57
- return turn;
58
- }
59
-
60
- export function recordSource(turn, { tool, ref }) {
61
- if (!turn || !tool || !ref) return;
62
- const key = `${tool}:${ref}`;
63
- if (turn.sources.some((s) => `${s.tool}:${s.ref}` === key)) return;
64
- turn.sources.push({ tool, ref, ts: Date.now() });
65
- }
66
-
67
- export function sourceFromToolEvent(event) {
68
- if (!event) return null;
69
- const title = event.title || event.kind || '';
70
- if (title === 'read' || title === 'grep' || title === 'glob') {
71
- const path = evidenceTarget(event);
72
- if (path) return { tool: title, ref: String(path) };
73
- }
74
- if (title === 'construct_tool') {
75
- const name = event.input?.name;
76
- if (name) return { tool: 'construct_tool', ref: String(name) };
77
- }
78
- return null;
79
- }
80
-
81
- export function turnBlocksFromTranscript(entries = []) {
82
- const blocks = [];
83
- let current = null;
84
-
85
- for (const entry of entries) {
86
- if (entry.kind && entry.block) {
87
- blocks.push(entry.block);
88
- if (entry.kind === 'turn') current = entry.block;
89
- continue;
90
- }
91
- if (entry.role === 'you' || entry.role === 'user') {
92
- current = createTurnBlock(entry.text);
93
- blocks.push({ kind: 'turn', block: current });
94
- continue;
95
- }
96
- if (!current) {
97
- if (entry.role === 'construct') blocks.push({ kind: 'legacy', role: 'assistant', text: entry.text });
98
- continue;
99
- }
100
- if (entry.role === 'thinking') current.thinking = entry.text;
101
- else if (entry.role === 'construct') current.assistant = entry.text;
102
- }
103
- return blocks;
104
- }
105
-
106
- export function flattenTurnBlocks(blocks) {
107
- const out = [];
108
- for (const item of blocks) {
109
- if (item.kind === 'legacy') {
110
- out.push({ type: 'assistant', text: item.text });
111
- continue;
112
- }
113
- if (item.kind !== 'turn') continue;
114
- const t = item.block;
115
- out.push({ type: 'user', text: t.userText });
116
- if (t.overlay) out.push({ type: 'turn_context', overlay: t.overlay, sources: t.sources });
117
- if (t.thinking) out.push({ type: 'thinking', text: t.thinking });
118
- for (const tool of t.tools) out.push({ type: 'tool', ...tool });
119
- if (t.assistant) out.push({ type: 'assistant', text: t.assistant });
120
- if (t.usage) out.push({ type: 'turn_usage', usage: t.usage });
121
- for (const n of t.notices) out.push({ type: 'system_notice', text: n });
122
- }
123
- return out;
124
- }
125
-
126
- export function serializeBlock(turn) {
127
- return { type: 'transcript_block', block: snapshotTurn(turn) };
128
- }
129
-
130
- export function deserializeBlock(row) {
131
- if (row?.type === 'transcript_block' && row.block) {
132
- return { ...row.block, evidence: migrateEvidenceVerdict(row.block) };
133
- }
134
- if (row?.type === 'transcript' && row.role && row.text) {
135
- return { legacy: true, role: row.role === 'you' ? 'user' : row.role, text: row.text };
136
- }
137
- return null;
138
- }
139
-
140
- export function restoreBlocksFromSessionLines(lines) {
141
- const blocks = [];
142
- let current = null;
143
-
144
- for (const row of lines) {
145
- const parsed = typeof row === 'string' ? (() => { try { return JSON.parse(row); } catch { return null; } })() : row;
146
- if (!parsed) continue;
147
-
148
- const des = deserializeBlock(parsed);
149
- if (!des) continue;
150
-
151
- if (des.legacy) {
152
- if (des.role === 'user') {
153
- current = createTurnBlock(des.text);
154
- blocks.push({ kind: 'turn', block: current });
155
- } else if (current && des.role === 'assistant') {
156
- current.assistant = des.text;
157
- } else {
158
- blocks.push({ kind: 'legacy', role: 'assistant', text: des.text });
159
- }
160
- continue;
161
- }
162
-
163
- if (des.kind === 'user') {
164
- current = createTurnBlock(des.userText || des.text || '');
165
- blocks.push({ kind: 'turn', block: current });
166
- } else if (des.kind === 'turn_snapshot') {
167
- current = {
168
- ...des,
169
- tools: des.tools || [],
170
- sources: des.sources || [],
171
- evidence: migrateEvidenceVerdict(des),
172
- notices: des.notices || [],
173
- continuation: des.continuation || null,
174
- };
175
- blocks.push({ kind: 'turn', block: current });
176
- }
177
- }
178
- return blocks;
179
- }
180
-
181
- export function snapshotTurn(turn) {
182
- return {
183
- kind: 'turn_snapshot',
184
- id: turn.id,
185
- userText: turn.userText,
186
- overlay: turn.overlay,
187
- thinking: turn.thinking,
188
- tools: turn.tools,
189
- assistant: turn.assistant,
190
- usage: turn.usage,
191
- sources: turn.sources,
192
- evidence: turn.evidence,
193
- notices: turn.notices,
194
- continuation: turn.continuation || null,
195
- };
196
- }
197
-
198
- export function applyEventToTurn(turn, event, state = null) {
199
- if (!turn || !event) return turn;
200
- switch (event.type) {
201
- case 'thinking':
202
- turn.thinking = state?.thinking ?? `${turn.thinking || ''}${event.text || ''}`;
203
- break;
204
- case 'text':
205
- turn.assistant = state?.assistant ?? `${turn.assistant || ''}${event.text || ''}`;
206
- break;
207
- case 'tool_call': {
208
- const existing = turn.tools.find((t) => t.id === event.id);
209
- if (existing) {
210
- existing.input = event.input ?? existing.input;
211
- } else {
212
- turn.tools.push({
213
- id: event.id,
214
- title: event.title || event.kind || 'tool',
215
- status: 'pending',
216
- input: event.input ?? null,
217
- });
218
- }
219
- break;
220
- }
221
- case 'tool_update': {
222
- const t = turn.tools.find((x) => x.id === event.id);
223
- if (t) {
224
- t.status = event.status || t.status;
225
- t.content = event.content ?? t.content;
226
- const src = sourceFromToolEvent(t);
227
- if (isSuccessfulEvidenceTool(t) && src) recordSource(turn, src);
228
- }
229
- else turn.tools.push({ id: event.id, title: event.id, status: event.status || 'pending' });
230
- break;
231
- }
232
- case 'usage':
233
- turn.usage = event;
234
- break;
235
- case 'notice':
236
- if (event.message && !turn.notices.includes(event.message)) turn.notices.push(event.message);
237
- break;
238
- case 'context_continuation':
239
- if (event.packet) turn.continuation = event.packet;
240
- break;
241
- default:
242
- break;
243
- }
244
- return turn;
245
- }
246
-
247
- export function formatTurnUsageLine(usage, colors = {}) {
248
- return formatUsageFooter(usage, colors).replace(/^\[usage\] /, '');
249
- }
250
-
251
- export function finalizeTurn(turn, { evidenceVisible = true } = {}) {
252
- if (!turn) return turn;
253
- turn.closed = true;
254
- turn.evidence = deriveEvidenceVerdict({ ...turn, evidenceVisible });
255
- turn.sources = turn.evidence.records.map((record) => ({ tool: record.tool, ref: record.target, ts: Date.now() }));
256
- const msg = evidenceNotice(turn.evidence);
257
- if (msg) {
258
- if (!turn.notices.includes(msg)) turn.notices.push(msg);
259
- }
260
- return turn;
261
- }
262
-
263
- export function turnBlocksToLegacyTranscript(blocks = []) {
264
- const out = [];
265
- for (const item of blocks) {
266
- if (item.kind === 'legacy') {
267
- out.push({ role: 'construct', text: item.text });
268
- continue;
269
- }
270
- if (item.kind !== 'turn') continue;
271
- const t = item.block;
272
- out.push({ role: 'you', text: t.userText });
273
- if (t.thinking) out.push({ role: 'thinking', text: t.thinking });
274
- if (t.assistant) out.push({ role: 'construct', text: t.assistant });
275
- }
276
- return out;
277
- }
278
-
279
- export function shouldShowInspector({ uiInspector = 'off', turn = null, forced = null } = {}) {
280
- if (forced != null) return forced;
281
- const mode = uiInspector || 'off';
282
- if (mode === 'on') return true;
283
- return false;
284
- }
@@ -1,18 +0,0 @@
1
- /**
2
- * lib/chat/tui/turn-present.mjs — re-exports shared chat presenters for TUI.
3
- *
4
- * Implementation lives in lib/chat/present.mjs so Ink, linear, and web share
5
- * one formatting source.
6
- */
7
-
8
- export {
9
- summarizeToolCalls,
10
- summarizeSources,
11
- formatRefsInline,
12
- formatSourceToolCounts,
13
- contextRows,
14
- splitSourceLines,
15
- toolGroupLabel,
16
- formatRouteStrip,
17
- formatRouteLogLine,
18
- } from '../present.mjs';
@@ -1,88 +0,0 @@
1
- /**
2
- * lib/chat/tui/turn-state.mjs — pure turn-state reduction for chat renderers.
3
- *
4
- * Reduces normalized driver events into renderable turn state with no React import.
5
- * Shared by linear mode, owned-loop SSE fallback, and functional tests.
6
- */
7
-
8
- import { addUsage } from './usage.mjs';
9
- import { isVisible } from '../transparency.mjs';
10
-
11
- export function createTurnState() {
12
- return {
13
- assistant: '',
14
- thinking: '',
15
- tools: [],
16
- plan: [],
17
- route: [],
18
- permissions: [],
19
- error: null,
20
- rendered: false,
21
- stopReason: null,
22
- lastUsage: null,
23
- };
24
- }
25
-
26
- export function applyTurnEvent(state, event, { session = null } = {}) {
27
- switch (event?.type) {
28
- case 'text':
29
- state.assistant += event.text || '';
30
- state.rendered = true;
31
- break;
32
- case 'thinking':
33
- state.thinking += event.text || '';
34
- state.rendered = true;
35
- break;
36
- case 'plan':
37
- state.plan = Array.isArray(event.entries) ? event.entries : [];
38
- state.rendered = true;
39
- break;
40
- case 'tool_call': {
41
- state.tools.push({
42
- id: event.id,
43
- title: event.title || event.kind || 'tool',
44
- status: 'pending',
45
- input: event.input ?? null,
46
- });
47
- state.rendered = true;
48
- break;
49
- }
50
- case 'tool_update': {
51
- const existing = state.tools.find((t) => t.id === event.id);
52
- if (existing) existing.status = event.status || existing.status;
53
- else state.tools.push({ id: event.id, title: event.id || 'tool', status: event.status || 'pending' });
54
- state.rendered = true;
55
- break;
56
- }
57
- case 'usage':
58
- if (session) addUsage(session.usage, event);
59
- state.lastUsage = event;
60
- break;
61
- case 'permission': {
62
- const title = event.toolCall?.title || event.toolCall?.callID || 'tool';
63
- state.permissions.push({ title, detail: event.options?.length ? `${event.options.length} options` : 'decision' });
64
- state.rendered = true;
65
- break;
66
- }
67
- case 'error':
68
- state.error = event.message || 'error';
69
- state.rendered = true;
70
- break;
71
- case 'done':
72
- state.stopReason = event.stopReason || 'end_turn';
73
- break;
74
- default:
75
- break;
76
- }
77
- return state;
78
- }
79
-
80
- export async function runTurnInto(driver, text, opts, { session = null, layers = null, onUpdate = () => {} } = {}) {
81
- const state = createTurnState();
82
- for await (const event of driver.prompt(text, opts)) {
83
- if (layers && !isVisible(event, layers)) continue;
84
- applyTurnEvent(state, event, { session });
85
- onUpdate(state, event);
86
- }
87
- return state;
88
- }
@@ -1,122 +0,0 @@
1
- /**
2
- * lib/chat/tui/usage.mjs — truthful token/cost accounting for `construct chat`.
3
- *
4
- * Formats a single turn's usage event into a compact footer and accumulates usage
5
- * across a session for the `/usage` panel. Every field is optional and only printed
6
- * when the host actually reported it: there are no fabricated or estimated splits
7
- * (no-fabrication rule). `input` tokens are labeled "prompt" since, under the
8
- * delegate-the-loop model, that is the only honest "prompt section" the host exposes;
9
- * a per-specialist breakdown is shown only when the host emits per-sub-agent usage.
10
- */
11
-
12
- export function createSessionUsage() {
13
- return {
14
- turns: 0,
15
- tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, total: 0 },
16
- cost: { amount: 0, currency: 'USD' },
17
- bySubAgent: new Map(),
18
- history: [],
19
- };
20
- }
21
-
22
- function addInto(target, tokens = {}) {
23
- if (!target || typeof target !== 'object') return;
24
- for (const key of Object.keys(target)) {
25
- if (Number.isFinite(tokens[key])) target[key] += tokens[key];
26
- }
27
- }
28
-
29
- export function addUsage(session, event) {
30
- // A usage event must never crash a turn. Accept only a well-formed accumulator
31
- // (the shape from createSessionUsage); anything else — a stray session object, a
32
- // restored partial — is a safe no-op rather than a thrown error mid-stream.
33
- if (!session || !event || !session.tokens) return;
34
- session.turns = (session.turns || 0) + 1;
35
- addInto(session.tokens, event.tokens || {});
36
- if (event.cost && Number.isFinite(event.cost.amount) && session.cost) {
37
- session.cost.amount += event.cost.amount;
38
- if (event.cost.currency) session.cost.currency = event.cost.currency;
39
- }
40
- if (event.subAgent && event.tokens && session.bySubAgent?.get) {
41
- const prev = session.bySubAgent.get(event.subAgent) || { input: 0, output: 0, total: 0 };
42
- addInto(prev, event.tokens);
43
- session.bySubAgent.set(event.subAgent, prev);
44
- }
45
- if (Array.isArray(session.history)) {
46
- session.history.push({ tokens: event.tokens || null, cost: event.cost || null, model: event.model || null });
47
- }
48
- }
49
-
50
- export function formatTokens(n) {
51
- if (!Number.isFinite(n)) return null;
52
- if (n < 1000) return String(n);
53
- if (n < 1000000) return `${(n / 1000).toFixed(n < 10000 ? 1 : 0)}k`;
54
- return `${(n / 1000000).toFixed(1)}M`;
55
- }
56
-
57
- function formatCost(cost) {
58
- if (!cost || !Number.isFinite(cost.amount)) return null;
59
- if (cost.amount === 0) return '$0';
60
- const digits = cost.amount < 0.01 ? 4 : cost.amount < 1 ? 3 : 2;
61
- return `~$${cost.amount.toFixed(digits)}`;
62
- }
63
-
64
- // Builds an ordered list of "label value" parts from whatever the host reported.
65
-
66
- function usageParts(event) {
67
- const t = event.tokens || {};
68
- const parts = [];
69
- if (Number.isFinite(t.input)) parts.push(`prompt ${formatTokens(t.input)}`);
70
- if (Number.isFinite(t.output)) parts.push(`output ${formatTokens(t.output)}`);
71
- if (Number.isFinite(t.reasoning) && t.reasoning > 0) parts.push(`reasoning ${formatTokens(t.reasoning)}`);
72
- if (Number.isFinite(t.cacheRead) && t.cacheRead > 0) parts.push(`cache\u2193 ${formatTokens(t.cacheRead)}`);
73
- if (Number.isFinite(t.cacheWrite) && t.cacheWrite > 0) parts.push(`cache\u2191 ${formatTokens(t.cacheWrite)}`);
74
- if (Number.isFinite(t.total)) parts.push(`total ${formatTokens(t.total)}`);
75
- const cost = formatCost(event.cost);
76
- if (cost) parts.push(cost);
77
- if (event.context && Number.isFinite(event.context.used) && Number.isFinite(event.context.size)) {
78
- parts.push(`ctx ${formatTokens(event.context.used)}/${formatTokens(event.context.size)}`);
79
- }
80
- if (event.model) parts.push(`model ${event.model}`);
81
- return parts;
82
- }
83
-
84
- export function formatUsageFooter(event, colors = {}) {
85
- const dim = colors.dim || '';
86
- const reset = colors.reset || '';
87
- const parts = usageParts(event);
88
- if (!parts.length) return `${dim}[usage] (host reported no token counts)${reset}`;
89
- return `${dim}[usage] ${parts.join(' \u00b7 ')}${reset}`;
90
- }
91
-
92
- // Multi-line detailed panel for the `/usage` command: session totals, per-sub-agent
93
- // attribution when present, and a short per-turn history.
94
-
95
- export function formatUsagePanel(session, colors = {}) {
96
- const dim = colors.dim || '';
97
- const bold = colors.bold || '';
98
- const reset = colors.reset || '';
99
- const lines = [];
100
- lines.push(`${bold}session usage${reset} ${dim}(${session.turns} turn${session.turns === 1 ? '' : 's'})${reset}`);
101
-
102
- const t = session.tokens;
103
- const totalParts = [];
104
- if (t.input) totalParts.push(`prompt ${formatTokens(t.input)}`);
105
- if (t.output) totalParts.push(`output ${formatTokens(t.output)}`);
106
- if (t.reasoning) totalParts.push(`reasoning ${formatTokens(t.reasoning)}`);
107
- if (t.cacheRead) totalParts.push(`cache\u2193 ${formatTokens(t.cacheRead)}`);
108
- if (t.cacheWrite) totalParts.push(`cache\u2191 ${formatTokens(t.cacheWrite)}`);
109
- if (t.total) totalParts.push(`total ${formatTokens(t.total)}`);
110
- const cost = formatCost(session.cost);
111
- if (cost) totalParts.push(cost);
112
- lines.push(totalParts.length ? ` ${totalParts.join(' \u00b7 ')}` : ` ${dim}no token counts reported yet${reset}`);
113
-
114
- if (session.bySubAgent.size) {
115
- lines.push(`${dim} by sub-agent:${reset}`);
116
- for (const [name, st] of session.bySubAgent) {
117
- lines.push(` ${name}: prompt ${formatTokens(st.input)} \u00b7 output ${formatTokens(st.output)} \u00b7 total ${formatTokens(st.total)}`);
118
- }
119
- }
120
-
121
- return lines.join('\n');
122
- }
@@ -1,146 +0,0 @@
1
- /**
2
- * lib/chat/web-commands.mjs — slash-command handler for dashboard web chat.
3
- *
4
- * Mirrors lib/chat/commands.mjs without readline. Returns plain-text output
5
- * and optional side effects (clear, open picker) for the web cockpit.
6
- */
7
-
8
- import { HELP } from './commands.mjs';
9
- import { LAYER_KEYS, loadChatConfig } from './config.mjs';
10
- import { formatUsagePanel } from './tui/usage.mjs';
11
- import { applySessionSetting } from './session-settings.mjs';
12
- import { commitPickerModel } from './model-picker.mjs';
13
- import { resolveFreeOpenRouterModel } from '../../apps/chat/engine/models.mjs';
14
- import { exportTurns } from './export.mjs';
15
- import { readOracleDockState, formatOracleDockDetail } from '../intake/session-prelude.mjs';
16
- import { handleDemoCommand } from './demo-guide.mjs';
17
-
18
- export { HELP };
19
-
20
- export async function handleWebChatCommand(input, {
21
- runtime = null,
22
- cwd = process.cwd(),
23
- turnBlocks = [],
24
- version = null,
25
- } = {}) {
26
- const text = String(input || '').trim();
27
- if (!text.startsWith('/')) {
28
- return { ok: false, error: 'not a command' };
29
- }
30
-
31
- const [cmd, ...rest] = text.split(/\s+/);
32
- const arg = rest.join(' ').trim();
33
- const session = runtime?.session || {};
34
- const layers = runtime?.layers || {};
35
-
36
- switch (cmd) {
37
- case '/help': {
38
- const lines = ['commands'];
39
- for (const [name, desc] of HELP) lines.push(` ${name.padEnd(28)}${desc}`);
40
- return { ok: true, output: lines.join('\n') };
41
- }
42
-
43
- case '/host': {
44
- const mode = session.modelMode === 'free-router' ? 'free-router' : 'pinned';
45
- const lines = [
46
- `engine: construct (owned loop)${version ? ` (${version})` : ''} model: ${session.model || '(default)'} mode: ${mode}`,
47
- 'construct runs the loop itself; switch models with /model',
48
- ];
49
- return { ok: true, output: lines.join('\n') };
50
- }
51
-
52
- case '/models':
53
- case '/model':
54
- if (arg) {
55
- commitPickerModel(session, { mode: 'pinned', modelId: arg }, { cwd, layers });
56
- return { ok: true, output: `model set: ${arg} (pinned, saved)`, sessionMeta: true };
57
- }
58
- return { ok: true, picker: 'model' };
59
-
60
- case '/free': {
61
- const freeId = await resolveFreeOpenRouterModel({ env: runtime?.env || process.env, tier: 'standard' });
62
- if (!freeId) return { ok: true, output: 'OpenRouter free router needs OPENROUTER_API_KEY' };
63
- commitPickerModel(session, { mode: 'free-router', modelId: freeId }, { cwd, layers });
64
- return { ok: true, output: `model mode: free-router → ${freeId} (saved)`, sessionMeta: true };
65
- }
66
-
67
- case '/set':
68
- if (!rest.length) return { ok: true, picker: 'set' };
69
- return applySetCommand(session, layers, rest, { cwd });
70
-
71
- case '/settings': {
72
- const { config } = loadChatConfig({ cwd });
73
- const lines = [
74
- 'settings',
75
- ` model: ${session.modelMode === 'free-router' ? `free-router → ${session.model || '?'}` : (session.model || '(default)')}`,
76
- ` permission: ${session.permissionMode || config.permissionMode || 'allow_once'}`,
77
- ` sandbox: ${session.sandbox || config.sandbox || 'workspace-write'}`,
78
- ` layers: ${LAYER_KEYS.map((k) => `${k}=${layers[k] !== false ? 'on' : 'off'}`).join(' ')}`,
79
- ];
80
- return { ok: true, output: lines.join('\n') };
81
- }
82
-
83
- case '/layers':
84
- return {
85
- ok: true,
86
- output: [
87
- `layers: ${LAYER_KEYS.map((k) => `${k}=${layers[k] !== false ? 'on' : 'off'}`).join(' ')}`,
88
- 'toggle with: /set <layer> on|off',
89
- ].join('\n'),
90
- };
91
-
92
- case '/usage':
93
- return { ok: true, output: formatUsagePanel(session.usage || { turns: 0, tokens: {}, cost: { amount: 0 } }) };
94
-
95
- case '/oracle': {
96
- const state = readOracleDockState({ cwd, env: runtime?.env || process.env });
97
- return { ok: true, output: `oracle\n${formatOracleDockDetail(state)}` };
98
- }
99
-
100
- case '/export': {
101
- const scope = arg === 'session' ? 'session' : 'last';
102
- const result = exportTurns(turnBlocks, { scope, cwd });
103
- if (!result.ok) return { ok: true, output: result.error || 'export failed' };
104
- return { ok: true, output: `exported ${result.count} turn(s) to ${result.path}` };
105
- }
106
-
107
- case '/clear':
108
- return { ok: true, clear: true };
109
-
110
- case '/demo': {
111
- const guide = runtime?.session?.demoGuide;
112
- if (!guide) {
113
- return { ok: true, output: 'No active demo. Launch with `construct demo <name>` or set CONSTRUCT_DEMO.' };
114
- }
115
- const chunks = [];
116
- const output = { write: (text) => { chunks.push(String(text)); } };
117
- handleDemoCommand(arg, {
118
- demoGuide: guide,
119
- output,
120
- colors: { dim: '', reset: '', bold: '', green: '' },
121
- });
122
- return { ok: true, output: chunks.join('').trim() || 'demo command complete' };
123
- }
124
-
125
- case '/inspect':
126
- return { ok: true, output: 'inspector toggle is Ink-only; web shows full inline detail by default' };
127
-
128
- case '/exit':
129
- case '/quit':
130
- return { ok: true, output: 'exit is terminal-only — close the tab or navigate away' };
131
-
132
- default:
133
- return { ok: true, output: `unknown command: ${cmd} — try /help` };
134
- }
135
- }
136
-
137
- function applySetCommand(session, layers, rest, { cwd }) {
138
- const [key, ...valueParts] = rest;
139
- if (!key) return { ok: true, picker: 'set' };
140
- const rawValue = valueParts.join(' ').trim();
141
- if (!rawValue) return { ok: true, output: `usage: /set ${key} <on|off|value>` };
142
-
143
- const result = applySessionSetting(session, layers, key, rawValue, { cwd, hostId: 'construct' });
144
- if (!result.ok) return { ok: true, output: result.error || 'invalid setting' };
145
- return { ok: true, output: `${result.key}: ${result.value}`, sessionMeta: true, layers: { ...layers } };
146
- }