pi-soly 1.2.0 → 1.4.0

package/README.md

@@ -4,7 +4,7 @@
 
 **The project management framework for [pi-coding-agent](https://github.com/nicobailon/pi-coding-agent).**
 
-Plans · State · Subagents · Multi-question picker · Rotor switcher · Live task list.
+Plans · State · Subagents · Multi-question picker · Live task list.
 
 One `npm install`. Zero config. Pure magic.
 
@@ -30,7 +30,7 @@ That's it. Restart pi, and you have:
 
 - **A complete project management engine** — plans, state, subagent-driven execution
 - **A multi-question picker** — `ask_pro` tool for the LLM
-- **A rotor switcher** — `Ctrl+Tab` to cycle, footer pill always visible
+- **Live task list + notifications** — see nudge + deprecation warnings as framed Box widgets
 - **A live task list** — `todo_update` tool renders in the footer
 - **7 soly agents** installed on first run
 
@@ -43,7 +43,7 @@ That's it. Restart pi, and you have:
 | Write your own planning workflow | `/plan`, `/execute`, `/resume`, `/inspect` — ready |
 | Manually dispatch subagents | `useSolyWorkerSubagents: true` — automatic routing |
 | 3 different packages for pickers/tasks/agents | One package, one config, one install |
-| Rotor name as free text in slash commands | Footer pill + `Ctrl+Tab` + `/rotor` picker |
+| Mode selection (oracle/scout/reviewer) | LLM picks via `subagent(...)` based on task brief |
 | Re-invent the state machine | `.soly/STATE.md` + auto-managed phases |
 
 ---
@@ -56,7 +56,7 @@ GSD-inspired planning and execution. State is the source of truth, not vibes.
 
 ```bash
 /plan            # generate PLAN.md for the current phase
-/execute         # dispatch plan to soly-worker subagent
+/execute         # execute plan directly (LLM does the work)
 /resume          # pick up a paused session
 /inspect         # show current state summary
 /discuss 3       # talk through decisions before planning phase 3
@@ -94,30 +94,6 @@ ask_pro({
 })
 ```
 
-### 🎛 Rotor Switcher
-
-Footer pill that's always there. `Ctrl+Tab` to cycle. No popup, no friction.
-
-```
-[model]  · ⚡ worker    · todos 2/5: write tests   ← footer, always visible
-[model]  ▶ 🐢 oracle    · todos 2/5: write tests   ← after one Ctrl+Tab
-[model]  · 🔍 scout     · todos 2/5: write tests   ← after two
-```
-
-Agents:
-- `worker` — default, full read+write
-- `oracle` — read-only decision advisor
-- `scout` — codebase reconnaissance
-- `researcher` — external docs, ecosystem
-- `planner` — architecture and decomposition
-- `context-builder` — hands off context to other agents
-- `reviewer` — adversarial code review, read-only
-- `delegate` — chains agents together
-
-### 📝 Live Task List
-
-`todo_update` tool — renders in the footer as `todos 2/5: current action`.
-
 The LLM can update its own task list mid-turn. You watch progress without re-asking.
 
 ```ts
@@ -171,18 +147,18 @@ todo_update({
                          ▼
                 ┌──────────────────┐
                 │  switch/         │
-                │  rotor switcher  │
+                │  (no rotors —    │
                 │                  │
                 │  Ctrl+Tab        │
                 │  footer pill     │
-                │  /rotor picker   │
+                │   removed 1.4)   │
                 └────────┬─────────┘
                          │
                          ▼
                 ┌──────────────────┐
                 │  7 soly agents   │
                 │                  │
-                │  soly-worker     │
+                │  worker (cycle)     │
                 │  soly-debugger   │
                 │  soly-tester     │
                 │  soly-reviewer   │
@@ -196,7 +172,7 @@ todo_update({
 
 ## 📚 Documentation
 
-- **Slash commands** — `/plan`, `/execute`, `/resume`, `/inspect`, `/discuss <N>`, `/quick <task>`, `/rotor`
+- **Slash commands** — `/plan`, `/execute`, `/resume`, `/inspect`, `/discuss <N>`, `/quick <task>`
 - **Tools** — `ask_pro(question[])` and `todo_update(todo[])`
 - **Events** — `session_start`, `before_agent_start`, `message_end`, `tool_call`, `tool_result`
 - **State files** — `.soly/STATE.md`, `.soly/ROADMAP.md`, `.soly/phases/<N>-<slug>/<N>-PLAN.md`

package/agents-install.ts

@@ -2,17 +2,16 @@
 // assets-install.ts — Idempotent install of soly-managed user assets
 // =============================================================================
 //
-// Soly ships two kinds of user-scope assets:
+// Soly ships one kind of user-scope asset:
 //
-//   1. Subagent configs → `~/.pi/agent/agents/`
-//      The single `soly-manager` subagent (mode-switching executor).
-//
-//   2. Skills → `~/.pi/agent/skills/<name>/`
+//   Skills → `~/.pi/agent/skills/<name>/`
 //      The `soly-framework` skill — framework documentation the LLM
-//      loads on demand via the read tool.
+//      loads on demand via the read tool. This is the LLM's only
+//      "helper" for soly — pi doesn't need a separate subagent layer
+//      for plan execution (the LLM in the main session does it).
 //
-// pi discovers both from `~/.pi/agent/`, so on first session_start we
-// copy our shipped files there.
+// pi discovers the skill from `~/.pi/agent/`, so on first session_start
+// we copy our shipped file there.
 //
 // IDEMPOTENT: if the target file already exists (user may have customized
 // it), we do NOT overwrite. This is one-way "first install wins".
@@ -22,41 +21,19 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 
-/** soly agent files bundled with the extension. */
-const SHIPPED_AGENTS = [
-	"soly-manager.md",
-] as const;
-
 /** soly skills bundled with the extension. Each entry is a directory
  *  under `skills/` containing a SKILL.md. */
 const SHIPPED_SKILLS = [
 	"soly-framework",
 ] as const;
 
-/** Where pi looks for user agents. Respects HOME/USERPROFILE for
- *  testability (otherwise we'd always write to the real user home).
- *  Agent files live directly in the dir (no `agents/` subfolder):
- *    ~/.agents/reviewer.md   (NOT ~/.agents/agents/reviewer.md)
- *  This keeps the path clean and matches the project-level convention. */
-function userAgentsDirs(): string[] {
-	const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
-	return [
-		path.join(home, ".agents"),                          // vendor-neutral (preferred)
-		path.join(home, ".pi", "agent", "agents"),           // pi native (legacy)
-	];
-}
-
-/** Where pi looks for user skills. */
+/** Where pi looks for user skills. Respects HOME/USERPROFILE for
+ *  testability (otherwise we'd always write to the real user home). */
 function userSkillsDir(): string {
 	const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
 	return path.join(home, ".pi", "agent", "skills");
 }
 
-/** Where this soly extension's `agents/` directory lives. */
-function shippedAgentsDir(extensionRoot: string): string {
-	return path.join(extensionRoot, "agents");
-}
-
 /** Where this soly extension's `skills/` directory lives. */
 function shippedSkillsDir(extensionRoot: string): string {
 	return path.join(extensionRoot, "skills");
@@ -68,19 +45,7 @@ export interface InstallResult {
 	errors: string[];
 }
 
-/** Copy a single file if destination doesn't exist. Idempotent. */
-function copyIfMissing(from: string, to: string): "installed" | "skipped" | "error" {
-	if (!fs.existsSync(from)) return "error";
-	if (fs.existsSync(to)) return "skipped";
-	try {
-		fs.copyFileSync(from, to);
-		return "installed";
-	} catch {
-		return "error";
-	}
-}
-
-/** Recursively copy a directory tree if destination doesn't exist. Idempotent. */
+/** Copy a directory tree if destination doesn't exist. Idempotent. */
 function copyDirIfMissing(from: string, to: string): "installed" | "skipped" | "error" {
 	if (!fs.existsSync(from)) return "error";
 	if (fs.existsSync(to)) return "skipped";
@@ -93,40 +58,6 @@ function copyDirIfMissing(from: string, to: string): "installed" | "skipped" | "
 	}
 }
 
-/** Install shipped soly agents to `~/.agents/` (vendor-neutral,
- *  preferred). Legacy `~/.pi/agent/agents/` copies are left alone —
- *  `discoverUserRotors` reads both, so old installs still work. */
-export function installSolyAgents(extensionRoot: string): InstallResult {
-	const result: InstallResult = { installed: [], skipped: [], errors: [] };
-	const src = shippedAgentsDir(extensionRoot);
-
-	if (!fs.existsSync(src)) return result; // dev mode no-op
-
-	// Try vendor-neutral first, then fall back to pi's native dir.
-	let dst: string | null = null;
-	for (const candidate of userAgentsDirs()) {
-		try {
-			fs.mkdirSync(candidate, { recursive: true });
-			dst = candidate;
-			break;
-		} catch (err) {
-			result.errors.push(`mkdir ${candidate}: ${(err as Error).message}`);
-		}
-	}
-	if (!dst) return result;
-
-	for (const name of SHIPPED_AGENTS) {
-		const from = path.join(src, name);
-		const to = path.join(dst, name);
-		const r = copyIfMissing(from, to);
-		if (r === "installed") result.installed.push(name);
-		else if (r === "skipped") result.skipped.push(name);
-		else result.errors.push(`missing source: ${from}`);
-	}
-
-	return result;
-}
-
 /** Install shipped soly skills to `~/.pi/agent/skills/`. Idempotent. */
 export function installSolySkills(extensionRoot: string): InstallResult {
 	const result: InstallResult = { installed: [], skipped: [], errors: [] };
@@ -147,33 +78,15 @@ export function installSolySkills(extensionRoot: string): InstallResult {
 	return result;
 }
 
-/** Install all soly assets (agents + skills). Combined for convenience. */
+/** Install all soly assets (skills only — agents are not shipped). */
 export function installSolyAssets(extensionRoot: string): {
-	agents: InstallResult;
 	skills: InstallResult;
 } {
 	return {
-		agents: installSolyAgents(extensionRoot),
 		skills: installSolySkills(extensionRoot),
 	};
 }
 
-/** Check which shipped soly agents are present across all user agent
- *  homes. A file counts as "installed" if it's in ANY of the dirs. */
-export function checkSolyAgentsInstalled(extensionRoot: string): {
-	installed: string[];
-	missing: string[];
-} {
-	const installed: string[] = [];
-	const missing: string[] = [];
-	for (const name of SHIPPED_AGENTS) {
-		const present = userAgentsDirs().some((dir) => fs.existsSync(path.join(dir, name)));
-		if (present) installed.push(name);
-		else missing.push(name);
-	}
-	return { installed, missing };
-}
-
 /** Check which shipped soly skills are present in the user dir. */
 export function checkSolySkillsInstalled(extensionRoot: string): {
 	installed: string[];

package/commands.ts

@@ -31,6 +31,10 @@ import {
 	type SolyState,
 } from "./core.ts";
 import type { SolyConfig } from "./config.ts";
+import { migrateSolyDir } from "./migrate.js";
+import { initSolyProject } from "./init.js";
+import { readNotifications, formatNotifications } from "./notifications-log.js";
+import { formatStatus } from "./status.js";
 
 /** Minimum ui surface the command handlers actually need. */
 export interface CommandUI {
@@ -332,6 +336,48 @@ What must the LLM do?
 	});
 
 	// ============================================================================
+	// /soly migrate — move .soly/ → .agents/ atomically
+	// ============================================================================
+	pi.registerCommand("soly-migrate", {
+		description:
+			"migrate project state from .soly/ to .agents/ (atomic rename, validates result, suggests git commit)",
+		handler: async (args, ctx) => {
+			const ui: CommandUI = {
+				notify: (t, k) => ctx.ui.notify(t, k ?? "info"),
+				select: async (label, options) => {
+					const result = await ctx.ui.select(label, options);
+					return result === undefined ? null : options.indexOf(result);
+				},
+				confirm: (title, message) => ctx.ui.confirm(title, message),
+			};
+			await migrateSolyDir(ctx.cwd, ui, { autoYes: args.includes("--yes") });
+		},
+	});
+
+	// /soly init — scaffold new project
+	// ============================================================================
+	pi.registerCommand("soly-init", {
+		description:
+			"scaffold a new soly project (interactive: pick template — minimal/web-app/library/cli)",
+		handler: async (args, ctx) => {
+			const ui: CommandUI = {
+				notify: (t, k) => ctx.ui.notify(t, k ?? "info"),
+				select: async (label, options) => {
+					const result = await ctx.ui.select(label, options);
+					return result === undefined ? null : options.indexOf(result);
+				},
+				confirm: (title, message) => ctx.ui.confirm(title, message),
+				input: (label, placeholder) => ctx.ui.input(label, placeholder),
+			};
+			// Parse args: --template=X, --yes, --name=X
+			const template = (args.match(/--template[= ](\S+)/)?.[1] as
+				| "minimal" | "web-app" | "library" | "cli" | undefined) ?? undefined;
+			const autoYes = args.includes("--yes");
+			const projectName = args.match(/--name[= ](\S+)/)?.[1];
+			await initSolyProject(ctx.cwd, ui, { template, autoYes, projectName });
+		},
+	});
+
 	// /soly
 	// ============================================================================
 
@@ -372,8 +418,8 @@ What must the LLM do?
 			};
 			const subcommands: Record<string, SolySub> = {
 				// `agent` subcommand REMOVED — moved to the separate `pi-switch`
-				// extension as the `/rotor` slash command (footer pill + Ctrl+Tab).
-				// Soly no longer owns the rotor switcher UI.
+				// extension (rotor switcher removed in 1.4.0).
+				// Soly no longer owns a rotor switcher.
 				config: {
 					description: "show merged config (per-project + global + defaults); edit .soly/config.json or ~/.soly/config.json",
 					run: () => {

package/config.ts

@@ -35,12 +35,10 @@ export interface SolyConfig {
 		preferAskPro: boolean;
 		/** When soly pause is invoked, also auto-save HANDOFF.json (currently always true; knob for future). */
 		autoCheckpointOnPause: boolean;
-		/** Opt-in: install soly-manager agent config to
-		 *  ~/.pi/agent/agents/ on session_start. The single soly subagent
-		 *  is mode-switching (worker/debugger/tester/reviewer/etc. based on
-		 *  the task brief). Off by default — most users don't need a soly-
-		 *  specialized subagent since the workflow template already
-		 *  contains soly instructions. */
+		/** DEPRECATED in 1.3.0. Soly no longer ships a subagent. The LLM
+		 *  executes plans directly using the slash commands + the
+		 *  soly-framework skill. This option is kept as a no-op for
+		 *  backward compat with old config files. */
 		useSolyWorkerSubagents: boolean;
 	};
 	display: {

package/index.ts

@@ -66,7 +66,7 @@ import { loadIntentDocs, buildIntentSection, loadInlineIntentBodies, type Intent
 
 // Built-in sub-features (merged from former pi-asked, pi-agented packages):
 import piAskExtension from "./ask/index.ts";
-import piSwitchExtension from "./switch/index.ts";
+
 
 export default function solyExtension(pi: ExtensionAPI) {
 	// ============================================================================
@@ -82,18 +82,7 @@ export default function solyExtension(pi: ExtensionAPI) {
 	let sessionCwd = "";
 
 	// ============================================================================
-	// Rotor switcher (Shift+Tab cycles through available rotors)
-	// ============================================================================
-
 	// ============================================================================
-	// Rotor switcher: REMOVED. The rotor cycler is now owned by the
-	// separate `pi-switch` extension (footer pill + Ctrl+Tab + /rotor slash).
-	// Soly owns a single subagent (soly-manager.md) and the auto-install on
-	// opt-in. Workflows read the current agent from
-	// globalThis.__PI_SWITCH_AGENT__ (set by pi-switch).
-	// ============================================================================
-
-	// Config (per-project + global + defaults). Refreshed on session_start
 	// and on each session_start (the LLM can call /soly config to view).
 	let activeConfig: SolyConfig = DEFAULT_CONFIG;
 	const getActiveConfig = (): SolyConfig => activeConfig;
@@ -261,7 +250,6 @@ export default function solyExtension(pi: ExtensionAPI) {
 		const hint = buildNextHint(state);
 		const hintGroup = hint ? `${"\x1b[2m"}${hint}${"\x1b[0m"}` : "";
 
-		// Agent badge — owned by pi-switch extension (header bar + status line).
 		// Soly doesn't render the agent badge itself.
 		const agentGroup = "";
 
@@ -324,18 +312,6 @@ export default function solyExtension(pi: ExtensionAPI) {
 		getConfig: getActiveConfig,
 	});
 
-	// ============================================================================
-	// Agent switcher: Ctrl+Shift+A cycles through available subagents.
-	// (Shift+Tab is taken by pi's thinking-level cycler; Ctrl+Shift+A is unused
-	// and mnemonic for "A"gent.)
-	// ============================================================================
-	// Agent switcher REMOVED — moved to the separate `pi-switch` extension.
-	// Soly no longer owns Ctrl+Tab, the footer pill, or /rotor slash.
-	// The current agent is read by soly workflows from
-	// globalThis.__PI_SWITCH_AGENT__ (set by pi-switch), with a fallback
-	// to "worker" if pi-switch isn't installed.
-	// ============================================================================
-
 	registerWorkflows(pi, {
 		getState: () => state,
 		getInteractiveRules: () =>
@@ -354,7 +330,7 @@ export default function solyExtension(pi: ExtensionAPI) {
 	pi.on("session_start", async (event, ctx) => {
 		// Deprecation warning: if the project still uses `.soly/`, nudge the
 		// user toward `.agents/`. One-time per session.
-		if (isLegacySolyDir(ctx.cwd)) {
+		if (activeConfig.agent.useSolyWorkerSubagents && isLegacySolyDir(ctx.cwd)) {
 			notifyDeprecation(
 				ctx.ui,
 				`.soly/ (legacy)`,
@@ -405,21 +381,22 @@ export default function solyExtension(pi: ExtensionAPI) {
 			}
 		}
 
-		// Auto-install soly user-scope assets (soly-manager agent + soly-framework
-		// skill) to ~/.pi/agent/ on first run. Opt-in via config
-		// `agent.useSolyWorkerSubagents` (default false). Idempotent — respects
-		// any existing user-customized copies.
+		// Auto-install soly user-scope assets (soly-framework skill only,
+		// since 1.3.0 we don't ship a subagent) to ~/.pi/agent/skills/ on
+		// first run. Opt-in via config `agent.useSolyWorkerSubagents`
+		// (kept for backward compat, now a no-op for the skill install).
+		// Idempotent — respects any existing user-customized copies.
 		if (activeConfig.agent.useSolyWorkerSubagents) {
 			const extRoot = path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, "$1"));
 			const assets = installSolyAssets(extRoot);
-			const installed = [...assets.agents.installed, ...assets.skills.installed.map((s) => `skill:${s}`)];
+			const installed = assets.skills.installed.map((s) => `skill:${s}`);
 			if (installed.length > 0) {
 				ctx.ui.notify(
-					`soly: installed (${installed.join(", ")}) — run \`/subagents-doctor\` to verify`,
+					`soly: installed (${installed.join(", ")}) — pi will discover on next session`,
 					"info",
 				);
 			}
-			for (const e of [...assets.agents.errors, ...assets.skills.errors]) {
+			for (const e of assets.skills.errors) {
 				ctx.ui.notify(`soly: install error — ${e}`, "warning");
 			}
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-soly",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Project management framework for pi-coding-agent. Workflows, planning, multi-question picker, agent switcher, live task list — one npm install, zero config.",
   "type": "module",
   "main": "index.ts",
@@ -38,10 +38,8 @@
     "scratchpad.ts",
     "tools.ts",
     "agents-install.ts",
-    "agents",
     "ask",
     "skills",
-    "switch",
     "workflows",
     "workflows-data"
   ],