@ai-coders/context 0.2.1 → 0.3.0

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"}

package/dist/generators/documentation/documentationGenerator.js

@@ -35,92 +35,80 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentationGenerator = void 0;
 const path = __importStar(require("path"));
-const moduleGrouper_1 = require("../moduleGrouper");
 const shared_1 = require("../shared");
-const documentationTemplates_1 = require("./documentationTemplates");
-const documentationTypes_1 = require("./documentationTypes");
+const templates_1 = require("./templates");
+const guideRegistry_1 = require("./guideRegistry");
 class DocumentationGenerator {
-    constructor(fileMapper, llmClient) {
-        this.fileMapper = fileMapper;
-        this.llmClient = llmClient;
-        this.moduleGrouper = new moduleGrouper_1.ModuleGrouper(fileMapper);
-        this.templates = new documentationTemplates_1.DocumentationTemplates(llmClient, fileMapper);
+    constructor(..._legacyArgs) {
+        this.guides = guideRegistry_1.DOCUMENT_GUIDES;
     }
     async generateDocumentation(repoStructure, outputDir, config = {}, verbose = false) {
-        const fullConfig = {
-            focusAreas: [],
-            maxContentLength: 2000,
-            includeExamples: true,
-            enabledTypes: documentationTypes_1.DOCUMENTATION_TYPES_ARRAY,
-            ...config
-        };
         const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📚 Generating documentation in');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        await this.generateAllDocumentation(repoStructure, moduleGroups, docsDir, fullConfig.enabledTypes || documentationTypes_1.DOCUMENTATION_TYPES_ARRAY, verbose);
-        await this.generateMainIndex(docsDir, fullConfig.enabledTypes || documentationTypes_1.DOCUMENTATION_TYPES_ARRAY, verbose);
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, 'Generating documentation scaffold in');
+        const guidesToGenerate = (0, guideRegistry_1.getGuidesByKeys)(config.selectedDocs);
+        const context = this.buildContext(repoStructure, guidesToGenerate);
+        const sections = this.getDocSections(guidesToGenerate);
+        let created = 0;
+        for (const section of sections) {
+            const targetPath = path.join(docsDir, section.fileName);
+            const content = section.content(context);
+            await shared_1.GeneratorUtils.writeFileWithLogging(targetPath, content, verbose, `Created ${section.fileName}`);
+            created += 1;
+        }
+        return created;
     }
-    async generateAllDocumentation(repoStructure, moduleGroups, docsDir, enabledTypes, verbose) {
-        shared_1.GeneratorUtils.logProgress('🧠 Generating high-level conceptual documentation...', verbose);
-        const generators = {
-            'mental-model': () => this.templates.createMentalModel(repoStructure, moduleGroups),
-            'architecture-decisions': () => this.templates.createArchitectureDecisions(repoStructure, moduleGroups),
-            'code-organization': () => this.templates.createCodeOrganization(repoStructure, moduleGroups),
-            'development-patterns': () => this.templates.createDevelopmentPatterns(repoStructure, moduleGroups),
-            'ai-guidelines': () => this.templates.createAIGuidelines(repoStructure, moduleGroups),
-            'contributing-workflows': () => this.templates.createContributingWorkflows(repoStructure, moduleGroups),
-            'domain-context': () => this.templates.createDomainContext(repoStructure, moduleGroups),
-            'software-guidelines': () => this.templates.createSoftwareGuidelines(repoStructure, moduleGroups)
+    buildContext(repoStructure, guides) {
+        const directorySet = new Set();
+        repoStructure.directories.forEach(dir => {
+            const [firstSegment] = dir.relativePath.split(/[\\/]/).filter(Boolean);
+            if (firstSegment) {
+                directorySet.add(firstSegment);
+            }
+        });
+        const topLevelDirectories = Array.from(directorySet).sort();
+        const directoryStats = topLevelDirectories.map(name => ({
+            name,
+            fileCount: repoStructure.files.filter(file => file.relativePath.startsWith(`${name}/`)).length
+        }));
+        const primaryLanguages = shared_1.GeneratorUtils.getTopFileExtensions(repoStructure, 5)
+            .filter(([ext]) => !!ext)
+            .map(([extension, count]) => ({ extension, count }));
+        return {
+            repoStructure,
+            topLevelDirectories,
+            primaryLanguages,
+            directoryStats,
+            guides
         };
-        for (const docType of enabledTypes) {
-            try {
-                const content = await generators[docType]();
-                const fileName = `${docType}.md`;
-                const filePath = path.join(docsDir, fileName);
-                await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Generated ${shared_1.GeneratorUtils.formatTitle(docType)}`);
+    }
+    getDocSections(guides) {
+        const sections = [
+            {
+                fileName: 'README.md',
+                content: context => (0, templates_1.renderIndex)(context)
             }
-            catch (error) {
-                shared_1.GeneratorUtils.logError(`Error generating ${docType}`, error, verbose);
+        ];
+        const renderMap = {
+            'project-overview': templates_1.renderProjectOverview,
+            architecture: templates_1.renderArchitectureNotes,
+            'development-workflow': () => (0, templates_1.renderDevelopmentWorkflow)(),
+            'testing-strategy': () => (0, templates_1.renderTestingStrategy)(),
+            glossary: templates_1.renderGlossary,
+            'data-flow': templates_1.renderDataFlow,
+            security: () => (0, templates_1.renderSecurity)(),
+            tooling: () => (0, templates_1.renderToolingGuide)()
+        };
+        guides.forEach(guide => {
+            const renderer = renderMap[guide.key];
+            if (!renderer) {
+                return;
             }
-        }
-    }
-    async generateMainIndex(docsDir, enabledTypes, verbose) {
-        const indexContent = this.templates.createDocumentationIndex(enabledTypes);
-        const indexPath = path.join(docsDir, 'README.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose, 'Generated documentation index');
-    }
-    // Convenience methods for specific documentation types
-    async generateMentalModelOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🧠 Generating mental model documentation');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createMentalModel(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'mental-model.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Mental Model');
-    }
-    async generateAIGuidelinesOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🤖 Generating AI guidelines documentation');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createAIGuidelines(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'ai-guidelines.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated AI Guidelines');
-    }
-    async generateArchitectureDecisionsOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🏗️ Generating architecture decisions documentation');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createArchitectureDecisions(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'architecture-decisions.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Architecture Decisions');
-    }
-    async generateSoftwareGuidelinesOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📋 Generating software development guidelines');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createSoftwareGuidelines(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'software-guidelines.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Software Development Guidelines');
+            sections.push({
+                fileName: guide.file,
+                content: renderer
+            });
+        });
+        return sections;
     }
 }
 exports.DocumentationGenerator = DocumentationGenerator;