planflow-ai 1.3.5 → 1.4.1

package/dist/cli/state/model-router.js

@@ -0,0 +1,36 @@
+/**
+ * Map a complexity score to a model tier and model name.
+ *
+ * - 0-3  -> fast     (haiku)
+ * - 4-5  -> standard (sonnet)
+ * - 6-10 -> powerful (opus)
+ */
+function complexityToTier(complexity) {
+    if (complexity <= 3) {
+        return { tier: 'fast', model: 'haiku' };
+    }
+    if (complexity <= 5) {
+        return { tier: 'standard', model: 'sonnet' };
+    }
+    return { tier: 'powerful', model: 'opus' };
+}
+/**
+ * Calculate model tiers for each plan phase based on complexity scores.
+ *
+ * Returns an empty array when model routing is disabled.
+ */
+export function calculateModelTiers(phases, modelRoutingEnabled) {
+    if (!modelRoutingEnabled) {
+        return [];
+    }
+    return phases.map((phase) => {
+        const { tier, model } = complexityToTier(phase.complexity);
+        return {
+            phase: phase.number,
+            complexity: phase.complexity,
+            tier,
+            model,
+        };
+    });
+}
+//# sourceMappingURL=model-router.js.map

package/dist/cli/state/model-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.js","sourceRoot":"","sources":["../../../src/cli/state/model-router.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAmB,EACnB,mBAA4B;IAE5B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,IAAI;YACJ,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/state/plan-parser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Plan markdown parser
+ *
+ * Parses plan files (flow/plans/plan_*.md) into structured PlanPhase objects.
+ * Extracts phase headers, complexity scores, dependencies, tasks, and verify tags.
+ */
+import type { PlanPhase } from './types.js';
+/**
+ * Parses a plan markdown file and returns an array of PlanPhase objects.
+ */
+export declare function parsePlan(planPath: string): PlanPhase[];
+/**
+ * Parses plan markdown content (for testability without file I/O).
+ */
+export declare function parsePlanContent(content: string): PlanPhase[];
+//# sourceMappingURL=plan-parser.d.ts.map

package/dist/cli/state/plan-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-parser.d.ts","sourceRoot":"","sources":["../../../src/cli/state/plan-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AAWtD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAGvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAiG7D"}

package/dist/cli/state/plan-parser.js

