@treeseed/cli 0.6.14 → 0.6.16

package/dist/cli/operations-registry.js

@@ -1054,13 +1054,25 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     options: DEV_RUNTIME_OPTIONS,
     examples: ["treeseed dev", "treeseed dev --plan --json", "treeseed dev --surface web --port 4322 --open off"],
     help: {
-      longSummary: ["Dev starts the unified local Treeseed runtime so you can work against the integrated web, API, and supporting local surfaces."],
+      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."
+      ],
+      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.",
+        "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."),
+        example("treeseed dev", "Start integrated local development", "Run the default integrated local runtime and keep supervising it in the foreground."),
         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 --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.",
+        "Stops watchers first and then terminates service process groups when the foreground command exits."
       ]
     },
     executionMode: "handler",
@@ -1070,9 +1082,12 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     options: DEV_RUNTIME_OPTIONS,
     examples: ["treeseed dev:watch", "treeseed dev:watch --json"],
     help: {
-      longSummary: ["Dev:watch starts local development with rebuild and watch semantics so code changes are reflected continuously during active development."],
+      longSummary: [
+        "Dev:watch is a compatibility alias for foreground dev supervision with live feedback enabled.",
+        "It stays attached to the terminal and cleans up supervised services on Ctrl+C just like `dev`."
+      ],
       examples: [
-        example("treeseed dev:watch", "Start watch mode", "Run the local runtime with watch and rebuild behavior enabled."),
+        example("treeseed dev:watch", "Start watch mode", "Run the local runtime with watch and rebuild behavior enabled in the foreground."),
         example("trsd dev:watch", "Use the short alias", "Start the same watch-mode runtime through the shorter entrypoint."),
         example("treeseed dev:watch --feedback restart", "Restart services without browser reload", "Use watcher-driven service restarts while leaving browser refresh to your own tooling."),
         example("treeseed dev:watch --help", "Inspect watch help", "Read the help surface before starting a longer watch session.")

package/package.json

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