@promptwheel/mcp 0.6.0

package/dist/tools/git.js

@@ -0,0 +1,98 @@
+/**
+ * Git operations tool: git_setup
+ */
+import { z } from 'zod';
+import { repos } from '@promptwheel/core';
+import { execFileSync } from 'node:child_process';
+/**
+ * Validates a git branch name to prevent command injection.
+ * Only allows alphanumeric characters, hyphens, underscores, forward slashes, and dots.
+ * Must not start with a hyphen (to prevent option injection).
+ */
+function validateBranchName(branch) {
+    // Git branch name rules:
+    // - Cannot start with a hyphen (prevents option injection like --delete)
+    // - Only alphanumeric, hyphens, underscores, forward slashes, and dots allowed
+    // - Cannot contain shell metacharacters like ; | & $ ` etc.
+    const validPattern = /^[a-zA-Z0-9][a-zA-Z0-9\-_./]*$/;
+    return validPattern.test(branch);
+}
+export function registerGitTools(server, getState) {
+    server.tool('promptwheel_git_setup', 'Create/checkout a branch for the current ticket. Returns branch name. Use after completing a ticket to prepare for PR creation.', {
+        ticketId: z.string().optional().describe('The ticket ID to create a branch for.'),
+        ticket_id: z.string().optional().describe('Alias for ticketId.'),
+        baseBranch: z.string().optional().describe('Base branch to branch from (default: main).'),
+        base_branch: z.string().optional().describe('Alias for baseBranch.'),
+    }, async (raw) => {
+        const params = {
+            ticketId: (raw.ticketId ?? raw.ticket_id),
+            baseBranch: raw.baseBranch ?? raw.base_branch,
+        };
+        const state = getState();
+        state.requireActive(); // ensure session is active
+        const ticket = await repos.tickets.getById(state.db, params.ticketId);
+        if (!ticket) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: 'Ticket not found.' }) }],
+                isError: true,
+            };
+        }
+        const baseBranch = params.baseBranch ?? 'main';
+        // Validate baseBranch to prevent command injection
+        if (!validateBranchName(baseBranch)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Invalid base branch name: "${baseBranch}". Branch names must start with an alphanumeric character and contain only alphanumeric characters, hyphens, underscores, forward slashes, and dots.`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        // Create branch name from ticket
+        const slug = ticket.title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 50);
+        const branchName = `promptwheel/${ticket.id}/${slug}`;
+        const cwd = state.project.rootPath;
+        try {
+            // Check if branch exists
+            try {
+                execFileSync('git', ['rev-parse', '--verify', branchName], { cwd, stdio: 'pipe' });
+                // Branch exists, just checkout
+                execFileSync('git', ['checkout', branchName], { cwd, stdio: 'pipe' });
+            }
+            catch {
+                // Branch doesn't exist, create from base
+                execFileSync('git', ['checkout', '-b', branchName, baseBranch], { cwd, stdio: 'pipe' });
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            branchName,
+                            baseBranch,
+                            ticketId: ticket.id,
+                            message: `Branch ${branchName} ready. Make your changes, then commit and push.`,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Git operation failed: ${e.message}`,
+                            branchName,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/tools/git.js.map

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

package/dist/tools/intelligence.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Intelligence tools: validate_ticket, audit_tickets, ticket_stats, heal_blocked
+ *
+ * Expose intelligence-layer functionality that was previously only
+ * available as ad-hoc scripts or internal-only logic.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SessionManager } from '../state.js';
+export declare function registerIntelligenceTools(server: McpServer, getState: () => SessionManager): void;
+//# sourceMappingURL=intelligence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/tools/intelligence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,QAye1F"}

package/dist/tools/intelligence.js

