npm - stageflow - Versions diffs - 0.1.0 → 0.3.0 - Mend

stageflow 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (132) hide show

package/README.md +190 -13
package/dist/agent/activity.d.ts +10 -1
package/dist/agent/activity.js +37 -2
package/dist/agent/activityObserver.d.ts +5 -1
package/dist/agent/activityObserver.js +174 -11
package/dist/agent/fakeAgent.js +4 -0
package/dist/agent/piAdapter.d.ts +16 -0
package/dist/agent/piAdapter.js +88 -21
package/dist/agent/port.d.ts +2 -0
package/dist/agent/providerAuth.js +12 -7
package/dist/catalog/displayCatalogPath.d.ts +12 -0
package/dist/catalog/displayCatalogPath.js +28 -0
package/dist/cli/ciIdentity.d.ts +14 -0
package/dist/cli/ciIdentity.js +52 -0
package/dist/cli/initCommand.d.ts +9 -0
package/dist/cli/initCommand.js +71 -0
package/dist/cli/initTemplates.d.ts +3 -0
package/dist/cli/initTemplates.js +19 -0
package/dist/cli/operatorCatalog.d.ts +10 -0
package/dist/cli/operatorCatalog.js +16 -0
package/dist/cli/runCommand.d.ts +26 -0
package/dist/cli/runCommand.js +209 -0
package/dist/cli/runOutput.d.ts +19 -0
package/dist/cli/runOutput.js +125 -0
package/dist/cli/validateCommand.d.ts +1 -1
package/dist/cli/validateCommand.js +20 -3
package/dist/cli.d.ts +12 -1
package/dist/cli.js +82 -66
package/dist/config/browseCatalog.d.ts +45 -0
package/dist/config/browseCatalog.js +170 -0
package/dist/config/createPipeline.d.ts +12 -3
package/dist/config/createPipeline.js +292 -100
package/dist/config/createStage.d.ts +10 -4
package/dist/config/createStage.js +44 -14
package/dist/config/listConfig.d.ts +14 -19
package/dist/config/listConfig.js +26 -191
package/dist/config/listModelsFromManifest.d.ts +2 -0
package/dist/config/listModelsFromManifest.js +4 -0
package/dist/config/loadOutcome.d.ts +4 -0
package/dist/config/loadPipeline.d.ts +1 -15
package/dist/config/loadPipeline.js +84 -142
package/dist/config/loadStage.d.ts +4 -0
package/dist/config/loadStage.js +60 -32
package/dist/config/loadStageflowManifest.d.ts +5 -0
package/dist/config/loadStageflowManifest.js +157 -0
package/dist/config/mergePipelineIncludes.d.ts +9 -0
package/dist/config/mergePipelineIncludes.js +141 -0
package/dist/config/normalizePipelineStageEntry.d.ts +16 -0
package/dist/config/normalizePipelineStageEntry.js +186 -0
package/dist/config/pipelineStageKeys.d.ts +4 -0
package/dist/config/pipelineStageKeys.js +14 -0
package/dist/config/resolveCatalogContext.d.ts +13 -0
package/dist/config/resolveCatalogContext.js +13 -0
package/dist/config/resolveForkEmitContext.d.ts +3 -0
package/dist/config/resolveForkEmitContext.js +12 -0
package/dist/config/resolvePipelineDag.d.ts +5 -1
package/dist/config/resolvePipelineDag.js +54 -36
package/dist/config/scanCatalogPaths.d.ts +4 -0
package/dist/config/scanCatalogPaths.js +83 -0
package/dist/config/validateCatalog.d.ts +22 -4
package/dist/config/validateCatalog.js +169 -132
package/dist/envelope/check.js +7 -0
package/dist/envelope/forkChoice.d.ts +3 -0
package/dist/envelope/forkChoice.js +47 -0
package/dist/index.d.ts +4 -0
package/dist/index.js +4 -0
package/dist/mcp/projectRun.d.ts +3 -0
package/dist/mcp/projectRun.js +7 -0
package/dist/mcp/server.js +1 -1
package/dist/mcp/tools.js +28 -11
package/dist/project/findProjectRoot.d.ts +2 -0
package/dist/project/findProjectRoot.js +51 -0
package/dist/project/globalHome.d.ts +2 -0
package/dist/project/globalHome.js +19 -0
package/dist/project/resolveProjectContext.d.ts +9 -0
package/dist/project/resolveProjectContext.js +38 -0
package/dist/project/resolveStageflowContext.d.ts +11 -0
package/dist/project/resolveStageflowContext.js +66 -0
package/dist/runstore/normalizeCatalogPath.d.ts +1 -0
package/dist/runstore/normalizeCatalogPath.js +4 -0
package/dist/runstore/port.d.ts +15 -0
package/dist/runstore/runProjection.js +11 -1
package/dist/runstore/sqlite/SqliteRunStore.js +46 -4
package/dist/runstore/sqlite/schema.d.ts +1 -1
package/dist/runstore/sqlite/schema.js +7 -1
package/dist/runtime/credentialBinding.d.ts +8 -6
package/dist/runtime/credentialBinding.js +18 -24
package/dist/runtime/pipelineRunner.d.ts +11 -0
package/dist/runtime/pipelineRunner.js +25 -1
package/dist/runtime/pipelineScheduler.d.ts +3 -0
package/dist/runtime/pipelineScheduler.js +70 -14
package/dist/runtime/reloadRunCatalog.d.ts +5 -0
package/dist/runtime/reloadRunCatalog.js +44 -0
package/dist/runtime/resumeReconstruct.d.ts +1 -0
package/dist/runtime/resumeReconstruct.js +27 -10
package/dist/runtime/runManager.d.ts +8 -0
package/dist/runtime/runManager.js +49 -18
package/dist/runtime/settingsFile.d.ts +12 -0
package/dist/runtime/settingsFile.js +87 -6
package/dist/runtime/stageAttemptBootstrap.js +3 -0
package/dist/runtime/stageProcessLauncher.d.ts +1 -0
package/dist/runtime/stageProcessLauncher.js +6 -0
package/dist/runtime/stageRecovery.js +3 -1
package/dist/runtime/stageRunner.d.ts +2 -0
package/dist/runtime/stageRunner.js +9 -2
package/dist/runtime/stageWorker.js +4 -6
package/dist/runtime/stageWorkerProtocol.d.ts +1 -0
package/dist/server/http.js +33 -9
package/dist/tools/emitStageEnvelope.d.ts +3 -1
package/dist/tools/emitStageEnvelope.js +11 -1
package/dist/types/envelope.d.ts +1 -0
package/dist/types/forkChoice.d.ts +8 -0
package/dist/types/forkChoice.js +1 -0
package/dist/types/pipeline.d.ts +51 -2
package/dist/types/stageflowManifest.d.ts +23 -0
package/dist/types/stageflowManifest.js +1 -0
package/dist/ui/assets/index-CFSzDZje.js +118 -0
package/dist/ui/assets/{index-DCsDopak.css → index-DefBlEvN.css} +1 -1
package/dist/ui/index.html +3 -2
package/dist/ui/stageflow-icon.svg +12 -0
package/package.json +7 -5
package/dist/agent/cursorExtension.d.ts +0 -12
package/dist/agent/cursorExtension.js +0 -88
package/dist/runstore/catalog.d.ts +0 -8
package/dist/runstore/catalog.js +0 -16
package/dist/runstore/disk/DiskRunStore.d.ts +0 -30
package/dist/runstore/disk/DiskRunStore.js +0 -238
package/dist/runstore/layout.d.ts +0 -22
package/dist/runstore/layout.js +0 -58
package/dist/runtime/hitlSeams.d.ts +0 -38
package/dist/runtime/hitlSeams.js +0 -2
package/dist/ui/assets/index-Cry0Tpfx.js +0 -118

