@vitos-pizza/vitos-pizza 0.1.0 → 0.2.0

package/node_modules/@vitos-pizza/subagents/skills/subagents/SKILL.md

@@ -1,80 +1,86 @@
----
-name: subagents
-description: Delegate exploration, planning, and implementation to Vito's Pizzeria subagents (scout, planner, worker).
----
-
-# Subagents (Vito's Pizzeria)
-
-Use the `subagent` tool to delegate work to focused child agents with isolated context.
-
-## Agent modes
-
-Vito's Pizzeria uses three modes via `/mode` or `F6`:
-
-| Mode | When to use |
-|------|-------------|
-| **agent** | Default balanced work |
-| **plan** | Read-only exploration — scout → planner, `question` for clarification |
-| **execute** | Full implementation after plan is approved |
-
-In **plan** mode the main agent cannot write/edit/bash. Delegate with subagents:
-
-```
-scout → planner → (user confirms) → switch to execute → worker
-```
-
-## Built-in agents
-
-| Agent | Use when |
-|-------|----------|
-| `scout` | Fast codebase recon; returns compressed context |
-| `planner` | Turn context + requirements into an implementation plan |
-| `worker` | Execute an approved plan with narrow, correct edits |
-| `title` | Generate short session titles (used by `@vitos-pizza/session-title`) |
-
-## Typical workflow
-
-```
-scout → planner → worker
-```
-
-### Chain (one tool call)
-
-```json
-{
-  "chain": [
-    { "agent": "scout", "task": "Map the auth module and key entry points" },
-    { "agent": "planner", "task": "Create a plan based on {previous}" },
-    { "agent": "worker", "task": "Implement the plan from {previous}" }
-  ]
-}
-```
-
-### Parallel
-
-```json
-{
-  "tasks": [
-    { "agent": "scout", "task": "Scan packages/subagents" },
-    { "agent": "scout", "task": "Scan packages/permission-system" }
-  ]
-}
-```
-
-### Async + wait
-
-Start work in the background, then block until it finishes:
-
-```json
-{ "agent": "worker", "task": "...", "async": true }
-```
-
-```json
-{ "id": "<runId>" }
-```
-
-via the `wait` tool.
-
-## External modules
-
-Other Vito's Pizzeria extensions can request subagent runs via `pi.events` RPC (`subagents:rpc:run`). Import helpers from `@vitos-pizza/subagents/rpc/client` if needed.
+---
+name: subagents
+description: Delegate exploration, planning, and implementation to Vito's Pizzeria subagents (scout, planner, worker).
+---
+
+# Subagents (Vito's Pizzeria)
+
+Use the `subagent` tool to delegate work to focused child agents with isolated context.
+
+## Agent modes
+
+Vito's Pizzeria uses three modes via `/mode` or `F6`:
+
+| Mode | When to use |
+|------|-------------|
+| **agent** | Default balanced work |
+| **plan** | Read-only planning — planner (+ optional scout), `question` for clarification; optional short **Next** footer |
+| **execute** | Full implementation after plan is approved |
+
+In **plan** mode the main agent cannot write/edit/bash. Delegate with subagents. Scout is optional — use it only when codebase recon is needed; otherwise call planner directly. When recon spans independent areas, run multiple scouts in parallel (`tasks: [...]`) then planner:
+
+```
+[optional scout(s) →] planner → (user confirms) → switch to execute → worker
+```
+
+## Built-in agents
+
+| Agent | Use when |
+|-------|----------|
+| `scout` | Fast codebase recon; returns compressed context |
+| `planner` | Turn context + requirements into an implementation plan |
+| `worker` | Execute an approved plan with narrow, correct edits |
+| `title` | Generate short session titles (used by `@vitos-pizza/session-title`) |
+
+## Typical workflow
+
+```
+[optional scout →] planner → worker
+```
+
+### Planner only (enough context)
+
+```json
+{ "agent": "planner", "task": "Create an implementation plan for ..." }
+```
+
+### Chain with scout (when recon is needed)
+
+```json
+{
+  "chain": [
+    { "agent": "scout", "task": "Map the auth module and key entry points" },
+    { "agent": "planner", "task": "Create a plan based on {previous}" },
+    { "agent": "worker", "task": "Implement the plan from {previous}" }
+  ]
+}
+```
+
+### Parallel
+
+```json
+{
+  "tasks": [
+    { "agent": "scout", "task": "Scan packages/subagents" },
+    { "agent": "scout", "task": "Scan packages/permission-system" }
+  ]
+}
+```
+
+### Async + wait
+
+Start work in the background, then block until it finishes:
+
+```json
+{ "agent": "worker", "task": "...", "async": true }
+```
+
+```json
+{ "id": "<runId>" }
+```
+
+via the `wait` tool.
+
+## External modules
+
+Other Vito's Pizzeria extensions can request subagent runs via `pi.events` RPC (`subagents:rpc:run`). Import helpers from `@vitos-pizza/subagents/rpc/client` if needed.

