@treeseed/sdk 0.4.6 → 0.4.8

package/dist/workflow/policy.d.ts

@@ -0,0 +1,12 @@
+export type TreeseedWorkflowBranchRole = 'feature' | 'staging' | 'main' | 'detached' | 'none';
+export type TreeseedResolvedWorkflowPaths = {
+    requestedCwd: string;
+    tenantRoot: string | null;
+    cwd: string;
+    repoRoot: string | null;
+    branchName: string | null;
+    branchRole: TreeseedWorkflowBranchRole;
+};
+export declare function classifyTreeseedBranchRole(branchName: string | null, repoDir: string | null): TreeseedWorkflowBranchRole;
+export declare function resolveTreeseedWorkflowPaths(startCwd: string): TreeseedResolvedWorkflowPaths;
+export declare function workflowEnvironmentForBranchRole(branchRole: TreeseedWorkflowBranchRole): "local" | "staging" | "prod" | "none";

package/dist/workflow/policy.js

@@ -0,0 +1,58 @@
+import { findNearestTreeseedRoot, run } from "../operations/services/workspace-tools.js";
+import { currentBranch, repoRoot } from "../operations/services/workspace-save.js";
+import { PRODUCTION_BRANCH, STAGING_BRANCH } from "../operations/services/git-workflow.js";
+function safeRepoRoot(cwd) {
+  try {
+    return repoRoot(cwd);
+  } catch {
+    return null;
+  }
+}
+function repoHasHead(repoDir) {
+  try {
+    run("git", ["rev-parse", "--verify", "HEAD"], { cwd: repoDir, capture: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function classifyTreeseedBranchRole(branchName, repoDir) {
+  if (!repoDir) {
+    return "none";
+  }
+  if (!branchName) {
+    return repoHasHead(repoDir) ? "detached" : "none";
+  }
+  if (branchName === STAGING_BRANCH) {
+    return "staging";
+  }
+  if (branchName === PRODUCTION_BRANCH) {
+    return "main";
+  }
+  return "feature";
+}
+function resolveTreeseedWorkflowPaths(startCwd) {
+  const tenantRoot = findNearestTreeseedRoot(startCwd);
+  const cwd = tenantRoot ?? startCwd;
+  const gitRoot = safeRepoRoot(cwd);
+  const branchName = gitRoot ? currentBranch(gitRoot) || null : null;
+  return {
+    requestedCwd: startCwd,
+    tenantRoot,
+    cwd,
+    repoRoot: gitRoot,
+    branchName,
+    branchRole: classifyTreeseedBranchRole(branchName, gitRoot)
+  };
+}
+function workflowEnvironmentForBranchRole(branchRole) {
+  if (branchRole === "staging") return "staging";
+  if (branchRole === "main") return "prod";
+  if (branchRole === "feature") return "local";
+  return "none";
+}
+export {
+  classifyTreeseedBranchRole,
+  resolveTreeseedWorkflowPaths,
+  workflowEnvironmentForBranchRole
+};

package/dist/workflow-state.d.ts

@@ -1,5 +1,6 @@
 import type { TreeseedWorkflowNextStep } from './workflow.ts';
-export type TreeseedBranchRole = 'feature' | 'staging' | 'main' | 'detached' | 'none';
+import { type TreeseedWorkflowBranchRole } from './workflow/policy.ts';
+export type TreeseedBranchRole = TreeseedWorkflowBranchRole;
 export type TreeseedWorkflowRecommendation = TreeseedWorkflowNextStep;
 export type TreeseedWorkflowState = {
     cwd: string;
@@ -44,6 +45,23 @@ export type TreeseedWorkflowState = {
         devVars: boolean;
     };
     releaseReady: boolean;
+    readiness: {
+        local: {
+            ready: boolean;
+            blockers: string[];
+            warnings: string[];
+        };
+        staging: {
+            ready: boolean;
+            blockers: string[];
+            warnings: string[];
+        };
+        prod: {
+            ready: boolean;
+            blockers: string[];
+            warnings: string[];
+        };
+    };
     rollbackCandidates: Array<{
         scope: 'staging' | 'prod';
         commit: string | null;

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-support.d.ts

@@ -1,4 +1,5 @@
-export { applyTreeseedEnvironmentToProcess, assertTreeseedCommandEnvironment, checkTreeseedProviderConnections, clearTreeseedRemoteSession, createDefaultTreeseedMachineConfig, ensureTreeseedGitignoreEntries, formatTreeseedConfigEnvironmentReport, formatTreeseedProviderConnectionReport, getTreeseedMachineConfigPaths, loadTreeseedMachineConfig, resolveTreeseedMachineEnvironmentValues, resolveTreeseedRemoteConfig, resolveTreeseedRemoteSession, rotateTreeseedMachineKey, runTreeseedConfigWizard, setTreeseedRemoteSession, writeTreeseedLocalEnvironmentFiles, writeTreeseedMachineConfig, } from './operations/services/config-runtime.ts';
+export { applyTreeseedConfigValues, applyTreeseedEnvironmentToProcess, applyTreeseedSafeRepairs, assertTreeseedCommandEnvironment, checkTreeseedProviderConnections, clearTreeseedRemoteSession, collectTreeseedConfigContext, collectTreeseedPrintEnvReport, createDefaultTreeseedMachineConfig, ensureTreeseedGitignoreEntries, getTreeseedMachineConfigPaths, loadTreeseedMachineConfig, listRelevantTreeseedConfigEntries, finalizeTreeseedConfig, resolveTreeseedMachineEnvironmentValues, resolveTreeseedRemoteConfig, resolveTreeseedRemoteSession, rotateTreeseedMachineKey, setTreeseedRemoteSession, writeTreeseedLocalEnvironmentFiles, writeTreeseedMachineConfig, } from './operations/services/config-runtime.ts';
+export { exportTreeseedCodebase } from './operations/services/export-runtime.ts';
 export { assertDeploymentInitialized, cleanupDestroyedState, createBranchPreviewDeployTarget, createPersistentDeployTarget, deployTargetLabel, destroyCloudflareResources, ensureGeneratedWranglerConfig, finalizeDeploymentState, loadDeployState, printDeploySummary, printDestroySummary, provisionCloudflareResources, runRemoteD1Migrations, syncCloudflareSecrets, validateDeployPrerequisites, validateDestroyPrerequisites, } from './operations/services/deploy.ts';
 export { assertCleanWorktree, assertFeatureBranch, branchExists, checkoutBranch, createDeprecatedTaskTag, createFeatureBranchFromStaging, currentManagedBranch, deleteLocalBranch, deleteRemoteBranch, ensureLocalBranchTracking, gitWorkflowRoot, listTaskBranches, mergeCurrentBranchIntoStaging, mergeStagingIntoMain, prepareReleaseBranches, PRODUCTION_BRANCH, pushBranch, remoteBranchExists, STAGING_BRANCH, syncBranchWithOrigin, waitForStagingAutomation, } from './operations/services/git-workflow.ts';
 export { loadCliDeployConfig, packageScriptPath, resolveWranglerBin, } from './operations/services/runtime-tools.ts';

package/dist/workflow-support.js

@@ -1,23 +1,27 @@
 import {
+  applyTreeseedConfigValues,
   applyTreeseedEnvironmentToProcess,
+  applyTreeseedSafeRepairs,
   assertTreeseedCommandEnvironment,
   checkTreeseedProviderConnections,
   clearTreeseedRemoteSession,
+  collectTreeseedConfigContext,
+  collectTreeseedPrintEnvReport,
   createDefaultTreeseedMachineConfig,
   ensureTreeseedGitignoreEntries,
-  formatTreeseedConfigEnvironmentReport,
-  formatTreeseedProviderConnectionReport,
   getTreeseedMachineConfigPaths,
   loadTreeseedMachineConfig,
+  listRelevantTreeseedConfigEntries,
+  finalizeTreeseedConfig,
   resolveTreeseedMachineEnvironmentValues,
   resolveTreeseedRemoteConfig,
   resolveTreeseedRemoteSession,
   rotateTreeseedMachineKey,
-  runTreeseedConfigWizard,
   setTreeseedRemoteSession,
   writeTreeseedLocalEnvironmentFiles,
   writeTreeseedMachineConfig
 } from "./operations/services/config-runtime.js";
+import { exportTreeseedCodebase } from "./operations/services/export-runtime.js";
 import {
   assertDeploymentInitialized,
   cleanupDestroyedState,
@@ -96,7 +100,9 @@ import {
 export {
   PRODUCTION_BRANCH,
   STAGING_BRANCH,
+  applyTreeseedConfigValues,
   applyTreeseedEnvironmentToProcess,
+  applyTreeseedSafeRepairs,
   applyWorkspaceVersionChanges,
   assertCleanWorktree,
   assertDeploymentInitialized,
@@ -109,6 +115,8 @@ export {
   clearTreeseedRemoteSession,
   collectCliPreflight,
   collectMergeConflictReport,
+  collectTreeseedConfigContext,
+  collectTreeseedPrintEnvReport,
   configuredRailwayServices,
   createBranchPreviewDeployTarget,
   createDefaultTreeseedMachineConfig,
@@ -125,18 +133,19 @@ export {
   ensureGeneratedWranglerConfig,
   ensureLocalBranchTracking,
   ensureTreeseedGitignoreEntries,
+  exportTreeseedCodebase,
   finalizeDeploymentState,
+  finalizeTreeseedConfig,
   findNearestTreeseedRoot,
   findNearestTreeseedWorkspaceRoot,
   formatMergeConflictReport,
-  formatTreeseedConfigEnvironmentReport,
-  formatTreeseedProviderConnectionReport,
   getTreeseedMachineConfigPaths,
   gitStatusPorcelain,
   gitWorkflowRoot,
   hasMeaningfulChanges,
   incrementVersion,
   isWorkspaceRoot,
+  listRelevantTreeseedConfigEntries,
   listTaskBranches,
   loadCliDeployConfig,
   loadDeployState,
@@ -161,7 +170,6 @@ export {
   run,
   runRemoteD1Migrations,
   runTenantDeployPreflight,
-  runTreeseedConfigWizard,
   runWorkspaceSavePreflight,
   setTreeseedRemoteSession,
   syncBranchWithOrigin,

package/dist/workflow.d.ts

@@ -1,7 +1,7 @@
 import { resolveTreeseedWorkflowState } from './workflow-state.ts';
 import { listTaskBranches } from './operations/services/git-workflow.ts';
 import { TreeseedWorkflowError, type TreeseedWorkflowErrorCode } from './workflow/operations.ts';
-export type TreeseedWorkflowOperationId = 'status' | 'config' | 'tasks' | 'switch' | 'dev' | 'save' | 'close' | 'stage' | 'release' | 'destroy';
+export type TreeseedWorkflowOperationId = 'status' | 'config' | 'tasks' | 'switch' | 'dev' | 'save' | 'close' | 'stage' | 'release' | 'destroy' | 'export';
 export type TreeseedWorkflowNextStep = {
     operation: string;
     reason?: string;
@@ -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;
@@ -61,6 +64,12 @@ export type TreeseedConfigInput = {
     environment?: TreeseedConfigScope[] | TreeseedConfigScope;
     syncProviders?: 'none' | 'github' | 'cloudflare' | 'railway' | 'all';
     sync?: 'none' | 'github' | 'cloudflare' | 'railway' | 'all';
+    updates?: Array<{
+        scope: Exclude<TreeseedConfigScope, 'all'>;
+        entryId: string;
+        value: string;
+        reused?: boolean;
+    }>;
     repair?: boolean;
     printEnv?: boolean;
     printEnvOnly?: boolean;
@@ -68,6 +77,9 @@ export type TreeseedConfigInput = {
     rotateMachineKey?: boolean;
     nonInteractive?: boolean;
 };
+export type TreeseedExportInput = {
+    directory?: string;
+};
 export type TreeseedReleaseInput = {
     bump: 'major' | 'minor' | 'patch';
 };
@@ -108,4 +120,5 @@ export declare class TreeseedWorkflowSdk {
     stage(input: TreeseedStageInput): Promise<TreeseedWorkflowResult>;
     release(input: TreeseedReleaseInput): Promise<TreeseedWorkflowResult>;
     destroy(input: TreeseedDestroyInput): Promise<TreeseedWorkflowResult>;
+    export(input?: TreeseedExportInput): Promise<TreeseedWorkflowResult>;
 }

package/dist/workflow.js

@@ -1,9 +1,11 @@
+import { resolveTreeseedWorkflowPaths } from "./workflow/policy.js";
 import {
   TreeseedWorkflowError,
   workflowClose,
   workflowConfig,
   workflowDestroy,
   workflowDev,
+  workflowExport,
   workflowRelease,
   workflowSave,
   workflowStage,
@@ -28,7 +30,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()
@@ -56,6 +58,8 @@ class TreeseedWorkflowSdk {
         return this.release(input);
       case "destroy":
         return this.destroy(input);
+      case "export":
+        return this.export(input);
       default:
         throw new Error(`Unsupported workflow operation "${operation}".`);
     }
@@ -90,6 +94,9 @@ class TreeseedWorkflowSdk {
   async destroy(input) {
     return workflowDestroy(this.helpers(), input);
   }
+  async export(input = {}) {
+    return workflowExport(this.helpers(), input);
+  }
 }
 export {
   TreeseedWorkflowError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -58,6 +58,7 @@
     "react": "^19.2.5",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",
+    "repomix": "^1.13.1",
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "yaml": "^2.8.1"
@@ -132,6 +133,10 @@
       "types": "./dist/platform/books-data.d.ts",
       "default": "./dist/platform/books-data.js"
     },
+    "./platform/book-export": {
+      "types": "./dist/platform/book-export.d.ts",
+      "default": "./dist/platform/book-export.js"
+    },
     "./platform/site-config-schema": {
       "types": "./dist/platform/site-config-schema.d.ts",
       "default": "./dist/platform/site-config-schema.js"