@gajae-code/coding-agent 0.18.1 → 0.18.6

package/src/tools/bash.ts

@@ -10,10 +10,28 @@ import { type BashArtifactSaveResult, type BashResult, executeBash } from "../ex
 
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { buildGjcRuntimeSessionEnv } from "../gjc-runtime/goal-mode-request";
+import {
+	MANAGED_OWNER_PREDECESSOR_GENERATION_ENV,
+	MANAGED_OWNER_PREDECESSOR_INCARNATION_ENV,
+	MANAGED_OWNER_PREDECESSOR_RUN_ID_ENV,
+	MANAGED_OWNER_PREDECESSOR_TOKEN_ENV,
+	MANAGED_OWNER_TRANSCRIPT_PATH_ENV,
+} from "../gjc-runtime/managed-owner-admission";
+import {
+	MANAGED_OWNER_CHILD_TOKEN_ENV,
+	MANAGED_OWNER_COMMAND_ENV,
+	MANAGED_OWNER_GENERATION_ENV,
+	MANAGED_OWNER_INCARNATION_ENV,
+	MANAGED_OWNER_REDACT_COMMAND_ENV,
+	MANAGED_OWNER_RUN_ID_ENV,
+	MANAGED_OWNER_STATE_DIR_ENV,
+} from "../gjc-runtime/managed-owner-supervisor";
 import {
 	GJC_RALPLAN_ARTIFACT_ENV,
 	GJC_RESTRICTED_ROLE_AGENT_BASH_ENV,
 } from "../gjc-runtime/restricted-role-agent-bash";
+import { GJC_TMUX_OWNER_SERVER_KEY_ENV } from "../gjc-runtime/session-state-sidecar";
+import { GJC_TMUX_LAUNCHED_ENV } from "../gjc-runtime/windows-powershell-command";
 import { InternalUrlRouter } from "../internal-urls";
 import { truncateToVisualLines } from "../modes/components/visual-truncate";
 import { highlightCode, type Theme } from "../modes/theme/theme";
@@ -94,6 +112,29 @@ const ARTIFACT_SAVE_DIAGNOSTIC_MAX_BYTES = 256;
 const BASH_ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 const MASTER_CAPABILITY_ENV = "GJC_MASTER_CAPABILITY";
 const MASTER_OWNER_SESSION_ENV = "GJC_MASTER_OWNER_SESSION_ID";
