@ordewell/cli 0.4.0 → 0.4.3

package/README.md

@@ -2,13 +2,21 @@
 
 The command line and terminal UI for **[Ordewell](https://ordewell.ai)** — turn one
 goal into an ordered plan of coding-agent tasks, each with its own runner, model
-and mode, then execute it and verify the result from evidence.
+and mode, then execute and verify it.
 
 ```bash
-npm install -g @ordewell/cli
+npm install -g @ordewell/cli              # or: npm install -g ordewell
 
-export OPENROUTER_API_KEY="sk-or-..."     # or GEMINI_API_KEY — auto-detected
+export OPENROUTER_API_KEY="sk-or-..."     # any one provider key — auto-detected
 
+ordewell                                  # the TUI
+```
+
+Bare `ordewell` opens the full-screen terminal UI. On first run it tells you
+what it still needs — a planner and at least one runner — both settable from
+inside it with `/planner`, `/runners` and `/key`. Or drive it as a CLI:
+
+```bash
 ordewell plan --goal "Add rate limiting to the public API"
 ordewell run
 ```
@@ -32,8 +40,9 @@ ordewell --help     # every slash command is also a subcommand
 
 ## Requirements
 
-Node.js ≥ 20. Linux, macOS and Windows are all supported; the TUI is
-tmux-backed, so on Windows run it under WSL.
+Node.js ≥ 20, and **tmux** for the TUI on every platform — it is what backs each
+task's live terminal (`apt install tmux`, `brew install tmux`). Linux, macOS and
+Windows are all supported; on Windows, run the TUI under WSL.
 
 Installing this package also installs `@ordewell/web`, the local API server the
 CLI and TUI drive over `127.0.0.1`. It starts on demand — you don't need to run

package/dist/main.js

@@ -133,6 +133,7 @@ Other:
   ordewell setup                  Interactive first-run setup wizard
   ordewell plugins list|install|remove|create   Manage runner plugins
   ordewell --help               Show this help
+  ordewell --version            Print the installed version (alias: version, -v)
 
 TUI options:
   --workspace /path   Workspace directory (default: cwd)
@@ -3480,6 +3481,9 @@ function pickerItemsFor(state, action) {
       detail: [m.provider, m.pricing].filter(Boolean).join(" \xB7 ") || void 0
     }));
   }
