@treeseed/cli 0.10.18 → 0.10.21

package/README.md

@@ -45,6 +45,7 @@ The main workflow commands exposed by the current CLI are:
 - `treeseed tasks [--json]`
 - `treeseed switch <branch-name> [--preview]`
 - `treeseed dev`
+- `treeseed dev start|status|logs|stop|restart`
 - `treeseed save [--preview] [--plan] "<commit message>"`
 - `treeseed stage "<resolution message>"`
 - `treeseed close "<close reason>"`
@@ -65,6 +66,7 @@ treeseed config
 treeseed switch feature/search-improvements --plan
 treeseed switch feature/search-improvements --preview
 treeseed dev
+treeseed dev start --web-runtime local
 treeseed save --preview "feat: add search filters"
 treeseed stage "feat: add search filters"
 treeseed release --patch
@@ -72,6 +74,27 @@ treeseed recover
 treeseed status --json
 ```
 
+## Development Server Instances
+
+`treeseed dev` remains the foreground local runtime supervisor. It delegates to `@treeseed/core`, starts the Market web/API/control-plane development surface, streams output in the active terminal, and exits when the shell-owned process is stopped.
+
+Managed dev instances use subcommands:
+
+```bash
+treeseed dev start --web-runtime local --json
+treeseed dev status --json
+treeseed dev status --all --json
+treeseed dev logs --follow
+treeseed dev stop --json
+treeseed dev restart --web-runtime local --json
+```
+
+Managed instances are scoped to the current physical worktree. The core runtime writes `.treeseed/dev/instances/<scope>.json`, `.treeseed/dev/pids/<scope>.pid`, and `.treeseed/logs/dev-<scope>.jsonl` in that worktree. A repository-family index under the git common dir makes sibling worktree instances discoverable to humans and AI agents.
+
+`--force` replaces only the current worktree instance. `--force-conflicts` is the explicit cross-worktree port-owner escape hatch. Additional worktrees receive stable alternate port blocks and worktree-specific local PostgreSQL/Mailpit names, so many agents can run development sessions in the same repository family.
+
+For the complete architecture, see the root workspace document `docs/local-dev-instances.md`.
+
 ## Agent-Safe Workflow
 
 Use planning mode before any destructive or multi-repo mutation:

package/dist/cli/handlers/config-ui.d.ts

@@ -21,6 +21,9 @@ type ConfigEntry = {
     purposes: string[];
     storage: 'shared' | 'scoped';
     validation?: ConfigValidation;
+    sourceRequirement?: string;
+    sourceHostType?: string | null;
+    sourceProvider?: string | null;
     scope: Exclude<ConfigScope, 'all'>;
     sharedScopes: Array<Exclude<ConfigScope, 'all'>>;
     required: boolean;

package/dist/cli/handlers/config-ui.js

@@ -336,6 +336,9 @@ function buildStartupDetailLines(step, draftValue) {
     `Applies to: ${step.scopes.join(", ")}`,
     `Required in: ${step.requiredScopes.join(", ")}`,
     `Storage: ${step.entry.storage}`,
+    ...step.entry.sourceRequirement ? [
+      `Host source: ${step.entry.sourceRequirement}${step.entry.sourceProvider ? ` (${step.entry.sourceProvider})` : ""}${step.entry.sourceHostType ? ` / ${step.entry.sourceHostType}` : ""}`
+    ] : [],
     "",
     `Current value: ${formatDisplayValue(step, step.currentValue, "(unset)")}`,
     `Suggested value: ${formatDisplayValue(step, step.suggestedValue, "(none)")}`,
@@ -356,6 +359,9 @@ function buildFullDetailLines(page, draftValue) {
     `Scope: ${page.scopes.join(", ")}`,
     `Storage: ${page.entry.storage} | ${page.required ? "required" : "optional"}`,
     `Group: ${page.entry.group}`,
+    ...page.entry.sourceRequirement ? [
+      `Host source: ${page.entry.sourceRequirement}${page.entry.sourceProvider ? ` (${page.entry.sourceProvider})` : ""}${page.entry.sourceHostType ? ` / ${page.entry.sourceHostType}` : ""}`
+    ] : [],
     "",
     `Current: ${formatDisplayValue(page, page.currentValue, "(unset)")}`,
     `Suggested: ${formatDisplayValue(page, page.suggestedValue, "(none)")}`,

package/dist/cli/handlers/config.js

@@ -32,7 +32,8 @@ function formatPrintEnvReports(payload) {
     lines.push(`Resolved environment values for ${report.scope}`);
     lines.push(payload.secretsRevealed ? "Secrets are shown." : "Secret values are masked.");
     for (const entry of report.environment?.entries ?? []) {
-      lines.push(`${entry.id}=${entry.displayValue} (${entry.source})`);
+      const hostSource = entry.sourceRequirement ? ` requirement=${entry.sourceRequirement}${entry.sourceProvider ? ` provider=${entry.sourceProvider}` : ""}${entry.sourceHostType ? ` hostType=${entry.sourceHostType}` : ""}` : "";
+      lines.push(`${entry.id}=${entry.displayValue} (${entry.source}${hostSource})`);
     }
     lines.push("");
     lines.push(`Provider connection checks for ${report.scope}`);

package/dist/cli/handlers/dev.js

@@ -52,6 +52,11 @@ const handleDev = async (invocation, context) => {
     }
     const feedback = typeof invocation.args.feedback === "string" ? invocation.args.feedback : void 0;
     const watch = feedback !== "off";
+    const subcommand = typeof invocation.positionals[0] === "string" ? invocation.positionals[0] : "";
+    const managedSubcommands = /* @__PURE__ */ new Set(["start", "status", "logs", "stop", "restart"]);
+    if (subcommand && !managedSubcommands.has(subcommand)) {
+      return fail(`Unknown dev subcommand "${subcommand}". Use start, status, logs, stop, or restart.`);
+    }
     const passthroughArgs = ["--surfaces", "web,api"];
     const forwardStringOption = (name, flag) => {
       const value = invocation.args[name];
@@ -75,6 +80,9 @@ const handleDev = async (invocation, context) => {
     forwardBooleanOption("plan", "--plan");
     forwardBooleanOption("reset", "--reset");
     forwardBooleanOption("force", "--force");
+    forwardBooleanOption("forceConflicts", "--force-conflicts");
+    forwardBooleanOption("all", "--all");
+    forwardBooleanOption("follow", "--follow");
     forwardBooleanOption("json", "--json");
     const workspaceRoot = findNearestTreeseedWorkspaceRoot(context.cwd);
     const workspaceLinksMode = typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0;
@@ -83,7 +91,12 @@ const handleDev = async (invocation, context) => {
       context.write(`[workspace][link] Linked ${workspaceLinks.created.length} local workspace package paths.`, "stdout");
     }
     const resolved = resolveCoreDevEntrypoint(context.cwd);
-    const args = watch ? [...resolved.args, ...passthroughArgs, "--watch"] : [...resolved.args, ...passthroughArgs];
+    const args = [
+      ...resolved.args,
+      ...subcommand ? [subcommand] : [],
+      ...passthroughArgs,
+      ...watch && !subcommand ? ["--watch"] : []
+    ];
     const result = context.spawn(resolved.command, args, {
       cwd: context.cwd,
       env: resolveTreeseedLaunchEnvironment({

package/dist/cli/handlers/init.js

@@ -1,6 +1,10 @@
+import { TREESEED_DEFAULT_STARTER_TEMPLATE_ID } from "@treeseed/sdk";
 import { TreeseedOperationsSdk } from "@treeseed/sdk/operations";
 import { guidedResult } from "./utils.js";
 const operations = new TreeseedOperationsSdk();
+function normalizeRepeatable(value) {
+  return Array.isArray(value) ? value.map(String) : typeof value === "string" ? [value] : [];
+}
 const handleInit = async (invocation, context) => {
   const directory = invocation.positionals[0];
   const result = await operations.execute({
@@ -13,7 +17,8 @@ const handleInit = async (invocation, context) => {
       siteUrl: invocation.args.siteUrl,
       contactEmail: invocation.args.contactEmail,
       repo: invocation.args.repo,
-      discord: invocation.args.discord
+      discord: invocation.args.discord,
+      hostBindingSpecs: normalizeRepeatable(invocation.args.host)
     }
   }, {
     cwd: context.cwd,
@@ -31,13 +36,35 @@ const handleInit = async (invocation, context) => {
       report: result.payload
     };
   }
+  const payload = result.payload;
+  const hostSummaries = Array.isArray(payload?.hostBindingSummaries) ? payload.hostBindingSummaries : [];
+  const configWrites = Array.isArray(payload?.hostBindingConfig?.configWrites) ? payload.hostBindingConfig.configWrites : [];
+  const environmentWrites = Array.isArray(payload?.hostBindingConfig?.environmentWrites) ? payload.hostBindingConfig.environmentWrites : [];
   return guidedResult({
     command: "init",
     summary: "Treeseed init completed successfully.",
-    facts: [{ label: "Directory", value: directory ?? "(current directory)" }],
+    facts: [
+      { label: "Directory", value: directory ?? "(current directory)" },
+      { label: "Template", value: String(payload?.template ?? TREESEED_DEFAULT_STARTER_TEMPLATE_ID) },
+      { label: "Host bindings", value: hostSummaries.length > 0 ? hostSummaries.length : "(none)" }
+    ],
+    sections: [
+      ...hostSummaries.length > 0 ? [{
+        title: "Host Bindings",
+        lines: hostSummaries.map((summary) => `${summary.requirementKey}: ${summary.mode}${summary.provider ? ` ${summary.provider}` : ""}${summary.alias ? ` (${summary.alias})` : ""}`)
+      }] : [],
+      ...configWrites.length > 0 ? [{
+        title: "Config Writes",
+        lines: configWrites.map((write) => `${write.target} ${write.path} <- ${write.provider ?? "template"}`)
+      }] : [],
+      ...environmentWrites.length > 0 ? [{
+        title: "Environment Entries",
+        lines: environmentWrites.map((entry) => `${entry.env}: ${entry.sensitivity} from ${entry.requirementKey}${entry.sourceProvider ? ` (${entry.sourceProvider})` : ""}`)
+      }] : []
+    ],
     nextSteps: [
       `cd ${directory}`,
-      "treeseed template show starter-basic",
+      `treeseed template show ${String(payload?.template ?? TREESEED_DEFAULT_STARTER_TEMPLATE_ID)}`,
       "treeseed sync --check",
       "treeseed doctor",
       "treeseed config --environment local",
@@ -45,7 +72,11 @@ const handleInit = async (invocation, context) => {
     ],
     report: {
       directory: directory ?? null,
-      template: result.payload?.template ?? null
+      template: payload?.template ?? null,
+      hostBindings: payload?.hostBindings ?? {},
+      hostBindingPlans: payload?.hostBindingPlans ?? null,
+      hostBindingSummaries: hostSummaries,
+      hostBindingConfig: payload?.hostBindingConfig ?? null
     }
   });
 };

package/dist/cli/handlers/projects.js

@@ -1,4 +1,5 @@
 import { MarketApiError } from "@treeseed/sdk/market-client";
+import { parseProjectLaunchHostBindingSpecs } from "@treeseed/sdk";
 import { fail, guidedResult } from "./utils.js";
 import { createMarketClientForInvocation } from "./market-utils.js";
 const DEPLOYMENT_TERMINAL_STATUSES = /* @__PURE__ */ new Set(["succeeded", "failed", "cancelled", "timed_out"]);
@@ -39,8 +40,10 @@ function projectUsage(action) {
       return "Usage: treeseed projects deployments <project-id>";
     case "deployment":
       return "Usage: treeseed projects deployment <project-id> <deployment-id>";
+    case "hosts":
+      return "Usage: treeseed projects hosts [audit|replace|resync|rotate] <project-id> [--host <requirement=provider:host-id|managed>]";
     default:
-      return "Usage: treeseed projects [list|access|deploy|publish|monitor|deployments|deployment]";
+      return "Usage: treeseed projects [list|access|hosts|deploy|publish|monitor|deployments|deployment]";
   }
 }
 function authFailure(error) {
@@ -106,6 +109,55 @@ function deploymentLine(deployment) {
     deploymentUrl(deployment)
   ].filter(Boolean).join("  ");
 }
+function normalizeRepeatable(value) {
+  if (Array.isArray(value)) return value.map(String).filter((entry) => entry.trim());
+  return typeof value === "string" && value.trim() ? [value.trim()] : [];
+}
+function hostBindingLine(entry) {
+  const binding = entry?.binding ?? {};
+  const audit = entry?.audit ?? {};
+  return [
+    entry.requirementKey,
+    entry.required ? "required" : "optional",
+    entry.type,
+    binding.provider ?? "(none)",
+    binding.hostId ?? binding.managedHostKey ?? "(not selected)",
+    audit.status ?? "ok"
+  ].filter(Boolean).join("  ");
+}
+function operationFacts(projectId, response) {
+  const operation = response.operation ?? null;
+  return [
+    { label: "Project", value: projectId },
+    { label: "Operation", value: operation?.id ?? null },
+    { label: "Status", value: operation?.status ?? null },
+    { label: "Poll", value: operation?.pollUrl ?? null }
+  ].filter((fact) => fact.value != null && fact.value !== "");
+}
+function hostBindingForMarket(parsed, requirementKey) {
+  const summary = parsed.summaries.find((entry) => entry.requirementKey === requirementKey) ?? parsed.omitted.find((entry) => entry.requirementKey === requirementKey);
+  const binding = parsed.hostBindings[requirementKey];
+  if (summary?.mode === "none") {
+    return {
+      requirementKey,
+      requirementKind: "host",
+      type: summary.type,
+      provider: summary.provider ?? "",
+      hostId: null,
+      managedHostKey: null,
+      mode: "none",
+      selectedBy: "user"
+    };
+  }
+  if (!binding || !summary) return null;
+  return {
+    ...binding,
+    hostId: summary.mode === "team_owned" ? summary.alias : null,
+    managedHostKey: summary.mode === "treeseed_managed" ? summary.alias === "managed" ? binding.managedHostKey : summary.alias : null,
+    displayName: summary.displayName,
+    environmentScopes: binding.environmentScopes?.filter((scope) => scope !== "local") ?? ["staging", "prod"]
+  };
+}
 function waitExitCode(status) {
   if (status === "succeeded") return 0;
   if (status === "timed_out") return 4;
@@ -226,6 +278,86 @@ const handleProjects = async (invocation, context) => {
         report: { marketId: profile.id, access: redact(response.payload) }
       });
     }
+    if (action === "hosts") {
+      const subaction = ["audit", "replace", "resync", "rotate"].includes(String(invocation.positionals[1])) ? String(invocation.positionals[1]) : "list";
+      const projectId = subaction === "list" ? invocation.positionals[1] : invocation.positionals[2];
+      if (!projectId) return fail(projectUsage(action));
+      if (subaction === "list") {
+        const response2 = await client.projectHosts(projectId);
+        const view2 = response2.payload.view ?? {};
+        return guidedResult({
+          command: "projects",
+          summary: "Treeseed project host bindings",
+          facts: [
+            { label: "Project", value: projectId },
+            { label: "Status", value: view2.summary?.status ?? "ok" },
+            { label: "Requirements", value: view2.summary?.total ?? 0 }
+          ],
+          sections: [{
+            title: "Host requirements",
+            lines: (view2.requirements ?? []).map(hostBindingLine)
+          }],
+          report: { marketId: profile.id, projectId, hosts: redact(response2.payload) }
+        });
+      }
+      if (subaction === "audit") {
+        const response2 = await client.auditProjectHosts(projectId, {
+          idempotencyKey: stringArg(invocation, "idempotencyKey")
+        });
+        const view2 = response2.payload.view ?? {};
+        return guidedResult({
+          command: "projects",
+          summary: "Treeseed project host audit",
+          facts: [
+            { label: "Project", value: projectId },
+            { label: "Status", value: view2.summary?.status ?? "ok" },
+            { label: "Warnings", value: view2.summary?.warnings ?? 0 },
+            { label: "Blocked", value: view2.summary?.blocked ?? 0 }
+          ],
+          sections: [{
+            title: "Diagnostics",
+            lines: (view2.diagnostics ?? []).map((entry) => `${entry.status}  ${entry.requirementKey ?? ""}  ${entry.message}`)
+          }],
+          report: { marketId: profile.id, projectId, audit: redact(response2.payload) }
+        });
+      }
+      const hostSpecs = normalizeRepeatable(invocation.args.host);
+      const hostSnapshot = await client.projectHosts(projectId);
+      const launchRequirements = hostSnapshot.payload.launchRequirements ?? null;
+      let requirementKey = stringArg(invocation, "requirement");
+      let hostBinding = null;
+      if (subaction === "replace") {
+        if (hostSpecs.length !== 1) return fail("Host replacement requires exactly one --host <requirement=provider:host-id|managed> spec.");
+        try {
+          const parsed = parseProjectLaunchHostBindingSpecs({ specs: hostSpecs, launchRequirements });
+          requirementKey = requirementKey ?? parsed.summaries[0]?.requirementKey ?? parsed.omitted[0]?.requirementKey ?? null;
+          if (!requirementKey) return fail("Host replacement could not determine a launch requirement key.");
+          hostBinding = hostBindingForMarket(parsed, requirementKey);
+          if (!hostBinding) return fail("Host replacement could not normalize the selected host binding.");
+        } catch (error) {
+          return fail(error instanceof Error ? error.message : String(error));
+        }
+      }
+      if (!requirementKey) return fail(`${subaction} requires --requirement <key>.`);
+      const body = {
+        ...hostBinding ? { hostBinding } : {},
+        ...stringArg(invocation, "sensitivePassphrase") ? { sensitivePassphrase: stringArg(invocation, "sensitivePassphrase") } : {},
+        ...stringArg(invocation, "idempotencyKey") ? { idempotencyKey: stringArg(invocation, "idempotencyKey") } : {}
+      };
+      const response = subaction === "replace" ? await client.replaceProjectHost(projectId, requirementKey, body) : subaction === "resync" ? await client.resyncProjectHost(projectId, requirementKey, body) : await client.rotateProjectHost(projectId, requirementKey, body);
+      const view = response.payload.view ?? {};
+      return guidedResult({
+        command: "projects",
+        summary: `Treeseed project host ${subaction} queued`,
+        facts: operationFacts(projectId, response),
+        sections: [{
+          title: "Host requirements",
+          lines: (view.requirements ?? []).map(hostBindingLine)
+        }],
+        nextSteps: response.operation?.id ? [`trsd projects hosts ${projectId}`, `trsd operations ${response.operation.id}`] : [`trsd projects hosts ${projectId}`],
+        report: { marketId: profile.id, projectId, response: redact(response) }
+      });
+    }
     if (action === "connect") {
       return fail("Use treeseed config --connect-market --market-project-id <project-id> for project pairing.");
     }

package/dist/cli/handlers/template.js

@@ -9,6 +9,50 @@ import {
 import { guidedResult } from "./utils.js";
 import { marketAuthRoot, marketSelector } from "./market-utils.js";
 const operations = new TreeseedOperationsSdk();
+function requirementStatus(required) {
+  return required === true ? "required" : "optional";
+}
+function providerList(requirement) {
+  return Array.isArray(requirement.compatibleProviders) && requirement.compatibleProviders.length > 0 ? requirement.compatibleProviders.join(", ") : "any provider";
+}
+function renderLaunchRequirementSections(template) {
+  const launchRequirements = template.launchRequirements;
+  if (!launchRequirements) {
+    return [{ title: "Launch Requirements", lines: ["No launch requirements declared."] }];
+  }
+  const hosts = Array.isArray(launchRequirements.hosts) ? launchRequirements.hosts : [];
+  const resources = Array.isArray(launchRequirements.resources) ? launchRequirements.resources : [];
+  const secrets = Array.isArray(launchRequirements.secrets) ? launchRequirements.secrets : [];
+  const configurableRequirements = [...hosts, ...resources];
+  const configWrites = configurableRequirements.flatMap((requirement) => Array.isArray(requirement.configWrites) ? requirement.configWrites.map((write) => `${requirement.key}: ${write.target}.${write.path} <- ${write.valueFrom}${write.writeWhen ? ` (${write.writeWhen})` : ""}`) : []);
+  const environmentWrites = configurableRequirements.flatMap((requirement) => Array.isArray(requirement.environmentWrites) ? requirement.environmentWrites.map((write) => `${requirement.key}: ${write.env} -> ${(write.targets ?? []).join(", ") || "config"} [${(write.scopes ?? []).join(", ") || "template scopes"}]`) : []);
+  return [
+    {
+      title: "Required Hosts",
+      lines: hosts.filter((host) => host.required === true).map((host) => `${host.key}: ${host.type} via ${providerList(host)} - ${host.purpose ?? host.displayName}`)
+    },
+    {
+      title: "Optional Hosts",
+      lines: hosts.filter((host) => host.required !== true).map((host) => `${host.key}: ${host.type} via ${providerList(host)} - ${host.purpose ?? host.displayName}`)
+    },
+    {
+      title: "Resources",
+      lines: resources.length > 0 ? resources.map((resource) => `${resource.key}: ${resource.type} ${requirementStatus(resource.required)} via ${providerList(resource)}`) : ["No resource lifecycle requirements in this phase."]
+    },
+    {
+      title: "Secrets",
+      lines: secrets.length > 0 ? secrets.map((secret) => `${secret.key}: ${secret.env} ${requirementStatus(secret.required)} -> ${(secret.targets ?? []).join(", ")}`) : ["No standalone secret requirements declared."]
+    },
+    {
+      title: "Config Writes",
+      lines: configWrites.length > 0 ? configWrites : ["No config writes declared."]
+    },
+    {
+      title: "Environment Targets",
+      lines: environmentWrites.length > 0 ? environmentWrites : ["No host-derived environment targets declared."]
+    }
+  ].filter((section) => section.lines.length > 0);
+}
 const handleTemplate = async (invocation, context) => {
   if (invocation.positionals[0] === "search" || invocation.positionals[0] === "install" || typeof invocation.args.market === "string") {
     const action = invocation.positionals[0] ?? "search";
@@ -78,6 +122,52 @@ const handleTemplate = async (invocation, context) => {
     outputFormat: context.outputFormat,
     transport: "cli"
   });
+  if (context.outputFormat === "json" || !result.ok) {
+    return {
+      exitCode: result.exitCode ?? (result.ok ? 0 : 1),
+      stdout: result.stdout,
+      stderr: result.stderr,
+      report: result.payload
+    };
+  }
+  const payload = result.payload;
+  if (payload?.action === "show" && payload.template) {
+    const template = payload.template;
+    return guidedResult({
+      command: "template",
+      summary: `Template ${template.id} is ready to scaffold.`,
+      facts: [
+        { label: "Name", value: template.displayName ?? template.id },
+        { label: "Status", value: template.status ?? "(unknown)" },
+        { label: "Version", value: template.templateVersion ?? "(unversioned)" },
+        { label: "Fulfillment", value: template.fulfillmentMode ?? "(unknown)" }
+      ],
+      sections: renderLaunchRequirementSections(template),
+      report: payload
+    });
+  }
+  if (payload?.action === "list" && Array.isArray(payload.templates)) {
+    return guidedResult({
+      command: "template",
+      summary: "Treeseed starter templates",
+      sections: [{
+        title: "Templates",
+        lines: payload.templates.map((template) => `${template.id}  ${template.displayName ?? template.id}  ${template.status ?? "unknown"}`)
+      }],
+      report: payload
+    });
+  }
+  if (payload?.action === "validate") {
+    return guidedResult({
+      command: "template",
+      summary: "Template validation completed.",
+      sections: [{
+        title: "Validated",
+        lines: Array.isArray(payload.validated) ? payload.validated.map(String) : []
+      }],
+      report: payload
+    });
+  }
   return {
     exitCode: result.exitCode ?? (result.ok ? 0 : 1),
     stdout: result.stdout,

package/dist/cli/operations-registry.js

@@ -2,6 +2,7 @@ import {
   findTreeseedOperation as findSdkOperation,
   TRESEED_OPERATION_SPECS as SDK_OPERATION_SPECS
 } from "@treeseed/sdk/operations";
+import { TREESEED_DEFAULT_STARTER_TEMPLATE_ID } from "@treeseed/sdk";
 function command(overlay) {
   return overlay;
 }
@@ -31,10 +32,53 @@ const DEV_RUNTIME_OPTIONS = [
   { name: "open", flags: "--open <mode>", description: "Control whether dev opens the browser after readiness. Defaults to off; use --open on to launch it.", kind: "enum", values: ["auto", "on", "off"] },
   { name: "plan", flags: "--plan", description: "Print the dev runtime plan and exit without starting services.", kind: "boolean" },
   { name: "reset", flags: "--reset", description: "Clear local dev runtime state before setup, migrations, and service startup.", kind: "boolean" },
-  { name: "force", flags: "--force", description: "Terminate overlapping Treeseed dev runtimes and listeners on required local dev ports before startup.", kind: "boolean" },
+  { name: "force", flags: "--force", description: "Replace the current worktree dev instance before startup.", kind: "boolean" },
+  { name: "forceConflicts", flags: "--force-conflicts", description: "Allow managed dev start to stop sibling worktree port owners when explicit ports conflict.", kind: "boolean" },
+  { name: "all", flags: "--all", description: "Apply managed dev status or stop to all worktrees in the repository family.", kind: "boolean" },
+  { name: "follow", flags: "--follow", description: "Follow managed dev logs when supported.", kind: "boolean" },
   { name: "json", flags: "--json", description: "Emit structured JSON or newline-delimited dev events.", kind: "boolean" },
   { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] }
 ];
+const DEV_STATUS_OPTIONS = DEV_RUNTIME_OPTIONS.filter((option) => ["all", "json"].includes(option.name));
+const DEV_LOGS_OPTIONS = DEV_RUNTIME_OPTIONS.filter((option) => ["follow", "json"].includes(option.name));
+const DEV_STOP_OPTIONS = DEV_RUNTIME_OPTIONS.filter((option) => ["all", "json"].includes(option.name));
+const DEV_START_OPTIONS = DEV_RUNTIME_OPTIONS.filter((option) => !["all", "follow"].includes(option.name));
+function devManagedHelpCommand(subcommand, spec) {
+  return {
+    id: `dev.${subcommand}`,
+    name: `dev ${subcommand}`,
+    aliases: [],
+    group: "Local Development",
+    summary: spec.summary,
+    description: spec.description,
+    provider: "default",
+    related: ["dev"],
+    usage: spec.usage,
+    options: spec.options,
+    examples: spec.examples,
+    helpVisible: false,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "dev",
+    help: {
+      workflowPosition: "managed dev instance",
+      longSummary: [spec.description],
+      whenToUse: spec.whenToUse,
+      beforeYouRun: spec.beforeYouRun,
+      outcomes: spec.outcomes,
+      examples: spec.examples,
+      automationNotes: [
+        "These managed dev subcommands use the same `dev` handler and core supervisor as foreground `treeseed dev`.",
+        "Use `--json` when another process needs stable instance records, ports, URLs, PIDs, ready checks, or log paths."
+      ],
+      warnings: spec.warnings ?? [],
+      relatedDetails: [
+        related("dev", "Use `dev` without a subcommand for the foreground supervisor.")
+      ],
+      seeAlso: ["dev"]
+    }
+  };
+}
 function genericWorkflowPosition(spec) {
   if (spec.group === "Workflow") {
     if (spec.name === "switch") return "start work";
@@ -848,14 +892,14 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "version", flags: "--version <version>", description: "Artifact version for market template install.", kind: "string" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
     ],
-    examples: ["treeseed template", "treeseed template list", "treeseed template show starter-basic", "treeseed template validate"],
+    examples: ["treeseed template", "treeseed template list", `treeseed template show ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID}`, "treeseed template validate"],
     help: {
       longSummary: [
         "Template exposes local starter catalog actions and market-backed search/install actions. Market search/install uses an integrated catalog from central and configured specialized markets, with every result labeled by source market."
       ],
       examples: [
         example("treeseed template", "Default to the catalog list", "Show the available starters without specifying an action."),
-        example("treeseed template show starter-basic", "Inspect a single starter", "View the details of one starter template."),
+        example(`treeseed template show ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID}`, "Inspect a single starter", "View the details of one starter template."),
         example("treeseed template validate", "Validate the current template set", "Run template validation to confirm the catalog is internally consistent.")
       ]
     },
@@ -881,15 +925,19 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   ["init", command({
     arguments: [{ name: "directory", description: "Target directory for the new tenant.", required: true }],
     options: [
-      { name: "template", flags: "--template <starter-id>", description: "Select the starter template id to generate. Defaults to starter-basic.", kind: "string" },
+      { name: "template", flags: "--template <starter-id>", description: `Select the starter template id to generate. Defaults to ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID}.`, kind: "string" },
       { name: "name", flags: "--name <site-name>", description: "Override the generated site name.", kind: "string" },
       { name: "slug", flags: "--slug <slug>", description: "Override the generated package and tenant slug.", kind: "string" },
       { name: "siteUrl", flags: "--site-url <url>", description: "Set the initial public site URL.", kind: "string" },
       { name: "contactEmail", flags: "--contact-email <email>", description: "Set the site contact address.", kind: "string" },
       { name: "repo", flags: "--repo <url>", description: "Set the repository URL.", kind: "string" },
-      { name: "discord", flags: "--discord <url>", description: "Set the Discord/community URL.", kind: "string" }
+      { name: "discord", flags: "--discord <url>", description: "Set the Discord/community URL.", kind: "string" },
+      { name: "host", flags: "--host <requirement=provider:alias>", description: "Bind a template launch requirement locally. Repeat for multiple requirements, or use requirement=none for optional hosts.", kind: "string", repeatable: true }
+    ],
+    examples: [
+      `treeseed init docs-site --template ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID} --name "Docs Site" --site-url https://docs.example.com`,
+      `treeseed init docs-site --template ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID} --host sourceRepository=github:acme --host publicWeb=cloudflare:managed`
     ],
