@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/dsl/aib-dsl.js

@@ -1 +1,838 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.compileAibDsl=V;const L=new Set(["file","exports","members","code","deps","usages","duplicates","graph","tree","cycles","imports"]),R=new Set(["rename","move","plan","module"]),$=new Set(["imports.normalize"]),K=new Set(["view"]),w="__aibDslDefaultFile",g="__aibDslDefaultScope",A="__aibDslDefaultTarget";function V(e,r={}){if(r.tolerantInspect===!0)return j(e);const t={},n=[],i=[],o=[],s=[],a=[];let c=null;for(const u of N(e)){const[f,...p]=u.tokens;if(f){if(f.startsWith("@")){M(t,f,p,u.lineNumber);continue}if(L.has(f)){c=y(c,"inspect",u.lineNumber),n.push(U(f,p,t,u.lineNumber));continue}if(R.has(f)){c=y(c,"mutation",u.lineNumber),f==="plan"||f==="module"?o.push(oe(p,u.lineNumber)):i.push(ie(f,p,u.lineNumber));continue}if($.has(f)){c=y(c,"imports",u.lineNumber),s.push(re(p,t,u.lineNumber));continue}if(K.has(f)){c=y(c,"view",u.lineNumber),a.push(se(p,u.lineNumber));continue}throw l(u.lineNumber,`Unknown DSL operation: ${f}`)}}if(c==="inspect")return{command:"inspect",payload:C(t,n)};if(o.length>0&&i.length>0)throw l(0,"Cannot mix modulePlan rows with rename/move mutation rows.");if(o.length>0)return E(t.sourceFile,"@source",0),{command:"modulePlan",payload:D({sourceFile:t.sourceFile,modules:o,expectEmpty:t.expectEmpty===!0?!0:void 0,save:t.save})};if(i.length===1){E(t.sourceFile,"@source",0);const u=i[0];return u.op==="rename"?{command:"rename",payload:D({sourceFile:t.sourceFile,renames:u.renames,save:t.save})}:{command:"move.toFile",payload:D({sourceFile:t.sourceFile,targetFile:u.targetFile,entities:u.entities,save:t.save})}}if(i.length>1)return E(t.sourceFile,"@source",0),{command:"refactor.batch",payload:D({sourceFile:t.sourceFile,requests:i,save:t.save})};if(s.length>0)return{command:"imports.normalize",payload:s.length===1?s[0]:{requests:s}};if(a.length>0)return{command:"view",payload:a.length===1?a[0]:{views:a}};throw l(0,"DSL document has no operations.")}function j(e){const r={},t=[],n=[];let i=null;const o=e.split(/\r?\n/);for(let a=0;a<o.length;a+=1){const c=a+1,u=o[a]??"",f=_(u).trim();if(!f)continue;let p;try{p=O(f,c)}catch(d){n.push({line:c,message:I(d instanceof Error?d.message:String(d))});continue}const[m,...T]=p;if(m){if(m.startsWith("@")){M(r,m,T,c);continue}if(L.has(m)){i=y(i,"inspect",c);try{t.push(U(m,T,r,c))}catch(d){n.push({line:c,message:I(d instanceof Error?d.message:String(d))})}continue}if(R.has(m)||$.has(m))throw l(c,"Cannot mix inspect, mutation, and imports operations in one DSL document.");n.push({line:c,message:`Unknown DSL operation: ${m}`})}}if(t.length===0)throw n.length>0?l(n[0].line,n[0].message):l(0,"DSL document has no operations.");const s=C(r,t);return n.length>0&&(s.dslDiagnostics=n.map(a=>({line:a.line,message:a.message}))),{command:"inspect",payload:s,...n.length>0?{diagnostics:n}:{}}}function I(e){return e.replace(/^DSL(?: line \d+)?:\s*/,"")}function N(e){return e.split(/\r?\n/).flatMap((r,t)=>{const n=_(r).trim();return n?[{lineNumber:t+1,tokens:O(n,t+1)}]:[]})}function _(e){let r=null;for(let t=0;t<e.length;t+=1){const n=e[t];if((n==='"'||n==="'")&&e[t-1]!=="\\"&&(r=r===n?null:r??n),n==="#"&&r===null)return e.slice(0,t)}return e}function O(e,r){const t=[];let n="",i=null;for(let o=0;o<e.length;o+=1){const s=e[o];if(i){s===i&&e[o-1]!=="\\"?i=null:n+=s;continue}if(s==='"'||s==="'"){i=s;continue}if(/\s/.test(s)){n&&(t.push(n),n="");continue}n+=s}if(i)throw l(r,"Unclosed quote.");return n&&t.push(n),t}function M(e,r,t,n){const i=t.join(" ").trim();if(!i)throw l(n,`${r} requires a value.`);switch(r){case"@file":e.file=i;return;case"@source":{const{value:o,flags:s}=B(t,n,r);e.sourceFile=o,s.has("expectEmpty")&&(e.expectEmpty=!0);return}case"@scope":e.scope=i;return;case"@target":e.target=i;return;case"@save":e.save=i;return;default:throw l(n,`Unknown DSL default: ${r}`)}}function B(e,r,t){const n=new Set,i=[];for(const s of e){if(s.startsWith("+")&&s.length>1){n.add(s.slice(1));continue}i.push(s)}const o=i.join(" ").trim();if(!o)throw l(r,`${t} requires a value.`);return{value:o,flags:n}}function y(e,r,t){if(e&&e!==r)throw l(t,"Cannot mix inspect, mutation, and imports operations in one DSL document.");return r}function U(e,r,t,n){const{positional:i,fields:o}=S(r,n),s={op:e};if(Object.assign(s,o),e==="file"||e==="exports"||e==="imports"){const a=i[0]??o.file,c=a??t.file;return c&&(s.file=c,a||h(s,w)),s}if(e==="members"){const c=W(s,i,t).map(v);return c.length===1&&!o.entity&&!o.entities?s.entity=c[0]:c.length>0&&!o.entities&&(s.entities=c),s}if(e==="code"||e==="deps"){const c=W(s,i,t).map(v);return e==="deps"&&c.length===1&&!o.entities&&!o.entity?s.entity=c[0]:c.length>0&&!o.entities&&!o.entity&&(s.entities=c),s}if(e==="usages"){const a=o.target??i[0],c=a??t.target??t.file;c&&(s.target=c,a||h(s,A));const u=o.entity??o.entities,p=(c===i[0]?i.slice(1):i).map(v);return!u&&p.length===1?s.entity=p[0]:!u&&p.length>1&&(s.entities=p),s}if(e==="duplicates"){const a=o.scope??i[0],c=a??t.scope;return c&&(s.scope=c,a||h(s,g)),s}if(e==="tree"){const a=o.scope??i[0],c=a??t.scope;return c&&(s.scope=c,a||h(s,g)),s}if(e==="cycles"){const a=o.scope??i[0],c=a??t.scope;return c&&(s.scope=c,a||h(s,g)),s}if(e==="graph"){const a=o.scope??i[0],c=a??t.scope;return c&&!s.fromFile&&(s.scope=c,a||h(s,g)),s}return s}function G(e,r){!e.file&&!e.fromFile&&r.file&&(e.file=r.file,h(e,w))}function W(e,r,t){return!e.file&&!e.fromFile&&r.length>0&&H(r[0])?(e.file=r[0],r.slice(1)):(G(e,t),r)}function H(e){return e.includes("/")||e.includes("\\")||/^@[^/\\]+[/\\]/.test(e)||/\.(?:[cm]?[jt]sx?|d\.ts)$/i.test(e)}function h(e,r){Object.defineProperty(e,r,{value:!0,enumerable:!1})}function S(e,r){const t=[],n={};for(const i of e){if(i.startsWith("+")&&i.length>1){x(n,i.slice(1),!0);continue}if(i.startsWith("-")&&i.length>1){x(n,i.slice(1),!1);continue}if(i.startsWith(">")&&i.length>1){x(n,"save",i.slice(1));continue}const o=i.indexOf("=");if(o>0){const s=i.slice(0,o),a=i.slice(o+1);x(n,q(s),J(s,a));continue}if(i==="->")throw l(r,"Unexpected move separator in inspect request.");t.push(i)}return{positional:t,fields:n}}function x(e,r,t){const n=e[r];if(n===void 0){e[r]=t;return}if(b(r)){e[r]=[...z(n),...z(t)];return}e[r]=t}function b(e){return e==="focus"||e==="scope"||e==="scopes"||e==="file"||e==="files"||e==="exclude"||e==="excludes"||e==="pathExclude"||e==="pathExcludes"||e==="excludePath"||e==="excludePaths"||e==="entities"||e==="only"||e==="except"||e==="kinds"}function z(e){return Array.isArray(e)?e:[e]}function q(e){return e==="from"?"fromFile":e==="no-default-exclude"?"noDefaultExclude":e==="no-config-exclude"?"noConfigExclude":e}function J(e,r){const t=X(r),n=Q(t);if(/^-?\d+$/.test(t))return Number(t);if(t==="true")return!0;if(t==="false")return!1;if(e==="entity"||e==="entities"){const i=(n??F(t)).map(v);return e==="entity"&&i.length===1?i[0]:i}return e==="only"||e==="except"?(n??F(t)).flatMap(Y):n&&b(q(e))?n:b(q(e))&&t.includes(",")?F(t):t}function Q(e){if(!e.startsWith("[")||!e.endsWith("]"))return null;const r=e.slice(1,-1).trim();return r?F(r):[]}function F(e){const r=[];let t="",n=0,i=0;for(const o of e){if(o==="{"?n+=1:o==="}"&&n>0?n-=1:o==="["?i+=1:o==="]"&&i>0&&(i-=1),o===","&&n===0&&i===0){t.trim()&&r.push(t.trim()),t="";continue}t+=o}return t.trim()&&r.push(t.trim()),r}function X(e){return e==="sum"?"summary":e==="loc"?"locations":e}function v(e){const r=e.match(/^(.+)\.\{(.+)\}$/);if(r){const n=r[1],i=r[2];return!n||!i?e:{parent:n,entities:i.split(",").map(o=>o.trim()).filter(Boolean)}}const t=e.match(/^(.+)\.([^./{}]+)$/);if(t){const n=t[1],i=t[2];return!n||!i?e:{parent:n,entities:[i]}}return e}function Y(e){const r=e.match(/^(.+)\.\{(.+)\}$/);if(r){const t=r[1],n=r[2];if(t&&n)return n.split(",").map(i=>i.trim()).filter(Boolean).map(i=>`${t}.${i}`)}return[e]}function C(e,r){const t=r.map(Z),n={requests:t};return P(n,t,{payloadKey:"file",defaultValue:e.file,predicate:ee,marker:w}),P(n,t,{payloadKey:"scope",defaultValue:e.scope,predicate:te,marker:g}),P(n,t,{payloadKey:"target",defaultValue:e.target,predicate:ne,marker:A}),e.save&&(n.save=e.save),k(n,t),n}function Z(e){const r={...e};for(const t of[w,g,A])e[t]===!0&&h(r,t);return r}function P(e,r,t){if(t.defaultValue===void 0)return;const n=r.filter(t.predicate);if(n.some(i=>i[t.payloadKey]!==void 0)){e[t.payloadKey]=t.defaultValue;for(const i of n)i[t.marker]===!0&&i[t.payloadKey]===t.defaultValue&&delete i[t.payloadKey]}}function k(e,r){for(const t of r){const n=String(t.op??"");if((n==="file"||n==="exports"||n==="imports")&&typeof t.file!="string"&&typeof e.file!="string")throw l(0,`${n} requires file=... or @file.`);if((n==="members"||n==="code"||n==="deps")&&typeof t.file!="string"&&typeof t.fromFile!="string"&&typeof e.file!="string")throw l(0,`${n} requires file=..., from=..., or @file.`);if(n==="usages"&&typeof t.target!="string"&&typeof e.target!="string")throw l(0,"usages requires target=..., positional target, @target, or @file.");if(n==="duplicates"&&typeof t.scope!="string"&&!Array.isArray(t.scope)&&typeof e.scope!="string"&&!Array.isArray(e.scope))throw l(0,"duplicates requires scope=..., positional scope, or @scope.");if(n==="graph"&&typeof t.fromFile!="string"&&typeof t.scope!="string"&&!Array.isArray(t.scope)&&typeof e.scope!="string"&&!Array.isArray(e.scope))throw l(0,"graph requires scope=..., positional scope, @scope, or from=...");if(n==="tree"&&typeof t.scope!="string"&&typeof e.scope!="string")throw l(0,"tree requires scope=..., positional scope, or @scope.");if(n==="cycles"&&typeof t.scope!="string"&&!Array.isArray(t.scope)&&typeof t.file!="string"&&!Array.isArray(t.files)&&typeof e.scope!="string"&&!Array.isArray(e.scope))throw l(0,"cycles requires scope=..., files=[...], positional scope, or @scope.")}}function ee(e){return(e.op==="file"||e.op==="exports"||e.op==="imports"||e.op==="members"||e.op==="code"||e.op==="deps")&&!e.fromFile}function te(e){return(e.op==="duplicates"||e.op==="graph"||e.op==="tree"||e.op==="cycles")&&!e.fromFile}function ne(e){return e.op==="usages"}function ie(e,r,t){if(e==="rename"){const i={};for(const o of r){if(o.startsWith(">")&&o.length>1)throw l(t,"Use @save <name> for mutation payload saves.");const s=o.indexOf("->");if(s<=0||s===o.length-2)throw l(t,`Invalid rename pair: ${o}`);i[o.slice(0,s)]=o.slice(s+2)}return{op:"rename",renames:i}}if(r.some(i=>i.startsWith(">")&&i.length>1))throw l(t,"Use @save <name> for mutation payload saves.");const n=r[0];if(typeof n=="string"&&n.endsWith(":")&&n.length>1){const i=r.slice(1);if(i.length===0)throw l(t,"Move entities are required.");return{op:"move",entities:i,targetFile:n.slice(0,-1)}}throw l(t,"Invalid move syntax. Expected: move target.ts: entity entity")}function re(e,r,t){const{positional:n,fields:i}=S(e,t),o={...i},s=o.scope??n[0]??r.scope;if(s!==void 0&&(o.scope=s),Array.isArray(o.scope))throw l(t,"imports.normalize scope expects one file/dir; use multiple imports.normalize lines for multiple scopes.");if(typeof o.scope!="string"||o.scope.length===0)throw l(t,"imports.normalize requires scope=..., positional scope, or @scope.");if(n.length>1)throw l(t,"imports.normalize accepts one positional scope; use key=value fields for options.");return o}function se(e,r){const{positional:t,fields:n}=S(e,r),i=n.handle??n.from??t[0];if(typeof i!="string"||i.length===0)throw l(r,"view requires a result handle.");if(t.length>1)throw l(r,"view accepts one positional handle; use key=value fields for options.");const o={handle:i};for(const[s,a]of Object.entries(n))s==="handle"||s==="from"||(o[s]=a);return o}function oe(e,r){if(e.findIndex(o=>o.endsWith(":"))!==0)throw l(r,"Plan syntax is: plan target.ts: entity entity");const n=e[0].slice(0,-1),i=e.slice(1);if(!n||i.length===0)throw l(r,"Plan row requires target and at least one entity.");return{target:n,entities:i}}function E(e,r,t){if(!e)throw l(t,`${r} is required.`)}function l(e,r){const t=e>0?`DSL line ${e}: `:"DSL: ";return new Error(`${t}${r}`)}function D(e){return Object.fromEntries(Object.entries(e).filter(r=>r[1]!==void 0))}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileAibDsl = compileAibDsl;
+const INSPECT_OPS = new Set(["file", "exports", "members", "code", "deps", "usages", "duplicates", "graph", "tree", "cycles", "imports", "aliasCandidates", "alias-candidates"]);
+const MUTATION_OPS = new Set(["rename", "move", "plan", "module"]);
+const IMPORT_OPS = new Set(["imports.normalize"]);
+const VIEW_OPS = new Set(["view"]);
+const INSPECT_OPTION_TOKENS_FIELD = "__aibDslOptionTokens";
+const DEFAULT_FILE_MARK = "__aibDslDefaultFile";
+const DEFAULT_SCOPE_MARK = "__aibDslDefaultScope";
+const DEFAULT_TARGET_MARK = "__aibDslDefaultTarget";
+function compileAibDsl(source, options = {}) {
+    if (options.tolerantInspect === true) {
+        return compileAibDslTolerantInspect(source);
+    }
+    const defaults = {};
+    const inspectRequests = [];
+    const mutationRequests = [];
+    const modulePlanRows = [];
+    const importNormalizeRequests = [];
+    const viewRequests = [];
+    let commandFamily = null;
+    for (const line of parseLines(source)) {
+        const [head, ...rest] = line.tokens;
+        if (!head) {
+            continue;
+        }
+        if (head.startsWith("@")) {
+            applyDefault(defaults, head, rest, line.lineNumber);
+            continue;
+        }
+        if (INSPECT_OPS.has(head)) {
+            commandFamily = claimFamily(commandFamily, "inspect", line.lineNumber);
+            inspectRequests.push(compileInspectRequest(head, rest, defaults, line.lineNumber));
+            continue;
+        }
+        if (MUTATION_OPS.has(head)) {
+            commandFamily = claimFamily(commandFamily, "mutation", line.lineNumber);
+            if (head === "plan" || head === "module") {
+                modulePlanRows.push(compilePlanRow(rest, line.lineNumber));
+            }
+            else {
+                mutationRequests.push(compileMutationRequest(head, rest, line.lineNumber));
+            }
+            continue;
+        }
+        if (IMPORT_OPS.has(head)) {
+            commandFamily = claimFamily(commandFamily, "imports", line.lineNumber);
+            importNormalizeRequests.push(compileImportNormalizeRequest(rest, defaults, line.lineNumber));
+            continue;
+        }
+        if (VIEW_OPS.has(head)) {
+            commandFamily = claimFamily(commandFamily, "view", line.lineNumber);
+            viewRequests.push(compileViewRequest(rest, line.lineNumber));
+            continue;
+        }
+        throw dslError(line.lineNumber, `Unknown DSL operation: ${head}`);
+    }
+    if (commandFamily === "inspect") {
+        return {
+            command: "inspect",
+            payload: buildInspectPayload(defaults, inspectRequests)
+        };
+    }
+    if (modulePlanRows.length > 0 && mutationRequests.length > 0) {
+        throw dslError(0, "Cannot mix modulePlan rows with rename/move mutation rows.");
+    }
+    if (modulePlanRows.length > 0) {
+        requireDefault(defaults.sourceFile, "@source", 0);
+        return {
+            command: "modulePlan",
+            payload: compactObject({
+                sourceFile: defaults.sourceFile,
+                modules: modulePlanRows,
+                expectEmpty: defaults.expectEmpty === true ? true : undefined,
+                save: defaults.save
+            })
+        };
+    }
+    if (mutationRequests.length === 1) {
+        requireDefault(defaults.sourceFile, "@source", 0);
+        const request = mutationRequests[0];
+        if (request.op === "rename") {
+            return {
+                command: "rename",
+                payload: compactObject({
+                    sourceFile: defaults.sourceFile,
+                    renames: request.renames,
+                    save: defaults.save
+                })
+            };
+        }
+        return {
+            command: "move.toFile",
+            payload: compactObject({
+                sourceFile: defaults.sourceFile,
+                targetFile: request.targetFile,
+                entities: request.entities,
+                save: defaults.save
+            })
+        };
+    }
+    if (mutationRequests.length > 1) {
+        requireDefault(defaults.sourceFile, "@source", 0);
+        return {
+            command: "refactor.batch",
+            payload: compactObject({
+                sourceFile: defaults.sourceFile,
+                requests: mutationRequests,
+                save: defaults.save
+            })
+        };
+    }
+    if (importNormalizeRequests.length > 0) {
+        return {
+            command: "imports.normalize",
+            payload: importNormalizeRequests.length === 1
+                ? importNormalizeRequests[0]
+                : { requests: importNormalizeRequests }
+        };
+    }
+    if (viewRequests.length > 0) {
+        return {
+            command: "view",
+            payload: viewRequests.length === 1
+                ? viewRequests[0]
+                : { views: viewRequests }
+        };
+    }
+    throw dslError(0, "DSL document has no operations.");
+}
+function compileAibDslTolerantInspect(source) {
+    const defaults = {};
+    const inspectRequests = [];
+    const diagnostics = [];
+    let commandFamily = null;
+    const sourceLines = source.split(/\r?\n/);
+    for (let index = 0; index < sourceLines.length; index += 1) {
+        const lineNumber = index + 1;
+        const rawLine = sourceLines[index] ?? "";
+        const withoutComment = stripComment(rawLine).trim();
+        if (!withoutComment) {
+            continue;
+        }
+        let tokens;
+        try {
+            tokens = tokenize(withoutComment, lineNumber);
+        }
+        catch (error) {
+            diagnostics.push({
+                line: lineNumber,
+                message: stripDslErrorPrefix(error instanceof Error ? error.message : String(error))
+            });
+            continue;
+        }
+        const [head, ...rest] = tokens;
+        if (!head) {
+            continue;
+        }
+        if (head.startsWith("@")) {
+            applyDefault(defaults, head, rest, lineNumber);
+            continue;
+        }
+        if (INSPECT_OPS.has(head)) {
+            commandFamily = claimFamily(commandFamily, "inspect", lineNumber);
+            try {
+                inspectRequests.push(compileInspectRequest(head, rest, defaults, lineNumber));
+            }
+            catch (error) {
+                diagnostics.push({
+                    line: lineNumber,
+                    message: stripDslErrorPrefix(error instanceof Error ? error.message : String(error))
+                });
+            }
+            continue;
+        }
+        if (MUTATION_OPS.has(head) || IMPORT_OPS.has(head)) {
+            throw dslError(lineNumber, "Cannot mix inspect, mutation, and imports operations in one DSL document.");
+        }
+        diagnostics.push({
+            line: lineNumber,
+            message: `Unknown DSL operation: ${head}`
+        });
+    }
+    if (inspectRequests.length === 0) {
+        throw diagnostics.length > 0
+            ? dslError(diagnostics[0].line, diagnostics[0].message)
+            : dslError(0, "DSL document has no operations.");
+    }
+    const payload = buildInspectPayload(defaults, inspectRequests);
+    if (diagnostics.length > 0) {
+        payload.dslDiagnostics = diagnostics.map((diagnostic) => ({
+            line: diagnostic.line,
+            message: diagnostic.message
+        }));
+    }
+    return {
+        command: "inspect",
+        payload,
+        ...(diagnostics.length > 0 ? { diagnostics } : {})
+    };
+}
+function stripDslErrorPrefix(message) {
+    return message.replace(/^DSL(?: line \d+)?:\s*/, "");
+}
+function parseLines(source) {
+    return source.split(/\r?\n/).flatMap((rawLine, index) => {
+        const withoutComment = stripComment(rawLine).trim();
+        if (!withoutComment) {
+            return [];
+        }
+        return [{
+                lineNumber: index + 1,
+                tokens: tokenize(withoutComment, index + 1)
+            }];
+    });
+}
+function stripComment(line) {
+    let quote = null;
+    for (let index = 0; index < line.length; index += 1) {
+        const char = line[index];
+        if ((char === `"` || char === "'") && line[index - 1] !== "\\") {
+            quote = quote === char ? null : quote ?? char;
+        }
+        if (char === "#" && quote === null && (index === 0 || /\s/.test(line[index - 1] ?? ""))) {
+            return line.slice(0, index);
+        }
+    }
+    return line;
+}
+function tokenize(line, lineNumber) {
+    const tokens = [];
+    let current = "";
+    let quote = null;
+    for (let index = 0; index < line.length; index += 1) {
+        const char = line[index];
+        if (quote) {
+            if (char === quote && line[index - 1] !== "\\") {
+                quote = null;
+            }
+            else {
+                current += char;
+            }
+            continue;
+        }
+        if (char === `"` || char === "'") {
+            quote = char;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (quote) {
+        throw dslError(lineNumber, "Unclosed quote.");
+    }
+    if (current) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+function applyDefault(defaults, directive, args, lineNumber) {
+    const value = args.join(" ").trim();
+    if (!value) {
+        throw dslError(lineNumber, `${directive} requires a value.`);
+    }
+    switch (directive) {
+        case "@file":
+            defaults.file = value;
+            return;
+        case "@source": {
+            const { value: sourceFile, flags } = parseDefaultDirectiveValue(args, lineNumber, directive);
+            defaults.sourceFile = sourceFile;
+            if (flags.has("expectEmpty")) {
+                defaults.expectEmpty = true;
+            }
+            return;
+        }
+        case "@scope":
+            defaults.scope = value;
+            return;
+        case "@target":
+            defaults.target = value;
+            return;
+        case "@save":
+            defaults.save = value;
+            return;
+        default:
+            throw dslError(lineNumber, `Unknown DSL default: ${directive}`);
+    }
+}
+function parseDefaultDirectiveValue(args, lineNumber, directive) {
+    const flags = new Set();
+    const valueParts = [];
+    for (const arg of args) {
+        if (arg.startsWith("+") && arg.length > 1) {
+            flags.add(arg.slice(1));
+            continue;
+        }
+        valueParts.push(arg);
+    }
+    const value = valueParts.join(" ").trim();
+    if (!value) {
+        throw dslError(lineNumber, `${directive} requires a value.`);
+    }
+    return { value, flags };
+}
+function claimFamily(current, next, lineNumber) {
+    if (current && current !== next) {
+        throw dslError(lineNumber, "Cannot mix inspect, mutation, and imports operations in one DSL document.");
+    }
+    return next;
+}
+function compileInspectRequest(op, tokens, defaults, lineNumber) {
+    const { positional, fields, optionTokens } = parseRequestTokens(tokens, lineNumber);
+    const request = { op };
+    Object.assign(request, fields);
+    if (optionTokens.length > 0) {
+        request[INSPECT_OPTION_TOKENS_FIELD] = optionTokens;
+    }
+    if (op === "file" || op === "exports" || op === "imports") {
+        const explicitFile = positional[0] ?? fields.file;
+        const file = explicitFile ?? defaults.file;
+        if (file) {
+            request.file = file;
+            if (!explicitFile) {
+                markDefault(request, DEFAULT_FILE_MARK);
+            }
+        }
+        return request;
+    }
+    if (op === "members") {
+        const entityTokens = applyPositionalFileOrDefault(request, positional, defaults);
+        const entities = entityTokens.map(parseEntityToken);
+        if (entities.length === 1 && !fields.entity && !fields.entities) {
+            request.entity = entities[0];
+        }
+        else if (entities.length > 0 && !fields.entities) {
+            request.entities = entities;
+        }
+        return request;
+    }
+    if (op === "code" || op === "deps") {
+        const entityTokens = applyPositionalFileOrDefault(request, positional, defaults);
+        const entities = entityTokens.map(parseEntityToken);
+        if (op === "deps" && entities.length === 1 && typeof entities[0] === "string" && !fields.entities && !fields.entity) {
+            request.entity = entities[0];
+        }
+        else if (entities.length > 0 && !fields.entities && !fields.entity) {
+            request.entities = entities;
+        }
+        return request;
+    }
+    if (op === "usages") {
+        const explicitTarget = fields.target ?? positional[0];
+        const target = explicitTarget ?? defaults.target ?? defaults.file;
+        if (target) {
+            request.target = target;
+            if (!explicitTarget) {
+                markDefault(request, DEFAULT_TARGET_MARK);
+            }
+        }
+        const explicitEntity = fields.entity ?? fields.entities;
+        const entityTokens = target === positional[0] ? positional.slice(1) : positional;
+        const entities = entityTokens.map(parseEntityToken);
+        if (!explicitEntity && entities.length === 1) {
+            request.entity = entities[0];
+        }
+        else if (!explicitEntity && entities.length > 1) {
+            request.entities = entities;
+        }
+        return request;
+    }
+    if (op === "duplicates") {
+        const explicitScope = fields.scope ?? positional[0];
+        const scope = explicitScope ?? defaults.scope;
+        if (scope) {
+            request.scope = scope;
+            if (!explicitScope) {
+                markDefault(request, DEFAULT_SCOPE_MARK);
+            }
+        }
+        return request;
+    }
+    if (op === "tree") {
+        const explicitScope = fields.scope ?? positional[0];
+        const scope = explicitScope ?? defaults.scope;
+        if (scope) {
+            request.scope = scope;
+            if (!explicitScope) {
+                markDefault(request, DEFAULT_SCOPE_MARK);
+            }
+        }
+        return request;
+    }
+    if (op === "cycles" || op === "aliasCandidates" || op === "alias-candidates") {
+        const explicitScope = fields.scope ?? positional[0];
+        const scope = explicitScope ?? defaults.scope;
+        if (scope) {
+            request.scope = scope;
+            if (!explicitScope) {
+                markDefault(request, DEFAULT_SCOPE_MARK);
+            }
+        }
+        return request;
+    }
+    if (op === "graph") {
+        const explicitScope = fields.scope ?? positional[0];
+        const scope = explicitScope ?? defaults.scope;
+        if (scope && !request.fromFile) {
+            request.scope = scope;
+            if (!explicitScope) {
+                markDefault(request, DEFAULT_SCOPE_MARK);
+            }
+        }
+        return request;
+    }
+    return request;
+}
+function applyFileDefault(request, defaults) {
+    if (!request.file && !request.fromFile && defaults.file) {
+        request.file = defaults.file;
+        markDefault(request, DEFAULT_FILE_MARK);
+    }
+}
+function applyPositionalFileOrDefault(request, positional, defaults) {
+    if (!request.file && !request.fromFile && positional.length > 0 && isPathLikeToken(positional[0])) {
+        request.file = positional[0];
+        return positional.slice(1);
+    }
+    applyFileDefault(request, defaults);
+    return positional;
+}
+function isPathLikeToken(token) {
+    return token.includes("/") ||
+        token.includes("\\") ||
+        /^@[^/\\]+[/\\]/.test(token) ||
+        /\.(?:[cm]?[jt]sx?|d\.ts)$/i.test(token);
+}
+function markDefault(request, key) {
+    Object.defineProperty(request, key, {
+        value: true,
+        enumerable: false
+    });
+}
+function parseRequestTokens(tokens, lineNumber) {
+    const positional = [];
+    const fields = {};
+    const optionTokens = [];
+    for (const token of tokens) {
+        if (token.startsWith("+") && token.length > 1) {
+            optionTokens.push(token);
+            assignField(fields, token.slice(1), true);
+            continue;
+        }
+        if (token.startsWith("-") && token.length > 1) {
+            optionTokens.push(token);
+            assignField(fields, token.slice(1), false);
+            continue;
+        }
+        if (token.startsWith(">") && token.length > 1) {
+            optionTokens.push(token);
+            assignField(fields, "save", token.slice(1));
+            continue;
+        }
+        const equalIndex = token.indexOf("=");
+        if (equalIndex > 0) {
+            const rawKey = token.slice(0, equalIndex);
+            const rawValue = token.slice(equalIndex + 1);
+            optionTokens.push(token);
+            assignField(fields, normalizeKey(rawKey), parseValue(rawKey, rawValue));
+            continue;
+        }
+        if (token === "->") {
+            throw dslError(lineNumber, "Unexpected move separator in inspect request.");
+        }
+        positional.push(token);
+    }
+    return { positional, fields, optionTokens };
+}
+function assignField(fields, key, value) {
+    const existing = fields[key];
+    if (existing === undefined) {
+        fields[key] = value;
+        return;
+    }
+    if (isRepeatableField(key)) {
+        fields[key] = [...asArray(existing), ...asArray(value)];
+        return;
+    }
+    fields[key] = value;
+}
+function isRepeatableField(key) {
+    return key === "focus" ||
+        key === "scope" ||
+        key === "scopes" ||
+        key === "file" ||
+        key === "files" ||
+        key === "exclude" ||
+        key === "excludes" ||
+        key === "pathExclude" ||
+        key === "pathExcludes" ||
+        key === "excludePath" ||
+        key === "excludePaths" ||
+        key === "entities" ||
+        key === "only" ||
+        key === "except" ||
+        key === "kinds";
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+function normalizeKey(key) {
+    if (key === "from") {
+        return "fromFile";
+    }
+    if (key === "no-default-exclude") {
+        return "noDefaultExclude";
+    }
+    if (key === "no-config-exclude") {
+        return "noConfigExclude";
+    }
+    return key;
+}
+function parseValue(key, value) {
+    const normalized = normalizeDetailAlias(value);
+    const bracketItems = parseBracketList(normalized);
+    if (/^-?\d+$/.test(normalized)) {
+        return Number(normalized);
+    }
+    if (normalized === "true") {
+        return true;
+    }
+    if (normalized === "false") {
+        return false;
+    }
+    if (key === "entity" || key === "entities") {
+        const entities = (bracketItems ?? splitCommaList(normalized)).map(parseEntityToken);
+        return key === "entity" && entities.length === 1 ? entities[0] : entities;
+    }
+    if (key === "only" || key === "except") {
+        return (bracketItems ?? splitCommaList(normalized)).flatMap(expandSelectorToken);
+    }
+    if (bracketItems && isRepeatableField(normalizeKey(key))) {
+        return bracketItems;
+    }
+    if (isRepeatableField(normalizeKey(key)) && normalized.includes(",")) {
+        return splitCommaList(normalized);
+    }
+    return normalized;
+}
+function parseBracketList(value) {
+    if (!value.startsWith("[") || !value.endsWith("]")) {
+        return null;
+    }
+    const inner = value.slice(1, -1).trim();
+    if (!inner) {
+        return [];
+    }
+    return splitCommaList(inner);
+}
+function splitCommaList(value) {
+    const items = [];
+    let current = "";
+    let braceDepth = 0;
+    let bracketDepth = 0;
+    for (const char of value) {
+        if (char === "{") {
+            braceDepth += 1;
+        }
+        else if (char === "}" && braceDepth > 0) {
+            braceDepth -= 1;
+        }
+        else if (char === "[") {
+            bracketDepth += 1;
+        }
+        else if (char === "]" && bracketDepth > 0) {
+            bracketDepth -= 1;
+        }
+        if (char === "," && braceDepth === 0 && bracketDepth === 0) {
+            if (current.trim()) {
+                items.push(current.trim());
+            }
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        items.push(current.trim());
+    }
+    return items;
+}
+function normalizeDetailAlias(value) {
+    if (value === "sum") {
+        return "summary";
+    }
+    if (value === "loc") {
+        return "locations";
+    }
+    return value;
+}
+function parseEntityToken(token) {
+    const groupMatch = token.match(/^(.+)\.\{(.+)\}$/);
+    if (groupMatch) {
+        const parent = groupMatch[1];
+        const members = groupMatch[2];
+        if (!parent || !members) {
+            return token;
+        }
+        return {
+            parent,
+            entities: members.split(",").map((item) => item.trim()).filter(Boolean)
+        };
+    }
+    const memberMatch = token.match(/^(.+)\.([^./{}]+)$/);
+    if (memberMatch) {
+        const parent = memberMatch[1];
+        const member = memberMatch[2];
+        if (!parent || !member) {
+            return token;
+        }
+        return {
+            parent,
+            entities: [member]
+        };
+    }
+    return token;
+}
+function expandSelectorToken(token) {
+    const groupMatch = token.match(/^(.+)\.\{(.+)\}$/);
+    if (groupMatch) {
+        const parent = groupMatch[1];
+        const members = groupMatch[2];
+        if (parent && members) {
+            return members.split(",").map((item) => item.trim()).filter(Boolean).map((member) => `${parent}.${member}`);
+        }
+    }
+    return [token];
+}
+function buildInspectPayload(defaults, requests) {
+    const normalizedRequests = requests.map(cloneRequestWithMarkers);
+    const payload = { requests: normalizedRequests };
+    hoistDefaultField(payload, normalizedRequests, {
+        payloadKey: "file",
+        defaultValue: defaults.file,
+        predicate: requestCanUsePayloadFile,
+        marker: DEFAULT_FILE_MARK
+    });
+    hoistDefaultField(payload, normalizedRequests, {
+        payloadKey: "scope",
+        defaultValue: defaults.scope,
+        predicate: requestCanUsePayloadScope,
+        marker: DEFAULT_SCOPE_MARK
+    });
+    hoistDefaultField(payload, normalizedRequests, {
+        payloadKey: "target",
+        defaultValue: defaults.target,
+        predicate: requestCanUsePayloadTarget,
+        marker: DEFAULT_TARGET_MARK
+    });
+    if (defaults.save) {
+        payload.save = defaults.save;
+    }
+    assertInspectPayload(payload, normalizedRequests);
+    return payload;
+}
+function cloneRequestWithMarkers(request) {
+    const clone = { ...request };
+    for (const key of [DEFAULT_FILE_MARK, DEFAULT_SCOPE_MARK, DEFAULT_TARGET_MARK]) {
+        if (request[key] === true) {
+            markDefault(clone, key);
+        }
+    }
+    return clone;
+}
+function hoistDefaultField(payload, requests, options) {
+    if (options.defaultValue === undefined) {
+        return;
+    }
+    const relevant = requests.filter(options.predicate);
+    if (!relevant.some((request) => request[options.payloadKey] !== undefined)) {
+        return;
+    }
+    payload[options.payloadKey] = options.defaultValue;
+    for (const request of relevant) {
+        if (request[options.marker] === true && request[options.payloadKey] === options.defaultValue) {
+            delete request[options.payloadKey];
+        }
+    }
+}
+function assertInspectPayload(payload, requests) {
+    for (const request of requests) {
+        const op = String(request.op ?? "");
+        if ((op === "file" || op === "exports" || op === "imports") && typeof request.file !== "string" && typeof payload.file !== "string") {
+            throw dslError(0, `${op} requires file=... or @file.`);
+        }
+        if ((op === "members" || op === "code" || op === "deps") && typeof request.file !== "string" && typeof request.fromFile !== "string" && typeof payload.file !== "string") {
+            throw dslError(0, `${op} requires file=..., from=..., or @file.`);
+        }
+        if (op === "usages" && typeof request.target !== "string" && typeof payload.target !== "string") {
+            throw dslError(0, "usages requires target=..., positional target, @target, or @file.");
+        }
+        if (op === "duplicates" && typeof request.scope !== "string" && !Array.isArray(request.scope) && typeof payload.scope !== "string" && !Array.isArray(payload.scope)) {
+            throw dslError(0, "duplicates requires scope=..., positional scope, or @scope.");
+        }
+        if (op === "graph" && typeof request.fromFile !== "string" && typeof request.scope !== "string" && !Array.isArray(request.scope) && typeof payload.scope !== "string" && !Array.isArray(payload.scope)) {
+            throw dslError(0, "graph requires scope=..., positional scope, @scope, or from=...");
+        }
+        if (op === "tree" && typeof request.scope !== "string" && typeof payload.scope !== "string") {
+            throw dslError(0, "tree requires scope=..., positional scope, or @scope.");
+        }
+        if (op === "cycles" && typeof request.scope !== "string" && !Array.isArray(request.scope) && typeof request.file !== "string" && !Array.isArray(request.files) && typeof payload.scope !== "string" && !Array.isArray(payload.scope)) {
+            throw dslError(0, "cycles requires scope=..., files=[...], positional scope, or @scope.");
+        }
+        if ((op === "aliasCandidates" || op === "alias-candidates") && typeof request.scope !== "string" && typeof payload.scope !== "string") {
+            throw dslError(0, "aliasCandidates requires scope=..., positional scope, or @scope.");
+        }
+    }
+}
+function requestCanUsePayloadFile(request) {
+    return (request.op === "file" ||
+        request.op === "exports" ||
+        request.op === "imports" ||
+        request.op === "members" ||
+        request.op === "code" ||
+        request.op === "deps") && !request.fromFile;
+}
+function requestCanUsePayloadScope(request) {
+    return (request.op === "duplicates" ||
+        request.op === "graph" ||
+        request.op === "tree" ||
+        request.op === "cycles" ||
+        request.op === "aliasCandidates" ||
+        request.op === "alias-candidates") && !request.fromFile;
+}
+function requestCanUsePayloadTarget(request) {
+    return request.op === "usages";
+}
+function compileMutationRequest(op, tokens, lineNumber) {
+    if (op === "rename") {
+        const renames = {};
+        for (const token of tokens) {
+            if (token.startsWith(">") && token.length > 1) {
+                throw dslError(lineNumber, "Use @save <name> for mutation payload saves.");
+            }
+            const index = token.indexOf("->");
+            if (index <= 0 || index === token.length - 2) {
+                throw dslError(lineNumber, `Invalid rename pair: ${token}`);
+            }
+            renames[token.slice(0, index)] = token.slice(index + 2);
+        }
+        return { op: "rename", renames };
+    }
+    if (tokens.some((token) => token.startsWith(">") && token.length > 1)) {
+        throw dslError(lineNumber, "Use @save <name> for mutation payload saves.");
+    }
+    const targetFirst = tokens[0];
+    if (typeof targetFirst === "string" && targetFirst.endsWith(":") && targetFirst.length > 1) {
+        const entities = tokens.slice(1);
+        if (entities.length === 0) {
+            throw dslError(lineNumber, "Move entities are required.");
+        }
+        return {
+            op: "move",
+            entities,
+            targetFile: targetFirst.slice(0, -1)
+        };
+    }
+    throw dslError(lineNumber, "Invalid move syntax. Expected: move target.ts: entity entity");
+}
+function compileImportNormalizeRequest(tokens, defaults, lineNumber) {
+    const { positional, fields } = parseRequestTokens(tokens, lineNumber);
+    const request = { ...fields };
+    const scope = request.scope ?? positional[0] ?? defaults.scope;
+    if (scope !== undefined) {
+        request.scope = scope;
+    }
+    if (Array.isArray(request.scope)) {
+        throw dslError(lineNumber, "imports.normalize scope expects one file/dir; use multiple imports.normalize lines for multiple scopes.");
+    }
+    if (typeof request.scope !== "string" || request.scope.length === 0) {
+        throw dslError(lineNumber, "imports.normalize requires scope=..., positional scope, or @scope.");
+    }
+    if (positional.length > 1) {
+        throw dslError(lineNumber, "imports.normalize accepts one positional scope; use key=value fields for options.");
+    }
+    return request;
+}
+function compileViewRequest(tokens, lineNumber) {
+    const { positional, fields } = parseRequestTokens(tokens, lineNumber);
+    const handle = fields.handle ?? fields.from ?? positional[0];
+    if (typeof handle !== "string" || handle.length === 0) {
+        throw dslError(lineNumber, "view requires a result handle.");
+    }
+    if (positional.length > 1) {
+        throw dslError(lineNumber, "view accepts one positional handle; use key=value fields for options.");
+    }
+    const request = {
+        handle
+    };
+    for (const [key, value] of Object.entries(fields)) {
+        if (key === "handle" || key === "from") {
+            continue;
+        }
+        request[key] = value;
+    }
+    return request;
+}
+function compilePlanRow(tokens, lineNumber) {
+    const colonIndex = tokens.findIndex((token) => token.endsWith(":"));
+    if (colonIndex !== 0) {
+        throw dslError(lineNumber, "Plan syntax is: plan target.ts: entity entity");
+    }
+    const target = tokens[0].slice(0, -1);
+    const entities = tokens.slice(1);
+    if (!target || entities.length === 0) {
+        throw dslError(lineNumber, "Plan row requires target and at least one entity.");
+    }
+    return { target, entities };
+}
+function requireDefault(value, name, lineNumber) {
+    if (!value) {
+        throw dslError(lineNumber, `${name} is required.`);
+    }
+}
+function dslError(lineNumber, message) {
+    const prefix = lineNumber > 0 ? `DSL line ${lineNumber}: ` : "DSL: ";
+    return new Error(`${prefix}${message}`);
+}
+function compactObject(input) {
+    return Object.fromEntries(Object.entries(input).filter((entry) => entry[1] !== undefined));
+}