@caupulican/pi-adaptative 0.90.12 → 0.91.2

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

@@ -0,0 +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"]}

package/dist/core/pipelines/parse-contract.d.ts

@@ -0,0 +1,10 @@
+import { type PipelineForm, type StageContract } from "./types.ts";
+export interface ParsedWorkspaceContract {
+    name?: string;
+    description?: string;
+    form: PipelineForm;
+    body: string;
+}
+export declare function parseWorkspaceFrontmatter(content: string): ParsedWorkspaceContract;
+export declare function parseStageContract(content: string): StageContract;
+//# sourceMappingURL=parse-contract.d.ts.map

package/dist/core/pipelines/parse-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-contract.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/parse-contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAIN,KAAK,YAAY,EAEjB,KAAK,aAAa,EAClB,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,uBAAuB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACb;AAkCD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAWlF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA2CjE"}

package/dist/core/pipelines/parse-contract.js

@@ -0,0 +1,105 @@
+import { parseFrontmatter } from "../../utils/frontmatter.js";
+import { isPlainRecord } from "../util/value-guards.js";
+import { MAX_CONTRACT_PROCESS_CHARS, MAX_HUMAN_CHECK_CHARS, MAX_PIPELINE_NAME_LENGTH, } from "./types.js";
+const FORMS = [
+    "pipeline",
+    "umbrella",
+    "record-library",
+    "knowledge-bundle",
+    "context-map",
+    "system-map",
+];
+function section(body, heading) {
+    const pattern = new RegExp(`^##\\s+${heading}\\s*$`, "im");
+    const start = body.search(pattern);
+    if (start === -1)
+        return "";
+    const after = body.slice(start).split("\n").slice(1);
+    const lines = [];
+    for (const line of after) {
+        if (/^##\s+/.test(line))
+            break;
+        lines.push(line);
+    }
+    return lines.join("\n").trim();
+}
+function listLines(text) {
+    const items = [];
+    for (const raw of text.split("\n")) {
+        const match = raw.match(/^\s*(?:[-*]|\d+\.)\s+(.+)$/);
+        if (match)
+            items.push(match[1].trim());
+    }
+    return items;
+}
+function classifyInput(line) {
+    const working = line.match(/^(?:Working(?:\s+\(this run\))?|4|Layer\s*4)\s*:\s*(.+)$/i);
+    if (working)
+        return { kind: "working", path: working[1].trim() };
+    const reference = line.match(/^(?:Reference(?:\s+\(every run\))?|3|Layer\s*3)\s*:\s*(.+)$/i);
+    if (reference)
+        return { kind: "reference", path: reference[1].trim() };
+    const numbered = line.match(/^([34])\s*:\s*(.+)$/);
+    if (numbered)
+        return { kind: numbered[1] === "3" ? "reference" : "working", path: numbered[2].trim() };
+    return undefined;
+}
+export function parseWorkspaceFrontmatter(content) {
+    const parsed = parseFrontmatter(content);
+    const fm = isPlainRecord(parsed.frontmatter) ? parsed.frontmatter : {};
+    const name = typeof fm.name === "string" ? fm.name.trim() : undefined;
+    const description = typeof fm.description === "string" ? fm.description.trim() : undefined;
+    const formRaw = typeof fm.form === "string" ? fm.form.trim() : "pipeline";
+    const form = FORMS.includes(formRaw) ? formRaw : "pipeline";
+    if (name && name.length > MAX_PIPELINE_NAME_LENGTH) {
+        throw new Error(`Pipeline name exceeds ${MAX_PIPELINE_NAME_LENGTH} characters.`);
+    }
+    return { name, description, form, body: parsed.body };
+}
+export function parseStageContract(content) {
+    const { body } = parseFrontmatter(content);
+    const titleLine = body.split("\n").find((line) => line.startsWith("# ")) ?? "";
+    const title = titleLine.replace(/^#\s+/, "").trim();
+    const oneJobMatch = body.match(/^One job:\s*(.+)$/im);
+    const inputsSection = section(body, "Inputs");
+    const processSection = section(body, "Process");
+    const outputsSection = section(body, "Outputs");
+    const humanSection = section(body, "Human check");
+    const doNot = [];
+    const inputs = [];
+    for (const raw of inputsSection.split("\n")) {
+        const trimmed = raw.trim();
+        if (!trimmed)
+            continue;
+        const doNotLine = trimmed.match(/^do not load:?\s*(.+)$/i);
+        if (doNotLine) {
+            doNot.push(doNotLine[1].trim());
+            continue;
+        }
+        const listed = trimmed.match(/^(?:[-*]|\d+\.)\s+(.+)$/);
+        const line = listed ? listed[1].trim() : trimmed;
+        if (/^do not load/i.test(line)) {
+            doNot.push(line.replace(/^do not load:?\s*/i, "").trim());
+            continue;
+        }
+        const input = classifyInput(line);
+        if (input)
+            inputs.push(input);
+    }
+    const process = listLines(processSection);
+    if (process.join("\n").length > MAX_CONTRACT_PROCESS_CHARS) {
+        throw new Error(`Stage process exceeds ${MAX_CONTRACT_PROCESS_CHARS} characters.`);
+    }
+    const outputs = listLines(outputsSection).map((line) => line.replace(/\s*→\s*output\/?\s*$/i, "").trim());
+    const humanCheck = humanSection.slice(0, MAX_HUMAN_CHECK_CHARS);
+    return {
+        title,
+        oneJob: (oneJobMatch?.[1] ?? "").trim(),
+        inputs,
+        doNotLoad: doNot,
+        process,
+        outputs,
+        humanCheck,
+    };
+}
+//# sourceMappingURL=parse-contract.js.map

package/dist/core/pipelines/parse-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-contract.js","sourceRoot":"","sources":["../../../src/core/pipelines/parse-contract.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseFrontmatter } from \"../../utils/frontmatter.ts\";\nimport { isPlainRecord } from \"../util/value-guards.ts\";\nimport {\n\tMAX_CONTRACT_PROCESS_CHARS,\n\tMAX_HUMAN_CHECK_CHARS,\n\tMAX_PIPELINE_NAME_LENGTH,\n\ttype PipelineForm,\n\ttype PipelineInputRef,\n\ttype StageContract,\n} from \"./types.ts\";\n\nconst FORMS: readonly PipelineForm[] = [\n\t\"pipeline\",\n\t\"umbrella\",\n\t\"record-library\",\n\t\"knowledge-bundle\",\n\t\"context-map\",\n\t\"system-map\",\n];\n\nexport interface ParsedWorkspaceContract {\n\tname?: string;\n\tdescription?: string;\n\tform: PipelineForm;\n\tbody: string;\n}\n\nfunction section(body: string, heading: string): string {\n\tconst pattern = new RegExp(`^##\\\\s+${heading}\\\\s*$`, \"im\");\n\tconst start = body.search(pattern);\n\tif (start === -1) return \"\";\n\tconst after = body.slice(start).split(\"\\n\").slice(1);\n\tconst lines: string[] = [];\n\tfor (const line of after) {\n\t\tif (/^##\\s+/.test(line)) break;\n\t\tlines.push(line);\n\t}\n\treturn lines.join(\"\\n\").trim();\n}\n\nfunction listLines(text: string): string[] {\n\tconst items: string[] = [];\n\tfor (const raw of text.split(\"\\n\")) {\n\t\tconst match = raw.match(/^\\s*(?:[-*]|\\d+\\.)\\s+(.+)$/);\n\t\tif (match) items.push(match[1].trim());\n\t}\n\treturn items;\n}\n\nfunction classifyInput(line: string): PipelineInputRef | undefined {\n\tconst working = line.match(/^(?:Working(?:\\s+\\(this run\\))?|4|Layer\\s*4)\\s*:\\s*(.+)$/i);\n\tif (working) return { kind: \"working\", path: working[1].trim() };\n\tconst reference = line.match(/^(?:Reference(?:\\s+\\(every run\\))?|3|Layer\\s*3)\\s*:\\s*(.+)$/i);\n\tif (reference) return { kind: \"reference\", path: reference[1].trim() };\n\tconst numbered = line.match(/^([34])\\s*:\\s*(.+)$/);\n\tif (numbered) return { kind: numbered[1] === \"3\" ? \"reference\" : \"working\", path: numbered[2].trim() };\n\treturn undefined;\n}\n\nexport function parseWorkspaceFrontmatter(content: string): ParsedWorkspaceContract {\n\tconst parsed = parseFrontmatter<Record<string, unknown>>(content);\n\tconst fm = isPlainRecord(parsed.frontmatter) ? parsed.frontmatter : {};\n\tconst name = typeof fm.name === \"string\" ? fm.name.trim() : undefined;\n\tconst description = typeof fm.description === \"string\" ? fm.description.trim() : undefined;\n\tconst formRaw = typeof fm.form === \"string\" ? fm.form.trim() : \"pipeline\";\n\tconst form = FORMS.includes(formRaw as PipelineForm) ? (formRaw as PipelineForm) : \"pipeline\";\n\tif (name && name.length > MAX_PIPELINE_NAME_LENGTH) {\n\t\tthrow new Error(`Pipeline name exceeds ${MAX_PIPELINE_NAME_LENGTH} characters.`);\n\t}\n\treturn { name, description, form, body: parsed.body };\n}\n\nexport function parseStageContract(content: string): StageContract {\n\tconst { body } = parseFrontmatter(content);\n\tconst titleLine = body.split(\"\\n\").find((line) => line.startsWith(\"# \")) ?? \"\";\n\tconst title = titleLine.replace(/^#\\s+/, \"\").trim();\n\tconst oneJobMatch = body.match(/^One job:\\s*(.+)$/im);\n\tconst inputsSection = section(body, \"Inputs\");\n\tconst processSection = section(body, \"Process\");\n\tconst outputsSection = section(body, \"Outputs\");\n\tconst humanSection = section(body, \"Human check\");\n\tconst doNot: string[] = [];\n\tconst inputs: PipelineInputRef[] = [];\n\tfor (const raw of inputsSection.split(\"\\n\")) {\n\t\tconst trimmed = raw.trim();\n\t\tif (!trimmed) continue;\n\t\tconst doNotLine = trimmed.match(/^do not load:?\\s*(.+)$/i);\n\t\tif (doNotLine) {\n\t\t\tdoNot.push(doNotLine[1].trim());\n\t\t\tcontinue;\n\t\t}\n\t\tconst listed = trimmed.match(/^(?:[-*]|\\d+\\.)\\s+(.+)$/);\n\t\tconst line = listed ? listed[1].trim() : trimmed;\n\t\tif (/^do not load/i.test(line)) {\n\t\t\tdoNot.push(line.replace(/^do not load:?\\s*/i, \"\").trim());\n\t\t\tcontinue;\n\t\t}\n\t\tconst input = classifyInput(line);\n\t\tif (input) inputs.push(input);\n\t}\n\tconst process = listLines(processSection);\n\tif (process.join(\"\\n\").length > MAX_CONTRACT_PROCESS_CHARS) {\n\t\tthrow new Error(`Stage process exceeds ${MAX_CONTRACT_PROCESS_CHARS} characters.`);\n\t}\n\tconst outputs = listLines(outputsSection).map((line) => line.replace(/\\s*→\\s*output\\/?\\s*$/i, \"\").trim());\n\tconst humanCheck = humanSection.slice(0, MAX_HUMAN_CHECK_CHARS);\n\treturn {\n\t\ttitle,\n\t\toneJob: (oneJobMatch?.[1] ?? \"\").trim(),\n\t\tinputs,\n\t\tdoNotLoad: doNot,\n\t\tprocess,\n\t\toutputs,\n\t\thumanCheck,\n\t};\n}\n"]}

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