package/dist/ui/index.html CHANGED Viewed

@@ -11,9 +11,10 @@
     </script>
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Figtree:wght@400;500;600;700&display=swap" />
+    <link rel="icon" type="image/svg+xml" href="/stageflow-icon.svg" />
     <title>Stageflow</title>
-    <script type="module" crossorigin src="/assets/index-Cry0Tpfx.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DCsDopak.css">
+    <script type="module" crossorigin src="/assets/index-CFSzDZje.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DefBlEvN.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/ui/stageflow-icon.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none" role="img" aria-label="Stageflow">
+  <path
+    d="M 12 20 C 28 20, 28 44, 52 44"
+    stroke="currentColor"
+    stroke-width="2.5"
+    stroke-linecap="round"
+    fill="none"
+  />
+  <circle cx="12" cy="20" r="5" fill="currentColor"/>
+  <circle cx="32" cy="32" r="5" fill="currentColor"/>
+  <circle cx="52" cy="44" r="5" fill="currentColor" opacity="0.45"/>
+</svg>

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "stageflow",
-  "version": "0.1.0",
-  "description": "Stageflow — personal CLI pipeline runtime for configurable SDLC stages on Pi",
+  "version": "0.3.0",
+  "description": "Stageflow — CLI pipeline runtime for configurable stages on Pi",
   "type": "module",
   "bin": {
     "sf": "./dist/cli.js",
@@ -16,7 +16,7 @@
     "type": "git",
     "url": "git+https://github.com/tejasghutukade/stageflow.git"
   },
