@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/core/task/task-kernel-host.js

@@ -0,0 +1,136 @@
+import { KernelError, requireNonEmptyString } from "./kernel-contract.js";
+import { appendDomainEvent, mutateTaskKernel } from "./task-kernel-store-v2.js";
+import { fingerprintTaskValue, parseHostBinding, parseHostStopReceipt } from "./task-kernel-schema.js";
+function runAt(current, runId) {
+    const index = current.runs.findIndex((item) => item.id === runId);
+    if (index < 0)
+        throw new KernelError("NOT_FOUND", `Run not found: ${runId}`);
+    const run = current.runs[index];
+    if (!run)
+        throw new KernelError("CORRUPT_STATE", `Run is missing: ${runId}`);
+    return { run, index };
+}
+function replaceRun(current, index, run) {
+    return { ...current, runs: current.runs.map((item, i) => i === index ? run : item) };
+}
+export function bindTaskRunHostReceipt(request) {
+    const actor = requireNonEmptyString(request.actor, "actor");
+    const runId = requireNonEmptyString(request.runId, "runId");
+    const requestedHost = parseHostBinding({
+        ...request.host,
+        kernelRevision: request.expectedRevision + 1,
+        contractFingerprint: "0".repeat(64),
+        stopReceipt: null,
+    }, "host");
+    const fingerprint = fingerprintTaskValue({ runId, host: requestedHost });
+    return mutateTaskKernel(request.root, request.taskDir, request.expectedRevision, actor, request.idempotencyKey, fingerprint, request.cwd, (current) => {
+        const { run, index } = runAt(current, runId);
+        if (current.runs.at(-1)?.id !== runId || (run.state !== "running" && run.state !== "waiting")) {
+            throw new KernelError("INVALID_TRANSITION", "Host receipt can only bind to the latest active or waiting Run");
+        }
+        if (run.host)
+            throw new KernelError("INVALID_TRANSITION", "Run host binding is immutable after its first receipt");
+        const host = parseHostBinding({
+            ...requestedHost,
+            kernelRevision: current.revision + 1,
+            contractFingerprint: fingerprintTaskValue(current.definition),
+            stopReceipt: null,
+        }, "host");
+        const next = replaceRun(current, index, { ...run, host });
+        return appendDomainEvent(next, actor, request.idempotencyKey, "run.host-bound", runId, fingerprint);
+    });
+}
+export function appendTaskRunHostSettlementRefs(request) {
+    const actor = requireNonEmptyString(request.actor, "actor");
+    const runId = requireNonEmptyString(request.runId, "runId");
+    const additions = {
+        requestRefs: request.requestRefs ?? [],
+        eventRefs: request.eventRefs ?? [],
+        resultRefs: request.resultRefs ?? [],
+    };
+    const fingerprint = fingerprintTaskValue({ runId, additions });
+    return mutateTaskKernel(request.root, request.taskDir, request.expectedRevision, actor, request.idempotencyKey, fingerprint, request.cwd, (current) => {
+        const { run, index } = runAt(current, runId);
+        if (!run.host)
+            throw new KernelError("INVALID_TRANSITION", "Run has no manager-bound host receipt");
+        if (run.host.stopReceipt)
+            throw new KernelError("INVALID_TRANSITION", "Run host already has a terminal receipt");
+        if (run.state !== "running" && run.state !== "waiting") {
+            throw new KernelError("INVALID_TRANSITION", "Host settlement references must be recorded while the Run is active");
+        }
+        const appendOnly = (existing, added, field) => {
+            if (!Array.isArray(added) || added.some((item) => typeof item !== "string" || !item.trim())) {
+                throw new KernelError("INVALID_REQUEST", `${field} must contain non-empty references`);
+            }
+            return [...new Set([...existing, ...added])];
+        };
+        const host = {
+            ...run.host,
+            requestRefs: appendOnly(run.host.requestRefs, additions.requestRefs, "requestRefs"),
+            eventRefs: appendOnly(run.host.eventRefs, additions.eventRefs, "eventRefs"),
+            resultRefs: appendOnly(run.host.resultRefs, additions.resultRefs, "resultRefs"),
+        };
+        if (host.requestRefs.length === run.host.requestRefs.length
+            && host.eventRefs.length === run.host.eventRefs.length
+            && host.resultRefs.length === run.host.resultRefs.length) {
+            throw new KernelError("INVALID_REQUEST", "Host settlement must append at least one new reference");
+        }
+        const next = replaceRun(current, index, { ...run, host });
+        return appendDomainEvent(next, actor, request.idempotencyKey, "run.host-settlement-recorded", runId, fingerprint);
+    });
+}
+export function recordTaskRunHostStopReceipt(request) {
+    const actor = requireNonEmptyString(request.actor, "actor");
+    const runId = requireNonEmptyString(request.runId, "runId");
+    const receipt = parseHostStopReceipt(request.receipt, "hostStopReceipt");
+    const fingerprint = fingerprintTaskValue({ runId, receipt });
+    return mutateTaskKernel(request.root, request.taskDir, request.expectedRevision, actor, request.idempotencyKey, fingerprint, request.cwd, (current) => {
+        const { run, index } = runAt(current, runId);
+        const host = run.host;
+        if (!host)
+            throw new KernelError("INVALID_TRANSITION", "Run has no manager-bound host receipt");
+        if (run.state === "running" || run.state === "waiting")
+            throw new KernelError("INVALID_TRANSITION", "Run host stop receipt requires a terminal Run");
+        if (receipt.taskId !== current.identity.taskId || receipt.runId !== run.id
+            || receipt.sessionId !== host.sessionId || receipt.threadId !== host.threadId
+            || receipt.contractFingerprint !== host.contractFingerprint
+            || receipt.contractFingerprint !== fingerprintTaskValue(current.definition)
+            || receipt.contractStale || receipt.receiptKernelRevision > current.revision) {
+            throw new KernelError("INVALID_REQUEST", "Host stop receipt does not match this Task, Run, binding, or current contract");
+        }
+        if (!host.requestRefs.includes(receipt.startRequestId)
+            || !host.eventRefs.includes(receipt.settleReceiptId)
+            || (!host.resultRefs.includes(receipt.evidenceRef) && !host.resultRefs.includes(receipt.receiptRef))) {
+            throw new KernelError("INVALID_REQUEST", "Host stop receipt references were not durably bound to the Run");
+        }
+        const codex = host.host === "codex-desktop" && receipt.source === "codex-desktop-bridge"
+            && receipt.assurance === "host-reported" && receipt.evidenceLevel === "desktop-native"
+            && receipt.terminalStatus === "completed";
+        const pi = host.host === "pi" && receipt.source === "pactile-pi-rpc"
+            && receipt.assurance === "manager-owned-child-exit"
+            && (receipt.terminalStatus === "exited" || receipt.terminalStatus === "cancelled");
+        if (!codex && !pi)
+            throw new KernelError("INVALID_REQUEST", "Host stop receipt source or terminal state is not supported for this Run binding");
+        const candidate = run.candidateSnapshot;
+        if (candidate) {
+            if (receipt.candidateSnapshotId !== candidate.id || receipt.candidateFingerprint !== candidate.fingerprint) {
+                throw new KernelError("INVALID_REQUEST", "Host stop receipt candidate does not match the current Run candidate");
+            }
+            if (receipt.candidateSource !== "captured" && receipt.candidateSource !== "derived") {
+                throw new KernelError("INVALID_REQUEST", "A Run candidate requires captured or derived stop-receipt provenance");
+            }
+        }
+        else if (receipt.candidateSnapshotId !== null || receipt.candidateFingerprint !== null) {
+            throw new KernelError("INVALID_REQUEST", "Host stop receipt cannot cite a candidate absent from the Run");
+        }
+        else if (receipt.candidateSource !== null) {
+            throw new KernelError("INVALID_REQUEST", "A stop receipt without a Run candidate cannot claim candidate provenance");
+        }
+        if (host.stopReceipt)
+            throw new KernelError("INVALID_TRANSITION", "Run host stop receipt is immutable once recorded");
+        const nextHost = { ...host, stopReceipt: receipt };
+        const next = replaceRun(current, index, { ...run, host: nextHost });
+        return appendDomainEvent(next, actor, request.idempotencyKey, "run.host-settled", runId, fingerprint);
+    });
+}
+//# sourceMappingURL=task-kernel-host.js.map

