@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/commands/add-missing-imports-preview-cache.js

@@ -1,2 +1,99 @@
-"use strict";var f=exports&&exports.__createBinding||(Object.create?(function(r,e,t,i){i===void 0&&(i=t);var n=Object.getOwnPropertyDescriptor(e,t);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[t]}}),Object.defineProperty(r,i,n)}):(function(r,e,t,i){i===void 0&&(i=t),r[i]=e[t]})),d=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),c=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(t){var i=[];for(var n in t)Object.prototype.hasOwnProperty.call(t,n)&&(i[i.length]=n);return i},r(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(e!=null)for(var i=r(e),n=0;n<i.length;n++)i[n]!=="default"&&f(t,e,i[n]);return d(t,e),t}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildAddMissingImportsPreviewId=g,exports.buildAddMissingImportsPreviewHash=y,exports.readAddMissingImportsPreviewRecord=P,exports.writeAddMissingImportsPreviewRecord=m,exports.hashFiles=w;const l=c(require("node:crypto")),s=c(require("node:fs")),h=c(require("node:path")),p=require("../shared/errors"),_=require("./workspace-cache");function g(r){return`imports_${o(u(r)).slice(0,10)}`}function y(r,e,t){return`sha256:${o(u({normalizedPayload:r,fileHashes:e,summary:t.summary,files:t.files}))}`}function P(r,e){const t=a(r,e);if(!s.existsSync(t))throw new p.CliError("ADD_MISSING_IMPORTS_PREVIEW_NOT_FOUND",`Add missing imports preview not found: ${e}`,{previewId:e,expectedPath:t});return JSON.parse(s.readFileSync(t,"utf8"))}function m(r,e){const t=a(r,e.previewId);s.mkdirSync(h.dirname(t),{recursive:!0}),s.writeFileSync(t,`${JSON.stringify(e,null,2)}
-`)}function w(r){const e={};for(const t of r)e[t]=s.existsSync(t)?o(s.readFileSync(t)):"missing";return e}function a(r,e){return(0,_.workspaceCachePath)(r,"add-missing-imports-previews",`${b(e)}.json`)}function o(r){return l.createHash("sha256").update(r).digest("hex")}function u(r){return r===null||typeof r!="object"?JSON.stringify(r):Array.isArray(r)?`[${r.map(e=>u(e)).join(",")}]`:`{${Object.entries(r).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>`${JSON.stringify(e)}:${u(t)}`).join(",")}}`}function b(r){return r.replace(/[^a-z0-9_-]+/gi,"-")}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAddMissingImportsPreviewId = buildAddMissingImportsPreviewId;
+exports.buildAddMissingImportsPreviewHash = buildAddMissingImportsPreviewHash;
+exports.readAddMissingImportsPreviewRecord = readAddMissingImportsPreviewRecord;
+exports.writeAddMissingImportsPreviewRecord = writeAddMissingImportsPreviewRecord;
+exports.hashFiles = hashFiles;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const errors_1 = require("../shared/errors");
+const workspace_cache_1 = require("./workspace-cache");
+function buildAddMissingImportsPreviewId(normalizedPayload) {
+    return `imports_${sha256(stableStringify(normalizedPayload)).slice(0, 10)}`;
+}
+function buildAddMissingImportsPreviewHash(normalizedPayload, fileHashes, previewResult) {
+    return `sha256:${sha256(stableStringify({
+        normalizedPayload,
+        fileHashes,
+        summary: previewResult.summary,
+        files: previewResult.files
+    }))}`;
+}
+function readAddMissingImportsPreviewRecord(cwd, previewId) {
+    const filePath = addMissingImportsPreviewRecordPath(cwd, previewId);
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("ADD_MISSING_IMPORTS_PREVIEW_NOT_FOUND", `Add missing imports preview not found: ${previewId}`, {
+            previewId,
+            expectedPath: filePath
+        });
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function writeAddMissingImportsPreviewRecord(cwd, record) {
+    const filePath = addMissingImportsPreviewRecordPath(cwd, record.previewId);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(record, null, 2)}\n`);
+}
+function hashFiles(files) {
+    const hashes = {};
+    for (const file of files) {
+        hashes[file] = fs.existsSync(file) ? sha256(fs.readFileSync(file)) : "missing";
+    }
+    return hashes;
+}
+function addMissingImportsPreviewRecordPath(cwd, previewId) {
+    return (0, workspace_cache_1.workspaceCachePath)(cwd, "add-missing-imports-previews", `${sanitizeId(previewId)}.json`);
+}
+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 sanitizeId(value) {
+    return value.replace(/[^a-z0-9_-]+/gi, "-");
+}

package/dist/commands/add-missing-imports.js

@@ -1,2 +1,241 @@
-"use strict";var R=exports&&exports.__createBinding||(Object.create?(function(t,e,i,r){r===void 0&&(r=i);var n=Object.getOwnPropertyDescriptor(e,i);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(t,r,n)}):(function(t,e,i,r){r===void 0&&(r=i),t[r]=e[i]})),D=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),x=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(i){var r=[];for(var n in i)Object.prototype.hasOwnProperty.call(i,n)&&(r[r.length]=n);return r},t(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var r=t(e),n=0;n<r.length;n++)r[n]!=="default"&&R(i,e,r[n]);return D(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runAddMissingImports=C;const y=x(require("node:path")),h=require("zod"),j=require("../client/http-client"),I=require("../shared/agent-text"),f=require("../shared/errors"),$=require("../shared/protocol"),F=require("../shared/routes"),M=require("./shared"),d=require("./add-missing-imports-preview-cache"),v=h.z.object({scope:h.z.string().min(1),execute:h.z.boolean().optional()});async function C(t,e,i={},r=[]){const n=r[0]??"preview";if(n==="help"||n==="--help")return{command:"imports addMissing",usage:["aib imports addMissing preview <file-or-dir>","aib imports addMissing apply <previewId>","aib imports addMissing execute <file-or-dir>"]};if(n==="apply"){const s=r[1];if(!s||s.startsWith("--"))throw new f.CliError("ADD_MISSING_IMPORTS_PREVIEW_ID_REQUIRED","imports addMissing apply expects a preview id.",{usage:"aib imports addMissing apply <previewId>"});return T(t,s,i)}const c=W(r),a=O(e??c,n==="execute");return b(t,a,i)}async function T(t,e,i){const r=(0,d.readAddMissingImportsPreviewRecord)(t,e),n=(0,d.hashFiles)(Object.keys(r.fileHashes));for(const[u,o]of Object.entries(r.fileHashes))if(n[u]!==o)throw new f.CliError("ADD_MISSING_IMPORTS_PREVIEW_FILES_CHANGED","Files changed after imports addMissing preview. Rerun preview.",{previewId:e,file:m(t,u)});const c=v.parse({...r.normalizedPayload,execute:!0}),s={...await b(t,c,i,e),operation:"imports.addMissing.apply"};return(0,I.attachAgentText)(s,A(s))}async function b(t,e,i,r){const n=await(0,M.resolveCompatibleTargetInstance)(t,$.CLI_COMMAND_IDS.addMissingImports,i),c=e.execute===!0,a=await(0,j.postJson)(n.entry,F.EXTENSION_ROUTES.addMissingImports,{scope:e.scope,execute:c},(0,M.extensionRequestOptions)(i)),s=q(t,a,c,r);if(!c&&s.ok!==!1){const u=O(e,!1),o=(0,d.buildAddMissingImportsPreviewId)(u),S=Array.isArray(s.allTouchedFiles)?s.allTouchedFiles.filter(E=>typeof E=="string"):[],_=(0,d.hashFiles)(S),w=(0,d.buildAddMissingImportsPreviewHash)(u,_,s);(0,d.writeAddMissingImportsPreviewRecord)(t,{previewId:o,previewHash:w,createdAt:new Date().toISOString(),cwd:y.resolve(t),normalizedPayload:u,fileHashes:_,previewResult:s}),s.previewId=o,s.next=`aib imports addMissing apply ${o}`}return(0,I.attachAgentText)(s,A(s))}function q(t,e,i,r){if(e.ok===!1)return e;const c=(Array.isArray(e.files)?e.files.filter(z):[]).filter(o=>l(o,"editCount")>0),a=Array.isArray(e.changedFiles)?e.changedFiles.filter(o=>typeof o=="string"):c.map(o=>typeof o.file=="string"?o.file:"").filter(Boolean),s=a.map(o=>m(t,o));return H({operation:r?"imports.addMissing.apply":i?"imports.addMissing.execute":"imports.addMissing.preview",scope:typeof e.scope=="string"?m(t,e.scope):null,summary:N(i,l(e,"changedFileCount"),l(e,"editCount"),l(e,"fileCount")),files:i?null:P(s,8),filesWritten:i?P(s,8):null,allTouchedFiles:a,fileCount:l(e,"fileCount"),changedFileCount:l(e,"changedFileCount"),editCount:l(e,"editCount"),previewId:r??null})}function N(t,e,i,r){return i===0?`${r} ${g(r,"file")} checked, no missing imports fixed`:`${t?`${e} ${g(e,"file")} written`:`${e} ${g(e,"file")} with edits`}, ${i} ${g(i,"edit")}`}function A(t){const e=[],i=typeof t.operation=="string"?t.operation:"imports.addMissing",r=typeof t.previewId=="string"&&i.endsWith(".preview")?` ${t.previewId}`:"";e.push(`${i}${r}`),typeof t.scope=="string"&&e.push(t.scope),typeof t.summary=="string"&&e.push(t.summary);const n=Array.isArray(t.filesWritten)?t.filesWritten:Array.isArray(t.files)?t.files:[];for(const c of n)typeof c=="string"&&e.push(c);return typeof t.next=="string"&&e.push(`next: ${t.next}`),e.join(`
-`)}function W(t){const e=t[0]??"preview",i=t.slice(1).find(r=>!r.startsWith("--"));return i?{scope:i,execute:e==="execute"}:void 0}function O(t,e){if(!t||typeof t!="object"||Array.isArray(t))throw new f.CliError("ADD_MISSING_IMPORTS_SCOPE_REQUIRED","imports addMissing expects a file or directory scope.");const i=t,r=p(i.scope)??p(i.file)??p(i.dir)??p(i.directory);if(!r)throw new f.CliError("ADD_MISSING_IMPORTS_SCOPE_REQUIRED","imports addMissing expects scope, file, dir, or directory.");const n=v.parse({scope:r,execute:e||i.execute===!0});return{scope:n.scope,execute:n.execute===!0}}function P(t,e){return t.length<=e?t:[...t.slice(0,e),`+ ${t.length-e} more`]}function H(t){const e={};for(const[i,r]of Object.entries(t))r!=null&&(e[i]=r);return e}function z(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function p(t){return typeof t=="string"&&t.trim()!==""?t.trim():null}function l(t,e){const i=t[e];return typeof i=="number"&&Number.isFinite(i)?i:0}function m(t,e){const i=y.relative(t,e);return i&&!i.startsWith("..")&&!y.isAbsolute(i)?i.replace(/\\/g,"/"):e.replace(/\\/g,"/")}function g(t,e){return t===1?e:`${e}s`}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAddMissingImports = runAddMissingImports;
+const path = __importStar(require("node:path"));
+const zod_1 = require("zod");
+const import_rules_1 = require("../config/import-rules");
+const standalone_import_process_1 = require("../imports/standalone-import-process");
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const add_missing_imports_preview_cache_1 = require("./add-missing-imports-preview-cache");
+const AddMissingImportsPayloadSchema = zod_1.z.object({
+    scope: zod_1.z.string().min(1),
+    execute: zod_1.z.boolean().optional()
+});
+async function runAddMissingImports(cwd, rawPayload, options = {}, restArgs = []) {
+    const action = restArgs[0] ?? "preview";
+    if (action === "help" || action === "--help") {
+        return {
+            command: "imports addMissing",
+            usage: [
+                "aib imports addMissing preview <file-or-dir>",
+                "aib imports addMissing apply <previewId>",
+                "aib imports addMissing execute <file-or-dir>"
+            ]
+        };
+    }
+    if (action === "apply") {
+        const previewId = restArgs[1];
+        if (!previewId || previewId.startsWith("--")) {
+            throw new errors_1.CliError("ADD_MISSING_IMPORTS_PREVIEW_ID_REQUIRED", "imports addMissing apply expects a preview id.", {
+                usage: "aib imports addMissing apply <previewId>"
+            });
+        }
+        return applyAddMissingImportsPreview(cwd, previewId, options);
+    }
+    const directPayload = payloadFromArgs(restArgs);
+    const payload = normalizePayload(rawPayload ?? directPayload, action === "execute");
+    return runAddMissingImportsPayload(cwd, payload, options);
+}
+async function applyAddMissingImportsPreview(cwd, previewId, options) {
+    const record = (0, add_missing_imports_preview_cache_1.readAddMissingImportsPreviewRecord)(cwd, previewId);
+    const currentHashes = (0, add_missing_imports_preview_cache_1.hashFiles)(Object.keys(record.fileHashes));
+    for (const [file, expectedHash] of Object.entries(record.fileHashes)) {
+        if (currentHashes[file] !== expectedHash) {
+            throw new errors_1.CliError("ADD_MISSING_IMPORTS_PREVIEW_FILES_CHANGED", "Files changed after imports addMissing preview. Rerun preview.", {
+                previewId,
+                file: formatRelativePath(cwd, file)
+            });
+        }
+    }
+    const payload = AddMissingImportsPayloadSchema.parse({
+        ...record.normalizedPayload,
+        execute: true
+    });
+    const result = await runAddMissingImportsPayload(cwd, payload, options, previewId);
+    const response = {
+        ...result,
+        operation: "imports.addMissing.apply"
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatAddMissingImportsAgentText(response));
+}
+async function runAddMissingImportsPayload(cwd, payload, options, previewIdFromApply) {
+    const execute = payload.execute === true;
+    const rawResult = await (0, standalone_import_process_1.runStandaloneImportWorker)({
+        workspaceRoot: cwd,
+        operation: "add-missing",
+        payload: { scope: payload.scope, execute },
+        importRules: options.importRules ?? (0, import_rules_1.readConfigImportRules)(cwd)
+    });
+    const response = compactAddMissingImportsPayload(cwd, rawResult, execute, previewIdFromApply);
+    if (!execute && response.ok !== false) {
+        const normalizedPayload = normalizePayload(payload, false);
+        const previewId = (0, add_missing_imports_preview_cache_1.buildAddMissingImportsPreviewId)(normalizedPayload);
+        const touchedFiles = Array.isArray(response.allTouchedFiles)
+            ? response.allTouchedFiles.filter((file) => typeof file === "string")
+            : [];
+        const fileHashes = (0, add_missing_imports_preview_cache_1.hashFiles)(touchedFiles);
+        const previewHash = (0, add_missing_imports_preview_cache_1.buildAddMissingImportsPreviewHash)(normalizedPayload, fileHashes, response);
+        (0, add_missing_imports_preview_cache_1.writeAddMissingImportsPreviewRecord)(cwd, {
+            previewId,
+            previewHash,
+            createdAt: new Date().toISOString(),
+            cwd: path.resolve(cwd),
+            normalizedPayload,
+            fileHashes,
+            previewResult: response
+        });
+        response.previewId = previewId;
+        response.next = `aib imports addMissing apply ${previewId}`;
+    }
+    return (0, agent_text_1.attachAgentText)(response, formatAddMissingImportsAgentText(response));
+}
+function compactAddMissingImportsPayload(cwd, raw, execute, previewIdFromApply) {
+    if (raw.ok === false) {
+        return raw;
+    }
+    const files = Array.isArray(raw.files) ? raw.files.filter(isObject) : [];
+    const changedRows = files.filter((file) => numberField(file, "editCount") > 0);
+    const touchedFiles = Array.isArray(raw.changedFiles)
+        ? raw.changedFiles.filter((file) => typeof file === "string")
+        : changedRows.map((row) => typeof row.file === "string" ? row.file : "").filter(Boolean);
+    const formattedTouchedFiles = touchedFiles.map((file) => formatRelativePath(cwd, file));
+    const operation = previewIdFromApply
+        ? "imports.addMissing.apply"
+        : execute ? "imports.addMissing.execute" : "imports.addMissing.preview";
+    return compactObject({
+        operation,
+        scope: typeof raw.scope === "string" ? formatRelativePath(cwd, raw.scope) : null,
+        summary: buildSummary(execute, numberField(raw, "changedFileCount"), numberField(raw, "editCount"), numberField(raw, "fileCount")),
+        files: !execute ? compactFiles(formattedTouchedFiles, 8) : null,
+        filesWritten: execute ? compactFiles(formattedTouchedFiles, 8) : null,
+        allTouchedFiles: touchedFiles,
+        fileCount: numberField(raw, "fileCount"),
+        changedFileCount: numberField(raw, "changedFileCount"),
+        editCount: numberField(raw, "editCount"),
+        previewId: previewIdFromApply ?? null
+    });
+}
+function buildSummary(execute, changedFileCount, editCount, fileCount) {
+    if (editCount === 0) {
+        return `${fileCount} ${plural(fileCount, "file")} checked, no missing imports fixed`;
+    }
+    const filePart = execute
+        ? `${changedFileCount} ${plural(changedFileCount, "file")} written`
+        : `${changedFileCount} ${plural(changedFileCount, "file")} with edits`;
+    return `${filePart}, ${editCount} ${plural(editCount, "edit")}`;
+}
+function formatAddMissingImportsAgentText(response) {
+    const lines = [];
+    const operation = typeof response.operation === "string" ? response.operation : "imports.addMissing";
+    const previewId = typeof response.previewId === "string" && operation.endsWith(".preview") ? ` ${response.previewId}` : "";
+    lines.push(`${operation}${previewId}`);
+    if (typeof response.scope === "string") {
+        lines.push(response.scope);
+    }
+    if (typeof response.summary === "string") {
+        lines.push(response.summary);
+    }
+    const files = Array.isArray(response.filesWritten)
+        ? response.filesWritten
+        : Array.isArray(response.files) ? response.files : [];
+    for (const file of files) {
+        if (typeof file === "string") {
+            lines.push(file);
+        }
+    }
+    if (typeof response.next === "string") {
+        lines.push(`next: ${response.next}`);
+    }
+    return lines.join("\n");
+}
+function payloadFromArgs(args) {
+    const action = args[0] ?? "preview";
+    const scope = args.slice(1).find((item) => !item.startsWith("--"));
+    return scope ? { scope, execute: action === "execute" } : undefined;
+}
+function normalizePayload(rawPayload, execute) {
+    if (!rawPayload || typeof rawPayload !== "object" || Array.isArray(rawPayload)) {
+        throw new errors_1.CliError("ADD_MISSING_IMPORTS_SCOPE_REQUIRED", "imports addMissing expects a file or directory scope.");
+    }
+    const raw = rawPayload;
+    const scope = readString(raw.scope) ?? readString(raw.file) ?? readString(raw.dir) ?? readString(raw.directory);
+    if (!scope) {
+        throw new errors_1.CliError("ADD_MISSING_IMPORTS_SCOPE_REQUIRED", "imports addMissing expects scope, file, dir, or directory.");
+    }
+    const parsed = AddMissingImportsPayloadSchema.parse({
+        scope,
+        execute: execute || raw.execute === true
+    });
+    return {
+        scope: parsed.scope,
+        execute: parsed.execute === true
+    };
+}
+function compactFiles(files, limit) {
+    if (files.length <= limit) {
+        return files;
+    }
+    return [...files.slice(0, limit), `+ ${files.length - limit} more`];
+}
+function compactObject(input) {
+    const output = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (value !== null && value !== undefined) {
+            output[key] = value;
+        }
+    }
+    return output;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function numberField(value, field) {
+    const raw = value[field];
+    return typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+}
+function formatRelativePath(cwd, file) {
+    const relative = path.relative(cwd, file);
+    return relative && !relative.startsWith("..") && !path.isAbsolute(relative)
+        ? relative.replace(/\\/g, "/")
+        : file.replace(/\\/g, "/");
+}
+function plural(count, singular) {
+    return count === 1 ? singular : `${singular}s`;
+}