-  "homepage": "https://github.com/tejasghutukade/stageflow#readme",
+  "homepage": "https://tejasghutukade.github.io/stageflow/",
   "bugs": {
     "url": "https://github.com/tejasghutukade/stageflow/issues"
   },
@@ -24,8 +24,9 @@
     "cli",
     "pipeline",
     "pi",
-    "sdlc",
-    "agent"
+    "agent",
+    "workflow",
+    "stages"
   ],
   "workspaces": [
     "ui"
@@ -42,6 +43,7 @@
     "ui:astryx": "npm run astryx -w ui",
     "copy:ui-dist": "tsx scripts/copy-ui-dist.ts",
     "verify:pack": "tsx scripts/verify-pack.ts",
+    "validate:examples": "npm run build && tsx scripts/validate-examples.ts",
     "prepublishOnly": "npm run build && npm run ui:build && npm run copy:ui-dist",
     "providers:list-login-capable": "tsx scripts/list-login-capable-providers.ts"
   },

package/dist/agent/cursorExtension.d.ts DELETED Viewed

@@ -1,12 +0,0 @@
-/**
- * Locate the pi-cursor-sdk extension entry without opening full global package
- * discovery. Stages stay sealed; only this allowlisted path is loaded.
- *
- * Resolution order:
- * 1. SOFTWARE_FACTORY_CURSOR_EXTENSION (absolute path to the extension .ts/.js)
- * 2. Path package from ~/.pi/agent/settings.json (same source interactive pi uses)
- * 3. npm install under ~/.pi/agent/npm/node_modules/pi-cursor-sdk
- * 4. Sibling checkout at ../pi-cursor-sdk relative to this repo
- */
-export declare function resolveCursorExtensionPath(): string | undefined;
-export declare function isCursorModelRef(modelRef: string): boolean;

package/dist/agent/cursorExtension.js DELETED Viewed

@@ -1,88 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-/**
- * Locate the pi-cursor-sdk extension entry without opening full global package
- * discovery. Stages stay sealed; only this allowlisted path is loaded.
- *
- * Resolution order:
- * 1. SOFTWARE_FACTORY_CURSOR_EXTENSION (absolute path to the extension .ts/.js)
- * 2. Path package from ~/.pi/agent/settings.json (same source interactive pi uses)
- * 3. npm install under ~/.pi/agent/npm/node_modules/pi-cursor-sdk
- * 4. Sibling checkout at ../pi-cursor-sdk relative to this repo
- */
-export function resolveCursorExtensionPath() {
-    const fromEnv = process.env.SOFTWARE_FACTORY_CURSOR_EXTENSION?.trim();
-    if (fromEnv && existsSync(fromEnv)) {
-        return path.resolve(fromEnv);
-    }
-    const fromSettings = resolveFromPiSettings();
-    if (fromSettings) {
-        return fromSettings;
-    }
-    const npmEntry = path.join(os.homedir(), ".pi", "agent", "npm", "node_modules", "pi-cursor-sdk", "src", "index.ts");
-    if (existsSync(npmEntry)) {
-        return npmEntry;
-    }
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const sibling = path.resolve(here, "../../../pi-cursor-sdk/src/index.ts");
-    if (existsSync(sibling)) {
-        return sibling;
-    }
-    return undefined;
-}
-export function isCursorModelRef(modelRef) {
-    const slash = modelRef.indexOf("/");
-    if (slash <= 0) {
-        return false;
-    }
-    return modelRef.slice(0, slash).toLowerCase() === "cursor";
-}
-function resolveFromPiSettings() {
-    const settingsPath = path.join(os.homedir(), ".pi", "agent", "settings.json");
-    if (!existsSync(settingsPath)) {
-        return undefined;
-    }
-    let settings;
-    try {
-        settings = JSON.parse(readFileSync(settingsPath, "utf8"));
-    }
-    catch {
-        return undefined;
-    }
-    if (!Array.isArray(settings.packages)) {
-        return undefined;
-    }
-    const agentDir = path.join(os.homedir(), ".pi", "agent");
-    for (const entry of settings.packages) {
-        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
-            continue;
-        }
-        const pkg = entry;
-        if (typeof pkg.source !== "string") {
-            continue;
-        }
-        if (!pkg.source.includes("pi-cursor-sdk")) {
-            continue;
-        }
-        const packageRoot = path.resolve(agentDir, pkg.source);
-        if (Array.isArray(pkg.extensions)) {
-            for (const ext of pkg.extensions) {
-                if (typeof ext !== "string") {
-                    continue;
-                }
-                const rel = ext.replace(/^\+/, "");
-                const full = path.resolve(packageRoot, rel);
-                if (existsSync(full)) {
-                    return full;
-                }
-            }
-        }
-        const declared = path.join(packageRoot, "src", "index.ts");
-        if (existsSync(declared)) {
-            return declared;
-        }
-    }
-    return undefined;
-}

package/dist/runstore/catalog.d.ts DELETED Viewed

@@ -1,8 +0,0 @@
-/**
- * @deprecated Prefer RunStore.listRuns / readRun via createRunStore.
- */
-export { deriveStatusFromStages, type StageLogEvent, type StageSnapshot, type RunSummary, type RunDetail, } from "./port.js";
-import type { RunDetail, RunSummary, StageLogEvent } from "./port.js";
-export declare function listRuns(rootDir: string): Promise<RunSummary[]>;
-export declare function readRun(rootDir: string, runId: string): Promise<RunDetail>;
-export declare function readStageLog(runDir: string, stageId: string): Promise<StageLogEvent[]>;

package/dist/runstore/catalog.js DELETED Viewed

@@ -1,16 +0,0 @@
-/**
- * @deprecated Prefer RunStore.listRuns / readRun via createRunStore.
- */
-export { deriveStatusFromStages, } from "./port.js";
-import { DiskRunStore } from "./disk/DiskRunStore.js";
-import { storeRootFor } from "./paths.js";
-import { readStageLogFromDisk } from "./disk/catalogHelpers.js";
-export async function listRuns(rootDir) {
-    return new DiskRunStore(storeRootFor(rootDir)).listRuns();
-}
-export async function readRun(rootDir, runId) {
-    return new DiskRunStore(storeRootFor(rootDir)).readRun(runId);
-}
-export async function readStageLog(runDir, stageId) {
-    return readStageLogFromDisk(runDir, stageId);
-}

package/dist/runstore/disk/DiskRunStore.d.ts DELETED Viewed

@@ -1,30 +0,0 @@
-import type { StageEnvelope } from "../../types/envelope.js";
-import type { StageLogLine } from "../../agent/activity.js";
-import type { CreateRunInput, CreatedRun, RunMeta, RunStatus, RunStore, StageExecution, StageExecutionPatch, StageLogEvent } from "../port.js";
-export declare class DiskRunStore implements RunStore {
-    private readonly storeRoot;
-    constructor(storeRoot: string);
-    getWorkspaceDir(runId: string): string;
-    createRun(input: CreateRunInput): Promise<CreatedRun>;
-    updateRunStatus(runId: string, status: RunStatus): Promise<void>;
-    readRunMeta(runId: string): Promise<RunMeta>;
-    readTaskYaml(runId: string): Promise<string>;
-    ensureStageWorkspace(runId: string, stageId: string): Promise<void>;
-    ensureAttemptWorkspace(runId: string, stageId: string, attempt: number): Promise<void>;
-    createStageExecution(runId: string, stageId: string): Promise<StageExecution>;
-    listStageExecutions(runId: string, stageId: string): Promise<StageExecution[]>;
-    getLatestStageExecution(runId: string, stageId: string): Promise<StageExecution | null>;
-    countStageAttempts(runId: string, stageId: string): Promise<number>;
-    getStageExecution(runId: string, stageId: string, attempt: number): Promise<StageExecution>;
-    updateStageExecution(runId: string, stageId: string, attempt: number, patch: StageExecutionPatch): Promise<void>;
-    writeEnvelope(runId: string, stageId: string, envelope: StageEnvelope, options?: {
-        attempt?: number;
-    }): Promise<void>;
-    readEnvelope(runId: string, stageId: string): Promise<StageEnvelope>;
-    appendStageEvent(runId: string, stageId: string, event: StageLogLine, options?: {
-        attempt?: number;
-    }): Promise<void>;
-    listStageEvents(runId: string, stageId: string, attempt?: number): Promise<StageLogEvent[]>;
-    listRuns(): Promise<import("../port.js").RunSummary[]>;
-    readRun(runId: string): Promise<import("../port.js").RunDetail>;
-}

