stageflow 0.1.0 → 0.3.0

package/dist/project/findProjectRoot.js

@@ -0,0 +1,51 @@
+import { existsSync, realpathSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import path from "node:path";
+const cache = new Map();
+function normalizeRoot(dir) {
+    try {
+        return realpathSync(path.resolve(dir));
+    }
+    catch {
+        return path.resolve(dir);
+    }
+}
+export function findProjectRoot(startDir) {
+    const normalized = path.resolve(startDir);
+    if (cache.has(normalized)) {
+        return cache.get(normalized) ?? null;
+    }
+    let result = null;
+    try {
+        const stdout = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+            cwd: normalized,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const trimmed = stdout.trim();
+        if (trimmed.length > 0) {
+            result = normalizeRoot(trimmed);
+        }
+    }
+    catch {
+        result = walkForGitRoot(normalized);
+    }
+    cache.set(normalized, result);
+    return result;
+}
+function walkForGitRoot(startDir) {
+    let dir = path.resolve(startDir);
+    for (;;) {
+        if (existsSync(path.join(dir, ".git"))) {
+            return normalizeRoot(dir);
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+export function clearFindProjectRootCacheForTests() {
+    cache.clear();
+}

package/dist/project/globalHome.d.ts

@@ -0,0 +1,2 @@
+export declare function globalStageflowHome(): string;
+export declare function ensureGlobalHome(): string;

package/dist/project/globalHome.js

@@ -0,0 +1,19 @@
+import { chmodSync, mkdirSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export function globalStageflowHome() {
+    return path.join(os.homedir(), ".stageflow");
+}
+export function ensureGlobalHome() {
+    const globalHome = globalStageflowHome();
+    mkdirSync(globalHome, { recursive: true });
+    const agentDir = path.join(globalHome, "agent");
+    mkdirSync(agentDir, { recursive: true });
+    try {
+        chmodSync(agentDir, 0o700);
+    }
+    catch {
+        // best-effort on non-POSIX
+    }
+    return globalHome;
+}

package/dist/project/resolveProjectContext.d.ts

@@ -0,0 +1,9 @@
+export type ProjectContext = {
+    invocationCwd: string;
+    projectRoot: string;
+    globalHome: string;
+    isGitProject: boolean;
+};
+export declare function resolveProjectContext(invocationCwd: string): ProjectContext;
+export declare function legacyProjectContext(cwd: string): ProjectContext;
+export declare function asProjectContext(input: ProjectContext | string): ProjectContext;

package/dist/project/resolveProjectContext.js

@@ -0,0 +1,38 @@
+import os from "node:os";
+import path from "node:path";
+import { findProjectRoot } from "./findProjectRoot.js";
+import { ensureGlobalHome, globalStageflowHome } from "./globalHome.js";
+export function resolveProjectContext(invocationCwd) {
+    const resolvedInvocation = path.resolve(invocationCwd);
+    const gitRoot = findProjectRoot(resolvedInvocation);
+    const globalHome = ensureGlobalHome();
+    if (gitRoot !== null) {
+        return {
+            invocationCwd: resolvedInvocation,
+            projectRoot: gitRoot,
+            globalHome,
+            isGitProject: true,
+        };
+    }
+    return {
+        invocationCwd: resolvedInvocation,
+        projectRoot: os.homedir(),
+        globalHome,
+        isGitProject: false,
+    };
+}
+export function legacyProjectContext(cwd) {
+    const invocationCwd = path.resolve(cwd);
+    return {
+        invocationCwd,
+        projectRoot: invocationCwd,
+        globalHome: globalStageflowHome(),
+        isGitProject: false,
+    };
+}
+export function asProjectContext(input) {
+    if (typeof input !== "string") {
+        return input;
+    }
+    return resolveProjectContext(input);
+}

package/dist/project/resolveStageflowContext.d.ts

@@ -0,0 +1,11 @@
+import type { LoadedManifest } from "../types/stageflowManifest.js";
+import type { LoadIssue } from "../config/loadOutcome.js";
+import type { ProjectContext } from "./resolveProjectContext.js";
+export type CatalogManifestStatus = "ok" | "missing" | "invalid" | "not_git";
+export type StageflowContext = ProjectContext & {
+    manifest: LoadedManifest | null;
+    manifestStatus: CatalogManifestStatus;
+    manifestIssues: LoadIssue[];
+};
+export declare function projectContextFromStageflow(ctx: StageflowContext): ProjectContext;
+export declare function resolveStageflowContext(invocationCwd: string): Promise<StageflowContext>;

package/dist/project/resolveStageflowContext.js

@@ -0,0 +1,66 @@
+import { access } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { loadStageflowManifestOutcome, manifestPathForProject, } from "../config/loadStageflowManifest.js";
+import { findProjectRoot } from "./findProjectRoot.js";
+import { ensureGlobalHome } from "./globalHome.js";
+export function projectContextFromStageflow(ctx) {
+    return {
+        invocationCwd: ctx.invocationCwd,
+        projectRoot: ctx.projectRoot,
+        globalHome: ctx.globalHome,
+        isGitProject: ctx.isGitProject,
+    };
+}
+export async function resolveStageflowContext(invocationCwd) {
+    const resolvedInvocation = path.resolve(invocationCwd);
+    const gitRoot = findProjectRoot(resolvedInvocation);
+    const globalHome = ensureGlobalHome();
+    if (gitRoot === null) {
+        return {
+            invocationCwd: resolvedInvocation,
+            projectRoot: os.homedir(),
+            globalHome,
+            isGitProject: false,
+            manifest: null,
+            manifestStatus: "not_git",
+            manifestIssues: [],
+        };
+    }
+    const manifestPath = manifestPathForProject(gitRoot);
+    try {
+        await access(manifestPath);
+    }
+    catch {
+        return {
+            invocationCwd: resolvedInvocation,
+            projectRoot: gitRoot,
+            globalHome,
+            isGitProject: true,
+            manifest: null,
+            manifestStatus: "missing",
+            manifestIssues: [],
+        };
+    }
+    const outcome = await loadStageflowManifestOutcome(gitRoot);
+    if (!outcome.ok) {
+        return {
+            invocationCwd: resolvedInvocation,
+            projectRoot: gitRoot,
+            globalHome,
+            isGitProject: true,
+            manifest: null,
+            manifestStatus: "invalid",
+            manifestIssues: outcome.issues,
+        };
+    }
+    return {
+        invocationCwd: resolvedInvocation,
+        projectRoot: gitRoot,
+        globalHome,
+        isGitProject: true,
+        manifest: outcome.value,
+        manifestStatus: "ok",
+        manifestIssues: [],
+    };
+}

package/dist/runstore/normalizeCatalogPath.d.ts

@@ -0,0 +1 @@
+export declare function normalizeCatalogPath(raw: string): string;

package/dist/runstore/normalizeCatalogPath.js

@@ -0,0 +1,4 @@
+import path from "node:path";
+export function normalizeCatalogPath(raw) {
+    return path.resolve(raw);
+}

package/dist/runstore/port.d.ts

@@ -36,7 +36,13 @@ export type RunMeta = {
     task_id?: string;
     updated_at?: string;
     checkout_root?: string;
+    git_sha?: string;
+    ci_pr_url?: string;
+    ci_job_url?: string;
     pipeline_dag?: RunPipelineDagSnapshot;
+    pipeline_path?: string;
+    task_path?: string;
+    project_root?: string;
 };
 export type CreatedRun = {
     runId: string;
@@ -81,6 +87,9 @@ export type RunSummary = {
     run_id: string;
     pipeline_id: string;
     task_id?: string;
+    pipeline_path?: string;
+    task_path?: string;
+    project_root?: string;
     status: RunStatus;
     created_at: string;
     updated_at?: string;
@@ -108,7 +117,13 @@ export type CreateRunInput = {
     taskYaml: string;
     taskId?: string;
     checkoutRoot?: string;
+    gitSha?: string;
+    ciPrUrl?: string;
+    ciJobUrl?: string;
     pipelineDag?: RunPipelineDagSnapshot;
+    pipelinePath?: string;
+    taskPath?: string;
+    projectRoot?: string;
 };
 /**
  * Persistence port for pipeline run state.

package/dist/runstore/runProjection.js

@@ -65,14 +65,24 @@ function failedFieldsFromStages(stages) {
     };
 }
 function resolveListedStatus(stages, meta) {
+    if (stages.length === 0)
+        return meta.status ?? "created";
     const derived = deriveStatusFromStages(stages);
-    return stages.length > 0 ? derived : (meta.status ?? derived);
+    if (meta.status === "succeeded" && derived === "running") {
+        const hasActiveStage = stages.some((s) => s.status === "running" || s.status === "waiting_for_input");
+        if (!hasActiveStage)
+            return "succeeded";
+    }
+    return derived;
 }
 export function projectRunSummary(meta, stages) {
     return {
         run_id: meta.run_id,
         pipeline_id: meta.pipeline_id,
         task_id: meta.task_id,
+        ...(meta.pipeline_path !== undefined ? { pipeline_path: meta.pipeline_path } : {}),
+        ...(meta.task_path !== undefined ? { task_path: meta.task_path } : {}),
+        ...(meta.project_root !== undefined ? { project_root: meta.project_root } : {}),
         status: resolveListedStatus(stages, meta),
         created_at: meta.created_at,
         updated_at: meta.updated_at,

package/dist/runstore/sqlite/SqliteRunStore.js

@@ -2,6 +2,7 @@ import Database from "better-sqlite3";
 import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { projectRunDetail, projectRunSummary, orderStageSnapshots } from "../runProjection.js";
+import { normalizeCatalogPath } from "../normalizeCatalogPath.js";
 import { buildStageSnapshotFromStore } from "../stageSnapshot.js";
 import { parsePipelineDagSnapshot } from "../pipelineDagSnapshot.js";
 import { newRunId, runWorkspaceDir } from "../paths.js";
@@ -27,12 +28,30 @@ function ensureCheckoutRootColumn(db) {
         db.exec(`ALTER TABLE runs ADD COLUMN checkout_root TEXT`);
     }
 }
+function ensureCiIdentityColumns(db) {
+    const cols = db.prepare(`PRAGMA table_info(runs)`).all();
+    const names = new Set(cols.map((c) => c.name));
+    for (const name of ["git_sha", "ci_pr_url", "ci_job_url"]) {
+        if (!names.has(name)) {
+            db.exec(`ALTER TABLE runs ADD COLUMN ${name} TEXT`);
+        }
+    }
+}
 function ensurePipelineDagColumn(db) {
     const cols = db.prepare(`PRAGMA table_info(runs)`).all();
     if (!cols.some((c) => c.name === "pipeline_dag_json")) {
         db.exec(`ALTER TABLE runs ADD COLUMN pipeline_dag_json TEXT`);
     }
 }
+function ensureRunLocatorColumns(db) {
+    const cols = db.prepare(`PRAGMA table_info(runs)`).all();
+    const names = new Set(cols.map((c) => c.name));
+    for (const name of ["pipeline_path", "task_path", "project_root"]) {
+        if (!names.has(name)) {
+            db.exec(`ALTER TABLE runs ADD COLUMN ${name} TEXT`);
+        }
+    }
+}
 function ensureStageExecutionsTable(db) {
     db.exec(`
 CREATE TABLE IF NOT EXISTS stage_executions (
@@ -87,7 +106,9 @@ export class SqliteRunStore {
         this.db.pragma(`busy_timeout = ${readSqliteBusyTimeoutMs()}`);
         this.db.exec(SCHEMA_SQL);
         ensureCheckoutRootColumn(this.db);
+        ensureCiIdentityColumns(this.db);
         ensurePipelineDagColumn(this.db);
+        ensureRunLocatorColumns(this.db);
         ensureStageExecutionsTable(this.db);
         ensureStageEventsAttemptColumn(this.db);
         this.migratePromise = importDiskRunsIfEmpty(this.db, storeRoot).then(() => undefined);
@@ -105,11 +126,20 @@ export class SqliteRunStore {
         const workspaceDir = this.getWorkspaceDir(runId);
         await mkdir(path.join(workspaceDir, "stages"), { recursive: true });
         const now = new Date().toISOString();
+        const pipelinePath = input.pipelinePath
+            ? normalizeCatalogPath(input.pipelinePath)
+            : null;
+        const taskPath = input.taskPath
+            ? normalizeCatalogPath(input.taskPath)
+            : null;
+        const projectRoot = input.projectRoot
+            ? normalizeCatalogPath(input.projectRoot)
+            : null;
         this.db
             .prepare(`INSERT INTO runs
-          (run_id, pipeline_id, task_id, task_yaml, status, created_at, updated_at, checkout_root, pipeline_dag_json)
+          (run_id, pipeline_id, task_id, task_yaml, status, created_at, updated_at, checkout_root, pipeline_dag_json, git_sha, ci_pr_url, ci_job_url, pipeline_path, task_path, project_root)
          VALUES
-          (@run_id, @pipeline_id, @task_id, @task_yaml, @status, @created_at, @updated_at, @checkout_root, @pipeline_dag_json)`)
+          (@run_id, @pipeline_id, @task_id, @task_yaml, @status, @created_at, @updated_at, @checkout_root, @pipeline_dag_json, @git_sha, @ci_pr_url, @ci_job_url, @pipeline_path, @task_path, @project_root)`)
             .run({
             run_id: runId,
             pipeline_id: input.pipelineId,
@@ -122,6 +152,12 @@ export class SqliteRunStore {
             pipeline_dag_json: input.pipelineDag
                 ? JSON.stringify(input.pipelineDag)
                 : null,
+            git_sha: input.gitSha ?? null,
+            ci_pr_url: input.ciPrUrl ?? null,
+            ci_job_url: input.ciJobUrl ?? null,
+            pipeline_path: pipelinePath,
+            task_path: taskPath,
+            project_root: projectRoot,
         });
         return { runId, workspaceDir };
     }
@@ -378,7 +414,7 @@ export class SqliteRunStore {
     async listRuns() {
         await this.ready();
         const rows = this.db
-            .prepare(`SELECT run_id, pipeline_id, task_id, task_yaml, status, created_at, updated_at, checkout_root, pipeline_dag_json
+            .prepare(`SELECT run_id, pipeline_id, task_id, task_yaml, status, created_at, updated_at, checkout_root, pipeline_dag_json, git_sha, ci_pr_url, ci_job_url, pipeline_path, task_path, project_root
          FROM runs ORDER BY created_at DESC`)
             .all();
         const summaries = [];
@@ -410,11 +446,17 @@ export class SqliteRunStore {
             task_id: row.task_id ?? undefined,
             updated_at: row.updated_at,
             ...(row.checkout_root != null ? { checkout_root: row.checkout_root } : {}),
+            ...(row.git_sha != null ? { git_sha: row.git_sha } : {}),
+            ...(row.ci_pr_url != null ? { ci_pr_url: row.ci_pr_url } : {}),
+            ...(row.ci_job_url != null ? { ci_job_url: row.ci_job_url } : {}),
+            ...(row.pipeline_path != null ? { pipeline_path: row.pipeline_path } : {}),
+            ...(row.task_path != null ? { task_path: row.task_path } : {}),
+            ...(row.project_root != null ? { project_root: row.project_root } : {}),
         };
     }
     getRunRow(runId) {
         const row = this.db
-            .prepare(`SELECT run_id, pipeline_id, task_id, task_yaml, status, created_at, updated_at, checkout_root, pipeline_dag_json
+            .prepare(`SELECT run_id, pipeline_id, task_id, task_yaml, status, created_at, updated_at, checkout_root, pipeline_dag_json, git_sha, ci_pr_url, ci_job_url, pipeline_path, task_path, project_root
          FROM runs WHERE run_id = ?`)
             .get(runId);
         if (!row)

package/dist/runstore/sqlite/schema.d.ts

@@ -1 +1 @@
-export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS runs (\n  run_id TEXT PRIMARY KEY,\n  pipeline_id TEXT NOT NULL,\n  task_id TEXT,\n  task_yaml TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  checkout_root TEXT,\n  pipeline_dag_json TEXT\n);\n\nCREATE TABLE IF NOT EXISTS stages (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  status TEXT,\n  summary TEXT,\n  envelope_json TEXT,\n  started_at TEXT,\n  finished_at TEXT,\n  PRIMARY KEY (run_id, stage_id),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS stage_events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  at TEXT NOT NULL,\n  event TEXT NOT NULL,\n  payload_json TEXT,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_runs_status_created\n  ON runs (status, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_runs_pipeline_created\n  ON runs (pipeline_id, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_stage_events_run_stage_at\n  ON stage_events (run_id, stage_id, at);\n\nCREATE TABLE IF NOT EXISTS stage_executions (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  attempt INTEGER NOT NULL,\n  status TEXT NOT NULL,\n  started_at TEXT,\n  finished_at TEXT,\n  envelope_json TEXT,\n  PRIMARY KEY (run_id, stage_id, attempt),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_stage_executions_run_stage\n  ON stage_executions (run_id, stage_id, attempt);\n";
+export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS runs (\n  run_id TEXT PRIMARY KEY,\n  pipeline_id TEXT NOT NULL,\n  task_id TEXT,\n  task_yaml TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  checkout_root TEXT,\n  pipeline_dag_json TEXT,\n  git_sha TEXT,\n  ci_pr_url TEXT,\n  ci_job_url TEXT,\n  pipeline_path TEXT,\n  task_path TEXT,\n  project_root TEXT\n);\n\nCREATE TABLE IF NOT EXISTS stages (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  status TEXT,\n  summary TEXT,\n  envelope_json TEXT,\n  started_at TEXT,\n  finished_at TEXT,\n  PRIMARY KEY (run_id, stage_id),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS stage_events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  at TEXT NOT NULL,\n  event TEXT NOT NULL,\n  payload_json TEXT,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_runs_status_created\n  ON runs (status, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_runs_pipeline_created\n  ON runs (pipeline_id, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_stage_events_run_stage_at\n  ON stage_events (run_id, stage_id, at);\n\nCREATE TABLE IF NOT EXISTS stage_executions (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  attempt INTEGER NOT NULL,\n  status TEXT NOT NULL,\n  started_at TEXT,\n  finished_at TEXT,\n  envelope_json TEXT,\n  PRIMARY KEY (run_id, stage_id, attempt),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_stage_executions_run_stage\n  ON stage_executions (run_id, stage_id, attempt);\n";

package/dist/runstore/sqlite/schema.js

@@ -8,7 +8,13 @@ CREATE TABLE IF NOT EXISTS runs (
   created_at TEXT NOT NULL,
   updated_at TEXT NOT NULL,
   checkout_root TEXT,
-  pipeline_dag_json TEXT
+  pipeline_dag_json TEXT,
+  git_sha TEXT,
+  ci_pr_url TEXT,
+  ci_job_url TEXT,
+  pipeline_path TEXT,
+  task_path TEXT,
+  project_root TEXT
 );
 
 CREATE TABLE IF NOT EXISTS stages (

package/dist/runtime/credentialBinding.d.ts

@@ -1,5 +1,6 @@
-import { parseCredentialSource, readCredentialSourceFromFile, writeCredentialSourceToFile, type CredentialSource } from "./settingsFile.js";
-export { parseCredentialSource, readCredentialSourceFromFile, writeCredentialSourceToFile, };
+import { type ProjectContext } from "../project/resolveProjectContext.js";
+import { parseCredentialSource, readCredentialSourceFromContext, writeCredentialSourceToContext, type CredentialSource } from "./settingsFile.js";
+export { parseCredentialSource, readCredentialSourceFromContext, writeCredentialSourceToContext, };
 export type CredentialBinding = {
     source: CredentialSource;
     authPath: string;
@@ -8,9 +9,10 @@ export type CredentialBinding = {
 export type ResolveCredentialBindingOptions = {
     piHomeAuthPath?: string;
 };
-export declare function sfOwnedAgentDir(cwd: string): string;
-export declare function sfOwnedAuthPath(cwd: string): string;
+export declare function sfOwnedAgentDir(): string;
+export declare function sfOwnedAuthPath(): string;
 export declare function piHomeAuthPath(override?: string): string;
 export declare function isUsableAuthFile(authPath: string): boolean;
-export declare function ensureSfOwnedAuthStore(cwd: string): string;
-export declare function resolveCredentialBinding(cwd: string, options?: ResolveCredentialBindingOptions): CredentialBinding;
+export declare function ensureSfOwnedAuthStore(): string;
+export declare function resolveCredentialBinding(ctx: ProjectContext | string, options?: ResolveCredentialBindingOptions): CredentialBinding;
+export { readCredentialSourceFromFile, writeCredentialSourceToFile, } from "./settingsFile.js";

package/dist/runtime/credentialBinding.js

@@ -1,14 +1,15 @@
-import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, existsSync, readFileSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { storeRootFor } from "../runstore/paths.js";
-import { parseCredentialSource, readCredentialSourceFromFile, writeCredentialSourceToFile, } from "./settingsFile.js";
-export { parseCredentialSource, readCredentialSourceFromFile, writeCredentialSourceToFile, };
-export function sfOwnedAgentDir(cwd) {
-    return path.join(storeRootFor(cwd), "agent");
+import { ensureGlobalHome } from "../project/globalHome.js";
+import { resolveProjectContext, } from "../project/resolveProjectContext.js";
+import { parseCredentialSource, readCredentialSourceFromContext, writeCredentialSourceToContext, } from "./settingsFile.js";
+export { parseCredentialSource, readCredentialSourceFromContext, writeCredentialSourceToContext, };
+export function sfOwnedAgentDir() {
+    return path.join(ensureGlobalHome(), "agent");
 }
-export function sfOwnedAuthPath(cwd) {
-    return path.join(sfOwnedAgentDir(cwd), "auth.json");
+export function sfOwnedAuthPath() {
+    return path.join(sfOwnedAgentDir(), "auth.json");
 }
 export function piHomeAuthPath(override) {
     return (override ??
@@ -25,18 +26,9 @@ export function isUsableAuthFile(authPath) {
         return false;
     }
 }
-export function ensureSfOwnedAuthStore(cwd) {
-    const storeRoot = storeRootFor(cwd);
-    mkdirSync(storeRoot, { recursive: true });
-    const agentDir = sfOwnedAgentDir(cwd);
-    mkdirSync(agentDir, { recursive: true });
-    try {
-        chmodSync(agentDir, 0o700);
-    }
-    catch {
-        // best-effort on non-POSIX
-    }
-    const authPath = sfOwnedAuthPath(cwd);
+export function ensureSfOwnedAuthStore() {
+    ensureGlobalHome();
+    const authPath = sfOwnedAuthPath();
     if (!existsSync(authPath)) {
         writeFileSync(authPath, "{}\n", { encoding: "utf8", mode: 0o600 });
     }
@@ -48,14 +40,15 @@ export function ensureSfOwnedAuthStore(cwd) {
     }
     return authPath;
 }
-export function resolveCredentialBinding(cwd, options = {}) {
+export function resolveCredentialBinding(ctx, options = {}) {
+    const projectCtx = typeof ctx === "string" ? resolveProjectContext(ctx) : ctx;
     const piHome = piHomeAuthPath(options.piHomeAuthPath);
-    const persisted = readCredentialSourceFromFile(cwd);
+    const persisted = readCredentialSourceFromContext(projectCtx);
     if (persisted !== undefined) {
         if (persisted === "sf_owned") {
             return {
                 source: "sf_owned",
-                authPath: ensureSfOwnedAuthStore(cwd),
+                authPath: ensureSfOwnedAuthStore(),
                 provisional: false,
             };
         }
@@ -74,7 +67,8 @@ export function resolveCredentialBinding(cwd, options = {}) {
     }
     return {
         source: "sf_owned",
-        authPath: ensureSfOwnedAuthStore(cwd),
+        authPath: ensureSfOwnedAuthStore(),
         provisional: true,
     };
 }
+export { readCredentialSourceFromFile, writeCredentialSourceToFile, } from "./settingsFile.js";

package/dist/runtime/pipelineRunner.d.ts

@@ -8,8 +8,10 @@ import { type StageExecutionMode } from "./stageConcurrency.js";
 import { StageProcessLauncher } from "./stageProcessLauncher.js";
 import type { OperatorCatalog } from "./stageAttemptBootstrap.js";
 export { PipelineValidationError } from "./pipelineValidationError.js";
+export type PipelineRunOutcome = "succeeded" | "failed" | "waiting";
 export type PipelineRunResult = {
     ok: boolean;
+    outcome: PipelineRunOutcome;
     runDir: string;
     runId: string;
     reason?: string;
@@ -29,11 +31,13 @@ export type PreparedPipeline = {
     agent: AgentPort;
     store: RunStore;
     cwd: string;
+    projectRoot: string;
     checkoutRoot?: string;
     hitl?: StageHitlController;
     executionMode?: StageExecutionMode;
     stageProcessLauncher?: StageProcessLauncher;
     operatorCatalog?: OperatorCatalog;
+    skipGates?: boolean;
 };
 export type ExecuteStagesOptions = {
     maxActiveStagesPerRun?: number;
@@ -52,12 +56,14 @@ export declare function runPipeline(options: {
     taskYaml?: string;
     pipeline: string;
     cwd?: string;
+    projectRoot?: string;
     checkoutOverride?: string;
     hitl?: StageHitlController;
     maxActiveStagesPerRun?: number;
     executionMode?: StageExecutionMode;
     stageProcessLauncher?: StageProcessLauncher;
     operatorCatalog?: OperatorCatalog;
+    skipGates?: boolean;
 }): Promise<PipelineRunResult>;
 /** Create the run immediately, then execute stages in the returned promise. */
 export declare function startPipeline(options: {
@@ -67,11 +73,16 @@ export declare function startPipeline(options: {
     taskYaml?: string;
     pipeline: string;
     cwd?: string;
+    projectRoot?: string;
     checkoutOverride?: string;
+    gitSha?: string;
+    ciPrUrl?: string;
+    ciJobUrl?: string;
     hitl?: StageHitlController;
     maxActiveStagesPerRun?: number;
     executionMode?: StageExecutionMode;
     stageProcessLauncher?: StageProcessLauncher;
     operatorCatalog?: OperatorCatalog;
+    skipGates?: boolean;
 }): Promise<StartedPipeline>;
 export declare function resolveTaskPath(taskArg: string, cwd?: string): string;