agent-step-gate 0.3.0

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,cAAc;AACd,+EAA+E;AAI/E,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IACjC,kEAAiD,CAAA;IACjD,sCAAqB,CAAA;IACrB,8DAA6C,CAAA;IAC7C,sDAAqC,CAAA;IACrC,wDAAuC,CAAA;IACvC,4DAA2C,CAAA;IAC3C,kDAAiC,CAAA;AACnC,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAED,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,IAAI,CAAgB;IACpB,WAAW,CAAmB;IAE9B,YAAY,IAAmB,EAAE,OAAe,EAAE,WAA6B;QAC7E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}

package/dist/core/gate.d.ts

@@ -0,0 +1,20 @@
+import type { TaskRow, StepRow, CurrentStepInfo } from '../types/index.js';
+export interface GateRepository {
+    getTask(taskId: string): TaskRow | undefined;
+    getCurrentSteps(taskId: string): StepRow[];
+    getTaskSteps(taskId: string): StepRow[];
+    getStep(stepId: string): StepRow | undefined;
+    completeAndAdvance(completedStepId: string, nextStepIds: string[], nextKeyHashes: string[], taskId: string, taskKeyHash: string | null): void;
+    updateTaskStatus(taskId: string, status: string): void;
+    verifyTaskKey(taskId: string, keyPlaintext: string): boolean;
+}
+export declare function validateCheckpoint(repo: GateRepository, taskId: string, stepId: string, stepKey: string): {
+    task: TaskRow;
+    currentStep: StepRow;
+};
+export declare function advanceSteps(repo: GateRepository, task: TaskRow, completedStepId: string): {
+    nextSteps?: CurrentStepInfo[];
+    nextStepKeys?: Record<string, string>;
+    allStepsCompleted?: boolean;
+    taskKey?: string;
+};

package/dist/core/gate.js

@@ -0,0 +1,82 @@
+import { GateError, GateErrorCode } from './errors.js';
+import { generateStepKey, generateTaskKey, hashKey } from './keys.js';
+export function validateCheckpoint(repo, taskId, stepId, stepKey) {
+    const task = repo.getTask(taskId);
+    if (!task) {
+        throw new GateError(GateErrorCode.TASK_NOT_FOUND, `Task not found: ${taskId}`);
+    }
+    if (task.status !== 'active') {
+        throw new GateError(GateErrorCode.TASK_ALREADY_COMPLETED, `Task already completed: ${taskId}`);
+    }
+    const currentSteps = repo.getCurrentSteps(taskId);
+    if (currentSteps.length === 0) {
+        throw new GateError(GateErrorCode.INTERNAL_ERROR, 'No current step found');
+    }
+    const currentStep = currentSteps.find(s => s.id === stepId);
+    if (!currentStep) {
+        throw new GateError(GateErrorCode.INVALID_CURRENT_STEP, `Step ${stepId} is not a current step. Current steps: [${currentSteps.map(s => s.id).join(', ')}]`, {
+            stepId: currentSteps[0].id,
+            path: currentSteps[0].path,
+            index: currentSteps[0].orderIndex,
+            total: task.totalSteps,
+        });
+    }
+    const keyHash = hashKey(stepKey);
+    if (keyHash !== currentStep.stepKeyHash) {
+        throw new GateError(GateErrorCode.INVALID_STEP_KEY, `Invalid step key for step ${stepId}`, {
+            stepId: currentStep.id,
+            path: currentStep.path,
+            index: currentStep.orderIndex,
+            total: task.totalSteps,
+        });
+    }
+    return { task, currentStep };
+}
+export function advanceSteps(repo, task, completedStepId) {
+    const allSteps = repo.getTaskSteps(task.id);
+    // 1. Find all pending steps whose dependencies are all satisfied.
+    //    Treat completedStepId as already completed since it's about to be in the transaction.
+    const unlockedSteps = allSteps.filter(s => {
+        if (s.status !== 'pending')
+            return false;
+        return s.dependsOn.every(depId => {
+            const dep = allSteps.find(x => x.id === depId);
+            if (!dep)
+                return false;
+            return dep.status === 'completed' || dep.status === 'skipped' || dep.id === completedStepId;
+        });
+    });
+    if (unlockedSteps.length > 0) {
+        // Generate keys for newly activated steps
+        const nextStepKeys = {};
+        const nextKeyHashes = [];
+        for (const step of unlockedSteps) {
+            const { plaintext, hash } = generateStepKey();
+            nextStepKeys[step.id] = plaintext;
+            nextKeyHashes.push(hash);
+        }
+        repo.completeAndAdvance(completedStepId, unlockedSteps.map(s => s.id), nextKeyHashes, task.id, null);
+        return {
+            nextSteps: unlockedSteps.map(s => ({
+                stepId: s.id,
+                path: s.path,
+                index: s.orderIndex,
+                total: task.totalSteps,
+            })),
+            nextStepKeys,
+        };
+    }
+    // 2. No pending steps unlocked → check if everything is completed
+    const allCompleted = allSteps.every(s => s.status === 'completed' || s.status === 'skipped' || s.id === completedStepId);
+    if (allCompleted) {
+        const { plaintext, hash } = generateTaskKey();
+        repo.completeAndAdvance(completedStepId, [], [], task.id, hash);
+        return { allStepsCompleted: true, taskKey: plaintext };
+    }
+    // 3. There are pending steps but their dependencies aren't satisfied yet.
+    //    This happens when completing a parallel branch — other branches are still running.
+    //    Just complete this step without activating anything new.
+    repo.completeAndAdvance(completedStepId, [], [], task.id, null);
+    return {};
+}
+//# sourceMappingURL=gate.js.map

