@gajae-code/coding-agent 0.12.21 → 0.13.0

package/src/cli.ts

@@ -5,9 +5,11 @@
  * lightweight CLI runner from pi-utils.
  */
 import "@gajae-code/utils/postmortem";
-import { Args, type CliConfig, Command, type CommandEntry, Flags, run } from "@gajae-code/utils/cli";
+import { Args, type CliConfig, Command, type CommandEntry, run } from "@gajae-code/utils/cli";
 import { APP_NAME, formatBunRuntimeError, MIN_BUN_VERSION, VERSION } from "@gajae-code/utils/dirs";
 import { runFixtureReport } from "./cli/fixture-report";
+import { ROOT_LAUNCH_FLAGS } from "./cli/root-flags";
+import QuickLane from "./commands/quick-lane";
 import { smokeTestTabWorker } from "./tools/browser/tab-worker-smoke";
 
 if (Bun.semver.order(Bun.version, MIN_BUN_VERSION) < 0) {
@@ -24,7 +26,6 @@ if (Bun.semver.order(Bun.version, MIN_BUN_VERSION) < 0) {
 process.title = APP_NAME;
 const rootHelpFlags = ["--help", "-h", "help"];
 const versionFlags = ["--version", "-v"];
-const THINKING_EFFORTS = ["minimal", "low", "medium", "high", "xhigh", "max"] as const;
 const MANAGED_OWNER_SUPERVISOR_ARG = "--internal-managed-owner-supervisor";
 const MANAGED_OWNER_CHILD_TOKEN_ENV = "GJC_MANAGED_OWNER_CHILD_TOKEN";
 const TMUX_OWNER_ISOLATION_ARG = "--internal-tmux-owner-isolation";
@@ -66,6 +67,7 @@ export const commands: CommandEntry[] = [
 	{ name: "plugin", load: () => import("./commands/plugin").then(m => m.default) },
 	{ name: "completion", load: () => import("./commands/completion").then(m => m.default) },
 	{ name: "launch", load: () => import("./commands/launch").then(m => m.default) },
+	{ name: "quick-lane", load: async () => QuickLane },
 ];
 
 async function showHelp(config: CliConfig): Promise<void> {
@@ -221,21 +223,52 @@ async function runMemoryGuardNativeSmokeFastPathFromCli(): Promise<void> {
 	runMemoryGuardNativeSmoke();
 }
 
+function isLaunchWorktreeSelector(arg: string): boolean {
+	return (
+		arg === "--worktree" ||
+		arg === "-w" ||
+		arg.startsWith("--worktree=") ||
+		arg.startsWith("-w=") ||
+		(arg.startsWith("-w") && arg.length > 2)
+	);
+}
+
+function rootFlagDescriptor(arg: string) {
+	if (arg.startsWith("--") && !arg.includes("="))
+		return ROOT_LAUNCH_FLAGS[arg.slice(2) as keyof typeof ROOT_LAUNCH_FLAGS];
+	if (/^-[^-]$/.test(arg))
+		return Object.values(ROOT_LAUNCH_FLAGS).find(descriptor => descriptor.char === arg.slice(1));
+	return undefined;
+}
+
+function rootFlagValueIndex(argv: readonly string[], index: number): number {
+	const descriptor = rootFlagDescriptor(argv[index] ?? "");
+	if (!descriptor || descriptor.kind === "boolean") return index;
+	const value = argv[index + 1];
+	return value && !value.startsWith("-") ? index + 1 : index;
+}
+
 function rootFixtureArg(argv: string[]): { present: boolean; id: string | undefined } {
 	for (let i = 0; i < argv.length; i++) {
-		const arg = argv[i];
-		// Stop at the first subcommand token so a `--fixture` flag belonging to a
-		// subcommand never hijacks the root fast-path into fixture-report mode.
-		if (isSubcommand(arg)) return { present: false, id: undefined };
+		const arg = argv[i] ?? "";
+		if (arg === "--" || isSubcommand(arg)) return { present: false, id: undefined };
 		if (arg === "--fixture") return { present: true, id: argv[i + 1] };
+		const descriptor = rootFlagDescriptor(arg);
+		if (descriptor && descriptor.kind !== "boolean") {
+			const value = argv[i + 1];
+			if (!value || value.startsWith("-")) return { present: false, id: undefined };
+			i++;
+		}
 	}
 	return { present: false, id: undefined };
 }
 
 function hasRootFastFlag(argv: string[], flags: readonly string[]): boolean {
-	for (const arg of argv) {
-		if (isSubcommand(arg)) return false;
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i] ?? "";
+		if (arg === "--" || isSubcommand(arg) || isLaunchWorktreeSelector(arg)) return false;
 		if (flags.includes(arg)) return true;
+		i = rootFlagValueIndex(argv, i);
 	}
 	return false;
 }
@@ -258,63 +291,7 @@ export class RootHelpCommand extends Command {
 			multiple: true,
 		}),
 	};
