@treeseed/sdk 0.4.5 → 0.4.7

package/dist/workflow-state.js

@@ -6,30 +6,14 @@ import {
   createPersistentDeployTarget,
   loadDeployState
 } from "./operations/services/deploy.js";
-import { PRODUCTION_BRANCH, STAGING_BRANCH } from "./operations/services/git-workflow.js";
 import { loadCliDeployConfig } from "./operations/services/runtime-tools.js";
 import { collectCliPreflight } from "./operations/services/workspace-preflight.js";
-import { currentBranch, gitStatusPorcelain, repoRoot } from "./operations/services/workspace-save.js";
+import { gitStatusPorcelain } from "./operations/services/workspace-save.js";
 import { isWorkspaceRoot } from "./operations/services/workspace-tools.js";
-function safeResolveRepoRoot(cwd) {
-  try {
-    return repoRoot(cwd);
-  } catch {
-    return null;
-  }
-}
-function branchRoleFor(branchName) {
-  if (!branchName) return "none";
-  if (branchName === STAGING_BRANCH) return "staging";
-  if (branchName === PRODUCTION_BRANCH) return "main";
-  return "feature";
-}
-function environmentForBranchRole(branchRole) {
-  if (branchRole === "staging") return "staging";
-  if (branchRole === "main") return "prod";
-  if (branchRole === "feature") return "local";
-  return "none";
-}
+import {
+  resolveTreeseedWorkflowPaths,
+  workflowEnvironmentForBranchRole
+} from "./workflow/policy.js";
 function emptyPersistentEnvironments() {
   return {
     local: { initialized: false, lastValidatedAt: null, lastDeploymentTimestamp: null, lastDeployedUrl: null },
@@ -37,25 +21,54 @@ function emptyPersistentEnvironments() {
     prod: { initialized: false, lastValidatedAt: null, lastDeploymentTimestamp: null, lastDeployedUrl: null }
   };
 }
+function readinessForEnvironment(state, scope) {
+  const blockers = [];
+  const warnings = [];
+  if (!state.deployConfigPresent) {
+    blockers.push("Missing treeseed.site.yaml.");
+  }
+  if (!state.files.machineConfig) {
+    blockers.push("Missing Treeseed machine config.");
+  }
+  if (scope === "local") {
+    if (!state.files.envLocal) {
+      blockers.push("Missing .env.local.");
+    }
+    if (!state.files.devVars) {
+      warnings.push("Missing .dev.vars.");
+    }
+  } else {
+    if (!state.persistentEnvironments[scope].initialized) {
+      blockers.push(`Environment ${scope} is not initialized.`);
+    }
+  }
+  return {
+    ready: blockers.length === 0,
+    blockers,
+    warnings
+  };
+}
 function resolveTreeseedWorkflowState(cwd) {
-  const workspaceRoot = isWorkspaceRoot(cwd);
-  const treeseedConfigPath = resolve(cwd, "treeseed.site.yaml");
+  const resolved = resolveTreeseedWorkflowPaths(cwd);
+  const effectiveCwd = resolved.cwd;
+  const workspaceRoot = isWorkspaceRoot(effectiveCwd);
+  const treeseedConfigPath = resolve(effectiveCwd, "treeseed.site.yaml");
   const tenantRoot = existsSync(treeseedConfigPath);
-  const root = safeResolveRepoRoot(cwd);
-  const branchName = root ? currentBranch(root) || null : null;
-  const branchRole = branchRoleFor(branchName);
+  const root = resolved.repoRoot;
+  const branchName = resolved.branchName;
+  const branchRole = resolved.branchRole;
   const dirtyWorktree = root ? gitStatusPorcelain(root).length > 0 : false;
-  const preflight = collectCliPreflight({ cwd, requireAuth: false });
-  const { configPath, keyPath } = getTreeseedMachineConfigPaths(cwd);
+  const preflight = collectCliPreflight({ cwd: effectiveCwd, requireAuth: false });
+  const { configPath, keyPath } = getTreeseedMachineConfigPaths(effectiveCwd);
   const state = {
-    cwd,
+    cwd: effectiveCwd,
     workspaceRoot,
     tenantRoot,
     deployConfigPresent: tenantRoot,
     repoRoot: root,
     branchName,
     branchRole,
-    environment: environmentForBranchRole(branchRole),
+    environment: workflowEnvironmentForBranchRole(branchRole),
     dirtyWorktree,
     preview: {
       enabled: false,
@@ -86,14 +99,19 @@ function resolveTreeseedWorkflowState(cwd) {
       devVars: existsSync(resolve(cwd, ".dev.vars"))
     },
     releaseReady: branchRole === "staging" && !dirtyWorktree,
+    readiness: {
+      local: { ready: false, blockers: [], warnings: [] },
+      staging: { ready: false, blockers: [], warnings: [] },
+      prod: { ready: false, blockers: [], warnings: [] }
+    },
     rollbackCandidates: [],
     recommendations: []
   };
   if (tenantRoot) {
     try {
-      const deployConfig = loadCliDeployConfig(cwd);
+      const deployConfig = loadCliDeployConfig(effectiveCwd);
       for (const scope of ["local", "staging", "prod"]) {
-        const deployState = loadDeployState(cwd, deployConfig, { target: createPersistentDeployTarget(scope) });
+        const deployState = loadDeployState(effectiveCwd, deployConfig, { target: createPersistentDeployTarget(scope) });
         state.persistentEnvironments[scope] = {
           initialized: deployState.readiness?.initialized === true || scope === "local",
           lastValidatedAt: deployState.readiness?.lastValidatedAt ?? deployState.readiness?.initializedAt ?? null,
@@ -123,7 +141,7 @@ function resolveTreeseedWorkflowState(cwd) {
         }
       }
       if (branchRole === "feature" && branchName) {
-        const previewState = loadDeployState(cwd, deployConfig, { target: createBranchPreviewDeployTarget(branchName) });
+        const previewState = loadDeployState(effectiveCwd, deployConfig, { target: createBranchPreviewDeployTarget(branchName) });
         state.preview = {
           enabled: previewState.previewEnabled === true || previewState.readiness?.initialized === true,
           url: previewState.lastDeployedUrl ?? null,
@@ -133,6 +151,9 @@ function resolveTreeseedWorkflowState(cwd) {
     } catch {
     }
   }
+  state.readiness.local = readinessForEnvironment(state, "local");
+  state.readiness.staging = readinessForEnvironment(state, "staging");
+  state.readiness.prod = readinessForEnvironment(state, "prod");
   state.recommendations = recommendTreeseedNextSteps(state);
   return state;
 }
@@ -150,13 +171,10 @@ function recommendTreeseedNextSteps(state) {
     return recommendations;
   }
   if (state.branchRole === "feature") {
-    if (state.dirtyWorktree) {
-      recommendations.push({ operation: "save", reason: "Persist, verify, and push the current task branch before staging or closing it.", input: { message: "describe your change" } });
-    } else {
-      recommendations.push({ operation: "stage", reason: "Merge this task branch into staging and clean up branch artifacts.", input: { message: "describe the resolution" } });
-    }
+    recommendations.push({ operation: "stage", reason: "Merge this task branch into staging and clean up branch artifacts.", input: { message: "describe the resolution" } });
+    recommendations.push({ operation: "save", reason: "Persist, verify, and push the current task branch before or independently of staging it.", input: { message: "describe your change" } });
     if (state.preview.enabled && state.branchName) {
-      recommendations.push({ operation: "save", reason: "Save refreshes the branch preview deployment when one is enabled.", input: { message: "describe your change" } });
+      recommendations.push({ operation: "save", reason: "Save refreshes the branch preview deployment when one is enabled.", input: { message: "describe your change", preview: true } });
     } else {
       recommendations.push({ operation: "dev", reason: "Use the local environment for iterative work on this feature branch." });
     }

package/dist/workflow.d.ts

@@ -35,18 +35,21 @@ export type TreeseedSaveInput = {
     hotfix?: boolean;
     verify?: boolean;
     refreshPreview?: boolean;
+    preview?: boolean;
     rebase?: boolean;
 };
 export type TreeseedCloseInput = {
     message: string;
     deletePreview?: boolean;
     deleteBranch?: boolean;
+    autoSave?: boolean;
 };
 export type TreeseedStageInput = {
     message: string;
     waitForStaging?: boolean;
     deletePreview?: boolean;
     deleteBranch?: boolean;
+    autoSave?: boolean;
 };
 export type TreeseedSwitchInput = {
     branch?: string;

package/dist/workflow.js

@@ -1,3 +1,4 @@
+import { resolveTreeseedWorkflowPaths } from "./workflow/policy.js";
 import {
   TreeseedWorkflowError,
   workflowClose,
@@ -28,7 +29,7 @@ class TreeseedWorkflowSdk {
     };
     return {
       context,
-      cwd: () => context.cwd ?? process.cwd(),
+      cwd: () => resolveTreeseedWorkflowPaths(context.cwd ?? process.cwd()).cwd,
       write: context.write ?? defaultWrite,
       runStatus: async () => this.status(),
       runTasks: async () => this.tasks()

package/package.json

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