@caupulican/pi-adaptative 0.90.11 → 0.91.2

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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"}

package/dist/core/reflection-controller.js

@@ -432,40 +432,59 @@ export class ReflectionController {
             }
             const explicitUserMemoryWrite = input.explicitUserMemoryInstruction === true &&
                 (write.kind === "memory_add" || write.kind === "memory_replace");
-            const decision = explicitUserMemoryWrite
-                ? {
+            // Additive skill promotion is the skill counterpart of a memory fact: a repeatable
+            // procedure should land as a loadable SKILL.md (overlap audit still holds the write).
+            // An owner who enabled auto-apply and omitted "skill" from the allow-list keeps that ceiling.
+            const ownerExcludedSkillLayer = policy.enabled && policy.autoApplyEnabled && !policy.allowedAutoApplyLayers.includes("skill");
+            const additiveSkillPromotion = write.kind === "promote_skill" && !ownerExcludedSkillLayer;
+            let decision;
+            if (explicitUserMemoryWrite) {
+                decision = {
                     kind: "apply",
                     reasonCode: "explicit_user_memory_instruction",
                     confidence: 100,
                     summary: proposal.summary,
                     requiresApproval: false,
-                }
-                : policy.enabled
-                    ? evaluateLearningDecision({
-                        proposal,
-                        confidence: policy.reflectionSourceConfidence,
-                        observations,
-                        // A replace/remove supersedes an existing durable fact — the reflection engine's
-                        // confront-before-write conflict signal — so it routes through approval instead of
-                        // silently overwriting prior memory. Additive writes contradict nothing.
-                        contradictions: contradictionsForReflectionWrite(write),
-                        settings: {
-                            enabled: true,
-                            autoApplyEnabled: policy.autoApplyEnabled,
-                            confidenceThreshold: policy.confidenceThreshold,
-                            minObservations: policy.minObservations,
-                            allowedAutoApplyLayers: policy.allowedAutoApplyLayers,
-                            requireRollbackPlan: policy.requireRollbackPlan,
-                            autoApplySupersessions: policy.autoApplySupersessions,
-                        },
-                    })
-                    : {
-                        kind: "apply",
-                        reasonCode: "learning_policy_disabled_legacy_apply",
-                        confidence: 0,
-                        summary: proposal.summary,
-                        requiresApproval: false,
-                    };
+                };
+            }
+            else if (additiveSkillPromotion) {
+                decision = {
+                    kind: "apply",
+                    reasonCode: "additive_skill_promotion",
+                    confidence: policy.reflectionSourceConfidence,
+                    summary: proposal.summary,
+                    requiresApproval: false,
+                };
+            }
+            else if (policy.enabled) {
+                decision = evaluateLearningDecision({
+                    proposal,
+                    confidence: policy.reflectionSourceConfidence,
+                    observations,
+                    // A replace/remove supersedes an existing durable fact — the reflection engine's
+                    // confront-before-write conflict signal — so it routes through approval instead of
+                    // silently overwriting prior memory. Additive writes contradict nothing.
+                    contradictions: contradictionsForReflectionWrite(write),
+                    settings: {
+                        enabled: true,
+                        autoApplyEnabled: policy.autoApplyEnabled,
+                        confidenceThreshold: policy.confidenceThreshold,
+                        minObservations: policy.minObservations,
+                        allowedAutoApplyLayers: policy.allowedAutoApplyLayers,
+                        requireRollbackPlan: policy.requireRollbackPlan,
+                        autoApplySupersessions: policy.autoApplySupersessions,
+                    },
+                });
+            }
+            else {
+                decision = {
+                    kind: "apply",
+                    reasonCode: "learning_policy_disabled_legacy_apply",
+                    confidence: 0,
+                    summary: proposal.summary,
+                    requiresApproval: false,
+                };
+            }
             this.deps.saveLearningDecisionSnapshot(decision);
             // G3: learning-gate outcome. Codes/numbers only — never the proposal summary/memory text.
             this.deps.emitAutonomyTelemetry({
@@ -607,6 +626,7 @@ export class ReflectionController {
                 if (!this.deps.archivePromotedSkill(rollback.target)) {
                     return { ok: false, reason: "skill_archive_failed" };
                 }
+                this.deps.refreshLiveSkills?.();
                 break;
             }
         }
@@ -634,7 +654,10 @@ export class ReflectionController {
         // R7 memory-to-behavior: a recurring procedure is compiled into an executable skill file rather
         // than stored as a flat fact. Written under the agent skills dir so it loads like any user skill.
         if (write.kind === "promote_skill") {
-            return this._promoteReflectionSkill(write.name, write.description, write.body);
+            const promoted = this._promoteReflectionSkill(write.name, write.description, write.body);
+            if (promoted)
+                this.deps.refreshLiveSkills?.();
+            return promoted;
         }
         const memTool = this.deps
             .getMemoryManager()