-    examples: ['treeseed init docs-site --template starter-basic --name "Docs Site" --site-url https://docs.example.com'],
     notes: ["Runs outside an existing repo or from any branch."],
     help: {
       workflowPosition: "create workspace",
@@ -909,7 +957,8 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
         "Seeds the project metadata fields requested through the CLI flags."
       ],
       examples: [
-        example('treeseed init docs-site --template starter-basic --name "Docs Site" --site-url https://docs.example.com', "Create a starter site", "Scaffold a new tenant using the basic starter and explicit branding metadata."),
+        example(`treeseed init docs-site --template ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID} --name "Docs Site" --site-url https://docs.example.com`, "Create a starter site", "Scaffold a new tenant using the default starter and explicit branding metadata."),
+        example(`treeseed init docs-site --template ${TREESEED_DEFAULT_STARTER_TEMPLATE_ID} --host sourceRepository=github:acme --host publicWeb=cloudflare:managed`, "Bind launch hosts locally", "Apply host-derived starter config during scaffold without calling Market inventory APIs."),
         example("treeseed init workbench --slug workbench --contact-email ops@example.com", "Control project identity fields", "Initialize a tenant while overriding slug and contact metadata at creation time."),
         example("treeseed init docs-site --repo https://github.com/example/docs-site --discord https://discord.gg/example", "Seed community and repository metadata", "Attach repository and community URLs during project initialization.")
       ],
