kemdicode-mcp 1.15.0

package/dist/tools/specialized/explain-code.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { UnifiedTool } from '../registry.js';
+export declare const explainCodeTool: UnifiedTool;
+//# sourceMappingURL=explain-code.tool.d.ts.map

package/dist/tools/specialized/explain-code.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-code.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/specialized/explain-code.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsB7C,eAAO,MAAM,eAAe,EAAE,WA2D7B,CAAC"}

package/dist/tools/specialized/explain-code.tool.js

@@ -0,0 +1,90 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import { executeAI, parseFiles } from '../../ai/index.js';
+import { getEnhancedContextString } from '../../utils/projectContext.enhanced.js';
+const DEPTH_PROMPTS = {
+    quick: `**QUICK OVERVIEW** - 2-3 sentences per method/class, main purpose, key dependencies`,
+    detailed: `**DETAILED** - Full explanation of each method, data flow, design patterns, relationships`,
+    deep: `**DEEP ANALYSIS** - Everything from detailed + dependency analysis, potential issues, improvement suggestions, ASCII flow diagram`,
+};
+const AUDIENCE_PROMPTS = {
+    junior: `**FOR JUNIOR DEVELOPER** - Explain basic concepts, provide examples, link to documentation, avoid jargon`,
+    senior: `**FOR SENIOR DEVELOPER** - Assume framework knowledge, focus on architecture decisions, highlight unusual patterns`,
+    'non-tech': `**FOR NON-TECHNICAL** - Explain in business terms, what it does for users, problems it solves`,
+};
+const schema = z.object({
+    files: z.string().describe('Files to explain (use @path/file.php syntax)'),
+    depth: z.enum(['quick', 'detailed', 'deep']).default('detailed'),
+    audience: z.enum(['junior', 'senior', 'non-tech']).default('senior'),
+});
+export const explainCodeTool = {
+    name: 'explain-code',
+    description: 'Code explanation from quick overview to deep analysis',
+    zodSchema: schema,
+    prompt: { description: 'Explain PHP/Laravel code' },
+    execute: async (args, onProgress) => {
+        const { files, depth = 'detailed', audience = 'senior' } = args;
+        if (!files?.toString().trim())
+            throw new Error('Files required. Use @path/file.php syntax.');
+        const filesStr = String(files);
+        const agent = depth === 'quick' ? 'explore' : 'plan';
+        const prompt = `${getEnhancedContextString()}
+# Code Explanation Request
+
+${DEPTH_PROMPTS[depth]}
+${AUDIENCE_PROMPTS[audience]}
+
+## Files
+${filesStr}
+
+## Output Format
+### [Class/File Name]
+**Purpose:** One sentence describing main responsibility
+
+**How it works:**
+[Explanation of flow]
+
+${depth !== 'quick'
+            ? `
+**Key methods:**
+- \`methodName()\`: What it does and why
+
+**Dependencies:**
+- Uses: [list]
+- Used by: [list]
+`
+            : ''}
+${depth === 'deep'
+            ? `
+**Flow diagram:**
+\`\`\`
+[ASCII diagram]
+\`\`\`
+
+**Potential issues:** [list]
+**Improvement suggestions:** [list]
+`
+            : ''}
+
+Begin explanation:`;
+        onProgress?.(`Explaining code (${depth}, ${audience}): ${filesStr}`);
+        return executeAI({ prompt, agent, files: parseFiles(filesStr), onProgress });
+    },
+};
+//# sourceMappingURL=explain-code.tool.js.map

package/dist/tools/specialized/explain-code.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-code.tool.js","sourceRoot":"","sources":["../../../src/tools/specialized/explain-code.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAElF,MAAM,aAAa,GAA2B;IAC5C,KAAK,EAAE,qFAAqF;IAC5F,QAAQ,EAAE,2FAA2F;IACrG,IAAI,EAAE,mIAAmI;CAC1I,CAAC;AAEF,MAAM,gBAAgB,GAA2B;IAC/C,MAAM,EAAE,0GAA0G;IAClH,MAAM,EAAE,oHAAoH;IAC5H,UAAU,EAAE,+FAA+F;CAC5G,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC1E,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,uDAAuD;IACpE,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACnD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAE7F,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAc,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAEhE,MAAM,MAAM,GAAG,GAAG,wBAAwB,EAAE;;;EAG9C,aAAa,CAAC,KAAe,CAAC;EAC9B,gBAAgB,CAAC,QAAkB,CAAC;;;EAGpC,QAAQ;;;;;;;;;EAUR,KAAK,KAAK,OAAO;YACf,CAAC,CAAC;;;;;;;CAOL;YACG,CAAC,CAAC,EACN;EAEE,KAAK,KAAK,MAAM;YACd,CAAC,CAAC;;;;;;;;CAQL;YACG,CAAC,CAAC,EACN;;mBAEmB,CAAC;QAEhB,UAAU,EAAE,CAAC,oBAAoB,KAAK,KAAK,QAAQ,MAAM,QAAQ,EAAE,CAAC,CAAC;QACrE,OAAO,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF,CAAC"}

package/dist/tools/specialized/fix-bug.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { UnifiedTool } from '../registry.js';
+export declare const fixBugTool: UnifiedTool;
+//# sourceMappingURL=fix-bug.tool.d.ts.map

package/dist/tools/specialized/fix-bug.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-bug.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/specialized/fix-bug.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAW7C,eAAO,MAAM,UAAU,EAAE,WA+ExB,CAAC"}

package/dist/tools/specialized/fix-bug.tool.js

@@ -0,0 +1,107 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import { executeAI, parseFiles } from '../../ai/index.js';
+import { getEnhancedContextString } from '../../utils/projectContext.enhanced.js';
+const schema = z.object({
+    files: z.string().describe('Files with the bug (use @path/file.php syntax)'),
+    description: z.string().describe('Bug description - what happens vs what should happen'),
+    errorLog: z.string().optional().describe('Stack trace or error log'),
+    steps: z.string().optional().describe('Steps to reproduce'),
+});
+export const fixBugTool = {
+    name: 'fix-bug',
+    description: 'Bug analysis and fix - root cause analysis, fix proposal, prevention',
+    zodSchema: schema,
+    prompt: { description: 'Find and fix bugs in PHP/Laravel code' },
+    execute: async (args, onProgress) => {
+        const { files, description, errorLog, steps } = args;
+        if (!files?.toString().trim())
+            throw new Error('Files required. Use @path/file.php syntax.');
+        if (!description?.toString().trim())
+            throw new Error('Bug description required.');
+        const filesStr = String(files);
+        const prompt = `${getEnhancedContextString()}
+# Bug Fix Request
+
+## Problem
+${description}
+
+${steps ? `## Steps to Reproduce\n${steps}` : ''}
+${errorLog ? `## Error Log\n\`\`\`\n${errorLog}\n\`\`\`` : ''}
+
+## Files
+${filesStr}
+
+## Analysis Framework
+
+### 1. Root Cause Analysis
+- Identify exact line/method causing the bug
+- Explain WHY the bug occurs
+- Determine if it's a bug or edge case
+
+### 2. Impact Assessment
+- Does bug affect other parts of the system?
+- Is any data corrupted?
+- Priority: critical/high/medium/low
+
+### 3. Fix Proposal
+- Minimal change approach
+- Complete code to paste
+- Explanation of why it works
+
+### 4. Prevention
+- How to prevent similar bugs
+- Suggested unit test
+
+## Output Format
+
+### Root Cause
+**Location:** \`file.php:LINE\`
+**Cause:** [explanation]
+
+### Proposed Fix
+\`\`\`php
+// BEFORE (problematic)
+...
+
+// AFTER (fixed)
+...
+\`\`\`
+
+### Why This Works
+[explanation]
+
+### Suggested Test
+\`\`\`php
+public function test_bug_is_fixed(): void
+{
+    // test case
+}
+\`\`\`
+
+### Prevention Tips
+- [tip 1]
+- [tip 2]
+
+Begin analysis:`;
+        onProgress?.(`Analyzing bug in: ${filesStr}`);
+        return executeAI({ prompt, agent: 'plan', files: parseFiles(filesStr), onProgress });
+    },
+};
+//# sourceMappingURL=fix-bug.tool.js.map

