taskplane 0.24.30 → 0.25.0

package/README.md

@@ -1,35 +1,47 @@
 # Taskplane
 
-Multi-agent AI orchestration for [pi](https://github.com/badlogic/pi-mono) — parallel task execution with checkpoint discipline, fresh-context worker loops, cross-model reviews, and automated merges.
+Multi-agent AI orchestration for coding with [pi](https://github.com/badlogic/pi-mono) — parallel task execution, mono- and poly-repo support, fresh-context worker loops, cross-model reviews, automated merges and a killer dashboard! 
 
-> **Status:** Experimental / Early — APIs and config formats may change between releases.
+> **Status:** Initial release.
 
 ## What It Does
 
-### STEP 1: Create the tasks
-Taskplane turns your coding project into an AI-managed task orchestration system. You simply ask your agent to create tasks using the built-in "create-taskplane-tasks" skill. This skill provides an opinionated task definition template designed to drive successful coding outcomes. Tasks define both the prompt.md and the status.md files that together act as the persistent memory store that allows AI coding agents to survive context resets and succeed with very long running tasks that would typically exhaust an agent's context window.
+Taskplane turns ideas into high-quality code using a proven process of:
 
-### STEP 2: Run batches of tasks
-The system works out the dependancy map for the entire batch of tasks then orchestrates them in waves, with appropriate parallelization and serialization. 
+have an idea >> create a spec >> create tasks >> orchestrate tasks >> evaluate the outcome
 
-The taskplane dashboard runs on a local port on your system and gives you elegant visibility into everything that's going on (a stark improvement over TUI-based dashboards).
+### Taskplane has:
+- A skill for creating tasks that the Taskplane orchestrator can run
+- PROMPT.md/STATUS.md task definition for persistent memory store
+- Support for both monorepo and polyrepo projects
+- Complete parallelized worktree isolation with dependency graphing and segment-level repo isolation
+- 4 agent types: supervisor, worker, reviewer, and merger
+- A deterministic orchestration engine to drive repeatable positive agent outcomes at scale
+- A simple file-based mail system so agents can communicate with each other
+- A killer locally-run web-based dashboard so you can see everything that's going on
 
 <img src="docs/images/orchrun-wave2of4-2lanes-withstatus.png" alt="image of taskplane dashboard" width="50%">
 
+### STEP 1: Create the tasks
+Taskplane turns your coding project into an AI-managed task orchestration system. You simply ask your agent to create tasks using the built-in "create-taskplane-tasks" skill. This skill provides an opinionated task definition template designed to drive successful coding outcomes. Tasks define both the prompt.md and the status.md files that together act as the persistent memory store that allows AI coding agents to survive context resets and succeed with very long running tasks that would typically exhaust an agent's context window.
+
+### STEP 2: Run batches of tasks
+Taskplane works out the dependency map for an entire batch of tasks then orchestrates them in waves, lanes, and tasks with appropriate parallelization and serialization. Taskplane can do this for both monorepo and polyrepo projects. For polyrepo projects, Taskplane additionally subdivides tasks into repo-aligned segments and uses a segmentation dependency map (DAG) to manage proper repo/worktree isolation and allow for dynamic segment expansion so worker agents can ask the supervisor agent to add additional segments to the dependency map in real time if required.
+
 ### Key Features
 
 - **Task Orchestrator** — Parallel multi-task execution using git worktrees for full filesystem isolation. Dependency-aware wave scheduling. Automated merges into a dedicated orch branch — your working branch stays stable until you choose to integrate.
-- **Persistent Worker Context** — Workers handle all steps in a single context, auto-detecting the model's context window (1M for Claude 4.6 Opus, 200K for Bedrock). Only iterates on context overflow. Dramatic reduction in spawn count and token cost.
-- **Worker-Driven Inline Reviews** — Workers invoke a `review_step` tool at step boundaries. Reviewer agents spawn in tmux sessions with full telemetry. REVISE feedback is addressed inline without losing context.
+- **Persistent Worker Context** — Workers handle all steps in a single context, auto-detecting the model's context window. Only iterates on context overflow. Dramatic reduction in spawn count and token cost.
+- **Worker-Driven Inline Reviews** — Workers invoke a `review_step` tool at step boundaries. Reviewer agents spawn with full telemetry. REVISE feedback is addressed inline without losing context.
 - **Supervisor Agent** — Conversational supervisor monitors batch progress, handles failures, and can invoke orchestrator commands autonomously (resume, integrate, pause, abort).
 - **Web Dashboard** — Live browser-based monitoring via `taskplane dashboard`. SSE streaming, lane/task progress, reviewer activity, merge telemetry, batch history.
 - **Structured Tasks** — PROMPT.md defines the mission, steps, and constraints. STATUS.md tracks progress. Agents follow the plan, not vibes.
 - **Checkpoint Discipline** — Step boundary commits ensure work is never lost, even if a worker crashes mid-task.
 - **Cross-Model Review** — Reviewer agent uses a different model than the worker agent (highly recommended, not enforced). Independent quality gate before merge.
 
-## Install
+## Installation
 
-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.
+Taskplane is a pi package. You need Node.js 22+, pi and Git installed first.
 
 ### Prerequisites
 
@@ -38,51 +50,31 @@ Taskplane is a [pi package](https://github.com/badlogic/pi-mono). You need [Node
 | [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)
+### Option A: Global Install (all projects - recommended)
 
 ```bash
 pi install npm:taskplane
 ```
 
-### Option B: Project-Local Install (recommended for teams)
+### Option B: Single Project-Local Install
 
 ```bash
 cd my-project
 pi install -l npm:taskplane
 ```
 
-Then scaffold your project:
-
-```bash
-taskplane init
-```
-
-Verify the installation:
-
-```bash
-taskplane doctor
-```
-
 ## Quickstart
 
-### 1. Initialize a project
+### 1. Initialize a project (scaffolds settings)
 
 ```bash
 cd my-project
-taskplane init --preset full
+taskplane init
 ```
+You'll answer a few questions. You can usually just accept the defaults. 
 
-This creates config files in `.pi/`, agent prompts, two example tasks, and adds `.gitignore` entries for runtime artifacts. On first install, init bootstraps global preferences at `~/.pi/agent/taskplane/preferences.json` with thinking defaults set to `high` for worker/reviewer/merger. Interactive init then prompts for worker/reviewer/merger model + thinking defaults (`inherit`, `off`, `minimal`, `low`, `medium`, `high`, `xhigh`). If 2+ providers are available from `pi --list-models`, init recommends cross-provider reviewer/merger selections. Init auto-detects whether you're in a single repo or a multi-repo workspace. See the [install tutorial](docs/tutorials/install.md) for workspace mode and other scenarios.
+This creates config files in `.pi/`, agent prompts, two example tasks, and adds `.gitignore` entries for runtime artifacts. On first install, init bootstraps global preferences at `~/.pi/agent/taskplane/preferences.json` with thinking defaults set to `high` for worker & reviewer, and off for merger. Interactive init then prompts for worker/reviewer/merger model + thinking defaults (`inherit`, `off`, `minimal`, `low`, `medium`, `high`, `xhigh`). If 2+ providers are available from `pi --list-models`, init recommends cross-provider reviewer/merger selections. Init auto-detects whether you're in a single repo or a multi-repo workspace. See the [install tutorial](docs/tutorials/install.md) for workspace mode and other scenarios.
 
 Want to reuse model/thinking picks across projects? Run `taskplane config --save-as-defaults` in an initialized project.
 
@@ -94,7 +86,15 @@ taskplane init --preset full --tasks-root docs/task-management
 
 When `--tasks-root` is provided, example task packets are skipped by default. Add `--include-examples` if you explicitly want examples in that folder.
 
-### 2. Launch the dashboard (recommended)
+### 2. Check your install with taskplane doctor
+
+Verify the installation and scaffolding. You should have all green checkboxes if everything was successful:
+
+```bash
+taskplane doctor
+```
+
+### 3. Launch the dashboard (recommended)
 
 In a separate terminal:
 
@@ -104,7 +104,7 @@ taskplane dashboard
 
 Opens a live web dashboard at `http://localhost:8099` with real-time batch monitoring.
 
-### 3. Run your first orchestration
+### 4. Run your first orchestration
 
 ```bash
 pi
@@ -121,7 +121,7 @@ Inside the pi session:
 
 `/orch` with no arguments is the universal entry point — it detects your project state and activates the supervisor for guided interaction (onboarding, batch planning, health checks, or retrospective). The default scaffold includes two independent example tasks, so `/orch all` gives you an immediate orchestrator + dashboard experience.
 
-### 4. Run a single task with isolation
+### 5. Run a single task with isolation
 
 For a single task with full worktree isolation, dashboard, and reviews:
 
@@ -131,18 +131,12 @@ For a single task with full worktree isolation, dashboard, and reviews:
 
 This uses the same orchestrator infrastructure as a full batch — isolated worktree, orch branch, supervisor, dashboard, inline reviews — but for just one task.
 
-> **Deprecated:** The `/task` command is deprecated and will be removed in a future major version. It does not provide worktree isolation, dashboard, or inline reviews. Use `/orch` for all workflows — including single-task execution.
-
 ## Commands
 
 ### Pi Session Commands
 
 | Command | Description |
 |---------|-------------|
-| `/task <path/to/PROMPT.md>` | ⚠️ **Deprecated.** Execute one task in the current branch/worktree. Use `/orch` instead. |
-| `/task-status` | ⚠️ **Deprecated.** Show current task progress. Use `/orch-status` or dashboard. |
-| `/task-pause` | ⚠️ **Deprecated.** Pause after current worker iteration finishes. Use `/orch-pause`. |
-| `/task-resume` | ⚠️ **Deprecated.** Resume a paused task. Use `/orch-resume`. |
 | `/orch [<areas\|paths\|all>]` | No args: detect state & guide (onboarding, batch planning, etc.); with args: execute tasks via isolated worktrees |
 | `/orch-plan <areas\|paths\|all>` | Preview execution plan without running |
 | `/orch-status` | Show batch progress |
@@ -176,8 +170,7 @@ This uses the same orchestrator infrastructure as a full batch — isolated work
        │          │          │
   ┌────▼────┐ ┌──▼─────┐ ┌──▼─────┐
   │ Lane 1  │ │ Lane 2 │ │ Lane 3 │    ← Git worktrees
-  │ /task   │ │ /task  │ │ /task  │       (isolated)
-  │ Worker  │ │ Worker │ │ Worker │
+  │ Worker  │ │ Worker │ │ Worker │       (isolated)
   │ Review  │ │ Review │ │ Review │
   └────┬────┘ └──┬─────┘ └──┬─────┘
        │         │          │

package/bin/taskplane.mjs

@@ -316,93 +316,6 @@ function detectStack(projectRoot) {
 
 // ─── YAML Generation ────────────────────────────────────────────────────────
 
-function generateTaskRunnerYaml(vars) {
-	return `# ═══════════════════════════════════════════════════════════════════════
-# Task Runner Configuration — ${vars.project_name}
-# ═══════════════════════════════════════════════════════════════════════
-#
-# This file configures the /task command (task-runner extension).
-# Edit freely — this file is owned by you, not the package.
-
-# ── Task Areas ────────────────────────────────────────────────────────
-# Define where tasks live. Each area has a folder path, ID prefix, and
-# a CONTEXT.md file that provides domain context to agents.
-
-task_areas:
-  ${vars.default_area}:
-    path: "${vars.tasks_root}"
-    prefix: "${vars.default_prefix}"
-    context: "${vars.tasks_root}/CONTEXT.md"
-
-# ── Reference Docs ────────────────────────────────────────────────────
-# Docs that tasks can reference in their "Context to Read First" section.
-# Add your project's architecture docs, API specs, etc.
-
-reference_docs: {}
-
-# ── Standards ─────────────────────────────────────────────────────────
-# Coding standards and rules. Agents follow these during implementation.
-
-standards: {}
-
-# ── Testing ───────────────────────────────────────────────────────────
-# Commands that agents run to verify their work.
-
-testing:
-  commands:${vars.test_cmd ? `\n    unit: "${vars.test_cmd}"` : ""}${vars.build_cmd ? `\n    build: "${vars.build_cmd}"` : ""}
-`;
-}
-
-function generateOrchestratorYaml(vars) {
-	return `# ═══════════════════════════════════════════════════════════════════════
-# Parallel Task Orchestrator Configuration — ${vars.project_name}
-# ═══════════════════════════════════════════════════════════════════════
-#
-# This file configures the /orch commands (task-orchestrator extension).
-# Edit freely — this file is owned by you, not the package.
-
-orchestrator:
-  max_lanes: ${vars.max_lanes}
-  worktree_location: "subdirectory"
-  worktree_prefix: "${vars.worktree_prefix}"
-  batch_id_format: "timestamp"
-  spawn_mode: "${vars.spawn_mode}"
-  session_prefix: "${vars.session_prefix}"
-
-dependencies:
-  source: "prompt"
-  cache: true
-
-assignment:
-  strategy: "affinity-first"
-  size_weights:
-    S: 1
-    M: 2
-    L: 4
-
-pre_warm:
-  auto_detect: false
-  commands: {}
-  always: []
-
-merge:
-  model: ""
-  tools: "read,write,edit,bash,grep,find,ls"
-  verify: []
-  order: "fewest-files-first"
-
-failure:
-  on_task_failure: "skip-dependents"
-  on_merge_failure: "pause"
-  stall_timeout: 30
-  max_worker_minutes: 30
-  abort_grace_period: 60
-
-monitoring:
-  poll_interval: 5
-`;
-}
-
 function buildTestingCommands(vars) {
 	const commands = {};
 	if (vars.test_cmd) commands.unit = vars.test_cmd;
@@ -964,6 +877,27 @@ async function autoCommitTaskFiles(projectRoot, tasksRoot) {
 }
 
 function discoverTaskAreaMetadata(projectRoot, configRoot = projectRoot, configPrefix = ".pi") {
+	// Prefer taskplane-config.json; fall back to task-runner.yaml for legacy projects
+	const jsonPath = path.join(configRoot, configPrefix, "taskplane-config.json");
+	if (fs.existsSync(jsonPath)) {
+		try {
+			const config = JSON.parse(fs.readFileSync(jsonPath, "utf8"));
+			const areas = config?.taskRunner?.taskAreas;
+			if (areas && typeof areas === "object" && !Array.isArray(areas)) {
+				const paths = new Set();
+				const contexts = new Set();
+				const areaRepoIds = {};
+				for (const [areaName, area] of Object.entries(areas)) {
+					if (!area || typeof area !== "object") continue;
+					if (typeof area.path === "string" && area.path) paths.add(area.path);
+					if (typeof area.context === "string" && area.context) contexts.add(area.context);
+					if (typeof area.repoId === "string" && area.repoId) areaRepoIds[areaName] = area.repoId;
+				}
+				return { paths: [...paths], contexts: [...contexts], areaRepoIds };
+			}
+		} catch { /* fall through to YAML */ }
+	}
+
 	const runnerPath = path.join(configRoot, configPrefix, "task-runner.yaml");
 	if (!fs.existsSync(runnerPath)) return { paths: [], contexts: [], areaRepoIds: {} };
 
@@ -1132,9 +1066,10 @@ async function cmdUninstall(args) {
 	console.log(`\n${c.bold}Taskplane Uninstall${c.reset}\n`);
 
 	const managedFiles = [
+		".pi/taskplane-config.json",
+		".pi/taskplane.json",
 		".pi/task-runner.yaml",
 		".pi/task-orchestrator.yaml",
-		".pi/taskplane.json",
 		".pi/agents/task-worker.md",
 		".pi/agents/task-reviewer.md",
 		".pi/agents/task-merger.md",
@@ -1194,7 +1129,7 @@ async function cmdUninstall(args) {
 		for (const f of sidecarsToDelete) console.log(`  - remove ${f.rel}`);
 		for (const d of taskDirsToDelete) console.log(`  - remove dir ${d.rel}`);
 		if (removeTasks && taskDirsToDelete.length === 0) {
-			console.log(`  ${c.dim}No task area directories found from .pi/task-runner.yaml.${c.reset}`);
+			console.log(`  ${c.dim}No task area directories found in config.${c.reset}`);
 		}
 		if (!removeTasks) {
 			console.log(`  ${c.dim}Task directories are preserved by default (use --remove-tasks to delete them).${c.reset}`);
@@ -1637,6 +1572,10 @@ async function cmdInit(args) {
 	const tasksRootIdx = args.indexOf("--tasks-root");
 	const tasksRootRaw = tasksRootIdx !== -1 ? args[tasksRootIdx + 1] : null;
 
+	if (preset && preset !== "minimal" && preset !== "full") {
+		die(`Unknown preset: "${preset}". Valid presets are: minimal, full`);
+	}
+
 	if (noExamplesFlag && includeExamples) {
 		die("Choose either --no-examples or --include-examples, not both.");
 	}
@@ -1670,7 +1609,7 @@ async function cmdInit(args) {
 
 	// ── Mode auto-detection ──────────────────────────────────────
 	const detection = detectInitMode(projectRoot);
-	const isPreset = preset === "minimal" || preset === "full" || preset === "runner-only";
+	const isPreset = preset === "minimal" || preset === "full";
 
 	// Error path: not a git repo and no git repos found
 	if (detection.mode === "error") {
@@ -1911,7 +1850,7 @@ async function cmdInit(args) {
 
 		// ── Gather config values (workspace mode) ───────────────────
 		let vars;
-		if (preset === "minimal" || preset === "full" || preset === "runner-only") {
+		if (preset === "minimal" || preset === "full") {
 			vars = getPresetVars(preset, projectRoot, tasksRootOverride);
 			console.log(`  Using preset: ${c.cyan}${preset}${c.reset}`);
 			if (tasksRootOverride) {
@@ -1955,22 +1894,6 @@ async function cmdInit(args) {
 			);
 		}
 
-		// Task runner config
-		writeFile(
-			path.join(taskplaneDir, "task-runner.yaml"),
-			generateTaskRunnerYaml(vars),
-			{ skipIfExists, label: `${configRepoName}/.taskplane/task-runner.yaml` }
-		);
-
-		// Orchestrator config (skip for runner-only preset)
-		if (preset !== "runner-only") {
-			writeFile(
-				path.join(taskplaneDir, "task-orchestrator.yaml"),
-				generateOrchestratorYaml(vars),
-				{ skipIfExists, label: `${configRepoName}/.taskplane/task-orchestrator.yaml` }
-			);
-		}
-
 		// Project config JSON (taskplane-config.json)
 		const projectConfig = generateProjectConfig(vars, initAgentConfig);
 		writeFile(
@@ -2109,10 +2032,8 @@ async function cmdInit(args) {
 		console.log(`     git push && ${c.dim}[create PR / merge to default branch]${c.reset}\n`);
 		console.log(`${c.bold}Quick start:${c.reset}`);
 		console.log(`  ${c.cyan}pi${c.reset}                                             # start pi (taskplane auto-loads)`);
-		if (preset !== "runner-only") {
-			console.log(`  ${c.cyan}/orch${c.reset}                                             # start the taskplane supervisor`);
-			console.log(`  ${c.cyan}/orch all${c.reset}                                        # run all open tasks`);
-		}
+		console.log(`  ${c.cyan}/orch${c.reset}                                             # start the taskplane supervisor`);
+		console.log(`  ${c.cyan}/orch all${c.reset}                                        # run all open tasks`);
 		if (inferTaskplaneInstallScope() === "global") {
 			console.log(`  ${c.cyan}taskplane config --save-as-defaults${c.reset}             # save these agent defaults for future inits`);
 		}
@@ -2139,7 +2060,7 @@ async function cmdInit(args) {
 
 	// Gather config values
 	let vars;
-	if (preset === "minimal" || preset === "full" || preset === "runner-only") {
+	if (preset === "minimal" || preset === "full") {
 		vars = getPresetVars(preset, projectRoot, tasksRootOverride);
 		console.log(`  Using preset: ${c.cyan}${preset}${c.reset}`);
 		if (tasksRootOverride) {
@@ -2180,23 +2101,7 @@ async function cmdInit(args) {
 		);
 	}
 
-	// Task runner config
-	writeFile(
-		path.join(projectRoot, ".pi", "task-runner.yaml"),
-		generateTaskRunnerYaml(vars),
-		{ skipIfExists, label: ".pi/task-runner.yaml" }
-	);
-
-	// Orchestrator config (skip for runner-only preset)
-	if (preset !== "runner-only") {
-		writeFile(
-			path.join(projectRoot, ".pi", "task-orchestrator.yaml"),
-			generateOrchestratorYaml(vars),
-			{ skipIfExists, label: ".pi/task-orchestrator.yaml" }
-		);
-	}
-
-	// Unified project config JSON
+	// Project config JSON
 	writeFile(
 		path.join(projectRoot, ".pi", "taskplane-config.json"),
 		JSON.stringify(generateProjectConfig(vars, initAgentConfig), null, 2) + "\n",
@@ -2271,10 +2176,8 @@ async function cmdInit(args) {
 	console.log(`\n${OK} ${c.bold}Taskplane initialized!${c.reset}\n`);
 	console.log(`${c.bold}Quick start:${c.reset}`);
 	console.log(`  ${c.cyan}pi${c.reset}                                             # start pi (taskplane auto-loads)`);
-	if (preset !== "runner-only") {
-		console.log(`  ${c.cyan}/orch${c.reset}                                             # start the taskplane supervisor`);
-		console.log(`  ${c.cyan}/orch all${c.reset}                                        # run all open tasks`);
-	}
+	console.log(`  ${c.cyan}/orch${c.reset}                                             # start the taskplane supervisor`);
+	console.log(`  ${c.cyan}/orch all${c.reset}                                        # run all open tasks`);
 	if (inferTaskplaneInstallScope() === "global") {
 		console.log(`  ${c.cyan}taskplane config --save-as-defaults${c.reset}             # save these agent defaults for future inits`);
 	}
@@ -2341,10 +2244,8 @@ function printFileList(vars, noExamples, preset, exampleTemplateDirs = [], proje
 		".pi/agents/task-reviewer.md",
 		".pi/agents/task-merger.md",
 		".pi/agents/supervisor.md",
-		".pi/task-runner.yaml",
+		".pi/taskplane-config.json",
 	];
-	if (preset !== "runner-only") files.push(".pi/task-orchestrator.yaml");
-	files.push(".pi/taskplane-config.json");
 	files.push(".pi/taskplane.json");
 	files.push(`${vars.tasks_root}/CONTEXT.md`);
 	if (!noExamples) {
@@ -2380,10 +2281,8 @@ function printWorkspaceFileList(vars, noExamples, preset, exampleTemplateDirs, c
 		`${prefix}/agents/task-reviewer.md`,
 		`${prefix}/agents/task-merger.md`,
 		`${prefix}/agents/supervisor.md`,
-		`${prefix}/task-runner.yaml`,
+		`${prefix}/taskplane-config.json`,
 	];
-	if (preset !== "runner-only") files.push(`${prefix}/task-orchestrator.yaml`);
-	files.push(`${prefix}/taskplane-config.json`);
 	files.push(`${prefix}/taskplane.json`);
 	files.push(`${prefix}/workspace.json`);
 	files.push(`${configRepoName}/${vars.tasks_root}/CONTEXT.md`);
@@ -2883,15 +2782,20 @@ function cmdDoctor() {
 	// Check project config (common — both modes)
 	console.log();
 	const hasUnifiedJson = fs.existsSync(path.join(configLocation.root, configLocation.prefix, "taskplane-config.json"));
+	const hasYamlFallback = !hasUnifiedJson && (
+		fs.existsSync(path.join(configLocation.root, configLocation.prefix, "task-runner.yaml")) ||
+		fs.existsSync(path.join(configLocation.root, configLocation.prefix, "task-orchestrator.yaml"))
+	);
 	const configFiles = [
-		{ path: "taskplane-config.json", required: false, hide: false },
-		// YAML configs are legacy fallback — hide when taskplane-config.json exists
-		{ path: "task-runner.yaml", required: !hasUnifiedJson, hide: hasUnifiedJson },
-		{ path: "task-orchestrator.yaml", required: !hasUnifiedJson, hide: hasUnifiedJson },
+		// JSON is required unless legacy YAML exists as fallback
+		{ path: "taskplane-config.json", required: !hasYamlFallback, hide: false },
+		// YAML configs are legacy fallback — only shown when JSON config is missing
+		{ path: "task-runner.yaml", required: false, hide: hasUnifiedJson },
+		{ path: "task-orchestrator.yaml", required: false, hide: hasUnifiedJson },
 		{ path: "agents/task-worker.md", required: true, hide: false },
 		{ path: "agents/task-reviewer.md", required: true, hide: false },
 		{ path: "agents/task-merger.md", required: true, hide: false },
-		// supervisor.md is created by /orch; taskplane.json is created at runtime
+		// supervisor.md is optional (scaffolded by init but may be absent in older projects); taskplane.json is created at runtime
 		{ path: "agents/supervisor.md", required: false, hide: true },
 		{ path: "taskplane.json", required: false, hide: true },
 	];
@@ -2979,7 +2883,7 @@ function cmdDoctor() {
 				console.log(`  ${OK} area '${areaName}' repo_id: ${repoId}`);
 			} else {
 				console.log(`  ${FAIL} area '${areaName}' repo_id '${repoId}' does not match any workspace repo [AREA_REPO_ID_UNKNOWN]`);
-				console.log(`     ${c.dim}→ Available repos: ${knownRepoIds.join(", ")}. Fix repo_id in ${configLocation.label}/task-runner.yaml${c.reset}`);
+				console.log(`     ${c.dim}→ Available repos: ${knownRepoIds.join(", ")}. Fix repoId in ${configLocation.label}/taskplane-config.json${c.reset}`);
 				issues++;
 			}
 		}
@@ -3239,7 +3143,7 @@ ${c.bold}Commands:${c.reset}
   ${c.cyan}help${c.reset}           Show this help message
 
 ${c.bold}Init options:${c.reset}
-  --preset <name>       Use a preset: minimal, full, runner-only
+  --preset <name>       Use a preset: minimal, full
   --tasks-root <path>   Relative tasks directory to use (e.g. docs/task-management)
   --no-examples         Skip example tasks scaffolding
   --include-examples    With --tasks-root, include example tasks (default is skip)
@@ -3261,7 +3165,7 @@ ${c.bold}Uninstall options:${c.reset}
   --package-only    Only remove installed package (skip project cleanup)
   --local           Force package uninstall from project-local scope
   --global          Force package uninstall from global scope
-  --remove-tasks    Also remove task area directories from task-runner.yaml
+  --remove-tasks    Also remove task area directories
   --all             Equivalent to --package + --remove-tasks
 
 ${c.bold}Examples:${c.reset}

package/dashboard/public/app.js

@@ -180,9 +180,9 @@ function showCopyToast(text) {
 }
 
 function copySessionId(sessionName) {
+  // Retained for potential future use but no longer rendered in the UI.
   navigator.clipboard.writeText(sessionName).then(() => {
     showCopyToast(`session ${sessionName}`);
-    // Flash the button
     const btn = document.querySelector(`[data-session="${sessionName}"]`);
     if (btn) {
       btn.classList.add("copied");
@@ -455,6 +455,27 @@ function renderSummary(batch) {
   const wavePlan = batch.wavePlan || [tasks.map(t => t.taskId)]; // fallback: single wave
   const currentWaveIdx = batch.currentWaveIndex || 0;
 
+  // TP-148: Build wave segment context — for each task appearing in multiple waves,
+  // determine which segment corresponds to each wave appearance.
+  const taskWaveAppearance = new Map(); // taskId → count of appearances so far
+  const waveSegmentLabels = wavePlan.map((taskIds) => {
+    const labels = new Map(); // taskId → label string
+    for (const tid of taskIds) {
+      const task = taskMap.get(tid);
+      const segmentIds = task?.segmentIds;
+      if (!segmentIds || segmentIds.length <= 1) continue;
+      const count = (taskWaveAppearance.get(tid) || 0);
+      taskWaveAppearance.set(tid, count + 1);
+      const segId = segmentIds[count];
+      if (segId) {
+        const parsed = parseSegmentId(segId);
+        const repo = parsed ? parsed.repoId : "";
+        labels.set(tid, `${tid} (segment ${count + 1}/${segmentIds.length}: ${repo})`);
+      }
+    }
+    return labels;
+  });
+
   // Compute per-wave and overall checkbox totals
   let batchChecked = 0, batchTotal = 0;
   const waveStats = wavePlan.map((taskIds, waveIdx) => {
@@ -503,7 +524,10 @@ function renderSummary(batch) {
     const fillWidth = isDone ? 100 : fillPct;
     const segClass = isCurrent ? "wave-seg-current" : isFuture ? "wave-seg-future" : "";
 
-    barHtml += `<div class="wave-seg ${segClass}" style="width:${segWidthPct.toFixed(1)}%" title="W${ws.waveIdx + 1}: ${ws.checked}/${ws.total} checkboxes (${ws.taskIds.join(', ')})">`;
+    // TP-148: Use segment-aware labels in tooltip when available
+    const segLabels = waveSegmentLabels[ws.waveIdx] || new Map();
+    const tooltipTasks = ws.taskIds.map(tid => segLabels.get(tid) || tid).join(', ');
+    barHtml += `<div class="wave-seg ${segClass}" style="width:${segWidthPct.toFixed(1)}%" title="W${ws.waveIdx + 1}: ${ws.checked}/${ws.total} checkboxes (${tooltipTasks})">`;
     barHtml += `  <div class="wave-seg-fill ${fillClass}" style="width:${fillWidth.toFixed(1)}%"></div>`;
     barHtml += `  <span class="wave-seg-label">W${ws.waveIdx + 1}</span>`;
     barHtml += `</div>`;
@@ -625,7 +649,7 @@ function renderLanesTasks(batch, sessions) {
     const laneSessionId = lane.laneSessionId;
     const v2Alive = isLaneAliveV2(lane.laneNumber);
     const alive = v2Alive !== null ? v2Alive : sessionSet.has(laneSessionId);
-    const sessionChip = `session: ${laneSessionId}`;
+
 
     // Lane header
     html += `<div class="lane-group">`;
@@ -646,11 +670,7 @@ function renderLanesTasks(batch, sessions) {
     // View button: shows conversation stream when available
     const isViewingConv = viewerMode === 'conversation' && viewerTarget === laneSessionId;
     html += `    <button class="session-view-btn${isViewingConv ? ' active' : ''}" onclick="viewConversation('${escapeHtml(laneSessionId)}')" title="View worker conversation">👁 View</button>`;
-    if (alive) {
-      html += `    <span class="session-cmd" data-session="${escapeHtml(laneSessionId)}" onclick="copySessionId('${escapeHtml(laneSessionId)}')" title="Copy session ID">${escapeHtml(sessionChip)}</span>`;
-    } else {
-      html += `    <span class="session-cmd dead-session">${escapeHtml(sessionChip)}</span>`;
-    }
+
     html += `  </div>`;
     html += `</div>`;
 
@@ -975,12 +995,7 @@ function renderMergeAgents(batch, sessions) {
     // Full telemetry cell
     html += `<td class="merge-telemetry-cell">${mergeTelemetryHtml(mergeTel, effectiveAlive)}</td>`;
     html += `<td>`;
-    if (effectiveAlive) {
-      const sessionChip = `session: ${effectiveSession}`;
-      html += `<span class="session-cmd" data-session="${escapeHtml(effectiveSession)}" onclick="copySessionId('${escapeHtml(effectiveSession)}')" title="Copy session ID">${escapeHtml(sessionChip)}</span>`;
-    } else {
-      html += '<span class="merge-no-data">—</span>';
-    }
+    html += '<span class="merge-no-data">—</span>';
     html += `</td>`;
     html += `<td class="merge-detail-cell">${mr.failureReason ? escapeHtml(mr.failureReason) : "—"}</td>`;
     html += `</tr>`;
@@ -1015,14 +1030,13 @@ function renderMergeAgents(batch, sessions) {
     if (shownSessions.has(sess)) continue;
 
     const sessTel = telemetry[sess] || null;
-    const sessionChip = `session: ${sess}`;
     html += `<tr>`;
     html += `<td class="merge-wave-cell">—</td>`;
     html += `<td><span class="status-badge status-running"><span class="status-dot running"></span> merging</span></td>`;
     html += `<td class="merge-session-cell">${escapeHtml(sess)}</td>`;
     // Full telemetry cell for active merge session
     html += `<td class="merge-telemetry-cell">${mergeTelemetryHtml(sessTel, true)}</td>`;
-    html += `<td><span class="session-cmd" data-session="${escapeHtml(sess)}" onclick="copySessionId('${escapeHtml(sess)}')" title="Copy session ID">${escapeHtml(sessionChip)}</span></td>`;
+    html += `<td>—</td>`;
     html += `<td>—</td>`;
     html += `</tr>`;
   }
@@ -1144,7 +1158,7 @@ function renderMailboxAuditEvent(evt) {
   } else {
     // Unknown event type — render generically
     direction = evt.from ? `${escapeHtml(evt.from)}` : '';
-    preview = JSON.stringify(evt).slice(0, 120);
+    preview = JSON.stringify(evt);
   }
 
   return `<div class="message-row">`
@@ -1175,7 +1189,7 @@ function renderMailboxDirMessage(msg) {
   else if (msg._status === 'reply-acked') statusBadge = '<span class="msg-badge msg-delivered">reply (acked)</span>';
   else statusBadge = '';
   const typeBadge = `<span class="msg-badge msg-type">${escapeHtml(msg.type || '')}</span>`;
-  const preview = (msg.content || '').slice(0, 120);
+  const preview = msg.content || '';
   const broadcastTag = msg._isBroadcast ? ' <span class="msg-badge msg-type">broadcast</span>' : '';
 
   return `<div class="message-row">`

package/dashboard/public/style.css

@@ -1787,9 +1787,9 @@ body {
 }
 .message-row {
   display: flex;
-  align-items: center;
+  align-items: flex-start;
   gap: 8px;
-  padding: 4px 8px;
+  padding: 6px 8px;
   font-size: 0.8rem;
   border-radius: 4px;
   background: var(--bg-secondary);
@@ -1826,9 +1826,8 @@ body {
 }
 .msg-preview {
   color: var(--text-primary);
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
+  white-space: pre-wrap;
+  word-break: break-word;
   flex: 1;
 }
 .msg-rate-limited {