@treeseed/sdk 0.12.42 → 0.12.43

package/dist/workflow/operations.d.ts

@@ -8,6 +8,7 @@ import { resolveTreeseedWorkflowState, type TreeseedWorkflowStatusOptions } from
 import { type TreeseedReconcileResult } from '../reconcile/index.js';
 import { type TreeseedWorkflowRunCommand, type TreeseedWorkflowRunJournal } from './runs.js';
 import { type TreeseedWorkflowMode } from './session.js';
+import { type TreeseedManagedRepository } from '../operations/services/managed-repositories.js';
 import type { TreeseedCloseInput, TreeseedCiInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedExportInput, TreeseedReleaseCandidateInput, TreeseedReleaseInput, TreeseedRecoverInput, TreeseedResumeInput, TreeseedSaveInput, TreeseedStageInput, TreeseedSwitchInput, TreeseedTaskBranchMetadata, TreeseedUpdateInput, TreeseedWorkflowContext, TreeseedWorkflowCiMode, TreeseedWorkflowDevInput, TreeseedWorkflowExecutionMode, TreeseedWorkflowOperationId, TreeseedWorkflowResult, TreeseedWorkflowWorktreeMode, TreeseedReleaseCandidateMode, TreeseedProofInput } from '../workflow.js';
 type WorkflowWrite = NonNullable<TreeseedWorkflowContext['write']>;
 type WorkflowStatePayload = ReturnType<typeof resolveTreeseedWorkflowState>;
