@caupulican/pi-adaptative 0.93.3 → 0.93.4

package/dist/core/pipelines/increment.js

@@ -1,8 +1,7 @@
-import { taskStepReferencesRequirement } from "../tasks/task-projection.js";
 import { updateTaskStep } from "../tasks/task-state.js";
 import { currentPipelineStage } from "./context.js";
 import { persistPipelineRun, scanStageOutput, stageOutputDir } from "./run-state.js";
-import { isPipelineRunActive } from "./types.js";
+import { isPipelineRunActive, } from "./types.js";
 export class PipelineIncrementError extends Error {
     constructor(message) {
         super(message);
@@ -14,31 +13,31 @@ function inFlightToolTasks(tasks) {
         return [];
     return tasks.filter((task) => task.status === "running").map((task) => task.taskId);
 }
-function linkedOpenStepIds(join, run) {
-    if (!run.goalId || !join.goal || join.goal.goalId !== run.goalId)
+function linkedOpenStepIds(join, run, stage) {
+    if (!stage)
         return [];
     if (!join.openTaskSteps || join.openTaskSteps.length === 0)
         return [];
     return join.openTaskSteps
-        .filter((step) => join.goal.requirements.some((requirement) => taskStepReferencesRequirement(step, requirement)))
+        .filter((step) => step.pipelineRunId === run.runId && step.pipelineStageId === stage.id)
         .map((step) => step.id);
 }
 export function incrementPipelineRun(definition, run, now, join = {}) {
     if (!isPipelineRunActive(run)) {
         throw new PipelineIncrementError(`Pipeline run '${run.runId}' is ${run.status}.`);
     }
-    const linked = linkedOpenStepIds(join, run);
+    const stage = currentPipelineStage(definition, run);
+    if (!stage) {
+        throw new PipelineIncrementError(`Current stage '${run.currentStageId}' is missing from the definition.`);
+    }
+    const linked = linkedOpenStepIds(join, run, stage);
     if (linked.length > 0) {
-        throw new PipelineIncrementError(`Cannot increment pipeline: open task_steps still reference the linked goal (${linked.join(", ")}).`);
+        throw new PipelineIncrementError(`Cannot increment pipeline: open task_steps still reference current stage '${stage.id}' (${linked.join(", ")}).`);
     }
     const running = inFlightToolTasks(join.backgroundToolTasks);
     if (running.length > 0) {
         throw new PipelineIncrementError(`Cannot increment pipeline: tool_task(s) still running (${running.join(", ")}). Wait once via tool_task.`);
     }
-    const stage = currentPipelineStage(definition, run);
-    if (!stage) {
-        throw new PipelineIncrementError(`Current stage '${run.currentStageId}' is missing from the definition.`);
-    }
     const scanned = scanStageOutput(stageOutputDir(run.runRoot, stage));
     if (scanned.status !== "complete") {
         throw new PipelineIncrementError(`Cannot increment pipeline: stage '${stage.id}' output/ has no files yet. Write the stage outputs first.`);
@@ -78,6 +77,17 @@ export function advanceTaskSteps(state, now) {
     const current = state.steps.find((step) => step.status === "in_progress") ??
         state.steps.find((step) => step.status === "pending");
     if (!current) {
+        const blocked = state.steps.filter((step) => step.status === "blocked");
+        if (blocked.length > 0) {
+            return {
+                state,
+                result: {
+                    surface: "task_steps",
+                    completed: false,
+                    detail: `Cannot advance: all remaining steps are blocked (${blocked.map((step) => step.id).join(", ")}).`,
+                },
+            };
+        }
         return {
             state,
             result: {
@@ -91,8 +101,8 @@ export function advanceTaskSteps(state, now) {
     if (current.status !== "completed") {
         nextState = updateTaskStep(nextState, current.id, { status: "completed" }, now);
     }
-    const following = nextState.steps.find((step) => step.id !== current.id && (step.status === "pending" || step.status === "blocked"));
-    if (following && following.status === "pending") {
+    const following = nextState.steps.find((step) => step.id !== current.id && step.status === "pending");
+    if (following) {
         nextState = updateTaskStep(nextState, following.id, { status: "in_progress" }, now);
         return {
             state: nextState,
@@ -105,6 +115,18 @@ export function advanceTaskSteps(state, now) {
             },
         };
     }
+    const blocked = nextState.steps.filter((step) => step.status === "blocked");
+    if (blocked.length > 0) {
+        return {
+            state: nextState,
+            result: {
+                surface: "task_steps",
+                from: current.id,
+                completed: false,
+                detail: `Completed ${current.id}. Remaining steps are blocked: ${blocked.map((step) => step.id).join(", ")}.`,
+            },
+        };
+    }
     return {
         state: nextState,
         result: {

package/dist/core/pipelines/increment.js.map

@@ -1 +1 @@
-{"version":3,"file":"increment.js","sourceRoot":"","sources":["../../../src/core/pipelines/increment.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAsC,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAwB,mBAAmB,EAA6C,MAAM,YAAY,CAAC;AAQlH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAChD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACtC,CAAC;CACD;AAED,SAAS,iBAAiB,CAAC,KAAmD;IAC7E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,iBAAiB,CAAC,IAA2B,EAAE,GAAgB;IACvE,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC5E,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtE,OAAO,IAAI,CAAC,aAAa;SACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;SACjH,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,UAA8B,EAC9B,GAAgB,EAChB,GAAW,EACX,IAAI,GAA0B,EAAE;IAEhC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,sBAAsB,CAAC,iBAAiB,GAAG,CAAC,KAAK,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,sBAAsB,CAC/B,+EAA+E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACpG,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,sBAAsB,CAC/B,0DAA0D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CACzG,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,GAAG,CAAC,cAAc,mCAAmC,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,sBAAsB,CAC/B,qCAAqC,KAAK,CAAC,EAAE,4DAA4D,CACzG,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,kBAAkB,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3E,OAAO;YACN,GAAG,EAAE,SAAS;YACd,MAAM,EAAE;gBACP,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,KAAK,CAAC,EAAE;gBACd,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,0BAA0B,KAAK,CAAC,EAAE,oBAAoB,GAAG,CAAC,KAAK,YAAY;aACnF;SACD,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,GAAG,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAC9E,OAAO;QACN,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE;YACP,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,KAAK,CAAC,EAAE;YACd,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,cAAc,KAAK,CAAC,EAAE,eAAe,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;SACvG;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAgB,EAAE,GAAW;IAC/D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,OAAO,kBAAkB,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,KAAqB,EACrB,GAAW;IAKX,MAAM,OAAO,GACZ,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;QACzD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO;YACN,KAAK;YACL,MAAM,EAAE;gBACP,OAAO,EAAE,YAAY;gBACrB,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,4BAA4B;aACpC;SACD,CAAC;IACH,CAAC;IACD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACpC,SAAS,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAC5F,CAAC;IACF,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjD,SAAS,GAAG,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;QACpF,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE;gBACP,OAAO,EAAE,YAAY;gBACrB,IAAI,EAAE,OAAO,CAAC,EAAE;gBAChB,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,aAAa,OAAO,CAAC,EAAE,aAAa,SAAS,CAAC,EAAE,GAAG;aAC3D;SACD,CAAC;IACH,CAAC;IACD,OAAO;QACN,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;YACP,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE,OAAO,CAAC,EAAE;YAChB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,aAAa,OAAO,CAAC,EAAE,6BAA6B;SAC5D;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;AAC/G,CAAC","sourcesContent":["import type { BackgroundToolTaskRef } from \"../background-tool-task-controller.ts\";\nimport type { GoalState } from \"../goals/goal-state.ts\";\nimport type { OpenTaskStepRef } from \"../goals/goal-tool-core.ts\";\nimport { taskStepReferencesRequirement } from \"../tasks/task-projection.ts\";\nimport { type TaskStep, type TaskStepsState, updateTaskStep } from \"../tasks/task-state.ts\";\nimport { currentPipelineStage } from \"./context.ts\";\nimport { persistPipelineRun, scanStageOutput, stageOutputDir } from \"./run-state.ts\";\nimport { type IncrementResult, isPipelineRunActive, type PipelineDefinition, type PipelineRun } from \"./types.ts\";\n\nexport interface PipelineIncrementJoin {\n\tgoal?: GoalState;\n\topenTaskSteps?: readonly OpenTaskStepRef[];\n\tbackgroundToolTasks?: readonly BackgroundToolTaskRef[];\n}\n\nexport class PipelineIncrementError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PipelineIncrementError\";\n\t}\n}\n\nfunction inFlightToolTasks(tasks: readonly BackgroundToolTaskRef[] | undefined): string[] {\n\tif (!tasks) return [];\n\treturn tasks.filter((task) => task.status === \"running\").map((task) => task.taskId);\n}\n\nfunction linkedOpenStepIds(join: PipelineIncrementJoin, run: PipelineRun): string[] {\n\tif (!run.goalId || !join.goal || join.goal.goalId !== run.goalId) return [];\n\tif (!join.openTaskSteps || join.openTaskSteps.length === 0) return [];\n\treturn join.openTaskSteps\n\t\t.filter((step) => join.goal!.requirements.some((requirement) => taskStepReferencesRequirement(step, requirement)))\n\t\t.map((step) => step.id);\n}\n\nexport function incrementPipelineRun(\n\tdefinition: PipelineDefinition,\n\trun: PipelineRun,\n\tnow: string,\n\tjoin: PipelineIncrementJoin = {},\n): { run: PipelineRun; result: IncrementResult } {\n\tif (!isPipelineRunActive(run)) {\n\t\tthrow new PipelineIncrementError(`Pipeline run '${run.runId}' is ${run.status}.`);\n\t}\n\tconst linked = linkedOpenStepIds(join, run);\n\tif (linked.length > 0) {\n\t\tthrow new PipelineIncrementError(\n\t\t\t`Cannot increment pipeline: open task_steps still reference the linked goal (${linked.join(\", \")}).`,\n\t\t);\n\t}\n\tconst running = inFlightToolTasks(join.backgroundToolTasks);\n\tif (running.length > 0) {\n\t\tthrow new PipelineIncrementError(\n\t\t\t`Cannot increment pipeline: tool_task(s) still running (${running.join(\", \")}). Wait once via tool_task.`,\n\t\t);\n\t}\n\tconst stage = currentPipelineStage(definition, run);\n\tif (!stage) {\n\t\tthrow new PipelineIncrementError(`Current stage '${run.currentStageId}' is missing from the definition.`);\n\t}\n\tconst scanned = scanStageOutput(stageOutputDir(run.runRoot, stage));\n\tif (scanned.status !== \"complete\") {\n\t\tthrow new PipelineIncrementError(\n\t\t\t`Cannot increment pipeline: stage '${stage.id}' output/ has no files yet. Write the stage outputs first.`,\n\t\t);\n\t}\n\tconst currentIndex = definition.stages.findIndex((candidate) => candidate.id === stage.id);\n\tconst next = definition.stages[currentIndex + 1];\n\tif (!next) {\n\t\tconst completed = persistPipelineRun({ ...run, status: \"completed\" }, now);\n\t\treturn {\n\t\t\trun: completed,\n\t\t\tresult: {\n\t\t\t\tsurface: \"pipeline\",\n\t\t\t\tfrom: stage.id,\n\t\t\t\tcompleted: true,\n\t\t\t\tdetail: `Completed final stage '${stage.id}'. Pipeline run '${run.runId}' is done.`,\n\t\t\t},\n\t\t};\n\t}\n\tconst advanced = persistPipelineRun({ ...run, currentStageId: next.id }, now);\n\treturn {\n\t\trun: advanced,\n\t\tresult: {\n\t\t\tsurface: \"pipeline\",\n\t\t\tfrom: stage.id,\n\t\t\tto: next.id,\n\t\t\tcompleted: false,\n\t\t\tdetail: `Completed '${stage.id}', started '${next.id}'. ${next.contract.oneJob || next.contract.title}`,\n\t\t},\n\t};\n}\n\nexport function abandonPipelineRun(run: PipelineRun, now: string): PipelineRun {\n\tif (!isPipelineRunActive(run)) return run;\n\treturn persistPipelineRun({ ...run, status: \"abandoned\" }, now);\n}\n\nexport function advanceTaskSteps(\n\tstate: TaskStepsState,\n\tnow: string,\n): {\n\tstate: TaskStepsState;\n\tresult: IncrementResult;\n} {\n\tconst current =\n\t\tstate.steps.find((step) => step.status === \"in_progress\") ??\n\t\tstate.steps.find((step) => step.status === \"pending\");\n\tif (!current) {\n\t\treturn {\n\t\t\tstate,\n\t\t\tresult: {\n\t\t\t\tsurface: \"task_steps\",\n\t\t\t\tcompleted: true,\n\t\t\t\tdetail: \"No open task steps remain.\",\n\t\t\t},\n\t\t};\n\t}\n\tlet nextState = state;\n\tif (current.status !== \"completed\") {\n\t\tnextState = updateTaskStep(nextState, current.id, { status: \"completed\" }, now);\n\t}\n\tconst following = nextState.steps.find(\n\t\t(step) => step.id !== current.id && (step.status === \"pending\" || step.status === \"blocked\"),\n\t);\n\tif (following && following.status === \"pending\") {\n\t\tnextState = updateTaskStep(nextState, following.id, { status: \"in_progress\" }, now);\n\t\treturn {\n\t\t\tstate: nextState,\n\t\t\tresult: {\n\t\t\t\tsurface: \"task_steps\",\n\t\t\t\tfrom: current.id,\n\t\t\t\tto: following.id,\n\t\t\t\tcompleted: false,\n\t\t\t\tdetail: `Completed ${current.id}, started ${following.id}.`,\n\t\t\t},\n\t\t};\n\t}\n\treturn {\n\t\tstate: nextState,\n\t\tresult: {\n\t\t\tsurface: \"task_steps\",\n\t\t\tfrom: current.id,\n\t\t\tcompleted: true,\n\t\t\tdetail: `Completed ${current.id}. No further pending steps.`,\n\t\t},\n\t};\n}\n\nexport function currentOpenTaskStep(steps: readonly TaskStep[]): TaskStep | undefined {\n\treturn steps.find((step) => step.status === \"in_progress\") ?? steps.find((step) => step.status === \"pending\");\n}\n"]}
+{"version":3,"file":"increment.js","sourceRoot":"","sources":["../../../src/core/pipelines/increment.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BackgroundToolTaskRef } from \"../background-tool-task-controller.ts\";\nimport type { OpenTaskStepRef } from \"../goals/goal-tool-core.ts\";\nimport { type TaskStep, type TaskStepsState, updateTaskStep } from \"../tasks/task-state.ts\";\nimport { currentPipelineStage } from \"./context.ts\";\nimport { persistPipelineRun, scanStageOutput, stageOutputDir } from \"./run-state.ts\";\nimport {\n\ttype IncrementResult,\n\tisPipelineRunActive,\n\ttype PipelineDefinition,\n\ttype PipelineRun,\n\ttype PipelineStage,\n} from \"./types.ts\";\n\nexport interface PipelineIncrementJoin {\n\topenTaskSteps?: readonly OpenTaskStepRef[];\n\tbackgroundToolTasks?: readonly BackgroundToolTaskRef[];\n}\n\nexport class PipelineIncrementError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PipelineIncrementError\";\n\t}\n}\n\nfunction inFlightToolTasks(tasks: readonly BackgroundToolTaskRef[] | undefined): string[] {\n\tif (!tasks) return [];\n\treturn tasks.filter((task) => task.status === \"running\").map((task) => task.taskId);\n}\n\nfunction linkedOpenStepIds(join: PipelineIncrementJoin, run: PipelineRun, stage?: PipelineStage): string[] {\n\tif (!stage) return [];\n\tif (!join.openTaskSteps || join.openTaskSteps.length === 0) return [];\n\n\treturn join.openTaskSteps\n\t\t.filter((step) => step.pipelineRunId === run.runId && step.pipelineStageId === stage.id)\n\t\t.map((step) => step.id);\n}\n\nexport function incrementPipelineRun(\n\tdefinition: PipelineDefinition,\n\trun: PipelineRun,\n\tnow: string,\n\tjoin: PipelineIncrementJoin = {},\n): { run: PipelineRun; result: IncrementResult } {\n\tif (!isPipelineRunActive(run)) {\n\t\tthrow new PipelineIncrementError(`Pipeline run '${run.runId}' is ${run.status}.`);\n\t}\n\tconst stage = currentPipelineStage(definition, run);\n\tif (!stage) {\n\t\tthrow new PipelineIncrementError(`Current stage '${run.currentStageId}' is missing from the definition.`);\n\t}\n\tconst linked = linkedOpenStepIds(join, run, stage);\n\tif (linked.length > 0) {\n\t\tthrow new PipelineIncrementError(\n\t\t\t`Cannot increment pipeline: open task_steps still reference current stage '${stage.id}' (${linked.join(\", \")}).`,\n\t\t);\n\t}\n\tconst running = inFlightToolTasks(join.backgroundToolTasks);\n\tif (running.length > 0) {\n\t\tthrow new PipelineIncrementError(\n\t\t\t`Cannot increment pipeline: tool_task(s) still running (${running.join(\", \")}). Wait once via tool_task.`,\n\t\t);\n\t}\n\tconst scanned = scanStageOutput(stageOutputDir(run.runRoot, stage));\n\tif (scanned.status !== \"complete\") {\n\t\tthrow new PipelineIncrementError(\n\t\t\t`Cannot increment pipeline: stage '${stage.id}' output/ has no files yet. Write the stage outputs first.`,\n\t\t);\n\t}\n\tconst currentIndex = definition.stages.findIndex((candidate) => candidate.id === stage.id);\n\tconst next = definition.stages[currentIndex + 1];\n\tif (!next) {\n\t\tconst completed = persistPipelineRun({ ...run, status: \"completed\" }, now);\n\t\treturn {\n\t\t\trun: completed,\n\t\t\tresult: {\n\t\t\t\tsurface: \"pipeline\",\n\t\t\t\tfrom: stage.id,\n\t\t\t\tcompleted: true,\n\t\t\t\tdetail: `Completed final stage '${stage.id}'. Pipeline run '${run.runId}' is done.`,\n\t\t\t},\n\t\t};\n\t}\n\tconst advanced = persistPipelineRun({ ...run, currentStageId: next.id }, now);\n\treturn {\n\t\trun: advanced,\n\t\tresult: {\n\t\t\tsurface: \"pipeline\",\n\t\t\tfrom: stage.id,\n\t\t\tto: next.id,\n\t\t\tcompleted: false,\n\t\t\tdetail: `Completed '${stage.id}', started '${next.id}'. ${next.contract.oneJob || next.contract.title}`,\n\t\t},\n\t};\n}\n\nexport function abandonPipelineRun(run: PipelineRun, now: string): PipelineRun {\n\tif (!isPipelineRunActive(run)) return run;\n\treturn persistPipelineRun({ ...run, status: \"abandoned\" }, now);\n}\n\nexport function advanceTaskSteps(\n\tstate: TaskStepsState,\n\tnow: string,\n): {\n\tstate: TaskStepsState;\n\tresult: IncrementResult;\n} {\n\tconst current =\n\t\tstate.steps.find((step) => step.status === \"in_progress\") ??\n\t\tstate.steps.find((step) => step.status === \"pending\");\n\tif (!current) {\n\t\tconst blocked = state.steps.filter((step) => step.status === \"blocked\");\n\t\tif (blocked.length > 0) {\n\t\t\treturn {\n\t\t\t\tstate,\n\t\t\t\tresult: {\n\t\t\t\t\tsurface: \"task_steps\",\n\t\t\t\t\tcompleted: false,\n\t\t\t\t\tdetail: `Cannot advance: all remaining steps are blocked (${blocked.map((step) => step.id).join(\", \")}).`,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tstate,\n\t\t\tresult: {\n\t\t\t\tsurface: \"task_steps\",\n\t\t\t\tcompleted: true,\n\t\t\t\tdetail: \"No open task steps remain.\",\n\t\t\t},\n\t\t};\n\t}\n\tlet nextState = state;\n\tif (current.status !== \"completed\") {\n\t\tnextState = updateTaskStep(nextState, current.id, { status: \"completed\" }, now);\n\t}\n\tconst following = nextState.steps.find((step) => step.id !== current.id && step.status === \"pending\");\n\tif (following) {\n\t\tnextState = updateTaskStep(nextState, following.id, { status: \"in_progress\" }, now);\n\t\treturn {\n\t\t\tstate: nextState,\n\t\t\tresult: {\n\t\t\t\tsurface: \"task_steps\",\n\t\t\t\tfrom: current.id,\n\t\t\t\tto: following.id,\n\t\t\t\tcompleted: false,\n\t\t\t\tdetail: `Completed ${current.id}, started ${following.id}.`,\n\t\t\t},\n\t\t};\n\t}\n\tconst blocked = nextState.steps.filter((step) => step.status === \"blocked\");\n\tif (blocked.length > 0) {\n\t\treturn {\n\t\t\tstate: nextState,\n\t\t\tresult: {\n\t\t\t\tsurface: \"task_steps\",\n\t\t\t\tfrom: current.id,\n\t\t\t\tcompleted: false,\n\t\t\t\tdetail: `Completed ${current.id}. Remaining steps are blocked: ${blocked.map((step) => step.id).join(\", \")}.`,\n\t\t\t},\n\t\t};\n\t}\n\treturn {\n\t\tstate: nextState,\n\t\tresult: {\n\t\t\tsurface: \"task_steps\",\n\t\t\tfrom: current.id,\n\t\t\tcompleted: true,\n\t\t\tdetail: `Completed ${current.id}. No further pending steps.`,\n\t\t},\n\t};\n}\n\nexport function currentOpenTaskStep(steps: readonly TaskStep[]): TaskStep | undefined {\n\treturn steps.find((step) => step.status === \"in_progress\") ?? steps.find((step) => step.status === \"pending\");\n}\n"]}

package/dist/core/pipelines/index.d.ts

@@ -1,8 +1,9 @@
+export { type ActivePipelineContext, createActivePipelineContextMessage, resolveActivePipelineContext, } from "./active-context.ts";
 export { assembleStageContext, currentPipelineStage, formatActivePipelineContext, formatPipelineContext, } from "./context.ts";
-export { discoverPipelineDefinitions, findPipelineDefinition, loadPipelineDefinition, projectPipelineRunsDir, projectPipelinesDir, } from "./discover.ts";
+export { discoverPipelineDefinitions, findPipelineDefinition, loadPipelineDefinition, projectPipelineRunsDir, projectPipelinesDir, resolvePipelineDefinitionForRun, } from "./discover.ts";
 export { abandonPipelineRun, advanceTaskSteps, currentOpenTaskStep, incrementPipelineRun, PipelineIncrementError, type PipelineIncrementJoin, } from "./increment.ts";
 export { parseStageContract, parseWorkspaceFrontmatter } from "./parse-contract.ts";
-export { createPipelineRunRoot, findActivePipelineRun, instantiatePipelineRun, loadPipelineRunById, persistPipelineRun, readPipelineRun, scanPipelineRun, scanStageOutput, stageOutputDir, writePipelineRun, } from "./run-state.ts";
+export { createPipelineRunRoot, findActivePipelineRun, instantiatePipelineRun, isProjectPipelineRun, loadPipelineRunById, persistPipelineRun, readPipelineRun, resolveCurrentProjectPipelineRun, resolveProjectPipelineRun, scanPipelineRun, scanStageOutput, stageOutputDir, withPipelineLifecycleLock, writePipelineRun, } from "./run-state.ts";
 export { appendPipelineRunSnapshot, decodePipelineRunSnapshotPayload, getLatestPipelineRunSnapshot, } from "./session-pipeline-run.ts";
-export { type AssembledStageContext, clonePipelineRun, type IncrementResult, isPipelineRun, isPipelineRunActive, PIPELINE_CONTEXT_MARKER, PIPELINE_RUN_CUSTOM_TYPE, PIPELINE_STAGE_FOLDER_RE, type PipelineDefinition, type PipelineForm, type PipelineRun, type PipelineStage, type StageContract, type StageScan, } from "./types.ts";
+export { type AssembledStageContext, clonePipelineRun, type IncrementResult, isPipelineRun, isPipelineRunActive, MAX_PIPELINE_STAGE_ID_LENGTH, PIPELINE_CONTEXT_MARKER, PIPELINE_RUN_CUSTOM_TYPE, PIPELINE_STAGE_FOLDER_RE, type PipelineDefinition, type PipelineForm, type PipelineRun, type PipelineStage, type StageContract, type StageScan, } from "./types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/pipelines/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,qBAAqB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,yBAAyB,EACzB,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,KAAK,eAAe,EACpB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAC1B,kCAAkC,EAClC,4BAA4B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,+BAA+B,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,qBAAqB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gCAAgC,EAChC,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,yBAAyB,EACzB,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,KAAK,eAAe,EACpB,aAAa,EACb,mBAAmB,EACnB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,GACd,MAAM,YAAY,CAAC"}

package/dist/core/pipelines/index.js

@@ -1,8 +1,9 @@
+export { createActivePipelineContextMessage, resolveActivePipelineContext, } from "./active-context.js";
 export { assembleStageContext, currentPipelineStage, formatActivePipelineContext, formatPipelineContext, } from "./context.js";
-export { discoverPipelineDefinitions, findPipelineDefinition, loadPipelineDefinition, projectPipelineRunsDir, projectPipelinesDir, } from "./discover.js";
+export { discoverPipelineDefinitions, findPipelineDefinition, loadPipelineDefinition, projectPipelineRunsDir, projectPipelinesDir, resolvePipelineDefinitionForRun, } from "./discover.js";
 export { abandonPipelineRun, advanceTaskSteps, currentOpenTaskStep, incrementPipelineRun, PipelineIncrementError, } from "./increment.js";
 export { parseStageContract, parseWorkspaceFrontmatter } from "./parse-contract.js";
-export { createPipelineRunRoot, findActivePipelineRun, instantiatePipelineRun, loadPipelineRunById, persistPipelineRun, readPipelineRun, scanPipelineRun, scanStageOutput, stageOutputDir, writePipelineRun, } from "./run-state.js";
+export { createPipelineRunRoot, findActivePipelineRun, instantiatePipelineRun, isProjectPipelineRun, loadPipelineRunById, persistPipelineRun, readPipelineRun, resolveCurrentProjectPipelineRun, resolveProjectPipelineRun, scanPipelineRun, scanStageOutput, stageOutputDir, withPipelineLifecycleLock, writePipelineRun, } from "./run-state.js";
 export { appendPipelineRunSnapshot, decodePipelineRunSnapshotPayload, getLatestPipelineRunSnapshot, } from "./session-pipeline-run.js";
-export { clonePipelineRun, isPipelineRun, isPipelineRunActive, PIPELINE_CONTEXT_MARKER, PIPELINE_RUN_CUSTOM_TYPE, PIPELINE_STAGE_FOLDER_RE, } from "./types.js";
+export { clonePipelineRun, isPipelineRun, isPipelineRunActive, MAX_PIPELINE_STAGE_ID_LENGTH, PIPELINE_CONTEXT_MARKER, PIPELINE_RUN_CUSTOM_TYPE, PIPELINE_STAGE_FOLDER_RE, } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/core/pipelines/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/pipelines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,yBAAyB,EACzB,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEN,gBAAgB,EAEhB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,GAOxB,MAAM,YAAY,CAAC","sourcesContent":["export {\n\tassembleStageContext,\n\tcurrentPipelineStage,\n\tformatActivePipelineContext,\n\tformatPipelineContext,\n} from \"./context.ts\";\nexport {\n\tdiscoverPipelineDefinitions,\n\tfindPipelineDefinition,\n\tloadPipelineDefinition,\n\tprojectPipelineRunsDir,\n\tprojectPipelinesDir,\n} from \"./discover.ts\";\nexport {\n\tabandonPipelineRun,\n\tadvanceTaskSteps,\n\tcurrentOpenTaskStep,\n\tincrementPipelineRun,\n\tPipelineIncrementError,\n\ttype PipelineIncrementJoin,\n} from \"./increment.ts\";\nexport { parseStageContract, parseWorkspaceFrontmatter } from \"./parse-contract.ts\";\nexport {\n\tcreatePipelineRunRoot,\n\tfindActivePipelineRun,\n\tinstantiatePipelineRun,\n\tloadPipelineRunById,\n\tpersistPipelineRun,\n\treadPipelineRun,\n\tscanPipelineRun,\n\tscanStageOutput,\n\tstageOutputDir,\n\twritePipelineRun,\n} from \"./run-state.ts\";\nexport {\n\tappendPipelineRunSnapshot,\n\tdecodePipelineRunSnapshotPayload,\n\tgetLatestPipelineRunSnapshot,\n} from \"./session-pipeline-run.ts\";\nexport {\n\ttype AssembledStageContext,\n\tclonePipelineRun,\n\ttype IncrementResult,\n\tisPipelineRun,\n\tisPipelineRunActive,\n\tPIPELINE_CONTEXT_MARKER,\n\tPIPELINE_RUN_CUSTOM_TYPE,\n\tPIPELINE_STAGE_FOLDER_RE,\n\ttype PipelineDefinition,\n\ttype PipelineForm,\n\ttype PipelineRun,\n\ttype PipelineStage,\n\ttype StageContract,\n\ttype StageScan,\n} from \"./types.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/pipelines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,kCAAkC,EAClC,4BAA4B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,+BAA+B,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gCAAgC,EAChC,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,yBAAyB,EACzB,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEN,gBAAgB,EAEhB,aAAa,EACb,mBAAmB,EACnB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,GAOxB,MAAM,YAAY,CAAC","sourcesContent":["export {\n\ttype ActivePipelineContext,\n\tcreateActivePipelineContextMessage,\n\tresolveActivePipelineContext,\n} from \"./active-context.ts\";\nexport {\n\tassembleStageContext,\n\tcurrentPipelineStage,\n\tformatActivePipelineContext,\n\tformatPipelineContext,\n} from \"./context.ts\";\nexport {\n\tdiscoverPipelineDefinitions,\n\tfindPipelineDefinition,\n\tloadPipelineDefinition,\n\tprojectPipelineRunsDir,\n\tprojectPipelinesDir,\n\tresolvePipelineDefinitionForRun,\n} from \"./discover.ts\";\nexport {\n\tabandonPipelineRun,\n\tadvanceTaskSteps,\n\tcurrentOpenTaskStep,\n\tincrementPipelineRun,\n\tPipelineIncrementError,\n\ttype PipelineIncrementJoin,\n} from \"./increment.ts\";\nexport { parseStageContract, parseWorkspaceFrontmatter } from \"./parse-contract.ts\";\nexport {\n\tcreatePipelineRunRoot,\n\tfindActivePipelineRun,\n\tinstantiatePipelineRun,\n\tisProjectPipelineRun,\n\tloadPipelineRunById,\n\tpersistPipelineRun,\n\treadPipelineRun,\n\tresolveCurrentProjectPipelineRun,\n\tresolveProjectPipelineRun,\n\tscanPipelineRun,\n\tscanStageOutput,\n\tstageOutputDir,\n\twithPipelineLifecycleLock,\n\twritePipelineRun,\n} from \"./run-state.ts\";\nexport {\n\tappendPipelineRunSnapshot,\n\tdecodePipelineRunSnapshotPayload,\n\tgetLatestPipelineRunSnapshot,\n} from \"./session-pipeline-run.ts\";\nexport {\n\ttype AssembledStageContext,\n\tclonePipelineRun,\n\ttype IncrementResult,\n\tisPipelineRun,\n\tisPipelineRunActive,\n\tMAX_PIPELINE_STAGE_ID_LENGTH,\n\tPIPELINE_CONTEXT_MARKER,\n\tPIPELINE_RUN_CUSTOM_TYPE,\n\tPIPELINE_STAGE_FOLDER_RE,\n\ttype PipelineDefinition,\n\ttype PipelineForm,\n\ttype PipelineRun,\n\ttype PipelineStage,\n\ttype StageContract,\n\ttype StageScan,\n} from \"./types.ts\";\n"]}

package/dist/core/pipelines/run-state.d.ts

@@ -11,6 +11,14 @@ export declare function parsePipelineRun(value: unknown): PipelineRun | undefine
 export declare function readPipelineRun(runRoot: string): PipelineRun | undefined;
 export declare function writePipelineRun(run: PipelineRun): void;
 export declare function createPipelineRunRoot(cwd: string, runId: string): string;
+/** Serialize project-wide pipeline admission and transitions across sessions and OS processes. */
+export declare function withPipelineLifecycleLock<T>(cwd: string, mutate: () => T): T;
+/** A restored run may operate only on its exact project-owned run directory. */
+export declare function isProjectPipelineRun(cwd: string, run: PipelineRun): boolean;
+/** Resolve the exact validated durable manifest for a project-owned session snapshot. */
+export declare function resolveProjectPipelineRun(cwd: string, run: PipelineRun): PipelineRun | undefined;
+/** Resolve the durable project-wide current run, using a session snapshot only as an identity hint. */
+export declare function resolveCurrentProjectPipelineRun(cwd: string, snapshot?: PipelineRun): PipelineRun | undefined;
 export declare function instantiatePipelineRun(args: {
     definition: PipelineDefinition;
     runId: string;

package/dist/core/pipelines/run-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/run-state.ts"],"names":[],"mappings":"AAKA,OAAO,EAGN,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAM5C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBrG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAE5E;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,SAAS,EAAE,CAKtG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAGxE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CASxE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAGvD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACZ,GAAG,WAAW,CAqBd;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAI7E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAc1E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAOvF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI/E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/run-state.ts"],"names":[],"mappings":"AAQA,OAAO,EAIN,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAqE5C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CASrG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAE5E;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,SAAS,EAAE,CAKtG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAGxE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CA4BxE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAYvD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED,kGAAkG;AAClG,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAS5E;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAS3E;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAGhG;AAED,uGAAuG;AACvG,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAG7G;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACZ,GAAG,WAAW,CAqBd;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAI7E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CA6B1E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAUvF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI/E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/core/pipelines/run-state.js

@@ -1,29 +1,84 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { writeFileAtomicSync } from "../util/atomic-file.js";
+import { lstatSync, mkdirSync, opendirSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { assertPortablePathSegment } from "../../utils/work-directory.js";
+import { canonicalPathScopeIdentity, isPathWithinScope, safeRealpathSync } from "../autonomy/path-scope.js";
+import { withFileLockSync, writeFileAtomicSync } from "../util/atomic-file.js";
+import { readBoundedDirectoryNamesSync, readBoundedTextFileSync } from "../util/bounded-file.js";
 import { isPlainRecord } from "../util/value-guards.js";
-import { projectPipelineRunsDir } from "./discover.js";
-import { clonePipelineRun, isPipelineRun, } from "./types.js";
+import { assertProjectPipelineDirectory } from "./discover.js";
+import { clonePipelineRun, isPipelineRun, isPipelineRunActive, } from "./types.js";
 export const RUN_MANIFEST_NAME = "run.json";
+const MAX_STAGE_OUTPUT_SCAN_DEPTH = 16;
+const MAX_STAGE_OUTPUT_SCAN_ENTRIES = 1000;
+const MAX_PIPELINE_RUN_MANIFEST_BYTES = 64 * 1024;
+const MAX_PIPELINE_RUN_SCAN_ENTRIES = 1_024;
+const PIPELINE_LIFECYCLE_LOCK_NAME = ".lifecycle";
 function isRealOutputFile(name) {
     return name !== ".gitkeep" && name !== ".DS_Store" && !name.startsWith(".");
 }
-export function scanStageOutput(outputDir) {
-    if (!existsSync(outputDir))
-        return { status: "empty", outputFiles: [] };
+function collectOutputFiles(realBaseDir, currentDir, relativePrefix = "", depth = 0, collected = [], budget = { visitedEntries: 0 }) {
+    if (depth > MAX_STAGE_OUTPUT_SCAN_DEPTH || budget.visitedEntries >= MAX_STAGE_OUTPUT_SCAN_ENTRIES) {
+        return collected;
+    }
+    let directory;
+    try {
+        directory = opendirSync(currentDir);
+    }
+    catch {
+        return collected;
+    }
     try {
-        const outputFiles = readdirSync(outputDir)
-            .filter((name) => {
-            if (!isRealOutputFile(name))
-                return false;
+        while (budget.visitedEntries < MAX_STAGE_OUTPUT_SCAN_ENTRIES) {
+            const dirent = directory.readSync();
+            if (!dirent)
+                break;
+            budget.visitedEntries++;
+            const entry = dirent.name;
+            if (!isRealOutputFile(entry))
+                continue;
+            const fullPath = join(currentDir, entry);
+            const relPath = relativePrefix ? `${relativePrefix}/${entry}` : entry;
             try {
-                return statSync(join(outputDir, name)).isFile();
+                const real = safeRealpathSync(fullPath);
+                if (!isPathWithinScope(real, realBaseDir))
+                    continue;
+                const lstat = lstatSync(fullPath);
+                if (lstat.isSymbolicLink()) {
+                    const realStat = statSync(real);
+                    if (realStat.isFile())
+                        collected.push(relPath);
+                }
+                else if (lstat.isFile()) {
+                    collected.push(relPath);
+                }
+                else if (lstat.isDirectory()) {
+                    collectOutputFiles(realBaseDir, fullPath, relPath, depth + 1, collected, budget);
+                }
             }
             catch {
-                return false;
+                // Ignore unreadable entries
             }
-        })
-            .sort();
+        }
+    }
+    catch {
+        return collected;
+    }
+    finally {
+        try {
+            directory.closeSync();
+        }
+        catch {
+            // The scan result remains valid if the OS already closed the directory handle.
+        }
+    }
+    return collected;
+}
+export function scanStageOutput(outputDir) {
+    try {
+        const root = lstatSync(outputDir);
+        if (root.isSymbolicLink() || !root.isDirectory())
+            return { status: "empty", outputFiles: [] };
+        const outputFiles = collectOutputFiles(safeRealpathSync(outputDir), outputDir).sort();
         return { status: outputFiles.length > 0 ? "complete" : "empty", outputFiles };
     }
     catch {
@@ -49,10 +104,23 @@ export function parsePipelineRun(value) {
 }
 export function readPipelineRun(runRoot) {
     try {
-        const parsed = JSON.parse(readFileSync(runManifestPath(runRoot), "utf8"));
+        const rootStats = lstatSync(runRoot);
+        if (!rootStats.isDirectory() || rootStats.isSymbolicLink())
+            return undefined;
+        const manifestPath = runManifestPath(runRoot);
+        const manifestStats = lstatSync(manifestPath);
+        if (!manifestStats.isFile() ||
+            manifestStats.isSymbolicLink() ||
+            manifestStats.size > MAX_PIPELINE_RUN_MANIFEST_BYTES) {
+            return undefined;
+        }
+        const parsed = JSON.parse(readBoundedTextFileSync(manifestPath, MAX_PIPELINE_RUN_MANIFEST_BYTES, "Pipeline run manifest"));
         const run = parsePipelineRun(parsed);
-        if (!run || run.runRoot !== runRoot)
+        if (!run ||
+            canonicalPathScopeIdentity(run.runRoot) !== canonicalPathScopeIdentity(runRoot) ||
+            basename(runRoot) !== run.runId) {
             return undefined;
+        }
         return run;
     }
     catch {
@@ -60,11 +128,57 @@ export function readPipelineRun(runRoot) {
     }
 }
 export function writePipelineRun(run) {
+    if (!isPipelineRun(run))
+        throw new Error("Pipeline run state is invalid and was not persisted.");
+    assertPortablePathSegment("Pipeline run id", run.runId);
+    if (basename(run.runRoot) !== run.runId) {
+        throw new Error("Pipeline run root must end with its exact run id.");
+    }
     mkdirSync(run.runRoot, { recursive: true });
+    const rootStats = lstatSync(run.runRoot);
+    if (!rootStats.isDirectory() || rootStats.isSymbolicLink()) {
+        throw new Error(`Pipeline run root is not a real directory: ${run.runRoot}`);
+    }
     writeFileAtomicSync(runManifestPath(run.runRoot), `${JSON.stringify(run, null, 2)}\n`);
 }
 export function createPipelineRunRoot(cwd, runId) {
-    return join(projectPipelineRunsDir(cwd), runId);
+    assertPortablePathSegment("Pipeline run id", runId);
+    return join(assertProjectPipelineDirectory(cwd, "pipeline-runs"), runId);
+}
+/** Serialize project-wide pipeline admission and transitions across sessions and OS processes. */
+export function withPipelineLifecycleLock(cwd, mutate) {
+    const runsRoot = assertProjectPipelineDirectory(cwd, "pipeline-runs");
+    return withFileLockSync(join(runsRoot, PIPELINE_LIFECYCLE_LOCK_NAME), () => {
+        const verifiedRoot = assertProjectPipelineDirectory(cwd, "pipeline-runs");
+        if (canonicalPathScopeIdentity(verifiedRoot) !== canonicalPathScopeIdentity(runsRoot)) {
+            throw new Error("Project pipeline-runs directory changed during lifecycle lock acquisition.");
+        }
+        return mutate();
+    });
+}
+/** A restored run may operate only on its exact project-owned run directory. */
+export function isProjectPipelineRun(cwd, run) {
+    try {
+        const expectedRoot = createPipelineRunRoot(cwd, run.runId);
+        if (canonicalPathScopeIdentity(run.runRoot) !== canonicalPathScopeIdentity(expectedRoot))
+            return false;
+        const rootStats = lstatSync(expectedRoot);
+        return rootStats.isDirectory() && !rootStats.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolve the exact validated durable manifest for a project-owned session snapshot. */
+export function resolveProjectPipelineRun(cwd, run) {
+    if (!isProjectPipelineRun(cwd, run))
+        return undefined;
+    return readPipelineRun(createPipelineRunRoot(cwd, run.runId));
+}
+/** Resolve the durable project-wide current run, using a session snapshot only as an identity hint. */
+export function resolveCurrentProjectPipelineRun(cwd, snapshot) {
+    const durableSnapshot = snapshot ? resolveProjectPipelineRun(cwd, snapshot) : undefined;
+    return findActivePipelineRun(cwd) ?? durableSnapshot;
 }
 export function instantiatePipelineRun(args) {
     const first = args.definition.stages[0];
@@ -95,33 +209,53 @@ export function persistPipelineRun(run, now) {
     return next;
 }
 export function findActivePipelineRun(cwd) {
-    const root = projectPipelineRunsDir(cwd);
-    if (!existsSync(root))
-        return undefined;
-    let latest;
+    let root;
     try {
-        for (const name of readdirSync(root)) {
-            const run = readPipelineRun(join(root, name));
-            if (!run || run.status !== "active")
-                continue;
-            if (!latest || run.updatedAt > latest.updatedAt)
-                latest = run;
-        }
+        root = assertProjectPipelineDirectory(cwd, "pipeline-runs");
     }
-    catch {
-        return latest;
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+    let names;
+    try {
+        names = readBoundedDirectoryNamesSync(root, MAX_PIPELINE_RUN_SCAN_ENTRIES, "Pipeline run directory");
     }
-    return latest;
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+    let active;
+    for (const name of names) {
+        if (name.startsWith("."))
+            continue;
+        const run = readPipelineRun(join(root, name));
+        if (!run) {
+            throw new Error(`Pipeline run directory contains an invalid managed entry: ${name}`);
+        }
+        if (!isPipelineRunActive(run))
+            continue;
+        if (active) {
+            throw new Error(`Pipeline run directory contains multiple active runs: ${active.runId}, ${run.runId}`);
+        }
+        active = run;
+    }
+    return active;
 }
 export function loadPipelineRunById(cwd, runId) {
     const trimmed = runId.trim();
     if (!trimmed)
         return undefined;
-    const fromDisk = readPipelineRun(join(projectPipelineRunsDir(cwd), trimmed));
-    if (fromDisk)
-        return fromDisk;
-    const active = findActivePipelineRun(cwd);
-    return active?.runId === trimmed ? active : undefined;
+    let runRoot;
+    try {
+        runRoot = createPipelineRunRoot(cwd, trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    return readPipelineRun(runRoot);
 }
 export function decodePipelineRunPayload(data) {
     if (!isPlainRecord(data))

package/dist/core/pipelines/run-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-state.js","sourceRoot":"","sources":["../../../src/core/pipelines/run-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { writeFileAtomicSync } from \"../util/atomic-file.ts\";\nimport { isPlainRecord } from \"../util/value-guards.ts\";\nimport { projectPipelineRunsDir } from \"./discover.ts\";\nimport {\n\tclonePipelineRun,\n\tisPipelineRun,\n\ttype PipelineDefinition,\n\ttype PipelineRun,\n\ttype PipelineStage,\n\ttype StageDiskStatus,\n\ttype StageScan,\n} from \"./types.ts\";\n\nexport const RUN_MANIFEST_NAME = \"run.json\";\n\nfunction isRealOutputFile(name: string): boolean {\n\treturn name !== \".gitkeep\" && name !== \".DS_Store\" && !name.startsWith(\".\");\n}\n\nexport function scanStageOutput(outputDir: string): { status: StageDiskStatus; outputFiles: string[] } {\n\tif (!existsSync(outputDir)) return { status: \"empty\", outputFiles: [] };\n\ttry {\n\t\tconst outputFiles = readdirSync(outputDir)\n\t\t\t.filter((name) => {\n\t\t\t\tif (!isRealOutputFile(name)) return false;\n\t\t\t\ttry {\n\t\t\t\t\treturn statSync(join(outputDir, name)).isFile();\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t})\n\t\t\t.sort();\n\t\treturn { status: outputFiles.length > 0 ? \"complete\" : \"empty\", outputFiles };\n\t} catch {\n\t\treturn { status: \"empty\", outputFiles: [] };\n\t}\n}\n\nexport function stageOutputDir(runRoot: string, stage: PipelineStage): string {\n\treturn join(runRoot, stage.folderName, \"output\");\n}\n\nexport function scanPipelineRun(definition: PipelineDefinition, run: PipelineRun): readonly StageScan[] {\n\treturn definition.stages.map((stage) => {\n\t\tconst scanned = scanStageOutput(stageOutputDir(run.runRoot, stage));\n\t\treturn { stageId: stage.id, status: scanned.status, outputFiles: scanned.outputFiles };\n\t});\n}\n\nexport function runManifestPath(runRoot: string): string {\n\treturn join(runRoot, RUN_MANIFEST_NAME);\n}\n\nexport function parsePipelineRun(value: unknown): PipelineRun | undefined {\n\tif (!isPipelineRun(value)) return undefined;\n\treturn clonePipelineRun(value);\n}\n\nexport function readPipelineRun(runRoot: string): PipelineRun | undefined {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(readFileSync(runManifestPath(runRoot), \"utf8\"));\n\t\tconst run = parsePipelineRun(parsed);\n\t\tif (!run || run.runRoot !== runRoot) return undefined;\n\t\treturn run;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport function writePipelineRun(run: PipelineRun): void {\n\tmkdirSync(run.runRoot, { recursive: true });\n\twriteFileAtomicSync(runManifestPath(run.runRoot), `${JSON.stringify(run, null, 2)}\\n`);\n}\n\nexport function createPipelineRunRoot(cwd: string, runId: string): string {\n\treturn join(projectPipelineRunsDir(cwd), runId);\n}\n\nexport function instantiatePipelineRun(args: {\n\tdefinition: PipelineDefinition;\n\trunId: string;\n\trunRoot: string;\n\tgoalId?: string;\n\tnow: string;\n}): PipelineRun {\n\tconst first = args.definition.stages[0];\n\tif (!first) throw new Error(\"Pipeline definition has no stages.\");\n\tfor (const stage of args.definition.stages) {\n\t\tmkdirSync(stageOutputDir(args.runRoot, stage), { recursive: true });\n\t}\n\tconst run: PipelineRun = {\n\t\tversion: 1,\n\t\trevision: 1,\n\t\trunId: args.runId,\n\t\tpipelineName: args.definition.name,\n\t\tdefinitionPath: args.definition.rootDir,\n\t\trunRoot: args.runRoot,\n\t\tcurrentStageId: first.id,\n\t\tstatus: \"active\",\n\t\tgoalId: args.goalId,\n\t\tcreatedAt: args.now,\n\t\tupdatedAt: args.now,\n\t};\n\twritePipelineRun(run);\n\treturn run;\n}\n\nexport function persistPipelineRun(run: PipelineRun, now: string): PipelineRun {\n\tconst next = { ...run, revision: run.revision + 1, updatedAt: now };\n\twritePipelineRun(next);\n\treturn next;\n}\n\nexport function findActivePipelineRun(cwd: string): PipelineRun | undefined {\n\tconst root = projectPipelineRunsDir(cwd);\n\tif (!existsSync(root)) return undefined;\n\tlet latest: PipelineRun | undefined;\n\ttry {\n\t\tfor (const name of readdirSync(root)) {\n\t\t\tconst run = readPipelineRun(join(root, name));\n\t\t\tif (!run || run.status !== \"active\") continue;\n\t\t\tif (!latest || run.updatedAt > latest.updatedAt) latest = run;\n\t\t}\n\t} catch {\n\t\treturn latest;\n\t}\n\treturn latest;\n}\n\nexport function loadPipelineRunById(cwd: string, runId: string): PipelineRun | undefined {\n\tconst trimmed = runId.trim();\n\tif (!trimmed) return undefined;\n\tconst fromDisk = readPipelineRun(join(projectPipelineRunsDir(cwd), trimmed));\n\tif (fromDisk) return fromDisk;\n\tconst active = findActivePipelineRun(cwd);\n\treturn active?.runId === trimmed ? active : undefined;\n}\n\nexport function decodePipelineRunPayload(data: unknown): PipelineRun | undefined {\n\tif (!isPlainRecord(data)) return undefined;\n\tconst value = data.run ?? data;\n\treturn parsePipelineRun(value);\n}\n\nexport function pipelineRunParentDir(runRoot: string): string {\n\treturn dirname(runRoot);\n}\n"]}
+{"version":3,"file":"run-state.js","sourceRoot":"","sources":["../../../src/core/pipelines/run-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstatSync, mkdirSync, opendirSync, statSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\nimport { assertPortablePathSegment } from \"../../utils/work-directory.ts\";\nimport { canonicalPathScopeIdentity, isPathWithinScope, safeRealpathSync } from \"../autonomy/path-scope.ts\";\nimport { withFileLockSync, writeFileAtomicSync } from \"../util/atomic-file.ts\";\nimport { readBoundedDirectoryNamesSync, readBoundedTextFileSync } from \"../util/bounded-file.ts\";\nimport { isPlainRecord } from \"../util/value-guards.ts\";\nimport { assertProjectPipelineDirectory } from \"./discover.ts\";\nimport {\n\tclonePipelineRun,\n\tisPipelineRun,\n\tisPipelineRunActive,\n\ttype PipelineDefinition,\n\ttype PipelineRun,\n\ttype PipelineStage,\n\ttype StageDiskStatus,\n\ttype StageScan,\n} from \"./types.ts\";\n\nexport const RUN_MANIFEST_NAME = \"run.json\";\nconst MAX_STAGE_OUTPUT_SCAN_DEPTH = 16;\nconst MAX_STAGE_OUTPUT_SCAN_ENTRIES = 1000;\nconst MAX_PIPELINE_RUN_MANIFEST_BYTES = 64 * 1024;\nconst MAX_PIPELINE_RUN_SCAN_ENTRIES = 1_024;\nconst PIPELINE_LIFECYCLE_LOCK_NAME = \".lifecycle\";\n\ninterface StageOutputScanBudget {\n\tvisitedEntries: number;\n}\n\nfunction isRealOutputFile(name: string): boolean {\n\treturn name !== \".gitkeep\" && name !== \".DS_Store\" && !name.startsWith(\".\");\n}\n\nfunction collectOutputFiles(\n\trealBaseDir: string,\n\tcurrentDir: string,\n\trelativePrefix = \"\",\n\tdepth = 0,\n\tcollected: string[] = [],\n\tbudget: StageOutputScanBudget = { visitedEntries: 0 },\n): string[] {\n\tif (depth > MAX_STAGE_OUTPUT_SCAN_DEPTH || budget.visitedEntries >= MAX_STAGE_OUTPUT_SCAN_ENTRIES) {\n\t\treturn collected;\n\t}\n\tlet directory: ReturnType<typeof opendirSync>;\n\ttry {\n\t\tdirectory = opendirSync(currentDir);\n\t} catch {\n\t\treturn collected;\n\t}\n\ttry {\n\t\twhile (budget.visitedEntries < MAX_STAGE_OUTPUT_SCAN_ENTRIES) {\n\t\t\tconst dirent = directory.readSync();\n\t\t\tif (!dirent) break;\n\t\t\tbudget.visitedEntries++;\n\t\t\tconst entry = dirent.name;\n\t\t\tif (!isRealOutputFile(entry)) continue;\n\t\t\tconst fullPath = join(currentDir, entry);\n\t\t\tconst relPath = relativePrefix ? `${relativePrefix}/${entry}` : entry;\n\t\t\ttry {\n\t\t\t\tconst real = safeRealpathSync(fullPath);\n\t\t\t\tif (!isPathWithinScope(real, realBaseDir)) continue;\n\t\t\t\tconst lstat = lstatSync(fullPath);\n\t\t\t\tif (lstat.isSymbolicLink()) {\n\t\t\t\t\tconst realStat = statSync(real);\n\t\t\t\t\tif (realStat.isFile()) collected.push(relPath);\n\t\t\t\t} else if (lstat.isFile()) {\n\t\t\t\t\tcollected.push(relPath);\n\t\t\t\t} else if (lstat.isDirectory()) {\n\t\t\t\t\tcollectOutputFiles(realBaseDir, fullPath, relPath, depth + 1, collected, budget);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Ignore unreadable entries\n\t\t\t}\n\t\t}\n\t} catch {\n\t\treturn collected;\n\t} finally {\n\t\ttry {\n\t\t\tdirectory.closeSync();\n\t\t} catch {\n\t\t\t// The scan result remains valid if the OS already closed the directory handle.\n\t\t}\n\t}\n\treturn collected;\n}\n\nexport function scanStageOutput(outputDir: string): { status: StageDiskStatus; outputFiles: string[] } {\n\ttry {\n\t\tconst root = lstatSync(outputDir);\n\t\tif (root.isSymbolicLink() || !root.isDirectory()) return { status: \"empty\", outputFiles: [] };\n\t\tconst outputFiles = collectOutputFiles(safeRealpathSync(outputDir), outputDir).sort();\n\t\treturn { status: outputFiles.length > 0 ? \"complete\" : \"empty\", outputFiles };\n\t} catch {\n\t\treturn { status: \"empty\", outputFiles: [] };\n\t}\n}\n\nexport function stageOutputDir(runRoot: string, stage: PipelineStage): string {\n\treturn join(runRoot, stage.folderName, \"output\");\n}\n\nexport function scanPipelineRun(definition: PipelineDefinition, run: PipelineRun): readonly StageScan[] {\n\treturn definition.stages.map((stage) => {\n\t\tconst scanned = scanStageOutput(stageOutputDir(run.runRoot, stage));\n\t\treturn { stageId: stage.id, status: scanned.status, outputFiles: scanned.outputFiles };\n\t});\n}\n\nexport function runManifestPath(runRoot: string): string {\n\treturn join(runRoot, RUN_MANIFEST_NAME);\n}\n\nexport function parsePipelineRun(value: unknown): PipelineRun | undefined {\n\tif (!isPipelineRun(value)) return undefined;\n\treturn clonePipelineRun(value);\n}\n\nexport function readPipelineRun(runRoot: string): PipelineRun | undefined {\n\ttry {\n\t\tconst rootStats = lstatSync(runRoot);\n\t\tif (!rootStats.isDirectory() || rootStats.isSymbolicLink()) return undefined;\n\t\tconst manifestPath = runManifestPath(runRoot);\n\t\tconst manifestStats = lstatSync(manifestPath);\n\t\tif (\n\t\t\t!manifestStats.isFile() ||\n\t\t\tmanifestStats.isSymbolicLink() ||\n\t\t\tmanifestStats.size > MAX_PIPELINE_RUN_MANIFEST_BYTES\n\t\t) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst parsed: unknown = JSON.parse(\n\t\t\treadBoundedTextFileSync(manifestPath, MAX_PIPELINE_RUN_MANIFEST_BYTES, \"Pipeline run manifest\"),\n\t\t);\n\t\tconst run = parsePipelineRun(parsed);\n\t\tif (\n\t\t\t!run ||\n\t\t\tcanonicalPathScopeIdentity(run.runRoot) !== canonicalPathScopeIdentity(runRoot) ||\n\t\t\tbasename(runRoot) !== run.runId\n\t\t) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn run;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport function writePipelineRun(run: PipelineRun): void {\n\tif (!isPipelineRun(run)) throw new Error(\"Pipeline run state is invalid and was not persisted.\");\n\tassertPortablePathSegment(\"Pipeline run id\", run.runId);\n\tif (basename(run.runRoot) !== run.runId) {\n\t\tthrow new Error(\"Pipeline run root must end with its exact run id.\");\n\t}\n\tmkdirSync(run.runRoot, { recursive: true });\n\tconst rootStats = lstatSync(run.runRoot);\n\tif (!rootStats.isDirectory() || rootStats.isSymbolicLink()) {\n\t\tthrow new Error(`Pipeline run root is not a real directory: ${run.runRoot}`);\n\t}\n\twriteFileAtomicSync(runManifestPath(run.runRoot), `${JSON.stringify(run, null, 2)}\\n`);\n}\n\nexport function createPipelineRunRoot(cwd: string, runId: string): string {\n\tassertPortablePathSegment(\"Pipeline run id\", runId);\n\treturn join(assertProjectPipelineDirectory(cwd, \"pipeline-runs\"), runId);\n}\n\n/** Serialize project-wide pipeline admission and transitions across sessions and OS processes. */\nexport function withPipelineLifecycleLock<T>(cwd: string, mutate: () => T): T {\n\tconst runsRoot = assertProjectPipelineDirectory(cwd, \"pipeline-runs\");\n\treturn withFileLockSync(join(runsRoot, PIPELINE_LIFECYCLE_LOCK_NAME), () => {\n\t\tconst verifiedRoot = assertProjectPipelineDirectory(cwd, \"pipeline-runs\");\n\t\tif (canonicalPathScopeIdentity(verifiedRoot) !== canonicalPathScopeIdentity(runsRoot)) {\n\t\t\tthrow new Error(\"Project pipeline-runs directory changed during lifecycle lock acquisition.\");\n\t\t}\n\t\treturn mutate();\n\t});\n}\n\n/** A restored run may operate only on its exact project-owned run directory. */\nexport function isProjectPipelineRun(cwd: string, run: PipelineRun): boolean {\n\ttry {\n\t\tconst expectedRoot = createPipelineRunRoot(cwd, run.runId);\n\t\tif (canonicalPathScopeIdentity(run.runRoot) !== canonicalPathScopeIdentity(expectedRoot)) return false;\n\t\tconst rootStats = lstatSync(expectedRoot);\n\t\treturn rootStats.isDirectory() && !rootStats.isSymbolicLink();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/** Resolve the exact validated durable manifest for a project-owned session snapshot. */\nexport function resolveProjectPipelineRun(cwd: string, run: PipelineRun): PipelineRun | undefined {\n\tif (!isProjectPipelineRun(cwd, run)) return undefined;\n\treturn readPipelineRun(createPipelineRunRoot(cwd, run.runId));\n}\n\n/** Resolve the durable project-wide current run, using a session snapshot only as an identity hint. */\nexport function resolveCurrentProjectPipelineRun(cwd: string, snapshot?: PipelineRun): PipelineRun | undefined {\n\tconst durableSnapshot = snapshot ? resolveProjectPipelineRun(cwd, snapshot) : undefined;\n\treturn findActivePipelineRun(cwd) ?? durableSnapshot;\n}\n\nexport function instantiatePipelineRun(args: {\n\tdefinition: PipelineDefinition;\n\trunId: string;\n\trunRoot: string;\n\tgoalId?: string;\n\tnow: string;\n}): PipelineRun {\n\tconst first = args.definition.stages[0];\n\tif (!first) throw new Error(\"Pipeline definition has no stages.\");\n\tfor (const stage of args.definition.stages) {\n\t\tmkdirSync(stageOutputDir(args.runRoot, stage), { recursive: true });\n\t}\n\tconst run: PipelineRun = {\n\t\tversion: 1,\n\t\trevision: 1,\n\t\trunId: args.runId,\n\t\tpipelineName: args.definition.name,\n\t\tdefinitionPath: args.definition.rootDir,\n\t\trunRoot: args.runRoot,\n\t\tcurrentStageId: first.id,\n\t\tstatus: \"active\",\n\t\tgoalId: args.goalId,\n\t\tcreatedAt: args.now,\n\t\tupdatedAt: args.now,\n\t};\n\twritePipelineRun(run);\n\treturn run;\n}\n\nexport function persistPipelineRun(run: PipelineRun, now: string): PipelineRun {\n\tconst next = { ...run, revision: run.revision + 1, updatedAt: now };\n\twritePipelineRun(next);\n\treturn next;\n}\n\nexport function findActivePipelineRun(cwd: string): PipelineRun | undefined {\n\tlet root: string;\n\ttry {\n\t\troot = assertProjectPipelineDirectory(cwd, \"pipeline-runs\");\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow error;\n\t}\n\tlet names: string[];\n\ttry {\n\t\tnames = readBoundedDirectoryNamesSync(root, MAX_PIPELINE_RUN_SCAN_ENTRIES, \"Pipeline run directory\");\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow error;\n\t}\n\tlet active: PipelineRun | undefined;\n\tfor (const name of names) {\n\t\tif (name.startsWith(\".\")) continue;\n\t\tconst run = readPipelineRun(join(root, name));\n\t\tif (!run) {\n\t\t\tthrow new Error(`Pipeline run directory contains an invalid managed entry: ${name}`);\n\t\t}\n\t\tif (!isPipelineRunActive(run)) continue;\n\t\tif (active) {\n\t\t\tthrow new Error(`Pipeline run directory contains multiple active runs: ${active.runId}, ${run.runId}`);\n\t\t}\n\t\tactive = run;\n\t}\n\treturn active;\n}\n\nexport function loadPipelineRunById(cwd: string, runId: string): PipelineRun | undefined {\n\tconst trimmed = runId.trim();\n\tif (!trimmed) return undefined;\n\tlet runRoot: string;\n\ttry {\n\t\trunRoot = createPipelineRunRoot(cwd, trimmed);\n\t} catch {\n\t\treturn undefined;\n\t}\n\treturn readPipelineRun(runRoot);\n}\n\nexport function decodePipelineRunPayload(data: unknown): PipelineRun | undefined {\n\tif (!isPlainRecord(data)) return undefined;\n\tconst value = data.run ?? data;\n\treturn parsePipelineRun(value);\n}\n\nexport function pipelineRunParentDir(runRoot: string): string {\n\treturn dirname(runRoot);\n}\n"]}

package/dist/core/pipelines/types.d.ts

@@ -1,5 +1,7 @@
 /** ICM pipeline form: numbered stages, factory vs product, status from files. */
 export declare const PIPELINE_STAGE_FOLDER_RE: RegExp;
+/** Two-digit ordinal, separator, and the longest stage slug accepted by PIPELINE_STAGE_FOLDER_RE. */
+export declare const MAX_PIPELINE_STAGE_ID_LENGTH = 66;
 export declare const MAX_PIPELINE_STAGES = 32;
 export declare const MAX_PIPELINE_NAME_LENGTH = 64;
 export declare const MAX_CONTRACT_PROCESS_CHARS = 4000;

package/dist/core/pipelines/types.d.ts.map

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