@dotcontext/mcp 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AI Coders Academy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @dotcontext/mcp
+
+Model Context Protocol adapter for dotcontext.
+
+This package owns:
+
+- the MCP server binary
+- the MCP installer command surface
+- MCP tool registration
+- request/response translation for the harness runtime
+
+It exposes the harness over MCP and should remain thinner than the runtime it serves.
+
+## Usage
+
+```bash
+# Install MCP configuration into supported AI tools
+npx @dotcontext/mcp install
+
+# Start the MCP server directly
+npx -y @dotcontext/mcp@latest
+```

package/dist/cli/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI boundary exports.
+ *
+ * This module defines the operator-facing surface that is expected to
+ * become the future `dotcontext/cli` package. Keep domain/runtime logic
+ * out of this boundary whenever possible.
+ */
+export { MCPInstallService, type MCPInstallServiceDependencies, type MCPInstallOptions, type MCPInstallResult, type MCPInstallation, StateDetector, type ProjectState, type StateDetectionResult, type StateDetectorOptions, } from '../services/cli';
+export { SyncService } from '../services/sync/syncService';
+export { ImportRulesService, ImportAgentsService } from '../services/import';
+export { ExportRulesService } from '../services/export';
+export { ReportService } from '../services/report';
+export { QuickSyncService, type QuickSyncOptions } from '../services/quickSync';
+export { ReverseQuickSyncService, type MergeStrategy } from '../services/reverseSync';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * CLI boundary exports.
+ *
+ * This module defines the operator-facing surface that is expected to
+ * become the future `dotcontext/cli` package. Keep domain/runtime logic
+ * out of this boundary whenever possible.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReverseQuickSyncService = exports.QuickSyncService = exports.ReportService = exports.ExportRulesService = exports.ImportAgentsService = exports.ImportRulesService = exports.SyncService = exports.StateDetector = exports.MCPInstallService = void 0;
+var cli_1 = require("../services/cli");
+Object.defineProperty(exports, "MCPInstallService", { enumerable: true, get: function () { return cli_1.MCPInstallService; } });
+Object.defineProperty(exports, "StateDetector", { enumerable: true, get: function () { return cli_1.StateDetector; } });
+var syncService_1 = require("../services/sync/syncService");
+Object.defineProperty(exports, "SyncService", { enumerable: true, get: function () { return syncService_1.SyncService; } });
+var import_1 = require("../services/import");
+Object.defineProperty(exports, "ImportRulesService", { enumerable: true, get: function () { return import_1.ImportRulesService; } });
+Object.defineProperty(exports, "ImportAgentsService", { enumerable: true, get: function () { return import_1.ImportAgentsService; } });
+var export_1 = require("../services/export");
+Object.defineProperty(exports, "ExportRulesService", { enumerable: true, get: function () { return export_1.ExportRulesService; } });
+var report_1 = require("../services/report");
+Object.defineProperty(exports, "ReportService", { enumerable: true, get: function () { return report_1.ReportService; } });
+var quickSync_1 = require("../services/quickSync");
+Object.defineProperty(exports, "QuickSyncService", { enumerable: true, get: function () { return quickSync_1.QuickSyncService; } });
+var reverseSync_1 = require("../services/reverseSync");
+Object.defineProperty(exports, "ReverseQuickSyncService", { enumerable: true, get: function () { return reverseSync_1.ReverseQuickSyncService; } });
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uCAUyB;AATvB,wGAAA,iBAAiB,OAAA;AAKjB,oGAAA,aAAa,OAAA;AAMf,4DAA2D;AAAlD,0GAAA,WAAW,OAAA;AACpB,6CAA6E;AAApE,4GAAA,kBAAkB,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAChD,6CAAwD;AAA/C,4GAAA,kBAAkB,OAAA;AAC3B,6CAAmD;AAA1C,uGAAA,aAAa,OAAA;AACtB,mDAAgF;AAAvE,6GAAA,gBAAgB,OAAA;AACzB,uDAAsF;AAA7E,sHAAA,uBAAuB,OAAA"}

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,CA2F9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAmF5D,CAAC"}

package/dist/generators/agents/agentConfig.js