package/dist/tools/specialized/fix-bug.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-bug.tool.js","sourceRoot":"","sources":["../../../src/tools/specialized/fix-bug.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAElF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACxF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,sEAAsE;IACnF,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE;IAChE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC7F,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAElF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,GAAG,wBAAwB,EAAE;;;;EAI9C,WAAW;;EAEX,KAAK,CAAC,CAAC,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;EAC9C,QAAQ,CAAC,CAAC,CAAC,yBAAyB,QAAQ,UAAU,CAAC,CAAC,CAAC,EAAE;;;EAG3D,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAqDM,CAAC;QAEb,UAAU,EAAE,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QAC9C,OAAO,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACvF,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+export { codeReviewTool } from './code-review.tool.js';
+export { writeTestsTool } from './write-tests.tool.js';
+export { explainCodeTool } from './explain-code.tool.js';
+export { fixBugTool } from './fix-bug.tool.js';
+export { refactorTool } from './refactor.tool.js';
+export { autoFixTool } from './auto-fix.tool.js';
+export { autoFixAgentTool } from './auto-fix-agent.tool.js';
+export { analyzeDepsTool } from './analyze-deps.tool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/specialized/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/specialized/index.js

@@ -0,0 +1,26 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+export { codeReviewTool } from './code-review.tool.js';
+export { writeTestsTool } from './write-tests.tool.js';
+export { explainCodeTool } from './explain-code.tool.js';
+export { fixBugTool } from './fix-bug.tool.js';
+export { refactorTool } from './refactor.tool.js';
+export { autoFixTool } from './auto-fix.tool.js';
+export { autoFixAgentTool } from './auto-fix-agent.tool.js';
+export { analyzeDepsTool } from './analyze-deps.tool.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/specialized/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/specialized/refactor.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { UnifiedTool } from '../registry.js';
+export declare const refactorTool: UnifiedTool;
+//# sourceMappingURL=refactor.tool.d.ts.map