@@ -1167,15 +1216,18 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   })],
   ["dev", command({
     options: DEV_RUNTIME_OPTIONS,
-    examples: ["treeseed dev", "treeseed dev --reset", "treeseed dev --reset --plan --json", "treeseed dev --web-runtime local --plan --json", "treeseed dev --port 4322"],
+    arguments: [{ name: "subcommand", description: "Optional managed instance action: start, status, logs, stop, or restart.", required: false }],
+    examples: ["treeseed dev", "treeseed dev start", "treeseed dev status --all --json", "treeseed dev logs", "treeseed dev stop", "treeseed dev --web-runtime local --plan --json"],
     help: {
       longSummary: [
-        "Dev starts the local Treeseed Market web/API/runtime services as a foreground supervisor.",
+        "Dev starts or manages the local Treeseed Market web/API/runtime services.",
+        "Without a subcommand, dev runs as the existing foreground supervisor.",
         "Capacity provider lifecycle is package-owned and runs through `treeseed capacity ...`, not through `treeseed dev`."
       ],
       beforeYouRun: [
         "Run from the tenant or workspace root you want to develop.",
         "From the Market repo root, dev automatically starts the local Market API, managed local PostgreSQL, and Market operations runner alongside the web UI.",
+        "Use `dev start` for worktree-scoped background instance management that AI agents can discover and stop later.",
         "Use `--plan --json` when you want to inspect fixed web/API/runner commands, setup steps, readiness checks, watched paths, and restart policy without starting services.",
         "Use `--reset` when you want a fresh local D1 database, Market PostgreSQL state, Mailpit inbox, generated worker bundle, and Wrangler temp output without deleting configuration.",
         "Dev prints the local web URL after readiness; it does not open a browser unless you pass `--open on` or `--open auto`.",
@@ -1183,6 +1235,10 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       ],
       examples: [
         example("treeseed dev", "Start local Market development", "Run web, API, managed PostgreSQL setup, and the Market operations runner locally."),
+        example("treeseed dev start", "Start a managed worktree instance", "Launch the same dev runtime detached, write worktree-local PID/log/state files, and return after readiness."),
+        example("treeseed dev status --all --json", "Inspect all worktree instances", "List managed dev instances discovered through the repository-family index."),
+        example("treeseed dev logs", "Show managed dev logs", "Print the current worktree managed dev log file."),
+        example("treeseed dev stop", "Stop managed dev", "Stop only the current worktree managed dev instance."),
         example("treeseed dev --reset", "Start from a fresh local runtime", "Clear disposable local dev state, rerun setup and database migrations, then start the dev supervisor."),
         example("treeseed dev --reset --plan --json", "Inspect reset actions", "Emit the reset, setup, readiness, command, and watch plan without deleting local state or starting services."),
         example("treeseed dev --plan --json", "Inspect the runtime plan", "Emit a structured plan with setup steps, commands, ports, URLs, readiness checks, and watch entries."),
@@ -1251,7 +1307,129 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   })],
   ["starlight:patch", command({ examples: ["treeseed starlight:patch"], executionMode: "adapter" })]
 ]);
