@ai-coders/context 0.1.0 → 0.3.0

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

@@ -0,0 +1,4 @@
+import { AgentType } from './agentTypes';
+export declare const AGENT_RESPONSIBILITIES: Record<AgentType, string[]>;
+export declare const AGENT_BEST_PRACTICES: Record<AgentType, string[]>;
+//# sourceMappingURL=agentConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentConfig.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAsE9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CA8D5D,CAAC"}

package/dist/generators/agents/agentConfig.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_BEST_PRACTICES = exports.AGENT_RESPONSIBILITIES = void 0;
+exports.AGENT_RESPONSIBILITIES = {
+    'code-reviewer': [
+        'Review code changes for quality, style, and best practices',
+        'Identify potential bugs and security issues',
+        'Ensure code follows project conventions',
+        'Provide constructive feedback and suggestions'
+    ],
+    'bug-fixer': [
+        'Analyze bug reports and error messages',
+        'Identify root causes of issues',
+        'Implement targeted fixes with minimal side effects',
+        'Test fixes thoroughly before deployment'
+    ],
+    'feature-developer': [
+        'Implement new features according to specifications',
+        'Design clean, maintainable code architecture',
+        'Integrate features with existing codebase',
+        'Write comprehensive tests for new functionality'
+    ],
+    'refactoring-specialist': [
+        'Identify code smells and improvement opportunities',
+        'Refactor code while maintaining functionality',
+        'Improve code organization and structure',
+        'Optimize performance where applicable'
+    ],
+    'test-writer': [
+        'Write comprehensive unit and integration tests',
+        'Ensure good test coverage across the codebase',
+        'Create test utilities and fixtures',
+        'Maintain and update existing tests'
+    ],
+    'documentation-writer': [
+        'Create clear, comprehensive documentation',
+        'Update existing documentation as code changes',
+        'Write helpful code comments and examples',
+        'Maintain README and API documentation'
+    ],
+    'performance-optimizer': [
+        'Identify performance bottlenecks',
+        'Optimize code for speed and efficiency',
+        'Implement caching strategies',
+        'Monitor and improve resource usage'
+    ],
+    'security-auditor': [
+        'Identify security vulnerabilities',
+        'Implement security best practices',
+        'Review dependencies for security issues',
+        'Ensure data protection and privacy compliance'
+    ],
+    'backend-specialist': [
+        'Design and implement server-side architecture',
+        'Create and maintain APIs and microservices',
+        'Optimize database queries and data models',
+        'Implement authentication and authorization',
+        'Handle server deployment and scaling'
+    ],
+    'frontend-specialist': [
+        'Design and implement user interfaces',
+        'Create responsive and accessible web applications',
+        'Optimize client-side performance and bundle sizes',
+        'Implement state management and routing',
+        'Ensure cross-browser compatibility'
+    ],
+    'architect-specialist': [
+        'Design overall system architecture and patterns',
+        'Define technical standards and best practices',
+        'Evaluate and recommend technology choices',
+        'Plan system scalability and maintainability',
+        'Create architectural documentation and diagrams'
+    ]
+};
+exports.AGENT_BEST_PRACTICES = {
+    'code-reviewer': [
+        'Focus on maintainability and readability',
+        'Consider the broader impact of changes',
+        'Be constructive and specific in feedback'
+    ],
+    'bug-fixer': [
+        'Reproduce the bug before fixing',
+        'Write tests to prevent regression',
+        'Document the fix for future reference'
+    ],
+    'feature-developer': [
+        'Follow existing patterns and conventions',
+        'Consider edge cases and error handling',
+        'Write tests alongside implementation'
+    ],
+    'refactoring-specialist': [
+        'Make small, incremental changes',
+        'Ensure tests pass after each refactor',
+        'Preserve existing functionality exactly'
+    ],
+    'test-writer': [
+        'Write tests that are clear and maintainable',
+        'Test both happy path and edge cases',
+        'Use descriptive test names'
+    ],
+    'documentation-writer': [
+        'Keep documentation up-to-date with code',
+        'Write from the user\'s perspective',
+        'Include practical examples'
+    ],
+    'performance-optimizer': [
+        'Measure before optimizing',
+        'Focus on actual bottlenecks',
+        'Don\'t sacrifice readability unnecessarily'
+    ],
+    'security-auditor': [
+        'Follow security best practices',
+        'Stay updated on common vulnerabilities',
+        'Consider the principle of least privilege'
+    ],
+    'backend-specialist': [
+        'Design APIs according the specification of the project',
+        'Implement proper error handling and logging',
+        'Use appropriate design patterns and clean architecture',
+        'Consider scalability and performance from the start',
+        'Implement comprehensive testing for business logic'
+    ],
+    'frontend-specialist': [
+        'Follow modern frontend development patterns',
+        'Optimize for accessibility and user experience',
+        'Implement responsive design principles',
+        'Use component-based architecture effectively',
+        'Optimize performance and loading times'
+    ],
+    'architect-specialist': [
+        'Consider long-term maintainability and scalability',
+        'Balance technical debt with business requirements',
+        'Document architectural decisions and rationale',
+        'Promote code reusability and modularity',
+        'Stay updated on industry trends and technologies'
+    ]
+};
+//# sourceMappingURL=agentConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentConfig.js","sourceRoot":"","sources":["../../../src/generators/agents/agentConfig.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAgC;IACjE,eAAe,EAAE;QACf,4DAA4D;QAC5D,6CAA6C;QAC7C,yCAAyC;QACzC,+CAA+C;KAChD;IACD,WAAW,EAAE;QACX,wCAAwC;QACxC,gCAAgC;QAChC,oDAAoD;QACpD,yCAAyC;KAC1C;IACD,mBAAmB,EAAE;QACnB,oDAAoD;QACpD,8CAA8C;QAC9C,2CAA2C;QAC3C,iDAAiD;KAClD;IACD,wBAAwB,EAAE;QACxB,oDAAoD;QACpD,+CAA+C;QAC/C,yCAAyC;QACzC,uCAAuC;KACxC;IACD,aAAa,EAAE;QACb,gDAAgD;QAChD,+CAA+C;QAC/C,oCAAoC;QACpC,oCAAoC;KACrC;IACD,sBAAsB,EAAE;QACtB,2CAA2C;QAC3C,+CAA+C;QAC/C,0CAA0C;QAC1C,uCAAuC;KACxC;IACD,uBAAuB,EAAE;QACvB,kCAAkC;QAClC,wCAAwC;QACxC,8BAA8B;QAC9B,oCAAoC;KACrC;IACD,kBAAkB,EAAE;QAClB,mCAAmC;QACnC,mCAAmC;QACnC,yCAAyC;QACzC,+CAA+C;KAChD;IACD,oBAAoB,EAAE;QACpB,+CAA+C;QAC/C,4CAA4C;QAC5C,2CAA2C;QAC3C,4CAA4C;QAC5C,sCAAsC;KACvC;IACD,qBAAqB,EAAE;QACrB,sCAAsC;QACtC,mDAAmD;QACnD,mDAAmD;QACnD,wCAAwC;QACxC,oCAAoC;KACrC;IACD,sBAAsB,EAAE;QACtB,iDAAiD;QACjD,+CAA+C;QAC/C,2CAA2C;QAC3C,6CAA6C;QAC7C,iDAAiD;KAClD;CACF,CAAC;AAEW,QAAA,oBAAoB,GAAgC;IAC/D,eAAe,EAAE;QACf,0CAA0C;QAC1C,wCAAwC;QACxC,0CAA0C;KAC3C;IACD,WAAW,EAAE;QACX,iCAAiC;QACjC,mCAAmC;QACnC,uCAAuC;KACxC;IACD,mBAAmB,EAAE;QACnB,0CAA0C;QAC1C,wCAAwC;QACxC,sCAAsC;KACvC;IACD,wBAAwB,EAAE;QACxB,iCAAiC;QACjC,uCAAuC;QACvC,yCAAyC;KAC1C;IACD,aAAa,EAAE;QACb,6CAA6C;QAC7C,qCAAqC;QACrC,4BAA4B;KAC7B;IACD,sBAAsB,EAAE;QACtB,yCAAyC;QACzC,oCAAoC;QACpC,4BAA4B;KAC7B;IACD,uBAAuB,EAAE;QACvB,2BAA2B;QAC3B,6BAA6B;QAC7B,4CAA4C;KAC7C;IACD,kBAAkB,EAAE;QAClB,gCAAgC;QAChC,wCAAwC;QACxC,2CAA2C;KAC5C;IACD,oBAAoB,EAAE;QACpB,wDAAwD;QACxD,6CAA6C;QAC7C,wDAAwD;QACxD,qDAAqD;QACrD,oDAAoD;KACrD;IACD,qBAAqB,EAAE;QACrB,6CAA6C;QAC7C,gDAAgD;QAChD,wCAAwC;QACxC,8CAA8C;QAC9C,wCAAwC;KACzC;IACD,sBAAsB,EAAE;QACtB,oDAAoD;QACpD,mDAAmD;QACnD,gDAAgD;QAChD,yCAAyC;QACzC,kDAAkD;KACnD;CACF,CAAC"}

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

@@ -0,0 +1,10 @@
+import { RepoStructure } from '../../types';
+export declare class AgentGenerator {
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,137 @@
+"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.AgentGenerator = void 0;
+const path = __importStar(require("path"));
+const shared_1 = require("../shared");
+const agentTypes_1 = require("./agentTypes");
+const templates_1 = require("./templates");
+class AgentGenerator {
+    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, selectedAgentTypes, verbose = false) {
+        const agentsDir = path.join(outputDir, 'agents');
+        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;
+        }
+        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;
+    }
+    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);
+    }
+    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;
+//# sourceMappingURL=agentGenerator.js.map

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

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

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

@@ -0,0 +1,4 @@
+export declare const AGENT_TYPES: readonly ["code-reviewer", "bug-fixer", "feature-developer", "refactoring-specialist", "test-writer", "documentation-writer", "performance-optimizer", "security-auditor", "backend-specialist", "frontend-specialist", "architect-specialist"];
+export type AgentType = typeof AGENT_TYPES[number];
+export declare const IMPORTANT_FILES: string[];
+//# sourceMappingURL=agentTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentTypes.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,iPAYd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,eAAe,UAI3B,CAAC"}

package/dist/generators/agents/agentTypes.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORTANT_FILES = exports.AGENT_TYPES = void 0;
+exports.AGENT_TYPES = [
+    'code-reviewer',
+    'bug-fixer',
+    'feature-developer',
+    'refactoring-specialist',
+    'test-writer',
+    'documentation-writer',
+    'performance-optimizer',
+    'security-auditor',
+    'backend-specialist',
+    'frontend-specialist',
+    'architect-specialist'
+];
+exports.IMPORTANT_FILES = [
+    'package.json', 'tsconfig.json', 'webpack.config.js',
+    'next.config.js', 'tailwind.config.js', 'README.md',
+    '.gitignore', 'Dockerfile', 'docker-compose.yml'
+];
+//# sourceMappingURL=agentTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentTypes.js","sourceRoot":"","sources":["../../../src/generators/agents/agentTypes.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACzB,eAAe;IACf,WAAW;IACX,mBAAmB;IACnB,wBAAwB;IACxB,aAAa;IACb,sBAAsB;IACtB,uBAAuB;IACvB,kBAAkB;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,sBAAsB;CACd,CAAC;AAIE,QAAA,eAAe,GAAG;IAC7B,cAAc,EAAE,eAAe,EAAE,mBAAmB;IACpD,gBAAgB,EAAE,oBAAoB,EAAE,WAAW;IACnD,YAAY,EAAE,YAAY,EAAE,oBAAoB;CACjD,CAAC"}

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