package/dist/runstore/disk/DiskRunStore.js DELETED Viewed

@@ -1,238 +0,0 @@
-import { appendFile, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { newRunId, runWorkspaceDir, runsDir } from "../paths.js";
-import { agentDir, artifactsDir, attemptAgentDir, attemptArtifactsDir, attemptEnvelopePath, attemptLogPath, envelopePath, stageDir, } from "../workspaceLayout.js";
-import { projectRunDetail, orderStageSnapshots } from "../runProjection.js";
-import { buildStageSnapshotFromStore } from "../stageSnapshot.js";
-import { buildRunSummaryFromDisk, fileExists, listStageIdsFromDisk, readRunMetaFromDisk, readStageLogFromDisk, taskIdFromCopy, } from "./catalogHelpers.js";
-const ensuredStageDirs = new Set();
-const EXECUTIONS_FILE = "executions.json";
-async function readStageLogFile(file) {
-    if (!(await fileExists(file)))
-        return [];
-    const text = await readFile(file, "utf8");
-    return text
-        .split("\n")
-        .map((line) => line.trim())
-        .filter(Boolean)
-        .map((line) => JSON.parse(line));
-}
-async function readExecutionsFromDisk(workspaceDir, stageId) {
-    const file = path.join(workspaceDir, "stages", stageId, EXECUTIONS_FILE);
-    if (!(await fileExists(file)))
-        return [];
-    const parsed = JSON.parse(await readFile(file, "utf8"));
-    return [...parsed].sort((a, b) => a.attempt - b.attempt);
-}
-async function writeExecutionsToDisk(workspaceDir, stageId, executions) {
-    const file = path.join(workspaceDir, "stages", stageId, EXECUTIONS_FILE);
-    await mkdir(path.dirname(file), { recursive: true });
-    const sorted = [...executions].sort((a, b) => a.attempt - b.attempt);
-    await writeFile(file, `${JSON.stringify(sorted, null, 2)}\n`);
-}
-export class DiskRunStore {
-    storeRoot;
-    constructor(storeRoot) {
-        this.storeRoot = storeRoot;
-    }
-    getWorkspaceDir(runId) {
-        return runWorkspaceDir(this.storeRoot, runId);
-    }
-    async createRun(input) {
-        const runId = newRunId();
-        const workspaceDir = this.getWorkspaceDir(runId);
-        await mkdir(workspaceDir, { recursive: true });
-        const now = new Date().toISOString();
-        const meta = {
-            run_id: runId,
-            pipeline_id: input.pipelineId,
-            created_at: now,
-            status: "running",
-            task_id: input.taskId,
-            updated_at: now,
-            ...(input.checkoutRoot !== undefined
-                ? { checkout_root: input.checkoutRoot }
-                : {}),
-            ...(input.pipelineDag ? { pipeline_dag: input.pipelineDag } : {}),
-        };
-        await Promise.all([
-            writeFile(path.join(workspaceDir, "meta.json"), `${JSON.stringify(meta, null, 2)}\n`),
-            writeFile(path.join(workspaceDir, "task.copy.yaml"), input.taskYaml),
-        ]);
-        return { runId, workspaceDir };
-    }
-    async updateRunStatus(runId, status) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        const meta = await readRunMetaFromDisk(workspaceDir);
-        meta.status = status;
-        meta.updated_at = new Date().toISOString();
-        await writeFile(path.join(workspaceDir, "meta.json"), `${JSON.stringify(meta, null, 2)}\n`);
-    }
-    async readRunMeta(runId) {
-        return readRunMetaFromDisk(this.getWorkspaceDir(runId));
-    }
-    async readTaskYaml(runId) {
-        return readFile(path.join(this.getWorkspaceDir(runId), "task.copy.yaml"), "utf8");
-    }
-    async ensureStageWorkspace(runId, stageId) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        const dir = stageDir(workspaceDir, stageId);
-        if (!ensuredStageDirs.has(dir)) {
-            await mkdir(artifactsDir(workspaceDir, stageId), { recursive: true });
-            await mkdir(agentDir(workspaceDir, stageId), { recursive: true });
-            ensuredStageDirs.add(dir);
-        }
-    }
-    async ensureAttemptWorkspace(runId, stageId, attempt) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        const key = `${runId}:${stageId}:${attempt}`;
-        if (!ensuredStageDirs.has(key)) {
-            await mkdir(attemptArtifactsDir(workspaceDir, stageId, attempt), {
-                recursive: true,
-            });
-            await mkdir(attemptAgentDir(workspaceDir, stageId, attempt), {
-                recursive: true,
-            });
-            ensuredStageDirs.add(key);
-        }
-        if (attempt === 1) {
-            await this.ensureStageWorkspace(runId, stageId);
-        }
-    }
-    async createStageExecution(runId, stageId) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        await this.ensureStageWorkspace(runId, stageId);
-        const executions = await readExecutionsFromDisk(workspaceDir, stageId);
-        const attempt = executions.length > 0 ? Math.max(...executions.map((e) => e.attempt)) + 1 : 1;
-        const execution = {
-            run_id: runId,
-            stage_id: stageId,
-            attempt,
-            status: "pending",
-            envelope: null,
-        };
-        executions.push(execution);
-        await writeExecutionsToDisk(workspaceDir, stageId, executions);
-        return execution;
-    }
-    async listStageExecutions(runId, stageId) {
-        return readExecutionsFromDisk(this.getWorkspaceDir(runId), stageId);
-    }
-    async getLatestStageExecution(runId, stageId) {
-        const executions = await this.listStageExecutions(runId, stageId);
-        return executions.length > 0 ? executions[executions.length - 1] : null;
-    }
-    async countStageAttempts(runId, stageId) {
-        const executions = await this.listStageExecutions(runId, stageId);
-        return executions.length;
-    }
-    async getStageExecution(runId, stageId, attempt) {
-        const executions = await this.listStageExecutions(runId, stageId);
-        const found = executions.find((e) => e.attempt === attempt);
-        if (!found) {
-            throw new Error(`Stage execution not found: ${runId}/${stageId} attempt ${attempt}`);
-        }
-        return found;
-    }
-    async updateStageExecution(runId, stageId, attempt, patch) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        const executions = await readExecutionsFromDisk(workspaceDir, stageId);
-        const index = executions.findIndex((e) => e.attempt === attempt);
-        if (index < 0) {
-            throw new Error(`Stage execution not found: ${runId}/${stageId} attempt ${attempt}`);
-        }
-        const current = executions[index];
-        executions[index] = {
-            ...current,
-            ...(patch.status !== undefined ? { status: patch.status } : {}),
-            ...(patch.started_at !== undefined ? { started_at: patch.started_at } : {}),
-            ...(patch.finished_at !== undefined ? { finished_at: patch.finished_at } : {}),
-            ...(patch.envelope !== undefined ? { envelope: patch.envelope } : {}),
-        };
-        await writeExecutionsToDisk(workspaceDir, stageId, executions);
-    }
-    async writeEnvelope(runId, stageId, envelope, options) {
-        const attempt = options?.attempt ?? 1;
-        await this.ensureStageWorkspace(runId, stageId);
-        if (attempt >= 2) {
-            await this.ensureAttemptWorkspace(runId, stageId, attempt);
-        }
-        const workspaceDir = this.getWorkspaceDir(runId);
-        const file = attempt >= 2
-            ? attemptEnvelopePath(workspaceDir, stageId, attempt)
-            : envelopePath(workspaceDir, stageId);
-        await writeFile(file, `${JSON.stringify(envelope, null, 2)}\n`);
-        try {
-            await this.updateStageExecution(runId, stageId, attempt, { envelope });
-        }
-        catch {
-            // no execution row yet
-        }
-    }
-    async readEnvelope(runId, stageId) {
-        const file = envelopePath(this.getWorkspaceDir(runId), stageId);
-        return JSON.parse(await readFile(file, "utf8"));
-    }
-    async appendStageEvent(runId, stageId, event, options) {
-        const attempt = options?.attempt ?? 1;
-        await this.ensureAttemptWorkspace(runId, stageId, attempt);
-        const file = attemptLogPath(this.getWorkspaceDir(runId), stageId, attempt);
-        const line = `${JSON.stringify({ ...event, at: new Date().toISOString() })}\n`;
-        await appendFile(file, line);
-    }
-    async listStageEvents(runId, stageId, attempt) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        if (attempt != null) {
-            return readStageLogFile(attemptLogPath(workspaceDir, stageId, attempt));
-        }
-        const events = [];
-        events.push(...(await readStageLogFromDisk(workspaceDir, stageId)));
-        const attemptsDir = path.join(workspaceDir, "stages", stageId, "attempts");
-        if (await fileExists(attemptsDir)) {
-            const entries = await readdir(attemptsDir, { withFileTypes: true });
-            const attemptNums = entries
-                .filter((e) => e.isDirectory())
-                .map((e) => Number.parseInt(e.name, 10))
-                .filter((n) => Number.isFinite(n) && n >= 2)
-                .sort((a, b) => a - b);
-            for (const n of attemptNums) {
-                events.push(...(await readStageLogFile(attemptLogPath(workspaceDir, stageId, n))));
-            }
-        }
-        return events.sort((a, b) => (a.at ?? "").localeCompare(b.at ?? ""));
-    }
-    async listRuns() {
-        const root = runsDir(this.storeRoot);
-        if (!(await fileExists(root)))
-            return [];
-        const entries = await readdir(root, { withFileTypes: true });
-        const summaries = [];
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            try {
-                summaries.push(await buildRunSummaryFromDisk(path.join(root, entry.name)));
-            }
-            catch {
-                // skip malformed run folders
-            }
-        }
-        summaries.sort((a, b) => b.created_at.localeCompare(a.created_at));
-        return summaries;
-    }
-    async readRun(runId) {
-        const workspaceDir = this.getWorkspaceDir(runId);
-        if (!(await fileExists(path.join(workspaceDir, "meta.json")))) {
-            throw new Error(`Run not found: ${runId}`);
-        }
-        const meta = await readRunMetaFromDisk(workspaceDir);
-        const task_yaml = await readFile(path.join(workspaceDir, "task.copy.yaml"), "utf8");
-        const stageIds = await listStageIdsFromDisk(workspaceDir, meta);
-        const loaded = await Promise.all(stageIds.map((id) => buildStageSnapshotFromStore(this, runId, id, workspaceDir)));
-        const stages = meta.pipeline_dag?.stage_ids?.length
-            ? orderStageSnapshots(meta.pipeline_dag.stage_ids, loaded)
-            : loaded;
-        const task_id = await taskIdFromCopy(workspaceDir, meta);
-        return projectRunDetail({ ...meta, task_id }, stages, task_yaml, meta.pipeline_dag ?? null);
-    }
-}

