@gajae-code/coding-agent 0.18.0 → 0.18.5

package/src/tools/session-descriptions.ts

@@ -0,0 +1,135 @@
+/**
+ * Session-dependent descriptions for tools whose prompt text varies with session settings.
+ *
+ * A discoverable tool is advertised before its implementation loads. The facade renders these
+ * descriptions from the session itself, so the text sent before the first call is the text the
+ * loaded tool reports afterwards, and the provider-visible `tools` block (and with it the
+ * prompt-cache prefix) does not change when the implementation loads (#5992).
+ */
+import { parseFrontmatter, prompt } from "@gajae-code/utils";
+import architectAgent from "../prompts/agents/architect.md" with { type: "text" };
+import criticAgent from "../prompts/agents/critic.md" with { type: "text" };
+import executorAgent from "../prompts/agents/executor.md" with { type: "text" };
+import plannerAgent from "../prompts/agents/planner.md" with { type: "text" };
+import evalDescription from "../prompts/tools/eval.md" with { type: "text" };
+import searchDescription from "../prompts/tools/search.md" with { type: "text" };
+import taskDescription from "../prompts/tools/task.md" with { type: "text" };
+import { getTaskSimpleModeCapabilities, type TaskSimpleMode } from "../task/simple-mode";
+import { getTaskSchema, type TaskToolSchemaInstance } from "../task/types";
+import { resolveFileDisplayMode } from "../utils/file-display-mode";
+import { resolveEvalBackends } from "./eval-backends";
+
+interface DescriptionSettings {
+	get(
+		key:
+			| "task.maxConcurrency"
+			| "task.isolation.mode"
+			| "task.simple"
+			| "task.disabledAgents"
+			| "eval.py"
+			| "eval.js"
+			| "readLineNumbers"
+			| "readHashLines"
+			| "edit.mode",
+	): unknown;
+	getEffectiveAutorouting(): { active: boolean };
+}
+
+interface DescriptionSession {
+	settings: DescriptionSettings;
+	getSessionSpawns?: () => string | null;
+	hasEditTool?: boolean;
+}
+
+interface BundledAgentName {
+	name: string;
+	hide?: boolean;
+}
+
+function parseBundledAgentName(markdown: string): BundledAgentName {
+	const { frontmatter } = parseFrontmatter(markdown, { level: "fatal" });
+	const { name, hide } = frontmatter;
+	if (typeof name !== "string") {
+		throw new Error("Bundled task agent frontmatter must include a name");
+	}
+	return { name, hide: hide === true };
+}
+
+// Read only each role's frontmatter; importing task/agents would also load and render the full prompts.
+const BUNDLED_AGENT_NAMES = [
+	parseBundledAgentName(executorAgent),
+	parseBundledAgentName(architectAgent),
+	parseBundledAgentName(plannerAgent),
+	parseBundledAgentName(criticAgent),
+];
+
+export interface EvalToolDescriptionOptions {
+	py?: boolean;
+	js?: boolean;
+}
+
+export function getEvalToolDescription(options: EvalToolDescriptionOptions = {}): string {
+	const py = options.py ?? true;
+	const js = options.js ?? true;
+	return prompt.render(evalDescription, { py, js });
+}
+
+export function evalToolDescriptionForSession(session: DescriptionSession | null | undefined): string {
+	if (!session) return getEvalToolDescription();
+	const backends = resolveEvalBackends({ settings: session.settings } as Parameters<typeof resolveEvalBackends>[0]);
+	return getEvalToolDescription({ py: backends.python, js: backends.js });
+}
+
+export function searchToolDescriptionForSession(session: DescriptionSession): string {
+	const displayMode = resolveFileDisplayMode(session);
+	return prompt.render(searchDescription, {
+		IS_HL_MODE: displayMode.hashLines,
+		IS_LINE_NUMBER_MODE: !displayMode.hashLines && displayMode.lineNumbers,
+	});
+}
+
+export function renderTaskDescription(session: DescriptionSession): string {
+	const simpleMode = session.settings.get("task.simple") as TaskSimpleMode;
+	const { contextEnabled, customSchemaEnabled } = getTaskSimpleModeCapabilities(simpleMode);
+	const isolationMode = session.settings.get("task.isolation.mode");
+	const parentSpawns = session.getSessionSpawns?.() ?? "*";
+	const spawningDisabled = parentSpawns === "";
+	const disabledSetting = session.settings.get("task.disabledAgents");
+	const disabledAgents = Array.isArray(disabledSetting)
+		? disabledSetting.filter((agent): agent is string => typeof agent === "string")
+		: [];
+	const allowedSpawns =
+		parentSpawns === "*"
+			? undefined
+			: new Set(
+					parentSpawns
+						.split(",")
+						.map(agent => agent.trim())
+						.filter(Boolean),
+				);
+	const agents = BUNDLED_AGENT_NAMES.filter(
+		agent =>
+			agent.hide !== true &&
+			!disabledAgents.includes(agent.name) &&
+			(allowedSpawns === undefined || allowedSpawns.has(agent.name)),
+	);
+	return prompt.render(taskDescription, {
+		agents: agents.map(({ name }) => ({ name })),
+		spawningDisabled,
+		MAX_CONCURRENCY: session.settings.get("task.maxConcurrency"),
+		isolationEnabled: isolationMode !== "none",
+		asyncEnabled: true,
+		contextEnabled,
+		customSchemaEnabled,
+		defaultMode: simpleMode === "default",
+		schemaFreeMode: simpleMode === "schema-free",
+		independentMode: simpleMode === "independent",
+		autoroutingActive: session.settings.getEffectiveAutorouting().active,
+	});
+}
+
+export function taskParametersForSession(session?: DescriptionSession): TaskToolSchemaInstance {
+	const simpleMode = session ? (session.settings.get("task.simple") as TaskSimpleMode) : "default";
+	const isolationMode = session?.settings.get("task.isolation.mode");
+	return getTaskSchema({ isolationEnabled: session !== undefined && isolationMode !== "none", simpleMode });
+}

