pi-soly 1.2.0 → 1.4.0

package/switch/index.ts

@@ -1,347 +0,0 @@
-// =============================================================================
-// index.ts — pi-switch extension entry (v2: footer-pill UI)
-// =============================================================================
-//
-// Wires the rotor switcher into pi as a compact footer pill:
-//   - Footer status pill: "▶ ⚡ worker" (or "· ⚡ worker" for the default)
-//   - Click pill or `/rotor` → open full picker modal (SelectList)
-//   - Ctrl+Tab → cycle to next rotor (no popup, hot switch)
-//   - F2 → same, fallback if your terminal doesn't pass Ctrl+Tab through
-//   - Persists current rotor to .soly/agent or ~/.pi-switch/agent
-//   - Exposes `globalThis.__PI_SWITCH_ROTOR__` for other extensions
-//   - Injects a short system-prompt section so the LLM knows the current
-//     rotor and the available alternatives
-//
-// UI philosophy:
-//   - Header is for content, not for tool chrome. Move rotors to footer.
-//   - Click to explore, hotkey to power-use, no DOM clutter in between.
-//   - Visual change is the pill text only. Chat stays clean.
-// =============================================================================
-
-import type { ExtensionAPI, ExtensionUIContext } from "@earendil-works/pi-coding-agent";
-import { Box, Text } from "@earendil-works/pi-tui";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import {
-	DEFAULT_ROTOR,
-	BUILTIN_ROTORS,
-	availableAgents,
-	nextAgent,
-	parseRotorName,
-	groupedAvailableRotors,
-	getRotorMeta,
-	loadAgent,
-	saveAgent,
-} from "./core.ts";
-import { buildPiSwitchSection, recommendAgent } from "./prompt.ts";
-
-const GLOBAL_KEY = "__PI_SWITCH_ROTOR__";
-
-export default function piSwitchExtension(pi: ExtensionAPI) {
-	let cwd = "";
-	let currentRotor: string = DEFAULT_ROTOR;
-	let cycle: string[] = [DEFAULT_ROTOR];
-	let lastUi: ExtensionUIContext | null = null;
-
-	function refreshCycle(): void {
-		cycle = availableAgents(cwd);
-		if (!cycle.includes(currentRotor)) currentRotor = DEFAULT_ROTOR;
-	}
-
-	function publish(): void {
-		(globalThis as Record<string, unknown>)[GLOBAL_KEY] = currentRotor;
-	}
-
-	function rerender(): void {
-		if (!lastUi) return;
-		try {
-			const meta = getRotorMeta(currentRotor);
-			// Persistent pill — always visible above the input, even for the
-			// default rotor. The user wants a constant mode indicator, not a
-			// transient one. Marker "▶" makes it scannable.
-			const marker = currentRotor === DEFAULT_ROTOR ? "·" : "▶";
-			const pill = `${marker} ${meta.emoji} ${currentRotor}`;
-			lastUi.setStatus("pi-switch", pill);
-		} catch { /* no ui yet */ }
-	}
-
-	function setRotor(next: string): void {
-		const prev = currentRotor;
-		if (next === prev) return;
-		currentRotor = next;
-		publish();
-		if (cwd) saveAgent(cwd, next);
-		rerender();
-		// Footer pill is the only visible signal of the switch.
-		// Chat stays clean — rotor is plumbing, not conversation content.
-	}
-
-	// ----- session_start: load persisted agent + set initial pill -----
-	pi.on("session_start", async (_event, ctx) => {
-		cwd = ctx.cwd;
-		lastUi = ctx.ui;
-		publish();
-		const restored = loadAgent(cwd);
-		if (restored) currentRotor = restored;
-		refreshCycle();
-		publish();
-		rerender();
-	});
-
-	// ----- before_agent_start: inject system-prompt section -----
-	pi.on("before_agent_start", async (event, ctx) => {
-		lastUi = ctx.ui;
-		rerender();
-		return {
-			systemPrompt: event.systemPrompt + buildPiSwitchSection(),
-		};
-	});
-
-	// ----- Hot cycle (no popup, no confirmation) -----
-	// Ctrl+Tab is the primary shortcut (most terminals support it).
-	// F2 is kept as a backup for terminals that don't pass Ctrl+Tab through.
-	// Debounced: 180ms — terminal key auto-repeat can fire the same key 5+
-	// times per second, which would spam the chat with the same agent
-	// notification. The window covers auto-repeat but allows deliberate
-	// sequential presses.
-	let lastCycleTs = 0;
-	const CYCLE_DEBOUNCE_MS = 180;
-	const cycleShortcut = (sctx: { ui: ExtensionUIContext }): void => {
-		const now = Date.now();
-		if (now - lastCycleTs < CYCLE_DEBOUNCE_MS) return;
-		lastCycleTs = now;
-		lastUi = sctx.ui;
-		refreshCycle();
-		setRotor(nextAgent(currentRotor, cycle));
-	};
-	pi.registerShortcut("ctrl+tab", {
-		description: "Cycle to next agent (worker → oracle → scout → …)",
-		handler: (sctx) => cycleShortcut(sctx),
-	});
-	pi.registerShortcut("f2", {
-		description: "Cycle to next agent (F2 fallback if Ctrl+Tab isn't passed by your terminal)",
-		handler: (sctx) => cycleShortcut(sctx),
-	});
-
-	// ----- /rotor: open picker, or subcommands (create / doctor / recommend / set) -----
-	// (formerly /agent — renamed to /rotor in 1.0.0 to match the "rotor" naming convention)
-	pi.registerCommand("rotor", {
-		description: "open rotor picker, or `set <name>`, `create`, `doctor`, `recommend <task>`",
-		handler: async (args, ctx) => {
-			lastUi = ctx.ui;
-			refreshCycle();
-			const parts = args.trim().split(/\s+/);
-			const subcommand = parts[0]?.toLowerCase();
-			const arg = parts[1];
-
-			if (subcommand === "create") return createAgent(arg, ctx.ui, cwd);
-			if (subcommand === "doctor") return ctx.ui.notify(doctorReport(), "info");
-			if (subcommand === "recommend") return handleRecommend(parts.slice(1).join(" "), ctx.ui);
-			if (subcommand === "set" && arg) return handleSet(arg, ctx.ui);
-
-			// Direct agent name → set
-			if (subcommand && cycle.includes(subcommand)) return setRotor(subcommand);
-			if (arg && !subcommand) return handleSet(arg, ctx.ui);
-
-			// No arg: open picker modal
-			openPicker(ctx.ui);
-		},
-	});
-}
-
-// ---------------------------------------------------------------------------
-// Picker modal (TUI SelectList)
-// ---------------------------------------------------------------------------
-
-function openPicker(ui: ExtensionUIContext): void {
-	refreshAndBuild(ui, (groups) => {
-		const all: Array<{ value: string; label: string; description: string; isCurrent: boolean }> = [];
-		for (const g of groups) {
-			all.push({ value: "__sep__", label: `── ${g.header} `, description: "", isCurrent: false });
-			for (const a of g.agents) {
-				const m = getRotorMeta(a);
-				all.push({
-					value: a,
-					label: `${m.emoji}  ${a}`,
-					description: `${m.description}${m.writesFiles ? "" : "  ·  read-only"}`,
-					isCurrent: a === currentRotorRef(),
-				});
-			}
-		}
-		return all;
-	}, ui, (choice) => {
-		if (choice && choice !== "__sep__") setRotorRef(choice);
-	});
-}
-
-function handleSet(name: string, ui: ExtensionUIContext): void {
-	const target = parseRotorName(name);
-	if (!target) return ui.notify(`pi-switch: invalid name "${name}".`, "error");
-	if (!availableAgents(cwd).includes(target)) {
-		return ui.notify(`pi-switch: unknown "${target}". available: ${availableAgents(cwd).join(", ")}`, "error");
-	}
-	setRotorRef(target);
-}
-
-function handleRecommend(task: string, ui: ExtensionUIContext): void {
-	if (!task) return ui.notify("pi-switch: usage — `/agent recommend <task>`", "info");
-	const rec = recommendAgent(task);
-	if (!rec) return ui.notify(`pi-switch: no clear match for: "${task}"`, "info");
-	ui.notify(`${rec.emoji} ${rec.agent}  ·  why: ${rec.why}\n  → /agent ${rec.agent} to switch`, "info");
-}
-
-// ---------------------------------------------------------------------------
-// setAgent / currentRotor — module-scope so the modal can mutate them
-// ---------------------------------------------------------------------------
-
-let currentRotorRef: () => string = () => DEFAULT_ROTOR;
-let setRotorRef: (next: string) => void = () => {};
-
-// The picker and the main extension share state via these refs.
-// We patch them in `wire()` at the top of the default export.
-function wire(get: () => string, set: (n: string) => void): void {
-	currentRotorRef = get;
-	setRotorRef = set;
-}
-
-function refreshAndBuild<T>(
-	ui: ExtensionUIContext,
-	build: (groups: ReturnType<typeof groupedAvailableRotors>) => T,
-	_ui: ExtensionUIContext,
-	_onSelect: (value: string) => void,
-): void {
-	// Currently unused: we build inline in openPicker. Kept for future.
-	void build;
-}
-
-// ---------------------------------------------------------------------------
-// /agent create — scaffold a new agent .md
-// ---------------------------------------------------------------------------
-
-function createAgent(
-	name: string | undefined,
-	ui: { notify: (t: string, k?: "info" | "warning" | "error") => void; input: (t: string, p?: string) => Promise<string | undefined> },
-	cwd: string,
-): void {
-	if (!name) {
-		ui.notify("pi-switch: usage — `/agent create <name>`", "info");
-		return;
-	}
-	if (!parseRotorName(name)) {
-		ui.notify(`pi-switch: invalid name "${name}". Use letters/digits/dashes/underscores, ≤64 chars.`, "error");
-		return;
-	}
-	// Write to ~/.agents/ (vendor-neutral) first; fall back to ~/.pi/agent/agents/
-	// (pi's native) if .agents/ doesn't exist or is unwritable.
-	const home = os.homedir();
-	const candidates = [
-		path.join(home, ".agents"),
-		path.join(home, ".pi", "agent", "agents"),
-	];
-	const targetDir = candidates.find((d) => {
-		try {
-			if (!fs.existsSync(d)) fs.mkdirSync(d, { recursive: true });
-			// Probe write permission
-			const probe = path.join(d, ".pi-switch-write-probe");
-			fs.writeFileSync(probe, "");
-			fs.unlinkSync(probe);
-			return true;
-		} catch {
-			return false;
-		}
-	});
-	if (!targetDir) {
-		ui.notify(`pi-switch: could not find a writable agents dir (tried ${candidates.join(", ")}).`, "error");
-		return;
-	}
-	const file = path.join(targetDir, `${name}.md`);
-	if (fs.existsSync(file)) {
-		ui.notify(`pi-switch: ${file} already exists. edit it directly.`, "warning");
-		return;
-	}
-	void ui.input(`description for "${name}":`, "one-liner that shows in the picker")?.then((desc) => {
-		const description = desc?.trim() || `custom agent (${name})`;
-		try {
-			// Atomic write: tmp + rename. Avoids partial files and the
-			// race where two parallel createAgent calls would clobber each
-			// other's write after both pass the existsSync check.
-			const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
-			fs.writeFileSync(tmp, rotorTemplate(name, description), "utf-8");
-			fs.renameSync(tmp, file);
-			ui.notify(
-				`pi-switch: created ${file}\n  → next Ctrl+Tab to see it in the cycle\n  → edit the system prompt to specialize`,
-				"info",
-			);
-		} catch (err) {
-			ui.notify(`pi-switch: failed to write ${file}: ${(err as Error).message}`, "error");
-		}
-	});
-}
-
-function rotorTemplate(name: string, description: string): string {
-	return `---
-name: ${name}
-description: ${description}
-thinking: medium
-systemPromptMode: replace
-inheritProjectContext: true
-inheritSkills: false
-tools: read, grep, find, ls, bash, edit, write
-defaultContext: fork
----
-
-You are \`${name}\`. Describe what you specialize in, your process, and
-what you should NOT do. Keep the rest of this frontmatter as-is unless
-you have a specific reason to change it.
-
-# Your role
-
-<!-- Replace with a one-paragraph description of what you're for. -->
-
-# Process
-
-1. Read the user's request carefully.
-2. Form a hypothesis about the right approach.
-3. Verify with tools (read, grep, bash) before writing.
-4. Commit changes in narrow, reviewable diffs.
-
-# What you should NOT do
-
-- Edit other agents' files
-- Run subagents yourself (you're already a subagent)
-- Skip verification ("trust me bro" is not a process)
-`;
-}
-
-function doctorReport(): string {
-	const cycle = availableAgents(cwd);
-	const userDir = path.join(os.homedir(), ".pi", "agent", "agents");
-	const lines: string[] = ["pi-switch doctor:", ""];
-	const builtins = cycle.filter((a) => BUILTIN_ROTORS.includes(a));
-	const users = cycle.filter((a) => !BUILTIN_ROTORS.includes(a));
-	lines.push(`cycle: ${cycle.length} agents (${builtins.length} built-in, ${users.length} user)`);
-	lines.push("");
-	if (!fs.existsSync(userDir)) {
-		lines.push(`user dir: ${userDir} (does not exist)`);
-	} else {
-		const files = fs.readdirSync(userDir).filter((f) => f.endsWith(".md"));
-		lines.push(`user dir: ${userDir} (${files.length} file(s))`);
-		const issues: string[] = [];
-		for (const f of files) {
-			try {
-				const raw = fs.readFileSync(path.join(userDir, f), "utf-8");
-				if (!raw.startsWith("---\n")) { issues.push(`${f}: no YAML frontmatter`); continue; }
-				const m = raw.match(/^---\n([\s\S]*?)\n---/);
-				if (!m) { issues.push(`${f}: malformed frontmatter`); continue; }
-				const fm = m[1] ?? "";
-				if (!/^name:\s*\S/m.test(fm)) issues.push(`${f}: missing 'name:' in frontmatter`);
-				else if (!/^description:\s*\S/m.test(fm)) issues.push(`${f}: missing 'description:' in frontmatter`);
-			} catch (e) {
-				issues.push(`${f}: read error: ${(e as Error).message}`);
-			}
-		}
-		lines.push(issues.length === 0 ? "validation: all user agents OK ✓" : "validation issues:\n  - " + issues.join("\n  - "));
-	}
-	return lines.join("\n");
-}