package/dist/core/task/task-kernel-host.js.map

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

package/dist/core/task/task-kernel-paths.d.ts

@@ -0,0 +1,19 @@
+import { type LegacyTaskMigrationView } from "./legacy-task-migration-reader.js";
+export declare function assertUniqueTaskId(root: string, taskId: string, ignoredDir: string): void;
+/** Internal reconciliation seam for a reader-validated migration snapshot. */
+export declare function assertUniqueTaskIdWithValidatedMigrationView(root: string, taskId: string, ignoredDir: string, migrationView: LegacyTaskMigrationView): void;
+/** Internal batch target probe; the batch validates its own staged authority separately. */
+export declare function assertUniqueTaskIdForLegacyBatchTarget(root: string, taskId: string, ignoredDir: string): void;
+export declare function assertDependenciesResolvable(root: string, taskId: string, dependencies: readonly string[], ignoredDir?: string): void;
+export declare function assertNoDependencyCycle(root: string, taskId: string, dependencies: readonly string[], ignoredDir: string): string;
+/** Internal reconciliation seam for a reader-validated migration snapshot. */
+export declare function assertNoDependencyCycleWithValidatedMigrationView(root: string, taskId: string, dependencies: readonly string[], ignoredDir: string, migrationView: LegacyTaskMigrationView): string;
+export declare function assertHardDependenciesSatisfied(root: string, dependencies: readonly string[], ignoredDir?: string): void;
+/** Resolves a Task ID across active and archived records for read-only evidence checks. */
+export declare function resolveTaskDirectoryById(root: string, taskId: string): string | null;
+/** Internal reconciliation seam for a reader-validated migration snapshot. */
+export declare function resolveTaskDirectoryByIdWithValidatedMigrationView(root: string, taskId: string, migrationView: LegacyTaskMigrationView): string | null;
+export declare function resolveInsideTasksRoot(root: string, taskDir: string, cwd?: string): string;
+export declare function resolveInsideTaskRoot(root: string, taskDir: string, cwd?: string): string;
+export declare function canonicalProjectRoot(root: string, cwd?: string): string;
+//# sourceMappingURL=task-kernel-paths.d.ts.map