@@ -0,0 +1,8 @@
+import { RepoStructure } from '../../types';
+import { FileMapper } from '../../utils/fileMapper';
+import { ContextGenerator } from '../shared';
+export declare class ContextUtils extends ContextGenerator {
+    constructor(fileMapper: FileMapper);
+    createFileContext(repoStructure: RepoStructure): Promise<string>;
+}
+//# sourceMappingURL=contextUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextUtils.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/contextUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAkB,MAAM,WAAW,CAAC;AAE7D,qBAAa,YAAa,SAAQ,gBAAgB;gBACpC,UAAU,EAAE,UAAU;IAK5B,iBAAiB,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAOvE"}

package/dist/generators/agents/contextUtils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextUtils = void 0;
+const agentTypes_1 = require("./agentTypes");
+const shared_1 = require("../shared");
+class ContextUtils extends shared_1.ContextGenerator {
+    constructor(fileMapper) {
+        super(fileMapper);
+    }
+    async createFileContext(repoStructure) {
+        return super.createFileContext(repoStructure, agentTypes_1.IMPORTANT_FILES);
+    }
+}
+exports.ContextUtils = ContextUtils;
+//# sourceMappingURL=contextUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextUtils.js","sourceRoot":"","sources":["../../../src/generators/agents/contextUtils.ts"],"names":[],"mappings":";;;AAGA,6CAA+C;AAC/C,sCAA6D;AAE7D,MAAa,YAAa,SAAQ,yBAAgB;IAChD,YAAY,UAAsB;QAChC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpB,CAAC;IAGD,KAAK,CAAC,iBAAiB,CAAC,aAA4B;QAClD,OAAO,KAAK,CAAC,iBAAiB,CAAC,aAAa,EAAE,4BAAe,CAAC,CAAC;IACjE,CAAC;CAKF;AAbD,oCAaC"}

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

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

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