package/dist/tools/specialized/refactor.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/specialized/refactor.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA+B7C,eAAO,MAAM,YAAY,EAAE,WAsE1B,CAAC"}

package/dist/tools/specialized/refactor.tool.js

@@ -0,0 +1,115 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import { executeAI, parseFiles } from '../../ai/index.js';
+import { getEnhancedContextString } from '../../utils/projectContext.enhanced.js';
+const GOALS = {
+    readability: `**READABILITY** - Better naming, shorter methods (max 15-20 lines), early returns, clear conditions`,
+    performance: `**PERFORMANCE** - Optimize DB queries (eager loading, chunking), caching, reduce N+1, lazy collections`,
+    solid: `**SOLID PRINCIPLES**
+- Single Responsibility: one class = one responsibility
+- Open/Closed: open for extension, closed for modification
+- Liskov Substitution: subclasses must be interchangeable
+- Interface Segregation: small, specific interfaces
+- Dependency Inversion: depend on abstractions`,
+    'laravel-patterns': `**LARAVEL PATTERNS** - Service classes, Repository pattern, Form Requests, Resources, Events/Listeners, Jobs, Policies`,
+    dry: `**DRY** - Identify duplication, extract to methods/traits/services, use inheritance wisely, create helpers`,
+};
+const SCOPES = {
+    minimal: `**MINIMAL** - Only obvious fixes, keep public interface, safest changes`,
+    moderate: `**MODERATE** - Structural changes allowed, can add classes/methods, maintain backward compatibility`,
+    aggressive: `**AGGRESSIVE** - Full restructuring allowed, interfaces can change, code quality over compatibility`,
+};
+const schema = z.object({
+    files: z.string().describe('Files to refactor (use @path/file.php syntax)'),
+    goal: z
+        .enum(['readability', 'performance', 'solid', 'laravel-patterns', 'dry'])
+        .default('readability'),
+    scope: z.enum(['minimal', 'moderate', 'aggressive']).default('moderate'),
+});
+export const refactorTool = {
+    name: 'refactor',
+    description: 'Code refactoring - readability, performance, SOLID, Laravel patterns, DRY',
+    zodSchema: schema,
+    prompt: { description: 'Refactor PHP/Laravel code' },
+    execute: async (args, onProgress) => {
+        const { files, goal = 'readability', scope = 'moderate' } = args;
+        if (!files?.toString().trim())
+            throw new Error('Files required. Use @path/file.php syntax.');
+        const filesStr = String(files);
+        const prompt = `${getEnhancedContextString()}
+# Refactoring Request
+
+${GOALS[goal]}
+${SCOPES[scope]}
+
+## Files
+${filesStr}
+
+## Output Format
+
+### Analysis
+**Current State:** [what's wrong]
+**Code smells:** [list]
+**Proposed Changes:** [list]
+
+### Refactored Code
+
+#### \`path/file.php\`
+
+**Change 1: [description]**
+\`\`\`php
+// BEFORE
+[old code]
+
+// AFTER
+[new code]
+\`\`\`
+**Rationale:** Why this change is better
+
+---
+
+### New Files (if any)
+\`\`\`php
+<?php
+// app/Services/NewService.php
+namespace App\\Services;
+
+class NewService
+{
+    // ...
+}
+\`\`\`
+
+### Migration Guide
+1. [step 1]
+2. [step 2]
+
+### Summary
+| Metric | Before | After |
+|--------|--------|-------|
+| Lines of code | X | Y |
+| Complexity | X | Y |
+| Classes | X | Y |
+
+Begin refactoring:`;
+        onProgress?.(`Refactoring (${goal}, ${scope}): ${filesStr}`);
+        return executeAI({ prompt, agent: 'plan', files: parseFiles(filesStr), onProgress });
+    },
+};
+//# sourceMappingURL=refactor.tool.js.map

