@treeseed/sdk 0.12.44 → 0.12.46

package/dist/workflow/runs.d.ts

@@ -85,6 +85,7 @@ export type TreeseedWorkflowLockInspection = {
     stale: boolean;
     staleReason: string | null;
 };
+export declare function markActiveWorkflowRunsInterrupted(signal: NodeJS.Signals | string): string[];
 export declare function workflowLockScopeForCommand(command: TreeseedWorkflowRunCommand): TreeseedWorkflowLockScope;
 export declare function isSharedWorkflowCommand(command?: string | null): command is TreeseedWorkflowRunCommand;
 export declare function generateWorkflowRunId(command: TreeseedWorkflowRunCommand): string;

package/dist/workflow/runs.js

@@ -7,9 +7,47 @@ const WORKTREE_METADATA_PATH = ".treeseed/worktree.json";
 const LOCK_STALE_AFTER_MS = 4 * 60 * 60 * 1e3;
 const WORKFLOW_RUN_STORAGE_ROOTS = /* @__PURE__ */ new Map();
 const SHARED_LOCK_COMMANDS = /* @__PURE__ */ new Set(["stage", "release"]);
+const ACTIVE_WORKFLOW_RUNS = /* @__PURE__ */ new Map();
+let SIGNAL_HANDLERS_INSTALLED = false;
 function nowIso() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
+function markActiveWorkflowRunsInterrupted(signal) {
+  const interrupted = [];
+  for (const [runId, root] of ACTIVE_WORKFLOW_RUNS) {
+    const journal = readWorkflowRunJournal(root, runId);
+    if (journal?.status === "running") {
+      updateWorkflowRunJournal(root, runId, (current) => ({
+        ...current,
+        status: "failed",
+        failure: {
+          code: "interrupted",
+          message: `Treeseed workflow was interrupted by ${signal}.`,
+          details: {
+            resumable: true,
+            recoverCommand: "treeseed recover",
+            resumeCommand: `treeseed resume ${runId}`
+          },
+          at: nowIso()
+        }
+      }));
+    }
+    releaseWorkflowLock(root, runId);
+    interrupted.push(runId);
+  }
+  ACTIVE_WORKFLOW_RUNS.clear();
+  return interrupted;
+}
+function installWorkflowSignalHandlers() {
+  if (SIGNAL_HANDLERS_INSTALLED) return;
+  SIGNAL_HANDLERS_INSTALLED = true;
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.once(signal, () => {
+      markActiveWorkflowRunsInterrupted(signal);
+      process.kill(process.pid, signal);
+    });
+  }
+}
 function managedWorktreePrimaryRoot(root) {
   const metadataPath = resolve(root, WORKTREE_METADATA_PATH);
   if (!existsSync(metadataPath)) return null;
@@ -167,6 +205,21 @@ function acquireWorkflowLock(root, command, runId) {
     };
   }
   if (inspection.stale) {
+    if (inspection.lock?.runId) {
+      const staleJournal = readWorkflowRunJournal(root, inspection.lock.runId);
+      if (staleJournal?.status === "running") {
+        updateWorkflowRunJournal(root, inspection.lock.runId, (journal) => ({
+          ...journal,
+          status: "failed",
+          failure: {
+            code: "interrupted",
+            message: `Workflow lock became stale because ${inspection.staleReason ?? "the owning process ended"}.`,
+            details: { resumable: true, resumeCommand: `treeseed resume ${inspection.lock.runId}` },
+            at: nowIso()
+          }
+        }));
+      }
+    }
     rmSync(dirs.lockPath, { force: true });
   }
   const timestamp = nowIso();
@@ -186,6 +239,8 @@ function acquireWorkflowLock(root, command, runId) {
   };
   writeFileSync(dirs.lockPath, `${JSON.stringify(lock, null, 2)}
 `, "utf8");
