@corbat-tech/coding-standards-mcp 1.0.3 → 1.1.0

package/dist/tools/definitions.d.ts

@@ -0,0 +1,104 @@
+/**
+ * MCP Tool Definitions.
+ *
+ * This file contains ONLY the tool definitions (name, description, inputSchema).
+ * Handler logic is in separate files under handlers/.
+ *
+ * Design principles:
+ * - One primary tool (get_context) that does everything
+ * - Supporting tools for specific use cases
+ * - Names are short and intuitive
+ * - Descriptions are optimized for LLM understanding
+ */
+export declare const tools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            task: {
+                type: string;
+                description: string;
+            };
+            project_dir: {
+                type: string;
+                description: string;
+            };
+            code?: undefined;
+            task_type?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            task_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            task?: undefined;
+            project_dir?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            task?: undefined;
+            project_dir?: undefined;
+            code?: undefined;
+            task_type?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            task?: undefined;
+            project_dir?: undefined;
+            code?: undefined;
+            task_type?: undefined;
+            query?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_dir: {
+                type: string;
+                description: string;
+            };
+            task?: undefined;
+            code?: undefined;
+            task_type?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export type ToolName = 'get_context' | 'validate' | 'search' | 'profiles' | 'health' | 'init';
+//# sourceMappingURL=definitions.d.ts.map

package/dist/tools/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkKjB,CAAC;AAGF,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC"}

package/dist/tools/definitions.js

