@grunnverk/kilde 0.1.0

package/src/mcp/server.ts

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+/**
+ * Kilde MCP Server
+ *
+ * Exposes kilde commands via Model Context Protocol
+ */
+
+/* eslint-disable import/extensions */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { executeTool } from './tools.js';
+import { getResources, readResource } from './resources.js';
+import { getPrompts, getPrompt } from './prompts/index.js';
+import { getLogger } from '../logging.js';
+import winston from 'winston';
+/* eslint-enable import/extensions */
+
+async function main() {
+    // Mark that we're running as MCP server
+    process.env.KILDE_MCP_SERVER = 'true';
+
+    // Remove console transports from logger
+    const logger = getLogger();
+    const transports = [...((logger as any).transports || [])];
+    for (const transport of transports) {
+        if (transport instanceof winston.transports.Console) {
+            logger.remove(transport);
+        }
+    }
+
+    // Initialize MCP server
+    const server = new McpServer(
+        {
+            name: 'kilde',
+            version: '0.1.0',
+        },
+        {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        }
+    );
+
+    // ========================================================================
+    // Tools Handlers
+    // ========================================================================
+
+    // Register kilde_commit
+    server.tool(
+        'kilde_commit',
+        'Generate AI-powered commit message and optionally create the commit',
+        {
+            add: z.boolean().optional(),
+            cached: z.boolean().optional(),
+            sendit: z.boolean().optional(),
+            interactive: z.boolean().optional(),
+            amend: z.boolean().optional(),
+            context: z.string().optional(),
+            contextFiles: z.array(z.string()).optional(),
+            dryRun: z.boolean().optional(),
+            verbose: z.boolean().optional(),
+            debug: z.boolean().optional(),
+        },
+        async (args) => {
+            const context = {
+                workingDirectory: process.cwd(),
+                config: undefined,
+                logger: getLogger(),
+            };
+
+            try {
+                return await executeTool('kilde_commit', args, context);
+            } catch (error: any) {
+                logger.error(`Tool kilde_commit failed: ${error.message}`);
+                return {
+                    content: [{
+                        type: 'text' as const,
+                        text: `Error: ${error.message}`,
+                    }],
+                    isError: true,
+                };
+            }
+        }
+    );
+
+    // Register kilde_release
+    server.tool(
+        'kilde_release',
+        'Generate release notes from git commit history (tag-based)',
+        {
+            fromTag: z.string().optional(),
+            toTag: z.string().optional(),
+            version: z.string().optional(),
+            output: z.string().optional(),
+            interactive: z.boolean().optional(),
+            focus: z.string().optional(),
+            context: z.string().optional(),
+            contextFiles: z.array(z.string()).optional(),
+            dryRun: z.boolean().optional(),
+            verbose: z.boolean().optional(),
+            debug: z.boolean().optional(),
+        },
+        async (args) => {
+            const context = {
+                workingDirectory: process.cwd(),
+                config: undefined,
+                logger: getLogger(),
+            };
+
+            try {
+                return await executeTool('kilde_release', args, context);
+            } catch (error: any) {
+                logger.error(`Tool kilde_release failed: ${error.message}`);
+                return {
+                    content: [{
+                        type: 'text' as const,
+                        text: `Error: ${error.message}`,
+                    }],
+                    isError: true,
+                };
+            }
+        }
+    );
+
+    // ========================================================================
+    // Resources Handlers
+    // ========================================================================
+
+    const resources = getResources();
+    for (const resource of resources) {
+        server.resource(
+            resource.name,
+            resource.uri,
+            {
+                description: resource.description || '',
+            },
+            async () => {
+                const data = await readResource(resource.uri);
+                return data;
+            }
+        );
+    }
+
+    // ========================================================================
+    // Prompts Handlers
+    // ========================================================================
+
+    const prompts = getPrompts();
+    for (const prompt of prompts) {
+        // Convert prompt arguments to zod schema
+        const promptArgs: Record<string, z.ZodTypeAny> = {};
+        if (prompt.arguments) {
+            for (const arg of prompt.arguments) {
+                promptArgs[arg.name] = arg.required ? z.string() : z.string().optional();
+            }
+        }
+
+        server.prompt(
+            prompt.name,
+            prompt.description,
+            promptArgs,
+            async (args, _extra) => {
+                // Convert args to Record<string, string> for getPrompt
+                const argsRecord: Record<string, string> = {};
+                for (const [key, value] of Object.entries(args)) {
+                    if (typeof value === 'string') {
+                        argsRecord[key] = value;
+                    }
+                }
+                const result = await getPrompt(prompt.name, argsRecord);
+                return result;
+            }
+        );
+    }
+
+    // ========================================================================
+    // Server Lifecycle
+    // ========================================================================
+
+    // Start the server with stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+
+    logger.info('Kilde MCP server started');
+}
+
+// Run the server
+main().catch((error) => {
+    const logger = getLogger();
+    logger.error(`MCP server failed: ${error.message}`);
+    process.exit(1);
+});

package/src/mcp/tools.ts