+  ACTIVE_WORKFLOW_RUNS.set(runId, root);
+  installWorkflowSignalHandlers();
   return {
     acquired: true,
     lock,
@@ -209,6 +264,7 @@ function refreshWorkflowLock(root, runId) {
   return updated;
 }
 function releaseWorkflowLock(root, runId) {
+  ACTIVE_WORKFLOW_RUNS.delete(runId);
   const path = workflowLockPath(root, runId);
   const lock = safeJsonParse(path);
   if (!lock || lock.runId !== runId) {
@@ -627,6 +683,7 @@ export {
   listInterruptedWorkflowRuns,
   listRecentWorkflowRunJournals,
   listWorkflowRunJournals,
+  markActiveWorkflowRunsInterrupted,
   readWorkflowRunJournal,
   refreshWorkflowLock,
   releaseWorkflowLock,

package/dist/workflow-support.d.ts

@@ -15,6 +15,7 @@ export { getRailwayAuthProfile, listRailwayEnvironments, listRailwayProjects, li
 export { githubRepositoryCredentialEnvName, resolveGitHubCredentialForRepository, type TreeseedGitHubCredentialResolution, } from './operations/services/github-credentials.js';
 export { createGitHubApiClient, ensureGitHubActionsEnvironment, getLatestGitHubWorkflowRun, listGitHubEnvironmentSecretNames, listGitHubEnvironmentVariableNames, type GitHubWorkflowDispatchResult, type GitHubWorkflowRunSummary, } from './operations/services/github-api.js';
 export { inspectTreeseedGitLocks, inspectTreeseedGitLockSet, inspectTreeseedWorkspaceGitLocks, recoverTreeseedGitLocks, runTreeseedGitBatch, runTreeseedGit, type TreeseedGitLockDiagnostic, type TreeseedGitLockKind, type TreeseedGitLockProcessHint, type TreeseedGitBatchOperation, type TreeseedGitRunnerMode, type TreeseedGitRunnerResult, type TreeseedGitWorkspaceLockDiagnostics, } from './operations/services/git-runner.js';
+export { buildTreeseedPackageArtifact, hydrateTreeseedPackageArtifacts, verifyTreeseedPackageArtifact, type TreeseedPackageArtifactManifest, } from './operations/services/package-artifacts.js';
 export { discoverTreeseedPackageAdapters, findTreeseedPackageAdapter, packageAdapterPlanSummary, planTreeseedPackageDevelopmentImage, runTreeseedPackageImageWorkflow, syncTreeseedPackageWorkflows, validateTreeseedPackageManifests, type TreeseedPackageAdapter, type TreeseedPackageDevelopmentImagePlan, type TreeseedPackageImageWorkflowOptions, type TreeseedPackageManifestValidation, type TreeseedPackageWorkflowSyncResult, type TreeseedPackageWorkflowTemplateKind, } from './operations/services/package-adapters.js';
 export { runTenantDeployPreflight, runWorkspaceReleasePreflight, runWorkspaceSavePreflight, } from './operations/services/save-deploy-preflight.js';
 export { collectCliPreflight } from './operations/services/workspace-preflight.js';

package/dist/workflow-support.js

@@ -145,6 +145,11 @@ import {
   runTreeseedGitBatch,
   runTreeseedGit
 } from "./operations/services/git-runner.js";
+import {
+  buildTreeseedPackageArtifact,
+  hydrateTreeseedPackageArtifacts,
+  verifyTreeseedPackageArtifact
+} from "./operations/services/package-artifacts.js";
 import {
   discoverTreeseedPackageAdapters,
   findTreeseedPackageAdapter,
@@ -227,6 +232,7 @@ export {
   assertNoWorkspaceLinksInDeploymentLockfiles,
   assertTreeseedCommandEnvironment,
   branchExists,
+  buildTreeseedPackageArtifact,
   checkTreeseedProviderConnections,
   checkoutBranch,
   cleanupDestroyedState,
@@ -286,6 +292,7 @@ export {
   gitWorkflowRoot,
   githubRepositoryCredentialEnvName,
   hasMeaningfulChanges,
+  hydrateTreeseedPackageArtifacts,
   incrementVersion,
   inspectTreeseedGitLockSet,
   inspectTreeseedGitLocks,
@@ -371,6 +378,7 @@ export {
   validateDestroyPrerequisites,
   validateRailwayDeployPrerequisites,
   validateTreeseedPackageManifests,
+  verifyTreeseedPackageArtifact,
   waitForStagingAutomation,
   warnDeprecatedTreeseedLocalEnvFiles,
   withTreeseedKeyAgentAutopromptDisabled,

package/dist/workflow.d.ts

@@ -129,6 +129,7 @@ export type TreeseedUpdateInput = {
     push?: boolean;
     worktreeMode?: TreeseedWorkflowWorktreeMode;
     workspaceLinks?: 'auto' | 'off';
+    adoptChanges?: boolean;
     plan?: boolean;
 };
 export type TreeseedCiInput = {
@@ -170,6 +171,7 @@ export type TreeseedStageInput = {
     deleteBranch?: boolean;
     autoSave?: boolean;
     ciMode?: TreeseedStageCiMode | TreeseedWorkflowCiMode;
+    async?: boolean;
     releaseCandidate?: TreeseedReleaseCandidateMode;
     worktreeMode?: TreeseedWorkflowWorktreeMode;
     workspaceLinks?: 'auto' | 'off';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.12.44",
+  "version": "0.12.46",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -42,6 +42,8 @@
     "test": "npm run test:unit",
     "test:unit": "vitest run --config ./vitest.config.ts",
     "test:unit:fast": "vitest run --config ./vitest.fast.config.ts",
+    "test:guarantees": "vitest run --config ./vitest.guarantees.config.ts",
+    "test:guarantees:coverage": "vitest run --config ./vitest.guarantees.config.ts --coverage",
     "test:workflow:lifecycle": "vitest run --config ./vitest.config.ts test/utils/workflow-lifecycle.test.ts",
     "test:release": "npm run test:unit:fast",
     "test:smoke": "node --import tsx ./scripts/test-smoke.ts",
@@ -93,6 +95,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
+    "@vitest/coverage-v8": "^4.1.2",
     "drizzle-kit": "^0.31.10",
     "tsx": "^4.21.0",
     "vitest": "^4.1.2"