@ai-coders/context 0.2.1 → 0.3.1

package/dist/commands/shared/agents.d.ts

@@ -0,0 +1,2 @@
+export declare function getAgentFilesByTypes(types?: string[]): Set<string> | undefined;
+//# sourceMappingURL=agents.d.ts.map

package/dist/commands/shared/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/agents.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAW9E"}

package/dist/commands/shared/agents.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgentFilesByTypes = getAgentFilesByTypes;
+const agentTypes_1 = require("../../generators/agents/agentTypes");
+function getAgentFilesByTypes(types) {
+    if (!types || types.length === 0) {
+        return undefined;
+    }
+    const allowed = new Set(agentTypes_1.AGENT_TYPES);
+    const files = types
+        .filter(type => allowed.has(type))
+        .map(type => `${type}.md`);
+    return files.length ? new Set(files) : undefined;
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/shared/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/commands/shared/agents.ts"],"names":[],"mappings":";;AAEA,oDAWC;AAbD,mEAAiE;AAEjE,SAAgB,oBAAoB,CAAC,KAAgB;IACnD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,wBAAW,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK;SAChB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAkC,CAAC,CAAC;SAC/D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IAE7B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/commands/shared/selection.d.ts

@@ -0,0 +1,12 @@
+export interface SelectionParseResult {
+    selected?: string[];
+    invalid: string[];
+    provided: boolean;
+    explicitNone: boolean;
+}
+export declare function parseDocSelection(input: unknown): SelectionParseResult;
+export declare function parseAgentSelection(input: unknown): SelectionParseResult;
+export declare function shouldGenerateDocs(resolvedType: 'docs' | 'agents' | 'both', selection: SelectionParseResult): boolean;
+export declare function shouldGenerateAgents(resolvedType: 'docs' | 'agents' | 'both', selection: SelectionParseResult): boolean;
+export declare function determineScaffoldType(docSelection?: string[], agentSelection?: string[]): 'docs' | 'agents' | 'both';
+//# sourceMappingURL=selection.d.ts.map

package/dist/commands/shared/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/selection.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAmBtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAoBxE;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,EAAE,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAkBrH;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,EAAE,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAkBvH;AAED,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAOpH"}

package/dist/commands/shared/selection.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDocSelection = parseDocSelection;
+exports.parseAgentSelection = parseAgentSelection;
+exports.shouldGenerateDocs = shouldGenerateDocs;
+exports.shouldGenerateAgents = shouldGenerateAgents;
+exports.determineScaffoldType = determineScaffoldType;
+const guideRegistry_1 = require("../../generators/documentation/guideRegistry");
+const agentTypes_1 = require("../../generators/agents/agentTypes");
+function parseDocSelection(input) {
+    if (input === undefined) {
+        return { selected: undefined, invalid: [], provided: false, explicitNone: false };
+    }
+    if (Array.isArray(input) && input.length === 0) {
+        return { selected: [], invalid: [], provided: true, explicitNone: true };
+    }
+    const values = toStringArray(input);
+    const normalized = values.map(value => value.toLowerCase().replace(/\.md$/, ''));
+    const valid = Array.from(new Set(normalized.filter(key => guideRegistry_1.DOCUMENT_GUIDE_KEYS.includes(key))));
+    const invalid = normalized.filter(key => !guideRegistry_1.DOCUMENT_GUIDE_KEYS.includes(key));
+    if (values.length > 0 && valid.length === 0 && invalid.length > 0) {
+        return { selected: undefined, invalid, provided: true, explicitNone: false };
+    }
+    return { selected: valid.length > 0 ? valid : undefined, invalid, provided: true, explicitNone: false };
+}
+function parseAgentSelection(input) {
+    if (input === undefined) {
+        return { selected: undefined, invalid: [], provided: false, explicitNone: false };
+    }
+    if (Array.isArray(input) && input.length === 0) {
+        return { selected: [], invalid: [], provided: true, explicitNone: true };
+    }
+    const values = toStringArray(input);
+    const normalized = values.map(value => value.toLowerCase().replace(/\.md$/, ''));
+    const allowed = new Set(agentTypes_1.AGENT_TYPES);
+    const valid = Array.from(new Set(normalized.filter(value => allowed.has(value))));
+    const invalid = normalized.filter(value => !allowed.has(value));
+    if (values.length > 0 && valid.length === 0 && invalid.length > 0) {
+        return { selected: undefined, invalid, provided: true, explicitNone: false };
+    }
+    return { selected: valid.length > 0 ? valid : undefined, invalid, provided: true, explicitNone: false };
+}
+function shouldGenerateDocs(resolvedType, selection) {
+    if (selection.explicitNone) {
+        return false;
+    }
+    if (resolvedType === 'agents') {
+        return false;
+    }
+    if (!selection.provided) {
+        return resolvedType === 'docs' || resolvedType === 'both';
+    }
+    if (selection.selected && selection.selected.length === 0) {
+        return false;
+    }
+    return resolvedType === 'docs' || resolvedType === 'both';
+}
+function shouldGenerateAgents(resolvedType, selection) {
+    if (selection.explicitNone) {
+        return false;
+    }
+    if (resolvedType === 'docs') {
+        return false;
+    }
+    if (!selection.provided) {
+        return resolvedType === 'agents' || resolvedType === 'both';
+    }
+    if (selection.selected && selection.selected.length === 0) {
+        return false;
+    }
+    return resolvedType === 'agents' || resolvedType === 'both';
+}
+function determineScaffoldType(docSelection, agentSelection) {
+    const docsSelected = docSelection === undefined ? true : docSelection.length > 0;
+    const agentsSelected = agentSelection === undefined ? true : agentSelection.length > 0;
+    if (docsSelected && agentsSelected)
+        return 'both';
+    if (docsSelected)
+        return 'docs';
+    return 'agents';
+}
+function toStringArray(input) {
+    if (Array.isArray(input)) {
+        return input.map(item => item.toString().trim()).filter(Boolean);
+    }
+    if (input === null || input === undefined) {
+        return [];
+    }
+    return input
+        .toString()
+        .split(',')
+        .map(part => part.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=selection.js.map

package/dist/commands/shared/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/commands/shared/selection.ts"],"names":[],"mappings":"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"}

package/dist/generators/agents/agentGenerator.d.ts

@@ -1,13 +1,10 @@
 import { RepoStructure } from '../../types';
-import { FileMapper } from '../../utils/fileMapper';
-import { BaseLLMClient } from '../../services/baseLLMClient';
 export declare class AgentGenerator {
-    private llmClient;
-    private contextUtils;
-    private promptFormatter;
-    constructor(fileMapper: FileMapper, llmClient: BaseLLMClient);
-    generateAgentPrompts(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
-    private generateAgentPrompt;
-    private generateAgentIndex;
+    private readonly docTouchpoints;
+    constructor(..._legacyArgs: unknown[]);
+    generateAgentPrompts(repoStructure: RepoStructure, outputDir: string, selectedAgentTypes?: string[], verbose?: boolean): Promise<number>;
+    private resolveAgentSelection;
+    private buildContext;
+    private formatDirectoryList;
 }
 //# sourceMappingURL=agentGenerator.d.ts.map

package/dist/generators/agents/agentGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAM7D,qBAAa,cAAc;IAMvB,OAAO,CAAC,SAAS;IALnB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;gBAGvC,UAAU,EAAE,UAAU,EACd,SAAS,EAAE,aAAa;IAM5B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;YA4BF,mBAAmB;YA0BnB,kBAAkB;CAOjC"}
+{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAe5C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CA8C7B;gBAEU,GAAG,WAAW,EAAE,OAAO,EAAE;IAG/B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAC7B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAuBlB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/generators/agents/agentGenerator.js

@@ -35,45 +35,102 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentGenerator = void 0;
 const path = __importStar(require("path"));
-const agentTypes_1 = require("./agentTypes");
-const contextUtils_1 = require("./contextUtils");
-const promptFormatter_1 = require("./promptFormatter");
 const shared_1 = require("../shared");
+const agentTypes_1 = require("./agentTypes");
+const templates_1 = require("./templates");
 class AgentGenerator {
-    constructor(fileMapper, llmClient) {
-        this.llmClient = llmClient;
-        this.contextUtils = new contextUtils_1.ContextUtils(fileMapper);
-        this.promptFormatter = new promptFormatter_1.PromptFormatter();
+    constructor(..._legacyArgs) {
+        this.docTouchpoints = [
+            {
+                title: 'Documentation Index',
+                path: '../docs/README.md',
+                marker: 'ai-task:docs-index'
+            },
+            {
+                title: 'Project Overview',
+                path: '../docs/project-overview.md',
+                marker: 'ai-task:project-overview'
+            },
+            {
+                title: 'Architecture Notes',
+                path: '../docs/architecture.md',
+                marker: 'ai-task:architecture-notes'
+            },
+            {
+                title: 'Development Workflow',
+                path: '../docs/development-workflow.md',
+                marker: 'ai-task:development-workflow'
+            },
+            {
+                title: 'Testing Strategy',
+                path: '../docs/testing-strategy.md',
+                marker: 'ai-task:testing-strategy'
+            },
+            {
+                title: 'Glossary & Domain Concepts',
+                path: '../docs/glossary.md',
+                marker: 'ai-task:glossary'
+            },
+            {
+                title: 'Data Flow & Integrations',
+                path: '../docs/data-flow.md',
+                marker: 'ai-task:data-flow'
+            },
+            {
+                title: 'Security & Compliance Notes',
+                path: '../docs/security.md',
+                marker: 'ai-task:security'
+            },
+            {
+                title: 'Tooling & Productivity Guide',
+                path: '../docs/tooling.md',
+                marker: 'ai-task:tooling'
+            }
+        ];
     }
-    async generateAgentPrompts(repoStructure, outputDir, verbose = false) {
+    async generateAgentPrompts(repoStructure, outputDir, selectedAgentTypes, verbose = false) {
         const agentsDir = path.join(outputDir, 'agents');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(agentsDir, verbose, '🤖 Generating agent prompts in');
-        const repoContext = this.contextUtils.createRepoContext(repoStructure);
-        const fileContext = await this.contextUtils.createFileContext(repoStructure);
-        for (const agentType of agentTypes_1.AGENT_TYPES) {
-            try {
-                const fileName = `${agentType}.md`;
-                const agentPrompt = await this.generateAgentPrompt(agentType, repoContext, fileContext, repoStructure);
-                const agentPath = path.join(agentsDir, fileName);
-                await shared_1.GeneratorUtils.writeFileWithLogging(agentPath, agentPrompt, verbose);
-            }
-            catch (error) {
-                shared_1.GeneratorUtils.logError(`Error generating ${agentType}`, error, verbose);
-            }
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(agentsDir, verbose, 'Generating agent scaffold in');
+        const context = this.buildContext(repoStructure);
+        const agentTypes = this.resolveAgentSelection(selectedAgentTypes);
+        let created = 0;
+        for (const agentType of agentTypes) {
+            const content = (0, templates_1.renderAgentPlaybook)(agentType, context.topLevelDirectories, this.docTouchpoints);
+            const filePath = path.join(agentsDir, `${agentType}.md`);
+            await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Created ${agentType}.md`);
+            created += 1;
         }
-        // Generate master agent index
-        await this.generateAgentIndex(agentsDir, verbose);
+        const indexPath = path.join(agentsDir, 'README.md');
+        const indexContent = (0, templates_1.renderAgentIndex)(agentTypes);
+        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose, 'Created README.md');
+        created += 1;
+        return created;
     }
-    async generateAgentPrompt(agentType, repoContext, fileContext, repoStructure) {
-        const structureOverview = this.contextUtils.createStructureOverview(repoStructure);
-        const agentPrompt = await this.llmClient.generateAgentPrompt(structureOverview, fileContext, agentType);
-        return this.promptFormatter.formatAgentPrompt(agentType, agentPrompt, repoContext);
+    resolveAgentSelection(selected) {
+        if (!selected || selected.length === 0) {
+            return agentTypes_1.AGENT_TYPES;
+        }
+        const allowed = new Set(agentTypes_1.AGENT_TYPES);
+        const filtered = selected.filter((agent) => allowed.has(agent));
+        return (filtered.length > 0 ? filtered : agentTypes_1.AGENT_TYPES);
     }
-    async generateAgentIndex(agentsDir, verbose) {
-        const fileName = 'README.md';
-        const indexContent = this.promptFormatter.generateAgentIndex();
-        const indexPath = path.join(agentsDir, fileName);
-        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose);
+    buildContext(repoStructure) {
+        const directorySet = new Set();
+        repoStructure.directories.forEach(dir => {
+            const [firstSegment] = dir.relativePath.split(/[\\/]/).filter(Boolean);
+            if (firstSegment) {
+                directorySet.add(firstSegment);
+            }
+        });
+        return {
+            topLevelDirectories: Array.from(directorySet).sort()
+        };
+    }
+    formatDirectoryList(topLevelDirectories) {
+        if (topLevelDirectories.length === 0) {
+            return '';
+        }
+        return topLevelDirectories.map(dir => `- \`${dir}/\` — Note why this directory matters for the agent.`).join('\n');
     }
 }
 exports.AgentGenerator = AgentGenerator;

package/dist/generators/agents/agentGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentGenerator.js","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAI7B,6CAAsD;AACtD,iDAA8C;AAC9C,uDAAoD;AACpD,sCAA2C;AAE3C,MAAa,cAAc;IAIzB,YACE,UAAsB,EACd,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;QAEhC,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe,GAAG,IAAI,iCAAe,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,aAA4B,EAC5B,SAAiB,EACjB,UAAmB,KAAK;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,uBAAc,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAEjG,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAE7E,KAAK,MAAM,SAAS,IAAI,wBAAW,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,GAAG,SAAS,KAAK,CAAC;gBACnC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAChD,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,CACd,CAAC;gBAEF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBACjD,MAAM,uBAAc,CAAC,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAC7E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uBAAc,CAAC,QAAQ,CAAC,oBAAoB,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,SAAoB,EACpB,WAAmB,EACnB,WAAmB,EACnB,aAA4B;QAE5B,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAEnF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAC1D,iBAAiB,EACjB,WAAW,EACX,SAAS,CACV,CAAC;QAEF,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACrF,CAAC;IAWO,KAAK,CAAC,kBAAkB,CAAC,SAAiB,EAAE,OAAgB;QAClE,MAAM,QAAQ,GAAG,WAAW,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,uBAAc,CAAC,oBAAoB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;CAEF;AA7ED,wCA6EC"}
+{"version":3,"file":"agentGenerator.js","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"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"}

package/dist/generators/agents/index.d.ts

@@ -1,6 +1,4 @@
 export { AgentGenerator } from './agentGenerator';
 export { AGENT_TYPES, AgentType, IMPORTANT_FILES } from './agentTypes';
 export { AGENT_RESPONSIBILITIES, AGENT_BEST_PRACTICES } from './agentConfig';
-export { ContextUtils } from './contextUtils';
-export { PromptFormatter } from './promptFormatter';
 //# sourceMappingURL=index.d.ts.map

package/dist/generators/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/generators/agents/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PromptFormatter = exports.ContextUtils = exports.AGENT_BEST_PRACTICES = exports.AGENT_RESPONSIBILITIES = exports.IMPORTANT_FILES = exports.AGENT_TYPES = exports.AgentGenerator = void 0;
+exports.AGENT_BEST_PRACTICES = exports.AGENT_RESPONSIBILITIES = exports.IMPORTANT_FILES = exports.AGENT_TYPES = exports.AgentGenerator = void 0;
 var agentGenerator_1 = require("./agentGenerator");
 Object.defineProperty(exports, "AgentGenerator", { enumerable: true, get: function () { return agentGenerator_1.AgentGenerator; } });
 var agentTypes_1 = require("./agentTypes");
@@ -9,8 +9,4 @@ Object.defineProperty(exports, "IMPORTANT_FILES", { enumerable: true, get: funct
 var agentConfig_1 = require("./agentConfig");
 Object.defineProperty(exports, "AGENT_RESPONSIBILITIES", { enumerable: true, get: function () { return agentConfig_1.AGENT_RESPONSIBILITIES; } });
 Object.defineProperty(exports, "AGENT_BEST_PRACTICES", { enumerable: true, get: function () { return agentConfig_1.AGENT_BEST_PRACTICES; } });
-var contextUtils_1 = require("./contextUtils");
-Object.defineProperty(exports, "ContextUtils", { enumerable: true, get: function () { return contextUtils_1.ContextUtils; } });
-var promptFormatter_1 = require("./promptFormatter");
-Object.defineProperty(exports, "PromptFormatter", { enumerable: true, get: function () { return promptFormatter_1.PromptFormatter; } });
 //# sourceMappingURL=index.js.map

package/dist/generators/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/agents/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2CAAuE;AAA9D,yGAAA,WAAW,OAAA;AAAa,6GAAA,eAAe,OAAA;AAChD,6CAA6E;AAApE,qHAAA,sBAAsB,OAAA;AAAE,mHAAA,oBAAoB,OAAA;AACrD,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/agents/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2CAAuE;AAA9D,yGAAA,WAAW,OAAA;AAAa,6GAAA,eAAe,OAAA;AAChD,6CAA6E;AAApE,qHAAA,sBAAsB,OAAA;AAAE,mHAAA,oBAAoB,OAAA"}

package/dist/generators/agents/templates/index.d.ts

@@ -0,0 +1,4 @@
+export { renderAgentPlaybook } from './playbookTemplate';
+export { renderAgentIndex } from './indexTemplate';
+export type { AgentTemplateContext, DocTouchpoint } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/agents/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/generators/agents/templates/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentIndex = exports.renderAgentPlaybook = void 0;
+var playbookTemplate_1 = require("./playbookTemplate");
+Object.defineProperty(exports, "renderAgentPlaybook", { enumerable: true, get: function () { return playbookTemplate_1.renderAgentPlaybook; } });
+var indexTemplate_1 = require("./indexTemplate");
+Object.defineProperty(exports, "renderAgentIndex", { enumerable: true, get: function () { return indexTemplate_1.renderAgentIndex; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/agents/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/index.ts"],"names":[],"mappings":";;;AAAA,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA;AAC5B,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA"}

package/dist/generators/agents/templates/indexTemplate.d.ts

@@ -0,0 +1,3 @@
+import { AgentType } from '../agentTypes';
+export declare function renderAgentIndex(agentTypes: readonly AgentType[]): string;
+//# sourceMappingURL=indexTemplate.d.ts.map

package/dist/generators/agents/templates/indexTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAwBzE"}

package/dist/generators/agents/templates/indexTemplate.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentIndex = renderAgentIndex;
+const agentConfig_1 = require("../agentConfig");
+function renderAgentIndex(agentTypes) {
+    const agentEntries = agentTypes.map(type => {
+        const title = formatTitle(type);
+        const primaryResponsibility = agentConfig_1.AGENT_RESPONSIBILITIES[type]?.[0] || 'Document responsibilities here.';
+        return `- [${title}](./${type}.md) — ${primaryResponsibility}`;
+    }).join('\n');
+    return `# Agent Handbook
+
+This directory contains ready-to-customize playbooks for AI agents collaborating on the repository.
+
+## Available Agents
+${agentEntries}
+
+## How To Use These Playbooks
+1. Pick the agent that matches your task.
+2. Enrich the template with project-specific context or links.
+3. Share the final prompt with your AI assistant.
+4. Capture learnings in the relevant documentation file so future runs improve.
+
+## Related Resources
+- [Documentation Index](../docs/README.md)
+- [Contributor Guidelines](../AGENTS.md)
+`;
+}
+function formatTitle(agentType) {
+    return agentType
+        .split('-')
+        .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=indexTemplate.js.map

package/dist/generators/agents/templates/indexTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/indexTemplate.ts"],"names":[],"mappings":";;AAGA,4CAwBC;AA1BD,gDAAwD;AAExD,SAAgB,gBAAgB,CAAC,UAAgC;IAC/D,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,qBAAqB,GAAG,oCAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,iCAAiC,CAAC;QACrG,OAAO,MAAM,KAAK,OAAO,IAAI,UAAU,qBAAqB,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;;EAKP,YAAY;;;;;;;;;;;CAWb,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,SAAS;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/generators/agents/templates/playbookTemplate.d.ts

@@ -0,0 +1,4 @@
+import { AgentType } from '../agentTypes';
+import { DocTouchpoint } from './types';
+export declare function renderAgentPlaybook(agentType: AgentType, topLevelDirectories: string[], touchpoints: DocTouchpoint[]): string;
+//# sourceMappingURL=playbookTemplate.d.ts.map

package/dist/generators/agents/templates/playbookTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbookTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,aAAa,EAAE,GAC3B,MAAM,CA8CR"}

package/dist/generators/agents/templates/playbookTemplate.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentPlaybook = renderAgentPlaybook;
+const agentConfig_1 = require("../agentConfig");
+const directoryTemplateHelpers_1 = require("../../shared/directoryTemplateHelpers");
+function renderAgentPlaybook(agentType, topLevelDirectories, touchpoints) {
+    const title = formatTitle(agentType);
+    const responsibilities = agentConfig_1.AGENT_RESPONSIBILITIES[agentType] || ['Clarify this agent\'s responsibilities.'];
+    const bestPractices = agentConfig_1.AGENT_BEST_PRACTICES[agentType] || ['Document preferred workflows.'];
+    const directoryList = (0, directoryTemplateHelpers_1.formatDirectoryList)(topLevelDirectories);
+    const touchpointList = touchpoints
+        .map(tp => `- [${tp.title}](${tp.path}) — ${tp.marker}`)
+        .join('\n');
+    return `# ${title} Agent Playbook
+
+## Mission
+Describe how the ${title.toLowerCase()} agent supports the team and when to engage it.
+
+## Responsibilities
+${formatList(responsibilities)}
+
+## Best Practices
+${formatList(bestPractices)}
+
+## Key Project Resources
+- Documentation index: [docs/README.md](../docs/README.md)
+- Agent handbook: [agents/README.md](./README.md)
+- Contributor guide: [AGENTS.md](../AGENTS.md)
+
+## Repository Starting Points
+${directoryList || '- Add directory highlights relevant to this agent.'}
+
+## Documentation Touchpoints
+${touchpointList}
+
+## Collaboration Checklist
+1. Confirm assumptions with issue reporters or maintainers.
+2. Review open pull requests affecting this area.
+3. Update the relevant doc section listed above and remove any resolved \`ai-slot\` placeholders.
+4. Capture learnings back in [docs/README.md](../docs/README.md) or the appropriate task marker.
+
+## Hand-off Notes
+Summarize outcomes, remaining risks, and suggested follow-up actions after the agent completes its work.
+
+## Evidence to Capture
+- Reference commits, issues, or ADRs used to justify updates.
+- Command output or logs that informed recommendations.
+- Follow-up items for maintainers or future agent runs.
+`;
+}
+function formatTitle(agentType) {
+    return agentType
+        .split('-')
+        .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ');
+}
+function formatList(items) {
+    if (!items.length) {
+        return '- _No entries defined yet._';
+    }
+    return items.map(item => `- ${item}`).join('\n');
+}
+//# sourceMappingURL=playbookTemplate.js.map

package/dist/generators/agents/templates/playbookTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbookTemplate.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":";;AAKA,kDAkDC;AAvDD,gDAA8E;AAE9E,oFAA4E;AAG5E,SAAgB,mBAAmB,CACjC,SAAoB,EACpB,mBAA6B,EAC7B,WAA4B;IAE5B,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,gBAAgB,GAAG,oCAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC1G,MAAM,aAAa,GAAG,kCAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC3F,MAAM,aAAa,GAAG,IAAA,8CAAmB,EAAC,mBAAmB,CAAC,CAAC;IAE/D,MAAM,cAAc,GAAG,WAAW;SAC/B,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;SACvD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,KAAK,KAAK;;;mBAGA,KAAK,CAAC,WAAW,EAAE;;;EAGpC,UAAU,CAAC,gBAAgB,CAAC;;;EAG5B,UAAU,CAAC,aAAa,CAAC;;;;;;;;EAQzB,aAAa,IAAI,oDAAoD;;;EAGrE,cAAc;;;;;;;;;;;;;;;CAef,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,SAAS;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAe;IACjC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,6BAA6B,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/generators/agents/templates/types.d.ts

@@ -0,0 +1,14 @@
+import { AgentType } from '../agentTypes';
+export interface DocTouchpoint {
+    title: string;
+    path: string;
+    marker: string;
+}
+export interface AgentTemplateContext {
+    agentType: AgentType;
+    topLevelDirectories: string[];
+    docTouchpoints: DocTouchpoint[];
+    responsibilities: string[];
+    bestPractices: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/agents/templates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/generators/agents/templates/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/generators/agents/templates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/types.ts"],"names":[],"mappings":""}

package/dist/generators/documentation/documentationGenerator.d.ts

@@ -1,19 +1,13 @@
 import { RepoStructure } from '../../types';
-import { FileMapper } from '../../utils/fileMapper';
-import { BaseLLMClient } from '../../services/baseLLMClient';
-import { DocumentationConfig } from './documentationTypes';
+interface DocumentationGenerationConfig {
+    selectedDocs?: string[];
+}
 export declare class DocumentationGenerator {
-    private fileMapper;
-    private llmClient;
-    private moduleGrouper;
-    private templates;
-    constructor(fileMapper: FileMapper, llmClient: BaseLLMClient);
-    generateDocumentation(repoStructure: RepoStructure, outputDir: string, config?: Partial<DocumentationConfig>, verbose?: boolean): Promise<void>;
-    private generateAllDocumentation;
-    private generateMainIndex;
-    generateMentalModelOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
-    generateAIGuidelinesOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
-    generateArchitectureDecisionsOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
-    generateSoftwareGuidelinesOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
+    private readonly guides;
+    constructor(..._legacyArgs: unknown[]);
+    generateDocumentation(repoStructure: RepoStructure, outputDir: string, config?: DocumentationGenerationConfig, verbose?: boolean): Promise<number>;
+    private buildContext;
+    private getDocSections;
 }
+export {};
 //# sourceMappingURL=documentationGenerator.d.ts.map

package/dist/generators/documentation/documentationGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentationGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/documentationGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAI7D,OAAO,EAAE,mBAAmB,EAAgD,MAAM,sBAAsB,CAAC;AAEzG,qBAAa,sBAAsB;IAK/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IALnB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAyB;gBAGhC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,aAAa;IAM5B,qBAAqB,CACzB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EACzC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;YAkBF,wBAAwB;YAsCxB,iBAAiB;IAWzB,uBAAuB,CAC3B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,wBAAwB,CAC5B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,iCAAiC,CACrC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,8BAA8B,CAClC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;CAUjB"}
+{"version":3,"file":"documentationGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/documentationGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAsB5C,UAAU,6BAA6B;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,GAAG,WAAW,EAAE,OAAO,EAAE;IAE/B,qBAAqB,CACzB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,6BAAkC,EAC1C,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAmBlB,OAAO,CAAC,YAAY;IA+BpB,OAAO,CAAC,cAAc;CAiCvB"}