@ordewell/cli 0.5.1 → 0.5.3

package/dist/main.js

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/main.ts
-var import_core21 = require("@ordewell/core");
+var import_core23 = require("@ordewell/core");
 
 // src/utils/env.ts
 var import_fs = require("fs");
@@ -95,6 +95,7 @@ Planning:
   ordewell fork                   Continue in a copy of the conversation and its tasks
   ordewell compact                Condense the conversation into a summary (tasks are kept)
   ordewell rewind [<n>]           Fork the conversation from before message <n> (no <n>: list them)
+  ordewell handoff [action]       Review, merge, discard or clean up a finished isolated run
 
 Tasks (<id> is an order number or a task ID):
   ordewell add-task --title "..."  Add a task to the current plan
@@ -123,6 +124,7 @@ Planner, models and runners:
   ordewell runners [<id> on|off]  Enable or disable runners (claude-code, opencode, codex)
   ordewell allowlist set|clear|show       Limit which models a runner may use
   ordewell auto [on|off]          Autonomous permission mode for new sessions
+  ordewell parallel [<n>]         How many AI tasks run at once (default 3; applies to a live run)
   ordewell refresh                Re-discover runners and model catalogs
   ordewell models                 List every provider's catalog (works without a server)
 
@@ -196,8 +198,9 @@ Environment:
   OPENROUTER_BASE_URL        Default: https://openrouter.ai/api/v1
   ORDEWELL_AUTONOMOUS_MODE   Approval posture for new sessions (see "ordewell auto")
   ORDEWELL_PORT              Daemon port CLI commands target (default: 3742)
+  ORDEWELL_DIRENV            false: agents skip the project's direnv .envrc
   ORDEWELL_RESEARCH_ENABLED  true (default) or false
-  ORDEWELL_MAX_PARALLEL      Default: 3
+  ORDEWELL_MAX_PARALLEL      Default: 3 \u2014 set with "ordewell parallel"
 `);
 }
 
@@ -387,10 +390,15 @@ var WorkspaceInitNeededError = class extends Error {
   }
   workspace;
 };
-var ApiClient = class {
+var SESSION_PATH = /^\/api\/(?:plans|sessions)\/([^/?]+)/;
+var ApiClient = class _ApiClient {
+  /** Where a CLI invocation's sessions live, when a client is built without one: `--workspace`, else the cwd. */
+  static defaultWorkspace;
   port;
-  constructor(port) {
+  workspace;
+  constructor(port, workspace) {
     this.port = port || DEFAULT_PORT;
+    this.workspace = workspace ?? _ApiClient.defaultWorkspace ?? process.cwd();
   }
   /**
    * Read at call time rather than at construction: a daemon restarted mid-run
@@ -400,7 +408,23 @@ var ApiClient = class {
   token() {
     return (0, import_core3.readDaemonToken)(this.port);
   }
-  httpRequest(method, urlPath, body) {
+  /**
+   * A daemon holds only the sessions adopted since it started, so after a
+   * restart every session-scoped call answered "Session not found" until the
+   * user ran `ordewell sessions load`. The saved session is adopted here
+   * instead — idempotent for one the daemon still holds — and the call made
+   * once more; a 404 means the first attempt never ran, so the retry cannot
+   * act twice.
+   */
+  async httpRequest(method, urlPath, body) {
+    const res = await this.rawRequest(method, urlPath, body);
+    const sessionId = urlPath.match(SESSION_PATH)?.[1];
+    const missing = res.status === 404 && res.data?.error === "Session not found";
+    if (!missing || !sessionId || urlPath.split("?")[0].endsWith("/load")) return res;
+    const adopted2 = await this.rawRequest("POST", `/api/sessions/${sessionId}/load?workspace=${encodeURIComponent(this.workspace)}`);
+    return adopted2.status === 200 ? this.rawRequest(method, urlPath, body) : res;
+  }
+  rawRequest(method, urlPath, body) {
     return new Promise((resolve3, reject) => {
       const url = new URL(urlPath, `http://127.0.0.1:${this.port}`);
       const configuredTimeout = Number.parseInt(process.env.ORDEWELL_HTTP_TIMEOUT_MS || "", 10);
@@ -941,6 +965,25 @@ function readLastSession(workspace) {
   }
   return null;
 }
