@soleri/core 2.0.2 → 2.4.0

package/dist/loop/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Loop system types — iterative validation loop state tracking.
+ *
+ * Loops let agents run validate-fix-validate cycles (e.g. token migration,
+ * contrast fixes, component builds). In-memory only — session-scoped.
+ */
+/** Supported loop modes — each maps to a different validation strategy. */
+export type LoopMode = 'token-migration' | 'contrast-fix' | 'component-build' | 'plan-iteration' | 'custom';
+/** Configuration for starting a new loop. */
+export interface LoopConfig {
+    mode: LoopMode;
+    prompt: string;
+    maxIterations: number;
+    targetScore?: number;
+}
+/** A single iteration result within a loop. */
+export interface LoopIteration {
+    iteration: number;
+    timestamp: string;
+    validationScore?: number;
+    validationResult?: string;
+    passed: boolean;
+}
+/** Loop lifecycle status. */
+export type LoopStatus = 'active' | 'completed' | 'cancelled' | 'max-iterations';
+/** Full state of a loop (active or historical). */
+export interface LoopState {
+    id: string;
+    config: LoopConfig;
+    iterations: LoopIteration[];
+    status: LoopStatus;
+    startedAt: string;
+    completedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/loop/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/loop/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,QAAQ,CAAC;AAEb,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAEjF,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/loop/types.js

@@ -0,0 +1,8 @@
+/**
+ * Loop system types — iterative validation loop state tracking.
+ *
+ * Loops let agents run validate-fix-validate cycles (e.g. token migration,
+ * contrast fixes, component builds). In-memory only — session-scoped.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/loop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/loop/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/planning/gap-analysis.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 6-pass gap analysis engine for plan grading.
+ * Ported from Salvador MCP's plan-gap-content.ts / plan-gap-technical.ts.
+ *
+ * Passes:
+ *   1. Structure     — required fields present and sufficiently long
+ *   2. Completeness  — measurable objectives, decision rationale, scope exclusions
+ *   3. Feasibility   — overly broad scope, missing dependency awareness
+ *   4. Risk          — breaking changes without mitigation, missing verification
+ *   5. Clarity       — ambiguous language, vague criteria
+ *   6. Semantic Quality — generic objectives, shallow rationale, non-concrete approach
+ */
+import type { Plan } from './planner.js';
+import type { PlanGap } from './gap-types.js';
+/** A custom gap analysis pass that agents can register. */
+export type GapAnalysisPass = (plan: Plan) => PlanGap[];
+export interface GapAnalysisOptions {
+    /** Custom gap analysis passes appended after the 6 built-in passes. */
+    customPasses?: GapAnalysisPass[];
+}
+/**
+ * Run all 6 built-in gap analysis passes on a plan, plus any custom passes.
+ * Returns a combined list of all gaps found, ordered by pass.
+ *
+ * @param plan - The plan to analyze
+ * @param options - Optional config with custom passes for domain-specific checks
+ */
+export declare function runGapAnalysis(plan: Plan, options?: GapAnalysisOptions): PlanGap[];
+//# sourceMappingURL=gap-analysis.d.ts.map

package/dist/planning/gap-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-analysis.d.ts","sourceRoot":"","sources":["../../src/planning/gap-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAA4B,MAAM,gBAAgB,CAAC;AAwcxE,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,EAAE,CAkBlF"}

package/dist/planning/gap-analysis.js

@@ -0,0 +1,265 @@
+/**
+ * 6-pass gap analysis engine for plan grading.
+ * Ported from Salvador MCP's plan-gap-content.ts / plan-gap-technical.ts.
+ *
+ * Passes:
+ *   1. Structure     — required fields present and sufficiently long
+ *   2. Completeness  — measurable objectives, decision rationale, scope exclusions
+ *   3. Feasibility   — overly broad scope, missing dependency awareness
+ *   4. Risk          — breaking changes without mitigation, missing verification
+ *   5. Clarity       — ambiguous language, vague criteria
+ *   6. Semantic Quality — generic objectives, shallow rationale, non-concrete approach
+ */
+import { generateGapId, MIN_OBJECTIVE_LENGTH, MIN_SCOPE_LENGTH, MIN_DECISION_LENGTH, } from './gap-types.js';
+// ─── Helpers ─────────────────────────────────────────────────────
+function gap(severity, category, description, recommendation, location, trigger) {
+    return {
+        id: generateGapId(),
+        severity,
+        category,
+        description,
+        recommendation,
+        ...(location ? { location } : {}),
+        ...(trigger ? { _trigger: trigger } : {}),
+    };
+}
+/** Combine all task descriptions + titles into a single text blob for analysis. */
+function taskText(plan) {
+    return plan.tasks.map((t) => `${t.title} ${t.description}`).join(' ');
+}
+/** Check if text contains any of the given patterns (case-insensitive). */
+function containsAny(text, patterns) {
+    const lower = text.toLowerCase();
+    return patterns.some((p) => lower.includes(p.toLowerCase()));
+}
+// ─── Pass 1: Structure ───────────────────────────────────────────
+function analyzeStructure(plan) {
+    const gaps = [];
+    if (!plan.objective || plan.objective.trim().length < MIN_OBJECTIVE_LENGTH) {
+        gaps.push(gap('critical', 'structure', plan.objective
+            ? `Objective too short (${plan.objective.trim().length} chars, need ${MIN_OBJECTIVE_LENGTH}+).`
+            : 'Plan has no objective.', 'Add a clear objective describing what this plan achieves.', 'objective', 'missing_or_short_objective'));
+    }
+    if (!plan.scope || plan.scope.trim().length < MIN_SCOPE_LENGTH) {
+        gaps.push(gap('critical', 'structure', plan.scope
+            ? `Scope too short (${plan.scope.trim().length} chars, need ${MIN_SCOPE_LENGTH}+).`
+            : 'Plan has no scope defined.', 'Define the scope — what is included and excluded.', 'scope', 'missing_or_short_scope'));
+    }
+    if (plan.tasks.length === 0) {
+        gaps.push(gap('critical', 'structure', 'Plan has no tasks.', 'Add at least one task to make the plan actionable.', 'tasks', 'no_tasks'));
+    }
+    return gaps;
+}
+// ─── Pass 2: Completeness ────────────────────────────────────────
+const METRIC_PATTERNS = [
+    /\d+/,
+    /percent/i,
+    /reduce/i,
+    /increase/i,
+    /measure/i,
+    /target/i,
+    /goal/i,
+    /kpi/i,
+    /metric/i,
+    /benchmark/i,
+];
+const EXCLUSION_KEYWORDS = ['not', 'exclude', 'outside', 'beyond', 'limit', 'except', 'won\'t', 'will not'];
+function analyzeCompleteness(plan) {
+    const gaps = [];
+    // Objective lacks measurable indicators
+    if (plan.objective && !METRIC_PATTERNS.some((p) => p.test(plan.objective))) {
+        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'));
+    }
+    // Decisions without rationale-like content
+    if (plan.decisions.length > 0) {
+        for (let i = 0; i < plan.decisions.length; i++) {
+            const d = plan.decisions[i];
+            if (d.trim().length < MIN_DECISION_LENGTH) {
+                gaps.push(gap('major', 'completeness', `Decision ${i + 1} is too short (${d.trim().length} chars) — lacks rationale.`, 'Expand each decision to include the reasoning (why this choice over alternatives).', `decisions[${i}]`, 'short_decision'));
+            }
+        }
+    }
+    // Scope missing exclusions
+    if (plan.scope && !containsAny(plan.scope, EXCLUSION_KEYWORDS)) {
+        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'));
+    }
+    return gaps;
+}
+// ─── Pass 3: Feasibility ─────────────────────────────────────────
+const OVERLY_BROAD_PATTERNS = [
+    'everything',
+    'all systems',
+    'entire codebase',
+    'complete rewrite',
+    'from scratch',
+    'total overhaul',
+    'rewrite everything',
+];
+const DEPENDENCY_KEYWORDS = ['depends', 'dependency', 'prerequisite', 'requires', 'blocked', 'before'];
+function analyzeFeasibility(plan) {
+    const gaps = [];
+    const scopeAndTasks = `${plan.scope} ${taskText(plan)}`;
+    // Overly broad scope
+    if (containsAny(scopeAndTasks, OVERLY_BROAD_PATTERNS)) {
+        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'));
+    }
+    // No dependency awareness in tasks
+    if (plan.tasks.length > 3 && !containsAny(scopeAndTasks, DEPENDENCY_KEYWORDS)) {
+        const hasDeps = plan.tasks.some((t) => t.dependsOn && t.dependsOn.length > 0);
+        if (!hasDeps) {
+            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'));
+        }
+    }
+    return gaps;
+}
+// ─── Pass 4: Risk ────────────────────────────────────────────────
+const BREAKING_CHANGE_KEYWORDS = [
+    'breaking change',
+    'breaking',
+    'migration',
+    'deprecate',
+    'remove api',
+    'remove endpoint',
+    'schema change',
+    'database migration',
+];
+const MITIGATION_KEYWORDS = [
+    'rollback',
+    'backward compatible',
+    'backwards compatible',
+    'feature flag',
+    'gradual',
+    'phased',
+    'fallback',
+    'backup',
+    'canary',
+    'blue-green',
+];
+const VERIFICATION_KEYWORDS = ['test', 'verify', 'validate', 'check', 'assert', 'confirm', 'spec', 'coverage'];
+function analyzeRisk(plan) {
+    const gaps = [];
+    const allText = `${plan.objective} ${plan.scope} ${taskText(plan)} ${plan.decisions.join(' ')}`;
+    // Breaking changes without mitigation
+    if (containsAny(allText, BREAKING_CHANGE_KEYWORDS) && !containsAny(allText, MITIGATION_KEYWORDS)) {
+        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'));
+    }
+    // No verification/testing mentioned
+    if (plan.tasks.length > 0 && !containsAny(allText, VERIFICATION_KEYWORDS)) {
+        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'));
+    }
+    return gaps;
+}
+// ─── Pass 5: Clarity ─────────────────────────────────────────────
+const AMBIGUOUS_WORDS = [
+    'maybe',
+    'perhaps',
+    'might',
+    'could',
+    'some',
+    'etc',
+    'soon',
+    'simple',
+    'easy',
+    'appropriate',
+    'various',
+    'several',
+    'probably',
+    'possibly',
+    'somehow',
+];
+function analyzeClarity(plan) {
+    const gaps = [];
+    const allText = `${plan.objective} ${plan.scope} ${plan.decisions.join(' ')}`;
+    const lower = allText.toLowerCase();
+    // Ambiguous language
+    const found = AMBIGUOUS_WORDS.filter((w) => {
+        const regex = new RegExp(`\\b${w}\\b`, 'i');
+        return regex.test(lower);
+    });
+    if (found.length > 0) {
+        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(',')}`));
+    }
+    // Tasks with very short or missing descriptions
+    const shortTasks = plan.tasks.filter((t) => !t.description || t.description.trim().length < 10);
+    if (shortTasks.length > 0) {
+        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'));
+    }
+    return gaps;
+}
+// ─── Pass 6: Semantic Quality ────────────────────────────────────
+const GENERIC_OBJECTIVE_PATTERNS = [
+    /^(create|build|implement|add|make|do)\s+\w+$/i,
+    /^fix\s+\w+$/i,
+    /^update\s+\w+$/i,
+];
+const RATIONALE_INDICATORS = ['because', 'since', 'due to', 'in order to', 'so that', 'given that', 'as a result'];
+const SHALLOW_INDICATORS = ['better', 'good', 'best', 'nice', 'great', 'improved'];
+function analyzeSemanticQuality(plan) {
+    const gaps = [];
+    // Generic/too-short objective
+    if (plan.objective) {
+        const words = plan.objective.trim().split(/\s+/);
+        const isGeneric = GENERIC_OBJECTIVE_PATTERNS.some((p) => p.test(plan.objective.trim()));
+        if (isGeneric || words.length < 5) {
+            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'));
+        }
+    }
+    // Task granularity check (too few or too many)
+    if (plan.tasks.length > 0 && plan.tasks.length < 3) {
+        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'));
+    }
+    else if (plan.tasks.length > 20) {
+        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'));
+    }
+    // Decisions with shallow rationale (uses "better/good" without "because/since")
+    for (let i = 0; i < plan.decisions.length; i++) {
+        const d = plan.decisions[i];
+        const hasShallow = containsAny(d, SHALLOW_INDICATORS);
+        const hasRationale = containsAny(d, RATIONALE_INDICATORS);
+        if (hasShallow && !hasRationale) {
+            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'));
+        }
+    }
+    // All task titles must be unique
+    const titleSet = new Set();
+    const duplicates = [];
+    for (const t of plan.tasks) {
+        if (titleSet.has(t.title))
+            duplicates.push(t.title);
+        titleSet.add(t.title);
+    }
+    if (duplicates.length > 0) {
+        gaps.push(gap('minor', 'semantic-quality', `Duplicate task titles: ${[...new Set(duplicates)].join(', ')}.`, 'Give each task a unique, descriptive title.', 'tasks', 'duplicate_task_titles'));
+    }
+    // No decisions at all for multi-task plans
+    if (plan.tasks.length >= 3 && plan.decisions.length === 0) {
+        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'));
+    }
+    return gaps;
+}
+// ─── Orchestrator ────────────────────────────────────────────────
+/**
+ * Run all 6 built-in gap analysis passes on a plan, plus any custom passes.
+ * Returns a combined list of all gaps found, ordered by pass.
+ *
+ * @param plan - The plan to analyze
+ * @param options - Optional config with custom passes for domain-specific checks
+ */
+export function runGapAnalysis(plan, options) {
+    const gaps = [
+        ...analyzeStructure(plan),
+        ...analyzeCompleteness(plan),
+        ...analyzeFeasibility(plan),
+        ...analyzeRisk(plan),
+        ...analyzeClarity(plan),
+        ...analyzeSemanticQuality(plan),
+    ];
+    // Run custom passes (domain-specific checks like tool-feasibility, UI context, etc.)
+    if (options?.customPasses) {
+        for (const pass of options.customPasses) {
+            gaps.push(...pass(plan));
+        }
+    }
+    return gaps;
+}
+//# sourceMappingURL=gap-analysis.js.map

package/dist/planning/gap-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-analysis.js","sourceRoot":"","sources":["../../src/planning/gap-analysis.ts"],"names":[],"mappings":"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"}

package/dist/planning/gap-types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gap analysis types and scoring constants.
+ * Ported from Salvador MCP's multi-pass grading engine.
+ */
+export type GapSeverity = 'critical' | 'major' | 'minor' | 'info';
+export type GapCategory = 'structure' | 'completeness' | 'feasibility' | 'risk' | 'clarity' | 'semantic-quality';
+export interface PlanGap {
+    id: string;
+    severity: GapSeverity;
+    category: GapCategory;
+    description: string;
+    recommendation: string;
+    /** Where in the plan this gap was found (e.g. 'objective', 'tasks[2]'). */
+    location?: string;
+    /** Machine-readable condition that fired — debug aid only. */
+    _trigger?: string;
+}
+/** Points deducted per gap severity. */
+export declare const SEVERITY_WEIGHTS: Record<GapSeverity, number>;
+/**
+ * Maximum deduction per category.
+ * Categories not listed here have NO cap — uncapped deductions.
+ */
+export declare const CATEGORY_PENALTY_CAPS: Record<string, number>;
+export declare const MIN_OBJECTIVE_LENGTH = 10;
+export declare const MIN_SCOPE_LENGTH = 10;
+export declare const MIN_DECISION_LENGTH = 10;
+export declare function generateGapId(): string;
+//# sourceMappingURL=gap-types.d.ts.map

package/dist/planning/gap-types.d.ts.map

@@ -0,0 +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,CAAC;AAEvB,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"}

package/dist/planning/gap-types.js

@@ -0,0 +1,28 @@
+/**
+ * Gap analysis types and scoring constants.
+ * Ported from Salvador MCP's multi-pass grading engine.
+ */
+// ─── Scoring Constants ───────────────────────────────────────────
+/** Points deducted per gap severity. */
+export const SEVERITY_WEIGHTS = {
+    critical: 30,
+    major: 15,
+    minor: 2,
+    info: 0,
+};
+/**
+ * Maximum deduction per category.
+ * Categories not listed here have NO cap — uncapped deductions.
+ */
+export const CATEGORY_PENALTY_CAPS = {
+    clarity: 10,
+};
+// ─── Validation Thresholds ───────────────────────────────────────
+export const MIN_OBJECTIVE_LENGTH = 10;
+export const MIN_SCOPE_LENGTH = 10;
+export const MIN_DECISION_LENGTH = 10;
+// ─── Helpers ─────────────────────────────────────────────────────
+export function generateGapId() {
+    return `gap_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+}
+//# sourceMappingURL=gap-types.js.map

package/dist/planning/gap-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-types.js","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,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"}

package/dist/planning/planner.d.ts

@@ -1,3 +1,5 @@
+import type { PlanGap } from './gap-types.js';
+import type { GapAnalysisOptions } from './gap-analysis.js';
 export type PlanStatus = 'draft' | 'approved' | 'executing' | 'completed';
 export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed';
 export interface PlanTask {
@@ -5,8 +7,50 @@ export interface PlanTask {
     title: string;
     description: string;
     status: TaskStatus;
+    /** Optional dependency IDs — tasks that must complete before this one. */
+    dependsOn?: string[];
     updatedAt: number;
 }
+export interface DriftItem {
+    type: 'skipped' | 'added' | 'modified' | 'reordered';
+    description: string;
+    impact: 'low' | 'medium' | 'high';
+    rationale: string;
+}
+export interface ReconciliationReport {
+    planId: string;
+    accuracy: number;
+    driftItems: DriftItem[];
+    summary: string;
+    reconciledAt: number;
+}
+export interface ReviewEvidence {
+    planId: string;
+    taskId?: string;
+    reviewer: string;
+    outcome: 'approved' | 'rejected' | 'needs_changes';
+    comments: string;
+    reviewedAt: number;
+}
+export type PlanGrade = 'A+' | 'A' | 'B' | 'C' | 'D' | 'F';
+export interface PlanCheck {
+    checkId: string;
+    planId: string;
+    grade: PlanGrade;
+    score: number;
+    gaps: PlanGap[];
+    iteration: number;
+    checkedAt: number;
+}
+/**
+ * Calculate score from gaps with severity-weighted deductions and iteration leniency.
+ * Ported from Salvador MCP's plan-grading.ts.
+ *
+ * - Minor gaps: weight=0 on iteration 1 (free sketching), weight=1 on iteration 2, full weight on 3+
+ * - Per-category deductions are capped before summing (prevents one category from tanking the score)
+ * - Score = max(0, 100 - totalDeductions)
+ */
+export declare function calculateScore(gaps: PlanGap[], iteration?: number): number;
 export interface Plan {
     id: string;
     objective: string;
@@ -14,6 +58,14 @@ export interface Plan {
     status: PlanStatus;
     decisions: string[];
     tasks: PlanTask[];
+    /** Reconciliation report — populated by reconcile(). */
+    reconciliation?: ReconciliationReport;
+    /** Review evidence — populated by addReview(). */
+    reviews?: ReviewEvidence[];
+    /** Latest grading check. */
+    latestCheck?: PlanCheck;
+    /** All check history. */
+    checks: PlanCheck[];
     createdAt: number;
     updatedAt: number;
 }
@@ -24,7 +76,8 @@ export interface PlanStore {
 export declare class Planner {
     private filePath;
     private store;
-    constructor(filePath: string);
+    private gapOptions?;
+    constructor(filePath: string, gapOptions?: GapAnalysisOptions);
     private load;
     private save;
     create(params: {
@@ -44,5 +97,101 @@ export declare class Planner {
     complete(planId: string): Plan;
     getExecuting(): Plan[];
     getActive(): Plan[];
+    /**
+     * Iterate on a draft plan — modify objective, scope, decisions, or tasks.
+     * Only allowed on plans in 'draft' status.
+     */
+    iterate(planId: string, changes: {
+        objective?: string;
+        scope?: string;
+        decisions?: string[];
+        addTasks?: Array<{
+            title: string;
+            description: string;
+        }>;
+        removeTasks?: string[];
+    }): Plan;
+    /**
+     * Split a plan's tasks into sub-tasks with dependency tracking.
+     * Replaces existing tasks with a new set that includes dependency references.
+     * Only allowed on 'draft' or 'approved' plans.
+     */
+    splitTasks(planId: string, tasks: Array<{
+        title: string;
+        description: string;
+        dependsOn?: string[];
+    }>): Plan;
+    /**
+     * Reconcile a plan — compare what was planned vs what actually happened.
+     * Only allowed on 'executing' or 'completed' plans.
+     */
+    reconcile(planId: string, report: {
+        actualOutcome: string;
+        driftItems?: DriftItem[];
+    }): Plan;
+    /**
+     * Add review evidence to a plan or specific task.
+     */
+    addReview(planId: string, review: {
+        taskId?: string;
+        reviewer: string;
+        outcome: 'approved' | 'rejected' | 'needs_changes';
+        comments: string;
+    }): Plan;
+    /**
+     * Get dispatch instructions for a specific task — returns the task and its
+     * unmet dependencies so a subagent knows what to work on and what to wait for.
+     */
+    getDispatch(planId: string, taskId: string): {
+        task: PlanTask;
+        unmetDependencies: PlanTask[];
+        ready: boolean;
+    };
+    /**
+     * Archive completed plans older than the given number of days.
+     * Removes them from the active store and returns the archived plans.
+     */
+    archive(olderThanDays: number): Plan[];
+    /**
+     * Get statistics about all plans.
+     */
+    stats(): {
+        total: number;
+        byStatus: Record<PlanStatus, number>;
+        avgTasksPerPlan: number;
+        totalTasks: number;
+        tasksByStatus: Record<TaskStatus, number>;
+    };
+    /**
+     * Grade a plan using 6-pass gap analysis with severity-weighted scoring.
+     * Ported from Salvador MCP's multi-pass grading engine.
+     *
+     * Scoring:
+     * - Each gap has a severity (critical=30, major=15, minor=2, info=0)
+     * - Deductions are per-category with optional caps
+     * - Iteration leniency: minor gaps free on iter 1, half on iter 2, full on 3+
+     * - Score = max(0, 100 - deductions)
+     *
+     * Grade thresholds: A+=95, A=90, B=80, C=70, D=60, F=<60
+     */
+    grade(planId: string): PlanCheck;
+    /**
+     * Get the latest check for a plan.
+     */
+    getLatestCheck(planId: string): PlanCheck | null;
+    /**
+     * Get all checks for a plan (history).
+     */
+    getCheckHistory(planId: string): PlanCheck[];
+    /**
+     * Auto-grade: grade the plan and return whether it meets a target grade.
+     */
+    meetsGrade(planId: string, targetGrade: PlanGrade): {
+        meets: boolean;
+        check: PlanCheck;
+    };
+    private scoreToGrade;
+    private gradeToMinScore;
+    private hasCircularDependencies;
 }
 //# sourceMappingURL=planner.d.ts.map

package/dist/planning/planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/planning/planner.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAY;gBAEb,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,IAAI;IAKZ,MAAM,CAAC,MAAM,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvD,GAAG,IAAI;IAuBR,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIhC,IAAI,IAAI,IAAI,EAAE;IAId,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW7B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWpC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAgBpE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW9B,YAAY,IAAI,IAAI,EAAE;IAItB,SAAS,IAAI,IAAI,EAAE;CAKpB"}
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/planning/planner.ts"],"names":[],"mappings":"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"}