@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/pactile/task/session-retrieval-jev.d.ts

@@ -0,0 +1,8 @@
+import type { PactileIntentV1 } from "../../core/index.js";
+export interface SessionRetrievalIntentOptionsV1 {
+    /** A caller-specified intent set is passed through without Jev advice. */
+    readonly intents?: readonly PactileIntentV1[];
+}
+/** Add optional local-route suggestions to a V2 Session fact-gap plan. */
+export declare function compileSessionRetrievalPlanWithJevV1(root: string, pack: Record<string, unknown>, options?: SessionRetrievalIntentOptionsV1): Promise<Record<string, unknown>>;
+//# sourceMappingURL=session-retrieval-jev.d.ts.map

package/dist/pactile/task/session-retrieval-jev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-retrieval-jev.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/session-retrieval-jev.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAkD5E,MAAM,WAAW,+BAA+B;IAC9C,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AA2OD,0EAA0E;AAC1E,wBAAsB,oCAAoC,CACxD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0KlC"}

package/dist/pactile/task/session-retrieval-jev.js

@@ -0,0 +1,352 @@
+import { projectTaskKernelLifecycle, readTaskKernel, } from "../../core/task/index.js";
+import { createJevDecisionFacadeV1, } from "../jev/index.js";
+import { JEV_ORIGIN_V1 } from "../jev/contracts.js";
+import { containsJevSensitiveContentV1, containsJevStructuredTextV1, } from "../jev/outbound.js";
+import { resolveJevProjectEgressPolicyV1 } from "../jev/project-policy.js";
+import { planRetrievalWithJevV1 } from "../retrieval/index.js";
+import { RETRIEVAL_INTENT_ORDER } from "../retrieval/types.js";
+import { resolveSelectedTask, resolveTaskDir } from "./session.js";
+import { compileSessionPack } from "./session-pack.js";
+import { attachSessionRetrievalJevReceiptV1, createSessionRetrievalJevReceiptV1, } from "./session-retrieval-jev-receipt.js";
+const SESSION_RETRIEVAL_JEV_DEADLINE_MS = 2_500;
+const SESSION_RETRIEVAL_JEV_MAX_RETRIES = 1;
+const MAX_SESSION_TASK_SUMMARY_BYTES = 8 * 1024;
+const MAX_SESSION_TASK_SUMMARY_CHARS = 1_800;
+const FALLBACK_EXPLANATION = "Jev retrieval advice was unavailable; the deterministic retrieval plan was kept.";
+const SESSION_RETRIEVAL_JEV_POLICY = {
+    filesystem: "read",
+    process: "none",
+    network: "project-authorized",
+    credentials: "project-authorized",
+    privacy: "project-approved-egress",
+    egressDestinations: [JEV_ORIGIN_V1],
+    telemetry: "local-only",
+    cost: "low",
+};
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function boundedSummary(value) {
+    const normalized = value.replace(/\s+/gu, " ").trim();
+    let result = "";
+    for (const character of normalized) {
+        if (result.length + character.length > MAX_SESSION_TASK_SUMMARY_CHARS ||
+            Buffer.byteLength(result, "utf8") + Buffer.byteLength(character, "utf8") >
+                MAX_SESSION_TASK_SUMMARY_BYTES)
+            break;
+        result += character;
+    }
+    return result || "Selected V2 Task";
+}
+function safeSessionPlanningSummary(phase) {
+    return `V2 Session fact gap in phase ${phase}. Decide whether semantic or structural local retrieval should supplement exact search.`;
+}
+function readCurrentV2Session(root) {
+    const selected = resolveSelectedTask(root);
+    if (!selected.taskPath || selected.stale)
+        return null;
+    const taskDir = resolveTaskDir(root, selected.taskPath);
+    const read = readTaskKernel({ root, taskDir, cwd: root });
+    if (read.kind !== "task-kernel-v2")
+        return null;
+    const lifecycle = projectTaskKernelLifecycle(read.kernel);
+    return {
+        stamp: {
+            taskPath: selected.taskPath,
+            contextKey: selected.contextKey,
+            taskId: lifecycle.taskId,
+            revision: lifecycle.revision,
+            phase: lifecycle.phase,
+        },
+        summary: boundedSummary(read.kernel.definition.title + "\n" + read.kernel.definition.deliverable),
+    };
+}
+function sameStamp(left, right) {
+    return (left !== null &&
+        right !== null &&
+        left.taskPath === right.taskPath &&
+        left.contextKey === right.contextKey &&
+        left.taskId === right.taskId &&
+        left.revision === right.revision &&
+        left.phase === right.phase);
+}
+function packedStamp(pack) {
+    const kernel = record(pack.kernel);
+    if (kernel?.schemaVersion !== 2 ||
+        kernel.selected !== true ||
+        typeof kernel.taskId !== "string" ||
+        typeof kernel.phase !== "string" ||
+        typeof kernel.revision !== "number" ||
+        !Number.isSafeInteger(kernel.revision) ||
+        kernel.revision < 0)
+        return null;
+    return {
+        taskPath: "",
+        contextKey: null,
+        taskId: kernel.taskId,
+        revision: kernel.revision,
+        phase: kernel.phase,
+    };
+}
+function packHasFactGap(pack) {
+    return (Array.isArray(pack.layers) &&
+        pack.layers.some((value) => {
+            const layer = record(value);
+            return layer?.n === 4 && layer.present === true;
+        }));
+}
+function attachPlanningReceipt(pack, input) {
+    const intents = [...input.intents];
+    const layers = Array.isArray(pack.layers)
+        ? pack.layers.map((value) => {
+            const layer = record(value);
+            if (layer?.n !== 4 || layer.present !== true)
+                return value;
+            return {
+                ...layer,
+                intents,
+                text: [
+                    "Fact gap: route with intents " + intents.join(" / ") + ".",
+                    "Keep exact search. Jev may only suggest semantic or structural local routes; it cannot add external intent or authorize a Provider.",
+                    "Kernel remains authoritative. Do not bind Agent tool names. Ranking and retrieval-pack stay with retrieval-extended.",
+                ].join(" "),
+            };
+        })
+        : pack.layers;
+    const fallback = input.fallbackReasonCode
+        ? {
+            reasonCode: input.fallbackReasonCode,
+            explanation: FALLBACK_EXPLANATION,
+        }
+        : null;
+    const base = {
+        ...pack,
+        retrievalPlanning: {
+            schemaVersion: 1,
+            source: input.source,
+            intents,
+            fallback,
+        },
+        ...(Array.isArray(layers) ? { layers } : {}),
+    };
+    const audit = createSessionRetrievalJevReceiptV1({
+        summary: input.summary,
+        deterministicIntents: input.deterministicIntents,
+        result: input.result,
+        decision: input.decision,
+        ...(input.fallbackReasonCode
+            ? {
+                fallbackReasonCode: input.fallbackReasonCode,
+                ...(input.fallbackExplanation
+                    ? { fallbackExplanation: input.fallbackExplanation }
+                    : {}),
+            }
+            : {}),
+        ...(input.stale ? { stale: true } : {}),
+    });
+    return attachSessionRetrievalJevReceiptV1(base, audit);
+}
+function jevEgressAuthorization() {
+    return {
+        network: "project-authorized",
+        privacy: "project-approved-egress",
+        credentials: "project-authorized",
+        destination: JEV_ORIGIN_V1,
+        egressDestinations: [JEV_ORIGIN_V1],
+        contentDecision: "task-summary-approved",
+    };
+}
+function createSessionRetrievalFacade() {
+    const enabledValue = process.env.PACTILE_JEV_ENABLED?.trim().toLowerCase();
+    return createJevDecisionFacadeV1({
+        ...(enabledValue === "false" ? { enabled: false } : {}),
+        maxDecisions: 1,
+        maxDeadlineMs: SESSION_RETRIEVAL_JEV_DEADLINE_MS,
+        transport: {
+            apiKey: process.env.PACTILE_JEV_API_KEY,
+            deadlineMs: SESSION_RETRIEVAL_JEV_DEADLINE_MS,
+            maxRetries: SESSION_RETRIEVAL_JEV_MAX_RETRIES,
+        },
+    });
+}
+function suggestedLocalIntents(intents) {
+    const selected = new Set(["exact"]);
+    for (const intent of intents)
+        if (intent === "semantic" || intent === "structural")
+            selected.add(intent);
+    return RETRIEVAL_INTENT_ORDER.filter((intent) => selected.has(intent));
+}
+function currentPlanningContext(root, factGap, options) {
+    const currentPack = compileSessionPack(root, factGap);
+    let current = null;
+    try {
+        current = readCurrentV2Session(root);
+    }
+    catch {
+        current = null;
+    }
+    const summary = current
+        ? safeSessionPlanningSummary(current.stamp.phase)
+        : "V2 Session fact gap. Decide whether semantic or structural local retrieval should supplement exact search.";
+    const request = {
+        query: summary,
+        ...(options.intents === undefined ? {} : { intents: [...options.intents] }),
+    };
+    return {
+        pack: currentPack,
+        summary,
+        fallbackInput: {
+            request,
+            defaultToExactForUnspecifiedIntents: options.intents === undefined,
+        },
+    };
+}
+/** Add optional local-route suggestions to a V2 Session fact-gap plan. */
+export async function compileSessionRetrievalPlanWithJevV1(root, pack, options = {}) {
+    if (!packHasFactGap(pack))
+        return pack;
+    const expected = packedStamp(pack);
+    if (!expected)
+        return pack;
+    let initial = null;
+    try {
+        initial = readCurrentV2Session(root);
+    }
+    catch {
+        initial = null;
+    }
+    const matchedSession = initial !== null &&
+        initial.stamp.taskId === expected.taskId &&
+        initial.stamp.revision === expected.revision &&
+        initial.stamp.phase === expected.phase
+        ? initial
+        : null;
+    const summary = matchedSession
+        ? safeSessionPlanningSummary(matchedSession.stamp.phase)
+        : "V2 Session fact gap. Decide whether semantic or structural local retrieval should supplement exact search.";
+    const request = {
+        query: summary,
+        ...(options.intents === undefined ? {} : { intents: [...options.intents] }),
+    };
+    const defaultToExactForUnspecifiedIntents = options.intents === undefined;
+    const fallbackInput = {
+        request,
+        defaultToExactForUnspecifiedIntents,
+    };
+    const initialPlanningContext = {
+        pack,
+        summary,
+        fallbackInput: {
+            request: {
+                query: request.query,
+                ...(options.intents === undefined
+                    ? {}
+                    : { intents: [...options.intents] }),
+            },
+            defaultToExactForUnspecifiedIntents,
+        },
+    };
+    const deterministic = async (fallbackReasonCode, decision, stale = false, planningContext = initialPlanningContext, auditContext) => {
+        const auditSummary = auditContext?.summary ?? planningContext.summary;
+        const auditDeterministicIntents = auditContext?.deterministicIntents;
+        try {
+            const result = await planRetrievalWithJevV1(planningContext.fallbackInput);
+            return attachPlanningReceipt(planningContext.pack, {
+                source: "deterministic",
+                intents: result.plan.intents,
+                summary: auditSummary,
+                deterministicIntents: auditDeterministicIntents ?? result.plan.intents,
+                result,
+                decision,
+                ...(fallbackReasonCode ? { fallbackReasonCode } : {}),
+                ...(stale ? { stale: true } : {}),
+            });
+        }
+        catch {
+            return attachPlanningReceipt(planningContext.pack, {
+                source: "deterministic",
+                intents: options.intents ?? ["exact"],
+                summary: auditSummary,
+                deterministicIntents: auditDeterministicIntents ??
+                    options.intents ?? ["exact"],
+                decision,
+                fallbackReasonCode: fallbackReasonCode ?? "planner-unavailable",
+                ...(stale ? { stale: true } : {}),
+            });
+        }
+    };
+    if (!matchedSession)
+        return deterministic("session-changed", undefined, true, currentPlanningContext(root, true, options));
+    if (options.intents !== undefined)
+        return deterministic();
+    if (containsJevSensitiveContentV1(matchedSession.summary) ||
+        containsJevStructuredTextV1(matchedSession.summary))
+        return deterministic("sensitive-content");
+    const projectEgress = resolveJevProjectEgressPolicyV1(root);
+    if (!projectEgress.allowed)
+        return deterministic(projectEgress.reasonCode);
+    if (process.env.PACTILE_JEV_ENABLED?.trim().toLowerCase() === "false")
+        return deterministic("disabled");
+    const apiKey = process.env.PACTILE_JEV_API_KEY;
+    if (typeof apiKey !== "string" || apiKey.length === 0)
+        return deterministic("configuration-missing");
+    try {
+        const advised = await planRetrievalWithJevV1({
+            request: {
+                ...request,
+                // This ceiling authorizes only the bounded Jev advice call below.
+                // The receipt exposes intents only; Kernel still controls retrieval.
+                requestedPolicy: SESSION_RETRIEVAL_JEV_POLICY,
+            },
+            defaultToExactForUnspecifiedIntents: true,
+            jev: {
+                facade: createSessionRetrievalFacade(),
+                callOptions: { egress: jevEgressAuthorization() },
+            },
+        });
+        let current = null;
+        try {
+            current = readCurrentV2Session(root);
+        }
+        catch {
+            current = null;
+        }
+        if (!sameStamp(matchedSession.stamp, current?.stamp ?? null)) {
+            const currentContext = currentPlanningContext(root, true, options);
+            const staleDeterministicIntents = await planRetrievalWithJevV1(fallbackInput)
+                .then((result) => result.plan.intents)
+                .catch(() => options.intents ?? ["exact"]);
+            return deterministic("session-changed", advised.decision, true, currentContext, {
+                summary,
+                deterministicIntents: staleDeterministicIntents,
+            });
+        }
+        const projectEgressAfter = resolveJevProjectEgressPolicyV1(root);
+        if (!projectEgressAfter.allowed)
+            return deterministic(projectEgressAfter.reasonCode, advised.decision);
+        const intents = suggestedLocalIntents(advised.plan.intents);
+        const deterministicResult = await planRetrievalWithJevV1(fallbackInput);
+        return attachPlanningReceipt(pack, {
+            source: advised.source === "jev-advised" && intents.length > 1
+                ? "jev-advised"
+                : "deterministic",
+            intents,
+            summary,
+            deterministicIntents: deterministicResult.plan.intents,
+            result: advised,
+            decision: advised.decision,
+            ...(advised.decision?.status === "fallback"
+                ? {
+                    fallbackReasonCode: advised.decision.fallback.reasonCode,
+                    fallbackExplanation: advised.decision.fallback.explanation,
+                }
+                : {}),
+        });
+    }
+    catch {
+        return deterministic("advisor-error");
+    }
+}
+//# sourceMappingURL=session-retrieval-jev.js.map