@@ -0,0 +1,219 @@
+/**
+ * MCP Tools for Kilde
+ *
+ * Exposes commit and release commands as MCP tools
+ */
+
+import * as CommandsGit from '@grunnverk/commands-git';
+import * as ReleaseCommand from '../commands/release';
+import { Config } from '@grunnverk/core';
+import { getLogger } from '../logging';
+import { createStorage } from '@grunnverk/shared';
+import { DEFAULT_CONFIG_DIR } from '../constants';
+
+export interface ToolContext {
+    workingDirectory: string;
+    config: Config | undefined;
+    logger: any;
+}
+
+/**
+ * Execute a tool with the given name and arguments
+ */
+export async function executeTool(
+    name: string,
+    args: Record<string, any>,
+    context: ToolContext
+): Promise<{ content: Array<{ type: 'text'; text: string }> }> {
+    const logger = context.logger || getLogger();
+    const storage = createStorage();
+
+    // Build config from args with required fields
+    const config: Config = {
+        configDirectory: DEFAULT_CONFIG_DIR,
+        discoveredConfigDirs: [],
+        resolvedConfigDirs: [],
+        ...(context.config || {}),
+        dryRun: args.dryRun ?? false,
+        verbose: args.verbose ?? false,
+        debug: args.debug ?? false,
+    } as Config;
+
+    try {
+        if (name === 'kilde_commit') {
+            // Build commit config
+            config.commit = {
+                add: args.add ?? false,
+                cached: args.cached ?? false,
+                sendit: args.sendit ?? false,
+                interactive: args.interactive ?? false,
+                amend: args.amend ?? false,
+                context: args.context,
+                contextFiles: args.contextFiles,
+            };
+
+            // Execute commit command
+            const summary = await CommandsGit.commit(config);
+
+            return {
+                content: [
+                    {
+                        type: 'text' as const,
+                        text: summary
+                    }
+                ]
+            };
+
+        } else if (name === 'kilde_release') {
+            // Build release config
+            config.release = {
+                from: args.fromTag,
+                to: args.toTag ?? 'HEAD',
+                interactive: args.interactive ?? false,
+                focus: args.focus,
+                context: args.context,
+                contextFiles: args.contextFiles,
+            };
+
+            // Add non-standard fields
+            if (args.version) (config.release as any).version = args.version;
+            if (args.output) (config.release as any).output = args.output;
+
+            // Execute release command
+            const releaseSummary = await ReleaseCommand.execute(config);
+
+            // If output file specified, write the result
+            if (args.output) {
+                const releaseNotesContent = `# ${releaseSummary.title}\n\n${releaseSummary.body}`;
+                await storage.writeFile(args.output, releaseNotesContent, 'utf-8');
+            }
+
+            return {
+                content: [
+                    {
+                        type: 'text' as const,
+                        text: `# ${releaseSummary.title}\n\n${releaseSummary.body}`
+                    }
+                ]
+            };
+
+        } else {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+    } catch (error: any) {
+        logger.error(`Tool execution failed: ${error.message}`);
+        throw error;
+    }
+}
+
+/**
+ * Get list of available tools
+ */
+export function getTools() {
+    return [
+        {
+            name: 'kilde_commit',
+            description: 'Generate AI-powered commit message and optionally create the commit',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    add: {
+                        type: 'boolean',
+                        description: 'Stage all changes before committing',
+                    },
+                    cached: {
+                        type: 'boolean',
+                        description: 'Only use staged changes',
+                    },
+                    sendit: {
+                        type: 'boolean',
+                        description: 'Automatically commit with generated message',
+                    },
+                    interactive: {
+                        type: 'boolean',
+                        description: 'Interactive mode for reviewing message',
+                    },
+                    amend: {
+                        type: 'boolean',
+                        description: 'Amend the previous commit',
+                    },
+                    context: {
+                        type: 'string',
+                        description: 'Additional context for commit message generation',
+                    },
+                    contextFiles: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Context files to include',
+                    },
+                    dryRun: {
+                        type: 'boolean',
+                        description: 'Preview without making changes',
+                    },
+                    verbose: {
+                        type: 'boolean',
+                        description: 'Enable verbose logging',
+                    },
+                    debug: {
+                        type: 'boolean',
+                        description: 'Enable debug logging',
+                    },
+                },
+            },
+        },
+        {
+            name: 'kilde_release',
+            description: 'Generate release notes from git commit history (tag-based)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    fromTag: {
+                        type: 'string',
+                        description: 'Start tag for release notes (default: last tag)',
+                    },
+                    toTag: {
+                        type: 'string',
+                        description: 'End tag for release notes (default: HEAD)',
+                    },
+                    version: {
+                        type: 'string',
+                        description: 'Version number for the release',
+                    },
+                    output: {
+                        type: 'string',
+                        description: 'Output file path for release notes',
+                    },
+                    interactive: {
+                        type: 'boolean',
+                        description: 'Interactive mode for reviewing notes',
+                    },
+                    focus: {
+                        type: 'string',
+                        description: 'Focus area for release notes (e.g., "breaking changes")',
+                    },
+                    context: {
+                        type: 'string',
+                        description: 'Additional context for release notes generation',
+                    },
+                    contextFiles: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Context files to include',
+                    },
+                    dryRun: {
+                        type: 'boolean',
+                        description: 'Preview without saving to file',
+                    },
+                    verbose: {
+                        type: 'boolean',
+                        description: 'Enable verbose logging',
+                    },
+                    debug: {
+                        type: 'boolean',
+                        description: 'Enable debug logging',
+                    },
+                },
+            },
+        },
+    ];
+}

package/src/types.ts

@@ -0,0 +1,131 @@
+import { z } from "zod";
+
+/**
+ * Configuration schema for Kilde
+ * Simplified for commit and release commands only
+ */
+export const ConfigSchema = z.object({
+    dryRun: z.boolean().optional(),
+    verbose: z.boolean().optional(),
+    debug: z.boolean().optional(),
+    model: z.string().optional(),
+    openaiReasoning: z.enum(['low', 'medium', 'high']).optional(),
+    openaiMaxOutputTokens: z.number().optional(),
+    outputDirectory: z.string().optional(),
+    configDirectory: z.string().optional(),
+    discoveredConfigDirs: z.array(z.string()).optional(),
+    resolvedConfigDirs: z.array(z.string()).optional(),
+    excludedPatterns: z.array(z.string()).optional(),
+    contextDirectories: z.array(z.string()).optional(),
+    overrides: z.boolean().optional(),
+    stopContext: z.any().optional(),
+
+    // Commit configuration
+    commit: z.object({
+        add: z.boolean().optional(),
+        cached: z.boolean().optional(),
+        sendit: z.boolean().optional(),
+        interactive: z.boolean().optional(),
+        amend: z.boolean().optional(),
+        push: z.union([z.boolean(), z.string()]).optional(),
+        messageLimit: z.number().optional(),
+        context: z.string().optional(),
+        contextFiles: z.array(z.string()).optional(),
+        direction: z.string().optional(),
+        skipFileCheck: z.boolean().optional(),
+        maxDiffBytes: z.number().optional(),
+        model: z.string().optional(),
+        openaiReasoning: z.enum(['low', 'medium', 'high']).optional(),
+        openaiMaxOutputTokens: z.number().optional(),
+        maxAgenticIterations: z.number().optional(),
+        allowCommitSplitting: z.boolean().optional(),
+        autoSplit: z.boolean().optional(),
+        toolTimeout: z.number().optional(),
+        selfReflection: z.boolean().optional(),
+    }).optional(),
+
+    // Release configuration (pure git only)
+    release: z.object({
+        from: z.string().optional(),
+        to: z.string().optional(),
+        fromTag: z.string().optional(),
+        toTag: z.string().optional(),
+        version: z.string().optional(),
+        output: z.string().optional(),
+        messageLimit: z.number().optional(),
+        context: z.string().optional(),
+        contextFiles: z.array(z.string()).optional(),
+        interactive: z.boolean().optional(),
+        focus: z.string().optional(),
+        maxDiffBytes: z.number().optional(),
+        model: z.string().optional(),
+        openaiReasoning: z.enum(['low', 'medium', 'high']).optional(),
+        openaiMaxOutputTokens: z.number().optional(),
+        maxAgenticIterations: z.number().optional(),
+        selfReflection: z.boolean().optional(),
+    }).optional(),
+});
+
+export const SecureConfigSchema = z.object({
+    openaiApiKey: z.string().optional(),
+});
+
+export type Config = z.infer<typeof ConfigSchema>;
+export type SecureConfig = z.infer<typeof SecureConfigSchema>;
+
+/**
+ * Commit configuration type
+ */
+export type CommitConfig = {
+    add?: boolean;
+    cached?: boolean;
+    sendit?: boolean;
+    interactive?: boolean;
+    amend?: boolean;
+    push?: string | boolean;
+    messageLimit?: number;
+    context?: string;
+    contextFiles?: string[];
+    direction?: string;
+    skipFileCheck?: boolean;
+    maxDiffBytes?: number;
+    model?: string;
+    openaiReasoning?: 'low' | 'medium' | 'high';
+    openaiMaxOutputTokens?: number;
+    maxAgenticIterations?: number;
+    allowCommitSplitting?: boolean;
+    autoSplit?: boolean;
+    toolTimeout?: number;
+    selfReflection?: boolean;
+}
+
+/**
+ * Release configuration type (pure git only)
+ */
+export type ReleaseConfig = {
+    from?: string;
+    to?: string;
+    fromTag?: string;
+    toTag?: string;
+    version?: string;
+    output?: string;
+    context?: string;
+    contextFiles?: string[];
+    interactive?: boolean;
+    focus?: string;
+    messageLimit?: number;
+    maxDiffBytes?: number;
+    model?: string;
+    openaiReasoning?: 'low' | 'medium' | 'high';
+    openaiMaxOutputTokens?: number;
+    maxAgenticIterations?: number;
+    selfReflection?: boolean;
+}
+
+/**
+ * Release summary returned by AI
+ */
+export type ReleaseSummary = {
+    title: string;
+    body: string;
+}