@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/commands/refactor-batch.js

@@ -1,4 +1,461 @@
-"use strict";var oe=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){n===void 0&&(n=r);var o=Object.getOwnPropertyDescriptor(t,r);(!o||("get"in o?!t.__esModule:o.writable||o.configurable))&&(o={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,o)}):(function(e,t,r,n){n===void 0&&(n=r),e[n]=t[r]})),ae=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),J=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var n=[];for(var o in r)Object.prototype.hasOwnProperty.call(r,o)&&(n[n.length]=o);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var n=e(t),o=0;o<n.length;o++)n[o]!=="default"&&oe(r,t,n[o]);return ae(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runRefactorBatch=de,exports.readCachedRefactorBatchExecution=he;const G=J(require("node:fs")),M=J(require("node:path")),A=require("zod"),ie=require("../client/http-client"),w=require("../config/env-vars"),se=require("../config/product-storage"),ce=require("../shared/routes"),ue=require("../shared/protocol"),P=require("../shared/agent-text"),le=require("../shared/errors"),fe=require("./refactor-batch-builder"),C=require("./refactor-batch-preview-cache"),x=require("./refactor-batch-execution-cache"),K=require("./mutation-execution-cache"),j=require("./shared"),q=A.z.object({operations:A.z.array(A.z.unknown()).min(1).optional(),requests:A.z.array(A.z.unknown()).min(1).optional(),continueOnError:A.z.boolean().optional(),execution:A.z.literal("sequential").optional()}).passthrough().refine(e=>Array.isArray(e.operations)||Array.isArray(e.requests),{message:"refactor batch expects operations[] or requests[]."});async function de(e,t,r={},n="preview",o={}){if(n==="apply"&&o.previewId){const u=L();if(u>0){const s=U(e,o.previewId),h=q.parse(z(s.normalizedPayload,!0));return X(e,h,r,"apply",{...o,previewId:o.previewId},u)}return pe(e,o.previewId,r,o)}const a=q.parse(t);return(n==="execute"||n==="apply")&&L()>0?X(e,a,r,n,o,L()):N(e,a,r,n,o)}async function pe(e,t,r,n){const o=U(e,t),a=q.parse(z(o.normalizedPayload,!0));return N(e,a,r,"apply",{...n,previewId:t})}function U(e,t){const r=(0,C.readRefactorBatchPreviewRecord)(e,t),n=r.files.find(o=>G.existsSync(o.file)!==o.existed||(0,C.hashFileIfExists)(o.file)!==o.hash);if(n)throw new le.CliError("REFACTOR_BATCH_PREVIEW_FILES_CHANGED","Touched files changed after refactor batch preview. Rerun preview.",{previewId:t,file:k(e,n.file)});return r}async function X(e,t,r,n,o,a){const u=(0,x.buildRefactorBatchExecutionId)(),s=`refactor.batch.${n}`,h=Ae(t),p=(0,x.createRefactorBatchExecutionStatus)(e,u,s,Q(t));(0,x.writeRefactorBatchExecutionStatus)(e,p);const f=Date.now(),y=$e(),R=be(()=>(0,se.runWithProductStorageOverride)(y[w.CLI_ENV.productStorageDir],()=>Ce(y,async()=>{try{const l=await N(e,t,r,n,o),g=Y(l);return p.status=l.ok===!1?"failed":"completed",p.phase="completed",p.completedRows=g.filter(i=>i.ok!==!1).length,p.failedRows=g.filter(i=>i.ok===!1).length,p.filesWritten=xe(l),p.result=l,l.ok===!1&&(p.error=c(l.code)??"REFACTOR_BATCH_FAILED"),(0,x.writeRefactorBatchExecutionStatus)(e,p),l}catch(l){throw p.status="failed",p.phase="completed",p.error=l instanceof Error?l.message:String(l),(0,x.writeRefactorBatchExecutionStatus)(e,p),l}}))),m=await _e(R,a);return m.status==="result"?m.result:(R.catch(()=>{}),we(e,u,s,h,Date.now()-f))}async function N(e,t,r,n,o){await Be();const a=await(0,j.resolveCompatibleTargetInstance)(e,ue.CLI_COMMAND_IDS.refactorBatch,r),u=await(0,j.fetchEffectiveConfig)(a.entry,r),s=(0,fe.buildExtensionRefactorBatchPayload)(t,u),h=await(0,ie.postJson)(a.entry,ce.EXTENSION_ROUTES.refactorBatch,s.payload,(0,j.extensionRequestOptions)(r)),p=me(e,h),f={ok:p.batchOk===!0,...p.batchOk===!0?{}:{code:"REFACTOR_BATCH_FAILED"},operation:`refactor.batch.${n}`,builder:s.summary,response:p};if(n==="preview"&&f.ok!==!1){const R=z(t,!1),m=(0,C.buildRefactorBatchPreviewId)(R),l=Ie(e,s.payload),g=(0,C.buildRefactorBatchPreviewHash)(R,l,f);(0,C.writeRefactorBatchPreviewRecord)(e,{previewId:m,previewHash:g,createdAt:new Date().toISOString(),cwd:M.resolve(e),normalizedPayload:R,files:l,builder:s.summary,previewResult:f}),f.previewId=m,f.next=`aib refactor batch apply ${m}`}const y={...o,...typeof f.previewId=="string"?{previewId:f.previewId}:{},...typeof f.next=="string"?{next:f.next}:{}};return(0,P.attachAgentText)(f,Re(e,s.summary,p,n,y))}function he(e,t){const r=(0,x.readRefactorBatchExecutionStatus)(e,t);if((r.status==="completed"||r.status==="failed")&&r.result)return r.result;const n={operation:"execution.status",executionId:r.executionId,status:r.status,phase:r.phase,summary:F(r),progress:`${r.completedRows}/${r.rowCount}`,filesWritten:r.filesWritten,updatedAt:r.updatedAt,...r.error?{error:r.error}:{}};return(0,P.attachAgentText)(n,ve(r))}function me(e,t){const r=Array.isArray(t.rows)?t.rows.map(n=>ye(e,n)):[];return{ok:t.ok===!0,operation:c(t.operation),contract:t.contract??null,execution:c(t.execution),continueOnError:t.continueOnError===!0,batchOk:t.batchOk===!0,batchStatus:c(t.batchStatus),requestedOperationCount:v(t.requestedOperationCount),plannedOperationCount:v(t.plannedOperationCount),attemptedRowCount:v(t.attemptedRowCount),rowCount:v(t.rowCount),passedRowCount:v(t.passedRowCount),failedRowCount:v(t.failedRowCount),skippedRowCount:v(t.skippedRowCount),guidance:t.guidance??null,rows:r,...t._metrics?{_metrics:t._metrics}:{}}}function ye(e,t){if(!t||typeof t!="object"||Array.isArray(t))return{ok:!1,error:"Invalid batch row shape."};const r=t;return r.skipped===!0?T({index:v(r.index),id:c(r.id),kind:c(r.kind),planned:r.planned===!0,attempted:!1,outcome:c(r.outcome),skipped:!0,skipReason:c(r.skipReason),error:c(r.error)}):T({index:v(r.index),id:c(r.id),kind:c(r.kind),planned:r.planned===!0,attempted:r.attempted===!0,outcome:c(r.outcome),ok:r.ok===!0,statusCode:v(r.statusCode),durationMs:v(r.durationMs),applied:r.applied===!0,touchedFiles:E(r.touchedFiles).map(n=>k(e,n)),savedFiles:E(r.savedFiles).map(n=>k(e,n)),error:c(r.error),response:Le(r.response)})}function Re(e,t,r,n,o={}){const a=Array.isArray(r.rows)?r.rows.filter(l=>!!l&&typeof l=="object"&&!Array.isArray(l)):[],u=a.filter(l=>l.outcome==="applied").length,s=a.filter(l=>l.outcome==="validated").length,h=typeof r.failedRowCount=="number"?r.failedRowCount:a.filter(l=>l.ok===!1).length,p=n==="execute"||n==="apply"||n==="validate"?n:u>0?"apply":"preview",f=[];o.routedFrom==="move.toFile"&&(f.push("move.toFile routed to refactor.batch"),f.push(""));const y=Me(t,e),R=Fe(t);if(f.push(Ee(p,o)),f.push(Se(p,{movePlan:y,renamePlan:R},a,u,s,h)),(y||R)&&a.length>0)ke(f,{movePlan:y,renamePlan:R},a);else for(const l of a){const g=c(l.id)??`row ${v(l.index)??"?"}`,i=c(l.kind)??"operation",b=c(l.outcome)??(l.ok===!0?"ok":"failed");f.push(`${Pe(i)} ${je(g)} ${b}`)}const m=D(a.flatMap(l=>E(l.savedFiles)));return m.length>0&&(f.push("filesWritten:"),f.push(...m)),o.next&&f.push(`next: ${o.next}`),f.join(`
-`)}function we(e,t,r,n,o){const a=(0,x.readRefactorBatchExecutionStatus)(e,t),u=Math.max(0,n-o),s={operation:"execution.status",executionId:a.executionId,status:a.status,phase:a.phase,summary:F(a),progress:`${a.completedRows}/${a.rowCount}`,filesWritten:a.filesWritten,updatedAt:a.updatedAt,estimatedRemainingMs:u};return(0,P.attachAgentText)(s,ge(r,a,u))}function ge(e,t,r){return[`${e} ${t.executionId}`,F(t),"applying mutation",r>0?`estimated remaining: ${Ne(Math.max(r,5e3))}`:"estimated remaining: check status again soon"].join(`
-`)}function ve(e){const t=[`${e.operation} ${e.executionId}`,F(e)];return e.status==="running"&&t.push("applying mutation"),e.error&&t.push(e.error),t.join(`
-`)}function F(e){return e.status==="completed"?`completed, ${e.completedRows}/${e.rowCount} rows, ${e.filesWritten.length} files written`:e.status==="failed"?`failed, ${e.completedRows}/${e.rowCount} rows, ${e.failedRows} failed`:`in progress, ${e.completedRows}/${e.rowCount} rows`}function be(e){return new Promise((t,r)=>{setImmediate(()=>{e().then(t,r)})})}async function _e(e,t){return(0,K.waitForMutationDeadline)(e,t)}function L(){return(0,K.readMutationSyncWaitMs)(process.env[w.CLI_ENV.refactorBatchSyncWaitMs],12e4)}function Ae(e){return 12e3+Q(e)*2e3}function Q(e){const t=Array.isArray(e.operations)?e.operations:Array.isArray(e.requests)?e.requests:[];let r=0;for(const n of t){if(!_(n)){r+=1;continue}const o=Array.isArray(n.entities)?n.entities:Array.isArray(n.symbols)?n.symbols:[],a=Array.isArray(n.renames)?n.renames:[];r+=Math.max(1,o.length,a.length)}return Math.max(1,r)}function xe(e){const t=Y(e);return D(t.flatMap(r=>E(r.savedFiles)))}function Y(e){const t=_(e.response)?e.response:null;return Array.isArray(t?.rows)?t.rows.filter(_):[]}async function Be(){const e=process.env[w.CLI_ENV.testRefactorBatchDelayMs];if(!e)return;const t=Number.parseInt(e,10);!Number.isFinite(t)||t<=0||await new Promise(r=>setTimeout(r,Math.min(t,12e4)))}function $e(){const e=[w.CLI_ENV.productStorageDir,w.CLI_ENV.trace,w.CLI_ENV.traceDir,w.CLI_ENV.metrics,w.CLI_ENV.metricsDir,w.CLI_ENV.metricsTag,w.CLI_ENV.mutationImpactMetrics,w.CLI_ENV.mutationImpactStream,w.CLI_ENV.testMoveToFileFailEntity,w.CLI_ENV.testRefactorBatchDelayMs],t={};for(const r of e)t[r]=process.env[r];return t}async function Ce(e,t){const r={};for(const[n,o]of Object.entries(e))r[n]=process.env[n],o===void 0?delete process.env[n]:process.env[n]=o;try{return await t()}finally{for(const[n,o]of Object.entries(r))o===void 0?delete process.env[n]:process.env[n]=o}}function Ie(e,t){const r=Array.isArray(t.operations)?t.operations.filter(_):[],n=new Set;for(const o of r){const a=_(o.body)?o.body:{},u=c(a.sourceFile),s=c(a.targetFile);u&&n.add(Z(e,u)),s&&n.add(Z(e,s))}return Array.from(n).sort((o,a)=>o.localeCompare(a)).map(o=>({file:o,existed:G.existsSync(o),hash:(0,C.hashFileIfExists)(o)}))}function Z(e,t){return M.normalize(M.isAbsolute(t)?t:M.resolve(e,t))}function Ee(e,t){return e==="preview"&&t.previewId?`refactor.batch.preview ${t.previewId}`:`refactor.batch.${e}`}function Se(e,t,r,n,o,a){const u=t.movePlan?.rows??[],s=t.renamePlan?.rows??[];if(u.length===0&&s.length===0)return`${r.length} rows, ${n>0?`${n} applied`:`${o} validated`}${a>0?`, ${a} failed`:""}`;const h=new Map(r.map(d=>[c(d.id),d]).filter(d=>!!d[0])),p=r.find(d=>d.ok===!1||d.outcome==="failed")??null,f=p?c(p.id):null,y=f?u.some(d=>d.id===f):!1,R=f?s.some(d=>d.id===f):!1,m=new Set(r.filter(d=>d.outcome==="applied").map(d=>c(d.id)).filter(d=>!!d)),l=new Set(r.filter(d=>d.outcome==="validated").map(d=>c(d.id)).filter(d=>!!d)),g=new Set(u.map(d=>d.targetFile)).size,i=D(r.flatMap(d=>E(d.savedFiles))).length,b=u.filter(d=>m.has(d.id)||l.has(d.id)).length,B=s.filter(d=>m.has(d.id)||l.has(d.id)).length;if(p){const d=[...s,...u],V=f?d.findIndex($=>$.id===f):-1,H=d.filter(($,ne)=>!m.has($.id)&&!l.has($.id)&&$.id!==f&&(V<0||ne>V||!h.has($.id))).length,I=[];return B>0&&I.push(`${B} ${B===1?"rename":"renames"} applied`),b>0&&I.push(`${b} ${b===1?"symbol":"symbols"} moved`),I.push(y?"1 symbol failed":R?"1 rename failed":"1 failed"),H>0&&I.push(`${H} not run`),I.join(", ")}const S=[];s.length>0&&S.push(`${s.length} ${s.length===1?"rename":"renames"}`),u.length>0&&(S.push(`${u.length} ${u.length===1?"symbol":"symbols"}`),S.push(`${g} ${g===1?"target":"targets"}`));const O=S.join(", ");if(e==="preview"||e==="validate")return`${O} ready`;const W=s.length>0?"applied":"moved";return i>0?`${O} ${W}; ${i} ${i===1?"file":"files"} written`:`${O} ${W}`}function Me(e,t){const n=(Array.isArray(e.rows)?e.rows.filter(_):[]).filter(a=>c(a.op)==="move");if(n.length===0)return null;const o=[];for(const a of n){const u=Array.isArray(a.builtRows)?a.builtRows.filter(_):[];for(const s of u){const h=c(s.id),p=c(s.entity),f=c(s.targetFile);h&&p&&f&&o.push({id:h,entity:p,targetFile:k(t,f)})}}return o.length>0?{rows:o}:null}function Fe(e){const r=(Array.isArray(e.rows)?e.rows.filter(_):[]).filter(o=>c(o.op)==="rename");if(r.length===0)return null;const n=[];for(const o of r){const a=Array.isArray(o.builtRows)?o.builtRows.filter(_):[];for(const u of a){const s=c(u.id),h=c(u.entity),p=c(u.newName);s&&h&&p&&n.push({id:s,entity:h,newName:p})}}return n.length>0?{rows:n}:null}function ke(e,t,r){const n=t.movePlan?.rows??[],o=t.renamePlan?.rows??[],a=new Map(r.map(i=>[c(i.id),i]).filter(i=>!!i[0])),u=new Set(r.filter(i=>i.outcome==="applied").map(i=>c(i.id)).filter(i=>!!i)),s=r.find(i=>i.ok===!1||i.outcome==="failed")??null,h=s?c(s.id):null,p=h?n.find(i=>i.id===h)??null:null,f=h?o.find(i=>i.id===h)??null:null,y=[...o,...n];if(s===null&&y.every(i=>u.has(i.id)||a.get(i.id)?.outcome==="validated")){ee(e,o,a,u),te(e,n,a,u);return}if(ee(e,o.filter(i=>u.has(i.id)),a,u),te(e,n.filter(i=>u.has(i.id)),a,u),s){e.push("failed:"),p?e.push(`${p.entity} -> ${p.targetFile}`):f&&e.push(`${f.entity} -> ${f.newName}`);const i=_(s.response)?s.response:null,b=c(i?.code)??c(i?.errorCode)??c(s.statusCode),B=qe(c(s.error)??(i?c(i.error):null));b&&e.push(`code: ${b}`),B&&e.push(B)}const m=h??null,l=m?y.findIndex(i=>i.id===m):-1,g=y.filter((i,b)=>!u.has(i.id)&&i.id!==h&&(l<0||b>l||!a.has(i.id)));g.length>0&&(e.push("not run:"),e.push(re(g.map(i=>i.entity),15)))}function ee(e,t,r,n){const o=t.filter(a=>n.has(a.id)||r.get(a.id)?.outcome==="validated");if(o.length!==0){e.push("renames:");for(const a of o)e.push(`${a.entity} -> ${a.newName}`)}}function te(e,t,r,n){const o=t.filter(a=>n.has(a.id)||r.get(a.id)?.outcome==="validated");o.length!==0&&(e.push("moves:"),Oe(e,o))}function Oe(e,t){const r=new Map;for(const n of t){const o=r.get(n.targetFile)??[];o.push(n.entity),r.set(n.targetFile,o)}for(const[n,o]of r)e.push(`${n}: ${re(o,15)}`)}function Pe(e){return e==="moveRefactor"?"move":e==="renameSymbol"?"rename":e}function je(e){const t=e.indexOf(":");return t>=0?e.slice(t+1):e}function D(e){return Array.from(new Set(e))}function re(e,t){const r=e.slice(0,t),n=e.length-r.length;return n>0?`${r.join(", ")}, + ${n} more`:r.join(", ")}function qe(e){return e?.replace(/^TypeScript refactor failed: Debug Failure\. False expression: /,"")??null}function Ne(e){const t=Math.max(1,Math.round(e/1e3));return t<60?`~${t} sec`:`~${Math.max(1,Math.round(t/60))} min`}function _(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function k(e,t){const r=t.replace(/\\/g,"/"),n=e.replace(/\\/g,"/").replace(/\/$/,""),o=r.toLowerCase(),a=n.toLowerCase();return o.startsWith(`${a}/`)?r.slice(n.length+1):r}function Le(e){if(!e||typeof e!="object"||Array.isArray(e))return null;const t=e;return T({ok:t.ok===!0,code:c(t.code),errorCode:c(t.errorCode),error:c(t.error),hint:c(t.hint),execute:typeof t.execute=="boolean"?t.execute:null,applied:typeof t.applied=="boolean"?t.applied:null})}function c(e){return typeof e=="string"?e:null}function v(e){return typeof e=="number"?e:null}function E(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function T(e){return Object.fromEntries(Object.entries(e).filter(([,t])=>t==null?!1:!(Array.isArray(t)&&t.length===0)))}function z(e,t){const r=Array.isArray(e.operations)?e.operations:Array.isArray(e.requests)?e.requests:null;if(!r)return{...e,execute:t};const{operations:n,...o}=e;return{...o,requests:r.map(a=>a&&typeof a=="object"&&!Array.isArray(a)?{...a,execute:t}:a),execute:t}}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRefactorBatch = runRefactorBatch;
+exports.readCachedRefactorBatchExecution = readCachedRefactorBatchExecution;
+exports.formatRefactorBatchAgentText = formatRefactorBatchAgentText;
+const zod_1 = require("zod");
+const env_vars_1 = require("../config/env-vars");
+const agent_text_1 = require("../shared/agent-text");
+const semantic_mutation_runtime_1 = require("../mutation/semantic-mutation-runtime");
+const refactor_batch_execution_cache_1 = require("./refactor-batch-execution-cache");
+const mutation_execution_cache_1 = require("./mutation-execution-cache");
+const selector_suggestions_1 = require("./selector-suggestions");
+const RefactorBatchPayloadSchema = zod_1.z.object({
+    operations: zod_1.z.array(zod_1.z.unknown()).min(1).optional(),
+    requests: zod_1.z.array(zod_1.z.unknown()).min(1).optional(),
+    continueOnError: zod_1.z.boolean().optional(),
+    execution: zod_1.z.literal("sequential").optional()
+}).passthrough().refine((payload) => Array.isArray(payload.operations) || Array.isArray(payload.requests), {
+    message: "refactor batch expects operations[] or requests[]."
+});
+async function runRefactorBatch(cwd, rawPayload, options = {}, action = "preview", formatOptions = {}) {
+    if (action === "apply" && formatOptions.previewId) {
+        const runtime = await (0, semantic_mutation_runtime_1.runSemanticMutationRuntime)(cwd, undefined, options, "apply", {
+            operationPrefix: "refactor.batch",
+            previewApplyCommand: "aib refactor batch apply",
+            previewId: formatOptions.previewId,
+            syncWaitMs: readRefactorBatchSyncWaitMs(),
+            formatOptions: { ...formatOptions, previewId: formatOptions.previewId },
+            formatResult: (result, builder, response, runtimeAction, runtimeFormatOptions) => (0, agent_text_1.attachAgentText)(result, formatRefactorBatchAgentText(cwd, builder, response, runtimeAction, runtimeFormatOptions))
+        });
+        return runtime.result;
+    }
+    const payload = RefactorBatchPayloadSchema.parse(rawPayload);
+    const runtime = await (0, semantic_mutation_runtime_1.runSemanticMutationRuntime)(cwd, payload, options, readSemanticRuntimeAction(action), {
+        operationPrefix: "refactor.batch",
+        previewApplyCommand: "aib refactor batch apply",
+        syncWaitMs: readRefactorBatchSyncWaitMs(),
+        formatOptions,
+        formatResult: (result, builder, response, runtimeAction, runtimeFormatOptions) => (0, agent_text_1.attachAgentText)(result, formatRefactorBatchAgentText(cwd, builder, response, runtimeAction, runtimeFormatOptions))
+    });
+    return runtime.result;
+}
+function readSemanticRuntimeAction(action) {
+    return action === "execute" || action === "apply" || action === "validate" ? action : "preview";
+}
+function readCachedRefactorBatchExecution(cwd, executionId) {
+    const status = (0, refactor_batch_execution_cache_1.readRefactorBatchExecutionStatus)(cwd, executionId);
+    if ((status.status === "completed" || status.status === "failed") && status.result) {
+        return status.result;
+    }
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        status: status.status,
+        phase: status.phase,
+        summary: buildRefactorBatchExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        filesWritten: status.filesWritten,
+        updatedAt: status.updatedAt,
+        ...(status.journal ? { journal: status.journal } : {}),
+        ...(status.error ? { error: status.error } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatRefactorBatchExecutionStatusText(status));
+}
+function formatRefactorBatchAgentText(cwd, builder, response, action, options = {}) {
+    const rows = Array.isArray(response.rows) ? response.rows.filter((row) => Boolean(row) && typeof row === "object" && !Array.isArray(row)) : [];
+    const applied = rows.filter((row) => row.outcome === "applied").length;
+    const validated = rows.filter((row) => row.outcome === "validated").length;
+    const failed = typeof response.failedRowCount === "number" ? response.failedRowCount : rows.filter((row) => row.ok === false).length;
+    const manualExtractionRows = readManualExtractionRows(rows);
+    const mode = action === "execute" || action === "apply" || action === "validate" ? action : applied > 0 ? "apply" : "preview";
+    const lines = [];
+    const movePlan = readMovePlan(builder, cwd);
+    const renamePlan = readRenamePlan(builder);
+    lines.push(formatRefactorBatchHeader(mode, options));
+    lines.push(formatRefactorBatchSummaryLine(mode, { movePlan, renamePlan }, rows, applied, validated, failed, manualExtractionRows));
+    if (mode === "preview" && failed === 0 && manualExtractionRows.length === 0) {
+        if (options.next) {
+            lines.push(`next: ${options.next}`);
+        }
+        return lines.join("\n");
+    }
+    if ((movePlan || renamePlan) && rows.length > 0) {
+        appendRefactorPlanBatchLines(lines, { movePlan, renamePlan }, rows);
+    }
+    else {
+        for (const row of rows) {
+            const id = readString(row.id) ?? `row ${readNumber(row.index) ?? "?"}`;
+            const kind = readString(row.kind) ?? "operation";
+            const outcome = readString(row.outcome) ?? (row.ok === true ? "ok" : "failed");
+            lines.push(`${formatRefactorBatchRowKind(kind)} ${formatRefactorBatchRowEntity(id)} ${outcome}`);
+        }
+    }
+    const files = uniqueStrings(rows.flatMap((row) => options.includeTouchedFiles === true && (mode === "preview" || mode === "validate")
+        ? readStringArray(row.touchedFiles)
+        : readStringArray(row.savedFiles)));
+    if (files.length > 0) {
+        lines.push(mode === "preview" || mode === "validate" ? "files:" : "filesWritten:");
+        lines.push(...files);
+    }
+    if (options.next) {
+        lines.push(`next: ${options.next}`);
+    }
+    return lines.join("\n");
+}
+function buildRefactorBatchStillRunningResponse(cwd, executionId, operation, estimatedDurationMs, elapsedMs) {
+    const status = (0, refactor_batch_execution_cache_1.readRefactorBatchExecutionStatus)(cwd, executionId);
+    const estimatedRemainingMs = Math.max(0, estimatedDurationMs - elapsedMs);
+    const response = {
+        operation: "execution.status",
+        executionId: status.executionId,
+        status: status.status,
+        phase: status.phase,
+        summary: buildRefactorBatchExecutionSummary(status),
+        progress: `${status.completedRows}/${status.rowCount}`,
+        filesWritten: status.filesWritten,
+        updatedAt: status.updatedAt,
+        estimatedRemainingMs
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatRefactorBatchStillRunningText(operation, status, estimatedRemainingMs));
+}
+function formatRefactorBatchStillRunningText(operation, status, estimatedRemainingMs) {
+    const lines = [
+        `${operation} ${status.executionId}`,
+        buildRefactorBatchExecutionSummary(status),
+        "applying mutation",
+        estimatedRemainingMs > 0
+            ? `estimated remaining: ${formatDuration(Math.max(estimatedRemainingMs, 5_000))}`
+            : "estimated remaining: check status again soon"
+    ];
+    return lines.join("\n");
+}
+function formatRefactorBatchExecutionStatusText(status) {
+    const lines = [
+        `${status.operation} ${status.executionId}`,
+        buildRefactorBatchExecutionSummary(status)
+    ];
+    if (status.status === "running") {
+        lines.push("applying mutation");
+    }
+    if (status.error) {
+        lines.push(status.error);
+    }
+    return lines.join("\n");
+}
+function buildRefactorBatchExecutionSummary(status) {
+    if (status.status === "completed") {
+        return `completed, ${status.completedRows}/${status.rowCount} rows, ${status.filesWritten.length} files written`;
+    }
+    if (status.status === "failed") {
+        return `failed, ${status.completedRows}/${status.rowCount} rows, ${status.failedRows} failed`;
+    }
+    return `in progress, ${status.completedRows}/${status.rowCount} rows`;
+}
+function readRefactorBatchSyncWaitMs() {
+    return (0, mutation_execution_cache_1.readMutationSyncWaitMs)(process.env[env_vars_1.CLI_ENV.refactorBatchSyncWaitMs], 120_000);
+}
+function formatRefactorBatchHeader(mode, options) {
+    const operation = options.operationLabel ??
+        (options.routedFrom === "move.toFile" || options.routedFrom === "rename"
+            ? options.routedFrom
+            : "refactor.batch");
+    return mode === "preview" && options.previewId
+        ? `${operation}.preview ${options.previewId}`
+        : `${operation}.${mode}`;
+}
+function formatRefactorBatchSummaryLine(mode, plan, rows, applied, validated, failed, manualExtractionRows = []) {
+    const moveRows = plan.movePlan?.rows ?? [];
+    const renameRows = plan.renamePlan?.rows ?? [];
+    if (moveRows.length === 0 && renameRows.length === 0) {
+        return `${rows.length} rows, ${applied > 0 ? `${applied} applied` : `${validated} validated`}${failed > 0 ? `, ${failed} failed` : ""}`;
+    }
+    const rowById = new Map(rows.map((row) => [readString(row.id), row]).filter((entry) => Boolean(entry[0])));
+    const failedRow = rows.find((row) => row.ok === false || row.outcome === "failed") ?? null;
+    const failedId = failedRow ? readString(failedRow.id) : null;
+    const failedIsMove = failedId ? moveRows.some((row) => row.id === failedId) : false;
+    const failedIsRename = failedId ? renameRows.some((row) => row.id === failedId) : false;
+    const appliedIds = new Set(rows.filter((row) => row.outcome === "applied").map((row) => readString(row.id)).filter((id) => Boolean(id)));
+    const validatedIds = new Set(rows.filter((row) => row.outcome === "validated").map((row) => readString(row.id)).filter((id) => Boolean(id)));
+    const targetCount = new Set(moveRows.map((row) => row.targetFile)).size;
+    const filesWritten = uniqueStrings(rows.flatMap((row) => readStringArray(row.savedFiles))).length;
+    const completedMoveCount = moveRows.filter((row) => appliedIds.has(row.id) || validatedIds.has(row.id)).length;
+    const completedRenameCount = renameRows.filter((row) => appliedIds.has(row.id) || validatedIds.has(row.id)).length;
+    const manualExtractionCount = manualExtractionRows.length;
+    const manualExtractionIds = new Set(manualExtractionRows.map((row) => readString(row.id)).filter((id) => Boolean(id)));
+    const nonManualFailedCount = Math.max(0, failed - manualExtractionCount);
+    if (failedRow) {
+        const planRows = [...renameRows, ...moveRows];
+        const terminalIndex = failedId ? planRows.findIndex((row) => row.id === failedId) : -1;
+        const notRunCount = planRows.filter((row, index) => !appliedIds.has(row.id) &&
+            !validatedIds.has(row.id) &&
+            !manualExtractionIds.has(row.id) &&
+            row.id !== failedId &&
+            (terminalIndex < 0 || index > terminalIndex || !rowById.has(row.id))).length;
+        const parts = [];
+        if (completedRenameCount > 0) {
+            parts.push(`${completedRenameCount} ${completedRenameCount === 1 ? "rename" : "renames"} applied`);
+        }
+        if (completedMoveCount > 0) {
+            parts.push(`${completedMoveCount} ${completedMoveCount === 1 ? "symbol" : "symbols"} moved`);
+        }
+        if (manualExtractionCount > 0) {
+            parts.push(`${manualExtractionCount} manual extraction required`);
+        }
+        if (nonManualFailedCount > 0) {
+            parts.push(failedIsMove ? "1 symbol failed" : failedIsRename ? "1 rename failed" : `${nonManualFailedCount} failed`);
+        }
+        if (notRunCount > 0) {
+            parts.push(`${notRunCount} not run`);
+        }
+        return parts.join(", ");
+    }
+    const baseParts = [];
+    if (renameRows.length > 0) {
+        baseParts.push(`${renameRows.length} ${renameRows.length === 1 ? "rename" : "renames"}`);
+    }
+    if (moveRows.length > 0) {
+        baseParts.push(`${moveRows.length} ${moveRows.length === 1 ? "symbol" : "symbols"}`);
+        baseParts.push(`${targetCount} ${targetCount === 1 ? "target" : "targets"}`);
+    }
+    const base = baseParts.join(", ");
+    if (mode === "preview" || mode === "validate") {
+        return `${base} ready`;
+    }
+    const verb = renameRows.length > 0 ? "applied" : "moved";
+    return filesWritten > 0 ? `${base} ${verb}; ${filesWritten} ${filesWritten === 1 ? "file" : "files"} written` : `${base} ${verb}`;
+}
+function readMovePlan(builder, cwd) {
+    const sourceRows = Array.isArray(builder.rows) ? builder.rows.filter(isJsonObject) : [];
+    const moveRows = sourceRows.filter((row) => readString(row.op) === "move");
+    if (moveRows.length === 0) {
+        return null;
+    }
+    const rows = [];
+    for (const sourceRow of moveRows) {
+        const sourceFile = readString(sourceRow.sourceFile);
+        const builtRows = Array.isArray(sourceRow.builtRows) ? sourceRow.builtRows.filter(isJsonObject) : [];
+        for (const builtRow of builtRows) {
+            const id = readString(builtRow.id);
+            const entity = readString(builtRow.entity);
+            const targetFile = readString(builtRow.targetFile);
+            if (id && entity && sourceFile && targetFile) {
+                rows.push({
+                    id,
+                    entity,
+                    sourceFile,
+                    targetFile: compactPath(cwd, targetFile)
+                });
+            }
+        }
+    }
+    return rows.length > 0 ? { rows } : null;
+}
+function readRenamePlan(builder) {
+    const sourceRows = Array.isArray(builder.rows) ? builder.rows.filter(isJsonObject) : [];
+    const renameRows = sourceRows.filter((row) => readString(row.op) === "rename");
+    if (renameRows.length === 0) {
+        return null;
+    }
+    const rows = [];
+    for (const sourceRow of renameRows) {
+        const builtRows = Array.isArray(sourceRow.builtRows) ? sourceRow.builtRows.filter(isJsonObject) : [];
+        for (const builtRow of builtRows) {
+            const id = readString(builtRow.id);
+            const entity = readString(builtRow.entity);
+            const newName = readString(builtRow.newName);
+            if (id && entity && newName) {
+                rows.push({ id, entity, newName });
+            }
+        }
+    }
+    return rows.length > 0 ? { rows } : null;
+}
+function appendRefactorPlanBatchLines(lines, plan, rows) {
+    const moveRows = plan.movePlan?.rows ?? [];
+    const renameRows = plan.renamePlan?.rows ?? [];
+    const rowById = new Map(rows.map((row) => [readString(row.id), row]).filter((entry) => Boolean(entry[0])));
+    const appliedIds = new Set(rows.filter((row) => row.outcome === "applied").map((row) => readString(row.id)).filter((id) => Boolean(id)));
+    const manualExtractionRows = readManualExtractionRows(rows);
+    const manualExtractionIds = new Set(manualExtractionRows.map((row) => readString(row.id)).filter((id) => Boolean(id)));
+    const failedRow = rows.find((row) => (row.ok === false || row.outcome === "failed") && !isManualExtractionRow(row)) ?? null;
+    const failedId = failedRow ? readString(failedRow.id) : null;
+    const failedMoveRow = failedId ? moveRows.find((row) => row.id === failedId) ?? null : null;
+    const failedRenameRow = failedId ? renameRows.find((row) => row.id === failedId) ?? null : null;
+    const planRows = [...renameRows, ...moveRows];
+    const allSucceeded = failedRow === null &&
+        manualExtractionRows.length === 0 &&
+        planRows.every((row) => appliedIds.has(row.id) || rowById.get(row.id)?.outcome === "validated");
+    if (allSucceeded) {
+        appendRenameLines(lines, renameRows, rowById, appliedIds);
+        appendMoveLines(lines, moveRows, rowById, appliedIds);
+        return;
+    }
+    appendRenameLines(lines, renameRows.filter((row) => appliedIds.has(row.id)), rowById, appliedIds);
+    appendMoveLines(lines, moveRows.filter((row) => appliedIds.has(row.id)), rowById, appliedIds);
+    appendManualExtractionRequiredLines(lines, moveRows.filter((row) => manualExtractionIds.has(row.id)));
+    if (failedRow) {
+        lines.push("failed:");
+        const nestedResponse = isJsonObject(failedRow.response) ? failedRow.response : null;
+        const error = normalizeRefactorBatchError(readString(failedRow.error) ?? (nestedResponse ? readString(nestedResponse.error) : null));
+        if (failedMoveRow && isAmbiguousTopLevelSymbolError(error)) {
+            appendAmbiguousMoveSelectorLines(lines, failedMoveRow);
+        }
+        else if (failedMoveRow) {
+            lines.push(`${failedMoveRow.entity} -> ${failedMoveRow.targetFile}`);
+        }
+        else if (failedRenameRow) {
+            lines.push(`${failedRenameRow.entity} -> ${failedRenameRow.newName}`);
+        }
+        const code = readString(nestedResponse?.code) ?? readString(nestedResponse?.errorCode) ?? readString(failedRow.statusCode);
+        if (code) {
+            lines.push(`code: ${code}`);
+        }
+        if (error && !(failedMoveRow && isAmbiguousTopLevelSymbolError(error))) {
+            lines.push(error);
+        }
+    }
+    const terminalId = failedId ?? null;
+    const terminalIndex = terminalId ? planRows.findIndex((row) => row.id === terminalId) : -1;
+    const notRunRows = planRows.filter((row, index) => !appliedIds.has(row.id) &&
+        !manualExtractionIds.has(row.id) &&
+        row.id !== failedId &&
+        (terminalIndex < 0 || index > terminalIndex || !rowById.has(row.id)));
+    if (notRunRows.length > 0) {
+        lines.push("not run:");
+        lines.push(formatInlineList(notRunRows.map((row) => row.entity), 15));
+    }
+}
+function appendRenameLines(lines, rows, rowById, appliedIds) {
+    const visibleRows = rows.filter((row) => appliedIds.has(row.id) || rowById.get(row.id)?.outcome === "validated");
+    if (visibleRows.length === 0) {
+        return;
+    }
+    lines.push("renames:");
+    for (const row of visibleRows) {
+        lines.push(`${row.entity} -> ${row.newName}`);
+    }
+}
+function appendMoveLines(lines, rows, rowById, appliedIds) {
+    const visibleRows = rows.filter((row) => appliedIds.has(row.id) || rowById.get(row.id)?.outcome === "validated");
+    if (visibleRows.length === 0) {
+        return;
+    }
+    lines.push("moves:");
+    appendGroupedMoves(lines, visibleRows);
+}
+function appendGroupedMoves(lines, rows) {
+    const byTarget = new Map();
+    for (const row of rows) {
+        const list = byTarget.get(row.targetFile) ?? [];
+        list.push(row.entity);
+        byTarget.set(row.targetFile, list);
+    }
+    for (const [target, entities] of byTarget) {
+        lines.push(`${target}: ${formatInlineList(entities, 15)}`);
+    }
+}
+function appendManualExtractionRequiredLines(lines, rows) {
+    if (rows.length === 0) {
+        return;
+    }
+    lines.push("manualExtractionRequired:");
+    appendGroupedMoves(lines, rows);
+    lines.push("reason: TypeScript move-to-file provider cannot produce edits for these symbols.");
+    lines.push("next: use manual extraction for listed symbols");
+}
+function appendAmbiguousMoveSelectorLines(lines, row) {
+    lines.push(`ambiguous entity: ${row.entity}`);
+    const selectors = (0, selector_suggestions_1.readTopLevelSelectorSuggestions)(row.sourceFile, row.entity, {
+        entityKindAliases: {
+            class: "c",
+            interface: "i",
+            type: "t",
+            function: "f",
+            variable: "v",
+            enum: "e",
+            namespace: "ns",
+            method: "m",
+            property: "p"
+        },
+        selectorSeparator: "-"
+    });
+    if (selectors.length === 0) {
+        return;
+    }
+    lines.push("");
+    lines.push("Use available:");
+    lines.push(`- ${selectors.join(", ")}`);
+}
+function formatRefactorBatchRowKind(kind) {
+    if (kind === "moveRefactor") {
+        return "move";
+    }
+    if (kind === "renameSymbol") {
+        return "rename";
+    }
+    return kind;
+}
+function formatRefactorBatchRowEntity(id) {
+    const separator = id.indexOf(":");
+    return separator >= 0 ? id.slice(separator + 1) : id;
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values));
+}
+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 normalizeRefactorBatchError(error) {
+    return error?.replace(/^TypeScript refactor failed: Debug Failure\. False expression: /, "") ?? null;
+}
+function isAmbiguousTopLevelSymbolError(error) {
+    return typeof error === "string" && error.startsWith("Ambiguous top-level symbol:");
+}
+function readManualExtractionRows(rows) {
+    return rows.filter(isManualExtractionRow);
+}
+function isManualExtractionRow(row) {
+    const response = isJsonObject(row.response) ? row.response : null;
+    const code = readString(response?.code);
+    const error = normalizeRefactorBatchError(readString(row.error) ?? readString(response?.error));
+    return code === "TS_MOVE_TO_FILE_UNSUPPORTED_BY_ENGINE" ||
+        (code === "TS_MOVE_TO_FILE_REFACTOR_FAILED" && /Changes overlap/i.test(error ?? ""));
+}
+function formatDuration(milliseconds) {
+    const seconds = Math.max(1, Math.round(milliseconds / 1000));
+    if (seconds < 60) {
+        return `~${seconds} sec`;
+    }
+    const minutes = Math.max(1, Math.round(seconds / 60));
+    return `~${minutes} min`;
+}
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function compactPath(cwd, filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    const cwdNormalized = cwd.replace(/\\/g, "/").replace(/\/$/, "");
+    const lower = normalized.toLowerCase();
+    const cwdLower = cwdNormalized.toLowerCase();
+    return lower.startsWith(`${cwdLower}/`) ? normalized.slice(cwdNormalized.length + 1) : normalized;
+}
+function readString(value) {
+    return typeof value === "string" ? value : null;
+}
+function readNumber(value) {
+    return typeof value === "number" ? value : null;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+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);
+    }));
+}