@@ -0,0 +1,26 @@
+import { type PipelineDefinition, type PipelineRun, type PipelineStage, type StageDiskStatus, type StageScan } from "./types.ts";
+export declare const RUN_MANIFEST_NAME = "run.json";
+export declare function scanStageOutput(outputDir: string): {
+    status: StageDiskStatus;
+    outputFiles: string[];
+};
+export declare function stageOutputDir(runRoot: string, stage: PipelineStage): string;
+export declare function scanPipelineRun(definition: PipelineDefinition, run: PipelineRun): readonly StageScan[];
+export declare function runManifestPath(runRoot: string): string;
+export declare function parsePipelineRun(value: unknown): PipelineRun | undefined;
+export declare function readPipelineRun(runRoot: string): PipelineRun | undefined;
+export declare function writePipelineRun(run: PipelineRun): void;
+export declare function createPipelineRunRoot(cwd: string, runId: string): string;
+export declare function instantiatePipelineRun(args: {
+    definition: PipelineDefinition;
+    runId: string;
+    runRoot: string;
+    goalId?: string;
+    now: string;
+}): PipelineRun;
+export declare function persistPipelineRun(run: PipelineRun, now: string): PipelineRun;
+export declare function findActivePipelineRun(cwd: string): PipelineRun | undefined;
+export declare function loadPipelineRunById(cwd: string, runId: string): PipelineRun | undefined;
+export declare function decodePipelineRunPayload(data: unknown): PipelineRun | undefined;
+export declare function pipelineRunParentDir(runRoot: string): string;
+//# sourceMappingURL=run-state.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,135 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { writeFileAtomicSync } from "../util/atomic-file.js";
+import { isPlainRecord } from "../util/value-guards.js";
+import { projectPipelineRunsDir } from "./discover.js";
+import { clonePipelineRun, isPipelineRun, } from "./types.js";
+export const RUN_MANIFEST_NAME = "run.json";
+function isRealOutputFile(name) {
+    return name !== ".gitkeep" && name !== ".DS_Store" && !name.startsWith(".");
+}
+export function scanStageOutput(outputDir) {
+    if (!existsSync(outputDir))
+        return { status: "empty", outputFiles: [] };
+    try {
+        const outputFiles = readdirSync(outputDir)
+            .filter((name) => {
+            if (!isRealOutputFile(name))
+                return false;
+            try {
+                return statSync(join(outputDir, name)).isFile();
+            }
+            catch {
+                return false;
+            }
+        })
+            .sort();
+        return { status: outputFiles.length > 0 ? "complete" : "empty", outputFiles };
+    }
+    catch {
+        return { status: "empty", outputFiles: [] };
+    }
+}
+export function stageOutputDir(runRoot, stage) {
+    return join(runRoot, stage.folderName, "output");
+}
+export function scanPipelineRun(definition, run) {
+    return definition.stages.map((stage) => {
+        const scanned = scanStageOutput(stageOutputDir(run.runRoot, stage));
+        return { stageId: stage.id, status: scanned.status, outputFiles: scanned.outputFiles };
+    });
+}
+export function runManifestPath(runRoot) {
+    return join(runRoot, RUN_MANIFEST_NAME);
+}
+export function parsePipelineRun(value) {
+    if (!isPipelineRun(value))
+        return undefined;
+    return clonePipelineRun(value);
+}
+export function readPipelineRun(runRoot) {
+    try {
+        const parsed = JSON.parse(readFileSync(runManifestPath(runRoot), "utf8"));
+        const run = parsePipelineRun(parsed);
+        if (!run || run.runRoot !== runRoot)
+            return undefined;
+        return run;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writePipelineRun(run) {
+    mkdirSync(run.runRoot, { recursive: true });
+    writeFileAtomicSync(runManifestPath(run.runRoot), `${JSON.stringify(run, null, 2)}\n`);
+}
+export function createPipelineRunRoot(cwd, runId) {
+    return join(projectPipelineRunsDir(cwd), runId);
+}
+export function instantiatePipelineRun(args) {
+    const first = args.definition.stages[0];
+    if (!first)
+        throw new Error("Pipeline definition has no stages.");
+    for (const stage of args.definition.stages) {
+        mkdirSync(stageOutputDir(args.runRoot, stage), { recursive: true });
+    }
+    const run = {
+        version: 1,
+        revision: 1,
+        runId: args.runId,
+        pipelineName: args.definition.name,
+        definitionPath: args.definition.rootDir,
+        runRoot: args.runRoot,
+        currentStageId: first.id,
+        status: "active",
+        goalId: args.goalId,
+        createdAt: args.now,
+        updatedAt: args.now,
+    };
+    writePipelineRun(run);
+    return run;
+}
+export function persistPipelineRun(run, now) {
+    const next = { ...run, revision: run.revision + 1, updatedAt: now };
+    writePipelineRun(next);
+    return next;
+}
+export function findActivePipelineRun(cwd) {
+    const root = projectPipelineRunsDir(cwd);
+    if (!existsSync(root))
+        return undefined;
+    let latest;
+    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;
+        }
+    }
+    catch {
+        return latest;
+    }
+    return latest;
+}
+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;
+}
+export function decodePipelineRunPayload(data) {
+    if (!isPlainRecord(data))
+        return undefined;
+    const value = data.run ?? data;
+    return parsePipelineRun(value);
+}
+export function pipelineRunParentDir(runRoot) {
+    return dirname(runRoot);
+}
+//# sourceMappingURL=run-state.js.map

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