package/dist/core/task/task-kernel-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-kernel-paths.d.ts","sourceRoot":"","sources":["../../../src/core/task/task-kernel-paths.ts"],"names":[],"mappings":"AAOA,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,mCAAmC,CAAC;AAI3C,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN;AAED,8EAA8E;AAC9E,wBAAgB,4CAA4C,CAC1D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,uBAAuB,GACrC,IAAI,CAIN;AAED,4FAA4F;AAC5F,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAOrI;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR;AAED,8EAA8E;AAC9E,wBAAgB,iDAAiD,CAC/D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,uBAAuB,GACrC,MAAM,CAGR;AAmCD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAQxH;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAIf;AAED,8EAA8E;AAC9E,wBAAgB,kDAAkD,CAChE,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,uBAAuB,GACrC,MAAM,GAAG,IAAI,CAIf;AAiFD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAa1F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQzF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvE"}

package/dist/core/task/task-kernel-paths.js

@@ -0,0 +1,237 @@
+import fs from "node:fs";
+import path from "node:path";
+import { KernelError, requireNonEmptyString } from "./kernel-contract.js";
+import { readKernel, readKernelStateDocument, withKernelStateLock } from "./kernel-store.js";
+import { isPlainObject } from "./schema.js";
+import { parseTaskKernelSnapshotV2 } from "./task-kernel-schema.js";
+import { listLegacyTaskMigrationDirectories, listSupersededLegacyTaskSourceDirectories, assertValidatedLegacyTaskMigrationView, readLegacyTaskImportRecord, readLegacyTaskMigrationView, } from "./legacy-task-migration-reader.js";
+import { readTaskKernelWithValidatedMigrationView } from "./task-kernel-store-v2.js";
+import { TASK_KERNEL_SCHEMA_VERSION } from "./task-kernel-types.js";
+export function assertUniqueTaskId(root, taskId, ignoredDir) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const match = findTaskById(canonicalRoot, taskId, ignoredDir, readMigrationView(canonicalRoot));
+    if (match && path.resolve(match.taskDir) !== path.resolve(ignoredDir))
+        throw new KernelError("INVALID_REQUEST", `Task ID already exists: ${taskId}`);
+}
+/** Internal reconciliation seam for a reader-validated migration snapshot. */
+export function assertUniqueTaskIdWithValidatedMigrationView(root, taskId, ignoredDir, migrationView) {
+    assertValidatedView(migrationView);
+    const match = findTaskById(root, taskId, ignoredDir, migrationView);
+    if (match && path.resolve(match.taskDir) !== path.resolve(ignoredDir))
+        throw new KernelError("INVALID_REQUEST", `Task ID already exists: ${taskId}`);
+}
+/** Internal batch target probe; the batch validates its own staged authority separately. */
+export function assertUniqueTaskIdForLegacyBatchTarget(root, taskId, ignoredDir) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const match = findTaskById(canonicalRoot, taskId, ignoredDir, null);
+    if (match && path.resolve(match.taskDir) !== path.resolve(ignoredDir))
+        throw new KernelError("INVALID_REQUEST", `Task ID already exists: ${taskId}`);
+}
+export function assertDependenciesResolvable(root, taskId, dependencies, ignoredDir) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const migrationView = readMigrationView(canonicalRoot);
+    for (const dependency of dependencies) {
+        if (dependency === taskId)
+            throw new KernelError("INVALID_REQUEST", "a Task cannot depend on itself");
+        if (!findTaskById(canonicalRoot, dependency, ignoredDir, migrationView))
+            throw new KernelError("DEPENDENCY_UNSATISFIED", `hard dependency not found: ${dependency}`);
+    }
+}
+export function assertNoDependencyCycle(root, taskId, dependencies, ignoredDir) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const migrationView = readMigrationView(canonicalRoot);
+    return assertNoDependencyCycleUsingView(canonicalRoot, taskId, dependencies, ignoredDir, migrationView);
+}
+/** Internal reconciliation seam for a reader-validated migration snapshot. */
+export function assertNoDependencyCycleWithValidatedMigrationView(root, taskId, dependencies, ignoredDir, migrationView) {
+    assertValidatedView(migrationView);
+    return assertNoDependencyCycleUsingView(root, taskId, dependencies, ignoredDir, migrationView);
+}
+function assertNoDependencyCycleUsingView(canonicalRoot, taskId, dependencies, ignoredDir, migrationView) {
+    const visiting = new Set();
+    const visited = new Set();
+    const graph = new Map();
+    const visit = (currentId) => {
+        if (currentId === taskId)
+            throw new KernelError("INVALID_REQUEST", `hard dependency cycle reaches ${taskId}`);
+        if (visited.has(currentId) || visiting.has(currentId))
+            return;
+        visiting.add(currentId);
+        const located = findTaskById(canonicalRoot, currentId, ignoredDir, migrationView);
+        graph.set(currentId, {
+            taskDir: located ? path.resolve(located.taskDir) : null,
+            dependencies: located ? [...new Set(located.dependencies)].sort() : [],
+        });
+        if (located && path.resolve(located.taskDir) !== path.resolve(ignoredDir)) {
+            for (const dependency of located.dependencies)
+                visit(dependency);
+        }
+        visiting.delete(currentId);
+        visited.add(currentId);
+    };
+    for (const dependency of dependencies)
+        visit(dependency);
+    return JSON.stringify([...graph.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([id, node]) => ({ id, ...node })));
+}
+export function assertHardDependenciesSatisfied(root, dependencies, ignoredDir) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const migrationView = readMigrationView(canonicalRoot);
+    const unmet = dependencies.filter((id) => {
+        const task = findTaskById(canonicalRoot, id, ignoredDir, migrationView);
+        return task?.phase !== "close" || task.outcome !== "completed";
+    });
+    if (unmet.length)
+        throw new KernelError("DEPENDENCY_UNSATISFIED", `hard dependencies must be closed successfully: ${unmet.join(", ")}`);
+}
+/** Resolves a Task ID across active and archived records for read-only evidence checks. */
+export function resolveTaskDirectoryById(root, taskId) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const located = findTaskById(canonicalRoot, requireNonEmptyString(taskId, "taskId"), undefined, readMigrationView(canonicalRoot));
+    return located?.taskDir ?? null;
+}
+/** Internal reconciliation seam for a reader-validated migration snapshot. */
+export function resolveTaskDirectoryByIdWithValidatedMigrationView(root, taskId, migrationView) {
+    assertValidatedView(migrationView);
+    const located = findTaskById(root, requireNonEmptyString(taskId, "taskId"), undefined, migrationView);
+    return located?.taskDir ?? null;
+}
+function findTaskById(root, taskId, ignoredDir, migrationView) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const supersededSources = new Set(listSupersededLegacyTaskSourceDirectories(canonicalRoot, migrationView));
+    const matches = enumerateTaskDirs(canonicalRoot, migrationView).flatMap((taskDir) => {
+        if (ignoredDir && path.resolve(taskDir) === path.resolve(ignoredDir))
+            return [];
+        if (supersededSources.has(path.resolve(taskDir)))
+            return [];
+        const importRecord = readLegacyTaskImportRecord(canonicalRoot, taskDir, migrationView);
+        if (importRecord) {
+            if (importRecord.status !== "imported") {
+                if (importRecord.legacyTaskId !== taskId)
+                    return [];
+                return [{
+                        taskDir,
+                        taskId,
+                        phase: "define",
+                        outcome: null,
+                        dependencies: [...importRecord.dependencyFacts.hardDependencies],
+                    }];
+            }
+            try {
+                if (!migrationView)
+                    throw new KernelError("CORRUPT_STATE", "legacy-task-migration-view-missing");
+                const read = readTaskKernelWithValidatedMigrationView({ root: canonicalRoot, taskDir }, migrationView);
+                if (read.kind === "task-kernel-v2" && read.kernel.identity.taskId === taskId) {
+                    return [{ taskDir, taskId, phase: read.kernel.phase, outcome: read.kernel.outcome, dependencies: read.kernel.definition.dependencies }];
+                }
+            }
+            catch {
+                if (importRecord.legacyTaskId === taskId)
+                    return [{ taskDir, taskId, phase: "define", outcome: null, dependencies: [...importRecord.dependencyFacts.hardDependencies] }];
+            }
+            return [];
+        }
+        try {
+            const document = withKernelStateLock(taskDir, undefined, (dir) => readKernelStateDocument(dir));
+            if (isPlainObject(document) && document.schemaVersion === TASK_KERNEL_SCHEMA_VERSION) {
+                const kernel = parseTaskKernelSnapshotV2(document);
+                return kernel.identity.taskId === taskId ? [{ taskDir, taskId, phase: kernel.phase, outcome: kernel.outcome, dependencies: kernel.definition.dependencies }] : [];
+            }
+            const legacy = readKernel({ taskDir });
+            if (legacy.legacy.id !== taskId)
+                return [];
+            const rawExtras = legacy.kernel.projection?.extras ?? {};
+            return [{ taskDir, taskId, phase: legacy.kernel.phase, outcome: legacy.kernel.outcome, dependencies: Array.isArray(rawExtras.depends_on) ? rawExtras.depends_on.filter((value) => typeof value === "string") : [] }];
+        }
+        catch {
+            return [];
+        }
+    });
+    if (matches.length > 1)
+        throw new KernelError("INVALID_REQUEST", `Task ID is ambiguous across active and archived records: ${taskId}`);
+    return matches[0] ?? null;
+}
+function enumerateTaskDirs(root, migrationView) {
+    const canonicalRoot = canonicalProjectRoot(root);
+    const tasksRoot = path.resolve(canonicalRoot, ".pactile", "tasks");
+    const result = [];
+    if (fs.existsSync(tasksRoot)) {
+        for (const entry of fs.readdirSync(tasksRoot, { withFileTypes: true })) {
+            if (!entry.isDirectory() || ["archive", "locale", "templates"].includes(entry.name))
+                continue;
+            result.push(path.join(tasksRoot, entry.name));
+        }
+        const archive = path.join(tasksRoot, "archive");
+        if (fs.existsSync(archive))
+            for (const month of fs.readdirSync(archive, { withFileTypes: true })) {
+                if (!month.isDirectory())
+                    continue;
+                const monthDir = path.join(archive, month.name);
+                for (const entry of fs.readdirSync(monthDir, { withFileTypes: true }))
+                    if (entry.isDirectory())
+                        result.push(path.join(monthDir, entry.name));
+            }
+    }
+    result.push(...listLegacyTaskMigrationDirectories(root, migrationView));
+    return [...new Set(result)];
+}
+export function resolveInsideTasksRoot(root, taskDir, cwd) {
+    const base = cwd ?? process.cwd();
+    const canonicalRoot = canonicalProjectRoot(root, cwd);
+    const tasksRoot = path.resolve(canonicalRoot, ".pactile", "tasks");
+    if (fs.existsSync(tasksRoot) && fs.realpathSync(tasksRoot) !== tasksRoot) {
+        throw new KernelError("INVALID_REQUEST", "project .pactile/tasks must resolve inside the canonical project root");
+    }
+    const candidate = canonicalizePath(path.resolve(base, taskDir));
+    const relative = path.relative(tasksRoot, candidate);
+    if (!relative || relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new KernelError("INVALID_REQUEST", "Task path must belong to the supplied project's .pactile/tasks tree");
+    }
+    return candidate;
+}
+export function resolveInsideTaskRoot(root, taskDir, cwd) {
+    const candidate = resolveInsideTasksRoot(root, taskDir, cwd);
+    const canonicalRoot = canonicalProjectRoot(root, cwd);
+    const relative = path.relative(path.resolve(canonicalRoot, ".pactile", "tasks"), candidate);
+    if (relative.split(path.sep).includes("archive")) {
+        throw new KernelError("INVALID_REQUEST", "new Task Kernel mutations must target active .pactile/tasks records");
+    }
+    return candidate;
+}
+export function canonicalProjectRoot(root, cwd) {
+    const canonicalRoot = canonicalizePath(path.resolve(cwd ?? process.cwd(), requireNonEmptyString(root, "root")));
+    if (fs.existsSync(canonicalRoot) && !fs.statSync(canonicalRoot).isDirectory()) {
+        throw new KernelError("INVALID_REQUEST", "project root must be a directory");
+    }
+    return canonicalRoot;
+}
+function readMigrationView(root) {
+    try {
+        return readLegacyTaskMigrationView(root);
+    }
+    catch (error) {
+        throw new KernelError("CORRUPT_STATE", error instanceof Error ? error.message : String(error));
+    }
+}
+function assertValidatedView(migrationView) {
+    try {
+        assertValidatedLegacyTaskMigrationView(migrationView);
+    }
+    catch (error) {
+        throw new KernelError("CORRUPT_STATE", error instanceof Error ? error.message : String(error));
+    }
+}
+function canonicalizePath(candidate) {
+    let existing = candidate;
+    const suffix = [];
+    while (!fs.existsSync(existing)) {
+        const parent = path.dirname(existing);
+        if (parent === existing)
+            return candidate;
+        suffix.unshift(path.basename(existing));
+        existing = parent;
+    }
+    return path.resolve(fs.realpathSync(existing), ...suffix);
+}
+//# sourceMappingURL=task-kernel-paths.js.map