+// Managed-owner env vars that must be scrubbed from child processes.
+// Exported for testing the env scrubbing behavior.
+export const MANAGED_OWNER_BASH_ENV = [
+	MANAGED_OWNER_STATE_DIR_ENV,
+	MANAGED_OWNER_GENERATION_ENV,
+	MANAGED_OWNER_RUN_ID_ENV,
+	MANAGED_OWNER_INCARNATION_ENV,
+	MANAGED_OWNER_CHILD_TOKEN_ENV,
+	MANAGED_OWNER_COMMAND_ENV,
+	MANAGED_OWNER_REDACT_COMMAND_ENV,
+	MANAGED_OWNER_PREDECESSOR_TOKEN_ENV,
+	MANAGED_OWNER_PREDECESSOR_GENERATION_ENV,
+	MANAGED_OWNER_PREDECESSOR_RUN_ID_ENV,
+	MANAGED_OWNER_PREDECESSOR_INCARNATION_ENV,
+	MANAGED_OWNER_TRANSCRIPT_PATH_ENV,
+	// The rest of the tmux-owner tuple (tmux-sessions.ts managedEnvironment): leaving
+	// either behind makes ownerTerminalContextFromEnvironment() report "invalid" in a
+	// nested gjc, because a server key or GJC_TMUX_LAUNCHED=1 without generation/state
+	// dir is an incomplete owner context.
+	GJC_TMUX_OWNER_SERVER_KEY_ENV,
+	GJC_TMUX_LAUNCHED_ENV,
+] as const;
+
 const COORDINATOR_ONLY_BASH_ENV = [
 	"GJC_COORDINATOR_SESSION_STATE_FILE",
 	"GJC_COORDINATOR_SESSION_ID",
@@ -102,6 +143,8 @@ const COORDINATOR_ONLY_BASH_ENV = [
 	"GJC_COORDINATOR_SESSION_READINESS_FILE",
 	"GJC_COORDINATOR_SIDECAR_SIGNATURE_REQUIRED",
 	"GJC_COORDINATOR_SIDECAR_KEY_ID",
+	// Managed-owner env family from managed-owner-supervisor.ts and managed-owner-admission.ts
+	...MANAGED_OWNER_BASH_ENV,
 ] as const;
 const DEFAULT_AUTO_BACKGROUND_THRESHOLD_MS = 60_000;
 const ACP_RELEASE_TIMEOUT_MS = 1_000;
@@ -1239,7 +1282,7 @@ export class BashTool implements AgentTool<BashToolSchema, BashToolDetails> {
 	 */
 	async #waitForManagedBashJob(
 		job: ManagedBashJobHandle,
-		thresholdMs: number,
+		thresholdMs: number | undefined,
 		signal?: AbortSignal,
 		backgroundRequest?: Promise<FoldReason>,
 		foldAdapter?: FoldAdapter,
@@ -1249,31 +1292,36 @@ export class BashTool implements AgentTool<BashToolSchema, BashToolDetails> {
 		}
 
 		const startedAt = Date.now();
-		const threshold = Promise.withResolvers<{ kind: "running"; reason: FoldReason }>();
-		const thresholdTimer = setTimeout(
-			() => {
-				const requestFold = this.session.requestForegroundBashBackground;
-				if (!foldAdapter || !requestFold) {
-					threshold.resolve({ kind: "running", reason: "timer" });
-					return;
-				}
-				void requestFold("timer", foldAdapter)
-					.then(folded => {
-						if (!folded) threshold.resolve({ kind: "running", reason: "timer" });
-					})
-					.catch(error => {
-						logger.warn("Timer-triggered fold failed", {
-							jobId: foldAdapter.jobId,
-							error: error instanceof Error ? error.message : String(error),
-						});
-						threshold.resolve({ kind: "running", reason: "timer" });
-					});
-			},
-			Math.max(0, thresholdMs),
-		);
+		const threshold =
+			thresholdMs === undefined ? undefined : Promise.withResolvers<{ kind: "running"; reason: FoldReason }>();
+		const thresholdTimer =
+			threshold === undefined
+				? undefined
+				: setTimeout(
+						() => {
+							const requestFold = this.session.requestForegroundBashBackground;
+							if (!foldAdapter || !requestFold) {
+								threshold.resolve({ kind: "running", reason: "timer" });
+								return;
+							}
+							void requestFold("timer", foldAdapter)
+								.then(folded => {
+									if (!folded) threshold.resolve({ kind: "running", reason: "timer" });
+								})
+								.catch(error => {
+									logger.warn("Timer-triggered fold failed", {
+										jobId: foldAdapter.jobId,
+										error: error instanceof Error ? error.message : String(error),
+									});
+									threshold.resolve({ kind: "running", reason: "timer" });
+								});
+						},
+						Math.max(0, thresholdMs ?? 0),
+					);
 		const waiters: Array<
 			Promise<ManagedBashJobCompletion | { kind: "running"; reason: FoldReason } | { kind: "aborted" }>
-		> = [job.completion, threshold.promise];
+		> = [job.completion];
+		if (threshold) waiters.push(threshold.promise);
 		if (backgroundRequest) {
 			waiters.push(backgroundRequest.then(reason => ({ kind: "running" as const, reason })));
 		}
@@ -1294,7 +1342,7 @@ export class BashTool implements AgentTool<BashToolSchema, BashToolDetails> {
 			return await Promise.race(waiters);
 		} finally {
 			stopSteerWatch();
-			clearTimeout(thresholdTimer);
+			if (thresholdTimer !== undefined) clearTimeout(thresholdTimer);
 			if (signal && onAbort) signal.removeEventListener("abort", onAbort);
 		}
 	}
@@ -1855,11 +1903,11 @@ export class BashTool implements AgentTool<BashToolSchema, BashToolDetails> {
 		// longer has to be bypassed to make folding work. A capable ACP session keeps
 		// its terminal contract and still folds.
 		if (!pty && ownedManager && !clientTerminalActive) {
-			// With auto-background off, wait past the command's own timeout so the job only
-			// leaves the foreground on an explicit Ctrl+B fold, never on an auto-background timer.
+			// With auto-background off, the foreground wait has no timer threshold, so the job
+			// only leaves the foreground on an explicit Ctrl+B or steer fold.
 			const autoBackgroundWaitMs = this.#autoBackgroundEnabled
 				? this.#resolveAutoBackgroundWaitMs(timeoutMs)
-				: timeoutMs + 1_000;
+				: undefined;
 			const startBackgrounded = autoBackgroundWaitMs === 0;
 			let managedForegroundSettled = false;
 			const job = this.#startManagedBashJob({
@@ -2561,7 +2609,7 @@ export class BashTool implements AgentTool<BashToolSchema, BashToolDetails> {
 			try {
 				bridgeWait = await this.#waitForManagedBashJob(
 					bridgeHandle,
-					this.#autoBackgroundEnabled ? this.#resolveAutoBackgroundWaitMs(timeoutMs) : timeoutMs + 1_000,
+					this.#autoBackgroundEnabled ? this.#resolveAutoBackgroundWaitMs(timeoutMs) : undefined,
 					signal,
 					bridgeFoldRequest.promise,
 					bridgeFoldAdapter,

package/src/tools/descriptors.test.ts

@@ -736,6 +736,35 @@ describe("tool descriptor compatibility gate", () => {
 			}),
 		).toThrow('Validation failed for tool "ask"');
 	});
+	test("loaded and deferred asks reject missing interview metadata and empty siblings with actionable corrections", async () => {
+		for (const stage of ["topology", "post-topology"] as const) {
+			const session = makeSession({ "tools.discoveryMode": "all" });
+			session.hasUI = true;
+			session.getDeepInterviewAskStage = () => stage;
+			const eager = await BUILTIN_TOOL_DESCRIPTORS.ask.load(session);
+			const lazy = (await createTools(session)).find(tool => tool.name === "ask");
+			if (!eager || !lazy) throw new Error("expected eager and deferred asks");
+			const ordinary = {
+				id: "dot-gjc-topology",
+				question: "Round 0 | Topology confirmation\n\nDoes this scope match?",
+				options: [{ label: "Looks right" }],
+				workflowGate: { stage: "deep-interview", kind: "question" },
+			};
+			for (const [arguments_, correction] of [
+				[{ questions: [ordinary] }, "require structured deepInterview metadata"],
+				[{ questions: [{ ...ordinary, deepInterview: null }] }, "require structured deepInterview metadata"],
+				[{ questions: [ordinary, { id: "metadata", question: "", options: [] }] }, "remove empty extra questions"],
+				[{ questions: [ordinary, ordinary] }, "require exactly one question"],
+			] as const) {
+				for (const tool of [eager, lazy]) {
+					expect(() =>
+						validateToolArguments(tool, { type: "toolCall", id: "incident", name: "ask", arguments: arguments_ }),
+					).toThrow(correction);
+				}
+			}
+		}
+	});
+
 	test("deferred ask validation matches eager AskTool on adversarial contracts", async () => {
 		const session = makeSession({ "tools.discoveryMode": "all" });
 		session.hasUI = true;

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

@@ -310,7 +310,7 @@ export const TOOL_CATALOG: Readonly<Record<string, ToolCatalogEntry>> = {
 	"ask": {
 		"name": "ask",
 		"label": "Ask",
-		"description": "Asks user when you need clarification or input during task execution.\n\n<conditions>\n- Multiple approaches exist with significantly different tradeoffs user should weigh\n</conditions>\n\n<instruction>\n- Use `recommended: <index>` to mark default (0-indexed); \" (Recommended)\" added automatically\n- Use `questions` for multiple related questions instead of asking one at a time\n- Set `multi: true` on question to allow multiple selections\n</instruction>\n\n<caution>\n- Provide 2-5 concise, distinct options\n</caution>\n\n<critical>\n- **Default to action.** Resolve ambiguity yourself using repo conventions, existing patterns, and reasonable defaults. Exhaust existing sources (code, configs, docs, history) before asking. Only ask when options have materially different tradeoffs the user must decide.\n- **If multiple choices are acceptable**, pick the most conservative/standard option and proceed; state the choice.\n- **Do NOT include the automatic custom-input control or labels that imitate it** such as \"Other (type your own)\", \"Other (specify)\", \"type your own\", \"custom input\", or \"직접 입력\" — UI automatically adds \"Other (type your own)\" to every question. A plain domain value such as \"Other\" is allowed when it is a genuine answer, not a request for free text. To collect free text, ask for it in the question body and rely on the automatic Other/custom-input control instead of adding a fake option.\n</critical>\n\n<examples>\n# Single question\nquestions: [{\"id\": \"auth_method\", \"question\": \"Which authentication method should this API use?\", \"options\": [{\"label\": \"JWT\"}, {\"label\": \"OAuth2\"}, {\"label\": \"Session cookies\"}], \"recommended\": 0}]\n\n# Multiple questions\nquestions: [{\"id\": \"storage_type\", \"question\": \"Which storage backend?\", \"options\": [{\"label\": \"SQLite\"}, {\"label\": \"PostgreSQL\"}]}, {\"id\": \"auth_method\", \"question\": \"Which auth method?\", \"options\": [{\"label\": \"JWT\"}, {\"label\": \"Session cookies\"}]}]\n</examples>",
+		"description": "Asks user when you need clarification or input during task execution.\n\n<conditions>\n- Multiple approaches exist with significantly different tradeoffs user should weigh\n</conditions>\n\n<instruction>\n- Use `recommended: <index>` to mark default (0-indexed); \" (Recommended)\" added automatically\n- Use `questions` for multiple related questions instead of asking one at a time\n- Set `multi: true` on question to allow multiple selections\n- Every question body must contain meaningful, non-whitespace text. Never add empty `metadata`/`ignore` questions.\n- While deep-interview is in the `interviewing` phase, submit exactly one question with the required `deepInterview` metadata on that question. Round 0 needs `round: 0`, `component: \"review-topology\"`, `dimension: \"topology\"`, `ambiguity`, and `intent_contract` containing the displayed items and affirmative labels. Later questions need a positive round, component, dimension, and ambiguity. Question prose and `workflowGate` alone cannot record an interview answer. After final-spec persistence transitions to `handoff`, next-workflow/approval choices are ordinary asks without interview round metadata.\n</instruction>\n\n<caution>\n- Provide 2-5 concise, distinct options\n</caution>\n\n<critical>\n- **Default to action.** Resolve ambiguity yourself using repo conventions, existing patterns, and reasonable defaults. Exhaust existing sources (code, configs, docs, history) before asking. Only ask when options have materially different tradeoffs the user must decide.\n- **If multiple choices are acceptable**, pick the most conservative/standard option and proceed; state the choice.\n- **Do NOT include the automatic custom-input control or labels that imitate it** such as \"Other (type your own)\", \"Other (specify)\", \"type your own\", \"custom input\", or \"직접 입력\" — UI automatically adds \"Other (type your own)\" to every question. A plain domain value such as \"Other\" is allowed when it is a genuine answer, not a request for free text. To collect free text, ask for it in the question body and rely on the automatic Other/custom-input control instead of adding a fake option.\n</critical>\n\n<examples>\n# Single question\nquestions: [{\"id\": \"auth_method\", \"question\": \"Which authentication method should this API use?\", \"options\": [{\"label\": \"JWT\"}, {\"label\": \"OAuth2\"}, {\"label\": \"Session cookies\"}], \"recommended\": 0}]\n\n# Multiple questions\nquestions: [{\"id\": \"storage_type\", \"question\": \"Which storage backend?\", \"options\": [{\"label\": \"SQLite\"}, {\"label\": \"PostgreSQL\"}]}, {\"id\": \"auth_method\", \"question\": \"Which auth method?\", \"options\": [{\"label\": \"JWT\"}, {\"label\": \"Session cookies\"}]}]\n</examples>",
 		"parameters": {
 			"type": "object",
 			"properties": {
@@ -326,7 +326,8 @@ export const TOOL_CATALOG: Readonly<Record<string, ToolCatalogEntry>> = {
 							},
 							"question": {
 								"type": "string",
-								"description": "question text"
+								"minLength": 1,
+								"description": "non-empty question text"
 							},
 							"options": {
 								"type": "array",
@@ -2660,7 +2661,8 @@ export const TOOL_CATALOG: Readonly<Record<string, ToolCatalogEntry>> = {
 					"description": "recency filter"
 				},
 				"limit": {
-					"type": "number",
+					"type": "integer",
+					"minimum": 1,
 					"description": "max results"
 				},
 				"max_tokens": {
@@ -2672,7 +2674,8 @@ export const TOOL_CATALOG: Readonly<Record<string, ToolCatalogEntry>> = {
 					"description": "sampling temperature"
 				},
 				"num_search_results": {
-					"type": "number",
+					"type": "integer",
+					"minimum": 1,
 					"description": "number of search results"
 				},
 				"xai_search_mode": {

package/src/web/search/index.ts

@@ -44,10 +44,10 @@ import {
 export const webSearchSchema = z.object({
 	query: z.string().describe("search query"),
 	recency: z.enum(["day", "week", "month", "year"]).describe("recency filter").optional(),
-	limit: z.number().describe("max results").optional(),
+	limit: z.number().int().min(1).describe("max results").optional(),
 	max_tokens: z.number().describe("max output tokens").optional(),
 	temperature: z.number().describe("sampling temperature").optional(),
-	num_search_results: z.number().describe("number of search results").optional(),
+	num_search_results: z.number().int().min(1).describe("number of search results").optional(),
 	xai_search_mode: z
 		.enum(["web", "x", "web_and_x"])
 		.describe("xAI only: use web_search, x_search, or both")

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
-`);
-}