package/switch/package.json

@@ -1,52 +0,0 @@
-{
-  "name": "pi-agented",
-  "version": "0.2.0",
-  "description": "Generic subagent switcher for pi. Header bar above chat, Ctrl+Shift+S to cycle, /agent slash command. Works with any agent in ~/.pi/agent/agents/.",
-  "type": "module",
-  "main": "index.ts",
-  "scripts": {
-    "test": "bun test",
-    "typecheck": "bun x tsc --noEmit"
-  },
-  "dependencies": {},
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
-  },
-  "devDependencies": {
-    "@earendil-works/pi-coding-agent": "0.78.1",
-    "@earendil-works/pi-tui": "0.78.1",
-    "@types/node": "^25.9.1",
-    "bun-types": "^1.3.14",
-    "typebox": "1.1.38",
-    "typescript": "^6.0.3"
-  },
-  "files": [
-    "index.ts",
-    "core.ts",
-    "prompt.ts",
-    "README.md"
-  ],
-  "keywords": [
-    "pi",
-    "pi-extension",
-    "pi-package",
-    "subagent",
-    "agent-switcher",
-    "task-routing"
-  ],
-  "license": "MIT",
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "repository": {
-    "type": "git",
-    "url": "http://git.local.stbl/lowern1ght/pi-soly.framework.git",
-    "directory": "packages/pi-switch"
-  }
-}

