@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/apply-module-plan.js

@@ -1,3 +1,1319 @@
-"use strict";var Oe=exports&&exports.__createBinding||(Object.create?(function(e,t,n,o){o===void 0&&(o=n);var r=Object.getOwnPropertyDescriptor(t,n);(!r||("get"in r?!t.__esModule:r.writable||r.configurable))&&(r={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,o,r)}):(function(e,t,n,o){o===void 0&&(o=n),e[o]=t[n]})),$e=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),re=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var o=[];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(o[o.length]=r);return o},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var o=e(t),r=0;r<o.length;r++)o[r]!=="default"&&Oe(n,t,o[r]);return $e(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runApplyModulePlan=qe,exports.reviseCachedModulePlan=Be,exports.readCachedModulePlanExecution=ze;const F=re(require("node:path")),O=re(require("node:fs")),E=require("zod"),ie=require("../client/http-client"),$=require("../shared/agent-text"),k=require("../shared/errors"),se=require("../shared/routes"),le=require("./session-workspace"),ae=require("./session-workspace"),D=require("./shared"),ue=require("../shared/protocol"),ce=require("./inspect-format"),De=require("./json-file-input"),Ue=require("./move-to-file"),d=require("./module-plan-cache"),fe=require("../metrics/central-metrics"),de=require("./module-plan-timeout"),me=require("./inspect-cycles"),_=require("../config/env-vars"),H=require("../config/product-storage"),R=require("../shared/event-loop"),h=require("../diagnostics/module-plan-timeline"),je=E.z.object({targetFile:E.z.string().min(1).optional(),target:E.z.string().min(1).optional(),file:E.z.string().min(1).optional(),symbols:E.z.array(E.z.union([E.z.string().min(1),E.z.object({}).passthrough()])).optional(),entities:E.z.array(E.z.union([E.z.string().min(1),E.z.object({}).passthrough()])).optional()}).passthrough(),We=E.z.object({sourceFile:E.z.string().min(1).optional(),file:E.z.string().min(1).optional(),facadeFile:E.z.string().min(1).optional(),facade:E.z.string().min(1).optional(),modules:E.z.array(je).optional(),execute:E.z.boolean().optional(),planId:E.z.string().min(1).optional()}).passthrough();async function qe(e,t,n,o={},r={}){const s=Te(t,"--plan"),i=Te(t,"--from-json");if(i&&n!==void 0)throw new k.CliError("APPLY_MODULE_PLAN_INPUT_SOURCE_CONFLICT","Use either modulePlan --stdin or modulePlan --from-json, not both.");const u=i?(0,De.readJsonObjectFile)(e,i,"INVALID_MODULE_PLAN_JSON_FILE"):n,f=t.includes("--execute")||Ct(u),c=u===void 0?{}:We.parse(u),m=typeof c.planId=="string"?c.planId:void 0,p=s??m;if(p&&u===void 0||f&&p)return J(e,p,o,"modulePlan.apply",r.executionId);if(f&&!p){(0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.enter",{hasExecutionId:!!r.executionId});const P=Ye();if(r.executionId&&P>0){const g=Me(e,r.executionId,"modulePlan.execute",c);g.phase="preview",I(e,g),(0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.pending.persisted",{rowCount:g.rowCount,entityCount:g.entityCount,syncWaitMs:P});const l=Date.now(),C=Ke();(0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.background.schedule");const w=Ve(()=>(0,H.runWithProductStorageOverride)(C[_.CLI_ENV.productStorageDir],()=>He(C,()=>((0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.background.start"),pe(e,c,o,r,g)))));(0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.wait.start",{syncWaitMs:P});const A=await Je(w,P);return A.status==="result"?((0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.wait.result"),A.result):(w.catch(()=>{}),(0,h.recordModulePlanTimeline)(e,r.executionId,"modulePlan.execute.wait.deadline",{elapsedMs:Date.now()-l}),Ge(e,r.executionId,"modulePlan.execute",Date.now()-l))}return pe(e,c,o,r)}return ye(e,c,o)}async function pe(e,t,n,o,r){const s=r??(o.executionId?Me(e,o.executionId,"modulePlan.execute",t):void 0);s&&((0,h.recordModulePlanTimeline)(e,s.executionId,"modulePlan.executePayload.start"),s.phase="preview",I(e,s),await(0,R.yieldToEventLoop)());let i;try{(0,h.recordModulePlanTimeline)(e,s?.executionId,"modulePlan.preview.start"),i=await ye(e,t,n,"modulePlan.execute-preview"),(0,h.recordModulePlanTimeline)(e,s?.executionId,"modulePlan.preview.end",{ok:i.ok!==!1,moduleCount:typeof i.moduleCount=="number"?i.moduleCount:null})}catch(u){throw s&&(s.status="failed",s.error=u instanceof Error?u.message:String(u),I(e,s)),u}return i.ok===!1||typeof i.planId!="string"?(s&&(s.status="failed",s.planId=typeof i.planId=="string"?i.planId:s.planId,s.error="modulePlan preview failed before execute.",I(e,s)),i):(s&&(s.planId=i.planId,s.phase="mutation",I(e,s),(0,h.recordModulePlanTimeline)(e,s.executionId,"modulePlan.mutation.phase.persisted",{planId:i.planId}),await(0,R.yieldToEventLoop)()),J(e,i.planId,n,"modulePlan.execute",o.executionId))}function Be(e,t){const n=(0,d.readModulePlanRecord)(e,t),o={operation:"modulePlan.revise",fromPlanId:t,planId:t,executable:n.executable!==!1,summary:n.executable===!1?"semantic module plan still has blocking move diagnostics":"semantic module plan already executable",changes:[],resolved:[],remainingBlocking:Et(n.previewResult),next:n.executable===!1?"Fix the plan manually, then rerun modulePlan preview.":`aib modulePlan apply ${t}`};return n.executable===!1&&(o.ok=!1,o.code="MODULE_PLAN_REVISE_NOT_APPLICABLE"),(0,$.attachAgentText)(o,z(o))}function ze(e,t){const n=(0,d.readModulePlanExecutionStatus)(e,t),o=n.rows,r=n.status==="failed"?Xe(e,n.planId,o.length):[],s=[...ge(o),...r],i={operation:"execution.status",executionId:n.executionId,planId:n.planId,status:n.status,summary:Y(n),progress:`${n.completedRows}/${n.rowCount}`,entityProgress:`${n.completedEntities??0}/${n.entityCount??0}`,filesWritten:X(n.filesWritten.map(u=>(0,d.formatRelativePath)(e,u)).sort((u,f)=>u.localeCompare(f))),rows:o,...s.length>0?{notRun:s}:{},...n.remainingSource?{remainingSource:n.remainingSource}:{},...n.phase?{phase:n.phase}:{},...n.postMutation?{postMutation:n.postMutation}:{},updatedAt:n.updatedAt,...n.error?{error:n.error}:{}};return(0,$.attachAgentText)(i,z(i))}function Ve(e){return new Promise((t,n)=>{setImmediate(()=>{e().then(t,n)})})}function Ke(){const e=[_.CLI_ENV.productStorageDir,_.CLI_ENV.trace,_.CLI_ENV.traceDir,_.CLI_ENV.metrics,_.CLI_ENV.metricsDir,_.CLI_ENV.metricsTag,_.CLI_ENV.mutationImpactMetrics,_.CLI_ENV.mutationImpactStream,_.CLI_ENV.testMoveToFileFailEntity,_.CLI_ENV.testPostMutationCyclesDelayMs,_.CLI_ENV.modulePlanDebugTimeline],t={};for(const n of e)t[n]=process.env[n];return t}async function He(e,t){const n={};for(const[o,r]of Object.entries(e))n[o]=process.env[o],r===void 0?delete process.env[o]:process.env[o]=r;try{return await t()}finally{for(const[o,r]of Object.entries(n))r===void 0?delete process.env[o]:process.env[o]=r}}async function Je(e,t){let n=null;try{return await Promise.race([e.then(o=>({status:"result",result:o})),new Promise(o=>{n=setTimeout(()=>o({status:"deadline"}),t)})])}finally{n&&clearTimeout(n)}}function Ye(){const e=process.env[_.CLI_ENV.modulePlanSyncWaitMs];if(e!==void 0){const t=Number.parseInt(e,10);return!Number.isFinite(t)||t<=0?0:Math.min(t,12e4)}return 12e4}function Ge(e,t,n,o){const r=(0,d.readModulePlanExecutionStatus)(e,t),s=y(r.timeoutHint)&&typeof r.timeoutHint.estimatedDurationMs=="number"?r.timeoutHint.estimatedDurationMs:null,i=s===null?null:Math.max(0,s-o),u={operation:"execution.status",executionId:r.executionId,planId:r.planId,status:r.status,...r.phase?{phase:r.phase}:{},summary:Y(r),progress:`${r.completedRows}/${r.rowCount}`,entityProgress:`${r.completedEntities??0}/${r.entityCount??0}`,expectEmpty:r.expectEmpty===!0,filesWritten:X(r.filesWritten.map(f=>(0,d.formatRelativePath)(e,f)).sort((f,c)=>f.localeCompare(c))),rows:r.rows,updatedAt:r.updatedAt,...i!==null?{estimatedRemainingMs:i}:{}};return(0,$.attachAgentText)(u,Qe(n,r,i))}function Qe(e,t,n){const o=[`${e} ${t.executionId}`,Y(t)];return t.phase==="preview"?o.push("previewing plan"):t.phase==="mutation"?o.push("applying mutation"):t.phase==="postMutation.cycles"&&(o.push("mutation completed"),o.push("checking cycles")),o.push(`status: aib execution status ${t.executionId}`),n!==null&&o.push(n>0?`estimated remaining: ${(0,de.formatModulePlanTimeoutEstimate)(Math.max(n,5e3))}`:"estimated remaining: check status again soon"),o.join(`
-`)}async function ye(e,t,n,o="modulePlan.preview"){(0,h.recordModulePlanTimeline)(e,void 0,"modulePlan.preview.resolveInstance.start",{operation:o});const r=await(0,D.resolveCompatibleTargetInstance)(e,ue.CLI_COMMAND_IDS.modulePlan,n);(0,h.recordModulePlanTimeline)(e,void 0,"modulePlan.preview.resolveInstance.end",{operation:o});const s=await(0,D.fetchEffectiveConfig)(r.entry,n),i=Se(e,t),u=ct(e,t,i,s),f=(0,d.buildModulePlanId)(u),c=await Ze(e,u,n,r),m=(0,d.hashFile)(i),p=(0,d.buildModulePlanHash)(u,m,c),P={planId:f,planHash:p,createdAt:new Date().toISOString(),cwd:F.resolve(e),sourceFile:i,sourceHash:m,executable:c.ok!==!1,normalizedRequest:u,inspectPayload:{requests:[u]},previewDir:"",previewResult:c};(0,d.writeModulePlanRecord)(e,P);const g={...c.ok===!1?{ok:!1,code:"MODULE_PLAN_BLOCKED"}:{},operation:o,planId:f,executable:c.ok!==!1,summary:Ie(c,!1),...typeof c.moduleCount=="number"?{moduleCount:c.moduleCount}:{},...Array.isArray(c.targets)?{targets:c.targets}:{},...Array.isArray(c.blocking)&&c.blocking.length>0?{blocking:c.blocking}:{},next:c.ok===!1?"Fix the plan, then rerun modulePlan preview.":`aib modulePlan apply ${f}`};return(0,$.attachAgentText)(g,z(g))}function Xe(e,t,n){if(t==="pending")return[];try{const o=(0,d.readModulePlanRecord)(e,t);return he(e,Q(o.normalizedRequest),n)}catch{return[]}}async function Ze(e,t,n,o){const r=Q(t),s=a(t.sourceFile)??"",i=await et(e,o,s,r,n);if(i)return i;const u=[],f=[],c=[];for(const m of r){await(0,R.yieldToEventLoop)();const p=a(m.targetFile)??"",P=U(m);(0,h.recordModulePlanTimeline)(e,void 0,"modulePlan.preview.row.start",{target:(0,d.formatRelativePath)(e,p),entityCount:P.length});const g=await Pe(e,s,p,P,m,!1,n);(0,h.recordModulePlanTimeline)(e,void 0,"modulePlan.preview.row.end",{target:(0,d.formatRelativePath)(e,p),ok:g.ok!==!1});const l=Ce("preview",e,s,p,P,g);if(f.push(l),u.push({file:(0,d.formatRelativePath)(e,p),entities:P,...typeof l.summary=="string"?{summary:l.summary}:{}}),l.ok===!1){c.push(l);break}await(0,R.yieldToEventLoop)()}return{op:"modulePlan",ok:c.length===0,sourceFile:s,moduleCount:r.length,targets:u,rows:f,...c.length>0?{blocking:c}:{},cycles:"notChecked"}}async function et(e,t,n,o,r){const s=await(0,ie.postJson)(t.entry,se.EXTENSION_ROUTES.inspect,{requests:[{op:"file",sourceFile:n,includeRanges:!1}]},(0,D.extensionRequestOptions)(r)),i=Array.isArray(s.results)?s.results.find(y):null,u=Array.isArray(i?.symbols)?i.symbols.filter(y):[];if(u.length===0)return null;const f=[],c=[],m=[];for(const p of o){const P=a(p.targetFile)??"",g=U(p),l={target:(0,d.formatRelativePath)(e,P),entities:g,ok:!0,summary:P&&!O.existsSync(P)?"target will be created":"target ready"};for(const C of tt(p)){const w=u.filter(A=>nt(A,C));if(w.length===0){l.ok=!1,l.entity=C.raw,l.code="MODULE_PLAN_SYMBOL_NOT_FOUND",l.error=`Symbol not found: ${C.raw}`,l.source=(0,d.formatRelativePath)(e,n);break}if(!C.symbolKind&&w.length>1){l.ok=!1,l.entity=C.raw,l.code="MODULE_PLAN_SYMBOL_AMBIGUOUS",l.error=`Ambiguous symbol: ${C.raw}`,l.available=w.map(A=>`${a(A.kind)??"symbol"}:${a(A.name)??C.symbolName}`),l.source=(0,d.formatRelativePath)(e,n);break}}if(f.push(W(l)),c.push({file:(0,d.formatRelativePath)(e,P),entities:g,...typeof l.summary=="string"?{summary:l.summary}:{}}),l.ok===!1){m.push(W(l));break}}return m.length===0?null:{op:"modulePlan",ok:!1,sourceFile:n,moduleCount:o.length,targets:c,rows:f,blocking:m,cycles:"notChecked"}}function tt(e){return(Array.isArray(e.symbols)?e.symbols.filter(y):[]).map(n=>{const o=a(n.raw)??a(n.symbolName)??"",r=a(n.symbolName)??o,s=a(n.symbolKind)??void 0;return{raw:o,symbolName:r,...s?{symbolKind:s}:{}}})}function nt(e,t){return a(e.name)!==t.symbolName?!1:!t.symbolKind||a(e.kind)===t.symbolKind}async function J(e,t,n,o="modulePlan.apply",r,s){const i=(0,d.readModulePlanRecord)(e,t);if(i.executable===!1||i.previewResult.ok===!1)throw new k.CliError("APPLY_MODULE_PLAN_NOT_EXECUTABLE","Module plan has blocking move diagnostics. Fix the plan before applying.",{planId:t,next:"Fix the plan, then rerun modulePlan preview."});if((0,d.hashFile)(i.sourceFile)!==i.sourceHash)throw new k.CliError("APPLY_MODULE_PLAN_SOURCE_CHANGED","Source file changed after modulePlan preview. Rerun modulePlan preview.",{planId:t,sourceFile:(0,d.formatRelativePath)(e,i.sourceFile)});const f=Q(i.normalizedRequest),c=[],m=new Set,p=i.sourceFile,P=f.map(M=>a(M.targetFile)).filter(M=>!!M),g=Z([p,...P]),l=s??ot(e,i,o,f,r);(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.apply.start",{operation:o,rowCount:f.length,entityCount:l.entityCount});const C={executionId:l.executionId,planId:i.planId,parentOperation:o,sourceFile:(0,d.formatRelativePath)(e,p),rowCount:f.length,entityCount:l.entityCount},w=(0,fe.startCentralMetricSpan)({kind:"mutation.execution",operation:o,cwd:F.resolve(e),...C});I(e,l),(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.apply.execution.persisted"),await(0,R.yieldToEventLoop)(),(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.cycles.pre.start",{fileCount:g.length});const A=xe(e,g);(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.cycles.pre.end",{componentCount:j(A.componentCount)??null});try{for(let x=0;x<f.length;x+=1){await(0,R.yieldToEventLoop)();const S=f[x],N=a(S.targetFile)??"",K=U(S),Fe=Mt(c.filter(L=>L.ok!==!1));(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.apply.row.start",{rowIndex:x,target:(0,d.formatRelativePath)(e,N),entityCount:K.length});const oe=await Pe(e,p,N,K,S,!0,n,{onProgress:L=>it(e,l,Fe,L,Array.from(m)),metricsContext:{...C,rowIndex:x,rowTargetFile:(0,d.formatRelativePath)(e,N)}}),q=Ce("execute",e,p,N,K,oe);c.push(q),(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.apply.row.end",{rowIndex:x,target:(0,d.formatRelativePath)(e,N),ok:q.ok!==!1});for(const L of b(oe.filesWritten))m.add((0,d.resolveCliFilePath)(e,L));if(rt(e,l,q,Array.from(m)),await(0,R.yieldToEventLoop)(),q.ok===!1)break}const M=c.every(x=>x.ok!==!1);if(M){l.phase="postMutation.cycles",I(e,l),(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.cycles.phase.persisted"),await(0,R.yieldToEventLoop)(),await at();const x=Z([...g,...Array.from(m)]);(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.cycles.post.start",{fileCount:x.length});const S=xe(e,x);(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.cycles.post.end",{componentCount:j(S.componentCount)??null}),l.postMutation={cycles:st(A,S,new Set(_e(e,x)))}}l.status=M?"completed":"failed",M&&(l.phase="completed"),l.failedRows=c.filter(x=>x.ok===!1).length,l.filesWritten=Array.from(m).sort((x,S)=>x.localeCompare(S));const T=await Re(e,p,n);T&&(l.remainingSource=T),I(e,l),(0,h.recordModulePlanTimeline)(e,l.executionId,"modulePlan.apply.execution.final.persisted",{status:l.status,completedRows:l.completedRows,completedEntities:l.completedEntities})}catch(M){throw l.status="failed",l.error=M instanceof Error?M.message:String(M),l.filesWritten=Array.from(m).sort((T,x)=>T.localeCompare(x)),I(e,l),w.end({ok:!1,status:l.status,error:M instanceof Error?M.message:String(M),completedRows:l.completedRows,failedRows:l.failedRows,completedEntities:l.completedEntities,filesWrittenCount:l.filesWritten.length}),M}const v=c.every(M=>M.ok!==!1),ee=v?[]:he(e,f,c.length),te=v?[]:[...ge(c),...ee];Ee(e,l);const ne={...v?{}:{ok:!1,code:"MODULE_PLAN_APPLY_FAILED"},operation:o,applied:v,planId:i.planId,executionId:l.executionId,expectEmpty:i.normalizedRequest.expectEmpty===!0,summary:Ie({rows:[...c,...ee]},!0),rows:c,...te.length>0?{notRun:te}:{},remainingSource:await Re(e,p,n),...l.postMutation?{postMutation:l.postMutation}:{},...G(i.previewResult).length>0?{createdFiles:ke(G(i.previewResult),8)}:{},filesWritten:X(Array.from(m).sort((M,T)=>M.localeCompare(T)).map(M=>(0,d.formatRelativePath)(e,M))),...v?{}:{next:"Fix failed move row and rerun modulePlan preview."}};return w.end({ok:v,status:l.status,completedRows:l.completedRows,failedRows:l.failedRows,completedEntities:l.completedEntities,filesWrittenCount:l.filesWritten.length}),(0,fe.recordCentralMetric)({kind:"mutation.summary",operation:o,cwd:F.resolve(e),ok:v,status:l.status,executionId:l.executionId,planId:i.planId,rowCount:l.rowCount,completedRows:l.completedRows,failedRows:l.failedRows,entityCount:l.entityCount,completedEntities:l.completedEntities,filesWrittenCount:l.filesWritten.length}),(0,$.attachAgentText)(ne,z(ne))}function he(e,t,n){return t.slice(n).map(o=>W({target:(0,d.formatRelativePath)(e,a(o.targetFile)??""),entities:U(o)}))}function ge(e){return e.map(t=>W({target:a(t.target)??"",entities:b(t.notRunEntities)})).filter(t=>b(t.entities).length>0)}async function Pe(e,t,n,o,r,s,i,u={}){const f=await(0,Ue.runMoveToFile)(e,{sourceFile:t,targetFile:n,entities:o,execute:s},i,[],u);return f.ok!==!1,f}function ot(e,t,n,o,r){const s=new Date().toISOString(),i=r??(0,d.buildModulePlanExecutionId)(t.planId),u=we(o);return{executionId:i,planId:t.planId,operation:n,cwd:F.resolve(e),sourceFile:t.sourceFile,status:"running",phase:"mutation",startedAt:s,updatedAt:s,rowCount:o.length,completedRows:0,failedRows:0,entityCount:u,completedEntities:0,expectEmpty:t.normalizedRequest.expectEmpty===!0,filesWritten:[],rows:[],timeoutHint:ut(t.normalizedRequest),productStorageDir:(0,H.productStorageRoot)()}}function Me(e,t,n,o){const r=new Date().toISOString(),s=Array.isArray(o.modules)?o.modules.filter(y):[];return{executionId:t,planId:"pending",operation:n,cwd:F.resolve(e),sourceFile:o.sourceFile||o.file?Se(e,o):"",status:"running",phase:"mutation",startedAt:r,updatedAt:r,rowCount:s.length,completedRows:0,failedRows:0,entityCount:we(s),completedEntities:0,expectEmpty:o.expectEmpty===!0,filesWritten:[],rows:[],productStorageDir:(0,H.productStorageRoot)()}}function rt(e,t,n,o){t.rows.push(n),t.completedRows=t.rows.filter(r=>r.ok!==!1).length,t.failedRows=t.rows.filter(r=>r.ok===!1).length,t.completedEntities=dt(t.rows),t.filesWritten=o.sort((r,s)=>r.localeCompare(s)),n.ok===!1&&(t.status="failed"),I(e,t)}function it(e,t,n,o,r){t.completedEntities=n+o.completedEntities,t.filesWritten=Array.from(new Set([...r,...o.filesWritten.map(s=>(0,d.resolveCliFilePath)(e,s))])).sort((s,i)=>s.localeCompare(i)),o.ok||(t.status="failed"),I(e,t)}function I(e,t){(0,d.writeModulePlanExecutionStatus)(e,t),Ee(e,t)}function Ee(e,t){if(!(0,ae.sessionWorkspaceExists)(e))return null;try{return(0,ae.saveSessionOutputJson)(e,"execution",`modulePlan-${t.executionId}`,t)}catch{return null}}function xe(e,t){const n=_e(e,t).filter(r=>O.existsSync((0,d.resolveCliFilePath)(e,r)));if(n.length===0)return{op:"cycles",componentCount:0,components:[]};const o=["cycles"];for(const r of n)o.push("--files",r);return o.push("--detail","imports","--limit","50"),(0,me.runInspectCycles)(e,o,void 0)}function st(e,t,n){const o=new Set(B(e).map(be)),r=B(t).filter(s=>b(s.files).some(i=>n.has(i))&&!o.has(be(s)));return{status:r.length>0?"new-or-changed":"none",detail:"imports",newOrChangedCount:r.length,preComponentCount:j(e.componentCount)??B(e).length,postComponentCount:j(t.componentCount)??B(t).length,components:r}}function B(e){return(Array.isArray(e.components)?e.components:[]).filter(y).map(t=>({kind:a(t.kind)??"mixed",files:b(t.files).sort(),chain:a(t.chain)??"",...y(t.cycle)?{cycle:t.cycle}:{},imports:lt(t)}))}function lt(e){const t=y(e.cycle)?e.cycle:{};return b(t.imports)}function be(e){return`${a(e.kind)??"mixed"}:${b(e.files).sort().join("|")}`}function _e(e,t){return Z(t.map(n=>(0,d.formatRelativePath)(e,(0,d.resolveCliFilePath)(e,n))))}async function at(){const e=process.env[_.CLI_ENV.testPostMutationCyclesDelayMs],t=e?Number.parseInt(e,10):0;!Number.isFinite(t)||t<=0||await new Promise(n=>setTimeout(n,Math.min(t,6e4)))}function Y(e){const t=e.filesWritten.length,n=`${e.completedRows}/${e.rowCount}`,o=e.entityCount??0,r=e.completedEntities??0,s=o>0?`, ${Math.floor(r/o*100)}% entities`:"",i=e.status==="running"&&e.phase==="postMutation.cycles"?`${n} rows${s}`:`${e.status==="running"?"in progress":e.status}, ${n} rows${s}`;return t>0?`${i}, ${t} ${t===1?"file":"files"} written`:i}function ut(e){return(0,de.buildModulePlanTimeoutHintFromRequest)(e)??{recommendedTimeoutMs:9e4,rowCount:0,symbolCount:0,message:"If the calling agent times out, inspect progress with: aib execution status last"}}function ct(e,t,n,o){const r=t.modules??[];if(r.length===0)throw new k.CliError("MODULE_PLAN_MODULES_REQUIRED","modulePlan expects a non-empty modules array.");const s=r.map(i=>{const u=i.target??i.targetFile??i.file;if(!u)throw new k.CliError("MODULE_PLAN_TARGET_REQUIRED","Each module expects target.");const f=i.entities??i.symbols??[];if(f.length===0)throw new k.CliError("MODULE_PLAN_ENTITIES_REQUIRED","Each module expects a non-empty entities array.");return{targetFile:(0,d.resolveCliFilePath)(e,u),symbols:f.map(c=>ft(c,o))}});return{op:"modulePlan",sourceFile:n,...t.expectEmpty===!0?{expectEmpty:!0}:{},modules:s}}function ft(e,t){if(typeof e=="string"){const o=(0,ce.parseInspectSelector)(e,t);return{raw:e,symbolName:o.symbolName,...o.symbolKind?{symbolKind:o.symbolKind}:{}}}const n=a(e.entity)??a(e.selector)??a(e.raw);if(n){const o=(0,ce.parseInspectSelector)(n,t);return{raw:n,symbolName:o.symbolName,...o.symbolKind?{symbolKind:o.symbolKind}:{}}}return Ne(e)}function Ce(e,t,n,o,r,s){const i={target:(0,d.formatRelativePath)(t,o),entities:r,ok:s.ok!==!1,summary:typeof s.summary=="string"?s.summary:null};if(e==="preview"&&typeof s.previewId=="string"&&(i.movePreviewId=s.previewId),Array.isArray(s.files)&&(i.files=s.files),Array.isArray(s.filesWritten)&&(i.filesWritten=s.filesWritten),s.ok===!1){const u=pt(s),f=a(u?.entity)??r[0]??null,m=(Array.isArray(s.results)?s.results.filter(y):[]).filter(g=>g.ok!==!1).map(g=>a(g.entity)).filter(g=>!!g),p=f?r.indexOf(f):-1,P=p>=0?r.slice(p+1):[];i.appliedEntities=m,i.notRunEntities=P,i.entity=f,i.code=a(u?.code)??a(s.code)??"MOVE_TO_FILE_FAILED",i.error=yt(a(u?.error)??a(s.error)??"Move failed."),i.hint=mt(t,a(u?.code),a(u?.hint)),i.next=a(u?.next),i.source=(0,d.formatRelativePath)(t,n)}return W(i)}function dt(e){return e.reduce((t,n)=>n.ok===!1?t+b(n.appliedEntities).length:t+b(n.entities).length,0)}function mt(e,t,n){return n?t==="TS_MOVE_TO_FILE_UNSUPPORTED_BY_ENGINE"?(0,le.useSessionGuidance)(e,"modulePlan.tsMoveUnsupportedHint",n,(0,le.readSessionNumberPref)(e,"diagnostics.hintLimit",2))??null:n:null}function pt(e){return(Array.isArray(e.results)?e.results.filter(y):[]).find(n=>n.ok===!1)??null}function yt(e){return e.replace(/^TypeScript refactor failed: Debug Failure\. False expression: /,"")}function Ie(e,t){const n=Array.isArray(e.rows)?e.rows.filter(y):[],o=n.reduce((m,p)=>m+b(p.entities).length,0),r=n.filter(m=>m.ok===!1).length,s=n.length,i=t?G(e).length:n.filter(m=>Ae(m)).length,u=t?Array.from(new Set(n.flatMap(m=>b(m.filesWritten).filter(p=>!p.startsWith("+"))))).length:0;if(r>0)return`${o} ${o===1?"symbol":"symbols"}, ${r} blocked`;const f=`${o} ${o===1?"symbol":"symbols"}, ${s} ${s===1?"target":"targets"} ${t?"moved":"ready"}`,c=[];return t&&u>0&&c.push(`${u} ${u===1?"file":"files"} written`),i>0&&c.push(`${i} ${i===1?"file":"files"} ${t?"created":"will be created"}`),c.length>0?`${f}; ${c.join(", ")}`:f}function Ae(e){return typeof e.summary=="string"&&e.summary.includes("target will be created")}function G(e){return(Array.isArray(e.rows)?e.rows.filter(y):[]).filter(n=>Ae(n)).map(n=>a(n.target)).filter(n=>!!n)}function z(e){const t=[],n=a(e.operation)??"modulePlan",o=a(e.planId),r=a(e.executionId);if(n!=="execution.status"){const i=n==="modulePlan.apply"||n==="modulePlan.execute"?r??o:o;t.push(i?`${n} ${i}`:n)}e.executable===!1&&t.push("blocked"),typeof e.summary=="string"&&t.push(e.summary),n==="execution.status"&&e.status==="running"&&e.phase==="postMutation.cycles"&&(t.push("mutation completed"),t.push("checking cycles"));const s=n==="execution.status"&&e.status==="running"&&e.phase==="postMutation.cycles";if(Array.isArray(e.targets)&&e.targets.length>0){t.push("targets:");for(const i of e.targets.filter(y)){const u=a(i.file),f=b(i.entities);u&&t.push(`${u}: ${V(f,5)}`)}}if(!s&&Array.isArray(e.rows)&&e.rows.length>0){t.push("moves:");for(const i of e.rows.filter(y)){const u=a(i.target),f=i.ok===!1&&b(i.appliedEntities).length>0?b(i.appliedEntities):b(i.entities);if(u&&f.length>0&&t.push(`${u}: ${V(f,5)}`),i.ok===!1){const c=a(i.code),m=a(i.error);c&&t.push(`code: ${c}`),m&&t.push(m)}}}if(Array.isArray(e.notRun)&&e.notRun.length>0){t.push("not run:");for(const i of e.notRun.filter(y)){const u=a(i.target),f=b(i.entities);u&&t.push(`${u}: ${V(f,5)}`)}}if(y(e.remainingSource)){const i=b(e.remainingSource.symbols);i.length===0?e.remainingSource.hasNonDeclarationText===!0?(t.push("source has no declarations"),t.push("source file still has non-declaration text")):t.push("source is empty"):e.expectEmpty===!0&&(t.push("source still contains:"),t.push(V(i,15)))}if(Array.isArray(e.blocking)&&e.blocking.length>0&&ht(t,e.blocking.filter(y)),e.status!=="running"&&Array.isArray(e.filesWritten)&&e.filesWritten.length>0){t.push("filesWritten:");for(const i of e.filesWritten.filter(u=>typeof u=="string"))t.push(i)}return y(e.postMutation)&&y(e.postMutation.cycles)&&gt(t,e.postMutation.cycles),typeof e.next=="string"&&!(Array.isArray(e.blocking)&&e.blocking.length>0)&&t.push(`next: ${e.next}`),t.join(`
-`)}function ht(e,t){const n=t.filter(i=>a(i.code)==="MODULE_PLAN_SYMBOL_NOT_FOUND").map(i=>a(i.entity)).filter(i=>!!i),o=t.filter(i=>a(i.code)==="MODULE_PLAN_SYMBOL_AMBIGUOUS").map(i=>a(i.entity)).filter(i=>!!i),r=n.length+o.length;n.length>0&&e.push(`not found symbols: ${n.join(", ")}`),o.length>0&&e.push(`ambiguous symbols: ${o.join(", ")}`);const s=t.filter(i=>a(i.code)!=="MODULE_PLAN_SYMBOL_NOT_FOUND"&&a(i.code)!=="MODULE_PLAN_SYMBOL_AMBIGUOUS");if(!(r>0&&s.length===0)){e.push("blocking:");for(const i of s.length>0?s:t){const u=a(i.target),f=a(i.entity),c=a(i.code),m=a(i.error),p=a(i.hint),P=a(i.next);u&&e.push(u),(f||c)&&e.push([f,c].filter(Boolean).join(": ")),m&&e.push(m),p&&e.push(`hint: ${p}`),P&&e.push(`next: ${P}`)}}}function gt(e,t){e.push("cycles:");const n=j(t.newOrChangedCount)??0;if(n===0){e.push("no new/changed cycles involving touched files");return}const o=Array.isArray(t.components)?t.components.filter(y):[];e.push(Pt(n,o)),o.forEach((r,s)=>{(0,me.appendCycleComponentText)(e,r,{detail:"imports",prefix:o.length===1?"":`${s+1}. `,indent:o.length===1?"":"   "})})}function Pt(e,t){const n=t.map(s=>a(s.kind)??"mixed"),o=Array.from(new Set(n)),r=o.length===1?`${o[0]} `:"";return`${e} new/changed ${r}${e===1?"cycle":"cycles"} involving touched files`}function Q(e){return Array.isArray(e.modules)?e.modules.filter(y):[]}function we(e){return e.reduce((t,n)=>{const o=U(n);if(o.length>0)return t+o.length;const r=Array.isArray(n.entities)?n.entities:[],s=Array.isArray(n.symbols)?n.symbols:[];return t+Math.max(r.length,s.length)},0)}function Mt(e){return e.reduce((t,n)=>t+b(n.entities).length,0)}function U(e){return(Array.isArray(e.symbols)?e.symbols.filter(y):[]).map(n=>a(n.raw)??a(n.selector)??a(n.entity)).filter(n=>!!n)}function Se(e,t){const n=t.sourceFile??t.file;if(!n)throw new k.CliError("MODULE_PLAN_SOURCE_REQUIRED","modulePlan expects sourceFile or file.");return(0,d.resolveCliFilePath)(e,n)}function Et(e){return Array.isArray(e.blocking)?e.blocking.filter(y):[]}function X(e){return ke(e,15)}async function Re(e,t,n){try{const o=await(0,D.resolveCompatibleTargetInstance)(e,ue.CLI_COMMAND_IDS.inspect,n),r=await(0,ie.postJson)(o.entry,se.EXTENSION_ROUTES.inspect,{requests:[{op:"file",file:t}]},(0,D.extensionRequestOptions)(n));return{file:(0,d.formatRelativePath)(e,t),symbols:bt(r),hasNonDeclarationText:xt(r,t)}}catch{return null}}function xt(e,t){const o=(Array.isArray(e.results)?e.results.filter(y):[])[0]??e;if(o.hasNonDeclarationText===!0)return!0;const r=a(o.sourceFile)??t;if(!r)return!1;try{return O.existsSync(r)&&O.statSync(r).isFile()&&O.readFileSync(r,"utf8").trim()!==""}catch{return!1}}function bt(e){const n=(Array.isArray(e.results)?e.results.filter(y):[])[0]??e;return(Array.isArray(n.symbols)?n.symbols:Array.isArray(n.items)?n.items:Array.isArray(n.declarations)?n.declarations:[]).map(_t).filter(r=>!!r)}function _t(e){if(typeof e=="string")return ve(e);if(!y(e))return null;const t=a(e.raw)??a(e.selector)??a(e.entity)??a(e.name)??a(e.label)??a(e.text);return t?ve(t):null}function ve(e){return(e.replace(/^export\s+/,"").trim().split(/\s+/)[0]??"").replace(/\(.*/,"").replace(/^[a-z]-/,"")||null}function ke(e,t){const n=e.slice(0,t),o=e.length-n.length;return o>0?[...n,`+ ${o} more`]:n}function V(e,t){const n=e.slice(0,t),o=e.length-n.length;return o>0?`${n.join(", ")}, +${o} more`:n.join(", ")}function Ct(e){return!!(e&&typeof e=="object"&&!Array.isArray(e)&&e.execute===!0)}function Te(e,t){const n=e.indexOf(t);if(n<0)return null;const o=e[n+1];return o&&!o.startsWith("--")?o:null}function a(e){return typeof e=="string"&&e.trim()!==""?e.trim():null}function j(e){return typeof e=="number"&&Number.isFinite(e)?e:null}function b(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function Z(e){return Array.from(new Set(e)).sort((t,n)=>t.localeCompare(n))}function W(e){return Object.fromEntries(Object.entries(e).filter(([,t])=>t==null?!1:!(Array.isArray(t)&&t.length===0)))}function y(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function Ne(e){return Object.fromEntries(Object.entries(e).map(([t,n])=>[t,Le(n)]))}function Le(e){return e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean"?e:Array.isArray(e)?e.map(t=>Le(t)):e&&typeof e=="object"?Ne(e):String(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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runApplyModulePlan = runApplyModulePlan;
+exports.reviseCachedModulePlan = reviseCachedModulePlan;
+exports.readCachedModulePlanExecution = readCachedModulePlanExecution;
+exports.formatModulePlanText = formatModulePlanText;
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+const typescript_1 = __importDefault(require("typescript"));
+const zod_1 = require("zod");
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const session_workspace_1 = require("./session-workspace");
+const inspect_selector_1 = require("./inspect-selector");
+const json_file_input_1 = require("./json-file-input");
+const module_plan_cache_1 = require("./module-plan-cache");
+const central_metrics_1 = require("../metrics/central-metrics");
+const module_plan_timeout_1 = require("./module-plan-timeout");
+const inspect_cycles_1 = require("./inspect-cycles");
+const env_vars_1 = require("../config/env-vars");
+const runtime_lifecycle_1 = require("../session/runtime-lifecycle");
+const product_storage_1 = require("../config/product-storage");
+const event_loop_1 = require("../shared/event-loop");
+const module_plan_timeline_1 = require("../diagnostics/module-plan-timeline");
+const resolve_1 = require("../config/resolve");
+const import_rules_1 = require("../config/import-rules");
+const mutation_comments_1 = require("../config/mutation-comments");
+const semantic_move_standalone_engine_1 = require("../mutation/semantic-move-standalone-engine");
+const semantic_move_metrics_1 = require("../mutation/semantic-move-metrics");
+const semantic_move_declarations_1 = require("../mutation/semantic-move-declarations");
+const module_plan_standalone_1 = require("./module-plan-standalone");
+const ModuleSchema = zod_1.z.object({
+    targetFile: zod_1.z.string().min(1).optional(),
+    target: zod_1.z.string().min(1).optional(),
+    file: zod_1.z.string().min(1).optional(),
+    symbols: zod_1.z.array(zod_1.z.union([
+        zod_1.z.string().min(1),
+        zod_1.z.object({}).passthrough()
+    ])).optional(),
+    entities: zod_1.z.array(zod_1.z.union([
+        zod_1.z.string().min(1),
+        zod_1.z.object({}).passthrough()
+    ])).optional()
+}).passthrough();
+const ApplyModulePlanPayloadSchema = zod_1.z.object({
+    sourceFile: zod_1.z.string().min(1).optional(),
+    file: zod_1.z.string().min(1).optional(),
+    facadeFile: zod_1.z.string().min(1).optional(),
+    facade: zod_1.z.string().min(1).optional(),
+    modules: zod_1.z.array(ModuleSchema).optional(),
+    execute: zod_1.z.boolean().optional(),
+    planId: zod_1.z.string().min(1).optional()
+}).passthrough();
+async function runApplyModulePlan(cwd, restArgs, rawPayload, options = {}, modulePlanOptions = {}) {
+    const flagPlanId = readFlagValue(restArgs, "--plan");
+    const fromJson = readFlagValue(restArgs, "--from-json");
+    if (fromJson && rawPayload !== undefined) {
+        throw new errors_1.CliError("APPLY_MODULE_PLAN_INPUT_SOURCE_CONFLICT", "Use either modulePlan --stdin or modulePlan --from-json, not both.");
+    }
+    const inputPayload = fromJson ? (0, json_file_input_1.readJsonObjectFile)(cwd, fromJson, "INVALID_MODULE_PLAN_JSON_FILE") : rawPayload;
+    const execute = restArgs.includes("--execute") || payloadExecute(inputPayload);
+    const payload = inputPayload === undefined ? {} : ApplyModulePlanPayloadSchema.parse(inputPayload);
+    const payloadPlanId = typeof payload.planId === "string" ? payload.planId : undefined;
+    const planId = flagPlanId ?? payloadPlanId;
+    if (planId && inputPayload === undefined) {
+        return applyCachedModulePlan(cwd, planId, options, "modulePlan.apply", modulePlanOptions.executionId);
+    }
+    if (execute && planId) {
+        return applyCachedModulePlan(cwd, planId, options, "modulePlan.apply", modulePlanOptions.executionId);
+    }
+    if (execute && !planId) {
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.enter", { hasExecutionId: Boolean(modulePlanOptions.executionId) });
+        const syncWaitMs = readModulePlanSyncWaitMs();
+        if (modulePlanOptions.executionId && syncWaitMs > 0) {
+            const pendingExecution = createPendingModulePlanExecutionStatus(cwd, modulePlanOptions.executionId, "modulePlan.execute", payload);
+            pendingExecution.phase = "preview";
+            persistModulePlanExecution(cwd, pendingExecution);
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.pending.persisted", {
+                rowCount: pendingExecution.rowCount,
+                entityCount: pendingExecution.entityCount,
+                syncWaitMs
+            });
+            const startedAtMs = Date.now();
+            const backgroundEnv = captureModulePlanBackgroundEnv();
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.background.schedule");
+            const jobPromise = startModulePlanBackgroundJob(() => (0, product_storage_1.runWithProductStorageOverride)(backgroundEnv[env_vars_1.CLI_ENV.productStorageDir], () => withModulePlanBackgroundEnv(backgroundEnv, () => {
+                (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.background.start");
+                return runModulePlanExecutePayload(cwd, payload, options, modulePlanOptions, pendingExecution);
+            })));
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.wait.start", { syncWaitMs });
+            const waitResult = await waitForModulePlanJob(jobPromise, syncWaitMs);
+            if (waitResult.status === "result") {
+                (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.wait.result");
+                return waitResult.result;
+            }
+            jobPromise.catch(() => undefined);
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, modulePlanOptions.executionId, "modulePlan.execute.wait.deadline", {
+                elapsedMs: Date.now() - startedAtMs
+            });
+            return buildModulePlanStillRunningResponse(cwd, modulePlanOptions.executionId, "modulePlan.execute", Date.now() - startedAtMs);
+        }
+        return runModulePlanExecutePayload(cwd, payload, options, modulePlanOptions);
+    }
+    return previewModulePlan(cwd, payload, options);
+}
+async function runModulePlanExecutePayload(cwd, payload, options, modulePlanOptions, pendingExecution) {
+    const execution = pendingExecution ?? (modulePlanOptions.executionId
+        ? createPendingModulePlanExecutionStatus(cwd, modulePlanOptions.executionId, "modulePlan.execute", payload)
+        : undefined);
+    if (execution) {
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.executePayload.start");
+        execution.phase = "preview";
+        persistModulePlanExecution(cwd, execution);
+        await (0, event_loop_1.yieldToEventLoop)();
+    }
+    let preview;
+    try {
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution?.executionId, "modulePlan.preview.start");
+        preview = await previewModulePlan(cwd, payload, options, "modulePlan.execute-preview");
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution?.executionId, "modulePlan.preview.end", {
+            ok: preview.ok !== false,
+            moduleCount: typeof preview.moduleCount === "number" ? preview.moduleCount : null
+        });
+    }
+    catch (error) {
+        if (execution) {
+            execution.status = "failed";
+            execution.error = error instanceof Error ? error.message : String(error);
+            persistModulePlanExecution(cwd, execution);
+        }
+        throw error;
+    }
+    if (preview.ok === false || typeof preview.planId !== "string") {
+        if (typeof preview.planId === "string" && (isRetryableModulePlanOverlapBlockedPreview(preview) || isNonRetryableModulePlanProviderLimitationBlockedPreview(preview))) {
+            const record = (0, module_plan_cache_1.readModulePlanRecord)(cwd, preview.planId);
+            const previewResult = {
+                ...record.previewResult,
+                ok: true,
+                retryableBlocking: isRetryableModulePlanOverlapBlockedPreview(preview) && Array.isArray(record.previewResult.blocking) ? record.previewResult.blocking : [],
+                providerLimitationBlocking: isNonRetryableModulePlanProviderLimitationBlockedPreview(preview) && Array.isArray(record.previewResult.blocking) ? record.previewResult.blocking : []
+            };
+            delete previewResult.blocking;
+            (0, module_plan_cache_1.writeModulePlanRecord)(cwd, {
+                ...record,
+                executable: true,
+                previewResult
+            });
+        }
+        else {
+            if (execution) {
+                execution.status = "failed";
+                execution.planId = typeof preview.planId === "string" ? preview.planId : execution.planId;
+                execution.error = "modulePlan preview failed before execute.";
+                persistModulePlanExecution(cwd, execution);
+            }
+            return preview;
+        }
+    }
+    if (preview.ok === false && typeof preview.planId === "string" && isRetryableModulePlanOverlapBlockedPreview(preview)) {
+        preview.ok = true;
+        delete preview.code;
+        preview.executable = true;
+    }
+    if (preview.ok === false && typeof preview.planId === "string" && isNonRetryableModulePlanProviderLimitationBlockedPreview(preview)) {
+        preview.ok = true;
+        delete preview.code;
+        preview.executable = true;
+    }
+    if (preview.ok === false || typeof preview.planId !== "string") {
+        if (execution) {
+            execution.status = "failed";
+            execution.planId = typeof preview.planId === "string" ? preview.planId : execution.planId;
+            execution.error = "modulePlan preview failed before execute.";
+            persistModulePlanExecution(cwd, execution);
+        }
+        return preview;
+    }
+    if (execution) {
+        execution.planId = preview.planId;
+        execution.phase = "mutation";
+        persistModulePlanExecution(cwd, execution);
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.mutation.phase.persisted", { planId: preview.planId });
+        await (0, event_loop_1.yieldToEventLoop)();
+    }
+    return applyCachedModulePlan(cwd, preview.planId, options, "modulePlan.execute", modulePlanOptions.executionId);
+}
+function isRetryableModulePlanOverlapBlockedPreview(preview) {
+    const blocking = Array.isArray(preview.blocking) ? preview.blocking.filter(isJsonObject) : [];
+    if (blocking.length === 0) {
+        return false;
+    }
+    return blocking.every((row) => readString(row.code) === "TS_MOVE_TO_FILE_REFACTOR_FAILED" &&
+        /Changes overlap/i.test(readString(row.error) ?? ""));
+}
+function isNonRetryableModulePlanProviderLimitationBlockedPreview(preview) {
+    const blocking = Array.isArray(preview.blocking) ? preview.blocking.filter(isJsonObject) : [];
+    if (blocking.length === 0) {
+        return false;
+    }
+    return blocking.every((row) => {
+        const providerLimitations = Array.isArray(row.providerLimitations) ? row.providerLimitations.filter(isJsonObject) : [];
+        if (providerLimitations.length > 0) {
+            return true;
+        }
+        return readString(row.code) === "TS_MOVE_TO_FILE_UNSUPPORTED_BY_ENGINE";
+    });
+}
+function reviseCachedModulePlan(cwd, planId) {
+    const record = (0, module_plan_cache_1.readModulePlanRecord)(cwd, planId);
+    const response = {
+        operation: "modulePlan.revise",
+        fromPlanId: planId,
+        planId,
+        executable: record.executable !== false,
+        summary: record.executable === false
+            ? "semantic module plan still has blocking move diagnostics"
+            : "semantic module plan already executable",
+        changes: [],
+        resolved: [],
+        remainingBlocking: collectBlockingRows(record.previewResult),
+        next: record.executable === false
+            ? "Fix the plan manually, then rerun modulePlan preview."
+            : `aib modulePlan apply ${planId}`
+    };
+    if (record.executable === false) {
+        response.ok = false;
+        response.code = "MODULE_PLAN_REVISE_NOT_APPLICABLE";
+    }
+    return (0, agent_text_1.attachAgentText)(response, formatModulePlanText(response));
+}
+function readCachedModulePlanExecution(cwd, executionId) {
+    const status = (0, module_plan_cache_1.readModulePlanExecutionStatus)(cwd, executionId);
+    const rows = status.rows;
+    const futureNotRun = status.status === "failed"
+        ? readNotRunRowsForExecution(cwd, status.planId, rows.length)
+        : [];
+    const notRun = [...compactNotRunEntitiesInRows(rows), ...futureNotRun];
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        planId: status.planId,
+        status: status.status,
+        summary: buildExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        entityProgress: `${status.completedEntities ?? 0}/${status.entityCount ?? 0}`,
+        filesWritten: summarizeWrittenFiles(status.filesWritten.map((file) => (0, module_plan_cache_1.formatRelativePath)(cwd, file)).sort((left, right) => left.localeCompare(right))),
+        rows,
+        ...(notRun.length > 0 ? { notRun } : {}),
+        ...(status.remainingSource ? { remainingSource: status.remainingSource } : {}),
+        ...(status.phase ? { phase: status.phase } : {}),
+        ...(status.postMutation ? { postMutation: status.postMutation } : {}),
+        updatedAt: status.updatedAt,
+        ...(status.error ? { error: status.error } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatModulePlanText(response));
+}
+function startModulePlanBackgroundJob(job) {
+    return (0, runtime_lifecycle_1.trackSessionBackgroundPromise)(new Promise((resolve, reject) => {
+        setImmediate(() => {
+            job().then(resolve, reject);
+        });
+    }), "module-plan-background");
+}
+function captureModulePlanBackgroundEnv() {
+    const keys = [
+        env_vars_1.CLI_ENV.productStorageDir,
+        env_vars_1.CLI_ENV.trace,
+        env_vars_1.CLI_ENV.traceDir,
+        env_vars_1.CLI_ENV.metrics,
+        env_vars_1.CLI_ENV.metricsDir,
+        env_vars_1.CLI_ENV.metricsTag,
+        env_vars_1.CLI_ENV.mutationImpactMetrics,
+        env_vars_1.CLI_ENV.mutationImpactStream,
+        env_vars_1.CLI_ENV.testMoveToFileFailEntity,
+        env_vars_1.CLI_ENV.testPostMutationCyclesDelayMs,
+        env_vars_1.CLI_ENV.modulePlanDebugTimeline
+    ];
+    const env = {};
+    for (const key of keys) {
+        env[key] = process.env[key];
+    }
+    return env;
+}
+async function withModulePlanBackgroundEnv(env, callback) {
+    const previous = {};
+    for (const [key, value] of Object.entries(env)) {
+        previous[key] = process.env[key];
+        if (value === undefined) {
+            delete process.env[key];
+        }
+        else {
+            process.env[key] = value;
+        }
+    }
+    try {
+        return await callback();
+    }
+    finally {
+        for (const [key, value] of Object.entries(previous)) {
+            if (value === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = value;
+            }
+        }
+    }
+}
+async function waitForModulePlanJob(jobPromise, deadlineMs) {
+    let timer = null;
+    try {
+        return await Promise.race([
+            jobPromise.then((result) => ({ status: "result", result })),
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve({ status: "deadline" }), deadlineMs);
+            })
+        ]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
+function readModulePlanSyncWaitMs() {
+    const raw = process.env[env_vars_1.CLI_ENV.modulePlanSyncWaitMs];
+    if (raw !== undefined) {
+        const parsed = Number.parseInt(raw, 10);
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            return 0;
+        }
+        return Math.min(parsed, 120_000);
+    }
+    return 120_000;
+}
+function buildModulePlanStillRunningResponse(cwd, executionId, operation, elapsedMs) {
+    const status = (0, module_plan_cache_1.readModulePlanExecutionStatus)(cwd, executionId);
+    const estimatedDurationMs = isJsonObject(status.timeoutHint) && typeof status.timeoutHint.estimatedDurationMs === "number"
+        ? status.timeoutHint.estimatedDurationMs
+        : null;
+    const estimatedRemainingMs = estimatedDurationMs === null ? null : Math.max(0, estimatedDurationMs - elapsedMs);
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        planId: status.planId,
+        status: status.status,
+        ...(status.phase ? { phase: status.phase } : {}),
+        summary: buildExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        entityProgress: `${status.completedEntities ?? 0}/${status.entityCount ?? 0}`,
+        expectEmpty: status.expectEmpty === true,
+        filesWritten: summarizeWrittenFiles(status.filesWritten.map((file) => (0, module_plan_cache_1.formatRelativePath)(cwd, file)).sort((left, right) => left.localeCompare(right))),
+        rows: status.rows,
+        updatedAt: status.updatedAt,
+        ...(estimatedRemainingMs !== null ? { estimatedRemainingMs } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatModulePlanStillRunningText(operation, status, estimatedRemainingMs));
+}
+function formatModulePlanStillRunningText(operation, status, estimatedRemainingMs) {
+    const lines = [
+        `${operation} ${status.executionId}`,
+        buildExecutionSummary(status)
+    ];
+    if (status.phase === "preview") {
+        lines.push("previewing plan");
+    }
+    else if (status.phase === "mutation") {
+        lines.push("applying mutation");
+    }
+    else if (status.phase === "postMutation.cycles") {
+        lines.push("mutation completed");
+        lines.push("checking cycles");
+    }
+    if (estimatedRemainingMs !== null) {
+        lines.push(estimatedRemainingMs > 0
+            ? `estimated remaining: ${(0, module_plan_timeout_1.formatModulePlanTimeoutEstimate)(Math.max(estimatedRemainingMs, 5_000))}`
+            : "estimated remaining: check status again soon");
+    }
+    return lines.join("\n");
+}
+async function previewModulePlan(cwd, payload, options, operation = "modulePlan.preview") {
+    const config = (0, resolve_1.resolveCliConfig)(null);
+    const sourceFile = readSourceFile(cwd, payload);
+    const normalizedRequest = buildNormalizedRequest(cwd, payload, sourceFile, config);
+    const planId = (0, module_plan_cache_1.buildModulePlanId)(normalizedRequest);
+    const previewResult = await runSemanticMovePreview(cwd, normalizedRequest, options, operation);
+    const sourceHash = (0, module_plan_cache_1.hashFile)(sourceFile);
+    const planHash = (0, module_plan_cache_1.buildModulePlanHash)(normalizedRequest, sourceHash, previewResult);
+    const record = {
+        planId,
+        planHash,
+        createdAt: new Date().toISOString(),
+        cwd: path.resolve(cwd),
+        sourceFile,
+        sourceHash,
+        executable: previewResult.ok !== false,
+        normalizedRequest,
+        inspectPayload: { requests: [normalizedRequest] },
+        previewDir: "",
+        previewResult
+    };
+    (0, module_plan_cache_1.writeModulePlanRecord)(cwd, record);
+    const response = {
+        ...(previewResult.ok === false ? { ok: false, code: "MODULE_PLAN_BLOCKED" } : {}),
+        operation,
+        planId,
+        executable: previewResult.ok !== false,
+        summary: buildPlanSummary(previewResult, false),
+        ...(typeof previewResult.moduleCount === "number" ? { moduleCount: previewResult.moduleCount } : {}),
+        ...(Array.isArray(previewResult.targets) ? { targets: previewResult.targets } : {}),
+        ...(Array.isArray(previewResult.blocking) && previewResult.blocking.length > 0 ? { blocking: previewResult.blocking } : {}),
+        next: previewResult.ok === false
+            ? "Fix the plan, then rerun modulePlan preview."
+            : `aib modulePlan apply ${planId}`
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatModulePlanText(response));
+}
+function readNotRunRowsForExecution(cwd, planId, completedRowCount) {
+    if (planId === "pending") {
+        return [];
+    }
+    try {
+        const record = (0, module_plan_cache_1.readModulePlanRecord)(cwd, planId);
+        return compactNotRunRows(cwd, readNormalizedModules(record.normalizedRequest), completedRowCount);
+    }
+    catch {
+        return [];
+    }
+}
+async function runSemanticMovePreview(cwd, normalizedRequest, options, operation) {
+    const modules = readNormalizedModules(normalizedRequest);
+    const sourceFile = readString(normalizedRequest.sourceFile) ?? "";
+    const built = (0, module_plan_standalone_1.buildModulePlanMoveBatch)({
+        cwd,
+        request: normalizedRequest,
+        execute: false,
+        config: (0, resolve_1.resolveCliConfig)(null),
+        importRules: options.importRules ?? (0, import_rules_1.readConfigImportRules)(cwd),
+        mutationComments: options.mutationComments ?? (0, mutation_comments_1.readConfigMutationComments)(cwd)
+    });
+    const metrics = (0, semantic_move_metrics_1.createSemanticMovePhaseMetrics)({
+        enabled: options.metricsEnabled === true,
+        cwd,
+        operation,
+        ...(options.semanticMoveMetricsExecutionId ? { executionId: options.semanticMoveMetricsExecutionId } : {})
+    });
+    const response = await (0, semantic_move_standalone_engine_1.runStandaloneSemanticMoveBatch)(cwd, built, undefined, undefined, metrics, options.semanticContextPool ? { semanticContextPool: options.semanticContextPool } : undefined);
+    const summarized = (0, module_plan_standalone_1.summarizeModulePlanMoveBatch)({ cwd, request: normalizedRequest, response, execute: false });
+    return {
+        op: "modulePlan",
+        ok: summarized.blocking.length === 0,
+        sourceFile,
+        moduleCount: modules.length,
+        targets: summarized.targets,
+        rows: summarized.rows,
+        ...(summarized.declarationFailures.length > 0 ? { declarationFailures: summarized.declarationFailures } : {}),
+        ...(summarized.missingEntities.length > 0 ? { missingEntities: summarized.missingEntities } : {}),
+        ...(summarized.blocking.length > 0 ? { blocking: summarized.blocking } : {}),
+        cycles: "notChecked"
+    };
+}
+async function applyCachedModulePlan(cwd, planId, options, operation = "modulePlan.apply", executionIdOverride, pendingExecution) {
+    const record = (0, module_plan_cache_1.readModulePlanRecord)(cwd, planId);
+    if (record.executable === false || record.previewResult.ok === false) {
+        throw new errors_1.CliError("APPLY_MODULE_PLAN_NOT_EXECUTABLE", "Module plan has blocking move diagnostics. Fix the plan before applying.", {
+            planId,
+            next: "Fix the plan, then rerun modulePlan preview."
+        });
+    }
+    const currentSourceHash = (0, module_plan_cache_1.hashFile)(record.sourceFile);
+    if (currentSourceHash !== record.sourceHash) {
+        throw new errors_1.CliError("APPLY_MODULE_PLAN_SOURCE_CHANGED", "Source file changed after modulePlan preview. Rerun modulePlan preview.", {
+            planId,
+            sourceFile: (0, module_plan_cache_1.formatRelativePath)(cwd, record.sourceFile)
+        });
+    }
+    const modules = readNormalizedModules(record.normalizedRequest);
+    const rows = [];
+    const filesWritten = new Set();
+    let declarationFailures = [];
+    let missingEntities = [];
+    const sourceFile = record.sourceFile;
+    const plannedTargets = modules.map((module) => readString(module.targetFile)).filter((file) => Boolean(file));
+    const plannedTouchedFiles = uniqueStrings([sourceFile, ...plannedTargets]);
+    const execution = pendingExecution ?? createModulePlanExecutionStatus(cwd, record, operation, modules, executionIdOverride);
+    (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.apply.start", {
+        operation,
+        rowCount: modules.length,
+        entityCount: execution.entityCount
+    });
+    const executionMetricContext = {
+        executionId: execution.executionId,
+        planId: record.planId,
+        parentOperation: operation,
+        sourceFile: (0, module_plan_cache_1.formatRelativePath)(cwd, sourceFile),
+        rowCount: modules.length,
+        entityCount: execution.entityCount
+    };
+    const span = (0, central_metrics_1.startCentralMetricSpan)({
+        kind: "mutation.execution",
+        operation,
+        cwd: path.resolve(cwd),
+        ...executionMetricContext
+    });
+    persistModulePlanExecution(cwd, execution);
+    (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.apply.execution.persisted");
+    await (0, event_loop_1.yieldToEventLoop)();
+    (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.cycles.pre.start", { fileCount: plannedTouchedFiles.length });
+    const preMutationCycles = runPostMutationCyclesSnapshot(cwd, plannedTouchedFiles);
+    (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.cycles.pre.end", {
+        componentCount: readNumber(preMutationCycles.componentCount) ?? null
+    });
+    try {
+        const built = (0, module_plan_standalone_1.buildModulePlanMoveBatch)({
+            cwd,
+            request: record.normalizedRequest,
+            execute: true,
+            config: (0, resolve_1.resolveCliConfig)(null),
+            importRules: options.importRules ?? (0, import_rules_1.readConfigImportRules)(cwd),
+            mutationComments: options.mutationComments ?? (0, mutation_comments_1.readConfigMutationComments)(cwd)
+        });
+        const metrics = (0, semantic_move_metrics_1.createSemanticMovePhaseMetrics)({
+            enabled: options.metricsEnabled === true,
+            cwd,
+            operation,
+            executionId: execution.executionId
+        });
+        let liveModuleOffset = 0;
+        const moveResponse = await (0, semantic_move_standalone_engine_1.runStandaloneSemanticMoveBatch)(cwd, built, {
+            beforeApply(writeSet) {
+                options.semanticMoveExecutionEvidence?.beforeApply(writeSet);
+                execution.phase = "mutation";
+                execution.plannedWriteSet = [...writeSet];
+                execution.potentiallyModifiedFiles = [...writeSet];
+                persistModulePlanExecution(cwd, execution);
+            },
+            afterProgress(progress) {
+                options.semanticMoveExecutionEvidence?.afterProgress?.(progress);
+            },
+            afterRoute(route) {
+                options.semanticMoveExecutionEvidence?.afterRoute?.(route);
+                const routeModules = [];
+                let rowCount = 0;
+                while (liveModuleOffset < modules.length && rowCount < route.requestedRowCount) {
+                    const module = modules[liveModuleOffset++];
+                    routeModules.push(module);
+                    rowCount += readModuleEntities(module).length;
+                }
+                const partialRequest = { ...record.normalizedRequest, modules: routeModules };
+                const partial = (0, module_plan_standalone_1.summarizeModulePlanMoveBatch)({ cwd, request: partialRequest, response: route.result, execute: true });
+                rows.push(...partial.rows);
+                for (const file of partial.filesWritten)
+                    filesWritten.add((0, module_plan_cache_1.resolveCliFilePath)(cwd, file));
+                execution.rows = [...rows];
+                execution.completedRows = rows.length;
+                execution.failedRows = rows.filter((row) => row.ok === false).length;
+                execution.completedEntities = countCompletedRowEntities(rows);
+                execution.filesWritten = Array.from(filesWritten).sort((left, right) => left.localeCompare(right));
+                persistModulePlanExecution(cwd, execution);
+                (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.apply.route.end", {
+                    routeIndex: route.index,
+                    completedRows: execution.completedRows,
+                    completedEntities: execution.completedEntities
+                });
+            }
+        }, undefined, metrics, options.semanticContextPool ? { semanticContextPool: options.semanticContextPool } : undefined);
+        const summarized = (0, module_plan_standalone_1.summarizeModulePlanMoveBatch)({
+            cwd,
+            request: record.normalizedRequest,
+            response: moveResponse,
+            execute: true
+        });
+        rows.splice(0, rows.length, ...summarized.rows);
+        declarationFailures = summarized.declarationFailures;
+        missingEntities = summarized.missingEntities;
+        for (const file of summarized.filesWritten)
+            filesWritten.add((0, module_plan_cache_1.resolveCliFilePath)(cwd, file));
+        execution.potentiallyModifiedFiles = readStringArray(moveResponse.potentiallyModifiedFiles).map((file) => (0, module_plan_cache_1.resolveCliFilePath)(cwd, file));
+        const ok = rows.every((row) => row.ok !== false);
+        if (ok) {
+            execution.phase = "postMutation.cycles";
+            persistModulePlanExecution(cwd, execution);
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.cycles.phase.persisted");
+            await (0, event_loop_1.yieldToEventLoop)();
+            await maybeDelayPostMutationCycles();
+            const postMutationFocusFiles = uniqueStrings([...plannedTouchedFiles, ...Array.from(filesWritten)]);
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.cycles.post.start", { fileCount: postMutationFocusFiles.length });
+            const postMutationCycles = runPostMutationCyclesSnapshot(cwd, postMutationFocusFiles);
+            (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.cycles.post.end", {
+                componentCount: readNumber(postMutationCycles.componentCount) ?? null
+            });
+            execution.postMutation = {
+                cycles: diffPostMutationCycles(preMutationCycles, postMutationCycles, new Set(formatCycleFocusFiles(cwd, postMutationFocusFiles)))
+            };
+        }
+        execution.status = ok ? "completed" : "failed";
+        if (ok) {
+            execution.phase = "completed";
+        }
+        execution.rows = [...rows];
+        execution.completedRows = rows.filter((row) => row.skipped !== true).length;
+        execution.failedRows = rows.filter((row) => row.ok === false && row.skipped !== true).length;
+        execution.completedEntities = countCompletedRowEntities(rows);
+        execution.filesWritten = Array.from(filesWritten).sort((left, right) => left.localeCompare(right));
+        const remainingSource = await readRemainingSourceSummary(cwd, sourceFile, options);
+        if (remainingSource) {
+            execution.remainingSource = remainingSource;
+        }
+        persistModulePlanExecution(cwd, execution);
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(cwd, execution.executionId, "modulePlan.apply.execution.final.persisted", {
+            status: execution.status,
+            completedRows: execution.completedRows,
+            completedEntities: execution.completedEntities
+        });
+    }
+    catch (error) {
+        execution.status = "failed";
+        execution.error = error instanceof Error ? error.message : String(error);
+        execution.filesWritten = Array.from(filesWritten).sort((left, right) => left.localeCompare(right));
+        persistModulePlanExecution(cwd, execution);
+        span.end({
+            ok: false,
+            status: execution.status,
+            error: error instanceof Error ? error.message : String(error),
+            completedRows: execution.completedRows,
+            failedRows: execution.failedRows,
+            completedEntities: execution.completedEntities,
+            filesWrittenCount: execution.filesWritten.length
+        });
+        throw error;
+    }
+    const ok = rows.every((row) => row.ok !== false);
+    const futureNotRun = ok ? [] : compactNotRunRows(cwd, modules, rows.length);
+    const notRun = ok ? [] : [...compactNotRunEntitiesInRows(rows), ...futureNotRun];
+    maybeSaveExecutionStatus(cwd, execution);
+    const response = {
+        ...(ok ? {} : { ok: false, code: "MODULE_PLAN_APPLY_FAILED" }),
+        operation,
+        applied: ok,
+        planId: record.planId,
+        executionId: execution.executionId,
+        expectEmpty: record.normalizedRequest.expectEmpty === true,
+        summary: buildPlanSummary({ rows: [...rows, ...futureNotRun] }, true),
+        rows,
+        ...(declarationFailures.length > 0 ? { declarationFailures } : {}),
+        ...(missingEntities.length > 0 ? { missingEntities } : {}),
+        ...(notRun.length > 0 ? { notRun } : {}),
+        remainingSource: await readRemainingSourceSummary(cwd, sourceFile, options),
+        ...(execution.postMutation ? { postMutation: execution.postMutation } : {}),
+        ...(readCreatedTargets(record.previewResult).length > 0 ? { createdFiles: compactStringList(readCreatedTargets(record.previewResult), 8) } : {}),
+        filesWritten: summarizeWrittenFiles(Array.from(filesWritten).sort((left, right) => left.localeCompare(right)).map((file) => (0, module_plan_cache_1.formatRelativePath)(cwd, file))),
+        ...(ok ? {} : { next: "Fix failed move row and rerun modulePlan preview." })
+    };
+    span.end({
+        ok,
+        status: execution.status,
+        completedRows: execution.completedRows,
+        failedRows: execution.failedRows,
+        completedEntities: execution.completedEntities,
+        filesWrittenCount: execution.filesWritten.length
+    });
+    (0, central_metrics_1.recordCentralMetric)({
+        kind: "mutation.summary",
+        operation,
+        cwd: path.resolve(cwd),
+        ok,
+        status: execution.status,
+        executionId: execution.executionId,
+        planId: record.planId,
+        rowCount: execution.rowCount,
+        completedRows: execution.completedRows,
+        failedRows: execution.failedRows,
+        entityCount: execution.entityCount,
+        completedEntities: execution.completedEntities,
+        filesWrittenCount: execution.filesWritten.length
+    });
+    return (0, agent_text_1.attachAgentText)(response, formatModulePlanText(response));
+}
+function compactNotRunRows(cwd, modules, startIndex) {
+    return modules.slice(startIndex).map((module) => compactObject({
+        target: (0, module_plan_cache_1.formatRelativePath)(cwd, readString(module.targetFile) ?? ""),
+        entities: readModuleEntities(module)
+    }));
+}
+function compactNotRunEntitiesInRows(rows) {
+    return rows
+        .map((row) => compactObject({
+        target: readString(row.target) ?? "",
+        entities: readStringArray(row.notRunEntities)
+    }))
+        .filter((row) => readStringArray(row.entities).length > 0);
+}
+function createModulePlanExecutionStatus(cwd, record, operation, modules, executionIdOverride) {
+    const now = new Date().toISOString();
+    const executionId = executionIdOverride ?? (0, module_plan_cache_1.buildModulePlanExecutionId)(record.planId);
+    const entityCount = countModuleEntities(modules);
+    return {
+        executionId,
+        planId: record.planId,
+        operation,
+        cwd: path.resolve(cwd),
+        sourceFile: record.sourceFile,
+        status: "running",
+        phase: "mutation",
+        startedAt: now,
+        updatedAt: now,
+        rowCount: modules.length,
+        completedRows: 0,
+        failedRows: 0,
+        entityCount,
+        completedEntities: 0,
+        expectEmpty: record.normalizedRequest.expectEmpty === true,
+        filesWritten: [],
+        rows: [],
+        timeoutHint: buildModulePlanTimeoutHint(record.normalizedRequest),
+        productStorageDir: (0, product_storage_1.productStorageRoot)()
+    };
+}
+function createPendingModulePlanExecutionStatus(cwd, executionId, operation, payload) {
+    const now = new Date().toISOString();
+    const rawModules = Array.isArray(payload.modules) ? payload.modules.filter(isJsonObject) : [];
+    return {
+        executionId,
+        planId: "pending",
+        operation,
+        cwd: path.resolve(cwd),
+        sourceFile: payload.sourceFile || payload.file ? readSourceFile(cwd, payload) : "",
+        status: "running",
+        phase: "mutation",
+        startedAt: now,
+        updatedAt: now,
+        rowCount: rawModules.length,
+        completedRows: 0,
+        failedRows: 0,
+        entityCount: countModuleEntities(rawModules),
+        completedEntities: 0,
+        expectEmpty: payload.expectEmpty === true,
+        filesWritten: [],
+        rows: [],
+        productStorageDir: (0, product_storage_1.productStorageRoot)()
+    };
+}
+function persistModulePlanExecution(cwd, execution) {
+    (0, module_plan_cache_1.writeModulePlanExecutionStatus)(cwd, execution);
+    maybeSaveExecutionStatus(cwd, execution);
+}
+function maybeSaveExecutionStatus(cwd, execution) {
+    if (!(0, session_workspace_1.sessionWorkspaceExists)(cwd)) {
+        return null;
+    }
+    try {
+        return (0, session_workspace_1.saveSessionOutputJson)(cwd, "execution", `modulePlan-${execution.executionId}`, execution);
+    }
+    catch {
+        return null;
+    }
+}
+function runPostMutationCyclesSnapshot(cwd, files) {
+    const existingFiles = formatCycleFocusFiles(cwd, files).filter((file) => fs.existsSync((0, module_plan_cache_1.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) ?? readCycleComponents(prePayload).length,
+        postComponentCount: readNumber(postPayload.componentCount) ?? readCycleComponents(postPayload).length,
+        components: newOrChanged
+    };
+}
+function readCycleComponents(payload) {
+    return (Array.isArray(payload.components) ? payload.components : [])
+        .filter(isJsonObject)
+        .map((component) => ({
+        kind: readString(component.kind) ?? "mixed",
+        files: readStringArray(component.files).sort(),
+        chain: readString(component.chain) ?? "",
+        ...(isJsonObject(component.cycle) ? { cycle: component.cycle } : {}),
+        imports: readCycleImports(component)
+    }));
+}
+function readCycleImports(component) {
+    const cycle = isJsonObject(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) => (0, module_plan_cache_1.formatRelativePath)(cwd, (0, module_plan_cache_1.resolveCliFilePath)(cwd, file))));
+}
+async function maybeDelayPostMutationCycles() {
+    const raw = process.env[env_vars_1.CLI_ENV.testPostMutationCyclesDelayMs];
+    const delayMs = raw ? Number.parseInt(raw, 10) : 0;
+    if (!Number.isFinite(delayMs) || delayMs <= 0) {
+        return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, Math.min(delayMs, 60_000)));
+}
+function buildExecutionSummary(status) {
+    const writtenCount = status.filesWritten.length;
+    const progress = `${status.completedRows}/${status.rowCount}`;
+    const entityCount = status.entityCount ?? 0;
+    const completedEntities = status.completedEntities ?? 0;
+    const entityProgress = entityCount > 0
+        ? `, ${Math.floor((completedEntities / entityCount) * 100)}% entities`
+        : "";
+    const base = status.status === "running" && status.phase === "postMutation.cycles"
+        ? `${progress} rows${entityProgress}`
+        : `${status.status === "running" ? "in progress" : status.status}, ${progress} rows${entityProgress}`;
+    return writtenCount > 0 ? `${base}, ${writtenCount} ${writtenCount === 1 ? "file" : "files"} written` : base;
+}
+function buildModulePlanTimeoutHint(request) {
+    return (0, module_plan_timeout_1.buildModulePlanTimeoutHintFromRequest)(request) ?? {
+        recommendedTimeoutMs: 90_000,
+        rowCount: 0,
+        symbolCount: 0,
+        message: "If the calling agent times out, inspect progress with: aib execution status last"
+    };
+}
+function buildNormalizedRequest(cwd, payload, sourceFile, config) {
+    const rawModules = payload.modules ?? [];
+    if (rawModules.length === 0) {
+        throw new errors_1.CliError("MODULE_PLAN_MODULES_REQUIRED", "modulePlan expects a non-empty modules array.");
+    }
+    const modules = rawModules.map((rawModule) => {
+        const targetFile = rawModule.target ?? rawModule.targetFile ?? rawModule.file;
+        if (!targetFile) {
+            throw new errors_1.CliError("MODULE_PLAN_TARGET_REQUIRED", "Each module expects target.");
+        }
+        const rawSymbols = rawModule.entities ?? rawModule.symbols ?? [];
+        if (rawSymbols.length === 0) {
+            throw new errors_1.CliError("MODULE_PLAN_ENTITIES_REQUIRED", "Each module expects a non-empty entities array.");
+        }
+        return {
+            targetFile: (0, module_plan_cache_1.resolveCliFilePath)(cwd, targetFile),
+            symbols: rawSymbols.map((rawSymbol) => parseModuleSymbol(rawSymbol, config))
+        };
+    });
+    return {
+        op: "modulePlan",
+        sourceFile,
+        ...(payload.expectEmpty === true ? { expectEmpty: true } : {}),
+        modules
+    };
+}
+function parseModuleSymbol(rawSymbol, config) {
+    if (typeof rawSymbol === "string") {
+        const parsed = (0, inspect_selector_1.parseInspectSelector)(rawSymbol, config);
+        return {
+            raw: rawSymbol,
+            symbolName: parsed.symbolName,
+            ...(parsed.symbolKind ? { symbolKind: parsed.symbolKind } : {})
+        };
+    }
+    const selector = readString(rawSymbol.entity) ?? readString(rawSymbol.selector) ?? readString(rawSymbol.raw);
+    if (selector) {
+        const parsed = (0, inspect_selector_1.parseInspectSelector)(selector, config);
+        return {
+            raw: selector,
+            symbolName: parsed.symbolName,
+            ...(parsed.symbolKind ? { symbolKind: parsed.symbolKind } : {})
+        };
+    }
+    return toJsonObject(rawSymbol);
+}
+function countCompletedRowEntities(rows) {
+    return rows.reduce((count, row) => {
+        if (row.ok === false) {
+            return count + readStringArray(row.appliedEntities).length;
+        }
+        return count + readStringArray(row.entities).length;
+    }, 0);
+}
+function buildPlanSummary(previewResult, applied) {
+    const rows = Array.isArray(previewResult.rows) ? previewResult.rows.filter(isJsonObject) : [];
+    const symbolCount = rows.reduce((count, row) => count + readStringArray(row.entities).length, 0);
+    const failedCount = rows.filter((row) => row.ok === false).length;
+    const appliedEntityCount = rows.reduce((count, row) => count + readStringArray(row.appliedEntities).length, 0);
+    const manualExtractionCount = rows.reduce((count, row) => count + readManualExtractionEntities(row).length, 0);
+    const nonManualFailedCount = rows.filter((row) => row.ok === false && readManualExtractionEntities(row).length === 0).length;
+    const targetCount = rows.length;
+    const createdCount = applied
+        ? readCreatedTargets(previewResult).length
+        : rows.filter((row) => targetWillBeCreated(row)).length;
+    const writtenCount = applied
+        ? Array.from(new Set(rows.flatMap((row) => readStringArray(row.filesWritten).filter((file) => !file.startsWith("+"))))).length
+        : 0;
+    if (failedCount > 0) {
+        const parts = [`${symbolCount} ${symbolCount === 1 ? "symbol" : "symbols"}`];
+        if (appliedEntityCount > 0) {
+            parts.push(`${appliedEntityCount} applied`);
+        }
+        if (manualExtractionCount > 0) {
+            parts.push(`${manualExtractionCount} manual extraction required`);
+        }
+        if (nonManualFailedCount > 0) {
+            parts.push(`${nonManualFailedCount} blocked`);
+        }
+        return parts.join(", ");
+    }
+    const base = `${symbolCount} ${symbolCount === 1 ? "symbol" : "symbols"}, ${targetCount} ${targetCount === 1 ? "target" : "targets"} ${applied ? "moved" : "ready"}`;
+    const details = [];
+    if (applied && writtenCount > 0) {
+        details.push(`${writtenCount} ${writtenCount === 1 ? "file" : "files"} written`);
+    }
+    if (createdCount > 0) {
+        details.push(`${createdCount} ${createdCount === 1 ? "file" : "files"} ${applied ? "created" : "will be created"}`);
+    }
+    return details.length > 0 ? `${base}; ${details.join(", ")}` : base;
+}
+function targetWillBeCreated(row) {
+    return typeof row.summary === "string" && row.summary.includes("target will be created");
+}
+function readCreatedTargets(previewResult) {
+    const rows = Array.isArray(previewResult.rows) ? previewResult.rows.filter(isJsonObject) : [];
+    return rows
+        .filter((row) => targetWillBeCreated(row))
+        .map((row) => readString(row.target))
+        .filter((file) => Boolean(file));
+}
+function formatModulePlanText(response) {
+    const lines = [];
+    const operation = readString(response.operation) ?? "modulePlan";
+    const planId = readString(response.planId);
+    const executionId = readString(response.executionId);
+    if (operation !== "execution.status") {
+        const headerId = operation === "modulePlan.apply" || operation === "modulePlan.execute"
+            ? executionId ?? planId
+            : planId;
+        lines.push(headerId ? `${operation} ${headerId}` : operation);
+    }
+    if (response.executable === false) {
+        lines.push("blocked");
+    }
+    if (typeof response.summary === "string") {
+        lines.push(response.summary);
+    }
+    if (operation === "execution.status" && response.status === "running" && response.phase === "postMutation.cycles") {
+        lines.push("mutation completed");
+        lines.push("checking cycles");
+    }
+    const isCheckingPostMutationCycles = operation === "execution.status" &&
+        response.status === "running" &&
+        response.phase === "postMutation.cycles";
+    if (Array.isArray(response.targets) && response.targets.length > 0) {
+        lines.push("targets:");
+        for (const target of response.targets.filter(isJsonObject)) {
+            const file = readString(target.file);
+            const entities = readStringArray(target.entities);
+            if (file) {
+                lines.push(`${file}: ${formatInlineList(entities, 5)}`);
+            }
+        }
+    }
+    if (!isCheckingPostMutationCycles && Array.isArray(response.rows) && response.rows.length > 0) {
+        const moveLines = [];
+        const manualExtractionRows = [];
+        const diagnosticRows = [];
+        lines.push("moves:");
+        for (const row of response.rows.filter(isJsonObject)) {
+            const target = readString(row.target);
+            const entities = row.ok === false ? readStringArray(row.appliedEntities) : readStringArray(row.entities);
+            if (target && entities.length > 0) {
+                moveLines.push(`${target}: ${formatInlineList(entities, 5)}`);
+            }
+            if (row.ok === false) {
+                if (readManualExtractionEntities(row).length > 0) {
+                    manualExtractionRows.push(row);
+                    continue;
+                }
+                diagnosticRows.push(row);
+            }
+        }
+        if (moveLines.length > 0) {
+            lines.push(...moveLines);
+        }
+        else {
+            lines.pop();
+        }
+        appendModulePlanManualExtractionLines(lines, manualExtractionRows);
+        for (const row of diagnosticRows) {
+            const code = readString(row.code);
+            const error = readString(row.error);
+            if (code) {
+                lines.push(`code: ${code}`);
+            }
+            if (error) {
+                lines.push(error);
+            }
+        }
+    }
+    if (Array.isArray(response.notRun) && response.notRun.length > 0) {
+        lines.push("not run:");
+        for (const row of response.notRun.filter(isJsonObject)) {
+            const target = readString(row.target);
+            const entities = readStringArray(row.entities);
+            if (target) {
+                lines.push(`${target}: ${formatInlineList(entities, 5)}`);
+            }
+        }
+    }
+    if (isJsonObject(response.remainingSource)) {
+        const remainingSymbols = readStringArray(response.remainingSource.symbols);
+        if (remainingSymbols.length === 0) {
+            if (response.remainingSource.hasNonDeclarationText === true) {
+                lines.push("source has no declarations");
+                lines.push("source file still has non-declaration text");
+            }
+            else {
+                lines.push("source is empty");
+            }
+        }
+        else if (response.expectEmpty === true) {
+            lines.push("source still contains:");
+            lines.push(formatInlineList(remainingSymbols, 15));
+        }
+    }
+    if (Array.isArray(response.blocking) && response.blocking.length > 0) {
+        appendModulePlanBlockingText(lines, response.blocking.filter(isJsonObject));
+    }
+    if (response.status !== "running" && Array.isArray(response.filesWritten) && response.filesWritten.length > 0) {
+        lines.push("filesWritten:");
+        for (const file of response.filesWritten.filter((item) => typeof item === "string")) {
+            lines.push(file);
+        }
+    }
+    if (isJsonObject(response.postMutation) && isJsonObject(response.postMutation.cycles)) {
+        appendPostMutationCyclesText(lines, response.postMutation.cycles);
+    }
+    if (typeof response.next === "string" &&
+        !(Array.isArray(response.blocking) && response.blocking.length > 0) &&
+        !lines.includes("manualExtractionRequired:")) {
+        lines.push(`next: ${response.next}`);
+    }
+    return lines.join("\n");
+}
+function appendModulePlanBlockingText(lines, blocking) {
+    const notFound = blocking
+        .filter((row) => readString(row.code) === "MODULE_PLAN_SYMBOL_NOT_FOUND")
+        .map((row) => readString(row.entity))
+        .filter((entity) => Boolean(entity));
+    const ambiguous = blocking
+        .filter((row) => readString(row.code) === "MODULE_PLAN_SYMBOL_AMBIGUOUS")
+        .map((row) => readString(row.entity))
+        .filter((entity) => Boolean(entity));
+    const selectorHandled = notFound.length + ambiguous.length;
+    if (notFound.length > 0) {
+        lines.push(`not found symbols: ${notFound.join(", ")}`);
+    }
+    if (ambiguous.length > 0) {
+        lines.push(`ambiguous symbols: ${ambiguous.join(", ")}`);
+    }
+    const manualExtractionRows = blocking.filter((row) => readManualExtractionEntities(row).length > 0);
+    appendModulePlanManualExtractionLines(lines, manualExtractionRows);
+    const remaining = blocking.filter((row) => readString(row.code) !== "MODULE_PLAN_SYMBOL_NOT_FOUND" &&
+        readString(row.code) !== "MODULE_PLAN_SYMBOL_AMBIGUOUS" &&
+        readManualExtractionEntities(row).length === 0);
+    if (selectorHandled > 0 && remaining.length === 0) {
+        return;
+    }
+    if (manualExtractionRows.length > 0 && remaining.length === 0) {
+        return;
+    }
+    lines.push("blocking:");
+    for (const row of remaining.length > 0 ? remaining : blocking) {
+        const target = readString(row.target);
+        const entity = readString(row.entity);
+        const code = readString(row.code);
+        const error = readString(row.error);
+        const hint = readString(row.hint);
+        const next = readString(row.next);
+        if (target) {
+            lines.push(target);
+        }
+        if (entity || code) {
+            lines.push([entity, code].filter(Boolean).join(": "));
+        }
+        if (error) {
+            lines.push(error);
+        }
+        if (hint) {
+            lines.push(`hint: ${hint}`);
+        }
+        if (next) {
+            lines.push(`next: ${next}`);
+        }
+    }
+}
+function appendModulePlanManualExtractionLines(lines, rows) {
+    const grouped = new Map();
+    for (const row of rows) {
+        const target = readString(row.target);
+        if (!target) {
+            continue;
+        }
+        const entities = readManualExtractionEntities(row);
+        if (entities.length === 0) {
+            continue;
+        }
+        const list = grouped.get(target) ?? [];
+        list.push(...entities);
+        grouped.set(target, list);
+    }
+    if (grouped.size === 0) {
+        return;
+    }
+    lines.push("manualExtractionRequired:");
+    for (const [target, entities] of grouped) {
+        lines.push(`${target}: ${formatInlineList(uniqueStringsInOrder(entities), 15)}`);
+    }
+    lines.push("reason: TypeScript move-to-file provider cannot produce edits for these symbols.");
+    lines.push("next: use manual extraction for listed symbols");
+}
+function appendPostMutationCyclesText(lines, cycles) {
+    lines.push("cycles:");
+    const count = readNumber(cycles.newOrChangedCount) ?? 0;
+    if (count === 0) {
+        lines.push("no new/changed cycles involving touched files");
+        return;
+    }
+    const components = Array.isArray(cycles.components) ? cycles.components.filter(isJsonObject) : [];
+    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 readNormalizedModules(request) {
+    return Array.isArray(request.modules) ? request.modules.filter(isJsonObject) : [];
+}
+function countModuleEntities(modules) {
+    return modules.reduce((count, module) => {
+        const normalizedEntities = readModuleEntities(module);
+        if (normalizedEntities.length > 0) {
+            return count + normalizedEntities.length;
+        }
+        const rawEntities = Array.isArray(module.entities) ? module.entities : [];
+        const rawSymbols = Array.isArray(module.symbols) ? module.symbols : [];
+        return count + Math.max(rawEntities.length, rawSymbols.length);
+    }, 0);
+}
+function countRowEntities(rows) {
+    return rows.reduce((count, row) => count + readStringArray(row.entities).length, 0);
+}
+function readModuleEntities(module) {
+    const symbols = Array.isArray(module.symbols) ? module.symbols.filter(isJsonObject) : [];
+    return symbols
+        .map((symbol) => readString(symbol.raw) ?? readString(symbol.selector) ?? readString(symbol.entity))
+        .filter((value) => Boolean(value));
+}
+function readManualExtractionEntities(row) {
+    const items = Array.isArray(row.manualExtractionRequired) ? row.manualExtractionRequired.filter(isJsonObject) : [];
+    return items
+        .map((item) => readString(item.entity))
+        .filter((entity) => Boolean(entity));
+}
+function readSourceFile(cwd, payload) {
+    const sourceFile = payload.sourceFile ?? payload.file;
+    if (!sourceFile) {
+        throw new errors_1.CliError("MODULE_PLAN_SOURCE_REQUIRED", "modulePlan expects sourceFile or file.");
+    }
+    return (0, module_plan_cache_1.resolveCliFilePath)(cwd, sourceFile);
+}
+function collectBlockingRows(previewResult) {
+    return Array.isArray(previewResult.blocking) ? previewResult.blocking.filter(isJsonObject) : [];
+}
+function summarizeWrittenFiles(written) {
+    return compactStringList(written, 15);
+}
+async function readRemainingSourceSummary(cwd, sourceFile, _options) {
+    try {
+        const text = fs.readFileSync(sourceFile, "utf8");
+        const declarations = (0, semantic_move_declarations_1.collectSemanticMoveDeclarations)(sourceFile, text);
+        const symbols = uniqueStringsInOrder(declarations.map((declaration) => declaration.name));
+        return {
+            file: (0, module_plan_cache_1.formatRelativePath)(cwd, sourceFile),
+            symbols,
+            hasNonDeclarationText: hasNonDeclarationSourceText(sourceFile, text)
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function hasNonDeclarationSourceText(file, text) {
+    const source = typescript_1.default.createSourceFile(file, text, typescript_1.default.ScriptTarget.Latest, true, file.endsWith("x") ? typescript_1.default.ScriptKind.TSX : typescript_1.default.ScriptKind.TS);
+    const ranges = (0, semantic_move_declarations_1.collectSemanticMoveDeclarations)(file, text)
+        .map((declaration) => ({ start: declaration.statementStart, end: declaration.statementEnd }))
+        .filter((range, index, all) => index === 0 || range.start !== all[index - 1].start || range.end !== all[index - 1].end)
+        .sort((left, right) => right.start - left.start);
+    let remaining = source.getFullText();
+    for (const range of ranges)
+        remaining = `${remaining.slice(0, range.start)}${remaining.slice(range.end)}`;
+    return remaining.trim().length > 0;
+}
+function compactStringList(items, limit) {
+    const visible = items.slice(0, limit);
+    const hidden = items.length - visible.length;
+    return hidden > 0 ? [...visible, `+ ${hidden} more`] : visible;
+}
+function formatInlineList(items, limit) {
+    const visible = items.slice(0, limit);
+    const hidden = items.length - visible.length;
+    return hidden > 0 ? `${visible.join(", ")}, +${hidden} more` : visible.join(", ");
+}
+function payloadExecute(rawPayload) {
+    return Boolean(rawPayload && typeof rawPayload === "object" && !Array.isArray(rawPayload) && rawPayload.execute === true);
+}
+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 readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values)).sort((left, right) => left.localeCompare(right));
+}
+function uniqueStringsInOrder(values) {
+    return Array.from(new Set(values));
+}
+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 isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function toJsonObject(value) {
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toJsonValue(item)]));
+}
+function toJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => toJsonValue(item));
+    }
+    if (value && typeof value === "object") {
+        return toJsonObject(value);
+    }
+    return String(value);
+}