package/dist/pactile/task/session-retrieval-jev.js.map

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

package/dist/pactile/task/session.d.ts

@@ -0,0 +1,13 @@
+export interface SelectedTask {
+    taskPath: string | null;
+    source: string;
+    contextKey: string | null;
+    stale: boolean;
+}
+/** A shell without a stable session key never inherits another task's selection. */
+export declare function resolveContextKey(env?: NodeJS.ProcessEnv): string | null;
+export declare function resolveTaskDir(root: string, taskRef: string): string;
+export declare function resolveSelectedTask(root: string, env?: NodeJS.ProcessEnv): SelectedTask;
+export declare function selectTask(root: string, taskRef: string, env?: NodeJS.ProcessEnv): SelectedTask;
+export declare function exitTask(root: string, env?: NodeJS.ProcessEnv): SelectedTask;
+//# sourceMappingURL=session.d.ts.map

package/dist/pactile/task/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAOD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAGrF;AAiBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA8BpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAapG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAoB5G;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAMzF"}

package/dist/pactile/task/session.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+function safeContextKey(raw) {
+    const value = raw.trim().replace(/[^A-Za-z0-9._-]+/g, "_").replace(/^[._-]+|[._-]+$/g, "").slice(0, 160);
+    return value || createHash("sha256").update(raw).digest("hex").slice(0, 24);
+}
+/** A shell without a stable session key never inherits another task's selection. */
+export function resolveContextKey(env = process.env) {
+    const value = env.PACTILE_CONTEXT_ID?.trim();
+    return value ? safeContextKey(value) : null;
+}
+function contextFile(root, key) {
+    return path.join(root, ".pactile", ".runtime", "sessions", `${key}.json`);
+}
+function readContext(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+        return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function resolveTaskDir(root, taskRef) {
+    const normalized = taskRef.trim().replaceAll("\\", "/").replace(/^\.\//, "");
+    const tasks = path.resolve(root, ".pactile", "tasks");
+    const insideTasks = (candidate) => {
+        const resolved = path.resolve(candidate);
+        const relative = path.relative(tasks, resolved);
+        if (!relative || relative.startsWith("..") || path.isAbsolute(relative) || relative.split(path.sep).includes("archive")) {
+            throw new Error(`Task reference must name an active task under .pactile/tasks: ${taskRef}`);
+        }
+        if (fs.existsSync(resolved) && fs.existsSync(tasks)) {
+            const realRoot = fs.realpathSync(tasks);
+            const realTask = fs.realpathSync(resolved);
+            const realRelative = path.relative(realRoot, realTask);
+            if (!realRelative || realRelative.startsWith("..") || path.isAbsolute(realRelative)) {
+                throw new Error(`Task reference resolves outside .pactile/tasks: ${taskRef}`);
+            }
+        }
+        return resolved;
+    };
+    if (path.isAbsolute(taskRef))
+        return insideTasks(taskRef);
+    if (normalized.includes("/") || normalized.startsWith(".pactile")) {
+        return insideTasks(path.resolve(root, normalized));
+    }
+    if (fs.existsSync(path.join(tasks, normalized)))
+        return insideTasks(path.join(tasks, normalized));
+    if (fs.existsSync(tasks)) {
+        const match = fs.readdirSync(tasks, { withFileTypes: true })
+            .find((item) => item.isDirectory() && item.name.endsWith(`-${normalized}`));
+        if (match)
+            return insideTasks(path.join(tasks, match.name));
+    }
+    return insideTasks(path.join(tasks, normalized));
+}
+export function resolveSelectedTask(root, env = process.env) {
+    const key = resolveContextKey(env);
+    if (!key)
+        return { taskPath: null, source: "none", contextKey: null, stale: false };
+    const value = readContext(contextFile(root, key)).selected_task;
+    if (typeof value !== "string" || !value.trim()) {
+        return { taskPath: null, source: "none", contextKey: key, stale: false };
+    }
+    return {
+        taskPath: value,
+        source: `session:${key}`,
+        contextKey: key,
+        stale: !fs.statSync(resolveTaskDir(root, value), { throwIfNoEntry: false })?.isDirectory(),
+    };
+}
+export function selectTask(root, taskRef, env = process.env) {
+    const dir = resolveTaskDir(root, taskRef);
+    if (!fs.statSync(dir, { throwIfNoEntry: false })?.isDirectory()) {
+        throw new Error(`Task not found: ${taskRef}`);
+    }
+    const key = resolveContextKey(env);
+    if (!key)
+        throw new Error("session identity not available; set PACTILE_CONTEXT_ID before selecting a task");
+    const file = contextFile(root, key);
+    const prior = readContext(file);
+    const selected = path.relative(root, dir).replaceAll("\\", "/");
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    delete prior.current_task;
+    fs.writeFileSync(file, `${JSON.stringify({
+        ...prior,
+        platform: key.startsWith("codex_") ? "codex" : "session",
+        last_seen_at: new Date().toISOString(),
+        selected_task: selected,
+        current_run: prior.current_run ?? null,
+    }, null, 2)}\n`, "utf8");
+    return { taskPath: selected, source: `session:${key}`, contextKey: key, stale: false };
+}
+export function exitTask(root, env = process.env) {
+    const selected = resolveSelectedTask(root, env);
+    if (selected.contextKey) {
+        fs.rmSync(contextFile(root, selected.contextKey), { force: true });
+    }
+    return selected;
+}
+//# sourceMappingURL=session.js.map

package/dist/pactile/task/session.js.map

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

package/dist/pactile/task/strategy.d.ts

@@ -0,0 +1,2 @@
+export * from "../../core/task/strategy.js";
+//# sourceMappingURL=strategy.d.ts.map

package/dist/pactile/task/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/strategy.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC"}

package/dist/pactile/task/strategy.js

@@ -0,0 +1,3 @@
+// Compatibility import for existing Task callers. Strategy authority lives with Kernel.
+export * from "../../core/task/strategy.js";
+//# sourceMappingURL=strategy.js.map

package/dist/pactile/task/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../src/pactile/task/strategy.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,cAAc,6BAA6B,CAAC"}

package/dist/pactile/task/task-map.d.ts

@@ -0,0 +1,35 @@
+import { type PactileTaskRecord } from "../../core/task/index.js";
+export declare const CHILD_STATES: readonly ["open", "working", "blocked", "review", "changes", "accepted", "integrating", "integrated", "cancelled"];
+export type ChildState = typeof CHILD_STATES[number];
+export interface ChildEntry {
+    id: string;
+    state: ChildState;
+    depends_on: string[];
+    touches: string[];
+    isolation: string;
+    ref: string | null;
+    [key: string]: unknown;
+}
+export interface TaskMap {
+    parent_id: string;
+    contract_epoch: number;
+    execution_topology: string;
+    merge_limit: number;
+    parallel_limit?: number;
+    children: ChildEntry[];
+    stages: Record<string, unknown>[];
+    integration_queue: string[];
+    [key: string]: unknown;
+}
+export declare function readTaskMap(parentDir: string): {
+    data: TaskMap | null;
+    body: string;
+};
+export declare function writeTaskMap(parentDir: string, data: TaskMap, body: string, event?: string): void;
+export declare function ensureTaskMap(parentDir: string, parent: PactileTaskRecord, event?: string): TaskMap;
+export declare function childStateErrors(parentDir: string, parent: PactileTaskRecord, childDir: string, state: ChildState, evidence: string, options?: {
+    ref?: string;
+    reason?: string;
+}): string[];
+export declare function parentArchiveErrors(parentDir: string, parent: PactileTaskRecord): string[];
+//# sourceMappingURL=task-map.d.ts.map

package/dist/pactile/task/task-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-map.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/task-map.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,eAAO,MAAM,YAAY,oHAAqH,CAAC;AAC/I,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiDD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBrF;AA+BD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGjG;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CASnG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,EAAE,CAiC/L;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAwB1F"}