@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/commands/normalize-imports.js

@@ -1,4 +1,1120 @@
-"use strict";var G=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){n===void 0&&(n=r);var i=Object.getOwnPropertyDescriptor(t,r);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,i)}):(function(e,t,r,n){n===void 0&&(n=r),e[n]=t[r]})),H=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),R=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)Object.prototype.hasOwnProperty.call(r,i)&&(n[n.length]=i);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var n=e(t),i=0;i<n.length;i++)n[i]!=="default"&&G(r,t,n[i]);return H(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runNormalizeImports=te,exports.readWorkspaceNormalizeImportRules=B;const K=R(require("node:crypto")),u=R(require("node:fs")),c=R(require("node:path")),m=require("../shared/errors"),Y=require("./json-file-input"),q=require("./workspace-cache"),E=[".ts",".tsx",".mts",".cts"],N=[".ts",".tsx",".mts",".cts",".js",".jsx",".mjs",".cjs"],ee=new Set(["node_modules",".git","dist","out","build",".tmp"]);function te(e,t,r){const n=xe(e,t);if(n.action==="apply"){const l=n.applyPlanId;if(!l)throw new m.CliError("NORMALIZE_IMPORTS_PLAN_REQUIRED","imports normalize apply expects a preview id.");return re(e,l,n.showAll)}if(n.action==="show"){const l=n.showPlanId;if(!l)throw new m.CliError("NORMALIZE_IMPORTS_PLAN_REQUIRED","imports normalize show expects a preview id.");return ne(e,l,n.showAll)}const i=x(t,"--from-json"),o=r!==void 0?oe(r):i?(0,Y.readJsonObjectFile)(e,i,"INVALID_NORMALIZE_IMPORTS_JSON_FILE"):null;if(o){const a=ie(e,o,n).map(f=>C(e,f));return a.length===1?a[0]:{ok:a.every(f=>f.ok!==!1),operation:"imports.normalizeBatch",results:a}}const s=n.positionals[0];if(!s)throw new m.CliError("NORMALIZE_IMPORTS_SCOPE_REQUIRED","normalizeImports expects a file or directory scope.");return C(e,L(e,{scope:s,action:n.action,...n.mode!==void 0?{mode:n.mode}:{},...n.preferAlias!==void 0?{preferAlias:n.preferAlias}:{},exclude:n.exclude,ruleSources:n.ruleSources,showAll:n.showAll},n.rules))}function C(e,t){if(!t.scope)throw new m.CliError("NORMALIZE_IMPORTS_SCOPE_REQUIRED","normalizeImports JSON requests expect scope, file, dir, or directory.");const r=U(c.resolve(e,t.scope),e,t.exclude),n=new Map,i=r.flatMap(l=>se(e,l,t.mode,t.preferAlias,n)),o=new Set(i.map(l=>l.file)).size;t.action==="execute"&&D(e,i);const s={ok:!0,operation:"imports.normalize",mode:t.action,target:t.mode,filesScanned:r.length,filesChanged:o,edits:i.length,...t.exclude.length>0?{exclude:t.exclude}:{},...t.ruleSources.length>0?{ruleSources:t.ruleSources.map(l=>I(e,l))}:{},...z(i,t.showAll),next:t.action==="execute"?"Run typecheck or targeted validation for the affected project.":"Rerun with execute or apply the preview id if the preview matches intent."};if(t.action==="preview"){const l=ze(e,t,i);Pe(e,{planId:l,createdAt:new Date().toISOString(),cwd:e,request:t,files:Me(e,i),edits:i}),s.planId=l,s.next=`aib imports normalize apply ${l}`}return s}function re(e,t,r=!1){const n=k(e,t),i=Object.entries(n.files).filter(([o,s])=>{const l=c.resolve(e,o);return!u.existsSync(l)||b(u.readFileSync(l))!==s}).map(([o])=>o);if(i.length>0)throw new m.CliError("NORMALIZE_IMPORTS_PLAN_STALE",`imports normalize plan is stale: ${t}`,{planId:t,staleFiles:i.slice(0,20),...i.length>20?{hidden:`+ ${i.length-20} more stale files`}:{}});return D(e,n.edits),{ok:!0,operation:"imports.normalize",mode:"apply",planId:t,target:n.request.mode,filesChanged:new Set(n.edits.map(o=>o.file)).size,edits:n.edits.length,...z(n.edits,r),next:"Run typecheck or targeted validation for the affected project."}}function ne(e,t,r){const n=k(e,t);return{ok:!0,operation:"imports.normalize",mode:"show",planId:t,target:n.request.mode,filesChanged:new Set(n.edits.map(i=>i.file)).size,edits:n.edits.length,...z(n.edits,r),next:`aib imports normalize apply ${t}`}}function ie(e,t,r){const n=P(t),i=[...r.rules,...n],o=v(t,r);return(Array.isArray(t.requests)?t.requests:[t]).map((l,a)=>{if(!S(l))throw new m.CliError("INVALID_NORMALIZE_IMPORTS_REQUEST",`normalizeImports request at index ${a} must be an object.`);return L(e,v({...o,...l},r),i)})}function v(e,t){const r=p(e.scope)??p(e.file)??p(e.dir)??p(e.directory),n=t.action==="show"?"preview":t.action;return{scope:r??"",...T(e,t)!==void 0?{mode:T(e,t)}:{},action:e.execute===!0?"execute":n,...p(e.preferAlias)?{preferAlias:p(e.preferAlias)}:{},exclude:A([...t.exclude,...g(e.exclude),...g(e.excludes)]),ruleSources:t.ruleSources,showAll:t.showAll||e.all===!0||e.details==="all"}}function L(e,t,r=[]){const n=B(e),s=[...n.rules,...r].filter(f=>Re(e,t.scope,f)).sort((f,d)=>Q(d)-Q(f))[0],l=t.mode??s?.mode??"relative",a=t.preferAlias??s?.preferAlias;return{scope:t.scope,mode:l,action:t.action,...a?{preferAlias:a}:{},exclude:A([...s?.exclude??[],...t.exclude]),ruleSources:A([...n.sources,...t.ruleSources]),showAll:t.showAll}}function T(e,t){const r=p(e.to)??p(e.mode)??t.mode;if(r!==void 0){if(V(r))return r;throw new m.CliError("INVALID_NORMALIZE_IMPORTS_MODE","normalizeImports to/mode expects relative, alias, or shortestAlias.")}}function oe(e){if(!je(e))throw new m.CliError("INVALID_NORMALIZE_IMPORTS_STDIN","normalizeImports --stdin expects a JSON object payload.");return e}function se(e,t,r,n,i){const o=u.readFileSync(t,"utf8"),s=pe(t,e,i),l=[],a=/\b(from\s+["']|import\s*\(\s*["'])([^"']+)(["'])/g;for(const f of o.matchAll(a)){const d=f[2];if(!d)continue;const h=le(t,d,s);if(!h)continue;const y=r==="relative"?ce(t,h):ue(h,s,n,r);!y||y===d||l.push({file:I(e,t),from:d,to:y})}return l}function D(e,t){const r=new Map;for(const n of t){const i=r.get(n.file)??[];i.push(n),r.set(n.file,i)}for(const[n,i]of r.entries()){const o=c.resolve(e,n);let s=u.readFileSync(o,"utf8");for(const l of i)s=s.replace(new RegExp(F(`"${l.from}"`),"g"),`"${l.to}"`),s=s.replace(new RegExp(F(`'${l.from}'`),"g"),`'${l.to}'`);u.writeFileSync(o,s)}}function U(e,t,r){if(!u.existsSync(e))throw new m.CliError("NORMALIZE_IMPORTS_SCOPE_NOT_FOUND",`Scope does not exist: ${e}`);if(M(t,e,r))return[];const n=u.statSync(e);if(n.isFile())return $(e)?[e]:[];if(!n.isDirectory())return[];const i=[];for(const o of u.readdirSync(e,{withFileTypes:!0})){const s=c.join(e,o.name);if(o.isDirectory()){!ee.has(o.name)&&!M(t,s,r)&&i.push(...U(s,t,r));continue}o.isFile()&&$(s)&&!M(t,s,r)&&i.push(s)}return i.sort()}function le(e,t,r){if(t.startsWith("."))return J(c.resolve(c.dirname(e),t));if(!r)return null;for(const n of r.mappings){const i=Se(t,n);if(i!==null)for(const o of n.targets){const s=o.includes("*")?o.replace(/\*/g,i):o,l=J(c.resolve(n.baseUrl,s));if(l)return l}}return null}function ce(e,t){const r=c.dirname(e),n=O(t);let i=c.relative(r,n).replace(/\\/g,"/");return i.startsWith(".")||(i=`./${i}`),`${i}.js`}function ue(e,t,r,n){if(!t||t.mappings.length===0)return null;const i=ae(e,t,r);return(n==="shortestAlias"?i.sort((s,l)=>s.specifier.length-l.specifier.length||s.specifier.localeCompare(l.specifier)):i.sort((s,l)=>l.specificity-s.specificity||s.specifier.length-l.specifier.length||s.specifier.localeCompare(l.specifier)))[0]?.specifier??null}function ae(e,t,r){const n=O(e);return t.mappings.filter(i=>!r||i.pattern===r).flatMap(i=>i.targets.map(o=>{const s=fe(n,i,o);return s?{specifier:s,pattern:i.pattern,specificity:i.specificity}:null}).filter(o=>o!==null))}function fe(e,t,r){const n=r.indexOf("*");if(n<0)return O(c.resolve(t.baseUrl,r))===e&&!t.pattern.includes("*")?t.pattern:null;const i=O(c.resolve(t.baseUrl,r.slice(0,n))),o=O(r.slice(n+1));if(!e.startsWith(i)||o&&!e.endsWith(o))return null;const s=e.slice(i.length,o?-o.length:void 0).replace(/^[/\\]/,"");return t.pattern.replace("*",s.replace(/\\/g,"/"))}function pe(e,t,r){let n=c.dirname(e);const i=c.parse(c.resolve(t)).root;for(;;){const o=c.join(n,"tsconfig.json");if(u.existsSync(o))return W(o,r);const s=c.dirname(n);if(s===n||n===i)return null;n=s}}function W(e,t){const r=c.resolve(e);if(t.has(r))return t.get(r)??null;t.set(r,null);try{const n=w(u.readFileSync(r,"utf8")),i=de(r,n,t),o=S(n.compilerOptions)?n.compilerOptions:{},s=typeof o.baseUrl=="string"?c.resolve(c.dirname(r),o.baseUrl):i?.baseUrl??c.dirname(r),l=S(o.paths)?o.paths:null,a=(l?Object.entries(l).flatMap(([d,h])=>Array.isArray(h)?he(d,h.filter(y=>typeof y=="string"),s):[]):i?.mappings??[]).sort((d,h)=>h.specificity-d.specificity||d.pattern.localeCompare(h.pattern)),f={configPath:r,baseUrl:s,mappings:a};return t.set(r,f),f}catch{return t.set(r,null),null}}function de(e,t,r){const n=p(t.extends);if(!n)return null;const i=me(e,n);return i?W(i,r):null}function me(e,t){const r=[];return t.startsWith(".")||c.isAbsolute(t)?r.push(c.resolve(c.dirname(e),t)):r.push(c.resolve(c.dirname(e),"node_modules",t)),r.flatMap(i=>c.extname(i)?[i]:[`${i}.json`,c.join(i,"tsconfig.json")]).find(i=>u.existsSync(i)&&u.statSync(i).isFile())??null}function he(e,t,r){const n=e.indexOf("*");return[{pattern:e,prefix:n>=0?e.slice(0,n):e,suffix:n>=0?e.slice(n+1):"",targets:t,specificity:e.replace("*","").length,baseUrl:r}]}function Se(e,t){return t.pattern.includes("*")?!e.startsWith(t.prefix)||!e.endsWith(t.suffix)?null:e.slice(t.prefix.length,e.length-t.suffix.length):e===t.pattern?"":null}function J(e){const t=new Set;t.add(e);const r=c.extname(e);if(r&&[".js",".jsx",".mjs",".cjs"].includes(r)){const n=e.slice(0,-r.length);for(const i of E)t.add(`${n}${i}`)}if(!r)for(const n of N)t.add(`${e}${n}`);for(const n of N)t.add(c.join(e,`index${n}`));for(const n of t)if(u.existsSync(n)&&u.statSync(n).isFile()&&$(n))return n;return null}function w(e){const t=ye(e),r=JSON.parse(t.replace(/,\s*([}\]])/g,"$1"));return S(r)?r:{}}function ye(e){let t="",r=!1,n=!1;for(let i=0;i<e.length;i+=1){const o=e[i]??"",s=e[i+1]??"";if(r){t+=o,n?n=!1:o==="\\"?n=!0:o==='"'&&(r=!1);continue}if(o==='"'){r=!0,t+=o;continue}if(o==="/"&&s==="/"){for(;i<e.length&&e[i]!==`
-`;)i+=1;t+=`
-`;continue}if(o==="/"&&s==="*"){for(i+=2;i<e.length&&!(e[i]==="*"&&e[i+1]==="/");)i+=1;i+=1;continue}t+=o}return t}function x(e,t){const r=e.indexOf(t);return r>=0?e[r+1]:void 0}function xe(e,t){const r=t.filter((h,y)=>!h.startsWith("--")&&!Oe(t,y)),n=r[0],i=n==="preview"||n==="apply"||n==="execute"||n==="show"?n:t.includes("--execute")?"execute":"preview",o=n===i?r.slice(1):r,s=x(t,"--to"),l=s===void 0?void 0:Z(s),a=x(t,"--rules")??x(t,"--rules-file"),f=[],d=a?ge(c.resolve(e,a),f):[];return{action:i,...i==="apply"&&o[0]?{applyPlanId:o[0]}:{},...i==="show"&&o[0]?{showPlanId:o[0]}:{},positionals:i==="apply"||i==="show"?o.slice(1):o,...l!==void 0?{mode:l}:{},...x(t,"--prefer-alias")!==void 0?{preferAlias:x(t,"--prefer-alias")}:{},exclude:Ie(t,"--exclude"),rules:d,ruleSources:f,showAll:t.includes("--all")||t.includes("--details")||t.includes("--full")}}function Z(e){if(V(e))return e;throw new m.CliError("INVALID_NORMALIZE_IMPORTS_MODE","normalizeImports --to expects relative, alias, or shortestAlias.")}function V(e){return e==="relative"||e==="alias"||e==="shortestAlias"}function Ie(e,t){const r=[];for(let n=0;n<e.length;n+=1)e[n]===t&&typeof e[n+1]=="string"&&(r.push(e[n+1]),n+=1);return r}function Oe(e,t){const r=e[t-1];return t>0&&r!==void 0&&_e.has(r)}const _e=new Set(["--to","--prefer-alias","--exclude","--from-json","--from-dsl","--from","--rules","--rules-file"]);function z(e,t){const r=t?e:e.slice(0,12);return{samples:r.map(n=>`${n.file}: ${n.from} -> ${n.to}`),...!t&&e.length>r.length?{hidden:`+ ${e.length-r.length} more edits`}:{}}}function ge(e,t){if(!u.existsSync(e)||!u.statSync(e).isFile())throw new m.CliError("NORMALIZE_IMPORTS_RULES_NOT_FOUND",`imports normalize rules file not found: ${e}`);return t.push(e),P(w(u.readFileSync(e,"utf8")))}function B(e){const t=be(e),r=[],n=[];for(const i of t){const o=c.join(i,"aib.json");if(!(!u.existsSync(o)||!u.statSync(o).isFile()))try{const s=P(w(u.readFileSync(o,"utf8")));s.length>0&&(r.push(...s),n.push(o))}catch{}}return{rules:r,sources:n}}function P(e){const t=S(e.aib)?e.aib:{};return[e.importNormalize,e.importsNormalize,e["imports.normalize"],t.importNormalize,t.importsNormalize,t["imports.normalize"]].flatMap(n=>Ae(n))}function Ae(e){return Array.isArray(e)?e.flatMap(t=>S(t)?[_(t)]:[]):S(e)?Array.isArray(e.rules)?e.rules.flatMap(t=>S(t)?[_(t)]:[]):Array.isArray(e.requests)?e.requests.flatMap(t=>S(t)?[_(t)]:[]):[_(e)]:[]}function _(e){const t=p(e.to)??p(e.mode);return{...p(e.scope)?{scope:p(e.scope)}:{},...t!==null?{mode:Z(t)}:{},...p(e.preferAlias)?{preferAlias:p(e.preferAlias)}:{},exclude:A([...g(e.exclude),...g(e.excludes)])}}function Re(e,t,r){if(!r.scope)return!0;const n=I(e,c.resolve(e,t)),i=I(e,c.resolve(e,r.scope));return n===i||n.startsWith(`${i}/`)||i.startsWith(`${n}/`)}function Q(e){return e.scope?e.scope.length:0}function M(e,t,r){if(r.length===0)return!1;const n=I(e,c.resolve(t));return r.some(i=>Ee(e,n,i))}function Ee(e,t,r){const n=I(e,c.isAbsolute(r)?r:c.resolve(e,r));return Ne(r)?we(r.replace(/\\/g,"/")).test(t):t===n||t.startsWith(`${n}/`)}function Ne(e){return/[*?]/.test(e)}function we(e){let t="";for(let r=0;r<e.length;r+=1){const n=e[r];n==="*"?e[r+1]==="*"?(t+=".*",r+=1):t+="[^/]*":n==="?"?t+="[^/]":t+=F(n??"")}return new RegExp(`^${t}$`)}function ze(e,t,r){return`imports_${b(j({cwd:e,request:t,edits:r})).slice(0,8)}`}function Pe(e,t){const r=X(e,t.planId);u.mkdirSync(c.dirname(r),{recursive:!0}),u.writeFileSync(r,`${JSON.stringify(t,null,2)}
-`)}function k(e,t){const r=X(e,t);if(!u.existsSync(r))throw new m.CliError("NORMALIZE_IMPORTS_PLAN_NOT_FOUND",`imports normalize plan not found: ${t}`,{planId:t,expectedPath:r});return JSON.parse(u.readFileSync(r,"utf8"))}function X(e,t){return(0,q.workspaceCachePath)(e,"imports-normalize",`${t.replace(/[^a-z0-9_-]+/gi,"-")}.json`)}function Me(e,t){const r={};for(const n of new Set(t.map(i=>i.file)))r[n]=b(u.readFileSync(c.resolve(e,n)));return r}function be(e){const t=[];let r=c.resolve(e);const n=c.parse(r).root;for(;t.push(r),r!==n;){const i=c.dirname(r);if(i===r)break;r=i}return t.reverse()}function b(e){return K.createHash("sha256").update(e).digest("hex")}function j(e){return e===null||typeof e!="object"?JSON.stringify(e):Array.isArray(e)?`[${e.map(t=>j(t)).join(",")}]`:`{${Object.entries(e).sort(([t],[r])=>t.localeCompare(r)).map(([t,r])=>`${JSON.stringify(t)}:${j(r)}`).join(",")}}`}function p(e){return typeof e=="string"&&e.trim()!==""?e.trim():null}function g(e){return typeof e=="string"&&e.trim()!==""?[e.trim()]:Array.isArray(e)?e.filter(t=>typeof t=="string").map(t=>t.trim()).filter(t=>t.length>0):[]}function A(e){return Array.from(new Set(e))}function $(e){return E.includes(c.extname(e))&&!e.endsWith(".d.ts")}function O(e){const t=c.extname(e);return E.includes(t)||N.includes(t)?e.slice(0,-t.length):e}function S(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function je(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function I(e,t){return c.relative(e,t).replace(/\\/g,"/")}function F(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNormalizeImports = runNormalizeImports;
+exports.readWorkspaceNormalizeImportRules = readWorkspaceNormalizeImportRules;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const workspace_root_1 = require("../config/workspace-root");
+const errors_1 = require("../shared/errors");
+const import_specifier_policy_1 = require("./import-specifier-policy");
+const json_file_input_1 = require("./json-file-input");
+const session_workspace_1 = require("./session-workspace");
+const workspace_cache_1 = require("./workspace-cache");
+const SOURCE_EXTENSIONS = [".ts", ".tsx", ".mts", ".cts"];
+const IMPORT_EXTENSIONS = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
+const EXCLUDED_DIRS = new Set(["node_modules", ".git", "dist", "out", "build", ".tmp"]);
+const NORMALIZE_VISIBLE_SAMPLE_LIMIT = 5;
+const NORMALIZE_VISIBLE_FILE_LIMIT = 12;
+function runNormalizeImports(cwd, restArgs, stdinPayload) {
+    const parsedArgs = parseNormalizeArgs(cwd, restArgs);
+    if (parsedArgs.action === "apply") {
+        const planId = parsedArgs.applyPlanId;
+        if (!planId) {
+            throw new errors_1.CliError("NORMALIZE_IMPORTS_PLAN_REQUIRED", "imports normalize apply expects a preview id.");
+        }
+        return applyNormalizeImportsPlan(cwd, planId, parsedArgs.showAll);
+    }
+    if (parsedArgs.action === "show") {
+        const planId = parsedArgs.showPlanId;
+        if (!planId) {
+            throw new errors_1.CliError("NORMALIZE_IMPORTS_PLAN_REQUIRED", "imports normalize show expects a preview id.");
+        }
+        return showNormalizeImportsPlan(cwd, planId, parsedArgs.showAll);
+    }
+    const fromJson = readFlagValue(restArgs, "--from-json");
+    const payload = stdinPayload !== undefined
+        ? assertNormalizeImportsPayload(stdinPayload)
+        : fromJson
+            ? (0, json_file_input_1.readJsonObjectFile)(cwd, fromJson, "INVALID_NORMALIZE_IMPORTS_JSON_FILE")
+            : null;
+    if (payload) {
+        const requests = expandNormalizeImportsPayload(cwd, payload, parsedArgs);
+        const results = requests.map((request) => runNormalizeImportsRequest(cwd, request));
+        return results.length === 1
+            ? results[0]
+            : {
+                ok: results.every((result) => result.ok !== false),
+                operation: "imports.normalizeBatch",
+                results
+            };
+    }
+    const scope = parsedArgs.positionals[0];
+    if (!scope) {
+        throw new errors_1.CliError("NORMALIZE_IMPORTS_SCOPE_REQUIRED", "normalizeImports expects a file or directory scope.");
+    }
+    return runNormalizeImportsRequest(cwd, finalizeNormalizeImportsRequest(cwd, {
+        scope,
+        action: parsedArgs.action,
+        ...(parsedArgs.mode !== undefined ? { mode: parsedArgs.mode } : {}),
+        ...(parsedArgs.preferAlias !== undefined ? { preferAlias: parsedArgs.preferAlias } : {}),
+        overrideConfig: parsedArgs.overrideConfig,
+        exclude: parsedArgs.exclude,
+        ruleSources: parsedArgs.ruleSources,
+        showAll: parsedArgs.showAll
+    }, parsedArgs.rules));
+}
+function runNormalizeImportsRequest(cwd, request) {
+    if (!request.scope) {
+        throw new errors_1.CliError("NORMALIZE_IMPORTS_SCOPE_REQUIRED", "normalizeImports JSON requests expect scope, file, dir, or directory.");
+    }
+    if (request.overrideConfig && !request.mode) {
+        throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_OVERRIDE", "+overrideConfig requires an explicit imports.normalize to= target.");
+    }
+    const files = collectSourceFiles(path.resolve(cwd, request.scope), cwd, request.exclude);
+    const configCache = new Map();
+    const plan = collectNormalizePlan(cwd, files, request, configCache);
+    const edits = plan.edits;
+    const filesChanged = uniqueStrings(edits.map((edit) => edit.file));
+    const target = request.overrideConfig && request.mode ? request.mode : request.mode ?? "config";
+    if (request.action === "execute") {
+        applyImportEdits(cwd, edits);
+    }
+    const response = {
+        ok: true,
+        operation: "imports.normalize",
+        mode: request.action,
+        target,
+        ...(request.overrideConfig ? { overrideConfig: true } : {}),
+        ...(plan.noPolicy ? { noPolicy: true } : {}),
+        filesScanned: files.length,
+        filesChanged: filesChanged.length,
+        filesTouched: filesChanged,
+        ...(request.action === "execute" ? { filesWritten: filesChanged } : {}),
+        edits: edits.length,
+        importEdits: edits,
+        policyGroups: policyGroupsToJson(plan.policyGroups),
+        configuredFiles: plan.configuredFiles.length,
+        ...(request.exclude.length > 0 ? { exclude: request.exclude } : {}),
+        ...(request.ruleSources.length > 0 ? { ruleSources: request.ruleSources.map((source) => toDisplayPath(cwd, source)) } : {}),
+        ...buildImportEditPresentation(cwd, request.action, target, edits, request.showAll, plan.policyGroups),
+        next: request.action === "execute"
+            ? "Run typecheck or targeted validation for the affected project."
+            : "Rerun with execute or apply the preview id if the preview matches intent."
+    };
+    if (request.action === "preview" && !plan.noPolicy) {
+        const planId = buildNormalizeImportsPlanId(cwd, request, edits);
+        writeNormalizeImportsPlan(cwd, {
+            planId,
+            createdAt: new Date().toISOString(),
+            cwd,
+            request,
+            files: hashEditedFiles(cwd, edits),
+            edits
+        });
+        response.planId = planId;
+        response.next = "Use the outer aib mutate apply id when this preview is run through mutate.";
+    }
+    else if (plan.noPolicy) {
+        response.next = "Add importNormalize config for this scope or rerun with an explicit to= target.";
+    }
+    return response;
+}
+function applyNormalizeImportsPlan(cwd, planId, showAll = false) {
+    const record = readNormalizeImportsPlan(cwd, planId);
+    const staleFiles = Object.entries(record.files)
+        .filter(([file, hash]) => {
+        const fullPath = path.resolve(cwd, file);
+        return !fs.existsSync(fullPath) || sha256(fs.readFileSync(fullPath)) !== hash;
+    })
+        .map(([file]) => file);
+    if (staleFiles.length > 0) {
+        throw new errors_1.CliError("NORMALIZE_IMPORTS_PLAN_STALE", `imports normalize plan is stale: ${planId}`, {
+            planId,
+            staleFiles: staleFiles.slice(0, 20),
+            ...(staleFiles.length > 20 ? { hidden: `+ ${staleFiles.length - 20} more stale files` } : {})
+        });
+    }
+    applyImportEdits(cwd, record.edits);
+    const filesChanged = uniqueStrings(record.edits.map((edit) => edit.file));
+    return {
+        ok: true,
+        operation: "imports.normalize",
+        mode: "apply",
+        planId,
+        target: record.request.overrideConfig && record.request.mode ? record.request.mode : record.request.mode ?? "config",
+        ...(record.request.overrideConfig ? { overrideConfig: true } : {}),
+        filesChanged: filesChanged.length,
+        filesTouched: filesChanged,
+        filesWritten: filesChanged,
+        edits: record.edits.length,
+        importEdits: record.edits,
+        policyGroups: policyGroupsToJson(buildPolicyGroupsFromEdits(record.edits, record.request)),
+        ...buildImportEditPresentation(cwd, "apply", record.request.overrideConfig && record.request.mode ? record.request.mode : record.request.mode ?? "config", record.edits, showAll, buildPolicyGroupsFromEdits(record.edits, record.request)),
+        next: "Run typecheck or targeted validation for the affected project."
+    };
+}
+function showNormalizeImportsPlan(cwd, planId, showAll) {
+    const record = readNormalizeImportsPlan(cwd, planId);
+    const filesChanged = uniqueStrings(record.edits.map((edit) => edit.file));
+    return {
+        ok: true,
+        operation: "imports.normalize",
+        mode: "show",
+        planId,
+        target: record.request.overrideConfig && record.request.mode ? record.request.mode : record.request.mode ?? "config",
+        filesChanged: filesChanged.length,
+        filesTouched: filesChanged,
+        edits: record.edits.length,
+        importEdits: record.edits,
+        policyGroups: policyGroupsToJson(buildPolicyGroupsFromEdits(record.edits, record.request)),
+        ...buildImportEditPresentation(cwd, "preview", record.request.overrideConfig && record.request.mode ? record.request.mode : record.request.mode ?? "config", record.edits, showAll, buildPolicyGroupsFromEdits(record.edits, record.request)),
+        next: "Use aib mutate preview/apply for imports.normalize."
+    };
+}
+function expandNormalizeImportsPayload(cwd, payload, parsedArgs) {
+    const inlineRules = extractNormalizeImportsRules(payload);
+    const rules = [...parsedArgs.rules, ...inlineRules];
+    const defaults = normalizeImportsRequestFromObject(payload, parsedArgs);
+    const rawRequests = Array.isArray(payload.requests) ? payload.requests : [payload];
+    return rawRequests.map((rawRequest, index) => {
+        if (!isRecord(rawRequest)) {
+            throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_REQUEST", `normalizeImports request at index ${index} must be an object.`);
+        }
+        return finalizeNormalizeImportsRequest(cwd, normalizeImportsRequestFromObject({ ...defaults, ...rawRequest }, parsedArgs), rules);
+    });
+}
+function normalizeImportsRequestFromObject(payload, parsedArgs) {
+    const scope = readString(payload.scope) ?? readString(payload.file) ?? readString(payload.dir) ?? readString(payload.directory);
+    const action = parsedArgs.action === "show" ? "preview" : parsedArgs.action;
+    return {
+        scope: scope ?? "",
+        ...(readPayloadMode(payload, parsedArgs) !== undefined ? { mode: readPayloadMode(payload, parsedArgs) } : {}),
+        action: payload.execute === true ? "execute" : action,
+        ...(readString(payload.preferAlias) ? { preferAlias: readString(payload.preferAlias) } : {}),
+        overrideConfig: parsedArgs.overrideConfig || payload.overrideConfig === true,
+        exclude: uniqueStrings([...parsedArgs.exclude, ...readStringArray(payload.exclude), ...readStringArray(payload.excludes)]),
+        ruleSources: parsedArgs.ruleSources,
+        showAll: parsedArgs.showAll || payload.all === true || payload.details === "all"
+    };
+}
+function finalizeNormalizeImportsRequest(cwd, request, explicitRules = []) {
+    const configRules = readWorkspaceNormalizeImportRules(cwd);
+    const rules = [...configRules.rules, ...explicitRules];
+    return {
+        scope: request.scope,
+        ...(request.mode ? { mode: request.mode } : {}),
+        action: request.action,
+        ...(request.preferAlias ? { preferAlias: request.preferAlias } : {}),
+        overrideConfig: request.overrideConfig,
+        exclude: uniqueStrings(request.exclude),
+        rules,
+        ruleSources: uniqueStrings([...configRules.sources, ...request.ruleSources]),
+        showAll: request.showAll
+    };
+}
+function readPayloadMode(payload, parsedArgs) {
+    const mode = readString(payload.to) ?? readString(payload.mode) ?? parsedArgs.mode;
+    if (mode === undefined) {
+        return undefined;
+    }
+    if (isNormalizeMode(mode)) {
+        return mode;
+    }
+    throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_MODE", "normalizeImports to/mode expects relative, alias, or shortestAlias.");
+}
+function assertNormalizeImportsPayload(value) {
+    if (!isJsonObject(value)) {
+        throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_STDIN", "normalizeImports --stdin expects a JSON object payload.");
+    }
+    return value;
+}
+function collectNormalizePlan(cwd, files, request, configCache) {
+    const registry = new PolicyRegistry();
+    const edits = files.flatMap((file) => collectImportEdits(cwd, file, request, configCache, registry));
+    const configuredFiles = files.filter((file) => fileHasNormalizePolicy(cwd, file, request));
+    return {
+        edits,
+        policyGroups: registry.groups(edits),
+        configuredFiles: configuredFiles.map((file) => toDisplayPath(cwd, file)),
+        noPolicy: !request.mode && !request.overrideConfig && configuredFiles.length === 0
+    };
+}
+function collectImportEdits(cwd, file, request, configCache, registry) {
+    const text = fs.readFileSync(file, "utf8");
+    const config = (0, import_specifier_policy_1.readNearestTsConfig)(file, cwd, configCache);
+    const edits = [];
+    for (const occurrence of collectImportSpecifierOccurrences(text, file)) {
+        const resolved = (0, import_specifier_policy_1.resolveImportSpecifier)(file, occurrence.specifier, config);
+        if (!resolved) {
+            continue;
+        }
+        const policy = resolveNormalizePolicy(cwd, file, resolved, request, registry);
+        if (!policy) {
+            continue;
+        }
+        const nextSpecifier = policy.mode === "relative"
+            ? (0, import_specifier_policy_1.formatRelativeImportSpecifier)(file, resolved, config)
+            : (0, import_specifier_policy_1.toAliasImportSpecifier)(resolved, config, policy.preferAlias, policy.mode);
+        if (!nextSpecifier || nextSpecifier === occurrence.specifier) {
+            continue;
+        }
+        edits.push({
+            file: toDisplayPath(cwd, file),
+            from: occurrence.specifier,
+            to: nextSpecifier,
+            policyId: policy.id,
+            start: occurrence.start,
+            end: occurrence.end,
+            specifiers: occurrence.specifiers,
+            importKind: occurrence.importKind,
+            statementKind: occurrence.statementKind,
+            line: occurrence.line
+        });
+    }
+    return edits;
+}
+class PolicyRegistry {
+    byKey = new Map();
+    ordered = [];
+    get(match) {
+        const key = stableStringify(match);
+        const existing = this.byKey.get(key);
+        if (existing) {
+            return existing;
+        }
+        const next = { ...match, id: `p${this.ordered.length + 1}` };
+        this.byKey.set(key, next);
+        this.ordered.push(next);
+        return next;
+    }
+    groups(edits) {
+        const editsByPolicy = new Map();
+        for (const edit of edits) {
+            editsByPolicy.set(edit.policyId, [...(editsByPolicy.get(edit.policyId) ?? []), edit]);
+        }
+        return this.ordered
+            .filter((policy) => editsByPolicy.has(policy.id))
+            .map((policy) => policyGroupFromPolicy(policy, editsByPolicy.get(policy.id) ?? []));
+    }
+}
+function buildPolicyGroupsFromEdits(edits, request) {
+    const policies = new Map();
+    for (const edit of edits) {
+        if (policies.has(edit.policyId)) {
+            continue;
+        }
+        const fallback = {
+            id: edit.policyId,
+            source: request.overrideConfig || request.mode ? "explicit" : "config",
+            ruleKind: request.overrideConfig || request.mode ? "explicit" : "simple",
+            mode: request.mode ?? "relative",
+            ...(request.preferAlias ? { preferAlias: request.preferAlias } : {}),
+            ...(request.overrideConfig ? { overrideConfig: true } : {})
+        };
+        policies.set(edit.policyId, fallback);
+    }
+    return Array.from(policies.values()).map((policy) => policyGroupFromPolicy(policy, edits.filter((edit) => edit.policyId === policy.id)));
+}
+function policyGroupFromPolicy(policy, edits) {
+    const files = uniqueStrings(edits.map((edit) => edit.file));
+    return compactObject({
+        id: policy.id,
+        source: policy.source,
+        ruleKind: policy.ruleKind,
+        ...(policy.relation ? { relation: policy.relation } : {}),
+        ...(policy.ruleScope ? { ruleScope: policy.ruleScope } : {}),
+        ...(policy.boundary ? { boundary: policy.boundary } : {}),
+        target: policy.mode,
+        ...(policy.preferAlias ? { preferAlias: policy.preferAlias } : {}),
+        ...(policy.overrideConfig ? { overrideConfig: policy.overrideConfig } : {}),
+        filesChanged: files.length,
+        edits: edits.length,
+        sampleFiles: files.slice(0, 3)
+    });
+}
+function policyGroupsToJson(groups) {
+    return groups.map((group) => compactObject({
+        id: group.id,
+        source: group.source,
+        ruleKind: group.ruleKind,
+        ...(group.relation ? { relation: group.relation } : {}),
+        ...(group.ruleScope ? { ruleScope: group.ruleScope } : {}),
+        ...(group.boundary ? { boundary: group.boundary } : {}),
+        target: group.target,
+        ...(group.preferAlias ? { preferAlias: group.preferAlias } : {}),
+        ...(group.overrideConfig ? { overrideConfig: group.overrideConfig } : {}),
+        filesChanged: group.filesChanged,
+        edits: group.edits,
+        sampleFiles: group.sampleFiles
+    }));
+}
+function resolveNormalizePolicy(cwd, consumerFile, targetFile, request, registry) {
+    if (request.overrideConfig) {
+        if (!request.mode) {
+            return null;
+        }
+        return registry.get({
+            source: "explicit",
+            ruleKind: "explicit",
+            mode: request.mode,
+            ...(request.preferAlias ? { preferAlias: request.preferAlias } : {}),
+            overrideConfig: true
+        });
+    }
+    const configPolicy = resolveConfigNormalizePolicy(cwd, consumerFile, targetFile, request, registry);
+    if (configPolicy) {
+        return configPolicy;
+    }
+    if (!request.mode) {
+        return null;
+    }
+    return registry.get({
+        source: "explicit",
+        ruleKind: "explicit",
+        mode: request.mode,
+        ...(request.preferAlias ? { preferAlias: request.preferAlias } : {})
+    });
+}
+function resolveConfigNormalizePolicy(cwd, consumerFile, targetFile, request, registry) {
+    const sortedRules = [...request.rules].sort((left, right) => ruleSpecificity(right) - ruleSpecificity(left));
+    for (const rule of sortedRules) {
+        if (!rule.boundary) {
+            continue;
+        }
+        if (isExcludedPath(cwd, consumerFile, rule.exclude)) {
+            continue;
+        }
+        const relation = boundaryRelation(cwd, consumerFile, targetFile, rule);
+        if (!relation) {
+            continue;
+        }
+        const target = relation === "inside" ? rule.inside : rule.outside;
+        if (!target) {
+            continue;
+        }
+        return registry.get({
+            source: "config",
+            ruleKind: "boundary",
+            relation,
+            ...(rule.scope ? { ruleScope: rule.scope } : {}),
+            boundary: rule.boundary,
+            mode: target.mode,
+            ...(target.preferAlias ? { preferAlias: target.preferAlias } : {})
+        });
+    }
+    for (const rule of sortedRules) {
+        if (rule.boundary || !rule.mode || !normalizeRuleAppliesToFile(cwd, consumerFile, rule)) {
+            continue;
+        }
+        if (isExcludedPath(cwd, consumerFile, rule.exclude)) {
+            continue;
+        }
+        return registry.get({
+            source: "config",
+            ruleKind: "simple",
+            ...(rule.scope ? { ruleScope: rule.scope } : {}),
+            mode: rule.mode,
+            ...(rule.preferAlias ? { preferAlias: rule.preferAlias } : {})
+        });
+    }
+    return null;
+}
+function fileHasNormalizePolicy(cwd, consumerFile, request) {
+    if (request.overrideConfig) {
+        return Boolean(request.mode);
+    }
+    if (request.mode) {
+        return true;
+    }
+    return request.rules.some((rule) => {
+        if (isExcludedPath(cwd, consumerFile, rule.exclude)) {
+            return false;
+        }
+        if (rule.boundary) {
+            return boundaryInstance(cwd, consumerFile, rule) !== null;
+        }
+        return Boolean(rule.mode) && normalizeRuleAppliesToFile(cwd, consumerFile, rule);
+    });
+}
+function boundaryRelation(cwd, consumerFile, targetFile, rule) {
+    const consumerInstance = boundaryInstance(cwd, consumerFile, rule);
+    const targetInstance = boundaryInstance(cwd, targetFile, rule);
+    if (consumerInstance && targetInstance) {
+        return consumerInstance === targetInstance ? "inside" : "outside";
+    }
+    if (consumerInstance || targetInstance) {
+        return "outside";
+    }
+    return null;
+}
+function boundaryInstance(cwd, file, rule) {
+    if (rule.boundary !== "*" || !rule.scope) {
+        return null;
+    }
+    const container = toDisplayPath(cwd, path.resolve(cwd, rule.scope));
+    const relative = toDisplayPath(cwd, path.resolve(file));
+    if (relative === container || !relative.startsWith(`${container}/`)) {
+        return null;
+    }
+    const rest = relative.slice(container.length + 1);
+    const [firstSegment] = rest.split("/");
+    return firstSegment && firstSegment.length > 0 ? firstSegment : null;
+}
+function collectImportSpecifierOccurrences(text, file) {
+    const sourceFile = typescript_1.default.createSourceFile(file, text, typescript_1.default.ScriptTarget.Latest, true, scriptKindForFile(file));
+    const occurrences = [];
+    const pushModuleSpecifier = (moduleSpecifier, specifiers, importKind, statementKind) => {
+        if (!moduleSpecifier || !typescript_1.default.isStringLiteralLike(moduleSpecifier)) {
+            return;
+        }
+        const literalStart = moduleSpecifier.getStart(sourceFile);
+        const literalEnd = moduleSpecifier.getEnd();
+        const { line } = sourceFile.getLineAndCharacterOfPosition(literalStart);
+        occurrences.push({
+            specifier: moduleSpecifier.text,
+            start: literalStart + 1,
+            end: literalEnd - 1,
+            specifiers,
+            importKind,
+            statementKind,
+            line: line + 1
+        });
+    };
+    const visit = (node) => {
+        if (typescript_1.default.isImportDeclaration(node)) {
+            pushModuleSpecifier(node.moduleSpecifier, readImportClauseSpecifiers(node.importClause), readImportClauseKind(node.importClause), "import");
+            return;
+        }
+        if (typescript_1.default.isExportDeclaration(node)) {
+            pushModuleSpecifier(node.moduleSpecifier, readExportClauseSpecifiers(node.exportClause), readExportDeclarationKind(node), "export");
+            return;
+        }
+        if (typescript_1.default.isCallExpression(node) && node.expression.kind === typescript_1.default.SyntaxKind.ImportKeyword) {
+            const [firstArg] = node.arguments;
+            pushModuleSpecifier(firstArg, [], "unknown", "dynamicImport");
+            return;
+        }
+        typescript_1.default.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return occurrences;
+}
+function scriptKindForFile(file) {
+    const ext = path.extname(file).toLowerCase();
+    if (ext === ".tsx") {
+        return typescript_1.default.ScriptKind.TSX;
+    }
+    if (ext === ".js" || ext === ".mjs" || ext === ".cjs" || ext === ".jsx") {
+        return typescript_1.default.ScriptKind.JS;
+    }
+    return typescript_1.default.ScriptKind.TS;
+}
+function readImportClauseSpecifiers(clause) {
+    if (!clause) {
+        return [];
+    }
+    const names = [];
+    if (clause.name) {
+        names.push(clause.name.text);
+    }
+    const bindings = clause.namedBindings;
+    if (bindings && typescript_1.default.isNamespaceImport(bindings)) {
+        names.push(`* as ${bindings.name.text}`);
+    }
+    else if (bindings && typescript_1.default.isNamedImports(bindings)) {
+        for (const specifier of bindings.elements) {
+            names.push(specifier.propertyName ? `${specifier.propertyName.text} as ${specifier.name.text}` : specifier.name.text);
+        }
+    }
+    return names;
+}
+function readImportClauseKind(clause) {
+    if (!clause) {
+        return "unknown";
+    }
+    if (clause.isTypeOnly) {
+        return "type";
+    }
+    const bindings = clause.namedBindings;
+    if (!bindings || !typescript_1.default.isNamedImports(bindings)) {
+        return "value";
+    }
+    const hasTypeSpecifiers = bindings.elements.some((specifier) => specifier.isTypeOnly);
+    const hasValueSpecifiers = bindings.elements.some((specifier) => !specifier.isTypeOnly);
+    return hasTypeSpecifiers && hasValueSpecifiers ? "mixed" : hasTypeSpecifiers ? "type" : "value";
+}
+function readExportClauseSpecifiers(clause) {
+    if (!clause) {
+        return [];
+    }
+    if (typescript_1.default.isNamespaceExport(clause)) {
+        return [`* as ${clause.name.text}`];
+    }
+    return clause.elements.map((specifier) => specifier.propertyName ? `${specifier.propertyName.text} as ${specifier.name.text}` : specifier.name.text);
+}
+function readExportDeclarationKind(node) {
+    if (node.isTypeOnly) {
+        return "type";
+    }
+    const clause = node.exportClause;
+    if (!clause || !typescript_1.default.isNamedExports(clause)) {
+        return "value";
+    }
+    const hasTypeSpecifiers = clause.elements.some((specifier) => specifier.isTypeOnly);
+    const hasValueSpecifiers = clause.elements.some((specifier) => !specifier.isTypeOnly);
+    return hasTypeSpecifiers && hasValueSpecifiers ? "mixed" : hasTypeSpecifiers ? "type" : "value";
+}
+function applyImportEdits(cwd, edits) {
+    const byFile = new Map();
+    for (const edit of edits) {
+        const list = byFile.get(edit.file) ?? [];
+        list.push(edit);
+        byFile.set(edit.file, list);
+    }
+    for (const [relativeFile, fileEdits] of byFile.entries()) {
+        const file = path.resolve(cwd, relativeFile);
+        let text = fs.readFileSync(file, "utf8");
+        for (const edit of [...fileEdits].sort((left, right) => right.start - left.start)) {
+            if (text.slice(edit.start, edit.end) !== edit.from) {
+                throw new errors_1.CliError("NORMALIZE_IMPORTS_PLAN_STALE", `imports normalize plan is stale for ${relativeFile}`, {
+                    file: relativeFile,
+                    expected: edit.from,
+                    actual: text.slice(edit.start, edit.end)
+                });
+            }
+            text = `${text.slice(0, edit.start)}${edit.to}${text.slice(edit.end)}`;
+        }
+        fs.writeFileSync(file, text);
+    }
+}
+function collectSourceFiles(scope, cwd, exclude) {
+    if (!fs.existsSync(scope)) {
+        throw new errors_1.CliError("NORMALIZE_IMPORTS_SCOPE_NOT_FOUND", `Scope does not exist: ${scope}`);
+    }
+    if (isExcludedPath(cwd, scope, exclude)) {
+        return [];
+    }
+    const stat = fs.statSync(scope);
+    if (stat.isFile()) {
+        return isSourceFile(scope) ? [scope] : [];
+    }
+    if (!stat.isDirectory()) {
+        return [];
+    }
+    const files = [];
+    for (const entry of fs.readdirSync(scope, { withFileTypes: true })) {
+        const child = path.join(scope, entry.name);
+        if (entry.isDirectory()) {
+            if (!EXCLUDED_DIRS.has(entry.name) && !isExcludedPath(cwd, child, exclude)) {
+                files.push(...collectSourceFiles(child, cwd, exclude));
+            }
+            continue;
+        }
+        if (entry.isFile() && isSourceFile(child) && !isExcludedPath(cwd, child, exclude)) {
+            files.push(child);
+        }
+    }
+    return files.sort();
+}
+function readFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+function parseNormalizeArgs(cwd, args) {
+    const positionals = args.filter((item, index) => !item.startsWith("--") && !isValueForFlag(args, index));
+    const first = positionals[0];
+    const action = first === "preview" || first === "apply" || first === "execute" || first === "show"
+        ? first
+        : args.includes("--execute") ? "execute" : "preview";
+    const actualPositionals = first === action ? positionals.slice(1) : positionals;
+    const rawMode = readFlagValue(args, "--to");
+    const mode = rawMode === undefined ? undefined : readNormalizeMode(rawMode);
+    const ruleFile = readFlagValue(args, "--rules") ?? readFlagValue(args, "--rules-file");
+    const ruleSources = [];
+    const rules = ruleFile ? readNormalizeImportsRuleFile(path.resolve(cwd, ruleFile), ruleSources) : [];
+    return {
+        action,
+        ...(action === "apply" && actualPositionals[0] ? { applyPlanId: actualPositionals[0] } : {}),
+        ...(action === "show" && actualPositionals[0] ? { showPlanId: actualPositionals[0] } : {}),
+        positionals: action === "apply" || action === "show" ? actualPositionals.slice(1) : actualPositionals,
+        ...(mode !== undefined ? { mode } : {}),
+        ...(readFlagValue(args, "--prefer-alias") !== undefined ? { preferAlias: readFlagValue(args, "--prefer-alias") } : {}),
+        overrideConfig: args.includes("--override-config") || args.includes("--overrideConfig"),
+        exclude: readRepeatedFlagValues(args, "--exclude"),
+        rules,
+        ruleSources,
+        showAll: args.includes("--all") || args.includes("--details") || args.includes("--full")
+    };
+}
+function readNormalizeMode(value) {
+    if (isNormalizeMode(value)) {
+        return value;
+    }
+    throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_MODE", "normalizeImports --to expects relative, alias, or shortestAlias.");
+}
+function isNormalizeMode(value) {
+    return value === "relative" || value === "alias" || value === "shortestAlias";
+}
+function readRepeatedFlagValues(args, flag) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        if (args[index] === flag && typeof args[index + 1] === "string") {
+            values.push(args[index + 1]);
+            index += 1;
+        }
+    }
+    return values;
+}
+function isValueForFlag(args, index) {
+    const previous = args[index - 1];
+    return index > 0 && previous !== undefined && VALUE_FLAGS.has(previous);
+}
+const VALUE_FLAGS = new Set(["--to", "--prefer-alias", "--exclude", "--from-json", "--from-dsl", "--from", "--rules", "--rules-file"]);
+function buildImportEditPresentation(cwd, action, target, edits, showAll, policyGroups) {
+    const visibleSamples = showAll ? edits : selectImportEditSamples(edits, NORMALIZE_VISIBLE_SAMPLE_LIMIT);
+    const visibleSampleKeys = new Set(visibleSamples.map(importEditKey));
+    const hiddenEdits = orderImportEditsForPresentation(edits.filter((edit) => !visibleSampleKeys.has(importEditKey(edit))));
+    const files = uniqueStrings(edits.map((edit) => edit.file));
+    const visibleFiles = showAll ? files : selectImportEditFiles(edits, NORMALIZE_VISIBLE_FILE_LIMIT);
+    const visibleFileSet = new Set(visibleFiles);
+    const hiddenFiles = orderImportFilesForPresentation(edits, files.filter((file) => !visibleFileSet.has(file)));
+    const hiddenEditCount = Math.max(0, edits.length - visibleSamples.length);
+    const hiddenFileCount = hiddenFiles.length;
+    const view = saveNormalizeImportsView(cwd, action, target, edits, hiddenEdits, hiddenFiles, policyGroups);
+    return compactObject({
+        samples: visibleSamples,
+        sampleCount: visibleSamples.length,
+        visibleFiles,
+        hiddenEditCount,
+        hiddenFileCount,
+        hidden: hiddenEditCount > 0 ? `+ ${hiddenEditCount} more import edits hidden` : null,
+        ...(view ? { view: view.saved } : {})
+    });
+}
+function selectImportEditSamples(edits, limit) {
+    return orderImportEditsForPresentation(edits).slice(0, limit);
+}
+function orderImportEditsForPresentation(edits) {
+    const samples = [];
+    const sorted = [...edits].sort(compareImportEditsForSample);
+    const seenPolicies = new Set();
+    const seenBuckets = new Set();
+    for (const edit of sorted) {
+        const bucket = importEditPathBucket(edit.file);
+        if (seenPolicies.has(edit.policyId) || seenBuckets.has(bucket)) {
+            continue;
+        }
+        samples.push(edit);
+        seenPolicies.add(edit.policyId);
+        seenBuckets.add(bucket);
+    }
+    const seenFiles = new Set(samples.map((sample) => sample.file));
+    for (const edit of sorted) {
+        const bucket = importEditPathBucket(edit.file);
+        if (seenFiles.has(edit.file) || seenBuckets.has(bucket)) {
+            continue;
+        }
+        samples.push(edit);
+        seenFiles.add(edit.file);
+        seenBuckets.add(bucket);
+    }
+    for (const edit of sorted) {
+        if (!samples.includes(edit)) {
+            samples.push(edit);
+        }
+    }
+    return samples;
+}
+function selectImportEditFiles(edits, limit) {
+    return orderImportFilesForPresentation(edits, uniqueStrings(edits.map((edit) => edit.file))).slice(0, limit);
+}
+function orderImportFilesForPresentation(edits, files) {
+    const fileScores = new Map();
+    for (const edit of edits) {
+        const current = fileScores.get(edit.file);
+        const score = importEditSampleNoise(edit);
+        if (current === undefined || score < current) {
+            fileScores.set(edit.file, score);
+        }
+    }
+    const sorted = [...files].sort((left, right) => (fileScores.get(left) ?? Number.MAX_SAFE_INTEGER) - (fileScores.get(right) ?? Number.MAX_SAFE_INTEGER)
+        || importEditPathBucket(left).localeCompare(importEditPathBucket(right))
+        || left.localeCompare(right));
+    const selected = [];
+    const seenBuckets = new Set();
+    for (const file of sorted) {
+        const bucket = importEditPathBucket(file);
+        if (seenBuckets.has(bucket)) {
+            continue;
+        }
+        selected.push(file);
+        seenBuckets.add(bucket);
+    }
+    for (const file of sorted) {
+        if (!selected.includes(file)) {
+            selected.push(file);
+        }
+    }
+    return selected;
+}
+function compareImportEditsForSample(left, right) {
+    return importEditSampleNoise(left) - importEditSampleNoise(right)
+        || importEditPathBucket(left.file).localeCompare(importEditPathBucket(right.file))
+        || left.file.localeCompare(right.file)
+        || left.line - right.line
+        || left.from.localeCompare(right.from);
+}
+function importEditSampleNoise(edit) {
+    const pathDepth = edit.file.split("/").length;
+    const importDepth = edit.from.split("/").length + edit.to.split("/").length;
+    const textLength = edit.from.length + edit.to.length;
+    const extensionNoise = edit.from.endsWith(".js") || edit.to.endsWith(".js") ? 4 : 0;
+    const lowSignalNoise = isLowSignalImportSpecifier(edit.from) || isLowSignalImportSpecifier(edit.to) ? 80 : 0;
+    const indexNoise = edit.from.endsWith("/index") || edit.to.endsWith("/index") ? 30 : 0;
+    const deepRelativeNoise = edit.from.startsWith("../../..") || edit.to.startsWith("../../..") ? 24 : 0;
+    return Math.min(pathDepth, 10) + Math.min(importDepth, 18) + Math.min(textLength, 140) + extensionNoise + lowSignalNoise + indexNoise + deepRelativeNoise;
+}
+function importEditPathBucket(file) {
+    const parts = file.replace(/\\/g, "/").split("/").filter(Boolean);
+    if (parts.length <= 2) {
+        return parts.join("/");
+    }
+    if (parts[0] === "packages" && parts.length >= 3) {
+        return parts.slice(0, 3).join("/");
+    }
+    if (parts[0] === "src" && parts.length >= 3) {
+        return parts.slice(0, 3).join("/");
+    }
+    return parts.slice(0, 2).join("/");
+}
+function isLowSignalImportSpecifier(specifier) {
+    return specifier === "." || specifier === ".." || specifier === "./" || specifier === "../";
+}
+function saveNormalizeImportsView(cwd, action, target, edits, hiddenEdits, hiddenFiles, policyGroups) {
+    if (edits.length === 0) {
+        return null;
+    }
+    if (hiddenEdits.length === 0 && hiddenFiles.length === 0) {
+        return null;
+    }
+    return (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, compactObject({
+        kind: "importsNormalize",
+        operation: "imports.normalize",
+        mode: action,
+        target,
+        policyGroups: policyGroupsToJson(policyGroups),
+        edits,
+        hiddenEdits,
+        hiddenEditCount: hiddenEdits.length,
+        hiddenFiles,
+        hiddenFileCount: hiddenFiles.length,
+        files: uniqueStrings(edits.map((edit) => edit.file))
+    }));
+}
+function importEditKey(edit) {
+    return `${edit.file}\0${edit.line}\0${edit.from}\0${edit.to}\0${edit.statementKind}`;
+}
+function readNormalizeImportsRuleFile(filePath, sources) {
+    if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+        throw new errors_1.CliError("NORMALIZE_IMPORTS_RULES_NOT_FOUND", `imports normalize rules file not found: ${filePath}`);
+    }
+    sources.push(filePath);
+    return extractNormalizeImportsRules((0, import_specifier_policy_1.parseJsoncObject)(fs.readFileSync(filePath, "utf8")));
+}
+function readWorkspaceNormalizeImportRules(cwd) {
+    const roots = collectWorkspaceConfigSearchRoots(cwd);
+    const rules = [];
+    const sources = [];
+    for (const root of roots) {
+        const filePath = path.join(root, "aib.json");
+        if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+            continue;
+        }
+        try {
+            const extracted = extractNormalizeImportsRules((0, import_specifier_policy_1.parseJsoncObject)(fs.readFileSync(filePath, "utf8")));
+            if (extracted.length > 0) {
+                rules.push(...extracted);
+                sources.push(filePath);
+            }
+        }
+        catch {
+            // Invalid local config is handled by root/session flows; normalize keeps this pass best-effort.
+        }
+    }
+    return { rules, sources };
+}
+function extractNormalizeImportsRules(raw) {
+    const nestedAib = isRecord(raw.aib) ? raw.aib : {};
+    const values = [
+        raw.importNormalize,
+        raw.importsNormalize,
+        raw["imports.normalize"],
+        nestedAib.importNormalize,
+        nestedAib.importsNormalize,
+        nestedAib["imports.normalize"]
+    ];
+    return values.flatMap((value) => parseNormalizeImportsRulesValue(value));
+}
+function parseNormalizeImportsRulesValue(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => isRecord(item) ? [normalizeImportsRuleFromObject(item)] : []);
+    }
+    if (!isRecord(value)) {
+        return [];
+    }
+    if (Array.isArray(value.rules)) {
+        return value.rules.flatMap((item) => isRecord(item) ? [normalizeImportsRuleFromObject(item)] : []);
+    }
+    if (Array.isArray(value.requests)) {
+        return value.requests.flatMap((item) => isRecord(item) ? [normalizeImportsRuleFromObject(item)] : []);
+    }
+    return [normalizeImportsRuleFromObject(value)];
+}
+function normalizeImportsRuleFromObject(value) {
+    const rawMode = readString(value.to) ?? readString(value.mode);
+    const inside = normalizeImportsRuleTargetFromObject(value.inside);
+    const outside = normalizeImportsRuleTargetFromObject(value.outside);
+    const boundary = readString(value.boundary);
+    if (rawMode !== null && (inside || outside)) {
+        throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_RULE", "importNormalize rule cannot combine to/mode with inside/outside.");
+    }
+    if (boundary !== null && boundary !== "*") {
+        throw new errors_1.CliError("INVALID_NORMALIZE_IMPORTS_RULE", "importNormalize boundary currently supports only \"*\".");
+    }
+    return {
+        ...(readString(value.scope) ? { scope: readString(value.scope) } : {}),
+        ...(rawMode !== null ? { mode: readNormalizeMode(rawMode) } : {}),
+        ...(readString(value.preferAlias) ? { preferAlias: readString(value.preferAlias) } : {}),
+        ...(boundary === "*" ? { boundary: "*" } : {}),
+        ...(inside ? { inside } : {}),
+        ...(outside ? { outside } : {}),
+        exclude: uniqueStrings([...readStringArray(value.exclude), ...readStringArray(value.excludes)])
+    };
+}
+function normalizeImportsRuleTargetFromObject(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const rawMode = readString(value.to) ?? readString(value.mode);
+    if (rawMode === null) {
+        return null;
+    }
+    return compactObject({
+        mode: readNormalizeMode(rawMode),
+        ...(readString(value.preferAlias) ? { preferAlias: readString(value.preferAlias) } : {})
+    });
+}
+function normalizeRuleAppliesToFile(cwd, file, rule) {
+    if (!rule.scope) {
+        return true;
+    }
+    const requestPath = toDisplayPath(cwd, path.resolve(file));
+    const rulePath = toDisplayPath(cwd, path.resolve(cwd, rule.scope));
+    return requestPath === rulePath || requestPath.startsWith(`${rulePath}/`);
+}
+function ruleSpecificity(rule) {
+    return rule.scope ? rule.scope.length : 0;
+}
+function isExcludedPath(cwd, candidate, exclude) {
+    if (exclude.length === 0) {
+        return false;
+    }
+    const relative = toDisplayPath(cwd, path.resolve(candidate));
+    return exclude.some((pattern) => matchesExcludePattern(cwd, relative, pattern));
+}
+function matchesExcludePattern(cwd, relativePath, pattern) {
+    const normalizedPattern = toDisplayPath(cwd, path.isAbsolute(pattern) ? pattern : path.resolve(cwd, pattern));
+    if (!containsGlob(pattern)) {
+        return relativePath === normalizedPattern || relativePath.startsWith(`${normalizedPattern}/`);
+    }
+    return globToRegExp(pattern.replace(/\\/g, "/")).test(relativePath);
+}
+function containsGlob(value) {
+    return /[*?]/.test(value);
+}
+function globToRegExp(pattern) {
+    let source = "";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const char = pattern[index];
+        if (char === "*") {
+            if (pattern[index + 1] === "*") {
+                source += ".*";
+                index += 1;
+            }
+            else {
+                source += "[^/]*";
+            }
+        }
+        else if (char === "?") {
+            source += "[^/]";
+        }
+        else {
+            source += escapeRegExp(char ?? "");
+        }
+    }
+    return new RegExp(`^${source}$`);
+}
+function buildNormalizeImportsPlanId(cwd, request, edits) {
+    return `imports_${sha256(stableStringify({ cwd, request, edits })).slice(0, 8)}`;
+}
+function writeNormalizeImportsPlan(cwd, record) {
+    const filePath = normalizeImportsPlanPath(cwd, record.planId);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(record, null, 2)}\n`);
+}
+function readNormalizeImportsPlan(cwd, planId) {
+    const filePath = normalizeImportsPlanPath(cwd, planId);
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("NORMALIZE_IMPORTS_PLAN_NOT_FOUND", `imports normalize plan not found: ${planId}`, {
+            planId,
+            expectedPath: filePath
+        });
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function normalizeImportsPlanPath(cwd, planId) {
+    return (0, workspace_cache_1.workspaceCachePath)(cwd, "imports-normalize", `${planId.replace(/[^a-z0-9_-]+/gi, "-")}.json`);
+}
+function hashEditedFiles(cwd, edits) {
+    const hashes = {};
+    for (const file of new Set(edits.map((edit) => edit.file))) {
+        hashes[file] = sha256(fs.readFileSync(path.resolve(cwd, file)));
+    }
+    return hashes;
+}
+function collectConfigSearchRoots(cwd) {
+    const roots = [];
+    let current = path.resolve(cwd);
+    const parsedRoot = path.parse(current).root;
+    while (true) {
+        roots.push(current);
+        if (current === parsedRoot) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return roots.reverse();
+}
+function collectWorkspaceConfigSearchRoots(cwd) {
+    const workspace = (0, workspace_root_1.resolveWorkspaceRoot)(cwd);
+    if (!workspace) {
+        return collectConfigSearchRoots(cwd);
+    }
+    const roots = [];
+    const stop = path.resolve(workspace.root).toLowerCase();
+    let current = path.resolve(cwd);
+    while (true) {
+        roots.push(current);
+        if (path.resolve(current).toLowerCase() === stop) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return roots.reverse();
+}
+function sha256(value) {
+    return crypto.createHash("sha256").update(value).digest("hex");
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    return `{${Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+        .join(",")}}`;
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function readStringArray(value) {
+    if (typeof value === "string" && value.trim() !== "") {
+        return [value.trim()];
+    }
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+function uniqueStrings(items) {
+    return Array.from(new Set(items));
+}
+function compactObject(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined &&
+        item !== null &&
+        !(Array.isArray(item) && item.length === 0) &&
+        !(typeof item === "string" && item.length === 0)));
+}
+function isSourceFile(file) {
+    return SOURCE_EXTENSIONS.includes(path.extname(file)) && !file.endsWith(".d.ts");
+}
+function withoutSourceExtension(file) {
+    const ext = path.extname(file);
+    return SOURCE_EXTENSIONS.includes(ext) || IMPORT_EXTENSIONS.includes(ext)
+        ? file.slice(0, -ext.length)
+        : file;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function toDisplayPath(cwd, file) {
+    return path.relative(cwd, file).replace(/\\/g, "/");
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}