agent-threader 2.0.5

package/dist/lib/parser/parser.d.ts

@@ -0,0 +1,8 @@
+import type { TaskResultV2, HealDecisionV2, ParserFailure } from "../contracts/types.js";
+export declare function parseTaskResult(logPath: string): TaskResultV2 | ParserFailure;
+export declare function parseHealDecision(logPath: string): HealDecisionV2 | ParserFailure;
+export declare function parseTaskResultFromString(raw: string): TaskResultV2 | ParserFailure;
+export declare function parseHealDecisionFromString(raw: string): HealDecisionV2 | ParserFailure;
+export declare function generateFailureSignature(failureClass: string, primarySignal: string, maxLength?: number): string;
+export declare function isParserFailure(result: TaskResultV2 | HealDecisionV2 | ParserFailure): result is ParserFailure;
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/parser/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAQ/B,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,aAAa,CAG9B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,aAAa,CAGhC;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,GACV,YAAY,GAAG,aAAa,CAmB9B;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,aAAa,CAmBhC;AA2HD,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAM,GACd,MAAM,CAYR;AAMD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,aAAa,GACpD,MAAM,IAAI,aAAa,CAEzB"}

package/dist/lib/parser/parser.js

@@ -0,0 +1,167 @@
+import { readFileSync } from "node:fs";
+import { validateTaskResultSchema, validateHealDecisionSchema } from "../contracts/schema-validator.js";
+const TASK_RESULT_START = "<<<TASK_RESULT_V2>>>";
+const TASK_RESULT_END = "<<<END_TASK_RESULT_V2>>>";
+const HEAL_DECISION_START = "<<<HEAL_DECISION_V2>>>";
+const HEAL_DECISION_END = "<<<END_HEAL_DECISION_V2>>>";
+export function parseTaskResult(logPath) {
+    const raw = readFileSync(logPath, "utf8");
+    return parseTaskResultFromString(raw);
+}
+export function parseHealDecision(logPath) {
+    const raw = readFileSync(logPath, "utf8");
+    return parseHealDecisionFromString(raw);
+}
+export function parseTaskResultFromString(raw) {
+    const extracted = extractLastFencedBlock(raw, TASK_RESULT_START, TASK_RESULT_END);
+    if (!extracted) {
+        return fail("NO_SENTINEL", "No <<<TASK_RESULT_V2>>> block found in output");
+    }
+    const repaired = repairJson(extracted);
+    let parsed;
+    try {
+        parsed = JSON.parse(repaired);
+    }
+    catch (e) {
+        return fail("INVALID_JSON", `Invalid JSON in TASK_RESULT_V2 block: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return validateTaskResult(parsed);
+}
+export function parseHealDecisionFromString(raw) {
+    const extracted = extractLastFencedBlock(raw, HEAL_DECISION_START, HEAL_DECISION_END);
+    if (!extracted) {
+        return fail("NO_SENTINEL", "No <<<HEAL_DECISION_V2>>> block found in output");
+    }
+    const repaired = repairJson(extracted);
+    let parsed;
+    try {
+        parsed = JSON.parse(repaired);
+    }
+    catch (e) {
+        return fail("INVALID_JSON", `Invalid JSON in HEAL_DECISION_V2 block: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return validateHealDecision(parsed);
+}
+function extractLastFencedBlock(text, startSentinel, endSentinel) {
+    let lastMatch = null;
+    let searchFrom = 0;
+    for (;;) {
+        const startIdx = text.indexOf(startSentinel, searchFrom);
+        if (startIdx === -1)
+            break;
+        const contentStart = startIdx + startSentinel.length;
+        const endIdx = text.indexOf(endSentinel, contentStart);
+        if (endIdx === -1)
+            break;
+        lastMatch = text.slice(contentStart, endIdx).trim();
+        searchFrom = endIdx + endSentinel.length;
+    }
+    return lastMatch;
+}
+function repairJson(raw) {
+    let text = raw.trim();
+    if (text.startsWith("```")) {
+        const lines = text.split("\n");
+        if (lines[lines.length - 1].trim() === "```") {
+            lines.shift();
+            lines.pop();
+            text = lines.join("\n").trim();
+        }
+    }
+    text = removeComments(text);
+    text = text.replace(/,\s*([\]}])/g, "$1");
+    return text;
+}
+function removeComments(text) {
+    let result = "";
+    let i = 0;
+    let inString = false;
+    while (i < text.length) {
+        if (inString) {
+            if (text[i] === "\\" && i + 1 < text.length) {
+                result += text[i] + text[i + 1];
+                i += 2;
+                continue;
+            }
+            if (text[i] === '"') {
+                inString = false;
+            }
+            result += text[i];
+            i++;
+        }
+        else {
+            if (text[i] === '"') {
+                inString = true;
+                result += text[i];
+                i++;
+            }
+            else if (text[i] === "/" && i + 1 < text.length && text[i + 1] === "/") {
+                while (i < text.length && text[i] !== "\n")
+                    i++;
+            }
+            else if (text[i] === "/" && i + 1 < text.length && text[i + 1] === "*") {
+                i += 2;
+                while (i < text.length && !(text[i] === "*" && i + 1 < text.length && text[i + 1] === "/")) {
+                    i++;
+                }
+                if (i < text.length)
+                    i += 2;
+            }
+            else {
+                result += text[i];
+                i++;
+            }
+        }
+    }
+    return result;
+}
+function validateTaskResult(data) {
+    if (typeof data !== "object" || data === null) {
+        return fail("SCHEMA_VIOLATION", "Task result must be a JSON object");
+    }
+    const obj = data;
+    if (obj.contract_version !== "2.0") {
+        return fail("UNSUPPORTED_VERSION", `Expected contract_version "2.0", got "${String(obj.contract_version)}"`);
+    }
+    const schemaResult = validateTaskResultSchema(data);
+    if (!schemaResult.valid) {
+        const first = schemaResult.errors[0];
+        const code = first?.keyword === "required" ? "MISSING_REQUIRED_FIELD" : "SCHEMA_VIOLATION";
+        return fail(code, schemaResult.errors.map(e => `${e.path}: ${e.message}`).join("; "));
+    }
+    return data;
+}
+function validateHealDecision(data) {
+    if (typeof data !== "object" || data === null) {
+        return fail("SCHEMA_VIOLATION", "Heal decision must be a JSON object");
+    }
+    const obj = data;
+    if (obj.contract_version !== "2.0") {
+        return fail("UNSUPPORTED_VERSION", `Expected contract_version "2.0", got "${String(obj.contract_version)}"`);
+    }
+    const schemaResult = validateHealDecisionSchema(data);
+    if (!schemaResult.valid) {
+        const first = schemaResult.errors[0];
+        const code = first?.keyword === "required" ? "MISSING_REQUIRED_FIELD" : "SCHEMA_VIOLATION";
+        return fail(code, schemaResult.errors.map(e => `${e.path}: ${e.message}`).join("; "));
+    }
+    return data;
+}
+export function generateFailureSignature(failureClass, primarySignal, maxLength = 120) {
+    let sig = primarySignal;
+    sig = sig.replace(/\/[\w./-]+/g, "<path>");
+    sig = sig.replace(/\d{4}-\d{2}-\d{2}T[\d:.Z+-]+/g, "<ts>");
+    sig = sig.replace(/\b\d{4,}\b/g, "<n>");
+    sig = sig.toLowerCase().replace(/\s+/g, " ").trim();
+    if (sig.length > maxLength - failureClass.length - 1) {
+        sig = sig.slice(0, maxLength - failureClass.length - 1);
+    }
+    return `${failureClass}:${sig}`;
+}
+function fail(code, message) {
+    return { ok: false, code, message };
+}
+export function isParserFailure(result) {
+    return "ok" in result && result.ok === false;
+}
+//# sourceMappingURL=parser.js.map