package/switch/prompt.ts

@@ -1,131 +0,0 @@
-// =============================================================================
-// prompt.ts — System-prompt section for the pi-switch extension
-// =============================================================================
-
-/** Task-pattern → recommended agent. The LLM reads this and decides
- *  whether to invoke /agent before launching subagent(...). Match is
- *  by keyword (case-insensitive). First match wins; ties broken by order. */
-export const TASK_AGENT_HINTS: ReadonlyArray<{
-	pattern: RegExp;
-	agent: string;
-	emoji: string;
-	why: string;
-}> = [
-	// English keywords (use \b — ASCII word boundary works for English)
-	{ pattern: /\b(research|investigate|look\s*up|find\s*out|explore|survey|compare\s+libraries|what\s+is\s+the\s+best)\b/i,
-	  agent: "researcher", emoji: "\ud83d\udcda",
-	  why: "external docs, ecosystem behavior, primary sources" },
-	{ pattern: /\b(scout|scan|map|find\s+all|where\s+is|locate|explore\s+codebase|skim)\b/i,
-	  agent: "scout", emoji: "\ud83d\udd0d",
-	  why: "codebase recon, patterns, file locations" },
-	{ pattern: /\b(plan|design|architect|outline|structure|break\s*down|steps|order)\b/i,
-	  agent: "soly-manager", emoji: "\ud83d\udccb",
-	  why: "decompose into ordered steps, identify risks" },
-	{ pattern: /\b(review|audit|check|adversarial|critique|find\s+bugs|qa)\b/i,
-	  agent: "reviewer", emoji: "\ud83d\udc40",
-	  why: "adversarial review of correctness, security, style" },
-	{ pattern: /\b(oracle|decision|tradeoff|compare|which\s+approach|is\s+this\s+wise|drift)\b/i,
-	  agent: "oracle", emoji: "\ud83d\udd2e",
-	  why: "decision consistency, hidden assumptions, drift detection" },
-	{ pattern: /\b(debug|bug|fix|crash|error|stack\s*trace|repro|why\s+is\s+this\s+broken)\b/i,
-	  agent: "soly-manager", emoji: "\ud83d\udc1e",
-	  why: "isolated bug investigation with minimal repro" },
-	{ pattern: /\b(test|tests|coverage|spec|assert)\b/i,
-	  agent: "soly-manager", emoji: "\ud83e\uddea",
-	  why: "test-only work, never modifies prod code" },
-	{ pattern: /\b(refactor|clean\s*up|simplify|extract|rename|restructure|no\s+behavior\s+change)\b/i,
-	  agent: "soly-manager", emoji: "\ud83d\udd04",
-	  why: "pure refactoring, behavior-preserving" },
-	{ pattern: /\b(document|docs|readme|jsdoc|comment|annotate)\b/i,
-	  agent: "soly-manager", emoji: "\ud83d\udcdd",
-	  why: "doc updates, READMEs, inline annotations" },
-	{ pattern: /\b(implement|build|write\s+code|add\s+feature|create\s+the)\b/i,
-	  agent: "worker", emoji: "\u26a1",
-	  why: "generic implementation with all tools" },
-	{ pattern: /\b(orchestrate|coordinate|dispatch|chain|run\s+in\s+parallel|first\s+.+\s+then)\b/i,
-	  agent: "soly-manager", emoji: "\ud83e\udd1d",
-	  why: "multi-agent orchestration" },
-	// Russian keywords (loose match — Russian words inflect heavily; we match
-	// word stems, accepting some false positives as the cost of broader coverage)
-	{ pattern: /(изуч|исслед|разузн|найди\s+инфу|research|investigate|find\s+out)/i,
-	  agent: "researcher", emoji: "\ud83d\udcda",
-	  why: "external docs, ecosystem behavior, primary sources" },
-	{ pattern: /(где\s+это|где\s+находит|find\s+all|locate)/i,
-	  agent: "scout", emoji: "\ud83d\udd0d",
-	  why: "codebase recon, patterns, file locations" },
-	{ pattern: /(спланир|plan|design|architect)/i,
-	  agent: "soly-manager", emoji: "\ud83d\udccb",
-	  why: "decompose into ordered steps, identify risks" },
-	{ pattern: /(проверь|ревью|аудит|review|audit)/i,
-	  agent: "reviewer", emoji: "\ud83d\udc40",
-	  why: "adversarial review of correctness, security, style" },
-	{ pattern: /(решени|выбор|decision|tradeoff|drift)/i,
-	  agent: "oracle", emoji: "\ud83d\udd2e",
-	  why: "decision consistency, hidden assumptions, drift detection" },
-	{ pattern: /(баг|ошибк|почему\s+(?:падает|ломает)|debug|bug|crash|stack\s*trace|repro)/i,
-	  agent: "soly-manager", emoji: "\ud83d\udc1e",
-	  why: "isolated bug investigation with minimal repro" },
-	{ pattern: /(тест|покрыт|test|coverage|spec|assert)/i,
-	  agent: "soly-manager", emoji: "\ud83e\uddea",
-	  why: "test-only work, never modifies prod code" },
-	{ pattern: /(рефактор|упрост|refactor|simplify|extract|restructure)/i,
-	  agent: "soly-manager", emoji: "\ud83d\udd04",
-	  why: "pure refactoring, behavior-preserving" },
-	{ pattern: /(документ|описани|document|readme|jsdoc)/i,
-	  agent: "soly-manager", emoji: "\ud83d\udcdd",
-	  why: "doc updates, READMEs, inline annotations" },
-	{ pattern: /(реализуй|сделай|напиши|создай|implement|build|add\s+feature|create\s+the)/i,
-	  agent: "worker", emoji: "\u26a1",
-	  why: "generic implementation with all tools" },
-	{ pattern: /(оркестрируй|координируй|orchestrate|coordinate|dispatch|chain)/i,
-	  agent: "soly-manager", emoji: "\ud83e\udd1d",
-	  why: "multi-agent orchestration" },
-];
-
-/** Heuristic: which agent does the task look like? Returns null if no
- *  pattern matches (caller should leave the current agent as-is). */
-export function recommendAgent(taskText: string): { agent: string; emoji: string; why: string } | null {
-	for (const hint of TASK_AGENT_HINTS) {
-		if (hint.pattern.test(taskText)) {
-			return { agent: hint.agent, emoji: hint.emoji, why: hint.why };
-		}
-	}
-	return null;
-}
-
-export function buildPiSwitchSection(): string {
-	return `
-
-## pi-switch — when to use \`/agent\`
-
-The \`/agent\` slash command + \`Ctrl+Tab\` shortcut cycle through 4 built-in cycle agents. Use the right one for the job:
-
-- **Read-only / no edits** (oracle, scout, reviewer): for analysis, planning, review. They won't modify files.
-- **Write tools** (worker): for implementation.
-- **User-defined** in \`~/.pi/agent/agents/\`: any agent the user has added — drop a markdown file with YAML frontmatter (name, description) and it joins the cycle automatically.
-
-The current agent is shown in the footer status line as \`[emoji name]\`.
-
-When you need a specialist for a sub-task, use the right agent via the parent LLM's \`subagent(...)\` call.
-
-**Soly subagent:** there is exactly one — \`soly-manager\`. It's a workflow executor that switches modes (worker/debugger/tester/reviewer/refactor/documenter/oracle/planner) based on the task brief. For any soly plan execution, spawn \`soly-manager\` via \`subagent(...)\` with the task — it picks the right mode itself.
-
-**Task → agent heuristics.** Before launching a generic \`subagent(...)\`, scan the request for these keywords:
-
-| Keywords in request | Suggested agent | Why |
-|---|---|---|
-| scout, scan, map, find all, where is, locate, explore codebase, skim | 🔍 scout | codebase recon, patterns, file locations |
-| review, audit, check, adversarial, critique, find bugs, qa | 👀 reviewer | adversarial correctness, security, style review |
-| oracle, decision, tradeoff, compare, which approach, is this wise, drift | 🔮 oracle | decision consistency, hidden assumptions |
-| implement, build, write code, add feature, create the, debug, fix, test, refactor, document, plan, validate | ⚡ soly-manager | workflow executor, picks mode from task brief |
-| (anything else) | ⚡ worker | generic implementation, all tools |
-
-For multi-step tasks, the orchestrator (you) decides which agents run and in what order. You can chain agents via \`subagent({ chain: [...] })\` or run them in parallel via parallel tasks.
-
-DON'T:
-- Launch a worker for analysis (use oracle/scout/reviewer)
-- Launch an oracle for implementation (it has no write tools)
-- Spawn soly-worker / soly-debugger / soly-tester — there is only \`soly-manager\`
-- Manually edit \`.soly/agent\` or \`~/.pi-switch/agent\` — use the slash command
-`;
-}