@planweave-ai/runtime 0.1.0

package/dist/taskManager/blockSubmission.js

@@ -0,0 +1,124 @@
+import { createHash } from "node:crypto";
+import { copyFile, mkdir, readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseBlockRef } from "../graph/compileTaskGraph.js";
+import { readJsonFile, writeJsonFile } from "../json.js";
+import { writeState } from "../state.js";
+import { exists, loadRuntime, refreshDerivedState } from "./runtimeContext.js";
+import { getBlock } from "./selectors.js";
+import { incrementTaskIndexCount, listDirCount, nextId, readTaskIndex, updateTaskIndex } from "./resultIndex.js";
+async function fileHash(path) {
+    return createHash("sha256").update(await readFile(path)).digest("hex");
+}
+async function runHasSubmittedResult(runDir, ref, runId, reportHash) {
+    const metadataPath = join(runDir, "metadata.json");
+    const reportPath = join(runDir, "report.md");
+    if (!(await exists(metadataPath)) || !(await exists(reportPath))) {
+        return false;
+    }
+    const metadata = await readJsonFile(metadataPath);
+    if (metadata.ref !== ref || metadata.runId !== runId) {
+        return false;
+    }
+    if (!reportHash) {
+        return true;
+    }
+    if (metadata.reportHash === reportHash) {
+        return true;
+    }
+    return (await fileHash(reportPath)) === reportHash;
+}
+async function findPersistedRun(workspace, taskId, blockId, ref, reportHash) {
+    const runRoot = join(workspace.resultsDir, taskId, "blocks", blockId, "runs");
+    const index = await readTaskIndex(workspace, taskId);
+    const indexedRunId = index.latestRunByBlock?.[ref];
+    if (indexedRunId && (await runHasSubmittedResult(join(runRoot, indexedRunId), ref, indexedRunId, reportHash))) {
+        return indexedRunId;
+    }
+    let entries;
+    try {
+        entries = await readdir(runRoot, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+    const runIds = entries
+        .filter((entry) => entry.isDirectory() && /^RUN-\d+$/.test(entry.name))
+        .map((entry) => entry.name)
+        .sort()
+        .reverse();
+    for (const runId of runIds) {
+        if (await runHasSubmittedResult(join(runRoot, runId), ref, runId, reportHash)) {
+            return runId;
+        }
+    }
+    return null;
+}
+export async function submitBlockResult(options) {
+    const context = await loadRuntime(options);
+    const { workspace, manifest, graph } = context;
+    let { state } = context;
+    const { taskId, blockId } = parseBlockRef(options.ref);
+    const block = getBlock(graph, options.ref);
+    if (block.type === "review") {
+        throw new Error("submit-result only accepts implementation blocks.");
+    }
+    const reportHash = await fileHash(options.reportPath);
+    const inProgress = state.blocks[options.ref]?.status === "in_progress";
+    const persistedRunId = (await findPersistedRun(workspace, taskId, blockId, options.ref, reportHash)) ??
+        (inProgress ? await findPersistedRun(workspace, taskId, blockId, options.ref) : null);
+    if (persistedRunId) {
+        await updateTaskIndex(workspace, taskId, (index) => ({
+            ...index,
+            latestRunByBlock: {
+                ...(index.latestRunByBlock ?? {}),
+                [options.ref]: persistedRunId
+            }
+        }));
+        state.blocks[options.ref] = { ...state.blocks[options.ref], status: "completed", lastRunId: persistedRunId };
+        state.currentRefs = state.currentRefs.filter((ref) => ref !== options.ref);
+        state = refreshDerivedState(manifest, state);
+        await writeState(workspace.stateFile, state);
+        return { ref: options.ref, runId: persistedRunId, status: "completed" };
+    }
+    if (!inProgress) {
+        throw new Error(`Block '${options.ref}' must be in_progress before submit-result.`);
+    }
+    const runRoot = join(workspace.resultsDir, taskId, "blocks", blockId, "runs");
+    const runId = options.runId ?? nextId("RUN", await listDirCount(runRoot));
+    const runDir = join(runRoot, runId);
+    const reportDestination = join(runDir, "report.md");
+    const metadataPath = join(runDir, "metadata.json");
+    await mkdir(runDir, { recursive: true });
+    if (options.reportPath !== reportDestination) {
+        await copyFile(options.reportPath, reportDestination);
+    }
+    const previousMetadata = (await exists(metadataPath)) ? await readJsonFile(metadataPath) : {};
+    await writeJsonFile(metadataPath, {
+        ...previousMetadata,
+        ref: options.ref,
+        taskId,
+        blockId,
+        runId,
+        submittedAt: new Date().toISOString(),
+        reportHash,
+        sourceReportPath: options.reportPath
+    });
+    await updateTaskIndex(workspace, taskId, (index) => ({
+        ...index,
+        latestRunByBlock: {
+            ...(index.latestRunByBlock ?? {}),
+            [options.ref]: runId
+        },
+        counts: incrementTaskIndexCount(index, "runs")
+    }));
+    state.blocks[options.ref] = { ...state.blocks[options.ref], status: "completed", lastRunId: runId };
+    state.currentRefs = state.currentRefs.filter((ref) => ref !== options.ref);
+    state = refreshDerivedState(manifest, state);
+    await writeState(workspace.stateFile, state);
+    return { ref: options.ref, runId, status: "completed" };
+}
+//# sourceMappingURL=blockSubmission.js.map

package/dist/taskManager/blockSubmission.js.map

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

package/dist/taskManager/claimScheduler.d.ts

@@ -0,0 +1,26 @@
+import type { BlockType, ClaimResult, ClaimScope, ExecutionGraphSession, PackageWorkspaceRef } from "../types.js";
+export declare function claimNext(options: {
+    projectRoot: PackageWorkspaceRef;
+    parallel?: boolean;
+    blockType?: BlockType;
+    dryRun?: boolean;
+    scope?: ClaimScope;
+    session?: ExecutionGraphSession;
+}): Promise<ClaimResult>;
+export declare function claimBlock(options: {
+    projectRoot: PackageWorkspaceRef;
+    ref: string;
+    dispatch?: boolean;
+    session?: ExecutionGraphSession;
+}): Promise<ClaimResult>;
+export declare function claimTask(options: {
+    projectRoot: PackageWorkspaceRef;
+    taskId: string;
+    session?: ExecutionGraphSession;
+}): Promise<ClaimResult>;
+export declare function claimBlockType(options: {
+    projectRoot: PackageWorkspaceRef;
+    blockType: BlockType;
+    session?: ExecutionGraphSession;
+}): Promise<ClaimResult>;
+//# sourceMappingURL=claimScheduler.d.ts.map

package/dist/taskManager/claimScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimScheduler.d.ts","sourceRoot":"","sources":["../../src/taskManager/claimScheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA0BlH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,CAAC,CA6PvB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,mBAAmB,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBvB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,WAAW,EAAE,mBAAmB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,CAAC,CAEvB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,CAAC,CAEvB"}

package/dist/taskManager/claimScheduler.js

@@ -0,0 +1,286 @@
+import { writeState } from "../state.js";
+import { patchFeedbackArtifact } from "./feedbackArtifacts.js";
+import { updateTaskIndex } from "./resultIndex.js";
+import { loadRuntime, refreshDerivedState } from "./runtimeContext.js";
+import { activeOpenFeedback, blockDependenciesCompleted, blockInScope, canDispatchImplementationBlock, canClaimReviewBlock, claimResultForBlock, feedbackInScope, markClaimed, normalizeClaimScope, taskDependenciesSatisfied, validateClaimScope } from "./selectors.js";
+function withCurrentRef(currentRefs, ref) {
+    return currentRefs.includes(ref) ? currentRefs : [...currentRefs, ref];
+}
+function withoutCurrentRef(currentRefs, ref) {
+    return currentRefs.filter((currentRef) => currentRef !== ref);
+}
+export async function claimNext(options) {
+    const context = await loadRuntime(options);
+    let { state } = context;
+    const { graph, manifest, workspace } = context;
+    const scope = normalizeClaimScope(options.scope);
+    const blockType = options.blockType;
+    const dryRun = options.dryRun === true;
+    const invalidScope = validateClaimScope(scope, graph);
+    if (invalidScope) {
+        return invalidScope;
+    }
+    const openFeedback = activeOpenFeedback(state);
+    if (openFeedback.length > 1) {
+        return { kind: "blocked", reason: "Multiple open feedback envelopes exist; resolve or dismiss one before continuing." };
+    }
+    if (openFeedback.length === 1) {
+        const [feedbackId, feedback] = openFeedback[0];
+        if (!feedbackInScope(feedback, graph, scope)) {
+            return { kind: "none", reason: "no_claimable_blocks_in_scope" };
+        }
+        const taskId = graph.blockTaskByRef.get(feedback.sourceReviewBlockRef);
+        if (!taskId) {
+            throw new Error(`Feedback '${feedbackId}' points to an unknown review block.`);
+        }
+        if (dryRun) {
+            return { kind: "feedback", content: feedback.content };
+        }
+        await patchFeedbackArtifact(workspace, taskId, feedbackId, { status: "in_progress" });
+        await updateTaskIndex(workspace, taskId, (index) => ({
+            ...index,
+            feedbackStatusById: {
+                ...(index.feedbackStatusById ?? {}),
+                [feedbackId]: "in_progress"
+            }
+        }));
+        feedback.status = "in_progress";
+        state.currentFeedbackId = feedbackId;
+        state.currentReviewBlockRef = feedback.sourceReviewBlockRef;
+        state.currentRefs = withoutCurrentRef(state.currentRefs, feedback.sourceReviewBlockRef);
+        state = refreshDerivedState(manifest, state);
+        await writeState(workspace.stateFile, state);
+        return { kind: "feedback", content: feedback.content };
+    }
+    const inProgressReview = graph.blockRefsInManifestOrder.find((ref) => {
+        const block = graph.blocksByRef.get(ref);
+        return block?.type === "review" && state.blocks[ref]?.status === "in_progress";
+    });
+    if (inProgressReview && state.currentFeedbackId) {
+        if (blockType && blockType !== "review") {
+            return { kind: "blocked", ref: inProgressReview, reason: "A review block is in progress outside the selected claim type." };
+        }
+        const currentFeedback = state.feedback[state.currentFeedbackId];
+        if (currentFeedback?.status === "resolved") {
+            if (!blockInScope(inProgressReview, graph, scope)) {
+                return { kind: "blocked", ref: inProgressReview, reason: "A review block is in progress outside the selected Auto Run scope." };
+            }
+            if (dryRun) {
+                return claimResultForBlock(inProgressReview, graph, "feedback_resolved");
+            }
+            state.blocks[inProgressReview] = { ...state.blocks[inProgressReview], pendingFeedbackId: null };
+            state.currentRefs = withCurrentRef(state.currentRefs, inProgressReview);
+            state.currentFeedbackId = null;
+            state.currentReviewBlockRef = inProgressReview;
+            await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+            return claimResultForBlock(inProgressReview, graph, "feedback_resolved");
+        }
+    }
+    if (inProgressReview) {
+        if (blockType && blockType !== "review") {
+            return { kind: "blocked", ref: inProgressReview, reason: "A review block is in progress outside the selected claim type." };
+        }
+        if (!blockInScope(inProgressReview, graph, scope)) {
+            return { kind: "blocked", ref: inProgressReview, reason: "A review block is in progress outside the selected Auto Run scope." };
+        }
+        const reason = state.blocks[inProgressReview]?.pendingFeedbackId ? "feedback_resolved" : "current";
+        if (dryRun) {
+            return claimResultForBlock(inProgressReview, graph, reason);
+        }
+        state.blocks[inProgressReview] = { ...state.blocks[inProgressReview], pendingFeedbackId: null };
+        state.currentRefs = withCurrentRef(state.currentRefs, inProgressReview);
+        state.currentReviewBlockRef = inProgressReview;
+        await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+        return claimResultForBlock(inProgressReview, graph, reason);
+    }
+    const current = graph.blockRefsInManifestOrder.find((ref) => {
+        const block = graph.blocksByRef.get(ref);
+        return state.blocks[ref]?.status === "in_progress" && block?.type !== "review";
+    });
+    if (current) {
+        const currentBlock = graph.blocksByRef.get(current);
+        if (blockType && currentBlock?.type !== blockType) {
+            return { kind: "blocked", ref: current, reason: "A block is in progress outside the selected claim type." };
+        }
+        if (!blockInScope(current, graph, scope)) {
+            return { kind: "blocked", ref: current, reason: "A block is in progress outside the selected Auto Run scope." };
+        }
+        return claimResultForBlock(current, graph, "current");
+    }
+    const claimSequentialReviewBlock = async () => {
+        for (const ref of graph.blockRefsInManifestOrder) {
+            if (!blockInScope(ref, graph, scope)) {
+                continue;
+            }
+            const taskId = graph.blockTaskByRef.get(ref);
+            const block = graph.blocksByRef.get(ref);
+            if (blockType && blockType !== "review") {
+                continue;
+            }
+            if (!taskId || block?.type !== "review") {
+                continue;
+            }
+            if (taskDependenciesSatisfied(graph, state, taskId) && state.blocks[ref]?.status === "ready" && canClaimReviewBlock(graph, state, ref)) {
+                if (dryRun) {
+                    return claimResultForBlock(ref, graph, "claimed");
+                }
+                markClaimed(state, ref, graph);
+                state = refreshDerivedState(manifest, state);
+                await writeState(workspace.stateFile, state);
+                return claimResultForBlock(ref, graph, "claimed");
+            }
+        }
+        return null;
+    };
+    const nextSequentialClaimableRefs = () => graph.blockRefsInManifestOrder.filter((ref) => {
+        if (!blockInScope(ref, graph, scope)) {
+            return false;
+        }
+        const taskId = graph.blockTaskByRef.get(ref);
+        const block = graph.blocksByRef.get(ref);
+        if (blockType && block?.type !== blockType) {
+            return false;
+        }
+        if (!taskId || !block || state.blocks[ref]?.status !== "ready" || !taskDependenciesSatisfied(graph, state, taskId)) {
+            return false;
+        }
+        const ready = block.type === "review" ? canClaimReviewBlock(graph, state, ref) : blockDependenciesCompleted(graph, state, ref);
+        return ready && (block.type === "review" || !graph.parallelSafeByBlockRef.get(ref));
+    });
+    if (options.parallel) {
+        if (!manifest.execution.parallel.enabled) {
+            return { kind: "blocked", reason: "Parallel execution is disabled by the Plan Package." };
+        }
+        const selected = [];
+        for (const ref of graph.blockRefsInManifestOrder) {
+            if (!blockInScope(ref, graph, scope)) {
+                continue;
+            }
+            const taskId = graph.blockTaskByRef.get(ref);
+            const block = graph.blocksByRef.get(ref);
+            if (blockType && block?.type !== blockType) {
+                continue;
+            }
+            if (!taskId || !block || block.type === "review") {
+                continue;
+            }
+            if (selected.length >= manifest.execution.parallel.maxConcurrent) {
+                break;
+            }
+            if (!taskDependenciesSatisfied(graph, state, taskId) || !blockDependenciesCompleted(graph, state, ref)) {
+                continue;
+            }
+            if (!graph.parallelSafeByBlockRef.get(ref) || state.blocks[ref]?.status !== "ready") {
+                continue;
+            }
+            const locks = new Set(graph.locksByBlockRef.get(ref) ?? []);
+            const conflicts = selected.some((selectedRef) => {
+                const selectedTaskId = graph.blockTaskByRef.get(selectedRef);
+                if (selectedTaskId && (graph.taskReachable(taskId, selectedTaskId) || graph.taskReachable(selectedTaskId, taskId))) {
+                    return true;
+                }
+                return (graph.locksByBlockRef.get(selectedRef) ?? []).some((lock) => locks.has(lock));
+            });
+            if (!conflicts) {
+                selected.push(ref);
+            }
+        }
+        if (selected.length === 0) {
+            const reviewClaim = await claimSequentialReviewBlock();
+            if (reviewClaim) {
+                if (dryRun && reviewClaim.kind === "block" && reviewClaim.blockType === "review") {
+                    return {
+                        ...reviewClaim,
+                        requestedMode: "parallel",
+                        parallelFallbackReason: "review_requires_sequential_claim",
+                        nextParallelClaimable: []
+                    };
+                }
+                return reviewClaim;
+            }
+            state.currentRefs = [];
+            if (!dryRun) {
+                await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+            }
+            return { kind: "none", reason: "no_parallel_blocks", nextSequentialClaimable: nextSequentialClaimableRefs() };
+        }
+        if (dryRun) {
+            return { kind: "batch", refs: selected };
+        }
+        for (const ref of selected) {
+            state.blocks[ref] = { ...state.blocks[ref], status: "in_progress" };
+        }
+        state.currentRefs = selected;
+        await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+        return { kind: "batch", refs: selected };
+    }
+    for (const ref of graph.blockRefsInManifestOrder) {
+        if (!blockInScope(ref, graph, scope)) {
+            continue;
+        }
+        const taskId = graph.blockTaskByRef.get(ref);
+        const block = graph.blocksByRef.get(ref);
+        if (blockType && block?.type !== blockType) {
+            continue;
+        }
+        if (!taskId || !block || block.type === "review") {
+            continue;
+        }
+        if (taskDependenciesSatisfied(graph, state, taskId) && blockDependenciesCompleted(graph, state, ref) && state.blocks[ref]?.status === "ready") {
+            if (dryRun) {
+                return claimResultForBlock(ref, graph, "claimed");
+            }
+            markClaimed(state, ref, graph);
+            await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+            return claimResultForBlock(ref, graph, "claimed");
+        }
+    }
+    const reviewClaim = await claimSequentialReviewBlock();
+    if (reviewClaim) {
+        return reviewClaim;
+    }
+    const blockedRef = graph.blockRefsInManifestOrder.find((ref) => blockInScope(ref, graph, scope) && state.blocks[ref]?.status === "blocked");
+    if (blockedRef) {
+        return {
+            kind: "blocked",
+            ref: blockedRef,
+            reason: state.blocks[blockedRef]?.blockedReason ?? `Block '${blockedRef}' is blocked.`
+        };
+    }
+    if (!dryRun) {
+        await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+    }
+    return { kind: "none", reason: "no_claimable_blocks" };
+}
+export async function claimBlock(options) {
+    if (options.dispatch) {
+        const context = await loadRuntime(options);
+        const { workspace, manifest, graph, state } = context;
+        const invalidScope = validateClaimScope({ kind: "block", blockRef: options.ref }, graph);
+        if (invalidScope) {
+            return invalidScope;
+        }
+        const block = graph.blocksByRef.get(options.ref);
+        if (block?.type !== "implementation") {
+            return { kind: "blocked", ref: options.ref, reason: "dispatch claims only support implementation blocks." };
+        }
+        if (!graph.parallelSafeByBlockRef.get(options.ref)) {
+            return { kind: "blocked", ref: options.ref, reason: `Block '${options.ref}' is not parallel-safe.` };
+        }
+        if (!canDispatchImplementationBlock(graph, state, options.ref)) {
+            return { kind: "blocked", ref: options.ref, reason: `Block '${options.ref}' is not dispatchable right now.` };
+        }
+        state.blocks[options.ref] = { ...state.blocks[options.ref], status: "in_progress" };
+        state.currentRefs = withCurrentRef(state.currentRefs, options.ref);
+        await writeState(workspace.stateFile, refreshDerivedState(manifest, state));
+        return claimResultForBlock(options.ref, graph, "dispatched");
+    }
+    return claimNext({ projectRoot: options.projectRoot, scope: { kind: "block", blockRef: options.ref }, session: options.session });
+}
+export async function claimTask(options) {
+    return claimNext({ projectRoot: options.projectRoot, scope: { kind: "task", taskId: options.taskId }, session: options.session });
+}
+export async function claimBlockType(options) {
+    return claimNext({ projectRoot: options.projectRoot, blockType: options.blockType, session: options.session });
+}
+//# sourceMappingURL=claimScheduler.js.map

package/dist/taskManager/claimScheduler.js.map

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

package/dist/taskManager/doctor.d.ts

@@ -0,0 +1,6 @@
+import type { DoctorReport, PackageWorkspaceRef } from "../types.js";
+export declare function runDoctor(options: {
+    projectRoot: PackageWorkspaceRef;
+    repair?: boolean;
+}): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/taskManager/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/taskManager/doctor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAe,YAAY,EAAE,mBAAmB,EAAkC,MAAM,aAAa,CAAC;AAoElH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,WAAW,EAAE,mBAAmB,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAgFtH"}

package/dist/taskManager/doctor.js

@@ -0,0 +1,141 @@
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join } from "node:path";
+import { compileTaskGraph } from "../graph/compileTaskGraph.js";
+import { readJsonFile } from "../json.js";
+import { findOrphanResults } from "../package/orphans.js";
+import { loadPackage } from "../package/loadPackage.js";
+import { ensureStateForManifest, readState, writeState } from "../state.js";
+import { readTaskIndex, updateTaskIndex } from "./resultIndex.js";
+async function exists(path) {
+    try {
+        await access(path, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function resultRunMatchesIndex(workspace, ref, taskId, runId) {
+    const blockId = ref.split("#")[1];
+    if (!blockId) {
+        return false;
+    }
+    const runDir = join(workspace.resultsDir, taskId, "blocks", blockId, "runs", runId);
+    const metadataPath = join(runDir, "metadata.json");
+    if (!(await exists(metadataPath)) || !(await exists(join(runDir, "report.md")))) {
+        return false;
+    }
+    const metadata = await readJsonFile(metadataPath);
+    return metadata.ref === ref && metadata.taskId === taskId && metadata.blockId === blockId && metadata.runId === runId;
+}
+function repairStaleCurrentRef(state, ref) {
+    const nextRefs = state.currentRefs.filter((currentRef) => currentRef !== ref);
+    if (nextRefs.length === state.currentRefs.length) {
+        return false;
+    }
+    state.currentRefs = nextRefs;
+    return true;
+}
+async function repairStateRunMismatch(options) {
+    if (!(await resultRunMatchesIndex(options.workspace, options.ref, options.taskId, options.indexRunId))) {
+        return false;
+    }
+    options.state.blocks[options.ref] = {
+        ...(options.state.blocks[options.ref] ?? {}),
+        status: "completed",
+        lastRunId: options.indexRunId
+    };
+    options.state.currentRefs = options.state.currentRefs.filter((ref) => ref !== options.ref);
+    return true;
+}
+async function repairIndexRunMismatch(options) {
+    if (!(await resultRunMatchesIndex(options.workspace, options.ref, options.taskId, options.stateRunId))) {
+        return false;
+    }
+    await updateTaskIndex(options.workspace, options.taskId, (index) => ({
+        ...index,
+        latestRunByBlock: {
+            ...(index.latestRunByBlock ?? {}),
+            [options.ref]: options.stateRunId
+        }
+    }));
+    return true;
+}
+export async function runDoctor(options) {
+    const { workspace, manifest } = await loadPackage(options.projectRoot);
+    const graph = compileTaskGraph(manifest);
+    let state = await readState(workspace.stateFile);
+    const issues = [];
+    let stateChanged = false;
+    for (const ref of state.currentRefs ?? []) {
+        if (!graph.blocksByRef.has(ref)) {
+            const repaired = options.repair ? repairStaleCurrentRef(state, ref) : false;
+            stateChanged = stateChanged || repaired;
+            issues.push({
+                code: "stale_current_ref",
+                ref,
+                repaired,
+                message: `Current ref '${ref}' does not exist in the manifest.`
+            });
+        }
+    }
+    for (const orphan of await findOrphanResults(workspace, manifest)) {
+        issues.push({
+            code: "orphan_result",
+            taskId: orphan.taskId,
+            path: orphan.path,
+            message: `Result directory '${orphan.taskId}' does not belong to a manifest task.`
+        });
+    }
+    for (const taskId of graph.taskNodesInManifestOrder) {
+        const index = await readTaskIndex(workspace, taskId);
+        const checkedRefs = new Set();
+        for (const [ref, indexRunId] of Object.entries(index.latestRunByBlock ?? {})) {
+            checkedRefs.add(ref);
+            const stateRunId = state.blocks?.[ref]?.lastRunId ?? null;
+            if (stateRunId !== indexRunId) {
+                const repaired = options.repair
+                    ? await repairStateRunMismatch({ workspace, state, ref, taskId, indexRunId })
+                    : false;
+                stateChanged = stateChanged || repaired;
+                issues.push({
+                    code: "index_state_mismatch",
+                    ref,
+                    taskId,
+                    path: join(workspace.resultsDir, taskId, "index.json"),
+                    stateRunId,
+                    indexRunId,
+                    repaired,
+                    message: `Task index points '${ref}' to '${indexRunId}', but state has '${stateRunId ?? "none"}'.`
+                });
+            }
+        }
+        for (const ref of graph.blocksByTask.get(taskId) ?? []) {
+            if (checkedRefs.has(ref)) {
+                continue;
+            }
+            const stateRunId = state.blocks?.[ref]?.lastRunId ?? null;
+            if (!stateRunId) {
+                continue;
+            }
+            const repaired = options.repair ? await repairIndexRunMismatch({ workspace, ref, taskId, stateRunId }) : false;
+            issues.push({
+                code: "index_state_mismatch",
+                ref,
+                taskId,
+                path: join(workspace.resultsDir, taskId, "index.json"),
+                stateRunId,
+                indexRunId: null,
+                repaired,
+                message: `State points '${ref}' to '${stateRunId}', but task index has no latest run for it.`
+            });
+        }
+    }
+    if (stateChanged) {
+        state = ensureStateForManifest(manifest, state);
+        await writeState(workspace.stateFile, state);
+    }
+    return { ok: issues.every((issue) => issue.repaired === true), issues };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/taskManager/doctor.js.map

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