@@ -0,0 +1,432 @@
+/**
+ * Intelligence tools: validate_ticket, audit_tickets, ticket_stats, heal_blocked
+ *
+ * Expose intelligence-layer functionality that was previously only
+ * available as ad-hoc scripts or internal-only logic.
+ */
+import { z } from 'zod';
+import { repos } from '@promptwheel/core';
+import { deriveScopePolicy, isFileAllowed, } from '../scope-policy.js';
+import { checkSpindle } from '../spindle.js';
+export function registerIntelligenceTools(server, getState) {
+    // ── promptwheel_validate_ticket ────────────────────────────────────────────
+    server.tool('promptwheel_validate_ticket', 'Validates a ticket against quality gates without executing it. Answers "why can\'t this ticket run?"', {
+        ticket_id: z.string().describe('The ticket ID to validate.'),
+    }, async (params) => {
+        const state = getState();
+        try {
+            const ticket = await repos.tickets.getById(state.db, params.ticket_id);
+            if (!ticket) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ error: `Ticket ${params.ticket_id} not found` }),
+                        }],
+                    isError: true,
+                };
+            }
+            const reasons = [];
+            const suggestions = [];
+            // 1. Check required fields
+            if (!ticket.title) {
+                reasons.push('Missing title');
+            }
+            if (!ticket.description) {
+                reasons.push('Missing description');
+                suggestions.push('Add a description explaining what changes to make');
+            }
+            if (ticket.allowedPaths.length === 0) {
+                suggestions.push('Consider adding allowed_paths to scope the changes');
+            }
+            if (ticket.verificationCommands.length === 0) {
+                reasons.push('No verification commands');
+                suggestions.push('Add verification commands (e.g., npm test, npx vitest run)');
+            }
+            // 2. Check status
+            if (ticket.status === 'done') {
+                reasons.push('Ticket already completed');
+            }
+            else if (ticket.status === 'aborted') {
+                reasons.push('Ticket was aborted');
+                suggestions.push('Create a new ticket if this work is still needed');
+            }
+            else if (ticket.status === 'blocked') {
+                reasons.push('Ticket is currently blocked');
+                suggestions.push('Use promptwheel_heal_blocked to diagnose and recover');
+            }
+            else if (ticket.status === 'in_progress') {
+                reasons.push('Ticket is already in progress');
+            }
+            // 3. Check scope policy
+            const run = state.run.current;
+            if (run) {
+                const policy = deriveScopePolicy({
+                    allowedPaths: ticket.allowedPaths,
+                    category: ticket.category ?? 'refactor',
+                    maxLinesPerTicket: run.max_lines_per_ticket,
+                });
+                // Check if allowed_paths overlap with denied paths
+                for (const p of ticket.allowedPaths) {
+                    if (!isFileAllowed(p, policy)) {
+                        reasons.push(`Allowed path "${p}" conflicts with denied policy`);
+                    }
+                }
+            }
+            // 4. Check retry exhaustion
+            if (ticket.retryCount >= ticket.maxRetries) {
+                reasons.push(`Retry limit exhausted (${ticket.retryCount}/${ticket.maxRetries})`);
+                suggestions.push('Increase maxRetries or simplify the ticket scope');
+            }
+            const runnable = reasons.length === 0;
+            const gateStatus = runnable ? 'PASS' : 'FAIL';
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            ticket_id: params.ticket_id,
+                            title: ticket.title,
+                            status: ticket.status,
+                            runnable,
+                            gate_status: gateStatus,
+                            reasons,
+                            suggestions,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: e.message }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // ── promptwheel_audit_tickets ──────────────────────────────────────────────
+    server.tool('promptwheel_audit_tickets', 'Analyzes ticket quality across the current session/project.', {
+        status_filter: z.string().optional().describe('Filter by status (e.g., "ready", "blocked", "done").'),
+    }, async (params) => {
+        const state = getState();
+        try {
+            const run = state.run.current;
+            const projectId = run?.project_id ?? state.project.id;
+            // Get all tickets, optionally filtered by status
+            const statusOpt = params.status_filter
+                ? { status: params.status_filter }
+                : undefined;
+            const allTickets = await repos.tickets.listByProject(state.db, projectId, { ...statusOpt, limit: 500 });
+            // Aggregate by status
+            const byStatus = {};
+            for (const t of allTickets) {
+                byStatus[t.status] = (byStatus[t.status] ?? 0) + 1;
+            }
+            // Aggregate by category
+            const byCategory = {};
+            for (const t of allTickets) {
+                const cat = t.category ?? 'uncategorized';
+                byCategory[cat] = (byCategory[cat] ?? 0) + 1;
+            }
+            // Detect quality issues
+            const qualityIssues = [];
+            const noDescription = allTickets.filter(t => !t.description);
+            if (noDescription.length > 0) {
+                qualityIssues.push(`${noDescription.length} ticket(s) missing description`);
+            }
+            const noVerification = allTickets.filter(t => t.verificationCommands.length === 0);
+            if (noVerification.length > 0) {
+                qualityIssues.push(`${noVerification.length} ticket(s) missing verification commands`);
+            }
+            const noScope = allTickets.filter(t => t.allowedPaths.length === 0);
+            if (noScope.length > 0) {
+                qualityIssues.push(`${noScope.length} ticket(s) with no allowed_paths (unrestricted scope)`);
+            }
+            const retryExhausted = allTickets.filter(t => t.retryCount >= t.maxRetries && t.status !== 'done');
+            if (retryExhausted.length > 0) {
+                qualityIssues.push(`${retryExhausted.length} ticket(s) exhausted retries without completing`);
+            }
+            const blocked = allTickets.filter(t => t.status === 'blocked');
+            if (blocked.length > 3) {
+                qualityIssues.push(`High blocked count: ${blocked.length} tickets blocked`);
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            total: allTickets.length,
+                            by_status: byStatus,
+                            by_category: byCategory,
+                            quality_issues: qualityIssues,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: e.message }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // ── promptwheel_ticket_stats ───────────────────────────────────────────────
+    server.tool('promptwheel_ticket_stats', 'Throughput metrics — completions by type, by day, success rates.', {
+        days: z.number().optional().describe('Number of days to look back (default: 7).'),
+    }, async (params) => {
+        const state = getState();
+        try {
+            const run = state.run.current;
+            const projectId = run?.project_id ?? state.project.id;
+            const lookbackDays = params.days ?? 7;
+            const cutoff = new Date(Date.now() - lookbackDays * 24 * 60 * 60 * 1000);
+            // Get all tickets
+            const allTickets = await repos.tickets.listByProject(state.db, projectId, { limit: 1000 });
+            // Get runs for duration/success tracking
+            const allRuns = await repos.runs.listByProject(state.db, projectId, { limit: 1000 });
+            // Filter to recent window
+            const recentTickets = allTickets.filter(t => t.updatedAt >= cutoff);
+            const recentRuns = allRuns.filter(r => r.createdAt >= cutoff);
+            // Completions by day
+            const completionsByDay = {};
+            const completedTickets = recentTickets.filter(t => t.status === 'done');
+            for (const t of completedTickets) {
+                const day = t.updatedAt.toISOString().slice(0, 10);
+                completionsByDay[day] = (completionsByDay[day] ?? 0) + 1;
+            }
+            // By category
+            const byCategory = {};
+            for (const t of completedTickets) {
+                const cat = t.category ?? 'uncategorized';
+                byCategory[cat] = (byCategory[cat] ?? 0) + 1;
+            }
+            // Success rate
+            const workerRuns = recentRuns.filter(r => r.type === 'worker');
+            const successRuns = workerRuns.filter(r => r.status === 'success');
+            const successRate = workerRuns.length > 0
+                ? Math.round((successRuns.length / workerRuns.length) * 100) / 100
+                : 0;
+            // Average duration
+            const durations = workerRuns
+                .filter(r => r.completedAt && r.startedAt)
+                .map(r => r.completedAt.getTime() - r.startedAt.getTime());
+            const avgDurationMs = durations.length > 0
+                ? Math.round(durations.reduce((a, b) => a + b, 0) / durations.length)
+                : 0;
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            lookback_days: lookbackDays,
+                            completions_by_day: completionsByDay,
+                            by_category: byCategory,
+                            total_completed: completedTickets.length,
+                            total_runs: workerRuns.length,
+                            success_rate: successRate,
+                            avg_duration_ms: avgDurationMs,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: e.message }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // ── promptwheel_history ───────────────────────────────────────────────────
+    server.tool('promptwheel_history', 'View recent session runs with summary stats.', {
+        limit: z.number().optional().describe('Max number of runs to return (default: 10).'),
+    }, async (params) => {
+        const state = getState();
+        try {
+            const run = state.run.current;
+            const projectId = run?.project_id ?? state.project.id;
+            const limit = params.limit ?? 10;
+            const allRuns = await repos.runs.listByProject(state.db, projectId, { limit });
+            const runs = allRuns.map(r => ({
+                id: r.id,
+                type: r.type,
+                status: r.status,
+                ticketId: r.ticketId,
+                createdAt: r.createdAt.toISOString(),
+                startedAt: r.startedAt?.toISOString() ?? null,
+                completedAt: r.completedAt?.toISOString() ?? null,
+                durationMs: r.completedAt && r.startedAt
+                    ? r.completedAt.getTime() - r.startedAt.getTime()
+                    : null,
+            }));
+            // Summary stats
+            const total = runs.length;
+            const successful = runs.filter(r => r.status === 'success').length;
+            const failed = runs.filter(r => r.status === 'failure').length;
+            const successRate = total > 0 ? Math.round((successful / total) * 100) : 0;
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            total,
+                            successful,
+                            failed,
+                            success_rate_percent: successRate,
+                            runs,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: e.message }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // ── promptwheel_heal_blocked ───────────────────────────────────────────────
+    server.tool('promptwheel_heal_blocked', 'Diagnose and recover blocked tickets.', {
+        ticket_id: z.string().describe('The ticket ID to diagnose/heal.'),
+        action: z.enum(['diagnose', 'retry', 'expand_scope']).optional()
+            .describe('Action: diagnose (default), retry (reset to ready), expand_scope (widen allowed_paths).'),
+    }, async (params) => {
+        const state = getState();
+        try {
+            const ticket = await repos.tickets.getById(state.db, params.ticket_id);
+            if (!ticket) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ error: `Ticket ${params.ticket_id} not found` }),
+                        }],
+                    isError: true,
+                };
+            }
+            const action = params.action ?? 'diagnose';
+            const suggestedActions = [];
+            let diagnosis = '';
+            let applied;
+            // ── Diagnose ──
+            if (ticket.status !== 'blocked' && action === 'diagnose') {
+                diagnosis = `Ticket is not blocked (status: ${ticket.status})`;
+            }
+            else {
+                // Analyze why it might be blocked
+                const diagParts = [];
+                // Check retry exhaustion
+                if (ticket.retryCount >= ticket.maxRetries) {
+                    diagParts.push(`Retry limit exhausted (${ticket.retryCount}/${ticket.maxRetries})`);
+                    suggestedActions.push('retry — reset retry count and status to ready');
+                }
+                // Check scope issues
+                if (ticket.allowedPaths.length > 0) {
+                    const run = state.run.current;
+                    if (run) {
+                        const policy = deriveScopePolicy({
+                            allowedPaths: ticket.allowedPaths,
+                            category: ticket.category ?? 'refactor',
+                            maxLinesPerTicket: run.max_lines_per_ticket,
+                        });
+                        // Check if all allowed paths are valid
+                        const invalidPaths = ticket.allowedPaths.filter(p => !isFileAllowed(p, policy));
+                        if (invalidPaths.length > 0) {
+                            diagParts.push(`Allowed paths conflict with denied policy: ${invalidPaths.join(', ')}`);
+                        }
+                    }
+                    // Scope too narrow?
+                    if (ticket.allowedPaths.length <= 2) {
+                        diagParts.push('Very narrow scope — may need expansion for related files');
+                        suggestedActions.push('expand_scope — widen allowed_paths for related files');
+                    }
+                }
+                // Check spindle state
+                const run = state.run.current;
+                if (run?.spindle) {
+                    const spindleCheck = checkSpindle(run.spindle);
+                    if (spindleCheck.shouldAbort || spindleCheck.shouldBlock) {
+                        diagParts.push(`Spindle detected: ${spindleCheck.reason ?? 'loop pattern'}`);
+                        suggestedActions.push('retry — reset after fixing the underlying issue');
+                    }
+                }
+                // Check missing verification
+                if (ticket.verificationCommands.length === 0) {
+                    diagParts.push('No verification commands — QA cannot validate');
+                    suggestedActions.push('Add verification commands before retrying');
+                }
+                diagnosis = diagParts.length > 0
+                    ? diagParts.join('; ')
+                    : 'No obvious issues found — may need manual investigation';
+            }
+            // ── Apply action ──
+            if (action === 'retry') {
+                await repos.tickets.updateStatus(state.db, params.ticket_id, 'ready');
+                applied = 'Reset ticket status to ready';
+                state.run.appendEvent('USER_OVERRIDE', {
+                    ticket_id: params.ticket_id,
+                    action: 'retry',
+                });
+            }
+            else if (action === 'expand_scope') {
+                if (ticket.allowedPaths.length === 0) {
+                    applied = 'Ticket has no scope restrictions — expansion not needed';
+                }
+                else {
+                    // Expand to include parent directories and sibling patterns
+                    const expanded = [...ticket.allowedPaths];
+                    for (const p of ticket.allowedPaths) {
+                        const parts = p.split('/');
+                        if (parts.length >= 2) {
+                            // Add sibling pattern: same directory, any file
+                            const dir = parts.slice(0, -1).join('/');
+                            const pattern = `${dir}/**`;
+                            if (!expanded.includes(pattern)) {
+                                expanded.push(pattern);
+                            }
+                        }
+                    }
+                    // We can't directly update allowedPaths through the standard repo API
+                    // so we reset the ticket to ready with a note about expanded scope
+                    await repos.tickets.updateStatus(state.db, params.ticket_id, 'ready');
+                    applied = `Reset to ready. Suggested expanded paths: ${expanded.join(', ')}`;
+                    state.run.appendEvent('USER_OVERRIDE', {
+                        ticket_id: params.ticket_id,
+                        action: 'expand_scope',
+                        expanded_paths: expanded,
+                    });
+                }
+            }
+            if (suggestedActions.length === 0 && action === 'diagnose') {
+                suggestedActions.push('retry — reset status and try again');
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            ticket_id: params.ticket_id,
+                            title: ticket.title,
+                            status: ticket.status,
+                            diagnosis,
+                            suggested_actions: suggestedActions,
+                            ...(applied ? { applied } : {}),
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: e.message }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=intelligence.js.map

package/dist/tools/intelligence.js.map

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

package/dist/tools/session.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Session management tools: start_session, session_status, end_session, advance, ingest_event
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SessionManager } from '../state.js';
+export declare function registerSessionTools(server: McpServer, getState: () => SessionManager): void;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,QAijBrF"}