package/src/tools/tool-catalog.generated.ts

@@ -2095,7 +2095,7 @@ export const TOOL_CATALOG: Readonly<Record<string, ToolCatalogEntry>> = {
 	"task": {
 		"name": "task",
 		"label": "Task",
-		"description": "Launches subagents to parallelize workflows.\n\n- Results are delivered automatically when complete.\n- The tool result lists the assigned task ids (e.g. `0-AuthLoader`) — those are the live agent ids.\n- Use `subagent` action `inspect` or `list` to snapshot manager state.\n- To wait or cancel, use the `subagent` tool; its await/cancel doctrine is authoritative.\n\nSubagents have no conversation history. Every fact, file path, and direction they need MUST be explicit in `context` or `assignment`.\n\n<parameters>\n- `agent`: agent type for all tasks\n- `tasks`: tasks to execute in parallel\n - `.id`: filesystem-safe, ≤48 chars, matching `[A-Za-z0-9][A-Za-z0-9_-]*`; prefer CamelCase\n - `.description`: UI label only — subagent never sees it\n - `.assignment`: complete self-contained instructions; one-liners and missing acceptance criteria are PROHIBITED\n- `context`: shared background prepended to every assignment; session-specific only\n- `.inheritContext` (optional): fork-context mode for seeding the subagent with sanitized parent conversation. Omit it or set `\"none\"` for no copied context. `\"receipt\"` copies a minimal receipt-sized snapshot, `\"last-turn\"` copies only the latest exchange, `\"bounded\"` copies the bounded default snapshot, and `\"full\"` copies a larger snapshot up to the configured/model token cap. Non-`none` modes work only when global `task.forkContext.enabled` is true and the target agent declares `forkContext: allowed`; otherwise the call is rejected. Bundled agents that support it: `executor`, `architect`. Use inherited context only when the subagent's value depends on parent context; cloned tokens are billed to the child as fresh input and surfaced in task receipts as fork-context cloned-token accounting.\n\n- `schema`: JTD schema for expected structured output (do not put format rules in assignments)\n- `spawnPlan` (optional): required before any batch with more than 4 tasks; include whyParallel, whyNotLocal, independence, expectedReceiptShape, and maxInlineTokens.\n\n- `repositoryBinding`: optional authoritative repository/worktree identity. It must match the active session and cannot authorize a foreign repository from this session. For another approved repository, start a fresh session rooted there (for example, `gjc --cwd <approved-worktree>`); do not use `/move` because materialized tasks retain their original binding.\n</parameters>\n\n<rules>\n- HARD runtime gate: calls with more than 4 tasks are rejected before any child launches unless `spawnPlan` is complete.\n- NEVER assign tasks to run project-wide build/test/lint. Caller verifies after the batch.\n- **Subagents do not verify, lint, or format.** Every assignment MUST instruct the subagent to skip all gates and formatters. You run them once at the end across the union of changed files — avoids redundant runs and racing formatter passes.\n- Each task: ≤3–5 explicit files. No globs, no \"update all\", no package-wide scope. Fan out to a cluster instead.\n- Pass large payloads via `local://<path>` URIs, not inline.\n- Put shared constraints in `context` once; do not duplicate across assignments.\n- Prefer agents that investigate **and** edit in one pass; only spin a read-only discovery step when affected files are genuinely unknown.\n</rules>\n\n<parallelization>\nTest: can task B run correctly without seeing A's output? If no, sequence A → B.\nSequential when one task produces a contract (types, API, schema, core module) the other consumes.\nParallel when tasks touch disjoint files or are independent refactors/tests.\n</parallelization>\n\n<context-fmt>\n# Goal         ← one sentence: what the batch accomplishes\n# Constraints  ← MUST/NEVER rules and session decisions\n# Contract     ← exact types/signatures if tasks share an interface\n</context-fmt>\n\n<assignment-fmt>\n# Target       ← exact files and symbols; explicit non-goals\n# Change       ← step-by-step add/remove/rename; APIs and patterns\n# Acceptance   ← observable result; no project-wide commands\n</assignment-fmt>\n\n<agents>\n# executor\nAutonomous implementation agent for bounded code changes, fixes, and verification-ready edits\n\n# architect\nRead-only architecture and code-review agent with severity-rated findings and status verdicts\n\n# planner\nRead-only planning agent for sequencing, acceptance criteria, risks, and handoff shape\n\n# critic\nRead-only plan critic that approves only actionable, verifiable execution plans\n</agents>",
+		"description": "Launches subagents to parallelize workflows.\n\n- Results are delivered automatically when complete.\n- The tool result lists the assigned task ids (e.g. `0-AuthLoader`) — those are the live agent ids.\n- Coordinate with running tasks via `irc` when available, using those ids. `subagent` cancel terminates a task and **cannot carry a message**.\n- Use `subagent` action `inspect` or `list` to snapshot manager state.\n- To wait or cancel, use the `subagent` tool; its await/cancel doctrine is authoritative.\n\nSubagents have no conversation history. Every fact, file path, and direction they need MUST be explicit in `context` or `assignment`.\nUse `irc` for live coordination when it is available.\n\n<parameters>\n- `agent`: agent type for all tasks\n- `tasks`: tasks to execute in parallel\n - `.id`: filesystem-safe, ≤48 chars, matching `[A-Za-z0-9][A-Za-z0-9_-]*`; prefer CamelCase\n - `.description`: UI label only — subagent never sees it\n - `.assignment`: complete self-contained instructions; one-liners and missing acceptance criteria are PROHIBITED\n- `context`: shared background prepended to every assignment; session-specific only\n- `.inheritContext` (optional): fork-context mode for seeding the subagent with sanitized parent conversation. Omit it or set `\"none\"` for no copied context. `\"receipt\"` copies a minimal receipt-sized snapshot, `\"last-turn\"` copies only the latest exchange, `\"bounded\"` copies the bounded default snapshot, and `\"full\"` copies a larger snapshot up to the configured/model token cap. Non-`none` modes work only when global `task.forkContext.enabled` is true and the target agent declares `forkContext: allowed`; otherwise the call is rejected. Bundled agents that support it: `executor`, `architect`. Use inherited context only when the subagent's value depends on parent context; cloned tokens are billed to the child as fresh input and surfaced in task receipts as fork-context cloned-token accounting.\n\n- `schema`: JTD schema for expected structured output (do not put format rules in assignments)\n- `spawnPlan` (optional): required before any batch with more than 4 tasks; include whyParallel, whyNotLocal, independence, expectedReceiptShape, and maxInlineTokens.\n\n- `repositoryBinding`: optional authoritative repository/worktree identity. It must match the active session and cannot authorize a foreign repository from this session. For another approved repository, start a fresh session rooted there (for example, `gjc --cwd <approved-worktree>`); do not use `/move` because materialized tasks retain their original binding.\n</parameters>\n\n<rules>\n- HARD runtime gate: calls with more than 4 tasks are rejected before any child launches unless `spawnPlan` is complete.\n- NEVER assign tasks to run project-wide build/test/lint. Caller verifies after the batch.\n- **Subagents do not verify, lint, or format.** Every assignment MUST instruct the subagent to skip all gates and formatters. You run them once at the end across the union of changed files — avoids redundant runs and racing formatter passes.\n- Each task: ≤3–5 explicit files. No globs, no \"update all\", no package-wide scope. Use `irc` to coordinate overlapping work when it is available; otherwise keep file sets independent.\n- Pass large payloads via `local://<path>` URIs, not inline.\n- Put shared constraints in `context` once; do not duplicate across assignments.\n- Prefer agents that investigate **and** edit in one pass; only spin a read-only discovery step when affected files are genuinely unknown.\n</rules>\n\n<parallelization>\nTest: can task B run correctly without seeing A's output? If no, sequence A → B, unless `irc` is available and A can answer a small clarification.\nStill sequence when one task produces a large, evolving contract (generated types, schema migration, core module API); live coordination is not a substitute for a finished contract.\nParallel when tasks touch disjoint files, are independent refactors/tests, or need only occasional peer clarification.\n</parallelization>\n\n<context-fmt>\n# Goal         ← one sentence: what the batch accomplishes\n# Constraints  ← MUST/NEVER rules and session decisions\n# Contract     ← exact types/signatures if tasks share an interface\n</context-fmt>\n\n<assignment-fmt>\n# Target       ← exact files and symbols; explicit non-goals\n# Change       ← step-by-step add/remove/rename; APIs and patterns\n# Acceptance   ← observable result; no project-wide commands\n</assignment-fmt>\n\n<agents>\nBundled role names: executor, architect, planner, critic. A configured agent may override a bundled role name and takes precedence.\nOther configured agents (project, user, plugin) may also be available; calling with an unknown `agent` lists the agents callable in this session.\n</agents>",
 		"parameters": {
 			"type": "object",
 			"properties": {

package/dist/types/cli/grep-cli.d.ts

@@ -1,17 +0,0 @@
-import { GrepOutputMode } from "@gajae-code/natives";
-export interface GrepCommandArgs {
-    pattern: string;
-    path: string;
-    glob?: string;
-    limit: number;
-    context: number;
-    mode: GrepOutputMode;
-    gitignore: boolean;
-}
-/**
- * Parse grep subcommand arguments.
- * Returns undefined if not a grep command.
- */
-export declare function parseGrepArgs(args: string[]): GrepCommandArgs | undefined;
-export declare function runGrepCommand(cmd: GrepCommandArgs): Promise<void>;
-export declare function printGrepHelp(): void;

package/dist/types/cli/shell-cli.d.ts

@@ -1,8 +0,0 @@
-export interface ShellCommandArgs {
-    cwd?: string;
-    timeoutMs?: number;
-    noSnapshot?: boolean;
-}
-export declare function parseShellArgs(args: string[]): ShellCommandArgs | undefined;
-export declare function runShellCommand(cmd: ShellCommandArgs): Promise<void>;
-export declare function printShellHelp(): void;

package/dist/types/commands/grep.d.ts

@@ -1,42 +0,0 @@
-import { Command } from "@gajae-code/utils/cli";
-export default class Grep extends Command {
-    static description: string;
-    static args: {
-        pattern: import("@gajae-code/utils/cli").ArgDescriptor & {
-            description: string;
-            required: false;
-        };
-        path: import("@gajae-code/utils/cli").ArgDescriptor & {
-            description: string;
-            required: false;
-        };
-    };
-    static flags: {
-        glob: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
-            char: string;
-            description: string;
-        };
-        limit: import("@gajae-code/utils/cli").FlagDescriptor<"integer"> & {
-            char: string;
-            description: string;
-            default: number;
-        };
-        context: import("@gajae-code/utils/cli").FlagDescriptor<"integer"> & {
-            char: string;
-            description: string;
-            default: number;
-        };
-        files: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
-            char: string;
-            description: string;
-        };
-        count: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
-            char: string;
-            description: string;
-        };
-        "no-gitignore": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
-            description: string;
-        };
-    };
-    run(): Promise<void>;
-}

package/dist/types/commands/shell.d.ts

@@ -1,21 +0,0 @@
-/**
- * Interactive shell console.
- */
-import { Command } from "@gajae-code/utils/cli";
-export default class Shell extends Command {
-    static description: string;
-    static flags: {
-        cwd: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
-            char: string;
-            description: string;
-        };
-        timeout: import("@gajae-code/utils/cli").FlagDescriptor<"integer"> & {
-            char: string;
-            description: string;
-        };
-        "no-snapshot": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
-            description: string;
-        };
-    };
-    run(): Promise<void>;
-}

package/src/cli/grep-cli.ts

@@ -1,160 +0,0 @@
-/**
- * Grep CLI command handlers.
- *
- * Handles `gjc grep` subcommand for testing grep tool on Windows.
- */
-import * as path from "node:path";
-import { GrepOutputMode, grep } from "@gajae-code/natives";
-import { APP_NAME } from "@gajae-code/utils";
-import chalk from "chalk";
-
-export interface GrepCommandArgs {
-	pattern: string;
-	path: string;
-	glob?: string;
-	limit: number;
-	context: number;
-	mode: GrepOutputMode;
-	gitignore: boolean;
-}
-
-/**
- * Parse grep subcommand arguments.
- * Returns undefined if not a grep command.
- */
-export function parseGrepArgs(args: string[]): GrepCommandArgs | undefined {
-	if (args.length === 0 || args[0] !== "grep") {
-		return undefined;
-	}
-
-	const result: GrepCommandArgs = {
-		pattern: "",
-		path: ".",
-		limit: 20,
-		context: 2,
-		mode: GrepOutputMode.Content,
-		gitignore: true,
-	};
-
-	const positional: string[] = [];
-
-	for (let i = 1; i < args.length; i++) {
-		const arg = args[i];
-		if (arg === "--glob" || arg === "-g") {
-			result.glob = args[++i];
-		} else if (arg === "--limit" || arg === "-l") {
-			result.limit = parseInt(args[++i], 10);
-		} else if (arg === "--context" || arg === "-C") {
-			result.context = parseInt(args[++i], 10);
-		} else if (arg === "--files" || arg === "-f") {
-			result.mode = GrepOutputMode.FilesWithMatches;
-		} else if (arg === "--count" || arg === "-c") {
-			result.mode = GrepOutputMode.Count;
-		} else if (arg === "--no-gitignore") {
-			result.gitignore = false;
-		} else if (!arg.startsWith("-")) {
-			positional.push(arg);
-		}
-	}
-
-	if (positional.length >= 1) {
-		result.pattern = positional[0];
-	}
-	if (positional.length >= 2) {
-		result.path = positional[1];
-	}
-
-	return result;
-}
-
-export async function runGrepCommand(cmd: GrepCommandArgs): Promise<void> {
-	if (!cmd.pattern) {
-		console.error(chalk.red("Error: Pattern is required"));
-		process.exit(1);
-	}
-
-	const searchPath = path.resolve(cmd.path);
-	console.log(chalk.dim(`Searching in: ${searchPath}`));
-	console.log(chalk.dim(`Pattern: ${cmd.pattern}`));
-	console.log(
-		chalk.dim(`Mode: ${cmd.mode}, Limit: ${cmd.limit}, Context: ${cmd.context}, Gitignore: ${cmd.gitignore}`),
-	);
-
-	console.log("");
-
-	try {
-		const result = await grep({
-			pattern: cmd.pattern,
-			path: searchPath,
-			glob: cmd.glob,
-			mode: cmd.mode,
-			maxCount: cmd.limit,
-			context: cmd.mode === GrepOutputMode.Content ? cmd.context : undefined,
-			hidden: true,
-			gitignore: cmd.gitignore,
-		});
-
-		console.log(chalk.green(`Total matches: ${result.totalMatches}`));
-		console.log(chalk.green(`Files with matches: ${result.filesWithMatches}`));
-		console.log(chalk.green(`Files searched: ${result.filesSearched}`));
-		if (result.limitReached) {
-			console.log(chalk.yellow(`Result limit reached (${cmd.limit} matches). Use --limit to show more.`));
-		}
-		console.log("");
-
-		for (const match of result.matches) {
-			const displayPath = match.path.replace(/\\/g, "/");
-
-			if (cmd.mode === GrepOutputMode.Content) {
-				if (match.contextBefore) {
-					for (const ctx of match.contextBefore) {
-						console.log(chalk.dim(`${displayPath}-${ctx.lineNumber}- ${ctx.line}`));
-					}
-				}
-				console.log(`${chalk.cyan(displayPath)}:${chalk.yellow(String(match.lineNumber))}: ${match.line}`);
-				if (match.contextAfter) {
-					for (const ctx of match.contextAfter) {
-						console.log(chalk.dim(`${displayPath}-${ctx.lineNumber}- ${ctx.line}`));
-					}
-				}
-				console.log("");
-			} else if (cmd.mode === GrepOutputMode.Count) {
-				console.log(`${chalk.cyan(displayPath)}: ${match.matchCount ?? 0} matches`);
-			} else {
-				console.log(chalk.cyan(displayPath));
-			}
-		}
-	} catch (err) {
-		console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
-		process.exit(1);
-	}
-}
-
-export function printGrepHelp(): void {
-	console.log(`${chalk.bold(`${APP_NAME} grep`)} - Test grep tool
-
-${chalk.bold("Usage:")}
-  ${APP_NAME} grep <pattern> [path] [options]
-
-${chalk.bold("Arguments:")}
-  pattern   Regex pattern to search for
-  path      Directory or file to search (default: .)
-
-${chalk.bold("Options:")}
-  -g, --glob <pattern>  Filter files by glob pattern
-  -l, --limit <n>       Max matches (default: 20)
-  -C, --context <n>     Context lines (default: 2)
-  -f, --files           Output file names only
-  -c, --count           Output match counts per file
-  -h, --help            Show this help
-  --no-gitignore        Include files excluded by .gitignore
-
-${chalk.bold("Environment:")}
-  PI_GREP_WORKERS=N    Set filesystem walker workers (default 4, 0 = auto)
-
-${chalk.bold("Examples:")}
-  ${APP_NAME} grep "import" src/
-  ${APP_NAME} grep "TODO" . --glob "*.ts"
-  ${APP_NAME} grep "function" --files
-`);
-}

