dino-spec 14.0.1 → 14.1.0

package/dist/mcp/tools/feedback.js

@@ -0,0 +1,255 @@
+/**
+ * Feedback MCP Tools - v14.1.0
+ *
+ * MCP tools for collecting and managing reviewer feedback.
+ * Tracks quality across iterations and provides early stopping recommendations.
+ */
+import { defineTool, registry } from '../registry.js';
+import { createFeedbackCollector, collectFeedback, checkEarlyStopping, extractLearnings, formatFeedbackState, formatEarlyStoppingResult, resolveFeedback, resolveIteration, } from '../../core/agents/feedback-collector.js';
+// =============================================================================
+// State Management
+// =============================================================================
+// In-memory state (per session)
+let collectorState = createFeedbackCollector();
+/**
+ * Reset the feedback collector state
+ */
+export function resetFeedbackCollector() {
+    collectorState = createFeedbackCollector();
+}
+/**
+ * Get current collector state (for testing)
+ */
+export function getCollectorState() {
+    return collectorState;
+}
+/**
+ * Collect feedback from a review
+ */
+async function handleCollectFeedback(params, _projectDir) {
+    const iteration = parseInt(params.iteration, 10);
+    if (isNaN(iteration)) {
+        return 'Error: iteration must be a number';
+    }
+    let findings;
+    try {
+        findings = JSON.parse(params.findings);
+    }
+    catch {
+        return 'Error: findings must be valid JSON';
+    }
+    // Build mock review result
+    const reviewResult = {
+        verdict: params.verdict || 'needs-discussion',
+        approved: params.verdict === 'approve',
+        blocking: params.verdict === 'request-changes',
+        findings,
+        summary: `Review with ${findings.length} finding(s)`,
+        reviewerId: 'manual',
+        timestamp: new Date(),
+        tokensUsed: 0,
+    };
+    // Collect feedback
+    collectorState = collectFeedback(collectorState, reviewResult, iteration);
+    // Check early stopping
+    const stopping = checkEarlyStopping(collectorState);
+    const lines = [
+        formatFeedbackState(collectorState),
+        '',
+        formatEarlyStoppingResult(stopping),
+    ];
+    return lines.join('\n');
+}
+export const collectFeedbackTool = defineTool({
+    name: 'dino_feedback_collect',
+    description: 'Collect feedback from a code review for quality tracking (v14.1.0)',
+    category: 'feedback',
+    tier: 'verification',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            iteration: {
+                type: 'string',
+                description: 'Current iteration number',
+            },
+            findings: {
+                type: 'string',
+                description: 'Review findings as JSON array: [{type, severity, file, message}]',
+            },
+            verdict: {
+                type: 'string',
+                description: 'Review verdict: approve, request-changes, needs-discussion',
+                enum: ['approve', 'request-changes', 'needs-discussion'],
+            },
+        },
+        required: ['iteration', 'findings'],
+    },
+    handler: handleCollectFeedback,
+    whenToUse: 'After a code review to track quality metrics and determine if early stopping is needed',
+    relatedTools: ['dino_feedback_status', 'dino_feedback_learnings', 'dino_feedback_resolve'],
+    version: 'v14.1.0',
+});
+/**
+ * View current feedback status
+ */
+async function handleFeedbackStatus(params, _projectDir) {
+    const showHistory = params.showHistory?.toLowerCase() === 'true';
+    const lines = [formatFeedbackState(collectorState)];
+    // Check early stopping
+    const stopping = checkEarlyStopping(collectorState);
+    lines.push('');
+    lines.push(formatEarlyStoppingResult(stopping));
+    if (showHistory && collectorState.history.length > 0) {
+        lines.push('');
+        lines.push('### Full History');
+        for (const entry of collectorState.history) {
+            lines.push(`| ${entry.iteration} | ${entry.score} | ${entry.criticalCount}C/${entry.majorCount}M/${entry.minorCount}m | ${entry.timestamp.toISOString()} |`);
+        }
+    }
+    return lines.join('\n');
+}
+export const feedbackStatusTool = defineTool({
+    name: 'dino_feedback_status',
+    description: 'View current feedback collector status and quality metrics (v14.1.0)',
+    category: 'feedback',
+    tier: 'verification',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            showHistory: {
+                type: 'string',
+                description: 'Show full quality history (true/false)',
+            },
+        },
+    },
+    handler: handleFeedbackStatus,
+    whenToUse: 'To check current quality score, trend, and early stopping status',
+    relatedTools: ['dino_feedback_collect', 'dino_feedback_learnings', 'dino_feedback_reset'],
+    version: 'v14.1.0',
+});
+/**
+ * Extract learnings from collected feedback
+ */
+async function handleFeedbackLearnings(params, _projectDir) {
+    const limit = params.limit ? parseInt(params.limit, 10) : 10;
+    const learnings = extractLearnings(collectorState);
+    const limited = learnings.slice(0, limit);
+    if (limited.length === 0) {
+        return 'No learnings to extract from current feedback.';
+    }
+    const lines = [
+        '## Learnings for Next Iteration',
+        '',
+        `Extracted from iteration ${collectorState.currentIteration}:`,
+        '',
+    ];
+    for (const learning of limited) {
+        lines.push(`- ${learning}`);
+    }
+    if (learnings.length > limit) {
+        lines.push('');
+        lines.push(`_...and ${learnings.length - limit} more_`);
+    }
+    return lines.join('\n');
+}
+export const feedbackLearningsTool = defineTool({
+    name: 'dino_feedback_learnings',
+    description: 'Extract learnings from feedback for the next iteration (v14.1.0)',
+    category: 'feedback',
+    tier: 'verification',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'string',
+                description: 'Maximum number of learnings to return (default: 10)',
+            },
+        },
+    },
+    handler: handleFeedbackLearnings,
+    whenToUse: 'Before starting a new iteration to inject learnings from previous reviews',
+    relatedTools: ['dino_feedback_collect', 'dino_feedback_status', 'dino_feedback_resolve'],
+    version: 'v14.1.0',
+});
+/**
+ * Mark feedback as resolved
+ */
+async function handleFeedbackResolve(params, _projectDir) {
+    const { feedbackId } = params;
+    if (feedbackId.toLowerCase() === 'all') {
+        collectorState = resolveIteration(collectorState, collectorState.currentIteration);
+        return `Resolved all feedback for iteration ${collectorState.currentIteration}`;
+    }
+    const entry = collectorState.entries.find((e) => e.id === feedbackId);
+    if (!entry) {
+        return `Feedback not found: ${feedbackId}`;
+    }
+    collectorState = resolveFeedback(collectorState, feedbackId);
+    return `Resolved feedback: ${feedbackId}`;
+}
+export const feedbackResolveTool = defineTool({
+    name: 'dino_feedback_resolve',
+    description: 'Mark feedback as resolved (v14.1.0)',
+    category: 'feedback',
+    tier: 'verification',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            feedbackId: {
+                type: 'string',
+                description: 'Feedback ID to resolve, or "all" for current iteration',
+            },
+        },
+        required: ['feedbackId'],
+    },
+    handler: handleFeedbackResolve,
+    whenToUse: 'After addressing feedback issues to mark them as resolved',
+    relatedTools: ['dino_feedback_collect', 'dino_feedback_status', 'dino_feedback_learnings'],
+    version: 'v14.1.0',
+});
+// =============================================================================
+// Reset Tool
+// =============================================================================
+/**
+ * Reset feedback collector
+ */
+async function handleFeedbackReset(_params, _projectDir) {
+    resetFeedbackCollector();
+    return 'Feedback collector reset. Quality history cleared.';
+}
+export const feedbackResetTool = defineTool({
+    name: 'dino_feedback_reset',
+    description: 'Reset feedback collector state (v14.1.0)',
+    category: 'feedback',
+    tier: 'verification',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    handler: handleFeedbackReset,
+    whenToUse: 'To start fresh with a new feedback collection session',
+    relatedTools: ['dino_feedback_collect', 'dino_feedback_status'],
+    version: 'v14.1.0',
+});
+// =============================================================================
+// Exports
+// =============================================================================
+/**
+ * All feedback tools
+ */
+export const feedbackTools = [
+    collectFeedbackTool,
+    feedbackStatusTool,
+    feedbackLearningsTool,
+    feedbackResolveTool,
+    feedbackResetTool,
+];
+/**
+ * Register feedback tools with the registry
+ */
+export function registerFeedbackTools() {
+    for (const tool of feedbackTools) {
+        registry.registerTool(tool);
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/mcp/tools/feedback.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dino-spec",
-  "version": "14.0.1",
+  "version": "14.1.0",
   "description": "Automatic context engineering for Claude Code",
   "type": "module",
   "exports": {