@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/inspect.js

@@ -1,16 +1,1450 @@
-"use strict";var ht=exports&&exports.__createBinding||(Object.create?(function(e,t,n,s){s===void 0&&(s=n);var i=Object.getOwnPropertyDescriptor(t,n);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,s,i)}):(function(e,t,n,s){s===void 0&&(s=n),e[s]=t[n]})),gt=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),ve=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var s=[];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(s[s.length]=i);return s},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var s=e(t),i=0;i<s.length;i++)s[i]!=="default"&&ht(n,t,s[i]);return gt(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runInspect=Ce;const L=ve(require("node:path")),ye=ve(require("node:fs")),bt=require("node:crypto"),It=require("../client/http-client"),xt=require("../shared/routes"),At=require("../shared/protocol"),E=require("../shared/errors"),V=require("../shared/agent-text"),ie=require("./shared"),$=require("./inspect-format"),w=require("./module-plan-cache"),he=require("./json-file-input"),ge=require("./inspect-graph"),De=require("./inspect-cycles"),be=require("./inspect-imports"),oe=require("./inspect-tree"),Y=require("../config/path-display"),S=require("./session-workspace"),St=require("./entity-resolution");async function Ce(e,t,n,s={},i={}){if(Et(t))return Nt(e,t);if((0,ge.isInspectGraphRequest)(t,n))return(0,ge.runInspectGraph)(e,t,n);if((0,De.isInspectCyclesRequest)(t,n))return(0,De.runInspectCycles)(e,t,n);if((0,oe.isInspectTreeRequest)(t,n))return(0,oe.runInspectTree)(e,t,n);if(t[0]==="imports")return(0,be.runInspectImports)(e,t,n);const o=Xt(e,t,n);if(o&&Yt(o))return qt(e,t,o,s,i);i.allowModulePlan!==!0&&Un(t,n)&&ct();const l=await(0,ie.resolveCompatibleTargetInstance)(e,At.CLI_COMMAND_IDS.inspect,s),r=await(0,ie.fetchEffectiveConfig)(l.entry,s),c=mn(e,t,n,r,i.allowModulePlan===!0,i.forceResults===!0);an(e,c),await _t(l.entry,c.payload,r,s),sn(e,c);const u=await(0,It.postJson)(l.entry,xt.EXTENSION_ROUTES.inspect,c.payload,(0,ie.extensionRequestOptions)(s));on(e,c,u);const d=(0,$.formatInspectResponse)(u,r,c.formatOptions);return Ct(rn(vt(e,u,d,c),c.revision),c)}async function _t(e,t,n,s){const i=Array.isArray(t.requests)?t.requests.filter(p):[],o=new Map;for(const l of i){const r=a(l.op);if(r!=="code"&&r!=="slice"&&r!=="dependencies"&&r!=="members"&&r!=="usages")continue;const c=a(l.sourceFile),u=a(l.symbolName);if(!c||!u)continue;const d=a(l.symbolKind);if(d==="constructor")continue;const m={raw:u,symbolName:u,symbolKind:d},y=o.get(c)??[];y.push(m),o.set(c,y)}for(const[l,r]of o)await(0,St.ensureSelectorsResolvable)(e,l,r,n,(0,ie.extensionRequestOptions)(s))}function Et(e){return e[0]==="usages"&&F(e,"--from-file")!==null}function Nt(e,t){const n=F(t,"--from-file");if(!n)throw new E.CliError("USAGES_FROM_FILE_REQUIRED","inspect usages --from-file expects a saved usages handle or JSON file.");const s=(0,S.resolveSessionFileArgument)(e,n),i=(0,he.readJsonObjectFile)(e,s,"INVALID_USAGES_ARTIFACT"),o=R(t,"--focus"),l=Ie(e,{detail:F(t,"--detail")??"locations",all:t.includes("--all"),limit:H(t,"--limit"),maxCodeLines:H(t,"--max-code-lines")??H(t,"--maxCodeLines")});if(l.detail==="summary")throw new E.CliError("INVALID_USAGES_DETAIL","inspect usages --from-file --detail expects locations or code.");if(l.detail!=="locations"&&l.detail!=="code")throw new E.CliError("INVALID_USAGES_DETAIL","inspect usages --detail expects locations or code.");const r=Oe(e,i,o,l);return(0,V.attachAgentText)(r,xe(e,r))}function vt(e,t,n,s){const i=s.usagesDetails??[],o=Dt(n,s);if(i.length===0||i.every(m=>m===null||m.detail==="summary"))return o;const l=Array.isArray(t.results)?t.results.filter(p):[];if(l.length===0)return o;const r=Array.isArray(o.results)?o.results.filter(p):[o],c=Array.isArray(s.payload.requests)?s.payload.requests.filter(p):[],u=l.map((m,y)=>{const h=i[y],A=r[y]??{};if(c[y]?.targetLocalUsagesHidden===!0&&(m.targetLocalUsagesHidden=!0),m.op!=="usages"||h===void 0||h===null||h.detail==="summary")return A;const I=Oe(e,m,[],h,!0);return Tt(A,I),I});Mt(e,u),Ut(u);const d=u.length===1?u[0]:{results:u};return(0,V.attachAgentText)(d,Bt(e,d,o))}function Dt(e,t){const n=Array.isArray(t.payload.requests)?t.payload.requests.filter(p):[],s=Array.isArray(e.results)?e.results.filter(p):null;return s?(s.forEach((i,o)=>Pe(i,n[o])),e):(Pe(e,n[0]),e)}function Pe(e,t){t?.targetLocalUsagesHidden===!0&&(e.targetLocalUsagesHidden=!0,e.scope==="excluding target"&&delete e.scope)}function Ct(e,t){return Fe(e,t.dslDiagnostics??[])}function Fe(e,t){if(t.length===0)return e;const n=(0,V.readAgentText)(e),s=Pt(t);return(0,V.attachAgentText)({...e,dslDiagnostics:t.map(i=>({line:i.line,message:i.message}))},n?`${n.trimEnd()}
-
-${s}`:s)}function Pt(e){return["dsl errors:",...e.map(t=>`line ${t.line}: ${t.message}`)].join(`
-`)}function Le(e){const t=e.dslDiagnostics;if(!Array.isArray(t))return{};const n=t.flatMap(s=>{if(!p(s))return[];const i=typeof s.line=="number"&&Number.isFinite(s.line)?s.line:null,o=typeof s.message=="string"&&s.message.length>0?s.message:null;return i!==null&&o!==null?[{line:i,message:o}]:[]});return n.length>0?{dslDiagnostics:n}:{}}function Oe(e,t,n,s,i=!1){const o=s.detail==="code"?Kt(e,t,n,s):jt(e,t,n,s);return $t(e,o,i),o}function Ft(e,t){return Ot(t??(0,S.readSessionStringPref)(e,"inspect.usages.detail","locations"))}function Ie(e,t){const n=t.all===!0,s=n?Number.MAX_SAFE_INTEGER:t.limit??(0,S.readSessionNumberPref)(e,"inspect.usages.maxLocations",12),i=n?Number.MAX_SAFE_INTEGER:t.limit??(0,S.readSessionNumberPref)(e,"inspect.usages.maxCodeBlocks",8);return{detail:Ft(e,t.detail),locationLimit:s,codeBlockLimit:i,maxCodeLines:t.maxCodeLines??(0,S.readSessionNumberPref)(e,"inspect.code.maxNonEmptyLines",120),all:n}}function Lt(e){return typeof e=="string"?e:null}function Ot(e){const t=e.trim().toLowerCase();if(t==="location")return"locations";if(t==="locations"||t==="code"||t==="summary")return t;throw new E.CliError("INVALID_USAGES_DETAIL","usages detail expects summary, locations, or code.",{detail:e})}function Tt(e,t){for(const n of["summary","saved","next","input","targetLocalUsagesHidden"])e[n]!==void 0&&(t[n]=e[n])}function $t(e,t,n){const s=Array.isArray(t.__viewItems)?t.__viewItems.filter(p):[];if(delete t.__viewItems,s.length===0)return;const i=Z({version:1,kind:"usages",source:"inspect",detail:a(t.detail)??"locations",target:a(t.target)??"",items:s}),o=(0,S.saveSessionResultViewJson)(e,Te(i),i);o&&(t.view=o.saved,n&&(t.__viewRecord=i))}function Mt(e,t){const n=t.map(r=>p(r.__viewRecord)?r.__viewRecord:null).filter(r=>r!==null&&a(r.kind)==="usages");if(n.length<=1)return;const s=Array.from(new Set(n.map(r=>a(r.detail)??"").filter(r=>r!==""))),i=n.flatMap(r=>Array.isArray(r.items)?r.items.filter(p):[]);if(i.length===0)return;const o=Z({version:1,kind:"usages",source:"inspect",detail:s.length===1?s[0]:"mixed",items:i}),l=(0,S.saveSessionResultViewJson)(e,Te(o),o);if(l)for(const r of t)p(r.__viewRecord)&&a(r.__viewRecord.kind)==="usages"&&(r.viewAllUsages=l.saved)}function Ut(e){for(const t of e)delete t.__viewRecord,delete t.__viewItems}function Te(e){return`res_${(0,bt.createHash)("sha256").update(JSON.stringify(e)).digest("hex").slice(0,8)}`}function Z(e){const t={};for(const[n,s]of Object.entries(e))s!==void 0&&s!==""&&(t[n]=s);return t}function Bt(e,t,n){if(Array.isArray(t.results)){const i=[],o=t.results.filter(p);let l=[];const r=()=>{if(l.length===0)return;const c=(0,$.formatInspectMixedAgentText)({results:l});c&&i.push(c),l=[]};for(const c of o){const u=a(c.detail);if(u==="locations"||u==="code"){r();const d=xe(e,c);d&&i.push(d);continue}if(a(c.op)==="usages"){r();const d=Rt(c);d&&i.push(d);continue}l.push(c)}return r(),kt(i,o),i.length>0?i.join(`
-
-`):null}const s=a(t.detail);return s==="locations"||s==="code"?xe(e,t):(0,V.readAgentText)(n)}function kt(e,t){const n=Array.from(new Set(t.map(i=>a(i.viewAllUsages)??"").filter(i=>i!=="")));if(n.length===0)return;const s=t.every(i=>a(i.op)==="usages");e.push(s?`view all: ${n[0]}`:["view all:",`usages: ${n[0]}`].join(`
-`))}function Rt(e){const t=[],n=a(e.target);t.push(n?`usages ${n}`:"usages");const s=a(e.summary);s&&t.push(s),Ae(t,e);const i=Array.isArray(e.items)?e.items.filter(p):[];for(const o of i){const l=a(o.entity)??"",r=a(o.summary)??"";t.push(`${l}: ${r}`.trim());const c=Array.isArray(o.usedBy)?o.usedBy.filter(u=>typeof u=="string"):[];t.push(...c)}return t.length>1?t.join(`
-`):null}function jt(e,t,n,s){const i=$e(t,n),o=[],r=i.map(c=>{const u=re(c);let d=0,m=0;const y=[],h=Array.isArray(c.usedBy)?c.usedBy.filter(p).flatMap(I=>{const O=Array.isArray(I.locations)?I.locations.filter(p):[],v=Q(e,a(I.file)??""),b=[],_=O.flatMap(D=>{const P=typeof D.line=="number"?D.line:0,f=p(D.container)?le(D.container):"";return d>=s.locationLimit?(m+=1,b.push({line:P,...f!==""?{container:f}:{}}),o.push(Z({name:u,text:f?`${v}:${P} ${f}`:`${v}:${P}`})),[]):(d+=1,[{line:P,...f!==""?{container:f}:{}}])});return b.length>0&&y.push({file:v,locations:b}),_.length>0?[{file:v,locations:_}]:[]}):[],A={entity:u,referenceCount:j(c.referenceCount),usedBy:h,...m>0?{hidden:`+ ${m} more locations`}:{}},C=y.length>0?{entity:u,referenceCount:m,usedBy:y}:null;return{displayItem:A,hiddenItem:C}}).map(c=>c.displayItem);return{op:"usages",detail:"locations",target:Q(e,a(t.targetPath)??""),summary:a(t.summary)??"",referenceCount:j(t.referenceCount),itemCount:j(t.itemCount),fileCount:j(t.fileCount),scopeLabel:Ue(e,t),targetMode:a(t.targetMode)??"",queryMode:a(t.queryMode)??"",targetLocalUsagesHidden:t.targetLocalUsagesHidden===!0,unused:Me(i),items:r,...o.length>0?{__viewItems:o}:{}}}function Kt(e,t,n,s){const i=s.maxCodeLines,o=[],l=new Set,r=new Map,c=new Map,u=[],d=$e(t,n);for(const m of d){const y=re(m),h=Array.isArray(m.usedBy)?m.usedBy.filter(p):[];for(const A of h){const C=a(A.file);if(!C)continue;const I=Array.isArray(A.locations)?A.locations.filter(p):[];for(const O of I){const v=p(O.container)?O.container:null,b=v&&p(v.range)?v.range:null,_=b&&p(b.start)?b.start:null,D=b&&p(b.end)?b.end:null;if(!_||!D||typeof _.line!="number"||typeof _.character!="number"||typeof D.line!="number"||typeof D.character!="number")continue;const P=`${y}:${C}:${_.line}:${_.character}:${D.line}:${D.character}`;if(l.has(P))continue;l.add(P);const f=r.get(y)??0,M=Wt(C,_.line,_.character,D.line,D.character),U=_.line+1,G={entity:y,file:Q(e,C),container:v?le(v):"",line:U,code:M};if(f>=s.codeBlockLimit){c.set(y,(c.get(y)??0)+1),u.push(Z({name:y,text:Ke(G,!1).join(`
-`).trim()}));continue}r.set(y,f+1);const x=Qt(M),ee=`code omitted: ${x} non-empty lines; exceeds inspect.code.maxNonEmptyLines=${i}`;x>i&&u.push(Z({name:y,text:Ke(G,!1).join(`
-`).trim()})),o.push({entity:y,file:Q(e,C),container:v?le(v):"",line:U,...x<=i?{code:M}:{omitted:ee,compactCode:wt(M)}})}}}return{op:"usages",detail:"code",target:Q(e,a(t.targetPath)??""),summary:a(t.summary)??"",referenceCount:j(t.referenceCount),itemCount:j(t.itemCount),fileCount:j(t.fileCount),scopeLabel:Ue(e,t),targetMode:a(t.targetMode)??"",queryMode:a(t.queryMode)??"",targetLocalUsagesHidden:t.targetLocalUsagesHidden===!0,unused:Me(d),blocks:o,hiddenBlocks:Array.from(c.entries()).map(([m,y])=>({entity:m,hidden:`+ ${y} more code blocks`})),...u.length>0?{__viewItems:u}:{}}}function $e(e,t){const n=Array.isArray(e.items)?e.items.filter(p):[];if(t.length===0)return n;const s=new Set(t.map(i=>i.trim()).filter(Boolean));return n.filter(i=>{const o=Vt(i),l=re(i);return s.has(o)||s.has(l)})}function Vt(e){return p(e.entity)?a(e.entity.name)??"":""}function re(e){return p(e.entity)?le(e.entity):""}function Me(e){return e.filter(t=>j(t.referenceCount)===0).map(t=>re(t)).filter(t=>t!=="")}function Ue(e,t){const n=K(t.usageScopes)??[];return n.length===0?"project":n.length===1?Q(e,n[0]):`${n.length} scopes`}function wt(e){const n=e.trim().split(/\r?\n/).map(i=>i.trimEnd()).filter(i=>i.trim()!=="")[0]??"";if(!n)return"";const s=n.indexOf("{");return s>=0?`${n.slice(0,s+1)}...}`:`${n} ...`}function Gt(e,t,n){const s=e.slice(0,t),i=e.length-s.length;return i>0?`${s.join(", ")}, + ${i} ${n}`:s.join(", ")}function j(e){return typeof e=="number"&&Number.isFinite(e)?e:0}function le(e){const t=Array.isArray(e.path)?e.path.filter(n=>typeof n=="string"&&n.trim()!==""):[];return t.length>0?t.join("."):a(e.name)??""}function xe(e,t){const n=a(t.detail);if(j(t.referenceCount)===0){const r=a(t.target),c=a(t.scopeLabel)??"project",u=[r?`usages ${r}`:"usages",`0 refs in ${c}`];Ae(u,t);const d=j(t.itemCount);return(a(t.targetMode)==="directory"||a(t.queryMode)!=="explicit")&&d>0&&u.push(`symbols checked: ${d}`),u.join(`
-`)}const s=[`usages ${n??"detail"}`];if(Ae(s,t),n==="code"){const r=Array.isArray(t.blocks)?t.blocks.filter(p):[],{ownerGroups:c,standalone:u}=ae(r,d=>a(d.entity)??"");for(const[d,m]of c){s.push(""),s.push(`// ${d}:`);for(const[y,h]of Se(m,A=>ce(a(A.entity)??"").name))y&&s.push(`// ${y}`),s.push(...Re(e,t,h))}if(u.length>0){c.length>0&&s.push("");for(const[d,m]of Se(u,y=>a(y.entity)??""))d&&s.push(`// ${d}`),s.push(...Re(e,t,m))}return ke(s,t),Be(s,t),s.join(`
-`).replace(/\n{3,}/g,`
-
-`).trimEnd()}const i=Array.isArray(t.items)?t.items.filter(p).filter(r=>j(r.referenceCount)>0):[],{ownerGroups:o,standalone:l}=ae(i,r=>a(r.entity)??"");for(const[r,c]of o){s.push(""),s.push(`// ${r}:`);for(const u of c)s.push(...Ve(u,!1))}l.length>0&&o.length>0&&s.push("");for(const r of l)s.push(...Ve(r,!0));return ke(s,t),Be(s,t),s.join(`
-`).trimEnd()}function Be(e,t){const n=a(t.view);n&&(e.length>0&&e[e.length-1]!==""&&e.push(""),e.push(`view: ${n}`))}function ke(e,t){const n=Array.isArray(t.unused)?t.unused.filter(s=>typeof s=="string"&&s!==""):[];if(n.length!==0){if(a(t.queryMode)==="explicit"){e.push(""),e.push(`unused: ${Gt(n,2,"more")}`);return}a(t.targetMode)==="file"&&(e.push(""),e.push(`unused symbols: ${n.length}`))}}function Ae(e,t){t.targetLocalUsagesHidden===!0&&e.push("target-local usages hidden; use +includeTarget to show")}function Re(e,t,n){const s=[],i=Se(n,r=>a(r.file)??"");for(const[r,c]of i)r&&s.push(`// ${r}`),s.push(...zt(e,c));const o=a(n[0]?.entity)??"",l=Jt(t,"hiddenBlocks",o);return l&&s.push(`// ${l}`),s}function zt(e,t){const n=[],{ownerGroups:s,standalone:i}=ae(t,o=>a(o.container)??"");for(const[o,l]of s)n.push(`// ${o}:`),n.push(...je(e,l));return i.length>0&&n.push(...je(e,i)),n}function je(e,t){const n=[];for(const s of t){if(typeof s.code=="string")n.push(s.code.trimEnd());else if(typeof s.omitted=="string"){const i=(0,S.useSessionGuidance)(e,"inspect.usages.codeOmitted",s.omitted)??"code omitted";n.push(`// ${i}`),typeof s.compactCode=="string"&&s.compactCode!==""&&n.push(s.compactCode)}n.push("")}return n}function Ke(e,t=!0){const n=[],s=a(e.entity);t&&s&&n.push(`// ${s}`);const i=a(e.file)??"",o=typeof e.line=="number"?` l${e.line}`:"";(i||o)&&n.push(`// ${i}${o}`.trim());const l=a(e.code);return l&&n.push(l.trimEnd()),n}function Ve(e,t){const n=a(e.entity)??"",s=ce(n),i=[`${t?n:s.name}:`],o=Array.isArray(e.usedBy)?e.usedBy.filter(p):[];for(const r of o){const c=a(r.file)??"",u=Array.isArray(r.locations)?r.locations.filter(p):[];if(u.length!==0){if(u.length===1){const[d]=u,m=typeof d?.line=="number"?d.line:0,y=a(d?.container);i.push(y?`${c}:${m} ${y}`:`${c}:${m}`);continue}i.push(`${c}:`),i.push(...Ht(u))}}const l=a(e.hidden);return l&&i.push(l),i}function Ht(e){const t=[],{ownerGroups:n,standalone:s}=ae(e,i=>a(i.container)??"");for(const[i,o]of n){t.push(`// ${i}:`);for(const l of o){const r=typeof l.line=="number"?l.line:0,c=ce(a(l.container)??"").name;t.push(c?`${c} l${r}`:`l${r}`)}}for(const i of s){const o=typeof i.line=="number"?i.line:0,l=a(i.container);t.push(l?`${l} l${o}`:`l${o}`)}return t}function Jt(e,t,n){const i=(Array.isArray(e[t])?e[t].filter(p):[]).find(o=>a(o.entity)===n);return i?a(i.hidden):null}function ae(e,t){const n=new Map,s=[];for(const i of e){const o=ce(t(i));if(!o.owner){s.push(i);continue}const l=n.get(o.owner)??[];l.push(i),n.set(o.owner,l)}return{ownerGroups:Array.from(n.entries()),standalone:s}}function ce(e){const t=e.lastIndexOf(".");return t<=0||t>=e.length-1?{owner:null,name:e}:{owner:e.slice(0,t),name:e.slice(t+1)}}function Se(e,t){const n=new Map;for(const s of e){const i=t(s),o=n.get(i)??[];o.push(s),n.set(i,o)}return Array.from(n.entries())}function Wt(e,t,n,s,i){const o=ye.readFileSync(e,"utf8"),l=we(o,t,n),r=we(o,s,i);return o.slice(l,r)}function we(e,t,n){let s=0,i=0;for(;i<e.length&&s<t;){const o=e.charCodeAt(i);o===13?(i+=e.charCodeAt(i+1)===10?2:1,s+=1):o===10?(i+=1,s+=1):i+=1}return Math.max(0,Math.min(i+n,e.length))}function Qt(e){return e.split(/\r?\n/).filter(t=>t.trim()!=="").length}function Q(e,t){const n=L.relative(e,t);return(n&&!n.startsWith("..")&&!L.isAbsolute(n)?n:t).replace(/\\/g,"/")}async function qt(e,t,n,s,i){const o=pe(n),l=[],r=[],c=[],u=(0,Y.buildDisplayPathAliases)(e,(0,S.readEffectiveSessionPathAliases)(e)),d=[];for(const b of o){if(!p(b))throw new E.CliError("INVALID_INSPECT_REQUEST","Inspect request must be an object.");a(b.op)==="graph"?(r.push(Zt(b)),d.push("graph")):a(b.op)==="imports"?(c.push(b),d.push("imports")):(l.push(b),d.push("inspect"))}const m=l.length>0?en((0,V.stripAgentText)(await Ce(e,["--stdin"],{requests:l},s,{...i,forceResults:!0}))):[],y=r.length>0?tn((0,V.stripAgentText)((0,ge.runInspectGraph)(e,["graph","--stdin"],{requests:r}))):[],h=c.map(b=>(0,be.buildInspectImportsResult)(e,{file:a(b.file)??a(b.fromFile)??a(b.sourceFile)??a(n.file)??"",ranges:B(b.ranges)!==!1,dynamic:B(b.dynamic)!==!1},u)),A=[];let C=0,I=0,O=0;for(const b of d)if(b==="graph"){const _=y[I++];_&&A.push(_)}else if(b==="imports"){const _=h[O++];_&&A.push(_)}else{const _=m[C++];_&&A.push(_)}const v={results:(0,be.mergeDirectoryFallbackResults)(A)};return Fe((0,V.attachAgentText)(v,(0,$.formatInspectMixedAgentText)(v)),Le(n).dslDiagnostics??[])}function Xt(e,t,n){if(t[0]==="graph")return null;if(t.includes("--stdin"))return p(n)?n:null;const s=F(t,"--from-json");return s?(0,he.readJsonObjectFile)(e,s,"INVALID_INSPECT_JSON_FILE"):null}function Yt(e){return pe(e).some(t=>p(t)&&(a(t.op)==="graph"||a(t.op)==="imports"))}function Zt(e){const t={...e};return delete t.op,delete t.sourceFile,t}function en(e){return Array.isArray(e.results)?e.results.filter(p).map(Ge):[Ge(e)]}function Ge(e){return e.op==="dependencies"?{...e,op:"deps"}:e}function tn(e){return Array.isArray(e.results)?e.results.filter(p).map(t=>({op:"graph",...t})):[{op:"graph",...nn(e)}]}function nn(e){const t={...e};return delete t.operation,delete t.next,delete t.last,typeof t.saved=="string"&&delete t.graphFile,t}function sn(e,t){(Array.isArray(t.payload.requests)?t.payload.requests:[]).forEach((s,i)=>{if(!p(s)||s.op!=="modulePlan"||s.previewFiles!==!0)return;const o=(0,w.normalizeModulePlanCacheRequest)(s),l=(0,w.buildModulePlanId)(o),r=a(s.previewDir),c=(0,w.resolveModulePlanPreviewDir)(e,l,r??void 0);s.previewDir=c,s.previewPatch=s.previewPatch!==!1,t.cachePlans.push({index:i,planId:l,normalizedRequest:o,previewDir:c})})}function on(e,t,n){if(!(t.cachePlans.length===0||!Array.isArray(n.results)))for(const s of t.cachePlans){const i=n.results[s.index];if(!p(i))continue;const o=a(s.normalizedRequest.sourceFile);if(!o)continue;const l=(0,w.hashFile)(o),r=(0,w.buildModulePlanHash)(s.normalizedRequest,l,i),c={planId:s.planId,planHash:r,createdAt:new Date().toISOString(),cwd:L.resolve(e),sourceFile:o,sourceHash:l,executable:i.ok!==!1,normalizedRequest:s.normalizedRequest,inspectPayload:t.payload,previewDir:s.previewDir,previewResult:i};(0,w.writeModulePlanRecord)(e,c),i.planId=s.planId,i.planHash=r,i.cached=!0,i.executable=i.ok!==!1,i.next=i.ok===!1?`Revise with: aib modulePlan revise --plan ${s.planId} --stdin`:`Run modulePlan apply ${s.planId} if the plan matches intent.`}}function rn(e,t){if(!t||!Array.isArray(e.results)||!p(e.results[0]))return e;const n=e.results[0];n.operation="modulePlan.revise",n.fromPlanId=t.fromPlanId,n.changes=t.changes;const s=En(n),i=t.previousBlocking.filter(o=>!s.includes(o));return i.length>0&&(n.resolved=i),n.remainingBlocking=Array.isArray(n.blocking)?n.blocking:[],delete n.blocking,delete n.boundary,delete n.targets,delete n.moduleCount,delete n.preview,delete n.facade,n.next=n.ok===!1||n.executable===!1?`Revise again from ${typeof n.planId=="string"?n.planId:t.fromPlanId}.`:`aib modulePlan apply ${typeof n.planId=="string"?n.planId:t.fromPlanId}`,(0,V.attachAgentText)(e,ln(n))}function ln(e){const t=[`modulePlan.revise ${typeof e.planId=="string"?e.planId:""}`.trim()];if(typeof e.fromPlanId=="string"&&t.push(`from: ${e.fromPlanId}`),typeof e.integrity=="string"&&t.push(e.integrity),p(e.api)&&typeof e.api.status=="string"){const n=typeof e.api.before=="number"?e.api.before:null,s=typeof e.api.after=="number"?e.api.after:null;t.push(n!==null&&s!==null?`api: ${e.api.status} ${n}->${s}`:`api: ${e.api.status}`)}if(typeof e.cycles=="string"&&t.push(`cycles: ${e.cycles}`),Array.isArray(e.changes)&&e.changes.length>0){t.push("changes:");for(const n of e.changes.filter(s=>typeof s=="string"))t.push(n)}return Array.isArray(e.resolved)&&e.resolved.length>0&&t.push(`resolved: ${e.resolved.length}`),Array.isArray(e.remainingBlocking)&&t.push(`remainingBlocking: ${e.remainingBlocking.length}`),typeof e.next=="string"&&t.push(`next: ${e.next}`),t.join(`
-`)}function an(e,t){if(!Array.isArray(t.payload.requests))return;const n=t.payload.requests.filter(p),s=new Map,i=[],o=new Map;for(let l=0;l<n.length;l+=1){const r=n[l],c=a(r.sourceFile);if(!c||!cn(a(r.op))||!Pn(c)){o.set(l,i.length),i.push(r);continue}let u=s.get(c);u?o.set(l,i.findIndex(m=>a(m.sourceFile)===c&&m.op==="directoryFallback")):(u=un(e,c),s.set(c,u),o.set(l,i.length),i.push(fn(u)));const d=dn(a(r.op));u.ops.includes(d)||u.ops.push(d)}s.size!==0&&(t.payload.requests=i,t.formatOptions.toFiles&&(t.formatOptions.toFiles=ue(t.formatOptions.toFiles,o,i.length)),t.formatOptions.saves&&(t.formatOptions.saves=ue(t.formatOptions.saves,o,i.length)),t.formatOptions.shows&&(t.formatOptions.shows=ze(t.formatOptions.shows,o,i.length)),t.formatOptions.ranges&&(t.formatOptions.ranges=ze(t.formatOptions.ranges,o,i.length)),t.formatOptions.parentNames&&(t.formatOptions.parentNames=ue(t.formatOptions.parentNames,o,i.length)),t.usagesDetails&&(t.usagesDetails=ue(t.usagesDetails,o,i.length)))}function cn(e){return e==="file"||e==="exports"||e==="members"||e==="code"||e==="dependencies"||e==="slice"}function un(e,t){const n=pn(e,t),s=(0,S.readEffectiveSessionPathAliases)(e),i=(0,Y.compactDisplayPath)(e,t,(0,Y.buildDisplayPathAliases)(e,s)),o=(0,oe.buildInspectTreeResult)(e,{scope:t,displayScope:i,depth:n,limit:40,aliases:s}),l=[];return{sourceFile:t,displayPath:i,ops:l,command:`aib inspect tree ${i} --depth ${n}`,result:{op:"directoryFallback",ok:!0,sourceFile:t,directory:i,skippedOps:l,command:`aib inspect tree ${i} --depth ${n}`,tree:o,lines:Array.isArray(o.lines)?o.lines:[]}}}function fn(e){return{op:"directoryFallback",sourceFile:e.sourceFile,fallback:e.result}}function pn(e,t){for(let n=1;n<=4;n+=1){const s=(0,oe.buildInspectTreeResult)(e,{scope:t,depth:n,limit:1});if(typeof s.files=="number"&&s.files>0)return n}return 2}function ue(e,t,n){const s=Array.from({length:n},()=>null);for(const[i,o]of t.entries())s[o]===null&&(s[o]=e[i]??null);return s}function ze(e,t,n){const s=Array.from({length:n},()=>!1);for(const[i,o]of t.entries())s[o]=s[o]||(e[i]??!1);return s}function dn(e){return e==="dependencies"?"deps":e??"inspect"}function mn(e,t,n,s,i,o){const l=Je(t),c=!(t.includes("--no-ranges")||t.includes("--noRanges"))&&(l==="code"||l==="file")||t.includes("--ranges")||l==="exports"&&(0,S.readSessionBooleanPref)(e,"inspect.exports.ranges",!1),u=t.includes("--details"),d=t.includes("--resolve-star")||l==="exports"&&(0,S.readSessionBooleanPref)(e,"inspect.exports.resolveStar",!1),m=t.includes("--local-only"),y=Fn(e,t),h=nt(t,"--offset"),A=H(t,"--limit")??(l==="members"?(0,S.readSessionNumberPref)(e,"inspect.members.maxItems",20):null),C=t.includes("--all")||l==="members"&&(0,S.readSessionBooleanPref)(e,"inspect.members.all",!1),I=F(t,"--to-file")??void 0,O=F(t,"--save")??void 0,v=l==="code"&&(t.includes("--no-show")||t.includes("--noShow")),b=t.includes("--show"),_=v?!1:b||l==="code"&&(0,S.readSessionBooleanPref)(e,"inspect.code.show",!0),D=(0,S.readSessionBooleanPref)(e,"inspect.code.meta",!0),P=l==="usages"?Ie(e,{detail:F(t,"--detail"),all:t.includes("--all"),limit:H(t,"--limit"),maxCodeLines:H(t,"--max-code-lines")??H(t,"--maxCodeLines")}):null,f=F(t,"--bundle-save")??void 0,M=F(t,"--preview-dir")??void 0,U=F(t,"--from-json")??void 0,G=F(t,"--parent")??void 0,x=G?(0,$.parseInspectSelector)(G,s).symbolName:void 0,ee=(0,Y.buildDisplayPathAliases)(e,(0,S.readEffectiveSessionPathAliases)(e)),te=[];if(I!==void 0&&O!==void 0)throw new E.CliError("INSPECT_OUTPUT_TARGET_CONFLICT","Use either --to-file or --save, not both.");const q={cwd:e,includeRanges:c,displayPathAliases:ee,pathAliasHints:te,details:u,localOnly:m,maxCodeLines:y,forceResults:o,show:_,codeMeta:D,...x!==void 0?{parentName:x,parentNames:[x]}:{},...I!==void 0?{toFile:I}:{},...O!==void 0?{save:O}:{},...f!==void 0?{bundleSave:f}:{},...M!==void 0?{previewDir:k(e,M)}:{}};if(U!==void 0){if(t.includes("--stdin")||n!==void 0)throw new E.CliError("INSPECT_INPUT_SOURCE_CONFLICT","Use either inspect --stdin or inspect --from-json, not both.");if(t.includes("--revise"))throw new E.CliError("INSPECT_REVISE_FROM_JSON_UNSUPPORTED","modulePlan revise currently expects --stdin.");const g=He((0,he.readJsonObjectFile)(e,U,"INVALID_INSPECT_JSON_FILE"),Je(t)),z=c||st(g),N=We(e,g,s,z,d,m,{memberOffset:h,memberLimit:A,memberAll:C},i);return{payload:N.payload,cachePlans:[],formatOptions:{...q,includeRanges:z,toFiles:N.toFiles,saves:N.saves,shows:N.shows,ranges:N.ranges,parentNames:N.parentNames,...f===void 0&&N.bundleSave!==void 0?{bundleSave:N.bundleSave}:{}},usagesDetails:N.usagesDetails}}if(n!==void 0){if(!p(n))throw new E.CliError("INVALID_INSPECT_STDIN","inspect input expects a JSON object payload.");if(t.includes("--revise"))return yn(e,t,n,s);const g=He(n,l),z=c||st(g),N=We(e,g,s,z,d,m,{memberOffset:h,memberLimit:A,memberAll:C},i);return{payload:N.payload,cachePlans:[],formatOptions:{...q,includeRanges:z,toFiles:N.toFiles,saves:N.saves,shows:N.shows,ranges:N.ranges,parentNames:N.parentNames,...f===void 0&&N.bundleSave!==void 0?{bundleSave:N.bundleSave}:{}},usagesDetails:N.usagesDetails,...Le(n)}}return{payload:hn(e,t,s,c,d,m,{memberOffset:h,memberLimit:A,memberAll:C},i),formatOptions:q,cachePlans:[],...P!==null?{usagesDetails:[P]}:{}}}function He(e,t){return!t||e.op!==void 0?e:{op:t,...e}}function Je(e){return e.filter(n=>!n.startsWith("--")&&!it(e,n))[0]??null}function yn(e,t,n,s){const i=F(t,"--plan");if(!i)throw new E.CliError("MODULE_PLAN_REVISE_PLAN_REQUIRED","modulePlan revise expects --plan <planId>.");const o=(0,w.readModulePlanRecord)(e,i),l=gn(e,o.previewResult,o.normalizedRequest,n,s),r=(0,w.buildModulePlanId)(l),c=(0,w.resolveModulePlanPreviewDir)(e,r);return{payload:{requests:[{...l,previewFiles:!0,previewPatch:!0,previewDir:c}]},formatOptions:{cwd:e,includeRanges:!1,displayPathAliases:(0,Y.buildDisplayPathAliases)(e,(0,S.readEffectiveSessionPathAliases)(e)),pathAliasHints:[],localOnly:!1,details:!1,maxCodeLines:(0,S.readSessionNumberPref)(e,"inspect.code.maxNonEmptyLines",120),codeMeta:(0,S.readSessionBooleanPref)(e,"inspect.code.meta",!0),previewDir:c},cachePlans:[{index:0,planId:r,normalizedRequest:l,previewDir:c}],revision:{fromPlanId:i,changes:Sn(e,o.normalizedRequest,l),previousBlocking:_n(o.previewResult,s)}}}function hn(e,t,n,s,i,o,l,r){const c=t.filter(I=>!I.startsWith("--")&&!it(t,I)),[u,d,m]=c;if(!u||!d)throw new E.CliError("INVALID_INSPECT_COMMAND","Expected: aib inspect <file|imports|exports|members|code|slice|deps|usages|duplicates> <file-or-dir> [entity].",{examples:["aib inspect file src/example.ts","aib inspect imports src/example.ts","aib inspect exports src/example.ts","aib inspect members src/example.ts c:Example","aib inspect code src/example.ts f:helper","aib inspect deps src/example.ts c:Example","aib inspect usages src/example.ts f:helper --scope src/main","aib inspect duplicates src/scripts --detail code"]});if(!rt(u))throw new E.CliError("INVALID_INSPECT_OP","Expected inspect op to be file, imports, exports, members, code, slice, deps, usages, duplicates, graph, tree, or cycles.");if(at(u,r),F(t,"--save")&&u!=="code"&&u!=="slice"&&u!=="usages"&&u!=="duplicate"&&u!=="duplicates")throw new E.CliError("INVALID_INSPECT_SAVE","inspect --save can be used only with code, slice, usages, or duplicates operations.");const y=lt(u),h={op:y,sourceFile:k(e,d),ranges:s||y==="code"||y==="slice",resolveStar:i,localOnly:y==="file"&&o};if(tt(h,l),y==="members"||y==="code"||y==="dependencies"||y==="slice"){if(!m)throw new E.CliError("INSPECT_ENTITY_REQUIRED",`inspect ${u} expects an entity selector.`);_e(h,m,n)}if(y==="usages"&&m&&_e(h,m,n),y==="duplicates"){h.detail=F(t,"--detail")??"locations",h.mode=F(t,"--mode")??"both";const I=H(t,"--limit"),O=nt(t,"--offset");I!==null&&(h.limit=I),O!==null&&(h.offset=O);const v=Bn(t,n);v.length>0&&(h.kinds=v);const b=de([...m?[m]:[],...R(t,"--entity"),...R(t,"--entities").flatMap(P=>P.split(","))],n);b.length>0&&(h.duplicateEntities=b);const _=de([...R(t,"--exclude"),...R(t,"--excludes").flatMap(P=>P.split(","))],n);_.length>0&&(h.duplicateExclude=_);const D=ft(e,[...R(t,"--path-exclude"),...R(t,"--path-excludes").flatMap(P=>P.split(",")),...R(t,"--exclude-path"),...R(t,"--exclude-paths").flatMap(P=>P.split(","))]);D.length>0&&(h.duplicatePathExclude=D)}const A=R(t,"--scope");if(y==="usages"&&A.length>0&&(h.scope=A.map(I=>k(e,I))),y==="duplicates"&&A.length>0&&(h.scope=A.map(I=>k(e,I))),y==="usages"){h.excludeTarget=t.includes("--exclude-target")||t.includes("--excludeTarget")||!1;const I=t.includes("--include-target")||t.includes("--includeTarget"),O=(0,S.readSessionBooleanPref)(e,"inspect.usages.excludeTarget",!1);I?h.excludeTarget=!1:h.excludeTarget===!0||O?h.excludeTarget=!0:Ze(e,a(h.sourceFile)??"",K(h.scope)??[])&&(h.excludeTarget=!0,h.targetLocalUsagesHidden=!0)}const C=F(t,"--parent");if(C){const I=(0,$.parseInspectSelector)(C,n);h.parentName=I.symbolName,I.symbolKind&&(h.parentKind=I.symbolKind)}return{requests:[h]}}function We(e,t,n,s,i,o,l,r){const c=pe(t),u=[],d=[],m=[],y=[],h=[],A=[],C=Lt(t.detail),I=B(t.all),O=J(t.limit),v=J(t.maxCodeLines),b=B(t.excludeTarget),_=B(t.includeTarget),D=a(t.bundleSave)??a(t.bundle)??a(t.saveBundle)??void 0;return{payload:{requests:c.map((f,M)=>{if(!p(f))throw new E.CliError("INVALID_INSPECT_REQUEST",`Inspect request at index ${M} must be an object.`);const U=a(f.op),G=a(f.sourceFile)??a(f.file)??(U==="usages"?a(f.target)??a(f.usageTarget)??a(f.dir):null)??(U==="duplicate"||U==="duplicates"?a(f.target)??a(f.dir)??ut(f.scope)??ut(f.scopes):null);if(!U||!rt(U))throw new E.CliError("INVALID_INSPECT_OP",`Inspect request at index ${M} has invalid op.`);if(at(U,r),!G)throw new E.CliError("SOURCE_FILE_REQUIRED",`Inspect request at index ${M} requires sourceFile or file.`);const x=lt(U),te=B(f.ranges)??B(f.includeRanges)??(x==="code"||x==="slice"||x==="file"?!0:x==="exports"?(0,S.readSessionBooleanPref)(e,"inspect.exports.ranges",!1):s),q=te||x==="code"||x==="slice",g={op:x,sourceFile:k(e,G),ranges:q,resolveStar:B(f.resolveStar)??(x==="exports"?(0,S.readSessionBooleanPref)(e,"inspect.exports.resolveStar",!1):i),localOnly:x==="file"&&(f.localOnly===!0||o)};if(x==="usages"){A.push(Ie(e,{detail:a(f.detail)??C,all:B(f.all)??I,limit:J(f.limit)??O,maxCodeLines:J(f.maxCodeLines)??v}));const T=K(f.scope)??K(f.scopes);T&&T.length>0&&(g.scope=T.map(se=>k(e,se)));const W=B(f.includeTarget)??_,X=B(f.excludeTarget)??b,ne=(0,S.readSessionBooleanPref)(e,"inspect.usages.excludeTarget",!1);W===!0?g.excludeTarget=!1:X!==null?g.excludeTarget=X:ne?g.excludeTarget=!0:Ze(e,g.sourceFile,K(g.scope)??[])&&(g.excludeTarget=!0,g.targetLocalUsagesHidden=!0),Array.isArray(f.entities)&&(g.usageEntities=$n(f.entities,n))}else A.push(null);if(x==="duplicates"){g.detail=a(f.detail)??a(t.detail)??"locations",g.mode=a(f.mode)??a(t.mode)??"both",g.limit=J(f.limit)??J(t.limit)??10,g.offset=fe(f.offset)??fe(t.offset)??0;const T=K(f.scope)??K(f.scopes)??K(t.scope)??K(t.scopes);T&&T.length>0&&(g.scope=T.map(yt=>k(e,yt)));const W=kn(f.kinds??t.kinds,n);W.length>0&&(g.kinds=W);const X=de(f.entities??f.entity??t.entities??t.entity,n);X.length>0&&(g.duplicateEntities=X);const ne=de(f.exclude??f.excludes??t.exclude??t.excludes,n);ne.length>0&&(g.duplicateExclude=ne);const se=ft(e,f.pathExclude??f.pathExcludes??f.excludePath??f.excludePaths??t.pathExclude??t.pathExcludes??t.excludePath??t.excludePaths);se.length>0&&(g.duplicatePathExclude=se)}if(x==="modulePlan"){g.modules=Tn(e,f.modules,n);const T=a(f.facade)??a(f.facadeFile);if(T&&(g.facadeFile=k(e,T)),f.previewFiles===!0||f.preview==="files"){g.previewFiles=!0;const W=a(f.previewDir)??a(f.outputDir);W&&(g.previewDir=k(e,W)),g.previewPatch=f.previewPatch!==!1}}tt(g,{memberOffset:fe(f.offset)??fe(f.memberOffset)??l.memberOffset,memberLimit:J(f.limit)??J(f.memberLimit)??l.memberLimit??(x==="members"?(0,S.readSessionNumberPref)(e,"inspect.members.maxItems",20):null),memberAll:B(f.all)??B(f.memberAll)??(x==="members"?(0,S.readSessionBooleanPref)(e,"inspect.members.all",!1):l.memberAll)});const z=a(f.id);z&&(g.id=z);const N=x==="modulePlan"?null:a(f.toFile)??a(f.outputFile),me=x==="modulePlan"?null:a(f.save);if(N&&x!=="code"&&x!=="slice")throw new E.CliError("INVALID_INSPECT_TO_FILE",`Inspect request at index ${M} can use toFile only with code or slice operations.`);if(me&&x!=="code"&&x!=="slice"&&x!=="usages"&&x!=="duplicates")throw new E.CliError("INVALID_INSPECT_SAVE",`Inspect request at index ${M} can use save only with code, slice, usages, or duplicates operations.`);if(N&&me)throw new E.CliError("INSPECT_OUTPUT_TARGET_CONFLICT",`Inspect request at index ${M} must use either toFile or save, not both.`);u.push(N),d.push(me);const mt=typeof f.show=="boolean"?f.show:null;m.push(mt??(x==="code"&&(0,S.readSessionBooleanPref)(e,"inspect.code.show",!0))),y.push(te);const Ee=a(f.entity);Ee&&_e(g,Ee,n);const Ne=a(f.parent);if(Ne){const T=(0,$.parseInspectSelector)(Ne,n);g.parentName=T.symbolName,T.symbolKind&&(g.parentKind=T.symbolKind),h.push(T.symbolName)}else h.push(null);return g})},toFiles:u,saves:d,shows:m,ranges:y,parentNames:h,usagesDetails:A,...D!==void 0?{bundleSave:D}:{}}}function _e(e,t,n){const s=(0,$.parseInspectSelector)(t,n);e.symbolName=s.symbolName,s.symbolKind&&(e.symbolKind=s.symbolKind)}function gn(e,t,n,s,i){const o=Nn(n),l=[...bn(e,s),...In(e,t,s,i)];if(l.length===0)throw new E.CliError("MODULE_PLAN_REVISE_MOVES_REQUIRED","modulePlan revise expects moves or applySuggestedFixes.");for(const r of l)An(o,r,i);return o}function bn(e,t){return(Array.isArray(t.moves)?t.moves:[]).filter(p).map(s=>{const i=a(s.entity)??a(s.symbol)??a(s.selector),o=a(s.to)??a(s.target)??a(s.toFile)??a(s.targetFile);return i&&o?{selector:i,toFile:k(e,o)}:null}).filter(s=>s!==null)}function In(e,t,n,s){const i=n.applySuggestedFixes,o=xn(t,s),l=i===!0||i==="all"?o.map((r,c)=>c):Array.isArray(i)?i:[];return l.length===0?[]:l.map(r=>typeof r=="number"?r:typeof r=="string"?Number(r):NaN).filter(r=>Number.isInteger(r)&&r>=0&&r<o.length).map(r=>({selector:o[r].selector,toFile:k(e,o[r].toFile)}))}function xn(e,t){const n=p(e.boundary)?e.boundary:{},s=Array.isArray(n.nonExportedImports)?n.nonExportedImports.filter(p):[],i=[];for(const o of s){const l=Array.isArray(o.suggestedFixes)?o.suggestedFixes.filter(p):[];for(const r of l){if(r.kind!=="moveSymbol")continue;const c=Qe(r.symbol,t),u=a(r.toFile);c&&u&&i.push({selector:c,toFile:u})}}return i}function Qe(e,t){if(!p(e))return null;const n=a(e.name),s=a(e.kind);if(!n||!s)return null;const i=t.entityKindAliases[s];return i?`${i}${t.selectorSeparator}${n}`:`${s}:${n}`}function An(e,t,n){const s=Array.isArray(e.modules)?e.modules.filter(p):[],i=(0,$.parseInspectSelector)(t.selector,n);let o=null;for(const c of s){const u=Array.isArray(c.symbols)?c.symbols:[],d=[];for(const m of u)o===null&&qe(m,i)?o=m:d.push(m);c.symbols=d}if(o===null)throw new E.CliError("MODULE_PLAN_REVISE_SYMBOL_NOT_FOUND",`Symbol not found in cached module plan: ${t.selector}`,{symbol:t.selector});let l=s.find(c=>a(c.targetFile)===t.toFile);l||(l={targetFile:t.toFile,symbols:[]},s.push(l));const r=Array.isArray(l.symbols)?l.symbols:[];r.some(c=>qe(c,i))||r.push(o),l.symbols=r,e.modules=s.filter(c=>Array.isArray(c.symbols)&&c.symbols.length>0)}function qe(e,t){if(!p(e))return!1;const n=a(e.raw),s=a(e.symbolName),i=a(e.symbolKind);return n===t.raw||s===t.symbolName&&(!t.symbolKind||i===t.symbolKind)}function Sn(e,t,n){const s=Ye(t),i=Ye(n),o=[];for(const[l,r]of i.entries()){const c=s.get(l);c&&c!==r&&o.push(`${l}: ${Xe(e,c)} -> ${Xe(e,r)}`)}return o}function _n(e,t){const n=p(e.boundary)?e.boundary:{};return(Array.isArray(n.nonExportedImports)?n.nonExportedImports.filter(p):[]).flatMap(i=>{const o=a(i.code)??"MODULE_PLAN_BOUNDARY_WARNING";return(Array.isArray(i.symbols)?i.symbols.filter(p):[]).map(r=>Qe(r,t)).filter(r=>typeof r=="string").map(r=>`${o}: ${r}`)})}function En(e){return(Array.isArray(e.blocking)?e.blocking.filter(p):[]).flatMap(n=>{const s=a(n.code)??"MODULE_PLAN_BOUNDARY_WARNING";return(Array.isArray(n.symbols)?n.symbols.filter(o=>typeof o=="string"):[]).map(o=>`${s}: ${o}`)})}function Xe(e,t){return L.relative(e,t).replace(/\\/g,"/")}function Ye(e){const t=new Map,n=Array.isArray(e.modules)?e.modules.filter(p):[];for(const s of n){const i=a(s.targetFile);if(!i)continue;const o=Array.isArray(s.symbols)?s.symbols.filter(p):[];for(const l of o){const r=a(l.raw),c=a(l.symbolName),u=a(l.symbolKind),d=r??(c?`${u??"symbol"}:${c}`:null);d&&t.set(d,i)}}return t}function Nn(e){return JSON.parse(JSON.stringify(e))}function k(e,t){return L.normalize(L.isAbsolute(t)?t:L.resolve(e,t))}function Ze(e,t,n){const s=L.normalize(t);return n.length===0?!et(s,e):n.some(i=>vn(i,s))}function vn(e,t){const n=L.normalize(e),s=L.normalize(t);return et(n,s)||Cn(n)?!1:Dn(s,n)}function Dn(e,t){const n=L.relative(L.normalize(t),L.normalize(e));return n!==""&&!n.startsWith("..")&&!L.isAbsolute(n)}function et(e,t){return L.normalize(e).toLowerCase()===L.normalize(t).toLowerCase()}function Cn(e){try{return ye.statSync(e).isFile()}catch{return!1}}function Pn(e){try{return ye.statSync(e).isDirectory()}catch{return!1}}function tt(e,t){if(t.memberAll){e.memberAll=!0;return}typeof t.memberOffset=="number"&&(e.memberOffset=t.memberOffset),typeof t.memberLimit=="number"&&(e.memberLimit=t.memberLimit)}function Fn(e,t){const n=F(t,"--max-lines");if(!n)return(0,S.readSessionNumberPref)(e,"inspect.code.maxNonEmptyLines",120);const s=Number(n);if(!Number.isInteger(s)||s<1)throw new E.CliError("INVALID_MAX_LINES","Expected --max-lines to be a positive integer.");return s}function H(e,t){const n=F(e,t);if(!n)return null;const s=Number(n);if(!Number.isInteger(s)||s<1)throw new E.CliError("INVALID_INSPECT_LIMIT",`Expected ${t} to be a positive integer.`);return s}function nt(e,t){const n=F(e,t);if(!n)return null;const s=Number(n);if(!Number.isInteger(s)||s<0)throw new E.CliError("INVALID_INSPECT_OFFSET",`Expected ${t} to be a non-negative integer.`);return s}function J(e){const t=typeof e=="number"?e:typeof e=="string"?Number(e):NaN;return Number.isInteger(t)&&t>0?t:null}function fe(e){const t=typeof e=="number"?e:typeof e=="string"?Number(e):NaN;return Number.isInteger(t)&&t>=0?t:null}function B(e){return typeof e=="boolean"?e:null}function st(e){return pe(e).some(n=>p(n)&&(n.ranges===!0||n.includeRanges===!0))}function pe(e){const t=On(e),n=Array.isArray(e.requests)?e.requests:[e],s=[];for(const i of n){if(!p(i)){s.push(i);continue}const o={...t,...i};delete o.requests;const l=Array.isArray(o.entities)?o.entities:null;if(!l){delete o.entities,s.push(o);continue}const r=a(o.op);if(r==="usages"||r==="duplicate"||r==="duplicates"){s.push(o);continue}delete o.entities;for(const c of l){if(p(c)){const u=Array.isArray(c.entities)?c.entities:null;if(u){const d={...c};delete d.entities;for(const m of u)s.push(Ln(o,d,m));continue}s.push({...o,...c});continue}if(typeof c!="string"||c.trim()===""){s.push({...o,entity:c});continue}s.push({...o,entity:c.trim()})}}return s}function Ln(e,t,n){return p(n)?{...e,...t,...n}:typeof n=="string"&&n.trim()!==""?{...e,...t,entity:n.trim()}:{...e,...t,entity:n}}function On(e){const t={};for(const n of["op","sourceFile","file","target","usageTarget","dir","scope","scopes","excludeTarget","includeTarget","ranges","includeRanges","resolveStar","localOnly","parent","offset","limit","all","memberOffset","memberLimit","memberAll","detail","mode","kinds","entities","entity","exclude","excludes","pathExclude","pathExcludes","excludePath","excludePaths","toFile","outputFile","save","show","bundleSave","bundle","saveBundle","previewFiles","preview","previewDir","outputDir","previewPatch","modules","facade","facadeFile"])e[n]!==void 0&&(t[n]=e[n]);return t}function F(e,t){const n=e.indexOf(t);if(n<0)return null;const s=e[n+1];return s&&!s.startsWith("--")?s:null}function R(e,t){const n=[];for(let s=0;s<e.length;s+=1){if(e[s]!==t)continue;const i=e[s+1];i&&!i.startsWith("--")&&n.push(i)}return n}function it(e,t){const n=e.indexOf(t);return n>0&&(e[n-1]==="--parent"||e[n-1]==="--max-lines"||e[n-1]==="--to-file"||e[n-1]==="--save"||e[n-1]==="--bundle-save"||e[n-1]==="--preview-dir"||e[n-1]==="--from-json"||e[n-1]==="--from-dsl"||e[n-1]==="--from"||e[n-1]==="--offset"||e[n-1]==="--limit"||e[n-1]==="--max-code-lines"||e[n-1]==="--maxCodeLines"||e[n-1]==="--scope"||e[n-1]==="--detail"||e[n-1]==="--mode"||e[n-1]==="--kind"||e[n-1]==="--kinds"||e[n-1]==="--entity"||e[n-1]==="--entities"||e[n-1]==="--exclude"||e[n-1]==="--excludes"||e[n-1]==="--path-exclude"||e[n-1]==="--path-excludes"||e[n-1]==="--exclude-path"||e[n-1]==="--exclude-paths")}function Tn(e,t,n){return Array.isArray(t)?t.filter(p).map(s=>{const i=a(s.target)??a(s.targetFile)??a(s.file),o=Array.isArray(s.entities)?s.entities:Array.isArray(s.symbols)?s.symbols:[];return{...i?{targetFile:k(e,i)}:{},symbols:o.map(l=>Mn(l,n)).filter(p)}}):[]}function $n(e,t){return e.flatMap(n=>ot(n,t,{})).filter(p)}function ot(e,t,n){if(typeof e=="string"&&e.trim()!==""){const c=(0,$.parseInspectSelector)(e,t);return[{...n,raw:e.trim(),symbolName:c.symbolName,...c.symbolKind?{symbolKind:c.symbolKind}:{}}]}if(!p(e))return[];const s=a(e.parent),i={...n};if(s){const c=(0,$.parseInspectSelector)(s,t);i.parentName=c.symbolName,c.symbolKind&&(i.parentKind=c.symbolKind)}const o=Array.isArray(e.entities)?e.entities:null;if(o)return o.flatMap(c=>ot(c,t,i));const l=a(e.entity)??a(e.selector)??a(e.raw);if(!l)return[];const r=(0,$.parseInspectSelector)(l,t);return[{...i,raw:l,symbolName:r.symbolName,...r.symbolKind?{symbolKind:r.symbolKind}:{}}]}function Mn(e,t){if(typeof e=="string"&&e.trim()!==""){const s=(0,$.parseInspectSelector)(e,t);return{raw:e.trim(),symbolName:s.symbolName,...s.symbolKind?{symbolKind:s.symbolKind}:{}}}if(!p(e))return null;const n=a(e.entity)??a(e.selector)??a(e.raw);if(n){const s=(0,$.parseInspectSelector)(n,t);return{raw:n,symbolName:s.symbolName,...s.symbolKind?{symbolKind:s.symbolKind}:{}}}return e}function rt(e){return e==="file"||e==="exports"||e==="imports"||e==="members"||e==="code"||e==="deps"||e==="slice"||e==="modulePlan"||e==="usages"||e==="duplicate"||e==="duplicates"||e==="tree"||e==="cycles"}function lt(e){return e==="deps"?"dependencies":e==="duplicate"?"duplicates":e==="cycles"?"cycles":e==="imports"?"imports":e}function at(e,t){e!=="modulePlan"||t||ct()}function ct(){throw new E.CliError("INSPECT_MODULE_PLAN_UNSUPPORTED","inspect is limited to file, exports, members, code, slice, deps, usages, duplicates, graph, tree, cycles, and imports. Use modulePlan preview/revise/apply/validate for module extraction plans.")}function Un(e,t){return e[0]==="modulePlan"?!0:!e.includes("--stdin")||!p(t)?!1:a(t.op)==="modulePlan"?!0:(Array.isArray(t.requests)?t.requests:[]).some(i=>p(i)&&a(i.op)==="modulePlan")}function a(e){return typeof e=="string"&&e.trim()!==""?e.trim():null}function K(e){return typeof e=="string"&&e.trim()!==""?[e.trim()]:Array.isArray(e)?e.filter(t=>typeof t=="string"&&t.trim()!=="").map(t=>t.trim()):null}function ut(e){if(typeof e=="string"&&e.trim()!=="")return e.trim();if(!Array.isArray(e))return null;const t=e.find(n=>typeof n=="string"&&n.trim()!=="");return typeof t=="string"?t.trim():null}function Bn(e,t){const n=[...R(e,"--kind"),...R(e,"--kinds").flatMap(s=>s.split(","))];return dt(n,t)}function kn(e,t){const n=K(e)??[];return dt(n.flatMap(s=>s.split(",")),t)}function de(e,t){return(Array.isArray(e)?e:typeof e=="string"?e.split(","):e&&typeof e=="object"&&!Array.isArray(e)?[e]:[]).flatMap(s=>{if(typeof s=="string"){const l=s.trim();if(!l)return[];const r=(0,$.parseInspectSelector)(l,t);return[pt(r.symbolName,r.symbolKind??null)]}if(!p(s))return[];const i=a(s.entity)??a(s.selector)??a(s.name);if(!i)return[];const o=(0,$.parseInspectSelector)(i,t);return[pt(o.symbolName,o.symbolKind??null)]})}function ft(e,t){return(Array.isArray(t)?t:typeof t=="string"?t.split(","):[]).filter(s=>typeof s=="string").map(s=>s.trim()).filter(s=>s.length>0).map(s=>L.isAbsolute(s)?s:L.resolve(e,s)).map(s=>s.replace(/\\/g,"/"))}function pt(e,t){return t?{symbolName:e,symbolKind:t}:{symbolName:e}}function dt(e,t){const n=new Map;for(const[i,o]of Object.entries(t.entityKindAliases))n.set(i.toLowerCase(),i),n.set(String(o).toLowerCase(),i);const s=e.map(i=>n.get(i.trim().toLowerCase())??"").filter(i=>i!=="");return Array.from(new Set(s))}function p(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInspect = runInspect;
+exports.buildInspectRequest = buildInspectRequest;
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+const node_crypto_1 = require("node:crypto");
+const resolve_1 = require("../config/resolve");
+const env_vars_1 = require("../config/env-vars");
+const request_env_1 = require("../config/request-env");
+const standalone_inspect_analysis_1 = require("../inspect/standalone-inspect-analysis");
+const standalone_inspect_process_1 = require("../inspect/standalone-inspect-process");
+const inspect_source_shape_1 = require("../inspect/inspect-source-shape");
+const agent_dx_1 = require("../agent-dx/agent-dx");
+const errors_1 = require("../shared/errors");
+const agent_text_1 = require("../shared/agent-text");
+const inspect_format_1 = require("./inspect-format");
+const inspect_selector_1 = require("./inspect-selector");
+const module_plan_cache_1 = require("./module-plan-cache");
+const json_file_input_1 = require("./json-file-input");
+const inspect_graph_1 = require("./inspect-graph");
+const inspect_cycles_1 = require("./inspect-cycles");
+const inspect_imports_1 = require("./inspect-imports");
+const inspect_tree_1 = require("./inspect-tree");
+const inspect_topology_1 = require("./inspect-topology");
+const inspect_alias_candidates_1 = require("./inspect-alias-candidates");
+const path_display_1 = require("../config/path-display");
+const session_workspace_1 = require("./session-workspace");
+const inspect_usages_detail_1 = require("./inspect-usages-detail");
+const inspect_direct_usages_1 = require("./inspect-direct-usages");
+const inspect_request_values_1 = require("./inspect-request-values");
+async function runInspect(cwd, restArgs, stdinPayload, options = {}, commandOptions = {}) {
+    const observationSignals = (0, agent_dx_1.collectAgentDxObservationSignals)(cwd, buildInspectObservation(restArgs, stdinPayload));
+    if (isInspectUsagesSavedDetailRequest(restArgs)) {
+        return runInspectUsagesSavedDetail(cwd, restArgs);
+    }
+    const inlinePayload = readInlineInspectPayload(cwd, restArgs, stdinPayload);
+    if (inlinePayload && isGraphOnlyInlinePayload(inlinePayload)) {
+        const runInProcess = () => runInspectWithInlineLocal(cwd, restArgs, inlinePayload, options, commandOptions);
+        return commandOptions.lexicalGraph
+            ? commandOptions.lexicalGraph.executeInspectGraph(cwd, restArgs, stdinPayload, runInProcess)
+            : runInProcess();
+    }
+    if (inlinePayload && inspectPayloadContainsLocal(inlinePayload)) {
+        return runInspectWithInlineLocal(cwd, restArgs, inlinePayload, options, commandOptions);
+    }
+    if ((0, inspect_graph_1.isInspectGraphRequest)(restArgs, stdinPayload)) {
+        const runInProcess = async () => (0, inspect_graph_1.runInspectGraph)(cwd, restArgs, stdinPayload);
+        return commandOptions.lexicalGraph
+            ? commandOptions.lexicalGraph.executeInspectGraph(cwd, restArgs, stdinPayload, runInProcess)
+            : runInProcess();
+    }
+    if ((0, inspect_topology_1.isInspectTopologyRequest)(restArgs, stdinPayload)) {
+        const runInProcess = () => (0, inspect_topology_1.runInspectTopology)(cwd, restArgs, commandOptions.semanticContextPool);
+        const result = restArgs[0] === "boundaries" && commandOptions.semanticBoundaries
+            ? await commandOptions.semanticBoundaries.executeInspectBoundaries(cwd, restArgs, runInProcess)
+            : runInProcess();
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, result, observationSignals);
+    }
+    if ((0, inspect_cycles_1.isInspectCyclesRequest)(restArgs, stdinPayload)) {
+        return (0, inspect_cycles_1.runInspectCycles)(cwd, restArgs, stdinPayload);
+    }
+    if ((0, inspect_tree_1.isInspectTreeRequest)(restArgs, stdinPayload)) {
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, (0, inspect_tree_1.runInspectTree)(cwd, restArgs, stdinPayload), observationSignals);
+    }
+    if ((0, inspect_alias_candidates_1.isInspectAliasCandidatesRequest)(restArgs, stdinPayload)) {
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, (0, inspect_alias_candidates_1.runInspectAliasCandidates)(cwd, restArgs, stdinPayload), observationSignals);
+    }
+    if (restArgs[0] === "imports") {
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, (0, inspect_imports_1.runInspectImports)(cwd, restArgs, stdinPayload), [
+            ...observationSignals,
+            ...collectInspectAgentDxSignals(restArgs)
+        ]);
+    }
+    if (commandOptions.allowModulePlan !== true && (0, inspect_request_values_1.inspectArgsContainModulePlan)(restArgs, stdinPayload)) {
+        (0, inspect_request_values_1.throwInspectModulePlanUnsupported)();
+    }
+    const standaloneConfig = (0, resolve_1.resolveCliConfig)(null);
+    const standaloneRequest = buildInspectRequest(cwd, restArgs, stdinPayload, standaloneConfig, commandOptions.allowModulePlan === true, commandOptions.forceResults === true);
+    applyDirectoryInspectFallbacks(cwd, standaloneRequest);
+    ensureStandaloneInspectSelectorsResolvable(standaloneRequest.payload, standaloneConfig);
+    prepareExecutableModulePlanRequests(cwd, standaloneRequest);
+    const workspaceContextDebug = inspectWorkspaceContextDebugEnabled(restArgs);
+    applyInspectWorkspaceContextDebugFlag(standaloneRequest.payload, workspaceContextDebug);
+    const payload = inspectBuiltRequestNeedsWorker(standaloneRequest)
+        ? await (0, standalone_inspect_process_1.runStandaloneInspectWorker)(cwd, standaloneRequest.payload)
+        : await (0, standalone_inspect_analysis_1.runStandaloneInspectPayload)(cwd, standaloneRequest.payload);
+    writeInspectWorkspaceContextDebugArtifact(cwd, workspaceContextDebug, standaloneRequest.payload, payload);
+    cacheExecutableModulePlans(cwd, standaloneRequest, payload);
+    const response = (0, inspect_format_1.formatInspectResponse)(payload, standaloneConfig, standaloneRequest.formatOptions);
+    return (0, agent_dx_1.applyAgentDxSignals)(cwd, applyInspectDslDiagnostics(applyUsagesDetails(cwd, payload, response, standaloneRequest), standaloneRequest), [...observationSignals, ...(standaloneRequest.agentDxSignals ?? [])]);
+}
+function inspectBuiltRequestNeedsWorker(request) {
+    const rows = Array.isArray(request.payload.requests) ? request.payload.requests.filter(inspect_usages_detail_1.isObject) : [request.payload];
+    return rows.some((row) => (0, inspect_usages_detail_1.readString)(row.op) === "usages" || (0, inspect_usages_detail_1.readString)(row.op) === "duplicates");
+}
+function ensureStandaloneInspectSelectorsResolvable(payload, config) {
+    const requests = Array.isArray(payload.requests) ? payload.requests.filter(inspect_usages_detail_1.isObject) : [payload];
+    const ambiguities = [];
+    const symbolsByFile = new Map();
+    for (const request of requests) {
+        const op = (0, inspect_usages_detail_1.readString)(request.op);
+        const sourceFile = (0, inspect_usages_detail_1.readString)(request.sourceFile);
+        const symbolName = (0, inspect_usages_detail_1.readString)(request.symbolName);
+        if (!sourceFile || !symbolName || (0, inspect_usages_detail_1.readString)(request.symbolKind) || !["code", "slice", "dependencies", "members", "usages"].includes(op ?? "")) {
+            continue;
+        }
+        if (!fs.existsSync(sourceFile) || !fs.statSync(sourceFile).isFile()) {
+            continue;
+        }
+        let symbols = symbolsByFile.get(sourceFile);
+        if (!symbols) {
+            symbols = (0, inspect_source_shape_1.collectInspectSymbols)(sourceFile, fs.readFileSync(sourceFile, "utf8"));
+            symbolsByFile.set(sourceFile, symbols);
+        }
+        const matches = symbols.filter((symbol) => symbol.name === symbolName);
+        if (matches.length <= 1) {
+            continue;
+        }
+        ambiguities.push({
+            entity: symbolName,
+            suggestions: matches.map((symbol) => {
+                const alias = config.entityKindAliases[symbol.kind] ?? symbol.kind;
+                return `${alias}${config.selectorSeparator}${symbolName}`;
+            })
+        });
+    }
+    if (ambiguities.length === 0) {
+        return;
+    }
+    const first = ambiguities[0];
+    throw new errors_1.CliError("AMBIGUOUS_ENTITY_SELECTOR", ambiguities.length === 1 ? `Ambiguity detected for entity "${first.entity}".` : `Ambiguity detected for ${ambiguities.length} entities.`, { ambiguities, suggestions: first.suggestions });
+}
+function isGraphOnlyInlinePayload(payload) {
+    const requests = (0, inspect_request_values_1.expandInspectStdinRequests)(payload);
+    return requests.length > 0 && requests.every((request) => (0, inspect_usages_detail_1.isObject)(request) && (0, inspect_usages_detail_1.readString)(request.op) === "graph");
+}
+function inspectWorkspaceContextDebugEnabled(restArgs) {
+    return restArgs.includes("--debug-workspace-context") ||
+        process.argv.includes("--debug-workspace-context");
+}
+function applyInspectWorkspaceContextDebugFlag(payload, enabled) {
+    if (!enabled) {
+        return;
+    }
+    if (typeof payload.op === "string") {
+        payload.debugWorkspaceContext = true;
+    }
+    if (!Array.isArray(payload.requests)) {
+        return;
+    }
+    for (const request of payload.requests) {
+        if ((0, inspect_usages_detail_1.isObject)(request)) {
+            request.debugWorkspaceContext = true;
+        }
+    }
+}
+function writeInspectWorkspaceContextDebugArtifact(cwd, enabled, request, response) {
+    if (!enabled) {
+        return;
+    }
+    try {
+        const dir = path.join(cwd, ".aib-debug", "workspace-context");
+        fs.mkdirSync(dir, { recursive: true });
+        const hash = (0, node_crypto_1.createHash)("sha1").update(JSON.stringify(request)).digest("hex").slice(0, 10);
+        const fileName = `${new Date().toISOString().replace(/[:.]/g, "-")}-inspect-${hash}.json`;
+        fs.writeFileSync(path.join(dir, fileName), `${JSON.stringify({
+            schemaVersion: 1,
+            kind: "inspect.workspaceContext",
+            cwd: path.resolve(cwd),
+            request,
+            response
+        }, null, 2)}\n`);
+    }
+    catch {
+        // Debug artifacts are best-effort and must never change inspect behavior.
+    }
+}
+function isInspectUsagesSavedDetailRequest(restArgs) {
+    return restArgs[0] === "usages" && (0, inspect_request_values_1.readFlagValue)(restArgs, "--from-file") !== null;
+}
+function runInspectUsagesSavedDetail(cwd, restArgs) {
+    const fromFile = (0, inspect_request_values_1.readFlagValue)(restArgs, "--from-file");
+    if (!fromFile) {
+        throw new errors_1.CliError("USAGES_FROM_FILE_REQUIRED", "inspect usages --from-file expects a saved usages handle or JSON file.");
+    }
+    const file = (0, session_workspace_1.resolveSessionFileArgument)(cwd, fromFile);
+    const artifact = (0, json_file_input_1.readJsonObjectFile)(cwd, file, "INVALID_USAGES_ARTIFACT");
+    const focus = (0, inspect_request_values_1.readFlagValues)(restArgs, "--focus");
+    const detailOptions = (0, inspect_usages_detail_1.readUsagesDetailOptions)(cwd, {
+        detail: (0, inspect_request_values_1.readFlagValue)(restArgs, "--detail") ?? "locations",
+        all: restArgs.includes("--all"),
+        limit: (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--limit"),
+        maxCodeLines: (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--max-code-lines") ?? (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--maxCodeLines")
+    });
+    if (detailOptions.detail === "summary") {
+        throw new errors_1.CliError("INVALID_USAGES_DETAIL", "inspect usages --from-file --detail expects locations or code.");
+    }
+    if (detailOptions.detail !== "locations" && detailOptions.detail !== "code") {
+        throw new errors_1.CliError("INVALID_USAGES_DETAIL", "inspect usages --detail expects locations or code.");
+    }
+    const result = (0, inspect_usages_detail_1.buildUsagesDetail)(cwd, artifact, focus, detailOptions);
+    return (0, agent_text_1.attachAgentText)(result, (0, inspect_usages_detail_1.formatUsagesDetailAgentText)(cwd, result));
+}
+function applyUsagesDetails(cwd, payload, response, builtRequest) {
+    const details = builtRequest.usagesDetails ?? [];
+    const responseWithMetadata = applyUsagesRequestMetadata(response, builtRequest);
+    if (details.length === 0 || details.every((detail) => detail === null || detail.detail === "summary")) {
+        return responseWithMetadata;
+    }
+    const rawResults = Array.isArray(payload.results) ? payload.results.filter(inspect_usages_detail_1.isObject) : [];
+    if (rawResults.length === 0) {
+        return responseWithMetadata;
+    }
+    const responseRows = Array.isArray(responseWithMetadata.results) ? responseWithMetadata.results.filter(inspect_usages_detail_1.isObject) : [responseWithMetadata];
+    const requestRows = Array.isArray(builtRequest.payload.requests) ? builtRequest.payload.requests.filter(inspect_usages_detail_1.isObject) : [];
+    const rows = rawResults.map((rawResult, index) => {
+        const detail = details[index];
+        const row = responseRows[index] ?? {};
+        const requestRow = requestRows[index];
+        if (requestRow?.targetLocalUsagesHidden === true) {
+            rawResult.targetLocalUsagesHidden = true;
+        }
+        if (rawResult.op !== "usages" || detail === undefined || detail === null || detail.detail === "summary") {
+            return row;
+        }
+        const detailResult = (0, inspect_usages_detail_1.buildUsagesDetail)(cwd, rawResult, [], detail, true);
+        if (typeof row.id === "string") {
+            detailResult.id = row.id;
+        }
+        detailResult.op = "usages";
+        (0, inspect_usages_detail_1.copyUsageDetailSummaryFields)(row, detailResult);
+        if ((0, inspect_usages_detail_1.isObject)(rawResult.debug)) {
+            detailResult.debug = rawResult.debug;
+        }
+        return detailResult;
+    });
+    (0, inspect_usages_detail_1.attachUsagesViewAll)(cwd, rows);
+    (0, inspect_usages_detail_1.stripUsagesViewRecords)(rows);
+    const result = rows.length === 1 ? rows[0] : { results: rows };
+    return (0, agent_text_1.attachAgentText)(result, (0, inspect_usages_detail_1.formatUsagesDetailResponseAgentText)(cwd, result, responseWithMetadata));
+}
+function applyUsagesRequestMetadata(response, builtRequest) {
+    const requestRows = Array.isArray(builtRequest.payload.requests) ? builtRequest.payload.requests.filter(inspect_usages_detail_1.isObject) : [];
+    const responseRows = Array.isArray(response.results) ? response.results.filter(inspect_usages_detail_1.isObject) : null;
+    if (responseRows) {
+        responseRows.forEach((row, index) => applyUsageRequestMetadata(row, requestRows[index]));
+        return response;
+    }
+    applyUsageRequestMetadata(response, requestRows[0]);
+    return response;
+}
+function applyUsageRequestMetadata(row, request) {
+    if (request?.targetLocalUsagesHidden !== true) {
+        return;
+    }
+    row.targetLocalUsagesHidden = true;
+    if (row.scope === "excluding target") {
+        delete row.scope;
+    }
+}
+function applyInspectDslDiagnostics(response, builtRequest) {
+    return applyDslDiagnosticsToResponse(response, builtRequest.dslDiagnostics ?? []);
+}
+function applyDslDiagnosticsToResponse(response, diagnostics) {
+    if (diagnostics.length === 0) {
+        return response;
+    }
+    const text = (0, agent_text_1.readAgentText)(response);
+    const diagnosticText = formatDslDiagnosticsAgentText(diagnostics);
+    return (0, agent_text_1.attachAgentText)({
+        ...response,
+        dslDiagnostics: diagnostics.map((diagnostic) => ({
+            line: diagnostic.line,
+            message: diagnostic.message
+        }))
+    }, text ? `${text.trimEnd()}\n\n${diagnosticText}` : diagnosticText);
+}
+function formatDslDiagnosticsAgentText(diagnostics) {
+    return [
+        "dsl errors:",
+        ...diagnostics.map((diagnostic) => `line ${diagnostic.line}: ${diagnostic.message}`)
+    ].join("\n");
+}
+function readDslDiagnosticsProperty(payload) {
+    const raw = payload.dslDiagnostics;
+    if (!Array.isArray(raw)) {
+        return {};
+    }
+    const diagnostics = raw.flatMap((item) => {
+        if (!(0, inspect_usages_detail_1.isObject)(item)) {
+            return [];
+        }
+        const line = typeof item.line === "number" && Number.isFinite(item.line) ? item.line : null;
+        const message = typeof item.message === "string" && item.message.length > 0 ? item.message : null;
+        return line !== null && message !== null ? [{ line, message }] : [];
+    });
+    return diagnostics.length > 0 ? { dslDiagnostics: diagnostics } : {};
+}
+async function runInspectWithInlineLocal(cwd, restArgs, rawPayload, options, commandOptions) {
+    const expandedRequests = (0, inspect_request_values_1.expandInspectStdinRequests)(rawPayload);
+    const inspectRequests = [];
+    const graphRequests = [];
+    const importsRequests = [];
+    const treeRequests = [];
+    const cyclesRequests = [];
+    const aliasCandidatesRequests = [];
+    const agentDxSignals = [];
+    const displayPathAliases = (0, path_display_1.buildDisplayPathAliases)(cwd, (0, session_workspace_1.readEffectiveSessionPathAliases)(cwd));
+    const order = [];
+    for (const rawRequest of expandedRequests) {
+        if (!(0, inspect_usages_detail_1.isObject)(rawRequest)) {
+            throw new errors_1.CliError("INVALID_INSPECT_REQUEST", "Inspect request must be an object.");
+        }
+        const op = (0, inspect_usages_detail_1.readString)(rawRequest.op);
+        const dslSignal = op ? collectInspectDslAgentDxSignal(op, rawRequest) : null;
+        if (dslSignal) {
+            agentDxSignals.push(dslSignal);
+        }
+        if (op === "graph") {
+            graphRequests.push(stripInlineGraphOp(rawRequest));
+            order.push("graph");
+        }
+        else if (op === "imports") {
+            importsRequests.push(rawRequest);
+            order.push("imports");
+        }
+        else if (op === "tree") {
+            treeRequests.push(rawRequest);
+            order.push("tree");
+        }
+        else if (op === "cycles") {
+            cyclesRequests.push(rawRequest);
+            order.push("cycles");
+        }
+        else if (op === "aliasCandidates" || op === "alias-candidates") {
+            aliasCandidatesRequests.push(rawRequest);
+            order.push("aliasCandidates");
+        }
+        else {
+            inspectRequests.push(rawRequest);
+            order.push("inspect");
+        }
+    }
+    const inspectResults = await runRuntimeInspectRequests(cwd, inspectRequests, options, commandOptions);
+    const graphResults = graphRequests.length > 0
+        ? readGraphResponseResults((0, agent_text_1.stripAgentText)((0, inspect_graph_1.runInspectGraph)(cwd, ["graph", "--stdin"], {
+            requests: graphRequests
+        })))
+        : [];
+    const importsResults = importsRequests.map((request) => (0, inspect_imports_1.buildInspectImportsResult)(cwd, {
+        file: (0, inspect_usages_detail_1.readString)(request.file) ?? (0, inspect_usages_detail_1.readString)(request.fromFile) ?? (0, inspect_usages_detail_1.readString)(request.sourceFile) ?? (0, inspect_usages_detail_1.readString)(rawPayload.file) ?? "",
+        ranges: (0, inspect_request_values_1.readBoolean)(request.ranges) !== false
+    }, displayPathAliases));
+    const treeResults = treeRequests.map((request) => (0, inspect_tree_1.buildInspectTreeResult)(cwd, buildInlineTreeInput(request)));
+    const cyclesResults = cyclesRequests.length > 0
+        ? readResponseResults((0, agent_text_1.stripAgentText)((0, inspect_cycles_1.runInspectCycles)(cwd, ["--stdin"], {
+            requests: cyclesRequests
+        })))
+        : [];
+    const aliasCandidatesResults = aliasCandidatesRequests.map((request) => (0, inspect_alias_candidates_1.buildInspectAliasCandidatesResult)(cwd, buildInlineAliasCandidatesInput(request)));
+    const results = [];
+    let inspectIndex = 0;
+    let graphIndex = 0;
+    let importsIndex = 0;
+    let treeIndex = 0;
+    let cyclesIndex = 0;
+    let aliasCandidatesIndex = 0;
+    for (const item of order) {
+        if (item === "graph") {
+            const graphResult = graphResults[graphIndex++];
+            if (graphResult) {
+                results.push(graphResult);
+            }
+        }
+        else if (item === "imports") {
+            const importsResult = importsResults[importsIndex++];
+            if (importsResult) {
+                results.push(importsResult);
+            }
+        }
+        else if (item === "tree") {
+            const treeResult = treeResults[treeIndex++];
+            if (treeResult) {
+                results.push(treeResult);
+            }
+        }
+        else if (item === "cycles") {
+            const cyclesResult = cyclesResults[cyclesIndex++];
+            if (cyclesResult) {
+                results.push(cyclesResult);
+            }
+        }
+        else if (item === "aliasCandidates") {
+            const aliasCandidatesResult = aliasCandidatesResults[aliasCandidatesIndex++];
+            if (aliasCandidatesResult) {
+                results.push(aliasCandidatesResult);
+            }
+        }
+        else {
+            const inspectResult = inspectResults[inspectIndex++];
+            if (inspectResult) {
+                results.push(inspectResult);
+            }
+        }
+    }
+    const response = {
+        ok: results.some((result) => result.ok === false) ? false : true,
+        ...(results.some((result) => result.op === "runtimeFailure") ? { partial: true } : {}),
+        results: (0, inspect_imports_1.mergeDirectoryFallbackResults)(results)
+    };
+    return (0, agent_dx_1.applyAgentDxSignals)(cwd, applyDslDiagnosticsToResponse((0, agent_text_1.attachAgentText)(response, (0, inspect_format_1.formatInspectMixedAgentText)(response)), readDslDiagnosticsProperty(rawPayload).dslDiagnostics ?? []), agentDxSignals);
+}
+function readInlineInspectPayload(cwd, restArgs, stdinPayload) {
+    if (restArgs[0] === "graph") {
+        return null;
+    }
+    if (restArgs.includes("--stdin")) {
+        if (!(0, inspect_usages_detail_1.isObject)(stdinPayload)) {
+            return null;
+        }
+        return stdinPayload;
+    }
+    const fromJson = (0, inspect_request_values_1.readFlagValue)(restArgs, "--from-json");
+    return fromJson ? (0, json_file_input_1.readJsonObjectFile)(cwd, fromJson, "INVALID_INSPECT_JSON_FILE") : null;
+}
+function inspectPayloadContainsLocal(rawPayload) {
+    return (0, inspect_request_values_1.expandInspectStdinRequests)(rawPayload).some((request) => (0, inspect_usages_detail_1.isObject)(request) && ((0, inspect_usages_detail_1.readString)(request.op) === "graph" ||
+        (0, inspect_usages_detail_1.readString)(request.op) === "imports" ||
+        (0, inspect_usages_detail_1.readString)(request.op) === "tree" ||
+        (0, inspect_usages_detail_1.readString)(request.op) === "cycles" ||
+        (0, inspect_usages_detail_1.readString)(request.op) === "aliasCandidates" ||
+        (0, inspect_usages_detail_1.readString)(request.op) === "alias-candidates"));
+}
+async function runRuntimeInspectRequests(cwd, inspectRequests, options, commandOptions) {
+    if (inspectRequests.length === 0) {
+        return [];
+    }
+    try {
+        if ((0, request_env_1.readRequestEnv)(env_vars_1.CLI_ENV.testInspectWorkerFailure) === "deadline") {
+            throw new errors_1.CliError("STANDALONE_INSPECT_WORKER_DEADLINE", "Standalone inspect worker did not finish before the injected test deadline.");
+        }
+        return readResponseResults((0, agent_text_1.stripAgentText)(await runInspect(cwd, ["--stdin"], {
+            requests: inspectRequests
+        }, options, {
+            ...commandOptions,
+            forceResults: true
+        })));
+    }
+    catch (error) {
+        return inspectRequests.map((request) => buildRuntimeInspectFailureResult(cwd, request, error));
+    }
+}
+function buildRuntimeInspectFailureResult(cwd, request, error) {
+    const details = (0, inspect_usages_detail_1.isObject)(error) && (0, inspect_usages_detail_1.isObject)(error.details) ? error.details : {};
+    const code = error instanceof errors_1.CliError ? error.code : "RUNTIME_INSPECT_FAILED";
+    const message = error instanceof Error ? error.message : String(error);
+    const file = (0, inspect_usages_detail_1.readString)(request.file) ??
+        (0, inspect_usages_detail_1.readString)(request.sourceFile) ??
+        (0, inspect_usages_detail_1.readString)(request.fromFile) ??
+        (0, inspect_usages_detail_1.readString)(request.target) ??
+        "";
+    const absoluteFile = file ? path.resolve(cwd, file) : "";
+    return {
+        ok: false,
+        op: "runtimeFailure",
+        requestedOp: (0, inspect_usages_detail_1.readString)(request.op) ?? "file",
+        ...((0, inspect_usages_detail_1.readString)(request.entity) ? { entity: (0, inspect_usages_detail_1.readString)(request.entity) } : {}),
+        ...(absoluteFile ? { sourceFile: absoluteFile, file: (0, inspect_usages_detail_1.displayPath)(cwd, absoluteFile) } : {}),
+        code,
+        error: message,
+        ...(Array.isArray(details.hints) ? { hints: details.hints } : {})
+    };
+}
+function buildInlineTreeInput(request) {
+    const input = {
+        scope: (0, inspect_usages_detail_1.readString)(request.scope) ?? (0, inspect_usages_detail_1.readString)(request.file) ?? (0, inspect_usages_detail_1.readString)(request.dir) ?? (0, inspect_usages_detail_1.readString)(request.directory) ?? ""
+    };
+    const displayScope = (0, inspect_usages_detail_1.readString)(request.displayScope) ?? (0, inspect_usages_detail_1.readString)(request.display_scope);
+    const depth = (0, inspect_request_values_1.readPositiveInteger)(request.depth);
+    const minDepth = (0, inspect_request_values_1.readNonNegativeInteger)(request.minDepth) ?? (0, inspect_request_values_1.readNonNegativeInteger)(request.min_depth);
+    const limit = (0, inspect_request_values_1.readPositiveInteger)(request.limit);
+    const exclude = (0, inspect_usages_detail_1.readStringArray)(request.exclude) ?? (0, inspect_usages_detail_1.readStringArray)(request.excludes);
+    const only = (0, inspect_usages_detail_1.readStringArray)(request.only);
+    const onlyDirs = (0, inspect_request_values_1.readBoolean)(request.onlyDirs) ?? (0, inspect_request_values_1.readBoolean)(request.only_dirs);
+    if (displayScope !== null) {
+        input.displayScope = displayScope;
+    }
+    if (depth !== null) {
+        input.depth = depth;
+    }
+    if (minDepth !== null) {
+        input.minDepth = minDepth;
+    }
+    if (limit !== null) {
+        input.limit = limit;
+    }
+    if (exclude !== null) {
+        input.exclude = exclude;
+    }
+    if (only !== null) {
+        input.only = only;
+    }
+    if (onlyDirs !== null) {
+        input.onlyDirs = onlyDirs;
+    }
+    return input;
+}
+function buildInlineAliasCandidatesInput(request) {
+    const input = {
+        scope: (0, inspect_usages_detail_1.readString)(request.scope) ?? (0, inspect_usages_detail_1.readString)(request.dir) ?? (0, inspect_usages_detail_1.readString)(request.directory) ?? ""
+    };
+    const displayScope = (0, inspect_usages_detail_1.readString)(request.displayScope) ?? (0, inspect_usages_detail_1.readString)(request.display_scope);
+    const limit = (0, inspect_request_values_1.readPositiveInteger)(request.limit);
+    const minImports = (0, inspect_request_values_1.readPositiveInteger)(request.minImports) ?? (0, inspect_request_values_1.readPositiveInteger)(request.min_imports);
+    const minFiles = (0, inspect_request_values_1.readPositiveInteger)(request.minFiles) ?? (0, inspect_request_values_1.readPositiveInteger)(request.min_files);
+    const detail = (0, inspect_usages_detail_1.readString)(request.detail);
+    const candidate = (0, inspect_usages_detail_1.readString)(request.candidate);
+    const include = (0, inspect_usages_detail_1.readStringArray)(request.include) ?? (0, inspect_usages_detail_1.readStringArray)(request.only);
+    const exclude = (0, inspect_usages_detail_1.readStringArray)(request.exclude) ?? (0, inspect_usages_detail_1.readStringArray)(request.excludes);
+    if (displayScope !== null) {
+        input.displayScope = displayScope;
+    }
+    if (limit !== null) {
+        input.limit = limit;
+    }
+    if (minImports !== null) {
+        input.minImports = minImports;
+    }
+    if (minFiles !== null) {
+        input.minFiles = minFiles;
+    }
+    if (detail !== null) {
+        input.detail = detail;
+    }
+    if (candidate !== null) {
+        input.candidate = candidate;
+    }
+    if (include !== null) {
+        input.include = include;
+    }
+    if (exclude !== null) {
+        input.exclude = exclude;
+    }
+    return input;
+}
+function stripInlineGraphOp(request) {
+    const graphRequest = { ...request };
+    delete graphRequest.op;
+    delete graphRequest.sourceFile;
+    return graphRequest;
+}
+function readResponseResults(response) {
+    if (Array.isArray(response.results)) {
+        return response.results.filter(inspect_usages_detail_1.isObject).map(normalizeComposedInspectResult);
+    }
+    return [normalizeComposedInspectResult(response)];
+}
+function normalizeComposedInspectResult(result) {
+    return result.op === "dependencies"
+        ? {
+            ...result,
+            op: "deps"
+        }
+        : result;
+}
+function readGraphResponseResults(response) {
+    if (Array.isArray(response.results)) {
+        return response.results.filter(inspect_usages_detail_1.isObject).map((result) => ({
+            op: "graph",
+            ...result
+        }));
+    }
+    return [{
+            op: "graph",
+            ...compactGraphResult(response)
+        }];
+}
+function compactGraphResult(response) {
+    const result = { ...response };
+    delete result.operation;
+    delete result.next;
+    delete result.last;
+    if (typeof result.saved === "string") {
+        delete result.graphFile;
+    }
+    return result;
+}
+function prepareExecutableModulePlanRequests(cwd, builtRequest) {
+    const requests = Array.isArray(builtRequest.payload.requests) ? builtRequest.payload.requests : [];
+    requests.forEach((request, index) => {
+        if (!(0, inspect_usages_detail_1.isObject)(request) || request.op !== "modulePlan" || request.previewFiles !== true) {
+            return;
+        }
+        const normalizedRequest = (0, module_plan_cache_1.normalizeModulePlanCacheRequest)(request);
+        const planId = (0, module_plan_cache_1.buildModulePlanId)(normalizedRequest);
+        const rawPreviewDir = (0, inspect_usages_detail_1.readString)(request.previewDir);
+        const previewDir = (0, module_plan_cache_1.resolveModulePlanPreviewDir)(cwd, planId, rawPreviewDir ?? undefined);
+        request.previewDir = previewDir;
+        request.previewPatch = request.previewPatch !== false;
+        builtRequest.cachePlans.push({
+            index,
+            planId,
+            normalizedRequest,
+            previewDir
+        });
+    });
+}
+function cacheExecutableModulePlans(cwd, builtRequest, response) {
+    if (builtRequest.cachePlans.length === 0 || !Array.isArray(response.results)) {
+        return;
+    }
+    for (const candidate of builtRequest.cachePlans) {
+        const result = response.results[candidate.index];
+        if (!(0, inspect_usages_detail_1.isObject)(result)) {
+            continue;
+        }
+        const sourceFile = (0, inspect_usages_detail_1.readString)(candidate.normalizedRequest.sourceFile);
+        if (!sourceFile) {
+            continue;
+        }
+        const sourceHash = (0, module_plan_cache_1.hashFile)(sourceFile);
+        const planHash = (0, module_plan_cache_1.buildModulePlanHash)(candidate.normalizedRequest, sourceHash, result);
+        const record = {
+            planId: candidate.planId,
+            planHash,
+            createdAt: new Date().toISOString(),
+            cwd: path.resolve(cwd),
+            sourceFile,
+            sourceHash,
+            executable: result.ok !== false,
+            normalizedRequest: candidate.normalizedRequest,
+            inspectPayload: builtRequest.payload,
+            previewDir: candidate.previewDir,
+            previewResult: result
+        };
+        (0, module_plan_cache_1.writeModulePlanRecord)(cwd, record);
+        result.planId = candidate.planId;
+        result.planHash = planHash;
+        result.cached = true;
+        result.executable = result.ok !== false;
+        result.next = result.ok === false
+            ? "Adjust the modulePlan segment and rerun aib mutate preview or execute."
+            : "Run aib mutate execute --stdin with the matching modulePlan segment if the plan matches intent.";
+    }
+}
+function applyDirectoryInspectFallbacks(cwd, builtRequest) {
+    if (!Array.isArray(builtRequest.payload.requests)) {
+        return;
+    }
+    const requests = builtRequest.payload.requests.filter(inspect_usages_detail_1.isObject);
+    const fallbackBySource = new Map();
+    const newRequests = [];
+    const indexMap = new Map();
+    for (let index = 0; index < requests.length; index += 1) {
+        const request = requests[index];
+        const sourceFile = (0, inspect_usages_detail_1.readString)(request.sourceFile);
+        if (!sourceFile || !isFileInspectOp((0, inspect_usages_detail_1.readString)(request.op)) || !(0, inspect_request_values_1.isExistingDirectory)(sourceFile)) {
+            indexMap.set(index, newRequests.length);
+            newRequests.push(request);
+            continue;
+        }
+        let fallback = fallbackBySource.get(sourceFile);
+        if (!fallback) {
+            fallback = buildDirectoryInspectFallback(cwd, sourceFile);
+            fallbackBySource.set(sourceFile, fallback);
+            indexMap.set(index, newRequests.length);
+            newRequests.push(directoryInspectFallbackRequest(fallback));
+        }
+        else {
+            indexMap.set(index, newRequests.findIndex((item) => (0, inspect_usages_detail_1.readString)(item.sourceFile) === sourceFile && item.op === "directoryFallback"));
+        }
+        const op = formatInspectOpForFallback((0, inspect_usages_detail_1.readString)(request.op));
+        if (!fallback.ops.includes(op)) {
+            fallback.ops.push(op);
+        }
+    }
+    if (fallbackBySource.size === 0) {
+        return;
+    }
+    builtRequest.payload.requests = newRequests;
+    if (builtRequest.formatOptions.toFiles) {
+        builtRequest.formatOptions.toFiles = remapNullableArray(builtRequest.formatOptions.toFiles, indexMap, newRequests.length);
+    }
+    if (builtRequest.formatOptions.saves) {
+        builtRequest.formatOptions.saves = remapNullableArray(builtRequest.formatOptions.saves, indexMap, newRequests.length);
+    }
+    if (builtRequest.formatOptions.shows) {
+        builtRequest.formatOptions.shows = remapBooleanArray(builtRequest.formatOptions.shows, indexMap, newRequests.length);
+    }
+    if (builtRequest.formatOptions.ranges) {
+        builtRequest.formatOptions.ranges = remapBooleanArray(builtRequest.formatOptions.ranges, indexMap, newRequests.length);
+    }
+    if (builtRequest.formatOptions.parentNames) {
+        builtRequest.formatOptions.parentNames = remapNullableArray(builtRequest.formatOptions.parentNames, indexMap, newRequests.length);
+    }
+    if (builtRequest.usagesDetails) {
+        builtRequest.usagesDetails = remapNullableArray(builtRequest.usagesDetails, indexMap, newRequests.length);
+    }
+}
+function isFileInspectOp(op) {
+    return op === "file" ||
+        op === "exports" ||
+        op === "members" ||
+        op === "code" ||
+        op === "dependencies" ||
+        op === "slice";
+}
+function buildDirectoryInspectFallback(cwd, sourceFile) {
+    const depth = detectInspectTreeFallbackDepth(cwd, sourceFile);
+    const aliases = (0, session_workspace_1.readEffectiveSessionPathAliases)(cwd);
+    const directoryDisplayPath = (0, path_display_1.compactDisplayPath)(cwd, sourceFile, (0, path_display_1.buildDisplayPathAliases)(cwd, aliases));
+    const tree = (0, inspect_tree_1.buildInspectTreeResult)(cwd, {
+        scope: sourceFile,
+        displayScope: directoryDisplayPath,
+        depth,
+        limit: 40,
+        aliases
+    });
+    const ops = [];
+    return {
+        sourceFile,
+        displayPath: directoryDisplayPath,
+        ops,
+        command: `aib inspect tree ${directoryDisplayPath} --depth ${depth}`,
+        result: {
+            op: "directoryFallback",
+            ok: true,
+            sourceFile,
+            directory: directoryDisplayPath,
+            skippedOps: ops,
+            command: `aib inspect tree ${directoryDisplayPath} --depth ${depth}`,
+            tree,
+            lines: Array.isArray(tree.lines) ? tree.lines : []
+        }
+    };
+}
+function directoryInspectFallbackRequest(fallback) {
+    return {
+        op: "directoryFallback",
+        sourceFile: fallback.sourceFile,
+        fallback: fallback.result
+    };
+}
+function detectInspectTreeFallbackDepth(cwd, sourceFile) {
+    for (let depth = 1; depth <= 4; depth += 1) {
+        const result = (0, inspect_tree_1.buildInspectTreeResult)(cwd, {
+            scope: sourceFile,
+            depth,
+            limit: 1
+        });
+        if (typeof result.files === "number" && result.files > 0) {
+            return depth;
+        }
+    }
+    return 2;
+}
+function remapNullableArray(values, indexMap, length) {
+    const remapped = Array.from({ length }, () => null);
+    for (const [oldIndex, newIndex] of indexMap.entries()) {
+        if (remapped[newIndex] === null) {
+            remapped[newIndex] = values[oldIndex] ?? null;
+        }
+    }
+    return remapped;
+}
+function remapBooleanArray(values, indexMap, length) {
+    const remapped = Array.from({ length }, () => false);
+    for (const [oldIndex, newIndex] of indexMap.entries()) {
+        remapped[newIndex] = remapped[newIndex] || (values[oldIndex] ?? false);
+    }
+    return remapped;
+}
+function formatInspectOpForFallback(op) {
+    return op === "dependencies" ? "deps" : op ?? "inspect";
+}
+function buildInspectRequest(cwd, restArgs, stdinPayload, config, allowModulePlan, forceResults) {
+    const directOp = readDirectInspectOp(restArgs);
+    const directRangesDisabled = restArgs.includes("--no-ranges") || restArgs.includes("--noRanges");
+    const includeRanges = (!directRangesDisabled && (directOp === "code" || directOp === "file")) ||
+        restArgs.includes("--ranges") ||
+        (directOp === "exports" && (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.exports.ranges", false));
+    const details = restArgs.includes("--details");
+    const resolveStar = restArgs.includes("--resolve-star") ||
+        (directOp === "exports" && (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.exports.resolveStar", false));
+    const localOnly = restArgs.includes("--local-only");
+    const maxCodeLines = (0, inspect_request_values_1.readMaxCodeLines)(cwd, restArgs);
+    const memberOffset = (0, inspect_request_values_1.readNonNegativeIntegerFlag)(restArgs, "--offset");
+    const memberLimit = (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--limit") ??
+        (directOp === "members" ? (0, session_workspace_1.readSessionNumberPref)(cwd, "inspect.members.maxItems", 20) : null);
+    const memberAll = restArgs.includes("--all") ||
+        (directOp === "members" && (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.members.all", false));
+    const toFile = (0, inspect_request_values_1.readFlagValue)(restArgs, "--to-file") ?? undefined;
+    const save = (0, inspect_request_values_1.readFlagValue)(restArgs, "--save") ?? undefined;
+    const explicitHideShow = directOp === "code" && (restArgs.includes("--no-show") || restArgs.includes("--noShow"));
+    const explicitShow = restArgs.includes("--show");
+    const show = explicitHideShow
+        ? false
+        : explicitShow || (directOp === "code" && (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.code.show", true));
+    const codeMeta = (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.code.meta", true);
+    const directUsagesDetail = directOp === "usages"
+        ? (0, inspect_usages_detail_1.readUsagesDetailOptions)(cwd, {
+            detail: (0, inspect_request_values_1.readFlagValue)(restArgs, "--detail"),
+            all: restArgs.includes("--all"),
+            limit: (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--limit"),
+            maxCodeLines: (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--max-code-lines") ?? (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--maxCodeLines")
+        })
+        : null;
+    const bundleSave = (0, inspect_request_values_1.readFlagValue)(restArgs, "--bundle-save") ?? undefined;
+    const previewDir = (0, inspect_request_values_1.readFlagValue)(restArgs, "--preview-dir") ?? undefined;
+    const fromJson = (0, inspect_request_values_1.readFlagValue)(restArgs, "--from-json") ?? undefined;
+    const parentSelector = (0, inspect_request_values_1.readFlagValue)(restArgs, "--parent") ?? undefined;
+    const parentName = parentSelector ? (0, inspect_selector_1.parseInspectSelector)(parentSelector, config).symbolName : undefined;
+    const displayPathAliases = (0, path_display_1.buildDisplayPathAliases)(cwd, (0, session_workspace_1.readEffectiveSessionPathAliases)(cwd));
+    const pathAliasHints = [];
+    if (toFile !== undefined && save !== undefined) {
+        throw new errors_1.CliError("INSPECT_OUTPUT_TARGET_CONFLICT", "Use either --to-file or --save, not both.");
+    }
+    const formatOptions = {
+        cwd,
+        includeRanges,
+        displayPathAliases,
+        pathAliasHints,
+        details,
+        localOnly,
+        maxCodeLines,
+        forceResults,
+        show,
+        codeMeta,
+        ...(parentName !== undefined ? { parentName, parentNames: [parentName] } : {}),
+        ...(toFile !== undefined ? { toFile } : {}),
+        ...(save !== undefined ? { save } : {}),
+        ...(bundleSave !== undefined ? { bundleSave } : {}),
+        ...(previewDir !== undefined ? { previewDir: (0, inspect_request_values_1.resolveCliFilePath)(cwd, previewDir) } : {})
+    };
+    if (fromJson !== undefined) {
+        if (restArgs.includes("--stdin") || stdinPayload !== undefined) {
+            throw new errors_1.CliError("INSPECT_INPUT_SOURCE_CONFLICT", "Use either inspect --stdin or inspect --from-json, not both.");
+        }
+        if (restArgs.includes("--revise")) {
+            throw new errors_1.CliError("LEGACY_MODULE_PLAN_REVISE_REMOVED", "modulePlan revise was removed. Use aib mutate preview or execute with an updated modulePlan segment.");
+        }
+        const fromJsonPayload = applyDirectInspectOpDefault((0, json_file_input_1.readJsonObjectFile)(cwd, fromJson, "INVALID_INSPECT_JSON_FILE"), readDirectInspectOp(restArgs));
+        const fromJsonIncludeRanges = includeRanges || (0, inspect_request_values_1.payloadRequestsRanges)(fromJsonPayload);
+        const builtFromJsonPayload = buildInspectStdinPayload(cwd, fromJsonPayload, config, fromJsonIncludeRanges, resolveStar, localOnly, {
+            memberOffset,
+            memberLimit,
+            memberAll
+        }, allowModulePlan);
+        return {
+            payload: builtFromJsonPayload.payload,
+            cachePlans: [],
+            formatOptions: {
+                ...formatOptions,
+                includeRanges: fromJsonIncludeRanges,
+                toFiles: builtFromJsonPayload.toFiles,
+                saves: builtFromJsonPayload.saves,
+                shows: builtFromJsonPayload.shows,
+                ranges: builtFromJsonPayload.ranges,
+                parentNames: builtFromJsonPayload.parentNames,
+                ...(bundleSave === undefined && builtFromJsonPayload.bundleSave !== undefined
+                    ? { bundleSave: builtFromJsonPayload.bundleSave }
+                    : {})
+            },
+            usagesDetails: builtFromJsonPayload.usagesDetails,
+            agentDxSignals: builtFromJsonPayload.agentDxSignals
+        };
+    }
+    if (stdinPayload !== undefined) {
+        if (!(0, inspect_usages_detail_1.isObject)(stdinPayload)) {
+            throw new errors_1.CliError("INVALID_INSPECT_STDIN", "inspect input expects a JSON object payload.");
+        }
+        if (restArgs.includes("--revise")) {
+            throw new errors_1.CliError("LEGACY_MODULE_PLAN_REVISE_REMOVED", "modulePlan revise was removed. Use aib mutate preview or execute with an updated modulePlan segment.");
+        }
+        const normalizedStdinPayload = applyDirectInspectOpDefault(stdinPayload, directOp);
+        const stdinIncludeRanges = includeRanges || (0, inspect_request_values_1.payloadRequestsRanges)(normalizedStdinPayload);
+        const builtStdinPayload = buildInspectStdinPayload(cwd, normalizedStdinPayload, config, stdinIncludeRanges, resolveStar, localOnly, {
+            memberOffset,
+            memberLimit,
+            memberAll
+        }, allowModulePlan);
+        return {
+            payload: builtStdinPayload.payload,
+            cachePlans: [],
+            formatOptions: {
+                ...formatOptions,
+                includeRanges: stdinIncludeRanges,
+                toFiles: builtStdinPayload.toFiles,
+                saves: builtStdinPayload.saves,
+                shows: builtStdinPayload.shows,
+                ranges: builtStdinPayload.ranges,
+                parentNames: builtStdinPayload.parentNames,
+                ...(bundleSave === undefined && builtStdinPayload.bundleSave !== undefined
+                    ? { bundleSave: builtStdinPayload.bundleSave }
+                    : {})
+            },
+            usagesDetails: builtStdinPayload.usagesDetails,
+            ...readDslDiagnosticsProperty(stdinPayload),
+            agentDxSignals: builtStdinPayload.agentDxSignals
+        };
+    }
+    const directUsagesPayload = (0, inspect_direct_usages_1.parseDirectUsagesKeyValueArgs)(restArgs);
+    if (directUsagesPayload !== null) {
+        const builtDirectUsages = buildInspectStdinPayload(cwd, directUsagesPayload, config, includeRanges, resolveStar, localOnly, {
+            memberOffset,
+            memberLimit,
+            memberAll
+        }, allowModulePlan);
+        return {
+            payload: builtDirectUsages.payload,
+            cachePlans: [],
+            formatOptions: {
+                ...formatOptions,
+                toFiles: builtDirectUsages.toFiles,
+                saves: builtDirectUsages.saves,
+                shows: builtDirectUsages.shows,
+                ranges: builtDirectUsages.ranges,
+                parentNames: builtDirectUsages.parentNames
+            },
+            usagesDetails: builtDirectUsages.usagesDetails,
+            agentDxSignals: builtDirectUsages.agentDxSignals
+        };
+    }
+    const directAgentDxSignals = collectInspectAgentDxSignals(restArgs);
+    return {
+        payload: buildInspectDirectPayload(cwd, restArgs, config, includeRanges, resolveStar, localOnly, {
+            memberOffset,
+            memberLimit,
+            memberAll
+        }, allowModulePlan),
+        formatOptions,
+        cachePlans: [],
+        ...(directUsagesDetail !== null ? { usagesDetails: [directUsagesDetail] } : {}),
+        ...(directAgentDxSignals.length > 0 ? { agentDxSignals: directAgentDxSignals } : {})
+    };
+}
+function applyDirectInspectOpDefault(payload, op) {
+    if (!op || payload.op !== undefined) {
+        return payload;
+    }
+    return {
+        op,
+        ...payload
+    };
+}
+function readDirectInspectOp(restArgs) {
+    const args = restArgs.filter((arg) => !arg.startsWith("--") && !(0, inspect_request_values_1.isFlagValue)(restArgs, arg));
+    return args[0] ?? null;
+}
+const INSPECT_FILE_KNOWN_FLAGS = new Set([
+    "--ranges",
+    "--no-ranges",
+    "--noRanges",
+    "--details",
+    "--local-only",
+    "--debug-workspace-context"
+]);
+const INSPECT_IMPORTS_KNOWN_FLAGS = new Set(["--ranges", "--no-ranges"]);
+const INSPECT_DSL_OPTION_TOKENS_FIELD = "__aibDslOptionTokens";
+const INSPECT_DSL_KNOWN_OPTIONS = {
+    file: new Set(["ranges", "includeRanges", "localOnly"]),
+    imports: new Set(["ranges", "includeRanges"]),
+    exports: new Set(["ranges", "includeRanges", "resolveStar"]),
+    members: new Set(["file", "fromFile", "entity", "entities", "parent", "ranges", "includeRanges", "limit", "offset", "all", "memberLimit", "memberOffset", "memberAll"]),
+    code: new Set(["file", "fromFile", "entity", "entities", "parent", "show", "ranges", "includeRanges", "toFile", "outputFile", "save", "maxCodeLines"]),
+    deps: new Set(["file", "fromFile", "entity", "entities", "parent"]),
+    usages: new Set(["target", "usageTarget", "dir", "scope", "scopes", "entity", "entities", "parent", "detail", "limit", "all", "save", "includeTarget", "excludeTarget", "maxCodeLines"]),
+    graph: new Set(["scope", "scopes", "file", "files", "fromFile", "from", "focus", "view", "depth", "symbolUsage", "symbols", "edges", "showEdges", "hubs", "showHubs", "entrypoints", "scopeEntrypoints", "showEntrypoints", "leaves", "scopeLeaves", "showLeaves", "exclude", "excludePatterns", "excludeFrom", "toFile", "outputFile", "save"]),
+    tree: new Set(["scope", "file", "dir", "directory", "depth", "minDepth", "min_depth", "limit", "only", "exclude", "excludes", "onlyDirs", "only_dirs", "noDefaultExclude", "no_default_exclude", "ned", "noConfigExclude", "no_config_exclude", "nec"]),
+    cycles: new Set(["scope", "scopes", "file", "files", "detail", "kind", "exclude", "excludes", "limit"]),
+    aliasCandidates: new Set(["scope", "dir", "directory", "detail", "candidate", "limit", "minImports", "min_imports", "minFiles", "min_files", "include", "only", "exclude", "excludes"]),
+    "alias-candidates": new Set(["scope", "dir", "directory", "detail", "candidate", "limit", "minImports", "min_imports", "minFiles", "min_files", "include", "only", "exclude", "excludes"])
+};
+function collectInspectAgentDxSignals(restArgs) {
+    const directOp = readDirectInspectOp(restArgs);
+    if (directOp !== "file" && directOp !== "imports") {
+        return [];
+    }
+    const signal = (0, agent_dx_1.collectUnknownFlagSignal)({
+        command: `inspect ${directOp}`,
+        args: restArgs.slice(1),
+        knownFlags: directOp === "file" ? INSPECT_FILE_KNOWN_FLAGS : INSPECT_IMPORTS_KNOWN_FLAGS,
+        helpRefs: [{ topic: `inspect.${directOp}`, reason: "unknownFlag", priority: 1, mode: "command" }]
+    });
+    return signal ? [signal] : [];
+}
+function buildInspectObservation(restArgs, stdinPayload) {
+    const inline = !restArgs.includes("--stdin") && stdinPayload === undefined;
+    const op = readDirectInspectOp(restArgs) ?? "inspect";
+    const targets = inline ? readDirectInspectTargets(restArgs) : [];
+    return {
+        command: op === "inspect" ? "inspect" : `inspect ${op}`,
+        family: "inspect",
+        surface: inline ? "inline" : restArgs.includes("--stdin") ? "stdin-dsl" : "json",
+        targets,
+        batchable: ["file", "exports", "imports", "tree"].includes(op)
+    };
+}
+function readDirectInspectTargets(restArgs) {
+    const op = readDirectInspectOp(restArgs);
+    if (!op) {
+        return [];
+    }
+    const args = restArgs.filter((arg) => !arg.startsWith("--") && !(0, inspect_request_values_1.isFlagValue)(restArgs, arg));
+    if (op === "file" || op === "exports" || op === "imports" || op === "tree") {
+        return args.slice(1);
+    }
+    return args[1] ? [args[1]] : [];
+}
+function buildInspectDirectPayload(cwd, restArgs, config, includeRanges, resolveStar, localOnly, memberOptions, allowModulePlan) {
+    const args = restArgs.filter((arg) => !arg.startsWith("--") && !(0, inspect_request_values_1.isFlagValue)(restArgs, arg));
+    const [op, sourceFile, entity] = args;
+    if (!op || !sourceFile) {
+        throw new errors_1.CliError("INVALID_INSPECT_COMMAND", "Expected: aib inspect <file|imports|exports|members|code|slice|deps|usages|duplicates> <file-or-dir> [entity].", {
+            examples: [
+                "aib inspect file src/example.ts",
+                "aib inspect imports src/example.ts",
+                "aib inspect exports src/example.ts",
+                "aib inspect members src/example.ts c:Example",
+                "aib inspect code src/example.ts f:helper",
+                "aib inspect deps src/example.ts c:Example",
+                "aib inspect usages src/example.ts f:helper --scope src/main",
+                "aib inspect duplicates src/scripts --detail code"
+            ]
+        });
+    }
+    if (!(0, inspect_request_values_1.isInspectOp)(op)) {
+        throw new errors_1.CliError("INVALID_INSPECT_OP", "Expected inspect op to be file, imports, exports, members, code, slice, deps, usages, duplicates, graph, tree, cycles, aliasCandidates, or imports.");
+    }
+    (0, inspect_request_values_1.assertModulePlanAllowed)(op, allowModulePlan);
+    if ((0, inspect_request_values_1.readFlagValue)(restArgs, "--save") && op !== "code" && op !== "slice" && op !== "usages" && op !== "duplicate" && op !== "duplicates") {
+        throw new errors_1.CliError("INVALID_INSPECT_SAVE", "inspect --save can be used only with code, slice, usages, or duplicates operations.");
+    }
+    const requestOp = (0, inspect_request_values_1.toExtensionInspectOp)(op);
+    if (isMultiTargetDirectInspectOp(op) && args.length > 2) {
+        return {
+            requests: args.slice(1).map((target) => {
+                const request = {
+                    op: requestOp,
+                    sourceFile: (0, inspect_request_values_1.resolveCliFilePath)(cwd, target),
+                    ranges: includeRanges,
+                    resolveStar,
+                    localOnly: requestOp === "file" && localOnly
+                };
+                (0, inspect_request_values_1.applyInspectMemberOptions)(request, memberOptions);
+                return request;
+            })
+        };
+    }
+    const request = {
+        op: requestOp,
+        sourceFile: (0, inspect_request_values_1.resolveCliFilePath)(cwd, sourceFile),
+        ranges: includeRanges || requestOp === "code" || requestOp === "slice",
+        resolveStar,
+        localOnly: requestOp === "file" && localOnly
+    };
+    (0, inspect_request_values_1.applyInspectMemberOptions)(request, memberOptions);
+    if (requestOp === "members" || requestOp === "code" || requestOp === "dependencies" || requestOp === "slice") {
+        if (!entity) {
+            throw new errors_1.CliError("INSPECT_ENTITY_REQUIRED", `inspect ${op} expects an entity selector.`);
+        }
+        (0, inspect_request_values_1.addSelectorToRequest)(request, entity, config);
+    }
+    if (requestOp === "usages" && entity) {
+        (0, inspect_request_values_1.addSelectorToRequest)(request, entity, config);
+    }
+    if (requestOp === "usages") {
+        request.cwd = path.resolve(cwd);
+    }
+    if (requestOp === "duplicates") {
+        request.detail = (0, inspect_request_values_1.readFlagValue)(restArgs, "--detail") ?? "locations";
+        request.mode = (0, inspect_request_values_1.readFlagValue)(restArgs, "--mode") ?? "both";
+        const limit = (0, inspect_request_values_1.readPositiveIntegerFlag)(restArgs, "--limit");
+        const offset = (0, inspect_request_values_1.readNonNegativeIntegerFlag)(restArgs, "--offset");
+        if (limit !== null) {
+            request.limit = limit;
+        }
+        if (offset !== null) {
+            request.offset = offset;
+        }
+        const kinds = (0, inspect_request_values_1.readDuplicateKindArgs)(restArgs, config);
+        if (kinds.length > 0) {
+            request.kinds = kinds;
+        }
+        const entities = (0, inspect_request_values_1.parseDuplicateEntityFilters)([
+            ...(entity ? [entity] : []),
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--entity"),
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--entities").flatMap((value) => value.split(","))
+        ], config);
+        if (entities.length > 0) {
+            request.duplicateEntities = entities;
+        }
+        const exclude = (0, inspect_request_values_1.parseDuplicateEntityFilters)([
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--exclude"),
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--excludes").flatMap((value) => value.split(","))
+        ], config);
+        if (exclude.length > 0) {
+            request.duplicateExclude = exclude;
+        }
+        const pathExclude = (0, inspect_request_values_1.parseDuplicatePathExcludes)(cwd, [
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--path-exclude"),
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--path-excludes").flatMap((value) => value.split(",")),
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--exclude-path"),
+            ...(0, inspect_request_values_1.readFlagValues)(restArgs, "--exclude-paths").flatMap((value) => value.split(","))
+        ]);
+        if (pathExclude.length > 0) {
+            request.duplicatePathExclude = pathExclude;
+        }
+    }
+    const scopes = (0, inspect_request_values_1.readFlagValues)(restArgs, "--scope");
+    if (requestOp === "usages" && scopes.length > 0) {
+        request.scope = scopes.map((scope) => (0, inspect_request_values_1.resolveCliFilePath)(cwd, scope));
+    }
+    if (requestOp === "duplicates" && scopes.length > 0) {
+        request.scope = scopes.map((scope) => (0, inspect_request_values_1.resolveCliFilePath)(cwd, scope));
+    }
+    if (requestOp === "usages") {
+        request.excludeTarget = restArgs.includes("--exclude-target") ||
+            restArgs.includes("--excludeTarget") ||
+            false;
+        const includeTarget = restArgs.includes("--include-target") || restArgs.includes("--includeTarget");
+        const prefExcludeTarget = (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.usages.excludeTarget", false);
+        if (includeTarget) {
+            request.excludeTarget = false;
+        }
+        else if (request.excludeTarget === true || prefExcludeTarget) {
+            request.excludeTarget = true;
+        }
+        else if ((0, inspect_request_values_1.shouldAutoExcludeUsageTarget)(cwd, (0, inspect_usages_detail_1.readString)(request.sourceFile) ?? "", (0, inspect_usages_detail_1.readStringArray)(request.scope) ?? [])) {
+            request.excludeTarget = true;
+            request.targetLocalUsagesHidden = true;
+        }
+    }
+    const parentSelector = (0, inspect_request_values_1.readFlagValue)(restArgs, "--parent");
+    if (parentSelector) {
+        const parent = (0, inspect_selector_1.parseInspectSelector)(parentSelector, config);
+        request.parentName = parent.symbolName;
+        if (parent.symbolKind) {
+            request.parentKind = parent.symbolKind;
+        }
+    }
+    return {
+        requests: [request]
+    };
+}
+function isMultiTargetDirectInspectOp(op) {
+    return op === "file" || op === "exports";
+}
+function buildInspectStdinPayload(cwd, rawPayload, config, includeRanges, resolveStar, localOnly, memberOptions, allowModulePlan) {
+    const rawRequests = (0, inspect_request_values_1.expandInspectStdinRequests)(rawPayload);
+    const toFiles = [];
+    const saves = [];
+    const shows = [];
+    const ranges = [];
+    const parentNames = [];
+    const usagesDetails = [];
+    const agentDxSignals = [];
+    const topLevelUsagesDetail = (0, inspect_usages_detail_1.readOptionalUsagesDetail)(rawPayload.detail);
+    const topLevelAll = (0, inspect_request_values_1.readBoolean)(rawPayload.all);
+    const topLevelLimit = (0, inspect_request_values_1.readPositiveInteger)(rawPayload.limit);
+    const topLevelMaxCodeLines = (0, inspect_request_values_1.readPositiveInteger)(rawPayload.maxCodeLines);
+    const topLevelExcludeTarget = (0, inspect_request_values_1.readBoolean)(rawPayload.excludeTarget);
+    const topLevelIncludeTarget = (0, inspect_request_values_1.readBoolean)(rawPayload.includeTarget);
+    const bundleSave = (0, inspect_usages_detail_1.readString)(rawPayload.bundleSave) ??
+        (0, inspect_usages_detail_1.readString)(rawPayload.bundle) ??
+        (0, inspect_usages_detail_1.readString)(rawPayload.saveBundle) ??
+        undefined;
+    const requests = rawRequests.map((rawRequest, index) => {
+        if (!(0, inspect_usages_detail_1.isObject)(rawRequest)) {
+            throw new errors_1.CliError("INVALID_INSPECT_REQUEST", `Inspect request at index ${index} must be an object.`);
+        }
+        const op = (0, inspect_usages_detail_1.readString)(rawRequest.op);
+        const sourceFile = (0, inspect_usages_detail_1.readString)(rawRequest.sourceFile) ??
+            (0, inspect_usages_detail_1.readString)(rawRequest.file) ??
+            (op === "usages" ? (0, inspect_usages_detail_1.readString)(rawRequest.target) ?? (0, inspect_usages_detail_1.readString)(rawRequest.usageTarget) ?? (0, inspect_usages_detail_1.readString)(rawRequest.dir) : null) ??
+            (op === "duplicate" || op === "duplicates" ? (0, inspect_usages_detail_1.readString)(rawRequest.target) ?? (0, inspect_usages_detail_1.readString)(rawRequest.dir) ?? (0, inspect_request_values_1.firstString)(rawRequest.scope) ?? (0, inspect_request_values_1.firstString)(rawRequest.scopes) : null);
+        if (!op || !(0, inspect_request_values_1.isInspectOp)(op)) {
+            throw new errors_1.CliError("INVALID_INSPECT_OP", `Inspect request at index ${index} has invalid op.`);
+        }
+        const dslSignal = collectInspectDslAgentDxSignal(op, rawRequest);
+        if (dslSignal) {
+            agentDxSignals.push(dslSignal);
+        }
+        (0, inspect_request_values_1.assertModulePlanAllowed)(op, allowModulePlan);
+        if (!sourceFile) {
+            throw new errors_1.CliError("SOURCE_FILE_REQUIRED", `Inspect request at index ${index} requires sourceFile or file.`);
+        }
+        const requestOp = (0, inspect_request_values_1.toExtensionInspectOp)(op);
+        const explicitRanges = (0, inspect_request_values_1.readBoolean)(rawRequest.ranges) ??
+            (0, inspect_request_values_1.readBoolean)(rawRequest.includeRanges);
+        const displayRanges = explicitRanges ??
+            (requestOp === "code" || requestOp === "slice"
+                ? true
+                : requestOp === "file"
+                    ? true
+                    : requestOp === "exports"
+                        ? (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.exports.ranges", false)
+                        : includeRanges);
+        const requestRanges = displayRanges || requestOp === "code" || requestOp === "slice";
+        const request = {
+            op: requestOp,
+            sourceFile: (0, inspect_request_values_1.resolveCliFilePath)(cwd, sourceFile),
+            ranges: requestRanges,
+            resolveStar: (0, inspect_request_values_1.readBoolean)(rawRequest.resolveStar) ??
+                (requestOp === "exports" ? (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.exports.resolveStar", false) : resolveStar),
+            localOnly: requestOp === "file" && (rawRequest.localOnly === true || localOnly)
+        };
+        if (requestOp === "usages") {
+            request.cwd = path.resolve(cwd);
+            usagesDetails.push((0, inspect_usages_detail_1.readUsagesDetailOptions)(cwd, {
+                detail: (0, inspect_usages_detail_1.readString)(rawRequest.detail) ?? topLevelUsagesDetail,
+                all: (0, inspect_request_values_1.readBoolean)(rawRequest.all) ?? topLevelAll,
+                limit: (0, inspect_request_values_1.readPositiveInteger)(rawRequest.limit) ?? topLevelLimit,
+                maxCodeLines: (0, inspect_request_values_1.readPositiveInteger)(rawRequest.maxCodeLines) ?? topLevelMaxCodeLines
+            }));
+            const scopes = (0, inspect_usages_detail_1.readStringArray)(rawRequest.scope) ?? (0, inspect_usages_detail_1.readStringArray)(rawRequest.scopes);
+            if (scopes && scopes.length > 0) {
+                request.scope = scopes.map((scope) => (0, inspect_request_values_1.resolveCliFilePath)(cwd, scope));
+            }
+            const includeTarget = (0, inspect_request_values_1.readBoolean)(rawRequest.includeTarget) ?? topLevelIncludeTarget;
+            const explicitExcludeTarget = (0, inspect_request_values_1.readBoolean)(rawRequest.excludeTarget) ?? topLevelExcludeTarget;
+            const prefExcludeTarget = (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.usages.excludeTarget", false);
+            if (includeTarget === true) {
+                request.excludeTarget = false;
+            }
+            else if (explicitExcludeTarget !== null) {
+                request.excludeTarget = explicitExcludeTarget;
+            }
+            else if (prefExcludeTarget) {
+                request.excludeTarget = true;
+            }
+            else if ((0, inspect_request_values_1.shouldAutoExcludeUsageTarget)(cwd, request.sourceFile, (0, inspect_usages_detail_1.readStringArray)(request.scope) ?? [])) {
+                request.excludeTarget = true;
+                request.targetLocalUsagesHidden = true;
+            }
+            if (Array.isArray(rawRequest.entities)) {
+                request.usageEntities = (0, inspect_request_values_1.parseUsageEntities)(rawRequest.entities, config);
+            }
+        }
+        else {
+            usagesDetails.push(null);
+        }
+        if (requestOp === "duplicates") {
+            request.detail = (0, inspect_usages_detail_1.readString)(rawRequest.detail) ?? (0, inspect_usages_detail_1.readString)(rawPayload.detail) ?? "locations";
+            request.mode = (0, inspect_usages_detail_1.readString)(rawRequest.mode) ?? (0, inspect_usages_detail_1.readString)(rawPayload.mode) ?? "both";
+            request.limit = (0, inspect_request_values_1.readPositiveInteger)(rawRequest.limit) ?? (0, inspect_request_values_1.readPositiveInteger)(rawPayload.limit) ?? 10;
+            request.offset = (0, inspect_request_values_1.readNonNegativeInteger)(rawRequest.offset) ?? (0, inspect_request_values_1.readNonNegativeInteger)(rawPayload.offset) ?? 0;
+            const scopes = (0, inspect_usages_detail_1.readStringArray)(rawRequest.scope) ?? (0, inspect_usages_detail_1.readStringArray)(rawRequest.scopes) ?? (0, inspect_usages_detail_1.readStringArray)(rawPayload.scope) ?? (0, inspect_usages_detail_1.readStringArray)(rawPayload.scopes);
+            if (scopes && scopes.length > 0) {
+                request.scope = scopes.map((scope) => (0, inspect_request_values_1.resolveCliFilePath)(cwd, scope));
+            }
+            const kinds = (0, inspect_request_values_1.readDuplicateKinds)(rawRequest.kinds ?? rawPayload.kinds, config);
+            if (kinds.length > 0) {
+                request.kinds = kinds;
+            }
+            const entities = (0, inspect_request_values_1.parseDuplicateEntityFilters)(rawRequest.entities ?? rawRequest.entity ?? rawPayload.entities ?? rawPayload.entity, config);
+            if (entities.length > 0) {
+                request.duplicateEntities = entities;
+            }
+            const exclude = (0, inspect_request_values_1.parseDuplicateEntityFilters)(rawRequest.exclude ?? rawRequest.excludes ?? rawPayload.exclude ?? rawPayload.excludes, config);
+            if (exclude.length > 0) {
+                request.duplicateExclude = exclude;
+            }
+            const pathExclude = (0, inspect_request_values_1.parseDuplicatePathExcludes)(cwd, rawRequest.pathExclude ??
+                rawRequest.pathExcludes ??
+                rawRequest.excludePath ??
+                rawRequest.excludePaths ??
+                rawPayload.pathExclude ??
+                rawPayload.pathExcludes ??
+                rawPayload.excludePath ??
+                rawPayload.excludePaths);
+            if (pathExclude.length > 0) {
+                request.duplicatePathExclude = pathExclude;
+            }
+        }
+        if (requestOp === "modulePlan") {
+            request.modules = (0, inspect_request_values_1.parseModulePlanModules)(cwd, rawRequest.modules, config);
+            const facade = (0, inspect_usages_detail_1.readString)(rawRequest.facade) ?? (0, inspect_usages_detail_1.readString)(rawRequest.facadeFile);
+            if (facade) {
+                request.facadeFile = (0, inspect_request_values_1.resolveCliFilePath)(cwd, facade);
+            }
+            if (rawRequest.previewFiles === true || rawRequest.preview === "files") {
+                request.previewFiles = true;
+                const previewDir = (0, inspect_usages_detail_1.readString)(rawRequest.previewDir) ?? (0, inspect_usages_detail_1.readString)(rawRequest.outputDir);
+                if (previewDir) {
+                    request.previewDir = (0, inspect_request_values_1.resolveCliFilePath)(cwd, previewDir);
+                }
+                request.previewPatch = rawRequest.previewPatch !== false;
+            }
+        }
+        (0, inspect_request_values_1.applyInspectMemberOptions)(request, {
+            memberOffset: (0, inspect_request_values_1.readNonNegativeInteger)(rawRequest.offset) ?? (0, inspect_request_values_1.readNonNegativeInteger)(rawRequest.memberOffset) ?? memberOptions.memberOffset,
+            memberLimit: (0, inspect_request_values_1.readPositiveInteger)(rawRequest.limit) ??
+                (0, inspect_request_values_1.readPositiveInteger)(rawRequest.memberLimit) ??
+                memberOptions.memberLimit ??
+                (requestOp === "members" ? (0, session_workspace_1.readSessionNumberPref)(cwd, "inspect.members.maxItems", 20) : null),
+            memberAll: (0, inspect_request_values_1.readBoolean)(rawRequest.all) ??
+                (0, inspect_request_values_1.readBoolean)(rawRequest.memberAll) ??
+                (requestOp === "members" ? (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.members.all", false) : memberOptions.memberAll)
+        });
+        const id = (0, inspect_usages_detail_1.readString)(rawRequest.id);
+        if (id) {
+            request.id = id;
+        }
+        const toFile = requestOp === "modulePlan" ? null : (0, inspect_usages_detail_1.readString)(rawRequest.toFile) ?? (0, inspect_usages_detail_1.readString)(rawRequest.outputFile);
+        const save = requestOp === "modulePlan" ? null : (0, inspect_usages_detail_1.readString)(rawRequest.save);
+        if (toFile && requestOp !== "code" && requestOp !== "slice") {
+            throw new errors_1.CliError("INVALID_INSPECT_TO_FILE", `Inspect request at index ${index} can use toFile only with code or slice operations.`);
+        }
+        if (save && requestOp !== "code" && requestOp !== "slice" && requestOp !== "usages" && requestOp !== "duplicates") {
+            throw new errors_1.CliError("INVALID_INSPECT_SAVE", `Inspect request at index ${index} can use save only with code, slice, usages, or duplicates operations.`);
+        }
+        if (toFile && save) {
+            throw new errors_1.CliError("INSPECT_OUTPUT_TARGET_CONFLICT", `Inspect request at index ${index} must use either toFile or save, not both.`);
+        }
+        toFiles.push(toFile);
+        saves.push(save);
+        const rawShow = typeof rawRequest.show === "boolean" ? rawRequest.show : null;
+        shows.push(rawShow ?? (requestOp === "code" && (0, session_workspace_1.readSessionBooleanPref)(cwd, "inspect.code.show", true)));
+        ranges.push(displayRanges);
+        const rawSymbolKind = (0, inspect_usages_detail_1.readString)(rawRequest.symbolKind) ?? (0, inspect_usages_detail_1.readString)(rawRequest.kind);
+        const entity = (0, inspect_usages_detail_1.readString)(rawRequest.entity) ??
+            (0, inspect_usages_detail_1.readString)(rawRequest.selector) ??
+            (0, inspect_usages_detail_1.readString)(rawRequest.symbol) ??
+            (0, inspect_usages_detail_1.readString)(rawRequest.symbolName) ??
+            (0, inspect_usages_detail_1.readString)(rawRequest.name);
+        if (entity) {
+            (0, inspect_request_values_1.addSelectorToRequest)(request, entity, config);
+        }
+        if (rawSymbolKind) {
+            request.symbolKind = rawSymbolKind;
+        }
+        const parent = (0, inspect_usages_detail_1.readString)(rawRequest.parent);
+        if (parent) {
+            const parsedParent = (0, inspect_selector_1.parseInspectSelector)(parent, config);
+            request.parentName = parsedParent.symbolName;
+            if (parsedParent.symbolKind) {
+                request.parentKind = parsedParent.symbolKind;
+            }
+            parentNames.push(parsedParent.symbolName);
+        }
+        else {
+            parentNames.push(null);
+        }
+        return request;
+    });
+    return {
+        payload: {
+            requests
+        },
+        toFiles,
+        saves,
+        shows,
+        ranges,
+        parentNames,
+        usagesDetails,
+        agentDxSignals,
+        ...(bundleSave !== undefined ? { bundleSave } : {})
+    };
+}
+function collectInspectDslAgentDxSignal(op, rawRequest) {
+    if (!(op in INSPECT_DSL_KNOWN_OPTIONS)) {
+        return null;
+    }
+    const rawTokens = rawRequest[INSPECT_DSL_OPTION_TOKENS_FIELD];
+    if (!Array.isArray(rawTokens)) {
+        return null;
+    }
+    const knownOptions = INSPECT_DSL_KNOWN_OPTIONS[op];
+    const unsupportedTokens = rawTokens
+        .filter((token) => typeof token === "string" && token.length > 0)
+        .filter((token) => !knownOptions.has(inspectDslOptionName(token)));
+    if (unsupportedTokens.length === 0) {
+        return null;
+    }
+    return {
+        kind: "unknownFlag",
+        command: `inspect ${op}`,
+        flags: uniqueStrings(unsupportedTokens),
+        helpRefs: [{ topic: `inspect.${op}`, reason: "unknownFlag", priority: 1, mode: "command" }]
+    };
+}
+function inspectDslOptionName(token) {
+    let rawName = token;
+    if ((token.startsWith("+") || token.startsWith("-")) && token.length > 1) {
+        rawName = token.slice(1);
+    }
+    else {
+        const equalIndex = token.indexOf("=");
+        if (equalIndex > 0) {
+            rawName = token.slice(0, equalIndex);
+        }
+        else if (token.startsWith(">") && token.length > 1) {
+            rawName = "save";
+        }
+    }
+    if (rawName === "from") {
+        return "fromFile";
+    }
+    if (rawName === "no-default-exclude") {
+        return "noDefaultExclude";
+    }
+    if (rawName === "no-config-exclude") {
+        return "noConfigExclude";
+    }
+    if (rawName === "only-dirs") {
+        return "onlyDirs";
+    }
+    if (rawName === "min-depth") {
+        return "minDepth";
+    }
+    return rawName;
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values));
+}