package/src/cli/shell-cli.ts

@@ -1,176 +0,0 @@
-/**
- * Shell CLI command handlers.
- *
- * Handles `gjc shell` subcommand for testing the native brush-core shell.
- */
-import * as path from "node:path";
-import { createInterface } from "node:readline/promises";
-import { Shell } from "@gajae-code/natives";
-import { APP_NAME, getProjectDir } from "@gajae-code/utils";
-import chalk from "chalk";
-import { Settings } from "../config/settings";
-import { buildMinimizerOptions } from "../exec/bash-executor";
-import { getOrCreateSnapshot } from "../utils/shell-snapshot";
-
-export interface ShellCommandArgs {
-	cwd?: string;
-	timeoutMs?: number;
-	noSnapshot?: boolean;
-}
-
-export function parseShellArgs(args: string[]): ShellCommandArgs | undefined {
-	if (args.length === 0 || args[0] !== "shell") {
-		return undefined;
-	}
-
-	const result: ShellCommandArgs = {};
-
-	for (let i = 1; i < args.length; i++) {
-		const arg = args[i];
-		if (arg === "--cwd" || arg === "-C") {
-			result.cwd = args[++i];
-		} else if (arg === "--timeout" || arg === "-t") {
-			const parsed = Number.parseInt(args[++i], 10);
-			if (Number.isFinite(parsed)) {
-				result.timeoutMs = parsed;
-			}
-		} else if (arg === "--no-snapshot") {
-			result.noSnapshot = true;
-		}
-	}
-
-	return result;
-}
-
-export async function runShellCommand(cmd: ShellCommandArgs): Promise<void> {
-	if (!process.stdin.isTTY) {
-		process.stderr.write("Error: shell console requires an interactive TTY.\n");
-		process.exit(1);
-	}
-
-	const cwd = cmd.cwd ? path.resolve(cmd.cwd) : getProjectDir();
-	const settings = await Settings.init({ cwd });
-	const { shell, env: shellEnv } = settings.getShellConfig();
-	const snapshotPath = cmd.noSnapshot || !shell.includes("bash") ? null : await getOrCreateSnapshot(shell, shellEnv);
-	const minimizer = buildMinimizerOptions(settings.getGroup("shellMinimizer"));
-	const shellSession = new Shell({ sessionEnv: shellEnv, snapshotPath: snapshotPath ?? undefined, minimizer });
-
-	let active = false;
-	let lastChar: string | null = null;
-
-	const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: true });
-	const prompt = chalk.cyan(`${APP_NAME} shell> `);
-
-	const printHelp = () => {
-		process.stdout.write(
-			`${chalk.bold("Shell Console Commands")}
-
-` +
-				`${chalk.bold("Special Commands:")}
-  .help           Show this help
-  .exit, exit     Exit the console
-
-` +
-				`${chalk.bold("Options:")}
-  --cwd, -C <path>     Set working directory for commands
-  --timeout, -t <ms>   Timeout per command in milliseconds
-  --no-snapshot        Skip sourcing snapshot from user shell
-
-` +
-				`${chalk.bold("Notes:")}
-  Runs in a persistent brush-core shell session.
-  Variables and functions defined in one command persist for the next.
-
-`,
-		);
-	};
-
-	const interruptHandler = () => {
-		if (active) {
-			void shellSession.abort();
-			return;
-		}
-		rl.close();
-		process.exit(0);
-	};
-
-	process.on("SIGINT", interruptHandler);
-	process.stdout.write(chalk.dim("Type .help for commands.\n"));
-
-	try {
-		while (true) {
-			const line = (await rl.question(prompt)).trim();
-			if (!line) {
-				continue;
-			}
-			if (line === ".help") {
-				printHelp();
-				continue;
-			}
-			if (line === ".exit" || line === "exit" || line === "quit") {
-				break;
-			}
-
-			active = true;
-			lastChar = null;
-			try {
-				const result = await shellSession.run(
-					{
-						command: line,
-						cwd,
-						timeoutMs: cmd.timeoutMs,
-					},
-					(err, chunk) => {
-						if (err) {
-							process.stderr.write(`${err.message}\n`);
-							return;
-						}
-						if (chunk.length > 0) {
-							lastChar = chunk[chunk.length - 1] ?? null;
-						}
-						process.stdout.write(chunk);
-					},
-				);
-
-				if (lastChar && lastChar !== "\n") {
-					process.stdout.write("\n");
-				}
-
-				if (result.timedOut) {
-					process.stderr.write(chalk.yellow("Command timed out.\n"));
-				} else if (result.cancelled) {
-					process.stderr.write(chalk.yellow("Command cancelled.\n"));
-				} else if (result.exitCode !== 0 && result.exitCode !== undefined) {
-					process.stderr.write(chalk.yellow(`Exit code: ${result.exitCode}\n`));
-				}
-			} catch (err) {
-				const message = err instanceof Error ? err.message : String(err);
-				process.stderr.write(chalk.red(`Error: ${message}\n`));
-			} finally {
-				active = false;
-			}
-		}
-	} finally {
-		process.off("SIGINT", interruptHandler);
-		rl.close();
-	}
-}
-
-export function printShellHelp(): void {
-	process.stdout.write(`${chalk.bold(`${APP_NAME} shell`)} - Interactive shell console for testing
-
-${chalk.bold("Usage:")}
-  ${APP_NAME} shell [options]
-
-${chalk.bold("Options:")}
-  --cwd, -C <path>     Set working directory for commands
-  --timeout, -t <ms>   Timeout per command in milliseconds
-  --no-snapshot        Skip sourcing snapshot from user shell
-  -h, --help           Show this help
-
-${chalk.bold("Examples:")}
-  ${APP_NAME} shell
-  ${APP_NAME} shell --cwd ./tmp
-  ${APP_NAME} shell --timeout 2000
-`);
-}

