@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/commands/file-text-edit-executor.js

@@ -0,0 +1,205 @@
+"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.applyTextOnlyFileCodeEditsDirectly = applyTextOnlyFileCodeEditsDirectly;
+exports.applyTextChanges = applyTextChanges;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function applyTextOnlyFileCodeEditsDirectly(fileCodeEdits, fsAdapter = fs, expectedOriginalTexts) {
+    const changesByFile = new Map();
+    for (const fileEdit of fileCodeEdits) {
+        const targetFile = path.normalize(fileEdit.fileName);
+        if (!fsAdapter.existsSync(targetFile)) {
+            return {
+                ok: false,
+                code: "FILE_TEXT_EDIT_TARGET_MISSING",
+                error: `Text edits target a missing file: ${targetFile}`
+            };
+        }
+        const currentChanges = changesByFile.get(targetFile) ?? [];
+        currentChanges.push(...fileEdit.textChanges);
+        changesByFile.set(targetFile, currentChanges);
+    }
+    const preparedEdits = [];
+    for (const [targetFile, textChanges] of changesByFile.entries()) {
+        const validation = validateAndNormalizeTextChanges(textChanges);
+        if (validation.ok === false) {
+            return {
+                ok: false,
+                code: validation.code,
+                error: `${targetFile}: ${validation.error}`
+            };
+        }
+        const originalText = fsAdapter.readFileSync(targetFile, "utf8");
+        const expectedOriginalText = expectedOriginalTexts?.get(targetFile);
+        if (expectedOriginalText !== undefined && originalText !== expectedOriginalText) {
+            return {
+                ok: false,
+                code: "FILE_TEXT_EDIT_ORIGINAL_CHANGED",
+                error: `${targetFile}: File content changed after commit preflight.`
+            };
+        }
+        const outOfBounds = validation.changes.find((change) => change.span.start + change.span.length > originalText.length);
+        if (outOfBounds) {
+            return {
+                ok: false,
+                code: "FILE_TEXT_EDIT_INVALID_SPAN",
+                error: `${targetFile}: Text edit span ${outOfBounds.span.start}:${outOfBounds.span.length} exceeds file length ${originalText.length}.`
+            };
+        }
+        const nextText = applyTextChanges(originalText, validation.changes);
+        if (nextText !== originalText) {
+            preparedEdits.push({ file: targetFile, originalText, nextText });
+        }
+    }
+    const writtenOriginalTexts = new Map();
+    try {
+        for (const preparedEdit of preparedEdits) {
+            writtenOriginalTexts.set(preparedEdit.file, preparedEdit.originalText);
+            fsAdapter.writeFileSync(preparedEdit.file, preparedEdit.nextText, "utf8");
+        }
+    }
+    catch (error) {
+        const recovery = restoreDirectlyWrittenFiles(writtenOriginalTexts, fsAdapter);
+        return {
+            ok: false,
+            code: "FILE_TEXT_EDIT_WRITE_FAILED",
+            error: recovery.errors.length > 0
+                ? `Failed to write text edits: ${error instanceof Error ? error.message : String(error)}. Restore also failed: ${recovery.errors.join("; ")}`
+                : `Failed to write text edits: ${error instanceof Error ? error.message : String(error)}`,
+            recovery: {
+                strategy: "preflight-and-rollback",
+                status: recovery.errors.length === 0 ? "completed" : "failed",
+                attemptedFiles: [...writtenOriginalTexts.keys()],
+                restoredFiles: recovery.restoredFiles,
+                errors: recovery.errors
+            }
+        };
+    }
+    return {
+        ok: true,
+        touchedFiles: preparedEdits.map((edit) => edit.file),
+        recovery: { strategy: "preflight-and-rollback", status: "not-needed" }
+    };
+}
+function applyTextChanges(text, changes) {
+    let nextText = text;
+    const orderedChanges = [...changes].sort((left, right) => right.span.start - left.span.start || right.span.length - left.span.length);
+    for (const change of orderedChanges) {
+        const start = change.span.start;
+        const end = change.span.start + change.span.length;
+        nextText = `${nextText.slice(0, start)}${change.newText}${nextText.slice(end)}`;
+    }
+    return nextText;
+}
+function validateAndNormalizeTextChanges(changes) {
+    const indexedChanges = changes.map((change, index) => ({ change, index }));
+    const orderedChanges = indexedChanges.sort((left, right) => left.change.span.start - right.change.span.start ||
+        Number(left.change.span.length === 0) - Number(right.change.span.length === 0) ||
+        left.index - right.index);
+    const normalizedChanges = [];
+    let previousEnd = -1;
+    for (let index = 0; index < orderedChanges.length; index += 1) {
+        const change = orderedChanges[index]?.change;
+        if (!change) {
+            continue;
+        }
+        const start = change.span.start;
+        const end = change.span.start + change.span.length;
+        if (!Number.isInteger(start) || !Number.isInteger(change.span.length) || start < 0 || change.span.length < 0) {
+            return {
+                ok: false,
+                code: "FILE_TEXT_EDIT_INVALID_SPAN",
+                error: `Invalid text edit span ${start}:${change.span.length}.`
+            };
+        }
+        const sameStartChanges = [change];
+        let nextIndex = index + 1;
+        while (nextIndex < orderedChanges.length) {
+            const nextChange = orderedChanges[nextIndex]?.change;
+            if (!nextChange || nextChange.span.start !== start) {
+                break;
+            }
+            sameStartChanges.push(nextChange);
+            nextIndex += 1;
+        }
+        const nonInsertChanges = sameStartChanges.filter((item) => item.span.length > 0);
+        if (start < previousEnd) {
+            return {
+                ok: false,
+                code: "FILE_TEXT_EDIT_OVERLAP",
+                error: `Overlapping text edit span ${start}:${change.span.length}.`
+            };
+        }
+        if (nonInsertChanges.length > 1) {
+            return {
+                ok: false,
+                code: "FILE_TEXT_EDIT_OVERLAP",
+                error: `Overlapping text edit span ${start}:${nonInsertChanges[1]?.span.length ?? 0}.`
+            };
+        }
+        const nonInsertChange = nonInsertChanges[0] ?? null;
+        if (nonInsertChange) {
+            normalizedChanges.push(nonInsertChange);
+        }
+        const sameOffsetInsertTexts = sameStartChanges
+            .filter((item) => item.span.length === 0)
+            .map((item) => item.newText);
+        if (sameOffsetInsertTexts.length > 0) {
+            normalizedChanges.push({
+                span: { start, length: 0 },
+                newText: sameOffsetInsertTexts.join("")
+            });
+        }
+        const groupEnd = nonInsertChange ? nonInsertChange.span.start + nonInsertChange.span.length : end;
+        previousEnd = Math.max(previousEnd, groupEnd);
+        index = nextIndex - 1;
+    }
+    return { ok: true, changes: normalizedChanges };
+}
+function restoreDirectlyWrittenFiles(originalTextsByFile, fsAdapter) {
+    const restoredFiles = [];
+    const errors = [];
+    for (const [file, originalText] of Array.from(originalTextsByFile.entries()).reverse()) {
+        try {
+            fsAdapter.writeFileSync(file, originalText, "utf8");
+            restoredFiles.push(file);
+        }
+        catch (error) {
+            errors.push(`${file}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { restoredFiles, errors };
+}

package/dist/commands/find-importers.js

@@ -1 +1,52 @@
-"use strict";var c=exports&&exports.__createBinding||(Object.create?(function(a,e,r,t){t===void 0&&(t=r);var n=Object.getOwnPropertyDescriptor(e,r);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(a,t,n)}):(function(a,e,r,t){t===void 0&&(t=r),a[t]=e[r]})),o=exports&&exports.__setModuleDefault||(Object.create?(function(a,e){Object.defineProperty(a,"default",{enumerable:!0,value:e})}):function(a,e){a.default=e}),s=exports&&exports.__importStar||(function(){var a=function(e){return a=Object.getOwnPropertyNames||function(r){var t=[];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(t[t.length]=n);return t},a(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null)for(var t=a(e),n=0;n<t.length;n++)t[n]!=="default"&&c(r,e,t[n]);return o(r,e),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runFindImporters=p;const f=s(require("node:path")),l=require("../client/http-client"),_=require("../shared/routes"),d=require("../shared/protocol"),i=require("./shared");async function p(a,e,r={}){const t=await(0,i.resolveCompatibleTargetInstance)(a,d.CLI_COMMAND_IDS.findImporters,r),n=f.normalize(e),u=await(0,l.postJson)(t.entry,_.EXTENSION_ROUTES.findImporters,{targetPath:n},(0,i.extensionRequestOptions)(r));return{ok:!0,selectedInstance:{instanceId:t.entry.instanceId,reason:t.reason,matchedWorkspace:t.matchedWorkspace,port:t.entry.port},response:u}}
+"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.runFindImporters = runFindImporters;
+const path = __importStar(require("node:path"));
+const standalone_import_process_1 = require("../imports/standalone-import-process");
+async function runFindImporters(cwd, targetPath, options = {}) {
+    const normalizedTargetPath = path.normalize(targetPath);
+    const payload = await (0, standalone_import_process_1.runStandaloneImportWorker)({
+        workspaceRoot: cwd,
+        operation: "find-importers",
+        payload: {
+            targetPath: normalizedTargetPath
+        }
+    });
+    return {
+        ok: true,
+        response: payload
+    };
+}

package/dist/commands/find-unused-imports.js

@@ -1 +1,55 @@
-"use strict";var l=exports&&exports.__createBinding||(Object.create?(function(o,e,r,t){t===void 0&&(t=r);var n=Object.getOwnPropertyDescriptor(e,r);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(o,t,n)}):(function(o,e,r,t){t===void 0&&(t=r),o[t]=e[r]})),f=exports&&exports.__setModuleDefault||(Object.create?(function(o,e){Object.defineProperty(o,"default",{enumerable:!0,value:e})}):function(o,e){o.default=e}),_=exports&&exports.__importStar||(function(){var o=function(e){return o=Object.getOwnPropertyNames||function(r){var t=[];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(t[t.length]=n);return t},o(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null)for(var t=o(e),n=0;n<t.length;n++)t[n]!=="default"&&l(r,e,t[n]);return f(r,e),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runFindUnusedImports=h;const p=_(require("node:path")),I=require("../client/http-client"),O=require("../shared/routes"),b=require("../shared/protocol"),i=require("./shared"),s=require("../shared/metrics");async function h(o,e,r={},t){const n=(0,s.metricsNow)(),a=await(0,i.resolveCompatibleTargetInstance)(o,b.CLI_COMMAND_IDS.findUnusedImports,r);(0,s.recordSpan)(t,"command.findUnusedImports.resolveTargetInstance",n);const c=p.normalize(e),u=(0,s.metricsNow)(),d=await(0,I.postJson)(a.entry,O.EXTENSION_ROUTES.findUnusedImports,{sourceFile:c},(0,i.extensionRequestOptions)({...r,metricsEnabled:!!t}));return(0,s.recordSpan)(t,"command.findUnusedImports.transport",u),{ok:!0,selectedInstance:{instanceId:a.entry.instanceId,reason:a.reason,matchedWorkspace:a.matchedWorkspace,port:a.entry.port},response:d}}
+"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.runFindUnusedImports = runFindUnusedImports;
+const path = __importStar(require("node:path"));
+const standalone_import_process_1 = require("../imports/standalone-import-process");
+const metrics_1 = require("../shared/metrics");
+async function runFindUnusedImports(cwd, sourceFile, options = {}, metricsSpans) {
+    const resolveStartedAt = (0, metrics_1.metricsNow)();
+    const normalizedSourceFile = path.normalize(sourceFile);
+    const transportStartedAt = (0, metrics_1.metricsNow)();
+    const payload = await (0, standalone_import_process_1.runStandaloneImportWorker)({
+        workspaceRoot: cwd,
+        operation: "find-unused",
+        payload: { sourceFile: normalizedSourceFile }
+    });
+    (0, metrics_1.recordSpan)(metricsSpans, "command.findUnusedImports.worker", transportStartedAt);
+    (0, metrics_1.recordSpan)(metricsSpans, "command.findUnusedImports.resolveTargetInstance", resolveStartedAt);
+    return {
+        ok: true,
+        response: payload
+    };
+}

package/dist/commands/generate-docs-command.js

@@ -1,6 +1,244 @@
-"use strict";var m=exports&&exports.__createBinding||(Object.create?(function(t,e,r,n){n===void 0&&(n=r);var i=Object.getOwnPropertyDescriptor(e,r);(!i||("get"in i?!e.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(t,n,i)}):(function(t,e,r,n){n===void 0&&(n=r),t[n]=e[r]})),S=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),g=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)Object.prototype.hasOwnProperty.call(r,i)&&(n[n.length]=i);return n},t(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null)for(var n=t(e),i=0;i<n.length;i++)n[i]!=="default"&&m(r,e,n[i]);return S(r,e),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runGenerateDocsCommand=b;const s=g(require("node:fs")),c=g(require("node:path")),w=require("./help-command"),p=require("../shared/agent-text"),l=require("../shared/errors"),E=c.join("docs","agent");function b(t,e){const r=j(e),n=(0,w.resolveHelpRoot)(),i=c.resolve(t,D(r.targetParent)),a=c.join(i,"aib"),o=s.existsSync(a),u=O(t,a);if(!r.yes)return(0,p.attachAgentText)({operation:"generate-docs",dryRun:!0,target:a,targetExists:o,helpSource:n.source},v(r,u,o));if(o&&!r.force)throw new l.CliError("GENERATED_DOCS_TARGET_EXISTS",`${u} already exists.`,{target:a,next:[`aib generate-docs ${d(r)}-y --force`.replace(/\s+/g," ").trim(),"aib generate-docs -t <other-path> -y"]});h(n.dir),o&&s.rmSync(a,{recursive:!0,force:!0});const f=A(n.dir,a),y=T(n.dir,`${P(u)}/README.md`),_=[`generated: ${u}`,`source: ${n.source}`,`${f.length} files written`,"","Add one of these to AGENTS.md or CLAUDE.md:","",y].join(`
-`);return(0,p.attachAgentText)({operation:"generate-docs",dryRun:!1,target:a,helpSource:n.source,filesWritten:f},_)}function j(t){let e=E,r=!1,n=!1,i=!1;for(let a=0;a<t.length;a+=1){const o=t[a];if(o){if(o==="-y"||o==="--yes"){n=!0;continue}if(o==="--force"){i=!0;continue}if(o==="-t"||o==="--target"||o==="--to"){const u=t[a+1];if(!u)throw new l.CliError("MISSING_FLAG_VALUE",`Expected a value after ${o}.`);e=u,r=!0,a+=1;continue}if(o==="help"||o==="--help")return{targetParent:e,targetProvided:r,yes:n,force:i};throw new l.CliError("UNKNOWN_GENERATE_DOCS_FLAG",`Unknown aib generate-docs flag: ${o}`,{availableFlags:["-y","--yes","-t <path>","--target <path>","--force"]})}}return{targetParent:e,targetProvided:r,yes:n,force:i}}function v(t,e,r){return r?[`${e} already exists.`,"Refusing to overwrite generated docs.","","No files written.","","To replace it:",`aib generate-docs ${d(t)}-y --force`.replace(/\s+/g," ").trim(),"","For another parent path:","aib generate-docs -t docs2 -y"].join(`
-`):t.targetProvided?[`target: ${e}`,"","No files written.","","To generate docs there:",`aib generate-docs ${d(t)}-y`.replace(/\s+/g," ").trim()].join(`
-`):["path was not provided.",`Default target: ${e}`,"","No files written.","","To generate docs there:","aib generate-docs -y","","For another parent path:","aib generate-docs -t docs"].join(`
-`)}function A(t,e){h(t);const r=c.join(t,"docs");s.mkdirSync(e,{recursive:!0});const n=[],i=c.join(t,"bootstrap.md");if(s.existsSync(i)){const o=c.join(e,"README.md");s.copyFileSync(i,o),n.push(o)}for(const o of s.readdirSync(r,{withFileTypes:!0}).sort((u,f)=>u.name.localeCompare(f.name))){if(!o.isFile()||!o.name.endsWith(".md"))continue;const u=c.join(r,o.name),f=c.join(e,o.name);s.copyFileSync(u,f),n.push(f)}const a=c.join(t,"help-meta.json");if(s.existsSync(a)){const o=c.join(e,"help-meta.json");s.copyFileSync(a,o),n.push(o)}return n}function h(t){const e=c.join(t,"docs");if(!s.existsSync(e))throw new l.CliError("HELP_DOCS_NOT_FOUND","Generated docs were not found in the active help bundle.",{docsDir:e})}function T(t,e){const r=c.join(t,"snippets","agents.md");return s.existsSync(r)?s.readFileSync(r,"utf8").trim().replaceAll("{{docsPath}}",e):["Recommended:",`For TS/JS code work, use aib. Start with ${e}.`,"","Minimal:",`Use ${e} when working with TS/JS code.`].join(`
-`)}function d(t){return t.targetProvided?`-t ${t.targetParent} `:""}function D(t){const e=t.trim();if(!e)throw new l.CliError("MISSING_TARGET_PATH","Expected a target path.");return e.replace(/[\\/]+$/,"")}function O(t,e){const r=c.relative(t,e);return!r||r.startsWith("..")||c.isAbsolute(r)?e:r||"."}function P(t){return t.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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerateDocsCommand = runGenerateDocsCommand;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const help_command_1 = require("./help-command");
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const DEFAULT_TARGET_PARENT = path.join("docs", "agent");
+function runGenerateDocsCommand(cwd, args) {
+    const options = parseGenerateDocsArgs(args);
+    const helpRoot = (0, help_command_1.resolveHelpRoot)();
+    const targetParent = path.resolve(cwd, normalizeInputPath(options.targetParent));
+    const targetDir = path.join(targetParent, "aib");
+    const targetExists = fs.existsSync(targetDir);
+    const displayTarget = displayPath(cwd, targetDir);
+    if (!options.yes) {
+        return (0, agent_text_1.attachAgentText)({
+            operation: "generate-docs",
+            dryRun: true,
+            target: targetDir,
+            targetExists,
+            helpSource: helpRoot.source
+        }, formatDryRunText(options, displayTarget, targetExists));
+    }
+    if (targetExists && !options.force) {
+        throw new errors_1.CliError("GENERATED_DOCS_TARGET_EXISTS", `${displayTarget} already exists.`, {
+            target: targetDir,
+            next: [
+                `aib generate-docs ${formatTargetFlag(options)}-y --force`.replace(/\s+/g, " ").trim(),
+                "aib generate-docs -t <other-path> -y"
+            ]
+        });
+    }
+    assertGeneratedDocsAvailable(helpRoot.dir);
+    if (targetExists) {
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    }
+    const written = writeGeneratedDocs(helpRoot.dir, targetDir);
+    const snippets = readAgentSnippets(helpRoot.dir, `${toPosix(displayTarget)}/README.md`);
+    const text = [
+        `generated: ${displayTarget}`,
+        `source: ${helpRoot.source}`,
+        `${written.length} files written`,
+        "",
+        "Add one of these to AGENTS.md or CLAUDE.md:",
+        "",
+        snippets
+    ].join("\n");
+    return (0, agent_text_1.attachAgentText)({
+        operation: "generate-docs",
+        dryRun: false,
+        target: targetDir,
+        helpSource: helpRoot.source,
+        filesWritten: written
+    }, text);
+}
+function parseGenerateDocsArgs(args) {
+    let targetParent = DEFAULT_TARGET_PARENT;
+    let targetProvided = false;
+    let yes = false;
+    let force = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const current = args[index];
+        if (!current) {
+            continue;
+        }
+        if (current === "-y" || current === "--yes") {
+            yes = true;
+            continue;
+        }
+        if (current === "--force") {
+            force = true;
+            continue;
+        }
+        if (current === "-t" || current === "--target" || current === "--to") {
+            const next = args[index + 1];
+            if (!next) {
+                throw new errors_1.CliError("MISSING_FLAG_VALUE", `Expected a value after ${current}.`);
+            }
+            targetParent = next;
+            targetProvided = true;
+            index += 1;
+            continue;
+        }
+        if (current === "help" || current === "--help") {
+            return {
+                targetParent,
+                targetProvided,
+                yes,
+                force
+            };
+        }
+        throw new errors_1.CliError("UNKNOWN_GENERATE_DOCS_FLAG", `Unknown aib generate-docs flag: ${current}`, {
+            availableFlags: ["-y", "--yes", "-t <path>", "--target <path>", "--force"]
+        });
+    }
+    return {
+        targetParent,
+        targetProvided,
+        yes,
+        force
+    };
+}
+function formatDryRunText(options, displayTarget, targetExists) {
+    if (targetExists) {
+        return [
+            `${displayTarget} already exists.`,
+            "Refusing to overwrite generated docs.",
+            "",
+            "No files written.",
+            "",
+            "To replace it:",
+            `aib generate-docs ${formatTargetFlag(options)}-y --force`.replace(/\s+/g, " ").trim(),
+            "",
+            "For another parent path:",
+            "aib generate-docs -t docs2 -y"
+        ].join("\n");
+    }
+    if (!options.targetProvided) {
+        return [
+            "path was not provided.",
+            `Default target: ${displayTarget}`,
+            "",
+            "No files written.",
+            "",
+            "To generate docs there:",
+            "aib generate-docs -y",
+            "",
+            "For another parent path:",
+            "aib generate-docs -t docs"
+        ].join("\n");
+    }
+    return [
+        `target: ${displayTarget}`,
+        "",
+        "No files written.",
+        "",
+        "To generate docs there:",
+        `aib generate-docs ${formatTargetFlag(options)}-y`.replace(/\s+/g, " ").trim()
+    ].join("\n");
+}
+function writeGeneratedDocs(helpRoot, targetDir) {
+    assertGeneratedDocsAvailable(helpRoot);
+    const docsDir = path.join(helpRoot, "docs");
+    fs.mkdirSync(targetDir, { recursive: true });
+    const written = [];
+    const bootstrap = path.join(helpRoot, "bootstrap.md");
+    if (fs.existsSync(bootstrap)) {
+        const readme = path.join(targetDir, "README.md");
+        fs.copyFileSync(bootstrap, readme);
+        written.push(readme);
+    }
+    for (const entry of fs.readdirSync(docsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+        if (!entry.isFile() || !entry.name.endsWith(".md")) {
+            continue;
+        }
+        const from = path.join(docsDir, entry.name);
+        const to = path.join(targetDir, entry.name);
+        fs.copyFileSync(from, to);
+        written.push(to);
+    }
+    const meta = path.join(helpRoot, "help-meta.json");
+    if (fs.existsSync(meta)) {
+        const to = path.join(targetDir, "help-meta.json");
+        fs.copyFileSync(meta, to);
+        written.push(to);
+    }
+    return written;
+}
+function assertGeneratedDocsAvailable(helpRoot) {
+    const docsDir = path.join(helpRoot, "docs");
+    if (!fs.existsSync(docsDir)) {
+        throw new errors_1.CliError("HELP_DOCS_NOT_FOUND", "Generated docs were not found in the active help bundle.", {
+            docsDir
+        });
+    }
+}
+function readAgentSnippets(helpRoot, docsReadmePath) {
+    const snippetsFile = path.join(helpRoot, "snippets", "agents.md");
+    if (fs.existsSync(snippetsFile)) {
+        return fs.readFileSync(snippetsFile, "utf8").trim().replaceAll("{{docsPath}}", docsReadmePath);
+    }
+    return [
+        "Recommended:",
+        `For TS/JS code work, use aib. Start with ${docsReadmePath}.`,
+        "",
+        "Minimal:",
+        `Use ${docsReadmePath} when working with TS/JS code.`
+    ].join("\n");
+}
+function formatTargetFlag(options) {
+    return options.targetProvided ? `-t ${options.targetParent} ` : "";
+}
+function normalizeInputPath(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new errors_1.CliError("MISSING_TARGET_PATH", "Expected a target path.");
+    }
+    return trimmed.replace(/[\\/]+$/, "");
+}
+function displayPath(cwd, absolutePath) {
+    const relative = path.relative(cwd, absolutePath);
+    if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) {
+        return absolutePath;
+    }
+    return relative || ".";
+}
+function toPosix(value) {
+    return value.replace(/\\/g, "/");
+}