package/dist/runstore/layout.d.ts DELETED Viewed

@@ -1,22 +0,0 @@
-import type { StageEnvelope } from "../types/envelope.js";
-import type { RunMeta, RunStatus } from "./port.js";
-export type { RunMeta, RunStatus } from "./port.js";
-export { stageDir } from "./paths.js";
-export declare function runsRoot(rootDir: string): string;
-export declare function runDirFor(rootDir: string, runId: string): string;
-export declare function createRun(options: {
-    rootDir: string;
-    pipelineId: string;
-    taskYaml: string;
-    taskId?: string;
-}): Promise<{
-    runId: string;
-    runDir: string;
-}>;
-export declare function writeRunMeta(runDir: string, meta: RunMeta): Promise<void>;
-export declare function readRunMeta(runDir: string): Promise<RunMeta>;
-export declare function updateRunStatus(runDir: string, status: RunStatus): Promise<void>;
-export declare function ensureStageDirs(runDir: string, stageId: string): Promise<string>;
-export declare function writeEnvelope(runDir: string, stageId: string, envelope: StageEnvelope): Promise<string>;
-export declare function appendStageLog(runDir: string, stageId: string, event: Record<string, unknown>): Promise<void>;
-export declare function readEnvelope(runDir: string, stageId: string): Promise<StageEnvelope>;

