@llipe.com/dev-tasks 0.6.7 → 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 +90 -0
- package/README.md +30 -2
- 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,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-session calibration data recording.
|
|
3
|
+
*
|
|
4
|
+
* Records proposed scope (primary/secondary ids), confidence, unresolved,
|
|
5
|
+
* timestamp, and task text hash. Written to `.dev-tasks/calibration/`
|
|
6
|
+
* for later precision/recall analysis.
|
|
7
|
+
*/
|
|
8
|
+
import { createHash } from "node:crypto";
|
|
9
|
+
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
10
|
+
import { resolve } from "node:path";
|
|
11
|
+
/* ─── Constants ───────────────────────────────────────────────────────── */
|
|
12
|
+
const CALIBRATION_DIR = ".dev-tasks/calibration";
|
|
13
|
+
/* ─── Public API ──────────────────────────────────────────────────────── */
|
|
14
|
+
/**
|
|
15
|
+
* Compute a SHA-256 hash of the task text (for deduplication and reference).
|
|
16
|
+
*/
|
|
17
|
+
export function hashTaskText(taskText) {
|
|
18
|
+
return createHash("sha256").update(taskText).digest("hex").slice(0, 16);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Build a calibration record from scope output and task text.
|
|
22
|
+
*/
|
|
23
|
+
export function buildCalibrationRecord(scopeOutput, taskText) {
|
|
24
|
+
return {
|
|
25
|
+
timestamp: new Date().toISOString(),
|
|
26
|
+
taskTextHash: hashTaskText(taskText),
|
|
27
|
+
primary: scopeOutput.primary,
|
|
28
|
+
secondary: scopeOutput.secondary,
|
|
29
|
+
confidence: scopeOutput.confidence,
|
|
30
|
+
unresolved: scopeOutput.unresolved,
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Write a calibration record to the calibration directory.
|
|
35
|
+
*
|
|
36
|
+
* @param baseDir - The project root (or working directory)
|
|
37
|
+
* @param record - The calibration record to write
|
|
38
|
+
* @returns The path to the written file
|
|
39
|
+
*/
|
|
40
|
+
export function writeCalibrationRecord(baseDir, record) {
|
|
41
|
+
const calibDir = resolve(baseDir, CALIBRATION_DIR);
|
|
42
|
+
if (!existsSync(calibDir)) {
|
|
43
|
+
mkdirSync(calibDir, { recursive: true });
|
|
44
|
+
}
|
|
45
|
+
// Filename: <timestamp-millis>-<task-hash>.json
|
|
46
|
+
const ts = new Date(record.timestamp).getTime();
|
|
47
|
+
const filename = `${ts}-${record.taskTextHash}.json`;
|
|
48
|
+
const filePath = resolve(calibDir, filename);
|
|
49
|
+
writeFileSync(filePath, JSON.stringify(record, null, 2) + "\n", "utf-8");
|
|
50
|
+
return filePath;
|
|
51
|
+
}
|
|
52
|
+
//# sourceMappingURL=calibration.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"calibration.js","sourceRoot":"","sources":["../../../core/scope/calibration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,6EAA6E;AAE7E,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD,6EAA6E;AAE7E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAwB,EACxB,QAAgB;IAEhB,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY,EAAE,YAAY,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,UAAU,EAAE,WAAW,CAAC,UAAU;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAyB;IAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,gDAAgD;IAChD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,MAAM,CAAC,YAAY,OAAO,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE7C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzE,OAAO,QAAQ,CAAC;AAClB,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Graph closure expansion for scope output.
|
|
3
|
+
*
|
|
4
|
+
* Adds `contracts_crossed` consumers and flow neighbors to `secondary`.
|
|
5
|
+
* Deduplicates (primary wins over secondary).
|
|
6
|
+
* Records `scope.source` per component (`llm` or `closure`).
|
|
7
|
+
*
|
|
8
|
+
* Spec §6.4 / RF-34.
|
|
9
|
+
*/
|
|
10
|
+
import type { CatalogIndex } from "../catalog/index-model.js";
|
|
11
|
+
import type { ScopeOutput } from "./types.js";
|
|
12
|
+
export type ScopeSource = "llm" | "closure";
|
|
13
|
+
export interface ScopeSourceMap {
|
|
14
|
+
[componentId: string]: ScopeSource;
|
|
15
|
+
}
|
|
16
|
+
export interface ClosureResult {
|
|
17
|
+
/** Final primary components (unchanged from LLM output) */
|
|
18
|
+
primary: string[];
|
|
19
|
+
/** Final secondary components (LLM secondary + closure additions, deduplicated) */
|
|
20
|
+
secondary: string[];
|
|
21
|
+
/** Source attribution per component */
|
|
22
|
+
sourceMap: ScopeSourceMap;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Expand scope via graph closure:
|
|
26
|
+
* 1. Add consumers of `contracts_crossed` to secondary
|
|
27
|
+
* 2. Add flow neighbors (if `flow` specified) to secondary
|
|
28
|
+
* 3. Deduplicate: primary wins over secondary; no duplicates in secondary
|
|
29
|
+
*/
|
|
30
|
+
export declare function expandClosure(scopeOutput: ScopeOutput, index: CatalogIndex): ClosureResult;
|
|
31
|
+
//# sourceMappingURL=closure.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"closure.d.ts","sourceRoot":"","sources":["../../../core/scope/closure.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mFAAmF;IACnF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,cAAc,CAAC;CAC3B;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,aAAa,CAuD1F"}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Graph closure expansion for scope output.
|
|
3
|
+
*
|
|
4
|
+
* Adds `contracts_crossed` consumers and flow neighbors to `secondary`.
|
|
5
|
+
* Deduplicates (primary wins over secondary).
|
|
6
|
+
* Records `scope.source` per component (`llm` or `closure`).
|
|
7
|
+
*
|
|
8
|
+
* Spec §6.4 / RF-34.
|
|
9
|
+
*/
|
|
10
|
+
/* ─── Public API ──────────────────────────────────────────────────────── */
|
|
11
|
+
/**
|
|
12
|
+
* Expand scope via graph closure:
|
|
13
|
+
* 1. Add consumers of `contracts_crossed` to secondary
|
|
14
|
+
* 2. Add flow neighbors (if `flow` specified) to secondary
|
|
15
|
+
* 3. Deduplicate: primary wins over secondary; no duplicates in secondary
|
|
16
|
+
*/
|
|
17
|
+
export function expandClosure(scopeOutput, index) {
|
|
18
|
+
const primarySet = new Set(scopeOutput.primary);
|
|
19
|
+
const secondarySet = new Set(scopeOutput.secondary);
|
|
20
|
+
// Build source map — LLM selections first
|
|
21
|
+
const sourceMap = {};
|
|
22
|
+
for (const id of scopeOutput.primary) {
|
|
23
|
+
sourceMap[id] = "llm";
|
|
24
|
+
}
|
|
25
|
+
for (const id of scopeOutput.secondary) {
|
|
26
|
+
sourceMap[id] = "llm";
|
|
27
|
+
}
|
|
28
|
+
// Step 1: Add consumers of contracts_crossed
|
|
29
|
+
for (const contractId of scopeOutput.contracts_crossed) {
|
|
30
|
+
const contractEntry = index.contracts[contractId];
|
|
31
|
+
if (!contractEntry)
|
|
32
|
+
continue;
|
|
33
|
+
for (const consumerId of contractEntry.consumers) {
|
|
34
|
+
if (!primarySet.has(consumerId) && !secondarySet.has(consumerId)) {
|
|
35
|
+
secondarySet.add(consumerId);
|
|
36
|
+
sourceMap[consumerId] = "closure";
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
// Also add the provider if not already in scope
|
|
40
|
+
const providerId = contractEntry.provider;
|
|
41
|
+
if (!primarySet.has(providerId) && !secondarySet.has(providerId)) {
|
|
42
|
+
secondarySet.add(providerId);
|
|
43
|
+
sourceMap[providerId] = "closure";
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
// Step 2: Add flow neighbors if flow is specified
|
|
47
|
+
if (scopeOutput.flow) {
|
|
48
|
+
const flowEntry = index.flows.find((f) => f.id === scopeOutput.flow);
|
|
49
|
+
if (flowEntry) {
|
|
50
|
+
for (const participantId of flowEntry.participants) {
|
|
51
|
+
if (!primarySet.has(participantId) && !secondarySet.has(participantId)) {
|
|
52
|
+
// Verify the participant exists in the index
|
|
53
|
+
const exists = index.components.some((c) => c.id === participantId);
|
|
54
|
+
if (exists) {
|
|
55
|
+
secondarySet.add(participantId);
|
|
56
|
+
sourceMap[participantId] = "closure";
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
return {
|
|
63
|
+
primary: [...primarySet],
|
|
64
|
+
secondary: [...secondarySet],
|
|
65
|
+
sourceMap,
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
//# sourceMappingURL=closure.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"closure.js","sourceRoot":"","sources":["../../../core/scope/closure.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,6EAA6E;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,WAAwB,EAAE,KAAmB;IACzE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAEpD,0CAA0C;IAC1C,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACrC,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;QACvC,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,6CAA6C;IAC7C,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,iBAAiB,EAAE,CAAC;QACvD,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa;YAAE,SAAS;QAE7B,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC7B,SAAS,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;YACpC,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC7B,SAAS,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;QACpC,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,aAAa,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;gBACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;oBACvE,6CAA6C;oBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;oBACpE,IAAI,MAAM,EAAE,CAAC;wBACX,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;wBAChC,SAAS,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;QACxB,SAAS,EAAE,CAAC,GAAG,YAAY,CAAC;QAC5B,SAAS;KACV,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gate rules G1-G7 for scope validation.
|
|
3
|
+
*
|
|
4
|
+
* Gates are classified as:
|
|
5
|
+
* - Abort gates (G1-G4): fail the pipeline, exit 7
|
|
6
|
+
* - Review gates (G5-G7): continue with review_flags
|
|
7
|
+
*
|
|
8
|
+
* Spec §8.3 / RF-34, RF-35, RF-40, RF-41.
|
|
9
|
+
*/
|
|
10
|
+
import type { CatalogIndex } from "../catalog/index-model.js";
|
|
11
|
+
import type { ScopeOutput } from "./types.js";
|
|
12
|
+
import type { ClosureResult } from "./closure.js";
|
|
13
|
+
export interface GateOptions {
|
|
14
|
+
/** Maximum total components (primary + secondary) before G1 abort. Default: 4. */
|
|
15
|
+
maxComponents?: number;
|
|
16
|
+
}
|
|
17
|
+
export interface GateViolation {
|
|
18
|
+
rule: string;
|
|
19
|
+
message: string;
|
|
20
|
+
}
|
|
21
|
+
export interface GateSuccess {
|
|
22
|
+
passed: true;
|
|
23
|
+
reviewFlags: GateViolation[];
|
|
24
|
+
}
|
|
25
|
+
export interface GateAbort {
|
|
26
|
+
passed: false;
|
|
27
|
+
abortReason: string;
|
|
28
|
+
abortRule: string;
|
|
29
|
+
reviewFlags: GateViolation[];
|
|
30
|
+
}
|
|
31
|
+
export type GateResult = GateSuccess | GateAbort;
|
|
32
|
+
/**
|
|
33
|
+
* Run all gate rules G1-G7 against the expanded scope.
|
|
34
|
+
*
|
|
35
|
+
* Abort gates (G1-G4) are checked first. If any abort gate triggers, the
|
|
36
|
+
* pipeline stops immediately.
|
|
37
|
+
*
|
|
38
|
+
* Review gates (G5-G7) are accumulated as review_flags.
|
|
39
|
+
*/
|
|
40
|
+
export declare function runGate(scopeOutput: ScopeOutput, closureResult: ClosureResult, index: CatalogIndex, options?: GateOptions): GateResult;
|
|
41
|
+
//# sourceMappingURL=gate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../core/scope/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,KAAK,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAQjD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,WAAgB,GACxB,UAAU,CAmGZ"}
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gate rules G1-G7 for scope validation.
|
|
3
|
+
*
|
|
4
|
+
* Gates are classified as:
|
|
5
|
+
* - Abort gates (G1-G4): fail the pipeline, exit 7
|
|
6
|
+
* - Review gates (G5-G7): continue with review_flags
|
|
7
|
+
*
|
|
8
|
+
* Spec §8.3 / RF-34, RF-35, RF-40, RF-41.
|
|
9
|
+
*/
|
|
10
|
+
/* ─── Constants ───────────────────────────────────────────────────────── */
|
|
11
|
+
const DEFAULT_MAX_COMPONENTS = 4;
|
|
12
|
+
/* ─── Public API ──────────────────────────────────────────────────────── */
|
|
13
|
+
/**
|
|
14
|
+
* Run all gate rules G1-G7 against the expanded scope.
|
|
15
|
+
*
|
|
16
|
+
* Abort gates (G1-G4) are checked first. If any abort gate triggers, the
|
|
17
|
+
* pipeline stops immediately.
|
|
18
|
+
*
|
|
19
|
+
* Review gates (G5-G7) are accumulated as review_flags.
|
|
20
|
+
*/
|
|
21
|
+
export function runGate(scopeOutput, closureResult, index, options = {}) {
|
|
22
|
+
const maxComponents = options.maxComponents ?? DEFAULT_MAX_COMPONENTS;
|
|
23
|
+
const reviewFlags = [];
|
|
24
|
+
// ─── Abort Gates (G1-G4) ─────────────────────────────────────────
|
|
25
|
+
// G1: total components > maxComponents → abort
|
|
26
|
+
const totalComponents = closureResult.primary.length + closureResult.secondary.length;
|
|
27
|
+
if (totalComponents > maxComponents) {
|
|
28
|
+
return {
|
|
29
|
+
passed: false,
|
|
30
|
+
abortReason: `Total components (${totalComponents}) exceeds maximum (${maxComponents}). Consider splitting the task.`,
|
|
31
|
+
abortRule: "G1",
|
|
32
|
+
reviewFlags,
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
// G2: confidence: low → abort
|
|
36
|
+
if (scopeOutput.confidence === "low") {
|
|
37
|
+
return {
|
|
38
|
+
passed: false,
|
|
39
|
+
abortReason: `Scope confidence is "low" — the task may be ambiguous or too broad.`,
|
|
40
|
+
abortRule: "G2",
|
|
41
|
+
reviewFlags,
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
// G3: non-empty unresolved → abort
|
|
45
|
+
if (scopeOutput.unresolved.length > 0) {
|
|
46
|
+
return {
|
|
47
|
+
passed: false,
|
|
48
|
+
abortReason: `Unresolved capabilities: ${scopeOutput.unresolved.join(", ")}. Cannot proceed with unmapped scope.`,
|
|
49
|
+
abortRule: "G3",
|
|
50
|
+
reviewFlags,
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
// G4: component in scope without component.json in catalog → abort
|
|
54
|
+
const allScopeIds = [...closureResult.primary, ...closureResult.secondary];
|
|
55
|
+
for (const id of allScopeIds) {
|
|
56
|
+
const comp = index.components.find((c) => c.id === id);
|
|
57
|
+
if (!comp) {
|
|
58
|
+
return {
|
|
59
|
+
passed: false,
|
|
60
|
+
abortReason: `Component "${id}" is in scope but has no entry in the catalog index.`,
|
|
61
|
+
abortRule: "G4",
|
|
62
|
+
reviewFlags,
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
// ─── Review Gates (G5-G7) ────────────────────────────────────────
|
|
67
|
+
// G5: LLM-selected component absent from candidates+closure (RF-40)
|
|
68
|
+
// A component selected by the LLM that was not in the original candidates
|
|
69
|
+
// and also not added by closure. This is a soft signal — may be valid but unusual.
|
|
70
|
+
const closureSourceMap = closureResult.sourceMap;
|
|
71
|
+
for (const id of scopeOutput.primary) {
|
|
72
|
+
if (closureSourceMap[id] === "llm") {
|
|
73
|
+
// Check if this component was only in the LLM output but not reachable via closure
|
|
74
|
+
// We flag if the component is not a neighbor of any other scope member
|
|
75
|
+
const isIsolated = isComponentIsolated(id, closureResult, index);
|
|
76
|
+
if (isIsolated) {
|
|
77
|
+
reviewFlags.push({
|
|
78
|
+
rule: "G5",
|
|
79
|
+
message: `Primary component "${id}" is not reachable via graph closure from other scope members. Verify its inclusion is intentional.`,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
// G6: scope spans >2 domains
|
|
85
|
+
const domains = getUniqueDomains(allScopeIds, index);
|
|
86
|
+
if (domains.size > 2) {
|
|
87
|
+
reviewFlags.push({
|
|
88
|
+
rule: "G6",
|
|
89
|
+
message: `Scope spans ${domains.size} domains (${[...domains].join(", ")}). Cross-domain changes increase coordination risk.`,
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
// G7: boundary contract has payload_confidence: low (RF-41)
|
|
93
|
+
for (const contractId of scopeOutput.contracts_crossed) {
|
|
94
|
+
const contractEntry = index.contracts[contractId];
|
|
95
|
+
if (!contractEntry)
|
|
96
|
+
continue;
|
|
97
|
+
// Look up the provider's provides entry for this contract
|
|
98
|
+
const provider = index.components.find((c) => c.id === contractEntry.provider);
|
|
99
|
+
if (!provider)
|
|
100
|
+
continue;
|
|
101
|
+
const providesEntry = provider.provides.find((p) => p.id === contractId);
|
|
102
|
+
if (providesEntry && providesEntry.payload_confidence === "low") {
|
|
103
|
+
reviewFlags.push({
|
|
104
|
+
rule: "G7",
|
|
105
|
+
message: `Boundary contract "${contractId}" has payload_confidence: low. Breaking-change detection may produce false positives.`,
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
return { passed: true, reviewFlags };
|
|
110
|
+
}
|
|
111
|
+
/* ─── Internal Helpers ────────────────────────────────────────────────── */
|
|
112
|
+
/**
|
|
113
|
+
* Check if a component is isolated (not a graph neighbor of any other scope member).
|
|
114
|
+
* Used for G5 detection.
|
|
115
|
+
*/
|
|
116
|
+
function isComponentIsolated(componentId, closureResult, index) {
|
|
117
|
+
const otherScope = [
|
|
118
|
+
...closureResult.primary.filter((id) => id !== componentId),
|
|
119
|
+
...closureResult.secondary,
|
|
120
|
+
];
|
|
121
|
+
if (otherScope.length === 0)
|
|
122
|
+
return false; // single component, not isolated by definition
|
|
123
|
+
const comp = index.components.find((c) => c.id === componentId);
|
|
124
|
+
if (!comp)
|
|
125
|
+
return true;
|
|
126
|
+
// Check if this component shares any contracts with scope members
|
|
127
|
+
// (either as provider or consumer)
|
|
128
|
+
for (const otherId of otherScope) {
|
|
129
|
+
const other = index.components.find((c) => c.id === otherId);
|
|
130
|
+
if (!other)
|
|
131
|
+
continue;
|
|
132
|
+
// Check if comp provides something other consumes
|
|
133
|
+
for (const p of comp.provides) {
|
|
134
|
+
if (other.consumes.some((c) => c.contract === p.id))
|
|
135
|
+
return false;
|
|
136
|
+
}
|
|
137
|
+
// Check if comp consumes something other provides
|
|
138
|
+
for (const c of comp.consumes) {
|
|
139
|
+
if (other.provides.some((p) => p.id === c.contract))
|
|
140
|
+
return false;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
// Check if they share a flow
|
|
144
|
+
for (const flow of index.flows) {
|
|
145
|
+
if (flow.participants.includes(componentId) &&
|
|
146
|
+
flow.participants.some((p) => otherScope.includes(p))) {
|
|
147
|
+
return false;
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
return true;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* Get unique domains for a set of component ids.
|
|
154
|
+
*/
|
|
155
|
+
function getUniqueDomains(componentIds, index) {
|
|
156
|
+
const domains = new Set();
|
|
157
|
+
for (const id of componentIds) {
|
|
158
|
+
const comp = index.components.find((c) => c.id === id);
|
|
159
|
+
if (comp) {
|
|
160
|
+
domains.add(comp.domain);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
return domains;
|
|
164
|
+
}
|
|
165
|
+
//# sourceMappingURL=gate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../../core/scope/gate.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Scope module —
|
|
2
|
+
* Scope module — LLM-assisted scoping with schema validation and repair retry.
|
|
3
|
+
* Includes graph closure expansion and gate rules.
|
|
3
4
|
*/
|
|
4
|
-
export {};
|
|
5
|
+
export { runScoping, EXIT_INVALID_SCOPE } from "./scoping.js";
|
|
6
|
+
export type { ScopingOptions, ScopingResult, ScopingSuccess, ScopingFailure } from "./scoping.js";
|
|
7
|
+
export { buildScopingInput, serializeScopingInput, SCOPING_SYSTEM_PROMPT } from "./prompt.js";
|
|
8
|
+
export { validateScopeSchema, validateScopeIds, parseLlmResponse } from "./validate.js";
|
|
9
|
+
export type { ValidationResult, IdValidationResult } from "./validate.js";
|
|
10
|
+
export { buildCalibrationRecord, writeCalibrationRecord, hashTaskText } from "./calibration.js";
|
|
11
|
+
export { expandClosure } from "./closure.js";
|
|
12
|
+
export type { ClosureResult, ScopeSource, ScopeSourceMap } from "./closure.js";
|
|
13
|
+
export { runGate } from "./gate.js";
|
|
14
|
+
export type { GateOptions, GateResult, GateSuccess, GateAbort, GateViolation } from "./gate.js";
|
|
15
|
+
export { buildPartitionProposal } from "./partition.js";
|
|
16
|
+
export type { PartitionProposal, PartitionEntry } from "./partition.js";
|
|
17
|
+
export type { ScopeOutput, ScopingInput, ScopingCandidate, ScopingFlow, ScopingDomain, CalibrationRecord, LlmScopeProvider, } from "./types.js";
|
|
5
18
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/scope/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/scope/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
|
package/dist/core/scope/index.js
CHANGED
|
@@ -1,2 +1,12 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Scope module — LLM-assisted scoping with schema validation and repair retry.
|
|
3
|
+
* Includes graph closure expansion and gate rules.
|
|
4
|
+
*/
|
|
5
|
+
export { runScoping, EXIT_INVALID_SCOPE } from "./scoping.js";
|
|
6
|
+
export { buildScopingInput, serializeScopingInput, SCOPING_SYSTEM_PROMPT } from "./prompt.js";
|
|
7
|
+
export { validateScopeSchema, validateScopeIds, parseLlmResponse } from "./validate.js";
|
|
8
|
+
export { buildCalibrationRecord, writeCalibrationRecord, hashTaskText } from "./calibration.js";
|
|
9
|
+
export { expandClosure } from "./closure.js";
|
|
10
|
+
export { runGate } from "./gate.js";
|
|
11
|
+
export { buildPartitionProposal } from "./partition.js";
|
|
2
12
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/scope/index.ts"],"names":[],"mappings":""}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/scope/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Partition proposal for G1 abort.
|
|
3
|
+
*
|
|
4
|
+
* Groups components by domain/boundary and orders producer-before-consumers.
|
|
5
|
+
* Emitted as a suggested task split when scope is over-broad.
|
|
6
|
+
*
|
|
7
|
+
* Spec §8.3 / RF-35.
|
|
8
|
+
*/
|
|
9
|
+
import type { CatalogIndex } from "../catalog/index-model.js";
|
|
10
|
+
import type { ClosureResult } from "./closure.js";
|
|
11
|
+
export interface PartitionEntry {
|
|
12
|
+
/** Suggested sub-task label */
|
|
13
|
+
label: string;
|
|
14
|
+
/** Component IDs in this partition */
|
|
15
|
+
components: string[];
|
|
16
|
+
/** Domain of the partition */
|
|
17
|
+
domain: string;
|
|
18
|
+
/** Ordering priority (lower = earlier). Producers get lower numbers. */
|
|
19
|
+
order: number;
|
|
20
|
+
}
|
|
21
|
+
export interface PartitionProposal {
|
|
22
|
+
/** Ordered list of partition entries (producer-first) */
|
|
23
|
+
partitions: PartitionEntry[];
|
|
24
|
+
/** Reasoning for the split */
|
|
25
|
+
rationale: string;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Generate a partition proposal for an over-broad scope.
|
|
29
|
+
*
|
|
30
|
+
* Strategy:
|
|
31
|
+
* 1. Group components by domain
|
|
32
|
+
* 2. Within each domain group, identify producers and consumers
|
|
33
|
+
* 3. Order: producers first (components that provide contracts consumed by others in scope)
|
|
34
|
+
*/
|
|
35
|
+
export declare function buildPartitionProposal(closureResult: ClosureResult, index: CatalogIndex): PartitionProposal;
|
|
36
|
+
//# sourceMappingURL=partition.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"partition.d.ts","sourceRoot":"","sources":["../../../core/scope/partition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,YAAY,GAClB,iBAAiB,CA2DnB"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Partition proposal for G1 abort.
|
|
3
|
+
*
|
|
4
|
+
* Groups components by domain/boundary and orders producer-before-consumers.
|
|
5
|
+
* Emitted as a suggested task split when scope is over-broad.
|
|
6
|
+
*
|
|
7
|
+
* Spec §8.3 / RF-35.
|
|
8
|
+
*/
|
|
9
|
+
/* ─── Public API ──────────────────────────────────────────────────────── */
|
|
10
|
+
/**
|
|
11
|
+
* Generate a partition proposal for an over-broad scope.
|
|
12
|
+
*
|
|
13
|
+
* Strategy:
|
|
14
|
+
* 1. Group components by domain
|
|
15
|
+
* 2. Within each domain group, identify producers and consumers
|
|
16
|
+
* 3. Order: producers first (components that provide contracts consumed by others in scope)
|
|
17
|
+
*/
|
|
18
|
+
export function buildPartitionProposal(closureResult, index) {
|
|
19
|
+
const allIds = [...closureResult.primary, ...closureResult.secondary];
|
|
20
|
+
const allIdsSet = new Set(allIds);
|
|
21
|
+
// Group by domain
|
|
22
|
+
const domainGroups = new Map();
|
|
23
|
+
for (const id of allIds) {
|
|
24
|
+
const comp = index.components.find((c) => c.id === id);
|
|
25
|
+
if (!comp)
|
|
26
|
+
continue;
|
|
27
|
+
const domain = comp.domain;
|
|
28
|
+
if (!domainGroups.has(domain)) {
|
|
29
|
+
domainGroups.set(domain, []);
|
|
30
|
+
}
|
|
31
|
+
domainGroups.get(domain).push(id);
|
|
32
|
+
}
|
|
33
|
+
// Compute producer score: how many in-scope components consume from this component
|
|
34
|
+
const producerScore = new Map();
|
|
35
|
+
for (const id of allIds) {
|
|
36
|
+
const comp = index.components.find((c) => c.id === id);
|
|
37
|
+
if (!comp)
|
|
38
|
+
continue;
|
|
39
|
+
let score = 0;
|
|
40
|
+
for (const provides of comp.provides) {
|
|
41
|
+
// Count how many in-scope components consume this contract
|
|
42
|
+
const consumers = index.contracts[provides.id]?.consumers ?? [];
|
|
43
|
+
score += consumers.filter((c) => allIdsSet.has(c) && c !== id).length;
|
|
44
|
+
}
|
|
45
|
+
producerScore.set(id, score);
|
|
46
|
+
}
|
|
47
|
+
// Build partitions ordered by domain, producers first within each domain
|
|
48
|
+
const partitions = [];
|
|
49
|
+
let orderCounter = 0;
|
|
50
|
+
// Sort domains: domains with higher aggregate producer scores come first
|
|
51
|
+
const domainOrder = [...domainGroups.entries()].sort((a, b) => {
|
|
52
|
+
const scoreA = a[1].reduce((sum, id) => sum + (producerScore.get(id) ?? 0), 0);
|
|
53
|
+
const scoreB = b[1].reduce((sum, id) => sum + (producerScore.get(id) ?? 0), 0);
|
|
54
|
+
return scoreB - scoreA; // Higher producer score → earlier
|
|
55
|
+
});
|
|
56
|
+
for (const [domain, components] of domainOrder) {
|
|
57
|
+
// Sort within domain: producers first (higher score = earlier)
|
|
58
|
+
const sorted = [...components].sort((a, b) => {
|
|
59
|
+
return (producerScore.get(b) ?? 0) - (producerScore.get(a) ?? 0);
|
|
60
|
+
});
|
|
61
|
+
partitions.push({
|
|
62
|
+
label: `${domain}: ${sorted.join(", ")}`,
|
|
63
|
+
components: sorted,
|
|
64
|
+
domain,
|
|
65
|
+
order: orderCounter++,
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
const rationale = buildRationale(partitions, allIds.length);
|
|
69
|
+
return { partitions, rationale };
|
|
70
|
+
}
|
|
71
|
+
/* ─── Internal ────────────────────────────────────────────────────────── */
|
|
72
|
+
function buildRationale(partitions, totalComponents) {
|
|
73
|
+
if (partitions.length === 1) {
|
|
74
|
+
return `Scope contains ${totalComponents} components in a single domain. Consider breaking into smaller tasks within the domain, implementing producers before consumers.`;
|
|
75
|
+
}
|
|
76
|
+
return `Scope spans ${partitions.length} domains with ${totalComponents} total components. Suggested split: implement each domain group as a separate task, starting with producer domains.`;
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=partition.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"partition.js","sourceRoot":"","sources":["../../../core/scope/partition.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Scoping prompt template and input assembler.
|
|
3
|
+
*
|
|
4
|
+
* The scoping prompt instructs the LLM to:
|
|
5
|
+
* - Choose only from provided candidates
|
|
6
|
+
* - Use `low` confidence when ambiguous
|
|
7
|
+
* - List unmapped capabilities in `unresolved`
|
|
8
|
+
*
|
|
9
|
+
* The input assembler builds the constrained input containing only:
|
|
10
|
+
* task, candidates, flows, domains (spec §7.1).
|
|
11
|
+
*/
|
|
12
|
+
import type { ResolveCandidate } from "../catalog/resolve.js";
|
|
13
|
+
import type { CatalogIndex } from "../catalog/index-model.js";
|
|
14
|
+
import type { ScopingInput } from "./types.js";
|
|
15
|
+
/**
|
|
16
|
+
* The system prompt for the scoping LLM call.
|
|
17
|
+
* Instructs the model on constraints and output format.
|
|
18
|
+
*/
|
|
19
|
+
export declare const SCOPING_SYSTEM_PROMPT = "You are a code-change scoping assistant. Your task is to determine which components from a service catalog are affected by a given task description.\n\n## Rules\n\n1. **Only choose from the provided candidates list.** Never invent component ids.\n2. When ambiguous or uncertain, set confidence to \"low\".\n3. Any capability the task mentions that you cannot map to a candidate MUST be listed in \"unresolved\".\n4. Primary components are those that need a code change. Secondary are needed for understanding context only.\n5. Primary: 1 to 6 items. Secondary: 0 to 8 items.\n6. Contracts crossed: list contract ids from provides/consumes that the task touches or depends on.\n7. Rationale: explain your reasoning in at most 600 characters.\n\n## Output Format\n\nReturn a single JSON object conforming to this structure:\n{\n \"schemaVersion\": \"1.0.0\",\n \"primary\": [\"<component-id>\", ...],\n \"secondary\": [\"<component-id>\", ...],\n \"contracts_crossed\": [\"<contract-id>\", ...],\n \"confidence\": \"high\" | \"medium\" | \"low\",\n \"unresolved\": [\"<capability-description>\", ...],\n \"rationale\": \"<explanation, max 600 chars>\",\n \"flow\": \"<optional flow-id>\"\n}\n\nReturn ONLY the JSON object. No markdown, no explanation, no wrapping.";
|
|
20
|
+
/**
|
|
21
|
+
* The repair prompt sent when the first LLM response fails validation.
|
|
22
|
+
*/
|
|
23
|
+
export declare const REPAIR_PROMPT_PREFIX = "Your previous response failed validation with the following errors:\n\n";
|
|
24
|
+
export declare const REPAIR_PROMPT_SUFFIX = "\n\nPlease fix the issues and return a corrected JSON object. Remember:\n- Only use component ids from the candidates list provided earlier.\n- Follow the exact schema (required: schemaVersion, primary, secondary, contracts_crossed, confidence, unresolved, rationale).\n- Rationale must be at most 600 characters.\n- Return ONLY the JSON object.";
|
|
25
|
+
/**
|
|
26
|
+
* Build the scoping input from task text and resolve results.
|
|
27
|
+
* The input contains ONLY task, candidates, flows, and domains — never the full catalog.
|
|
28
|
+
*
|
|
29
|
+
* @param taskText - The task description text
|
|
30
|
+
* @param resolveResults - Candidate components from the resolve step
|
|
31
|
+
* @param index - The catalog index (used to look up component details, flows, domains)
|
|
32
|
+
* @returns The constrained scoping input
|
|
33
|
+
*/
|
|
34
|
+
export declare function buildScopingInput(taskText: string, resolveResults: ResolveCandidate[], index: CatalogIndex): ScopingInput;
|
|
35
|
+
/**
|
|
36
|
+
* Serialize the scoping input to a string for the LLM user message.
|
|
37
|
+
*/
|
|
38
|
+
export declare function serializeScopingInput(input: ScopingInput): string;
|
|
39
|
+
//# sourceMappingURL=prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../core/scope/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAgD,MAAM,YAAY,CAAC;AAI7F;;;GAGG;AACH,eAAO,MAAM,qBAAqB,2vCA0BqC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,4EAEhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,8VAMF,CAAC;AAIhC;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,gBAAgB,EAAE,EAClC,KAAK,EAAE,YAAY,GAClB,YAAY,CA4Bd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEjE"}
|