@treeseed/cli 0.8.9 → 0.8.11

package/dist/cli/handlers/dev.js

@@ -42,7 +42,8 @@ function resolveCoreDevEntrypoint(cwd) {
 }
 const handleDev = async (invocation, context) => {
   try {
-    const watch = invocation.commandName === "dev:watch" || invocation.args.watch === true;
+    const feedback = typeof invocation.args.feedback === "string" ? invocation.args.feedback : void 0;
+    const watch = feedback !== "off";
     const passthroughArgs = [];
     const forwardStringOption = (name, flag) => {
       const value = invocation.args[name];
@@ -56,6 +57,7 @@ const handleDev = async (invocation, context) => {
       }
     };
     forwardStringOption("surface", "--surface");
+    forwardStringOption("surfaces", "--surfaces");
     forwardStringOption("host", "--host");
     forwardStringOption("port", "--port");
     forwardStringOption("apiHost", "--api-host");

package/dist/cli/operations-registry.js

@@ -21,7 +21,8 @@ function related(name, why) {
   return { name, why };
 }
 const DEV_RUNTIME_OPTIONS = [
-  { name: "surface", flags: "--surface <surface>", description: "Select the local dev surface to run.", kind: "enum", values: ["integrated", "web", "api", "manager", "worker", "services"] },
+  { name: "surface", flags: "--surface <surface>", description: "Select one local dev surface to run. Compatibility alias for --surfaces.", kind: "enum", values: ["integrated", "web", "api", "manager", "worker", "agents", "services"] },
+  { name: "surfaces", flags: "--surfaces <surfaces>", description: "Select comma-separated local dev surfaces to run.", kind: "string" },
   { name: "host", flags: "--host <host>", description: "Host for the web dev server.", kind: "string" },
   { name: "port", flags: "--port <port>", description: "Port for the web dev server.", kind: "string" },
   { name: "apiHost", flags: "--api-host <host>", description: "Host used to construct the local API URL.", kind: "string" },
@@ -1162,29 +1163,33 @@ 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 --surface web --port 4322 --open off"],
+    examples: ["treeseed dev", "treeseed dev --reset", "treeseed dev --reset --plan --json", "treeseed dev --surfaces web,api --plan --json", "treeseed dev --surface web --port 4322 --open off"],
     help: {
       longSummary: [
-        "Dev starts the unified local Treeseed runtime as a foreground supervisor so you can work against the integrated web, API, and supporting local surfaces.",
-        "The command keeps streaming logs and dev events until you press Ctrl+C, receive SIGTERM, or a required surface fails; shutdown stops every service process group it started."
+        "Dev starts the unified local Treeseed runtime as a foreground supervisor so you can work against the integrated web, API, manager, worker, and supporting local surfaces.",
+        "The command keeps streaming logs and dev events until you press Ctrl+C or receive SIGTERM. Required surface failures are restarted with backoff instead of ending the supervisor."
       ],
       beforeYouRun: [
         "Run from the tenant or workspace root you want to develop.",
-        "Use `--plan --json` when you want to inspect commands, setup steps, readiness checks, and watched paths without starting services.",
+        "Use `--plan --json` when you want to inspect selected surfaces, commands, setup steps, readiness checks, watched paths, and restart policy without starting services.",
         "Use `--reset` when you want a fresh local D1 database, Mailpit inbox, generated worker bundle, and Wrangler temp output without deleting configuration.",
         "Keep the foreground process running while you test. Press Ctrl+C to stop the supervised stack and free the local ports."
       ],
       examples: [
-        example("treeseed dev", "Start integrated local development", "Run the default integrated local runtime and keep supervising it in the foreground."),
+        example("treeseed dev", "Start integrated local development", "Run web, API, manager, and worker locally and keep supervising them in the foreground."),
         example("treeseed dev --reset", "Start from a fresh local runtime", "Clear disposable local dev state, rerun setup and D1 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."),
+        example("treeseed dev --surfaces web,api,worker --plan --json", "Inspect selected surfaces", "Plan a comma-separated set of local surfaces without starting the supervisor."),
+        example("treeseed dev --surface api --plan --json", "Inspect the API surface", "Plan the local API runtime without the web UI."),
+        example("treeseed dev --surfaces integrated,agents", "Opt into agents diagnostics", "Start the integrated local platform plus the agents diagnostic loop."),
         example("treeseed dev --surface web --port 4322 --open off", "Run only the web surface", "Start the Astro UI on a specific port without opening a browser."),
         example("trsd dev", "Use the short alias", "Start the same local runtime through the shorter entrypoint."),
         example("treeseed dev --json", "Stream dev events", "Emit newline-delimited events while the long-running dev process supervises local services.")
       ],
       outcomes: [
         "Starts the selected local surfaces, waits for readiness, and then remains attached as the live supervisor.",
+        "Restarts required crashed surfaces with capped exponential backoff and keeps setup/readiness failures alive for retry.",
         "Stops watchers first and then terminates service process groups when the foreground command exits."
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.8.9",
+  "version": "0.8.11",
   "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": "0.8.9",
+    "@treeseed/sdk": "0.8.11",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },