@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/commands/inspect.js

@@ -1,16 +1,1450 @@
-"use strict";var bt=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]})),It=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),Fe=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"&&bt(n,t,s[i]);return It(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runInspect=Ce;const M=Fe(require("node:path")),ye=Fe(require("node:fs")),xt=require("node:crypto"),At=require("../client/http-client"),St=require("../shared/routes"),_t=require("../shared/protocol"),E=require("../shared/errors"),z=require("../shared/agent-text"),re=require("./shared"),k=require("./inspect-format"),w=require("./module-plan-cache"),he=require("./json-file-input"),ge=require("./inspect-graph"),be=require("./inspect-cycles"),Ie=require("./inspect-imports"),ee=require("./inspect-tree"),Q=require("../config/path-display"),A=require("./session-workspace"),Et=require("./entity-resolution");async function Ce(e,t,n,s={},i={}){if(vt(t))return Dt(e,t);const o=qt(e,t,n);if(o&&en(o))return Zt(e,t,o,s,i);if((0,ge.isInspectGraphRequest)(t,n))return(0,ge.runInspectGraph)(e,t,n);if((0,be.isInspectCyclesRequest)(t,n))return(0,be.runInspectCycles)(e,t,n);if((0,ee.isInspectTreeRequest)(t,n))return(0,ee.runInspectTree)(e,t,n);if(t[0]==="imports")return(0,Ie.runInspectImports)(e,t,n);i.allowModulePlan!==!0&&jn(t,n)&&ft();const c=await(0,re.resolveCompatibleTargetInstance)(e,_t.CLI_COMMAND_IDS.inspect,s),l=await(0,re.fetchEffectiveConfig)(c.entry,s),a=bn(e,t,n,l,i.allowModulePlan===!0,i.forceResults===!0);pn(e,a),await Nt(c.entry,a.payload,l,s),cn(e,a);const f=await(0,At.postJson)(c.entry,St.EXTENSION_ROUTES.inspect,a.payload,(0,re.extensionRequestOptions)(s));an(e,a,f);const d=(0,k.formatInspectResponse)(f,l,a.formatOptions);return Pt(un(Ft(e,f,d,a),a.revision),a)}async function Nt(e,t,n,s){const i=Array.isArray(t.requests)?t.requests.filter(p):[],o=new Map;for(const c of i){const l=r(c.op);if(l!=="code"&&l!=="slice"&&l!=="dependencies"&&l!=="members"&&l!=="usages")continue;const a=r(c.sourceFile),f=r(c.symbolName);if(!a||!f)continue;const d=r(c.symbolKind);if(d==="constructor")continue;const y={raw:f,symbolName:f,symbolKind:d},m=o.get(a)??[];m.push(y),o.set(a,m)}for(const[c,l]of o)await(0,Et.ensureSelectorsResolvable)(e,c,l,n,(0,re.extensionRequestOptions)(s))}function vt(e){return e[0]==="usages"&&O(e,"--from-file")!==null}function Dt(e,t){const n=O(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,A.resolveSessionFileArgument)(e,n),i=(0,he.readJsonObjectFile)(e,s,"INVALID_USAGES_ARTIFACT"),o=K(t,"--focus"),c=xe(e,{detail:O(t,"--detail")??"locations",all:t.includes("--all"),limit:J(t,"--limit"),maxCodeLines:J(t,"--max-code-lines")??J(t,"--maxCodeLines")});if(c.detail==="summary")throw new E.CliError("INVALID_USAGES_DETAIL","inspect usages --from-file --detail expects locations or code.");if(c.detail!=="locations"&&c.detail!=="code")throw new E.CliError("INVALID_USAGES_DETAIL","inspect usages --detail expects locations or code.");const l=Te(e,i,o,c);return(0,z.attachAgentText)(l,Ae(e,l))}function Ft(e,t,n,s){const i=s.usagesDetails??[],o=Ct(n,s);if(i.length===0||i.every(y=>y===null||y.detail==="summary"))return o;const c=Array.isArray(t.results)?t.results.filter(p):[];if(c.length===0)return o;const l=Array.isArray(o.results)?o.results.filter(p):[o],a=Array.isArray(s.payload.requests)?s.payload.requests.filter(p):[],f=c.map((y,m)=>{const h=i[m],N=l[m]??{};if(a[m]?.targetLocalUsagesHidden===!0&&(y.targetLocalUsagesHidden=!0),y.op!=="usages"||h===void 0||h===null||h.detail==="summary")return N;const I=Te(e,y,[],h,!0);return Mt(N,I),I});kt(e,f),Bt(f);const d=f.length===1?f[0]:{results:f};return(0,z.attachAgentText)(d,Rt(e,d,o))}function Ct(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 Pt(e,t){return Le(e,t.dslDiagnostics??[])}function Le(e,t){if(t.length===0)return e;const n=(0,z.readAgentText)(e),s=Lt(t);return(0,z.attachAgentText)({...e,dslDiagnostics:t.map(i=>({line:i.line,message:i.message}))},n?`${n.trimEnd()}
-
-${s}`:s)}function Lt(e){return["dsl errors:",...e.map(t=>`line ${t.line}: ${t.message}`)].join(`
-`)}function Oe(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 Te(e,t,n,s,i=!1){const o=s.detail==="code"?zt(e,t,n,s):Vt(e,t,n,s);return Ut(e,o,i),o}function Ot(e,t){return $t(t??(0,A.readSessionStringPref)(e,"inspect.usages.detail","locations"))}function xe(e,t){const n=t.all===!0,s=n?Number.MAX_SAFE_INTEGER:t.limit??(0,A.readSessionNumberPref)(e,"inspect.usages.maxLocations",12),i=n?Number.MAX_SAFE_INTEGER:t.limit??(0,A.readSessionNumberPref)(e,"inspect.usages.maxCodeBlocks",8);return{detail:Ot(e,t.detail),locationLimit:s,codeBlockLimit:i,maxCodeLines:t.maxCodeLines??(0,A.readSessionNumberPref)(e,"inspect.code.maxNonEmptyLines",120),all:n}}function Tt(e){return typeof e=="string"?e:null}function $t(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 Mt(e,t){for(const n of["summary","saved","next","input","targetLocalUsagesHidden"])e[n]!==void 0&&(t[n]=e[n])}function Ut(e,t,n){const s=Array.isArray(t.__viewItems)?t.__viewItems.filter(p):[];if(delete t.__viewItems,s.length===0)return;const i=te({version:1,kind:"usages",source:"inspect",detail:r(t.detail)??"locations",target:r(t.target)??"",items:s}),o=(0,A.saveSessionResultViewJson)(e,$e(i),i);o&&(t.view=o.saved,n&&(t.__viewRecord=i))}function kt(e,t){const n=t.map(l=>p(l.__viewRecord)?l.__viewRecord:null).filter(l=>l!==null&&r(l.kind)==="usages");if(n.length<=1)return;const s=Array.from(new Set(n.map(l=>r(l.detail)??"").filter(l=>l!==""))),i=n.flatMap(l=>Array.isArray(l.items)?l.items.filter(p):[]);if(i.length===0)return;const o=te({version:1,kind:"usages",source:"inspect",detail:s.length===1?s[0]:"mixed",items:i}),c=(0,A.saveSessionResultViewJson)(e,$e(o),o);if(c)for(const l of t)p(l.__viewRecord)&&r(l.__viewRecord.kind)==="usages"&&(l.viewAllUsages=c.saved)}function Bt(e){for(const t of e)delete t.__viewRecord,delete t.__viewItems}function $e(e){return`res_${(0,xt.createHash)("sha256").update(JSON.stringify(e)).digest("hex").slice(0,8)}`}function te(e){const t={};for(const[n,s]of Object.entries(e))s!==void 0&&s!==""&&(t[n]=s);return t}function Rt(e,t,n){if(Array.isArray(t.results)){const i=[],o=t.results.filter(p);let c=[];const l=()=>{if(c.length===0)return;const a=(0,k.formatInspectMixedAgentText)({results:c});a&&i.push(a),c=[]};for(const a of o){const f=r(a.detail);if(f==="locations"||f==="code"){l();const d=Ae(e,a);d&&i.push(d);continue}if(r(a.op)==="usages"){l();const d=Kt(a);d&&i.push(d);continue}c.push(a)}return l(),jt(i,o),i.length>0?i.join(`
-
-`):null}const s=r(t.detail);return s==="locations"||s==="code"?Ae(e,t):(0,z.readAgentText)(n)}function jt(e,t){const n=Array.from(new Set(t.map(i=>r(i.viewAllUsages)??"").filter(i=>i!=="")));if(n.length===0)return;const s=t.every(i=>r(i.op)==="usages");e.push(s?`view all: ${n[0]}`:["view all:",`usages: ${n[0]}`].join(`
-`))}function Kt(e){const t=[],n=r(e.target);t.push(n?`usages ${n}`:"usages");const s=r(e.summary);s&&t.push(s),Se(t,e);const i=Array.isArray(e.items)?e.items.filter(p):[];for(const o of i){const c=r(o.entity)??"",l=r(o.summary)??"";t.push(`${c}: ${l}`.trim());const a=Array.isArray(o.usedBy)?o.usedBy.filter(f=>typeof f=="string"):[];t.push(...a)}return t.length>1?t.join(`
-`):null}function Vt(e,t,n,s){const i=Me(t,n),o=[],l=i.map(a=>{const f=le(a);let d=0,y=0;const m=[],h=Array.isArray(a.usedBy)?a.usedBy.filter(p).flatMap(I=>{const T=Array.isArray(I.locations)?I.locations.filter(p):[],S=X(e,r(I.file)??""),L=[],C=T.flatMap(D=>{const F=typeof D.line=="number"?D.line:0,u=p(D.container)?ce(D.container):"";return d>=s.locationLimit?(y+=1,L.push({line:F,...u!==""?{container:u}:{}}),o.push(te({name:f,text:u?`${S}:${F} ${u}`:`${S}:${F}`})),[]):(d+=1,[{line:F,...u!==""?{container:u}:{}}])});return L.length>0&&m.push({file:S,locations:L}),C.length>0?[{file:S,locations:C}]:[]}):[],N={entity:f,referenceCount:V(a.referenceCount),usedBy:h,...y>0?{hidden:`+ ${y} more locations`}:{}},P=m.length>0?{entity:f,referenceCount:y,usedBy:m}:null;return{displayItem:N,hiddenItem:P}}).map(a=>a.displayItem);return{op:"usages",detail:"locations",target:X(e,r(t.targetPath)??""),summary:r(t.summary)??"",referenceCount:V(t.referenceCount),itemCount:V(t.itemCount),fileCount:V(t.fileCount),scopeLabel:ke(e,t),targetMode:r(t.targetMode)??"",queryMode:r(t.queryMode)??"",targetLocalUsagesHidden:t.targetLocalUsagesHidden===!0,unused:Ue(i),items:l,...o.length>0?{__viewItems:o}:{}}}function zt(e,t,n,s){const i=s.maxCodeLines,o=[],c=new Set,l=new Map,a=new Map,f=[],d=Me(t,n);for(const y of d){const m=le(y),h=Array.isArray(y.usedBy)?y.usedBy.filter(p):[];for(const N of h){const P=r(N.file);if(!P)continue;const I=Array.isArray(N.locations)?N.locations.filter(p):[];for(const T of I){const S=p(T.container)?T.container:null,L=S&&p(S.range)?S.range:null,C=L&&p(L.start)?L.start:null,D=L&&p(L.end)?L.end:null;if(!C||!D||typeof C.line!="number"||typeof C.character!="number"||typeof D.line!="number"||typeof D.character!="number")continue;const F=`${m}:${P}:${C.line}:${C.character}:${D.line}:${D.character}`;if(c.has(F))continue;c.add(F);const u=l.get(m)??0,$=Xt(P,C.line,C.character,D.line,D.character),g=C.line+1,_={entity:m,file:X(e,P),container:S?ce(S):"",line:g,code:$};if(u>=s.codeBlockLimit){a.set(m,(a.get(m)??0)+1),f.push(te({name:m,text:Ve(_,!1).join(`
-`).trim()}));continue}l.set(m,u+1);const x=Yt($),ne=`code omitted: ${x} non-empty lines; exceeds inspect.code.maxNonEmptyLines=${i}`;x>i&&f.push(te({name:m,text:Ve(_,!1).join(`
-`).trim()})),o.push({entity:m,file:X(e,P),container:S?ce(S):"",line:g,...x<=i?{code:$}:{omitted:ne,compactCode:wt($)}})}}}return{op:"usages",detail:"code",target:X(e,r(t.targetPath)??""),summary:r(t.summary)??"",referenceCount:V(t.referenceCount),itemCount:V(t.itemCount),fileCount:V(t.fileCount),scopeLabel:ke(e,t),targetMode:r(t.targetMode)??"",queryMode:r(t.queryMode)??"",targetLocalUsagesHidden:t.targetLocalUsagesHidden===!0,unused:Ue(d),blocks:o,hiddenBlocks:Array.from(a.entries()).map(([y,m])=>({entity:y,hidden:`+ ${m} more code blocks`})),...f.length>0?{__viewItems:f}:{}}}function Me(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=Gt(i),c=le(i);return s.has(o)||s.has(c)})}function Gt(e){return p(e.entity)?r(e.entity.name)??"":""}function le(e){return p(e.entity)?ce(e.entity):""}function Ue(e){return e.filter(t=>V(t.referenceCount)===0).map(t=>le(t)).filter(t=>t!=="")}function ke(e,t){const n=R(t.usageScopes)??[];return n.length===0?"project":n.length===1?X(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 Ht(e,t,n){const s=e.slice(0,t),i=e.length-s.length;return i>0?`${s.join(", ")}, + ${i} ${n}`:s.join(", ")}function V(e){return typeof e=="number"&&Number.isFinite(e)?e:0}function ce(e){const t=Array.isArray(e.path)?e.path.filter(n=>typeof n=="string"&&n.trim()!==""):[];return t.length>0?t.join("."):r(e.name)??""}function Ae(e,t){const n=r(t.detail);if(V(t.referenceCount)===0){const l=r(t.target),a=r(t.scopeLabel)??"project",f=[l?`usages ${l}`:"usages",`0 refs in ${a}`];Se(f,t);const d=V(t.itemCount);return(r(t.targetMode)==="directory"||r(t.queryMode)!=="explicit")&&d>0&&f.push(`symbols checked: ${d}`),f.join(`
-`)}const s=[`usages ${n??"detail"}`];if(Se(s,t),n==="code"){const l=Array.isArray(t.blocks)?t.blocks.filter(p):[],{ownerGroups:a,standalone:f}=ae(l,d=>r(d.entity)??"");for(const[d,y]of a){s.push(""),s.push(`// ${d}:`);for(const[m,h]of _e(y,N=>ue(r(N.entity)??"").name))m&&s.push(`// ${m}`),s.push(...je(e,t,h))}if(f.length>0){a.length>0&&s.push("");for(const[d,y]of _e(f,m=>r(m.entity)??""))d&&s.push(`// ${d}`),s.push(...je(e,t,y))}return Re(s,t),Be(s,t),s.join(`
-`).replace(/\n{3,}/g,`
-
-`).trimEnd()}const i=Array.isArray(t.items)?t.items.filter(p).filter(l=>V(l.referenceCount)>0):[],{ownerGroups:o,standalone:c}=ae(i,l=>r(l.entity)??"");for(const[l,a]of o){s.push(""),s.push(`// ${l}:`);for(const f of a)s.push(...ze(f,!1))}c.length>0&&o.length>0&&s.push("");for(const l of c)s.push(...ze(l,!0));return Re(s,t),Be(s,t),s.join(`
-`).trimEnd()}function Be(e,t){const n=r(t.view);n&&(e.length>0&&e[e.length-1]!==""&&e.push(""),e.push(`view: ${n}`))}function Re(e,t){const n=Array.isArray(t.unused)?t.unused.filter(s=>typeof s=="string"&&s!==""):[];if(n.length!==0){if(r(t.queryMode)==="explicit"){e.push(""),e.push(`unused: ${Ht(n,2,"more")}`);return}r(t.targetMode)==="file"&&(e.push(""),e.push(`unused symbols: ${n.length}`))}}function Se(e,t){t.targetLocalUsagesHidden===!0&&e.push("target-local usages hidden; use +includeTarget to show")}function je(e,t,n){const s=[],i=_e(n,l=>r(l.file)??"");for(const[l,a]of i)l&&s.push(`// ${l}`),s.push(...Jt(e,a));const o=r(n[0]?.entity)??"",c=Qt(t,"hiddenBlocks",o);return c&&s.push(`// ${c}`),s}function Jt(e,t){const n=[],{ownerGroups:s,standalone:i}=ae(t,o=>r(o.container)??"");for(const[o,c]of s)n.push(`// ${o}:`),n.push(...Ke(e,c));return i.length>0&&n.push(...Ke(e,i)),n}function Ke(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,A.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 Ve(e,t=!0){const n=[],s=r(e.entity);t&&s&&n.push(`// ${s}`);const i=r(e.file)??"",o=typeof e.line=="number"?` l${e.line}`:"";(i||o)&&n.push(`// ${i}${o}`.trim());const c=r(e.code);return c&&n.push(c.trimEnd()),n}function ze(e,t){const n=r(e.entity)??"",s=ue(n),i=[`${t?n:s.name}:`],o=Array.isArray(e.usedBy)?e.usedBy.filter(p):[];for(const l of o){const a=r(l.file)??"",f=Array.isArray(l.locations)?l.locations.filter(p):[];if(f.length!==0){if(f.length===1){const[d]=f,y=typeof d?.line=="number"?d.line:0,m=r(d?.container);i.push(m?`${a}:${y} ${m}`:`${a}:${y}`);continue}i.push(`${a}:`),i.push(...Wt(f))}}const c=r(e.hidden);return c&&i.push(c),i}function Wt(e){const t=[],{ownerGroups:n,standalone:s}=ae(e,i=>r(i.container)??"");for(const[i,o]of n){t.push(`// ${i}:`);for(const c of o){const l=typeof c.line=="number"?c.line:0,a=ue(r(c.container)??"").name;t.push(a?`${a} l${l}`:`l${l}`)}}for(const i of s){const o=typeof i.line=="number"?i.line:0,c=r(i.container);t.push(c?`${c} l${o}`:`l${o}`)}return t}function Qt(e,t,n){const i=(Array.isArray(e[t])?e[t].filter(p):[]).find(o=>r(o.entity)===n);return i?r(i.hidden):null}function ae(e,t){const n=new Map,s=[];for(const i of e){const o=ue(t(i));if(!o.owner){s.push(i);continue}const c=n.get(o.owner)??[];c.push(i),n.set(o.owner,c)}return{ownerGroups:Array.from(n.entries()),standalone:s}}function ue(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 _e(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 Xt(e,t,n,s,i){const o=ye.readFileSync(e,"utf8"),c=Ge(o,t,n),l=Ge(o,s,i);return o.slice(c,l)}function Ge(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 Yt(e){return e.split(/\r?\n/).filter(t=>t.trim()!=="").length}function X(e,t){return(0,Q.compactDisplayPath)(e,t,(0,Q.buildDisplayPathAliases)(e,(0,A.readEffectiveSessionPathAliases)(e)))}async function Zt(e,t,n,s,i){const o=pe(n),c=[],l=[],a=[],f=[],d=[],y=(0,Q.buildDisplayPathAliases)(e,(0,A.readEffectiveSessionPathAliases)(e)),m=[];for(const g of o){if(!p(g))throw new E.CliError("INVALID_INSPECT_REQUEST","Inspect request must be an object.");const _=r(g.op);_==="graph"?(l.push(on(g)),m.push("graph")):_==="imports"?(a.push(g),m.push("imports")):_==="tree"?(f.push(g),m.push("tree")):_==="cycles"?(d.push(g),m.push("cycles")):(c.push(g),m.push("inspect"))}const h=await tn(e,c,s,i),N=l.length>0?rn((0,z.stripAgentText)((0,ge.runInspectGraph)(e,["graph","--stdin"],{requests:l}))):[],P=a.map(g=>(0,Ie.buildInspectImportsResult)(e,{file:r(g.file)??r(g.fromFile)??r(g.sourceFile)??r(n.file)??"",ranges:B(g.ranges)!==!1,dynamic:B(g.dynamic)!==!1},y)),I=f.map(g=>(0,ee.buildInspectTreeResult)(e,sn(g))),T=d.length>0?we((0,z.stripAgentText)((0,be.runInspectCycles)(e,["--stdin"],{requests:d}))):[],S=[];let L=0,C=0,D=0,F=0,u=0;for(const g of m)if(g==="graph"){const _=N[C++];_&&S.push(_)}else if(g==="imports"){const _=P[D++];_&&S.push(_)}else if(g==="tree"){const _=I[F++];_&&S.push(_)}else if(g==="cycles"){const _=T[u++];_&&S.push(_)}else{const _=h[L++];_&&S.push(_)}const $={ok:!S.some(g=>g.ok===!1),...S.some(g=>g.op==="runtimeFailure")?{partial:!0}:{},results:(0,Ie.mergeDirectoryFallbackResults)(S)};return Le((0,z.attachAgentText)($,(0,k.formatInspectMixedAgentText)($)),Oe(n).dslDiagnostics??[])}function qt(e,t,n){if(t[0]==="graph")return null;if(t.includes("--stdin"))return p(n)?n:null;const s=O(t,"--from-json");return s?(0,he.readJsonObjectFile)(e,s,"INVALID_INSPECT_JSON_FILE"):null}function en(e){return pe(e).some(t=>p(t)&&(r(t.op)==="graph"||r(t.op)==="imports"||r(t.op)==="tree"||r(t.op)==="cycles"))}async function tn(e,t,n,s){if(t.length===0)return[];try{return we((0,z.stripAgentText)(await Ce(e,["--stdin"],{requests:t},n,{...s,forceResults:!0})))}catch(i){return t.map(o=>nn(e,o,i))}}function nn(e,t,n){const s=p(n)&&p(n.details)?n.details:{},i=n instanceof E.CliError?n.code:"RUNTIME_INSPECT_FAILED",o=n instanceof Error?n.message:String(n),c=r(t.file)??r(t.sourceFile)??r(t.fromFile)??r(t.target)??"",l=c?M.resolve(e,c):"";return{ok:!1,op:"runtimeFailure",requestedOp:r(t.op)??"file",...r(t.entity)?{entity:r(t.entity)}:{},...l?{sourceFile:l,file:X(e,l)}:{},code:i,error:o,...Array.isArray(s.hints)?{hints:s.hints}:{}}}function sn(e){const t={scope:r(e.scope)??r(e.file)??r(e.dir)??r(e.directory)??""},n=r(e.displayScope)??r(e.display_scope),s=G(e.depth),i=Y(e.minDepth)??Y(e.min_depth),o=G(e.limit),c=R(e.exclude)??R(e.excludes),l=R(e.only),a=B(e.onlyDirs)??B(e.only_dirs);return n!==null&&(t.displayScope=n),s!==null&&(t.depth=s),i!==null&&(t.minDepth=i),o!==null&&(t.limit=o),c!==null&&(t.exclude=c),l!==null&&(t.only=l),a!==null&&(t.onlyDirs=a),t}function on(e){const t={...e};return delete t.op,delete t.sourceFile,t}function we(e){return Array.isArray(e.results)?e.results.filter(p).map(He):[He(e)]}function He(e){return e.op==="dependencies"?{...e,op:"deps"}:e}function rn(e){return Array.isArray(e.results)?e.results.filter(p).map(t=>({op:"graph",...t})):[{op:"graph",...ln(e)}]}function ln(e){const t={...e};return delete t.operation,delete t.next,delete t.last,typeof t.saved=="string"&&delete t.graphFile,t}function cn(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),c=(0,w.buildModulePlanId)(o),l=r(s.previewDir),a=(0,w.resolveModulePlanPreviewDir)(e,c,l??void 0);s.previewDir=a,s.previewPatch=s.previewPatch!==!1,t.cachePlans.push({index:i,planId:c,normalizedRequest:o,previewDir:a})})}function an(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=r(s.normalizedRequest.sourceFile);if(!o)continue;const c=(0,w.hashFile)(o),l=(0,w.buildModulePlanHash)(s.normalizedRequest,c,i),a={planId:s.planId,planHash:l,createdAt:new Date().toISOString(),cwd:M.resolve(e),sourceFile:o,sourceHash:c,executable:i.ok!==!1,normalizedRequest:s.normalizedRequest,inspectPayload:t.payload,previewDir:s.previewDir,previewResult:i};(0,w.writeModulePlanRecord)(e,a),i.planId=s.planId,i.planHash=l,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 un(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=Fn(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,z.attachAgentText)(e,fn(n))}function fn(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 pn(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 c=0;c<n.length;c+=1){const l=n[c],a=r(l.sourceFile);if(!a||!dn(r(l.op))||!Tn(a)){o.set(c,i.length),i.push(l);continue}let f=s.get(a);f?o.set(c,i.findIndex(y=>r(y.sourceFile)===a&&y.op==="directoryFallback")):(f=mn(e,a),s.set(a,f),o.set(c,i.length),i.push(yn(f)));const d=gn(r(l.op));f.ops.includes(d)||f.ops.push(d)}s.size!==0&&(t.payload.requests=i,t.formatOptions.toFiles&&(t.formatOptions.toFiles=fe(t.formatOptions.toFiles,o,i.length)),t.formatOptions.saves&&(t.formatOptions.saves=fe(t.formatOptions.saves,o,i.length)),t.formatOptions.shows&&(t.formatOptions.shows=Je(t.formatOptions.shows,o,i.length)),t.formatOptions.ranges&&(t.formatOptions.ranges=Je(t.formatOptions.ranges,o,i.length)),t.formatOptions.parentNames&&(t.formatOptions.parentNames=fe(t.formatOptions.parentNames,o,i.length)),t.usagesDetails&&(t.usagesDetails=fe(t.usagesDetails,o,i.length)))}function dn(e){return e==="file"||e==="exports"||e==="members"||e==="code"||e==="dependencies"||e==="slice"}function mn(e,t){const n=hn(e,t),s=(0,A.readEffectiveSessionPathAliases)(e),i=(0,Q.compactDisplayPath)(e,t,(0,Q.buildDisplayPathAliases)(e,s)),o=(0,ee.buildInspectTreeResult)(e,{scope:t,displayScope:i,depth:n,limit:40,aliases:s}),c=[];return{sourceFile:t,displayPath:i,ops:c,command:`aib inspect tree ${i} --depth ${n}`,result:{op:"directoryFallback",ok:!0,sourceFile:t,directory:i,skippedOps:c,command:`aib inspect tree ${i} --depth ${n}`,tree:o,lines:Array.isArray(o.lines)?o.lines:[]}}}function yn(e){return{op:"directoryFallback",sourceFile:e.sourceFile,fallback:e.result}}function hn(e,t){for(let n=1;n<=4;n+=1){const s=(0,ee.buildInspectTreeResult)(e,{scope:t,depth:n,limit:1});if(typeof s.files=="number"&&s.files>0)return n}return 2}function fe(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 Je(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 gn(e){return e==="dependencies"?"deps":e??"inspect"}function bn(e,t,n,s,i,o){const c=Qe(t),a=!(t.includes("--no-ranges")||t.includes("--noRanges"))&&(c==="code"||c==="file")||t.includes("--ranges")||c==="exports"&&(0,A.readSessionBooleanPref)(e,"inspect.exports.ranges",!1),f=t.includes("--details"),d=t.includes("--resolve-star")||c==="exports"&&(0,A.readSessionBooleanPref)(e,"inspect.exports.resolveStar",!1),y=t.includes("--local-only"),m=$n(e,t),h=it(t,"--offset"),N=J(t,"--limit")??(c==="members"?(0,A.readSessionNumberPref)(e,"inspect.members.maxItems",20):null),P=t.includes("--all")||c==="members"&&(0,A.readSessionBooleanPref)(e,"inspect.members.all",!1),I=O(t,"--to-file")??void 0,T=O(t,"--save")??void 0,S=c==="code"&&(t.includes("--no-show")||t.includes("--noShow")),L=t.includes("--show"),C=S?!1:L||c==="code"&&(0,A.readSessionBooleanPref)(e,"inspect.code.show",!0),D=(0,A.readSessionBooleanPref)(e,"inspect.code.meta",!0),F=c==="usages"?xe(e,{detail:O(t,"--detail"),all:t.includes("--all"),limit:J(t,"--limit"),maxCodeLines:J(t,"--max-code-lines")??J(t,"--maxCodeLines")}):null,u=O(t,"--bundle-save")??void 0,$=O(t,"--preview-dir")??void 0,g=O(t,"--from-json")??void 0,_=O(t,"--parent")??void 0,x=_?(0,k.parseInspectSelector)(_,s).symbolName:void 0,ne=(0,Q.buildDisplayPathAliases)(e,(0,A.readEffectiveSessionPathAliases)(e)),se=[];if(I!==void 0&&T!==void 0)throw new E.CliError("INSPECT_OUTPUT_TARGET_CONFLICT","Use either --to-file or --save, not both.");const Z={cwd:e,includeRanges:a,displayPathAliases:ne,pathAliasHints:se,details:f,localOnly:y,maxCodeLines:m,forceResults:o,show:C,codeMeta:D,...x!==void 0?{parentName:x,parentNames:[x]}:{},...I!==void 0?{toFile:I}:{},...T!==void 0?{save:T}:{},...u!==void 0?{bundleSave:u}:{},...$!==void 0?{previewDir:j(e,$)}:{}};if(g!==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 b=We((0,he.readJsonObjectFile)(e,g,"INVALID_INSPECT_JSON_FILE"),Qe(t)),H=a||ot(b),v=Xe(e,b,s,H,d,y,{memberOffset:h,memberLimit:N,memberAll:P},i);return{payload:v.payload,cachePlans:[],formatOptions:{...Z,includeRanges:H,toFiles:v.toFiles,saves:v.saves,shows:v.shows,ranges:v.ranges,parentNames:v.parentNames,...u===void 0&&v.bundleSave!==void 0?{bundleSave:v.bundleSave}:{}},usagesDetails:v.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 In(e,t,n,s);const b=We(n,c),H=a||ot(b),v=Xe(e,b,s,H,d,y,{memberOffset:h,memberLimit:N,memberAll:P},i);return{payload:v.payload,cachePlans:[],formatOptions:{...Z,includeRanges:H,toFiles:v.toFiles,saves:v.saves,shows:v.shows,ranges:v.ranges,parentNames:v.parentNames,...u===void 0&&v.bundleSave!==void 0?{bundleSave:v.bundleSave}:{}},usagesDetails:v.usagesDetails,...Oe(n)}}return{payload:xn(e,t,s,a,d,y,{memberOffset:h,memberLimit:N,memberAll:P},i),formatOptions:Z,cachePlans:[],...F!==null?{usagesDetails:[F]}:{}}}function We(e,t){return!t||e.op!==void 0?e:{op:t,...e}}function Qe(e){return e.filter(n=>!n.startsWith("--")&&!rt(e,n))[0]??null}function In(e,t,n,s){const i=O(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),c=An(e,o.previewResult,o.normalizedRequest,n,s),l=(0,w.buildModulePlanId)(c),a=(0,w.resolveModulePlanPreviewDir)(e,l);return{payload:{requests:[{...c,previewFiles:!0,previewPatch:!0,previewDir:a}]},formatOptions:{cwd:e,includeRanges:!1,displayPathAliases:(0,Q.buildDisplayPathAliases)(e,(0,A.readEffectiveSessionPathAliases)(e)),pathAliasHints:[],localOnly:!1,details:!1,maxCodeLines:(0,A.readSessionNumberPref)(e,"inspect.code.maxNonEmptyLines",120),codeMeta:(0,A.readSessionBooleanPref)(e,"inspect.code.meta",!0),previewDir:a},cachePlans:[{index:0,planId:l,normalizedRequest:c,previewDir:a}],revision:{fromPlanId:i,changes:vn(e,o.normalizedRequest,c),previousBlocking:Dn(o.previewResult,s)}}}function xn(e,t,n,s,i,o,c,l){const a=t.filter(I=>!I.startsWith("--")&&!rt(t,I)),[f,d,y]=a;if(!f||!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(!ct(f))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(ut(f,l),O(t,"--save")&&f!=="code"&&f!=="slice"&&f!=="usages"&&f!=="duplicate"&&f!=="duplicates")throw new E.CliError("INVALID_INSPECT_SAVE","inspect --save can be used only with code, slice, usages, or duplicates operations.");const m=at(f),h={op:m,sourceFile:j(e,d),ranges:s||m==="code"||m==="slice",resolveStar:i,localOnly:m==="file"&&o};if(st(h,c),m==="members"||m==="code"||m==="dependencies"||m==="slice"){if(!y)throw new E.CliError("INSPECT_ENTITY_REQUIRED",`inspect ${f} expects an entity selector.`);Ee(h,y,n)}if(m==="usages"&&y&&Ee(h,y,n),m==="duplicates"){h.detail=O(t,"--detail")??"locations",h.mode=O(t,"--mode")??"both";const I=J(t,"--limit"),T=it(t,"--offset");I!==null&&(h.limit=I),T!==null&&(h.offset=T);const S=Kn(t,n);S.length>0&&(h.kinds=S);const L=de([...y?[y]:[],...K(t,"--entity"),...K(t,"--entities").flatMap(F=>F.split(","))],n);L.length>0&&(h.duplicateEntities=L);const C=de([...K(t,"--exclude"),...K(t,"--excludes").flatMap(F=>F.split(","))],n);C.length>0&&(h.duplicateExclude=C);const D=dt(e,[...K(t,"--path-exclude"),...K(t,"--path-excludes").flatMap(F=>F.split(",")),...K(t,"--exclude-path"),...K(t,"--exclude-paths").flatMap(F=>F.split(","))]);D.length>0&&(h.duplicatePathExclude=D)}const N=K(t,"--scope");if(m==="usages"&&N.length>0&&(h.scope=N.map(I=>j(e,I))),m==="duplicates"&&N.length>0&&(h.scope=N.map(I=>j(e,I))),m==="usages"){h.excludeTarget=t.includes("--exclude-target")||t.includes("--excludeTarget")||!1;const I=t.includes("--include-target")||t.includes("--includeTarget"),T=(0,A.readSessionBooleanPref)(e,"inspect.usages.excludeTarget",!1);I?h.excludeTarget=!1:h.excludeTarget===!0||T?h.excludeTarget=!0:tt(e,r(h.sourceFile)??"",R(h.scope)??[])&&(h.excludeTarget=!0,h.targetLocalUsagesHidden=!0)}const P=O(t,"--parent");if(P){const I=(0,k.parseInspectSelector)(P,n);h.parentName=I.symbolName,I.symbolKind&&(h.parentKind=I.symbolKind)}return{requests:[h]}}function Xe(e,t,n,s,i,o,c,l){const a=pe(t),f=[],d=[],y=[],m=[],h=[],N=[],P=Tt(t.detail),I=B(t.all),T=G(t.limit),S=G(t.maxCodeLines),L=B(t.excludeTarget),C=B(t.includeTarget),D=r(t.bundleSave)??r(t.bundle)??r(t.saveBundle)??void 0;return{payload:{requests:a.map((u,$)=>{if(!p(u))throw new E.CliError("INVALID_INSPECT_REQUEST",`Inspect request at index ${$} must be an object.`);const g=r(u.op),_=r(u.sourceFile)??r(u.file)??(g==="usages"?r(u.target)??r(u.usageTarget)??r(u.dir):null)??(g==="duplicate"||g==="duplicates"?r(u.target)??r(u.dir)??pt(u.scope)??pt(u.scopes):null);if(!g||!ct(g))throw new E.CliError("INVALID_INSPECT_OP",`Inspect request at index ${$} has invalid op.`);if(ut(g,l),!_)throw new E.CliError("SOURCE_FILE_REQUIRED",`Inspect request at index ${$} requires sourceFile or file.`);const x=at(g),se=B(u.ranges)??B(u.includeRanges)??(x==="code"||x==="slice"||x==="file"?!0:x==="exports"?(0,A.readSessionBooleanPref)(e,"inspect.exports.ranges",!1):s),Z=se||x==="code"||x==="slice",b={op:x,sourceFile:j(e,_),ranges:Z,resolveStar:B(u.resolveStar)??(x==="exports"?(0,A.readSessionBooleanPref)(e,"inspect.exports.resolveStar",!1):i),localOnly:x==="file"&&(u.localOnly===!0||o)};if(x==="usages"){N.push(xe(e,{detail:r(u.detail)??P,all:B(u.all)??I,limit:G(u.limit)??T,maxCodeLines:G(u.maxCodeLines)??S}));const U=R(u.scope)??R(u.scopes);U&&U.length>0&&(b.scope=U.map(oe=>j(e,oe)));const W=B(u.includeTarget)??C,q=B(u.excludeTarget)??L,ie=(0,A.readSessionBooleanPref)(e,"inspect.usages.excludeTarget",!1);W===!0?b.excludeTarget=!1:q!==null?b.excludeTarget=q:ie?b.excludeTarget=!0:tt(e,b.sourceFile,R(b.scope)??[])&&(b.excludeTarget=!0,b.targetLocalUsagesHidden=!0),Array.isArray(u.entities)&&(b.usageEntities=Bn(u.entities,n))}else N.push(null);if(x==="duplicates"){b.detail=r(u.detail)??r(t.detail)??"locations",b.mode=r(u.mode)??r(t.mode)??"both",b.limit=G(u.limit)??G(t.limit)??10,b.offset=Y(u.offset)??Y(t.offset)??0;const U=R(u.scope)??R(u.scopes)??R(t.scope)??R(t.scopes);U&&U.length>0&&(b.scope=U.map(gt=>j(e,gt)));const W=Vn(u.kinds??t.kinds,n);W.length>0&&(b.kinds=W);const q=de(u.entities??u.entity??t.entities??t.entity,n);q.length>0&&(b.duplicateEntities=q);const ie=de(u.exclude??u.excludes??t.exclude??t.excludes,n);ie.length>0&&(b.duplicateExclude=ie);const oe=dt(e,u.pathExclude??u.pathExcludes??u.excludePath??u.excludePaths??t.pathExclude??t.pathExcludes??t.excludePath??t.excludePaths);oe.length>0&&(b.duplicatePathExclude=oe)}if(x==="modulePlan"){b.modules=kn(e,u.modules,n);const U=r(u.facade)??r(u.facadeFile);if(U&&(b.facadeFile=j(e,U)),u.previewFiles===!0||u.preview==="files"){b.previewFiles=!0;const W=r(u.previewDir)??r(u.outputDir);W&&(b.previewDir=j(e,W)),b.previewPatch=u.previewPatch!==!1}}st(b,{memberOffset:Y(u.offset)??Y(u.memberOffset)??c.memberOffset,memberLimit:G(u.limit)??G(u.memberLimit)??c.memberLimit??(x==="members"?(0,A.readSessionNumberPref)(e,"inspect.members.maxItems",20):null),memberAll:B(u.all)??B(u.memberAll)??(x==="members"?(0,A.readSessionBooleanPref)(e,"inspect.members.all",!1):c.memberAll)});const H=r(u.id);H&&(b.id=H);const v=x==="modulePlan"?null:r(u.toFile)??r(u.outputFile),me=x==="modulePlan"?null:r(u.save);if(v&&x!=="code"&&x!=="slice")throw new E.CliError("INVALID_INSPECT_TO_FILE",`Inspect request at index ${$} 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 ${$} can use save only with code, slice, usages, or duplicates operations.`);if(v&&me)throw new E.CliError("INSPECT_OUTPUT_TARGET_CONFLICT",`Inspect request at index ${$} must use either toFile or save, not both.`);f.push(v),d.push(me);const ht=typeof u.show=="boolean"?u.show:null;y.push(ht??(x==="code"&&(0,A.readSessionBooleanPref)(e,"inspect.code.show",!0))),m.push(se);const Ne=r(u.symbolKind)??r(u.kind),ve=r(u.entity)??r(u.selector)??r(u.symbol)??r(u.symbolName)??r(u.name);ve&&Ee(b,ve,n),Ne&&(b.symbolKind=Ne);const De=r(u.parent);if(De){const U=(0,k.parseInspectSelector)(De,n);b.parentName=U.symbolName,U.symbolKind&&(b.parentKind=U.symbolKind),h.push(U.symbolName)}else h.push(null);return b})},toFiles:f,saves:d,shows:y,ranges:m,parentNames:h,usagesDetails:N,...D!==void 0?{bundleSave:D}:{}}}function Ee(e,t,n){const s=(0,k.parseInspectSelector)(t,n);e.symbolName=s.symbolName,s.symbolKind&&(e.symbolKind=s.symbolKind)}function An(e,t,n,s,i){const o=Cn(n),c=[...Sn(e,s),..._n(e,t,s,i)];if(c.length===0)throw new E.CliError("MODULE_PLAN_REVISE_MOVES_REQUIRED","modulePlan revise expects moves or applySuggestedFixes.");for(const l of c)Nn(o,l,i);return o}function Sn(e,t){return(Array.isArray(t.moves)?t.moves:[]).filter(p).map(s=>{const i=r(s.entity)??r(s.symbol)??r(s.selector),o=r(s.to)??r(s.target)??r(s.toFile)??r(s.targetFile);return i&&o?{selector:i,toFile:j(e,o)}:null}).filter(s=>s!==null)}function _n(e,t,n,s){const i=n.applySuggestedFixes,o=En(t,s),c=i===!0||i==="all"?o.map((l,a)=>a):Array.isArray(i)?i:[];return c.length===0?[]:c.map(l=>typeof l=="number"?l:typeof l=="string"?Number(l):NaN).filter(l=>Number.isInteger(l)&&l>=0&&l<o.length).map(l=>({selector:o[l].selector,toFile:j(e,o[l].toFile)}))}function En(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 c=Array.isArray(o.suggestedFixes)?o.suggestedFixes.filter(p):[];for(const l of c){if(l.kind!=="moveSymbol")continue;const a=Ye(l.symbol,t),f=r(l.toFile);a&&f&&i.push({selector:a,toFile:f})}}return i}function Ye(e,t){if(!p(e))return null;const n=r(e.name),s=r(e.kind);if(!n||!s)return null;const i=t.entityKindAliases[s];return i?`${i}${t.selectorSeparator}${n}`:`${s}:${n}`}function Nn(e,t,n){const s=Array.isArray(e.modules)?e.modules.filter(p):[],i=(0,k.parseInspectSelector)(t.selector,n);let o=null;for(const a of s){const f=Array.isArray(a.symbols)?a.symbols:[],d=[];for(const y of f)o===null&&Ze(y,i)?o=y:d.push(y);a.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 c=s.find(a=>r(a.targetFile)===t.toFile);c||(c={targetFile:t.toFile,symbols:[]},s.push(c));const l=Array.isArray(c.symbols)?c.symbols:[];l.some(a=>Ze(a,i))||l.push(o),c.symbols=l,e.modules=s.filter(a=>Array.isArray(a.symbols)&&a.symbols.length>0)}function Ze(e,t){if(!p(e))return!1;const n=r(e.raw),s=r(e.symbolName),i=r(e.symbolKind);return n===t.raw||s===t.symbolName&&(!t.symbolKind||i===t.symbolKind)}function vn(e,t,n){const s=et(t),i=et(n),o=[];for(const[c,l]of i.entries()){const a=s.get(c);a&&a!==l&&o.push(`${c}: ${qe(e,a)} -> ${qe(e,l)}`)}return o}function Dn(e,t){const n=p(e.boundary)?e.boundary:{};return(Array.isArray(n.nonExportedImports)?n.nonExportedImports.filter(p):[]).flatMap(i=>{const o=r(i.code)??"MODULE_PLAN_BOUNDARY_WARNING";return(Array.isArray(i.symbols)?i.symbols.filter(p):[]).map(l=>Ye(l,t)).filter(l=>typeof l=="string").map(l=>`${o}: ${l}`)})}function Fn(e){return(Array.isArray(e.blocking)?e.blocking.filter(p):[]).flatMap(n=>{const s=r(n.code)??"MODULE_PLAN_BOUNDARY_WARNING";return(Array.isArray(n.symbols)?n.symbols.filter(o=>typeof o=="string"):[]).map(o=>`${s}: ${o}`)})}function qe(e,t){return M.relative(e,t).replace(/\\/g,"/")}function et(e){const t=new Map,n=Array.isArray(e.modules)?e.modules.filter(p):[];for(const s of n){const i=r(s.targetFile);if(!i)continue;const o=Array.isArray(s.symbols)?s.symbols.filter(p):[];for(const c of o){const l=r(c.raw),a=r(c.symbolName),f=r(c.symbolKind),d=l??(a?`${f??"symbol"}:${a}`:null);d&&t.set(d,i)}}return t}function Cn(e){return JSON.parse(JSON.stringify(e))}function j(e,t){return M.normalize(M.isAbsolute(t)?t:M.resolve(e,t))}function tt(e,t,n){const s=M.normalize(t);return n.length===0?!nt(s,e):n.some(i=>Pn(i,s))}function Pn(e,t){const n=M.normalize(e),s=M.normalize(t);return nt(n,s)||On(n)?!1:Ln(s,n)}function Ln(e,t){const n=M.relative(M.normalize(t),M.normalize(e));return n!==""&&!n.startsWith("..")&&!M.isAbsolute(n)}function nt(e,t){return M.normalize(e).toLowerCase()===M.normalize(t).toLowerCase()}function On(e){try{return ye.statSync(e).isFile()}catch{return!1}}function Tn(e){try{return ye.statSync(e).isDirectory()}catch{return!1}}function st(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 $n(e,t){const n=O(t,"--max-lines");if(!n)return(0,A.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 J(e,t){const n=O(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 it(e,t){const n=O(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 G(e){const t=typeof e=="number"?e:typeof e=="string"?Number(e):NaN;return Number.isInteger(t)&&t>0?t:null}function Y(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 ot(e){return pe(e).some(n=>p(n)&&(n.ranges===!0||n.includeRanges===!0))}function pe(e){const t=Un(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 c=Array.isArray(o.entities)?o.entities:null;if(!c){delete o.entities,s.push(o);continue}const l=r(o.op);if(l==="usages"||l==="duplicate"||l==="duplicates"){s.push(o);continue}delete o.entities;for(const a of c){if(p(a)){const f=Array.isArray(a.entities)?a.entities:null;if(f){const d={...a};delete d.entities;for(const y of f)s.push(Mn(o,d,y));continue}s.push({...o,...a});continue}if(typeof a!="string"||a.trim()===""){s.push({...o,entity:a});continue}s.push({...o,entity:a.trim()})}}return s}function Mn(e,t,n){return p(n)?{...e,...t,...n}:typeof n=="string"&&n.trim()!==""?{...e,...t,entity:n.trim()}:{...e,...t,entity:n}}function Un(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 O(e,t){const n=e.indexOf(t);if(n<0)return null;const s=e[n+1];return s&&!s.startsWith("--")?s:null}function K(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 rt(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 kn(e,t,n){return Array.isArray(t)?t.filter(p).map(s=>{const i=r(s.target)??r(s.targetFile)??r(s.file),o=Array.isArray(s.entities)?s.entities:Array.isArray(s.symbols)?s.symbols:[];return{...i?{targetFile:j(e,i)}:{},symbols:o.map(c=>Rn(c,n)).filter(p)}}):[]}function Bn(e,t){return e.flatMap(n=>lt(n,t,{})).filter(p)}function lt(e,t,n){if(typeof e=="string"&&e.trim()!==""){const a=(0,k.parseInspectSelector)(e,t);return[{...n,raw:e.trim(),symbolName:a.symbolName,...a.symbolKind?{symbolKind:a.symbolKind}:{}}]}if(!p(e))return[];const s=r(e.parent),i={...n};if(s){const a=(0,k.parseInspectSelector)(s,t);i.parentName=a.symbolName,a.symbolKind&&(i.parentKind=a.symbolKind)}const o=Array.isArray(e.entities)?e.entities:null;if(o)return o.flatMap(a=>lt(a,t,i));const c=r(e.entity)??r(e.selector)??r(e.raw);if(!c)return[];const l=(0,k.parseInspectSelector)(c,t);return[{...i,raw:c,symbolName:l.symbolName,...l.symbolKind?{symbolKind:l.symbolKind}:{}}]}function Rn(e,t){if(typeof e=="string"&&e.trim()!==""){const s=(0,k.parseInspectSelector)(e,t);return{raw:e.trim(),symbolName:s.symbolName,...s.symbolKind?{symbolKind:s.symbolKind}:{}}}if(!p(e))return null;const n=r(e.entity)??r(e.selector)??r(e.raw);if(n){const s=(0,k.parseInspectSelector)(n,t);return{raw:n,symbolName:s.symbolName,...s.symbolKind?{symbolKind:s.symbolKind}:{}}}return e}function ct(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 at(e){return e==="deps"?"dependencies":e==="duplicate"?"duplicates":e==="cycles"?"cycles":e==="imports"?"imports":e}function ut(e,t){e!=="modulePlan"||t||ft()}function ft(){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 jn(e,t){return e[0]==="modulePlan"?!0:!e.includes("--stdin")||!p(t)?!1:r(t.op)==="modulePlan"?!0:(Array.isArray(t.requests)?t.requests:[]).some(i=>p(i)&&r(i.op)==="modulePlan")}function r(e){return typeof e=="string"&&e.trim()!==""?e.trim():null}function R(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 pt(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 Kn(e,t){const n=[...K(e,"--kind"),...K(e,"--kinds").flatMap(s=>s.split(","))];return yt(n,t)}function Vn(e,t){const n=R(e)??[];return yt(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 c=s.trim();if(!c)return[];const l=(0,k.parseInspectSelector)(c,t);return[mt(l.symbolName,l.symbolKind??null)]}if(!p(s))return[];const i=r(s.entity)??r(s.selector)??r(s.name);if(!i)return[];const o=(0,k.parseInspectSelector)(i,t);return[mt(o.symbolName,o.symbolKind??null)]})}function dt(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=>M.isAbsolute(s)?s:M.resolve(e,s)).map(s=>s.replace(/\\/g,"/"))}function mt(e,t){return t?{symbolName:e,symbolKind:t}:{symbolName:e}}function yt(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));
+}