+const DEV_MANAGED_OPERATION_SPECS = [
+  devManagedHelpCommand("start", {
+    summary: "Start a detached worktree-scoped dev instance.",
+    description: "Start launches the same Market web/API/runner runtime as foreground `dev`, but detaches it, writes worktree-local instance state, captures logs, waits for readiness, and returns a summary.",
+    usage: "treeseed dev start [--web-runtime local|provider|auto] [--port <port>] [--api-port <port>] [--force] [--force-conflicts] [--json]",
+    options: DEV_START_OPTIONS,
+    whenToUse: [
+      "Use this when you want the local Market runtime to keep running after the shell command exits.",
+      "Use it for AI-agent workflows where later commands need discoverable PID, port, URL, and log state."
+    ],
+    beforeYouRun: [
+      "Run from the worktree that should own the managed instance.",
+      "Use `--web-runtime local` for fast Astro hot reload.",
+      "Use `--force` to replace only the current worktree instance. Use `--force-conflicts` only when you intentionally want to stop sibling worktree port owners."
+    ],
+    outcomes: [
+      "Writes `.treeseed/dev/instances/web-api.json`, `.treeseed/dev/pids/web-api.pid`, and `.treeseed/logs/dev-web-api.jsonl` in the current worktree.",
+      "Returns after readiness with URLs, ports, PID, process group, log path, and ready-check state."
+    ],
+    examples: [
+      example("treeseed dev start --web-runtime local --force", "Start the current worktree instance", "Launch the managed background runtime with local web hot reload and replace any stale current-worktree owner."),
+      example("treeseed dev start --port 4322 --api-port 3002 --json", "Start on explicit ports", "Pin web and API ports and emit a structured instance summary."),
+      example("trsd dev start --web-runtime local", "Use the short alias", "Start the same managed runtime through the shorter entrypoint.")
+    ]
+  }),
+  devManagedHelpCommand("status", {
+    summary: "Inspect managed dev instance state.",
+    description: "Status reads worktree-local managed dev state, checks process and readiness health, repairs stale records opportunistically, and can discover sibling worktree instances through the repository-family index.",
+    usage: "treeseed dev status [--all] [--json]",
+    options: DEV_STATUS_OPTIONS,
+    whenToUse: [
+      "Use this before starting a new managed instance to see whether one is already running.",
+      "Use `--all` when multiple worktrees or AI agents may be running sibling instances for the same repository family."
+    ],
+    beforeYouRun: [
+      "Run from the worktree you want to inspect.",
+      "Use `--json` for automation that needs the exact status, PID, ports, URLs, stale reason, or sibling conflicts."
+    ],
+    outcomes: [
+      "Prints ready, starting, degraded, stopped, or stale state for the current worktree instance.",
+      "With `--all`, includes instances discovered from sibling worktrees through the shared repository-family index."
+    ],
+    examples: [
+      example("treeseed dev status", "Inspect current worktree", "Show the managed instance state for the current worktree."),
+      example("treeseed dev status --all", "Inspect sibling worktrees", "List managed instances discoverable across the repository family."),
+      example("treeseed dev status --json", "Read status programmatically", "Emit machine-readable instance state for agents or scripts.")
+    ]
+  }),
+  devManagedHelpCommand("logs", {
+    summary: "Read managed dev logs.",
+    description: "Logs prints the current worktree managed dev log in human-readable form, rendering structured dev events as concise text and optionally following the stable log file.",
+    usage: "treeseed dev logs [--follow] [--json]",
+    options: DEV_LOGS_OPTIONS,
+    whenToUse: [
+      "Use this when `dev status` reports stale, degraded, or stopped and you need to see what happened.",
+      "Use `--follow` while iterating locally to watch the background runtime without reattaching to the supervisor process."
+    ],
+    beforeYouRun: [
+      "Run from the worktree that owns the managed instance.",
+      "Default human output shows a recent, readable tail. Use the reported log path if you need the full historical file."
+    ],
+    outcomes: [
+      "Prints the current managed log tail from `.treeseed/logs/dev-web-api.jsonl`.",
+      "With `--follow`, continues streaming appended log lines until interrupted."
+    ],
+    examples: [
+      example("treeseed dev logs", "Show recent managed logs", "Print the current worktree managed dev log tail in human-readable form."),
+      example("treeseed dev logs --follow", "Follow background runtime logs", "Stream appended log entries while the managed instance runs."),
+      example("treeseed dev status --json", "Find the log path", "Use status when automation needs the authoritative log file location.")
+    ]
+  }),
+  devManagedHelpCommand("stop", {
+    summary: "Stop managed dev instances.",
+    description: "Stop terminates the current worktree managed dev process group and leaves sibling worktree instances alone unless `--all` is explicitly provided.",
+    usage: "treeseed dev stop [--all] [--json]",
+    options: DEV_STOP_OPTIONS,
+    whenToUse: [
+      "Use this when you are done with the current worktree background runtime.",
+      "Use `--all` only when intentionally cleaning up every discoverable managed instance in the repository family."
+    ],
+    beforeYouRun: [
+      "Run from the worktree whose instance should be stopped.",
+      "Prefer `dev status --all` first when several agents may be working in sibling worktrees."
+    ],
+    outcomes: [
+      "Stops only the owned process group for the current worktree by default.",
+      "Marks stopped or stale records so later `dev start` and `dev status` calls see accurate state."
+    ],
+    warnings: [
+      "`--all` can interrupt sibling worktree sessions owned by other humans or agents."
+    ],
+    examples: [
+      example("treeseed dev stop", "Stop current worktree instance", "Terminate only the current managed dev process group."),
+      example("treeseed dev stop --all", "Stop repository-family instances", "Stop all discoverable managed instances for the repository family."),
+      example("treeseed dev stop --json", "Stop from automation", "Emit a structured stop summary.")
+    ]
+  }),
+  devManagedHelpCommand("restart", {
+    summary: "Restart a managed dev instance.",
+    description: "Restart stops the current worktree managed dev instance, then starts it again with the same managed-start semantics, state files, log path, readiness checks, and port ownership rules.",
+    usage: "treeseed dev restart [--web-runtime local|provider|auto] [--port <port>] [--api-port <port>] [--force] [--force-conflicts] [--json]",
+    options: DEV_START_OPTIONS,
+    whenToUse: [
+      "Use this after changing runtime configuration, package links, or local service state that needs a fresh supervisor.",
+      "Use it when the managed instance is degraded and a clean stop/start is preferable to inspecting every child process manually."
+    ],
+    beforeYouRun: [
+      "Run from the worktree that owns the managed instance.",
+      "Pass the same runtime options you would use with `dev start` when you want to change ports or web runtime mode during restart."
+    ],
+    outcomes: [
+      "Stops the current worktree managed instance and starts a new one.",
+      "Returns the new PID, process group, ports, URLs, log path, and readiness result."
+    ],
+    examples: [
+      example("treeseed dev restart --web-runtime local --force", "Restart local hot-reload runtime", "Replace the current worktree managed instance and wait for readiness."),
+      example("treeseed dev restart --port 4322 --api-port 3002 --json", "Restart on new ports", "Restart with explicit web/API ports and emit a structured summary."),
+      example("trsd dev restart", "Use the short alias", "Restart through the shorter entrypoint.")
+    ]
+  })
+];
 const CLI_ONLY_OPERATION_SPECS = [
+  ...DEV_MANAGED_OPERATION_SPECS,
   {
     id: "seed.plan",
     name: "seed",
@@ -1498,11 +1676,11 @@ const CLI_ONLY_OPERATION_SPECS = [
     name: "projects",
     aliases: [],
     group: "Utilities",
-    summary: "Inspect projects and run web deployment operations from the selected market.",
-    description: "List market projects, inspect access, and queue or inspect project web deployment operations through the Market API.",
+    summary: "Inspect projects, project hosts, and web deployment operations from the selected market.",
+    description: "List market projects, inspect access and host bindings, and queue project host or web deployment operations through the Market API.",
     provider: "default",
     related: ["market", "teams", "config"],
-    usage: "treeseed projects [list|access|deploy|publish|monitor|deployments|deployment]",
+    usage: "treeseed projects [list|access|hosts|deploy|publish|monitor|deployments|deployment]",
     arguments: [
       { name: "action", description: "Projects action.", required: false },
       { name: "project-id", description: "Project id for deployment and access actions.", required: false },
@@ -1518,6 +1696,9 @@ const CLI_ONLY_OPERATION_SPECS = [
       { name: "dryRun", flags: "--dry-run", description: "Queue a dry-run deployment request when supported.", kind: "boolean" },
       { name: "reason", flags: "--reason <text>", description: "Presentation-safe reason stored on the deployment request.", kind: "string" },
       { name: "idempotencyKey", flags: "--idempotency-key <key>", description: "Deterministic idempotency key for the deployment request.", kind: "string" },
+      { name: "requirement", flags: "--requirement <key>", description: "Launch host requirement key for project host resync or rotate operations.", kind: "string" },
+      { name: "host", flags: "--host <requirement=provider:host-id>", description: "Replacement host binding for `projects hosts replace`. Use requirement=provider:managed for a managed host or requirement=none for optional hosts.", kind: "string", repeatable: true },
+      { name: "sensitivePassphrase", flags: "--sensitive-passphrase <passphrase>", description: "One-time unlock passphrase for team-owned host credentials. Avoid this in shell history; prefer interactive UI when possible.", kind: "string" },
       { name: "yes", flags: "--yes", description: "Required confirmation for production deploy and publish actions.", kind: "boolean" },
       { name: "limit", flags: "--limit <count>", description: "Maximum number of deployments to list.", kind: "string" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
@@ -1525,14 +1706,17 @@ const CLI_ONLY_OPERATION_SPECS = [
     examples: [
       "treeseed projects list",
       "treeseed projects access project_123",
+      "treeseed projects hosts project_123",
+      "treeseed projects hosts audit project_123",
+      "treeseed projects hosts replace project_123 --host publicWeb=cloudflare:web-host-123",
       "treeseed projects deploy project_123 --environment staging --wait",
       "treeseed projects publish project_123 --environment prod --yes",
       "treeseed projects deployments project_123 --json",
       "treeseed projects deployment project_123 dep_123"
     ],
     help: {
-      longSummary: ["Projects reads project, access, and deployment state from the selected market API using the SDK market client."],
-      whenToUse: ["Use this to inspect projects, queue staging or production web deployment operations, and inspect the same deployment state shown in the Market UI."],
+      longSummary: ["Projects reads project, host binding, access, and deployment state from the selected market API using the SDK market client."],
+      whenToUse: ["Use this to inspect projects, audit or replace launch host bindings, queue staging or production web deployment operations, and inspect the same state shown in the Market UI."],
       beforeYouRun: ["Authenticate to the market with `treeseed auth:login --market <selector>` and know the project id before queueing deployment work."],
       automationNotes: ["Use `--json` to capture project lists, deployment records, events, and wait results for automation."],
       warnings: ["Production deploy and publish require `--yes`; without it the CLI exits before calling the API."]

package/dist/cli/runtime.js

@@ -22,6 +22,28 @@ function shouldRenderCommandHelp(spec, argv) {
   const treeseedArgs = separatorIndex >= 0 ? argv.slice(0, separatorIndex) : argv;
   return treeseedArgs.some(isHelpFlag);
 }
+function resolveNestedDevHelpTarget(argv) {
+  const managedSubcommands = /* @__PURE__ */ new Set(["start", "status", "logs", "stop", "restart"]);
+  const subcommand = argv.find((arg) => !arg.startsWith("-") && managedSubcommands.has(arg));
+  return subcommand ? `dev ${subcommand}` : null;
+}
+function resolveCommandHelpTarget(spec, argv) {
+  if (spec.name === "dev") {
+    return resolveNestedDevHelpTarget(argv) ?? spec.name;
+  }
+  return spec.name;
+}
+function resolveExplicitHelpTarget(args) {
+  const helpArgs = args.filter((arg) => !arg.startsWith("-"));
+  if (helpArgs.length === 0) return null;
+  for (let length = Math.min(3, helpArgs.length); length > 0; length -= 1) {
+    const candidate = helpArgs.slice(0, length).join(" ");
+    if (findTreeseedOperation(candidate)) {
+      return candidate;
+    }
+  }
+  return helpArgs[0] ?? null;
+}
 function isNoColorFlag(value) {
   return value === "--no-color";
 }
@@ -303,13 +325,14 @@ class TreeseedOperationsSdk {
       return writeTreeseedResult({ exitCode: 1, stderr: [lines.join("\n")] }, context);
     }
     if (shouldRenderCommandHelp(spec, argv)) {
+      const helpTarget = resolveCommandHelpTarget(spec, argv);
       if (shouldUseInkHelp(context)) {
-        const helpExitCode = await renderTreeseedHelpInk(spec.name, context);
+        const helpExitCode = await renderTreeseedHelpInk(helpTarget, context);
         if (typeof helpExitCode === "number") {
           return helpExitCode;
         }
       }
-      context.write(renderTreeseedHelp(spec.name), "stdout");
+      context.write(renderTreeseedHelp(helpTarget), "stdout");
       return 0;
     }
     return spec.executionMode === "adapter" ? this.executeAdapter(spec, argv, context) : spec.executionMode === "delegate" ? this.executeAgents(argv, context) : this.executeHandler(spec, argv, context);
@@ -318,7 +341,7 @@ class TreeseedOperationsSdk {
     const context = createTreeseedCommandContext(overrides);
     const [firstArg, ...restArgs] = argv;
     if (!firstArg || isHelpFlag(firstArg) || firstArg === "help") {
-      const commandName = firstArg === "help" ? restArgs[0] ?? null : null;
+      const commandName = firstArg === "help" ? resolveExplicitHelpTarget(restArgs) : null;
       if (shouldUseInkHelp(context)) {
         const helpExitCode = await renderTreeseedHelpInk(commandName, context);
         if (typeof helpExitCode === "number") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.10.18",
+  "version": "0.10.21",
   "description": "Operator-facing Treeseed CLI package.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -45,7 +45,7 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "github:treeseed-ai/sdk#0.10.24",
+    "@treeseed/sdk": "github:treeseed-ai/sdk#0.10.27",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },