taskplane 0.2.9 → 0.3.0

package/README.md

@@ -19,7 +19,24 @@ Taskplane turns your coding project into an AI-managed task board. You define ta
 
 ## Install
 
-Taskplane is a [pi package](https://github.com/badlogic/pi-mono). You need [Node.js](https://nodejs.org/) ≥ 20 and [pi](https://github.com/badlogic/pi-mono) installed first.
+Taskplane is a [pi package](https://github.com/badlogic/pi-mono). You need [Node.js](https://nodejs.org/) ≥ 22 and [pi](https://github.com/badlogic/pi-mono) installed first.
+
+### Prerequisites
+
+| Dependency | Required | Notes |
+|-----------|----------|-------|
+| [Node.js](https://nodejs.org/) ≥ 22 | Yes | Runtime |
+| [pi](https://github.com/badlogic/pi-mono) | Yes | Agent framework |
+| [Git](https://git-scm.com/) | Yes | Version control, worktrees |
+| **tmux** | **Strongly recommended** | Required for `/orch` parallel execution |
+
+**tmux** is needed for the orchestrator to spawn parallel worker sessions. Without it, `/orch` will not work. On Windows, Taskplane can install it for you:
+
+```bash
+taskplane install-tmux
+```
+
+On macOS: `brew install tmux` · On Linux: `sudo apt install tmux` (or your distro's package manager)
 
 ### Option A: Global Install (all projects)
 
@@ -138,6 +155,7 @@ Orchestrator lanes execute tasks through task-runner under the hood, so `/task`
 |---------|-------------|
 | `taskplane init` | Scaffold project config (interactive or `--preset`) |
 | `taskplane doctor` | Validate installation and config |
+| `taskplane install-tmux` | Install or upgrade tmux for Git Bash (Windows) |
 | `taskplane version` | Show version info |
 | `taskplane dashboard` | Launch the web dashboard |
 | `taskplane uninstall` | Remove Taskplane project files and optionally uninstall package (`--package`) |

package/bin/taskplane.mjs

@@ -10,6 +10,18 @@
  * and auto-discovered by pi. This CLI is for everything else.
  */
 
+// ─── Node.js version gate (fail fast) ───────────────────────────────────────
+
+const MIN_NODE_MAJOR = 22;
+const nodeMajor = parseInt(process.versions.node.split(".")[0], 10);
+if (nodeMajor < MIN_NODE_MAJOR) {
+	console.error(
+		`\x1b[31m❌ Taskplane requires Node.js >= ${MIN_NODE_MAJOR}.0.0 (found ${process.versions.node}).\x1b[0m\n` +
+		`   Upgrade: https://nodejs.org/\n`
+	);
+	process.exit(1);
+}
+
 import fs from "node:fs";
 import path from "node:path";
 import readline from "node:readline";
@@ -1249,10 +1261,10 @@ function cmdDoctor() {
 	const checks = [
 		{ label: "pi installed", check: () => commandExists("pi"), detail: () => getVersion("pi") },
 		{
-			label: "Node.js >= 20.0.0",
+			label: "Node.js >= 22.0.0",
 			check: () => {
 				const v = process.versions.node;
-				return parseInt(v.split(".")[0]) >= 20;
+				return parseInt(v.split(".")[0]) >= 22;
 			},
 			detail: () => `v${process.versions.node}`,
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskplane",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "AI agent orchestration for pi — parallel task execution with checkpoint discipline",
   "keywords": [
     "pi-package",
@@ -24,7 +24,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "files": [
     "bin/",