package/dist/runstore/layout.js DELETED Viewed

@@ -1,58 +0,0 @@
-/**
- * @deprecated Prefer createRunStore() + RunStore. Thin disk helpers for legacy callers.
- */
-import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { DiskRunStore } from "./disk/DiskRunStore.js";
-import { storeRootFor } from "./paths.js";
-export { stageDir } from "./paths.js";
-function disk(rootDir) {
-    return new DiskRunStore(storeRootFor(rootDir));
-}
-export function runsRoot(rootDir) {
-    return path.join(storeRootFor(rootDir), "runs");
-}
-export function runDirFor(rootDir, runId) {
-    return path.join(runsRoot(rootDir), runId);
-}
-export async function createRun(options) {
-    const created = await disk(options.rootDir).createRun({
-        pipelineId: options.pipelineId,
-        taskYaml: options.taskYaml,
-        taskId: options.taskId,
-    });
-    return { runId: created.runId, runDir: created.workspaceDir };
-}
-export async function writeRunMeta(runDir, meta) {
-    await writeFile(path.join(runDir, "meta.json"), `${JSON.stringify(meta, null, 2)}\n`);
-}
-export async function readRunMeta(runDir) {
-    return JSON.parse(await readFile(path.join(runDir, "meta.json"), "utf8"));
-}
-export async function updateRunStatus(runDir, status) {
-    const meta = await readRunMeta(runDir);
-    meta.status = status;
-    meta.updated_at = new Date().toISOString();
-    await writeRunMeta(runDir, meta);
-}
-export async function ensureStageDirs(runDir, stageId) {
-    const dir = path.join(runDir, "stages", stageId);
-    await mkdir(path.join(dir, "artifacts"), { recursive: true });
-    return dir;
-}
-export async function writeEnvelope(runDir, stageId, envelope) {
-    const dir = await ensureStageDirs(runDir, stageId);
-    const file = path.join(dir, "envelope.json");
-    await writeFile(file, `${JSON.stringify(envelope, null, 2)}\n`);
-    return file;
-}
-export async function appendStageLog(runDir, stageId, event) {
-    const dir = await ensureStageDirs(runDir, stageId);
-    const file = path.join(dir, "log.jsonl");
-    const line = `${JSON.stringify({ ...event, at: new Date().toISOString() })}\n`;
-    await appendFile(file, line);
-}
-export async function readEnvelope(runDir, stageId) {
-    const file = path.join(runDir, "stages", stageId, "envelope.json");
-    return JSON.parse(await readFile(file, "utf8"));
-}

