@llipe.com/dev-tasks 0.6.6 → 0.7.3
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/.claude/agents/developer.md +2 -0
- package/.claude/commands/developer.md +2 -0
- package/.claude/commands/planner.md +2 -0
- package/.claude/commands/product-engineer.md +13 -7
- package/.claude/skills/activity-init/SKILL.md +81 -8
- package/.github/agents/developer.agent.md +2 -0
- package/.github/agents/planner.agent.md +2 -0
- package/.github/agents/product-engineer.agent.md +13 -7
- package/.github/prompts/product-engineer-init.prompt.md +7 -1
- package/.github/skills/activity-init/SKILL.md +81 -8
- package/.kiro/agents/developer.md +2 -0
- package/.kiro/agents/planner.md +2 -0
- package/.kiro/agents/product-engineer.md +13 -7
- package/.kiro/skills/activity-init/SKILL.md +81 -8
- package/AGENTS.md +96 -1
- package/CHANGELOG.md +96 -0
- package/README.md +288 -632
- package/dist/adapters/cli/catalog-build.d.ts +30 -0
- package/dist/adapters/cli/catalog-build.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-build.js +73 -0
- package/dist/adapters/cli/catalog-build.js.map +1 -0
- package/dist/adapters/cli/catalog-query.d.ts +13 -0
- package/dist/adapters/cli/catalog-query.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-query.js +329 -0
- package/dist/adapters/cli/catalog-query.js.map +1 -0
- package/dist/adapters/cli/catalog-scaffold.d.ts +24 -0
- package/dist/adapters/cli/catalog-scaffold.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-scaffold.js +46 -0
- package/dist/adapters/cli/catalog-scaffold.js.map +1 -0
- package/dist/adapters/cli/catalog-validate.d.ts +35 -0
- package/dist/adapters/cli/catalog-validate.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-validate.js +122 -0
- package/dist/adapters/cli/catalog-validate.js.map +1 -0
- package/dist/adapters/cli/ctx-assemble.d.ts +19 -0
- package/dist/adapters/cli/ctx-assemble.d.ts.map +1 -0
- package/dist/adapters/cli/ctx-assemble.js +293 -0
- package/dist/adapters/cli/ctx-assemble.js.map +1 -0
- package/dist/adapters/cli/ctx-fetch.d.ts +49 -0
- package/dist/adapters/cli/ctx-fetch.d.ts.map +1 -0
- package/dist/adapters/cli/ctx-fetch.js +267 -0
- package/dist/adapters/cli/ctx-fetch.js.map +1 -0
- package/dist/adapters/cli/extract-all.d.ts +2 -2
- package/dist/adapters/cli/extract-all.d.ts.map +1 -1
- package/dist/adapters/cli/extract-all.js.map +1 -1
- package/dist/adapters/cli/extract-component.d.ts +2 -2
- package/dist/adapters/cli/extract-component.d.ts.map +1 -1
- package/dist/adapters/cli/extract-component.js.map +1 -1
- package/dist/adapters/cli/init.d.ts +37 -0
- package/dist/adapters/cli/init.d.ts.map +1 -0
- package/dist/adapters/cli/init.js +336 -0
- package/dist/adapters/cli/init.js.map +1 -0
- package/dist/adapters/cli/scope-gate.d.ts +25 -0
- package/dist/adapters/cli/scope-gate.d.ts.map +1 -0
- package/dist/adapters/cli/scope-gate.js +157 -0
- package/dist/adapters/cli/scope-gate.js.map +1 -0
- package/dist/adapters/cli/scope.d.ts +26 -0
- package/dist/adapters/cli/scope.d.ts.map +1 -0
- package/dist/adapters/cli/scope.js +172 -0
- package/dist/adapters/cli/scope.js.map +1 -0
- package/dist/adapters/cli/validate-component.d.ts +24 -0
- package/dist/adapters/cli/validate-component.d.ts.map +1 -0
- package/dist/adapters/cli/validate-component.js +62 -0
- package/dist/adapters/cli/validate-component.js.map +1 -0
- package/dist/adapters/cli/verify-contract-diff.d.ts +21 -0
- package/dist/adapters/cli/verify-contract-diff.d.ts.map +1 -0
- package/dist/adapters/cli/verify-contract-diff.js +69 -0
- package/dist/adapters/cli/verify-contract-diff.js.map +1 -0
- package/dist/adapters/cli/verify-drift.d.ts +24 -0
- package/dist/adapters/cli/verify-drift.d.ts.map +1 -0
- package/dist/adapters/cli/verify-drift.js +103 -0
- package/dist/adapters/cli/verify-drift.js.map +1 -0
- package/dist/adapters/cli/verify-impact.d.ts +23 -0
- package/dist/adapters/cli/verify-impact.d.ts.map +1 -0
- package/dist/adapters/cli/verify-impact.js +119 -0
- package/dist/adapters/cli/verify-impact.js.map +1 -0
- package/dist/bin/dev-tasks.d.ts +1 -1
- package/dist/bin/dev-tasks.js +28 -6
- package/dist/bin/dev-tasks.js.map +1 -1
- package/dist/bin/dt.js +488 -0
- package/dist/bin/dt.js.map +1 -1
- package/dist/core/catalog/build.d.ts +143 -0
- package/dist/core/catalog/build.d.ts.map +1 -0
- package/dist/core/catalog/build.js +475 -0
- package/dist/core/catalog/build.js.map +1 -0
- package/dist/core/catalog/checks/index.d.ts +18 -0
- package/dist/core/catalog/checks/index.d.ts.map +1 -0
- package/dist/core/catalog/checks/index.js +18 -0
- package/dist/core/catalog/checks/index.js.map +1 -0
- package/dist/core/catalog/checks/v01-schema.d.ts +17 -0
- package/dist/core/catalog/checks/v01-schema.d.ts.map +1 -0
- package/dist/core/catalog/checks/v01-schema.js +57 -0
- package/dist/core/catalog/checks/v01-schema.js.map +1 -0
- package/dist/core/catalog/checks/v02-v03-identity.d.ts +14 -0
- package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +1 -0
- package/dist/core/catalog/checks/v02-v03-identity.js +60 -0
- package/dist/core/catalog/checks/v02-v03-identity.js.map +1 -0
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts +7 -0
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +1 -0
- package/dist/core/catalog/checks/v04-referential-integrity.js +32 -0
- package/dist/core/catalog/checks/v04-referential-integrity.js.map +1 -0
- package/dist/core/catalog/checks/v05-domain-existence.d.ts +6 -0
- package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +1 -0
- package/dist/core/catalog/checks/v05-domain-existence.js +23 -0
- package/dist/core/catalog/checks/v05-domain-existence.js.map +1 -0
- package/dist/core/catalog/checks/v06-v07-paths.d.ts +29 -0
- package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +1 -0
- package/dist/core/catalog/checks/v06-v07-paths.js +107 -0
- package/dist/core/catalog/checks/v06-v07-paths.js.map +1 -0
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts +13 -0
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +1 -0
- package/dist/core/catalog/checks/v08-v10-contracts.js +70 -0
- package/dist/core/catalog/checks/v08-v10-contracts.js.map +1 -0
- package/dist/core/catalog/checks/v11-manual-fields.d.ts +16 -0
- package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +1 -0
- package/dist/core/catalog/checks/v11-manual-fields.js +60 -0
- package/dist/core/catalog/checks/v11-manual-fields.js.map +1 -0
- package/dist/core/catalog/checks/v12-cycles.d.ts +8 -0
- package/dist/core/catalog/checks/v12-cycles.d.ts.map +1 -0
- package/dist/core/catalog/checks/v12-cycles.js +28 -0
- package/dist/core/catalog/checks/v12-cycles.js.map +1 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +7 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +1 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.js +33 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.js.map +1 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +8 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +1 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.js +42 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +1 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +7 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +1 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.js +47 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +1 -0
- package/dist/core/catalog/checks/v17-low-confidence.d.ts +7 -0
- package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +1 -0
- package/dist/core/catalog/checks/v17-low-confidence.js +32 -0
- package/dist/core/catalog/checks/v17-low-confidence.js.map +1 -0
- package/dist/core/catalog/checks/v18-low-payload.d.ts +7 -0
- package/dist/core/catalog/checks/v18-low-payload.d.ts.map +1 -0
- package/dist/core/catalog/checks/v18-low-payload.js +33 -0
- package/dist/core/catalog/checks/v18-low-payload.js.map +1 -0
- package/dist/core/catalog/checks/v19-domain-membership.d.ts +8 -0
- package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +1 -0
- package/dist/core/catalog/checks/v19-domain-membership.js +55 -0
- package/dist/core/catalog/checks/v19-domain-membership.js.map +1 -0
- package/dist/core/catalog/coverage.d.ts +39 -0
- package/dist/core/catalog/coverage.d.ts.map +1 -0
- package/dist/core/catalog/coverage.js +62 -0
- package/dist/core/catalog/coverage.js.map +1 -0
- package/dist/core/catalog/graph.d.ts +49 -0
- package/dist/core/catalog/graph.d.ts.map +1 -0
- package/dist/core/catalog/graph.js +114 -0
- package/dist/core/catalog/graph.js.map +1 -0
- package/dist/core/catalog/index-model.d.ts +96 -0
- package/dist/core/catalog/index-model.d.ts.map +1 -0
- package/dist/core/catalog/index-model.js +8 -0
- package/dist/core/catalog/index-model.js.map +1 -0
- package/dist/core/catalog/queries.d.ts +69 -0
- package/dist/core/catalog/queries.d.ts.map +1 -0
- package/dist/core/catalog/queries.js +165 -0
- package/dist/core/catalog/queries.js.map +1 -0
- package/dist/core/catalog/resolve.d.ts +47 -0
- package/dist/core/catalog/resolve.d.ts.map +1 -0
- package/dist/core/catalog/resolve.js +318 -0
- package/dist/core/catalog/resolve.js.map +1 -0
- package/dist/core/catalog/scaffold.d.ts +31 -0
- package/dist/core/catalog/scaffold.d.ts.map +1 -0
- package/dist/core/catalog/scaffold.js +141 -0
- package/dist/core/catalog/scaffold.js.map +1 -0
- package/dist/core/catalog/validate-component.d.ts +50 -0
- package/dist/core/catalog/validate-component.d.ts.map +1 -0
- package/dist/core/catalog/validate-component.js +105 -0
- package/dist/core/catalog/validate-component.js.map +1 -0
- package/dist/core/catalog/validate.d.ts +71 -0
- package/dist/core/catalog/validate.d.ts.map +1 -0
- package/dist/core/catalog/validate.js +103 -0
- package/dist/core/catalog/validate.js.map +1 -0
- package/dist/core/context/assemble.d.ts +126 -0
- package/dist/core/context/assemble.d.ts.map +1 -0
- package/dist/core/context/assemble.js +197 -0
- package/dist/core/context/assemble.js.map +1 -0
- package/dist/core/context/cache.d.ts +60 -0
- package/dist/core/context/cache.d.ts.map +1 -0
- package/dist/core/context/cache.js +236 -0
- package/dist/core/context/cache.js.map +1 -0
- package/dist/core/context/exit-codes.d.ts +28 -0
- package/dist/core/context/exit-codes.d.ts.map +1 -0
- package/dist/core/context/exit-codes.js +28 -0
- package/dist/core/context/exit-codes.js.map +1 -0
- package/dist/core/context/fetch.d.ts +55 -0
- package/dist/core/context/fetch.d.ts.map +1 -0
- package/dist/core/context/fetch.js +112 -0
- package/dist/core/context/fetch.js.map +1 -0
- package/dist/core/context/index.d.ts +7 -1
- package/dist/core/context/index.d.ts.map +1 -1
- package/dist/core/context/index.js +7 -1
- package/dist/core/context/index.js.map +1 -1
- package/dist/core/context/init.d.ts +179 -0
- package/dist/core/context/init.d.ts.map +1 -0
- package/dist/core/context/init.js +532 -0
- package/dist/core/context/init.js.map +1 -0
- package/dist/core/context/layers/architecture-layer.d.ts +13 -0
- package/dist/core/context/layers/architecture-layer.d.ts.map +1 -0
- package/dist/core/context/layers/architecture-layer.js +24 -0
- package/dist/core/context/layers/architecture-layer.js.map +1 -0
- package/dist/core/context/layers/contracts-layer.d.ts +13 -0
- package/dist/core/context/layers/contracts-layer.d.ts.map +1 -0
- package/dist/core/context/layers/contracts-layer.js +83 -0
- package/dist/core/context/layers/contracts-layer.js.map +1 -0
- package/dist/core/context/layers/conventions-delta-layer.d.ts +13 -0
- package/dist/core/context/layers/conventions-delta-layer.d.ts.map +1 -0
- package/dist/core/context/layers/conventions-delta-layer.js +37 -0
- package/dist/core/context/layers/conventions-delta-layer.js.map +1 -0
- package/dist/core/context/layers/flow-layer.d.ts +14 -0
- package/dist/core/context/layers/flow-layer.d.ts.map +1 -0
- package/dist/core/context/layers/flow-layer.js +61 -0
- package/dist/core/context/layers/flow-layer.js.map +1 -0
- package/dist/core/context/layers/index-layer.d.ts +13 -0
- package/dist/core/context/layers/index-layer.d.ts.map +1 -0
- package/dist/core/context/layers/index-layer.js +77 -0
- package/dist/core/context/layers/index-layer.js.map +1 -0
- package/dist/core/context/layers/primary-layer.d.ts +16 -0
- package/dist/core/context/layers/primary-layer.d.ts.map +1 -0
- package/dist/core/context/layers/primary-layer.js +61 -0
- package/dist/core/context/layers/primary-layer.js.map +1 -0
- package/dist/core/context/layers/secondary-layer.d.ts +19 -0
- package/dist/core/context/layers/secondary-layer.d.ts.map +1 -0
- package/dist/core/context/layers/secondary-layer.js +52 -0
- package/dist/core/context/layers/secondary-layer.js.map +1 -0
- package/dist/core/context/session-lock.d.ts +114 -0
- package/dist/core/context/session-lock.d.ts.map +1 -0
- package/dist/core/context/session-lock.js +90 -0
- package/dist/core/context/session-lock.js.map +1 -0
- package/dist/core/context/tokens.d.ts +35 -0
- package/dist/core/context/tokens.d.ts.map +1 -0
- package/dist/core/context/tokens.js +88 -0
- package/dist/core/context/tokens.js.map +1 -0
- package/dist/core/distribution/fetch-package.d.ts +18 -0
- package/dist/core/distribution/fetch-package.d.ts.map +1 -0
- package/dist/core/distribution/fetch-package.js +42 -0
- package/dist/core/distribution/fetch-package.js.map +1 -0
- package/dist/core/distribution/index.d.ts +3 -1
- package/dist/core/distribution/index.d.ts.map +1 -1
- package/dist/core/distribution/index.js +2 -1
- package/dist/core/distribution/index.js.map +1 -1
- package/dist/core/distribution/install.d.ts +1 -1
- package/dist/core/distribution/install.d.ts.map +1 -1
- package/dist/core/distribution/install.js +10 -2
- package/dist/core/distribution/install.js.map +1 -1
- package/dist/core/distribution/pin.d.ts +5 -0
- package/dist/core/distribution/pin.d.ts.map +1 -1
- package/dist/core/distribution/pin.js +17 -1
- package/dist/core/distribution/pin.js.map +1 -1
- package/dist/core/distribution/update.d.ts +11 -1
- package/dist/core/distribution/update.d.ts.map +1 -1
- package/dist/core/distribution/update.js +45 -1
- package/dist/core/distribution/update.js.map +1 -1
- package/dist/core/exit-codes.d.ts +30 -1
- package/dist/core/exit-codes.d.ts.map +1 -1
- package/dist/core/exit-codes.js +31 -1
- package/dist/core/exit-codes.js.map +1 -1
- package/dist/core/extract/component.d.ts +11 -8
- package/dist/core/extract/component.d.ts.map +1 -1
- package/dist/core/extract/component.js.map +1 -1
- package/dist/core/extract/index.d.ts +1 -1
- package/dist/core/extract/index.d.ts.map +1 -1
- package/dist/core/extract/openapi/route1.d.ts.map +1 -1
- package/dist/core/extract/openapi/route1.js +6 -0
- package/dist/core/extract/openapi/route1.js.map +1 -1
- package/dist/core/extract/providers/node-ts.d.ts.map +1 -1
- package/dist/core/extract/providers/node-ts.js +9 -0
- package/dist/core/extract/providers/node-ts.js.map +1 -1
- package/dist/core/index.d.ts +1 -0
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +1 -0
- package/dist/core/index.js.map +1 -1
- package/dist/core/providers/index.d.ts +3 -2
- package/dist/core/providers/index.d.ts.map +1 -1
- package/dist/core/providers/index.js +1 -1
- package/dist/core/providers/index.js.map +1 -1
- package/dist/core/providers/tracker.d.ts +74 -0
- package/dist/core/providers/tracker.d.ts.map +1 -0
- package/dist/core/providers/tracker.js +38 -0
- package/dist/core/providers/tracker.js.map +1 -0
- package/dist/core/scope/calibration.d.ts +25 -0
- package/dist/core/scope/calibration.d.ts.map +1 -0
- package/dist/core/scope/calibration.js +52 -0
- package/dist/core/scope/calibration.js.map +1 -0
- package/dist/core/scope/closure.d.ts +31 -0
- package/dist/core/scope/closure.d.ts.map +1 -0
- package/dist/core/scope/closure.js +68 -0
- package/dist/core/scope/closure.js.map +1 -0
- package/dist/core/scope/gate.d.ts +41 -0
- package/dist/core/scope/gate.d.ts.map +1 -0
- package/dist/core/scope/gate.js +165 -0
- package/dist/core/scope/gate.js.map +1 -0
- package/dist/core/scope/index.d.ts +15 -2
- package/dist/core/scope/index.d.ts.map +1 -1
- package/dist/core/scope/index.js +11 -1
- package/dist/core/scope/index.js.map +1 -1
- package/dist/core/scope/partition.d.ts +36 -0
- package/dist/core/scope/partition.d.ts.map +1 -0
- package/dist/core/scope/partition.js +78 -0
- package/dist/core/scope/partition.js.map +1 -0
- package/dist/core/scope/prompt.d.ts +39 -0
- package/dist/core/scope/prompt.d.ts.map +1 -0
- package/dist/core/scope/prompt.js +123 -0
- package/dist/core/scope/prompt.js.map +1 -0
- package/dist/core/scope/scoping.d.ts +52 -0
- package/dist/core/scope/scoping.d.ts.map +1 -0
- package/dist/core/scope/scoping.js +99 -0
- package/dist/core/scope/scoping.js.map +1 -0
- package/dist/core/scope/types.d.ts +77 -0
- package/dist/core/scope/types.d.ts.map +1 -0
- package/dist/core/scope/types.js +5 -0
- package/dist/core/scope/types.js.map +1 -0
- package/dist/core/scope/validate.d.ts +47 -0
- package/dist/core/scope/validate.d.ts.map +1 -0
- package/dist/core/scope/validate.js +90 -0
- package/dist/core/scope/validate.js.map +1 -0
- package/dist/core/verify/asyncapi-diff.d.ts +34 -0
- package/dist/core/verify/asyncapi-diff.d.ts.map +1 -0
- package/dist/core/verify/asyncapi-diff.js +209 -0
- package/dist/core/verify/asyncapi-diff.js.map +1 -0
- package/dist/core/verify/contract-diff.d.ts +39 -0
- package/dist/core/verify/contract-diff.d.ts.map +1 -0
- package/dist/core/verify/contract-diff.js +63 -0
- package/dist/core/verify/contract-diff.js.map +1 -0
- package/dist/core/verify/drift.d.ts +47 -0
- package/dist/core/verify/drift.d.ts.map +1 -0
- package/dist/core/verify/drift.js +122 -0
- package/dist/core/verify/drift.js.map +1 -0
- package/dist/core/verify/impact.d.ts +22 -0
- package/dist/core/verify/impact.d.ts.map +1 -0
- package/dist/core/verify/impact.js +93 -0
- package/dist/core/verify/impact.js.map +1 -0
- package/dist/core/verify/index.d.ts +10 -0
- package/dist/core/verify/index.d.ts.map +1 -0
- package/dist/core/verify/index.js +9 -0
- package/dist/core/verify/index.js.map +1 -0
- package/dist/core/verify/openapi-diff.d.ts +29 -0
- package/dist/core/verify/openapi-diff.d.ts.map +1 -0
- package/dist/core/verify/openapi-diff.js +291 -0
- package/dist/core/verify/openapi-diff.js.map +1 -0
- package/dist/core/verify/types.d.ts +138 -0
- package/dist/core/verify/types.d.ts.map +1 -0
- package/dist/core/verify/types.js +5 -0
- package/dist/core/verify/types.js.map +1 -0
- package/package.json +11 -2
- package/schemas/component.schema.json +203 -0
- package/schemas/flow.schema.json +75 -0
- package/schemas/scope-output.schema.json +62 -0
- package/schemas/.gitkeep +0 -0
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI handler for `dt scope --task "<text>" --candidates <resolve-output> [--json]`.
|
|
3
|
+
*
|
|
4
|
+
* Runs the LLM scoping step: assembles input, calls LLM, validates output,
|
|
5
|
+
* retries once on failure, records calibration.
|
|
6
|
+
*
|
|
7
|
+
* Exit codes:
|
|
8
|
+
* - 0: success
|
|
9
|
+
* - 2: invalid usage (missing required flags)
|
|
10
|
+
* - 10: invalid scope after retry
|
|
11
|
+
* - 11: no candidates (empty resolve output)
|
|
12
|
+
*/
|
|
13
|
+
import { readFileSync, existsSync } from "node:fs";
|
|
14
|
+
import { resolve } from "node:path";
|
|
15
|
+
import { ExitCode } from "#core/exit-codes.js";
|
|
16
|
+
import { runScoping, EXIT_INVALID_SCOPE } from "#core/scope/scoping.js";
|
|
17
|
+
import { parse as yamlParse } from "yaml";
|
|
18
|
+
/* ─── Exit Codes ──────────────────────────────────────────────────────── */
|
|
19
|
+
/** Exit 11: No candidates from resolve */
|
|
20
|
+
const EXIT_NO_CANDIDATES = 11;
|
|
21
|
+
/* ─── Main Command ────────────────────────────────────────────────────── */
|
|
22
|
+
/**
|
|
23
|
+
* Run the `dt scope` command.
|
|
24
|
+
*/
|
|
25
|
+
export async function runScope(options, llmProvider) {
|
|
26
|
+
const { json, task, candidates: candidatesPath, metaRepo, out, skipCalibration } = options;
|
|
27
|
+
// Validate required flags
|
|
28
|
+
if (!task) {
|
|
29
|
+
const msg = 'Missing required flag: --task "<text>"';
|
|
30
|
+
if (json) {
|
|
31
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
32
|
+
}
|
|
33
|
+
else {
|
|
34
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
35
|
+
}
|
|
36
|
+
return ExitCode.InvalidUsage;
|
|
37
|
+
}
|
|
38
|
+
if (!candidatesPath) {
|
|
39
|
+
const msg = "Missing required flag: --candidates <path-to-resolve-output.json>";
|
|
40
|
+
if (json) {
|
|
41
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
42
|
+
}
|
|
43
|
+
else {
|
|
44
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
45
|
+
}
|
|
46
|
+
return ExitCode.InvalidUsage;
|
|
47
|
+
}
|
|
48
|
+
// Load candidates
|
|
49
|
+
const candidatesFile = resolve(candidatesPath);
|
|
50
|
+
if (!existsSync(candidatesFile)) {
|
|
51
|
+
const msg = `Candidates file not found: ${candidatesFile}`;
|
|
52
|
+
if (json) {
|
|
53
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
54
|
+
}
|
|
55
|
+
else {
|
|
56
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
57
|
+
}
|
|
58
|
+
return ExitCode.NotFound;
|
|
59
|
+
}
|
|
60
|
+
let candidates;
|
|
61
|
+
try {
|
|
62
|
+
candidates = JSON.parse(readFileSync(candidatesFile, "utf-8"));
|
|
63
|
+
}
|
|
64
|
+
catch (err) {
|
|
65
|
+
const msg = `Failed to parse candidates file: ${err instanceof Error ? err.message : String(err)}`;
|
|
66
|
+
if (json) {
|
|
67
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
68
|
+
}
|
|
69
|
+
else {
|
|
70
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
71
|
+
}
|
|
72
|
+
return ExitCode.GeneralError;
|
|
73
|
+
}
|
|
74
|
+
// Guard: empty candidates
|
|
75
|
+
if (!candidates || candidates.length === 0) {
|
|
76
|
+
const msg = "No candidates from resolve — cannot scope with zero candidates";
|
|
77
|
+
if (json) {
|
|
78
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
79
|
+
}
|
|
80
|
+
else {
|
|
81
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
82
|
+
}
|
|
83
|
+
return EXIT_NO_CANDIDATES;
|
|
84
|
+
}
|
|
85
|
+
// Load index
|
|
86
|
+
const metaRepoPath = resolve(metaRepo ?? ".");
|
|
87
|
+
const indexPath = resolve(metaRepoPath, "catalog", "index.yaml");
|
|
88
|
+
if (!existsSync(indexPath)) {
|
|
89
|
+
const msg = `Catalog index not found: ${indexPath}`;
|
|
90
|
+
if (json) {
|
|
91
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
92
|
+
}
|
|
93
|
+
else {
|
|
94
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
95
|
+
}
|
|
96
|
+
return ExitCode.NotFound;
|
|
97
|
+
}
|
|
98
|
+
let index;
|
|
99
|
+
try {
|
|
100
|
+
index = yamlParse(readFileSync(indexPath, "utf-8"));
|
|
101
|
+
}
|
|
102
|
+
catch (err) {
|
|
103
|
+
const msg = `Failed to parse catalog index: ${err instanceof Error ? err.message : String(err)}`;
|
|
104
|
+
if (json) {
|
|
105
|
+
process.stdout.write(JSON.stringify({ error: msg }, null, 2) + "\n");
|
|
106
|
+
}
|
|
107
|
+
else {
|
|
108
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
109
|
+
}
|
|
110
|
+
return ExitCode.GeneralError;
|
|
111
|
+
}
|
|
112
|
+
// Run scoping
|
|
113
|
+
const result = await runScoping({
|
|
114
|
+
taskText: task,
|
|
115
|
+
candidates,
|
|
116
|
+
index,
|
|
117
|
+
llmProvider,
|
|
118
|
+
baseDir: out ?? process.cwd(),
|
|
119
|
+
skipCalibration,
|
|
120
|
+
});
|
|
121
|
+
if (!result.success) {
|
|
122
|
+
if (json) {
|
|
123
|
+
process.stdout.write(JSON.stringify({
|
|
124
|
+
error: "Invalid scope after retry",
|
|
125
|
+
errors: result.errors,
|
|
126
|
+
repair_attempted: result.repairAttempted,
|
|
127
|
+
}, null, 2) + "\n");
|
|
128
|
+
}
|
|
129
|
+
else {
|
|
130
|
+
process.stderr.write("Error: Invalid scope after retry\n");
|
|
131
|
+
for (const e of result.errors) {
|
|
132
|
+
process.stderr.write(` - ${e}\n`);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
return EXIT_INVALID_SCOPE;
|
|
136
|
+
}
|
|
137
|
+
// Output
|
|
138
|
+
printOutput(result.output, result.repairAttempted, result.calibrationPath, json);
|
|
139
|
+
return ExitCode.Success;
|
|
140
|
+
}
|
|
141
|
+
/* ─── Output ──────────────────────────────────────────────────────────── */
|
|
142
|
+
function printOutput(output, repairAttempted, calibrationPath, json) {
|
|
143
|
+
if (json) {
|
|
144
|
+
const result = {
|
|
145
|
+
success: true,
|
|
146
|
+
scope: output,
|
|
147
|
+
repair_attempted: repairAttempted,
|
|
148
|
+
calibration_path: calibrationPath ?? null,
|
|
149
|
+
};
|
|
150
|
+
process.stdout.write(JSON.stringify(result, null, 2) + "\n");
|
|
151
|
+
}
|
|
152
|
+
else {
|
|
153
|
+
process.stdout.write(`✓ Scope determined (confidence: ${output.confidence})\n`);
|
|
154
|
+
process.stdout.write(` Primary: ${output.primary.join(", ")}\n`);
|
|
155
|
+
if (output.secondary.length > 0) {
|
|
156
|
+
process.stdout.write(` Secondary: ${output.secondary.join(", ")}\n`);
|
|
157
|
+
}
|
|
158
|
+
if (output.contracts_crossed.length > 0) {
|
|
159
|
+
process.stdout.write(` Contracts crossed: ${output.contracts_crossed.join(", ")}\n`);
|
|
160
|
+
}
|
|
161
|
+
if (output.unresolved.length > 0) {
|
|
162
|
+
process.stdout.write(` Unresolved: ${output.unresolved.join(", ")}\n`);
|
|
163
|
+
}
|
|
164
|
+
if (repairAttempted) {
|
|
165
|
+
process.stdout.write(` (repair attempt was needed)\n`);
|
|
166
|
+
}
|
|
167
|
+
if (calibrationPath) {
|
|
168
|
+
process.stdout.write(` Calibration: ${calibrationPath}\n`);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
//# sourceMappingURL=scope.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../adapters/cli/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAIxE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAa1C,6EAA6E;AAE7E,0CAA0C;AAC1C,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,6EAA6E;AAE7E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAwB,EACxB,WAA6B;IAE7B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAE3F,0BAA0B;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,wCAAwC,CAAC;QACrD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,mEAAmE,CAAC;QAChF,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,kBAAkB;IAClB,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,8BAA8B,cAAc,EAAE,CAAC;QAC3D,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAuB,CAAC;IACvF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnG,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,gEAAgE,CAAC;QAC7E,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,aAAa;IACb,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,4BAA4B,SAAS,EAAE,CAAC;QACpD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,KAAmB,CAAC;IACxB,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAiB,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACjG,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,QAAQ,EAAE,IAAI;QACd,UAAU;QACV,KAAK;QACL,WAAW;QACX,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAC7B,eAAe;KAChB,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CACZ;gBACE,KAAK,EAAE,2BAA2B;gBAClC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,gBAAgB,EAAE,MAAM,CAAC,eAAe;aACzC,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC3D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,SAAS;IACT,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACjF,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAE7E,SAAS,WAAW,CAClB,MAAmB,EACnB,eAAwB,EACxB,eAAmC,EACnC,IAAa;IAEb,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;YACb,gBAAgB,EAAE,eAAe;YACjC,gBAAgB,EAAE,eAAe,IAAI,IAAI;SAC1C,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC;QAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,eAAe,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI handler for `dt validate-component <path>`.
|
|
3
|
+
* Validates a component.json manifest against the bundled JSON Schema
|
|
4
|
+
* (draft 2020-12), entirely offline. Spec: specification-multi-repo-context.md
|
|
5
|
+
* section 6.2 / 8.1 (component-repo PR CI), section 15 (component-repo CI usage).
|
|
6
|
+
*/
|
|
7
|
+
import { type ValidateArtifactResult } from "#core/catalog/validate-component.js";
|
|
8
|
+
export interface ValidateComponentOptions {
|
|
9
|
+
json: boolean;
|
|
10
|
+
path?: string;
|
|
11
|
+
}
|
|
12
|
+
export interface ValidateComponentOutput {
|
|
13
|
+
path: string;
|
|
14
|
+
valid: boolean;
|
|
15
|
+
errors: ValidateArtifactResult["errors"];
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Run the `dt validate-component <path>` command.
|
|
19
|
+
* Returns the process exit code: 0 if valid, ExitCode.AuthError (4) if invalid
|
|
20
|
+
* (per spec section 6.7 — "4: Catalog validation errors"), ExitCode.InvalidUsage (2)
|
|
21
|
+
* if no path was given, ExitCode.NotFound (5) if the file does not exist.
|
|
22
|
+
*/
|
|
23
|
+
export declare function runValidateComponent(options: ValidateComponentOptions): number;
|
|
24
|
+
//# sourceMappingURL=validate-component.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validate-component.d.ts","sourceRoot":"","sources":["../../../adapters/cli/validate-component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qCAAqC,CAAC;AAG7C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAyC9E"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI handler for `dt validate-component <path>`.
|
|
3
|
+
* Validates a component.json manifest against the bundled JSON Schema
|
|
4
|
+
* (draft 2020-12), entirely offline. Spec: specification-multi-repo-context.md
|
|
5
|
+
* section 6.2 / 8.1 (component-repo PR CI), section 15 (component-repo CI usage).
|
|
6
|
+
*/
|
|
7
|
+
import { existsSync } from "node:fs";
|
|
8
|
+
import { resolve } from "node:path";
|
|
9
|
+
import { validateComponentFile, } from "#core/catalog/validate-component.js";
|
|
10
|
+
import { ExitCode } from "#core/exit-codes.js";
|
|
11
|
+
/**
|
|
12
|
+
* Run the `dt validate-component <path>` command.
|
|
13
|
+
* Returns the process exit code: 0 if valid, ExitCode.AuthError (4) if invalid
|
|
14
|
+
* (per spec section 6.7 — "4: Catalog validation errors"), ExitCode.InvalidUsage (2)
|
|
15
|
+
* if no path was given, ExitCode.NotFound (5) if the file does not exist.
|
|
16
|
+
*/
|
|
17
|
+
export function runValidateComponent(options) {
|
|
18
|
+
const targetPath = options.path;
|
|
19
|
+
if (!targetPath) {
|
|
20
|
+
if (options.json) {
|
|
21
|
+
process.stdout.write(JSON.stringify({ error: "Missing required argument: <path>" }, null, 2) + "\n");
|
|
22
|
+
}
|
|
23
|
+
else {
|
|
24
|
+
process.stderr.write("Usage: dt validate-component <path> [--json]\n");
|
|
25
|
+
}
|
|
26
|
+
return ExitCode.InvalidUsage;
|
|
27
|
+
}
|
|
28
|
+
const absPath = resolve(targetPath);
|
|
29
|
+
if (!existsSync(absPath)) {
|
|
30
|
+
if (options.json) {
|
|
31
|
+
process.stdout.write(JSON.stringify({ path: absPath, error: "File not found" }, null, 2) + "\n");
|
|
32
|
+
}
|
|
33
|
+
else {
|
|
34
|
+
process.stderr.write(`File not found: ${absPath}\n`);
|
|
35
|
+
}
|
|
36
|
+
return ExitCode.NotFound;
|
|
37
|
+
}
|
|
38
|
+
const result = validateComponentFile(absPath);
|
|
39
|
+
const output = {
|
|
40
|
+
path: absPath,
|
|
41
|
+
valid: result.valid,
|
|
42
|
+
errors: result.errors,
|
|
43
|
+
};
|
|
44
|
+
if (options.json) {
|
|
45
|
+
process.stdout.write(JSON.stringify(output, null, 2) + "\n");
|
|
46
|
+
}
|
|
47
|
+
else {
|
|
48
|
+
printHumanOutput(output);
|
|
49
|
+
}
|
|
50
|
+
return result.valid ? ExitCode.Success : ExitCode.AuthError;
|
|
51
|
+
}
|
|
52
|
+
function printHumanOutput(output) {
|
|
53
|
+
if (output.valid) {
|
|
54
|
+
process.stdout.write(`✓ ${output.path} is valid\n`);
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
57
|
+
process.stderr.write(`✗ ${output.path} is invalid\n\n`);
|
|
58
|
+
for (const err of output.errors) {
|
|
59
|
+
process.stderr.write(` ${err.path || "/"}: ${err.message} (${err.keyword})\n`);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
//# sourceMappingURL=validate-component.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validate-component.js","sourceRoot":"","sources":["../../../adapters/cli/validate-component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,qBAAqB,GAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAa/C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAiC;IACpE,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC/E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC3E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,OAAO,IAAI,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA+B;IACvD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,IAAI,iBAAiB,CAAC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI adapter for `dt verify contract-diff`.
|
|
3
|
+
*
|
|
4
|
+
* Usage: dt verify contract-diff --base <path> --head <path> [--json]
|
|
5
|
+
*
|
|
6
|
+
* Exit codes:
|
|
7
|
+
* 0 — no breaking changes detected
|
|
8
|
+
* 8 — breaking change detected
|
|
9
|
+
* 1 — unexpected error (malformed spec, missing file, etc.)
|
|
10
|
+
* 2 — incorrect usage (missing required flags)
|
|
11
|
+
*/
|
|
12
|
+
export interface VerifyContractDiffCliOptions {
|
|
13
|
+
/** Path to base (old) spec */
|
|
14
|
+
basePath: string | undefined;
|
|
15
|
+
/** Path to head (new) spec */
|
|
16
|
+
headPath: string | undefined;
|
|
17
|
+
/** Output JSON */
|
|
18
|
+
json: boolean;
|
|
19
|
+
}
|
|
20
|
+
export declare function runVerifyContractDiff(options: VerifyContractDiffCliOptions): number;
|
|
21
|
+
//# sourceMappingURL=verify-contract-diff.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify-contract-diff.d.ts","sourceRoot":"","sources":["../../../adapters/cli/verify-contract-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,4BAA4B;IAC3C,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAwDnF"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI adapter for `dt verify contract-diff`.
|
|
3
|
+
*
|
|
4
|
+
* Usage: dt verify contract-diff --base <path> --head <path> [--json]
|
|
5
|
+
*
|
|
6
|
+
* Exit codes:
|
|
7
|
+
* 0 — no breaking changes detected
|
|
8
|
+
* 8 — breaking change detected
|
|
9
|
+
* 1 — unexpected error (malformed spec, missing file, etc.)
|
|
10
|
+
* 2 — incorrect usage (missing required flags)
|
|
11
|
+
*/
|
|
12
|
+
import { ExitCode } from "#core/exit-codes.js";
|
|
13
|
+
import { runContractDiff } from "#core/verify/contract-diff.js";
|
|
14
|
+
export function runVerifyContractDiff(options) {
|
|
15
|
+
const { basePath, headPath, json } = options;
|
|
16
|
+
if (!basePath || !headPath) {
|
|
17
|
+
const msg = "Usage: dt verify contract-diff --base <path> --head <path> [--json]";
|
|
18
|
+
if (json) {
|
|
19
|
+
process.stdout.write(JSON.stringify({ error: msg }) + "\n");
|
|
20
|
+
}
|
|
21
|
+
else {
|
|
22
|
+
process.stderr.write(`Error: --base and --head are required.\n${msg}\n`);
|
|
23
|
+
}
|
|
24
|
+
return ExitCode.InvalidUsage;
|
|
25
|
+
}
|
|
26
|
+
let result;
|
|
27
|
+
try {
|
|
28
|
+
result = runContractDiff({ basePath, headPath });
|
|
29
|
+
}
|
|
30
|
+
catch (err) {
|
|
31
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
32
|
+
if (json) {
|
|
33
|
+
process.stdout.write(JSON.stringify({ error: message }) + "\n");
|
|
34
|
+
}
|
|
35
|
+
else {
|
|
36
|
+
process.stderr.write(`Error: ${message}\n`);
|
|
37
|
+
}
|
|
38
|
+
return ExitCode.GeneralError;
|
|
39
|
+
}
|
|
40
|
+
if (json) {
|
|
41
|
+
process.stdout.write(JSON.stringify(result, null, 2) + "\n");
|
|
42
|
+
}
|
|
43
|
+
else {
|
|
44
|
+
const breakingFindings = result.findings.filter((f) => f.kind === "breaking");
|
|
45
|
+
const nonBreakingFindings = result.findings.filter((f) => f.kind === "non-breaking");
|
|
46
|
+
if (breakingFindings.length > 0) {
|
|
47
|
+
process.stdout.write(`\n⚠ ${breakingFindings.length} breaking change(s) detected:\n\n`);
|
|
48
|
+
for (const f of breakingFindings) {
|
|
49
|
+
process.stdout.write(` [${f.code}] ${f.message}\n`);
|
|
50
|
+
process.stdout.write(` at ${f.path}\n\n`);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
if (nonBreakingFindings.length > 0) {
|
|
54
|
+
process.stdout.write(`ℹ ${nonBreakingFindings.length} non-breaking change(s):\n\n`);
|
|
55
|
+
for (const f of nonBreakingFindings) {
|
|
56
|
+
process.stdout.write(` [${f.code}] ${f.message}\n`);
|
|
57
|
+
}
|
|
58
|
+
process.stdout.write("\n");
|
|
59
|
+
}
|
|
60
|
+
if (!result.breaking && breakingFindings.length === 0 && nonBreakingFindings.length === 0) {
|
|
61
|
+
process.stdout.write("No changes detected.\n");
|
|
62
|
+
}
|
|
63
|
+
else if (!result.breaking) {
|
|
64
|
+
process.stdout.write("✓ No breaking changes.\n");
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return result.breaking ? ExitCode.BreakingChange : ExitCode.Success;
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=verify-contract-diff.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify-contract-diff.js","sourceRoot":"","sources":["../../../adapters/cli/verify-contract-diff.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI adapter for `dt verify drift`.
|
|
3
|
+
*
|
|
4
|
+
* Usage: dt verify drift [--id <comp>] [--threshold <days>] [--index <path>] [--json]
|
|
5
|
+
*
|
|
6
|
+
* Exit codes:
|
|
7
|
+
* 0 — success (drift report generated)
|
|
8
|
+
* 1 — unexpected error
|
|
9
|
+
* 12 — unknown component (when --id is specified but not found)
|
|
10
|
+
*/
|
|
11
|
+
export interface VerifyDriftCliOptions {
|
|
12
|
+
/** Component id to check (optional — checks all if omitted) */
|
|
13
|
+
id: string | undefined;
|
|
14
|
+
/** Staleness threshold in days */
|
|
15
|
+
threshold: number | undefined;
|
|
16
|
+
/** Output JSON */
|
|
17
|
+
json: boolean;
|
|
18
|
+
/** Path to catalog index file */
|
|
19
|
+
indexPath: string | undefined;
|
|
20
|
+
/** Path to repository root for git operations */
|
|
21
|
+
repoRoot: string | undefined;
|
|
22
|
+
}
|
|
23
|
+
export declare function runVerifyDrift(options: VerifyDriftCliOptions): number;
|
|
24
|
+
//# sourceMappingURL=verify-drift.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify-drift.d.ts","sourceRoot":"","sources":["../../../adapters/cli/verify-drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,kCAAkC;IAClC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAcD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAwFrE"}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI adapter for `dt verify drift`.
|
|
3
|
+
*
|
|
4
|
+
* Usage: dt verify drift [--id <comp>] [--threshold <days>] [--index <path>] [--json]
|
|
5
|
+
*
|
|
6
|
+
* Exit codes:
|
|
7
|
+
* 0 — success (drift report generated)
|
|
8
|
+
* 1 — unexpected error
|
|
9
|
+
* 12 — unknown component (when --id is specified but not found)
|
|
10
|
+
*/
|
|
11
|
+
import { readFileSync } from "node:fs";
|
|
12
|
+
import { parse as parseYaml } from "yaml";
|
|
13
|
+
import { ExitCode } from "#core/exit-codes.js";
|
|
14
|
+
import { runDrift } from "#core/verify/drift.js";
|
|
15
|
+
/**
|
|
16
|
+
* Load the catalog index from a file path.
|
|
17
|
+
*/
|
|
18
|
+
function loadCatalogIndex(indexPath) {
|
|
19
|
+
const content = readFileSync(indexPath, "utf-8");
|
|
20
|
+
const trimmed = content.trim();
|
|
21
|
+
if (trimmed.startsWith("{")) {
|
|
22
|
+
return JSON.parse(trimmed);
|
|
23
|
+
}
|
|
24
|
+
return parseYaml(trimmed);
|
|
25
|
+
}
|
|
26
|
+
export function runVerifyDrift(options) {
|
|
27
|
+
const { id, threshold, json, indexPath, repoRoot } = options;
|
|
28
|
+
// Load catalog index
|
|
29
|
+
const resolvedIndexPath = indexPath ?? "catalog/index.yaml";
|
|
30
|
+
let index;
|
|
31
|
+
try {
|
|
32
|
+
index = loadCatalogIndex(resolvedIndexPath);
|
|
33
|
+
}
|
|
34
|
+
catch (err) {
|
|
35
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
36
|
+
if (json) {
|
|
37
|
+
process.stdout.write(JSON.stringify({ error: `Failed to load catalog index: ${message}` }) + "\n");
|
|
38
|
+
}
|
|
39
|
+
else {
|
|
40
|
+
process.stderr.write(`Error: Failed to load catalog index at "${resolvedIndexPath}": ${message}\n`);
|
|
41
|
+
}
|
|
42
|
+
return ExitCode.GeneralError;
|
|
43
|
+
}
|
|
44
|
+
// Run drift analysis
|
|
45
|
+
let result;
|
|
46
|
+
try {
|
|
47
|
+
result = runDrift(index, { id, threshold, repoRoot });
|
|
48
|
+
}
|
|
49
|
+
catch (err) {
|
|
50
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
51
|
+
if (json) {
|
|
52
|
+
process.stdout.write(JSON.stringify({ error: message }) + "\n");
|
|
53
|
+
}
|
|
54
|
+
else {
|
|
55
|
+
process.stderr.write(`Error: ${message}\n`);
|
|
56
|
+
}
|
|
57
|
+
return ExitCode.GeneralError;
|
|
58
|
+
}
|
|
59
|
+
// Check if --id was specified but yielded no results (component not found)
|
|
60
|
+
if (id && result.entries.length === 0) {
|
|
61
|
+
const msg = `Component "${id}" not found in catalog index.`;
|
|
62
|
+
if (json) {
|
|
63
|
+
process.stdout.write(JSON.stringify({ error: msg }) + "\n");
|
|
64
|
+
}
|
|
65
|
+
else {
|
|
66
|
+
process.stderr.write(`Error: ${msg}\n`);
|
|
67
|
+
}
|
|
68
|
+
return ExitCode.UnknownComponent;
|
|
69
|
+
}
|
|
70
|
+
// Output results
|
|
71
|
+
if (json) {
|
|
72
|
+
process.stdout.write(JSON.stringify(result, null, 2) + "\n");
|
|
73
|
+
}
|
|
74
|
+
else {
|
|
75
|
+
process.stdout.write(`\nDrift Analysis (threshold: ${result.threshold} days)\n`);
|
|
76
|
+
process.stdout.write(`${"─".repeat(60)}\n\n`);
|
|
77
|
+
if (result.entries.length === 0) {
|
|
78
|
+
process.stdout.write(" No components found.\n");
|
|
79
|
+
}
|
|
80
|
+
else {
|
|
81
|
+
// Header
|
|
82
|
+
process.stdout.write(` ${"Component".padEnd(25)} ${"Source".padEnd(10)} ${"Docs".padEnd(10)} ${"Drift".padEnd(10)} Status\n`);
|
|
83
|
+
process.stdout.write(` ${"─".repeat(65)}\n`);
|
|
84
|
+
for (const entry of result.entries) {
|
|
85
|
+
const sourceStr = entry.sourceDaysAgo === -1 ? "n/a" : `${entry.sourceDaysAgo}d`;
|
|
86
|
+
const docsStr = entry.docsDaysAgo === -1 ? "n/a" : `${entry.docsDaysAgo}d`;
|
|
87
|
+
const driftStr = `${entry.driftDays}d`;
|
|
88
|
+
const status = entry.stale ? "STALE" : "ok";
|
|
89
|
+
process.stdout.write(` ${entry.id.padEnd(25)} ${sourceStr.padEnd(10)} ${docsStr.padEnd(10)} ${driftStr.padEnd(10)} ${status}\n`);
|
|
90
|
+
}
|
|
91
|
+
process.stdout.write(`\n`);
|
|
92
|
+
if (result.staleEntries.length > 0) {
|
|
93
|
+
process.stdout.write(` ${result.staleEntries.length} component(s) with stale docs (drift > ${result.threshold} days)\n`);
|
|
94
|
+
}
|
|
95
|
+
else {
|
|
96
|
+
process.stdout.write(` All docs are within the ${result.threshold}-day threshold.\n`);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
process.stdout.write("\n");
|
|
100
|
+
}
|
|
101
|
+
return ExitCode.Success;
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=verify-drift.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify-drift.js","sourceRoot":"","sources":["../../../adapters/cli/verify-drift.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI adapter for `dt verify impact`.
|
|
3
|
+
*
|
|
4
|
+
* Usage: dt verify impact --contract <id> [--emit-tasks] [--json]
|
|
5
|
+
*
|
|
6
|
+
* Exit codes:
|
|
7
|
+
* 0 — success (consumers listed)
|
|
8
|
+
* 1 — unexpected error
|
|
9
|
+
* 2 — incorrect usage (missing required flags)
|
|
10
|
+
* 12 — unknown component/contract
|
|
11
|
+
*/
|
|
12
|
+
export interface VerifyImpactCliOptions {
|
|
13
|
+
/** Contract id to analyze */
|
|
14
|
+
contractId: string | undefined;
|
|
15
|
+
/** Whether to emit derived tasks */
|
|
16
|
+
emitTasks: boolean;
|
|
17
|
+
/** Output JSON */
|
|
18
|
+
json: boolean;
|
|
19
|
+
/** Path to catalog index file */
|
|
20
|
+
indexPath: string | undefined;
|
|
21
|
+
}
|
|
22
|
+
export declare function runVerifyImpact(options: VerifyImpactCliOptions): Promise<number>;
|
|
23
|
+
//# sourceMappingURL=verify-impact.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify-impact.d.ts","sourceRoot":"","sources":["../../../adapters/cli/verify-impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAcD,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGtF"}
|