package/dist/lib/parser/parser.js.map

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

package/dist/lib/state/init-state.d.ts

@@ -0,0 +1,15 @@
+import type { RunPolicy } from "./types.js";
+export interface InitStateOptions {
+    manifestPath: string;
+    outputPath?: string;
+    heal?: string;
+    batchStrategy?: string;
+}
+export interface InitStateResult {
+    statePath: string;
+    runId: string;
+    taskCount: number;
+    policy: RunPolicy;
+}
+export declare function initState(options: InitStateOptions): Promise<InitStateResult>;
+//# sourceMappingURL=init-state.d.ts.map

package/dist/lib/state/init-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-state.d.ts","sourceRoot":"","sources":["../../../src/lib/state/init-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkDnF"}

package/dist/lib/state/init-state.js

@@ -0,0 +1,50 @@
+import { readFileSync } from "node:fs";
+import { DEFAULT_POLICY } from "./types.js";
+import { initializeState, writeState } from "./state.js";
+import { ConfigError } from "../errors/types.js";
+import { validateManifestSchema } from "../contracts/schema-validator.js";
+export async function initState(options) {
+    const outputPath = options.outputPath ?? ".agentic/state.json";
+    let raw;
+    try {
+        raw = readFileSync(options.manifestPath, "utf8");
+    }
+    catch (e) {
+        throw new ConfigError(options.manifestPath, `Cannot read manifest: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new ConfigError(options.manifestPath, `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const schemaResult = validateManifestSchema(data);
+    if (!schemaResult.valid) {
+        const msgs = schemaResult.errors.map(e => `${e.path}: ${e.message}`).join("; ");
+        throw new ConfigError(options.manifestPath, `Schema validation failed: ${msgs}`);
+    }
+    const manifest = data;
+    const policy = { ...DEFAULT_POLICY };
+    if (options.heal) {
+        const valid = ["auto", "off", "task", "batch", "epoch"];
+        if (valid.includes(options.heal)) {
+            policy.heal_schedule = options.heal;
+        }
+    }
+    if (options.batchStrategy) {
+        const valid = ["fibonacci", "fixed"];
+        if (valid.includes(options.batchStrategy)) {
+            policy.batch_strategy = options.batchStrategy;
+        }
+    }
+    const state = initializeState(manifest, policy);
+    writeState(outputPath, state);
+    return {
+        statePath: outputPath,
+        runId: state.run_id,
+        taskCount: manifest.tasks.length,
+        policy: state.policy,
+    };
+}
+//# sourceMappingURL=init-state.js.map

package/dist/lib/state/init-state.js.map

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

package/dist/lib/state/logs.d.ts

@@ -0,0 +1,19 @@
+export interface LogsOptions {
+    statePath: string;
+    taskId?: string;
+    phase?: string;
+}
+export interface LogEntry {
+    taskId: string;
+    phase: string;
+    attempt: number;
+    logPath: string;
+    verifyLogPath: string | null;
+    exitCode: number | null;
+    timestamp: string;
+}
+export interface LogsResult {
+    entries: LogEntry[];
+}
+export declare function getLogs(options: LogsOptions): LogsResult;
+//# sourceMappingURL=logs.d.ts.map

package/dist/lib/state/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/lib/state/logs.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAyBxD"}

package/dist/lib/state/logs.js

@@ -0,0 +1,25 @@
+import { loadState } from "./state.js";
+export function getLogs(options) {
+    const state = loadState(options.statePath);
+    const entries = [];
+    for (const [taskId, ts] of Object.entries(state.tasks)) {
+        if (options.taskId && taskId !== options.taskId)
+            continue;
+        for (const h of ts.history) {
+            if (options.phase && h.phase !== options.phase)
+                continue;
+            entries.push({
+                taskId: h.task_id,
+                phase: h.phase,
+                attempt: h.attempt_number,
+                logPath: h.log_path,
+                verifyLogPath: h.verify_log_path ?? null,
+                exitCode: h.exit_code ?? null,
+                timestamp: h.timestamp,
+            });
+        }
+    }
+    entries.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    return { entries };
+}
+//# sourceMappingURL=logs.js.map

package/dist/lib/state/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/lib/state/logs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAsBvC,MAAM,UAAU,OAAO,CAAC,OAAoB;IAC1C,MAAM,KAAK,GAAY,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,OAAO,GAAe,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,OAAO,CAAC,MAAM;YAAE,SAAS;QAE1D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;gBAAE,SAAS;YAEzD,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,CAAC,CAAC,OAAO;gBACjB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,cAAc;gBACzB,OAAO,EAAE,CAAC,CAAC,QAAQ;gBACnB,aAAa,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;gBACxC,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;gBAC7B,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAE/D,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/lib/state/state.d.ts

@@ -0,0 +1,7 @@
+import type { ManifestV2 } from "../contracts/types.js";
+import type { StateV2, RunPolicy } from "./types.js";
+export declare function loadState(statePath: string): StateV2;
+export declare function writeState(statePath: string, state: StateV2): void;
+export declare function initializeState(manifest: ManifestV2, policy?: RunPolicy): StateV2;
+export declare function computeManifestDigest(manifest: ManifestV2): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/lib/state/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/lib/state/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAKhE,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAsBpD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAIlE;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,UAAU,EACpB,MAAM,GAAE,SAA0B,GACjC,OAAO,CAyBT;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAalE"}

package/dist/lib/state/state.js

@@ -0,0 +1,72 @@
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { DEFAULT_POLICY } from "./types.js";
+import { ConfigError } from "../errors/types.js";
+import { validateStateSchema } from "../contracts/schema-validator.js";
+export function loadState(statePath) {
+    let raw;
+    try {
+        raw = readFileSync(statePath, "utf8");
+    }
+    catch (e) {
+        throw new ConfigError(statePath, `Cannot read state file: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new ConfigError(statePath, `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const schemaResult = validateStateSchema(data);
+    if (!schemaResult.valid) {
+        const msgs = schemaResult.errors.map(e => `${e.path}: ${e.message}`).join("; ");
+        throw new ConfigError(statePath, `Schema validation failed: ${msgs}`);
+    }
+    return data;
+}
+export function writeState(statePath, state) {
+    const dir = path.dirname(statePath);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(statePath, JSON.stringify(state, null, 2) + "\n", "utf8");
+}
+export function initializeState(manifest, policy = DEFAULT_POLICY) {
+    const tasks = {};
+    for (const task of manifest.tasks) {
+        tasks[task.id] = {
+            status: "PENDING",
+            worker_attempts: 0,
+            healer_attempts: 0,
+            last_failure_class: null,
+            last_failure_signature: null,
+            applied_patch_ids: [],
+            history: [],
+        };
+    }
+    return {
+        state_version: "2.0",
+        run_id: manifest.run_id,
+        run_status: "RUNNING",
+        abort_reason: null,
+        manifest_digest: computeManifestDigest(manifest),
+        policy,
+        tasks,
+        healing_rounds: [],
+    };
+}
+export function computeManifestDigest(manifest) {
+    const normalized = JSON.stringify({
+        manifest_version: manifest.manifest_version,
+        run_id: manifest.run_id,
+        tasks: manifest.tasks.map(t => ({
+            id: t.id,
+            prompt_ref: t.prompt_ref,
+            depends_on: [...t.depends_on].sort(),
+            timeout_sec: t.timeout_sec,
+            verify_profile: t.verify_profile,
+        })),
+    });
+    return createHash("sha256").update(normalized).digest("hex");
+}
+//# sourceMappingURL=state.js.map

package/dist/lib/state/state.js.map

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

package/dist/lib/state/status.d.ts

@@ -0,0 +1,22 @@
+export interface StatusOptions {
+    statePath: string;
+}
+export interface FailedTaskInfo {
+    taskId: string;
+    status: string;
+    failureClass: string | null;
+    failureSignature: string | null;
+    workerAttempts: number;
+}
+export interface StatusResult {
+    runId: string;
+    runStatus: string;
+    abortReason: string | null;
+    taskSummary: Record<string, number>;
+    totalTasks: number;
+    healingRounds: number;
+    lastHealDecision: string | null;
+    failedTasks: FailedTaskInfo[];
+}
+export declare function getStatus(options: StatusOptions): StatusResult;
+//# sourceMappingURL=status.d.ts.map

package/dist/lib/state/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/lib/state/status.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAoC9D"}

package/dist/lib/state/status.js

@@ -0,0 +1,34 @@
+import { loadState } from "./state.js";
+export function getStatus(options) {
+    const state = loadState(options.statePath);
+    const taskSummary = {};
+    const failedTasks = [];
+    let totalTasks = 0;
+    for (const [taskId, ts] of Object.entries(state.tasks)) {
+        totalTasks++;
+        taskSummary[ts.status] = (taskSummary[ts.status] ?? 0) + 1;
+        if (ts.status === "FAILED" || ts.status === "ESCALATED" || ts.status === "BLOCKED") {
+            failedTasks.push({
+                taskId,
+                status: ts.status,
+                failureClass: ts.last_failure_class,
+                failureSignature: ts.last_failure_signature,
+                workerAttempts: ts.worker_attempts,
+            });
+        }
+    }
+    const lastRound = state.healing_rounds.length > 0
+        ? state.healing_rounds[state.healing_rounds.length - 1]
+        : null;
+    return {
+        runId: state.run_id,
+        runStatus: state.run_status,
+        abortReason: state.abort_reason,
+        taskSummary,
+        totalTasks,
+        healingRounds: state.healing_rounds.length,
+        lastHealDecision: lastRound?.decision ?? null,
+        failedTasks,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/lib/state/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/lib/state/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyBvC,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,MAAM,KAAK,GAAY,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEpD,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,UAAU,EAAE,CAAC;QACb,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAE3D,IAAI,EAAE,CAAC,MAAM,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,WAAW,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACnF,WAAW,CAAC,IAAI,CAAC;gBACf,MAAM;gBACN,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,YAAY,EAAE,EAAE,CAAC,kBAAkB;gBACnC,gBAAgB,EAAE,EAAE,CAAC,sBAAsB;gBAC3C,cAAc,EAAE,EAAE,CAAC,eAAe;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC/C,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QACvD,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,WAAW,EAAE,KAAK,CAAC,YAAY;QAC/B,WAAW;QACX,UAAU;QACV,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM;QAC1C,gBAAgB,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI;QAC7C,WAAW;KACZ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,55 @@
+export type TaskStatus = "PENDING" | "RUNNING" | "DONE" | "BLOCKED" | "FAILED" | "ESCALATED";
+export interface HistoryEntry {
+    task_id: string;
+    phase: "worker" | "verify" | "healer" | "rollback";
+    attempt_number: number;
+    log_path: string;
+    verify_log_path?: string | null;
+    exit_code?: number | null;
+    failure_class?: string | null;
+    failure_signature?: string | null;
+    applied_patch_ids?: string[];
+    duration_sec?: number | null;
+    timestamp: string;
+}
+export interface TaskState {
+    status: TaskStatus;
+    worker_attempts: number;
+    healer_attempts: number;
+    last_failure_class: string | null;
+    last_failure_signature: string | null;
+    applied_patch_ids: string[];
+    history: HistoryEntry[];
+}
+export interface RunPolicy {
+    heal_schedule: "auto" | "off" | "task" | "batch" | "epoch";
+    batch_strategy: "fibonacci" | "fixed";
+    current_batch_size: number;
+    failure_threshold: number;
+    max_worker_attempts_per_task: number;
+    max_heal_rounds_per_window: number;
+    max_total_heal_rounds: number;
+    signature_repeat_limit: number;
+}
+export interface HealingRound {
+    round_number: number;
+    scope: "task" | "batch" | "epoch";
+    window_task_ids: string[];
+    failed_task_ids: string[];
+    decision: "RETRY" | "ESCALATE" | "NOT_FIXABLE";
+    applied_patch_ids: string[];
+    timestamp: string;
+}
+export interface StateV2 {
+    state_version: "2.0";
+    run_id: string;
+    run_status: "RUNNING" | "COMPLETED" | "ABORTED";
+    abort_reason: string | null;
+    manifest_digest: string;
+    policy: RunPolicy;
+    tasks: Record<string, TaskState>;
+    healing_rounds: HealingRound[];
+}
+export declare const DEFAULT_POLICY: RunPolicy;
+export declare const FIBONACCI_BATCH_SEQUENCE: readonly [1, 2, 3, 5, 8, 13];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/state/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAI7F,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3D,cAAc,EAAE,WAAW,GAAG,OAAO,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4BAA4B,EAAE,MAAM,CAAC;IACrC,0BAA0B,EAAE,MAAM,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAID,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,cAAc,EAAE,YAAY,EAAE,CAAC;CAChC;AAID,eAAO,MAAM,cAAc,EAAE,SAS5B,CAAC;AAEF,eAAO,MAAM,wBAAwB,8BAA+B,CAAC"}

package/dist/lib/state/types.js

@@ -0,0 +1,14 @@
+// ─── Task Status ─────────────────────────────────────────────────────────────
+// ─── Defaults ────────────────────────────────────────────────────────────────
+export const DEFAULT_POLICY = {
+    heal_schedule: "auto",
+    batch_strategy: "fibonacci",
+    current_batch_size: 1,
+    failure_threshold: 0.5,
+    max_worker_attempts_per_task: 3,
+    max_heal_rounds_per_window: 2,
+    max_total_heal_rounds: 8,
+    signature_repeat_limit: 2,
+};
+export const FIBONACCI_BATCH_SEQUENCE = [1, 2, 3, 5, 8, 13];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/state/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAsEhF,gFAAgF;AAEhF,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,aAAa,EAAE,MAAM;IACrB,cAAc,EAAE,WAAW;IAC3B,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,GAAG;IACtB,4BAA4B,EAAE,CAAC;IAC/B,0BAA0B,EAAE,CAAC;IAC7B,qBAAqB,EAAE,CAAC;IACxB,sBAAsB,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAU,CAAC"}