@treeseed/sdk 0.4.12 → 0.5.0

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

@@ -37,12 +37,12 @@ const TREESEED_DEFAULT_PLUGIN_REFERENCES = [
 const TREESEED_DEFAULT_PROVIDER_SELECTIONS = {
   forms: "store_only",
   agents: {
-    execution: "stub",
+    execution: "copilot",
     mutation: "local_branch",
-    repository: "stub",
-    verification: "stub",
-    notification: "stub",
-    research: "stub"
+    repository: "git",
+    verification: "local",
+    notification: "sdk_message",
+    research: "project_graph"
   },
   deploy: "cloudflare",
   content: {
@@ -52,9 +52,57 @@ const TREESEED_DEFAULT_PROVIDER_SELECTIONS = {
   },
   site: "default"
 };
-const TRESEED_MANAGED_SERVICE_KEYS = ["api", "agents", "manager", "worker", "runner", "workdayStart", "workdayReport"];
+const TRESEED_MANAGED_SERVICE_KEYS = ["api", "manager", "worker", "workdayStart", "workdayReport"];
 const TRESEED_WORKSPACE_PACKAGE_DIRS = ["sdk", "core", "cli"];
 const CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER = "replace-with-cloudflare-account-id";
+function normalizePlanesFromLegacyHosting(hosting) {
+  if (!hosting || Object.keys(hosting).length === 0) {
+    return {
+      hub: { mode: "treeseed_hosted" },
+      runtime: { mode: "none", registration: "none" }
+    };
+  }
+  if (hosting.kind === "market_control_plane" || hosting.kind === "hosted_project") {
+    return {
+      hub: { mode: "treeseed_hosted" },
+      runtime: {
+        mode: "treeseed_managed",
+        registration: hosting.kind === "market_control_plane" ? "none" : hosting.registration ?? "none",
+        marketBaseUrl: hosting.marketBaseUrl,
+        teamId: hosting.teamId,
+        projectId: hosting.projectId
+      }
+    };
+  }
+  return {
+    hub: { mode: "customer_hosted" },
+    runtime: {
+      mode: "byo_attached",
+      registration: hosting.registration ?? "none",
+      marketBaseUrl: hosting.marketBaseUrl,
+      teamId: hosting.teamId,
+      projectId: hosting.projectId
+    }
+  };
+}
+function normalizeLegacyHostingFromPlanes(hub, runtime) {
+  if (runtime.mode === "treeseed_managed" && hub.mode === "treeseed_hosted") {
+    return {
+      kind: "hosted_project",
+      registration: runtime.registration === "required" ? "optional" : runtime.registration ?? "none",
+      marketBaseUrl: runtime.marketBaseUrl,
+      teamId: runtime.teamId,
+      projectId: runtime.projectId
+    };
+  }
+  return {
+    kind: "self_hosted_project",
+    registration: runtime.registration === "required" ? "optional" : runtime.registration ?? "none",
+    marketBaseUrl: runtime.marketBaseUrl,
+    teamId: runtime.teamId,
+    projectId: runtime.projectId
+  };
+}
 function parseServiceEnvironmentConfig(value) {
   const record = optionalRecord(value, "service environment") ?? {};
   return {
@@ -108,6 +156,81 @@ function parseManagedServicesConfig(value) {
     ])
   );
 }
+function parseWebSurfaceCacheConfig(value, label) {
+  const record = optionalRecord(value, label) ?? {};
+  if (Object.keys(record).length === 0) {
+    return void 0;
+  }
+  return {
+    sourcePages: parseWebCachePolicyRecord(record.sourcePages ?? record.source_pages, `${label}.sourcePages`, {
+      paths: ["/", "/contact", "/404"]
+    }),
+    contentPages: parseWebCachePolicyRecord(record.contentPages ?? record.content_pages, `${label}.contentPages`),
+    r2PublishedObjects: parseWebCachePolicyRecord(
+      record.r2PublishedObjects ?? record.r2_published_objects,
+      `${label}.r2PublishedObjects`
+    )
+  };
+}
+function parseWebCachePolicyRecord(value, label, options = {}) {
+  const record = optionalRecord(value, label) ?? {};
+  if (Object.keys(record).length === 0) {
+    return options.paths ? { paths: [...options.paths] } : void 0;
+  }
+  const parsed = {
+    browserTtlSeconds: optionalNonNegativeNumber(
+      record.browserTtlSeconds ?? record.browser_ttl_seconds,
+      `${label}.browserTtlSeconds`
+    ),
+    edgeTtlSeconds: optionalNonNegativeNumber(
+      record.edgeTtlSeconds ?? record.edge_ttl_seconds,
+      `${label}.edgeTtlSeconds`
+    ),
+    staleWhileRevalidateSeconds: optionalNonNegativeNumber(
+      record.staleWhileRevalidateSeconds ?? record.stale_while_revalidate_seconds,
+      `${label}.staleWhileRevalidateSeconds`
+    ),
+    staleIfErrorSeconds: optionalNonNegativeNumber(
+      record.staleIfErrorSeconds ?? record.stale_if_error_seconds,
+      `${label}.staleIfErrorSeconds`
+    )
+  };
+  if (options.paths) {
+    parsed.paths = [...new Set(Array.isArray(record.paths) ? record.paths.map((entry) => optionalString(entry)).filter(Boolean) : options.paths)];
+  }
+  return parsed;
+}
+function parseSurfaceConfig(value, label) {
+  const record = optionalRecord(value, label);
+  if (!record) {
+    return void 0;
+  }
+  return {
+    enabled: record.enabled === void 0 ? void 0 : optionalBoolean(record.enabled, `${label}.enabled`),
+    provider: optionalString(record.provider),
+    rootDir: optionalString(record.rootDir),
+    publicBaseUrl: optionalString(record.publicBaseUrl),
+    localBaseUrl: optionalString(record.localBaseUrl),
+    cache: parseWebSurfaceCacheConfig(record.cache, `${label}.cache`)
+  };
+}
+function parsePlatformSurfacesConfig(value) {
+  const record = optionalRecord(value, "surfaces");
+  if (!record) {
+    return void 0;
+  }
+  return Object.fromEntries(
+    Object.entries(record).map(([surfaceKey, surfaceValue]) => [
+      surfaceKey,
+      parseSurfaceConfig(surfaceValue, `surfaces.${surfaceKey}`)
+    ])
+  );
+}
+function inferManagedRuntimeFromServices(services) {
+  return Object.values(services ?? {}).some(
+    (service) => service && service.enabled !== false && (service.provider ?? "railway") === "railway"
+  );
+}
 const packageRoot = packageRootFromSource;
 const packageScriptRoot = resolve(packageRoot, "scripts");
 const packageDistScriptRoot = resolve(packageRoot, "dist", "scripts");
@@ -272,6 +395,15 @@ function optionalPositiveNumber(value, label) {
   }
   return value;
 }