package/src/commands/grep.ts

@@ -1,48 +0,0 @@
-/**
- * Test grep tool.
- */
-import { GrepOutputMode } from "@gajae-code/natives";
-import { Args, Command, Flags } from "@gajae-code/utils/cli";
-import { type GrepCommandArgs, runGrepCommand } from "../cli/grep-cli";
-import { initTheme } from "../modes/theme/theme";
-
-export default class Grep extends Command {
-	static description = "Test grep tool";
-
-	static args = {
-		pattern: Args.string({ description: "Regex pattern to search for", required: false }),
-		path: Args.string({ description: "Directory or file to search", required: false }),
-	};
-
-	static flags = {
-		glob: Flags.string({ char: "g", description: "Filter files by glob pattern" }),
-		limit: Flags.integer({ char: "l", description: "Max matches", default: 20 }),
-		context: Flags.integer({ char: "C", description: "Context lines", default: 2 }),
-		files: Flags.boolean({ char: "f", description: "Output file names only" }),
-		count: Flags.boolean({ char: "c", description: "Output match counts per file" }),
-		"no-gitignore": Flags.boolean({ description: "Include files excluded by .gitignore" }),
-	};
-
-	async run(): Promise<void> {
-		const { args, flags } = await this.parse(Grep);
-
-		const mode: GrepCommandArgs["mode"] = flags.count
-			? GrepOutputMode.Count
-			: flags.files
-				? GrepOutputMode.FilesWithMatches
-				: GrepOutputMode.Content;
-
-		const cmd: GrepCommandArgs = {
-			pattern: args.pattern ?? "",
-			path: args.path ?? ".",
-			glob: flags.glob,
-			limit: flags.limit,
-			context: flags.context,
-			mode,
-			gitignore: !flags["no-gitignore"],
-		};
-
-		await initTheme();
-		await runGrepCommand(cmd);
-	}
-}

package/src/commands/shell.ts

@@ -1,29 +0,0 @@
-/**
- * Interactive shell console.
- */
-import { Command, Flags } from "@gajae-code/utils/cli";
-import { runShellCommand, type ShellCommandArgs } from "../cli/shell-cli";
-import { initTheme } from "../modes/theme/theme";
-
-export default class Shell extends Command {
-	static description = "Interactive shell console";
-
-	static flags = {
-		cwd: Flags.string({ char: "C", description: "Set working directory for commands" }),
-		timeout: Flags.integer({ char: "t", description: "Timeout per command in milliseconds" }),
-		"no-snapshot": Flags.boolean({ description: "Skip sourcing snapshot from user shell" }),
-	};
-
-	async run(): Promise<void> {
-		const { flags } = await this.parse(Shell);
-
-		const cmd: ShellCommandArgs = {
-			cwd: flags.cwd,
-			timeoutMs: flags.timeout,
-			noSnapshot: flags["no-snapshot"],
-		};
-
-		await initTheme();
-		await runShellCommand(cmd);
-	}
-}