@treeseed/sdk 0.4.7 → 0.4.8

package/dist/workflow/operations.js

@@ -1,23 +1,21 @@
-import { readFileSync, writeFileSync, existsSync, copyFileSync } from "node:fs";
+import { readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
 import {
   applyTreeseedEnvironmentToProcess,
+  applyTreeseedConfigValues,
+  applyTreeseedSafeRepairs,
   assertTreeseedCommandEnvironment,
   checkTreeseedProviderConnections,
-  createDefaultTreeseedMachineConfig,
+  collectTreeseedConfigContext,
+  collectTreeseedPrintEnvReport,
   ensureTreeseedActVerificationTooling,
   ensureTreeseedGitignoreEntries,
-  formatTreeseedConfigEnvironmentReport,
-  formatTreeseedProviderConnectionReport,
+  finalizeTreeseedConfig,
   getTreeseedMachineConfigPaths,
-  loadTreeseedMachineConfig,
-  resolveTreeseedMachineEnvironmentValues,
-  rotateTreeseedMachineKey,
-  runTreeseedConfigWizard,
-  writeTreeseedLocalEnvironmentFiles,
-  writeTreeseedMachineConfig
+  rotateTreeseedMachineKey
 } from "../operations/services/config-runtime.js";
+import { exportTreeseedCodebase } from "../operations/services/export-runtime.js";
 import {
   assertDeploymentInitialized,
   cleanupDestroyedState,
@@ -196,51 +194,6 @@ function ensureLocalReadinessOrThrow(operation, tenantRoot) {
   }
   return state;
 }
-function dedupeRepairActions(actions) {
-  const seen = /* @__PURE__ */ new Set();
-  return actions.filter((action) => {
-    if (seen.has(action.id)) return false;
-    seen.add(action.id);
-    return true;
-  });
-}
-function applyTreeseedSafeRepairs(tenantRoot) {
-  const actions = [];
-  ensureTreeseedGitignoreEntries(tenantRoot);
-  actions.push({ id: "gitignore", detail: "Ensured Treeseed gitignore entries are present." });
-  const envLocalPath = resolve(tenantRoot, ".env.local");
-  const envLocalExamplePath = resolve(tenantRoot, ".env.local.example");
-  if (!existsSync(envLocalPath) && existsSync(envLocalExamplePath)) {
-    copyFileSync(envLocalExamplePath, envLocalPath);
-    actions.push({ id: "env-local", detail: "Created .env.local from .env.local.example." });
-  }
-  const deployConfig = loadCliDeployConfig(tenantRoot);
-  const { configPath } = getTreeseedMachineConfigPaths(tenantRoot);
-  if (!existsSync(configPath)) {
-    const machineConfig2 = createDefaultTreeseedMachineConfig({
-      tenantRoot,
-      deployConfig,
-      tenantConfig: void 0
-    });
-    writeTreeseedMachineConfig(tenantRoot, machineConfig2);
-    actions.push({ id: "machine-config", detail: "Created the default Treeseed machine config." });
-  }
-  resolveTreeseedMachineEnvironmentValues(tenantRoot, "local");
-  actions.push({ id: "machine-key", detail: "Ensured the Treeseed machine key exists." });
-  const machineConfig = loadTreeseedMachineConfig(tenantRoot);
-  writeTreeseedMachineConfig(tenantRoot, machineConfig);
-  writeTreeseedLocalEnvironmentFiles(tenantRoot);
-  actions.push({ id: "local-env", detail: "Regenerated .env.local and .dev.vars from the current machine config." });
-  for (const scope of ["local", "staging", "prod"]) {
-    const target = createPersistentDeployTarget(scope);
-    const state = loadDeployState(tenantRoot, deployConfig, { target });
-    if (state.readiness?.initialized || scope === "local") {
-      ensureGeneratedWranglerConfig(tenantRoot, { target });
-      actions.push({ id: `wrangler-${scope}`, detail: `Regenerated the ${scope} generated Wrangler config.` });
-    }
-  }
-  return dedupeRepairActions(actions);
-}
 function bumpRootPackageJson(root, level) {
   const packageJsonPath = resolve(root, "package.json");
   const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
@@ -456,23 +409,22 @@ async function workflowConfig(helpers, input = {}) {
       });
       ensureTreeseedGitignoreEntries(tenantRoot);
       const preflight = collectCliPreflight({ cwd: tenantRoot, requireAuth: false });
+      const contextSnapshot = collectTreeseedConfigContext({
+        tenantRoot,
+        scopes,
+        env: helpers.context.env
+      });
       if (printEnvOnly) {
-        const reports = scopes.map((scope) => ({
+        const reports2 = scopes.map((scope) => ({
           scope,
-          environmentReport: formatTreeseedConfigEnvironmentReport({
+          environment: collectTreeseedPrintEnvReport({
             tenantRoot,
             scope,
             env: helpers.context.env,
             revealSecrets
           }),
-          providerReport: formatTreeseedProviderConnectionReport(
-            checkTreeseedProviderConnections({ tenantRoot, scope, env: helpers.context.env })
-          )
+          provider: checkTreeseedProviderConnections({ tenantRoot, scope, env: helpers.context.env })
         }));
-        for (const report of reports) {
-          maybePrint(helpers.write, report.environmentReport);
-          maybePrint(helpers.write, report.providerReport);
-        }
         return {
           ok: true,
           operation: "config",
@@ -481,7 +433,7 @@ async function workflowConfig(helpers, input = {}) {
             scopes,
             sync,
             secretsRevealed: revealSecrets,
-            reports,
+            reports: reports2,
             repairs,
             preflight,
             toolHealth
@@ -510,25 +462,40 @@ async function workflowConfig(helpers, input = {}) {
           ])
         };
       }
-      const wizardResult = await runTreeseedConfigWizard({
+      const explicitUpdates = Array.isArray(input.updates) ? input.updates.map((update) => ({
+        scope: update.scope,
+        entryId: String(update.entryId ?? ""),
+        value: typeof update.value === "string" ? update.value : "",
+        reused: update.reused === true
+      })) : null;
+      const autoUpdates = scopes.flatMap(
+        (scope) => contextSnapshot.entriesByScope[scope].map((entry) => ({
+          scope,
+          entryId: entry.id,
+          value: entry.effectiveValue,
+          reused: entry.currentValue.length > 0 || entry.suggestedValue.length > 0
+        }))
+      );
+      const applyResult = applyTreeseedConfigValues({
+        tenantRoot,
+        updates: explicitUpdates ?? autoUpdates
+      });
+      const finalizeResult = finalizeTreeseedConfig({
         tenantRoot,
         scopes,
         sync,
-        authStatus: preflight.checks.auth,
-        env: helpers.context.env,
-        useInk: input.nonInteractive === true ? false : process.stdin.isTTY && process.stdout.isTTY,
-        printEnv,
-        revealSecrets,
-        write: (line) => maybePrint(helpers.write, line),
-        prompt: async (message) => {
-          if (input.nonInteractive === true) {
-            return "";
-          }
-          return String(await (helpers.context.prompt?.(message) ?? ""));
-        }
+        env: helpers.context.env
       });
-      writeTreeseedLocalEnvironmentFiles(tenantRoot);
-      applyTreeseedEnvironmentToProcess({ tenantRoot, scope: "local", override: true });
+      const reports = printEnv ? scopes.map((scope) => ({
+        scope,
+        environment: collectTreeseedPrintEnvReport({
+          tenantRoot,
+          scope,
+          env: helpers.context.env,
+          revealSecrets
+        }),
+        provider: finalizeResult.connectionChecks.find((report) => report.scope === scope) ?? checkTreeseedProviderConnections({ tenantRoot, scope, env: helpers.context.env })
+      })) : [];
       const { configPath, keyPath } = getTreeseedMachineConfigPaths(tenantRoot);
       const state = resolveTreeseedWorkflowState(tenantRoot);
       return buildWorkflowResult(
@@ -543,7 +510,12 @@ async function workflowConfig(helpers, input = {}) {
           repairs,
           preflight,
           toolHealth,
-          result: wizardResult,
+          context: contextSnapshot,
+          result: {
+            ...applyResult,
+            ...finalizeResult
+          },
+          reports,
           state,
           readiness: state.readiness
         },
@@ -558,6 +530,13 @@ async function workflowConfig(helpers, input = {}) {
     toError("config", error);
   }
 }
+async function workflowExport(helpers, input = {}) {
+  return await withContextEnv(helpers.context.env, async () => {
+    const directory = resolve(helpers.context.cwd ?? helpers.cwd(), input.directory ?? ".");
+    const exported = await exportTreeseedCodebase({ directory });
+    return buildWorkflowResult("export", exported.tenantRoot, exported);
+  });
+}
 async function workflowSwitch(helpers, input) {
   try {
     return withContextEnv(helpers.context.env, () => {
@@ -966,6 +945,7 @@ export {
   workflowConfig,
   workflowDestroy,
   workflowDev,
+  workflowExport,
   workflowRelease,
   workflowSave,
   workflowStage,

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;
@@ -64,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;
@@ -71,6 +77,9 @@ export type TreeseedConfigInput = {
     rotateMachineKey?: boolean;
     nonInteractive?: boolean;
 };
+export type TreeseedExportInput = {
+    directory?: string;
+};
 export type TreeseedReleaseInput = {
     bump: 'major' | 'minor' | 'patch';
 };
@@ -111,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

@@ -5,6 +5,7 @@ import {
   workflowConfig,
   workflowDestroy,
   workflowDev,
+  workflowExport,
   workflowRelease,
   workflowSave,
   workflowStage,
@@ -57,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}".`);
     }
@@ -91,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.7",
+  "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"