@@ -0,0 +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"}

package/dist/generators/agents/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+Object.defineProperty(exports, "AGENT_TYPES", { enumerable: true, get: function () { return agentTypes_1.AGENT_TYPES; } });
+Object.defineProperty(exports, "IMPORTANT_FILES", { enumerable: true, get: function () { return agentTypes_1.IMPORTANT_FILES; } });
+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; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,9 @@
+import { AgentType } from './agentTypes';
+export declare class PromptFormatter {
+    formatAgentPrompt(agentType: AgentType, generatedPrompt: string, repoContext: string): string;
+    generateAgentIndex(): string;
+    private getAgentResponsibilities;
+    private getAgentBestPractices;
+    private getAgentCommands;
+}
+//# sourceMappingURL=promptFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptFormatter.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/promptFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,cAAc,CAAC;AAItD,qBAAa,eAAe;IAC1B,iBAAiB,CACf,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,MAAM;IA2BT,kBAAkB,IAAI,MAAM;IA8B5B,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/generators/agents/promptFormatter.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptFormatter = void 0;
+const agentTypes_1 = require("./agentTypes");
+const agentConfig_1 = require("./agentConfig");
+const shared_1 = require("../shared");
+class PromptFormatter {
+    formatAgentPrompt(agentType, generatedPrompt, repoContext) {
+        const title = shared_1.GeneratorUtils.formatTitle(agentType);
+        return `# ${title} Agent
+
+## Role Description
+You are a specialized ${title} agent for this codebase. Your primary function is to assist with ${agentType.replace('-', ' ')} tasks while maintaining deep understanding of the project structure and conventions.
+
+## Repository Context
+${repoContext}
+
+## Agent-Specific Prompt
+${generatedPrompt}
+
+## Key Responsibilities
+${this.getAgentResponsibilities(agentType)}
+
+## Best Practices
+${this.getAgentBestPractices(agentType)}
+
+## Common Commands and Patterns
+${this.getAgentCommands(agentType)}
+
+${shared_1.GeneratorUtils.createGeneratedByFooter('Agent', `Agent Type: ${agentType}`)}
+`;
+    }
+    generateAgentIndex() {
+        return `# AI Agents Index
+
+This directory contains specialized AI agent prompts designed for this codebase.
+
+## Available Agents
+
+${agentTypes_1.AGENT_TYPES.map(type => {
+            const title = shared_1.GeneratorUtils.formatTitle(type);
+            return `### [${title}](${type}.md)
+- **File:** \`${type}.md\`
+- **Purpose:** Specialized ${title.toLowerCase()} tasks
+`;
+        }).join('\n')}
+
+## Usage
+
+Each agent prompt is designed to provide context-aware assistance for specific development tasks. Use these prompts with your preferred AI assistant to get specialized help with your codebase.
+
+## How to Use
+
+1. Choose the appropriate agent for your task
+2. Copy the agent prompt from the corresponding .md file
+3. Provide the prompt to your AI assistant along with your specific question or task
+4. The agent will provide context-aware assistance based on your codebase structure
+
+${shared_1.GeneratorUtils.createGeneratedByFooter('Agent Index')}
+`;
+    }
+    getAgentResponsibilities(agentType) {
+        return agentConfig_1.AGENT_RESPONSIBILITIES[agentType]?.map(r => `- ${r}`).join('\n') ||
+            '- Perform specialized tasks for this agent type';
+    }
+    getAgentBestPractices(agentType) {
+        return agentConfig_1.AGENT_BEST_PRACTICES[agentType]?.map(p => `- ${p}`).join('\n') ||
+            '- Follow general best practices for software development';
+    }
+    getAgentCommands(agentType) {
+        return `Common patterns and commands for ${agentType} tasks:
+
+\`\`\`bash
+# Add relevant commands here based on the codebase
+npm test          # Run tests
+npm run lint      # Check code style
+npm run build     # Build the project
+\`\`\`
+
+Refer to the project's package.json or documentation for specific commands.`;
+    }
+}
+exports.PromptFormatter = PromptFormatter;
+//# sourceMappingURL=promptFormatter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptFormatter.js","sourceRoot":"","sources":["../../../src/generators/agents/promptFormatter.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AACtD,+CAA6E;AAC7E,sCAA2C;AAE3C,MAAa,eAAe;IAC1B,iBAAiB,CACf,SAAoB,EACpB,eAAuB,EACvB,WAAmB;QAEnB,MAAM,KAAK,GAAG,uBAAc,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAEpD,OAAO,KAAK,KAAK;;;wBAGG,KAAK,qEAAqE,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;;;EAG3H,WAAW;;;EAGX,eAAe;;;EAGf,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;;;EAGxC,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC;;;EAGrC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC;;EAEhC,uBAAc,CAAC,uBAAuB,CAAC,OAAO,EAAE,eAAe,SAAS,EAAE,CAAC;CAC5E,CAAC;IACA,CAAC;IAED,kBAAkB;QAChB,OAAO;;;;;;EAMT,wBAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACvB,MAAM,KAAK,GAAG,uBAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,QAAQ,KAAK,KAAK,IAAI;gBACf,IAAI;6BACS,KAAK,CAAC,WAAW,EAAE;CAC/C,CAAC;QACF,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;EAaX,uBAAc,CAAC,uBAAuB,CAAC,aAAa,CAAC;CACtD,CAAC;IACA,CAAC;IAEO,wBAAwB,CAAC,SAAoB;QACnD,OAAO,oCAAsB,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAChE,iDAAiD,CAAC;IAC3D,CAAC;IAEO,qBAAqB,CAAC,SAAoB;QAChD,OAAO,kCAAoB,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9D,0DAA0D,CAAC;IACpE,CAAC;IAEO,gBAAgB,CAAC,SAAoB;QAC3C,OAAO,oCAAoC,SAAS;;;;;;;;;4EASoB,CAAC;IAC3E,CAAC;CACF;AApFD,0CAoFC"}

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