package/dist/core/task/task-kernel-paths.js.map

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

package/dist/core/task/task-kernel-reviews.d.ts

@@ -0,0 +1,3 @@
+import type { RecordTaskReviewRequest, TaskKernelMutationResult } from "./task-kernel-types.js";
+export declare function recordTaskReview(request: RecordTaskReviewRequest): TaskKernelMutationResult;
+//# sourceMappingURL=task-kernel-reviews.d.ts.map

package/dist/core/task/task-kernel-reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-kernel-reviews.d.ts","sourceRoot":"","sources":["../../../src/core/task/task-kernel-reviews.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,wBAAwB,CAAC;AAGhC,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,wBAAwB,CA0J1B"}

package/dist/core/task/task-kernel-reviews.js

@@ -0,0 +1,100 @@
+import { randomUUID } from "node:crypto";
+import { KernelError, requireNonEmptyString, } from "./kernel-contract.js";
+import { appendDomainEvent, mutateTaskKernel } from "./task-kernel-store-v2.js";
+import { fingerprintTaskValue, parseAcceptanceEvidence, parseMeasurementRefs, parseStringArray, REVIEW_DECISIONS, } from "./task-kernel-schema.js";
+import { canonicalProjectRoot } from "./task-kernel-paths.js";
+import { resolveTaskReviewEvidenceV1 } from "./task-review-evidence.js";
+export function recordTaskReview(request) {
+    const root = canonicalProjectRoot(request.root, request.cwd);
+    const actor = requireNonEmptyString(request.actor, "actor");
+    const fingerprint = fingerprintTaskValue({
+        runId: request.runId,
+        candidateSnapshotId: request.candidateSnapshotId,
+        candidateFingerprint: request.candidateFingerprint,
+        reviewer: request.reviewer,
+        reviewId: request.reviewId ?? null,
+        decision: request.decision,
+        evidenceRefs: request.evidenceRefs,
+        acceptanceEvidence: request.acceptanceEvidence ?? {},
+        unresolvedBlockers: request.unresolvedBlockers ?? [],
+        measurementRef: request.measurementRef ?? null,
+    });
+    return mutateTaskKernel(root, request.taskDir, request.expectedRevision, actor, request.idempotencyKey, fingerprint, request.cwd, (current) => {
+        if (current.phase !== "verify")
+            throw new KernelError("INVALID_TRANSITION", `Review requires Verify phase, got ${current.phase}`);
+        const runIndex = current.runs.findIndex((candidate) => candidate.id === request.runId);
+        const run = current.runs[runIndex];
+        if (run?.state !== "completed" ||
+            !run.candidateSnapshot ||
+            current.runs.at(-1)?.id !== run.id)
+            throw new KernelError("INVALID_TRANSITION", "Review requires the latest completed Run with a candidate snapshot");
+        if (request.candidateSnapshotId !== run.candidateSnapshot.id ||
+            request.candidateFingerprint !== run.candidateSnapshot.fingerprint)
+            throw new KernelError("CANDIDATE_MISMATCH", "Review candidate snapshot ID and fingerprint must match the Run snapshot");
+        const reviewer = requireNonEmptyString(request.reviewer, "reviewer");
+        const reviewId = request.reviewId === undefined
+            ? randomUUID()
+            : requireNonEmptyString(request.reviewId, "reviewId");
+        if (reviewId.length > 128) {
+            throw new KernelError("INVALID_REQUEST", "reviewId cannot exceed 128 characters");
+        }
+        if (current.reviews.some((item) => item.id === reviewId)) {
+            throw new KernelError("INVALID_REQUEST", `Review ID already exists: ${reviewId}`);
+        }
+        if (reviewer !== actor)
+            throw new KernelError("REVIEW_NOT_INDEPENDENT", "the Review actor must match the recorded reviewer");
+        if (reviewer === run.startedBy ||
+            reviewer === run.authorization.approvedBy)
+            throw new KernelError("REVIEW_NOT_INDEPENDENT", "Review must be performed by someone other than the Run executor and approver");
+        if (!REVIEW_DECISIONS.includes(request.decision))
+            throw new KernelError("INVALID_REQUEST", "Review decision must be pass, fail, or needs-changes");
+        const evidenceRefs = parseStringArray(request.evidenceRefs, "evidenceRefs");
+        const acceptanceEvidence = parseAcceptanceEvidence(request.acceptanceEvidence ?? {}, current.definition.acceptanceCriteria, request.decision === "pass");
+        const unresolvedBlockers = parseStringArray(request.unresolvedBlockers ?? [], "unresolvedBlockers", true);
+        if (request.decision === "pass" && unresolvedBlockers.length)
+            throw new KernelError("TASK_GATE_UNSATISFIED", "a passing Review cannot have unresolved blockers");
+        const reviewEvidenceRefs = [
+            ...new Set([
+                ...evidenceRefs,
+                ...Object.values(acceptanceEvidence).flat(),
+            ]),
+        ];
+        const evidenceVerification = resolveTaskReviewEvidenceV1({
+            root,
+            taskDir: request.taskDir,
+            cwd: request.cwd,
+            run,
+            candidateSnapshotId: run.candidateSnapshot.id,
+            candidateFingerprint: run.candidateSnapshot.fingerprint,
+            evidenceRefs: reviewEvidenceRefs,
+        });
+        const review = {
+            id: reviewId,
+            taskId: current.identity.taskId,
+            runId: run.id,
+            candidateSnapshotId: run.candidateSnapshot.id,
+            candidateFingerprint: run.candidateSnapshot.fingerprint,
+            reviewer,
+            independent: true,
+            decision: request.decision,
+            evidenceRefs,
+            acceptanceEvidence,
+            evidenceVerification,
+            unresolvedBlockers,
+            reviewedAt: new Date().toISOString(),
+        };
+        const condition = request.decision === "pass" ? "ready" : "blocked";
+        const measurementRefs = parseMeasurementRefs({
+            ...run.measurementRefs,
+            ...(request.measurementRef ? { review: request.measurementRef } : {}),
+        }, "measurementRefs");
+        const kernel = {
+            ...current,
+            condition,
+            runs: current.runs.map((item, index) => index === runIndex ? { ...run, measurementRefs } : item),
+            reviews: [...current.reviews, review],
+        };
+        return appendDomainEvent(kernel, actor, request.idempotencyKey, "review.recorded", review.id, fingerprint);
+    });
+}
+//# sourceMappingURL=task-kernel-reviews.js.map

package/dist/core/task/task-kernel-reviews.js.map

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

package/dist/core/task/task-kernel-runs.d.ts

@@ -0,0 +1,5 @@
+import type { RecordTaskRunResultRequest, ResumeTaskRunRequest, StartTaskRunRequest, TaskKernelMutationResult } from "./task-kernel-types.js";
+export declare function startTaskRun(request: StartTaskRunRequest): TaskKernelMutationResult;
+export declare function resumeTaskRun(request: ResumeTaskRunRequest): TaskKernelMutationResult;
+export declare function recordTaskRunResult(request: RecordTaskRunResultRequest): TaskKernelMutationResult;
+//# sourceMappingURL=task-kernel-runs.d.ts.map

package/dist/core/task/task-kernel-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-kernel-runs.d.ts","sourceRoot":"","sources":["../../../src/core/task/task-kernel-runs.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EAGzB,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,wBAAwB,CA+CnF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,wBAAwB,CAerF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,wBAAwB,CA0HjG"}