@soleri/core 2.1.0 → 2.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/brain/brain.d.ts +10 -1
- package/dist/brain/brain.d.ts.map +1 -1
- package/dist/brain/brain.js +116 -13
- package/dist/brain/brain.js.map +1 -1
- package/dist/brain/intelligence.d.ts +36 -1
- package/dist/brain/intelligence.d.ts.map +1 -1
- package/dist/brain/intelligence.js +119 -14
- package/dist/brain/intelligence.js.map +1 -1
- package/dist/brain/types.d.ts +34 -2
- package/dist/brain/types.d.ts.map +1 -1
- package/dist/cognee/client.d.ts +3 -0
- package/dist/cognee/client.d.ts.map +1 -1
- package/dist/cognee/client.js +17 -0
- package/dist/cognee/client.js.map +1 -1
- package/dist/cognee/sync-manager.d.ts +94 -0
- package/dist/cognee/sync-manager.d.ts.map +1 -0
- package/dist/cognee/sync-manager.js +293 -0
- package/dist/cognee/sync-manager.js.map +1 -0
- package/dist/control/identity-manager.d.ts +22 -0
- package/dist/control/identity-manager.d.ts.map +1 -0
- package/dist/control/identity-manager.js +233 -0
- package/dist/control/identity-manager.js.map +1 -0
- package/dist/control/intent-router.d.ts +32 -0
- package/dist/control/intent-router.d.ts.map +1 -0
- package/dist/control/intent-router.js +242 -0
- package/dist/control/intent-router.js.map +1 -0
- package/dist/control/types.d.ts +68 -0
- package/dist/control/types.d.ts.map +1 -0
- package/dist/control/types.js +9 -0
- package/dist/control/types.js.map +1 -0
- package/dist/curator/curator.d.ts +37 -1
- package/dist/curator/curator.d.ts.map +1 -1
- package/dist/curator/curator.js +199 -1
- package/dist/curator/curator.js.map +1 -1
- package/dist/errors/classify.d.ts +13 -0
- package/dist/errors/classify.d.ts.map +1 -0
- package/dist/errors/classify.js +97 -0
- package/dist/errors/classify.js.map +1 -0
- package/dist/errors/index.d.ts +6 -0
- package/dist/errors/index.d.ts.map +1 -0
- package/dist/errors/index.js +4 -0
- package/dist/errors/index.js.map +1 -0
- package/dist/errors/retry.d.ts +40 -0
- package/dist/errors/retry.d.ts.map +1 -0
- package/dist/errors/retry.js +97 -0
- package/dist/errors/retry.js.map +1 -0
- package/dist/errors/types.d.ts +48 -0
- package/dist/errors/types.d.ts.map +1 -0
- package/dist/errors/types.js +59 -0
- package/dist/errors/types.js.map +1 -0
- package/dist/facades/types.d.ts +1 -1
- package/dist/governance/governance.d.ts +42 -0
- package/dist/governance/governance.d.ts.map +1 -0
- package/dist/governance/governance.js +488 -0
- package/dist/governance/governance.js.map +1 -0
- package/dist/governance/index.d.ts +3 -0
- package/dist/governance/index.d.ts.map +1 -0
- package/dist/governance/index.js +2 -0
- package/dist/governance/index.js.map +1 -0
- package/dist/governance/types.d.ts +102 -0
- package/dist/governance/types.d.ts.map +1 -0
- package/dist/governance/types.js +3 -0
- package/dist/governance/types.js.map +1 -0
- package/dist/index.d.ts +52 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +47 -1
- package/dist/index.js.map +1 -1
- package/dist/intake/content-classifier.d.ts +14 -0
- package/dist/intake/content-classifier.d.ts.map +1 -0
- package/dist/intake/content-classifier.js +125 -0
- package/dist/intake/content-classifier.js.map +1 -0
- package/dist/intake/dedup-gate.d.ts +17 -0
- package/dist/intake/dedup-gate.d.ts.map +1 -0
- package/dist/intake/dedup-gate.js +66 -0
- package/dist/intake/dedup-gate.js.map +1 -0
- package/dist/intake/intake-pipeline.d.ts +63 -0
- package/dist/intake/intake-pipeline.d.ts.map +1 -0
- package/dist/intake/intake-pipeline.js +373 -0
- package/dist/intake/intake-pipeline.js.map +1 -0
- package/dist/intake/types.d.ts +65 -0
- package/dist/intake/types.d.ts.map +1 -0
- package/dist/intake/types.js +3 -0
- package/dist/intake/types.js.map +1 -0
- package/dist/intelligence/loader.js +1 -1
- package/dist/intelligence/loader.js.map +1 -1
- package/dist/intelligence/types.d.ts +3 -1
- package/dist/intelligence/types.d.ts.map +1 -1
- package/dist/logging/logger.d.ts +37 -0
- package/dist/logging/logger.d.ts.map +1 -0
- package/dist/logging/logger.js +145 -0
- package/dist/logging/logger.js.map +1 -0
- package/dist/logging/types.d.ts +19 -0
- package/dist/logging/types.d.ts.map +1 -0
- package/dist/logging/types.js +2 -0
- package/dist/logging/types.js.map +1 -0
- package/dist/loop/loop-manager.d.ts +100 -0
- package/dist/loop/loop-manager.d.ts.map +1 -0
- package/dist/loop/loop-manager.js +379 -0
- package/dist/loop/loop-manager.js.map +1 -0
- package/dist/loop/types.d.ts +103 -0
- package/dist/loop/types.d.ts.map +1 -0
- package/dist/loop/types.js +11 -0
- package/dist/loop/types.js.map +1 -0
- package/dist/persistence/index.d.ts +3 -0
- package/dist/persistence/index.d.ts.map +1 -0
- package/dist/persistence/index.js +2 -0
- package/dist/persistence/index.js.map +1 -0
- package/dist/persistence/sqlite-provider.d.ts +25 -0
- package/dist/persistence/sqlite-provider.d.ts.map +1 -0
- package/dist/persistence/sqlite-provider.js +59 -0
- package/dist/persistence/sqlite-provider.js.map +1 -0
- package/dist/persistence/types.d.ts +36 -0
- package/dist/persistence/types.d.ts.map +1 -0
- package/dist/persistence/types.js +8 -0
- package/dist/persistence/types.js.map +1 -0
- package/dist/planning/gap-analysis.d.ts +72 -0
- package/dist/planning/gap-analysis.d.ts.map +1 -0
- package/dist/planning/gap-analysis.js +442 -0
- package/dist/planning/gap-analysis.js.map +1 -0
- package/dist/planning/gap-types.d.ts +29 -0
- package/dist/planning/gap-types.d.ts.map +1 -0
- package/dist/planning/gap-types.js +28 -0
- package/dist/planning/gap-types.js.map +1 -0
- package/dist/planning/planner.d.ts +421 -4
- package/dist/planning/planner.d.ts.map +1 -1
- package/dist/planning/planner.js +949 -21
- package/dist/planning/planner.js.map +1 -1
- package/dist/playbooks/generic/brainstorming.d.ts +9 -0
- package/dist/playbooks/generic/brainstorming.d.ts.map +1 -0
- package/dist/playbooks/generic/brainstorming.js +105 -0
- package/dist/playbooks/generic/brainstorming.js.map +1 -0
- package/dist/playbooks/generic/code-review.d.ts +11 -0
- package/dist/playbooks/generic/code-review.d.ts.map +1 -0
- package/dist/playbooks/generic/code-review.js +176 -0
- package/dist/playbooks/generic/code-review.js.map +1 -0
- package/dist/playbooks/generic/subagent-execution.d.ts +9 -0
- package/dist/playbooks/generic/subagent-execution.d.ts.map +1 -0
- package/dist/playbooks/generic/subagent-execution.js +68 -0
- package/dist/playbooks/generic/subagent-execution.js.map +1 -0
- package/dist/playbooks/generic/systematic-debugging.d.ts +9 -0
- package/dist/playbooks/generic/systematic-debugging.d.ts.map +1 -0
- package/dist/playbooks/generic/systematic-debugging.js +87 -0
- package/dist/playbooks/generic/systematic-debugging.js.map +1 -0
- package/dist/playbooks/generic/tdd.d.ts +9 -0
- package/dist/playbooks/generic/tdd.d.ts.map +1 -0
- package/dist/playbooks/generic/tdd.js +70 -0
- package/dist/playbooks/generic/tdd.js.map +1 -0
- package/dist/playbooks/generic/verification.d.ts +9 -0
- package/dist/playbooks/generic/verification.d.ts.map +1 -0
- package/dist/playbooks/generic/verification.js +74 -0
- package/dist/playbooks/generic/verification.js.map +1 -0
- package/dist/playbooks/index.d.ts +4 -0
- package/dist/playbooks/index.d.ts.map +1 -0
- package/dist/playbooks/index.js +5 -0
- package/dist/playbooks/index.js.map +1 -0
- package/dist/playbooks/playbook-registry.d.ts +42 -0
- package/dist/playbooks/playbook-registry.d.ts.map +1 -0
- package/dist/playbooks/playbook-registry.js +227 -0
- package/dist/playbooks/playbook-registry.js.map +1 -0
- package/dist/playbooks/playbook-seeder.d.ts +47 -0
- package/dist/playbooks/playbook-seeder.d.ts.map +1 -0
- package/dist/playbooks/playbook-seeder.js +104 -0
- package/dist/playbooks/playbook-seeder.js.map +1 -0
- package/dist/playbooks/playbook-types.d.ts +132 -0
- package/dist/playbooks/playbook-types.d.ts.map +1 -0
- package/dist/playbooks/playbook-types.js +12 -0
- package/dist/playbooks/playbook-types.js.map +1 -0
- package/dist/project/project-registry.d.ts +79 -0
- package/dist/project/project-registry.d.ts.map +1 -0
- package/dist/project/project-registry.js +274 -0
- package/dist/project/project-registry.js.map +1 -0
- package/dist/project/types.d.ts +28 -0
- package/dist/project/types.d.ts.map +1 -0
- package/dist/project/types.js +5 -0
- package/dist/project/types.js.map +1 -0
- package/dist/prompts/index.d.ts +4 -0
- package/dist/prompts/index.d.ts.map +1 -0
- package/dist/prompts/index.js +3 -0
- package/dist/prompts/index.js.map +1 -0
- package/dist/prompts/parser.d.ts +17 -0
- package/dist/prompts/parser.d.ts.map +1 -0
- package/dist/prompts/parser.js +47 -0
- package/dist/prompts/parser.js.map +1 -0
- package/dist/prompts/template-manager.d.ts +25 -0
- package/dist/prompts/template-manager.d.ts.map +1 -0
- package/dist/prompts/template-manager.js +71 -0
- package/dist/prompts/template-manager.js.map +1 -0
- package/dist/prompts/types.d.ts +26 -0
- package/dist/prompts/types.d.ts.map +1 -0
- package/dist/prompts/types.js +5 -0
- package/dist/prompts/types.js.map +1 -0
- package/dist/runtime/admin-extra-ops.d.ts +15 -0
- package/dist/runtime/admin-extra-ops.d.ts.map +1 -0
- package/dist/runtime/admin-extra-ops.js +595 -0
- package/dist/runtime/admin-extra-ops.js.map +1 -0
- package/dist/runtime/admin-ops.d.ts +15 -0
- package/dist/runtime/admin-ops.d.ts.map +1 -0
- package/dist/runtime/admin-ops.js +329 -0
- package/dist/runtime/admin-ops.js.map +1 -0
- package/dist/runtime/capture-ops.d.ts +15 -0
- package/dist/runtime/capture-ops.d.ts.map +1 -0
- package/dist/runtime/capture-ops.js +363 -0
- package/dist/runtime/capture-ops.js.map +1 -0
- package/dist/runtime/cognee-sync-ops.d.ts +12 -0
- package/dist/runtime/cognee-sync-ops.d.ts.map +1 -0
- package/dist/runtime/cognee-sync-ops.js +55 -0
- package/dist/runtime/cognee-sync-ops.js.map +1 -0
- package/dist/runtime/core-ops.d.ts +9 -3
- package/dist/runtime/core-ops.d.ts.map +1 -1
- package/dist/runtime/core-ops.js +693 -10
- package/dist/runtime/core-ops.js.map +1 -1
- package/dist/runtime/curator-extra-ops.d.ts +9 -0
- package/dist/runtime/curator-extra-ops.d.ts.map +1 -0
- package/dist/runtime/curator-extra-ops.js +71 -0
- package/dist/runtime/curator-extra-ops.js.map +1 -0
- package/dist/runtime/domain-ops.d.ts.map +1 -1
- package/dist/runtime/domain-ops.js +61 -15
- package/dist/runtime/domain-ops.js.map +1 -1
- package/dist/runtime/grading-ops.d.ts +14 -0
- package/dist/runtime/grading-ops.d.ts.map +1 -0
- package/dist/runtime/grading-ops.js +105 -0
- package/dist/runtime/grading-ops.js.map +1 -0
- package/dist/runtime/intake-ops.d.ts +14 -0
- package/dist/runtime/intake-ops.d.ts.map +1 -0
- package/dist/runtime/intake-ops.js +110 -0
- package/dist/runtime/intake-ops.js.map +1 -0
- package/dist/runtime/loop-ops.d.ts +14 -0
- package/dist/runtime/loop-ops.d.ts.map +1 -0
- package/dist/runtime/loop-ops.js +251 -0
- package/dist/runtime/loop-ops.js.map +1 -0
- package/dist/runtime/memory-cross-project-ops.d.ts +12 -0
- package/dist/runtime/memory-cross-project-ops.d.ts.map +1 -0
- package/dist/runtime/memory-cross-project-ops.js +165 -0
- package/dist/runtime/memory-cross-project-ops.js.map +1 -0
- package/dist/runtime/memory-extra-ops.d.ts +13 -0
- package/dist/runtime/memory-extra-ops.d.ts.map +1 -0
- package/dist/runtime/memory-extra-ops.js +173 -0
- package/dist/runtime/memory-extra-ops.js.map +1 -0
- package/dist/runtime/orchestrate-ops.d.ts +17 -0
- package/dist/runtime/orchestrate-ops.d.ts.map +1 -0
- package/dist/runtime/orchestrate-ops.js +246 -0
- package/dist/runtime/orchestrate-ops.js.map +1 -0
- package/dist/runtime/planning-extra-ops.d.ts +25 -0
- package/dist/runtime/planning-extra-ops.d.ts.map +1 -0
- package/dist/runtime/planning-extra-ops.js +663 -0
- package/dist/runtime/planning-extra-ops.js.map +1 -0
- package/dist/runtime/playbook-ops.d.ts +14 -0
- package/dist/runtime/playbook-ops.d.ts.map +1 -0
- package/dist/runtime/playbook-ops.js +141 -0
- package/dist/runtime/playbook-ops.js.map +1 -0
- package/dist/runtime/project-ops.d.ts +15 -0
- package/dist/runtime/project-ops.d.ts.map +1 -0
- package/dist/runtime/project-ops.js +186 -0
- package/dist/runtime/project-ops.js.map +1 -0
- package/dist/runtime/runtime.d.ts.map +1 -1
- package/dist/runtime/runtime.js +65 -3
- package/dist/runtime/runtime.js.map +1 -1
- package/dist/runtime/types.d.ts +29 -0
- package/dist/runtime/types.d.ts.map +1 -1
- package/dist/runtime/vault-extra-ops.d.ts +10 -0
- package/dist/runtime/vault-extra-ops.d.ts.map +1 -0
- package/dist/runtime/vault-extra-ops.js +536 -0
- package/dist/runtime/vault-extra-ops.js.map +1 -0
- package/dist/telemetry/telemetry.d.ts +48 -0
- package/dist/telemetry/telemetry.d.ts.map +1 -0
- package/dist/telemetry/telemetry.js +87 -0
- package/dist/telemetry/telemetry.js.map +1 -0
- package/dist/vault/playbook.d.ts +34 -0
- package/dist/vault/playbook.d.ts.map +1 -0
- package/dist/vault/playbook.js +60 -0
- package/dist/vault/playbook.js.map +1 -0
- package/dist/vault/vault.d.ts +97 -4
- package/dist/vault/vault.d.ts.map +1 -1
- package/dist/vault/vault.js +424 -65
- package/dist/vault/vault.js.map +1 -1
- package/package.json +7 -3
- package/src/__tests__/admin-extra-ops.test.ts +467 -0
- package/src/__tests__/admin-ops.test.ts +271 -0
- package/src/__tests__/brain-intelligence.test.ts +205 -0
- package/src/__tests__/brain.test.ts +134 -3
- package/src/__tests__/capture-ops.test.ts +509 -0
- package/src/__tests__/cognee-integration.test.ts +80 -0
- package/src/__tests__/cognee-sync-manager.test.ts +103 -0
- package/src/__tests__/core-ops.test.ts +292 -2
- package/src/__tests__/curator-extra-ops.test.ts +381 -0
- package/src/__tests__/domain-ops.test.ts +66 -0
- package/src/__tests__/errors.test.ts +388 -0
- package/src/__tests__/governance.test.ts +522 -0
- package/src/__tests__/grading-ops.test.ts +361 -0
- package/src/__tests__/identity-manager.test.ts +243 -0
- package/src/__tests__/intake-pipeline.test.ts +162 -0
- package/src/__tests__/intent-router.test.ts +222 -0
- package/src/__tests__/logger.test.ts +200 -0
- package/src/__tests__/loop-ops.test.ts +469 -0
- package/src/__tests__/memory-cross-project-ops.test.ts +248 -0
- package/src/__tests__/memory-extra-ops.test.ts +352 -0
- package/src/__tests__/orchestrate-ops.test.ts +289 -0
- package/src/__tests__/persistence.test.ts +225 -0
- package/src/__tests__/planner.test.ts +416 -7
- package/src/__tests__/planning-extra-ops.test.ts +706 -0
- package/src/__tests__/playbook-registry.test.ts +326 -0
- package/src/__tests__/playbook-seeder.test.ts +163 -0
- package/src/__tests__/playbook.test.ts +389 -0
- package/src/__tests__/project-ops.test.ts +381 -0
- package/src/__tests__/template-manager.test.ts +222 -0
- package/src/__tests__/vault-extra-ops.test.ts +482 -0
- package/src/brain/brain.ts +185 -16
- package/src/brain/intelligence.ts +179 -10
- package/src/brain/types.ts +40 -2
- package/src/cognee/client.ts +18 -0
- package/src/cognee/sync-manager.ts +389 -0
- package/src/control/identity-manager.ts +354 -0
- package/src/control/intent-router.ts +326 -0
- package/src/control/types.ts +102 -0
- package/src/curator/curator.ts +295 -1
- package/src/errors/classify.ts +102 -0
- package/src/errors/index.ts +5 -0
- package/src/errors/retry.ts +132 -0
- package/src/errors/types.ts +81 -0
- package/src/governance/governance.ts +698 -0
- package/src/governance/index.ts +18 -0
- package/src/governance/types.ts +111 -0
- package/src/index.ts +213 -2
- package/src/intake/content-classifier.ts +146 -0
- package/src/intake/dedup-gate.ts +92 -0
- package/src/intake/intake-pipeline.ts +503 -0
- package/src/intake/types.ts +69 -0
- package/src/intelligence/loader.ts +1 -1
- package/src/intelligence/types.ts +3 -1
- package/src/logging/logger.ts +154 -0
- package/src/logging/types.ts +21 -0
- package/src/loop/loop-manager.ts +448 -0
- package/src/loop/types.ts +115 -0
- package/src/persistence/index.ts +7 -0
- package/src/persistence/sqlite-provider.ts +62 -0
- package/src/persistence/types.ts +44 -0
- package/src/planning/gap-analysis.ts +775 -0
- package/src/planning/gap-types.ts +61 -0
- package/src/planning/planner.ts +1273 -24
- package/src/playbooks/generic/brainstorming.ts +110 -0
- package/src/playbooks/generic/code-review.ts +181 -0
- package/src/playbooks/generic/subagent-execution.ts +74 -0
- package/src/playbooks/generic/systematic-debugging.ts +92 -0
- package/src/playbooks/generic/tdd.ts +75 -0
- package/src/playbooks/generic/verification.ts +79 -0
- package/src/playbooks/index.ts +27 -0
- package/src/playbooks/playbook-registry.ts +284 -0
- package/src/playbooks/playbook-seeder.ts +119 -0
- package/src/playbooks/playbook-types.ts +162 -0
- package/src/project/project-registry.ts +370 -0
- package/src/project/types.ts +31 -0
- package/src/prompts/index.ts +3 -0
- package/src/prompts/parser.ts +59 -0
- package/src/prompts/template-manager.ts +77 -0
- package/src/prompts/types.ts +28 -0
- package/src/runtime/admin-extra-ops.ts +652 -0
- package/src/runtime/admin-ops.ts +340 -0
- package/src/runtime/capture-ops.ts +404 -0
- package/src/runtime/cognee-sync-ops.ts +63 -0
- package/src/runtime/core-ops.ts +787 -9
- package/src/runtime/curator-extra-ops.ts +85 -0
- package/src/runtime/domain-ops.ts +67 -15
- package/src/runtime/grading-ops.ts +130 -0
- package/src/runtime/intake-ops.ts +126 -0
- package/src/runtime/loop-ops.ts +277 -0
- package/src/runtime/memory-cross-project-ops.ts +191 -0
- package/src/runtime/memory-extra-ops.ts +186 -0
- package/src/runtime/orchestrate-ops.ts +278 -0
- package/src/runtime/planning-extra-ops.ts +718 -0
- package/src/runtime/playbook-ops.ts +169 -0
- package/src/runtime/project-ops.ts +202 -0
- package/src/runtime/runtime.ts +77 -3
- package/src/runtime/types.ts +29 -0
- package/src/runtime/vault-extra-ops.ts +606 -0
- package/src/telemetry/telemetry.ts +118 -0
- package/src/vault/playbook.ts +87 -0
- package/src/vault/vault.ts +575 -98
|
@@ -0,0 +1,442 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gap analysis engine for plan grading.
|
|
3
|
+
* Ported from Salvador MCP's plan-gap-content.ts / plan-gap-technical.ts /
|
|
4
|
+
* plan-gap-domain.ts / plan-gap-antipattern.ts.
|
|
5
|
+
*
|
|
6
|
+
* 6 built-in passes (always run):
|
|
7
|
+
* 1. Structure — required fields present and sufficiently long
|
|
8
|
+
* 2. Completeness — measurable objectives, decision rationale, scope exclusions
|
|
9
|
+
* 3. Feasibility — overly broad scope, missing dependency awareness
|
|
10
|
+
* 4. Risk — breaking changes without mitigation, missing verification
|
|
11
|
+
* 5. Clarity — ambiguous language, vague criteria
|
|
12
|
+
* 6. Semantic Quality — generic objectives, shallow rationale, non-concrete approach
|
|
13
|
+
*
|
|
14
|
+
* Opt-in pass factories (registered via customPasses):
|
|
15
|
+
* - createToolFeasibilityPass — validates tool_chain entries and ordering
|
|
16
|
+
* - createFlowAlignmentPass — validates flow and target_mode against registries
|
|
17
|
+
* - createAntiPatternPass — detects content anti-patterns and vague criteria
|
|
18
|
+
*/
|
|
19
|
+
import { generateGapId, MIN_OBJECTIVE_LENGTH, MIN_SCOPE_LENGTH, MIN_DECISION_LENGTH, } from './gap-types.js';
|
|
20
|
+
// ─── Helpers ─────────────────────────────────────────────────────
|
|
21
|
+
function gap(severity, category, description, recommendation, location, trigger) {
|
|
22
|
+
return {
|
|
23
|
+
id: generateGapId(),
|
|
24
|
+
severity,
|
|
25
|
+
category,
|
|
26
|
+
description,
|
|
27
|
+
recommendation,
|
|
28
|
+
...(location ? { location } : {}),
|
|
29
|
+
...(trigger ? { _trigger: trigger } : {}),
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
/** Combine all task descriptions + titles into a single text blob for analysis. */
|
|
33
|
+
function taskText(plan) {
|
|
34
|
+
return plan.tasks.map((t) => `${t.title} ${t.description}`).join(' ');
|
|
35
|
+
}
|
|
36
|
+
/** Extract text from a decision (supports both string and structured format). */
|
|
37
|
+
function decisionText(d) {
|
|
38
|
+
return typeof d === 'string' ? d : `${d.decision} ${d.rationale}`;
|
|
39
|
+
}
|
|
40
|
+
/** Combine all decisions into a single text blob. */
|
|
41
|
+
function decisionsText(plan) {
|
|
42
|
+
return plan.decisions.map(decisionText).join(' ');
|
|
43
|
+
}
|
|
44
|
+
/** Check if text contains any of the given patterns (case-insensitive). */
|
|
45
|
+
function containsAny(text, patterns) {
|
|
46
|
+
const lower = text.toLowerCase();
|
|
47
|
+
return patterns.some((p) => lower.includes(p.toLowerCase()));
|
|
48
|
+
}
|
|
49
|
+
// ─── Pass 1: Structure ───────────────────────────────────────────
|
|
50
|
+
function analyzeStructure(plan) {
|
|
51
|
+
const gaps = [];
|
|
52
|
+
if (!plan.objective || plan.objective.trim().length < MIN_OBJECTIVE_LENGTH) {
|
|
53
|
+
gaps.push(gap('critical', 'structure', plan.objective
|
|
54
|
+
? `Objective too short (${plan.objective.trim().length} chars, need ${MIN_OBJECTIVE_LENGTH}+).`
|
|
55
|
+
: 'Plan has no objective.', 'Add a clear objective describing what this plan achieves.', 'objective', 'missing_or_short_objective'));
|
|
56
|
+
}
|
|
57
|
+
if (!plan.scope || plan.scope.trim().length < MIN_SCOPE_LENGTH) {
|
|
58
|
+
gaps.push(gap('critical', 'structure', plan.scope
|
|
59
|
+
? `Scope too short (${plan.scope.trim().length} chars, need ${MIN_SCOPE_LENGTH}+).`
|
|
60
|
+
: 'Plan has no scope defined.', 'Define the scope — what is included and excluded.', 'scope', 'missing_or_short_scope'));
|
|
61
|
+
}
|
|
62
|
+
if (plan.tasks.length === 0) {
|
|
63
|
+
gaps.push(gap('critical', 'structure', 'Plan has no tasks.', 'Add at least one task to make the plan actionable.', 'tasks', 'no_tasks'));
|
|
64
|
+
}
|
|
65
|
+
return gaps;
|
|
66
|
+
}
|
|
67
|
+
// ─── Pass 2: Completeness ────────────────────────────────────────
|
|
68
|
+
const METRIC_PATTERNS = [
|
|
69
|
+
/\d+/,
|
|
70
|
+
/percent/i,
|
|
71
|
+
/reduce/i,
|
|
72
|
+
/increase/i,
|
|
73
|
+
/measure/i,
|
|
74
|
+
/target/i,
|
|
75
|
+
/goal/i,
|
|
76
|
+
/kpi/i,
|
|
77
|
+
/metric/i,
|
|
78
|
+
/benchmark/i,
|
|
79
|
+
];
|
|
80
|
+
const EXCLUSION_KEYWORDS = [
|
|
81
|
+
'not',
|
|
82
|
+
'exclude',
|
|
83
|
+
'outside',
|
|
84
|
+
'beyond',
|
|
85
|
+
'limit',
|
|
86
|
+
'except',
|
|
87
|
+
"won't",
|
|
88
|
+
'will not',
|
|
89
|
+
];
|
|
90
|
+
function analyzeCompleteness(plan) {
|
|
91
|
+
const gaps = [];
|
|
92
|
+
// Objective lacks measurable indicators
|
|
93
|
+
if (plan.objective && !METRIC_PATTERNS.some((p) => p.test(plan.objective))) {
|
|
94
|
+
gaps.push(gap('minor', 'completeness', 'Objective has no measurable targets or metrics.', 'Include quantifiable success criteria (numbers, percentages, concrete outcomes).', 'objective', 'no_metrics_in_objective'));
|
|
95
|
+
}
|
|
96
|
+
// Decisions without rationale-like content
|
|
97
|
+
if (plan.decisions.length > 0) {
|
|
98
|
+
for (let i = 0; i < plan.decisions.length; i++) {
|
|
99
|
+
const d = plan.decisions[i];
|
|
100
|
+
const text = decisionText(d);
|
|
101
|
+
if (text.trim().length < MIN_DECISION_LENGTH) {
|
|
102
|
+
gaps.push(gap('major', 'completeness', `Decision ${i + 1} is too short (${text.trim().length} chars) — lacks rationale.`, 'Expand each decision to include the reasoning (why this choice over alternatives).', `decisions[${i}]`, 'short_decision'));
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
// Scope missing exclusions
|
|
107
|
+
if (plan.scope && !containsAny(plan.scope, EXCLUSION_KEYWORDS)) {
|
|
108
|
+
gaps.push(gap('minor', 'completeness', 'Scope does not mention what is excluded.', 'Add explicit exclusions to prevent scope creep (e.g., "does NOT include…").', 'scope', 'no_exclusions_in_scope'));
|
|
109
|
+
}
|
|
110
|
+
return gaps;
|
|
111
|
+
}
|
|
112
|
+
// ─── Pass 3: Feasibility ─────────────────────────────────────────
|
|
113
|
+
const OVERLY_BROAD_PATTERNS = [
|
|
114
|
+
'everything',
|
|
115
|
+
'all systems',
|
|
116
|
+
'entire codebase',
|
|
117
|
+
'complete rewrite',
|
|
118
|
+
'from scratch',
|
|
119
|
+
'total overhaul',
|
|
120
|
+
'rewrite everything',
|
|
121
|
+
];
|
|
122
|
+
const DEPENDENCY_KEYWORDS = [
|
|
123
|
+
'depends',
|
|
124
|
+
'dependency',
|
|
125
|
+
'prerequisite',
|
|
126
|
+
'requires',
|
|
127
|
+
'blocked',
|
|
128
|
+
'before',
|
|
129
|
+
];
|
|
130
|
+
function analyzeFeasibility(plan) {
|
|
131
|
+
const gaps = [];
|
|
132
|
+
const scopeAndTasks = `${plan.scope} ${taskText(plan)}`;
|
|
133
|
+
// Overly broad scope
|
|
134
|
+
if (containsAny(scopeAndTasks, OVERLY_BROAD_PATTERNS)) {
|
|
135
|
+
gaps.push(gap('major', 'feasibility', 'Scope contains overly broad indicators — risk of unrealistic delivery.', 'Narrow the scope to a well-defined subset. Prefer incremental delivery over big-bang rewrites.', 'scope', 'overly_broad_scope'));
|
|
136
|
+
}
|
|
137
|
+
// No dependency awareness in tasks
|
|
138
|
+
if (plan.tasks.length > 3 && !containsAny(scopeAndTasks, DEPENDENCY_KEYWORDS)) {
|
|
139
|
+
const hasDeps = plan.tasks.some((t) => t.dependsOn && t.dependsOn.length > 0);
|
|
140
|
+
if (!hasDeps) {
|
|
141
|
+
gaps.push(gap('minor', 'feasibility', `${plan.tasks.length} tasks with no dependency mentions — execution order unclear.`, 'Identify dependencies between tasks or add explicit ordering notes.', 'tasks', 'no_dependency_awareness'));
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
return gaps;
|
|
145
|
+
}
|
|
146
|
+
// ─── Pass 4: Risk ────────────────────────────────────────────────
|
|
147
|
+
const BREAKING_CHANGE_KEYWORDS = [
|
|
148
|
+
'breaking change',
|
|
149
|
+
'breaking',
|
|
150
|
+
'migration',
|
|
151
|
+
'deprecate',
|
|
152
|
+
'remove api',
|
|
153
|
+
'remove endpoint',
|
|
154
|
+
'schema change',
|
|
155
|
+
'database migration',
|
|
156
|
+
];
|
|
157
|
+
const MITIGATION_KEYWORDS = [
|
|
158
|
+
'rollback',
|
|
159
|
+
'backward compatible',
|
|
160
|
+
'backwards compatible',
|
|
161
|
+
'feature flag',
|
|
162
|
+
'gradual',
|
|
163
|
+
'phased',
|
|
164
|
+
'fallback',
|
|
165
|
+
'backup',
|
|
166
|
+
'canary',
|
|
167
|
+
'blue-green',
|
|
168
|
+
];
|
|
169
|
+
const VERIFICATION_KEYWORDS = [
|
|
170
|
+
'test',
|
|
171
|
+
'verify',
|
|
172
|
+
'validate',
|
|
173
|
+
'check',
|
|
174
|
+
'assert',
|
|
175
|
+
'confirm',
|
|
176
|
+
'spec',
|
|
177
|
+
'coverage',
|
|
178
|
+
];
|
|
179
|
+
function analyzeRisk(plan) {
|
|
180
|
+
const gaps = [];
|
|
181
|
+
const allText = `${plan.objective} ${plan.scope} ${taskText(plan)} ${decisionsText(plan)}`;
|
|
182
|
+
// Breaking changes without mitigation
|
|
183
|
+
if (containsAny(allText, BREAKING_CHANGE_KEYWORDS) &&
|
|
184
|
+
!containsAny(allText, MITIGATION_KEYWORDS)) {
|
|
185
|
+
gaps.push(gap('major', 'risk', 'Plan involves breaking changes but mentions no mitigation strategy.', 'Add a rollback plan, feature flags, or phased migration approach.', undefined, 'breaking_without_mitigation'));
|
|
186
|
+
}
|
|
187
|
+
// No verification/testing mentioned
|
|
188
|
+
if (plan.tasks.length > 0 && !containsAny(allText, VERIFICATION_KEYWORDS)) {
|
|
189
|
+
gaps.push(gap('minor', 'risk', 'No verification or testing mentioned in the plan.', 'Add at least one task or note about testing/validation.', 'tasks', 'no_verification_mentioned'));
|
|
190
|
+
}
|
|
191
|
+
return gaps;
|
|
192
|
+
}
|
|
193
|
+
// ─── Pass 5: Clarity ─────────────────────────────────────────────
|
|
194
|
+
const AMBIGUOUS_WORDS = [
|
|
195
|
+
'maybe',
|
|
196
|
+
'perhaps',
|
|
197
|
+
'might',
|
|
198
|
+
'could',
|
|
199
|
+
'some',
|
|
200
|
+
'etc',
|
|
201
|
+
'soon',
|
|
202
|
+
'simple',
|
|
203
|
+
'easy',
|
|
204
|
+
'appropriate',
|
|
205
|
+
'various',
|
|
206
|
+
'several',
|
|
207
|
+
'probably',
|
|
208
|
+
'possibly',
|
|
209
|
+
'somehow',
|
|
210
|
+
];
|
|
211
|
+
function analyzeClarity(plan) {
|
|
212
|
+
const gaps = [];
|
|
213
|
+
const allText = `${plan.objective} ${plan.scope} ${decisionsText(plan)}`;
|
|
214
|
+
const lower = allText.toLowerCase();
|
|
215
|
+
// Ambiguous language
|
|
216
|
+
const found = AMBIGUOUS_WORDS.filter((w) => {
|
|
217
|
+
const regex = new RegExp(`\\b${w}\\b`, 'i');
|
|
218
|
+
return regex.test(lower);
|
|
219
|
+
});
|
|
220
|
+
if (found.length > 0) {
|
|
221
|
+
gaps.push(gap('minor', 'clarity', `Ambiguous language detected: ${found.slice(0, 5).join(', ')}${found.length > 5 ? ` (+${found.length - 5} more)` : ''}.`, 'Replace vague terms with concrete, specific language.', undefined, `ambiguous_words:${found.join(',')}`));
|
|
222
|
+
}
|
|
223
|
+
// Tasks with very short or missing descriptions
|
|
224
|
+
const shortTasks = plan.tasks.filter((t) => !t.description || t.description.trim().length < 10);
|
|
225
|
+
if (shortTasks.length > 0) {
|
|
226
|
+
gaps.push(gap('minor', 'clarity', `${shortTasks.length} task(s) with very short descriptions: ${shortTasks.map((t) => t.id).join(', ')}.`, 'Add detailed descriptions to all tasks explaining what needs to be done.', 'tasks', 'short_task_descriptions'));
|
|
227
|
+
}
|
|
228
|
+
return gaps;
|
|
229
|
+
}
|
|
230
|
+
// ─── Pass 6: Semantic Quality ────────────────────────────────────
|
|
231
|
+
const GENERIC_OBJECTIVE_PATTERNS = [
|
|
232
|
+
/^(create|build|implement|add|make|do)\s+\w+$/i,
|
|
233
|
+
/^fix\s+\w+$/i,
|
|
234
|
+
/^update\s+\w+$/i,
|
|
235
|
+
];
|
|
236
|
+
const RATIONALE_INDICATORS = [
|
|
237
|
+
'because',
|
|
238
|
+
'since',
|
|
239
|
+
'due to',
|
|
240
|
+
'in order to',
|
|
241
|
+
'so that',
|
|
242
|
+
'given that',
|
|
243
|
+
'as a result',
|
|
244
|
+
];
|
|
245
|
+
const SHALLOW_INDICATORS = ['better', 'good', 'best', 'nice', 'great', 'improved'];
|
|
246
|
+
function analyzeSemanticQuality(plan) {
|
|
247
|
+
const gaps = [];
|
|
248
|
+
// Generic/too-short objective
|
|
249
|
+
if (plan.objective) {
|
|
250
|
+
const words = plan.objective.trim().split(/\s+/);
|
|
251
|
+
const isGeneric = GENERIC_OBJECTIVE_PATTERNS.some((p) => p.test(plan.objective.trim()));
|
|
252
|
+
if (isGeneric || words.length < 5) {
|
|
253
|
+
gaps.push(gap('major', 'semantic-quality', `Objective is too generic${words.length < 5 ? ` (${words.length} words)` : ''}: "${plan.objective.trim()}".`, 'Expand the objective to describe the specific outcome, context, and constraints.', 'objective', 'generic_objective'));
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
// Task granularity check (too few or too many)
|
|
257
|
+
if (plan.tasks.length > 0 && plan.tasks.length < 3) {
|
|
258
|
+
gaps.push(gap('minor', 'semantic-quality', `Only ${plan.tasks.length} task(s) — plan may lack sufficient breakdown.`, 'Break down the work into 3-15 well-defined tasks for better tracking.', 'tasks', 'too_few_tasks'));
|
|
259
|
+
}
|
|
260
|
+
else if (plan.tasks.length > 20) {
|
|
261
|
+
gaps.push(gap('major', 'semantic-quality', `${plan.tasks.length} tasks — plan scope may be too large.`, 'Split into multiple plans or consolidate related tasks to stay under 20.', 'tasks', 'too_many_tasks'));
|
|
262
|
+
}
|
|
263
|
+
// Decisions with shallow rationale (uses "better/good" without "because/since")
|
|
264
|
+
for (let i = 0; i < plan.decisions.length; i++) {
|
|
265
|
+
const d = decisionText(plan.decisions[i]);
|
|
266
|
+
const hasShallow = containsAny(d, SHALLOW_INDICATORS);
|
|
267
|
+
const hasRationale = containsAny(d, RATIONALE_INDICATORS);
|
|
268
|
+
if (hasShallow && !hasRationale) {
|
|
269
|
+
gaps.push(gap('minor', 'semantic-quality', `Decision ${i + 1} uses subjective language without justification.`, 'Replace "better/good/best" with concrete reasoning using "because/since/due to".', `decisions[${i}]`, 'shallow_rationale'));
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
// All task titles must be unique
|
|
273
|
+
const titleSet = new Set();
|
|
274
|
+
const duplicates = [];
|
|
275
|
+
for (const t of plan.tasks) {
|
|
276
|
+
if (titleSet.has(t.title))
|
|
277
|
+
duplicates.push(t.title);
|
|
278
|
+
titleSet.add(t.title);
|
|
279
|
+
}
|
|
280
|
+
if (duplicates.length > 0) {
|
|
281
|
+
gaps.push(gap('minor', 'semantic-quality', `Duplicate task titles: ${[...new Set(duplicates)].join(', ')}.`, 'Give each task a unique, descriptive title.', 'tasks', 'duplicate_task_titles'));
|
|
282
|
+
}
|
|
283
|
+
// No decisions at all for multi-task plans
|
|
284
|
+
if (plan.tasks.length >= 3 && plan.decisions.length === 0) {
|
|
285
|
+
gaps.push(gap('major', 'semantic-quality', `${plan.tasks.length} tasks but no decisions documented.`, 'Document key decisions and their rationale — at least 1 per 3 tasks.', 'decisions', 'no_decisions'));
|
|
286
|
+
}
|
|
287
|
+
return gaps;
|
|
288
|
+
}
|
|
289
|
+
// ─── Opt-In Pass Factories ──────────────────────────────────────
|
|
290
|
+
// Ported from Salvador's plan-gap-technical.ts, plan-gap-domain.ts,
|
|
291
|
+
// and plan-gap-antipattern.ts. These are parameterized factories that
|
|
292
|
+
// agents register via customPasses.
|
|
293
|
+
/**
|
|
294
|
+
* Factory: tool chain feasibility pass.
|
|
295
|
+
* Validates that tool_chain entries are known and ordering rules are respected.
|
|
296
|
+
* Ported from Salvador's analyzeToolFeasibility.
|
|
297
|
+
*
|
|
298
|
+
* @param validTools - Set of valid tool names for this agent
|
|
299
|
+
* @param orderingRules - Ordering constraints (e.g., search before create)
|
|
300
|
+
*/
|
|
301
|
+
export function createToolFeasibilityPass(validTools, orderingRules) {
|
|
302
|
+
return (plan) => {
|
|
303
|
+
const gaps = [];
|
|
304
|
+
const toolChain = plan.tool_chain;
|
|
305
|
+
if (!toolChain || toolChain.length === 0)
|
|
306
|
+
return gaps;
|
|
307
|
+
// Validate tool names
|
|
308
|
+
const invalidTools = toolChain.filter((t) => !validTools.has(t));
|
|
309
|
+
if (invalidTools.length > 0) {
|
|
310
|
+
gaps.push(gap('critical', 'tool-feasibility', `Invalid tool names in tool_chain: ${invalidTools.join(', ')}`, 'Use valid tool names. Check available tools for this agent.', 'tool_chain', `invalid_tools:${invalidTools.join(',')}`));
|
|
311
|
+
}
|
|
312
|
+
// Validate ordering rules
|
|
313
|
+
if (orderingRules) {
|
|
314
|
+
for (const rule of orderingRules) {
|
|
315
|
+
const beforeIndex = toolChain.indexOf(rule.before);
|
|
316
|
+
const afterIndex = toolChain.indexOf(rule.after);
|
|
317
|
+
if (beforeIndex !== -1 && afterIndex !== -1 && beforeIndex > afterIndex) {
|
|
318
|
+
gaps.push(gap('major', 'tool-feasibility', `Tool ordering violation: ${rule.before} must come before ${rule.after}`, rule.reason, 'tool_chain', `ordering:${rule.before}>${rule.after}`));
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
return gaps;
|
|
323
|
+
};
|
|
324
|
+
}
|
|
325
|
+
/**
|
|
326
|
+
* Factory: flow and mode alignment pass.
|
|
327
|
+
* Validates flow and target_mode against known values and intent alignment.
|
|
328
|
+
* Ported from Salvador's analyzeFlowAlignment.
|
|
329
|
+
*
|
|
330
|
+
* @param validFlows - Set of valid flow names for this agent
|
|
331
|
+
* @param validModes - Set of valid operational modes for this agent
|
|
332
|
+
* @param intentFlowMap - Maps detected intents to expected flows
|
|
333
|
+
*/
|
|
334
|
+
export function createFlowAlignmentPass(validFlows, validModes, intentFlowMap) {
|
|
335
|
+
return (plan) => {
|
|
336
|
+
const gaps = [];
|
|
337
|
+
if (plan.flow && !validFlows.has(plan.flow)) {
|
|
338
|
+
gaps.push(gap('major', 'flow-alignment', `Invalid flow: ${plan.flow}`, `Valid flows are: ${Array.from(validFlows).join(', ')}`, 'flow', `invalid_flow:${plan.flow}`));
|
|
339
|
+
}
|
|
340
|
+
if (plan.target_mode && !validModes.has(plan.target_mode)) {
|
|
341
|
+
gaps.push(gap('major', 'flow-alignment', `Invalid target_mode: ${plan.target_mode}`, `Valid modes are: ${Array.from(validModes).join(', ')}`, 'target_mode', `invalid_mode:${plan.target_mode}`));
|
|
342
|
+
}
|
|
343
|
+
// Intent-flow alignment (optional)
|
|
344
|
+
if (intentFlowMap && plan.flow) {
|
|
345
|
+
const objectiveLower = (plan.objective || '').toLowerCase();
|
|
346
|
+
let detectedIntent = null;
|
|
347
|
+
if (/\b(create|build|implement|add|new)\b/.test(objectiveLower)) {
|
|
348
|
+
detectedIntent = 'CREATE';
|
|
349
|
+
}
|
|
350
|
+
else if (/\b(fix|debug|repair|resolve|bug)\b/.test(objectiveLower)) {
|
|
351
|
+
detectedIntent = 'FIX';
|
|
352
|
+
}
|
|
353
|
+
else if (/\b(review|audit|check|validate|inspect)\b/.test(objectiveLower)) {
|
|
354
|
+
detectedIntent = 'REVIEW';
|
|
355
|
+
}
|
|
356
|
+
else if (/\b(plan|design|architect|structure)\b/.test(objectiveLower)) {
|
|
357
|
+
detectedIntent = 'PLAN';
|
|
358
|
+
}
|
|
359
|
+
else if (/\b(enhance|improve|refactor|optimize)\b/.test(objectiveLower)) {
|
|
360
|
+
detectedIntent = 'ENHANCE';
|
|
361
|
+
}
|
|
362
|
+
else if (/\b(deliver|package|publish|deploy|release)\b/.test(objectiveLower)) {
|
|
363
|
+
detectedIntent = 'DELIVER';
|
|
364
|
+
}
|
|
365
|
+
if (detectedIntent) {
|
|
366
|
+
const expectedFlows = intentFlowMap[detectedIntent] || [];
|
|
367
|
+
if (expectedFlows.length > 0 && !expectedFlows.includes(plan.flow)) {
|
|
368
|
+
gaps.push(gap('minor', 'flow-alignment', `Flow '${plan.flow}' may not align with detected intent '${detectedIntent}'`, `Consider using flow: ${expectedFlows.join(' or ')}`, 'flow', `intent_flow_mismatch:${detectedIntent}->${plan.flow}`));
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
}
|
|
372
|
+
return gaps;
|
|
373
|
+
};
|
|
374
|
+
}
|
|
375
|
+
/**
|
|
376
|
+
* Factory: content anti-pattern pass.
|
|
377
|
+
* Detects common anti-patterns in plan content.
|
|
378
|
+
* Ported from Salvador's analyzeContentAntiPatterns.
|
|
379
|
+
*
|
|
380
|
+
* @param antiPatterns - Regex patterns to check against approach text
|
|
381
|
+
* @param mitigationPatterns - Patterns that indicate the plan is already mitigating
|
|
382
|
+
*/
|
|
383
|
+
export function createAntiPatternPass(antiPatterns, mitigationPatterns) {
|
|
384
|
+
const VAGUE_CRITERIA_PATTERNS = [
|
|
385
|
+
/^it (looks?|works?|is) (good|nice|fine|great|ok|correct)/i,
|
|
386
|
+
/^(looks?|works?) (good|nice|fine|great|ok)/i,
|
|
387
|
+
/^it('s| is) (done|complete|finished)/i,
|
|
388
|
+
/\bmy machine\b/i,
|
|
389
|
+
];
|
|
390
|
+
return (plan) => {
|
|
391
|
+
const gaps = [];
|
|
392
|
+
const approach = (plan.approach || '').toLowerCase();
|
|
393
|
+
const criteria = plan.success_criteria || [];
|
|
394
|
+
const fullText = [approach, ...criteria].join(' ').toLowerCase();
|
|
395
|
+
// Check if plan is actively mitigating known anti-patterns
|
|
396
|
+
const isMitigating = mitigationPatterns
|
|
397
|
+
? mitigationPatterns.some((p) => p.test(fullText))
|
|
398
|
+
: false;
|
|
399
|
+
// Custom anti-pattern checks
|
|
400
|
+
if (!isMitigating && antiPatterns) {
|
|
401
|
+
for (const ap of antiPatterns) {
|
|
402
|
+
if (ap.pattern.test(approach)) {
|
|
403
|
+
gaps.push(gap(ap.severity, 'anti-pattern', ap.description, ap.recommendation, 'approach', `anti_pattern:${ap.description}`));
|
|
404
|
+
}
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
// Vague success criteria (generic — always checked)
|
|
408
|
+
for (const criterion of criteria) {
|
|
409
|
+
const isVague = VAGUE_CRITERIA_PATTERNS.some((p) => p.test(criterion));
|
|
410
|
+
if (isVague) {
|
|
411
|
+
gaps.push(gap('minor', 'anti-pattern', `Success criterion is not measurable: "${criterion}"`, 'Rewrite as a verifiable assertion: "Component renders X", "All Y pass Z", "No A in B".', 'success_criteria', `vague_criterion:${criterion}`));
|
|
412
|
+
}
|
|
413
|
+
}
|
|
414
|
+
return gaps;
|
|
415
|
+
};
|
|
416
|
+
}
|
|
417
|
+
// ─── Orchestrator ────────────────────────────────────────────────
|
|
418
|
+
/**
|
|
419
|
+
* Run all 6 built-in gap analysis passes on a plan, plus any custom passes.
|
|
420
|
+
* Returns a combined list of all gaps found, ordered by pass.
|
|
421
|
+
*
|
|
422
|
+
* @param plan - The plan to analyze
|
|
423
|
+
* @param options - Optional config with custom passes for domain-specific checks
|
|
424
|
+
*/
|
|
425
|
+
export function runGapAnalysis(plan, options) {
|
|
426
|
+
const gaps = [
|
|
427
|
+
...analyzeStructure(plan),
|
|
428
|
+
...analyzeCompleteness(plan),
|
|
429
|
+
...analyzeFeasibility(plan),
|
|
430
|
+
...analyzeRisk(plan),
|
|
431
|
+
...analyzeClarity(plan),
|
|
432
|
+
...analyzeSemanticQuality(plan),
|
|
433
|
+
];
|
|
434
|
+
// Run custom passes (domain-specific checks like tool-feasibility, UI context, etc.)
|
|
435
|
+
if (options?.customPasses) {
|
|
436
|
+
for (const pass of options.customPasses) {
|
|
437
|
+
gaps.push(...pass(plan));
|
|
438
|
+
}
|
|
439
|
+
}
|
|
440
|
+
return gaps;
|
|
441
|
+
}
|
|
442
|
+
//# sourceMappingURL=gap-analysis.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gap-analysis.js","sourceRoot":"","sources":["../../src/planning/gap-analysis.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gap analysis types and scoring constants.
|
|
3
|
+
* Ported from Salvador MCP's multi-pass grading engine.
|
|
4
|
+
*/
|
|
5
|
+
export type GapSeverity = 'critical' | 'major' | 'minor' | 'info';
|
|
6
|
+
export type GapCategory = 'structure' | 'completeness' | 'feasibility' | 'risk' | 'clarity' | 'semantic-quality' | 'tool-feasibility' | 'flow-alignment' | 'anti-pattern';
|
|
7
|
+
export interface PlanGap {
|
|
8
|
+
id: string;
|
|
9
|
+
severity: GapSeverity;
|
|
10
|
+
category: GapCategory;
|
|
11
|
+
description: string;
|
|
12
|
+
recommendation: string;
|
|
13
|
+
/** Where in the plan this gap was found (e.g. 'objective', 'tasks[2]'). */
|
|
14
|
+
location?: string;
|
|
15
|
+
/** Machine-readable condition that fired — debug aid only. */
|
|
16
|
+
_trigger?: string;
|
|
17
|
+
}
|
|
18
|
+
/** Points deducted per gap severity. */
|
|
19
|
+
export declare const SEVERITY_WEIGHTS: Record<GapSeverity, number>;
|
|
20
|
+
/**
|
|
21
|
+
* Maximum deduction per category.
|
|
22
|
+
* Categories not listed here have NO cap — uncapped deductions.
|
|
23
|
+
*/
|
|
24
|
+
export declare const CATEGORY_PENALTY_CAPS: Record<string, number>;
|
|
25
|
+
export declare const MIN_OBJECTIVE_LENGTH = 10;
|
|
26
|
+
export declare const MIN_SCOPE_LENGTH = 10;
|
|
27
|
+
export declare const MIN_DECISION_LENGTH = 10;
|
|
28
|
+
export declare function generateGapId(): string;
|
|
29
|
+
//# sourceMappingURL=gap-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gap-types.d.ts","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,cAAc,GACd,aAAa,GACb,MAAM,GACN,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAKxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAExD,CAAC;AAIF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAItC,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gap analysis types and scoring constants.
|
|
3
|
+
* Ported from Salvador MCP's multi-pass grading engine.
|
|
4
|
+
*/
|
|
5
|
+
// ─── Scoring Constants ───────────────────────────────────────────
|
|
6
|
+
/** Points deducted per gap severity. */
|
|
7
|
+
export const SEVERITY_WEIGHTS = {
|
|
8
|
+
critical: 30,
|
|
9
|
+
major: 15,
|
|
10
|
+
minor: 2,
|
|
11
|
+
info: 0,
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Maximum deduction per category.
|
|
15
|
+
* Categories not listed here have NO cap — uncapped deductions.
|
|
16
|
+
*/
|
|
17
|
+
export const CATEGORY_PENALTY_CAPS = {
|
|
18
|
+
clarity: 10,
|
|
19
|
+
};
|
|
20
|
+
// ─── Validation Thresholds ───────────────────────────────────────
|
|
21
|
+
export const MIN_OBJECTIVE_LENGTH = 10;
|
|
22
|
+
export const MIN_SCOPE_LENGTH = 10;
|
|
23
|
+
export const MIN_DECISION_LENGTH = 10;
|
|
24
|
+
// ─── Helpers ─────────────────────────────────────────────────────
|
|
25
|
+
export function generateGapId() {
|
|
26
|
+
return `gap_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=gap-types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gap-types.js","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,oEAAoE;AAEpE,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;CACR,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,oEAAoE;AAEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,oEAAoE;AAEpE,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC"}
|