@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.
- package/README.md +7 -10
- package/bin/construct +235 -209
- package/bin/construct-postinstall.mjs +0 -21
- package/commands/work/optimize-prompts.md +1 -1
- package/examples/distribution/sources/adr.md +2 -2
- package/examples/seed-observations/decisions.md +1 -1
- package/lib/artifact-loop-core.mjs +412 -0
- package/lib/artifact-manifest.mjs +6 -0
- package/lib/artifact-release-gate.mjs +115 -49
- package/lib/audit-rules.mjs +2 -4
- package/lib/audit-skills.mjs +32 -20
- package/lib/audit-specialists.mjs +44 -26
- package/lib/auto-docs.mjs +6 -5
- package/lib/brand-prose.mjs +3 -3
- package/lib/brand-tokens.mjs +2 -2
- package/lib/certification/artifact-fixtures.mjs +4 -1
- package/lib/certification/demo-parity.mjs +6 -32
- package/lib/certification/real-llm-scenarios.mjs +58 -13
- package/lib/certification/role-cards.mjs +7 -6
- package/lib/certification/role-overlays.mjs +4 -4
- package/lib/certification/runner.mjs +9 -2
- package/lib/certification/skill-inventory.mjs +34 -22
- package/lib/certification/skill-scenarios.mjs +21 -8
- package/lib/certification/specialist-contracts.mjs +4 -3
- package/lib/certification/specialist-scenarios.mjs +7 -6
- package/lib/certification/status.mjs +5 -4
- package/lib/cli-commands.mjs +55 -54
- package/lib/comment-lint.mjs +1 -5
- package/lib/completions.mjs +20 -2
- package/lib/config/legacy-config-migration.mjs +90 -24
- package/lib/config/schema.mjs +5 -5
- package/lib/config/source-targets.mjs +80 -0
- package/lib/contracts/validate.mjs +119 -51
- package/lib/decisions/golden.mjs +3 -2
- package/lib/decisions/registry.mjs +11 -6
- package/lib/demo-project.mjs +188 -0
- package/lib/demo-recording.mjs +9 -34
- package/lib/demo-script.mjs +2 -2
- package/lib/demo-surface.mjs +13 -131
- package/lib/demo-tour-renderer.mjs +92 -0
- package/lib/demo.mjs +69 -54
- package/lib/diagram-export.mjs +63 -14
- package/lib/doctor/source-checkout.mjs +3 -4
- package/lib/doctor/watchers/consistency.mjs +90 -22
- package/lib/doctor/watchers/credential-parity.mjs +97 -0
- package/lib/doctor/watchers/mcp-protocol.mjs +1 -1
- package/lib/doctor/watchers/service-health.mjs +4 -32
- package/lib/document-export.mjs +73 -9
- package/lib/document-extract.mjs +10 -198
- package/lib/embed/artifact.mjs +2 -3
- package/lib/embed/cli.mjs +1 -1
- package/lib/embed/config.mjs +1 -2
- package/lib/embed/customer-profiles.mjs +1 -1
- package/lib/embed/daemon.mjs +5 -6
- package/lib/embed/demand-fetch.mjs +114 -2
- package/lib/embed/docs-lifecycle.mjs +9 -5
- package/lib/embed/intake-metrics.mjs +2 -2
- package/lib/embed/notifications.mjs +2 -3
- package/lib/embed/recommendation-store.mjs +25 -22
- package/lib/embed/role-framing.mjs +4 -9
- package/lib/embedded-contract/capability.mjs +4 -2
- package/lib/embedded-contract/contract-version.mjs +1 -1
- package/lib/env-config.mjs +2 -2
- package/lib/flavors/loader.mjs +21 -19
- package/lib/graph/build-from-registry.mjs +31 -7
- package/lib/graph/staleness.mjs +1 -1
- package/lib/headhunt.mjs +82 -35
- package/lib/hooks/agent-tracker.mjs +2 -2
- package/lib/hooks/config-protection.mjs +1 -1
- package/lib/hooks/registry-sync.mjs +3 -3
- package/lib/host-capabilities.mjs +5 -5
- package/lib/improvement/controller.mjs +2 -2
- package/lib/init-unified.mjs +19 -21
- package/lib/intake/classify.mjs +26 -0
- package/lib/intake/daemon.mjs +2 -3
- package/lib/intake/prepare.mjs +10 -3
- package/lib/intake/session-prelude.mjs +1 -1
- package/lib/intake/tables/creative.mjs +9 -9
- package/lib/intake/tables/operations.mjs +4 -4
- package/lib/intake/tables/research.mjs +2 -2
- package/lib/integrations/intake-integrations.mjs +9 -10
- package/lib/knowledge/research-store.mjs +2 -2
- package/lib/mcp/server.mjs +104 -61
- package/lib/mcp/tool-budget.mjs +1 -46
- package/lib/mcp/tool-recovery.mjs +44 -0
- package/lib/mcp/tools/artifact-author.mjs +36 -0
- package/lib/mcp/tools/find-tool.mjs +86 -0
- package/lib/mcp/tools/orchestration-run.mjs +107 -69
- package/lib/mcp/tools/project.mjs +4 -3
- package/lib/mcp/tools/{profile.mjs → scope.mjs} +54 -52
- package/lib/mcp/tools/skills.mjs +39 -22
- package/lib/mcp/tools/telemetry.mjs +2 -1
- package/lib/mcp/tools/workflow.mjs +1 -1
- package/lib/mcp-platform-config.mjs +7 -5
- package/lib/migrations/index.mjs +4 -2
- package/lib/migrations/v2-unified-registry.mjs +35 -0
- package/lib/model-router.mjs +203 -36
- package/lib/models/catalog.mjs +25 -9
- package/lib/models/execution-capability-profile.mjs +3 -3
- package/lib/models/execution-policy.mjs +7 -6
- package/lib/models/provider-poll.mjs +18 -4
- package/lib/opencode-config.mjs +56 -1
- package/lib/opencode-runtime-plugin.mjs +13 -10
- package/lib/oracle/artifact-gate.mjs +14 -4
- package/lib/oracle/cli.mjs +2 -0
- package/lib/oracle/dispatch.mjs +18 -1
- package/lib/oracle/execute.mjs +39 -7
- package/lib/oracle/index.mjs +1 -1
- package/lib/oracle/org-graph.mjs +10 -5
- package/lib/oracle/policy.mjs +6 -0
- package/lib/oracle/read-model.mjs +103 -6
- package/lib/oracle/reconcile.mjs +31 -4
- package/lib/oracle/remediation-dispatch.mjs +53 -0
- package/lib/oracle/routing.mjs +5 -0
- package/lib/oracle/synthesize.mjs +80 -3
- package/lib/orchestration/routing-tables.mjs +44 -10
- package/lib/orchestration/runtime.mjs +2 -0
- package/lib/orchestration/worker.mjs +1 -1
- package/lib/orchestration-policy.mjs +351 -62
- package/lib/overrides/resolver.mjs +1 -12
- package/lib/parity.mjs +37 -11
- package/lib/policy/engine.mjs +80 -15
- package/lib/prompt-composer.js +51 -15
- package/lib/prompt-metadata.mjs +3 -2
- package/lib/providers/connection-probe.mjs +58 -0
- package/lib/providers/copilot-auth.mjs +1 -1
- package/lib/providers/credential-bootstrap.mjs +1 -1
- package/lib/providers/op-run.mjs +3 -4
- package/lib/providers/secret-resolver.mjs +31 -0
- package/lib/publish-tooling.mjs +3 -11
- package/lib/publish.mjs +12 -29
- package/lib/reconcile/mcp-entry-reconcile.mjs +14 -9
- package/lib/reflect.mjs +2 -2
- package/lib/registry/agent-manifest.mjs +190 -0
- package/lib/registry/assemble.mjs +133 -0
- package/lib/registry/catalog.mjs +171 -0
- package/lib/registry/cli.mjs +590 -6
- package/lib/registry/consolidation.mjs +5 -4
- package/lib/registry/docs-sync.mjs +67 -0
- package/lib/registry/loader.mjs +147 -0
- package/lib/registry/org-io.mjs +76 -0
- package/lib/registry/retired-paths.mjs +71 -0
- package/lib/registry/surface-map.mjs +5 -7
- package/lib/registry/validator.mjs +438 -0
- package/lib/research-execution-policy.mjs +173 -0
- package/lib/roles/catalog.mjs +4 -9
- package/lib/roles/fence.mjs +107 -1
- package/lib/roles/flavor-bindings.mjs +68 -0
- package/lib/roles/gateway.mjs +140 -29
- package/lib/roles/manifest.mjs +22 -13
- package/lib/roles/router.mjs +1 -1
- package/lib/scopes/enrich.mjs +67 -0
- package/lib/scopes/hooks.mjs +12 -0
- package/lib/{profiles → scopes}/lifecycle.mjs +70 -70
- package/lib/scopes/loader.mjs +104 -0
- package/lib/scopes/rebrand.mjs +32 -0
- package/lib/scopes/research-profile.mjs +16 -0
- package/lib/scopes/teams.mjs +98 -0
- package/lib/service-manager.mjs +1 -117
- package/lib/setup-prompts.mjs +1 -1
- package/lib/setup.mjs +6 -26
- package/lib/skills/composition-graph.mjs +98 -0
- package/lib/skills/router.mjs +80 -0
- package/lib/specialist-contracts.mjs +17 -18
- package/lib/specialists/postconditions.mjs +2 -2
- package/lib/specialists/prompt-schema.mjs +6 -5
- package/lib/specialists/roster.mjs +7 -12
- package/lib/specialists/schema.mjs +9 -6
- package/lib/status.mjs +25 -90
- package/lib/storage/file-lock.mjs +6 -3
- package/lib/telemetry/skill-calls.mjs +1 -1
- package/lib/templates/doc-presentation.mjs +63 -0
- package/lib/templates/visual-requirements.mjs +35 -2
- package/lib/term-format.mjs +107 -2
- package/lib/test-env-setup.mjs +21 -0
- package/lib/ui/components.mjs +42 -0
- package/lib/ui/glyphs.mjs +58 -0
- package/lib/ui/links.mjs +115 -0
- package/lib/ui/theme.mjs +108 -0
- package/lib/uninstall/uninstall.mjs +2 -1
- package/lib/validator.mjs +45 -8
- package/lib/validators/skill-effectiveness.mjs +174 -0
- package/lib/validators/skills.mjs +1 -1
- package/package.json +12 -8
- package/personas/construct.md +12 -3
- package/platforms/claude/CLAUDE.md +1 -1
- package/rules/common/beads-hygiene.md +52 -0
- package/rules/common/neurodivergent-output.md +4 -7
- package/rules/common/research.md +2 -0
- package/scripts/sync-specialists.mjs +260 -49
- package/skills/ai/prompt-optimizer.md +3 -3
- package/skills/brand/output-vibe.md +48 -0
- package/skills/docs/adr-workflow.md +3 -0
- package/skills/docs/backlog-proposal-workflow.md +3 -0
- package/skills/docs/codebase-research-workflow.md +5 -2
- package/skills/docs/customer-profile-workflow.md +3 -0
- package/skills/docs/document-ingest-workflow.md +3 -0
- package/skills/docs/evidence-ingest-workflow.md +4 -1
- package/skills/docs/init-project.md +1 -1
- package/skills/docs/prd-workflow.md +1 -1
- package/skills/docs/prfaq-workflow.md +3 -0
- package/skills/docs/product-intelligence-workflow.md +4 -1
- package/skills/docs/product-signal-workflow.md +3 -0
- package/skills/docs/research-workflow.md +13 -6
- package/skills/docs/runbook-workflow.md +3 -0
- package/skills/docs/strategy-workflow.md +3 -0
- package/skills/docs/user-research-workflow.md +6 -3
- package/skills/operating/orchestration-reference.md +1 -1
- package/skills/roles/{engineer.ai.md → ai-engineer.md} +2 -2
- package/skills/roles/architect.ai-systems.md +1 -1
- package/skills/roles/architect.data.md +1 -1
- package/skills/roles/architect.enterprise.md +1 -1
- package/skills/roles/architect.integration.md +1 -1
- package/skills/roles/architect.md +1 -1
- package/skills/roles/architect.platform.md +1 -1
- package/skills/roles/{product-manager.business-strategy.md → business-strategist.md} +3 -3
- package/skills/roles/data-analyst.experiment.md +1 -1
- package/skills/roles/data-analyst.md +1 -1
- package/skills/roles/data-analyst.product-intelligence.md +1 -1
- package/skills/roles/data-analyst.product.md +1 -1
- package/skills/roles/data-analyst.telemetry.md +1 -1
- package/skills/roles/{engineer.data.md → data-engineer.md} +2 -2
- package/skills/roles/data-engineer.pipeline.md +2 -2
- package/skills/roles/data-engineer.vector-retrieval.md +2 -2
- package/skills/roles/data-engineer.warehouse.md +2 -2
- package/skills/roles/debugger.md +1 -1
- package/skills/roles/designer.accessibility.md +1 -1
- package/skills/roles/designer.md +1 -1
- package/skills/roles/{reviewer.devil-advocate.md → devil-advocate.md} +2 -2
- package/skills/roles/{operator.docs.md → docs-keeper.md} +3 -3
- package/skills/roles/engineer.md +3 -7
- package/skills/roles/{reviewer.evaluator.md → evaluator.md} +2 -2
- package/skills/roles/{researcher.explorer.md → explorer.md} +2 -2
- package/skills/roles/{operator.md → operations.md} +2 -5
- package/skills/roles/orchestrator.md +1 -1
- package/skills/roles/{engineer.platform.md → platform-engineer.md} +2 -2
- package/skills/roles/product-manager.ai-product.md +1 -1
- package/skills/roles/product-manager.enterprise.md +1 -1
- package/skills/roles/product-manager.growth.md +1 -2
- package/skills/roles/product-manager.md +1 -2
- package/skills/roles/product-manager.platform.md +1 -1
- package/skills/roles/product-manager.product.md +1 -1
- package/skills/roles/qa.ai-eval.md +1 -1
- package/skills/roles/qa.api-contract.md +1 -1
- package/skills/roles/qa.data-pipeline.md +1 -1
- package/skills/roles/qa.md +1 -1
- package/skills/roles/qa.web-ui.md +1 -1
- package/skills/roles/{operator.release.md → release-manager.md} +3 -3
- package/skills/roles/researcher.md +1 -1
- package/skills/roles/reviewer.md +1 -1
- package/skills/roles/security.ai.md +1 -1
- package/skills/roles/security.appsec.md +1 -1
- package/skills/roles/security.cloud.md +1 -1
- package/skills/roles/security.legal-compliance.md +1 -1
- package/skills/roles/security.md +1 -1
- package/skills/roles/security.privacy.md +1 -1
- package/skills/roles/security.supply-chain.md +1 -1
- package/skills/roles/{operator.sre.md → sre.md} +3 -3
- package/skills/roles/{qa.test-automation.md → test-automation.md} +2 -2
- package/skills/roles/{reviewer.trace.md → trace-reviewer.md} +2 -2
- package/skills/roles/{researcher.ux.md → ux-researcher.md} +2 -2
- package/skills/routing.json +18 -0
- package/skills/routing.md +1 -1
- package/specialists/artifact-manifest.json +2 -1
- package/specialists/audit-enrichments.json +14 -14
- package/specialists/org/contracts/accessibility-to-qa.json +37 -0
- package/specialists/org/contracts/any-to-business-strategist.json +57 -0
- package/specialists/org/contracts/any-to-debugger.json +38 -0
- package/specialists/org/contracts/any-to-designer.json +33 -0
- package/specialists/org/contracts/any-to-docs-keeper.json +34 -0
- package/specialists/org/contracts/any-to-explorer.json +39 -0
- package/specialists/org/contracts/any-to-sre-incident.json +33 -0
- package/specialists/org/contracts/any-to-trace-reviewer.json +32 -0
- package/specialists/org/contracts/architect-to-ai-engineer.json +32 -0
- package/specialists/org/contracts/architect-to-data-engineer.json +52 -0
- package/specialists/org/contracts/architect-to-devil-advocate.json +38 -0
- package/specialists/org/contracts/architect-to-engineer.json +34 -0
- package/specialists/org/contracts/architect-to-evaluator.json +59 -0
- package/specialists/org/contracts/architect-to-legal-compliance.json +55 -0
- package/specialists/org/contracts/architect-to-operations.json +45 -0
- package/specialists/org/contracts/architect-to-platform-engineer.json +42 -0
- package/specialists/org/contracts/business-strategist-to-product-manager.json +39 -0
- package/specialists/org/contracts/construct-to-orchestrator.json +36 -0
- package/specialists/org/contracts/construct-to-rd-lead.json +53 -0
- package/specialists/org/contracts/data-analyst-to-product-manager.json +43 -0
- package/specialists/org/contracts/data-engineer-to-platform-engineer.json +36 -0
- package/specialists/org/contracts/designer-to-accessibility.json +36 -0
- package/specialists/org/contracts/engineer-to-qa.json +34 -0
- package/specialists/org/contracts/engineer-to-reviewer.json +52 -0
- package/specialists/org/contracts/explorer-to-engineer.json +38 -0
- package/specialists/org/contracts/legal-compliance-to-release-manager.json +43 -0
- package/specialists/org/contracts/platform-engineer-to-engineer.json +31 -0
- package/specialists/org/contracts/product-manager-to-architect.json +71 -0
- package/specialists/org/contracts/product-manager-to-data-analyst.json +49 -0
- package/specialists/org/contracts/product-manager-to-ux-researcher.json +51 -0
- package/specialists/org/contracts/qa-to-release-manager.json +42 -0
- package/specialists/org/contracts/qa-to-test-automation.json +42 -0
- package/specialists/org/contracts/rd-lead-to-architect.json +38 -0
- package/specialists/org/contracts/researcher-to-architect.json +40 -0
- package/specialists/org/contracts/researcher-to-product-manager.json +57 -0
- package/specialists/org/contracts/reviewer-to-security.json +41 -0
- package/specialists/org/contracts/sre-to-release-manager.json +36 -0
- package/specialists/org/contracts/test-automation-to-engineer.json +34 -0
- package/specialists/org/contracts/trace-reviewer-to-sre.json +41 -0
- package/specialists/org/contracts/user-to-construct.json +30 -0
- package/specialists/org/groups/engineering-group.json +43 -0
- package/specialists/org/groups/governance-group.json +38 -0
- package/specialists/org/groups/operations-group.json +41 -0
- package/specialists/org/groups/product-group.json +46 -0
- package/specialists/org/groups/quality-group.json +42 -0
- package/specialists/org/groups/strategy-group.json +41 -0
- package/specialists/org/policies/action-approval.json +13 -0
- package/specialists/org/policies/agents-routing.json +13 -0
- package/specialists/org/policies/architecture.json +20 -0
- package/specialists/org/policies/bash-safety.json +13 -0
- package/specialists/org/policies/beads-hygiene.json +13 -0
- package/specialists/org/policies/bootstrap-state.json +13 -0
- package/specialists/org/policies/code-review.json +13 -0
- package/specialists/org/policies/coding-style.json +13 -0
- package/specialists/org/policies/comments.json +13 -0
- package/specialists/org/policies/commit-approval.json +13 -0
- package/specialists/org/policies/contract-preconditions.json +13 -0
- package/specialists/org/policies/deployment.json +20 -0
- package/specialists/org/policies/description.json +14 -0
- package/specialists/org/policies/design-approval.json +19 -0
- package/specialists/org/policies/doc-ownership.json +13 -0
- package/specialists/org/policies/file-path-fence.json +13 -0
- package/specialists/org/policies/framing.json +13 -0
- package/specialists/org/policies/git-workflow.json +13 -0
- package/specialists/org/policies/incident-response.json +15 -0
- package/specialists/org/policies/intake-triage.json +15 -0
- package/specialists/org/policies/neurodivergent-output.json +13 -0
- package/specialists/org/policies/no-fabrication.json +13 -0
- package/specialists/org/policies/patterns.json +13 -0
- package/specialists/org/policies/quality-gate-approval.json +17 -0
- package/specialists/org/policies/release-gates.json +13 -0
- package/specialists/org/policies/research-evidence.json +13 -0
- package/specialists/org/policies/review-before-change.json +13 -0
- package/specialists/org/policies/rollback.json +15 -0
- package/specialists/org/policies/scope-change.json +20 -0
- package/specialists/org/policies/secret-scan.json +13 -0
- package/specialists/org/policies/security-approval.json +17 -0
- package/specialists/org/policies/security.json +13 -0
- package/specialists/org/policies/session-efficiency.json +13 -0
- package/specialists/org/policies/skill-routing.json +13 -0
- package/specialists/org/policies/strategic-prioritization.json +17 -0
- package/specialists/org/policies/testing.json +13 -0
- package/specialists/org/policies/tool-invisibility.json +14 -0
- package/specialists/org/scopes/creative.json +54 -0
- package/specialists/org/scopes/operations.json +51 -0
- package/specialists/org/scopes/research.json +60 -0
- package/specialists/org/scopes/rnd.json +81 -0
- package/specialists/org/specialists/cx-accessibility.json +69 -0
- package/specialists/org/specialists/cx-ai-engineer.json +75 -0
- package/specialists/org/specialists/cx-architect.json +89 -0
- package/specialists/org/specialists/cx-business-strategist.json +72 -0
- package/specialists/org/specialists/cx-data-analyst.json +68 -0
- package/specialists/org/specialists/cx-data-engineer.json +71 -0
- package/specialists/org/specialists/cx-debugger.json +75 -0
- package/specialists/org/specialists/cx-designer.json +85 -0
- package/specialists/org/specialists/cx-devil-advocate.json +71 -0
- package/specialists/org/specialists/cx-docs-keeper.json +82 -0
- package/specialists/org/specialists/cx-engineer.json +106 -0
- package/specialists/org/specialists/cx-evaluator.json +69 -0
- package/specialists/org/specialists/cx-explorer.json +69 -0
- package/specialists/org/specialists/cx-legal-compliance.json +74 -0
- package/specialists/org/specialists/cx-operations.json +72 -0
- package/specialists/org/specialists/cx-oracle.json +46 -0
- package/specialists/org/specialists/cx-orchestrator.json +81 -0
- package/specialists/org/specialists/cx-platform-engineer.json +80 -0
- package/specialists/org/specialists/cx-product-manager.json +102 -0
- package/specialists/org/specialists/cx-qa.json +79 -0
- package/specialists/org/specialists/cx-rd-lead.json +73 -0
- package/specialists/org/specialists/cx-release-manager.json +77 -0
- package/specialists/org/specialists/cx-researcher.json +82 -0
- package/specialists/org/specialists/cx-reviewer.json +71 -0
- package/specialists/org/specialists/cx-security.json +91 -0
- package/specialists/org/specialists/cx-sre.json +94 -0
- package/specialists/org/specialists/cx-test-automation.json +69 -0
- package/specialists/org/specialists/cx-trace-reviewer.json +69 -0
- package/specialists/org/specialists/cx-ux-researcher.json +68 -0
- package/specialists/org/teams/accessibility-team.json +39 -0
- package/specialists/org/teams/design-team.json +40 -0
- package/specialists/org/teams/engineering-team.json +50 -0
- package/specialists/org/teams/governance-team.json +41 -0
- package/specialists/org/teams/operations-team.json +46 -0
- package/specialists/org/teams/product-management-team.json +45 -0
- package/specialists/org/teams/quality-team.json +49 -0
- package/specialists/org/teams/research-team.json +39 -0
- package/specialists/org/teams/strategy-team.json +48 -0
- package/specialists/org/teams/ux-research-team.json +39 -0
- package/specialists/prompts/_shared/validation-contract.md +1 -1
- package/specialists/prompts/_team-template.md +10 -0
- package/specialists/prompts/cx-accessibility.md +1 -0
- package/specialists/prompts/cx-ai-engineer.md +1 -1
- package/specialists/prompts/cx-business-strategist.md +1 -1
- package/specialists/prompts/cx-data-engineer.md +1 -1
- package/specialists/prompts/cx-designer.md +1 -0
- package/specialists/prompts/cx-devil-advocate.md +1 -1
- package/specialists/prompts/cx-docs-keeper.md +1 -1
- package/specialists/prompts/cx-evaluator.md +1 -1
- package/specialists/prompts/cx-explorer.md +1 -1
- package/specialists/prompts/cx-operations.md +1 -1
- package/specialists/prompts/cx-oracle.md +7 -3
- package/specialists/prompts/cx-orchestrator.md +17 -1
- package/specialists/prompts/cx-platform-engineer.md +1 -1
- package/specialists/prompts/cx-product-manager.md +2 -0
- package/specialists/prompts/cx-release-manager.md +1 -1
- package/specialists/prompts/cx-researcher.md +7 -4
- package/specialists/prompts/cx-sre.md +1 -1
- package/specialists/prompts/cx-test-automation.md +2 -2
- package/specialists/prompts/cx-trace-reviewer.md +3 -3
- package/specialists/prompts/cx-ux-researcher.md +2 -1
- package/templates/demos/scripts/architecture-review-adr.json +30 -0
- package/templates/demos/scripts/capability-contract.json +25 -0
- package/templates/demos/scripts/intake-triage.json +25 -0
- package/templates/demos/scripts/profile-doctor-health.json +25 -0
- package/templates/demos/tapes/agentic-platforms-prd.tape +2 -2
- package/templates/demos/tapes/architecture-review-adr.tape +44 -0
- package/templates/demos/tapes/capability-contract.tape +39 -0
- package/templates/demos/tapes/intake-triage.tape +39 -0
- package/templates/demos/tapes/profile-doctor-health.tape +39 -0
- package/templates/distribution/construct-brand.typ +23 -18
- package/templates/distribution/construct-decision.typ +1 -1
- package/templates/distribution/construct-pdf.typ +1 -1
- package/templates/distribution/construct-prd.typ +1 -1
- package/templates/distribution/construct-research.typ +1 -1
- package/templates/distribution/mermaid-puppeteer.json +8 -0
- package/templates/docs/persona-artifact.md +1 -1
- package/templates/docs/prd.md +6 -0
- package/apps/chat/engine/ai-sdk-agent.mjs +0 -183
- package/apps/chat/engine/loop-driver.mjs +0 -211
- package/apps/chat/engine/models.mjs +0 -122
- package/apps/chat/engine/provider-adapters.mjs +0 -171
- package/apps/chat/engine/tools/permission.mjs +0 -54
- package/apps/chat/engine/tools/primitives.mjs +0 -180
- package/apps/chat/engine/tools/registry.mjs +0 -122
- package/apps/chat/engine/turn-controls.mjs +0 -70
- package/lib/boundary.mjs +0 -127
- package/lib/certification/dashboard-api.mjs +0 -71
- package/lib/chat/cli.mjs +0 -333
- package/lib/chat/command-suggest.mjs +0 -161
- package/lib/chat/commands.mjs +0 -215
- package/lib/chat/config.mjs +0 -142
- package/lib/chat/context-compactor.mjs +0 -250
- package/lib/chat/context-continuation.mjs +0 -253
- package/lib/chat/continuation-source.mjs +0 -58
- package/lib/chat/demo-guide.mjs +0 -61
- package/lib/chat/design-tokens.mjs +0 -91
- package/lib/chat/desktop-binary.mjs +0 -81
- package/lib/chat/desktop-build.mjs +0 -130
- package/lib/chat/desktop-launcher.mjs +0 -133
- package/lib/chat/evidence.mjs +0 -145
- package/lib/chat/export.mjs +0 -74
- package/lib/chat/harness/driver.mjs +0 -91
- package/lib/chat/list-picker.mjs +0 -112
- package/lib/chat/model-picker.mjs +0 -356
- package/lib/chat/openrouter-fallback.mjs +0 -151
- package/lib/chat/permission-prompt.mjs +0 -33
- package/lib/chat/picker-catalog.mjs +0 -45
- package/lib/chat/policy-telemetry.mjs +0 -34
- package/lib/chat/present.mjs +0 -246
- package/lib/chat/session-context.mjs +0 -39
- package/lib/chat/session-persist.mjs +0 -73
- package/lib/chat/session-restore.mjs +0 -71
- package/lib/chat/session-settings.mjs +0 -53
- package/lib/chat/system-prompt.mjs +0 -52
- package/lib/chat/transparency.mjs +0 -93
- package/lib/chat/tui/color-scheme.mjs +0 -42
- package/lib/chat/tui/markdown.mjs +0 -123
- package/lib/chat/tui/presentation.mjs +0 -100
- package/lib/chat/tui/render.mjs +0 -500
- package/lib/chat/tui/turn-block.mjs +0 -284
- package/lib/chat/tui/turn-present.mjs +0 -18
- package/lib/chat/tui/turn-state.mjs +0 -88
- package/lib/chat/tui/usage.mjs +0 -122
- package/lib/chat/web-commands.mjs +0 -146
- package/lib/chat/web-launcher.mjs +0 -63
- package/lib/chat/web-picker-keys.mjs +0 -46
- package/lib/chat/web-session.mjs +0 -159
- package/lib/config/alias.mjs +0 -57
- package/lib/dashboard-demo.mjs +0 -71
- package/lib/dashboard-static.mjs +0 -175
- package/lib/install/desktop-binary-download.mjs +0 -88
- package/lib/profiles/loader.mjs +0 -123
- package/lib/profiles/rebrand.mjs +0 -46
- package/lib/server/auth.mjs +0 -169
- package/lib/server/chat-loop.mjs +0 -622
- package/lib/server/chat.mjs +0 -336
- package/lib/server/cors.mjs +0 -77
- package/lib/server/csrf.mjs +0 -103
- package/lib/server/demo-preview.mjs +0 -63
- package/lib/server/index.mjs +0 -2641
- package/lib/server/insights.mjs +0 -780
- package/lib/server/langfuse-login.mjs +0 -58
- package/lib/server/rate-limit.mjs +0 -93
- package/lib/server/telemetry-login.mjs +0 -100
- package/lib/server/webhook.mjs +0 -512
- package/specialists/contracts.json +0 -1032
- package/specialists/contracts.schema.json +0 -83
- package/specialists/policy-inventory.json +0 -188
- package/specialists/registry.json +0 -1412
- package/specialists/role-manifests.json +0 -217
- 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
|
-
}
|
package/lib/chat/tui/usage.mjs
DELETED
|
@@ -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
|
-
}
|