+var SESSION_PREFIX = "session-";
+function expandSessionId(id, workspace) {
+  if (id.startsWith(SESSION_PREFIX)) return id;
+  let files;
+  try {
+    files = (0, import_fs3.readdirSync)((0, import_path3.join)((0, import_core5.getStateDir)(workspace), "sessions")).filter((f) => f.endsWith(".json"));
+  } catch {
+    return id;
+  }
+  const matches = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    try {
+      const full = JSON.parse((0, import_fs3.readFileSync)((0, import_path3.join)((0, import_core5.getStateDir)(workspace), "sessions", file), "utf8"))?.meta?.id;
+      if (typeof full === "string" && (full.endsWith(id) || full.slice(SESSION_PREFIX.length).startsWith(id))) matches.add(full);
+    } catch {
+    }
+  }
+  return matches.size === 1 ? [...matches][0] : id;
+}
 
 // src/approvals.ts
 function describeApproval(event) {
@@ -1043,7 +1086,7 @@ function isTransient(event) {
 // src/commands/plan.ts
 var import_core6 = require("@ordewell/core");
 function planTasks(plan) {
-  return plan?.tasks || [];
+  return plan ? allTasksOf(plan) : [];
 }
 function hasCommittedPlan(plan) {
   return planTasks(plan).length > 0;
@@ -1111,7 +1154,7 @@ function printPlan(plan, sessionId, runners2, models) {
     return rp ? ` (${task.assignedModel.modelLabel} \xB7 ${label})` : ` (${task.assignedModel.modelLabel})`;
   };
   console.log(`
-Plan: ${tasks.length} tasks (${aiCount} AI, ${manCount} Manual) \u2014 ${(plan.runners || runners2).join(", ")}`);
+Plan: ${tasks.length} task${tasks.length === 1 ? "" : "s"} (${aiCount} AI, ${manCount} Manual) \u2014 ${(plan.runners || runners2).join(", ")}`);
   console.log(`Session: ${sessionId}
 `);
   for (const t of tasks) {
@@ -2961,30 +3004,47 @@ async function handlePlannerEffort(subArgs, injectedApi) {
   console.log(`Planner effort set to ${level}.`);
 }
 
-// src/commands/key.ts
+// src/commands/parallel.ts
 var import_core14 = require("@ordewell/core");
-var USAGE5 = "Usage: ordewell key [list | set <provider> <key>]";
+var USAGE5 = "Usage: ordewell parallel [<number of tasks, 1 or more>]";
+async function handleParallel(subArgs, injectedApi) {
+  const [wanted] = positionals(subArgs);
+  const api = await connect(subArgs, injectedApi);
+  if (!wanted || wanted === "show") {
+    const settings = await api.getSettings();
+    console.log(`Up to ${String(settings.maxParallel ?? "?")} AI tasks run at once. Change with: ordewell parallel <n>`);
+    return;
+  }
+  const limit = (0, import_core14.parseMaxParallel)(wanted);
+  if (limit === null) fail(`"${wanted}" is not a number of tasks (1 or more).`, USAGE5);
+  await persistEnv(api, { ORDEWELL_MAX_PARALLEL: String(limit) });
+  console.log(`Up to ${limit} AI task${limit === 1 ? "" : "s"} now run at once.`);
+}
+
+// src/commands/key.ts
+var import_core15 = require("@ordewell/core");
+var USAGE6 = "Usage: ordewell key [list | set <provider> <key>]";
 async function handleKey(subArgs, injectedApi) {
   const [action, provider, ...keyParts] = positionals(subArgs);
   if (action && action !== "list" && action !== "set") {
-    fail(`Unknown key action: "${action}"`, USAGE5);
+    fail(`Unknown key action: "${action}"`, USAGE6);
   }
   const api = await connect(subArgs, injectedApi);
   if (action !== "set") {
     const catalog = await fetchCatalog(api);
     console.log("\nAPI provider keys\n");
-    for (const id2 of import_core14.PROVIDER_PRIORITY) {
-      const meta2 = import_core14.ALL_PROVIDERS[id2];
+    for (const id2 of import_core15.PROVIDER_PRIORITY) {
+      const meta2 = import_core15.ALL_PROVIDERS[id2];
       const configured = catalog.providers.includes(id2);
       console.log(`  ${configured ? "\u2713" : " "} ${id2.padEnd(14)} ${meta2.apiKeyEnvVar.padEnd(28)} ${meta2.label}`);
     }
     console.log(`
-  \u2713 = a working key was found. ${USAGE5}`);
+  \u2713 = a working key was found. ${USAGE6}`);
     return;
   }
-  if (!provider) fail(USAGE5);
+  if (!provider) fail(USAGE6);
   const id = provider.toLowerCase();
-  const meta = import_core14.ALL_PROVIDERS[id];
+  const meta = import_core15.ALL_PROVIDERS[id];
   if (!meta) {
     fail(`Unknown provider: ${provider}`, "Run `ordewell key` to see the list.");
   }
@@ -2995,7 +3055,7 @@ async function handleKey(subArgs, injectedApi) {
 }
 
 // src/commands/runners.ts
-var USAGE6 = "Usage: ordewell runners [<runner-id> on|off]";
+var USAGE7 = "Usage: ordewell runners [<runner-id> on|off]";
 async function handleRunners(subArgs, injectedApi) {
   const [runner, toggle] = positionals(subArgs);
   const api = await connect(subArgs, injectedApi);
@@ -3006,7 +3066,7 @@ async function handleRunners(subArgs, injectedApi) {
       console.log(`  ${r.enabled ? "\u2713" : " "} ${r.id.padEnd(14)} ${r.name}${r.enabled ? "" : "  (disabled)"}`);
     }
     console.log(`
-  \u2713 = offered to the planner. ${USAGE6}`);
+  \u2713 = offered to the planner. ${USAGE7}`);
     return;
   }
   const state = await api.getRunners();
@@ -3015,7 +3075,7 @@ async function handleRunners(subArgs, injectedApi) {
     fail(`Unknown runner: ${runner}`, `Enabled or not, this daemon knows: ${state.runners.map((r) => r.id).join(", ")}`);
   }
   const enabled = toggle === void 0 ? !known.enabled : toggle === "on" ? true : toggle === "off" ? false : null;
-  if (enabled === null) fail(USAGE6);
+  if (enabled === null) fail(USAGE7);
   await api.setRunnerEnabled(runner, enabled);
   console.log(`${runner} ${enabled ? "enabled" : "disabled"}.`);
 }
@@ -3065,7 +3125,7 @@ async function handleApprove(subArgs, injectedApi) {
 // src/tui/terminalLauncher.ts
 var import_child_process3 = require("child_process");
 var import_util = require("util");
-var import_core15 = require("@ordewell/core");
+var import_core16 = require("@ordewell/core");
 var execFileAsync = (0, import_util.promisify)(import_child_process3.execFile);
 var defaultExecFile = async (command, args) => {
   const { stdout, stderr } = await execFileAsync(command, args);
@@ -3085,16 +3145,16 @@ var defaultWhich = (bin) => {
 async function openTaskTerminal(port, planSessionId, taskId, deps = {}) {
   const platform = deps.platform ?? process.platform;
   const env = deps.env ?? process.env;
-  const hasTmuxImpl = deps.hasTmuxImpl ?? import_core15.hasTmux;
+  const hasTmuxImpl = deps.hasTmuxImpl ?? import_core16.hasTmux;
   const execFileImpl = deps.execFileImpl ?? defaultExecFile;
   const spawnImpl = deps.spawnImpl ?? defaultSpawn;
   const which = deps.which ?? defaultWhich;
   if (!hasTmuxImpl()) {
     return { ok: false, message: "tmux is not installed \u2014 install it to get a real terminal per task." };
   }
-  const session = (0, import_core15.tmuxSessionName)(port);
-  const socket = (0, import_core15.tmuxSocketName)(port);
-  const base = (0, import_core15.tmuxWindowName)(taskId, planSessionId);
+  const session = (0, import_core16.tmuxSessionName)(port);
+  const socket = (0, import_core16.tmuxSocketName)(port);
+  const base = (0, import_core16.tmuxWindowName)(taskId, planSessionId);
   let windows;
   try {
     const { stdout } = await execFileImpl("tmux", ["-L", socket, "list-windows", "-t", session, "-F", "#{window_name}"]);
@@ -3388,7 +3448,7 @@ Dependencies \xB7 #${task.order} ${task.title}
 }
 
 // src/tui/index.ts
-var import_core20 = require("@ordewell/core");
+var import_core22 = require("@ordewell/core");
 
 // src/tui/editor.ts
 function emptyEditor() {
@@ -3550,6 +3610,7 @@ var SLASH_COMMANDS = [
   { name: "allowlist", usage: "/allowlist [set <runner> <ids> | clear <runner>]", description: "Limit which models a runner may use", category: "models" },
   { name: "runners", usage: "/runners [<id> on|off]", description: "Enable or disable runners (claude-code, opencode, codex)", category: "models" },
   { name: "auto", usage: "/auto [on|off]", description: "Autonomous permission mode for new plans", category: "models" },
+  { name: "parallel", usage: "/parallel [<n>]", description: "How many AI tasks run at once (applies to a live run)", category: "models" },
   { name: "refresh", usage: "/refresh", description: "Re-discover runners and model catalogs", category: "models" },
   // Skills
   { name: "tdd", usage: "/tdd [on|off]", description: "Test-Driven Development mode", category: "skills" },
@@ -3774,6 +3835,7 @@ function chatEditorRoom(cols, active) {
 }
 
 // src/tui/state.ts
+var import_core17 = require("@ordewell/core");
 var SKILL_IDS = ["tdd", "verify"];
 function noSkills() {
   return { tdd: false, verify: false };
@@ -3838,6 +3900,7 @@ function initialState(overrides = {}) {
     orchestratorModel: "",
     plannerProvider: "",
     plannerEffort: "",
+    maxParallel: import_core17.DEFAULT_MAX_PARALLEL,
     configuredProviders: [],
     allowlist: {},
     autonomous: true,
@@ -3857,7 +3920,7 @@ function initialState(overrides = {}) {
 }
 
 // src/tui/layout.ts
-var import_core16 = require("@ordewell/core");
+var import_core18 = require("@ordewell/core");
 var CHROME_ROWS = 4;
 function chatInputWrap(state) {
   const active = state.focus === "chat" && !state.overlay;
@@ -3993,9 +4056,9 @@ function chatScrollMax(state) {
 }
 function plannerSetup(state) {
   const provider = state.plannerProvider;
-  const registration = import_core16.ALL_PROVIDERS[provider];
+  const registration = import_core18.ALL_PROVIDERS[provider];
   if (!registration) return { label: "not set", ready: false };
-  const runner = (0, import_core16.runnerForProvider)(provider);
+  const runner = (0, import_core18.runnerForProvider)(provider);
   const ready = runner ? state.runners.some((r) => r.id === runner) : state.configuredProviders.includes(provider);
   return { label: registration.label, ready };
 }
@@ -4178,7 +4241,7 @@ function taskLines(state, row, index, cols) {
   const icon = paint(rawIcon);
   const kind = running ? style.yellow("RUN") : task.type === "user" ? style.yellow("MAN") : style.grey(" AI");
   const caret = selected ? style.cyan("\u276F") : " ";
-  const orderLabel = parent ? (0, import_core16.taskOrderLabel)(task, parent) : String(task.order).padStart(2);
+  const orderLabel = parent ? (0, import_core18.taskOrderLabel)(task, parent) : String(task.order).padStart(2);
   const indent = parent ? "  " : "";
   const head = `${indent}${caret} ${icon} ${orderLabel} ${kind} `;
   const titleRoom = Math.max(1, cols - width(head));
@@ -4199,21 +4262,22 @@ function taskLines(state, row, index, cols) {
   const mode = task.type === "ai" ? `mode: ${task.taskMode ?? "default"}${modeInfo?.autonomous ? style.yellow(" \u26A1") : ""}` : "";
   const runner = task.assignedRunner ?? "";
   const bodyPad = parent ? "      " : "    ";
-  const meta = [running ? "working" : "", runner, model].filter(Boolean).join(" \xB7 ");
+  const activity = idle ? "quiet \u2014 t opens its terminal" : running ? "working" : "";
+  const meta = [activity, runner, model].filter(Boolean).join(" \xB7 ");
   if (meta) lines.push(style.grey(truncate(`${bodyPad}${meta}`, cols)));
   if (effort || mode) lines.push(style.grey(truncate(`${bodyPad}${[effort, mode].filter(Boolean).join(" \xB7 ")}`, cols)));
   if (task.isolation?.state === "conflict") {
     const where = task.isolation.conflictRepo && task.isolation.conflictRepo !== "." ? ` in ${task.isolation.conflictRepo}` : "";
-    const files = task.isolation.conflictFiles?.length ? ` (${(0, import_core16.capConflictFiles)(task.isolation.conflictFiles)})` : "";
+    const files = task.isolation.conflictFiles?.length ? ` (${(0, import_core18.capConflictFiles)(task.isolation.conflictFiles)})` : "";
     lines.push(style.red(truncate(`${bodyPad}\u26A0 merge conflict${where}${files} \u2014 its work is kept on its own branch`, cols)));
   }
   if (task.isolation?.state === "repairing") {
-    const files = task.isolation.conflictFiles?.length ? ` in ${(0, import_core16.capConflictFiles)(task.isolation.conflictFiles)}` : "";
+    const files = task.isolation.conflictFiles?.length ? ` in ${(0, import_core18.capConflictFiles)(task.isolation.conflictFiles)}` : "";
     const attempt = task.isolation.repair ? ` (attempt ${task.isolation.repair.attempt}/${task.isolation.repair.limit})` : "";
     lines.push(style.yellow(truncate(`${bodyPad}\u21BB repairing conflict${files}${attempt}`, cols)));
   }
   if (task.isolation?.state === "integrated" && task.isolation.repairedFiles?.length) {
-    lines.push(style.grey(truncate(`${bodyPad}\u21BB landed after repairing conflict in ${(0, import_core16.capConflictFiles)(task.isolation.repairedFiles)}`, cols)));
+    lines.push(style.grey(truncate(`${bodyPad}\u21BB landed after repairing conflict in ${(0, import_core18.capConflictFiles)(task.isolation.repairedFiles)}`, cols)));
   }
   let editorLine;
   if (expanded) {
@@ -4298,7 +4362,7 @@ function helpScrollMax(state) {
 }
 
 // src/tui/render.ts
-var import_core17 = require("@ordewell/core");
+var import_core19 = require("@ordewell/core");
 function render(state) {
   const { rows, cols } = state;
   const rowsForBody = bodyRows(state);
@@ -4562,7 +4626,7 @@ function renderHandoff(state, overlay, rows, cols) {
     return frame(`Diff \u2014 ${handoffBranch(handoff)}`, [...shown, "", style.grey(`${more}enter or esc goes back`)], rows, cols);
   }
   const landed = handoff.landed.length === 0 ? [style.grey("Nothing landed on it.")] : handoff.landed.map((task) => {
-    const repaired = task.repairedFiles?.length ? style.yellow(` \u2014 repaired (${(0, import_core17.capConflictFiles)(task.repairedFiles)})`) : "";
+    const repaired = task.repairedFiles?.length ? style.yellow(` \u2014 repaired (${(0, import_core19.capConflictFiles)(task.repairedFiles)})`) : "";
     return `  ${style.green("\u2713")} #${task.order} ${task.title}${repaired}`;
   });
   const actions = handoffActions(handoff).map((action, index) => {
@@ -4652,9 +4716,9 @@ function frame(title, body, rows, cols) {
 }
 
 // src/tui/reducer.ts
-var import_core18 = require("@ordewell/core");
+var import_core20 = require("@ordewell/core");
 var import_plan_utils3 = require("@ordewell/core/plan-utils");
-var KNOWN_PROVIDERS2 = Object.keys(import_core18.ALL_PROVIDERS);
+var KNOWN_PROVIDERS2 = Object.keys(import_core20.ALL_PROVIDERS);
 var DEFAULT_EFFORT = "__runner_default__";
 function step(state, effects = []) {
   return { state, effects };
@@ -4673,6 +4737,17 @@ function alreadySpoken(messages, content) {
   const redrawn = messages.at(-1)?.role === "system" && messages.at(-1)?.content === content;
   return spoken || redrawn;
 }
+function runLabel(tasks) {
+  const running = tasks.filter(isTaskRunning);
+  if (running.length > 0) {
+    const [first] = running;
+    const name = first.assignedRunner ? `${first.title} \xB7 ${first.assignedRunner}` : first.title;
+    return running.length > 1 ? `${name} (+${running.length - 1} more)` : name;
+  }
+  const waiting = tasks.filter((t) => t.status === "awaiting_user").length;
+  if (waiting === 0) return "";
+  return waiting === 1 ? "1 task waits for you" : `${waiting} tasks wait for you`;
+}
 function researchLabel(messages, summary) {
   const others = messages.filter(isPendingResearch).length - 1;
   return others > 0 ? `${summary} (+${others} more)` : summary;
@@ -4776,6 +4851,16 @@ function reduce(state, action) {
       const status = state.status === "planning" ? "researching" : state.status;
       return step({ ...spoken, status, busyLabel: researchLabel(spoken.messages, summary) });
     }
+    // A settled transcript line, not a research step: nothing ever settles a
+    // task's start, so as a step it stayed "⋯" forever and was counted into
+    // the planner's next "(+N more)".
+    case "taskStarted": {
+      if (stale(state, action.sessionId)) return step(state);
+      const tasks = state.tasks.map((t) => t.id === action.taskId && !isTaskRunning(t) ? { ...t, status: "in_progress" } : t);
+      const who = action.runner ? ` \xB7 ${action.runner}` : "";
+      const spoken = say(state, "system", sanitize(`Started "${action.title}"${who}`));
+      return step({ ...spoken, tasks, status: "executing", busyLabel: runLabel(tasks) });
+    }
     case "researchStepDone": {
       if (stale(state, action.sessionId)) return step(state);
       const messages = settleResearchStep(state.messages, action);
@@ -4816,7 +4901,7 @@ function reduce(state, action) {
         return t;
       });
       if (!changed) return step(state);
-      return step({ ...state, status: "executing", tasks });
+      return step({ ...state, status: "executing", tasks, busyLabel: runLabel(tasks) });
     }
     case "queueReady": {
       if (stale(state, action.sessionId)) return step(state);
@@ -4986,6 +5071,7 @@ function applySettings(state, settings) {
     orchestratorModel: typeof settings.orchestratorModel === "string" ? settings.orchestratorModel : state.orchestratorModel,
     plannerProvider: typeof settings.aiProvider === "string" ? settings.aiProvider : state.plannerProvider,
     plannerEffort: typeof settings.plannerThinkingEffort === "string" ? settings.plannerThinkingEffort : state.plannerEffort,
+    maxParallel: typeof settings.maxParallel === "number" ? settings.maxParallel : state.maxParallel,
     allowlist: settings.modelAllowlist && typeof settings.modelAllowlist === "object" ? settings.modelAllowlist : state.allowlist
   };
 }
@@ -5002,11 +5088,11 @@ function modelDetail(m) {
 function providerErrorHint(state) {
   const failed = Object.keys(state.providerErrors ?? {});
   if (failed.length === 0) return void 0;
-  const names = failed.map((p) => import_core18.ALL_PROVIDERS[p]?.label ?? p);
+  const names = failed.map((p) => import_core20.ALL_PROVIDERS[p]?.label ?? p);
   return `\u26A0 Unavailable (key or fetch failed): ${names.join(", ")} \u2014 showing working providers only.`;
 }
 function plannerModelItems(state) {
-  const runner = (0, import_core18.runnerForProvider)(state.plannerProvider);
+  const runner = (0, import_core20.runnerForProvider)(state.plannerProvider);
   if (!runner) return state.orchestratorModels.map((m) => ({ id: m.id, label: m.label, detail: modelDetail(m) }));
   const items = state.models.filter((m) => m.runners?.includes(runner)).map((m) => ({
     id: m.id,
@@ -5020,7 +5106,7 @@ function plannerModelItems(state) {
   return items.length > 0 ? items : [{ id: "", label: `No ${runner} models discovered yet`, detail: "run /refresh", disabled: true }];
 }
 function plannerEffortItems(state) {
-  const runner = (0, import_core18.runnerForProvider)(state.plannerProvider);
+  const runner = (0, import_core20.runnerForProvider)(state.plannerProvider);
   if (!runner) {
     return [{ id: "", label: "Thinking effort applies to a coding-agent planner", detail: "switch with /planner", disabled: true }];
   }
@@ -5601,6 +5687,8 @@ function runCommand(state, { name, args }) {
       return runners(state, args);
     case "auto":
       return setAutonomous(state, args[0]);
+    case "parallel":
+      return setMaxParallel(state, args[0]);
     case "mouse":
       return setMouseCapture(state, args[0]);
     case "sessions":
@@ -5769,7 +5857,7 @@ function newSession(state) {
 }
 function setModel(state, args) {
   if (args[0] === "set" && args[1]) {
-    const runner = (0, import_core18.runnerForProvider)(state.plannerProvider);
+    const runner = (0, import_core20.runnerForProvider)(state.plannerProvider);
     const known = runner ? modelsForRunner(state.models, runner) : [];
     if (runner && known.length > 0 && !known.some((m) => m.id === args[1])) {
       return fail3(state, `${args[1]} was not discovered for ${runner}.`);
@@ -5791,21 +5879,21 @@ function setModel(state, args) {
 }
 function plannerItems(state) {
   const installed = new Set(state.runners.map((r) => r.id));
-  const agents = import_core18.CLI_PROVIDERS.map((id) => {
-    const runner = (0, import_core18.runnerForProvider)(id);
+  const agents = import_core20.CLI_PROVIDERS.map((id) => {
+    const runner = (0, import_core20.runnerForProvider)(id);
     const ready = installed.has(runner);
     return {
       id,
-      label: import_core18.ALL_PROVIDERS[id].label,
+      label: import_core20.ALL_PROVIDERS[id].label,
       detail: ready ? "coding agent \xB7 no API key needed" : "CLI not installed or not on PATH",
       selected: state.plannerProvider === id,
       disabled: !ready
     };
   });
-  const vendors = import_core18.PROVIDER_PRIORITY.filter((id) => state.configuredProviders.includes(id)).map((id) => ({
+  const vendors = import_core20.PROVIDER_PRIORITY.filter((id) => state.configuredProviders.includes(id)).map((id) => ({
     id,
-    label: import_core18.ALL_PROVIDERS[id].label,
-    detail: import_core18.ALL_PROVIDERS[id].apiKeyEnvVar,
+    label: import_core20.ALL_PROVIDERS[id].label,
+    detail: import_core20.ALL_PROVIDERS[id].apiKeyEnvVar,
     selected: state.plannerProvider === id
   }));
   return vendors.length > 0 ? [...agents, ...vendors] : [...agents, { id: "", label: "No API providers configured", detail: "add a key with /key", disabled: true }];
@@ -5863,16 +5951,16 @@ function setKey(state, args) {
     }
     return step(state, [{ type: "setApiKey", provider, key: args.slice(2).join(" ") }]);
   }
-  const items = import_core18.PROVIDER_PRIORITY.map((id) => ({
+  const items = import_core20.PROVIDER_PRIORITY.map((id) => ({
     id,
-    label: import_core18.ALL_PROVIDERS[id].label,
-    detail: import_core18.ALL_PROVIDERS[id].apiKeyEnvVar,
+    label: import_core20.ALL_PROVIDERS[id].label,
+    detail: import_core20.ALL_PROVIDERS[id].apiKeyEnvVar,
     selected: state.configuredProviders.includes(id)
   }));
   return step({ ...state, overlay: { kind: "picker", picker: picker("API provider key", items, { kind: "set-key" }) } });
 }
 function keyPrompt(provider) {
-  const meta = import_core18.ALL_PROVIDERS[provider];
+  const meta = import_core20.ALL_PROVIDERS[provider];
   return {
     kind: "prompt",
     title: `${meta.label} API key`,
@@ -5947,6 +6035,12 @@ function runners(state, args) {
     })
   } });
 }
+function setMaxParallel(state, arg) {
+  if (!arg) return step(say(state, "system", `Up to ${state.maxParallel} AI task${state.maxParallel === 1 ? "" : "s"} run at once \u2014 /parallel <n> changes it.`));
+  const limit = (0, import_core20.parseMaxParallel)(arg);
+  if (limit === null) return fail3(state, "Usage: /parallel [<number of tasks, 1 or more>]");
+  return step({ ...state, maxParallel: limit }, [{ type: "setMaxParallel", limit }]);
+}
 function setAutonomous(state, arg) {
   const enabled = resolveToggle(arg, state.autonomous);
   if (enabled === null) return fail3(state, "Usage: /auto [on|off]");
@@ -6202,7 +6296,9 @@ function createApp(deps) {
   function dispatch(action) {
     if (exited) return;
     const result = reduce(state, action);
+    const previousSession = state.sessionId;
     state = result.state;
+    if (state.sessionId && state.sessionId !== previousSession) deps.onSessionChange?.(state.sessionId, state);
     if (state.exiting) {
       exited = true;
       clearInterval(spinnerInterval);
@@ -6234,7 +6330,7 @@ function createApp(deps) {
 
 // src/tui/effects.ts
 var import_child_process4 = require("child_process");
-var import_core19 = require("@ordewell/core");
+var import_core21 = require("@ordewell/core");
 var import_plan_utils4 = require("@ordewell/core/plan-utils");
 var ConversationQueue = class {
   tail = Promise.resolve();
@@ -6405,7 +6501,7 @@ async function perform(effect, deps) {
       dispatch({ type: "notice", message: `Orchestrator model set to ${effect.modelId}.` });
       return;
     case "setPlanner": {
-      const meta = import_core19.ALL_PROVIDERS[effect.provider];
+      const meta = import_core21.ALL_PROVIDERS[effect.provider];
       if (!meta) throw new Error(`Unknown planner: ${effect.provider}`);
       const env = { AI_PROVIDER: effect.provider };
       const settings = await api.updateSettings({ env });
@@ -6417,7 +6513,7 @@ async function perform(effect, deps) {
       });
       dispatch({
         type: "notice",
-        message: `${(0, import_core19.isCliProvider)(effect.provider) ? `Planning with ${meta.label} \u2014 no API key needed.` : `Planner set to ${meta.label}.`} ${plannerModelNotice(recall2)}`
+        message: `${(0, import_core21.isCliProvider)(effect.provider) ? `Planning with ${meta.label} \u2014 no API key needed.` : `Planner set to ${meta.label}.`} ${plannerModelNotice(recall2)}`
       });
       await loadModels(deps);
       return;
@@ -6429,7 +6525,7 @@ async function perform(effect, deps) {
       dispatch({ type: "notice", message: `Planner effort set to ${effect.effort || "the runner default"}.` });
       return;
     case "setApiKey": {
-      const meta = import_core19.ALL_PROVIDERS[effect.provider];
+      const meta = import_core21.ALL_PROVIDERS[effect.provider];
       if (!meta) throw new Error(`Unknown provider: ${effect.provider}`);
       await api.updateSettings({ env: { [meta.apiKeyEnvVar]: effect.key } });
       deps.setEnvVar(meta.apiKeyEnvVar, effect.key);
@@ -6460,6 +6556,11 @@ async function perform(effect, deps) {
       dispatch({ type: "notice", message: effect.message });
       return;
     }
+    case "setMaxParallel":
+      await api.updateSettings({ env: { ORDEWELL_MAX_PARALLEL: String(effect.limit) } });
+      deps.setEnvVar("ORDEWELL_MAX_PARALLEL", String(effect.limit));
+      dispatch({ type: "notice", message: `Up to ${effect.limit} AI task${effect.limit === 1 ? "" : "s"} now run at once.` });
+      return;
     case "setAutonomous":
       deps.setEnvVar("ORDEWELL_AUTONOMOUS_MODE", String(effect.enabled));
       dispatch({ type: "notice", message: `Autonomous mode ${effect.enabled ? "on" : "off"}.` });
@@ -6590,7 +6691,7 @@ function osc52(text) {
 function copySelection(deps, text) {
   if (!text) return;
   const lines = text.split("\n").length;
-  const command = (0, import_core19.clipboardCopyCommand)(deps.hasBin);
+  const command = (0, import_core21.clipboardCopyCommand)(deps.hasBin);
   if (command) {
     try {
       (deps.pipeToClipboard ?? pipeToClipboardDefault)(command, text);
@@ -6727,12 +6828,12 @@ function onExecutionEvent(dispatch, event, sessionId) {
       return;
     }
     case "task_started":
-      dispatch({ type: "researchStep", summary: `${event.title ?? event.taskId} \xB7 ${event.runner ?? ""}`.trim(), sessionId });
+      dispatch({ type: "taskStarted", taskId: String(event.taskId), title: String(event.title ?? event.taskId), runner: event.runner, sessionId });
       return;
     // The extension shows these in its checkpoint panel; here they are
     // transcript lines, which is the TUI's equivalent surface.
     case "checkpoint":
-      dispatch({ type: "notice", message: `\xB7 Checkpoint \u2014 ${event.taskTitle}: ${(0, import_core19.truncateCheckpointSummary)(event.summary)}` });
+      dispatch({ type: "notice", message: `\xB7 Checkpoint \u2014 ${event.taskTitle}: ${(0, import_core21.truncateCheckpointSummary)(event.summary)}` });
       return;
     case "approval_decided":
       dispatch({ type: "notice", message: describeApprovalDecision2(event) });
@@ -7116,7 +7217,7 @@ async function handleTui(subArgs) {
   }
   const workspace = flag(subArgs, "--workspace") || process.cwd();
   try {
-    (0, import_core20.assertWorkspaceExists)(workspace);
+    (0, import_core22.assertWorkspaceExists)(workspace);
   } catch {
     console.error(
       `Workspace "${workspace}" does not exist.
@@ -7125,12 +7226,12 @@ cd into a directory that exists, or pass --workspace <path> naming one that does
     );
     process.exit(1);
   }
-  registerSkillCommands((0, import_core20.createSkillsService)(workspace).listSkills());
+  registerSkillCommands((0, import_core22.createSkillsService)(workspace).listSkills());
   const explicitPort = flag(subArgs, "--port") || process.env.ORDEWELL_PORT;
   const targetPort = explicitPort ? resolvePort(subArgs) : await findFreePort();
   const { port, owned: ownedAtLaunch } = await ensureDaemonOwned(targetPort, { detached: false });
   let owned = ownedAtLaunch;
-  const api = new ApiClient(port);
+  const api = new ApiClient(port, workspace);
   const conversationQueue = new ConversationQueue();
   let terminal;
   const autoMode = process.env.ORDEWELL_AUTONOMOUS_MODE;
@@ -7144,7 +7245,7 @@ cd into a directory that exists, or pass --workspace <path> naming one that does
       conversationQueue,
       port,
       dispatch: (action) => app.dispatch(action),
-      newSessionId: () => (0, import_core20.mintSessionId)(),
+      newSessionId: () => (0, import_core22.mintSessionId)(),
       setEnvVar: (key, value) => {
         writeEnvVar(findEnvFile(), key, value);
         process.env[key] = value;
@@ -7161,7 +7262,16 @@ cd into a directory that exists, or pass --workspace <path> naming one that does
       },
       exit: () => shutdown(0)
     }),
-    onExit: () => shutdown(0)
+    onExit: () => shutdown(0),
+    // The same pointer `ordewell plan` leaves, so `ordewell handoff`,
+    // `terminal <n>` and the other one-shot commands act on the session this
+    // TUI is showing instead of saying there is none.
+    onSessionChange: (sessionId, state) => {
+      try {
+        saveLastSession(sessionId, state.goal, state.runners.filter((r) => r.enabled).map((r) => r.id), workspace);
+      } catch {
+      }
+    }
   });
   terminal = openTerminal({
     mouse: mouseCapture,
@@ -7207,6 +7317,7 @@ var COMMANDS = {
   model: handleModel,
   planner: handlePlanner,
   "planner-effort": handlePlannerEffort,
+  parallel: handleParallel,
   key: handleKey,
   runners: handleRunners,
   auto: handleAuto,
@@ -7253,10 +7364,12 @@ function cliVersion() {
 }
 
 // src/main.ts
+var TUI_FLAGS = /* @__PURE__ */ new Set(["--workspace", "--port"]);
 async function main() {
-  (0, import_core21.migrateOldConfigDir)();
+  (0, import_core23.migrateOldConfigDir)();
   loadEnvFile();
   const argv = process.argv.slice(2);
+  if (TUI_FLAGS.has(argv[0] ?? "")) argv.unshift("tui");
   const command = argv[0] ?? (process.stdin.isTTY ? "tui" : "--help");
   if (command === "--help" || command === "-h") {
     printHelp();
@@ -7266,6 +7379,11 @@ async function main() {
     console.log(cliVersion());
     return;
   }
+  ApiClient.defaultWorkspace = flag(argv, "--workspace") || void 0;
+  const sessionAt = argv.indexOf("--session-id");
+  if (sessionAt > 0 && argv[sessionAt + 1]) {
+    argv[sessionAt + 1] = expandSessionId(argv[sessionAt + 1], flag(argv, "--workspace") || process.cwd());
+  }
   const handler = COMMANDS[command];
   if (!handler) {
     console.error(`Unknown command: ${command}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ordewell/cli",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Ordewell CLI and TUI — plan, run and verify coding-agent tasks from the terminal.",
   "license": "Apache-2.0",
   "author": "Alessandro Costanzo Ciano",
@@ -32,7 +32,7 @@
   },
   "main": "./dist/main.js",
   "bin": {
-    "ordewell": "./dist/main.js"
+    "ordewell": "dist/main.js"
   },
   "files": [
     "dist",
@@ -48,8 +48,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ordewell/core": "^0.5.1",
-    "@ordewell/web": "^0.5.1",
+    "@ordewell/core": "^0.5.3",
+    "@ordewell/web": "^0.5.3",
     "string-width": "^7.2.0",
     "ws": "^8.18.0"
   },