package/dist/tools/specialized/refactor.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor.tool.js","sourceRoot":"","sources":["../../../src/tools/specialized/refactor.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAElF,MAAM,KAAK,GAA2B;IACpC,WAAW,EAAE,qGAAqG;IAClH,WAAW,EAAE,wGAAwG;IACrH,KAAK,EAAE;;;;;+CAKsC;IAC7C,kBAAkB,EAAE,wHAAwH;IAC5I,GAAG,EAAE,4GAA4G;CAClH,CAAC;AAEF,MAAM,MAAM,GAA2B;IACrC,OAAO,EAAE,yEAAyE;IAClF,QAAQ,EAAE,qGAAqG;IAC/G,UAAU,EAAE,qGAAqG;CAClH,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC3E,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;SACxE,OAAO,CAAC,aAAa,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,2EAA2E;IACxF,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE;IACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,aAAa,EAAE,KAAK,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAE7F,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,GAAG,wBAAwB,EAAE;;;EAG9C,KAAK,CAAC,IAAc,CAAC;EACrB,MAAM,CAAC,KAAe,CAAC;;;EAGvB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAgDS,CAAC;QAEhB,UAAU,EAAE,CAAC,gBAAgB,IAAI,KAAK,KAAK,MAAM,QAAQ,EAAE,CAAC,CAAC;QAC7D,OAAO,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACvF,CAAC;CACF,CAAC"}

package/dist/tools/specialized/write-tests.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { UnifiedTool } from '../registry.js';
+export declare const writeTestsTool: UnifiedTool;
+//# sourceMappingURL=write-tests.tool.d.ts.map

package/dist/tools/specialized/write-tests.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tests.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/specialized/write-tests.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsB7C,eAAO,MAAM,cAAc,EAAE,WA+E5B,CAAC"}

package/dist/tools/specialized/write-tests.tool.js

