@treeseed/sdk 0.4.7 → 0.4.9

package/dist/operations/services/deploy.d.ts

@@ -23,7 +23,6 @@ export declare function ensureGeneratedWranglerConfig(tenantRoot: any, options?:
         cloudflare: {
             accountId: string;
             workerName: string | undefined;
-            gatewayWorkerName: string | undefined;
             queueName: string | undefined;
             dlqName: string | undefined;
             d1Binding: string | undefined;
@@ -126,7 +125,6 @@ export declare function validateDeployPrerequisites(tenantRoot: any, { requireRe
     cloudflare: {
         accountId: string;
         workerName: string | undefined;
-        gatewayWorkerName: string | undefined;
         queueName: string | undefined;
         dlqName: string | undefined;
         d1Binding: string | undefined;
@@ -210,7 +208,6 @@ export declare function validateDestroyPrerequisites(tenantRoot: any, { requireR
     cloudflare: {
         accountId: string;
         workerName: string | undefined;
-        gatewayWorkerName: string | undefined;
         queueName: string | undefined;
         dlqName: string | undefined;
         d1Binding: string | undefined;

package/dist/operations/services/deploy.js

@@ -10,7 +10,7 @@ const DEFAULT_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 const GENERATED_ROOT = ".treeseed/generated";
 const STATE_ROOT = ".treeseed/state";
 const PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "staging", "prod"]);
-const MANAGED_SERVICE_KEYS = ["api", "agents", "gateway", "manager", "worker", "workdayStart", "workdayReport"];
+const MANAGED_SERVICE_KEYS = ["api", "agents", "manager", "worker", "runner", "workdayStart", "workdayReport"];
 const TRESEED_ENVELOPE_SCHEMA_GENERATION = "runtime-envelopes-v1";
 const TRESEED_MIGRATION_WAVE_ID = "0005_runtime_envelopes";
 const TRESEED_SUPPORTED_PAYLOAD_RANGE = { min: 1, max: 1 };

package/dist/operations/services/export-runtime.d.ts

@@ -0,0 +1,18 @@
+export type TreeseedExportResult = {
+    directory: string;
+    tenantRoot: string;
+    outputPath: string;
+    branch: string;
+    timestamp: string;
+    includedBundlePaths: string[];
+    ignorePatterns: string[];
+    summary: {
+        totalFiles: number;
+        totalCharacters: number;
+        totalTokens: number;
+        outputFiles: string[];
+    };
+};
+export declare function exportTreeseedCodebase({ directory, }?: {
+    directory?: string;
+}): Promise<TreeseedExportResult>;

package/dist/operations/services/export-runtime.js

@@ -0,0 +1,136 @@
+import { existsSync, mkdirSync, statSync } from "node:fs";
+import { resolve, relative } from "node:path";
+import { runDefaultAction, setLogLevel } from "repomix";
+import { loadTreeseedDeployConfigFromPath, resolveTreeseedDeployConfigPathFromRoot } from "../../platform/deploy-config.js";
+import { findNearestTreeseedRoot } from "./workspace-tools.js";
+import { currentBranch, repoRoot } from "./workspace-save.js";
+function ensureDirectory(directory) {
+  if (!existsSync(directory)) {
+    throw new Error(`Treeseed export directory does not exist: ${directory}`);
+  }
+  const stats = statSync(directory);
+  if (!stats.isDirectory()) {
+    throw new Error(`Treeseed export directory must be a directory: ${directory}`);
+  }
+}
+function formatExportTimestamp(date = /* @__PURE__ */ new Date()) {
+  const year = date.getFullYear();
+  const month = `${date.getMonth() + 1}`.padStart(2, "0");
+  const day = `${date.getDate()}`.padStart(2, "0");
+  const hours = `${date.getHours()}`.padStart(2, "0");
+  const minutes = `${date.getMinutes()}`.padStart(2, "0");
+  const seconds = `${date.getSeconds()}`.padStart(2, "0");
+  return `${year}-${month}-${day}-${hours}-${minutes}-${seconds}`;
+}
+function sanitizeBranchSegment(branch) {
+  const sanitized = String(branch ?? "").trim().replaceAll(/[\\/]+/g, "-").replaceAll(/[^a-zA-Z0-9._-]+/g, "-").replaceAll(/-+/g, "-").replaceAll(/^-|-$/g, "");
+  return sanitized || "detached";
+}
+function resolveGitBranch(directory) {
+  try {
+    const gitRoot = repoRoot(directory);
+    const branch = currentBranch(gitRoot);
+    return sanitizeBranchSegment(branch);
+  } catch {
+    return "detached";
+  }
+}
+function resolveExportOutputPath(directory, branch, timestamp) {
+  const exportsRoot = resolve(directory, ".treeseed", "exports");
+  mkdirSync(exportsRoot, { recursive: true });
+  return resolve(exportsRoot, `${branch}-${timestamp}.md`);
+}
+function resolveConfiguredBundlePaths(directory, tenantRoot, config) {
+  const includedBundlePaths = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const configuredPath of config.export?.bundledPaths ?? []) {
+    const absolutePath = resolve(tenantRoot, configuredPath);
+    if (!existsSync(absolutePath)) {
+      continue;
+    }
+    const relativeToDirectory = relative(directory, absolutePath);
+    if (!relativeToDirectory || !relativeToDirectory.startsWith("..") && relativeToDirectory !== ".") {
+      continue;
+    }
+    if (seen.has(absolutePath)) {
+      continue;
+    }
+    seen.add(absolutePath);
+    includedBundlePaths.push(absolutePath);
+  }
+  return includedBundlePaths.sort((left, right) => left.localeCompare(right));
+}
+function resolveIgnorePatterns(config) {
+  return [
+    ".treeseed/exports",
+    ".treeseed/exports/**",
+    "**/.treeseed/exports",
+    "**/.treeseed/exports/**",
+    ...config.export?.ignore ?? []
+  ];
+}
+function toRepomixDirectories(directory, includedBundlePaths) {
+  return [".", ...includedBundlePaths.map((bundlePath) => relative(directory, bundlePath) || ".")];
+}
+function normalizePackResultOutputFiles(packResult, outputPath) {
+  return packResult.outputFiles && packResult.outputFiles.length > 0 ? packResult.outputFiles : [outputPath];
+}
+async function withCleanNodeExecArgv(action) {
+  const previousExecArgv = [...process.execArgv];
+  process.execArgv = previousExecArgv.filter(
+    (arg) => !arg.startsWith("--test") && !arg.startsWith("--input-type") && !arg.startsWith("--experimental-test") && !arg.startsWith("--watch")
+  );
+  try {
+    return await action();
+  } finally {
+    process.execArgv = previousExecArgv;
+  }
+}
+async function exportTreeseedCodebase({
+  directory = process.cwd()
+} = {}) {
+  const resolvedDirectory = resolve(directory);
+  ensureDirectory(resolvedDirectory);
+  const tenantRoot = findNearestTreeseedRoot(resolvedDirectory);
+  if (!tenantRoot) {
+    throw new Error(`Treeseed export requires a Treeseed project. No ancestor containing treeseed.site.yaml was found from ${resolvedDirectory}.`);
+  }
+  const deployConfig = loadTreeseedDeployConfigFromPath(resolveTreeseedDeployConfigPathFromRoot(tenantRoot));
+  const includedBundlePaths = resolveConfiguredBundlePaths(resolvedDirectory, tenantRoot, deployConfig);
+  const ignorePatterns = resolveIgnorePatterns(deployConfig);
+  const branch = resolveGitBranch(resolvedDirectory);
+  const timestamp = formatExportTimestamp();
+  const outputPath = resolveExportOutputPath(resolvedDirectory, branch, timestamp);
+  const options = {
+    output: outputPath,
+    style: "markdown",
+    ignore: ignorePatterns.join(","),
+    quiet: true,
+    skipLocalConfig: true,
+    copy: false,
+    stdout: false
+  };
+  setLogLevel(0);
+  const result = await withCleanNodeExecArgv(
+    () => runDefaultAction(toRepomixDirectories(resolvedDirectory, includedBundlePaths), resolvedDirectory, options)
+  );
+  const outputFiles = normalizePackResultOutputFiles(result.packResult, outputPath);
+  return {
+    directory: resolvedDirectory,
+    tenantRoot,
+    outputPath,
+    branch,
+    timestamp,
+    includedBundlePaths,
+    ignorePatterns,
+    summary: {
+      totalFiles: result.packResult.totalFiles,
+      totalCharacters: result.packResult.totalCharacters,
+      totalTokens: result.packResult.totalTokens,
+      outputFiles
+    }
+  };
+}
+export {
+  exportTreeseedCodebase
+};

package/dist/operations/services/railway-deploy.js

@@ -5,7 +5,7 @@ import { loadCliDeployConfig } from "./runtime-tools.js";
 function normalizeScope(scope) {
   return scope === "prod" ? "prod" : scope === "staging" ? "staging" : "local";
 }
-const RAILWAY_SERVICE_KEYS = ["api", "agents", "manager", "worker", "workdayStart", "workdayReport"];
+const RAILWAY_SERVICE_KEYS = ["api", "agents", "manager", "worker", "runner", "workdayStart", "workdayReport"];
 function runRailway(args, { cwd, capture = false, allowFailure = false } = {}) {
   const result = spawnSync("railway", args, {
     cwd,
@@ -26,7 +26,7 @@ function configuredRailwayServices(tenantRoot, scope) {
     if (!service || service.enabled === false || (service.provider ?? "railway") !== "railway") {
       return null;
     }
-    const defaultRootDir = ["api", "manager", "worker", "workdayStart", "workdayReport"].includes(serviceKey) ? "." : "packages/core";
+    const defaultRootDir = ["api", "manager", "worker", "runner", "workdayStart", "workdayReport"].includes(serviceKey) ? "." : "packages/core";
     const serviceRoot = resolve(tenantRoot, service.railway?.rootDir ?? service.rootDir ?? defaultRootDir);
     const railwayEnvironment = service.environments?.[normalizedScope]?.railwayEnvironment ?? normalizedScope;
     const publicBaseUrl = service.environments?.[normalizedScope]?.baseUrl ?? service.publicBaseUrl ?? null;

package/dist/operations/services/runtime-tools.d.ts

@@ -38,7 +38,6 @@ export declare function loadCliDeployConfig(tenantRoot: any): {
     cloudflare: {
         accountId: string;
         workerName: string | undefined;
-        gatewayWorkerName: string | undefined;
         queueName: string | undefined;
         dlqName: string | undefined;
         d1Binding: string | undefined;

package/dist/operations/services/runtime-tools.js

@@ -50,7 +50,7 @@ const TREESEED_DEFAULT_PROVIDER_SELECTIONS = {
   },
   site: "default"
 };
-const TRESEED_MANAGED_SERVICE_KEYS = ["api", "agents", "gateway", "manager", "worker", "workdayStart", "workdayReport"];
+const TRESEED_MANAGED_SERVICE_KEYS = ["api", "agents", "manager", "worker", "runner", "workdayStart", "workdayReport"];
 const TRESEED_WORKSPACE_PACKAGE_DIRS = ["sdk", "core", "cli"];
 const CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER = "replace-with-cloudflare-account-id";
 function parseServiceEnvironmentConfig(value) {
@@ -301,7 +301,6 @@ function parseFallbackDeployConfig(configPath) {
     cloudflare: {
       accountId: optionalCloudflareAccountId(cloudflare.accountId) ?? optionalCloudflareAccountId(process.env.CLOUDFLARE_ACCOUNT_ID) ?? CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER,
       workerName: optionalString(cloudflare.workerName),
-      gatewayWorkerName: optionalString(cloudflare.gatewayWorkerName),
       queueName: optionalString(cloudflare.queueName),
       dlqName: optionalString(cloudflare.dlqName),
       d1Binding: optionalString(cloudflare.d1Binding),

package/dist/operations-registry.js

@@ -17,6 +17,7 @@ const TRESEED_OPERATION_SPECS = [
   operation({ id: "template.sync", name: "sync", aliases: [], group: "Validation", summary: "Validate or reconcile the managed template surface for the current site.", description: "Use remote template metadata plus the local scaffold artifact to check or apply updates to the managed scaffold surface.", provider: "default", related: ["template", "init", "status"] }),
   operation({ id: "project.init", name: "init", aliases: [], group: "Workflow", summary: "Scaffold a new Treeseed tenant project.", description: "Create a new Treeseed tenant directory from a remote-catalog template backed by the packaged scaffold artifact.", provider: "default", related: ["config", "switch", "dev"] }),
   operation({ id: "project.config", name: "config", aliases: [], group: "Workflow", summary: "Configure and test the runtime foundation.", description: "Apply safe repairs, collect environment values, write local machine config, generate local env files, initialize environments, sync providers, and run doctor-style checks.", provider: "default", related: ["status", "switch", "dev"] }),
+  operation({ id: "project.export", name: "export", aliases: [], group: "Utilities", summary: "Export a Markdown snapshot of the current codebase.", description: "Generate a Markdown codebase snapshot for the selected directory using the SDK-owned repomix integration and store it under .treeseed/exports.", provider: "default", related: ["status", "config"] }),
   operation({ id: "deploy.release", name: "release", aliases: [], group: "Workflow", summary: "Promote staging to production with a version bump.", description: "Validate staging, apply one version bump, tag the release, merge staging into main, push, and rely on production deploy automation.", provider: "default", related: ["stage", "status", "rollback"] }),
   operation({ id: "deploy.destroy", name: "destroy", aliases: [], group: "Workflow", summary: "Destroy a persistent environment and its local state.", description: "Delete the selected persistent environment resources and remove the local deploy state after confirmation.", provider: "default", related: ["config", "status"] }),
   operation({ id: "local.dev", name: "dev", aliases: [], group: "Local Development", summary: "Start the unified local Treeseed development environment.", description: "Start the unified local Treeseed development environment.", provider: "default" }),

package/dist/operations-types.d.ts

@@ -1,5 +1,5 @@
 export type TreeseedOperationGroup = 'Workflow' | 'Local Development' | 'Validation' | 'Release Utilities' | 'Utilities' | 'Passthrough';
-export type TreeseedOperationId = 'workspace.status' | 'workspace.doctor' | 'branch.tasks' | 'branch.switch' | 'branch.save' | 'branch.close' | 'branch.stage' | 'deploy.release' | 'deploy.rollback' | 'deploy.destroy' | 'template.list' | 'template.show' | 'template.validate' | 'template.sync' | 'project.init' | 'project.config' | 'local.dev' | 'local.devWatch' | 'local.build' | 'local.check' | 'local.preview' | 'local.lint' | 'local.test' | 'validation.testUnit' | 'validation.preflight' | 'validation.authCheck' | 'auth.login' | 'auth.logout' | 'auth.whoami' | 'release.testE2e' | 'release.testE2eLocal' | 'release.testE2eStaging' | 'release.testE2eFull' | 'release.testFast' | 'release.verify' | 'release.publishChanged' | 'services.mailpitUp' | 'services.mailpitDown' | 'services.mailpitLogs' | 'data.d1MigrateLocal' | 'content.cleanupMarkdown' | 'content.cleanupMarkdownCheck' | 'tools.astro' | 'tools.syncDevvars' | 'tools.starlightPatch' | 'agents.run';
+export type TreeseedOperationId = 'workspace.status' | 'workspace.doctor' | 'branch.tasks' | 'branch.switch' | 'branch.save' | 'branch.close' | 'branch.stage' | 'deploy.release' | 'deploy.rollback' | 'deploy.destroy' | 'template.list' | 'template.show' | 'template.validate' | 'template.sync' | 'project.init' | 'project.config' | 'local.dev' | 'local.devWatch' | 'local.build' | 'local.check' | 'local.preview' | 'local.lint' | 'local.test' | 'validation.testUnit' | 'validation.preflight' | 'validation.authCheck' | 'auth.login' | 'auth.logout' | 'auth.whoami' | 'release.testE2e' | 'release.testE2eLocal' | 'release.testE2eStaging' | 'release.testE2eFull' | 'release.testFast' | 'release.verify' | 'release.publishChanged' | 'services.mailpitUp' | 'services.mailpitDown' | 'services.mailpitLogs' | 'data.d1MigrateLocal' | 'content.cleanupMarkdown' | 'content.cleanupMarkdownCheck' | 'project.export' | 'tools.astro' | 'tools.syncDevvars' | 'tools.starlightPatch' | 'agents.run';
 export type TreeseedOperationProviderId = 'default';
 export type TreeseedOperationMetadata = {
     id: TreeseedOperationId;

package/dist/platform/book-export.d.ts

@@ -0,0 +1,78 @@
+export type TreeseedBookExportFileEntry = {
+    fileId: string;
+    bookId: string;
+    memberBookId: string;
+    absolutePath: string;
+    projectRelativePath: string;
+    bookRelativePath: string;
+    rootRelativePath: string;
+    rootPath: string;
+    ordinal: number;
+    frontmatterOrder: number | null;
+    sourceType: 'md' | 'mdx' | 'text';
+    chunkId: string;
+    markerId: string;
+};
+export type TreeseedBookExportMemberSummary = {
+    bookId: string;
+    slug: string;
+    title: string;
+    order: number;
+    downloadFileName: string;
+    downloadHref: string;
+    sourceFileCount: number;
+    markdownPath?: string;
+    indexPath?: string;
+};
+export type TreeseedBookExportManifest = {
+    packageKind: 'book' | 'library';
+    packageVersion: number;
+    packageId: string;
+    generatedAt: string;
+    tenantRoot: string;
+    tenantId: string;
+    book: {
+        id: string;
+        slug: string;
+        title: string;
+        order: number;
+        basePath: string;
+        downloadFileName: string;
+        downloadHref: string;
+        downloadTitle: string;
+        resolvedRoots: string[];
+    };
+    files: TreeseedBookExportFileEntry[];
+    members?: TreeseedBookExportMemberSummary[];
+};
+export type TreeseedBookPackageResult = {
+    manifest: TreeseedBookExportManifest;
+    markdownPath: string;
+    indexPath: string;
+    sourceFileCount: number;
+    includedRoots: string[];
+};
+export type TreeseedBookLibraryPackageResult = {
+    manifest: TreeseedBookExportManifest;
+    markdownPath: string;
+    indexPath: string;
+    memberPackages: TreeseedBookPackageResult[];
+    sourceFileCount: number;
+    includedRoots: string[];
+};
+export declare function buildBookExportManifest(bookId: string, options?: {
+    projectRoot?: string;
+}): TreeseedBookExportManifest;
+export declare function exportBookPackage(bookId: string, options?: {
+    projectRoot?: string;
+}): Promise<TreeseedBookPackageResult>;
+export declare function exportBookLibrary(options?: {
+    projectRoot?: string;
+}): Promise<TreeseedBookLibraryPackageResult>;
+export declare function exportTenantBookPackages(options?: {
+    projectRoot?: string;
+}): Promise<{
+    projectRoot: string;
+    bookPackages: TreeseedBookPackageResult[];
+    libraryPackage: TreeseedBookLibraryPackageResult;
+}>;