+  if (action.kind === "set-runners") {
+    return state.runners.map((runner) => ({ id: runner.id, label: runner.name }));
+  }
   if (action.kind === "set-task-runner") {
     const task = state.tasks.find((candidate) => candidate.id === action.taskId);
     if (!task) return [];
@@ -3769,6 +3773,16 @@ function choose(state, picker2, item) {
   if (picker2.action.kind === "set-allowlist") {
     return step(closed, [{ type: "setAllowlist", runner: picker2.action.runner, modelIds: picker2.chosen }]);
   }
+  if (picker2.action.kind === "set-runners") {
+    const changes = state.runners.filter((runner) => runner.enabled !== picker2.chosen.includes(runner.id)).map((runner) => ({ runner: runner.id, enabled: !runner.enabled }));
+    if (changes.length === 0) return step(closed);
+    const names = state.runners.filter((r) => picker2.chosen.includes(r.id)).map((r) => r.name);
+    return step(closed, [{
+      type: "setRunners",
+      changes,
+      message: names.length > 0 ? `Runners enabled: ${names.join(", ")}.` : "No runners enabled \u2014 the planner has nothing to assign work to."
+    }]);
+  }
   if (picker2.action.kind === "set-task-deps") {
     const taskId = picker2.action.taskId;
     const task = state.tasks.find((candidate) => candidate.id === taskId);
@@ -3801,14 +3815,6 @@ function choose(state, picker2, item) {
       return step(closed, [{ type: "deleteSession", sessionId: item.id }]);
     case "set-key":
       return step({ ...state, overlay: keyPrompt(item.id) });
-    case "toggle-runner": {
-      const enabled = !(state.runners.find((r) => r.id === item.id)?.enabled ?? item.selected ?? false);
-      const items = picker2.items.map((i) => i.id === item.id ? { ...i, selected: enabled, detail: enabled ? "enabled" : "disabled" } : i);
-      return step(
-        { ...state, overlay: { kind: "picker", picker: { ...picker2, items } } },
-        [{ type: "setRunnerEnabled", runner: item.id, enabled }]
-      );
-    }
     case "choose-allowlist-runner": {
       const action = { kind: "set-allowlist", runner: item.id };
       const items = pickerItemsFor(state, action);
@@ -3821,7 +3827,7 @@ function choose(state, picker2, item) {
           kind: "picker",
           picker: {
             title: `Models allowed for ${item.label}`,
-            hint: "space toggles \xB7 enter confirms \xB7 empty selection lifts the restriction",
+            hint: "An empty selection lifts the restriction.",
             items,
             filter: "",
             index: 0,
@@ -4189,17 +4195,14 @@ function runners(state, args) {
     if (enabled === null) return fail2(state, "Usage: /runners [<runner-id> on|off]");
     return step(state, [{ type: "setRunnerEnabled", runner, enabled }]);
   }
-  const items = state.runners.map((r) => ({
-    id: r.id,
-    label: r.name,
-    detail: r.enabled ? "enabled" : "disabled",
-    selected: r.enabled
-  }));
+  const action = { kind: "set-runners" };
+  const items = pickerItemsFor(state, action);
   return step({ ...state, overlay: {
     kind: "picker",
-    picker: picker("Toggle runner", items, { kind: "toggle-runner" }, {
-      hint: "Changes apply immediately.",
-      footer: "enter toggles \xB7 esc closes \xB7 type to filter"
+    picker: picker("Runners", items, action, {
+      hint: "Enabled runners are the ones the planner may assign work to.",
+      multi: true,
+      chosen: state.runners.filter((r) => r.enabled).map((r) => r.id)
     })
   } });
 }
@@ -4245,7 +4248,7 @@ function openTaskDepsPicker(state, task) {
     overlay: {
       kind: "picker",
       picker: picker(`Depends on \xB7 #${task.order} ${task.title}`, items, action, {
-        hint: "Only tasks earlier in the plan can be dependencies. Space toggles, enter saves.",
+        hint: "Only tasks earlier in the plan can be dependencies.",
         multi: true,
         chosen: task.dependencies.filter((id) => items.some((i) => i.id === id))
       })
@@ -4879,14 +4882,14 @@ function renderPicker(picker2, rows, cols) {
   const start = Math.max(0, Math.min(picker2.index - Math.floor(room / 2), items.length - room));
   for (const [offset, item] of items.slice(start, start + room).entries()) {
     const active = start + offset === picker2.index;
-    const mark = picker2.multi ? picker2.chosen.includes(item.id) ? style.green("[\u2713]") : style.grey("[ ]") : item.selected ? style.green("\u25CF ") : "  ";
+    const mark = picker2.multi ? picker2.chosen.includes(item.id) ? style.green("[\u2713]") : style.grey("[ ]") : item.selected ? style.green("\u25CF") : " ";
     const caret = active ? style.cyan("\u276F") : " ";
     const label = truncate(item.label, Math.max(1, cols - 12));
     const detail = item.detail ? style.grey(` \u2014 ${item.detail}`) : "";
-    const line = item.disabled ? `${caret}${mark} ${style.grey(label)}${detail}` : `${caret}${mark} ${active ? style.bold(label) : label}${detail}`;
+    const line = item.disabled ? `${caret} ${mark} ${style.grey(label)}${detail}` : `${caret} ${mark} ${active ? style.bold(label) : label}${detail}`;
     body.push(truncate(line, cols - 2));
   }
-  body.push("", style.grey(picker2.footer ?? (picker2.multi ? "space toggles \xB7 enter confirms \xB7 esc cancels" : "enter selects \xB7 esc cancels \xB7 type to filter")));
+  body.push("", style.grey(picker2.multi ? "space toggles \xB7 enter confirms \xB7 esc cancels \xB7 type to filter" : "enter selects \xB7 esc cancels \xB7 type to filter"));
   return frame(picker2.title, body, rows, cols);
 }
 var CATEGORY_TITLE = {
@@ -5176,6 +5179,14 @@ async function perform(effect, deps) {
       await loadRunners(deps);
       dispatch({ type: "notice", message: `${effect.runner} ${effect.enabled ? "enabled" : "disabled"}.` });
       return;
+    case "setRunners": {
+      for (const change of effect.changes) {
+        await api.setRunnerEnabled(change.runner, change.enabled);
+      }
+      await loadRunners(deps);
+      dispatch({ type: "notice", message: effect.message });
+      return;
+    }
     case "setAutonomous":
       deps.setEnvVar("ORDEWELL_AUTONOMOUS_MODE", String(effect.enabled));
       dispatch({ type: "notice", message: `Autonomous mode ${effect.enabled ? "on" : "off"}.` });
@@ -5694,6 +5705,19 @@ var COMMANDS = {
   tui: handleTui
 };
 
+// src/version.ts
+var import_fs7 = require("fs");
+var import_path5 = require("path");
+function cliVersion() {
+  try {
+    const pkg = JSON.parse((0, import_fs7.readFileSync)((0, import_path5.join)(__dirname, "..", "package.json"), "utf8"));
+    const version = pkg.version;
+    return typeof version === "string" && version ? version : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
 // src/main.ts
 async function main() {
   loadEnvFile();
@@ -5703,6 +5727,10 @@ async function main() {
     printHelp();
     return;
   }
+  if (command === "--version" || command === "-v" || command === "version") {
+    console.log(cliVersion());
+    return;
+  }
   const handler = COMMANDS[command];
   if (!handler) {
     console.error(`Unknown command: ${command}`);

package/package.json

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