@@ -0,0 +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"]}

package/dist/core/pipelines/session-pipeline-run.d.ts

@@ -0,0 +1,6 @@
+import type { SessionManager } from "@caupulican/pi-agent-core/node";
+import { type PipelineRun } from "./types.ts";
+export declare function appendPipelineRunSnapshot(sessionManager: Pick<SessionManager, "appendCustomEntry">, run: PipelineRun): string;
+export declare function decodePipelineRunSnapshotPayload(data: unknown): PipelineRun | undefined;
+export declare function getLatestPipelineRunSnapshot(sessionManager: Pick<SessionManager, "getLatestCustomEntryOnBranch">): PipelineRun | undefined;
+//# sourceMappingURL=session-pipeline-run.d.ts.map

package/dist/core/pipelines/session-pipeline-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pipeline-run.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/session-pipeline-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAOrE,OAAO,EAA6D,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AASzG,wBAAgB,yBAAyB,CACxC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC,EACzD,GAAG,EAAE,WAAW,GACd,MAAM,CAER;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAEvF;AAED,wBAAgB,4BAA4B,CAC3C,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,8BAA8B,CAAC,GAClE,WAAW,GAAG,SAAS,CAEzB"}

package/dist/core/pipelines/session-pipeline-run.js

@@ -0,0 +1,18 @@
+import { appendSessionSnapshot, decodeSessionSnapshotPayload, getLatestSessionSnapshotOnBranch, } from "../session-snapshot.js";
+import { clonePipelineRun, isPipelineRun, PIPELINE_RUN_CUSTOM_TYPE } from "./types.js";
+const PIPELINE_RUN_SNAPSHOT_CODEC = {
+    customType: PIPELINE_RUN_CUSTOM_TYPE,
+    valueKey: "run",
+    isValue: isPipelineRun,
+    clone: clonePipelineRun,
+};
+export function appendPipelineRunSnapshot(sessionManager, run) {
+    return appendSessionSnapshot(sessionManager, PIPELINE_RUN_SNAPSHOT_CODEC, run);
+}
+export function decodePipelineRunSnapshotPayload(data) {
+    return decodeSessionSnapshotPayload(data, PIPELINE_RUN_SNAPSHOT_CODEC);
+}
+export function getLatestPipelineRunSnapshot(sessionManager) {
+    return getLatestSessionSnapshotOnBranch(sessionManager, PIPELINE_RUN_SNAPSHOT_CODEC);
+}
+//# sourceMappingURL=session-pipeline-run.js.map

