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