package/dist/core/gate.js.map

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

package/dist/core/keys.d.ts

@@ -0,0 +1,18 @@
+export declare function randomCode(length: number): string;
+export declare function generateStepKey(): {
+    plaintext: string;
+    hash: string;
+};
+/** Task-level key — proves all steps in a task were checkpointed */
+export declare function generateTaskKey(): {
+    plaintext: string;
+    hash: string;
+};
+/** @deprecated use generateTaskKey */
+export declare const generateFinalKey: typeof generateTaskKey;
+/** Node-level key — system-generated receipt when all tasks in a node are done */
+export declare function generateNodeKey(): {
+    plaintext: string;
+    hash: string;
+};
+export declare function hashKey(plaintext: string): string;

package/dist/core/keys.js

@@ -0,0 +1,37 @@
+import crypto from 'node:crypto';
+const CHARSET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+export function randomCode(length) {
+    const bytes = crypto.randomBytes(length * 2); // oversample to avoid modulo bias
+    let result = '';
+    let byteIdx = 0;
+    for (let i = 0; i < length; i++) {
+        // rejection sampling: skip bytes >= 252 (the largest multiple of 36 under 256)
+        let val;
+        do {
+            val = bytes[byteIdx++];
+        } while (val >= 252 && byteIdx < bytes.length);
+        result += CHARSET[val % CHARSET.length];
+    }
+    return result;
+}
+export function generateStepKey() {
+    const plaintext = randomCode(6);
+    const hash = hashKey(plaintext);
+    return { plaintext, hash };
+}
+/** Task-level key — proves all steps in a task were checkpointed */
+export function generateTaskKey() {
+    const plaintext = randomCode(6);
+    return { plaintext, hash: hashKey(plaintext) };
+}
+/** @deprecated use generateTaskKey */
+export const generateFinalKey = generateTaskKey;
+/** Node-level key — system-generated receipt when all tasks in a node are done */
+export function generateNodeKey() {
+    const plaintext = randomCode(6);
+    return { plaintext, hash: hashKey(plaintext) };
+}
+export function hashKey(plaintext) {
+    return crypto.createHash('sha256').update(plaintext).digest('hex');
+}
+//# sourceMappingURL=keys.js.map