@@ -0,0 +1,124 @@
+/**
+ * Plan markdown parser
+ *
+ * Parses plan files (flow/plans/plan_*.md) into structured PlanPhase objects.
+ * Extracts phase headers, complexity scores, dependencies, tasks, and verify tags.
+ */
+import { readFileSync } from 'node:fs';
+const PHASE_HEADER_RE = /^### Phase (\d+):\s*(.+)$/;
+const COMPLEXITY_RE = /\*\*Complexity\*\*:\s*(\d+)\/10/;
+const DEPENDENCIES_RE = /\*\*Dependencies\*\*:\s*(.+)/;
+const TASK_RE = /^- \[[ x]\]\s+(.+)$/;
+const VERIFY_RE = /<verify>(.+)<\/verify>/;
+const PHASE_REF_RE = /Phase\s+(\d+)/gi;
+const DEFAULT_COMPLEXITY = 5;
+/**
+ * Parses a plan markdown file and returns an array of PlanPhase objects.
+ */
+export function parsePlan(planPath) {
+    const content = readFileSync(planPath, 'utf-8');
+    return parsePlanContent(content);
+}
+/**
+ * Parses plan markdown content (for testability without file I/O).
+ */
+export function parsePlanContent(content) {
+    const phases = [];
+    const lines = content.split('\n');
+    let currentPhase = null;
+    let lastTaskIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Phase header
+        const headerMatch = trimmed.match(PHASE_HEADER_RE);
+        if (headerMatch) {
+            // Save previous phase
+            if (currentPhase) {
+                phases.push(finalizePhase(currentPhase));
+            }
+            currentPhase = {
+                number: parseInt(headerMatch[1], 10),
+                name: headerMatch[2].trim(),
+                complexity: null,
+                dependencies: null,
+                tasks: [],
+            };
+            lastTaskIndex = -1;
+            continue;
+        }
+        if (!currentPhase)
+            continue;
+        // Complexity
+        const complexityMatch = trimmed.match(COMPLEXITY_RE);
+        if (complexityMatch) {
+            currentPhase.complexity = parseInt(complexityMatch[1], 10);
+            continue;
+        }
+        // Dependencies
+        const depsMatch = trimmed.match(DEPENDENCIES_RE);
+        if (depsMatch) {
+            const depsValue = depsMatch[1].trim();
+            if (/^none$/i.test(depsValue)) {
+                currentPhase.dependencies = [];
+            }
+            else {
+                const depNumbers = [];
+                let match;
+                // Reset regex state for each use
+                const phaseRefRe = /Phase\s+(\d+)/gi;
+                while ((match = phaseRefRe.exec(depsValue)) !== null) {
+                    depNumbers.push(parseInt(match[1], 10));
+                }
+                currentPhase.dependencies = depNumbers.length > 0 ? depNumbers : [];
+            }
+            continue;
+        }
+        // Task line
+        const taskMatch = trimmed.match(TASK_RE);
+        if (taskMatch) {
+            const taskName = taskMatch[1].trim();
+            currentPhase.tasks.push({ index: currentPhase.tasks.length + 1, name: taskName, verify_command: null });
+            lastTaskIndex = currentPhase.tasks.length - 1;
+            continue;
+        }
+        // Verify tag (must follow a task line)
+        if (lastTaskIndex >= 0) {
+            const verifyMatch = trimmed.match(VERIFY_RE);
+            if (verifyMatch) {
+                currentPhase.tasks[lastTaskIndex].verify_command = verifyMatch[1].trim();
+                lastTaskIndex = -1;
+                continue;
+            }
+            // If non-empty, non-verify line after a task, reset lastTaskIndex
+            if (trimmed !== '') {
+                lastTaskIndex = -1;
+            }
+        }
+    }
+    // Save the last phase
+    if (currentPhase) {
+        phases.push(finalizePhase(currentPhase));
+    }
+    return phases;
+}
+function finalizePhase(phase) {
+    const complexity = phase.complexity ?? DEFAULT_COMPLEXITY;
+    // Dependencies: if explicitly set, use them; otherwise sequential fallback
+    let dependencies;
+    if (phase.dependencies !== null) {
+        dependencies = phase.dependencies;
+    }
+    else {
+        // Sequential fallback: depend on previous phase, Phase 1 has no deps
+        dependencies = phase.number > 1 ? [phase.number - 1] : [];
+    }
+    return {
+        number: phase.number,
+        name: phase.name,
+        complexity,
+        dependencies,
+        tasks: phase.tasks,
+    };
+}
+//# sourceMappingURL=plan-parser.js.map

package/dist/cli/state/plan-parser.js.map

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

package/dist/cli/state/session-state.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Session state checker — detects which session-start files exist
+ * in the flow directory, returning a structured SessionState object.
+ */
+import type { SessionState } from './types.js';
+/**
+ * Checks existence of all session-start files and returns structured state.
+ *
+ * Files checked:
+ * - ledger.md
+ * - brain/index.md
+ * - tasklist.md
+ * - memory.md
+ * - .scratchpad.md
+ * - .heartbeat-events.jsonl
+ * - .heartbeat-state.json
+ * - .heartbeat-prompt.md
+ * - STATE.md
+ */
+export declare function getSessionState(flowDir: string): SessionState;
+//# sourceMappingURL=session-state.d.ts.map

package/dist/cli/state/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../../src/cli/state/session-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAc7D"}

package/dist/cli/state/session-state.js

@@ -0,0 +1,36 @@
+/**
+ * Session state checker — detects which session-start files exist
+ * in the flow directory, returning a structured SessionState object.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Checks existence of all session-start files and returns structured state.
+ *
+ * Files checked:
+ * - ledger.md
+ * - brain/index.md
+ * - tasklist.md
+ * - memory.md
+ * - .scratchpad.md
+ * - .heartbeat-events.jsonl
+ * - .heartbeat-state.json
+ * - .heartbeat-prompt.md
+ * - STATE.md
+ */
+export function getSessionState(flowDir) {
+    return {
+        files_present: {
+            ledger: existsSync(join(flowDir, 'ledger.md')),
+            brain_index: existsSync(join(flowDir, 'brain', 'index.md')),
+            tasklist: existsSync(join(flowDir, 'tasklist.md')),
+            memory: existsSync(join(flowDir, 'memory.md')),
+            scratchpad: existsSync(join(flowDir, '.scratchpad.md')),
+            heartbeat_events: existsSync(join(flowDir, '.heartbeat-events.jsonl')),
+            heartbeat_state: existsSync(join(flowDir, '.heartbeat-state.json')),
+            heartbeat_prompt: existsSync(join(flowDir, '.heartbeat-prompt.md')),
+            state_md: existsSync(join(flowDir, 'STATE.md')),
+        },
+    };
+}
+//# sourceMappingURL=session-state.js.map

