planflow-ai 1.3.5 → 1.4.3

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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAC/C,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAC/C,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAC/D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE5C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAmB;QAC5B,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,EAAE;QACpB,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;KACjB,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,uCAAuC;QACvC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,iBAAiB;QACjB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,iBAAiB,GAAG,KAAK,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,cAAc,KAAK,iBAAiB,EAAE,CAAC;YACzC,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;YAE3D,qDAAqD;YACrD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,kBAAkB,EAAE,CAAC;gBACjD,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,kBAAkB,EAAE,CAAC;gBACxD,iBAAiB,GAAG,KAAK,CAAC;YAC5B,CAAC;YACD,0CAA0C;YAC1C,IAAI,iBAAiB,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjD,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;gBAC7D,IAAI,UAAU,EAAE,CAAC;oBACf,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC;wBAC1B,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;wBACnC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;wBAC1B,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;qBAC9B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;YAC1C,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,cAAc,KAAK,gBAAgB,EAAE,CAAC;YAC/C,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;YAC5C,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,OAAe,EAAE,KAAqB,EAAE,iBAA0B;IACjG,IAAI,iBAAiB;QAAE,OAAO;IAE9B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,cAAc;YACjB,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;YAC3B,MAAM;QACR,KAAK,aAAa;YAChB,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;YAC1B,MAAM;QACR,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACjD,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,CAAC,aAAa,GAAG;oBACpB,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACnC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;iBAC3B,CAAC;YACJ,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,cAAc;YACjB,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;YAC3B,MAAM;IACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,OAAe,EAAE,KAAqB;IAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAEhE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,0CAA0C;QAC1C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACzG,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;gBACnB,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC5B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;gBACnB,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAE,KAAqB;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAEnF,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC7B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC9B,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,OAAe,EAAE,KAAqB;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,KAAqB;IACjE,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC;IAC9B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,137 @@
+/**
+ * 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 ContextEntryType = 'contract' | 'decision' | 'progress';
+export type ContractKind = 'endpoint' | 'interface' | 'function' | 'type';
+export interface ContractData {
+    name: string;
+    kind: ContractKind;
+    signature: string;
+    fields?: string[];
+}
+export interface DecisionData {
+    choice: string;
+    reason?: string;
+}
+export interface ProgressData {
+    task: number;
+    status: 'complete' | 'in-progress';
+    summary?: string;
+}
+export interface ContextEntry {
+    agent: string;
+    type: ContextEntryType;
+    timestamp: string;
+    data: ContractData | DecisionData | ProgressData;
+}
+export interface ContractConflict {
+    name: string;
+    entries: {
+        agent: string;
+        signature: string;
+        fields?: string[];
+    }[];
+}
+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"}

package/dist/cli/state/wave-calculator.js

@@ -0,0 +1,134 @@
+/**
+ * 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.
+ */
+/**
+ * Detect whether the dependency graph contains a cycle using iterative DFS.
+ */
+function hasCycle(phaseNumbers, adjacency) {
+    const WHITE = 0;
+    const GRAY = 1;
+    const BLACK = 2;
+    const color = new Map();
+    for (const n of phaseNumbers)
+        color.set(n, WHITE);
+    for (const start of phaseNumbers) {
+        if (color.get(start) !== WHITE)
+            continue;
+        const stack = [
+            { node: start, idx: 0 },
+        ];
+        color.set(start, GRAY);
+        while (stack.length > 0) {
+            const top = stack[stack.length - 1];
+            const neighbors = adjacency.get(top.node) ?? [];
+            if (top.idx < neighbors.length) {
+                const neighbor = neighbors[top.idx];
+                top.idx++;
+                const c = color.get(neighbor);
+                if (c === GRAY)
+                    return true; // back-edge → cycle
+                if (c === WHITE) {
+                    color.set(neighbor, GRAY);
+                    stack.push({ node: neighbor, idx: 0 });
+                }
+            }
+            else {
+                color.set(top.node, BLACK);
+                stack.pop();
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Calculate wave groups from plan phases.
+ *
+ * @returns Sorted array of WaveGroup objects.
+ */
+export function calculateWaves(phases) {
+    if (phases.length === 0)
+        return [];
+    // Build adjacency list (phase → phases it depends on, i.e. forward edges
+    // point from a phase to its dependencies for the purpose of cycle detection).
+    // For cycle detection we need "phase → successors" (who depends on me).
+    const phaseNumbers = phases.map((p) => p.number);
+    const depMap = new Map();
+    const successorMap = new Map();
+    for (const p of phases) {
+        depMap.set(p.number, [...p.dependencies]);
+        if (!successorMap.has(p.number))
+            successorMap.set(p.number, []);
+        for (const dep of p.dependencies) {
+            if (!successorMap.has(dep))
+                successorMap.set(dep, []);
+            successorMap.get(dep).push(p.number);
+        }
+    }
+    // Cycle detection — use successor adjacency for DFS.
+    if (hasCycle(phaseNumbers, successorMap)) {
+        // Fallback: sequential, one phase per wave.
+        const sorted = [...phaseNumbers].sort((a, b) => a - b);
+        return sorted.map((n, i) => ({
+            wave_number: i + 1,
+            phase_numbers: [n],
+        }));
+    }
+    // Assign wave numbers iteratively.
+    const waveOf = new Map();
+    const phaseSet = new Set(phaseNumbers);
+    // Iterative assignment: keep going until all phases are assigned.
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const p of phases) {
+            if (waveOf.has(p.number))
+                continue;
+            // Filter dependencies to only those that are actual phases in the plan.
+            const deps = (depMap.get(p.number) ?? []).filter((d) => phaseSet.has(d));
+            if (deps.length === 0) {
+                waveOf.set(p.number, 1);
+                changed = true;
+            }
+            else if (deps.every((d) => waveOf.has(d))) {
+                const maxDepWave = Math.max(...deps.map((d) => waveOf.get(d)));
+                waveOf.set(p.number, maxDepWave + 1);
+                changed = true;
+            }
+        }
+    }
+    // Detect Tests phase: last phase by number whose name contains "test".
+    const sortedPhases = [...phases].sort((a, b) => a.number - b.number);
+    const lastPhase = sortedPhases[sortedPhases.length - 1];
+    const isTestsPhase = lastPhase && /test/i.test(lastPhase.name) ? lastPhase.number : null;
+    // If the Tests phase shares a wave with other phases, move it to its own final wave.
+    if (isTestsPhase !== null) {
+        const testWave = waveOf.get(isTestsPhase);
+        const phasesInSameWave = Array.from(waveOf.entries()).filter(([num, w]) => w === testWave && num !== isTestsPhase);
+        if (phasesInSameWave.length > 0) {
+            // Move Tests to max_wave + 1
+            const maxWave = Math.max(...Array.from(waveOf.values()));
+            waveOf.set(isTestsPhase, maxWave + 1);
+        }
+    }
+    // Group phases by wave number.
+    const waveMap = new Map();
+    for (const [phaseNum, wave] of Array.from(waveOf.entries())) {
+        if (!waveMap.has(wave))
+            waveMap.set(wave, []);
+        waveMap.get(wave).push(phaseNum);
+    }
+    // Build sorted WaveGroup array.
+    const waveNumbers = Array.from(waveMap.keys()).sort((a, b) => a - b);
+    return waveNumbers.map((wn) => ({
+        wave_number: wn,
+        phase_numbers: waveMap.get(wn).sort((a, b) => a - b),
+    }));
+}
+//# sourceMappingURL=wave-calculator.js.map

package/dist/cli/state/wave-calculator.js.map

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

package/dist/cli/types.d.ts

@@ -45,4 +45,19 @@ export interface HeartbeatTask {
 export interface HeartbeatOptions {
     target: string;
 }
+export type NotificationLevel = 'info' | 'warn' | 'error';
+export type NotificationType = 'task_started' | 'phase_complete' | 'task_complete' | 'task_failed' | 'task_blocked';
+export interface NotificationEvent {
+    id: string;
+    timestamp: Date;
+    task: string;
+    type: NotificationType;
+    level: NotificationLevel;
+    phase?: string;
+    message: string;
+}
+export interface HeartbeatState {
+    lastReadTimestamp: string;
+    lastSessionId?: string;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planflow-ai",
-  "version": "1.3.5",
+  "version": "1.4.3",
   "description": "Structured AI-assisted development workflows for discovery, planning, execution, code reviews, and testing",
   "type": "module",
   "main": "dist/cli/index.js",
@@ -57,11 +57,16 @@
   "author": "Bruno Cardoso",
   "license": "MIT",
   "dependencies": {
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "node-notifier": "^10.0.1"
+  },
+  "optionalDependencies": {
+    "planflow-brain": "file:../brain"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",
     "@types/node": "^22.10.5",
+    "@types/node-notifier": "^8.0.5",
     "jest": "^29.7.0",
     "prettier": "^3.4.2",
     "ts-jest": "^29.2.5",

package/templates/shared/CLAUDE.md.template

@@ -90,6 +90,10 @@ During skill execution, the LLM silently buffers patterns and anti-patterns, pre
 
 When `phase_isolation: true` in `flow/.flowconfig` (default), each `/execute-plan` phase runs in an isolated Agent sub-agent with a clean context window. Sub-agent receives focused context (phase spec, file list, patterns) and returns structured JSON summary. Eliminates context rot. Disable with `/flow phase_isolation=false`. See `.claude/resources/core/phase-isolation.md`.
 
+## Per-Task Verification
+
+Tasks in plan phases can include optional `<verify>` sections with targeted verification commands. After each task, verification runs immediately. Failed verifications trigger a debug sub-agent (haiku) for diagnosis, followed by an auto-repair loop (up to `max_verify_retries`, default: 2, configurable in `flow/.flowconfig`). `/create-plan` auto-generates `<verify>` sections based on task type heuristics. Backward compatible — tasks without `<verify>` skip verification. See `.claude/resources/core/per-task-verification.md`.
+
 ## Discovery Sub-Agents
 
 During `/discovery-plan`, three parallel haiku sub-agents explore the codebase (similar features, API/data patterns, schema/types). Returns condensed JSON findings merged into a Codebase Analysis section. Always-on. See `.claude/resources/core/discovery-sub-agents.md`.