package/node_modules/@vitos-pizza/subagents/src/agents.ts

@@ -1,166 +1,166 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-	CONFIG_DIR_NAME,
-	getAgentDir,
-	parseFrontmatter,
-} from "@earendil-works/pi-coding-agent";
-import type { AgentScope } from "./types.ts";
-
-export interface AgentConfig {
-	name: string;
-	description: string;
-	tools?: string[];
-	model?: string;
-	thinking?: string;
-	systemPromptMode?: "append" | "replace";
-	systemPrompt: string;
-	source: "builtin" | "user" | "project";
-	filePath: string;
-}
-
-export interface AgentDiscoveryResult {
-	agents: AgentConfig[];
-	projectAgentsDir: string | null;
-	builtinAgentsDir: string;
-}
-
-const THINKING_LEVELS = new Set([
-	"off",
-	"minimal",
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max",
-]);
-
-export function getBuiltinAgentsDir(): string {
-	return path.join(
-		path.dirname(fileURLToPath(import.meta.url)),
-		"..",
-		"agents",
-	);
-}
-
-function loadAgentsFromDir(
-	dir: string,
-	source: AgentConfig["source"],
-): AgentConfig[] {
-	if (!fs.existsSync(dir)) return [];
-
-	let entries: fs.Dirent[];
-	try {
-		entries = fs.readdirSync(dir, { withFileTypes: true });
-	} catch {
-		return [];
-	}
-
-	const agents: AgentConfig[] = [];
-	for (const entry of entries) {
-		if (!entry.name.endsWith(".md")) continue;
-		if (!entry.isFile() && !entry.isSymbolicLink()) continue;
-
-		const filePath = path.join(dir, entry.name);
-		let content: string;
-		try {
-			content = fs.readFileSync(filePath, "utf-8");
-		} catch {
-			continue;
-		}
-
-		const { frontmatter, body } = parseFrontmatter<Record<string, string>>(
-			content,
-		);
-		if (!frontmatter.name || !frontmatter.description) continue;
-
-		const tools = frontmatter.tools
-			?.split(",")
-			.map((tool) => tool.trim())
-			.filter(Boolean);
-
-		const systemPromptMode =
-			frontmatter.systemPromptMode === "append" ? "append" : "replace";
-
-		agents.push({
-			name: frontmatter.name,
-			description: frontmatter.description,
-			tools: tools && tools.length > 0 ? tools : undefined,
-			model: frontmatter.model,
-			thinking: frontmatter.thinking,
-			systemPromptMode,
-			systemPrompt: body,
-			source,
-			filePath,
-		});
-	}
-
-	return agents;
-}
-
-function isDirectory(candidate: string): boolean {
-	try {
-		return fs.statSync(candidate).isDirectory();
-	} catch {
-		return false;
-	}
-}
-
-function findNearestProjectAgentsDir(cwd: string): string | null {
-	let currentDir = cwd;
-	while (true) {
-		const candidate = path.join(currentDir, CONFIG_DIR_NAME, "agents");
-		if (isDirectory(candidate)) return candidate;
-
-		const parentDir = path.dirname(currentDir);
-		if (parentDir === currentDir) return null;
-		currentDir = parentDir;
-	}
-}
-
-export function applyThinkingSuffix(
-	model: string | undefined,
-	thinking: string | undefined,
-): string | undefined {
-	if (!model || !thinking) return model;
-	const colonIdx = model.lastIndexOf(":");
-	if (
-		colonIdx !== -1 &&
-		THINKING_LEVELS.has(model.substring(colonIdx + 1))
-	) {
-		return `${model.slice(0, colonIdx)}:${thinking}`;
-	}
-	return `${model}:${thinking}`;
-}
-
-export function discoverAgents(
-	cwd: string,
-	scope: AgentScope = "both",
-): AgentDiscoveryResult {
-	const builtinAgentsDir = getBuiltinAgentsDir();
-	const userDir = path.join(getAgentDir(), "agents");
-	const projectAgentsDir = findNearestProjectAgentsDir(cwd);
-
-	const builtinAgents = loadAgentsFromDir(builtinAgentsDir, "builtin");
-	const userAgents = scope === "project" ? [] : loadAgentsFromDir(userDir, "user");
-	const projectAgents =
-		scope === "user" || !projectAgentsDir
-			? []
-			: loadAgentsFromDir(projectAgentsDir, "project");
-
-	const agentMap = new Map<string, AgentConfig>();
-	for (const agent of builtinAgents) agentMap.set(agent.name, agent);
-	if (scope === "both" || scope === "user") {
-		for (const agent of userAgents) agentMap.set(agent.name, agent);
-	}
-	if (scope === "both" || scope === "project") {
-		for (const agent of projectAgents) agentMap.set(agent.name, agent);
-	}
-
-	return {
-		agents: Array.from(agentMap.values()),
-		projectAgentsDir,
-		builtinAgentsDir,
-	};
-}
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+	CONFIG_DIR_NAME,
+	getAgentDir,
+	parseFrontmatter,
+} from "@earendil-works/pi-coding-agent";
+import type { AgentScope } from "./types.ts";
+
+export interface AgentConfig {
+	name: string;
+	description: string;
+	tools?: string[];
+	model?: string;
+	thinking?: string;
+	systemPromptMode?: "append" | "replace";
+	systemPrompt: string;
+	source: "builtin" | "user" | "project";
+	filePath: string;
+}
+
+export interface AgentDiscoveryResult {
+	agents: AgentConfig[];
+	projectAgentsDir: string | null;
+	builtinAgentsDir: string;
+}
+
+const THINKING_LEVELS = new Set([
+	"off",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max",
+]);
+
+export function getBuiltinAgentsDir(): string {
+	return path.join(
+		path.dirname(fileURLToPath(import.meta.url)),
+		"..",
+		"agents",
+	);
+}
+
+function loadAgentsFromDir(
+	dir: string,
+	source: AgentConfig["source"],
+): AgentConfig[] {
+	if (!fs.existsSync(dir)) return [];
+
+	let entries: fs.Dirent[];
+	try {
+		entries = fs.readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+
+	const agents: AgentConfig[] = [];
+	for (const entry of entries) {
+		if (!entry.name.endsWith(".md")) continue;
+		if (!entry.isFile() && !entry.isSymbolicLink()) continue;
+
+		const filePath = path.join(dir, entry.name);
+		let content: string;
+		try {
+			content = fs.readFileSync(filePath, "utf-8");
+		} catch {
+			continue;
+		}
+
+		const { frontmatter, body } = parseFrontmatter<Record<string, string>>(
+			content,
+		);
+		if (!frontmatter.name || !frontmatter.description) continue;
+
+		const tools = frontmatter.tools
+			?.split(",")
+			.map((tool) => tool.trim())
+			.filter(Boolean);
+
+		const systemPromptMode =
+			frontmatter.systemPromptMode === "append" ? "append" : "replace";
+
+		agents.push({
+			name: frontmatter.name,
+			description: frontmatter.description,
+			tools: tools && tools.length > 0 ? tools : undefined,
+			model: frontmatter.model,
+			thinking: frontmatter.thinking,
+			systemPromptMode,
+			systemPrompt: body,
+			source,
+			filePath,
+		});
+	}
+
+	return agents;
+}
+
+function isDirectory(candidate: string): boolean {
+	try {
+		return fs.statSync(candidate).isDirectory();
+	} catch {
+		return false;
+	}
+}
+
+function findNearestProjectAgentsDir(cwd: string): string | null {
+	let currentDir = cwd;
+	while (true) {
+		const candidate = path.join(currentDir, CONFIG_DIR_NAME, "agents");
+		if (isDirectory(candidate)) return candidate;
+
+		const parentDir = path.dirname(currentDir);
+		if (parentDir === currentDir) return null;
+		currentDir = parentDir;
+	}
+}
+
+export function applyThinkingSuffix(
+	model: string | undefined,
+	thinking: string | undefined,
+): string | undefined {
+	if (!model || !thinking) return model;
+	const colonIdx = model.lastIndexOf(":");
+	if (
+		colonIdx !== -1 &&
+		THINKING_LEVELS.has(model.substring(colonIdx + 1))
+	) {
+		return `${model.slice(0, colonIdx)}:${thinking}`;
+	}
+	return `${model}:${thinking}`;
+}
+
+export function discoverAgents(
+	cwd: string,
+	scope: AgentScope = "both",
+): AgentDiscoveryResult {
+	const builtinAgentsDir = getBuiltinAgentsDir();
+	const userDir = path.join(getAgentDir(), "agents");
+	const projectAgentsDir = findNearestProjectAgentsDir(cwd);
+
+	const builtinAgents = loadAgentsFromDir(builtinAgentsDir, "builtin");
+	const userAgents = scope === "project" ? [] : loadAgentsFromDir(userDir, "user");
+	const projectAgents =
+		scope === "user" || !projectAgentsDir
+			? []
+			: loadAgentsFromDir(projectAgentsDir, "project");
+
+	const agentMap = new Map<string, AgentConfig>();
+	for (const agent of builtinAgents) agentMap.set(agent.name, agent);
+	if (scope === "both" || scope === "user") {
+		for (const agent of userAgents) agentMap.set(agent.name, agent);
+	}
+	if (scope === "both" || scope === "project") {
+		for (const agent of projectAgents) agentMap.set(agent.name, agent);
+	}
+
+	return {
+		agents: Array.from(agentMap.values()),
+		projectAgentsDir,
+		builtinAgentsDir,
+	};
+}

package/node_modules/@vitos-pizza/subagents/src/async/job-tracker.ts

@@ -1,71 +1,71 @@
-import {
-	SUBAGENT_ASYNC_COMPLETE,
-	SUBAGENT_ASYNC_STARTED,
-} from "../rpc/channels.ts";
-import type { AsyncRunStatus, ExecuteSubagentInput } from "../types.ts";
-
-export interface AsyncJobTracker {
-	track(runId: string, status: AsyncRunStatus): void;
-	update(runId: string, patch: Partial<AsyncRunStatus>): void;
-	get(runId: string): AsyncRunStatus | undefined;
-	list(): AsyncRunStatus[];
-	remove(runId: string): void;
-	clear(): void;
-}
-
-export function createAsyncJobTracker(): AsyncJobTracker {
-	const jobs = new Map<string, AsyncRunStatus>();
-
-	return {
-		track(runId, status) {
-			jobs.set(runId, status);
-		},
-		update(runId, patch) {
-			const current = jobs.get(runId);
-			if (!current) return;
-			jobs.set(runId, { ...current, ...patch, updatedAt: Date.now() });
-		},
-		get(runId) {
-			return jobs.get(runId);
-		},
-		list() {
-			return Array.from(jobs.values());
-		},
-		remove(runId) {
-			jobs.delete(runId);
-		},
-		clear() {
-			jobs.clear();
-		},
-	};
-}
-
-export interface SubagentEventBus {
-	emit(channel: string, payload: unknown): void;
-	on(channel: string, handler: (payload: unknown) => void): () => void;
-}
-
-export function emitAsyncStarted(
-	events: SubagentEventBus | undefined,
-	payload: {
-		id: string;
-		mode: AsyncRunStatus["mode"];
-		sessionId: string | null;
-		agents: string[];
-	},
-): void {
-	events?.emit(SUBAGENT_ASYNC_STARTED, payload);
-}
-
-export function emitAsyncComplete(
-	events: SubagentEventBus | undefined,
-	payload: {
-		id: string;
-		exitCode: number;
-		finalOutput: string;
-	},
-): void {
-	events?.emit(SUBAGENT_ASYNC_COMPLETE, payload);
-}
-
-export type AsyncExecuteInput = ExecuteSubagentInput;
+import {
+	SUBAGENT_ASYNC_COMPLETE,
+	SUBAGENT_ASYNC_STARTED,
+} from "../rpc/channels.ts";
+import type { AsyncRunStatus, ExecuteSubagentInput } from "../types.ts";
+
+export interface AsyncJobTracker {
+	track(runId: string, status: AsyncRunStatus): void;
+	update(runId: string, patch: Partial<AsyncRunStatus>): void;
+	get(runId: string): AsyncRunStatus | undefined;
+	list(): AsyncRunStatus[];
+	remove(runId: string): void;
+	clear(): void;
+}
+
+export function createAsyncJobTracker(): AsyncJobTracker {
+	const jobs = new Map<string, AsyncRunStatus>();
+
+	return {
+		track(runId, status) {
+			jobs.set(runId, status);
+		},
+		update(runId, patch) {
+			const current = jobs.get(runId);
+			if (!current) return;
+			jobs.set(runId, { ...current, ...patch, updatedAt: Date.now() });
+		},
+		get(runId) {
+			return jobs.get(runId);
+		},
+		list() {
+			return Array.from(jobs.values());
+		},
+		remove(runId) {
+			jobs.delete(runId);
+		},
+		clear() {
+			jobs.clear();
+		},
+	};
+}
+
+export interface SubagentEventBus {
+	emit(channel: string, payload: unknown): void;
+	on(channel: string, handler: (payload: unknown) => void): () => void;
+}
+
+export function emitAsyncStarted(
+	events: SubagentEventBus | undefined,
+	payload: {
+		id: string;
+		mode: AsyncRunStatus["mode"];
+		sessionId: string | null;
+		agents: string[];
+	},
+): void {
+	events?.emit(SUBAGENT_ASYNC_STARTED, payload);
+}
+
+export function emitAsyncComplete(
+	events: SubagentEventBus | undefined,
+	payload: {
+		id: string;
+		exitCode: number;
+		finalOutput: string;
+	},
+): void {
+	events?.emit(SUBAGENT_ASYNC_COMPLETE, payload);
+}
+
+export type AsyncExecuteInput = ExecuteSubagentInput;