package/dist/cli/state/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../../src/cli/state/session-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO;QACL,aAAa,EAAE;YACb,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC9C,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YAC3D,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAClD,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC9C,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YACvD,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;YACtE,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;YACnE,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;YACnE,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;SAChD;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/state/state-md-parser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * STATE.md Parser
+ *
+ * Parses `flow/STATE.md` into a structured ExecutionState object.
+ * Uses regex-based line parsing consistent with flowconfig-parser and plan-parser patterns.
+ * Returns null if STATE.md doesn't exist.
+ */
+import type { ExecutionState } from './types.js';
+/**
+ * Parse `flow/STATE.md` into a structured ExecutionState object.
+ * Returns null if STATE.md doesn't exist.
+ */
+export declare function parseStateMd(flowDir: string): ExecutionState | null;
+/**
+ * Parse STATE.md content string (for testability without file I/O).
+ */
+export declare function parseStateMdContent(content: string): ExecutionState;
+//# sourceMappingURL=state-md-parser.d.ts.map

package/dist/cli/state/state-md-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-md-parser.d.ts","sourceRoot":"","sources":["../../../src/cli/state/state-md-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAqC,cAAc,EAAE,MAAM,YAAY,CAAC;AASpF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAenE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAuEnE"}

package/dist/cli/state/state-md-parser.js

@@ -0,0 +1,222 @@
+/**
+ * STATE.md Parser
+ *
+ * Parses `flow/STATE.md` into a structured ExecutionState object.
+ * Uses regex-based line parsing consistent with flowconfig-parser and plan-parser patterns.
+ * Returns null if STATE.md doesn't exist.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const SECTION_RE = /^## (.+)$/;
+const BOLD_KV_RE = /^- \*\*(.+?)\*\*:\s*(.*)$/;
+const BULLET_RE = /^- (.+)$/;
+const UPDATED_RE = /^\*\*Updated\*\*:\s*(.+)$/;
+const COMPLETED_PHASE_RE = /^Phase (\d+):\s*(.+?)\s*—\s*(.+)$/;
+const CURRENT_PHASE_RE = /^(\d+)\s*—\s*(.+)$/;
+/**
+ * Parse `flow/STATE.md` into a structured ExecutionState object.
+ * Returns null if STATE.md doesn't exist.
+ */
+export function parseStateMd(flowDir) {
+    const statePath = join(flowDir, 'STATE.md');
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    let content;
+    try {
+        content = readFileSync(statePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    return parseStateMdContent(content);
+}
+/**
+ * Parse STATE.md content string (for testability without file I/O).
+ */
+export function parseStateMdContent(content) {
+    const state = {
+        active_skill: null,
+        active_plan: null,
+        current_phase: null,
+        current_task: null,
+        completed_phases: [],
+        decisions: [],
+        blockers: [],
+        files_modified: [],
+        next_action: null,
+        updated_at: null,
+    };
+    const lines = content.split('\n');
+    let currentSection = '';
+    let inCompletedPhases = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Updated timestamp (outside sections)
+        const updatedMatch = trimmed.match(UPDATED_RE);
+        if (updatedMatch) {
+            state.updated_at = updatedMatch[1].trim();
+            continue;
+        }
+        // Section header
+        const sectionMatch = trimmed.match(SECTION_RE);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1].trim();
+            inCompletedPhases = false;
+            continue;
+        }
+        if (currentSection === 'Execution State') {
+            parseExecutionStateLine(trimmed, state, inCompletedPhases);
+            // Track if we just entered completed phases sub-list
+            const kvMatch = trimmed.match(BOLD_KV_RE);
+            if (kvMatch && kvMatch[1] === 'Completed Phases') {
+                inCompletedPhases = true;
+            }
+            else if (kvMatch && kvMatch[1] !== 'Completed Phases') {
+                inCompletedPhases = false;
+            }
+            // Indented bullets under Completed Phases
+            if (inCompletedPhases && line.match(/^\s{2,}- /)) {
+                const indentedContent = trimmed.replace(/^- /, '');
+                const phaseMatch = indentedContent.match(COMPLETED_PHASE_RE);
+                if (phaseMatch) {
+                    state.completed_phases.push({
+                        number: parseInt(phaseMatch[1], 10),
+                        name: phaseMatch[2].trim(),
+                        outcome: phaseMatch[3].trim(),
+                    });
+                }
+            }
+        }
+        else if (currentSection === 'Decisions') {
+            parseDecisionLine(trimmed, state);
+        }
+        else if (currentSection === 'Blockers') {
+            parseBlockerLine(trimmed, state);
+        }
+        else if (currentSection === 'Files Modified') {
+            parseFileModifiedLine(trimmed, state);
+        }
+        else if (currentSection === 'Next Action') {
+            parseNextActionLine(trimmed, state);
+        }
+    }
+    return state;
+}
+/**
+ * Parse a line within the Execution State section.
+ */
+function parseExecutionStateLine(trimmed, state, inCompletedPhases) {
+    if (inCompletedPhases)
+        return;
+    const kvMatch = trimmed.match(BOLD_KV_RE);
+    if (!kvMatch)
+        return;
+    const key = kvMatch[1].trim();
+    const value = kvMatch[2].trim();
+    switch (key) {
+        case 'Active Skill':
+            state.active_skill = value;
+            break;
+        case 'Active Plan':
+            state.active_plan = value;
+            break;
+        case 'Current Phase': {
+            const phaseMatch = value.match(CURRENT_PHASE_RE);
+            if (phaseMatch) {
+                state.current_phase = {
+                    number: parseInt(phaseMatch[1], 10),
+                    name: phaseMatch[2].trim(),
+                };
+            }
+            break;
+        }
+        case 'Current Task':
+            state.current_task = value;
+            break;
+    }
+}
+/**
+ * Parse a decision bullet line.
+ * Format: "- Chose X over Y (reason: Z)" or "- Decision text (reason: explanation)"
+ */
+function parseDecisionLine(trimmed, state) {
+    const bulletMatch = trimmed.match(BULLET_RE);
+    if (!bulletMatch)
+        return;
+    const text = bulletMatch[1].trim();
+    const reasonMatch = text.match(/^(.+?)\s*\(reason:\s*(.+?)\)$/);
+    if (reasonMatch) {
+        const decisionText = reasonMatch[1].trim();
+        // Try to extract "Chose X over Y" pattern
+        const choseMatch = decisionText.match(/^(?:Chose|Used)\s+(.+?)(?:\s+(?:over|for|instead of)\s+(.+))?$/i);
+        if (choseMatch) {
+            state.decisions.push({
+                decision: decisionText,
+                choice: choseMatch[1].trim(),
+                reason: reasonMatch[2].trim(),
+            });
+        }
+        else {
+            state.decisions.push({
+                decision: decisionText,
+                choice: decisionText,
+                reason: reasonMatch[2].trim(),
+            });
+        }
+    }
+    else {
+        state.decisions.push({
+            decision: text,
+            choice: text,
+            reason: '',
+        });
+    }
+}
+/**
+ * Parse a blocker bullet line.
+ * Format: "- Issue description (status: X, tried: Y)"
+ */
+function parseBlockerLine(trimmed, state) {
+    const bulletMatch = trimmed.match(BULLET_RE);
+    if (!bulletMatch)
+        return;
+    const text = bulletMatch[1].trim();
+    const detailsMatch = text.match(/^(.+?)\s*\(status:\s*(.+?),\s*tried:\s*(.+?)\)$/);
+    if (detailsMatch) {
+        state.blockers.push({
+            issue: detailsMatch[1].trim(),
+            status: detailsMatch[2].trim(),
+            tried: detailsMatch[3].trim(),
+        });
+    }
+    else {
+        state.blockers.push({
+            issue: text,
+            status: 'unknown',
+            tried: '',
+        });
+    }
+}
+/**
+ * Parse a file path bullet line.
+ */
+function parseFileModifiedLine(trimmed, state) {
+    const bulletMatch = trimmed.match(BULLET_RE);
+    if (!bulletMatch)
+        return;
+    const filePath = bulletMatch[1].trim();
+    if (filePath) {
+        state.files_modified.push(filePath);
+    }
+}
+/**
+ * Parse the next action line (first non-empty line in the section).
+ */
+function parseNextActionLine(trimmed, state) {
+    if (trimmed && !state.next_action) {
+        state.next_action = trimmed;
+    }
+}
+//# sourceMappingURL=state-md-parser.js.map

package/dist/cli/state/state-md-parser.js.map

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

package/dist/cli/state/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Types for the deterministic state script (`planflow-ai state`).
+ *
+ * These interfaces define the JSON output shape produced by parsing
+ * plan-flow config files, session state, heartbeat events, and plans.
+ */
+export interface FlowConfig {
+    autopilot: boolean;
+    commit: boolean;
+    push: boolean;
+    pr: boolean;
+    branch: string;
+    wave_execution: boolean;
+    phase_isolation: boolean;
+    model_routing: boolean;
+    max_verify_retries: number;
+}
+export interface SessionState {
+    files_present: {
+        ledger: boolean;
+        brain_index: boolean;
+        tasklist: boolean;
+        memory: boolean;
+        scratchpad: boolean;
+        heartbeat_events: boolean;
+        heartbeat_state: boolean;
+        heartbeat_prompt: boolean;
+        state_md: boolean;
+    };
+}
+export interface HeartbeatSummary {
+    unread_count: number;
+    has_prompt: boolean;
+    last_read_timestamp: string | null;
+}
+export interface TaskCompletion {
+    task_number: number;
+    task_name: string;
+    files_created: string[];
+    files_modified: string[];
+}
+export interface PlanTask {
+    index: number;
+    name: string;
+    verify_command: string | null;
+}
+export interface PlanPhase {
+    number: number;
+    name: string;
+    complexity: number;
+    dependencies: number[];
+    tasks: PlanTask[];
+}
+export interface WaveGroup {
+    wave_number: number;
+    phase_numbers: number[];
+}
+export type ModelTierLevel = 'fast' | 'standard' | 'powerful';
+export interface ModelTier {
+    phase: number;
+    complexity: number;
+    tier: ModelTierLevel;
+    model: string;
+}
+export interface CompletedPhase {
+    number: number;
+    name: string;
+    outcome: string;
+}
+export interface Decision {
+    decision: string;
+    choice: string;
+    reason: string;
+}
+export interface Blocker {
+    issue: string;
+    status: string;
+    tried: string;
+}
+export interface ExecutionState {
+    active_skill: string | null;
+    active_plan: string | null;
+    current_phase: {
+        number: number;
+        name: string;
+    } | null;
+    current_task: string | null;
+    completed_phases: CompletedPhase[];
+    decisions: Decision[];
+    blockers: Blocker[];
+    files_modified: string[];
+    next_action: string | null;
+    updated_at: string | null;
+}
+export interface StateOutput {
+    config: FlowConfig;
+    session: SessionState;
+    heartbeat: HeartbeatSummary;
+    execution?: ExecutionState;
+    plan?: {
+        phases: PlanPhase[];
+        waves: WaveGroup[];
+        model_tiers: ModelTier[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/state/types.d.ts.map

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

package/dist/cli/state/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for the deterministic state script (`planflow-ai state`).
+ *
+ * These interfaces define the JSON output shape produced by parsing
+ * plan-flow config files, session state, heartbeat events, and plans.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/state/types.js.map

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

package/dist/cli/state/wave-calculator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Wave calculator — topological sort of phase dependencies into wave groups.
+ *
+ * Phases with no dependencies land in wave 1. Each subsequent phase lands in
+ * wave = max(wave of each dependency) + 1. A "Tests" phase (last phase whose
+ * name contains "test", case-insensitive) is always isolated in the final wave.
+ *
+ * If a circular dependency is detected the fallback is sequential execution:
+ * one phase per wave in phase-number order.
+ */
+import type { PlanPhase, WaveGroup } from './types.js';
+/**
+ * Calculate wave groups from plan phases.
+ *
+ * @returns Sorted array of WaveGroup objects.
+ */
+export declare function calculateWaves(phases: PlanPhase[]): WaveGroup[];
+//# sourceMappingURL=wave-calculator.d.ts.map

package/dist/cli/state/wave-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave-calculator.d.ts","sourceRoot":"","sources":["../../../src/cli/state/wave-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA6CvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAuF/D"}