planflow-ai 1.3.4 → 1.4.1

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"}

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":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,SAAS,QAAQ,CACf,YAAsB,EACtB,SAAgC;IAEhC,MAAM,KAAK,GAAG,CAAC,CAAC;IAChB,MAAM,IAAI,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,CAAC,CAAC;IAChB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,YAAY;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAElD,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK;YAAE,SAAS;QAEzC,MAAM,KAAK,GAAyC;YAClD,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;SACxB,CAAC;QACF,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEvB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAEhD,IAAI,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACpC,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC9B,IAAI,CAAC,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC,CAAC,oBAAoB;gBACjD,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;oBAChB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC3B,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,yEAAyE;IACzE,8EAA8E;IAC9E,wEAAwE;IACxE,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEjD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACtD,YAAY,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;QACzC,4CAA4C;QAC5C,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,WAAW,EAAE,CAAC,GAAG,CAAC;YAClB,aAAa,EAAE,CAAC,CAAC,CAAC;SACnB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,mCAAmC;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAEvC,kEAAkE;IAClE,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBAAE,SAAS;YAEnC,wEAAwE;YACxE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAEzE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACxB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;gBAChE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;gBACrC,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,YAAY,GAChB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAEtE,qFAAqF;IACrF,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC;QAC3C,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAC1D,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,KAAK,YAAY,CACrD,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,6BAA6B;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5C,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,gCAAgC;IAChC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;KACtD,CAAC,CAAC,CAAC;AACN,CAAC"}

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.4",
+  "version": "1.4.1",
   "description": "Structured AI-assisted development workflows for discovery, planning, execution, code reviews, and testing",
   "type": "module",
   "main": "dist/cli/index.js",
@@ -57,11 +57,13 @@
   "author": "Bruno Cardoso",
   "license": "MIT",
   "dependencies": {
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "node-notifier": "^10.0.1"
   },
   "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`.