@treeseed/cli 0.6.9 → 0.6.10

package/dist/cli/handlers/close.js

@@ -4,6 +4,7 @@ const handleClose = async (invocation, context) => {
   try {
     const result = await createWorkflowSdk(context).close({
       message: invocation.positionals.join(" ").trim(),
+      worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -17,10 +18,12 @@ const handleClose = async (invocation, context) => {
         { label: "Mode", value: payload.mode },
         { label: "Closed branch", value: payload.branchName },
         { label: "Auto-saved", value: payload.autoSaved ? "yes" : "no" },
-        { label: "Deprecated tag", value: payload.rootRepo.tagName ?? payload.deprecatedTag.tagName },
+        { label: "Deprecated tag", value: payload.rootRepo.tagName ?? payload.deprecatedTag?.tagName ?? "(planned)" },
         { label: "Package branches cleaned", value: String(deletedPackages) },
-        { label: "Preview cleanup", value: payload.previewCleanup.performed ? "performed" : "not needed" },
-        { label: "Final branch", value: payload.finalBranch }
+        { label: "Preview cleanup", value: payload.previewCleanup?.performed ? "performed" : result.executionMode === "plan" ? "planned" : "not needed" },
+        { label: "Worktree cleanup", value: payload.worktreeCleanup?.removed ? "removed" : "not needed" },
+        { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" },
+        { label: "Final branch", value: payload.finalBranch ?? "staging" }
       ],
       nextSteps: renderWorkflowNextSteps(result),
       report: result

package/dist/cli/handlers/export.js

@@ -3,7 +3,10 @@ import { createWorkflowSdk, workflowErrorResult } from "./workflow.js";
 const handleExport = async (invocation, context) => {
   try {
     const directory = typeof invocation.positionals[0] === "string" && invocation.positionals[0].trim().length > 0 ? invocation.positionals[0] : void 0;
-    const result = await createWorkflowSdk(context).export({ directory });
+    const result = await createWorkflowSdk(context).export({
+      directory,
+      worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0
+    });
     const exported = result.payload;
     return guidedResult({
       command: "export",
@@ -15,7 +18,8 @@ const handleExport = async (invocation, context) => {
         { label: "Timestamp", value: exported.timestamp },
         { label: "Files", value: exported.summary?.totalFiles },
         { label: "Tokens", value: exported.summary?.totalTokens },
-        { label: "Bundled paths", value: Array.isArray(exported.includedBundlePaths) ? exported.includedBundlePaths.length : 0 }
+        { label: "Bundled paths", value: Array.isArray(exported.includedBundlePaths) ? exported.includedBundlePaths.length : 0 },
+        { label: "Worktree path", value: exported.worktreePath ?? "(in-place)" }
       ],
       report: exported
     });

package/dist/cli/handlers/recover.js

@@ -1,8 +1,10 @@
 import { guidedResult } from "./utils.js";
 import { createWorkflowSdk, renderWorkflowNextSteps, workflowErrorResult } from "./workflow.js";
-const handleRecover = async (_invocation, context) => {
+const handleRecover = async (invocation, context) => {
   try {
-    const result = await createWorkflowSdk(context).recover({});
+    const result = await createWorkflowSdk(context).recover({
+      pruneStale: invocation.args.pruneStale === true
+    });
     const payload = result.payload;
     return guidedResult({
       command: "recover",
@@ -11,6 +13,8 @@ const handleRecover = async (_invocation, context) => {
         { label: "Active lock", value: payload.lock.active ? "yes" : "no" },
         { label: "Stale lock", value: payload.lock.stale ? "yes" : "no" },
         { label: "Interrupted runs", value: payload.interruptedRuns.length },
+        { label: "Stale runs", value: payload.staleRuns?.length ?? 0 },
+        { label: "Pruned runs", value: payload.prunedRuns?.length ?? 0 },
         { label: "Recorded runs", value: payload.runCount }
       ],
       nextSteps: renderWorkflowNextSteps(result),

package/dist/cli/handlers/release.js

@@ -58,6 +58,8 @@ const handleRelease = async (invocation, context) => {
     const bump = ["major", "minor", "patch"].find((candidate) => invocation.args[candidate] === true) ?? "patch";
     const result = await createWorkflowSdk(context).release({
       bump,
+      worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
+      ciMode: typeof invocation.args.ciMode === "string" ? invocation.args.ciMode : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -83,6 +85,9 @@ const handleRelease = async (invocation, context) => {
         { label: "Dependent packages", value: String(payload.packageSelection.dependents.length) },
         { label: result.executionMode === "plan" ? "Packages planned" : "Released packages", value: String((payload.touchedPackages ?? payload.packageSelection.selected).length) },
         { label: "Publish waits", value: result.executionMode === "plan" ? String(plannedPublishes) : String(completedPublishes) },
+        { label: "CI mode", value: payload.ciMode ?? "auto" },
+        { label: "Workflow gates", value: String(payload.workflowGates?.length ?? 0) },
+        { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" },
         { label: "Final branch", value: payload.finalBranch ?? (result.executionMode === "plan" ? payload.stagingBranch : "(unknown)") }
       ],
       sections: result.executionMode === "plan" ? formatReleasePlanSections(payload) : [],

package/dist/cli/handlers/save.js

@@ -51,6 +51,9 @@ const handleSave = async (invocation, context) => {
       message: invocation.positionals.join(" ").trim(),
       hotfix: invocation.args.hotfix === true,
       preview: invocation.args.preview === true,
+      worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
+      ciMode: typeof invocation.args.ciMode === "string" ? invocation.args.ciMode : void 0,
+      verifyMode: typeof invocation.args.verifyMode === "string" ? invocation.args.verifyMode : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -78,7 +81,10 @@ const handleSave = async (invocation, context) => {
           value: result.executionMode === "plan" ? plannedRepos || "not applicable" : savedRepos || ((payload.repos ?? []).length > 0 ? "none saved" : "not applicable")
         },
         { label: "Market pushed", value: payload.rootRepo?.pushed ? "yes" : "no" },
-        { label: "Preview action", value: payload.previewAction?.status ?? "skipped" }
+        { label: "Preview action", value: payload.previewAction?.status ?? "skipped" },
+        { label: "CI mode", value: payload.ciMode ?? "auto" },
+        { label: "Workflow gates", value: String(payload.workflowGates?.length ?? 0) },
+        { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" }
       ],
       sections: result.executionMode === "plan" ? [
         ...payload.plannedSteps?.length ? [{ title: "Dependency mode transitions", lines: payload.plannedSteps.filter((step) => /workspace-(?:link|unlink)/u.test(String(step.id ?? ""))).map((step) => `- ${step.description ?? step.id}`) }] : [],

package/dist/cli/handlers/stage.js

@@ -4,6 +4,8 @@ const handleStage = async (invocation, context) => {
   try {
     const result = await createWorkflowSdk(context).stage({
       message: invocation.positionals.join(" ").trim(),
+      worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
+      ciMode: typeof invocation.args.ciMode === "string" ? invocation.args.ciMode : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -19,11 +21,14 @@ const handleStage = async (invocation, context) => {
         { label: "Merge target", value: payload.mergeTarget },
         { label: "Merge strategy", value: payload.mergeStrategy },
         { label: "Auto-saved", value: payload.autoSaved ? "yes" : "no" },
-        { label: "Deprecated tag", value: payload.rootRepo.tagName ?? payload.deprecatedTag.tagName },
+        { label: "Deprecated tag", value: payload.rootRepo.tagName ?? payload.deprecatedTag?.tagName ?? "(planned)" },
         { label: "Package merges", value: String(mergedPackages) },
-        { label: "Staging wait", value: payload.stagingWait.status },
-        { label: "Preview cleanup", value: payload.previewCleanup.performed ? "performed" : "not needed" },
-        { label: "Final branch", value: payload.finalBranch }
+        { label: "Staging wait", value: payload.stagingWait?.status ?? (result.executionMode === "plan" ? "planned" : "unknown") },
+        { label: "Workflow gates", value: String(payload.workflowGates?.length ?? 0) },
+        { label: "Preview cleanup", value: payload.previewCleanup?.performed ? "performed" : result.executionMode === "plan" ? "planned" : "not needed" },
+        { label: "Worktree cleanup", value: payload.worktreeCleanup?.removed ? "removed" : "not needed" },
+        { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" },
+        { label: "Final branch", value: payload.finalBranch ?? payload.mergeTarget }
       ],
       nextSteps: renderWorkflowNextSteps(result),
       report: result

package/dist/cli/handlers/switch.js

@@ -6,6 +6,7 @@ const handleSwitch = async (invocation, context) => {
     const result = await createWorkflowSdk(context).switchTask({
       branch,
       preview: invocation.args.preview === true,
+      worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -22,8 +23,10 @@ const handleSwitch = async (invocation, context) => {
         { label: "Market created", value: payload.rootRepo.created ? "yes" : "no" },
         { label: "Package branches created", value: String(packageCreated) },
         { label: "Package branches resumed", value: String(packageResumed) },
-        { label: "Preview", value: payload.preview.enabled ? "enabled" : "disabled" },
-        { label: "Preview URL", value: payload.preview.url ?? "(none)" }
+        { label: "Preview", value: payload.preview?.enabled ? "enabled" : payload.previewRequested ? "planned" : "disabled" },
+        { label: "Preview URL", value: payload.preview?.url ?? "(none)" },
+        { label: "Worktree mode", value: payload.worktreeMode ?? "auto" },
+        { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" }
       ],
       nextSteps: renderWorkflowNextSteps(result),
       report: result

package/dist/cli/operations-registry.js

@@ -208,6 +208,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     arguments: [{ name: "branch-name", description: "Task branch to create or resume.", required: true }],
     options: [
       { name: "preview", flags: "--preview", description: "Provision or refresh a branch-scoped Cloudflare preview environment.", kind: "boolean" },
+      { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "plan", flags: "--plan", description: "Compute the recursive branch switch plan without mutating any repo.", kind: "boolean" },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },
@@ -261,6 +262,9 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     options: [
       { name: "hotfix", flags: "--hotfix", description: "Allow save on main for an explicit hotfix.", kind: "boolean" },
       { name: "preview", flags: "--preview", description: "Create or refresh the branch preview during save.", kind: "boolean" },
+      { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
+      { name: "ciMode", flags: "--ci <mode>", description: "Control hosted GitHub Actions waits.", kind: "enum", values: ["auto", "hosted", "off"] },
+      { name: "verifyMode", flags: "--verify <mode>", description: "Control save verification depth.", kind: "enum", values: ["fast", "local", "hosted", "both", "skip"] },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "plan", flags: "--plan", description: "Compute the recursive save plan without mutating any repo.", kind: "boolean" },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },
@@ -309,6 +313,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     arguments: [{ name: "message", description: "Reason for closing the task without staging it.", required: true, kind: "message_tail" }],
     options: [
       { name: "plan", flags: "--plan", description: "Compute the recursive close plan without mutating any repo.", kind: "boolean" },
+      { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
@@ -348,6 +353,8 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     arguments: [{ name: "message", description: "Resolution message for the staged task.", required: true, kind: "message_tail" }],
     options: [
       { name: "plan", flags: "--plan", description: "Compute the recursive staging plan without mutating any repo.", kind: "boolean" },
+      { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
+      { name: "ciMode", flags: "--ci <mode>", description: "Control hosted GitHub Actions waits.", kind: "enum", values: ["auto", "hosted", "off"] },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
@@ -407,8 +414,11 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     handlerName: "resume"
   })],
   ["recover", command({
-    options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
-    examples: ["treeseed recover", "treeseed recover --json"],
+    options: [
+      { name: "pruneStale", flags: "--prune-stale", description: "Archive stale interrupted runs that are no longer safe to resume.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed recover", "treeseed recover --json", "treeseed recover --prune-stale --json"],
     help: {
       workflowPosition: "recover",
       longSummary: [
@@ -422,10 +432,11 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
         "Run it from the market workspace root or anywhere inside the tenant so the CLI can inspect the correct `.treeseed/workflow` journal directory."
       ],
       outcomes: [
-        "Reports the active workflow lock, interrupted runs, and the exact `treeseed resume <run-id>` command for resumable runs."
+        "Reports the active workflow lock, resumable interrupted runs, stale runs, obsolete runs, and the exact `treeseed resume <run-id>` command for resumable runs."
       ],
       automationNotes: [
-        "`recover --json` is the supported discovery entrypoint for agents that need to inspect lock state and resumable run ids safely before mutating the workspace."
+        "`recover --json` is the supported discovery entrypoint for agents that need to inspect lock state and resumable run ids safely before mutating the workspace.",
+        "Use `recover --prune-stale --json` to archive stale journals after the recorded branch or release heads no longer match current state."
       ]
     },
     executionMode: "handler",
@@ -555,6 +566,33 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       force: invocation.args.force === true
     })
   })],
+  ["tools", command({
+    options: [
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed tools", "trsd tools --json"],
+    help: {
+      workflowPosition: "setup",
+      longSummary: [
+        "Tools reports the Treeseed-managed executable cache, exact binary paths, invocation mode, and GitHub CLI authentication state without installing or mutating tools."
+      ],
+      whenToUse: [
+        "Use this before shelling out to `gh`, Wrangler, Railway, or Copilot from an agent or script.",
+        "Use this when a command claims an executable is missing but `treeseed install` has already prepared the managed tool cache."
+      ],
+      outcomes: [
+        "Reports toolsHome, ghConfigDir, per-tool binaryPath, invocation command, and GitHub auth remediation."
+      ],
+      examples: [
+        example("trsd tools --json", "Resolve managed paths for automation", "Emit stable executable paths and auth status for scripts or agents.")
+      ],
+      relatedDetails: [
+        related("install", "Use `install` when tools are missing or the managed cache needs repair."),
+        related("doctor", "Use `doctor` when tools exist but workflow readiness is still blocked.")
+      ]
+    },
+    executionMode: "adapter"
+  })],
   ["auth:login", command({
     options: [
       { name: "host", flags: "--host <id>", description: "Override the configured remote host id for this login.", kind: "string" },
@@ -863,6 +901,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   ["export", command({
     arguments: [{ name: "directory", description: "Directory subtree to export. Defaults to the current shell directory.", required: false }],
     options: [
+      { name: "worktreeMode", flags: "--worktree <mode>", description: "Include managed workflow worktree mode metadata.", kind: "enum", values: ["auto", "on", "off"] },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
     ],
     examples: ["treeseed export", "treeseed export src", "treeseed export packages/sdk --json"],
@@ -905,6 +944,8 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "major", flags: "--major", description: "Bump to the next major version.", kind: "boolean" },
       { name: "minor", flags: "--minor", description: "Bump to the next minor version.", kind: "boolean" },
       { name: "patch", flags: "--patch", description: "Bump to the next patch version.", kind: "boolean" },
+      { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
+      { name: "ciMode", flags: "--ci <mode>", description: "Control hosted GitHub Actions waits.", kind: "enum", values: ["auto", "hosted", "off"] },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "plan", flags: "--plan", description: "Compute the recursive release plan without mutating any repo.", kind: "boolean" },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },

package/package.json

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