@soleri/core 9.0.4 → 9.3.0

package/dist/planning/plan-lifecycle.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Plan lifecycle FSM — state transitions, grade thresholds, and structural validation.
+ * Extracted from planner.ts to isolate pure lifecycle logic from persistence.
+ */
+import type { PlanGap } from './gap-types.js';
+/**
+ * Plan lifecycle status.
+ * Ported from Salvador's PlanLifecycleStatus with full 8-state lifecycle.
+ *
+ * Lifecycle: brainstorming → draft → approved → executing → [validating] → reconciling → completed → archived
+ */
+export type PlanStatus = 'brainstorming' | 'draft' | 'approved' | 'executing' | 'validating' | 'reconciling' | 'completed' | 'archived';
+/**
+ * Valid status transitions.
+ * Each key maps to the set of statuses it can transition to.
+ * Ported from Salvador's LIFECYCLE_TRANSITIONS.
+ */
+export declare const LIFECYCLE_TRANSITIONS: Record<PlanStatus, PlanStatus[]>;
+/**
+ * Statuses where the 30-minute TTL should NOT apply.
+ * Plans in these states may span multiple sessions.
+ */
+export declare const NON_EXPIRING_STATUSES: PlanStatus[];
+/**
+ * Validate a lifecycle status transition.
+ * Returns true if the transition is valid, false otherwise.
+ */
+export declare function isValidTransition(from: PlanStatus, to: PlanStatus): boolean;
+/**
+ * Get the valid next statuses for a given status.
+ */
+export declare function getValidNextStatuses(status: PlanStatus): PlanStatus[];
+/**
+ * Check if a status should have TTL expiration.
+ * Plans in executing/reconciling states persist indefinitely.
+ */
+export declare function shouldExpire(status: PlanStatus): boolean;
+/**
+ * Apply an FSM transition to a plan status.
+ * Throws if the transition is invalid. Returns the new status and timestamp.
+ * Does NOT mutate the plan — caller applies the result.
+ */
+export declare function applyTransition(currentStatus: PlanStatus, targetStatus: PlanStatus): {
+    status: PlanStatus;
+    updatedAt: number;
+};
+export type PlanGrade = 'A+' | 'A' | 'B' | 'C' | 'D' | 'F';
+/**
+ * Convert a numeric score to a letter grade.
+ * Thresholds: A+=95, A=90, B=80, C=70, D=60, F=<60
+ */
+export declare function scoreToGrade(score: number): PlanGrade;
+/**
+ * Convert a letter grade to the minimum score required.
+ */
+export declare function gradeToMinScore(grade: PlanGrade): number;
+/**
+ * Error thrown when a plan's grade is below the minimum required for approval.
+ */
+export declare class PlanGradeRejectionError extends Error {
+    readonly grade: PlanGrade;
+    readonly score: number;
+    readonly minGrade: PlanGrade;
+    readonly gaps: PlanGap[];
+    constructor(grade: PlanGrade, score: number, minGrade: PlanGrade, gaps: PlanGap[]);
+}
+/**
+ * Calculate score from gaps with severity-weighted deductions and iteration leniency.
+ */
+export declare function calculateScore(gaps: PlanGap[], iteration?: number): number;
+/**
+ * Detect circular dependencies among tasks.
+ * Uses DFS with in-stack tracking.
+ */
+export declare function hasCircularDependencies(tasks: ReadonlyArray<{
+    id: string;
+    dependsOn?: string[];
+}>): boolean;
+import type { PlanTask, TaskStatus, Plan, PlanDecision } from './planner-types.js';
+export interface IterateChanges {
+    objective?: string;
+    scope?: string;
+    decisions?: (string | PlanDecision)[];
+    addTasks?: Array<{
+        title: string;
+        description: string;
+    }>;
+    removeTasks?: string[];
+    approach?: string;
+    context?: string;
+    success_criteria?: string[];
+    tool_chain?: string[];
+    flow?: string;
+    target_mode?: string;
+}
+/**
+ * Apply iteration changes to a plan (mutates in place).
+ * Caller is responsible for status validation and persistence.
+ */
+export declare function applyIteration(plan: Plan, changes: IterateChanges): void;
+/**
+ * Replace plan tasks with a new split set, validating dependency references.
+ * Caller is responsible for status validation and persistence.
+ */
+/**
+ * Apply a task status update with auto-metrics (startedAt, completedAt, durationMs).
+ * Caller is responsible for plan status validation and persistence.
+ */
+export declare function applyTaskStatusUpdate(task: PlanTask, status: TaskStatus): void;
+/**
+ * Create a new Plan object (factory). Does not persist.
+ */
+export declare function createPlanObject(params: {
+    objective: string;
+    scope: string;
+    decisions?: (string | PlanDecision)[];
+    tasks?: Array<{
+        title: string;
+        description: string;
+    }>;
+    approach?: string;
+    context?: string;
+    success_criteria?: string[];
+    tool_chain?: string[];
+    flow?: string;
+    target_mode?: string;
+    alternatives?: import('./planner-types.js').PlanAlternative[];
+    initialStatus?: 'brainstorming' | 'draft';
+}): Plan;
+export declare function applySplitTasks(plan: Plan, tasks: Array<{
+    title: string;
+    description: string;
+    dependsOn?: string[];
+    acceptanceCriteria?: string[];
+}>): void;
+//# sourceMappingURL=plan-lifecycle.d.ts.map

package/dist/planning/plan-lifecycle.d.ts.map

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

package/dist/planning/plan-lifecycle.js

@@ -0,0 +1,309 @@
+/**
+ * Plan lifecycle FSM — state transitions, grade thresholds, and structural validation.
+ * Extracted from planner.ts to isolate pure lifecycle logic from persistence.
+ */
+import { SEVERITY_WEIGHTS, CATEGORY_PENALTY_CAPS, CATEGORY_BONUS_CAPS } from './gap-types.js';
+/**
+ * Valid status transitions.
+ * Each key maps to the set of statuses it can transition to.
+ * Ported from Salvador's LIFECYCLE_TRANSITIONS.
+ */
+export const LIFECYCLE_TRANSITIONS = {
+    brainstorming: ['draft'],
+    draft: ['approved'],
+    approved: ['executing'],
+    executing: ['validating', 'reconciling'],
+    validating: ['reconciling', 'executing'],
+    reconciling: ['completed'],
+    completed: ['archived'],
+    archived: [],
+};
+/**
+ * Statuses where the 30-minute TTL should NOT apply.
+ * Plans in these states may span multiple sessions.
+ */
+export const NON_EXPIRING_STATUSES = [
+    'brainstorming',
+    'executing',
+    'validating',
+    'reconciling',
+];
+/**
+ * Validate a lifecycle status transition.
+ * Returns true if the transition is valid, false otherwise.
+ */
+export function isValidTransition(from, to) {
+    return LIFECYCLE_TRANSITIONS[from].includes(to);
+}
+/**
+ * Get the valid next statuses for a given status.
+ */
+export function getValidNextStatuses(status) {
+    return LIFECYCLE_TRANSITIONS[status];
+}
+/**
+ * Check if a status should have TTL expiration.
+ * Plans in executing/reconciling states persist indefinitely.
+ */
+export function shouldExpire(status) {
+    return !NON_EXPIRING_STATUSES.includes(status);
+}
+/**
+ * Apply an FSM transition to a plan status.
+ * Throws if the transition is invalid. Returns the new status and timestamp.
+ * Does NOT mutate the plan — caller applies the result.
+ */
+export function applyTransition(currentStatus, targetStatus) {
+    if (!isValidTransition(currentStatus, targetStatus)) {
+        const valid = getValidNextStatuses(currentStatus);
+        throw new Error(`Invalid transition: '${currentStatus}' → '${targetStatus}'. ` +
+            `Valid transitions from '${currentStatus}': ${valid.length > 0 ? valid.join(', ') : 'none'}`);
+    }
+    return { status: targetStatus, updatedAt: Date.now() };
+}
+/**
+ * Convert a numeric score to a letter grade.
+ * Thresholds: A+=95, A=90, B=80, C=70, D=60, F=<60
+ */
+export function scoreToGrade(score) {
+    if (score >= 95)
+        return 'A+';
+    if (score >= 90)
+        return 'A';
+    if (score >= 80)
+        return 'B';
+    if (score >= 70)
+        return 'C';
+    if (score >= 60)
+        return 'D';
+    return 'F';
+}
+/**
+ * Convert a letter grade to the minimum score required.
+ */
+export function gradeToMinScore(grade) {
+    switch (grade) {
+        case 'A+':
+            return 95;
+        case 'A':
+            return 90;
+        case 'B':
+            return 80;
+        case 'C':
+            return 70;
+        case 'D':
+            return 60;
+        case 'F':
+            return 0;
+    }
+}
+/**
+ * Error thrown when a plan's grade is below the minimum required for approval.
+ */
+export class PlanGradeRejectionError extends Error {
+    grade;
+    score;
+    minGrade;
+    gaps;
+    constructor(grade, score, minGrade, gaps) {
+        const gapSummary = gaps
+            .filter((g) => g.severity === 'critical' || g.severity === 'major')
+            .map((g) => `- [${g.severity}] ${g.description}`)
+            .join('\n');
+        super(`Plan grade ${grade} (${score}/100) is below the minimum required grade ${minGrade} for approval. ` +
+            `Iterate on the plan to address gaps before approving.\n${gapSummary}`);
+        this.name = 'PlanGradeRejectionError';
+        this.grade = grade;
+        this.score = score;
+        this.minGrade = minGrade;
+        this.gaps = gaps;
+    }
+}
+// ─── Score Calculation ───────────────────────────────────────────
+/**
+ * Calculate score from gaps with severity-weighted deductions and iteration leniency.
+ */
+export function calculateScore(gaps, iteration = 1) {
+    const categoryDeductions = new Map();
+    const categoryBonuses = new Map();
+    for (const gap of gaps) {
+        let weight = SEVERITY_WEIGHTS[gap.severity];
+        if (gap.severity === 'minor') {
+            if (iteration === 1)
+                weight = 0;
+            else if (iteration === 2)
+                weight = 1;
+        }
+        const category = gap.category;
+        if (weight < 0) {
+            categoryBonuses.set(category, (categoryBonuses.get(category) ?? 0) + Math.abs(weight));
+        }
+        else {
+            categoryDeductions.set(category, (categoryDeductions.get(category) ?? 0) + weight);
+        }
+    }
+    let deductions = 0;
+    for (const [category, total] of categoryDeductions) {
+        const cap = CATEGORY_PENALTY_CAPS[category];
+        deductions += cap !== undefined ? Math.min(total, cap) : total;
+    }
+    let bonuses = 0;
+    for (const [category, total] of categoryBonuses) {
+        const cap = CATEGORY_BONUS_CAPS[category];
+        bonuses += cap !== undefined ? Math.min(total, cap) : total;
+    }
+    return Math.max(0, Math.min(100, 100 - deductions + bonuses));
+}
+// ─── Structural Validation ───────────────────────────────────────
+/**
+ * Detect circular dependencies among tasks.
+ * Uses DFS with in-stack tracking.
+ */
+export function hasCircularDependencies(tasks) {
+    const visited = new Set();
+    const inStack = new Set();
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const dfs = (taskId) => {
+        if (inStack.has(taskId))
+            return true;
+        if (visited.has(taskId))
+            return false;
+        visited.add(taskId);
+        inStack.add(taskId);
+        const task = taskMap.get(taskId);
+        if (task?.dependsOn) {
+            for (const dep of task.dependsOn) {
+                if (dfs(dep))
+                    return true;
+            }
+        }
+        inStack.delete(taskId);
+        return false;
+    };
+    for (const task of tasks) {
+        if (dfs(task.id))
+            return true;
+    }
+    return false;
+}
+/**
+ * Apply iteration changes to a plan (mutates in place).
+ * Caller is responsible for status validation and persistence.
+ */
+export function applyIteration(plan, changes) {
+    const now = Date.now();
+    if (changes.objective !== undefined)
+        plan.objective = changes.objective;
+    if (changes.scope !== undefined)
+        plan.scope = changes.scope;
+    if (changes.decisions !== undefined)
+        plan.decisions = changes.decisions;
+    if (changes.approach !== undefined)
+        plan.approach = changes.approach;
+    if (changes.context !== undefined)
+        plan.context = changes.context;
+    if (changes.success_criteria !== undefined)
+        plan.success_criteria = changes.success_criteria;
+    if (changes.tool_chain !== undefined)
+        plan.tool_chain = changes.tool_chain;
+    if (changes.flow !== undefined)
+        plan.flow = changes.flow;
+    if (changes.target_mode !== undefined)
+        plan.target_mode = changes.target_mode;
+    if (changes.removeTasks?.length) {
+        const removeSet = new Set(changes.removeTasks);
+        plan.tasks = plan.tasks.filter((t) => !removeSet.has(t.id));
+    }
+    if (changes.addTasks?.length) {
+        const maxIndex = plan.tasks.reduce((max, t) => {
+            const num = parseInt(t.id.replace('task-', ''), 10);
+            return isNaN(num) ? max : Math.max(max, num);
+        }, 0);
+        for (let i = 0; i < changes.addTasks.length; i++) {
+            plan.tasks.push({
+                id: `task-${maxIndex + i + 1}`,
+                title: changes.addTasks[i].title,
+                description: changes.addTasks[i].description,
+                status: 'pending',
+                updatedAt: now,
+            });
+        }
+    }
+    plan.updatedAt = now;
+}
+/**
+ * Replace plan tasks with a new split set, validating dependency references.
+ * Caller is responsible for status validation and persistence.
+ */
+/**
+ * Apply a task status update with auto-metrics (startedAt, completedAt, durationMs).
+ * Caller is responsible for plan status validation and persistence.
+ */
+export function applyTaskStatusUpdate(task, status) {
+    const now = Date.now();
+    if (status === 'in_progress' && !task.startedAt)
+        task.startedAt = now;
+    if (status === 'completed' || status === 'skipped' || status === 'failed') {
+        task.completedAt = now;
+        if (task.startedAt) {
+            if (!task.metrics)
+                task.metrics = {};
+            task.metrics.durationMs = now - task.startedAt;
+        }
+    }
+    task.status = status;
+    task.updatedAt = now;
+}
+/**
+ * Create a new Plan object (factory). Does not persist.
+ */
+export function createPlanObject(params) {
+    const now = Date.now();
+    return {
+        id: `plan-${now}-${Math.random().toString(36).slice(2, 8)}`,
+        objective: params.objective,
+        scope: params.scope,
+        status: params.initialStatus ?? 'draft',
+        decisions: params.decisions ?? [],
+        tasks: (params.tasks ?? []).map((t, i) => ({
+            id: `task-${i + 1}`,
+            title: t.title,
+            description: t.description,
+            status: 'pending',
+            updatedAt: now,
+        })),
+        ...(params.approach !== undefined && { approach: params.approach }),
+        ...(params.context !== undefined && { context: params.context }),
+        ...(params.success_criteria !== undefined && { success_criteria: params.success_criteria }),
+        ...(params.tool_chain !== undefined && { tool_chain: params.tool_chain }),
+        ...(params.flow !== undefined && { flow: params.flow }),
+        ...(params.target_mode !== undefined && { target_mode: params.target_mode }),
+        ...(params.alternatives !== undefined && { alternatives: params.alternatives }),
+        checks: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function applySplitTasks(plan, tasks) {
+    const now = Date.now();
+    plan.tasks = tasks.map((t, i) => ({
+        id: `task-${i + 1}`,
+        title: t.title,
+        description: t.description,
+        status: 'pending',
+        dependsOn: t.dependsOn,
+        ...(t.acceptanceCriteria && { acceptanceCriteria: t.acceptanceCriteria }),
+        updatedAt: now,
+    }));
+    const taskIds = new Set(plan.tasks.map((t) => t.id));
+    for (const task of plan.tasks) {
+        if (task.dependsOn) {
+            for (const dep of task.dependsOn) {
+                if (!taskIds.has(dep))
+                    throw new Error(`Task '${task.id}' depends on unknown task '${dep}'`);
+            }
+        }
+    }
+    plan.updatedAt = now;
+}
+//# sourceMappingURL=plan-lifecycle.js.map

package/dist/planning/plan-lifecycle.js.map

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

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

@@ -0,0 +1,202 @@
+/**
+ * Shared type definitions for the planning module.
+ * Extracted to avoid circular imports between planner.ts and its extracted modules.
+ */
+import type { PlanStatus, PlanGrade } from './plan-lifecycle.js';
+import type { PlanGap } from './gap-types.js';
+import type { GapAnalysisOptions } from './gap-analysis.js';
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed';
+export interface TaskEvidence {
+    /** What the evidence proves (maps to an acceptance criterion). */
+    criterion: string;
+    /** Evidence content — command output, URL, file path, description. */
+    content: string;
+    /** Evidence type. */
+    type: 'command_output' | 'url' | 'file' | 'description';
+    submittedAt: number;
+}
+export interface TaskMetrics {
+    durationMs?: number;
+    iterations?: number;
+    toolCalls?: number;
+    modelTier?: string;
+    estimatedCostUsd?: number;
+}
+export interface TaskDeliverable {
+    type: 'file' | 'vault_entry' | 'url';
+    path: string;
+    hash?: string;
+    verifiedAt?: number;
+    stale?: boolean;
+}
+export interface ExecutionSummary {
+    totalDurationMs: number;
+    tasksCompleted: number;
+    tasksSkipped: number;
+    tasksFailed: number;
+    avgTaskDurationMs: number;
+}
+export interface VerificationFinding {
+    /** What was found (bug, issue, code smell). */
+    description: string;
+    /** How severe the finding is. */
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    /** Whether the finding was proven reproducible before fixing. */
+    proven: boolean;
+    /** How the finding was proven (test case, reproduction steps, stack trace). */
+    proof?: string;
+}
+export interface TaskVerification {
+    /** Findings that motivated changes to existing code. */
+    findings: VerificationFinding[];
+}
+export interface PlanTask {
+    id: string;
+    title: string;
+    description: string;
+    status: TaskStatus;
+    /** Optional dependency IDs — tasks that must complete before this one. */
+    dependsOn?: string[];
+    /** Evidence submitted for task acceptance criteria. */
+    evidence?: TaskEvidence[];
+    /** Whether this task has been verified (all evidence checked + reviews passed). */
+    verified?: boolean;
+    /** Task-level acceptance criteria (for verification checking). */
+    acceptanceCriteria?: string[];
+    /** Timestamp when task was first moved to in_progress. */
+    startedAt?: number;
+    /** Timestamp when task reached a terminal state (completed/skipped/failed). */
+    completedAt?: number;
+    /** Per-task execution metrics. */
+    metrics?: TaskMetrics;
+    /** Deliverables produced by this task. */
+    deliverables?: TaskDeliverable[];
+    /** Verification findings for tasks that modify existing code. Advisory only. */
+    verification?: TaskVerification;
+    updatedAt: number;
+}
+export interface DriftItem {
+    /** Type of drift */
+    type: 'skipped' | 'added' | 'modified' | 'reordered';
+    /** What drifted */
+    description: string;
+    /** How much this affected the plan */
+    impact: 'low' | 'medium' | 'high';
+    /** Why the drift occurred */
+    rationale: string;
+}
+export interface ReconciliationReport {
+    planId: string;
+    /** Accuracy score: 100 = perfect execution, 0 = total drift. Impact-weighted. */
+    accuracy: number;
+    driftItems: DriftItem[];
+    /** Human-readable summary of the drift */
+    summary: string;
+    reconciledAt: number;
+}
+export interface ReviewEvidence {
+    planId: string;
+    taskId?: string;
+    reviewer: string;
+    outcome: 'approved' | 'rejected' | 'needs_changes';
+    comments: string;
+    reviewedAt: number;
+}
+export interface PlanCheck {
+    checkId: string;
+    planId: string;
+    grade: PlanGrade;
+    score: number;
+    gaps: PlanGap[];
+    iteration: number;
+    checkedAt: number;
+}
+/**
+ * A structured decision with rationale.
+ * Ported from Salvador's PlanContent.decisions.
+ */
+export interface PlanDecision {
+    decision: string;
+    rationale: string;
+}
+/**
+ * A rejected alternative approach considered during planning.
+ * Plans with 2+ alternatives score higher — forced alternative analysis
+ * prevents tunnel vision and strengthens decision rationale.
+ */
+export interface PlanAlternative {
+    approach: string;
+    pros: string[];
+    cons: string[];
+    rejected_reason: string;
+}
+export interface Plan {
+    id: string;
+    objective: string;
+    scope: string;
+    status: PlanStatus;
+    /**
+     * Decisions can be flat strings (backward compat) or structured {decision, rationale}.
+     * New plans should prefer PlanDecision[].
+     */
+    decisions: (string | PlanDecision)[];
+    tasks: PlanTask[];
+    /** High-level approach description. Ported from Salvador's PlanContent. */
+    approach?: string;
+    /** Additional context for the plan. */
+    context?: string;
+    /** Measurable success criteria. */
+    success_criteria?: string[];
+    /** Tools to use in execution order. */
+    tool_chain?: string[];
+    /** Flow definition to follow (e.g., 'developer', 'reviewer', 'designer'). */
+    flow?: string;
+    /** Target operational mode (e.g., 'build', 'review', 'fix'). */
+    target_mode?: string;
+    /** Rejected alternative approaches — plans with 2+ alternatives score higher. */
+    alternatives?: PlanAlternative[];
+    /** Reconciliation report — populated by reconcile(). */
+    reconciliation?: ReconciliationReport;
+    /** Review evidence — populated by addReview(). */
+    reviews?: ReviewEvidence[];
+    /** Latest grading check. */
+    latestCheck?: PlanCheck;
+    /** All check history. */
+    checks: PlanCheck[];
+    /** Matched playbook info (set by orchestration layer via playbook_match). */
+    playbookMatch?: {
+        label: string;
+        genericId?: string;
+        domainId?: string;
+    };
+    /** Source GitHub issue this plan was created from (e.g., #NNN in prompt). */
+    githubIssue?: {
+        owner: string;
+        repo: string;
+        number: number;
+    };
+    /** GitHub issue projection — populated by orchestrate_project_to_github. */
+    githubProjection?: {
+        repo: string;
+        milestone?: number;
+        issues: Array<{
+            taskId: string;
+            issueNumber: number;
+        }>;
+        projectedAt: number;
+    };
+    /** Aggregate execution metrics — populated by reconcile() and complete(). */
+    executionSummary?: ExecutionSummary;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface PlanStore {
+    version: string;
+    plans: Plan[];
+}
+export interface PlannerOptions {
+    gapOptions?: GapAnalysisOptions;
+    /** Minimum grade required for plan approval. Default: 'A'. Set to undefined to disable. */
+    minGradeForApproval?: PlanGrade;
+}
+//# sourceMappingURL=planner-types.d.ts.map

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

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