@@ -0,0 +1,180 @@
+"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'
+    ],
+    'devops-specialist': [
+        'Design and maintain CI/CD pipelines',
+        'Implement infrastructure as code',
+        'Configure monitoring and alerting systems',
+        'Manage container orchestration and deployments',
+        'Optimize cloud resources and cost efficiency'
+    ],
+    'database-specialist': [
+        'Design and optimize database schemas',
+        'Create and manage database migrations',
+        'Optimize query performance and indexing',
+        'Ensure data integrity and consistency',
+        'Implement backup and recovery strategies'
+    ],
+    'mobile-specialist': [
+        'Develop native and cross-platform mobile applications',
+        'Optimize mobile app performance and battery usage',
+        'Implement mobile-specific UI/UX patterns',
+        'Handle app store deployment and updates',
+        'Integrate push notifications and offline capabilities'
+    ]
+};
+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'
+    ],
+    'devops-specialist': [
+        'Automate everything that can be automated',
+        'Implement infrastructure as code for reproducibility',
+        'Monitor system health proactively',
+        'Design for failure and implement proper fallbacks',
+        'Keep security and compliance in every deployment'
+    ],
+    'database-specialist': [
+        'Always benchmark queries before and after optimization',
+        'Plan migrations with rollback strategies',
+        'Use appropriate indexing strategies for workloads',
+        'Maintain data consistency across transactions',
+        'Document schema changes and their business impact'
+    ],
+    'mobile-specialist': [
+        'Test on real devices, not just simulators',
+        'Optimize for battery life and data usage',
+        'Follow platform-specific design guidelines',
+        'Implement proper offline-first strategies',
+        'Plan for app store review requirements early'
+    ]
+};
+//# 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":"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"}

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

@@ -0,0 +1,36 @@
+import { RepoStructure } from '../../types';
+import { AgentType } from './agentTypes';
+/** Skill info that agents can reference */
+interface AvailableSkill {
+    slug: string;
+    name: string;
+    description: string;
+    phases: string[];
+}
+interface AgentGenerationConfig {
+    selectedAgents?: string[];
+    semantic?: boolean;
+    /** Filtered list of agents based on project type classification */
+    filteredAgents?: AgentType[];
+    /** Include section headings and guidance in scaffolds (CLI mode) */
+    includeContentStubs?: boolean;
+    /** Fill scaffolds with semantic data (no LLM required) */
+    autoFill?: boolean;
+    /** Available skills that agents can reference */
+    availableSkills?: AvailableSkill[];
+}
+export declare class AgentGenerator {
+    private readonly docTouchpoints;
+    private analyzer?;
+    constructor(..._legacyArgs: unknown[]);
+    generateAgentPrompts(repoStructure: RepoStructure, outputDir: string, config?: AgentGenerationConfig | string[], verbose?: boolean): Promise<number>;
+    /**
+     * Render an "Available Skills" markdown section for an agent, filtered to relevant skills.
+     */
+    private renderSkillsSection;
+    private getRelevantSymbolsForAgent;
+    private resolveAgentSelection;
+    private buildContext;
+}
+export {};
+//# 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,OAAO,EAAe,SAAS,EAAE,MAAM,cAAc,CAAC;AAoBtD,2CAA2C;AAC3C,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;IAC7B,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AA6CD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAS7B;IAEF,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAExB,GAAG,WAAW,EAAE,OAAO,EAAE;IAE/B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,qBAAqB,GAAG,MAAM,EAAO,EAC7C,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAoGlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,0BAA0B;IA2FlC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/generators/agents/agentGenerator.js