+function optionalNonNegativeNumber(value, label) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    throw new Error(`Invalid deploy config: expected ${label} to be a non-negative number when provided.`);
+  }
+  return value;
+}
 function optionalEnum(value, label, allowed) {
   const normalized = optionalString(value);
   if (!normalized) {
@@ -314,6 +446,35 @@ function parseFallbackDeployConfig(configPath) {
   const cloudflarePages = optionalRecord(cloudflare.pages, "cloudflare.pages") ?? {};
   const cloudflareR2 = optionalRecord(cloudflare.r2, "cloudflare.r2") ?? {};
   const hosting = optionalRecord(record.hosting, "hosting") ?? {};
+  const parsedHosting = Object.keys(hosting).length === 0 ? void 0 : {
+    kind: optionalEnum(hosting.kind, "hosting.kind", [
+      "market_control_plane",
+      "hosted_project",
+      "self_hosted_project"
+    ]) ?? "self_hosted_project",
+    registration: optionalEnum(hosting.registration, "hosting.registration", ["optional", "none"]) ?? "none",
+    marketBaseUrl: optionalString(process.env.TREESEED_MARKET_API_BASE_URL),
+    teamId: optionalString(process.env.TREESEED_HOSTING_TEAM_ID),
+    projectId: optionalString(process.env.TREESEED_PROJECT_ID)
+  };
+  const services = parseManagedServicesConfig(record.services);
+  const normalizedPlanes = normalizePlanesFromLegacyHosting(parsedHosting);
+  const inferredPlanes = !parsedHosting && record.hub === void 0 && record.runtime === void 0 && inferManagedRuntimeFromServices(services) ? {
+    hub: { mode: "customer_hosted" },
+    runtime: { mode: "treeseed_managed", registration: "none" }
+  } : normalizedPlanes;
+  const hubRecord = optionalRecord(record.hub, "hub") ?? {};
+  const runtimeRecord = optionalRecord(record.runtime, "runtime") ?? {};
+  const hub = {
+    mode: optionalEnum(hubRecord.mode, "hub.mode", ["treeseed_hosted", "customer_hosted"]) ?? inferredPlanes.hub.mode
+  };
+  const runtime = {
+    mode: optionalEnum(runtimeRecord.mode, "runtime.mode", ["none", "byo_attached", "treeseed_managed"]) ?? inferredPlanes.runtime.mode,
+    registration: optionalEnum(runtimeRecord.registration, "runtime.registration", ["optional", "required", "none"]) ?? inferredPlanes.runtime.registration ?? "none",
+    marketBaseUrl: optionalString(process.env.TREESEED_MARKET_API_BASE_URL) ?? inferredPlanes.runtime.marketBaseUrl,
+    teamId: optionalString(process.env.TREESEED_HOSTING_TEAM_ID) ?? inferredPlanes.runtime.teamId,
+    projectId: optionalString(process.env.TREESEED_PROJECT_ID) ?? inferredPlanes.runtime.projectId
+  };
   const smtp = optionalRecord(record.smtp, "smtp") ?? {};
   const turnstile = optionalRecord(record.turnstile, "turnstile") ?? {};
   const agentProviders = optionalRecord(optionalRecord(record.providers, "providers")?.agents, "providers.agents") ?? {};
@@ -323,35 +484,28 @@ function parseFallbackDeployConfig(configPath) {
     slug: expectString(record.slug, "slug"),
     siteUrl: expectString(record.siteUrl, "siteUrl"),
     contactEmail: expectString(record.contactEmail, "contactEmail"),
-    hosting: Object.keys(hosting).length === 0 ? void 0 : {
-      kind: optionalEnum(hosting.kind, "hosting.kind", [
-        "market_control_plane",
-        "hosted_project",
-        "self_hosted_project"
-      ]) ?? "self_hosted_project",
-      registration: optionalEnum(hosting.registration, "hosting.registration", ["optional", "none"]) ?? "none",
-      marketBaseUrl: optionalString(hosting.marketBaseUrl),
-      teamId: optionalString(hosting.teamId),
-      projectId: optionalString(hosting.projectId)
-    },
+    hosting: parsedHosting && record.hub === void 0 && record.runtime === void 0 ? parsedHosting : normalizeLegacyHostingFromPlanes(hub, runtime),
+    hub,
+    runtime,
     cloudflare: {
-      accountId: optionalCloudflareAccountId(cloudflare.accountId) ?? optionalCloudflareAccountId(process.env.CLOUDFLARE_ACCOUNT_ID) ?? CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER,
+      accountId: optionalCloudflareAccountId(process.env.CLOUDFLARE_ACCOUNT_ID) ?? CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER,
+      zoneId: optionalString(cloudflare.zoneId ?? cloudflare.zone_id),
       workerName: optionalString(cloudflare.workerName),
       queueName: optionalString(cloudflare.queueName),
       dlqName: optionalString(cloudflare.dlqName),
       d1Binding: optionalString(cloudflare.d1Binding),
       queueBinding: optionalString(cloudflare.queueBinding),
       pages: cloudflare.pages === void 0 ? void 0 : {
-        projectName: optionalString(cloudflarePages.projectName) ?? optionalString(process.env.TREESEED_CLOUDFLARE_PAGES_PROJECT_NAME),
-        previewProjectName: optionalString(cloudflarePages.previewProjectName) ?? optionalString(process.env.TREESEED_CLOUDFLARE_PAGES_PREVIEW_PROJECT_NAME),
+        projectName: optionalString(process.env.TREESEED_CLOUDFLARE_PAGES_PROJECT_NAME) ?? optionalString(cloudflarePages.projectName),
+        previewProjectName: optionalString(process.env.TREESEED_CLOUDFLARE_PAGES_PREVIEW_PROJECT_NAME) ?? optionalString(cloudflarePages.previewProjectName),
         productionBranch: optionalString(cloudflarePages.productionBranch) ?? "main",
         stagingBranch: optionalString(cloudflarePages.stagingBranch) ?? "staging",
         buildOutputDir: optionalString(cloudflarePages.buildOutputDir)
       },
       r2: cloudflare.r2 === void 0 ? void 0 : {
-        binding: optionalString(cloudflareR2.binding) ?? optionalString(process.env.TREESEED_CONTENT_BUCKET_BINDING),
-        bucketName: optionalString(cloudflareR2.bucketName) ?? optionalString(process.env.TREESEED_CONTENT_BUCKET_NAME),
-        publicBaseUrl: optionalString(cloudflareR2.publicBaseUrl) ?? optionalString(process.env.TREESEED_CONTENT_PUBLIC_BASE_URL),
+        binding: optionalString(process.env.TREESEED_CONTENT_BUCKET_BINDING),
+        bucketName: optionalString(process.env.TREESEED_CONTENT_BUCKET_NAME),
+        publicBaseUrl: optionalString(process.env.TREESEED_CONTENT_PUBLIC_BASE_URL),
         manifestKeyTemplate: optionalString(cloudflareR2.manifestKeyTemplate ?? cloudflareR2.manifestKey) ?? "teams/{teamId}/published/common.json",
         previewRootTemplate: optionalString(cloudflareR2.previewRootTemplate ?? cloudflareR2.previewRoot) ?? "teams/{teamId}/previews",
         previewTtlHours: optionalPositiveNumber(cloudflareR2.previewTtlHours, "cloudflare.r2.previewTtlHours") ?? 168
@@ -381,16 +535,22 @@ function parseFallbackDeployConfig(configPath) {
         docs: expectString(
           contentProviders.docs ?? contentProviders.runtime ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.content.docs ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.content.runtime,
           "providers.content.docs"
-        )
+        ),
+        serving: optionalEnum(
+          contentProviders.serving,
+          "providers.content.serving",
+          ["local_collections", "published_runtime"]
+        ) ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.content.serving
       },
       site: expectString(record.providers?.site ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.site, "providers.site")
     },
-    services: parseManagedServicesConfig(record.services),
+    surfaces: parsePlatformSurfacesConfig(record.surfaces),
+    services,
     smtp: {
       enabled: optionalBoolean(smtp.enabled, "smtp.enabled")
     },
     turnstile: {
-      enabled: optionalBoolean(turnstile.enabled, "turnstile.enabled") ?? true
+      enabled: optionalBoolean(turnstile.enabled, "turnstile.enabled") ?? false
     }
   };
   Object.defineProperty(deployConfig, "__tenantRoot", {

package/dist/operations/services/watch-dev.js

@@ -40,7 +40,7 @@ function shouldIgnoreWatchPath(filePath, rootPath) {
     return false;
   }
   const normalized = rel.split(sep).join("/");
-  return normalized === ".git" || normalized.startsWith(".git/") || normalized === "node_modules" || normalized.startsWith("node_modules/") || normalized === ".astro" || normalized.startsWith(".astro/") || normalized === ".wrangler" || normalized.startsWith(".wrangler/") || normalized === ".local" || normalized.startsWith(".local/") || normalized === ".treeseed" || normalized.startsWith(".treeseed/") || normalized === "dist" || normalized.startsWith("dist/") || normalized === "coverage" || normalized.startsWith("coverage/") || normalized === ".dev.vars" || normalized === "books" || normalized.startsWith("books/") || normalized === "__treeseed" || normalized.startsWith("__treeseed/") || normalized.startsWith("public/books/") || normalized.startsWith("public/__treeseed/");
+  return normalized === ".git" || normalized.startsWith(".git/") || normalized === "node_modules" || normalized.startsWith("node_modules/") || normalized === ".astro" || normalized.startsWith(".astro/") || normalized === ".wrangler" || normalized.startsWith(".wrangler/") || normalized === ".local" || normalized.startsWith(".local/") || normalized === ".treeseed" || normalized.startsWith(".treeseed/") || normalized === "dist" || normalized.startsWith("dist/") || normalized === "coverage" || normalized.startsWith("coverage/") || normalized === "books" || normalized.startsWith("books/") || normalized === "__treeseed" || normalized.startsWith("__treeseed/") || normalized.startsWith("public/books/") || normalized.startsWith("public/__treeseed/");
 }
 function collectRootSnapshot(rootPath, snapshot) {
   if (!existsSync(rootPath)) {
@@ -135,9 +135,7 @@ function createTenantWatchEntries(tenantRoot) {
     { kind: "tenant", root: resolve(tenantRoot, "src") },
     { kind: "tenant", root: resolve(tenantRoot, "public") },
     { kind: "tenant", root: resolve(tenantRoot, "astro.config.ts") },
-    { kind: "tenant", root: resolve(tenantRoot, "treeseed.site.yaml") },
-    { kind: "tenant", root: resolve(tenantRoot, ".env.local") },
-    { kind: "tenant", root: resolve(tenantRoot, ".env.local.example") }
+    { kind: "tenant", root: resolve(tenantRoot, "treeseed.site.yaml") }
   ];
   if (isEditablePackageWorkspace()) {
     const sdkRoot = workspaceSdkRoot();

package/dist/operations/services/workspace-preflight.d.ts

@@ -2,19 +2,19 @@ export declare function createWranglerCommandEnv(overrides?: {}): {
     XDG_CONFIG_HOME: string;
     WRANGLER_SEND_METRICS: string;
 };
-export declare function parseGitHubAuthStatus(): {
+export declare function parseGitHubAuthStatus(values?: NodeJS.ProcessEnv): {
     authenticated: boolean;
     detail: string;
 };
-export declare function parseWranglerWhoAmI(): {
+export declare function parseWranglerWhoAmI(values?: NodeJS.ProcessEnv): {
     authenticated: boolean;
     detail: string;
 };
-export declare function parseRailwayWhoAmI(): {
+export declare function parseRailwayWhoAmI(values?: NodeJS.ProcessEnv): {
     authenticated: boolean;
     detail: string;
 };
-export declare function parseCopilotSessionStatus(): {
+export declare function parseCopilotSessionStatus(values?: NodeJS.ProcessEnv): {
     configured: boolean;
     detail: string;
 };

package/dist/operations/services/workspace-preflight.js

@@ -1,6 +1,7 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import { dirname, resolve } from "node:path";
+import { collectTreeseedConfigSeedValues } from "./config-runtime.js";
 import { createTempDir } from "./workspace-tools.js";
 function runCapture(command, args, options = {}) {
   const result = spawnSync(command, args, {
@@ -32,43 +33,44 @@ function createWranglerCommandEnv(overrides = {}) {
     ...overrides
   };
 }
-function envTokenStatus(keys, label) {
+function envTokenStatus(keys, label, values = process.env) {
   const foundKey = keys.find((key) => {
-    const value = process.env[key];
+    const value = values[key];
     return typeof value === "string" && value.trim().length > 0;
   }) ?? null;
   return {
     ready: Boolean(foundKey),
-    detail: foundKey ? `${label} token detected from ${foundKey}.` : `${label} token is not configured. Set ${keys.join(" or ")}.`,
-    source: foundKey ? "env" : "missing"
+    detail: foundKey ? `${label} token detected from configured Treeseed environment (${foundKey}).` : `${label} token is not configured. Set ${keys.join(" or ")}.`,
+    source: foundKey ? "config" : "missing"
   };
 }
-function parseGitHubAuthStatus() {
+function parseGitHubAuthStatus(values = process.env) {
   return {
-    authenticated: envTokenStatus(["GH_TOKEN"], "GitHub").ready,
-    detail: envTokenStatus(["GH_TOKEN"], "GitHub").detail
+    authenticated: envTokenStatus(["GH_TOKEN"], "GitHub", values).ready,
+    detail: envTokenStatus(["GH_TOKEN"], "GitHub", values).detail
   };
 }
-function parseWranglerWhoAmI() {
+function parseWranglerWhoAmI(values = process.env) {
   return {
-    authenticated: envTokenStatus(["CLOUDFLARE_API_TOKEN"], "Cloudflare").ready,
-    detail: envTokenStatus(["CLOUDFLARE_API_TOKEN"], "Cloudflare").detail
+    authenticated: envTokenStatus(["CLOUDFLARE_API_TOKEN"], "Cloudflare", values).ready,
+    detail: envTokenStatus(["CLOUDFLARE_API_TOKEN"], "Cloudflare", values).detail
   };
 }
-function parseRailwayWhoAmI() {
+function parseRailwayWhoAmI(values = process.env) {
   return {
-    authenticated: envTokenStatus(["RAILWAY_API_TOKEN"], "Railway").ready,
-    detail: envTokenStatus(["RAILWAY_API_TOKEN"], "Railway").detail
+    authenticated: envTokenStatus(["RAILWAY_API_TOKEN", "RAILWAY_TOKEN"], "Railway", values).ready,
+    detail: envTokenStatus(["RAILWAY_API_TOKEN", "RAILWAY_TOKEN"], "Railway", values).detail
   };
 }
-function parseCopilotSessionStatus() {
-  const status = envTokenStatus(["GH_TOKEN"], "GitHub");
+function parseCopilotSessionStatus(values = process.env) {
+  const status = envTokenStatus(["GH_TOKEN"], "GitHub", values);
   return {
     configured: status.ready,
-    detail: status.ready ? "GitHub token detected from GH_TOKEN for Copilot-backed workflows." : "GitHub token is not configured. Set GH_TOKEN for Copilot-backed workflows."
+    detail: status.ready ? "GitHub token detected from configured Treeseed environment for Copilot-backed workflows." : "GitHub token is not configured. Set GH_TOKEN for Copilot-backed workflows."
   };
 }
 function collectCliPreflight({ cwd = process.cwd(), requireAuth = false } = {}) {
+  const configuredValues = collectTreeseedConfigSeedValues(cwd, "local");
   const binaries = {
     git: locateBinary("git"),
     npm: locateBinary("npm"),
@@ -87,22 +89,22 @@ function collectCliPreflight({ cwd = process.cwd(), requireAuth = false } = {})
     auth: {}
   };
   if (binaries.gh) {
-    checks.auth.gh = parseGitHubAuthStatus();
+    checks.auth.gh = parseGitHubAuthStatus(configuredValues);
   } else {
     checks.auth.gh = { authenticated: false, detail: "GitHub CLI is not installed." };
   }
   if (binaries.wrangler) {
-    checks.auth.wrangler = parseWranglerWhoAmI();
+    checks.auth.wrangler = parseWranglerWhoAmI(configuredValues);
   } else {
     checks.auth.wrangler = { authenticated: false, detail: "Wrangler CLI is not installed." };
   }
   if (binaries.railway) {
-    checks.auth.railway = parseRailwayWhoAmI();
+    checks.auth.railway = parseRailwayWhoAmI(configuredValues);
   } else {
     checks.auth.railway = { authenticated: false, detail: "Railway CLI is not installed." };
   }
   if (binaries.copilot) {
-    checks.auth.copilot = parseCopilotSessionStatus();
+    checks.auth.copilot = parseCopilotSessionStatus(configuredValues);
   } else {
     checks.auth.copilot = { configured: false, detail: "Copilot CLI is not installed." };
   }

package/dist/operations/services/workspace-save.d.ts

@@ -8,12 +8,21 @@ export declare function planWorkspaceVersionChanges(root?: any): {
     touched: Set<unknown>;
 };
 export declare function applyWorkspaceVersionChanges(plan: any): any;
-export declare function planWorkspaceReleaseBump(level?: string, root?: any): {
+export declare function planWorkspaceReleaseBump(level?: string, root?: any, options?: {}): {
     packages: any[];
     touched: Set<unknown>;
     versions: Map<any, any>;
     level: string;
+    selected: Set<any>;
 };
+export declare function collectWorkspaceVersionConsistencyIssues(root?: any): {
+    packageName: any;
+    dependencyName: string;
+    field: string;
+    currentSpec: unknown;
+    expectedSpec: string;
+}[];
+export declare function assertWorkspaceVersionConsistency(root?: any): void;
 export declare function repoRoot(cwd?: any): string;
 export declare function currentBranch(repoDir: any): string;
 export declare function originRemoteUrl(repoDir: any): string;

package/dist/operations/services/workspace-save.js

@@ -113,17 +113,20 @@ function applyWorkspaceVersionChanges(plan) {
   }
   return plan;
 }
-function planWorkspaceReleaseBump(level = "patch", root = workspaceRoot()) {
+function planWorkspaceReleaseBump(level = "patch", root = workspaceRoot(), options = {}) {
   const packages = workspacePackages(root).map((pkg) => ({
     ...pkg,
     packageJsonPath: resolve(pkg.dir, "package.json"),
     packageJson: readPackageJson(resolve(pkg.dir, "package.json"))
   }));
   const publishable = new Set(publishableWorkspacePackages(root).map((pkg) => pkg.name));
+  const selected = options.selectedPackageNames ? new Set(
+    [...options.selectedPackageNames].map((name) => String(name)).filter((name) => publishable.has(name))
+  ) : new Set(publishable);
   const touched = /* @__PURE__ */ new Set();
   const versions = /* @__PURE__ */ new Map();
   for (const pkg of packages) {
-    if (!publishable.has(pkg.name)) {
+    if (!publishable.has(pkg.name) || !selected.has(pkg.name)) {
       continue;
     }
     const nextVersion = incrementVersion(pkg.packageJson.version, level);
@@ -132,6 +135,9 @@ function planWorkspaceReleaseBump(level = "patch", root = workspaceRoot()) {
     touched.add(pkg.name);
   }
   for (const pkg of packages) {
+    if (!selected.has(pkg.name)) {
+      continue;
+    }
     for (const field of internalDependencyFields(pkg.packageJson)) {
       for (const depName of Object.keys(pkg.packageJson[field] ?? {})) {
         if (!versions.has(depName)) {
@@ -146,9 +152,52 @@ function planWorkspaceReleaseBump(level = "patch", root = workspaceRoot()) {
     packages,
     touched,
     versions,
-    level
+    level,
+    selected
   };
 }
+function collectWorkspaceVersionConsistencyIssues(root = workspaceRoot()) {
+  const packages = workspacePackages(root).map((pkg) => ({
+    ...pkg,
+    packageJson: readPackageJson(resolve(pkg.dir, "package.json"))
+  }));
+  const versions = new Map(packages.map((pkg) => [pkg.name, pkg.packageJson.version]));
+  const issues = [];
+  for (const pkg of packages) {
+    for (const field of internalDependencyFields(pkg.packageJson)) {
+      for (const [depName, currentSpec] of Object.entries(pkg.packageJson[field] ?? {})) {
+        if (!versions.has(depName)) {
+          continue;
+        }
+        const expectedSpec = `^${versions.get(depName)}`;
+        if (currentSpec !== expectedSpec) {
+          issues.push({
+            packageName: pkg.name,
+            dependencyName: depName,
+            field,
+            currentSpec,
+            expectedSpec
+          });
+        }
+      }
+    }
+  }
+  return issues;
+}
+function assertWorkspaceVersionConsistency(root = workspaceRoot()) {
+  const issues = collectWorkspaceVersionConsistencyIssues(root);
+  if (issues.length === 0) {
+    return;
+  }
+  const rendered = issues.map((issue) => `${issue.packageName} ${issue.field}.${issue.dependencyName}=${issue.currentSpec} expected ${issue.expectedSpec}`).join("\n");
+  throw new Error(
+    [
+      "Treeseed save found inconsistent checked-out package dependency versions.",
+      "Resolve the package manifest drift before saving.",
+      rendered
+    ].join("\n")
+  );
+}
 function repoRoot(cwd = workspaceRoot()) {
   return run("git", ["rev-parse", "--show-toplevel"], { cwd, capture: true }).trim();
 }
@@ -220,7 +269,9 @@ function formatMergeConflictReport(report, repoDir, targetBranch = "main") {
 export {
   MERGE_CONFLICT_EXIT_CODE,
   applyWorkspaceVersionChanges,
+  assertWorkspaceVersionConsistency,
   collectMergeConflictReport,
+  collectWorkspaceVersionConsistencyIssues,
   countConflictMarkers,
   currentBranch,
   formatMergeConflictReport,

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

@@ -1,3 +1,4 @@
+export declare const TREESEED_WORKSPACE_PACKAGE_DIRS: string[];
 export declare function workspaceRoot(startCwd?: string): any;
 export declare function findNearestTreeseedRoot(startCwd?: string): string | null;
 export declare function isWorkspaceRoot(root?: string): any;

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

@@ -1,7 +1,21 @@
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import { join, relative, resolve } from "node:path";
-const TREESEED_WORKSPACE_PACKAGE_DIRS = ["sdk", "core", "cli", "agent", "api"];
+const TREESEED_WORKSPACE_PACKAGE_DIRS = ["sdk", "core", "cli"];
+function packageSortWeight(pkg) {
+  const relativeDir = String(pkg.relativeDir ?? "");
+  const dirName = relativeDir.split("/").pop() ?? "";
+  const index = TREESEED_WORKSPACE_PACKAGE_DIRS.indexOf(dirName);
+  return index >= 0 ? index : Number.MAX_SAFE_INTEGER;
+}
+function compareWorkspacePackages(left, right) {
+  const leftWeight = packageSortWeight(left);
+  const rightWeight = packageSortWeight(right);
+  if (leftWeight !== rightWeight) {
+    return leftWeight - rightWeight;
+  }
+  return left.name.localeCompare(right.name);
+}
 function escapeRegex(source) {
   return source.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
 }
@@ -103,7 +117,7 @@ function workspacePackages(root = workspaceRoot()) {
       });
     }
   }
-  return [...discovered.values()].sort((left, right) => left.name.localeCompare(right.name));
+  return [...discovered.values()].sort(compareWorkspacePackages);
 }
 function internalDependenciesFor(pkg, packageNames) {
   const internalDeps = /* @__PURE__ */ new Set();
@@ -127,7 +141,7 @@ function sortWorkspacePackages(packages) {
       indegree.set(pkg.name, (indegree.get(pkg.name) ?? 0) + 1);
     }
   }
-  const ready = [...packages].filter((pkg) => (indegree.get(pkg.name) ?? 0) === 0).sort((left, right) => left.name.localeCompare(right.name));
+  const ready = [...packages].filter((pkg) => (indegree.get(pkg.name) ?? 0) === 0).sort(compareWorkspacePackages);
   const ordered = [];
   while (ready.length > 0) {
     const next = ready.shift();
@@ -142,13 +156,13 @@ function sortWorkspacePackages(packages) {
         const dependent = packageMap.get(dependentName);
         if (dependent) {
           ready.push(dependent);
-          ready.sort((left, right) => left.name.localeCompare(right.name));
+          ready.sort(compareWorkspacePackages);
         }
       }
     }
   }
   if (ordered.length !== packages.length) {
-    return [...packages].sort((left, right) => left.name.localeCompare(right.name));
+    return [...packages].sort(compareWorkspacePackages);
   }
   return ordered;
 }
@@ -251,6 +265,7 @@ function cleanupDir(dirPath) {
   }
 }
 export {
+  TREESEED_WORKSPACE_PACKAGE_DIRS,
   changedWorkspacePackages,
   cleanupDir,
   createTempDir,