agent-step-gate 0.3.0

package/dist/core/reconcile.js

@@ -0,0 +1,198 @@
+import db from '../storage/db.js';
+function now() { return new Date().toISOString(); }
+export function reconcile(programId) {
+    const report = {
+        timestamp: now(),
+        scope: { programId },
+        summary: { totalPrograms: 0, totalNodes: 0, totalTasks: 0, totalSteps: 0, healthy: 0, stale: 0, orphan: 0, drift: 0 },
+        orphans: [],
+        staleTasks: [],
+        drifts: [],
+        suggestions: [],
+    };
+    // ---- 1. Count totals ----
+    const progFilter = programId ? 'WHERE program_id = ?' : '';
+    const progParams = programId ? [programId] : [];
+    report.summary.totalPrograms = db.prepare(`SELECT COUNT(*) as c FROM programs ${progFilter}`).get(...progParams).c;
+    report.summary.totalNodes = db.prepare(`SELECT COUNT(*) as c FROM program_nodes ${progFilter}`).get(...progParams).c;
+    // For tasks/steps, scope by program's sessions if programId given
+    let taskFilter = '';
+    let taskParams = [];
+    if (programId) {
+        const sessions = db.prepare('SELECT session_id FROM sessions WHERE program_id = ?').all(programId);
+        const sids = sessions.map((s) => s.session_id);
+        if (sids.length > 0) {
+            const ph = sids.map(() => '?').join(',');
+            taskFilter = `WHERE session_id IN (${ph})`;
+            taskParams = sids;
+        }
+        else {
+            taskFilter = "WHERE 1=0";
+        }
+    }
+    report.summary.totalTasks = db.prepare(`SELECT COUNT(*) as c FROM tasks ${taskFilter}`).get(...taskParams).c;
+    if (report.summary.totalTasks > 0) {
+        const steps = db.prepare(`SELECT COUNT(*) as c FROM steps WHERE task_id IN (SELECT id FROM tasks ${taskFilter})`).get(...taskParams);
+        report.summary.totalSteps = steps.c;
+    }
+    // ---- 2. Find orphan/stale steps ----
+    // Step whose task is cancelled or doesn't exist
+    const orphanSteps = db.prepare(`
+    SELECT s.id, s.task_id, s.path, s.status, s.completed_at
+    FROM steps s
+    LEFT JOIN tasks t ON s.task_id = t.id
+    WHERE t.id IS NULL OR t.status = 'cancelled'
+  `).all();
+    for (const s of orphanSteps) {
+        report.orphans.push({
+            type: 'step_orphan',
+            stepId: s.id,
+            taskId: s.task_id,
+            path: s.path,
+            detail: s.status === 'completed'
+                ? `Step completed but task is gone/cancelled. Can serve as skipKey source.`
+                : `Step is ${s.status} but its task no longer exists.`,
+        });
+        report.summary.orphan++;
+    }
+    // Steps with status 'current' but updated > 30 min ago (stale)
+    const staleThreshold = new Date(Date.now() - 30 * 60 * 1000).toISOString();
+    const staleSteps = db.prepare(`
+    SELECT s.id, s.task_id, s.path, t.updated_at
+    FROM steps s
+    JOIN tasks t ON s.task_id = t.id
+    WHERE s.status = 'current' AND t.updated_at < ?
+    ORDER BY t.updated_at ASC
+  `).all(staleThreshold);
+    for (const s of staleSteps) {
+        report.orphans.push({
+            type: 'step_stale',
+            stepId: s.id,
+            taskId: s.task_id,
+            path: s.path,
+            detail: `Step stuck in 'current' since ${s.updated_at}.`,
+        });
+    }
+    // ---- 3. Find stale active tasks ----
+    const staleTasks = db.prepare(`
+    SELECT id, title, status, session_id, created_at, updated_at
+    FROM tasks
+    WHERE status = 'active' AND updated_at < ?
+    ORDER BY updated_at ASC
+  `).all(staleThreshold);
+    for (const t of staleTasks) {
+        report.staleTasks.push({
+            taskId: t.id,
+            title: t.title,
+            status: t.status,
+            sessionId: t.session_id,
+            createdAt: t.created_at,
+            updatedAt: t.updated_at,
+        });
+        report.summary.stale++;
+    }
+    // ---- 4. Completed steps in incomplete tasks ----
+    const danglingCompletes = db.prepare(`
+    SELECT s.id, s.task_id, s.path, t.status as task_status
+    FROM steps s
+    JOIN tasks t ON s.task_id = t.id
+    WHERE s.status = 'completed' AND t.status = 'active'
+  `).all();
+    if (danglingCompletes.length > 0) {
+        report.suggestions.push(`${danglingCompletes.length} completed step(s) exist in active tasks. Consider finalizing.`);
+    }
+    // ---- 5. Task completed but Node not refreshed ----
+    const nodeDrifts = db.prepare(`
+    SELECT pn.node_id, pn.program_id, pn.title, pn.status as node_status
+    FROM program_nodes pn
+    WHERE pn.status = 'in_progress'
+  `).all();
+    for (const nd of nodeDrifts) {
+        // Check if all tasks under this node are completed
+        const sessions = db.prepare('SELECT session_id FROM sessions WHERE program_node_id = ?').all(nd.node_id);
+        if (sessions.length === 0)
+            continue;
+        const sids = sessions.map((s) => s.session_id);
+        const ph = sids.map(() => '?').join(',');
+        const allDone = db.prepare(`
+      SELECT COUNT(*) as c FROM tasks
+      WHERE session_id IN (${ph}) AND status != 'completed'
+    `).get(...sids);
+        const anyActive = db.prepare(`
+      SELECT COUNT(*) as c FROM tasks
+      WHERE session_id IN (${ph}) AND status = 'active'
+    `).get(...sids);
+        if (allDone.c === 0) {
+            // All tasks done but node still in_progress — drift!
+            report.drifts.push({
+                type: 'task_done_node_pending',
+                detail: `Node "${nd.title}" (${nd.node_id}): all tasks completed but node status is still '${nd.node_status}'. Run finalize on the last task to trigger auto-propagation.`,
+            });
+            report.summary.drift++;
+        }
+        if (anyActive.c === 0 && allDone.c === 0) {
+            // No active, all completed, node not refreshed
+            report.drifts.push({
+                type: 'task_done_node_pending',
+                detail: `Node "${nd.title}" (${nd.node_id}): all tasks done, node not refreshed.`,
+            });
+            if (report.summary.drift === 0)
+                report.summary.drift++;
+        }
+    }
+    // Also: task active but node already completed
+    const revDrifts = db.prepare(`
+    SELECT t.id as task_id, t.title as task_title, pn.node_id, pn.title as node_title
+    FROM tasks t
+    JOIN sessions s ON t.session_id = s.session_id
+    JOIN program_nodes pn ON s.program_node_id = pn.node_id
+    WHERE t.status = 'active' AND pn.status = 'completed'
+  `).all();
+    for (const rd of revDrifts) {
+        report.drifts.push({
+            type: 'task_active_node_done',
+            detail: `Task "${rd.task_title}" (${rd.task_id}) is active but its Node "${rd.node_title}" is already completed.`,
+        });
+        report.summary.drift++;
+    }
+    // ---- 6. Recalculate node/program status ----
+    const allNodes = programId
+        ? db.prepare('SELECT * FROM program_nodes WHERE program_id = ?').all(programId)
+        : db.prepare('SELECT * FROM program_nodes').all();
+    // Detect drift: node that's in_progress but all tasks done — report only, do not mutate
+    for (const node of allNodes) {
+        if (node.status !== 'in_progress')
+            continue;
+        const sessions = db.prepare('SELECT session_id FROM sessions WHERE program_node_id = ?').all(node.node_id);
+        if (sessions.length === 0)
+            continue;
+        const sids = sessions.map((s) => s.session_id);
+        const ph = sids.map(() => '?').join(',');
+        const pending = db.prepare(`SELECT COUNT(*) as c FROM tasks WHERE session_id IN (${ph}) AND status != 'completed'`).get(...sids);
+        if (pending.c === 0) {
+            report.drifts.push({
+                type: 'task_done_node_pending',
+                detail: `Node "${node.title}" (${node.node_id}): all tasks done but node is in_progress. Run finalize on the last task to trigger auto-propagation.`,
+            });
+            report.summary.drift++;
+            report.suggestions.push(`Node "${node.title}" (${node.node_id}) has all tasks complete but status is stuck. Re-run finalize on the last task to fix.`);
+        }
+    }
+    // ---- 7. Build suggestions ----
+    const activeCount = db.prepare("SELECT COUNT(*) as c FROM tasks WHERE status = 'active'").get().c;
+    if (activeCount > 3) {
+        report.suggestions.push(`${activeCount} active tasks. Consider reviewing for stale/inactive tasks with 'program rebuild --dry-run'.`);
+    }
+    if (report.orphans.length > 0) {
+        report.suggestions.push(`${report.orphans.length} orphan/stale step(s) found. They can serve as skipKey sources or be cleaned up.`);
+    }
+    if (report.drifts.length > 0) {
+        report.suggestions.push(`${report.drifts.length} state drift(s) found. Run finalize on affected tasks to propagate.`);
+    }
+    if (report.summary.totalTasks === 0) {
+        report.suggestions.push('No tasks found. Create a plan with: node dist/cli.js start-plan ...');
+    }
+    report.summary.healthy = report.summary.totalTasks - report.summary.stale - report.summary.orphan;
+    return report;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/core/reconcile.js.map

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

package/dist/core/session.d.ts

@@ -0,0 +1,25 @@
+export declare function getCurrentSessionId(): string | null;
+export interface SessionInfo {
+    sessionId: string;
+    sessionSecret: string;
+    recoveryToken: string;
+    cliInstanceId: string;
+    workspace: string;
+}
+/** Create a new session and write the session file. */
+export declare function createSession(workspace: string): SessionInfo;
+/** Verify session_secret against stored hash. */
+export declare function verifySessionSecret(sessionId: string, secret: string): boolean;
+/** Verify recovery_token against stored hash. */
+export declare function verifyRecoveryToken(sessionId: string, token: string): boolean;
+/** Check if a session is still active. */
+export declare function isSessionActive(sessionId: string): boolean;
+/** Write session credentials to local file for CLI/Hook use. */
+export declare function writeSessionFile(info: SessionInfo): void;
+/** Write binding file — deterministic pointer for Stop Hook.
+ *  Only one binding per workspace at a time (last-write-wins per MCP process). */
+export declare function writeBindingFile(info: {
+    sessionId: string;
+    cliInstanceId: string;
+    workspace: string;
+}): void;

package/dist/core/session.js

@@ -0,0 +1,88 @@
+import crypto from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import db from '../storage/db.js';
+import { randomCode } from './keys.js';
+const SESSION_DIR = '.step-gate/sessions';
+const BINDING_DIR = '.step-gate/bindings';
+// Shared state: the single session for this MCP process.
+// Created lazily on first gate_start_plan call, then shared by all tools.
+let currentSessionId = null;
+export function getCurrentSessionId() { return currentSessionId; }
+function sha256(input) {
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+function now() {
+    return new Date().toISOString();
+}
+/** Create a new session and write the session file. */
+export function createSession(workspace) {
+    const sessionId = `ses_${randomCode(6)}`;
+    const sessionSecret = randomCode(6);
+    const recoveryToken = randomCode(6);
+    const cliInstanceId = `cli_${randomCode(6)}`;
+    const ts = now();
+    db.prepare(`
+    INSERT INTO sessions (session_id, session_secret_hash, recovery_token_hash, workspace, created_by_cli, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(sessionId, sha256(sessionSecret), sha256(recoveryToken), workspace, cliInstanceId, ts, ts);
+    db.prepare(`
+    INSERT INTO cli_instances (cli_instance_id, session_id, workspace, pid, created_at, last_seen_at)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(cliInstanceId, sessionId, workspace, process.pid, ts, ts);
+    currentSessionId = sessionId;
+    writeSessionFile({ sessionId, sessionSecret, recoveryToken, cliInstanceId, workspace });
+    writeBindingFile({ sessionId, cliInstanceId, workspace });
+    return { sessionId, sessionSecret, recoveryToken, cliInstanceId, workspace };
+}
+/** Verify session_secret against stored hash. */
+export function verifySessionSecret(sessionId, secret) {
+    const row = db.prepare('SELECT session_secret_hash FROM sessions WHERE session_id = ?')
+        .get(sessionId);
+    if (!row)
+        return false;
+    return sha256(secret) === row.session_secret_hash;
+}
+/** Verify recovery_token against stored hash. */
+export function verifyRecoveryToken(sessionId, token) {
+    const row = db.prepare('SELECT recovery_token_hash FROM sessions WHERE session_id = ?')
+        .get(sessionId);
+    if (!row)
+        return false;
+    return sha256(token) === row.recovery_token_hash;
+}
+/** Check if a session is still active. */
+export function isSessionActive(sessionId) {
+    const row = db.prepare("SELECT status FROM sessions WHERE session_id = ?")
+        .get(sessionId);
+    return row?.status === 'active';
+}
+/** Write session credentials to local file for CLI/Hook use. */
+export function writeSessionFile(info) {
+    const dir = resolve(info.workspace || process.cwd(), SESSION_DIR);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(resolve(dir, `${info.sessionId}.json`), JSON.stringify({
+        session_id: info.sessionId,
+        session_secret: info.sessionSecret,
+        recovery_token: info.recoveryToken,
+        cli_instance_id: info.cliInstanceId,
+        workspace: info.workspace || process.cwd(),
+        created_at: now(),
+    }, null, 2));
+}
+/** Write binding file — deterministic pointer for Stop Hook.
+ *  Only one binding per workspace at a time (last-write-wins per MCP process). */
+export function writeBindingFile(info) {
+    const dir = resolve(info.workspace || process.cwd(), BINDING_DIR);
+    mkdirSync(dir, { recursive: true });
+    const bindId = `bind_${info.cliInstanceId}`;
+    writeFileSync(resolve(dir, `${bindId}.json`), JSON.stringify({
+        binding_id: bindId,
+        session_id: info.sessionId,
+        session_file: `${SESSION_DIR}/${info.sessionId}.json`,
+        cli_instance_id: info.cliInstanceId,
+        workspace: info.workspace || process.cwd(),
+        created_at: now(),
+    }, null, 2));
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,29 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerStartPlan } from './tools/startPlan.js';
+import { registerCurrent } from './tools/current.js';
+import { registerCheckpoint } from './tools/checkpoint.js';
+import { registerFinalize } from './tools/finalize.js';
+import { registerActiveTask } from './tools/activeTask.js';
+import { registerCancelTask } from './tools/cancelTask.js';
+import { getCurrentSessionId } from './core/session.js';
+// Session: created lazily on first gate_start_plan call.
+// All tools share the same session via getCurrentSessionId().
+// This ensures gate_current and gate_checkpoint see the same session
+// as gate_start_plan.
+const server = new McpServer({
+    name: 'agent-step-gate',
+    version: '0.2.0',
+});
+registerStartPlan(server);
+registerCurrent(server, () => getCurrentSessionId());
+registerCheckpoint(server);
+registerFinalize(server);
+registerActiveTask(server, () => getCurrentSessionId());
+registerCancelTask(server, () => getCurrentSessionId());
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,yDAAyD;AACzD,8DAA8D;AAC9D,qEAAqE;AACrE,sBAAsB;AAEtB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC;AACrD,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC;AACxD,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/storage/db.d.ts

@@ -0,0 +1,3 @@
+import Database from 'better-sqlite3';
+declare const db: Database.Database;
+export default db;

package/dist/storage/db.js

@@ -0,0 +1,117 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DB_PATH = resolve(__dirname, '..', '..', 'data', 'gate.db');
+mkdirSync(dirname(DB_PATH), { recursive: true });
+const db = new Database(DB_PATH);
+db.pragma('journal_mode = WAL');
+db.pragma('synchronous = NORMAL');
+db.pragma('busy_timeout = 5000');
+db.pragma('foreign_keys = ON');
+db.exec(`
+  CREATE TABLE IF NOT EXISTS programs (
+    program_id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'active',
+    total_nodes INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS program_nodes (
+    node_id TEXT PRIMARY KEY,
+    program_id TEXT NOT NULL,
+    title TEXT NOT NULL,
+    description TEXT,
+    order_index INTEGER NOT NULL DEFAULT 0,
+    status TEXT NOT NULL DEFAULT 'pending',
+    session_id TEXT,
+    completed_at TEXT,
+    created_at TEXT NOT NULL,
+    FOREIGN KEY(program_id) REFERENCES programs(program_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS sessions (
+    session_id TEXT PRIMARY KEY,
+    session_secret_hash TEXT NOT NULL,
+    recovery_token_hash TEXT NOT NULL,
+    title TEXT,
+    workspace TEXT,
+    program_id TEXT,
+    program_node_id TEXT,
+    status TEXT NOT NULL DEFAULT 'active',
+    created_by_cli TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    FOREIGN KEY(program_id) REFERENCES programs(program_id),
+    FOREIGN KEY(program_node_id) REFERENCES program_nodes(node_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS cli_instances (
+    cli_instance_id TEXT PRIMARY KEY,
+    session_id TEXT NOT NULL,
+    hostname TEXT,
+    pid INTEGER,
+    workspace TEXT,
+    status TEXT NOT NULL DEFAULT 'active',
+    created_at TEXT NOT NULL,
+    last_seen_at TEXT NOT NULL,
+    FOREIGN KEY(session_id) REFERENCES sessions(session_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS tasks (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'active',
+    current_index INTEGER NOT NULL DEFAULT 0,
+    total_steps INTEGER NOT NULL,
+    final_key_hash TEXT,
+    session_id TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    FOREIGN KEY(session_id) REFERENCES sessions(session_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS steps (
+    id TEXT PRIMARY KEY,
+    task_id TEXT NOT NULL,
+    parent_path TEXT,
+    title TEXT NOT NULL,
+    path TEXT NOT NULL,
+    order_index INTEGER NOT NULL,
+    depends_on TEXT,
+    status TEXT NOT NULL DEFAULT 'pending',
+    step_key_hash TEXT,
+    completed_at TEXT,
+    created_at TEXT NOT NULL,
+    FOREIGN KEY(task_id) REFERENCES tasks(id)
+  );
+
+  CREATE TABLE IF NOT EXISTS events (
+    id TEXT PRIMARY KEY,
+    task_id TEXT NOT NULL,
+    step_id TEXT,
+    event_type TEXT NOT NULL,
+    payload TEXT,
+    created_at TEXT NOT NULL,
+    FOREIGN KEY(task_id) REFERENCES tasks(id)
+  );
+`);
+// Safe migrations for existing databases
+for (const sql of [
+    "ALTER TABLE tasks ADD COLUMN session_id TEXT",
+    "ALTER TABLE sessions ADD COLUMN created_by_cli TEXT",
+    "ALTER TABLE sessions ADD COLUMN workspace TEXT",
+    "ALTER TABLE sessions ADD COLUMN program_id TEXT",
+    "ALTER TABLE sessions ADD COLUMN program_node_id TEXT",
+    "ALTER TABLE program_nodes ADD COLUMN node_key_hash TEXT",
+]) {
+    try {
+        db.exec(sql);
+    }
+    catch { /* column exists */ }
+}
+export default db;
+//# sourceMappingURL=db.js.map

package/dist/storage/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAElE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAEjD,MAAM,EAAE,GAAsB,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;AAEpD,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAChC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAClC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACjC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE/B,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwFP,CAAC,CAAC;AAEH,yCAAyC;AACzC,KAAK,MAAM,GAAG,IAAI;IAChB,8CAA8C;IAC9C,qDAAqD;IACrD,gDAAgD;IAChD,iDAAiD;IACjD,sDAAsD;IACtD,yDAAyD;CAC1D,EAAE,CAAC;IACF,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;AACrD,CAAC;AAED,eAAe,EAAE,CAAC"}

package/dist/storage/repository.d.ts

@@ -0,0 +1,24 @@
+import type { TaskRow, StepRow, EventRow } from '../types/index.js';
+export declare function createTask(task: TaskRow, steps: StepRow[]): void;
+export declare function getTask(taskId: string): TaskRow | undefined;
+export declare function getCurrentSteps(taskId: string): StepRow[];
+export declare function getCurrentStep(taskId: string): StepRow | undefined;
+export declare function getStep(stepId: string): StepRow | undefined;
+export declare function getTaskSteps(taskId: string): StepRow[];
+export declare function completeStep(stepId: string): void;
+export declare function setCurrentStep(stepId: string, keyHash: string): void;
+export declare function updateTaskStatus(taskId: string, status: string): void;
+export declare function setFinalKeyHash(taskId: string, hash: string): void;
+export declare function verifyStepKey(taskId: string, stepId: string, keyPlaintext: string): boolean;
+export declare function verifyTaskKey(taskId: string, keyPlaintext: string): boolean;
+/** @deprecated use verifyTaskKey */
+export declare const verifyFinalKey: typeof verifyTaskKey;
+export declare function getActiveTasks(sessionId?: string): TaskRow[];
+export declare function getActiveTask(): TaskRow | undefined;
+export declare function cancelTask(taskId: string, sessionId: string): void;
+export declare function addEvent(taskId: string, stepId: string | null, eventType: string, payload?: string): void;
+export declare function completeAndAdvance(completedStepId: string, nextStepIds: string[], nextKeyHashes: string[], taskId: string, finalKeyHash: string | null): void;
+export declare function verifySkipKey(oldTaskId: string, stepId: string, oldKey: string): boolean;
+/** Record that a skipKey has been consumed — prevents unlimited reuse (B1 fix) */
+export declare function recordSkipConsumed(taskId: string, stepId: string): void;
+export declare function getEvents(taskId: string): EventRow[];