@@ -0,0 +1,304 @@
+"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");
+const guideRegistry_1 = require("../documentation/guideRegistry");
+const semantic_1 = require("../../services/semantic");
+const agentConfig_1 = require("./agentConfig");
+const scaffoldFrontmatter_1 = require("../../types/scaffoldFrontmatter");
+const scaffoldStructures_1 = require("../shared/scaffoldStructures");
+const autoFill_1 = require("../../services/autoFill");
+const stack_1 = require("../../services/stack");
+/**
+ * Mapping of agent types to relevant skill slugs
+ */
+const AGENT_SKILL_MAP = {
+    'code-reviewer': ['code-review', 'security-audit'],
+    'bug-fixer': ['bug-investigation'],
+    'feature-developer': ['feature-breakdown', 'commit-message'],
+    'refactoring-specialist': ['refactoring'],
+    'test-writer': ['test-generation'],
+    'documentation-writer': ['documentation', 'commit-message'],
+    'security-auditor': ['security-audit'],
+};
+/**
+ * Agent to PREVC phase mapping
+ */
+const AGENT_PHASES = {
+    'code-reviewer': ['R', 'V'],
+    'bug-fixer': ['E', 'V'],
+    'feature-developer': ['P', 'E'],
+    'refactoring-specialist': ['E'],
+    'test-writer': ['E', 'V'],
+    'documentation-writer': ['P', 'C'],
+    'performance-optimizer': ['E', 'V'],
+    'security-auditor': ['R', 'V'],
+    'backend-specialist': ['P', 'E'],
+    'frontend-specialist': ['P', 'E'],
+    'architect-specialist': ['P', 'R'],
+    'devops-specialist': ['E', 'C'],
+    'database-specialist': ['P', 'E'],
+    'mobile-specialist': ['P', 'E'],
+};
+/**
+ * Format agent type as display title
+ */
+function formatAgentTitle(agentType) {
+    return agentType
+        .split('-')
+        .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ');
+}
+class AgentGenerator {
+    constructor(..._legacyArgs) {
+        this.docTouchpoints = [
+            {
+                title: 'Documentation Index',
+                path: '../docs/README.md'
+            },
+            ...guideRegistry_1.DOCUMENT_GUIDES.map(guide => ({
+                title: guide.title,
+                path: `../docs/${guide.file}`
+            }))
+        ];
+    }
+    async generateAgentPrompts(repoStructure, outputDir, config = {}, verbose = false) {
+        // Support legacy API: if config is an array, treat it as selectedAgents
+        const normalizedConfig = Array.isArray(config)
+            ? { selectedAgents: config }
+            : config;
+        const agentsDir = path.join(outputDir, 'agents');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(agentsDir, verbose, 'Generating agent scaffold in');
+        // Perform semantic analysis if enabled
+        let semantics;
+        if (normalizedConfig.semantic) {
+            shared_1.GeneratorUtils.logProgress('Running semantic analysis for agents...', verbose);
+            this.analyzer = new semantic_1.CodebaseAnalyzer();
+            try {
+                semantics = await this.analyzer.analyze(repoStructure.rootPath);
+                shared_1.GeneratorUtils.logProgress(`Analyzed ${semantics.stats.totalFiles} files, found ${semantics.stats.totalSymbols} symbols`, verbose);
+            }
+            catch (error) {
+                shared_1.GeneratorUtils.logError('Semantic analysis failed, continuing without it', error, verbose);
+            }
+        }
+        // Detect stack info for autoFill
+        let stackInfo;
+        if (normalizedConfig.autoFill) {
+            try {
+                const stackDetector = new stack_1.StackDetector();
+                stackInfo = await stackDetector.detect(repoStructure.rootPath);
+            }
+            catch (error) {
+                shared_1.GeneratorUtils.logError('Stack detection failed, continuing without it', error, verbose);
+            }
+        }
+        const context = this.buildContext(repoStructure, semantics);
+        const agentTypes = this.resolveAgentSelection(normalizedConfig.selectedAgents, normalizedConfig.filteredAgents);
+        let created = 0;
+        // Generate frontmatter-only files for each agent (scaffold v2)
+        for (const agentType of agentTypes) {
+            const title = formatAgentTitle(agentType);
+            const responsibilities = agentConfig_1.AGENT_RESPONSIBILITIES[agentType] || [];
+            const description = responsibilities[0] || `${title} agent playbook`;
+            const phases = AGENT_PHASES[agentType];
+            const frontmatter = (0, scaffoldFrontmatter_1.createAgentFrontmatter)(title, description, agentType, phases);
+            let content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n';
+            // Add content based on mode
+            const structure = (0, scaffoldStructures_1.getScaffoldStructure)(agentType);
+            if (structure) {
+                if (normalizedConfig.autoFill && semantics) {
+                    // AutoFill: generate content from semantic analysis (no LLM needed)
+                    const autoFillService = new autoFill_1.AutoFillService();
+                    const autoFillContext = {
+                        semantics,
+                        stackInfo,
+                        repoPath: repoStructure.rootPath,
+                        topLevelDirectories: context.topLevelDirectories
+                    };
+                    content += autoFillService.fillAgent(agentType, structure, autoFillContext);
+                }
+                else if (normalizedConfig.includeContentStubs) {
+                    // Content stubs: section headings with guidance comments
+                    content += (0, scaffoldStructures_1.serializeStructureAsMarkdown)(structure);
+                }
+            }
+            // Append available skills section if skills are provided
+            if (normalizedConfig.availableSkills && normalizedConfig.availableSkills.length > 0) {
+                const skillsSection = this.renderSkillsSection(agentType, normalizedConfig.availableSkills);
+                if (skillsSection) {
+                    content += skillsSection;
+                }
+            }
+            const filePath = path.join(agentsDir, `${agentType}.md`);
+            await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Created ${agentType}.md`);
+            created += 1;
+        }
+        // Generate README.md index
+        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;
+    }
+    /**
+     * Render an "Available Skills" markdown section for an agent, filtered to relevant skills.
+     */
+    renderSkillsSection(agentType, availableSkills) {
+        const relevantSlugs = AGENT_SKILL_MAP[agentType];
+        if (!relevantSlugs || relevantSlugs.length === 0) {
+            return null;
+        }
+        const matchedSkills = availableSkills.filter(s => relevantSlugs.includes(s.slug));
+        if (matchedSkills.length === 0) {
+            return null;
+        }
+        const rows = matchedSkills.map(s => `| [${s.slug}](./../skills/${s.slug}/SKILL.md) | ${s.description} |`);
+        return `\n## Available Skills\n\nThe following skills provide detailed procedures for specific tasks. Activate them when needed:\n\n| Skill | Description |\n|-------|-------------|\n${rows.join('\n')}\n`;
+    }
+    getRelevantSymbolsForAgent(agentType, semantics) {
+        if (!semantics)
+            return [];
+        const { symbols } = semantics;
+        let relevantSymbols = [];
+        // Filter symbols based on agent type
+        switch (agentType) {
+            case 'test-writer':
+                // Test writer needs test-related symbols
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /test|spec|mock|stub/i.test(s.name)),
+                    ...symbols.classes.filter(s => /test|spec/i.test(s.name)),
+                ];
+                break;
+            case 'code-reviewer':
+            case 'refactoring-specialist':
+                // These need main classes and interfaces
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => s.exported),
+                    ...symbols.interfaces.filter(s => s.exported),
+                ];
+                break;
+            case 'documentation-writer':
+                // Documentation writer needs exported symbols
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => s.exported),
+                    ...symbols.interfaces.filter(s => s.exported),
+                    ...symbols.functions.filter(s => s.exported),
+                    ...symbols.types.filter(s => s.exported),
+                ];
+                break;
+            case 'security-auditor':
+                // Security auditor needs auth-related symbols
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /auth|security|crypt|token|password|secret/i.test(s.name)),
+                    ...symbols.classes.filter(s => /auth|security|guard|policy/i.test(s.name)),
+                ];
+                break;
+            case 'performance-optimizer':
+                // Performance needs cache, async, and data processing symbols
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /cache|async|batch|queue|pool/i.test(s.name)),
+                    ...symbols.classes.filter(s => /cache|pool|buffer|queue/i.test(s.name)),
+                ];
+                break;
+            case 'database-specialist':
+                // Database specialist needs repository and model symbols
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => /repository|model|entity|schema|migration/i.test(s.name)),
+                    ...symbols.interfaces.filter(s => /repository|model|entity/i.test(s.name)),
+                ];
+                break;
+            case 'backend-specialist':
+                // Backend needs services, controllers, handlers
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => /service|controller|handler|middleware/i.test(s.name)),
+                ];
+                break;
+            case 'frontend-specialist':
+                // Frontend needs components and hooks
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /^use[A-Z]/i.test(s.name)), // hooks
+                    ...symbols.classes.filter(s => /component|view|page|screen/i.test(s.name)),
+                ];
+                break;
+            default:
+                // Default: top exported symbols
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => s.exported).slice(0, 5),
+                    ...symbols.interfaces.filter(s => s.exported).slice(0, 5),
+                ];
+        }
+        // Convert to KeySymbolInfo and limit
+        return relevantSymbols.slice(0, 15).map(s => ({
+            name: s.name,
+            kind: s.kind,
+            file: s.location.file,
+            line: s.location.line,
+        }));
+    }
+    resolveAgentSelection(selected, filteredByProjectType) {
+        // If explicitly selected agents are provided, use those
+        if (selected && selected.length > 0) {
+            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);
+        }
+        // If filtered by project type, use those
+        if (filteredByProjectType && filteredByProjectType.length > 0) {
+            return filteredByProjectType;
+        }
+        // Default: all agents
+        return agentTypes_1.AGENT_TYPES;
+    }
+    buildContext(repoStructure, semantics) {
+        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(),
+            semantics
+        };
+    }
+}
+exports.AgentGenerator = AgentGenerator;
+//# sourceMappingURL=agentGenerator.js.map