@@ -845,6 +846,7 @@ type StageRepoPlan = {
     name: string;
     path: string;
     kind: 'root' | 'managed';
+    repoKind?: TreeseedManagedRepository['kind'];
     sourceBranch: string;
     targetBranch: typeof STAGING_BRANCH;
     remoteSourceExists: boolean;
@@ -957,6 +959,12 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         sceneArtifacts: "full" | "screenshots";
         releaseImageRefs: Record<string, string>;
         localCleanup: import("../workflow-support.js").TreeseedLocalCleanupReport | null;
+        releaseHelperRepos: {
+            name: string;
+            kind: import("../operations/services/managed-repositories.js").TreeseedManagedRepositoryKind;
+            path: string;
+            remote: string | null;
+        }[];
         autoResumeCandidate: {
             runId: string;
             branch: string | null;
@@ -1045,6 +1053,30 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         workspaceUnlink: import("../operations/services/workspace-dependency-mode.js").WorkspaceDependencyModeReport;
     };
     packageReleases: Record<string, unknown>[];
+    managedHelperReleases: {
+        status: string;
+        repos: {
+            name: string;
+            kind: import("../operations/services/managed-repositories.js").TreeseedManagedRepositoryKind;
+            path: string;
+            stagingHead: string;
+            promotion: {
+                targetBranch: string;
+                expectedBefore: string | null;
+                commitSha: string;
+                pushed: boolean;
+                verified: boolean;
+            };
+            backMerge: {
+                status: string;
+                merged: boolean;
+                repoName: string;
+                sourceBranch: string;
+                targetBranch: string;
+                commitSha: string;
+            };
+        }[];
+    };
     rootRelease: {
         name: string;
         version: string;
@@ -1248,6 +1280,12 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
     sceneArtifacts: "full" | "screenshots";
     releaseImageRefs: Record<string, string>;
     localCleanup: import("../workflow-support.js").TreeseedLocalCleanupReport | null;
+    releaseHelperRepos: {
+        name: string;
+        kind: import("../operations/services/managed-repositories.js").TreeseedManagedRepositoryKind;
+        path: string;
+        remote: string | null;
+    }[];
     freshArchivedRuns: never[];
     autoResumeCandidate: {
         runId: string;

package/dist/workflow/operations.js

@@ -2265,6 +2265,28 @@ function backMergeProductionIntoStaging(repoDir, repoName, message) {
     commitSha: headCommit(repoDir)
   };
 }
+function releaseHelperRepoToProduction(repo) {
+  syncBranchWithOrigin(repo.dir, STAGING_BRANCH);
+  if (!remoteBranchExists(repo.dir, STAGING_BRANCH)) {
+    throw new Error(`${repo.name} has no origin/${STAGING_BRANCH} branch to release.`);
+  }
+  const stagingHead = remoteHeadCommit(repo.dir, STAGING_BRANCH);
+  const promotion = promoteCommitToProductionBranch(repo.dir, stagingHead);
+  const backMerge = backMergeProductionIntoStaging(repo.dir, repo.name, releaseAdminMessage({
+    subject: `release: back-merge ${PRODUCTION_BRANCH} into ${STAGING_BRANCH}`,
+    version: null,
+    sourceRef: PRODUCTION_BRANCH,
+    targetRef: STAGING_BRANCH
+  }));
+  return {
+    name: repo.name,
+    kind: repo.kind,
+    path: repo.relativeDir,
+    stagingHead,
+    promotion,
+    backMerge
+  };
+}
 function backMergeRootProductionIntoStaging(root, syncPackageStagingHeads, options = {}) {
   const gitRoot = repoRoot(root);
   const commits = releaseHistoryCommits(gitRoot, STAGING_BRANCH, `origin/${PRODUCTION_BRANCH}`);
@@ -2309,6 +2331,27 @@ function releasePlanStableDependencyVersionMap(plannedRelease) {
   const stableDependencyVersions = plannedRelease.stableDependencyVersions && typeof plannedRelease.stableDependencyVersions === "object" && !Array.isArray(plannedRelease.stableDependencyVersions) ? plannedRelease.stableDependencyVersions : {};
   return new Map(Object.entries(stableDependencyVersions).map(([name, version]) => [name, String(version)]));
 }
+function collectReleaseHelperRepoBlockers(root) {
+  const blockers = [];
+  for (const repo of checkedOutReleaseHelperRepos(root)) {
+    const branch = currentBranch(repo.dir) || null;
+    if (hasMeaningfulChanges(repo.dir)) {
+      blockers.push(`${repo.name} has uncommitted changes.`);
+    }
+    if (branch !== STAGING_BRANCH) {
+      blockers.push(`${repo.name} is on ${branch ?? "(detached)"} instead of ${STAGING_BRANCH}.`);
+    }
+    try {
+      originRemoteUrl(repo.dir);
+    } catch {
+      blockers.push(`${repo.name} has no readable origin remote.`);
+    }
+    if (!remoteBranchExists(repo.dir, STAGING_BRANCH)) {
+      blockers.push(`${repo.name} has no origin/${STAGING_BRANCH} branch.`);
+    }
+  }
+  return blockers;
+}
 function releasePlanPackageSelection(value) {
   const record = value && typeof value === "object" ? value : {};
   return {
@@ -5043,16 +5086,38 @@ function writeStageCandidateManifest(root, runId, manifest) {
   }
   return manifest;
 }
-function checkedOutStagePackageRepos(root) {
-  return checkedOutManagedWorkflowRepos(root).filter((repo) => repo.kind === "package");
+function dedupeManagedReposByRemote(repos) {
+  const seen = /* @__PURE__ */ new Set();
+  const deduped = [];
+  for (const repo of repos) {
+    const key = repo.remoteUrl ? `remote:${repo.remoteUrl}` : `path:${repo.dir}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    deduped.push(repo);
+  }
+  return deduped;
+}
+function checkedOutStagePromotionRepos(root) {
+  return dedupeManagedReposByRemote(checkedOutManagedWorkflowRepos(root).filter((repo) => repo.kind === "package" || repo.kind === "template" || repo.kind === "fixture"));
+}
+function checkedOutReleaseHelperRepos(root) {
+  return dedupeManagedReposByRemote(checkedOutManagedWorkflowRepos(root).filter((repo) => repo.kind === "template" || repo.kind === "fixture"));
+}
+function syncAllCheckedOutReleaseHelperRepos(root, branchName) {
+  for (const repo of checkedOutManagedWorkflowRepos(root).filter((entry) => entry.kind === "template" || entry.kind === "fixture")) {
+    if (remoteBranchExists(repo.dir, branchName)) {
+      syncBranchWithOrigin(repo.dir, branchName);
+    }
+  }
 }
 function buildStagePromotionPlan(root, branchName, input) {
   const gitRoot = repoRoot(root);
   const repos = [
-    ...checkedOutStagePackageRepos(root).map((repo) => ({
+    ...checkedOutStagePromotionRepos(root).map((repo) => ({
       name: repo.name,
       path: repo.dir,
       kind: "managed",
+      repoKind: repo.kind,
       sourceBranch: branchName,
       targetBranch: STAGING_BRANCH,
       remoteSourceExists: remoteBranchExists(repo.dir, branchName),
@@ -5149,6 +5214,7 @@ function createStageCandidateManifest(root, runId, branchName, plan, verificatio
     packages: packageRepos.map((repo) => ({
       name: repo.name,
       path: repo.path,
+      repoKind: repo.repoKind,
       commit: headCommit(repo.path),
       remote: (() => {
         try {
@@ -5165,7 +5231,7 @@ function createStageCandidateManifest(root, runId, branchName, plan, verificatio
 }
 function cleanupStageSourceBranches(root, branchName, manifest) {
   const results = [];
-  for (const repo of checkedOutStagePackageRepos(root)) {
+  for (const repo of checkedOutStagePromotionRepos(root)) {
     const manifestRepo = manifest.packages.find((entry) => entry.name === repo.name);
     if (!manifestRepo) continue;
     const remoteDeleted = deleteRemoteBranch(repo.dir, branchName);
@@ -5320,7 +5386,7 @@ ${currentBlockers.map((entry) => `- ${entry}`).join("\n")}`, {
         const mergeDown = await executeJournalStep(root, workflowRun.runId, "merge-staging-down", () => {
           const results = [];
           try {
-            for (const repo of checkedOutStagePackageRepos(root)) {
+            for (const repo of checkedOutStagePromotionRepos(root)) {
               if (!remoteBranchExists(repo.dir, featureBranch)) {
                 results.push({ name: repo.name, path: repo.dir, skipped: true, reason: "remote-branch-missing" });
                 continue;
@@ -5622,6 +5688,7 @@ async function workflowRelease(helpers, input) {
       const rootRepo = createWorkspaceRootRepoReport(root);
       traceReleaseStartup("inspect package repos");
       const packageReports = createWorkspacePackageReports(root);
+      const releaseHelperRepos = checkedOutReleaseHelperRepos(root);
       const explicitResumeRunId = helpers.context.workflow?.resumeRunId ?? null;
       traceReleaseStartup("check auto resume");
       const autoResumeRun = executionMode === "execute" && !explicitResumeRunId && input.fresh !== true ? findAutoResumableReleaseRun(root, session.branchName, rootRepo, packageReports, { archiveStale: false }) : null;
@@ -5653,6 +5720,7 @@ async function workflowRelease(helpers, input) {
         level,
         repairVersionLine: effectiveInput.repairVersionLine === true
       });
+      blockers.push(...collectReleaseHelperRepoBlockers(root));
       const selectedVersions = releasePlanVersionMap(plannedRelease.plannedVersions);
       const releaseImageVersions = productionReleaseImageRefVersions(root, selectedVersions);
       const releaseImageRefs = productionReleaseImageRefEnv(releaseImageVersions);
@@ -5673,6 +5741,12 @@ async function workflowRelease(helpers, input) {
         sceneArtifacts: normalizeSceneArtifactsMode(effectiveInput.sceneArtifacts),
         releaseImageRefs,
         localCleanup,
+        releaseHelperRepos: releaseHelperRepos.map((repo) => ({
+          name: repo.name,
+          kind: repo.kind,
+          path: repo.relativeDir,
+          remote: repo.remoteUrl
+        })),
         freshArchivedRuns: [],
         autoResumeCandidate: planAutoResumeRun ? {
           runId: planAutoResumeRun.runId,
@@ -5740,6 +5814,14 @@ ${blockers.join("\n")}`, {
               resumable: true
             };
           }),
+          {
+            id: "release-helper-repos",
+            description: "Promote starter templates and shared fixture repositories from staging to production",
+            repoName: rootRepo.name,
+            repoPath: rootRepo.path,
+            branch: STAGING_BRANCH,
+            resumable: true
+          },
           { id: "verify-published-artifacts", description: "Verify immutable registry artifacts exist after publish workflows", repoName: rootRepo.name, repoPath: rootRepo.path, branch: PRODUCTION_BRANCH, resumable: true },
           { id: "production-package-deploy-workflows", description: "Wait for production package deploy workflows before live verification", repoName: rootRepo.name, repoPath: rootRepo.path, branch: PRODUCTION_BRANCH, resumable: true },
           { id: "production-hosting", description: "Reconcile and live-verify production hosted resources before root deploy", repoName: rootRepo.name, repoPath: rootRepo.path, branch: PRODUCTION_BRANCH, resumable: true },
@@ -5861,6 +5943,11 @@ ${rendered}`);
           });
           packageReleases.push(packageRelease);
         }
+        const managedHelperReleases = await executeJournalStep(root, workflowRun.runId, "release-helper-repos", () => {
+          const releases = releaseHelperRepos.map((repo) => releaseHelperRepoToProduction(repo));
+          syncAllCheckedOutReleaseHelperRepos(root, STAGING_BRANCH);
+          return { status: "completed", repos: releases };
+        });
         const publishedArtifacts = await executeJournalStep(root, workflowRun.runId, "verify-published-artifacts", () => verifyPublishedReleaseArtifacts(selectedVersions));
         const productionPackageDeployWorkflows = await executeJournalStep(root, workflowRun.runId, "production-package-deploy-workflows", () => {
           const deployGates = productionPackageDeployGates(root, allVersions);
@@ -5950,6 +6037,7 @@ ${rendered}`);
           workspaceUnlink,
           releaseMetadata,
           packageReleases,
+          managedHelperReleases,
           rootRelease,
           publishWait: publishWait.workflowGates,
           publishedArtifacts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.12.42",
+  "version": "0.12.43",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {