@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/commands/file-rename.js

@@ -1,5 +1,1053 @@
-"use strict";var ge=exports&&exports.__createBinding||(Object.create?(function(e,t,n,r){r===void 0&&(r=n);var o=Object.getOwnPropertyDescriptor(t,n);(!o||("get"in o?!t.__esModule:o.writable||o.configurable))&&(o={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,o)}):(function(e,t,n,r){r===void 0&&(r=n),e[r]=t[n]})),Re=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),Q=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var r=[];for(var o in n)Object.prototype.hasOwnProperty.call(n,o)&&(r[r.length]=o);return r},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var r=e(t),o=0;o<r.length;o++)r[o]!=="default"&&ge(n,t,r[o]);return Re(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runFileRename=Me,exports.readCachedFileRenameExecution=Ce;const _=Q(require("node:fs")),f=Q(require("node:path")),x=require("zod"),Fe=require("../client/http-client"),E=require("../config/env-vars"),Ee=require("../config/product-storage"),W=require("../config/import-rules"),O=require("../shared/agent-text"),S=require("../shared/errors"),U=require("../shared/protocol"),_e=require("../shared/routes"),B=require("./shared"),X=require("./inspect-cycles"),b=require("./file-rename-preview-cache"),w=require("./file-rename-execution-cache"),F=require("./file-mutation-runtime"),Y=require("./mutation-execution-cache"),Z=x.z.object({base:x.z.string().min(1),renames:x.z.array(x.z.object({source:x.z.string().min(1),target:x.z.string().min(1)})).min(1),execute:x.z.boolean().optional()});async function Me(e,t,n={},r=[]){const o=Be(),i=r[0]??"preview";if(i==="help"||i==="--help")return Ge();if(i==="apply"){const l=r[1];if(!l||l.startsWith("--"))throw new S.CliError("FILE_RENAME_PREVIEW_ID_REQUIRED","file rename apply expects a preview id.",{usage:"aib file rename apply <previewId>"});return we(e,l,n,o)}if(i!=="preview"&&i!=="execute"&&i!=="validate")throw new S.CliError("UNKNOWN_FILE_RENAME_COMMAND",`Unknown file rename command: ${i}`,{availableCommands:["preview","apply","execute","validate","help"]});const s=Z.parse(t);return i==="execute"&&K()>0?ee(e,{...s,execute:!0},n,"execute",K(),o):te(e,{...s,execute:i==="execute"},n,i,o)}async function we(e,t,n,r){const o=(0,b.readFileRenamePreviewRecord)(e,t);(0,b.validateFileMoveStates)(o);const i=Z.parse({...o.normalizedPayload,execute:!0}),s=K();if(s>0)return ee(e,i,n,"apply",s,r,t);const l=await te(e,i,n,"apply",r,t);return l.ok===!1?(0,O.attachAgentText)({...l,next:"Fix the file rename request and rerun preview."},G({...l,next:"Fix the file rename request and rerun preview."})):l}async function ee(e,t,n,r,o,i,s){const l=ie(e,t,!0),a=(0,w.buildFileRenameExecutionId)(),u=`file.rename.${r}`,d=(0,F.estimateFileMutationDurationMs)(qe(l.operations)),c=(0,w.createFileRenameExecutionStatus)(e,a,u,We(e,l.operations));(0,w.writeFileRenameExecutionStatus)(e,c);const R=Date.now(),M=Ve(),P=(0,F.startFileMutationBackgroundJob)(()=>(0,Ee.runWithProductStorageOverride)(M[E.CLI_ENV.productStorageDir],()=>(0,F.withFileMutationBackgroundEnv)(M,async()=>{try{const m=await ne(e,l,r,n,i,a,c,s),I=Ue(m);return c.status=m.ok===!1?"failed":"completed",c.phase="completed",c.completedRows=m.ok===!1?I.filter(A=>A.ok!==!1).length:c.rowCount,c.failedRows=m.ok===!1?I.filter(A=>A.ok===!1).length:0,c.notRunRows=m.ok===!1?Math.max(0,c.rowCount-I.length):0,c.filesWritten=$(m.filesWritten),c.touchedFiles=$(m.touchedFiles),c.moves=Array.isArray(m.renames)?m.renames.filter(h):[],c.rows=I,h(m.postMutation)&&(c.postMutation=m.postMutation),c.result=m,m.ok===!1&&(c.error=p(m.code)??le(I)??"FILE_RENAME_FAILED"),(0,w.writeFileRenameExecutionStatus)(e,c),m}catch(m){throw c.status="failed",c.phase="completed",c.failedRows=Math.max(1,c.failedRows),c.notRunRows=Math.max(0,c.rowCount-c.completedRows-c.failedRows),c.error=m instanceof Error?m.message:String(m),(0,w.writeFileRenameExecutionStatus)(e,c),m}}))),T=await(0,Y.waitForMutationDeadline)(P,o);return T.status==="result"?T.result:(P.catch(()=>{}),xe(e,a,u,d,Date.now()-R))}async function te(e,t,n,r,o,i,s,l){await(0,F.maybeDelayFileMutationForTest)(process.env[E.CLI_ENV.testFileRenameDelayMs]);const a=l??ie(e,t,r==="execute"||r==="apply"),u=a.execute?await ne(e,a,r==="apply"?"apply":"execute",n,o,s,void 0,i):be(a.operations),d=se(e,u,a,r,i,s);if((r==="preview"||r==="validate")&&d.ok!==!1){const c=(0,b.buildFileRenamePreviewId)(a.normalizedPayload),R=(0,b.readFileMoveStates)(a.operations),M=(0,b.buildFileRenamePreviewHash)(a.normalizedPayload,R,d);(0,b.writeFileRenamePreviewRecord)(e,{previewId:c,previewHash:M,createdAt:new Date().toISOString(),cwd:f.resolve(e),normalizedPayload:a.normalizedPayload,states:R,previewResult:d}),d.previewId=c,d.next=`aib file rename apply ${c}`}return(0,O.attachAgentText)(d,G(d))}async function ne(e,t,n,r,o,i,s,l){const a=[],u=new Set,d=new Set,c=[],R=ce(e,t.operations.map(y=>y.sourceFile));let M=[],P=null;for(const y of t.operations){s&&(s.phase="movingFile",s.status="running",q(e,s,a,u,d),await z());const C=await ve(e,y,r,o),L=Array.isArray(C.rows)&&h(C.rows[0])?C.rows[0]:v(y,"FILE_RENAME_FAILED","Extension did not return a file rename row.");a.push(L);for(const N of D(L.savedFiles))u.add(f.normalize(N));for(const N of D(L.touchedFiles))d.add(f.normalize(N));for(const N of Je(L.importSnapshotBefore))c.push(N);if(s&&(q(e,s,a,u,d),await z()),L.ok===!1)break;await(0,F.delayFileMutationForTest)(o.testRowDelayMs)}const T=a.every(y=>y.ok!==!1)&&a.length===t.operations.length;if(a.some(y=>y.ok!==!1)&&o.postProcessImports&&d.size>0){s&&(s.phase="postProcessImports",q(e,s,a,u,d),await z()),await(0,F.delayFileMutationForTest)(o.testImportPostProcessDelayMs);const y=await Ie(e,Array.from(d),c,r);M=Array.isArray(y.cleanup)?y.cleanup.filter(h):[];for(const C of D(y.savedFiles))u.add(f.normalize(C))}const m=M.every(y=>y.ok!==!1);if(T&&m){s&&(s.phase="postMutation.cycles",q(e,s,a,u,d),await z()),await nt(o.testPostMutationCyclesDelayMs);const y=ye([...Array.from(d),...Array.from(u)]),C=ce(e,y);P={cycles:Qe(R,C,new Set(pe(e,y)))}}const I=J({...!T||!m?{ok:!1}:{},operation:U.CLI_COMMAND_IDS.fileMutation,execute:!0,rowCount:t.operations.length,appliedCount:a.filter(y=>y.applied===!0).length,savedFiles:Array.from(u),touchedFiles:Array.from(d),cleanup:M,rows:a,postMutation:P}),A=se(e,I,t,n,l,i);return(0,O.attachAgentText)(A,G(A))}function q(e,t,n,r,o){const i=n.map(s=>ae(e,s));t.rows=i,t.completedRows=i.filter(s=>s.ok!==!1).length,t.failedRows=i.filter(s=>s.ok===!1).length,t.notRunRows=t.failedRows>0?Math.max(0,t.rowCount-i.length):0,t.filesWritten=Array.from(r).sort((s,l)=>s.localeCompare(l)).map(s=>g(e,s)),t.touchedFiles=Array.from(o).sort((s,l)=>s.localeCompare(l)).map(s=>g(e,s)),t.failedRows>0&&(t.status="failed",t.error=le(i)??"FILE_RENAME_FAILED"),(0,w.writeFileRenameExecutionStatus)(e,t)}async function ve(e,t,n,r){const o=await(0,B.resolveCompatibleTargetInstance)(e,U.CLI_COMMAND_IDS.fileMutation,n),i=n.importRules??(0,W.readConfigImportRules)(e),s=r.testFailRequiredImportUpdate,a={operations:[s?{...t,testFailRequiredImportUpdate:s}:t],execute:!0,importRules:(0,W.importRulesToJson)(i),postProcessImports:!1};return s&&(a.testFailRequiredImportUpdate=s),oe(o.entry,a,n)}async function Ie(e,t,n,r){const o=await(0,B.resolveCompatibleTargetInstance)(e,U.CLI_COMMAND_IDS.fileMutation,r),i=r.importRules??(0,W.readConfigImportRules)(e);return oe(o.entry,{action:"postProcessImports",files:t,importRules:(0,W.importRulesToJson)(i),importSnapshotBefore:n},r)}function Ce(e,t){const n=(0,w.readFileRenameExecutionStatus)(e,t),r={operation:"execution.status",executionId:n.executionId,status:n.status,phase:n.phase,summary:j(n),progress:`${n.completedRows}/${n.rowCount}`,filesWritten:n.filesWritten,touchedFiles:n.touchedFiles,...n.postMutation?{postMutation:n.postMutation}:{},updatedAt:n.updatedAt,...n.error?{error:n.error}:{}};return(0,O.attachAgentText)(r,Se(n))}function xe(e,t,n,r,o){const i=(0,w.readFileRenameExecutionStatus)(e,t),s=Math.max(0,r-o),l={operation:"execution.status",executionId:i.executionId,status:i.status,phase:i.phase,summary:j(i),progress:`${i.completedRows}/${i.rowCount}`,filesWritten:i.filesWritten,touchedFiles:i.touchedFiles,...i.postMutation?{postMutation:i.postMutation}:{},updatedAt:i.updatedAt,estimatedRemainingMs:s};return(0,O.attachAgentText)(l,Ae(n,i,s))}function Ae(e,t,n){return[`${e} ${t.executionId}`,j(t),re(t),n>0?`estimated remaining: ${(0,F.formatFileMutationDuration)(Math.max(n,5e3))}`:"estimated remaining: check status again soon"].join(`
-`)}function Se(e){const t=[j(e)];if(e.status==="running")return t.push(re(e)),t.join(`
-`);je(t,e);const n=e.rows.filter(o=>o.ok===!1),r=n[0];if(r){const o=p(r.code)??e.error??"FILE_RENAME_FAILED";t.push(`code: ${o}`),typeof r.error=="string"&&t.push(r.error),typeof r.rollback=="string"&&t.push(`rollback: ${r.rollback}`),typeof r.hint=="string"&&t.push(`hint: ${r.hint}`),t.push("failed:");for(const i of n)t.push(`${p(i.source)??"source"} -> ${p(i.target)??"target"}`)}else e.error&&t.push(e.error);return ze(t,e),e.filesWritten.length>0&&de(t,e.filesWritten,e.plannedMoves.map(o=>o.target)),h(e.postMutation)&&h(e.postMutation.cycles)&&he(t,e.postMutation.cycles),e.status==="failed"&&t.push("next: Fix failed rename row and rerun file.rename preview."),t.join(`
-`)}function re(e){return e.phase==="postProcessImports"?"updating imports":e.phase==="postMutation.cycles"?"checking cycles":"renaming files"}function j(e){const t=Math.floor(Math.max(0,e.completedRows)/Math.max(1,e.rowCount)*100);if(e.status==="completed")return`completed, ${e.completedRows}/${e.rowCount} rows, ${t}% files, ${e.filesWritten.length} files written`;if(e.status==="failed"){const n=[`failed, ${e.completedRows}/${e.rowCount} rows, ${t}% files`,`${e.failedRows} failed`];return e.notRunRows>0&&n.push(`${e.notRunRows} not run`),n.push(`${e.filesWritten.length} files written`),n.join(", ")}return`in progress, ${e.completedRows}/${e.rowCount} rows, ${t}% files`}async function oe(e,t,n){try{return await(0,Fe.postJson)(e,_e.EXTENSION_ROUTES.fileMutation,t,(0,B.extensionRequestOptions)(n))}catch(r){if(r instanceof S.CliError&&r.code==="REMOTE_ERROR"){const o=h(r.details)?r.details:{},i=h(o.payload)?o.payload:null;if(i)return i}throw r}}function ie(e,t,n){const r=Le(e,t.base),o=[],i=new Set;for(const s of t.renames){const l=Pe(e,r,s.source);V(e,l,"FILE_RENAME_SOURCE_OUTSIDE_CWD");const a=Te(e,r,l,s.target);V(e,a,"FILE_RENAME_TARGET_OUTSIDE_CWD");const u=tt(a);if(i.has(u))throw new S.CliError("FILE_RENAME_DUPLICATE_TARGET","Several file renames resolve to the same target.",{targetFile:g(e,a)});i.add(u),o.push({id:`rename-${o.length+1}`,kind:"fileRename",sourceFile:l,targetDir:f.dirname(a),targetFile:a,execute:n})}if(o.length===0)throw new S.CliError("FILE_RENAME_ROWS_REQUIRED","file rename expects at least one rename pair.");return{execute:n,baseDir:r,operations:o,normalizedPayload:{base:r,renames:ke(o),execute:n}}}function be(e){const t=[];for(const r of e){if(t.some(o=>o.ok===!1))break;t.push(De(r))}return{...t.every(r=>r.ok!==!1)&&t.length===e.length?{}:{ok:!1},operation:U.CLI_COMMAND_IDS.fileMutation,execute:!1,rowCount:e.length,appliedCount:0,savedFiles:[],rows:t}}function De(e){if(e.kind!=="fileRename")return v(e,"FILE_MUTATION_KIND_UNSUPPORTED",`Unsupported file mutation kind: ${e.kind}`);if(!_.existsSync(e.sourceFile))return v(e,"FILE_RENAME_SOURCE_NOT_FOUND","Source file does not exist.");try{if(!_.statSync(e.sourceFile).isFile())return v(e,"FILE_RENAME_SOURCE_DIRECTORY_UNSUPPORTED","file rename v1 supports files only, not directories.")}catch(t){return v(e,"FILE_RENAME_SOURCE_STAT_FAILED",t instanceof Error?t.message:String(t))}return _.existsSync(e.targetFile)?v(e,"FILE_RENAME_TARGET_EXISTS","Target file already exists.","Pick another target directory/name or remove the target collision."):$e(e.sourceFile)?v(e,"FILE_RENAME_SOURCE_ASSET_UNSUPPORTED","CSS/SCSS files cannot be renamed with file rename v1."):_.existsSync(e.targetDir)?{id:e.id,ok:!0,sourceFile:e.sourceFile,targetFile:e.targetFile,applied:!1}:v(e,"FILE_RENAME_TARGET_DIR_NOT_FOUND","Target parent directory does not exist.")}function v(e,t,n,r){return{id:e.id,ok:!1,sourceFile:e.sourceFile,targetFile:e.targetFile,applied:!1,code:t,error:n,...r?{hint:r}:{}}}function $e(e){return[".css",".scss"].includes(f.extname(e).toLowerCase())}function ke(e){return e.map(t=>({source:t.sourceFile,target:t.targetFile}))}function Pe(e,t,n){const r=n.trim();if(f.isAbsolute(r))return f.normalize(r);const o=f.normalize(f.resolve(t,r));if(_.existsSync(o))return o;const i=f.normalize(f.resolve(e,r));return _.existsSync(i)?i:o}function Te(e,t,n,r){const o=r.trim();return f.isAbsolute(o)?f.normalize(o):o.includes("/")||o.includes("\\")?f.normalize(f.resolve(t,o)):f.normalize(f.resolve(f.dirname(n),o))}function Le(e,t){const n=f.normalize(f.isAbsolute(t)?t:f.resolve(e,t));return V(e,n,"FILE_RENAME_PATH_OUTSIDE_CWD"),n}function V(e,t,n){const r=f.resolve(e),o=f.relative(r,t);if(!(o===""||!o.startsWith("..")&&!f.isAbsolute(o)))throw new S.CliError(n,"File move paths must stay inside the current workspace.",{cwd:r,filePath:t})}function se(e,t,n,r,o,i){const s=Array.isArray(t.rows)?t.rows.filter(h).map(R=>ae(e,R)):[],l=t.ok!==!1&&s.every(R=>R.ok!==!1),a=He(s,"target"),u=Ye(e,D(t.savedFiles)).map(R=>g(e,R)),d=r==="apply"?"file.rename.apply":n.execute?"file.rename.execute":"file.rename.preview";return J({...l?{}:{ok:!1},operation:d,executionId:i??null,base:g(e,n.baseDir),operationCount:n.operations.length,summary:l?n.execute?`${n.operations.length} ${k(n.operations.length,"file","files")} renamed, ${u.length} ${k(u.length,"file","files")} written`:`${n.operations.length} ${k(n.operations.length,"file","files")} ready`:Oe(s,n.operations.length,n.execute||r==="apply"),renames:Ne(e,n.operations),...n.execute||r==="apply"?{filesWritten:u,filesRenamed:a}:{},...h(t.postMutation)?{postMutation:t.postMutation}:{},rows:l?null:s,previewId:o??null})}function ae(e,t){return J({id:p(t.id),ok:t.ok!==!1,source:g(e,p(t.sourceFile)??""),target:g(e,p(t.targetFile)??""),applied:typeof t.applied=="boolean"?t.applied:null,rollback:p(t.rollback),savedFiles:Ze(D(t.savedFiles).map(n=>g(e,n)),5),code:p(t.code),error:p(t.error),hint:p(t.hint)})}function Ne(e,t){return t.map(n=>({source:g(e,n.sourceFile),target:g(e,n.targetFile)}))}function Oe(e,t,n){const r=e.filter(i=>i.ok===!1).length,o=Math.max(0,t-e.length);if(!n){const i=Math.min(t,e.length);return`${t} ${k(t,"file","files")}, validation blocked at row ${i}`}return`${t} ${k(t,"file","files")}, ${r} failed${o>0?`, ${o} not run`:""}`}function We(e,t){return t.map(n=>({source:g(e,n.sourceFile),target:g(e,n.targetFile),targetDir:g(e,n.targetDir)}))}function Ue(e){return Array.isArray(e.rows)?e.rows.filter(h):[]}function qe(e){const t=new Set(e.map(r=>r.targetDir));let n=0;for(const r of t)_.existsSync(r)||(n+=1);return{rowCount:e.length,targetDirCount:t.size,dirsToCreate:n}}function le(e){const t=e.find(n=>n.ok===!1);return t?p(t.code):null}function je(e,t){const n=new Set(t.rows.filter(o=>o.ok!==!1).map(o=>p(o.source)).filter(o=>!!o)),r=[];for(const o of t.plannedMoves)t.status!=="completed"&&!n.has(o.source)||r.push(`${o.source} -> ${o.target}`);if(r.length!==0){e.push("renames:");for(const o of r)e.push(o)}}function ze(e,t){if(t.notRunRows<=0)return;const n=new Set(t.rows.map(o=>p(o.source)).filter(o=>!!o)),r=t.plannedMoves.filter(o=>!n.has(o.source));if(r.length!==0){e.push("not run:");for(const o of r)e.push(o.source)}}function K(){return(0,Y.readMutationSyncWaitMs)(process.env[E.CLI_ENV.fileRenameSyncWaitMs],12e4)}function Be(){return{postProcessImports:(0,F.isFileMutationImportPostProcessEnabled)(),testFailRequiredImportUpdate:p(process.env[E.CLI_ENV.testFileRenameFailImports]),testRowDelayMs:(0,F.readFileMutationTestDelayMs)(process.env[E.CLI_ENV.testFileRenameRowDelayMs],6e4),testImportPostProcessDelayMs:(0,F.readFileMutationTestDelayMs)(process.env[E.CLI_ENV.testFileRenameImportsDelayMs],6e4),testPostMutationCyclesDelayMs:(0,F.readFileMutationTestDelayMs)(process.env[E.CLI_ENV.testPostMutationCyclesDelayMs],6e4)}}function Ve(){return(0,F.captureFileMutationBackgroundEnv)([E.CLI_ENV.testFileRenameDelayMs,E.CLI_ENV.testFileRenameRowDelayMs,E.CLI_ENV.testFileRenameImportsDelayMs,E.CLI_ENV.testFileRenameFailImports])}function G(e){const t=p(e.operation);if(!t?.startsWith("file.rename."))return null;const n=[],r=p(e.previewId),o=p(e.executionId);n.push(e.ok===!1?`${t} failed`:r&&t==="file.rename.preview"?`${t} ${r}`:o&&(t==="file.rename.apply"||t==="file.rename.execute")?`${t} ${o}`:t),typeof e.summary=="string"&&n.push(e.summary);const i=Array.isArray(e.renames)?e.renames.filter(h):[];if(i.length>0&&e.ok!==!1){n.push("renames:");for(const l of i){const a=p(l.source),u=p(l.target);a&&u&&n.push(`${a} -> ${u}`)}}Ke(n,e);const s=Array.isArray(e.filesWritten)?e.filesWritten:[];return s.length>0&&de(n,s,Array.isArray(e.filesRenamed)?e.filesRenamed:[]),h(e.postMutation)&&h(e.postMutation.cycles)&&he(n,e.postMutation.cycles),typeof e.next=="string"&&n.push(`next: ${e.next}`),n.join(`
-`)}function Ke(e,t){if(t.ok!==!1||!Array.isArray(t.rows))return;const n=t.rows.filter(h).find(r=>r.ok===!1);n&&(e.push("failed:"),e.push(`${p(n.source)??"source"} -> ${p(n.target)??"target"}`),e.push(`code: ${p(n.code)??"FILE_RENAME_FAILED"}`),typeof n.error=="string"&&e.push(n.error),typeof n.rollback=="string"&&e.push(`rollback: ${n.rollback}`),typeof n.hint=="string"&&e.push(`hint: ${n.hint}`))}function Ge(){return{ok:!0,command:"file rename",usage:"aib file rename preview --stdin | aib file rename execute --stdin | aib file rename apply <previewId>",dsl:["@base packages/agent-project-tooling/src","rename workspace-runner-cli.ts->cli.ts workspace-runner-command-hints.ts->command-hints.ts"],notes:["preview validates planned file renames without writing.","execute renames files and updates TypeScript imports.","apply uses the cached preview id and refuses stale source/target state."]}}function He(e,t){return e.map(n=>p(n[t])).filter(n=>!!n)}function D(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function Je(e){return Array.isArray(e)?e.filter(h):[]}function ce(e,t){const n=pe(e,t).filter(o=>_.existsSync(me(e,o)));if(n.length===0)return{op:"cycles",componentCount:0,components:[]};const r=["cycles"];for(const o of n)r.push("--files",o);return r.push("--detail","imports","--limit","50"),(0,X.runInspectCycles)(e,r,void 0)}function Qe(e,t,n){const r=new Set(ue(e).map(fe)),o=ue(t).filter(i=>$(i.files).some(s=>n.has(s))&&!r.has(fe(i)));return{status:o.length>0?"new-or-changed":"none",detail:"imports",newOrChangedCount:o.length,preComponentCount:H(e.componentCount),postComponentCount:H(t.componentCount),components:o}}function ue(e){return(Array.isArray(e.components)?e.components:[]).filter(h).map(t=>({kind:p(t.kind)??"mixed",files:$(t.files).sort(),chain:p(t.chain)??"",...h(t.cycle)?{cycle:t.cycle}:{},imports:Xe(t)}))}function Xe(e){const t=h(e.cycle)?e.cycle:{};return $(t.imports)}function fe(e){return`${p(e.kind)??"mixed"}:${$(e.files).sort().join("|")}`}function pe(e,t){return ye(t.map(n=>g(e,me(e,n))))}function me(e,t){return f.normalize(f.isAbsolute(t)?t:f.resolve(e,t))}function $(e){return D(e)}function Ye(e,t){return t.filter(n=>{const r=f.isAbsolute(n)?n:f.resolve(e,n);return _.existsSync(r)})}function Ze(e,t){const n=Array.from(new Set(e)).sort((i,s)=>i.localeCompare(s)),r=n.slice(0,t),o=n.length-r.length;return o>0?[...r,`+ ${o} more`]:r}function rt(e,t){const n=e.slice(0,t),r=e.length-n.length;return r>0?`${n.join(", ")}, + ${r} more`:n.join(", ")}function de(e,t,n){const r=t.filter(u=>typeof u=="string");if(r.length===0)return;const o=new Set(n.filter(u=>typeof u=="string")),i=r.filter(u=>o.has(u)),s=r.filter(u=>!o.has(u)),l=s.slice(0,8),a=s.length-l.length;e.push("filesWritten:");for(const u of[...i,...l])e.push(u);a>0&&e.push(`+ ${a} reference ${k(a,"file","files")}`)}function he(e,t){e.push("cycles:");const n=H(t.newOrChangedCount);if(n===0){e.push("no new/changed cycles involving touched files");return}const r=Array.isArray(t.components)?t.components.filter(h):[];e.push(et(n,r)),r.forEach((o,i)=>{(0,X.appendCycleComponentText)(e,o,{detail:"imports",prefix:r.length===1?"":`${i+1}. `,indent:r.length===1?"":"   "})})}function et(e,t){const n=t.map(i=>p(i.kind)??"mixed"),r=Array.from(new Set(n)),o=r.length===1?`${r[0]} `:"";return`${e} new/changed ${o}${e===1?"cycle":"cycles"} involving touched files`}function k(e,t,n){return e===1?t:n}function p(e){return typeof e=="string"&&e.length>0?e:null}function H(e){return typeof e=="number"&&Number.isFinite(e)?e:0}function J(e){return Object.fromEntries(Object.entries(e).filter(([,t])=>t==null?!1:!(Array.isArray(t)&&t.length===0)))}function h(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function tt(e){const t=f.normalize(e);return process.platform==="win32"?t.toLowerCase():t}function ye(e){return Array.from(new Set(e))}function z(){return new Promise(e=>setImmediate(e))}async function nt(e){e<=0||await new Promise(t=>setTimeout(t,e))}function g(e,t){return t?f.relative(e,t).replace(/\\/g,"/"):""}
+"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.runFileRename = runFileRename;
+exports.runFileRenameExecutionWorker = runFileRenameExecutionWorker;
+exports.readCachedFileRenameExecution = readCachedFileRenameExecution;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const zod_1 = require("zod");
+const env_vars_1 = require("../config/env-vars");
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const inspect_cycles_1 = require("./inspect-cycles");
+const mutation_eta_1 = require("./mutation-eta");
+const file_rename_preview_cache_1 = require("./file-rename-preview-cache");
+const file_rename_execution_cache_1 = require("./file-rename-execution-cache");
+const file_mutation_runtime_1 = require("./file-mutation-runtime");
+const mutation_execution_cache_1 = require("./mutation-execution-cache");
+const mutate_child_execution_1 = require("./mutate-child-execution");
+const file_mutation_worker_apply_1 = require("./file-mutation-worker-apply");
+const file_impact_scan_1 = require("../mutation/file-impact-scan");
+const runtime_lifecycle_1 = require("../session/runtime-lifecycle");
+const FileRenamePayloadSchema = zod_1.z.object({
+    base: zod_1.z.string().min(1),
+    renames: zod_1.z.array(zod_1.z.object({
+        source: zod_1.z.string().min(1),
+        target: zod_1.z.string().min(1)
+    })).min(1),
+    execute: zod_1.z.boolean().optional()
+});
+async function runFileRename(cwd, rawPayload, options = {}, restArgs = []) {
+    const runtimeOptions = readFileRenameRuntimeOptions();
+    const action = restArgs[0] ?? "preview";
+    if (action === "help" || action === "--help") {
+        return FileRenameHelp();
+    }
+    if (action === "apply") {
+        const previewId = restArgs[1];
+        if (!previewId || previewId.startsWith("--")) {
+            throw new errors_1.CliError("FILE_RENAME_PREVIEW_ID_REQUIRED", "file rename apply expects a preview id.", {
+                usage: "aib file rename apply <previewId>"
+            });
+        }
+        return applyFileRenamePreview(cwd, previewId, options, runtimeOptions);
+    }
+    if (action !== "preview" && action !== "execute" && action !== "validate") {
+        throw new errors_1.CliError("UNKNOWN_FILE_RENAME_COMMAND", `Unknown file rename command: ${action}`, {
+            availableCommands: ["preview", "apply", "execute", "validate", "help"]
+        });
+    }
+    const payload = FileRenamePayloadSchema.parse(rawPayload);
+    if (action === "execute" && readFileRenameSyncWaitMs() > 0) {
+        return runFileRenamePayloadWithExecution(cwd, {
+            ...payload,
+            execute: true
+        }, options, "execute", readFileRenameSyncWaitMs(), runtimeOptions);
+    }
+    return runFileRenamePayload(cwd, {
+        ...payload,
+        execute: action === "execute"
+    }, options, action, runtimeOptions);
+}
+async function applyFileRenamePreview(cwd, previewId, options, runtimeOptions) {
+    const record = (0, file_rename_preview_cache_1.readFileRenamePreviewRecord)(cwd, previewId);
+    (0, file_rename_preview_cache_1.validateFileMoveStates)(record);
+    const payload = FileRenamePayloadSchema.parse({
+        ...record.normalizedPayload,
+        execute: true
+    });
+    const syncWaitMs = readFileRenameSyncWaitMs();
+    if (syncWaitMs > 0) {
+        return runFileRenamePayloadWithExecution(cwd, payload, options, "apply", syncWaitMs, runtimeOptions, previewId);
+    }
+    const result = await runFileRenamePayload(cwd, payload, options, "apply", runtimeOptions, previewId);
+    return result.ok === false
+        ? (0, agent_text_1.attachAgentText)({ ...result, next: "Fix the file rename request and rerun preview." }, formatFileRenameAgentText({ ...result, next: "Fix the file rename request and rerun preview." }))
+        : result;
+}
+async function runFileRenamePayloadWithExecution(cwd, payload, options, action, syncWaitMs, runtimeOptions, previewIdFromApply) {
+    const normalized = normalizePayload(cwd, payload, true);
+    const executionId = (0, file_rename_execution_cache_1.buildFileRenameExecutionId)();
+    const operation = `file.rename.${action}`;
+    const etaEstimate = (0, file_mutation_runtime_1.estimateFileMutationEta)(buildFileMutationEtaInput(cwd, normalized.operations));
+    const estimatedDurationMs = etaEstimate.selectedMs;
+    const status = (0, file_rename_execution_cache_1.createFileRenameExecutionStatus)(cwd, executionId, operation, buildPlannedMoves(cwd, normalized.operations));
+    (0, file_rename_execution_cache_1.writeFileRenameExecutionStatus)(cwd, status);
+    const startedAtMs = Date.now();
+    const backgroundEnv = captureFileRenameBackgroundEnv();
+    const workerInputPath = writeFileRenameWorkerInput(cwd, executionId, {
+        schemaVersion: 1,
+        cwd,
+        payload,
+        normalized,
+        options: serializeResolveTargetInstanceOptions(options),
+        action,
+        runtimeOptions,
+        executionId,
+        status,
+        previewIdFromApply: previewIdFromApply ?? null
+    });
+    const workerPid = startFileRenameWorkerProcess(cwd, workerInputPath, backgroundEnv);
+    if (workerPid === null) {
+        return failFileRenameWorkerStart(cwd, status, "FILE_RENAME_WORKER_START_FAILED", "File rename worker did not publish a process id.");
+    }
+    const publicationFailure = await (0, mutate_child_execution_1.awaitFileMutationWorkerPublication)({
+        cwd,
+        executionId,
+        kind: "file.rename",
+        operation,
+        workerPid
+    });
+    if (publicationFailure) {
+        return publicationFailure;
+    }
+    const result = await waitForFileRenameWorkerResult(cwd, executionId, syncWaitMs);
+    if (result) {
+        return result;
+    }
+    const finalStatus = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, executionId);
+    if (finalStatus && finalStatus.status !== "running") {
+        return isObject(finalStatus.result)
+            ? finalStatus.result
+            : readCachedFileRenameExecution(cwd, executionId);
+    }
+    return buildFileRenameStillRunningResponse(cwd, executionId, operation, workerPid, estimatedDurationMs, Date.now() - startedAtMs, etaEstimate);
+}
+async function runFileRenameExecutionWorker(input) {
+    const status = input.status;
+    status.workerPid = process.pid;
+    (0, file_rename_execution_cache_1.writeFileRenameExecutionStatus)(input.cwd, status);
+    try {
+        const result = await executeFileRenameOperations(input.cwd, input.normalized, input.action, input.options, input.runtimeOptions, input.executionId, status, input.previewIdFromApply ?? undefined);
+        const rows = readFileRenameRows(result);
+        status.status = result.ok === false ? "failed" : "completed";
+        status.phase = "completed";
+        status.completedRows = result.ok === false ? rows.filter((row) => row.ok !== false).length : status.rowCount;
+        status.failedRows = result.ok === false ? rows.filter((row) => row.ok === false).length : 0;
+        status.notRunRows = result.ok === false ? Math.max(0, status.rowCount - rows.length) : 0;
+        status.filesWritten = readStringArray(result.filesWritten);
+        status.touchedFiles = readStringArray(result.touchedFiles);
+        status.moves = Array.isArray(result.renames) ? result.renames.filter(isObject) : [];
+        status.rows = rows;
+        if (isObject(result.postMutation)) {
+            status.postMutation = result.postMutation;
+        }
+        status.result = result;
+        if (result.ok === false) {
+            status.error = readString(result.code) ?? readFirstFailedCode(rows) ?? "FILE_RENAME_FAILED";
+        }
+        (0, file_rename_execution_cache_1.writeFileRenameExecutionStatus)(input.cwd, status);
+        return result;
+    }
+    catch (error) {
+        status.status = "failed";
+        status.phase = "completed";
+        status.failedRows = Math.max(1, status.failedRows);
+        status.notRunRows = Math.max(0, status.rowCount - status.completedRows - status.failedRows);
+        status.error = error instanceof Error ? error.message : String(error);
+        (0, file_rename_execution_cache_1.writeFileRenameExecutionStatus)(input.cwd, status);
+        throw error;
+    }
+}
+function writeFileRenameWorkerInput(cwd, executionId, input) {
+    const filePath = path.join(fileRenameWorkerDir(cwd, executionId), "worker-input.json");
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tmpPath, `${JSON.stringify(input, null, 2)}\n`);
+    fs.renameSync(tmpPath, filePath);
+    return filePath;
+}
+function fileRenameWorkerDir(cwd, executionId) {
+    return path.join(cwd, ".tmp", "aib-file-rename-workers", executionId.replace(/[^a-z0-9_-]+/gi, "-"));
+}
+function startFileRenameWorkerProcess(cwd, inputPath, envPatch) {
+    const env = { ...process.env };
+    for (const [key, value] of Object.entries(envPatch)) {
+        if (value === undefined) {
+            delete env[key];
+        }
+        else {
+            env[key] = value;
+        }
+    }
+    const child = (0, node_child_process_1.spawn)(process.execPath, [path.join(__dirname, "file-rename-worker.js"), inputPath], {
+        cwd,
+        env,
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true
+    });
+    child.on("error", () => undefined);
+    (0, runtime_lifecycle_1.trackSessionOwnedProcess)(child, "file-rename-worker");
+    child.unref();
+    return child.pid ?? null;
+}
+async function waitForFileRenameWorkerResult(cwd, executionId, syncWaitMs) {
+    if (syncWaitMs <= 0) {
+        return null;
+    }
+    const deadline = Date.now() + syncWaitMs;
+    while (Date.now() < deadline) {
+        const status = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, executionId);
+        if (status && isFinalFileRenameWorkerStatus(status)) {
+            return isObject(status.result)
+                ? status.result
+                : readCachedFileRenameExecution(cwd, executionId);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    const finalStatus = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, executionId);
+    if (finalStatus && isFinalFileRenameWorkerStatus(finalStatus)) {
+        return isObject(finalStatus.result)
+            ? finalStatus.result
+            : readCachedFileRenameExecution(cwd, executionId);
+    }
+    return null;
+}
+function isFinalFileRenameWorkerStatus(status) {
+    return isObject(status.result) || status.phase === "completed";
+}
+function serializeResolveTargetInstanceOptions(options) {
+    return {
+        ...(options.metricsEnabled !== undefined ? { metricsEnabled: options.metricsEnabled } : {}),
+        ...(options.importRules ? { importRules: options.importRules } : {}),
+        ...(options.mutationComments ? { mutationComments: options.mutationComments } : {})
+    };
+}
+async function runFileRenamePayload(cwd, payload, options, action, runtimeOptions, previewIdFromApply, executionId, normalizedFromExecution) {
+    await (0, file_mutation_runtime_1.maybeDelayFileMutationForTest)(process.env[env_vars_1.CLI_ENV.testFileRenameDelayMs]);
+    const normalized = normalizedFromExecution ?? normalizePayload(cwd, payload, action === "execute" || action === "apply");
+    const result = normalized.execute
+        ? await executeFileRenameOperations(cwd, normalized, action === "apply" ? "apply" : "execute", options, runtimeOptions, executionId, undefined, previewIdFromApply)
+        : buildLocalFileRenamePreviewResult(normalized.operations);
+    const response = compactFileRenameResponse(cwd, result, normalized, action, previewIdFromApply, executionId);
+    if ((action === "preview" || action === "validate") && response.ok !== false) {
+        const previewId = (0, file_rename_preview_cache_1.buildFileRenamePreviewId)(normalized.normalizedPayload);
+        const states = (0, file_rename_preview_cache_1.readFileMoveStates)(normalized.operations);
+        const previewHash = (0, file_rename_preview_cache_1.buildFileRenamePreviewHash)(normalized.normalizedPayload, states, response);
+        (0, file_rename_preview_cache_1.writeFileRenamePreviewRecord)(cwd, {
+            previewId,
+            previewHash,
+            createdAt: new Date().toISOString(),
+            cwd: path.resolve(cwd),
+            normalizedPayload: normalized.normalizedPayload,
+            states,
+            previewResult: response
+        });
+        response.previewId = previewId;
+        response.next = `aib file rename apply ${previewId}`;
+    }
+    return (0, agent_text_1.attachAgentText)(response, formatFileRenameAgentText(response));
+}
+async function executeFileRenameOperations(cwd, normalized, action, options, runtimeOptions, executionId, status, previewIdFromApply) {
+    const rawRows = [];
+    const filesWritten = new Set();
+    const touchedFiles = new Set();
+    const importSnapshotBefore = [];
+    const preMutationCycles = runPostMutationCyclesSnapshot(cwd, normalized.operations.map((operation) => operation.sourceFile));
+    let cleanup = [];
+    let postMutation = null;
+    for (const operation of normalized.operations) {
+        if (status) {
+            status.phase = "movingFile";
+            status.status = "running";
+            persistFileRenameExecutionProgress(cwd, status, rawRows, filesWritten, touchedFiles);
+            await yieldToEventLoop();
+        }
+        const rowResult = await (0, file_mutation_worker_apply_1.executeWorkerOwnedFileMutationRow)(cwd, operation, options, runtimeOptions);
+        const row = Array.isArray(rowResult.rows) && isObject(rowResult.rows[0])
+            ? rowResult.rows[0]
+            : localFailureRow(operation, "FILE_RENAME_FAILED", "Extension did not return a file rename row.");
+        rawRows.push(row);
+        for (const savedFile of collectStringArray(row.savedFiles)) {
+            filesWritten.add(path.normalize(savedFile));
+        }
+        for (const touchedFile of collectStringArray(row.touchedFiles)) {
+            touchedFiles.add(path.normalize(touchedFile));
+        }
+        for (const snapshot of collectImportSnapshots(row.importSnapshotBefore)) {
+            importSnapshotBefore.push(snapshot);
+        }
+        for (const cleanupRow of collectImportSnapshots(row.cleanup)) {
+            cleanup.push(cleanupRow);
+        }
+        if (status) {
+            persistFileRenameExecutionProgress(cwd, status, rawRows, filesWritten, touchedFiles);
+            await yieldToEventLoop();
+        }
+        if (row.ok === false) {
+            break;
+        }
+        await (0, file_mutation_runtime_1.delayFileMutationForTest)(runtimeOptions.testRowDelayMs);
+    }
+    const rowsOk = rawRows.every((row) => row.ok !== false) && rawRows.length === normalized.operations.length;
+    const cleanupOk = cleanup.every((row) => row.ok !== false);
+    if (rowsOk && cleanupOk) {
+        if (status) {
+            status.phase = "postMutation.cycles";
+            persistFileRenameExecutionProgress(cwd, status, rawRows, filesWritten, touchedFiles);
+            await yieldToEventLoop();
+        }
+        await maybeDelayPostMutationCycles(runtimeOptions.testPostMutationCyclesDelayMs);
+        const postMutationFocusFiles = uniqueStrings([...Array.from(touchedFiles), ...Array.from(filesWritten)]);
+        const postMutationCycles = runPostMutationCyclesSnapshot(cwd, postMutationFocusFiles);
+        postMutation = {
+            cycles: diffPostMutationCycles(preMutationCycles, postMutationCycles, new Set(formatCycleFocusFiles(cwd, postMutationFocusFiles)))
+        };
+    }
+    const rawResult = compactObject({
+        ...(!rowsOk || !cleanupOk ? { ok: false } : {}),
+        operation: "fileMutation",
+        execute: true,
+        rowCount: normalized.operations.length,
+        appliedCount: rawRows.filter((row) => row.applied === true).length,
+        savedFiles: Array.from(filesWritten),
+        touchedFiles: Array.from(touchedFiles),
+        cleanup,
+        rows: rawRows,
+        postMutation
+    });
+    const response = compactFileRenameResponse(cwd, rawResult, normalized, action, previewIdFromApply, executionId);
+    return (0, agent_text_1.attachAgentText)(response, formatFileRenameAgentText(response));
+}
+function persistFileRenameExecutionProgress(cwd, status, rawRows, filesWritten, touchedFiles) {
+    const compactRows = rawRows.map((row) => compactRow(cwd, row));
+    status.rows = compactRows;
+    status.completedRows = compactRows.filter((row) => row.ok !== false).length;
+    status.failedRows = compactRows.filter((row) => row.ok === false).length;
+    status.notRunRows = status.failedRows > 0 ? Math.max(0, status.rowCount - compactRows.length) : 0;
+    status.filesWritten = Array.from(filesWritten).sort((left, right) => left.localeCompare(right)).map((file) => formatRelativePath(cwd, file));
+    status.touchedFiles = Array.from(touchedFiles).sort((left, right) => left.localeCompare(right)).map((file) => formatRelativePath(cwd, file));
+    if (status.failedRows > 0) {
+        status.status = "failed";
+        status.error = readFirstFailedCode(compactRows) ?? "FILE_RENAME_FAILED";
+    }
+    (0, file_rename_execution_cache_1.writeFileRenameExecutionStatus)(cwd, status);
+}
+function readCachedFileRenameExecution(cwd, executionId) {
+    const status = (0, file_rename_execution_cache_1.readFileRenameExecutionStatus)(cwd, executionId);
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        status: status.status,
+        phase: status.phase,
+        summary: buildFileRenameExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        filesWritten: status.filesWritten,
+        touchedFiles: status.touchedFiles,
+        ...(status.postMutation ? { postMutation: status.postMutation } : {}),
+        updatedAt: status.updatedAt,
+        ...(status.error ? { error: status.error } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatFileRenameExecutionStatusText(status));
+}
+function buildFileRenameStillRunningResponse(cwd, executionId, operation, workerPid, estimatedDurationMs, elapsedMs, estimate = null) {
+    const status = (0, file_rename_execution_cache_1.readFileRenameExecutionStatus)(cwd, executionId);
+    const estimatedRemainingMs = Math.max(0, estimatedDurationMs - elapsedMs);
+    const eta = (0, mutation_eta_1.buildMutationEtaHint)(status.executionId, estimatedRemainingMs);
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        childExecutionKind: "file.rename",
+        childOperation: operation,
+        childCacheNamespace: file_rename_execution_cache_1.FILE_RENAME_EXECUTION_NAMESPACE,
+        childWorkerPid: workerPid,
+        status: status.status,
+        phase: status.phase,
+        summary: buildFileRenameExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        filesWritten: status.filesWritten,
+        touchedFiles: status.touchedFiles,
+        ...(status.postMutation ? { postMutation: status.postMutation } : {}),
+        updatedAt: status.updatedAt,
+        ...(estimate ? { eta: estimate } : {}),
+        estimatedRemainingMs: eta.estimatedRemainingMs,
+        suggestedFirstCheckMs: eta.suggestedFirstCheckMs,
+        next: eta.next
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatFileRenameStillRunningText(operation, status, eta));
+}
+function failFileRenameWorkerStart(cwd, status, code, error) {
+    const result = {
+        ok: false,
+        operation: status.operation,
+        executionId: status.executionId,
+        code,
+        error,
+        filesWritten: [],
+        filesTouched: []
+    };
+    status.status = "failed";
+    status.phase = "completed";
+    status.failedRows = Math.max(1, status.failedRows);
+    status.notRunRows = Math.max(0, status.rowCount - status.completedRows - status.failedRows);
+    status.error = code;
+    status.result = result;
+    (0, file_rename_execution_cache_1.writeFileRenameExecutionStatus)(cwd, status);
+    return result;
+}
+function formatFileRenameStillRunningText(operation, status, eta) {
+    return [
+        `${operation} ${status.executionId}`,
+        buildFileRenameExecutionSummary(status),
+        formatFileRenamePhaseLine(status),
+        ...(0, mutation_eta_1.formatMutationEtaLines)(eta)
+    ].join("\n");
+}
+function formatFileRenameExecutionStatusText(status) {
+    const lines = [
+        buildFileRenameExecutionSummary(status)
+    ];
+    if (status.status === "running") {
+        lines.push(formatFileRenamePhaseLine(status));
+        return lines.join("\n");
+    }
+    appendExecutionRenameLines(lines, status);
+    const failedRows = status.rows.filter((row) => row.ok === false);
+    const firstFailed = failedRows[0];
+    if (firstFailed) {
+        const code = readString(firstFailed.code) ?? status.error ?? "FILE_RENAME_FAILED";
+        lines.push(`code: ${code}`);
+        if (typeof firstFailed.error === "string") {
+            lines.push(firstFailed.error);
+        }
+        if (typeof firstFailed.rollback === "string") {
+            lines.push(`rollback: ${firstFailed.rollback}`);
+        }
+        if (typeof firstFailed.hint === "string") {
+            lines.push(`hint: ${firstFailed.hint}`);
+        }
+        lines.push("failed:");
+        for (const row of failedRows) {
+            lines.push(`${readString(row.source) ?? "source"} -> ${readString(row.target) ?? "target"}`);
+        }
+    }
+    else if (status.error) {
+        lines.push(status.error);
+    }
+    appendExecutionNotRunLines(lines, status);
+    if (status.filesWritten.length > 0) {
+        appendFilesWrittenLines(lines, status.filesWritten, status.plannedMoves.map((move) => move.target));
+    }
+    if (isObject(status.postMutation) && isObject(status.postMutation.cycles)) {
+        appendPostMutationCyclesText(lines, status.postMutation.cycles);
+    }
+    if (status.status === "failed") {
+        lines.push("next: Fix failed rename row and rerun file.rename preview.");
+    }
+    return lines.join("\n");
+}
+function formatFileRenamePhaseLine(status) {
+    if (status.phase === "postProcessImports") {
+        return "updating imports";
+    }
+    if (status.phase === "postMutation.cycles") {
+        return "checking cycles";
+    }
+    return "renaming files";
+}
+function buildFileRenameExecutionSummary(status) {
+    const percent = Math.floor((Math.max(0, status.completedRows) / Math.max(1, status.rowCount)) * 100);
+    if (status.status === "completed") {
+        return `completed, ${status.completedRows}/${status.rowCount} rows, ${percent}% files, ${status.filesWritten.length} files written`;
+    }
+    if (status.status === "failed") {
+        const parts = [
+            `failed, ${status.completedRows}/${status.rowCount} rows, ${percent}% files`,
+            `${status.failedRows} failed`
+        ];
+        if (status.notRunRows > 0) {
+            parts.push(`${status.notRunRows} not run`);
+        }
+        parts.push(`${status.filesWritten.length} files written`);
+        return parts.join(", ");
+    }
+    return `in progress, ${status.completedRows}/${status.rowCount} rows, ${percent}% files`;
+}
+function normalizePayload(cwd, payload, execute) {
+    const baseDir = resolveInsideCwd(cwd, payload.base);
+    const operations = [];
+    const seenTargets = new Set();
+    for (const rename of payload.renames) {
+        const sourceFile = resolveSourceFile(cwd, baseDir, rename.source);
+        assertInsideCwd(cwd, sourceFile, "FILE_RENAME_SOURCE_OUTSIDE_CWD");
+        const targetFile = resolveRenameTargetFile(cwd, baseDir, sourceFile, rename.target);
+        assertInsideCwd(cwd, targetFile, "FILE_RENAME_TARGET_OUTSIDE_CWD");
+        const targetKey = normalizeKey(targetFile);
+        if (seenTargets.has(targetKey)) {
+            throw new errors_1.CliError("FILE_RENAME_DUPLICATE_TARGET", "Several file renames resolve to the same target.", {
+                targetFile: formatRelativePath(cwd, targetFile)
+            });
+        }
+        seenTargets.add(targetKey);
+        operations.push({
+            id: `rename-${operations.length + 1}`,
+            kind: "fileRename",
+            sourceFile,
+            targetDir: path.dirname(targetFile),
+            targetFile,
+            execute
+        });
+    }
+    if (operations.length === 0) {
+        throw new errors_1.CliError("FILE_RENAME_ROWS_REQUIRED", "file rename expects at least one rename pair.");
+    }
+    return {
+        execute,
+        baseDir,
+        operations,
+        normalizedPayload: {
+            base: baseDir,
+            renames: normalizedPayloadRenames(operations),
+            execute
+        }
+    };
+}
+function buildLocalFileRenamePreviewResult(operations) {
+    const rows = [];
+    for (const operation of operations) {
+        if (rows.some((row) => row.ok === false)) {
+            break;
+        }
+        rows.push(validateLocalMoveOperation(operation));
+    }
+    const ok = rows.every((row) => row.ok !== false) && rows.length === operations.length;
+    return {
+        ...(ok ? {} : { ok: false }),
+        operation: "fileMutation",
+        execute: false,
+        rowCount: operations.length,
+        appliedCount: 0,
+        savedFiles: [],
+        rows
+    };
+}
+function validateLocalMoveOperation(operation) {
+    if (operation.kind !== "fileRename") {
+        return localFailureRow(operation, "FILE_MUTATION_KIND_UNSUPPORTED", `Unsupported file mutation kind: ${operation.kind}`);
+    }
+    if (!fs.existsSync(operation.sourceFile)) {
+        return localFailureRow(operation, "FILE_RENAME_SOURCE_NOT_FOUND", "Source file does not exist.");
+    }
+    try {
+        const stat = fs.statSync(operation.sourceFile);
+        if (!stat.isFile()) {
+            return localFailureRow(operation, "FILE_RENAME_SOURCE_DIRECTORY_UNSUPPORTED", "file rename v1 supports files only, not directories.");
+        }
+    }
+    catch (error) {
+        return localFailureRow(operation, "FILE_RENAME_SOURCE_STAT_FAILED", error instanceof Error ? error.message : String(error));
+    }
+    if (fs.existsSync(operation.targetFile)) {
+        return localFailureRow(operation, "FILE_RENAME_TARGET_EXISTS", "Target file already exists.", "Pick another target directory/name or remove the target collision.");
+    }
+    if (isCssLikeAsset(operation.sourceFile)) {
+        return localFailureRow(operation, "FILE_RENAME_SOURCE_ASSET_UNSUPPORTED", "CSS/SCSS files cannot be renamed with file rename v1.");
+    }
+    if (!fs.existsSync(operation.targetDir)) {
+        return localFailureRow(operation, "FILE_RENAME_TARGET_DIR_NOT_FOUND", "Target parent directory does not exist.");
+    }
+    return {
+        id: operation.id,
+        ok: true,
+        sourceFile: operation.sourceFile,
+        targetFile: operation.targetFile,
+        applied: false
+    };
+}
+function localFailureRow(operation, code, error, hint) {
+    return {
+        id: operation.id,
+        ok: false,
+        sourceFile: operation.sourceFile,
+        targetFile: operation.targetFile,
+        applied: false,
+        code,
+        error,
+        ...(hint ? { hint } : {})
+    };
+}
+function isCssLikeAsset(filePath) {
+    return [".css", ".scss"].includes(path.extname(filePath).toLowerCase());
+}
+function normalizedPayloadRenames(operations) {
+    return operations.map((operation) => ({
+        source: operation.sourceFile,
+        target: operation.targetFile
+    }));
+}
+function resolveSourceFile(cwd, baseDir, rawPath) {
+    const trimmed = rawPath.trim();
+    if (path.isAbsolute(trimmed)) {
+        return path.normalize(trimmed);
+    }
+    const baseRelative = path.normalize(path.resolve(baseDir, trimmed));
+    if (fs.existsSync(baseRelative)) {
+        return baseRelative;
+    }
+    const cwdRelative = path.normalize(path.resolve(cwd, trimmed));
+    if (fs.existsSync(cwdRelative)) {
+        return cwdRelative;
+    }
+    return baseRelative;
+}
+function resolveRenameTargetFile(cwd, baseDir, sourceFile, rawTarget) {
+    const trimmed = rawTarget.trim();
+    if (path.isAbsolute(trimmed)) {
+        return path.normalize(trimmed);
+    }
+    if (trimmed.includes("/") || trimmed.includes("\\")) {
+        return path.normalize(path.resolve(baseDir, trimmed));
+    }
+    return path.normalize(path.resolve(path.dirname(sourceFile), trimmed));
+}
+function resolveInsideCwd(cwd, rawPath) {
+    const resolved = path.normalize(path.isAbsolute(rawPath) ? rawPath : path.resolve(cwd, rawPath));
+    assertInsideCwd(cwd, resolved, "FILE_RENAME_PATH_OUTSIDE_CWD");
+    return resolved;
+}
+function assertInsideCwd(cwd, filePath, code) {
+    const root = path.resolve(cwd);
+    const relative = path.relative(root, filePath);
+    if (relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative))) {
+        return;
+    }
+    throw new errors_1.CliError(code, "File move paths must stay inside the current workspace.", {
+        cwd: root,
+        filePath
+    });
+}
+function compactFileRenameResponse(cwd, raw, normalized, action, previewIdFromApply, executionId) {
+    const rows = Array.isArray(raw.rows)
+        ? raw.rows.filter(isObject).map((row) => compactRow(cwd, row))
+        : [];
+    const ok = raw.ok !== false && rows.every((row) => row.ok !== false);
+    const renamedFiles = collectRows(rows, "target");
+    const filesWritten = collectExistingFiles(cwd, collectStringArray(raw.savedFiles)).map((file) => formatRelativePath(cwd, file));
+    const operation = action === "apply"
+        ? "file.rename.apply"
+        : normalized.execute
+            ? "file.rename.execute"
+            : "file.rename.preview";
+    const response = compactObject({
+        ...(ok ? {} : { ok: false }),
+        operation,
+        executionId: executionId ?? null,
+        base: formatRelativePath(cwd, normalized.baseDir),
+        operationCount: normalized.operations.length,
+        summary: ok
+            ? normalized.execute
+                ? `${normalized.operations.length} ${plural(normalized.operations.length, "file", "files")} renamed, ${filesWritten.length} ${plural(filesWritten.length, "file", "files")} written`
+                : `${normalized.operations.length} ${plural(normalized.operations.length, "file", "files")} ready`
+            : buildFailureSummary(rows, normalized.operations.length, normalized.execute || action === "apply"),
+        renames: formatRenamePairs(cwd, normalized.operations),
+        ...(normalized.execute || action === "apply" ? { filesWritten, filesRenamed: renamedFiles } : {}),
+        ...(isObject(raw.postMutation) ? { postMutation: raw.postMutation } : {}),
+        rows: ok ? null : rows,
+        previewId: previewIdFromApply ?? null
+    });
+    return response;
+}
+function compactRow(cwd, row) {
+    return compactObject({
+        id: readString(row.id),
+        ok: row.ok !== false,
+        source: formatRelativePath(cwd, readString(row.sourceFile) ?? ""),
+        target: formatRelativePath(cwd, readString(row.targetFile) ?? ""),
+        applied: typeof row.applied === "boolean" ? row.applied : null,
+        rollback: readString(row.rollback),
+        savedFiles: compactList(collectStringArray(row.savedFiles).map((file) => formatRelativePath(cwd, file)), 5),
+        code: readString(row.code),
+        error: readString(row.error),
+        hint: readString(row.hint)
+    });
+}
+function formatRenamePairs(cwd, operations) {
+    return operations.map((operation) => ({
+        source: formatRelativePath(cwd, operation.sourceFile),
+        target: formatRelativePath(cwd, operation.targetFile)
+    }));
+}
+function buildFailureSummary(rows, total, executed) {
+    const failed = rows.filter((row) => row.ok === false).length;
+    const notRun = Math.max(0, total - rows.length);
+    if (!executed) {
+        const checked = Math.min(total, rows.length);
+        return `${total} ${plural(total, "file", "files")}, validation blocked at row ${checked}`;
+    }
+    return `${total} ${plural(total, "file", "files")}, ${failed} failed${notRun > 0 ? `, ${notRun} not run` : ""}`;
+}
+function buildPlannedMoves(cwd, operations) {
+    return operations.map((operation) => ({
+        source: formatRelativePath(cwd, operation.sourceFile),
+        target: formatRelativePath(cwd, operation.targetFile),
+        targetDir: formatRelativePath(cwd, operation.targetDir)
+    }));
+}
+function readFileRenameRows(result) {
+    return Array.isArray(result.rows) ? result.rows.filter(isObject) : [];
+}
+function buildFileMutationEtaInput(cwd, operations) {
+    const targetDirs = new Set(operations.map((operation) => operation.targetDir));
+    let dirsToCreate = 0;
+    for (const targetDir of targetDirs) {
+        if (!fs.existsSync(targetDir)) {
+            dirsToCreate += 1;
+        }
+    }
+    const impact = (0, file_impact_scan_1.estimateFileMutationImpact)(cwd, operations.map((operation) => operation.sourceFile));
+    return {
+        rowCount: operations.length,
+        targetDirCount: targetDirs.size,
+        dirsToCreate,
+        importingFileCount: impact.importingFileCount,
+        importStatementCount: impact.importStatementCount,
+        barrelExportCount: impact.barrelExportCount,
+        sourceFileCount: impact.sourceFileCount,
+        existingSourceFileCount: impact.existingSourceFileCount,
+        scanTruncated: impact.truncated
+    };
+}
+function readFirstFailedCode(rows) {
+    const failed = rows.find((row) => row.ok === false);
+    return failed ? readString(failed.code) : null;
+}
+function appendExecutionRenameLines(lines, status) {
+    const completedSources = new Set(status.rows.filter((row) => row.ok !== false).map((row) => readString(row.source)).filter((value) => Boolean(value)));
+    const pairs = [];
+    for (const move of status.plannedMoves) {
+        if (status.status !== "completed" && !completedSources.has(move.source)) {
+            continue;
+        }
+        pairs.push(`${move.source} -> ${move.target}`);
+    }
+    if (pairs.length === 0) {
+        return;
+    }
+    lines.push("renames:");
+    for (const pair of pairs) {
+        lines.push(pair);
+    }
+}
+function appendExecutionNotRunLines(lines, status) {
+    if (status.notRunRows <= 0) {
+        return;
+    }
+    const seenSources = new Set(status.rows.map((row) => readString(row.source)).filter((value) => Boolean(value)));
+    const notRun = status.plannedMoves.filter((move) => !seenSources.has(move.source));
+    if (notRun.length === 0) {
+        return;
+    }
+    lines.push("not run:");
+    for (const move of notRun) {
+        lines.push(move.source);
+    }
+}
+function readFileRenameSyncWaitMs() {
+    return (0, mutation_execution_cache_1.readMutationSyncWaitMs)(process.env[env_vars_1.CLI_ENV.fileRenameSyncWaitMs], 120_000);
+}
+function readFileRenameRuntimeOptions() {
+    return {
+        postProcessImports: (0, file_mutation_runtime_1.isFileMutationImportPostProcessEnabled)(),
+        testFailRequiredImportUpdate: readString(process.env[env_vars_1.CLI_ENV.testFileRenameFailImports]),
+        testRowDelayMs: (0, file_mutation_runtime_1.readFileMutationTestDelayMs)(process.env[env_vars_1.CLI_ENV.testFileRenameRowDelayMs], 60_000),
+        testImportPostProcessDelayMs: (0, file_mutation_runtime_1.readFileMutationTestDelayMs)(process.env[env_vars_1.CLI_ENV.testFileRenameImportsDelayMs], 60_000),
+        testPostMutationCyclesDelayMs: (0, file_mutation_runtime_1.readFileMutationTestDelayMs)(process.env[env_vars_1.CLI_ENV.testPostMutationCyclesDelayMs], 60_000)
+    };
+}
+function captureFileRenameBackgroundEnv() {
+    return (0, file_mutation_runtime_1.captureFileMutationBackgroundEnv)([
+        env_vars_1.CLI_ENV.testFileRenameDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameRowDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameFailImports
+    ]);
+}
+function formatFileRenameAgentText(response) {
+    const operation = readString(response.operation);
+    if (!operation?.startsWith("file.rename.")) {
+        return null;
+    }
+    const lines = [];
+    const previewId = readString(response.previewId);
+    const executionId = readString(response.executionId);
+    lines.push(response.ok === false
+        ? `${operation} failed`
+        : previewId && operation === "file.rename.preview"
+            ? `${operation} ${previewId}`
+            : executionId && (operation === "file.rename.apply" || operation === "file.rename.execute")
+                ? `${operation} ${executionId}`
+                : operation);
+    if (typeof response.summary === "string") {
+        lines.push(response.summary);
+    }
+    const renames = Array.isArray(response.renames) ? response.renames.filter(isObject) : [];
+    if (renames.length > 0 && response.ok !== false) {
+        lines.push("renames:");
+        for (const rename of renames) {
+            const source = readString(rename.source);
+            const target = readString(rename.target);
+            if (source && target) {
+                lines.push(`${source} -> ${target}`);
+            }
+        }
+    }
+    appendFailureLines(lines, response);
+    const filesWritten = Array.isArray(response.filesWritten) ? response.filesWritten : [];
+    if (filesWritten.length > 0) {
+        appendFilesWrittenLines(lines, filesWritten, Array.isArray(response.filesRenamed) ? response.filesRenamed : []);
+    }
+    if (isObject(response.postMutation) && isObject(response.postMutation.cycles)) {
+        appendPostMutationCyclesText(lines, response.postMutation.cycles);
+    }
+    if (typeof response.next === "string") {
+        lines.push(`next: ${response.next}`);
+    }
+    return lines.join("\n");
+}
+function appendFailureLines(lines, response) {
+    if (response.ok !== false || !Array.isArray(response.rows)) {
+        return;
+    }
+    const failed = response.rows.filter(isObject).find((row) => row.ok === false);
+    if (!failed) {
+        return;
+    }
+    lines.push("failed:");
+    lines.push(`${readString(failed.source) ?? "source"} -> ${readString(failed.target) ?? "target"}`);
+    lines.push(`code: ${readString(failed.code) ?? "FILE_RENAME_FAILED"}`);
+    if (typeof failed.error === "string") {
+        lines.push(failed.error);
+    }
+    if (typeof failed.rollback === "string") {
+        lines.push(`rollback: ${failed.rollback}`);
+    }
+    if (typeof failed.hint === "string") {
+        lines.push(`hint: ${failed.hint}`);
+    }
+}
+function FileRenameHelp() {
+    return {
+        ok: true,
+        command: "file rename",
+        usage: "aib file rename preview --stdin | aib file rename execute --stdin | aib file rename apply <previewId>",
+        dsl: [
+            "@base packages/agent-project-tooling/src",
+            "rename workspace-runner-cli.ts->cli.ts workspace-runner-command-hints.ts->command-hints.ts"
+        ],
+        notes: [
+            "preview validates planned file renames without writing.",
+            "execute renames files and updates TypeScript imports.",
+            "apply uses the cached preview id and refuses stale source/target state."
+        ]
+    };
+}
+function collectRows(rows, field) {
+    return rows.map((row) => readString(row[field])).filter((value) => Boolean(value));
+}
+function collectStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function collectImportSnapshots(value) {
+    return Array.isArray(value) ? value.filter(isObject) : [];
+}
+function runPostMutationCyclesSnapshot(cwd, files) {
+    const existingFiles = formatCycleFocusFiles(cwd, files).filter((file) => fs.existsSync(resolveCliFilePath(cwd, file)));
+    if (existingFiles.length === 0) {
+        return {
+            op: "cycles",
+            componentCount: 0,
+            components: []
+        };
+    }
+    const args = ["cycles"];
+    for (const file of existingFiles) {
+        args.push("--files", file);
+    }
+    args.push("--detail", "imports", "--limit", "50");
+    return (0, inspect_cycles_1.runInspectCycles)(cwd, args, undefined);
+}
+function diffPostMutationCycles(prePayload, postPayload, touchedFiles) {
+    const preKeys = new Set(readCycleComponents(prePayload).map(cycleComponentKey));
+    const newOrChanged = readCycleComponents(postPayload).filter((component) => readStringArray(component.files).some((file) => touchedFiles.has(file)) &&
+        !preKeys.has(cycleComponentKey(component)));
+    return {
+        status: newOrChanged.length > 0 ? "new-or-changed" : "none",
+        detail: "imports",
+        newOrChangedCount: newOrChanged.length,
+        preComponentCount: readNumber(prePayload.componentCount),
+        postComponentCount: readNumber(postPayload.componentCount),
+        components: newOrChanged
+    };
+}
+function readCycleComponents(payload) {
+    return (Array.isArray(payload.components) ? payload.components : [])
+        .filter(isObject)
+        .map((component) => ({
+        kind: readString(component.kind) ?? "mixed",
+        files: readStringArray(component.files).sort(),
+        chain: readString(component.chain) ?? "",
+        ...(isObject(component.cycle) ? { cycle: component.cycle } : {}),
+        imports: readCycleImports(component)
+    }));
+}
+function readCycleImports(component) {
+    const cycle = isObject(component.cycle) ? component.cycle : {};
+    return readStringArray(cycle.imports);
+}
+function cycleComponentKey(component) {
+    return `${readString(component.kind) ?? "mixed"}:${readStringArray(component.files).sort().join("|")}`;
+}
+function formatCycleFocusFiles(cwd, files) {
+    return uniqueStrings(files.map((file) => formatRelativePath(cwd, resolveCliFilePath(cwd, file))));
+}
+function resolveCliFilePath(cwd, file) {
+    return path.normalize(path.isAbsolute(file) ? file : path.resolve(cwd, file));
+}
+function readStringArray(value) {
+    return collectStringArray(value);
+}
+function collectExistingFiles(cwd, files) {
+    return files.filter((file) => {
+        const resolved = path.isAbsolute(file) ? file : path.resolve(cwd, file);
+        return fs.existsSync(resolved);
+    });
+}
+function compactList(items, limit) {
+    const unique = Array.from(new Set(items)).sort((left, right) => left.localeCompare(right));
+    const visible = unique.slice(0, limit);
+    const hidden = unique.length - visible.length;
+    return hidden > 0 ? [...visible, `+ ${hidden} more`] : visible;
+}
+function formatInlineList(values, limit) {
+    const visible = values.slice(0, limit);
+    const hidden = values.length - visible.length;
+    return hidden > 0 ? `${visible.join(", ")}, + ${hidden} more` : visible.join(", ");
+}
+function appendFilesWrittenLines(lines, values, movedTargets) {
+    const files = values.filter((value) => typeof value === "string");
+    if (files.length === 0) {
+        return;
+    }
+    const moved = new Set(movedTargets.filter((value) => typeof value === "string"));
+    const movedFiles = files.filter((file) => moved.has(file));
+    const referenceFiles = files.filter((file) => !moved.has(file));
+    const visibleReferenceFiles = referenceFiles.slice(0, 8);
+    const hiddenReferenceFiles = referenceFiles.length - visibleReferenceFiles.length;
+    lines.push("filesWritten:");
+    for (const file of [...movedFiles, ...visibleReferenceFiles]) {
+        lines.push(file);
+    }
+    if (hiddenReferenceFiles > 0) {
+        lines.push(`+ ${hiddenReferenceFiles} reference ${plural(hiddenReferenceFiles, "file", "files")}`);
+    }
+}
+function appendPostMutationCyclesText(lines, cycles) {
+    lines.push("cycles:");
+    const count = readNumber(cycles.newOrChangedCount);
+    if (count === 0) {
+        lines.push("no new/changed cycles involving touched files");
+        return;
+    }
+    const components = Array.isArray(cycles.components) ? cycles.components.filter(isObject) : [];
+    lines.push(formatPostMutationCycleSummary(count, components));
+    components.forEach((component, index) => {
+        (0, inspect_cycles_1.appendCycleComponentText)(lines, component, {
+            detail: "imports",
+            prefix: components.length === 1 ? "" : `${index + 1}. `,
+            indent: components.length === 1 ? "" : "   "
+        });
+    });
+}
+function formatPostMutationCycleSummary(count, components) {
+    const kinds = components.map((component) => readString(component.kind) ?? "mixed");
+    const uniqueKinds = Array.from(new Set(kinds));
+    const kindText = uniqueKinds.length === 1 ? `${uniqueKinds[0]} ` : "";
+    return `${count} new/changed ${kindText}${count === 1 ? "cycle" : "cycles"} involving touched files`;
+}
+function plural(count, one, many) {
+    return count === 1 ? one : many;
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function compactObject(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => {
+        if (value === null || value === undefined) {
+            return false;
+        }
+        return !(Array.isArray(value) && value.length === 0);
+    }));
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeKey(filePath) {
+    const normalized = path.normalize(filePath);
+    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values));
+}
+function yieldToEventLoop() {
+    return new Promise((resolve) => setImmediate(resolve));
+}
+async function maybeDelayPostMutationCycles(delayMs) {
+    if (delayMs <= 0) {
+        return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+function formatRelativePath(cwd, filePath) {
+    if (!filePath) {
+        return "";
+    }
+    return path.relative(cwd, filePath).replace(/\\/g, "/");
+}