@@ -0,0 +1,115 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import { executeAI, parseFiles } from '../../ai/index.js';
+import { getEnhancedContextString } from '../../utils/projectContext.enhanced.js';
+const TYPE_PROMPTS = {
+    unit: `**UNIT TESTS** - Test individual methods in isolation, mock dependencies, use PHPUnit assertions. Location: tests/Unit/`,
+    feature: `**FEATURE TESTS** - Test complete flows via HTTP, use actingAs() for auth, test response status/JSON. Location: tests/Feature/`,
+    both: `**UNIT + FEATURE** - Generate both types where appropriate.`,
+};
+const COVERAGE_PROMPTS = {
+    'happy-path': `**HAPPY PATH** - Test main success scenarios, basic input validation`,
+    'edge-cases': `**EDGE CASES** - Empty data, null values, boundary conditions, invalid types, missing relations`,
+    full: `**FULL COVERAGE** - Happy path + edge cases + error handling + authorization + DB transactions + events/jobs`,
+};
+const schema = z.object({
+    files: z.string().describe('Files to test (use @path/file.php syntax)'),
+    type: z.enum(['unit', 'feature', 'both']).default('unit'),
+    coverage: z.enum(['happy-path', 'edge-cases', 'full']).default('happy-path'),
+});
+export const writeTestsTool = {
+    name: 'write-tests',
+    description: 'Generate PHPUnit tests for Laravel code (unit and feature tests)',
+    zodSchema: schema,
+    prompt: { description: 'Generate tests for PHP/Laravel files' },
+    execute: async (args, onProgress) => {
+        const { files, type = 'unit', coverage = 'happy-path' } = args;
+        if (!files?.toString().trim())
+            throw new Error('Files required. Use @path/file.php syntax.');
+        const filesStr = String(files);
+        const prompt = `${getEnhancedContextString()}
+# Generate Tests Request
+
+${TYPE_PROMPTS[type]}
+${COVERAGE_PROMPTS[coverage]}
+
+## Files to Test
+${filesStr}
+
+## Laravel Test Patterns
+
+\`\`\`php
+// Unit Test Pattern
+class ExampleServiceTest extends TestCase
+{
+    private ExampleService $service;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->service = new ExampleService(
+            $this->createMock(DependencyInterface::class)
+        );
+    }
+
+    public function test_method_does_something(): void
+    {
+        // Arrange
+        $input = [...];
+
+        // Act
+        $result = $this->service->method($input);
+
+        // Assert
+        $this->assertEquals($expected, $result);
+    }
+}
+
+// Feature Test Pattern
+class ExampleControllerTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_endpoint_returns_success(): void
+    {
+        $user = User::factory()->create();
+
+        $response = $this->actingAs($user)
+            ->postJson('/api/endpoint', ['data' => 'value']);
+
+        $response->assertStatus(200)
+            ->assertJsonStructure(['id', 'name']);
+    }
+}
+\`\`\`
+
+## Requirements
+- Complete, runnable test files
+- Proper namespace and imports
+- setUp() method if needed
+- Descriptive test names (test_it_does_something)
+- AAA pattern (Arrange, Act, Assert)
+- Data providers for multiple cases where useful
+
+Begin generating tests:`;
+        onProgress?.(`Generating tests (${type}, ${coverage}): ${filesStr}`);
+        return executeAI({ prompt, agent: 'plan', files: parseFiles(filesStr), onProgress });
+    },
+};
+//# sourceMappingURL=write-tests.tool.js.map

package/dist/tools/specialized/write-tests.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tests.tool.js","sourceRoot":"","sources":["../../../src/tools/specialized/write-tests.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAElF,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,yHAAyH;IAC/H,OAAO,EAAE,gIAAgI;IACzI,IAAI,EAAE,6DAA6D;CACpE,CAAC;AAEF,MAAM,gBAAgB,GAA2B;IAC/C,YAAY,EAAE,sEAAsE;IACpF,YAAY,EAAE,iGAAiG;IAC/G,IAAI,EAAE,8GAA8G;CACrH,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;CAC7E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,kEAAkE;IAC/E,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE,EAAE,WAAW,EAAE,sCAAsC,EAAE;IAC/D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,QAAQ,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;QAC/D,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAE7F,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,GAAG,wBAAwB,EAAE;;;EAG9C,YAAY,CAAC,IAAc,CAAC;EAC5B,gBAAgB,CAAC,QAAkB,CAAC;;;EAGpC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAyDc,CAAC;QAErB,UAAU,EAAE,CAAC,qBAAqB,IAAI,KAAK,QAAQ,MAAM,QAAQ,EAAE,CAAC,CAAC;QACrE,OAAO,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACvF,CAAC;CACF,CAAC"}

package/dist/tools/system/ai-config.tool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can distributed under the terms of the GNU
+ * General Public License as published by the Free Software Foundation.
+ */
+import { UnifiedTool } from '../registry.js';
+/**
+ * AI Config Tool
+ */
+export declare const aiConfigTool: UnifiedTool;
+//# sourceMappingURL=ai-config.tool.d.ts.map

package/dist/tools/system/ai-config.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/system/ai-config.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2N7C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,WAkD1B,CAAC"}