@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/bin/cli.js

@@ -1,5 +1,812 @@
 #!/usr/bin/env node
-"use strict";var G=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const L=G(require("node:fs")),re=G(require("node:path")),P=require("../payloads/read-stdin-json"),ne=require("../commands/doctor"),se=require("../commands/init-workspace"),U=require("../commands/inspect"),oe=require("../commands/imports-command"),ie=require("../commands/declaration-command"),ae=require("../commands/config-command"),ce=require("../commands/control-plane-command"),ue=require("../commands/background-command"),de=require("../commands/diagnostics-command"),le=require("../commands/execution-command"),fe=require("../commands/feedback-command"),pe=require("../commands/observability-command"),me=require("../commands/worker-command"),_e=require("../commands/generate-docs-command"),Ce=require("../commands/help-command"),Ie=require("../commands/runtime-command"),Ee=require("../commands/host-command"),ve=require("../commands/ota-command"),we=require("../commands/reveal-command"),Se=require("../commands/result-view"),he=require("../commands/quick-read"),V=require("../commands/captured-input"),H=require("../commands/session-workspace"),J=require("../commands/session-workspace"),K=require("../config/path-aliases"),A=require("../session/client"),ye=require("../session/server"),ge=require("../commands/module-plan-cache"),z=require("../config/resolve-command-alias"),Ne=require("../config/auto-start-ide"),o=require("../config/env-vars"),Q=require("../client/transport-options"),g=require("../shared/errors"),w=require("../shared/metrics"),X=require("../shared/presentation"),Y=require("../tracing/config"),F=require("../tracing/trace"),k=require("../rg-wrapper/core"),be=require("../rg-wrapper/options"),T=require("../rtk-wrapper/core"),Z=require("../runtime/input-source");function Le(e){return e.ok===!1}let x=null,D=Date.now();function xe(e){const n=[];let i=process.cwd(),r,p,d=process.env[o.CLI_ENV.metrics]==="1",l=(0,Q.parseExtensionTransport)(process.env[o.CLI_ENV.transport])??void 0,E,h,_;for(let C=0;C<e.length;C+=1){const f=e[C];if(f){if(f==="--"&&(n[0]==="rg"||(0,T.isRtkPassthroughCommand)(n[0]??""))){n.push(f,...e.slice(C+1));break}if(f==="--cwd"){const m=e[C+1];if(!m)throw new g.CliError("MISSING_FLAG_VALUE","Expected a value after --cwd.");i=m,C+=1;continue}if(f==="--instance"){const m=e[C+1];if(!m)throw new g.CliError("MISSING_FLAG_VALUE","Expected a value after --instance.");r=m,C+=1;continue}if(f==="--session"||f==="-s"){const m=e[C+1];if(!m)throw new g.CliError("MISSING_FLAG_VALUE",`Expected a value after ${f}.`);p=m,C+=1;continue}if(f==="--metrics"){d=!0;continue}if(f==="--dsl"||f==="--force-dsl"){_="dsl";continue}if(f==="--stdin-format"){const m=e[C+1];if(m!=="auto"&&m!=="dsl")throw new g.CliError("INVALID_STDIN_FORMAT","Expected --stdin-format to be auto or dsl.");_=m,C+=1;continue}if(f==="--trace-dir"){const m=e[C+1];if(!m)throw new g.CliError("MISSING_FLAG_VALUE","Expected a value after --trace-dir.");h=m,C+=1;continue}if(f==="--auto-start-ide"){E="serve-web";continue}if(f==="--no-auto-start-ide"){E="off";continue}if(f==="--transport"){const m=e[C+1],s=(0,Q.parseExtensionTransport)(m);if(!s)throw new g.CliError("INVALID_TRANSPORT","Expected --transport to be either http or websocket.");l=s,C+=1;continue}n.push(f)}}const b=process.env[o.CLI_ENV.traceDir];return{commandArgs:n,cwd:i,instanceId:r,sessionId:p,metricsEnabled:d,transport:l,autoStartIde:(0,Ne.resolveAutoStartIdePolicy)(E),trace:(0,Y.resolveTraceConfig)(i,{...h!==void 0?{flagTraceDir:h}:{},...b!==void 0?{envTraceDir:b}:{}}),..._!==void 0?{stdinFormat:_}:{}}}async function De(){D=Date.now();const e=(0,w.metricsNow)(),n=[],{commandArgs:i,cwd:r,instanceId:p,sessionId:d,metricsEnabled:l,transport:E,autoStartIde:h,trace:_,stdinFormat:b}=xe(process.argv.slice(2));await(0,J.runWithSessionOverride)(d,async()=>{const[C,...f]=i,m=(0,w.metricsNow)(),s=await(0,z.resolveCanonicalCommandAlias)(C??"ping",r,p,h);if(l&&(0,w.recordSpan)(n,"cli.aliasResolution",m),s==="rg"){Fe(r,f);return}if((0,T.isRtkPassthroughCommand)(s)){Te(s,r,f);return}const q=(0,P.stripStdinFormatFlags)(f),u=q.restArgs;if((0,z.isRemovedAgentCommand)(s))throw new g.CliError("UNKNOWN_COMMAND",`Unknown command: ${s}`,{availableCommands:["doctor","diagnostics","listInstances","ping","runtimeInfo","printConfig","init-skill-usage","init","help","generate-docs","config","qr","git","gh","docker","kubectl","jest","vitest","playwright","pytest","go","cargo","rake","lint","biome","tsc","next","prettier","ruff","golangci-lint","rubocop","sync","reveal","inspect","imports","view","execution","file","move","rename","refactor","modulePlan","session","runtime","host","trace","control-plane","background","worker","ota","observability","feedback","note"]});if(s==="session"&&(u[0]??"status")==="serve"){await(0,ye.runSessionServerCli)();return}if(s==="trace"){const t=(0,Y.runTraceCommand)(r,u,_);a(t);return}if(s==="control-plane"){const t=await(0,ce.runControlPlaneCommand)(r,u);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="background"){const t=(0,ue.runBackgroundCommand)(r,u);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="worker"){const t=(0,me.runWorkerCommand)(r,u);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="host"){const t=(0,Ee.runHostCommand)(u);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="ota"){const t=await(0,ve.runOtaCommand)(u);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="diagnostics"){await(0,de.runDiagnosticsCommand)(u);return}if(s==="observability"){M(r,s,u,_);const t=(0,pe.runObservabilityCommand)(r,u);a(t);return}if(s==="feedback"||s==="note"){M(r,s,u,_);const t=(0,fe.runFeedbackCommand)(r,u,s);a(t);return}if(s==="init"){const t=(0,se.runInitWorkspace)(r,u);a(t);return}if(s==="help"){const t=(0,Ce.runHelpCommand)(u);a(t);return}if(s==="generate-docs"){const t=(0,_e.runGenerateDocsCommand)(r,u);a(t);return}if(s==="config"){M(r,s,u,_);const t=(0,ae.runConfigCommand)(r,u);a(t);return}if(s==="runtime"){const t=await(0,Ie.runRuntimeCommand)(r,u);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="reveal"){M(r,s,u,_);const t=(0,we.runRevealCommand)(r,u);a(t);return}if(s==="qr"){const t=u.includes("--stdin")?await(0,P.readRawStdinText)():void 0;x=(0,F.startTrace)({cwd:r,argv:process.argv.slice(2),command:s,restArgs:u,..._.absoluteTraceDir!==void 0?{traceDir:_.absoluteTraceDir}:_.traceDir!==void 0?{traceDir:_.traceDir}:{},...t!==void 0?{stdinSource:{format:"qr",text:t}}:{},startedAtMs:D});const I=await(0,he.runQuickReadCommand)(r,u,t!==void 0?{rawStdin:t}:{});I.ok===!1&&(process.exitCode=1),a(I);return}const R=Me(s,u),O=R?(0,J.readEffectiveSessionPathAliases)(r):{},c=R?(0,K.expandPathAliasesInArgs)(r,u,O):u,S=await(0,Z.resolveCommandInputSource)({command:s,cwd:r,restArgs:c,readStdinInput:()=>(0,P.readStdinPayloadWithSource)({command:s,restArgs:c,...q.format!==void 0||b!==void 0?{format:q.format??b}:{}})}),v=R?(0,K.expandPathAliasesInJson)(r,S.payload,O):S.payload;if(x=(0,F.startTrace)({cwd:r,argv:process.argv.slice(2),command:s,restArgs:c,..._.absoluteTraceDir!==void 0?{traceDir:_.absoluteTraceDir}:_.traceDir!==void 0?{traceDir:_.traceDir}:{},...v!==void 0?{stdinPayload:v}:{},...S.source!==void 0?{stdinSource:S.source}:{},startedAtMs:D}),s==="session"){const t=c[0]??"status";if(t==="init"||t==="clear"||t==="where"||t==="read"||t==="write"||t==="prefs"||t==="aliases"||t==="list"||t==="use"){const I=(0,H.runSessionWorkspaceCommand)(r,c,v);a(I);return}if(t==="status"){const I=(0,H.runSessionWorkspaceCommand)(r,c,v),N=await(0,A.getSessionStatus)();a({...I,runtime:qe(N)});return}if(t==="start"){const I=await(0,A.startSession)();a(I);return}if(t==="stop"){const I=await(0,A.stopSession)();a(I);return}throw new g.CliError("UNKNOWN_SESSION_COMMAND",`Unknown aib session command: ${t}`)}if(s==="imports"&&c[0]==="normalize"){const t=(0,V.attachCapturedInput)(r,"imports",v,await(0,oe.runImportsCommand)(r,c,v,{...p!==void 0?{explicitInstanceId:p}:{},autoStartIde:h,...E!==void 0?{transport:E}:{},...l?{metricsEnabled:!0}:{}},l?n:void 0),S.source);a(t);return}if(s==="execution"){const t=(0,le.runExecutionCommand)(r,c);a(t);return}if(s==="view"){const t=(0,Se.runResultViewCommand)(r,c,v);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="declaration"){const t=(0,V.attachCapturedInput)(r,`declaration.${c[0]??"help"}`,v,await(0,ie.runDeclarationCommand)(r,c,v,{...p!==void 0?{explicitInstanceId:p}:{},autoStartIde:h,...E!==void 0?{transport:E}:{},...l?{metricsEnabled:!0}:{}}),S.source);t.ok===!1&&(process.exitCode=1),a(t);return}if(s==="doctor"){const t=c.includes("--progress"),I=c.includes("--json"),N=await(0,ne.runDoctor)({cwd:r,runtime:c.includes("--runtime"),verbose:c.includes("--verbose"),json:I,progress:t});N.ok===!1&&(process.exitCode=1),a(N,void 0,{suppressStdout:t&&!I&&process.env.AIB_FORCE_JSON!=="1"});return}if(s==="inspect"&&(c[0]==="graph"||c[0]==="tree"||c[0]==="cycles")){const t=(0,w.metricsNow)(),I=c[0]==="tree"?"tree":c[0]==="cycles"?"cycles":"graph",N=(0,V.attachCapturedInput)(r,I,v,await(0,U.runInspect)(r,c,v,{...p!==void 0?{explicitInstanceId:p}:{},autoStartIde:h,...E!==void 0?{transport:E}:{},...l?{metricsEnabled:!0}:{}}),S.source);l&&((0,w.recordSpan)(n,"cli.inspectGraph",t),(0,w.recordSpan)(n,"cli.total",e)),a(l?(0,w.appendMetrics)(N,n):N,E);return}if(s==="inspect"&&c.includes("--stdin")&&Re(v)){const t=(0,w.metricsNow)(),I=(0,V.attachCapturedInput)(r,Pe(v),v,await(0,U.runInspect)(r,c,v,{...p!==void 0?{explicitInstanceId:p}:{},autoStartIde:h,...E!==void 0?{transport:E}:{},...l?{metricsEnabled:!0}:{}}),S.source);l&&((0,w.recordSpan)(n,"cli.inspectLocal",t),(0,w.recordSpan)(n,"cli.total",e)),a(l?(0,w.appendMetrics)(I,n):I,E);return}if((0,Z.commandRequiresPayload)(s,c,S))throw new g.CliError("STDIN_REQUIRED",`${s} currently expects a payload on stdin or --from.`);const y={command:s,restArgs:c,cwd:r},W=Ae(s,c);W&&(y.modulePlanExecutionId=W),d!==void 0&&(y.sessionId=d),p!==void 0&&(y.instanceId=p),v!==void 0&&(y.stdinPayload=v),S.source!==void 0&&(y.stdinInputSource=S.source),l&&(y.metricsEnabled=!0),E&&(y.transport=E),y.autoStartIde=h.mode;const B=Ve();Object.keys(B).length>0&&(y.env=B);const te=(0,w.metricsNow)(),$=await(0,A.callSession)(y,l?n:void 0);l&&((0,w.recordSpan)(n,"cli.callSession",te),(0,w.recordSpan)(n,"cli.total",e));const j=l?(0,w.appendMetrics)($,n):$;Le(j)&&(process.exitCode=1),a(j,E)})}function Ve(){const e=[o.CLI_ENV.managedHostScript,o.CLI_ENV.managedHostKind,o.CLI_ENV.managedHostRunDir,o.CLI_ENV.codeServerPath,o.CLI_ENV.extensionVsix,o.CLI_ENV.ideCommand,o.CLI_ENV.chromePath,o.CLI_ENV.managedHostWaitMs,o.CLI_ENV.workspaceRoot,o.CLI_ENV.disableWatchers,o.CLI_ENV.trace,o.CLI_ENV.traceDir,o.CLI_ENV.failureSnapshots,o.CLI_ENV.productStorageDir,o.CLI_ENV.metrics,o.CLI_ENV.metricsDir,o.CLI_ENV.metricsTag,o.CLI_ENV.mutationImpactMetrics,o.CLI_ENV.mutationImpactStream,o.CLI_ENV.testPostMutationCyclesDelayMs,o.CLI_ENV.testRefactorBatchDelayMs,o.CLI_ENV.testRenameDelayMs,o.CLI_ENV.testFileMoveToDirDelayMs,o.CLI_ENV.testFileMoveToDirRowDelayMs,o.CLI_ENV.testFileMoveToDirImportsDelayMs,o.CLI_ENV.testFileMoveToDirFailImports,o.CLI_ENV.testFileRenameDelayMs,o.CLI_ENV.testFileRenameRowDelayMs,o.CLI_ENV.testFileRenameImportsDelayMs,o.CLI_ENV.testFileRenameFailImports,o.CLI_ENV.testFileRefactorBatchDelayMs,o.CLI_ENV.testFileRefactorBatchRowDelayMs,o.CLI_ENV.testFileRefactorBatchImportsDelayMs,o.CLI_ENV.testFileRefactorBatchFailImports,o.CLI_ENV.disableFileMutationImportPostProcess,o.CLI_ENV.disableFileMoveImportPostProcess,o.CLI_ENV.modulePlanSyncWaitMs,o.CLI_ENV.refactorBatchSyncWaitMs,o.CLI_ENV.renameSyncWaitMs,o.CLI_ENV.fileMoveToDirSyncWaitMs,o.CLI_ENV.fileRenameSyncWaitMs,o.CLI_ENV.fileRefactorBatchSyncWaitMs],n={};for(const i of e){const r=process.env[i];r!==void 0&&(n[i]=r)}return n}function Ae(e,n){if(e!=="modulePlan")return null;const i=n[0]??"";return i!=="execute"&&i!=="apply"?null:ke()??(0,ge.buildModulePlanExecutionId)()}function ke(){const e=process.env.AIB_MODULE_PLAN_EXECUTION_ID;return e&&/^exec_[a-z0-9_-]+$/i.test(e)?e:null}function M(e,n,i,r){x=(0,F.startTrace)({cwd:e,argv:process.argv.slice(2),command:n,restArgs:i,...r.absoluteTraceDir!==void 0?{traceDir:r.absoluteTraceDir}:r.traceDir!==void 0?{traceDir:r.traceDir}:{},startedAtMs:D})}function Me(e,n){return e==="session"||e==="execution"||e==="observability"||e==="doctor"||e==="reveal"||e==="view"||e==="declaration"||e==="imports"&&n[0]==="normalize"||e==="inspect"&&(n[0]==="graph"||n[0]==="tree"||n[0]==="cycles"||n[0]==="imports"||n.includes("--stdin"))}function qe(e){if(e.running===!0){const n=e.session&&typeof e.session=="object"&&!Array.isArray(e.session)?e.session:{},i=typeof n.pid=="number"?` pid ${n.pid}`:"",r=typeof n.port=="number"?` port ${n.port}`:"";return`running${i}${r}`.trim()}return e.processAlive===!0&&e.healthy===!1?"unhealthy":"stopped"}function Re(e){return!e||typeof e!="object"||Array.isArray(e)?!1:e.op==="tree"||e.op==="cycles"||e.op==="imports"?!0:Array.isArray(e.requests)&&e.requests.some(n=>n&&typeof n=="object"&&!Array.isArray(n)&&(n.op==="tree"||n.op==="cycles"||n.op==="imports"))}function Pe(e){if(!e||typeof e!="object"||Array.isArray(e))return"inspect";const n=Array.isArray(e.requests)?e.requests.filter(i=>i&&typeof i=="object"&&!Array.isArray(i)):[e];return n.every(i=>i.op==="cycles")?"cycles":n.every(i=>i.op==="tree")?"tree":n.every(i=>i.op==="imports")?"imports":"inspect"}De().catch(e=>{const n=(0,g.errorPayload)(e);a(n),process.exitCode=1});function Fe(e,n){const i=n[0]==="--"?n.slice(1):n,r=ee(),d=(0,k.classifyRgArgs)(i,{hasStdin:r}).mode==="optimizable"?(0,k.runBrgFormatted)({cwd:e,args:i,env:process.env},(0,be.resolveBrgFormatOptions)(e,i,process.env)):r?(0,k.runBrgRaw)({cwd:e,args:i,env:process.env,stdinText:L.default.readFileSync(0,"utf8")}):(0,k.runBrgRawInherited)({cwd:e,args:i,env:process.env,hasStdin:r});if(d.spawnError){process.stderr.write(`aib rg: failed to run rg. Install rg or set ${o.CLI_ENV.rgPath}: ${d.spawnError}
-`),process.exitCode=2;return}d.stdout&&process.stdout.write(d.stdout),d.stderr&&process.stderr.write(d.stderr),process.exitCode=d.exitCode}function Te(e,n,i){const r=i[0]==="--"?i.slice(1):i,p=ee(),d=(0,T.runRtkPassthrough)({tool:e,cwd:n,args:r,env:process.env,...p?{stdinText:L.default.readFileSync(0,"utf8")}:{}});if(d.spawnError){process.stderr.write(`aib ${e}: failed to run rtk. Install rtk or set ${o.CLI_ENV.rtkPath}: ${d.spawnError}
-`),process.exitCode=d.exitCode;return}d.stdout&&process.stdout.write(d.stdout),d.stderr&&process.stderr.write(d.stderr),process.exitCode=d.exitCode}function ee(){try{return!L.default.fstatSync(0).isCharacterDevice()}catch{return process.stdin.isTTY===!1}}function a(e,n,i={}){const r=(0,X.createCliPresentationEnvelope)(e),p=(0,X.presentCliEnvelope)(r,process.env.AIB_FORCE_JSON==="1"?"json":"agent"),d=i.suppressStdout===!0?"":p;x?.enabled&&x.complete({output:r.tracePayload,stdoutText:d,exitCode:e.ok===!1?1:Oe(process.exitCode),durationMs:Date.now()-D,...n?{transport:n}:{}});const l=process.env.AIB_CANONICAL_JSON_PATH;l&&(L.default.mkdirSync(re.default.dirname(l),{recursive:!0}),L.default.writeFileSync(l,`${JSON.stringify(r.tracePayload,null,2)}
-`)),i.suppressStdout!==!0&&process.stdout.write(p)}function Oe(e){return typeof e=="number"?e:0}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const read_stdin_json_1 = require("../payloads/read-stdin-json");
+const doctor_1 = require("../commands/doctor");
+const init_workspace_1 = require("../commands/init-workspace");
+const inspect_1 = require("../commands/inspect");
+const imports_command_1 = require("../commands/imports-command");
+const internal_command_1 = require("../commands/internal-command");
+const declaration_command_1 = require("../commands/declaration-command");
+const mutate_command_1 = require("../commands/mutate-command");
+const config_command_1 = require("../commands/config-command");
+const control_plane_command_1 = require("../commands/control-plane-command");
+const background_command_1 = require("../commands/background-command");
+const diagnostics_command_1 = require("../commands/diagnostics-command");
+const execution_command_1 = require("../commands/execution-command");
+const feedback_command_1 = require("../commands/feedback-command");
+const observability_command_1 = require("../commands/observability-command");
+const worker_command_1 = require("../commands/worker-command");
+const generate_docs_command_1 = require("../commands/generate-docs-command");
+const help_command_1 = require("../commands/help-command");
+const skills_command_1 = require("../commands/skills-command");
+const ota_command_1 = require("../commands/ota-command");
+const reveal_command_1 = require("../commands/reveal-command");
+const result_view_1 = require("../commands/result-view");
+const quick_read_1 = require("../commands/quick-read");
+const captured_input_1 = require("../commands/captured-input");
+const module_plan_cache_1 = require("../commands/module-plan-cache");
+const session_workspace_1 = require("../commands/session-workspace");
+const session_workspace_2 = require("../commands/session-workspace");
+const path_aliases_1 = require("../config/path-aliases");
+const client_1 = require("../session/client");
+const server_1 = require("../session/server");
+const resolve_command_alias_1 = require("../config/resolve-command-alias");
+const env_vars_1 = require("../config/env-vars");
+const errors_1 = require("../shared/errors");
+const metrics_1 = require("../shared/metrics");
+const presentation_1 = require("../shared/presentation");
+const config_1 = require("../tracing/config");
+const trace_1 = require("../tracing/trace");
+const core_1 = require("../rg-wrapper/core");
+const options_1 = require("../rg-wrapper/options");
+const core_2 = require("../rtk-wrapper/core");
+const core_3 = require("../tsc-wrapper/core");
+const input_source_1 = require("../runtime/input-source");
+function isErrorPayload(value) {
+    return value.ok === false;
+}
+let activeTrace = null;
+let cliStartedAtWallMs = Date.now();
+function parseGlobalFlags(args) {
+    const commandArgs = [];
+    let cwd = process.cwd();
+    let sessionId;
+    let metricsEnabled = process.env[env_vars_1.CLI_ENV.metrics] === "1";
+    let flagTraceDir;
+    let stdinFormat;
+    for (let index = 0; index < args.length; index += 1) {
+        const current = args[index];
+        if (!current) {
+            continue;
+        }
+        if (current === "--" && (commandArgs[0] === "rg" || (0, core_2.isRtkPassthroughCommand)(commandArgs[0] ?? ""))) {
+            commandArgs.push(current, ...args.slice(index + 1));
+            break;
+        }
+        if (current === "--cwd") {
+            const nextValue = args[index + 1];
+            if (!nextValue) {
+                throw new errors_1.CliError("MISSING_FLAG_VALUE", "Expected a value after --cwd.");
+            }
+            cwd = nextValue;
+            index += 1;
+            continue;
+        }
+        if (current === "--session" || current === "-s") {
+            const nextValue = args[index + 1];
+            if (!nextValue) {
+                throw new errors_1.CliError("MISSING_FLAG_VALUE", `Expected a value after ${current}.`);
+            }
+            sessionId = nextValue;
+            index += 1;
+            continue;
+        }
+        if (current === "--metrics") {
+            metricsEnabled = true;
+            continue;
+        }
+        if (current === "--dsl" || current === "--force-dsl") {
+            stdinFormat = "dsl";
+            continue;
+        }
+        if (current === "--stdin-format") {
+            const nextValue = args[index + 1];
+            if (nextValue !== "auto" && nextValue !== "dsl") {
+                throw new errors_1.CliError("INVALID_STDIN_FORMAT", "Expected --stdin-format to be auto or dsl.");
+            }
+            stdinFormat = nextValue;
+            index += 1;
+            continue;
+        }
+        if (current === "--trace-dir") {
+            const nextValue = args[index + 1];
+            if (!nextValue) {
+                throw new errors_1.CliError("MISSING_FLAG_VALUE", "Expected a value after --trace-dir.");
+            }
+            flagTraceDir = nextValue;
+            index += 1;
+            continue;
+        }
+        commandArgs.push(current);
+    }
+    const envTraceDir = process.env[env_vars_1.CLI_ENV.traceDir];
+    return {
+        commandArgs,
+        cwd,
+        sessionId,
+        metricsEnabled,
+        trace: (0, config_1.resolveTraceConfig)(cwd, {
+            ...(flagTraceDir !== undefined ? { flagTraceDir } : {}),
+            ...(envTraceDir !== undefined ? { envTraceDir } : {})
+        }),
+        ...(stdinFormat !== undefined ? { stdinFormat } : {})
+    };
+}
+async function main() {
+    cliStartedAtWallMs = Date.now();
+    const cliStartedAt = (0, metrics_1.metricsNow)();
+    const spans = [];
+    const { commandArgs, cwd, sessionId, metricsEnabled, trace, stdinFormat: globalStdinFormat } = parseGlobalFlags(process.argv.slice(2));
+    await (0, session_workspace_2.runWithSessionOverride)(sessionId, async () => {
+        const [rawCommand, ...rawRestArgs] = commandArgs;
+        const aliasStartedAt = (0, metrics_1.metricsNow)();
+        const command = await (0, resolve_command_alias_1.resolveCanonicalCommandAlias)(rawCommand ?? "help", cwd);
+        if (metricsEnabled) {
+            (0, metrics_1.recordSpan)(spans, "cli.aliasResolution", aliasStartedAt);
+        }
+        if (command === "rg") {
+            runRgPassthrough(cwd, rawRestArgs);
+            return;
+        }
+        if ((0, core_2.isRtkPassthroughCommand)(command)) {
+            runRtkCommandPassthrough(command, cwd, rawRestArgs);
+            return;
+        }
+        if (command === "tsc") {
+            (0, core_3.runAibTscCommand)(cwd, rawRestArgs, process.env);
+            return;
+        }
+        const stdinFormat = (0, read_stdin_json_1.stripStdinFormatFlags)(rawRestArgs);
+        const restArgs = stdinFormat.restArgs;
+        if ((0, resolve_command_alias_1.isRemovedAgentCommand)(command)) {
+            throw new errors_1.CliError("UNKNOWN_COMMAND", `Unknown command: ${command}`, {
+                availableCommands: [
+                    "doctor",
+                    "diagnostics",
+                    "printConfig",
+                    "init-skill-usage",
+                    "init",
+                    "help",
+                    "skills",
+                    "generate-docs",
+                    "config",
+                    "qr",
+                    "git",
+                    "gh",
+                    "docker",
+                    "kubectl",
+                    "jest",
+                    "vitest",
+                    "playwright",
+                    "pytest",
+                    "go",
+                    "cargo",
+                    "rake",
+                    "lint",
+                    "biome",
+                    "tsc",
+                    "next",
+                    "prettier",
+                    "ruff",
+                    "golangci-lint",
+                    "rubocop",
+                    "sync",
+                    "reveal",
+                    "inspect",
+                    "imports",
+                    "view",
+                    "execution",
+                    "mutate",
+                    "session",
+                    "trace",
+                    "control-plane",
+                    "background",
+                    "worker",
+                    "ota",
+                    "observability",
+                    "feedback",
+                    "note"
+                ]
+            });
+        }
+        if (command === "session" && (restArgs[0] ?? "status") === "serve") {
+            await (0, server_1.runSessionServerCli)();
+            return;
+        }
+        if (command === "trace") {
+            const result = (0, config_1.runTraceCommand)(cwd, restArgs, trace);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "control-plane") {
+            const result = await (0, control_plane_command_1.runControlPlaneCommand)(cwd, restArgs);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "background") {
+            const result = (0, background_command_1.runBackgroundCommand)(cwd, restArgs);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "worker") {
+            const result = (0, worker_command_1.runWorkerCommand)(cwd, restArgs);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "ota") {
+            const result = await (0, ota_command_1.runOtaCommand)(restArgs);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "diagnostics") {
+            await (0, diagnostics_command_1.runDiagnosticsCommand)(restArgs);
+            return;
+        }
+        if (command === "observability") {
+            startLocalTrace(cwd, command, restArgs, trace);
+            const result = (0, observability_command_1.runObservabilityCommand)(cwd, restArgs);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "feedback" || command === "note") {
+            startLocalTrace(cwd, command, restArgs, trace);
+            const result = (0, feedback_command_1.runFeedbackCommand)(cwd, restArgs, command);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "init") {
+            const result = (0, init_workspace_1.runInitWorkspace)(cwd, restArgs);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "help") {
+            const result = (0, help_command_1.runHelpCommand)(restArgs);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "skills") {
+            const result = (0, skills_command_1.runSkillsCommand)(cwd, restArgs);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "generate-docs") {
+            const result = (0, generate_docs_command_1.runGenerateDocsCommand)(cwd, restArgs);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "config") {
+            startLocalTrace(cwd, command, restArgs, trace);
+            const result = (0, config_command_1.runConfigCommand)(cwd, restArgs);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "reveal") {
+            startLocalTrace(cwd, command, restArgs, trace);
+            const result = (0, reveal_command_1.runRevealCommand)(cwd, restArgs);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "qr") {
+            const rawQrStdin = restArgs.includes("--stdin") ? await (0, read_stdin_json_1.readRawStdinText)() : undefined;
+            activeTrace = (0, trace_1.startTrace)({
+                cwd,
+                argv: process.argv.slice(2),
+                command,
+                restArgs,
+                ...(trace.absoluteTraceDir !== undefined ? { traceDir: trace.absoluteTraceDir } : trace.traceDir !== undefined ? { traceDir: trace.traceDir } : {}),
+                ...(rawQrStdin !== undefined ? { stdinSource: { format: "qr", text: rawQrStdin } } : {}),
+                startedAtMs: cliStartedAtWallMs
+            });
+            const result = await (0, quick_read_1.runQuickReadCommand)(cwd, restArgs, rawQrStdin !== undefined ? { rawStdin: rawQrStdin } : {});
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        const localCommand = isDirectCliCommand(command, restArgs);
+        const pathAliases = localCommand ? (0, session_workspace_2.readEffectiveSessionPathAliases)(cwd) : {};
+        const expandedRestArgs = localCommand ? expandLocalCommandPathAliases(cwd, command, restArgs, pathAliases) : restArgs;
+        const inputSource = await (0, input_source_1.resolveCommandInputSource)({
+            command,
+            cwd,
+            restArgs: expandedRestArgs,
+            readStdinInput: () => (0, read_stdin_json_1.readStdinPayloadWithSource)({
+                command,
+                restArgs: expandedRestArgs,
+                ...(stdinFormat.format !== undefined || globalStdinFormat !== undefined ? { format: stdinFormat.format ?? globalStdinFormat } : {})
+            })
+        });
+        const stdinPayload = localCommand
+            ? (0, path_aliases_1.expandPathAliasesInJson)(cwd, inputSource.payload, pathAliases, inspectPayloadContainsAliasCandidates(inputSource.payload) ? { literalKeys: new Set(["candidate"]) } : {})
+            : inputSource.payload;
+        activeTrace = (0, trace_1.startTrace)({
+            cwd,
+            argv: process.argv.slice(2),
+            command,
+            restArgs: expandedRestArgs,
+            ...(trace.absoluteTraceDir !== undefined ? { traceDir: trace.absoluteTraceDir } : trace.traceDir !== undefined ? { traceDir: trace.traceDir } : {}),
+            ...(stdinPayload !== undefined ? { stdinPayload } : {}),
+            ...(inputSource.source !== undefined ? { stdinSource: inputSource.source } : {}),
+            startedAtMs: cliStartedAtWallMs
+        });
+        if (command === "session") {
+            const sessionCommand = expandedRestArgs[0] ?? "status";
+            if (sessionCommand === "init" ||
+                sessionCommand === "clear" ||
+                sessionCommand === "where" ||
+                sessionCommand === "read" ||
+                sessionCommand === "write" ||
+                sessionCommand === "prefs" ||
+                sessionCommand === "aliases" ||
+                sessionCommand === "list" ||
+                sessionCommand === "use") {
+                const result = (0, session_workspace_1.runSessionWorkspaceCommand)(cwd, expandedRestArgs, stdinPayload);
+                traceAndPrint(result);
+                return;
+            }
+            if (sessionCommand === "status") {
+                const workspaceStatus = (0, session_workspace_1.runSessionWorkspaceCommand)(cwd, expandedRestArgs, stdinPayload);
+                const runtimeStatus = await (0, client_1.getSessionStatus)();
+                traceAndPrint({
+                    ...workspaceStatus,
+                    runtime: compactRuntimeStatus(runtimeStatus),
+                    ...(expandedRestArgs.includes("--verbose") ? { runtimeDiagnostics: runtimeStatus } : {})
+                });
+                return;
+            }
+            if (sessionCommand === "start") {
+                const result = await (0, client_1.startSession)();
+                traceAndPrint(result);
+                return;
+            }
+            if (sessionCommand === "stop") {
+                const result = await (0, client_1.stopSession)();
+                traceAndPrint(result);
+                return;
+            }
+            throw new errors_1.CliError("UNKNOWN_SESSION_COMMAND", `Unknown aib session command: ${sessionCommand}`);
+            return;
+        }
+        if (command === "imports" && expandedRestArgs[0] === "normalize") {
+            const result = (0, captured_input_1.attachCapturedInput)(cwd, "imports", stdinPayload, await (0, imports_command_1.runImportsCommand)(cwd, expandedRestArgs, stdinPayload, {
+                ...(metricsEnabled ? { metricsEnabled: true } : {})
+            }, metricsEnabled ? spans : undefined), inputSource.source);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "internal") {
+            const result = (0, internal_command_1.runInternalCommand)(cwd, expandedRestArgs, stdinPayload);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "execution") {
+            const result = (0, execution_command_1.runExecutionCommand)(cwd, expandedRestArgs);
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "view") {
+            const result = (0, result_view_1.runResultViewCommand)(cwd, expandedRestArgs, stdinPayload);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "declaration") {
+            const result = (0, captured_input_1.attachCapturedInput)(cwd, `declaration.${expandedRestArgs[0] ?? "help"}`, stdinPayload, await (0, declaration_command_1.runDeclarationCommand)(cwd, expandedRestArgs, stdinPayload, {
+                ...(metricsEnabled ? { metricsEnabled: true } : {})
+            }), inputSource.source);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "mutate" && !shouldRouteMutateExecuteThroughSession(expandedRestArgs)) {
+            const result = (0, captured_input_1.attachCapturedInput)(cwd, "mutate", stdinPayload, await (0, mutate_command_1.runMutateCommand)(cwd, expandedRestArgs, stdinPayload, {
+                ...(metricsEnabled ? { metricsEnabled: true } : {})
+            }), inputSource.source);
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result);
+            return;
+        }
+        if (command === "doctor") {
+            const progressRequested = expandedRestArgs.includes("--progress");
+            const jsonRequested = expandedRestArgs.includes("--json");
+            const result = await (0, doctor_1.runDoctor)({
+                cwd,
+                verbose: expandedRestArgs.includes("--verbose"),
+                json: jsonRequested,
+                progress: progressRequested
+            });
+            if (result.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(result, {
+                suppressStdout: progressRequested && !jsonRequested && process.env.AIB_FORCE_JSON !== "1"
+            });
+            return;
+        }
+        if (command === "inspect" && isLocalInspectCommand(expandedRestArgs)) {
+            const graphStartedAt = (0, metrics_1.metricsNow)();
+            const inspectKind = expandedRestArgs[0] === "tree" ? "tree" : expandedRestArgs[0] === "cycles" ? "cycles" : expandedRestArgs[0] === "aliasCandidates" || expandedRestArgs[0] === "alias-candidates" ? "aliasCandidates" : "graph";
+            const result = (0, captured_input_1.attachCapturedInput)(cwd, inspectKind, stdinPayload, await (0, inspect_1.runInspect)(cwd, expandedRestArgs, stdinPayload, {
+                ...(metricsEnabled ? { metricsEnabled: true } : {})
+            }), inputSource.source);
+            if (metricsEnabled) {
+                (0, metrics_1.recordSpan)(spans, "cli.inspectGraph", graphStartedAt);
+                (0, metrics_1.recordSpan)(spans, "cli.total", cliStartedAt);
+            }
+            const output = metricsEnabled ? (0, metrics_1.appendMetrics)(result, spans) : result;
+            if (output.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(output);
+            return;
+        }
+        if (command === "inspect" && expandedRestArgs.includes("--stdin") && inspectStdinPayloadContainsLocalInspect(stdinPayload)) {
+            const treeStartedAt = (0, metrics_1.metricsNow)();
+            const result = (0, captured_input_1.attachCapturedInput)(cwd, inspectStdinCaptureKind(stdinPayload), stdinPayload, await (0, inspect_1.runInspect)(cwd, expandedRestArgs, stdinPayload, {
+                ...(metricsEnabled ? { metricsEnabled: true } : {})
+            }), inputSource.source);
+            if (metricsEnabled) {
+                (0, metrics_1.recordSpan)(spans, "cli.inspectLocal", treeStartedAt);
+                (0, metrics_1.recordSpan)(spans, "cli.total", cliStartedAt);
+            }
+            const output = metricsEnabled ? (0, metrics_1.appendMetrics)(result, spans) : result;
+            if (output.ok === false) {
+                process.exitCode = 1;
+            }
+            traceAndPrint(output);
+            return;
+        }
+        if ((0, input_source_1.commandRequiresPayload)(command, expandedRestArgs, inputSource)) {
+            throw new errors_1.CliError("STDIN_REQUIRED", `${command} currently expects a payload on stdin or --from.`);
+        }
+        const sessionPayload = {
+            command,
+            restArgs: expandedRestArgs,
+            cwd
+        };
+        const modulePlanExecutionId = maybeCreateModulePlanExecutionId(command, expandedRestArgs, stdinPayload);
+        if (modulePlanExecutionId) {
+            sessionPayload.modulePlanExecutionId = modulePlanExecutionId;
+        }
+        if (sessionId !== undefined) {
+            sessionPayload.sessionId = sessionId;
+        }
+        if (stdinPayload !== undefined) {
+            sessionPayload.stdinPayload = stdinPayload;
+        }
+        if (inputSource.source !== undefined) {
+            sessionPayload.stdinInputSource = inputSource.source;
+        }
+        if (metricsEnabled) {
+            sessionPayload.metricsEnabled = true;
+        }
+        if (command === "inspect" && (expandedRestArgs.includes("--debug-workspace-context") || process.env[env_vars_1.CLI_ENV.debugWorkspaceContext] === "1")) {
+            sessionPayload.debugWorkspaceContext = true;
+        }
+        const sessionEnv = sessionRuntimeEnv();
+        if (Object.keys(sessionEnv).length > 0) {
+            sessionPayload.env = sessionEnv;
+        }
+        const sessionCallStartedAt = (0, metrics_1.metricsNow)();
+        const result = await (0, client_1.callSession)(sessionPayload, metricsEnabled ? spans : undefined);
+        if (metricsEnabled) {
+            (0, metrics_1.recordSpan)(spans, "cli.callSession", sessionCallStartedAt);
+            (0, metrics_1.recordSpan)(spans, "cli.total", cliStartedAt);
+        }
+        const output = metricsEnabled ? (0, metrics_1.appendMetrics)(result, spans) : result;
+        if (isErrorPayload(output)) {
+            process.exitCode = 1;
+        }
+        traceAndPrint(output);
+    });
+}
+function sessionRuntimeEnv() {
+    const keys = [
+        env_vars_1.CLI_ENV.workspaceRoot,
+        env_vars_1.CLI_ENV.disableWatchers,
+        env_vars_1.CLI_ENV.trace,
+        env_vars_1.CLI_ENV.traceDir,
+        env_vars_1.CLI_ENV.failureSnapshots,
+        env_vars_1.CLI_ENV.debugWorkspaceContext,
+        env_vars_1.CLI_ENV.productStorageDir,
+        env_vars_1.CLI_ENV.metrics,
+        env_vars_1.CLI_ENV.metricsDir,
+        env_vars_1.CLI_ENV.metricsTag,
+        env_vars_1.CLI_ENV.mutationImpactMetrics,
+        env_vars_1.CLI_ENV.mutationImpactStream,
+        env_vars_1.CLI_ENV.semanticRenameDirectApply,
+        env_vars_1.CLI_ENV.testPostMutationCyclesDelayMs,
+        env_vars_1.CLI_ENV.testRefactorBatchDelayMs,
+        env_vars_1.CLI_ENV.testRenameDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirRowDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirFailImports,
+        env_vars_1.CLI_ENV.testFileRenameDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameRowDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameFailImports,
+        env_vars_1.CLI_ENV.testFileRefactorBatchDelayMs,
+        env_vars_1.CLI_ENV.testFileRefactorBatchRowDelayMs,
+        env_vars_1.CLI_ENV.testFileRefactorBatchImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileRefactorBatchFailImports,
+        env_vars_1.CLI_ENV.testFileRefactorBatchCrashAfterFsMove,
+        env_vars_1.CLI_ENV.testMutateDelayMs,
+        env_vars_1.CLI_ENV.testInspectWorkerFailure,
+        env_vars_1.CLI_ENV.disableFileMutationImportPostProcess,
+        env_vars_1.CLI_ENV.disableFileMoveImportPostProcess,
+        env_vars_1.CLI_ENV.modulePlanSyncWaitMs,
+        env_vars_1.CLI_ENV.refactorBatchSyncWaitMs,
+        env_vars_1.CLI_ENV.renameSyncWaitMs,
+        env_vars_1.CLI_ENV.fileMoveToDirSyncWaitMs,
+        env_vars_1.CLI_ENV.fileRenameSyncWaitMs,
+        env_vars_1.CLI_ENV.fileRefactorBatchSyncWaitMs,
+        env_vars_1.CLI_ENV.mutateSyncWaitMs
+    ];
+    const env = {};
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+function maybeCreateModulePlanExecutionId(command, restArgs, stdinPayload) {
+    if (command === "mutate" && shouldRouteMutateModulePlanThroughSession(restArgs, stdinPayload)) {
+        return readPresetModulePlanExecutionId() ?? (0, module_plan_cache_1.buildModulePlanExecutionId)();
+    }
+    return null;
+}
+function readPresetModulePlanExecutionId() {
+    const value = process.env.AIB_MODULE_PLAN_EXECUTION_ID;
+    return value && /^exec_[a-z0-9_-]+$/i.test(value) ? value : null;
+}
+function shouldRouteMutateExecuteThroughSession(restArgs) {
+    return restArgs[0] === "execute";
+}
+function shouldRouteMutateModulePlanThroughSession(restArgs, stdinPayload) {
+    if (restArgs[0] !== "execute" || !isJsonObject(stdinPayload)) {
+        return false;
+    }
+    const segments = Array.isArray(stdinPayload.segments) ? stdinPayload.segments.filter(isJsonObject) : [];
+    return segments.length === 1 && segments[0]?.kind === "modulePlan";
+}
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function startLocalTrace(cwd, command, restArgs, trace) {
+    activeTrace = (0, trace_1.startTrace)({
+        cwd,
+        argv: process.argv.slice(2),
+        command,
+        restArgs,
+        ...(trace.absoluteTraceDir !== undefined ? { traceDir: trace.absoluteTraceDir } : trace.traceDir !== undefined ? { traceDir: trace.traceDir } : {}),
+        startedAtMs: cliStartedAtWallMs
+    });
+}
+function isDirectCliCommand(command, restArgs) {
+    return command === "session" ||
+        command === "execution" ||
+        command === "observability" ||
+        command === "doctor" ||
+        command === "reveal" ||
+        command === "view" ||
+        command === "declaration" ||
+        command === "mutate" ||
+        (command === "imports" && restArgs[0] === "normalize") ||
+        (command === "inspect" && (isLocalInspectCommand(restArgs) || restArgs[0] === "imports" || restArgs.includes("--stdin")));
+}
+function isLocalInspectCommand(restArgs) {
+    return restArgs[0] === "graph" ||
+        restArgs[0] === "tree" ||
+        restArgs[0] === "cycles" ||
+        restArgs[0] === "topology" ||
+        restArgs[0] === "aliases" ||
+        restArgs[0] === "boundary" ||
+        restArgs[0] === "boundaries" ||
+        restArgs[0] === "aliasCandidates" ||
+        restArgs[0] === "alias-candidates";
+}
+function compactRuntimeStatus(status) {
+    if (status.running === true) {
+        const session = status.session && typeof status.session === "object" && !Array.isArray(status.session) ? status.session : {};
+        const pid = typeof session.pid === "number" ? ` pid ${session.pid}` : "";
+        const port = typeof session.port === "number" ? ` port ${session.port}` : "";
+        return `running${pid}${port}`.trim();
+    }
+    if (status.processAlive === true && status.healthy === false) {
+        return "unhealthy";
+    }
+    return "stopped";
+}
+function inspectStdinPayloadContainsLocalInspect(payload) {
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        return false;
+    }
+    if (payload.op === "tree" || payload.op === "cycles" || payload.op === "imports" || payload.op === "aliasCandidates" || payload.op === "alias-candidates") {
+        return true;
+    }
+    return Array.isArray(payload.requests) && payload.requests.some((request) => request && typeof request === "object" && !Array.isArray(request) &&
+        (request.op === "tree" || request.op === "cycles" || request.op === "imports" || request.op === "aliasCandidates" || request.op === "alias-candidates"));
+}
+function inspectPayloadContainsAliasCandidates(payload) {
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        return false;
+    }
+    if (payload.op === "aliasCandidates" || payload.op === "alias-candidates") {
+        return true;
+    }
+    return Array.isArray(payload.requests) && payload.requests.some((request) => request && typeof request === "object" && !Array.isArray(request) &&
+        (request.op === "aliasCandidates" || request.op === "alias-candidates"));
+}
+function expandLocalCommandPathAliases(cwd, command, restArgs, aliases) {
+    if (Object.keys(aliases).length === 0) {
+        return restArgs;
+    }
+    const skipNextValueFlags = command === "inspect" && (restArgs[0] === "aliasCandidates" || restArgs[0] === "alias-candidates")
+        ? new Set(["--candidate"])
+        : new Set();
+    const expanded = [];
+    let skipNext = false;
+    for (const arg of restArgs) {
+        if (skipNext) {
+            expanded.push(arg);
+            skipNext = false;
+            continue;
+        }
+        const shouldSkip = skipNextValueFlags.has(arg) || Array.from(skipNextValueFlags).some((flag) => arg.startsWith(`${flag}=`));
+        expanded.push(shouldSkip ? arg : (0, path_aliases_1.expandPathAliasValue)(cwd, arg, aliases));
+        if (skipNextValueFlags.has(arg)) {
+            skipNext = true;
+        }
+    }
+    return expanded;
+}
+function inspectStdinCaptureKind(payload) {
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        return "inspect";
+    }
+    const requests = Array.isArray(payload.requests) ? payload.requests.filter((request) => request && typeof request === "object" && !Array.isArray(request)) : [payload];
+    if (requests.every((request) => request.op === "cycles")) {
+        return "cycles";
+    }
+    if (requests.every((request) => request.op === "tree")) {
+        return "tree";
+    }
+    if (requests.every((request) => request.op === "imports")) {
+        return "imports";
+    }
+    if (requests.every((request) => request.op === "aliasCandidates" || request.op === "alias-candidates")) {
+        return "aliasCandidates";
+    }
+    return "inspect";
+}
+void main().catch((error) => {
+    const output = (0, errors_1.errorPayload)(error);
+    traceAndPrint(output);
+    process.exitCode = 1;
+});
+function runRgPassthrough(cwd, restArgs) {
+    const rgArgs = restArgs[0] === "--" ? restArgs.slice(1) : restArgs;
+    const hasStdin = hasReadableStdin();
+    const classification = (0, core_1.classifyRgArgs)(rgArgs, { hasStdin });
+    const formatOptions = (0, options_1.resolveBrgFormatOptions)(cwd, rgArgs, process.env);
+    const capEnabled = typeof formatOptions.outputCapBytes === "number" && formatOptions.outputCapBytes > 0;
+    const stdinText = hasStdin ? node_fs_1.default.readFileSync(0, "utf8") : undefined;
+    const result = (() => {
+        if (classification.mode === "optimizable" || capEnabled) {
+            return (0, core_1.runBrgFormatted)({
+                cwd,
+                args: rgArgs,
+                env: process.env,
+                ...(stdinText !== undefined ? { stdinText } : {})
+            }, formatOptions);
+        }
+        if (hasStdin) {
+            return (0, core_1.runBrgRaw)({
+                cwd,
+                args: rgArgs,
+                env: process.env,
+                stdinText: stdinText ?? ""
+            });
+        }
+        return (0, core_1.runBrgRawInherited)({
+            cwd,
+            args: rgArgs,
+            env: process.env,
+            hasStdin
+        });
+    })();
+    if (result.spawnError) {
+        process.stderr.write(`aib rg: failed to run rg. Install rg or set ${env_vars_1.CLI_ENV.rgPath}: ${result.spawnError}\n`);
+        process.exitCode = 2;
+        return;
+    }
+    if (result.stdout) {
+        process.stdout.write(result.stdout);
+    }
+    if (result.stderr) {
+        process.stderr.write(result.stderr);
+    }
+    process.exitCode = result.exitCode;
+}
+function runRtkCommandPassthrough(command, cwd, restArgs) {
+    const toolArgs = restArgs[0] === "--" ? restArgs.slice(1) : restArgs;
+    const hasStdin = hasReadableStdin();
+    const result = (0, core_2.runRtkPassthrough)({
+        tool: command,
+        cwd,
+        args: toolArgs,
+        env: process.env,
+        ...(hasStdin ? { stdinText: node_fs_1.default.readFileSync(0, "utf8") } : {})
+    });
+    if (result.spawnError) {
+        process.stderr.write(`aib ${command}: failed to run rtk. Install rtk or set ${env_vars_1.CLI_ENV.rtkPath}: ${result.spawnError}\n`);
+        process.exitCode = result.exitCode;
+        return;
+    }
+    if (result.stdout) {
+        process.stdout.write(result.stdout);
+    }
+    if (result.stderr) {
+        process.stderr.write(result.stderr);
+    }
+    process.exitCode = result.exitCode;
+}
+function hasReadableStdin() {
+    try {
+        return !node_fs_1.default.fstatSync(0).isCharacterDevice();
+    }
+    catch {
+        return process.stdin.isTTY === false;
+    }
+}
+function traceAndPrint(output, options = {}) {
+    const envelope = (0, presentation_1.createCliPresentationEnvelope)(output);
+    const rendered = (0, presentation_1.presentCliEnvelope)(envelope, process.env.AIB_FORCE_JSON === "1" ? "json" : "agent");
+    const stdoutText = options.suppressStdout === true ? "" : rendered;
+    if (activeTrace?.enabled) {
+        activeTrace.complete({
+            output: envelope.tracePayload,
+            stdoutText,
+            exitCode: output.ok === false ? 1 : numericExitCode(process.exitCode),
+            durationMs: Date.now() - cliStartedAtWallMs,
+        });
+    }
+    const canonicalJsonPath = process.env.AIB_CANONICAL_JSON_PATH;
+    if (canonicalJsonPath) {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(canonicalJsonPath), { recursive: true });
+        node_fs_1.default.writeFileSync(canonicalJsonPath, `${JSON.stringify(envelope.tracePayload, null, 2)}\n`);
+    }
+    if (options.suppressStdout !== true) {
+        process.stdout.write(rendered);
+    }
+}
+function numericExitCode(exitCode) {
+    return typeof exitCode === "number" ? exitCode : 0;
+}