package/dist/core/pipelines/session-pipeline-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pipeline-run.js","sourceRoot":"","sources":["../../../src/core/pipelines/session-pipeline-run.ts"],"names":[],"mappings":"AACA,OAAO,EACN,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,GAEhC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,wBAAwB,EAAoB,MAAM,YAAY,CAAC;AAEzG,MAAM,2BAA2B,GAA6C;IAC7E,UAAU,EAAE,wBAAwB;IACpC,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,aAAa;IACtB,KAAK,EAAE,gBAAgB;CACvB,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACxC,cAAyD,EACzD,GAAgB;IAEhB,OAAO,qBAAqB,CAAC,cAAc,EAAE,2BAA2B,EAAE,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAAa;IAC7D,OAAO,4BAA4B,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC3C,cAAoE;IAEpE,OAAO,gCAAgC,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;AACtF,CAAC","sourcesContent":["import type { SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport {\n\tappendSessionSnapshot,\n\tdecodeSessionSnapshotPayload,\n\tgetLatestSessionSnapshotOnBranch,\n\ttype SessionSnapshotCodec,\n} from \"../session-snapshot.ts\";\nimport { clonePipelineRun, isPipelineRun, PIPELINE_RUN_CUSTOM_TYPE, type PipelineRun } from \"./types.ts\";\n\nconst PIPELINE_RUN_SNAPSHOT_CODEC: SessionSnapshotCodec<PipelineRun, \"run\"> = {\n\tcustomType: PIPELINE_RUN_CUSTOM_TYPE,\n\tvalueKey: \"run\",\n\tisValue: isPipelineRun,\n\tclone: clonePipelineRun,\n};\n\nexport function appendPipelineRunSnapshot(\n\tsessionManager: Pick<SessionManager, \"appendCustomEntry\">,\n\trun: PipelineRun,\n): string {\n\treturn appendSessionSnapshot(sessionManager, PIPELINE_RUN_SNAPSHOT_CODEC, run);\n}\n\nexport function decodePipelineRunSnapshotPayload(data: unknown): PipelineRun | undefined {\n\treturn decodeSessionSnapshotPayload(data, PIPELINE_RUN_SNAPSHOT_CODEC);\n}\n\nexport function getLatestPipelineRunSnapshot(\n\tsessionManager: Pick<SessionManager, \"getLatestCustomEntryOnBranch\">,\n): PipelineRun | undefined {\n\treturn getLatestSessionSnapshotOnBranch(sessionManager, PIPELINE_RUN_SNAPSHOT_CODEC);\n}\n"]}

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

@@ -0,0 +1,91 @@
+/** ICM pipeline form: numbered stages, factory vs product, status from files. */
+export declare const PIPELINE_STAGE_FOLDER_RE: RegExp;
+export declare const MAX_PIPELINE_STAGES = 32;
+export declare const MAX_PIPELINE_NAME_LENGTH = 64;
+export declare const MAX_CONTRACT_PROCESS_CHARS = 4000;
+export declare const MAX_HUMAN_CHECK_CHARS = 1000;
+export declare const MAX_STAGE_CONTEXT_CHARS = 8000;
+export declare const MAX_LAYER_FILE_CHARS = 4000;
+export type PipelineForm = "pipeline" | "umbrella" | "record-library" | "knowledge-bundle" | "context-map" | "system-map";
+export type ContextLayer = 0 | 1 | 2 | 3 | 4;
+export type InputKind = "working" | "reference";
+export interface PipelineInputRef {
+    kind: InputKind;
+    path: string;
+}
+export interface StageContract {
+    title: string;
+    oneJob: string;
+    inputs: readonly PipelineInputRef[];
+    doNotLoad: readonly string[];
+    process: readonly string[];
+    outputs: readonly string[];
+    humanCheck: string;
+}
+export interface PipelineStage {
+    id: string;
+    ordinal: number;
+    slug: string;
+    folderName: string;
+    contractPath: string;
+    outputDir: string;
+    contract: StageContract;
+}
+export type StageDiskStatus = "empty" | "complete";
+export interface PipelineDefinition {
+    name: string;
+    description: string;
+    form: PipelineForm;
+    rootDir: string;
+    entryFile: string;
+    routingPath: string;
+    factoryDir: string;
+    stagesDir: string;
+    stages: readonly PipelineStage[];
+}
+export type PipelineRunStatus = "active" | "completed" | "abandoned";
+export interface PipelineRun {
+    version: 1;
+    revision: number;
+    runId: string;
+    pipelineName: string;
+    definitionPath: string;
+    runRoot: string;
+    currentStageId: string;
+    status: PipelineRunStatus;
+    goalId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StageScan {
+    stageId: string;
+    status: StageDiskStatus;
+    outputFiles: readonly string[];
+}
+export interface IncrementResult {
+    surface: "pipeline" | "task_steps" | "goal";
+    from?: string;
+    to?: string;
+    completed: boolean;
+    detail: string;
+}
+export interface AssembledLayer {
+    layer: ContextLayer;
+    path: string;
+    label: string;
+    text: string;
+    truncated: boolean;
+}
+export interface AssembledStageContext {
+    stageId: string;
+    layers: readonly AssembledLayer[];
+    text: string;
+    tokenEstimate: number;
+}
+export declare const PIPELINE_RUN_CUSTOM_TYPE = "pipeline_run";
+export declare const PIPELINE_CONTEXT_MARKER = "<pipeline_context";
+export declare function isPipelineForm(value: unknown): value is PipelineForm;
+export declare function isPipelineRun(value: unknown): value is PipelineRun;
+export declare function clonePipelineRun(run: PipelineRun): PipelineRun;
+export declare function isPipelineRunActive(run: Pick<PipelineRun, "status">): boolean;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/pipelines/types.js

@@ -0,0 +1,44 @@
+/** ICM pipeline form: numbered stages, factory vs product, status from files. */
+export const PIPELINE_STAGE_FOLDER_RE = /^(\d{2})_([a-z0-9][a-z0-9-]{0,62})$/;
+export const MAX_PIPELINE_STAGES = 32;
+export const MAX_PIPELINE_NAME_LENGTH = 64;
+export const MAX_CONTRACT_PROCESS_CHARS = 4_000;
+export const MAX_HUMAN_CHECK_CHARS = 1_000;
+export const MAX_STAGE_CONTEXT_CHARS = 8_000;
+export const MAX_LAYER_FILE_CHARS = 4_000;
+export const PIPELINE_RUN_CUSTOM_TYPE = "pipeline_run";
+export const PIPELINE_CONTEXT_MARKER = "<pipeline_context";
+export function isPipelineForm(value) {
+    return (value === "pipeline" ||
+        value === "umbrella" ||
+        value === "record-library" ||
+        value === "knowledge-bundle" ||
+        value === "context-map" ||
+        value === "system-map");
+}
+export function isPipelineRun(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return (record.version === 1 &&
+        typeof record.revision === "number" &&
+        Number.isInteger(record.revision) &&
+        record.revision >= 0 &&
+        typeof record.runId === "string" &&
+        record.runId.length > 0 &&
+        typeof record.pipelineName === "string" &&
+        typeof record.definitionPath === "string" &&
+        typeof record.runRoot === "string" &&
+        typeof record.currentStageId === "string" &&
+        (record.status === "active" || record.status === "completed" || record.status === "abandoned") &&
+        typeof record.createdAt === "string" &&
+        typeof record.updatedAt === "string" &&
+        (record.goalId === undefined || typeof record.goalId === "string"));
+}
+export function clonePipelineRun(run) {
+    return { ...run };
+}
+export function isPipelineRunActive(run) {
+    return run.status === "active";
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/pipelines/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAkG1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,OAAO,CACN,KAAK,KAAK,UAAU;QACpB,KAAK,KAAK,UAAU;QACpB,KAAK,KAAK,gBAAgB;QAC1B,KAAK,KAAK,kBAAkB;QAC5B,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,YAAY,CACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,CACN,MAAM,CAAC,OAAO,KAAK,CAAC;QACpB,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACnC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,MAAM,CAAC,QAAQ,IAAI,CAAC;QACpB,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAChC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACvB,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;QACvC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QACzC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QACzC,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;QAC9F,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAChD,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAgC;IACnE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC;AAChC,CAAC","sourcesContent":["/** ICM pipeline form: numbered stages, factory vs product, status from files. */\n\nexport const PIPELINE_STAGE_FOLDER_RE = /^(\\d{2})_([a-z0-9][a-z0-9-]{0,62})$/;\nexport const MAX_PIPELINE_STAGES = 32;\nexport const MAX_PIPELINE_NAME_LENGTH = 64;\nexport const MAX_CONTRACT_PROCESS_CHARS = 4_000;\nexport const MAX_HUMAN_CHECK_CHARS = 1_000;\nexport const MAX_STAGE_CONTEXT_CHARS = 8_000;\nexport const MAX_LAYER_FILE_CHARS = 4_000;\n\nexport type PipelineForm =\n\t| \"pipeline\"\n\t| \"umbrella\"\n\t| \"record-library\"\n\t| \"knowledge-bundle\"\n\t| \"context-map\"\n\t| \"system-map\";\n\nexport type ContextLayer = 0 | 1 | 2 | 3 | 4;\n\nexport type InputKind = \"working\" | \"reference\";\n\nexport interface PipelineInputRef {\n\tkind: InputKind;\n\tpath: string;\n}\n\nexport interface StageContract {\n\ttitle: string;\n\toneJob: string;\n\tinputs: readonly PipelineInputRef[];\n\tdoNotLoad: readonly string[];\n\tprocess: readonly string[];\n\toutputs: readonly string[];\n\thumanCheck: string;\n}\n\nexport interface PipelineStage {\n\tid: string;\n\tordinal: number;\n\tslug: string;\n\tfolderName: string;\n\tcontractPath: string;\n\toutputDir: string;\n\tcontract: StageContract;\n}\n\nexport type StageDiskStatus = \"empty\" | \"complete\";\n\nexport interface PipelineDefinition {\n\tname: string;\n\tdescription: string;\n\tform: PipelineForm;\n\trootDir: string;\n\tentryFile: string;\n\troutingPath: string;\n\tfactoryDir: string;\n\tstagesDir: string;\n\tstages: readonly PipelineStage[];\n}\n\nexport type PipelineRunStatus = \"active\" | \"completed\" | \"abandoned\";\n\nexport interface PipelineRun {\n\tversion: 1;\n\trevision: number;\n\trunId: string;\n\tpipelineName: string;\n\tdefinitionPath: string;\n\trunRoot: string;\n\tcurrentStageId: string;\n\tstatus: PipelineRunStatus;\n\tgoalId?: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\nexport interface StageScan {\n\tstageId: string;\n\tstatus: StageDiskStatus;\n\toutputFiles: readonly string[];\n}\n\nexport interface IncrementResult {\n\tsurface: \"pipeline\" | \"task_steps\" | \"goal\";\n\tfrom?: string;\n\tto?: string;\n\tcompleted: boolean;\n\tdetail: string;\n}\n\nexport interface AssembledLayer {\n\tlayer: ContextLayer;\n\tpath: string;\n\tlabel: string;\n\ttext: string;\n\ttruncated: boolean;\n}\n\nexport interface AssembledStageContext {\n\tstageId: string;\n\tlayers: readonly AssembledLayer[];\n\ttext: string;\n\ttokenEstimate: number;\n}\n\nexport const PIPELINE_RUN_CUSTOM_TYPE = \"pipeline_run\";\nexport const PIPELINE_CONTEXT_MARKER = \"<pipeline_context\";\n\nexport function isPipelineForm(value: unknown): value is PipelineForm {\n\treturn (\n\t\tvalue === \"pipeline\" ||\n\t\tvalue === \"umbrella\" ||\n\t\tvalue === \"record-library\" ||\n\t\tvalue === \"knowledge-bundle\" ||\n\t\tvalue === \"context-map\" ||\n\t\tvalue === \"system-map\"\n\t);\n}\n\nexport function isPipelineRun(value: unknown): value is PipelineRun {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tconst record = value as Record<string, unknown>;\n\treturn (\n\t\trecord.version === 1 &&\n\t\ttypeof record.revision === \"number\" &&\n\t\tNumber.isInteger(record.revision) &&\n\t\trecord.revision >= 0 &&\n\t\ttypeof record.runId === \"string\" &&\n\t\trecord.runId.length > 0 &&\n\t\ttypeof record.pipelineName === \"string\" &&\n\t\ttypeof record.definitionPath === \"string\" &&\n\t\ttypeof record.runRoot === \"string\" &&\n\t\ttypeof record.currentStageId === \"string\" &&\n\t\t(record.status === \"active\" || record.status === \"completed\" || record.status === \"abandoned\") &&\n\t\ttypeof record.createdAt === \"string\" &&\n\t\ttypeof record.updatedAt === \"string\" &&\n\t\t(record.goalId === undefined || typeof record.goalId === \"string\")\n\t);\n}\n\nexport function clonePipelineRun(run: PipelineRun): PipelineRun {\n\treturn { ...run };\n}\n\nexport function isPipelineRunActive(run: Pick<PipelineRun, \"status\">): boolean {\n\treturn run.status === \"active\";\n}\n"]}

package/dist/core/reflection-controller.d.ts

@@ -47,6 +47,8 @@ export interface ReflectionControllerDeps {
     getReflectionSignal(): AbortSignal;
     /** Archive a promoted skill (rollback of a `promote_skill` write). */
     archivePromotedSkill(name: string): boolean;
+    /** Make a just-written or archived skill visible to this session's skill vault. */
+    refreshLiveSkills?(): void;
     /** G3/G8 autonomy telemetry sink for learning-gate outcomes and approval requests. */
     emitAutonomyTelemetry(event: AutonomyTelemetryEvent): void;
     /** Account the reflection pass's token spend into the cost roll-up (idempotent on reportId). */

package/dist/core/reflection-controller.d.ts.map

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