package/dist/core/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/core/keys.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,OAAO,GAAG,sCAAsC,CAAC;AAEvD,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kCAAkC;IAChF,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,+EAA+E;QAC/E,IAAI,GAAW,CAAC;QAChB,GAAG,CAAC;YACF,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzB,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE;QAC/C,MAAM,IAAI,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEhD,kFAAkF;AAClF,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,SAAiB;IACvC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC"}

package/dist/core/plan.d.ts

@@ -0,0 +1,2 @@
+import type { PlanNode, LeafStep } from '../types/index.js';
+export declare function flattenPlan(nodes: PlanNode[], taskId: string, parentPath?: string): LeafStep[];

package/dist/core/plan.js

@@ -0,0 +1,135 @@
+import { GateError, GateErrorCode } from './errors.js';
+export function flattenPlan(nodes, taskId, parentPath) {
+    if (!nodes || nodes.length === 0) {
+        throw new GateError(GateErrorCode.PLAN_SCHEMA_INVALID, 'Plan must have at least one step');
+    }
+    const now = new Date().toISOString();
+    const leaves = [];
+    let idCounter = 0;
+    // Maps original node ID → leaf step IDs (container IDs map to all descendants)
+    const nodeToLeafStepIds = new Map();
+    function dfs(nodeList, pathPrefix, inheritedDependsOn) {
+        for (const node of nodeList) {
+            if (!node.title) {
+                throw new GateError(GateErrorCode.PLAN_SCHEMA_INVALID, 'Each step must have a title');
+            }
+            const nodePath = pathPrefix ? `${pathPrefix} / ${node.title}` : node.title;
+            // Merge this node's deps into the inheritance chain for children (F3b)
+            const mergedInherited = [...inheritedDependsOn, ...(node.dependsOn || [])];
+            const childInherited = [...new Set(mergedInherited)];
+            if (!node.children || node.children.length === 0) {
+                idCounter++;
+                const stepId = node.id ? `${taskId}_${node.id}` : `${taskId}_step_${idCounter}`;
+                if (node.id) {
+                    nodeToLeafStepIds.set(node.id, [stepId]);
+                }
+                leaves.push({
+                    stepId,
+                    nodeId: node.id,
+                    title: node.title,
+                    path: nodePath,
+                    ownDependsOn: node.dependsOn,
+                    inheritedDependsOn,
+                });
+            }
+            else {
+                const beforeCount = leaves.length;
+                dfs(node.children, nodePath, childInherited);
+                if (node.id) {
+                    const descendantIds = leaves.slice(beforeCount).map(l => l.stepId);
+                    nodeToLeafStepIds.set(node.id, descendantIds);
+                }
+            }
+        }
+    }
+    dfs(nodes, parentPath ?? '', []);
+    if (leaves.length === 0) {
+        throw new GateError(GateErrorCode.PLAN_SCHEMA_INVALID, 'Plan must have at least one step');
+    }
+    // ---- Phase 2: Resolve node IDs → leaf step IDs ----
+    // Container references expand to all descendant leaf IDs.
+    const resolvedDeps = leaves.map(() => []);
+    for (let i = 0; i < leaves.length; i++) {
+        const leaf = leaves[i];
+        const effectiveDependsOn = [
+            ...leaf.inheritedDependsOn,
+            ...(leaf.ownDependsOn || []),
+        ];
+        const uniqueDeps = [...new Set(effectiveDependsOn)];
+        const resolved = [];
+        for (const depId of uniqueDeps) {
+            const targetIds = nodeToLeafStepIds.get(depId);
+            if (targetIds && targetIds.length > 0) {
+                for (const sid of targetIds)
+                    resolved.push(sid);
+            }
+        }
+        resolvedDeps[i] = [...new Set(resolved)];
+    }
+    // ---- Phase 3 (F1): Cycle detection via DFS three-color ----
+    const leafIdToIndex = new Map();
+    for (let i = 0; i < leaves.length; i++) {
+        leafIdToIndex.set(leaves[i].stepId, i);
+    }
+    let Color;
+    (function (Color) {
+        Color[Color["WHITE"] = 0] = "WHITE";
+        Color[Color["GRAY"] = 1] = "GRAY";
+        Color[Color["BLACK"] = 2] = "BLACK";
+    })(Color || (Color = {}));
+    const colors = leaves.map(() => Color.WHITE);
+    function detectCycle(idx, path) {
+        if (colors[idx] === Color.GRAY) {
+            const cycleStart = path.indexOf(leaves[idx].stepId);
+            const cyclePath = [...path.slice(cycleStart), leaves[idx].stepId].join(' → ');
+            throw new GateError(GateErrorCode.PLAN_SCHEMA_INVALID, `Circular dependency detected: ${cyclePath}`);
+        }
+        if (colors[idx] === Color.BLACK)
+            return;
+        colors[idx] = Color.GRAY;
+        path.push(leaves[idx].stepId);
+        for (const depId of resolvedDeps[idx]) {
+            const depIdx = leafIdToIndex.get(depId);
+            if (depIdx !== undefined) {
+                detectCycle(depIdx, path);
+            }
+        }
+        path.pop();
+        colors[idx] = Color.BLACK;
+    }
+    for (let i = 0; i < leaves.length; i++) {
+        if (colors[i] === Color.WHITE) {
+            detectCycle(i, []);
+        }
+    }
+    // ---- Phase 4: Build result with auto-serial fallback ----
+    const result = [];
+    for (let i = 0; i < leaves.length; i++) {
+        const leaf = leaves[i];
+        let finalDependsOn;
+        const hasExplicitDeps = leaf.ownDependsOn !== undefined || leaf.inheritedDependsOn.length > 0;
+        if (hasExplicitDeps) {
+            finalDependsOn = resolvedDeps[i];
+        }
+        else if (i === 0) {
+            finalDependsOn = [];
+        }
+        else {
+            finalDependsOn = [leaves[i - 1].stepId];
+        }
+        result.push({
+            id: leaf.stepId,
+            taskId,
+            parentPath: parentPath ?? null,
+            title: leaf.title,
+            path: leaf.path,
+            orderIndex: i + 1,
+            dependsOn: finalDependsOn,
+            status: 'pending',
+            completedAt: null,
+            createdAt: now,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=plan.js.map

package/dist/core/plan.js.map

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

package/dist/core/program.d.ts

@@ -0,0 +1,69 @@
+export interface ProgramInfo {
+    programId: string;
+    title: string;
+    totalNodes: number;
+    nodes: ProgramNodeInfo[];
+}
+export interface ProgramNodeInfo {
+    nodeId: string;
+    title: string;
+    description?: string;
+    orderIndex: number;
+    status: string;
+    sessionId?: string;
+}
+/** Create a new program from a plan (JSON array of nodes with optional dependsOn). */
+export declare function createProgram(title: string, nodes: {
+    id?: string;
+    title: string;
+    description?: string;
+    dependsOn?: string[];
+}[]): ProgramInfo;
+/** Get program status with all nodes. */
+export declare function getProgramStatus(programId: string): ProgramInfo | null;
+/** Find ready nodes (all deps satisfied, not yet started). */
+export declare function getReadyNodes(programId: string): ProgramNodeInfo[];
+/** Start a program node — creates a new session bound to it. */
+export declare function startProgramNode(programId: string, nodeId: string, sessionId: string): boolean;
+/** Commit parent: mark the program node as completed, auto-generating a nodeKey receipt. */
+export declare function commitProgramNode(sessionId: string): {
+    programId: string;
+    nodeId: string;
+    nodeKey?: string;
+    allDone: boolean;
+} | null;
+/** Rebuild manifest: what's done and what will be lost if we rebuild this program/node. */
+export interface RebuildManifest {
+    scope: {
+        programId: string;
+        nodeId?: string;
+    };
+    programTitle: string;
+    completedSteps: Array<{
+        oldTaskId: string;
+        taskTitle: string;
+        stepId: string;
+        stepPath: string;
+        status: string;
+        nodeId?: string;
+    }>;
+    pendingSteps: Array<{
+        taskId: string;
+        taskTitle: string;
+        stepId: string;
+        stepPath: string;
+    }>;
+    activeTaskCount: number;
+    completedTaskCount: number;
+}
+export declare function getRebuildManifest(programId: string, nodeId?: string): RebuildManifest | null;
+/** Execute rebuild: cancel active tasks, reset node(s) to pending. */
+export declare function executeRebuild(programId: string, nodeId?: string): {
+    cancelled: number;
+    resetNodes: string[];
+};
+/** Finalize program: check all nodes complete. */
+export declare function finalizeProgram(programId: string): {
+    ok: boolean;
+    pending: ProgramNodeInfo[];
+};

package/dist/core/program.js

@@ -0,0 +1,191 @@
+import crypto from 'node:crypto';
+import db from '../storage/db.js';
+import { randomCode, generateNodeKey } from './keys.js';
+function now() { return new Date().toISOString(); }
+function sha256(s) { return crypto.createHash('sha256').update(s).digest('hex'); }
+/** Create a new program from a plan (JSON array of nodes with optional dependsOn). */
+export function createProgram(title, nodes) {
+    const programId = `pgm_${randomCode(6)}`;
+    const ts = now();
+    db.prepare('INSERT INTO programs (program_id, title, status, total_nodes, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)')
+        .run(programId, title, 'active', nodes.length, ts, ts);
+    const programNodes = nodes.map((n, i) => {
+        const nodeId = n.id ?? `pg_${programId}_${i + 1}`;
+        db.prepare('INSERT INTO program_nodes (node_id, program_id, title, description, order_index, status, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)')
+            .run(nodeId, programId, n.title, n.description ?? null, i + 1, 'pending', ts);
+        return { nodeId, title: n.title, description: n.description, orderIndex: i + 1, status: 'pending' };
+    });
+    return { programId, title, totalNodes: nodes.length, nodes: programNodes };
+}
+/** Get program status with all nodes. */
+export function getProgramStatus(programId) {
+    const p = db.prepare('SELECT * FROM programs WHERE program_id = ?').get(programId);
+    if (!p)
+        return null;
+    const nodes = db.prepare('SELECT * FROM program_nodes WHERE program_id = ? ORDER BY order_index').all(programId);
+    return {
+        programId: p.program_id,
+        title: p.title,
+        totalNodes: p.total_nodes,
+        nodes: nodes.map((n) => ({
+            nodeId: n.node_id, title: n.title, description: n.description,
+            orderIndex: n.order_index, status: n.status, sessionId: n.session_id,
+        })),
+    };
+}
+/** Find ready nodes (all deps satisfied, not yet started). */
+export function getReadyNodes(programId) {
+    const nodes = db.prepare("SELECT * FROM program_nodes WHERE program_id = ? AND status = 'pending' ORDER BY order_index").all(programId);
+    // For now, no DAG at program level — just return ordered pending nodes.
+    // Future: filter by depends_on satisfaction.
+    return nodes.map((n) => ({
+        nodeId: n.node_id, title: n.title, description: n.description,
+        orderIndex: n.order_index, status: n.status, sessionId: n.session_id,
+    }));
+}
+/** Start a program node — creates a new session bound to it. */
+export function startProgramNode(programId, nodeId, sessionId) {
+    const node = db.prepare('SELECT * FROM program_nodes WHERE node_id = ? AND program_id = ?').get(nodeId, programId);
+    if (!node || node.status !== 'pending')
+        return false;
+    db.prepare("UPDATE program_nodes SET status = 'in_progress', session_id = ? WHERE node_id = ?")
+        .run(sessionId, nodeId);
+    db.prepare('UPDATE sessions SET program_id = ?, program_node_id = ? WHERE session_id = ?')
+        .run(programId, nodeId, sessionId);
+    return true;
+}
+/** Commit parent: mark the program node as completed, auto-generating a nodeKey receipt. */
+export function commitProgramNode(sessionId) {
+    const session = db.prepare('SELECT program_id, program_node_id FROM sessions WHERE session_id = ?').get(sessionId);
+    if (!session?.program_node_id)
+        return null;
+    // Generate nodeKey as a completion receipt
+    const { plaintext: nodeKey, hash: nodeKeyHash } = generateNodeKey();
+    db.prepare("UPDATE program_nodes SET status = 'completed', completed_at = ?, node_key_hash = ? WHERE node_id = ?")
+        .run(now(), nodeKeyHash, session.program_node_id);
+    // Check if all nodes are completed
+    const pending = db.prepare("SELECT COUNT(*) as cnt FROM program_nodes WHERE program_id = ? AND status != 'completed'")
+        .get(session.program_id);
+    if (pending.cnt === 0) {
+        db.prepare("UPDATE programs SET status = 'completed', updated_at = ? WHERE program_id = ?")
+            .run(now(), session.program_id);
+        return { programId: session.program_id, nodeId: session.program_node_id, nodeKey, allDone: true };
+    }
+    return { programId: session.program_id, nodeId: session.program_node_id, nodeKey, allDone: false };
+}
+export function getRebuildManifest(programId, nodeId) {
+    const prog = db.prepare('SELECT * FROM programs WHERE program_id = ?').get(programId);
+    if (!prog)
+        return null;
+    // Find sessions under this program (optionally filtered by node)
+    let sessions;
+    if (nodeId) {
+        sessions = db.prepare("SELECT * FROM sessions WHERE program_id = ? AND program_node_id = ?").all(programId, nodeId);
+    }
+    else {
+        sessions = db.prepare("SELECT * FROM sessions WHERE program_id = ?").all(programId);
+    }
+    const sessionIds = sessions.map((s) => s.session_id);
+    if (sessionIds.length === 0) {
+        return {
+            scope: { programId, nodeId },
+            programTitle: prog.title,
+            completedSteps: [],
+            pendingSteps: [],
+            activeTaskCount: 0,
+            completedTaskCount: 0,
+        };
+    }
+    // Find all tasks from these sessions
+    const placeholders = sessionIds.map(() => '?').join(',');
+    const tasks = db.prepare(`SELECT * FROM tasks WHERE session_id IN (${placeholders})`).all(...sessionIds);
+    const completedSteps = [];
+    const pendingSteps = [];
+    let activeCount = 0;
+    let completedCount = 0;
+    for (const task of tasks) {
+        if (task.status === 'completed')
+            completedCount++;
+        if (task.status === 'active' || task.status === 'cancelled')
+            activeCount++;
+        const steps = db.prepare('SELECT * FROM steps WHERE task_id = ? ORDER BY order_index').all(task.id);
+        const node = sessions.find((s) => s.session_id === task.session_id);
+        for (const step of steps) {
+            if (step.status === 'completed') {
+                completedSteps.push({
+                    oldTaskId: task.id,
+                    taskTitle: task.title,
+                    stepId: step.id,
+                    stepPath: step.path,
+                    status: 'completed',
+                    nodeId: node?.program_node_id,
+                });
+            }
+            else if (step.status === 'current' || step.status === 'pending') {
+                pendingSteps.push({
+                    taskId: task.id,
+                    taskTitle: task.title,
+                    stepId: step.id,
+                    stepPath: step.path,
+                });
+            }
+        }
+    }
+    return {
+        scope: { programId, nodeId },
+        programTitle: prog.title,
+        completedSteps,
+        pendingSteps,
+        activeTaskCount: activeCount,
+        completedTaskCount: completedCount,
+    };
+}
+/** Execute rebuild: cancel active tasks, reset node(s) to pending. */
+export function executeRebuild(programId, nodeId) {
+    let sessions;
+    if (nodeId) {
+        sessions = db.prepare("SELECT * FROM sessions WHERE program_id = ? AND program_node_id = ?").all(programId, nodeId);
+    }
+    else {
+        sessions = db.prepare("SELECT * FROM sessions WHERE program_id = ?").all(programId);
+    }
+    const sessionIds = sessions.map((s) => s.session_id);
+    if (sessionIds.length === 0)
+        return { cancelled: 0, resetNodes: [] };
+    const placeholders = sessionIds.map(() => '?').join(',');
+    // Cancel all active tasks under these sessions
+    const result = db.prepare(`UPDATE tasks SET status = 'cancelled', updated_at = ? WHERE session_id IN (${placeholders}) AND status = 'active'`).run(now(), ...sessionIds);
+    // Reset affected nodes to pending
+    const resetNodes = [];
+    if (nodeId) {
+        db.prepare("UPDATE program_nodes SET status = 'pending', session_id = NULL, completed_at = NULL, node_key_hash = NULL WHERE node_id = ?")
+            .run(nodeId);
+        resetNodes.push(nodeId);
+    }
+    else {
+        const nodes = db.prepare("SELECT node_id FROM program_nodes WHERE program_id = ? AND status != 'pending'").all(programId);
+        for (const n of nodes) {
+            db.prepare("UPDATE program_nodes SET status = 'pending', session_id = NULL, completed_at = NULL, node_key_hash = NULL WHERE node_id = ?")
+                .run(n.node_id);
+            resetNodes.push(n.node_id);
+        }
+        db.prepare("UPDATE programs SET status = 'active', updated_at = ? WHERE program_id = ?").run(now(), programId);
+    }
+    return { cancelled: result.changes, resetNodes };
+}
+/** Finalize program: check all nodes complete. */
+export function finalizeProgram(programId) {
+    const nodes = db.prepare("SELECT * FROM program_nodes WHERE program_id = ? AND status != 'completed'").all(programId);
+    if (nodes.length > 0) {
+        return {
+            ok: false,
+            pending: nodes.map((n) => ({
+                nodeId: n.node_id, title: n.title, description: n.description,
+                orderIndex: n.order_index, status: n.status, sessionId: n.session_id,
+            })),
+        };
+    }
+    db.prepare("UPDATE programs SET status = 'completed', updated_at = ? WHERE program_id = ?").run(now(), programId);
+    return { ok: true, pending: [] };
+}
+//# sourceMappingURL=program.js.map

package/dist/core/program.js.map

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

package/dist/core/reconcile.d.ts

@@ -0,0 +1,37 @@
+export interface ReconcileReport {
+    timestamp: string;
+    scope: {
+        programId?: string;
+    };
+    summary: {
+        totalPrograms: number;
+        totalNodes: number;
+        totalTasks: number;
+        totalSteps: number;
+        healthy: number;
+        stale: number;
+        orphan: number;
+        drift: number;
+    };
+    orphans: Array<{
+        type: 'step_orphan' | 'step_stale';
+        stepId: string;
+        taskId: string;
+        path: string;
+        detail: string;
+    }>;
+    staleTasks: Array<{
+        taskId: string;
+        title: string;
+        status: string;
+        sessionId: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    drifts: Array<{
+        type: 'task_done_node_pending' | 'task_active_node_done';
+        detail: string;
+    }>;
+    suggestions: string[];
+}
+export declare function reconcile(programId?: string): ReconcileReport;