@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/commands/rename-entities.js

@@ -1,4 +1,794 @@
-"use strict";var ie=exports&&exports.__createBinding||(Object.create?(function(e,n,t,r){r===void 0&&(r=t);var i=Object.getOwnPropertyDescriptor(n,t);(!i||("get"in i?!n.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return n[t]}}),Object.defineProperty(e,r,i)}):(function(e,n,t,r){r===void 0&&(r=t),e[r]=n[t]})),oe=exports&&exports.__setModuleDefault||(Object.create?(function(e,n){Object.defineProperty(e,"default",{enumerable:!0,value:n})}):function(e,n){e.default=n}),T=exports&&exports.__importStar||(function(){var e=function(n){return e=Object.getOwnPropertyNames||function(t){var r=[];for(var i in t)Object.prototype.hasOwnProperty.call(t,i)&&(r[r.length]=i);return r},e(n)};return function(n){if(n&&n.__esModule)return n;var t={};if(n!=null)for(var r=e(n),i=0;i<r.length;i++)r[i]!=="default"&&ie(t,n,r[i]);return oe(t,n),t}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runRenameEntities=de,exports.readCachedRenameExecution=ge;const N=T(require("node:fs")),d=T(require("node:path")),R=require("zod"),se=require("../client/http-client"),v=require("../config/env-vars"),ae=require("../config/product-storage"),ce=require("../shared/routes"),le=require("../shared/protocol"),E=require("../shared/agent-text"),I=require("../shared/errors"),_=require("./shared"),ue=require("../selectors/parse-entities"),fe=require("./entity-resolution"),me=require("../shared/types"),$=require("./rename-preview-cache"),x=require("./rename-execution-cache"),j=require("./mutation-execution-cache"),pe=require("./inspect-symbol-query"),V=require("./rename-input"),M=require("../metrics/central-metrics"),K=R.z.object({sourceFile:R.z.string().min(1).optional(),file:R.z.string().min(1).optional(),renames:V.RenamesInputSchema,execute:R.z.boolean().optional()}).superRefine((e,n)=>{!e.sourceFile&&!e.file&&n.addIssue({code:"custom",path:["sourceFile"],message:"rename expects sourceFile or file."})}).transform(e=>({sourceFile:e.sourceFile??e.file??"",renames:(0,V.normalizeRenamesInput)(e.renames),...e.execute!==void 0?{execute:e.execute}:{}}));async function de(e,n,t={},r=[]){if(r.includes("--help"))return ot();const i=ne(r,"--preview")??ne(r,"--preview-id");if(i){const s=W();return s>0?he(e,i,t,s):ye(e,i,t)}const o=K.parse(n);return o.execute===!0&&W()>0?U(e,o,t,"execute",W()):P(e,o,t)}async function ye(e,n,t){const r=z(e,n),i=B(r),o=await P(e,i,t,{previewId:n});return H(o,r)}async function he(e,n,t,r){const i=z(e,n),o=B(i);return U(e,o,t,"apply",r,{previewId:n,record:i})}function z(e,n){const t=(0,$.readRenamePreviewRecord)(e,n);if((0,$.hashFile)(t.sourceFile)!==t.sourceHash)throw new I.CliError("RENAME_PREVIEW_SOURCE_CHANGED","Source file changed after rename preview. Rerun rename preview.",{previewId:n,sourceFile:S(e,t.sourceFile)});return t}function B(e){return K.parse({...e.normalizedPayload,execute:!0})}function H(e,n){const t=A(e.api)&&e.api.status==="preserved-via-alias",r=e.ok===!1?"Fix the rename request and rerun preview.":t||e.api!==void 0?"If public API rename is intended, update consumers explicitly.":null,i=A(n.previewResult)?n.previewResult.api:void 0,o={...e,operation:"rename.apply",...i!==void 0?{api:i}:{},...r?{next:r}:{}};return(0,E.attachAgentText)(o,G(o))}async function U(e,n,t,r,i,o){const s=(0,x.buildRenameExecutionId)(),c=`rename.${r}`,l=Fe(n),a=(0,x.createRenameExecutionStatus)(e,s,c,J(n));(0,x.writeRenameExecutionStatus)(e,a);const p=Date.now(),h=$e(),m=we(()=>(0,ae.runWithProductStorageOverride)(h[v.CLI_ENV.productStorageDir],()=>_e(h,async()=>{try{const u=o?H(await P(e,n,t,{previewId:o.previewId}),o.record):await P(e,n,t),f=Se(u);return a.status=u.ok===!1?"failed":"completed",a.phase="completed",a.completedRows=f.filter(g=>g.ok!==!1).length,a.failedRows=f.filter(g=>g.ok===!1).length,a.filesWritten=xe(u),a.result=u,u.ok===!1&&(a.error=rt(u.code)??"RENAME_FAILED"),(0,x.writeRenameExecutionStatus)(e,a),u}catch(u){throw a.status="failed",a.phase="completed",a.error=u instanceof Error?u.message:String(u),(0,x.writeRenameExecutionStatus)(e,a),u}}))),y=await(0,j.waitForMutationDeadline)(m,i);return y.status==="result"?y.result:(m.catch(()=>{}),ve(e,s,c,l,Date.now()-p))}async function P(e,n,t,r){await Ne();const i=await(0,_.resolveCompatibleTargetInstance)(e,le.CLI_COMMAND_IDS.renameEntities,t),o=await(0,_.fetchEffectiveConfig)(i.entry,t),s=Ie(e,n.sourceFile),c=n.execute===!0,l=(0,ue.parseEntitySelectors)(n.renames.map(f=>f.entity),o),a=new Map;for(const f of n.renames)a.set(f.entity.trim(),f);await(0,fe.ensureSelectorsResolvable)(i.entry,s,l,o,(0,_.extensionRequestOptions)(t));const p=[];for(const f of l){const g=a.get(f.raw);if(!g)throw new Error(`Rename operation not found for selector: ${f.raw}`);const F=(0,M.startCentralMetricSpan)({kind:"mutation.entity",operation:c?"rename.execute":"rename.preview",cwd:d.resolve(e),sourceFile:S(e,s),entity:f.raw,newName:g.newName,totalEntities:l.length});try{const b=await(0,se.postJson)(i.entry,ce.EXTENSION_ROUTES.renameSymbol,{sourceFile:s,symbolName:f.symbolName,symbolKind:f.symbolKind,...f.parentName?{parentName:f.parentName}:{},newName:g.newName,execute:c,impactMetrics:(0,M.mutationImpactMetricsEnabled)()},(0,_.extensionRequestOptions)(t)),O=Pe(e,o,f,g.newName,b);p.push(O),F.end(Re(b,O,l.length))}catch(b){p.push(Me(o,f,g.newName,b)),F.end({ok:!1,code:b instanceof I.CliError?b.code:"RENAME_FAILED",error:b instanceof Error?b.message:String(b),totalEntities:l.length})}}const h=p.every(f=>f.ok!==!1),m=nt(s,n.renames,l,c),y=await Ze(i.entry,s,l,n.renames,p,o,e,t),u=Ee(e,s,c,l,p,h,y,i.entry.workspaceFolders);if(!c&&h){const f=(0,$.buildRenamePreviewId)(m),g=(0,$.hashFile)(s),F=(0,$.buildRenamePreviewHash)(m,g,u);(0,$.writeRenamePreviewRecord)(e,{previewId:f,previewHash:F,createdAt:new Date().toISOString(),cwd:d.resolve(e),sourceFile:s,sourceHash:g,normalizedPayload:m,previewResult:u}),u.previewId=f,u.next=`aib rename apply ${f}`}return Ce(e,u),(0,E.attachAgentText)(u,G(u))}function ge(e,n){const t=(0,x.readRenameExecutionStatus)(e,n);if((t.status==="completed"||t.status==="failed")&&t.result)return t.result;const r={operation:"execution.status",executionId:t.executionId,status:t.status,phase:t.phase,summary:k(t),progress:`${t.completedRows}/${t.rowCount}`,filesWritten:t.filesWritten,updatedAt:t.updatedAt,...t.error?{error:t.error}:{}};return(0,E.attachAgentText)(r,be(t))}function ve(e,n,t,r,i){const o=(0,x.readRenameExecutionStatus)(e,n),s=Math.max(0,r-i),c={operation:"execution.status",executionId:o.executionId,status:o.status,phase:o.phase,summary:k(o),progress:`${o.completedRows}/${o.rowCount}`,filesWritten:o.filesWritten,updatedAt:o.updatedAt,estimatedRemainingMs:s};return(0,E.attachAgentText)(c,Ae(t,o,s))}function Ae(e,n,t){return[`${e} ${n.executionId}`,k(n),"applying mutation",t>0?`estimated remaining: ${it(Math.max(t,5e3))}`:"estimated remaining: check status again soon"].join(`
-`)}function be(e){const n=[`${e.operation} ${e.executionId}`,k(e)];return e.status==="running"&&n.push("applying mutation"),e.error&&n.push(e.error),n.join(`
-`)}function k(e){return e.status==="completed"?`completed, ${e.completedRows}/${e.rowCount} renames, ${e.filesWritten.length} files written`:e.status==="failed"?`failed, ${e.completedRows}/${e.rowCount} renames, ${e.failedRows} failed`:`in progress, ${e.completedRows}/${e.rowCount} renames`}function we(e){return new Promise((n,t)=>{setImmediate(()=>{e().then(n,t)})})}function W(){return(0,j.readMutationSyncWaitMs)(process.env[v.CLI_ENV.renameSyncWaitMs],12e4)}function Fe(e){return 12e3+J(e)*2e3}function J(e){return Math.max(1,e.renames.length)}function xe(e){return(Array.isArray(e.filesWritten)?e.filesWritten:Array.isArray(e.files)?e.files:[]).filter(t=>typeof t=="string"&&!t.startsWith("+"))}function Se(e){const n=Array.isArray(e.renames)?e.renames.map(r=>({ok:typeof r=="string"&&!r.includes("failed")})):e.rename?[{ok:e.ok!==!1}]:[];if(n.length>0)return n;const t=Array.isArray(e.failed)?e.failed.filter(A):[];return t.length>0?t.map(r=>({...r,ok:!1})):[{ok:e.ok!==!1}]}async function Ne(){const e=process.env[v.CLI_ENV.testRenameDelayMs];if(!e)return;const n=Number.parseInt(e,10);!Number.isFinite(n)||n<=0||await new Promise(t=>setTimeout(t,Math.min(n,12e4)))}function $e(){const e=[v.CLI_ENV.productStorageDir,v.CLI_ENV.trace,v.CLI_ENV.traceDir,v.CLI_ENV.metrics,v.CLI_ENV.metricsDir,v.CLI_ENV.metricsTag,v.CLI_ENV.mutationImpactMetrics,v.CLI_ENV.mutationImpactStream,v.CLI_ENV.testRenameDelayMs],n={};for(const t of e)n[t]=process.env[t];return n}async function _e(e,n){const t={};for(const[r,i]of Object.entries(e))t[r]=process.env[r],i===void 0?delete process.env[r]:process.env[r]=i;try{return await n()}finally{for(const[r,i]of Object.entries(t))i===void 0?delete process.env[r]:process.env[r]=i}}function Ce(e,n){(0,M.recordCentralMetric)({kind:"mutation.summary",operation:typeof n.operation=="string"?n.operation:"rename",cwd:d.resolve(e),ok:n.ok!==!1,sourceFile:typeof n.file=="string"?n.file:null,summary:typeof n.summary=="string"?n.summary:null,filesWrittenCount:Array.isArray(n.filesWritten)?n.filesWritten.filter(t=>typeof t=="string"&&!t.startsWith("+")).length:0})}function Re(e,n,t){const r=A(e.renameImpact)?e.renameImpact:{};return{ok:e.ok!==!1,totalEntities:t,editCount:typeof n.editCount=="number"?n.editCount:0,changedFileCount:Array.isArray(n.allFiles)?n.allFiles.length:0,savedFileCount:Array.isArray(n.allSavedFiles)?n.allSavedFiles.length:0,...(0,M.mutationImpactMetricsEnabled)()?{impactCollectionMs:typeof r.impactCollectionMs=="number"?r.impactCollectionMs:null,impact:{locationCount:typeof r.locationCount=="number"?r.locationCount:null,fileCount:typeof r.fileCount=="number"?r.fileCount:null,impactCollectionMs:typeof r.impactCollectionMs=="number"?r.impactCollectionMs:null},changedFiles:Array.isArray(n.allFiles)?n.allFiles:[],savedFiles:Array.isArray(n.allSavedFiles)?n.allSavedFiles:[]}:{},configFilePath:typeof e.configFilePath=="string"?e.configFilePath:null}}function Ee(e,n,t,r,i,o,s,c){const l=i.reduce((u,f)=>u+te(f.editCount),0),a=Qe(i),p=De(i),h=i.map((u,f)=>({oldName:r[f]?.symbolName??(typeof u.oldName=="string"?u.oldName:u.entity),newName:u.newName})),m=Oe(e,c,i,h,a,n)??Te(e,c,a,h);return{...o?{}:{ok:!1},operation:t?"rename.execute":"rename.preview",file:S(e,n),...r.length===1?{rename:q(i[0],!1)}:{renames:i.map(u=>q(u,!0))},summary:t?`${p.length} ${p.length===1?"file":"files"} written, ${l} edits`:r.length===1?`${a.length} ${a.length===1?"file":"files"}, ${l} edits`:`${r.length} symbols, ${a.length} ${a.length===1?"file":"files"}, ${l} edits`,...t?{}:{files:D(a,5)},...t?{filesWritten:D(p,5)}:{},...o?{}:{failed:i.filter(u=>u.ok===!1).map(u=>ke(u))},...m?{api:We(m)}:{},...o?{}:{next:"Fix failed rename rows and rerun preview."}}}function Ie(e,n){const t=n.trim();return d.normalize(d.isAbsolute(t)?t:d.resolve(e,t))}function Me(e,n,t,r){const i=r instanceof I.CliError&&A(r.details)?r.details:{},o=A(i.details)?i.details:{},s=Z(e,o.candidates),c=A(o.sourceConsistency)?Q(o.sourceConsistency):null;return{entity:n.raw,oldName:n.symbolName,acceptedSelector:C(n,e),newName:t,ok:!1,code:r instanceof I.CliError?r.code:"RENAME_FAILED",error:r instanceof Error?r.message:String(r),...c?{source:c}:{},...s.length>0?{candidates:s}:{},next:s.length>0?"Retry with one of the candidate selectors.":"Run inspect file for this source file, then retry with a canonical selector."}}function Pe(e,n,t,r,i){const o=A(i.locationPreview)?i.locationPreview:{},s=Array.isArray(o.locations)?o.locations.filter(A):[],c=tt(e,s),l=Be(s,t.symbolName,r),a=l.length>0?[]:He(e,c,t.symbolName,r,typeof i.sourceFile=="string"?i.sourceFile:null),p=A(i.sourceConsistency)?Q(i.sourceConsistency):null;return i.ok!==!1?{entity:t.raw,oldName:t.symbolName,...typeof i.sourceFile=="string"?{sourceFilePath:i.sourceFile}:{},acceptedSelector:C(t,n),newName:r,ok:!0,editCount:s.length,...typeof i.configFilePath=="string"?{projectConfig:S(e,i.configFilePath)}:{},allFiles:c.map(({file:m,count:y})=>`${m} x${y}`),files:D(c.map(({file:m,count:y})=>`${m} x${y}`),5),...l.length+a.length>0?{apiAliases:[...l,...a]}:{},...p?{source:p}:{},...i.applied!==void 0?{applied:i.applied===!0}:{},...Array.isArray(i.savedFiles)?{allSavedFiles:i.savedFiles.filter(m=>typeof m=="string").map(m=>S(e,m)),savedFiles:D(i.savedFiles.filter(m=>typeof m=="string").map(m=>S(e,m)),5)}:{}}:{entity:t.raw,acceptedSelector:C(t,n),newName:r,ok:!1,code:typeof i.code=="string"?i.code:"RENAME_FAILED",error:typeof i.error=="string"?i.error:"Rename failed.",...p?{source:p}:{},candidates:Z(n,i.candidates),next:"Use one of the candidates or rerun inspect file if the file changed."}}function q(e,n){const t=typeof e.acceptedSelector=="string"?e.acceptedSelector:e.entity,r=e.ok===!1?"failed":`${te(e.editCount)} edits`,i=n?`, ${r}`:"";return`${t} -> ${e.newName}${i}`}function ke(e){const n={rename:q(e,!1),code:typeof e.code=="string"?e.code:"RENAME_FAILED",error:typeof e.error=="string"?e.error:"Rename failed."};for(const t of["source","candidates","next"])e[t]!==void 0&&(n[t]=e[t]);return n}function De(e){const n=new Set;for(const t of e){const r=Array.isArray(t.allSavedFiles)?t.allSavedFiles:t.savedFiles;if(Array.isArray(r))for(const i of r)typeof i=="string"&&!i.startsWith("+")&&n.add(i)}return Array.from(n)}function We(e){const n=typeof e.aliases=="string"?e.aliases:"aliases",t=typeof e.consumers=="string"?e.consumers:"",r=/^(\d+)\s+/.exec(t),i=r?Number(r[1]):0,o=n.startsWith("1 ")?"name":"names";return i>0?`old ${o} preserved by ${n}; ${t} still use old names`:`old ${o} preserved by ${n}`}function G(e){if(e.ok===!1)return null;const n=typeof e.operation=="string"?e.operation:"";if(n!=="rename.preview"&&n!=="rename.execute"&&n!=="rename.apply")return null;const t=[],r=typeof e.previewId=="string"?e.previewId:"";if(t.push(r&&n==="rename.preview"?`${n} ${r}`:n),typeof e.file=="string"&&t.push(e.file),typeof e.rename=="string")t.push(e.rename);else if(Array.isArray(e.renames))for(const i of e.renames)typeof i=="string"&&t.push(qe(i));return typeof e.summary=="string"&&t.push(e.summary),Le(t,Array.isArray(e.filesWritten)?e.filesWritten:e.files),typeof e.api=="string"&&t.push(`api: ${e.api}`),typeof e.next=="string"&&t.push(`next: ${e.next}`),t.join(`
-`)}function qe(e){return e.replace(/,\s+\d+\s+edits$/,"")}function Le(e,n){if(Array.isArray(n))for(const t of n)typeof t=="string"&&e.push(t)}function Oe(e,n,t,r,i,o){const s=Ke(t),c=ze(e,t,r),l=Ve(e,i,o,r),a=L([...s,...c,...l]);if(a.length===0)return null;const p=Je(e,t),h=ee(e,n),m=X(h,a.map(y=>y.oldName),p);return{status:"preserved-via-alias",aliases:`${a.length} ${a.length===1?"alias":"aliases"}`,consumers:`${m.length} ${m.length===1?"file":"files"} not rewritten`,hint:"Public API names were preserved through re-export aliases. Consumers still use old names."}}function Te(e,n,t,r){if(!t.some(l=>/(^|[/\\])index\.(ts|tsx|mts|cts) x\d+$/i.test(l))||r.length===0)return null;const o=je(e,t),s=ee(e,n),c=X(s,r.map(l=>l.oldName),o);return{status:"preserved-via-alias",aliases:`${r.length} ${r.length===1?"alias":"aliases"}`,consumers:`${c.length} ${c.length===1?"file":"files"} not rewritten`,hint:"Public API names were preserved through re-export aliases. Consumers still use old names."}}function je(e,n){const t=new Set;for(const r of n){if(typeof r!="string"||r.startsWith("+"))continue;const i=/^(.*) x(\d+)$/.exec(r);i&&t.add(w(d.resolve(e,i[1])))}return t}function Ve(e,n,t,r){const i=w(t),o=[];for(const s of n){if(typeof s!="string"||s.startsWith("+"))continue;const c=/^(.*) x(\d+)$/.exec(s);if(!c)continue;const l=d.resolve(e,c[1]);if(w(l)===i)continue;if(/^index\.(ts|tsx|mts|cts)$/i.test(d.basename(l))){o.push(...r);continue}let a="";try{a=N.readFileSync(l,"utf8")}catch{continue}if(!(!a.includes("export")||!a.includes("from")))for(const p of r)a.includes(p.oldName)&&o.push(p)}return L(o)}function Ke(e){const n=[];for(const t of e)if(Array.isArray(t.apiAliases))for(const r of t.apiAliases)A(r)&&typeof r.oldName=="string"&&typeof r.newName=="string"&&n.push({oldName:r.oldName,newName:r.newName});return L(n)}function L(e){const n=new Set;return e.filter(t=>{const r=`${t.newName} as ${t.oldName}`;return n.has(r)?!1:(n.add(r),!0)})}function ze(e,n,t){const r=[];for(const o of n){const s=typeof o.sourceFilePath=="string"?w(o.sourceFilePath):null,c=Array.isArray(o.allFiles)?o.allFiles:[];for(const l of c){if(typeof l!="string"||l.startsWith("+"))continue;const a=/^(.*) x(\d+)$/.exec(l);if(!a)continue;const p=d.resolve(e,a[1]);if(s&&w(p)===s)continue;let h="";try{h=N.readFileSync(p,"utf8")}catch{continue}if(!(!h.includes("export")||!h.includes("from")))for(const m of t)h.includes(m.oldName)&&r.push(m)}}const i=new Set;return r.filter(o=>{const s=`${o.newName} as ${o.oldName}`;return i.has(s)?!1:(i.add(s),!0)})}function Be(e,n,t){const r=new RegExp(`\\b${Y(t)}\\s+as\\s+${Y(n)}\\b`);return e.filter(o=>typeof o.replacementPreview=="string"&&(r.test(o.replacementPreview)||Ue(o,n,t))).map(o=>({oldName:n,newName:t,...typeof o.fileName=="string"?{fileName:o.fileName}:{}})).slice(0,20)}function He(e,n,t,r,i){const o=i?w(i):null,s=[];for(const{file:c}of n){const l=d.resolve(e,c);if(o&&w(l)===o)continue;let a="";try{a=N.readFileSync(l,"utf8")}catch{continue}!a.includes(t)||!a.includes("export")||!a.includes("from")||s.push({oldName:t,newName:r,fileName:l})}return s.slice(0,20)}function Ue(e,n,t){if(typeof e.fileName!="string"||typeof e.replacementPreview!="string"||!e.replacementPreview.includes(t))return!1;let r="";try{r=N.readFileSync(e.fileName,"utf8")}catch{return!1}return r.includes(n)&&r.includes("export")&&r.includes("from")}function Je(e,n){const t=new Set;for(const r of n){const i=Array.isArray(r.allFiles)?r.allFiles:[];for(const o of i){if(typeof o!="string"||o.startsWith("+"))continue;const s=/^(.*) x(\d+)$/.exec(o);s&&t.add(w(d.resolve(e,s[1])))}}return t}function X(e,n,t){const r=Array.from(new Set(n.filter(s=>s.length>0)));if(r.length===0)return[];const i=[],o=new Set;for(const s of e)for(const c of Ge(s,5e3)){const l=w(c);if(t.has(l)||o.has(l))continue;o.add(l);let a="";try{a=N.readFileSync(c,"utf8")}catch{continue}r.some(p=>a.includes(p))&&i.push(c)}return i}function Ge(e,n){const t=[],r=[d.resolve(e)];for(;r.length>0&&t.length<n;){const i=r.pop();if(!i)continue;let o=[];try{o=N.readdirSync(i,{withFileTypes:!0})}catch{continue}for(const s of o){if(t.length>=n)break;if(s.isDirectory()){if(Xe(s.name))continue;r.push(d.join(i,s.name));continue}s.isFile()&&Ye(s.name)&&t.push(d.join(i,s.name))}}return t}function Xe(e){return[".git",".aib-plan-cache",".aib-preview",".aib-trace",".tmp","dist","node_modules","out"].includes(e)}function Ye(e){return/\.(ts|tsx|mts|cts)$/i.test(e)&&!/\.d\.(ts|mts|cts)$/i.test(e)}function w(e){return d.normalize(e).toLowerCase()}function Y(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Qe(e){const n=new Map;for(const t of e){const r=Array.isArray(t.allFiles)?t.allFiles:t.files;if(Array.isArray(r))for(const i of r){if(typeof i!="string"||i.startsWith("+"))continue;const o=/^(.*) x(\d+)$/.exec(i);if(!o)continue;const s=o[1],c=Number(o[2]);n.set(s,(n.get(s)??0)+c)}}return Array.from(n.entries()).sort((t,r)=>t[0].localeCompare(r[0])).map(([t,r])=>`${t} x${r}`)}function st(e,n){return Array.from(new Set(n.map(t=>t.projectConfig).filter(t=>typeof t=="string"&&t.length>0))).sort((t,r)=>t.localeCompare(r))}async function Ze(e,n,t,r,i,o,s,c){const l=new Set(t.map(y=>y.symbolName)),a=new Set(r.map(y=>y.newName.trim())),p=Array.from(l).filter(y=>y.length>0);if(p.length===0)return[];const h=et(n,i,s).slice(0,40),m=[];for(const y of h){let u;try{u=await(0,pe.queryTopLevelInspectSymbols)(e,y,(0,_.extensionRequestOptions)(c))}catch{continue}for(const f of u){if(typeof f.name!="string")continue;const g=f.name;if(!p.some(b=>g.includes(b))||l.has(g)||a.has(g))continue;const F=typeof f.kind=="string"?f.kind.toLowerCase():"";m.push(C({raw:g,symbolName:g,symbolKind:re(F)?F:null},o))}}return Array.from(new Set(m)).sort((y,u)=>y.localeCompare(u))}function et(e,n,t){const r=new Set([e]);for(const i of n){const o=Array.isArray(i.allFiles)?i.allFiles:[];for(const s of o){if(typeof s!="string"||s.startsWith("+"))continue;const c=/^(.*) x(\d+)$/.exec(s);c&&r.add(d.resolve(t,c[1]))}}return Array.from(r)}function tt(e,n){const t=new Map;for(const r of n){if(typeof r.fileName!="string")continue;const i=S(e,r.fileName);t.set(i,(t.get(i)??0)+1)}return Array.from(t.entries()).sort((r,i)=>r[0].localeCompare(i[0])).map(([r,i])=>({file:r,count:i}))}function Q(e){return e.documentMatchesDisk===!0&&e.documentIsDirty!==!0?null:{documentMatchesDisk:e.documentMatchesDisk===!0,documentIsDirty:e.documentIsDirty===!0}}function nt(e,n,t,r){return{sourceFile:e,renames:n.map((i,o)=>({entity:t[o]?.raw??i.entity.trim(),symbolName:t[o]?.symbolName??i.entity.trim(),...t[o]?.symbolKind?{symbolKind:t[o]?.symbolKind}:{},...t[o]?.parentName?{parentName:t[o]?.parentName}:{},newName:i.newName})),execute:r}}function Z(e,n){return Array.isArray(n)?n.filter(A).slice(0,8).map(t=>{const r=typeof t.name=="string"?t.name:"",i=typeof t.kind=="string"?t.kind.toLowerCase():"",o=Array.isArray(t.path)?t.path.filter(c=>typeof c=="string"):[],s=o.length>1?o[o.length-2]:void 0;return{name:r,kind:i,selector:C({raw:s?`${s}.${r}`:r,symbolName:r,symbolKind:re(i)?i:null,...s?{parentName:s}:{}},e)}}):[]}function C(e,n){const t=e.parentName?`${e.parentName}.${e.symbolName}`:e.symbolName;return e.symbolKind?`${n.entityKindAliases[e.symbolKind]}${n.selectorSeparator}${t}`:e.raw}function ee(e,n){const t=w(d.resolve(e)),r=[];for(const i of n.map(o=>d.resolve(o))){const o=w(i);if(t===o||o.startsWith(`${t}/`)){r.push(i);continue}t.startsWith(`${o}/`)&&r.push(d.resolve(e))}return r.length===0?[d.resolve(e)]:Array.from(new Set(r))}function D(e,n){const t=e.slice(0,n),r=e.length-t.length;return r>0?[...t,`+ ${r} more`]:t}function te(e){return typeof e=="number"?e:0}function rt(e){return typeof e=="string"?e:null}function it(e){const n=Math.max(1,Math.ceil(e/1e3));return n<60?`~${n} sec`:`~${Math.ceil(n/60)} min`}function S(e,n){return d.relative(e,n).replace(/\\/g,"/")}function ne(e,n){const t=e.indexOf(n);if(t<0)return null;const r=e[t+1];return r&&!r.startsWith("--")?r:null}function ot(){return{ok:!0,command:"rename",usage:"aib rename preview <sourceFile> <entity> <newName> | aib rename preview --stdin | aib rename execute --stdin | aib rename apply <previewId>",preview:{sourceFile:"src/path/to/source-file.ts",renames:[{entity:"OldSymbolName",newName:"NewSymbolName"}],execute:!1},apply:"aib rename apply rename_abc123",notes:["Use execute:false first when selector resolution is uncertain.","Preview returns previewId, file/edit summary, and candidate selectors on failure.","Apply by previewId refuses to run if the source file changed after preview."]}}function A(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function re(e){return me.ENTITY_KIND_IDS.includes(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.buildSemanticRenameResponse = buildSemanticRenameResponse;
+exports.readCachedRenameExecution = readCachedRenameExecution;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const agent_text_1 = require("../shared/agent-text");
+const types_1 = require("../shared/types");
+const rename_execution_cache_1 = require("./rename-execution-cache");
+const central_metrics_1 = require("../metrics/central-metrics");
+function buildSemanticRenameResponse(cwd, result, builder, response, action, formatOptions) {
+    const builtRows = readSemanticRenameBuiltRows(builder);
+    const responseRows = readSemanticRenameResponseRows(response);
+    const rowResults = builtRows.map((builtRow) => buildSemanticRenameRowResult(cwd, builtRow, responseRows.get(builtRow.id) ?? null));
+    const ok = result.ok !== false && rowResults.every((row) => row.ok !== false);
+    const sourceFile = builtRows.find((row) => row.sourceFile)?.sourceFile ?? "";
+    const absoluteSourceFile = sourceFile ? resolveInputPath(cwd, sourceFile) : "";
+    const renamePairs = rowResults.map((row) => ({
+        oldName: typeof row.oldName === "string" ? row.oldName : row.entity,
+        newName: row.newName
+    }));
+    const files = summarizeRenameFiles(rowResults);
+    const savedFiles = collectSavedFiles(rowResults);
+    const totalEdits = rowResults.reduce((count, row) => count + readNumber(row.editCount), 0);
+    const workspaceFolders = [cwd];
+    const apiSummary = absoluteSourceFile
+        ? buildRenameApiSummary(cwd, workspaceFolders, rowResults, renamePairs, files, absoluteSourceFile, action !== "preview")
+        : null;
+    const operation = action === "apply" ? "rename.apply" : action === "execute" ? "rename.execute" : "rename.preview";
+    const formatted = {
+        ...result,
+        ...(!ok ? { ok: false } : {}),
+        operation,
+        ...(operation === "rename.preview" && typeof result.previewId === "string" ? { previewId: result.previewId } : {}),
+        ...(absoluteSourceFile ? { file: formatRelativePath(cwd, absoluteSourceFile) } : {}),
+        ...(rowResults.length === 1
+            ? { rename: formatRenameLine(rowResults[0], false) }
+            : { renames: rowResults.map((row) => formatRenameLine(row, true)) }),
+        ...(operation === "rename.preview" && (files.length > 0 || totalEdits > 0)
+            ? {
+                summary: rowResults.length === 1
+                    ? `${files.length} ${files.length === 1 ? "file" : "files"}, ${totalEdits} edits`
+                    : `${rowResults.length} symbols, ${files.length} ${files.length === 1 ? "file" : "files"}, ${totalEdits} edits`,
+                files: compactList(files, 5)
+            }
+            : savedFiles.length > 0
+                ? {
+                    summary: `${savedFiles.length} ${savedFiles.length === 1 ? "file" : "files"} written`,
+                    filesWritten: compactList(savedFiles, 5)
+                }
+                : {}),
+        ...(!ok ? { failed: rowResults.filter((row) => row.ok === false).map((row) => compactRenameFailure(row)) } : {}),
+        ...(apiSummary ? { api: formatApiSummary(apiSummary) } : {}),
+        ...(!ok ? { next: "Fix failed rename rows and rerun preview." } : {}),
+        ...(ok && apiSummary && operation !== "rename.preview"
+            ? { next: "If public API rename is intended, update consumers explicitly." }
+            : {}),
+        ...(operation === "rename.preview" && typeof formatOptions.next === "string" ? { next: formatOptions.next } : {})
+    };
+    recordSemanticRenameMetrics(cwd, operation, rowResults, formatted);
+    return (0, agent_text_1.attachAgentText)(formatted, formatRenameAgentText(formatted));
+}
+function recordSemanticRenameMetrics(cwd, operation, rowResults, response) {
+    for (const row of rowResults) {
+        (0, central_metrics_1.recordCentralMetric)({
+            kind: "mutation.entity",
+            operation,
+            cwd: path.resolve(cwd),
+            sourceFile: typeof row.sourceFilePath === "string" && row.sourceFilePath.length > 0
+                ? formatRelativePath(cwd, row.sourceFilePath)
+                : null,
+            entity: row.entity,
+            newName: row.newName,
+            ok: row.ok !== false,
+            totalEntities: rowResults.length,
+            editCount: typeof row.editCount === "number" ? row.editCount : 0,
+            changedFileCount: Array.isArray(row.allFiles) ? row.allFiles.length : 0,
+            savedFileCount: Array.isArray(row.allSavedFiles) ? row.allSavedFiles.length : 0,
+            ...((0, central_metrics_1.mutationImpactMetricsEnabled)()
+                ? {
+                    impact: {
+                        locationCount: typeof row.editCount === "number" ? row.editCount : null,
+                        fileCount: Array.isArray(row.allFiles) ? row.allFiles.length : null,
+                        impactCollectionMs: null
+                    },
+                    changedFiles: Array.isArray(row.allFiles) ? row.allFiles : [],
+                    savedFiles: Array.isArray(row.allSavedFiles) ? row.allSavedFiles : []
+                }
+                : {})
+        });
+    }
+    recordRenameSummaryMetric(cwd, response);
+}
+function readSemanticRenameBuiltRows(builder) {
+    const requests = Array.isArray(builder.rows) ? builder.rows.filter(isJsonObject) : [];
+    const rows = [];
+    for (const request of requests) {
+        if (request.op !== "rename" || !Array.isArray(request.builtRows)) {
+            continue;
+        }
+        for (const rawRow of request.builtRows.filter(isJsonObject)) {
+            if (typeof rawRow.id === "string" &&
+                typeof rawRow.entity === "string" &&
+                typeof rawRow.newName === "string") {
+                rows.push({
+                    id: rawRow.id,
+                    sourceFile: typeof rawRow.sourceFile === "string" ? rawRow.sourceFile : "",
+                    entity: rawRow.entity,
+                    newName: rawRow.newName
+                });
+            }
+        }
+    }
+    return rows;
+}
+function readSemanticRenameResponseRows(response) {
+    const rows = new Map();
+    for (const rawRow of Array.isArray(response.rows) ? response.rows.filter(isJsonObject) : []) {
+        if (typeof rawRow.id === "string") {
+            rows.set(rawRow.id, rawRow);
+        }
+    }
+    return rows;
+}
+function buildSemanticRenameRowResult(cwd, builtRow, responseRow) {
+    const nestedResponse = isJsonObject(responseRow?.response) ? responseRow.response : {};
+    const locationPreview = isJsonObject(nestedResponse.locationPreview) ? nestedResponse.locationPreview : {};
+    const fileCounts = readStringArray(locationPreview.fileCounts);
+    const savedFiles = readStringArray(responseRow?.savedFiles);
+    const ok = responseRow?.ok !== false;
+    const result = {
+        entity: builtRow.entity,
+        oldName: builtRow.entity,
+        sourceFilePath: builtRow.sourceFile ? resolveInputPath(cwd, builtRow.sourceFile) : "",
+        acceptedSelector: builtRow.entity,
+        newName: builtRow.newName,
+        ok,
+        editCount: readNumber(locationPreview.locationCount),
+        allFiles: fileCounts,
+        files: compactList(fileCounts, 5),
+        applied: responseRow?.applied === true,
+        ...(savedFiles.length > 0
+            ? {
+                allSavedFiles: savedFiles,
+                savedFiles: compactList(savedFiles, 5)
+            }
+            : {})
+    };
+    if (!ok) {
+        result.code = typeof responseRow?.error === "string" ? responseRow.error : "RENAME_FAILED";
+        result.error = typeof responseRow?.error === "string" ? responseRow.error : "Rename failed.";
+    }
+    return result;
+}
+function readCachedRenameExecution(cwd, executionId) {
+    const status = (0, rename_execution_cache_1.readRenameExecutionStatus)(cwd, executionId);
+    if ((status.status === "completed" || status.status === "failed") && status.result) {
+        return status.result;
+    }
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        status: status.status,
+        phase: status.phase,
+        summary: buildRenameExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        filesWritten: status.filesWritten,
+        updatedAt: status.updatedAt,
+        ...(status.error ? { error: status.error } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatRenameExecutionStatusText(status));
+}
+function formatRenameExecutionStatusText(status) {
+    const lines = [
+        `${status.operation} ${status.executionId}`,
+        buildRenameExecutionSummary(status)
+    ];
+    if (status.status === "running") {
+        lines.push("applying mutation");
+    }
+    if (status.error) {
+        lines.push(status.error);
+    }
+    return lines.join("\n");
+}
+function buildRenameExecutionSummary(status) {
+    if (status.status === "completed") {
+        return `completed, ${status.completedRows}/${status.rowCount} renames, ${status.filesWritten.length} files written`;
+    }
+    if (status.status === "failed") {
+        return `failed, ${status.completedRows}/${status.rowCount} renames, ${status.failedRows} failed`;
+    }
+    return `in progress, ${status.completedRows}/${status.rowCount} renames`;
+}
+function recordRenameSummaryMetric(cwd, response) {
+    (0, central_metrics_1.recordCentralMetric)({
+        kind: "mutation.summary",
+        operation: typeof response.operation === "string" ? response.operation : "rename",
+        cwd: path.resolve(cwd),
+        ok: response.ok !== false,
+        sourceFile: typeof response.file === "string" ? response.file : null,
+        summary: typeof response.summary === "string" ? response.summary : null,
+        filesWrittenCount: Array.isArray(response.filesWritten) ? response.filesWritten.filter((file) => typeof file === "string" && !file.startsWith("+")).length : 0
+    });
+}
+function resolveInputPath(cwd, filePath) {
+    const trimmed = filePath.trim();
+    return path.normalize(path.isAbsolute(trimmed) ? trimmed : path.resolve(cwd, trimmed));
+}
+function formatRenameLine(result, includeEditCount) {
+    const selector = typeof result.acceptedSelector === "string" ? result.acceptedSelector : result.entity;
+    const status = result.ok === false ? "failed" : `${readNumber(result.editCount)} edits`;
+    const suffix = includeEditCount ? `, ${status}` : "";
+    return `${selector} -> ${result.newName}${suffix}`;
+}
+function compactRenameFailure(result) {
+    const row = {
+        rename: formatRenameLine(result, false),
+        code: typeof result.code === "string" ? result.code : "RENAME_FAILED",
+        error: typeof result.error === "string" ? result.error : "Rename failed."
+    };
+    for (const key of ["source", "candidates", "next"]) {
+        if (result[key] !== undefined) {
+            row[key] = result[key];
+        }
+    }
+    return row;
+}
+function collectSavedFiles(results) {
+    const files = new Set();
+    for (const result of results) {
+        const source = Array.isArray(result.allSavedFiles) ? result.allSavedFiles : result.savedFiles;
+        if (!Array.isArray(source)) {
+            continue;
+        }
+        for (const item of source) {
+            if (typeof item === "string" && !item.startsWith("+")) {
+                files.add(item);
+            }
+        }
+    }
+    return Array.from(files);
+}
+function formatApiSummary(apiSummary) {
+    const aliases = typeof apiSummary.aliases === "string" ? apiSummary.aliases : "aliases";
+    const consumers = typeof apiSummary.consumers === "string" ? apiSummary.consumers : "";
+    const consumerMatch = /^(\d+)\s+/.exec(consumers);
+    const consumerCount = consumerMatch ? Number(consumerMatch[1]) : 0;
+    const plural = aliases.startsWith("1 ") ? "name" : "names";
+    return consumerCount > 0
+        ? `old ${plural} preserved by ${aliases}; ${consumers} still use old names`
+        : `old ${plural} preserved by ${aliases}`;
+}
+function formatRenameAgentText(response) {
+    if (response.ok === false) {
+        return null;
+    }
+    const operation = typeof response.operation === "string" ? response.operation : "";
+    if (operation !== "rename.preview" && operation !== "rename.execute" && operation !== "rename.apply") {
+        return null;
+    }
+    const lines = [];
+    const previewId = typeof response.previewId === "string" ? response.previewId : "";
+    lines.push(previewId && operation === "rename.preview" ? `${operation} ${previewId}` : operation);
+    if (typeof response.file === "string") {
+        lines.push(response.file);
+    }
+    if (typeof response.rename === "string") {
+        lines.push(response.rename);
+    }
+    else if (Array.isArray(response.renames)) {
+        for (const rename of response.renames) {
+            if (typeof rename === "string") {
+                lines.push(stripSuccessfulRenameEditSuffix(rename));
+            }
+        }
+    }
+    if (typeof response.summary === "string") {
+        lines.push(response.summary);
+    }
+    appendStringList(lines, Array.isArray(response.filesWritten) ? response.filesWritten : response.files);
+    if (typeof response.api === "string") {
+        lines.push(`api: ${response.api}`);
+    }
+    if (typeof response.next === "string") {
+        lines.push(`next: ${response.next}`);
+    }
+    return lines.join("\n");
+}
+function stripSuccessfulRenameEditSuffix(rename) {
+    return rename.replace(/,\s+\d+\s+edits$/, "");
+}
+function appendStringList(lines, values) {
+    if (!Array.isArray(values)) {
+        return;
+    }
+    for (const value of values) {
+        if (typeof value === "string") {
+            lines.push(value);
+        }
+    }
+}
+function buildRenameApiSummary(cwd, workspaceFolders, results, renamePairs, summarizedFiles, sourceFile, allowDiskInference) {
+    const aliases = collectApiAliases(results);
+    const inferredAliases = allowDiskInference ? inferApiAliasesFromChangedExports(cwd, results, renamePairs) : [];
+    const summaryAliases = allowDiskInference ? inferApiAliasesFromSummaryFiles(cwd, summarizedFiles, sourceFile, renamePairs) : [];
+    const effectiveAliases = uniqueAliases([...aliases, ...inferredAliases, ...summaryAliases]);
+    if (effectiveAliases.length === 0) {
+        return null;
+    }
+    const changedFiles = collectChangedFilePaths(cwd, results);
+    const scanRoots = getRenameApiScanRoots(cwd, workspaceFolders);
+    const consumerFiles = collectFilesContainingAnyName(scanRoots, effectiveAliases.map((alias) => alias.oldName), changedFiles);
+    return {
+        status: "preserved-via-alias",
+        aliases: `${effectiveAliases.length} ${effectiveAliases.length === 1 ? "alias" : "aliases"}`,
+        consumers: `${consumerFiles.length} ${consumerFiles.length === 1 ? "file" : "files"} not rewritten`,
+        hint: "Public API names were preserved through re-export aliases. Consumers still use old names."
+    };
+}
+function inferApiAliasesFromSummaryFiles(cwd, summarizedFiles, sourceFile, renamePairs) {
+    const sourceComparable = normalizeComparablePath(sourceFile);
+    const aliases = [];
+    for (const item of summarizedFiles) {
+        if (typeof item !== "string" || item.startsWith("+")) {
+            continue;
+        }
+        const match = /^(.*) x(\d+)$/.exec(item);
+        if (!match) {
+            continue;
+        }
+        const absoluteFile = path.resolve(cwd, match[1]);
+        if (normalizeComparablePath(absoluteFile) === sourceComparable) {
+            continue;
+        }
+        let text = "";
+        try {
+            text = fs.readFileSync(absoluteFile, "utf8");
+        }
+        catch {
+            continue;
+        }
+        for (const pair of renamePairs) {
+            if (hasResidualPublicExport(text, pair)) {
+                aliases.push(pair);
+            }
+        }
+    }
+    return uniqueAliases(aliases);
+}
+function collectApiAliases(results) {
+    const aliases = [];
+    for (const result of results) {
+        if (!Array.isArray(result.apiAliases)) {
+            continue;
+        }
+        for (const rawAlias of result.apiAliases) {
+            if (!isJsonObject(rawAlias)) {
+                continue;
+            }
+            if (typeof rawAlias.oldName === "string" && typeof rawAlias.newName === "string") {
+                aliases.push({
+                    oldName: rawAlias.oldName,
+                    newName: rawAlias.newName
+                });
+            }
+        }
+    }
+    return uniqueAliases(aliases);
+}
+function uniqueAliases(aliases) {
+    const seen = new Set();
+    return aliases.filter((alias) => {
+        const key = `${alias.newName} as ${alias.oldName}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+function inferApiAliasesFromChangedExports(cwd, results, renamePairs) {
+    const aliases = [];
+    for (const result of results) {
+        const sourceComparable = typeof result.sourceFilePath === "string"
+            ? normalizeComparablePath(result.sourceFilePath)
+            : null;
+        const resultFiles = Array.isArray(result.allFiles) ? result.allFiles : [];
+        for (const item of resultFiles) {
+            if (typeof item !== "string" || item.startsWith("+")) {
+                continue;
+            }
+            const match = /^(.*) x(\d+)$/.exec(item);
+            if (!match) {
+                continue;
+            }
+            const absoluteFile = path.resolve(cwd, match[1]);
+            if (sourceComparable && normalizeComparablePath(absoluteFile) === sourceComparable) {
+                continue;
+            }
+            let text = "";
+            try {
+                text = fs.readFileSync(absoluteFile, "utf8");
+            }
+            catch {
+                continue;
+            }
+            for (const pair of renamePairs) {
+                if (hasResidualPublicExport(text, pair)) {
+                    aliases.push(pair);
+                }
+            }
+        }
+    }
+    const seen = new Set();
+    return aliases.filter((alias) => {
+        const key = `${alias.newName} as ${alias.oldName}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+function collectAliasPreservingRenames(locations, oldName, newName) {
+    const aliasPattern = new RegExp(`\\b${escapeRegExp(newName)}\\s+as\\s+${escapeRegExp(oldName)}\\b`);
+    const aliases = locations
+        .filter((location) => typeof location.replacementPreview === "string" &&
+        aliasPattern.test(location.replacementPreview))
+        .map((location) => ({
+        oldName,
+        newName,
+        ...(typeof location.fileName === "string" ? { fileName: location.fileName } : {})
+    }));
+    return aliases.slice(0, 20);
+}
+function collectPotentialAliasPreservingExports(cwd, fileCounts, oldName, newName, sourceFile) {
+    const sourceComparable = sourceFile ? normalizeComparablePath(sourceFile) : null;
+    const aliases = [];
+    for (const { file } of fileCounts) {
+        const absoluteFile = path.resolve(cwd, file);
+        if (sourceComparable && normalizeComparablePath(absoluteFile) === sourceComparable) {
+            continue;
+        }
+        let text = "";
+        try {
+            text = fs.readFileSync(absoluteFile, "utf8");
+        }
+        catch {
+            continue;
+        }
+        if (!hasResidualPublicExport(text, { oldName, newName })) {
+            continue;
+        }
+        aliases.push({
+            oldName,
+            newName,
+            fileName: absoluteFile
+        });
+    }
+    return aliases.slice(0, 20);
+}
+function hasResidualPublicExport(sourceText, pair) {
+    const oldNamePattern = new RegExp(`(?:^|[^\\p{ID_Continue}$])${escapeRegExp(pair.oldName)}(?:$|[^\\p{ID_Continue}$])`, "u");
+    const aliasPattern = new RegExp(`(?:^|[,\\s])(?:type\\s+)?${escapeRegExp(pair.newName)}\\s+as\\s+${escapeRegExp(pair.oldName)}(?:$|[,\\s])`, "u");
+    for (const match of sourceText.matchAll(/\bexport\s+(?:type\s+)?\{([\s\S]*?)\}(?:\s+from\b[^;]*)?;/gu)) {
+        const bindings = match[1] ?? "";
+        if (aliasPattern.test(bindings) || oldNamePattern.test(bindings)) {
+            return true;
+        }
+    }
+    return false;
+}
+function collectChangedFilePaths(cwd, results) {
+    const files = new Set();
+    for (const result of results) {
+        const resultFiles = Array.isArray(result.allFiles) ? result.allFiles : [];
+        for (const item of resultFiles) {
+            if (typeof item !== "string" || item.startsWith("+")) {
+                continue;
+            }
+            const match = /^(.*) x(\d+)$/.exec(item);
+            if (match) {
+                files.add(normalizeComparablePath(path.resolve(cwd, match[1])));
+            }
+        }
+    }
+    return files;
+}
+function collectFilesContainingAnyName(roots, names, excludedFiles) {
+    const uniqueNames = Array.from(new Set(names.filter((name) => name.length > 0)));
+    if (uniqueNames.length === 0) {
+        return [];
+    }
+    const files = [];
+    const seen = new Set();
+    for (const root of roots) {
+        for (const file of walkTypeScriptFiles(root, 5000)) {
+            const comparableFile = normalizeComparablePath(file);
+            if (excludedFiles.has(comparableFile) || seen.has(comparableFile)) {
+                continue;
+            }
+            seen.add(comparableFile);
+            let text = "";
+            try {
+                text = fs.readFileSync(file, "utf8");
+            }
+            catch {
+                continue;
+            }
+            if (uniqueNames.some((name) => text.includes(name))) {
+                files.push(file);
+            }
+        }
+    }
+    return files;
+}
+function walkTypeScriptFiles(root, maxFiles) {
+    const files = [];
+    const stack = [path.resolve(root)];
+    while (stack.length > 0 && files.length < maxFiles) {
+        const current = stack.pop();
+        if (!current) {
+            continue;
+        }
+        let entries = [];
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (files.length >= maxFiles) {
+                break;
+            }
+            if (entry.isDirectory()) {
+                if (shouldSkipDirectory(entry.name)) {
+                    continue;
+                }
+                stack.push(path.join(current, entry.name));
+                continue;
+            }
+            if (entry.isFile() && isTypeScriptSourceFile(entry.name)) {
+                files.push(path.join(current, entry.name));
+            }
+        }
+    }
+    return files;
+}
+function shouldSkipDirectory(name) {
+    return [
+        ".git",
+        ".aib-plan-cache",
+        ".aib-preview",
+        ".aib-trace",
+        ".tmp",
+        "dist",
+        "node_modules",
+        "out"
+    ].includes(name);
+}
+function isTypeScriptSourceFile(fileName) {
+    return /\.(ts|tsx|mts|cts)$/i.test(fileName) && !/\.d\.(ts|mts|cts)$/i.test(fileName);
+}
+function normalizeComparablePath(filePath) {
+    return path.normalize(filePath).toLowerCase();
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function summarizeRenameFiles(results) {
+    const counts = new Map();
+    for (const result of results) {
+        const resultFiles = Array.isArray(result.allFiles) ? result.allFiles : result.files;
+        if (!Array.isArray(resultFiles)) {
+            continue;
+        }
+        for (const item of resultFiles) {
+            if (typeof item !== "string" || item.startsWith("+")) {
+                continue;
+            }
+            const match = /^(.*) x(\d+)$/.exec(item);
+            if (!match) {
+                continue;
+            }
+            const file = match[1];
+            const count = Number(match[2]);
+            counts.set(file, (counts.get(file) ?? 0) + count);
+        }
+    }
+    return Array.from(counts.entries())
+        .sort((left, right) => left[0].localeCompare(right[0]))
+        .map(([file, count]) => `${file} x${count}`);
+}
+function collectProjectConfigs(cwd, results) {
+    return Array.from(new Set(results
+        .map((result) => result.projectConfig)
+        .filter((item) => typeof item === "string" && item.length > 0))).sort((left, right) => left.localeCompare(right));
+}
+function collectRenameResultFiles(sourceFile, results, cwd) {
+    const files = new Set([sourceFile]);
+    for (const result of results) {
+        const resultFiles = Array.isArray(result.allFiles) ? result.allFiles : [];
+        for (const item of resultFiles) {
+            if (typeof item !== "string" || item.startsWith("+")) {
+                continue;
+            }
+            const match = /^(.*) x(\d+)$/.exec(item);
+            if (!match) {
+                continue;
+            }
+            files.add(path.resolve(cwd, match[1]));
+        }
+    }
+    return Array.from(files);
+}
+function countRenameLocationsByFile(cwd, locations) {
+    const counts = new Map();
+    for (const location of locations) {
+        if (typeof location.fileName !== "string") {
+            continue;
+        }
+        const file = formatRelativePath(cwd, location.fileName);
+        counts.set(file, (counts.get(file) ?? 0) + 1);
+    }
+    return Array.from(counts.entries())
+        .sort((left, right) => left[0].localeCompare(right[0]))
+        .map(([file, count]) => ({ file, count }));
+}
+function compactSourceConsistency(raw) {
+    if (raw.documentMatchesDisk === true && raw.documentIsDirty !== true) {
+        return null;
+    }
+    return {
+        documentMatchesDisk: raw.documentMatchesDisk === true,
+        documentIsDirty: raw.documentIsDirty === true
+    };
+}
+function normalizeRenamePayload(sourceFile, renames, selectors, execute) {
+    return {
+        sourceFile,
+        renames: renames.map((rename, index) => ({
+            entity: selectors[index]?.raw ?? rename.entity.trim(),
+            symbolName: selectors[index]?.symbolName ?? rename.entity.trim(),
+            ...(selectors[index]?.symbolKind ? { symbolKind: selectors[index]?.symbolKind } : {}),
+            ...(selectors[index]?.parentName ? { parentName: selectors[index]?.parentName } : {}),
+            newName: rename.newName
+        })),
+        execute
+    };
+}
+function formatRenameCandidates(config, rawCandidates) {
+    if (!Array.isArray(rawCandidates)) {
+        return [];
+    }
+    return rawCandidates.filter(isJsonObject).slice(0, 8).map((candidate) => {
+        const name = typeof candidate.name === "string" ? candidate.name : "";
+        const kind = typeof candidate.kind === "string" ? candidate.kind.toLowerCase() : "";
+        const path = Array.isArray(candidate.path) ? candidate.path.filter((item) => typeof item === "string") : [];
+        const parentName = path.length > 1 ? path[path.length - 2] : undefined;
+        return {
+            name,
+            kind,
+            selector: formatSelector({
+                raw: parentName ? `${parentName}.${name}` : name,
+                symbolName: name,
+                symbolKind: isKnownKind(kind) ? kind : null,
+                ...(parentName ? { parentName } : {})
+            }, config)
+        };
+    });
+}
+function formatSelector(selector, config) {
+    const symbolName = selector.parentName ? `${selector.parentName}.${selector.symbolName}` : selector.symbolName;
+    if (!selector.symbolKind) {
+        return selector.raw;
+    }
+    const alias = config.entityKindAliases[selector.symbolKind];
+    return `${alias}${config.selectorSeparator}${symbolName}`;
+}
+function getRenameApiScanRoots(cwd, workspaceFolders) {
+    const resolvedCwd = normalizeComparablePath(path.resolve(cwd));
+    const candidates = [];
+    for (const folder of workspaceFolders.map((item) => path.resolve(item))) {
+        const comparableFolder = normalizeComparablePath(folder);
+        if (resolvedCwd === comparableFolder || comparableFolder.startsWith(`${resolvedCwd}/`)) {
+            candidates.push(folder);
+            continue;
+        }
+        if (resolvedCwd.startsWith(`${comparableFolder}/`)) {
+            candidates.push(path.resolve(cwd));
+        }
+    }
+    if (candidates.length === 0) {
+        return [path.resolve(cwd)];
+    }
+    return Array.from(new Set(candidates));
+}
+function compactList(items, limit) {
+    const visible = items.slice(0, limit);
+    const hidden = items.length - visible.length;
+    return hidden > 0 ? [...visible, `+ ${hidden} more`] : visible;
+}
+function readNumber(value) {
+    return typeof value === "number" ? value : 0;
+}
+function readString(value) {
+    return typeof value === "string" ? value : null;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function formatDuration(milliseconds) {
+    const seconds = Math.max(1, Math.ceil(milliseconds / 1000));
+    if (seconds < 60) {
+        return `~${seconds} sec`;
+    }
+    const minutes = Math.ceil(seconds / 60);
+    return `~${minutes} min`;
+}
+function formatRelativePath(cwd, filePath) {
+    return path.relative(cwd, filePath).replace(/\\/g, "/");
+}
+function readFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    if (index < 0) {
+        return null;
+    }
+    const value = args[index + 1];
+    return value && !value.startsWith("--") ? value : null;
+}
+function renameEntitiesHelp() {
+    return {
+        ok: true,
+        command: "rename",
+        usage: "aib rename preview <sourceFile> <entity> <newName> | aib rename preview --stdin | aib rename execute --stdin | aib rename apply <previewId>",
+        preview: {
+            sourceFile: "src/path/to/source-file.ts",
+            renames: [
+                {
+                    entity: "OldSymbolName",
+                    newName: "NewSymbolName"
+                }
+            ],
+            execute: false
+        },
+        apply: "aib rename apply rename_abc123",
+        notes: [
+            "Use execute:false first when selector resolution is uncertain.",
+            "Preview returns previewId, file/edit summary, and candidate selectors on failure.",
+            "Apply by previewId refuses to run if the source file changed after preview."
+        ]
+    };
+}
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isKnownKind(value) {
+    return types_1.ENTITY_KIND_IDS.includes(value);
+}