package/dist/runtime/hitlSeams.d.ts DELETED Viewed

@@ -1,38 +0,0 @@
-import type { OpaqueAnswer, OpaqueWaitRequest } from "../agent/port.js";
-/** Context for T2 answer/prompt matching (T2 owns kind schema later). */
-export type AnswerPromptAssertContext = {
-    runId: string;
-    stageId: string;
-    answer: OpaqueAnswer;
-    pendingRequest?: OpaqueWaitRequest;
-};
-/**
- * T2 pre-append gate. Stub accepts any opaque until ask-operator lands.
- * Call at deliverAnswer entry before any append or inject (KTD6 / KTD9).
- */
-export type AssertAnswerMatchesPrompt = (ctx: AnswerPromptAssertContext) => void | Promise<void>;
-export type HitlWaitEnterContext = {
-    runId: string;
-    stageId: string;
-    request: OpaqueWaitRequest;
-};
-export type HitlAnswerDeliverContext = {
-    runId: string;
-    stageId: string;
-    answer: OpaqueAnswer;
-    pendingRequest?: OpaqueWaitRequest;
-};
-/**
- * T3 ordered hooks. No-op until durable Q&A owns operator_prompt / operator_answer.
- * T1 must not define event bodies here (KTD9).
- */
-export type HitlQaHooks = {
-    onWaitEnter?: (ctx: HitlWaitEnterContext) => void | Promise<void>;
-    onAnswerDeliver?: (ctx: HitlAnswerDeliverContext) => void | Promise<void>;
-};
-export declare const noopAssertAnswerMatchesPrompt: AssertAnswerMatchesPrompt;
-export declare const noopHitlQaHooks: HitlQaHooks;
-export type HitlSeams = {
-    assertAnswerMatchesPrompt?: AssertAnswerMatchesPrompt;
-    qaHooks?: HitlQaHooks;
-};

package/dist/runtime/hitlSeams.js DELETED Viewed

	@@ -1,2 +0,0 @@
1	- export const noopAssertAnswerMatchesPrompt = () => { };
2	- export const noopHitlQaHooks = {};