@@ -0,0 +1,171 @@
+/**
+ * MCP Tool Definitions.
+ *
+ * This file contains ONLY the tool definitions (name, description, inputSchema).
+ * Handler logic is in separate files under handlers/.
+ *
+ * Design principles:
+ * - One primary tool (get_context) that does everything
+ * - Supporting tools for specific use cases
+ * - Names are short and intuitive
+ * - Descriptions are optimized for LLM understanding
+ */
+export const tools = [
+    // PRIMARY TOOL - Everything in one call
+    {
+        name: 'get_context',
+        description: `Returns coding standards, guardrails, and workflow for implementing a task.
+
+WHEN TO USE:
+- ALWAYS call this FIRST before writing any code
+- When starting a new feature, bugfix, or refactor
+- When unsure about project conventions
+
+RETURNS:
+- Detected stack (Java/Python/TypeScript/Go/Rust/etc)
+- Task type classification (feature/bugfix/refactor/test/security/performance)
+- MUST rules (mandatory guidelines)
+- AVOID rules (anti-patterns to prevent)
+- Code quality thresholds (max lines, coverage %)
+- Naming conventions (classes, methods, files)
+- Recommended TDD workflow
+
+EXAMPLE: get_context({ task: "Create payment service", project_dir: "/path/to/project" })`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task: {
+                    type: 'string',
+                    description: 'What you\'re implementing (e.g., "Create payment service", "Fix login bug")',
+                },
+                project_dir: {
+                    type: 'string',
+                    description: 'Project directory for auto-detection of stack and .corbat.json config (optional)',
+                },
+            },
+            required: ['task'],
+        },
+    },
+    // VALIDATE - Check code against standards
+    {
+        name: 'validate',
+        description: `Validate code against coding standards. Returns validation criteria and checklist.
+
+WHEN TO USE:
+- After writing code, before committing
+- During code review
+- To check if code follows project standards
+
+RETURNS:
+- Code quality thresholds (max method lines, coverage)
+- Guardrails for the task type
+- Naming convention checks
+- Review checklist (CRITICAL/WARNINGS/Score)
+
+EXAMPLE: validate({ code: "public class UserService { ... }", task_type: "feature" })`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                code: {
+                    type: 'string',
+                    description: 'The code to validate',
+                },
+                task_type: {
+                    type: 'string',
+                    enum: ['feature', 'bugfix', 'refactor', 'test'],
+                    description: 'Type of task for context-aware validation (optional)',
+                },
+            },
+            required: ['code'],
+        },
+    },
+    // SEARCH - Find specific topics in documentation
+    {
+        name: 'search',
+        description: `Search standards documentation for specific topics.
+
+WHEN TO USE:
+- Looking for specific technology guidance (kafka, docker, kubernetes)
+- Need detailed information on a pattern or practice
+- Exploring available standards
+
+EXAMPLE QUERIES: "kafka", "testing", "docker", "logging", "metrics", "archunit", "flyway"
+
+RETURNS: Up to 5 matching results with excerpts from documentation.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (e.g., "kafka", "testing", "docker")',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    // PROFILES - List available profiles
+    {
+        name: 'profiles',
+        description: `List all available coding standards profiles.
+
+RETURNS: List of profiles with ID and description. Profiles include:
+- java-spring-backend: Enterprise Java with Hexagonal Architecture
+- nodejs: Node.js/TypeScript with Clean Architecture
+- react, vue, angular: Frontend frameworks
+- python: FastAPI/Django
+- go, rust: Systems programming
+- And more...
+
+Use profile ID in .corbat.json or get_context will auto-detect.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    // HEALTH - Server status
+    {
+        name: 'health',
+        description: `Check server status, loaded profiles, and usage metrics.
+
+RETURNS:
+- Server status (OK/ERROR)
+- Version
+- Load time
+- Profiles loaded
+- Standards documents count
+- Usage metrics (tool calls, most used profile)`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    // INIT - Generate .corbat.json
+    {
+        name: 'init',
+        description: `Generate a .corbat.json configuration file for a project.
+
+WHEN TO USE:
+- Setting up Corbat for a new project
+- Want to customize coding standards for a project
+- Need to see available profiles and options
+
+Analyzes the project directory and suggests optimal configuration based on detected stack.
+
+RETURNS:
+- Detected stack information
+- Suggested .corbat.json content
+- Available profiles list
+- Setup instructions`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_dir: {
+                    type: 'string',
+                    description: 'Project directory to analyze',
+                },
+            },
+            required: ['project_dir'],
+        },
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,wCAAwC;IACxC;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;;;;;;;;;;;;;;;;0FAgByE;QACtF,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6EAA6E;iBAC3F;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kFAAkF;iBAChG;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IAED,0CAA0C;IAC1C;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;sFAaqE;QAClF,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;iBACpC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;oBAC/C,WAAW,EAAE,sDAAsD;iBACpE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IAED,iDAAiD;IACjD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;;;;;oEASmD;QAChE,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IAED,qCAAqC;IACrC;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;gEAU+C;QAC5D,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;SACf;KACF;IAED,yBAAyB;IACzB;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;;;;gDAQ+B;QAC5C,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;SACf;KACF;IAED,+BAA+B;IAC/B;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;qBAaI;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;CACF,CAAC"}

package/dist/tools/handlers/get-context.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handler for the get_context tool.
+ * Returns complete coding standards context for a task.
+ */
+export declare function handleGetContext(args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=get-context.d.ts.map

package/dist/tools/handlers/get-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/get-context.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA4HhF"}

package/dist/tools/handlers/get-context.js

@@ -0,0 +1,118 @@
+import { classifyTaskType, detectProjectStack, getGuardrails, getProjectRules, loadProjectConfig, } from '../../agent.js';
+import { config } from '../../config.js';
+import { getProfile, listProfiles } from '../../profiles.js';
+import { GetContextSchema } from '../schemas.js';
+/**
+ * Handler for the get_context tool.
+ * Returns complete coding standards context for a task.
+ */
+export async function handleGetContext(args) {
+    const { task, project_dir } = GetContextSchema.parse(args);
+    // Classify task type
+    const taskType = classifyTaskType(task);
+    // Auto-detect project stack if directory provided
+    let detectedStack = null;
+    let projectConfig = null;
+    if (project_dir) {
+        detectedStack = await detectProjectStack(project_dir);
+        projectConfig = await loadProjectConfig(project_dir);
+    }
+    // Determine profile (priority: project config > detected > default)
+    const profileId = projectConfig?.profile || detectedStack?.suggestedProfile || config.defaultProfile;
+    const profile = await getProfile(profileId);
+    if (!profile) {
+        const availableProfiles = await listProfiles();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Profile "${profileId}" not found.\n\nAvailable profiles:\n${availableProfiles.map((p) => `- ${p.id}`).join('\n')}\n\nRun \`corbat-init\` in your project to create a custom profile.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Get guardrails and rules
+    const guardrails = await getGuardrails(taskType, projectConfig);
+    const projectRules = getProjectRules(taskType, projectConfig);
+    // Build concise, scannable output
+    const lines = [`# Context for: ${task}`, '', '---', ''];
+    // Stack Detection (concise)
+    if (detectedStack) {
+        const stackParts = [detectedStack.language];
+        if (detectedStack.framework)
+            stackParts.push(detectedStack.framework);
+        if (detectedStack.buildTool)
+            stackParts.push(detectedStack.buildTool);
+        lines.push(`**Stack:** ${stackParts.join(' · ')}`);
+    }
+    lines.push(`**Task type:** ${taskType.toUpperCase()}`);
+    lines.push(`**Profile:** ${profileId}`);
+    lines.push('');
+    // Guardrails (essential, concise)
+    lines.push('---', '', '## Guardrails', '');
+    lines.push('**MUST:**');
+    for (const rule of guardrails.mandatory.slice(0, 5)) {
+        lines.push(`- ${rule}`);
+    }
+    lines.push('');
+    lines.push('**AVOID:**');
+    for (const rule of guardrails.avoid.slice(0, 4)) {
+        lines.push(`- ${rule}`);
+    }
+    lines.push('');
+    // Project-specific rules (if any)
+    if (projectRules.length > 0) {
+        lines.push('**PROJECT RULES:**');
+        for (const rule of projectRules) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push('');
+    }
+    // Quick Reference (most important settings)
+    lines.push('---', '', '## Quick Reference', '');
+    if (profile.codeQuality) {
+        lines.push(`- Max method lines: ${profile.codeQuality.maxMethodLines}`);
+        lines.push(`- Max class lines: ${profile.codeQuality.maxClassLines}`);
+        lines.push(`- Min test coverage: ${profile.codeQuality.minimumTestCoverage}%`);
+    }
+    if (profile.architecture) {
+        lines.push(`- Architecture: ${profile.architecture.type}`);
+    }
+    if (profile.ddd?.enabled) {
+        lines.push('- DDD: Enabled');
+    }
+    if (profile.testing) {
+        lines.push(`- Testing: ${profile.testing.framework || 'standard'}`);
+    }
+    lines.push('');
+    // Naming conventions (concise)
+    if (profile.naming) {
+        lines.push('---', '', '## Naming', '');
+        const naming = profile.naming;
+        if (naming.general && typeof naming.general === 'object') {
+            for (const [key, value] of Object.entries(naming.general)) {
+                lines.push(`- **${key}:** ${value}`);
+            }
+        }
+        if (naming.suffixes && typeof naming.suffixes === 'object') {
+            lines.push('');
+            lines.push('**Suffixes:**');
+            for (const [key, value] of Object.entries(naming.suffixes)) {
+                lines.push(`- ${key}: \`${value}\``);
+            }
+        }
+        lines.push('');
+    }
+    // Workflow reminder (brief)
+    lines.push('---', '', '## Workflow', '');
+    lines.push('```');
+    lines.push('1. CLARIFY  → Ask if unclear');
+    lines.push('2. PLAN     → Task checklist');
+    lines.push('3. BUILD    → TDD: Test → Code → Refactor');
+    lines.push('4. VERIFY   → Tests pass, linter clean');
+    lines.push('5. REVIEW   → Self-check as expert');
+    lines.push('```');
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=get-context.js.map

package/dist/tools/handlers/get-context.js.map

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

package/dist/tools/handlers/health.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Handler for the health tool.
+ * Returns server status, loaded configuration, and usage metrics.
+ */
+export declare function handleHealth(): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/handlers/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/health.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwDhG"}

package/dist/tools/handlers/health.js

@@ -0,0 +1,57 @@
+import { config } from '../../config.js';
+import { getMetrics } from '../../metrics.js';
+import { listProfiles, loadStandards } from '../../profiles.js';
+/**
+ * Handler for the health tool.
+ * Returns server status, loaded configuration, and usage metrics.
+ */
+export async function handleHealth() {
+    const startTime = Date.now();
+    try {
+        const profiles = await listProfiles();
+        const standards = await loadStandards();
+        const loadTimeMs = Date.now() - startTime;
+        const metrics = getMetrics();
+        const lines = [
+            '# Corbat MCP Health',
+            '',
+            '**Status:** OK',
+            `**Version:** ${config.serverVersion}`,
+            `**Uptime:** ${metrics.uptimeFormatted}`,
+            `**Load time:** ${loadTimeMs}ms`,
+            '',
+            '## Resources',
+            '',
+            `- **Profiles:** ${profiles.length}`,
+            `- **Standards:** ${standards.length} documents`,
+            `- **Default profile:** ${config.defaultProfile}`,
+            '',
+        ];
+        // Only show metrics section if there have been calls
+        if (metrics.totalToolCalls > 0) {
+            lines.push('## Metrics', '');
+            lines.push(`- **Total tool calls:** ${metrics.totalToolCalls}`);
+            if (metrics.mostUsedTool) {
+                lines.push(`- **Most used tool:** ${metrics.mostUsedTool}`);
+            }
+            if (metrics.mostUsedProfile) {
+                lines.push(`- **Most used profile:** ${metrics.mostUsedProfile}`);
+            }
+            if (metrics.mostCommonTaskType) {
+                lines.push(`- **Most common task:** ${metrics.mostCommonTaskType}`);
+            }
+            if (metrics.errors > 0) {
+                lines.push(`- **Errors:** ${metrics.errors}`);
+            }
+            lines.push('');
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `# Corbat MCP Health\n\n**Status:** ERROR\n**Error:** ${errorMessage}` }],
+        };
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/handlers/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/tools/handlers/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAG;YACZ,qBAAqB;YACrB,EAAE;YACF,gBAAgB;YAChB,gBAAgB,MAAM,CAAC,aAAa,EAAE;YACtC,eAAe,OAAO,CAAC,eAAe,EAAE;YACxC,kBAAkB,UAAU,IAAI;YAChC,EAAE;YACF,cAAc;YACd,EAAE;YACF,mBAAmB,QAAQ,CAAC,MAAM,EAAE;YACpC,oBAAoB,SAAS,CAAC,MAAM,YAAY;YAChD,0BAA0B,MAAM,CAAC,cAAc,EAAE;YACjD,EAAE;SACH,CAAC;QAEF,qDAAqD;QACrD,IAAI,OAAO,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;YAEhE,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,4BAA4B,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wDAAwD,YAAY,EAAE,EAAE,CAAC;SAC1G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/handlers/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool handlers index.
+ * Re-exports all handlers for centralized access.
+ */
+export { handleGetContext } from './get-context.js';
+export { handleHealth } from './health.js';
+export { handleInit } from './init.js';
+export { handleProfiles } from './profiles.js';
+export { handleSearch } from './search.js';
+export { handleValidate } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/handlers/index.js

@@ -0,0 +1,11 @@
+/**
+ * Tool handlers index.
+ * Re-exports all handlers for centralized access.
+ */
+export { handleGetContext } from './get-context.js';
+export { handleHealth } from './health.js';
+export { handleInit } from './init.js';
+export { handleProfiles } from './profiles.js';
+export { handleSearch } from './search.js';
+export { handleValidate } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/handlers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/handlers/init.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handler for the init tool.
+ * Analyzes project and generates suggested .corbat.json configuration.
+ */
+export declare function handleInit(args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=init.d.ts.map

package/dist/tools/handlers/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/init.ts"],"names":[],"mappings":"AAiEA;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAiDhF"}

package/dist/tools/handlers/init.js

@@ -0,0 +1,102 @@
+import { detectProjectStack } from '../../agent.js';
+import { listProfiles } from '../../profiles.js';
+import { InitSchema } from '../schemas.js';
+/**
+ * Generate suggested .corbat.json configuration based on detected stack.
+ */
+function generateSuggestedConfig(stack) {
+    if (!stack) {
+        return {
+            profile: 'minimal',
+            autoInject: true,
+            rules: {
+                always: ['Follow project coding conventions'],
+                onNewFile: ['Add appropriate file header comments'],
+                onTest: ['Follow AAA pattern (Arrange-Act-Assert)'],
+                onRefactor: ['Ensure tests pass before and after refactoring'],
+            },
+        };
+    }
+    const config = {
+        profile: stack.suggestedProfile,
+        autoInject: true,
+    };
+    // Add language-specific rules
+    const rules = {
+        always: [],
+        onNewFile: [],
+        onTest: [],
+        onRefactor: [],
+    };
+    if (stack.language === 'Java') {
+        rules.always.push('Use constructor injection for dependencies');
+        rules.onNewFile.push('Add Javadoc for public classes and methods');
+        rules.onTest.push('Use @DisplayName for readable test names');
+    }
+    else if (stack.language === 'TypeScript' || stack.language === 'JavaScript') {
+        rules.always.push('Use strict TypeScript configuration');
+        rules.onNewFile.push('Export types alongside implementations');
+        rules.onTest.push('Mock external dependencies');
+    }
+    else if (stack.language === 'Python') {
+        rules.always.push('Use type hints for function signatures');
+        rules.onNewFile.push('Add module docstring');
+        rules.onTest.push('Use pytest fixtures for setup');
+    }
+    else if (stack.language === 'Go') {
+        rules.always.push('Follow effective Go guidelines');
+        rules.onNewFile.push('Add package documentation');
+        rules.onTest.push('Use table-driven tests');
+    }
+    if (rules.always.length > 0 || rules.onNewFile.length > 0) {
+        config.rules = rules;
+    }
+    return config;
+}
+/**
+ * Handler for the init tool.
+ * Analyzes project and generates suggested .corbat.json configuration.
+ */
+export async function handleInit(args) {
+    const { project_dir } = InitSchema.parse(args);
+    // Detect project stack
+    const stack = await detectProjectStack(project_dir);
+    // Get available profiles
+    const profiles = await listProfiles();
+    const profileIds = profiles.map((p) => p.id);
+    // Generate suggested config
+    const suggestedConfig = generateSuggestedConfig(stack);
+    const lines = ['# Corbat MCP Configuration', '', '## Detected Stack', ''];
+    if (stack) {
+        lines.push(`- **Language:** ${stack.language}`);
+        if (stack.framework) {
+            lines.push(`- **Framework:** ${stack.framework}`);
+        }
+        if (stack.buildTool) {
+            lines.push(`- **Build Tool:** ${stack.buildTool}`);
+        }
+        lines.push(`- **Suggested Profile:** ${stack.suggestedProfile}`);
+        lines.push(`- **Confidence:** ${stack.confidence}`);
+    }
+    else {
+        lines.push('Could not auto-detect stack. Using minimal profile.');
+    }
+    lines.push('', '## Suggested .corbat.json', '');
+    lines.push('```json');
+    lines.push(JSON.stringify(suggestedConfig, null, 2));
+    lines.push('```');
+    lines.push('', '## How to Use', '');
+    lines.push(`1. Save the above JSON to \`${project_dir}/.corbat.json\``);
+    lines.push('2. Customize rules and profile as needed');
+    lines.push('3. Run `get_context` to get standards for your tasks');
+    lines.push('', '## Available Profiles', '');
+    for (const id of profileIds.slice(0, 10)) {
+        const isSelected = id === suggestedConfig.profile ? ' **(selected)**' : '';
+        lines.push(`- ${id}${isSelected}`);
+    }
+    if (profileIds.length > 10) {
+        lines.push(`- ... and ${profileIds.length - 10} more`);
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=init.js.map