-	static flags = {
-		model: Flags.string({ description: 'Model to use (fuzzy match: "opus", "gpt-5.2", or "openai/gpt-5.2")' }),
-		smol: Flags.string({ description: "Smol/fast model for lightweight tasks (or GJC_SMOL_MODEL env)" }),
-		slow: Flags.string({ description: "Slow/reasoning model for thorough analysis (or GJC_SLOW_MODEL env)" }),
-		plan: Flags.string({ description: "Plan model for architectural planning (or GJC_PLAN_MODEL env)" }),
-		mpreset: Flags.string({ description: "Model profile preset to activate for this session" }),
-		default: Flags.boolean({ description: "Persist --mpreset as the default model profile" }),
-		provider: Flags.string({ description: "Provider to use (legacy; prefer --model)" }),
-		"api-key": Flags.string({ description: "API key (defaults to env vars)" }),
-		credential: Flags.string({
-			description:
-				"Stored credential selector: email:<addr>, id:<n>, account:<id>, project:<id>, or provider/email:<addr>",
-		}),
-		"system-prompt": Flags.string({ description: "System prompt (default: coding assistant prompt)" }),
-		"append-system-prompt": Flags.string({ description: "Append text or file contents to the system prompt" }),
-		"mcp-config": Flags.string({ description: "Tools-only MCP config file (absolute path)" }),
-		"clipboard-transport": Flags.string({
-			description: "Clipboard transport: auto (default), native, osc52, or ssh",
-			options: ["auto", "native", "osc52", "ssh"],
-		}),
-		"clipboard-ssh-host": Flags.string({
-			description: "SSH host alias for --clipboard-transport ssh (from ~/.ssh/config)",
-		}),
-		"allow-home": Flags.boolean({ description: "Allow starting in ~ without auto-switching to a temp dir" }),
-		mode: Flags.string({
-			description: "Output mode: text (default), json, or acp",
-			options: ["text", "json", "acp"],
-		}),
-		print: Flags.boolean({ char: "p", description: "Non-interactive mode: process prompt and exit" }),
-		continue: Flags.boolean({ char: "c", description: "Continue previous session" }),
-		resume: Flags.string({ char: "r", description: "Resume a session (by ID prefix, path, or picker if omitted)" }),
-		"session-dir": Flags.string({ description: "Directory for session storage and lookup" }),
-		"no-session": Flags.boolean({ description: "Don't save session (ephemeral)" }),
-		models: Flags.string({ description: "Comma-separated model patterns for Alt+N cycling" }),
-		"no-tools": Flags.boolean({ description: "Disable all built-in tools" }),
-		"no-lsp": Flags.boolean({ description: "Disable LSP tools, formatting, and diagnostics" }),
-		"no-pty": Flags.boolean({ description: "Disable PTY-based interactive bash execution" }),
-		tmux: Flags.boolean({ description: "Launch interactive startup inside tmux" }),
-		tools: Flags.string({ description: "Comma-separated list of tools to enable (default: all)" }),
-		thinking: Flags.string({
-			description: `Set thinking level: ${THINKING_EFFORTS.join(", ")}`,
-			options: [...THINKING_EFFORTS],
-		}),
-		hook: Flags.string({ description: "Load a hook/extension file (can be used multiple times)", multiple: true }),
-		extension: Flags.string({
-			char: "e",
-			description: "Load an extension file (can be used multiple times)",
-			multiple: true,
-		}),
-		"no-extensions": Flags.boolean({ description: "Disable extension discovery (explicit -e paths still work)" }),
-		"no-skills": Flags.boolean({ description: "Disable skills discovery and loading" }),
-		skills: Flags.string({ description: "Comma-separated glob patterns to filter skills (e.g., git-*,docker)" }),
-		"no-rules": Flags.boolean({ description: "Disable rules discovery and loading" }),
-		export: Flags.string({ description: "Export session file to HTML and exit" }),
-		"list-models": Flags.string({ description: "List available models (with optional fuzzy search)" }),
-		"no-title": Flags.boolean({ description: "Disable title auto-generation" }),
-	};
+	static flags = ROOT_LAUNCH_FLAGS;
 	static examples = [
 		`# Interactive mode\n  ${APP_NAME}`,
 		`# Interactive mode with initial prompt\n  ${APP_NAME} "List all .ts files in src/"`,

package/src/commands/acp.ts

@@ -15,7 +15,7 @@ export default class Acp extends Command {
 
 	async run(): Promise<void> {
 		const { args, terminalAuth } = prepareAcpTerminalAuthArgs(this.argv);
-		const parsed = parseArgs(args);
+		const parsed = parseArgs(args, terminalAuth ? "local" : "acp");
 		if (parsed.unknownFlags.size > 0) {
 			throw new CliParseError(`Unknown ACP option: ${[...parsed.unknownFlags.keys()].join(", ")}`);
 		}

package/src/commands/daemon.ts

@@ -11,9 +11,8 @@ import {
 import type { DaemonKind } from "../daemon/control-types";
 import { DAEMON_ACTION_TOKENS, resolveDaemonAction } from "../daemon/operator-contract";
 import { initTheme } from "../modes/theme/theme";
-import { runSdkSessionCli } from "../sdk/cli";
 
-const ACTIONS = [...DAEMON_ACTION_TOKENS, "discord-internal", "slack-internal", "session"] as const;
+const ACTIONS = [...DAEMON_ACTION_TOKENS, "discord-internal", "slack-internal"] as const;
 
 function parsePositiveTimeout(raw: string | undefined, flagName: string): number | undefined {
 	if (raw === undefined) return undefined;
@@ -29,7 +28,7 @@ function parsePositiveTimeout(raw: string | undefined, flagName: string): number
 
 export default class Daemon extends Command {
 	static description =
-		"Manage GJC background daemons and SDK sessions. Routine use: `gjc daemon status` to check, `gjc daemon restart` to reload (spawns one if none is running). `stop`/`list` and the escalation flags below are advanced primitives.";
+		"Manage GJC background daemons. Routine use: `gjc daemon status` to check, `gjc daemon restart` to reload (spawns one if none is running). `stop`/`list` and the escalation flags below are advanced primitives.";
 
 	static examples = [
 		"# Check the daemon (concise per-daemon result)\n  gjc daemon status",
@@ -59,16 +58,6 @@ export default class Daemon extends Command {
 		smoke: Flags.boolean({ description: "Internal: run worker smoke without configuration or network" }),
 		"owner-id": Flags.string({ description: "Internal: daemon owner id" }),
 		"agent-dir": Flags.string({ description: "Internal: daemon state directory" }),
-		op: Flags.string({ description: "SDK control or global operation" }),
-		"idempotency-key": Flags.string({ description: "Caller idempotency key required for SDK lifecycle globals" }),
-		"json-input": Flags.string({ description: "SDK request JSON object" }),
-		"json-input-file": Flags.string({ description: "Read SDK request JSON from a 0600 file" }),
-		"json-input-stdin": Flags.boolean({ description: "Read SDK request JSON from standard input" }),
-		confirm: Flags.boolean({ description: "Confirm a destructive SDK control operation" }),
-		query: Flags.string({ description: "SDK query name" }),
-		cursor: Flags.string({ description: "SDK query continuation cursor" }),
-		"show-endpoint-credential": Flags.boolean({ description: "Allow session.get_endpoint secret output" }),
-		yes: Flags.boolean({ description: "Confirm endpoint credential output on a TTY" }),
 	};
 
 	async run(): Promise<void> {
@@ -81,24 +70,6 @@ export default class Daemon extends Command {
 			"--graceful-timeout-ms",
 		);
 		const killTimeoutMs = parsePositiveTimeout(flagRec["kill-timeout-ms"] as string | undefined, "--kill-timeout-ms");
-		if (rawAction === "session") {
-			await runSdkSessionCli({
-				action: positional[0],
-				sessionId: positional[1],
-				operation: flagRec.op as string | undefined,
-				query: flagRec.query as string | undefined,
-				jsonInput: flagRec["json-input"] as string | undefined,
-				jsonInputFile: flagRec["json-input-file"] as string | undefined,
-				jsonInputStdin: Boolean(flagRec["json-input-stdin"]),
-				confirm: Boolean(flagRec.confirm),
-				idempotencyKey: flagRec["idempotency-key"] as string | undefined,
-				cursor: flagRec.cursor as string | undefined,
-				showEndpointCredential: Boolean(flagRec["show-endpoint-credential"]),
-				yes: Boolean(flagRec.yes),
-				agentDir: flagRec["agent-dir"] as string | undefined,
-			});
-			return;
-		}
 		const action = (resolveDaemonAction(rawAction) ?? rawAction) as DaemonCommandAction;
 		const kinds = positional as DaemonKind[];
 		const cmd: DaemonCommandArgs = {

package/src/commands/gc.ts

@@ -26,7 +26,7 @@ export default class Gc extends Command {
 		force: Flags.boolean({ description: "Alias for --prune (eligible records only)", default: false }),
 		"dry-run": Flags.boolean({ description: "Force report-only mode", default: false }),
 		disk: Flags.boolean({
-			description: "Also report on-disk retention (sessions, blobs, natives, backups)",
+			description: "Also report on-disk retention (sessions, blobs, artifacts, natives, backups)",
 			default: false,
 		}),
 		"repair-session-index": Flags.boolean({

package/src/commands/launch.ts

@@ -4,10 +4,10 @@
 
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { THINKING_EFFORTS } from "@gajae-code/ai/core";
 import { APP_NAME, setProjectDir } from "@gajae-code/utils";
-import { Args, Command, Flags } from "@gajae-code/utils/cli";
-import { parseArgs } from "../cli/args";
+import { Args, Command } from "@gajae-code/utils/cli";
+import { assertLocalLaunchArgs, parseArgs } from "../cli/args";
+import { ROOT_LAUNCH_FLAGS } from "../cli/root-flags";
 import { launchDefaultTmuxIfNeeded } from "../gjc-runtime/launch-tmux";
 import { type PreparedLaunchWorktree, prepareLaunchWorktree } from "../gjc-runtime/launch-worktree";
 import {
@@ -70,130 +70,7 @@ export default class Index extends Command {
 		}),
 	};
 
-	static flags = {
-		model: Flags.string({
-			description: 'Model to use (fuzzy match: "opus", "gpt-5.2", or "openai/gpt-5.2")',
-		}),
-		smol: Flags.string({
-			description: "Smol/fast model for lightweight tasks (or GJC_SMOL_MODEL env)",
-		}),
-		slow: Flags.string({
-			description: "Slow/reasoning model for thorough analysis (or GJC_SLOW_MODEL env)",
-		}),
-		plan: Flags.string({
-			description: "Plan model for architectural planning (or GJC_PLAN_MODEL env)",
-		}),
-		mpreset: Flags.string({
-			description: "Model profile preset to activate for this session",
-		}),
-		default: Flags.boolean({
-			description: "Persist --mpreset as the default model profile",
-		}),
-		provider: Flags.string({
-			description: "Provider to use (legacy; prefer --model)",
-		}),
-		"api-key": Flags.string({
-			description: "API key (defaults to env vars)",
-		}),
-		credential: Flags.string({
-			description:
-				"Stored credential selector: email:<addr>, id:<n>, account:<id>, project:<id>, or provider/email:<addr>",
-		}),
-		"system-prompt": Flags.string({
-			description: "System prompt (default: coding assistant prompt)",
-		}),
-		"append-system-prompt": Flags.string({
-			description: "Append text or file contents to the system prompt",
-		}),
-		"mcp-config": Flags.string({
-			description: "Tools-only MCP config file (absolute path)",
-		}),
-		"clipboard-transport": Flags.string({
-			description: "Clipboard transport: auto (default), native, osc52, or ssh",
-			options: ["auto", "native", "osc52", "ssh"],
-		}),
-		"clipboard-ssh-host": Flags.string({
-			description: "SSH host alias for --clipboard-transport ssh (from ~/.ssh/config)",
-		}),
-		"allow-home": Flags.boolean({
-			description: "Allow starting in ~ without auto-switching to a temp dir",
-		}),
-		mode: Flags.string({
-			description: "Output mode: text (default), json, or acp",
-			options: ["text", "json", "acp"],
-		}),
-		print: Flags.boolean({
-			char: "p",
-			description: "Non-interactive mode: process prompt and exit",
-		}),
-		continue: Flags.boolean({
-			char: "c",
-			description: "Continue previous session",
-		}),
-		resume: Flags.string({
-			char: "r",
-			description: "Resume a session (by ID prefix, path, or picker if omitted)",
-		}),
-		"session-dir": Flags.string({
-			description:
-				"Explicit session storage directory and lookup override (default uses managed v2 workspace scope)",
-		}),
-		"no-session": Flags.boolean({
-			description: "Don't save session (ephemeral)",
-		}),
-		models: Flags.string({
-			description: "Comma-separated model patterns for Alt+N cycling",
-		}),
-		"no-tools": Flags.boolean({
-			description: "Disable all built-in tools",
-		}),
-		"no-lsp": Flags.boolean({
-			description: "Disable LSP tools, formatting, and diagnostics",
-		}),
-		"no-pty": Flags.boolean({
-			description: "Disable PTY-based interactive bash execution",
-		}),
-		tmux: Flags.boolean({
-			description: "Launch interactive startup inside tmux",
-		}),
-		tools: Flags.string({
-			description: "Comma-separated list of tools to enable (default: all)",
-		}),
-		thinking: Flags.string({
-			description: `Set thinking level: ${THINKING_EFFORTS.join(", ")}`,
-			options: [...THINKING_EFFORTS],
-		}),
-		hook: Flags.string({
-			description: "Load a hook/extension file (can be used multiple times)",
-			multiple: true,
-		}),
-		extension: Flags.string({
-			char: "e",
-			description: "Load an extension file (can be used multiple times)",
-			multiple: true,
-		}),
-		"no-extensions": Flags.boolean({
-			description: "Disable extension discovery (explicit -e paths still work)",
-		}),
-		"no-skills": Flags.boolean({
-			description: "Disable skills discovery and loading",
-		}),
-		skills: Flags.string({
-			description: "Comma-separated glob patterns to filter skills (e.g., git-*,docker)",
-		}),
-		"no-rules": Flags.boolean({
-			description: "Disable rules discovery and loading",
-		}),
-		export: Flags.string({
-			description: "Export session file to HTML and exit",
-		}),
-		"list-models": Flags.string({
-			description: "List available models (with optional fuzzy search)",
-		}),
-		"no-title": Flags.boolean({
-			description: "Disable title auto-generation",
-		}),
-	};
+	static flags = ROOT_LAUNCH_FLAGS;
 
 	static examples = [
 		`# Interactive mode\n  ${APP_NAME}`,
@@ -215,7 +92,8 @@ export default class Index extends Command {
 
 	async run(): Promise<void> {
 		const { args } = prepareAcpTerminalAuthArgs(this.argv);
-		const parsed = parseArgs([...args]);
+		const parsed = parseArgs([...args], "deferred");
+		if (parsed.mode !== "acp") assertLocalLaunchArgs(parsed);
 		if (parsed.help || parsed.version) {
 			await runRootCommand(parsed, args);
 			return;
@@ -232,7 +110,8 @@ export default class Index extends Command {
 			process.chdir(launch.cwd);
 			setProjectDir(launch.cwd);
 		}
-		const launchParsed = parseArgs(launch.args);
+		const launchParsed = parseArgs(launch.args, "deferred");
+		if (launchParsed.mode !== "acp") assertLocalLaunchArgs(launchParsed);
 		if (
 			launchDefaultTmuxIfNeeded({
 				parsed: launchParsed,

package/src/commands/quick-lane.ts

@@ -0,0 +1,51 @@
+/**
+ * Quick-lane task classification (issue #3984).
+ *
+ * Read-only classification surface for the quick lane: prints whether a task
+ * request is eligible for the quick lane (bounded, direct execution) or must
+ * keep the existing deep path (planning/interview). This performs no routing
+ * and mutates nothing — it only exposes the deterministic classifier so task
+ * classification can be inspected, audited, and consumed by tooling.
+ */
+import { Args, Command, Flags } from "@gajae-code/utils/cli";
+import { classifyQuickLane } from "../quick-lane/classify";
+
+export default class QuickLane extends Command {
+	static description =
+		"Classify a task into the quick lane (bounded, direct execution) or the deep path (planning/interview)";
+
+	static args = {
+		action: Args.string({ description: "Action", required: true, options: ["classify"] }),
+		text: Args.string({ description: "Task text", required: true, multiple: true }),
+	};
+
+	static flags = {
+		json: Flags.boolean({ description: "Output the decision as JSON" }),
+	};
+
+	static examples = [
+		`$ gjc quick-lane classify "add validation to processKeywordDetector"`,
+		`$ gjc quick-lane classify --json "fix src/hooks/bridge.ts"`,
+		`$ gjc quick-lane classify "team make it better"`,
+	];
+
+	async run(): Promise<void> {
+		const { args, flags } = await this.parse(QuickLane);
+		const text = (Array.isArray(args.text) ? args.text.join(" ") : (args.text ?? "")).trim();
+		const decision = classifyQuickLane(text);
+
+		if (flags.json) {
+			process.stdout.write(`${JSON.stringify(decision, null, 2)}\n`);
+			return;
+		}
+
+		const lines = [`lane: ${decision.lane}`];
+		if (decision.reasons.length > 0) {
+			lines.push(`reasons:\n${decision.reasons.map(reason => `  - ${reason}`).join("\n")}`);
+		}
+		if (decision.exclusions.length > 0) {
+			lines.push(`exclusions:\n${decision.exclusions.map(exclusion => `  - ${exclusion}`).join("\n")}`);
+		}
+		process.stdout.write(`${lines.join("\n")}\n`);
+	}
+}