@defai.digital/review-domain 13.0.3

package/dist/focus-modes.js

@@ -0,0 +1,241 @@
+/**
+ * Focus Mode Prompts
+ *
+ * Specialized prompts for each review focus mode.
+ * INV-REV-001: Each focus mode MUST only report issues relevant to that focus.
+ */
+/**
+ * Focus-specific system prompts
+ * Each prompt instructs the LLM to focus on specific categories of issues.
+ */
+export const FOCUS_MODE_PROMPTS = {
+    security: `You are a security-focused code reviewer. Analyze for:
+- Injection vulnerabilities (SQL, XSS, command injection, LDAP injection)
+- Authentication/authorization issues (broken auth, insecure sessions)
+- Sensitive data exposure (PII leaks, hardcoded credentials, logging secrets)
+- Insecure cryptography (weak algorithms, improper key management)
+- Security misconfigurations (CORS, headers, permissions)
+- OWASP Top 10 vulnerabilities
+- Input validation failures
+- Insecure deserialization
+
+Only report security-related issues. Ignore style, naming, or general code quality.
+Tag all comments with category starting with "security/".`,
+    architecture: `You are an architecture-focused code reviewer. Analyze for:
+- Single Responsibility Principle violations (classes/functions doing too much)
+- High coupling between modules (tight dependencies, circular imports)
+- Dependency inversion issues (high-level depending on low-level)
+- Circular dependencies
+- God classes/functions (doing too much)
+- Missing abstraction layers
+- Improper separation of concerns
+- Leaky abstractions
+- Interface segregation violations
+- Improper layering (presentation touching data directly)
+
+Only report architectural issues. Ignore security, performance, or style issues.
+Tag all comments with category starting with "architecture/".`,
+    performance: `You are a performance-focused code reviewer. Analyze for:
+- N+1 query patterns (database queries in loops)
+- Memory leaks (unclosed resources, event listeners not removed)
+- Unnecessary re-renders or re-computations
+- Expensive operations in loops (sorting, regex compilation)
+- Missing caching opportunities
+- Blocking operations in async contexts
+- O(n²) or worse algorithms where O(n) is possible
+- Unnecessary object creation in hot paths
+- String concatenation in loops
+- Unbounded collections growth
+
+Only report performance issues. Ignore security, architecture, or style issues.
+Tag all comments with category starting with "performance/".`,
+    maintainability: `You are a maintainability-focused code reviewer. Analyze for:
+- Code duplication (DRY violations, copy-paste code)
+- Poor naming (unclear variable/function names, abbreviations)
+- Missing or inadequate documentation
+- Complex conditionals (deeply nested, long chains)
+- Magic numbers/strings without constants
+- Dead code or unreachable branches
+- Inconsistent patterns within the codebase
+- Long functions/methods (>50 lines)
+- Too many parameters (>5)
+- Complex boolean expressions
+
+Only report maintainability issues. Ignore security, performance, or architecture issues.
+Tag all comments with category starting with "maintainability/".`,
+    correctness: `You are a correctness-focused code reviewer. Analyze for:
+- Logic errors and off-by-one mistakes
+- Null/undefined handling issues (missing null checks, optional chaining)
+- Race conditions (async ordering, shared state)
+- Error handling gaps (uncaught exceptions, unhandled rejections)
+- Type mismatches or unsafe casts
+- Edge cases not handled (empty arrays, zero values)
+- Incorrect assumptions in comments vs code
+- Integer overflow/underflow
+- Floating point precision issues
+- Incorrect comparisons (== vs ===)
+
+Only report correctness issues. Focus on bugs, not style or optimization.
+Tag all comments with category starting with "correctness/".`,
+    all: `You are a comprehensive code reviewer. Analyze for issues in ALL categories:
+
+SECURITY:
+- Injection vulnerabilities, auth issues, data exposure, cryptography issues
+
+ARCHITECTURE:
+- SRP violations, high coupling, circular dependencies, missing abstractions
+
+PERFORMANCE:
+- N+1 queries, memory leaks, inefficient algorithms, blocking operations
+
+MAINTAINABILITY:
+- Code duplication, poor naming, complex conditionals, magic numbers
+
+CORRECTNESS:
+- Logic errors, null handling, race conditions, error handling gaps
+
+Prioritize critical issues. Provide balanced coverage across all categories.
+Tag comments with appropriate category prefixes (security/, architecture/, performance/, maintainability/, correctness/).`,
+};
+/**
+ * Get the prompt for a specific focus mode
+ */
+export function getFocusModePrompt(focus) {
+    return FOCUS_MODE_PROMPTS[focus];
+}
+/**
+ * Get the response format instructions
+ * This instructs the LLM how to format its response for parsing.
+ */
+export const RESPONSE_FORMAT_INSTRUCTIONS = `
+Respond with a JSON array of review comments. Each comment must have:
+{
+  "file": "path/to/file.ts",
+  "line": 42,
+  "lineEnd": 45,           // optional, for multi-line issues
+  "severity": "critical",   // one of: critical, warning, suggestion, note
+  "title": "Brief issue title (max 100 chars)",
+  "body": "Detailed explanation of the issue and why it matters",
+  "rationale": "Why this is important to fix", // optional but recommended
+  "suggestion": "How to fix this issue",       // required for critical/warning
+  "suggestedCode": "code snippet showing the fix", // optional
+  "confidence": 0.95,      // your confidence 0-1
+  "category": "security/sql-injection" // category with focus prefix
+}
+
+IMPORTANT:
+- severity must be one of: critical, warning, suggestion, note
+- critical/warning MUST include suggestion field
+- body MUST explain WHY this matters
+- confidence should reflect your certainty (0.0-1.0)
+- Only report issues you are confident about
+- Do not report style issues unless maintainability focus
+
+Respond ONLY with the JSON array, no other text.
+`;
+/**
+ * Build the complete review prompt
+ */
+export function buildReviewPrompt(focus, fileContents, userContext) {
+    const focusPrompt = getFocusModePrompt(focus);
+    let prompt = `${focusPrompt}
+
+${RESPONSE_FORMAT_INSTRUCTIONS}
+
+`;
+    if (userContext) {
+        prompt += `Additional context from the user:
+${userContext}
+
+`;
+    }
+    prompt += `Files to review:
+
+`;
+    for (const file of fileContents) {
+        prompt += `--- ${file.path} ---
+${file.content}
+
+`;
+    }
+    prompt += `
+Now analyze these files and provide your review comments as a JSON array.`;
+    return prompt;
+}
+/**
+ * Categories allowed for each focus mode
+ * INV-REV-001: Used to validate that comments match their focus mode
+ */
+export const FOCUS_MODE_CATEGORIES = {
+    security: [
+        'security/injection',
+        'security/xss',
+        'security/sql-injection',
+        'security/command-injection',
+        'security/auth',
+        'security/authorization',
+        'security/data-exposure',
+        'security/cryptography',
+        'security/configuration',
+        'security/deserialization',
+        'security/validation',
+        'security/other',
+    ],
+    architecture: [
+        'architecture/srp-violation',
+        'architecture/coupling',
+        'architecture/circular-dependency',
+        'architecture/god-class',
+        'architecture/abstraction',
+        'architecture/separation-of-concerns',
+        'architecture/layering',
+        'architecture/other',
+    ],
+    performance: [
+        'performance/n-plus-one',
+        'performance/memory-leak',
+        'performance/re-render',
+        'performance/loop-operation',
+        'performance/caching',
+        'performance/blocking',
+        'performance/algorithm',
+        'performance/allocation',
+        'performance/other',
+    ],
+    maintainability: [
+        'maintainability/duplication',
+        'maintainability/naming',
+        'maintainability/documentation',
+        'maintainability/complexity',
+        'maintainability/magic-number',
+        'maintainability/dead-code',
+        'maintainability/consistency',
+        'maintainability/long-function',
+        'maintainability/other',
+    ],
+    correctness: [
+        'correctness/logic-error',
+        'correctness/null-handling',
+        'correctness/race-condition',
+        'correctness/error-handling',
+        'correctness/type-mismatch',
+        'correctness/edge-case',
+        'correctness/comparison',
+        'correctness/overflow',
+        'correctness/other',
+    ],
+    all: [], // All categories allowed
+};
+/**
+ * Check if a category is valid for a focus mode
+ * INV-REV-001: Validates focus mode isolation
+ */
+export function isCategoryValidForFocus(category, focus) {
+    if (focus === 'all') {
+        return true; // All categories allowed for 'all' focus
+    }
+    const allowedCategories = FOCUS_MODE_CATEGORIES[focus];
+    // Check exact match or prefix match
+    return allowedCategories.some((allowed) => category === allowed || category.startsWith(focus + '/'));
+}
+//# sourceMappingURL=focus-modes.js.map

package/dist/focus-modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-modes.js","sourceRoot":"","sources":["../src/focus-modes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,QAAQ,EAAE;;;;;;;;;;;0DAW8C;IAExD,YAAY,EAAE;;;;;;;;;;;;;8DAa8C;IAE5D,WAAW,EAAE;;;;;;;;;;;;;6DAa8C;IAE3D,eAAe,EAAE;;;;;;;;;;;;;iEAa8C;IAE/D,WAAW,EAAE;;;;;;;;;;;;;6DAa8C;IAE3D,GAAG,EAAE;;;;;;;;;;;;;;;;;;0HAkBmH;CACzH,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyB3C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAkB,EAClB,YAAiD,EACjD,WAAoB;IAEpB,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,MAAM,GAAG,GAAG,WAAW;;EAE3B,4BAA4B;;CAE7B,CAAC;IAEA,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI;EACZ,WAAW;;CAEZ,CAAC;IACA,CAAC;IAED,MAAM,IAAI;;CAEX,CAAC;IAEA,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI;EAC5B,IAAI,CAAC,OAAO;;CAEb,CAAC;IACA,CAAC;IAED,MAAM,IAAI;0EAC8D,CAAC;IAEzE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkC;IAClE,QAAQ,EAAE;QACR,oBAAoB;QACpB,cAAc;QACd,wBAAwB;QACxB,4BAA4B;QAC5B,eAAe;QACf,wBAAwB;QACxB,wBAAwB;QACxB,uBAAuB;QACvB,wBAAwB;QACxB,0BAA0B;QAC1B,qBAAqB;QACrB,gBAAgB;KACjB;IACD,YAAY,EAAE;QACZ,4BAA4B;QAC5B,uBAAuB;QACvB,kCAAkC;QAClC,wBAAwB;QACxB,0BAA0B;QAC1B,qCAAqC;QACrC,uBAAuB;QACvB,oBAAoB;KACrB;IACD,WAAW,EAAE;QACX,wBAAwB;QACxB,yBAAyB;QACzB,uBAAuB;QACvB,4BAA4B;QAC5B,qBAAqB;QACrB,sBAAsB;QACtB,uBAAuB;QACvB,wBAAwB;QACxB,mBAAmB;KACpB;IACD,eAAe,EAAE;QACf,6BAA6B;QAC7B,wBAAwB;QACxB,+BAA+B;QAC/B,4BAA4B;QAC5B,8BAA8B;QAC9B,2BAA2B;QAC3B,6BAA6B;QAC7B,+BAA+B;QAC/B,uBAAuB;KACxB;IACD,WAAW,EAAE;QACX,yBAAyB;QACzB,2BAA2B;QAC3B,4BAA4B;QAC5B,4BAA4B;QAC5B,2BAA2B;QAC3B,uBAAuB;QACvB,wBAAwB;QACxB,sBAAsB;QACtB,mBAAmB;KACpB;IACD,GAAG,EAAE,EAAE,EAAE,yBAAyB;CACnC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,KAAkB;IAC1E,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,CAAC,yCAAyC;IACxD,CAAC;IAED,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAEvD,oCAAoC;IACpC,OAAO,iBAAiB,CAAC,IAAI,CAC3B,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CACtE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Review Domain
+ *
+ * AI-powered code review with focused analysis modes.
+ */
+export type { FileContent, ReviewContext, ParsedReviewResponse, ReviewServiceConfig, ReviewPromptExecutor, ReviewExecutionOptions, DryRunResult, } from './types.js';
+export type { ReviewRequest, ReviewResult, ReviewComment, ReviewFocus, ReviewSummary, SarifOutput, } from './types.js';
+export { FOCUS_MODE_PROMPTS, getFocusModePrompt, RESPONSE_FORMAT_INSTRUCTIONS, buildReviewPrompt, FOCUS_MODE_CATEGORIES, isCategoryValidForFocus, } from './focus-modes.js';
+export { parseReviewResponse, filterCommentsByFocus, filterCommentsByConfidence, validateActionableSuggestions, generateCommentId, } from './comment-builder.js';
+export { formatReviewAsMarkdown, formatCompactSummary } from './markdown-formatter.js';
+export { formatReviewAsSarif, formatSarifAsJson, createEmptySarifReport, } from './sarif-formatter.js';
+export { ReviewService, ReviewError, createReviewService } from './review-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGvF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * Review Domain
+ *
+ * AI-powered code review with focused analysis modes.
+ */
+// Focus Modes
+export { FOCUS_MODE_PROMPTS, getFocusModePrompt, RESPONSE_FORMAT_INSTRUCTIONS, buildReviewPrompt, FOCUS_MODE_CATEGORIES, isCategoryValidForFocus, } from './focus-modes.js';
+// Comment Builder
+export { parseReviewResponse, filterCommentsByFocus, filterCommentsByConfidence, validateActionableSuggestions, generateCommentId, } from './comment-builder.js';
+// Markdown Formatter
+export { formatReviewAsMarkdown, formatCompactSummary } from './markdown-formatter.js';
+// SARIF Formatter
+export { formatReviewAsSarif, formatSarifAsJson, createEmptySarifReport, } from './sarif-formatter.js';
+// Review Service
+export { ReviewService, ReviewError, createReviewService } from './review-service.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,cAAc;AACd,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,qBAAqB;AACrB,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/markdown-formatter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Markdown Formatter
+ *
+ * Formats review results as markdown output.
+ * INV-REV-OUT-001: Comments ordered by severity.
+ */
+import { type ReviewResult } from '@defai.digital/contracts';
+/**
+ * Format review result as markdown
+ */
+export declare function formatReviewAsMarkdown(result: ReviewResult): string;
+/**
+ * Format a compact summary for CLI output
+ */
+export declare function formatCompactSummary(result: ReviewResult): string;
+//# sourceMappingURL=markdown-formatter.d.ts.map

package/dist/markdown-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-formatter.d.ts","sourceRoot":"","sources":["../src/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+GnE;AAkED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAqBjE"}

package/dist/markdown-formatter.js

@@ -0,0 +1,183 @@
+/**
+ * Markdown Formatter
+ *
+ * Formats review results as markdown output.
+ * INV-REV-OUT-001: Comments ordered by severity.
+ */
+import { sortCommentsBySeverity, } from '@defai.digital/contracts';
+/**
+ * Format review result as markdown
+ */
+export function formatReviewAsMarkdown(result) {
+    const { summary, comments, filesReviewed, linesAnalyzed, durationMs, providerId } = result;
+    // Sort comments by severity (INV-REV-OUT-001)
+    const sortedComments = sortCommentsBySeverity(comments);
+    const lines = [];
+    // Header
+    lines.push('# Code Review Report');
+    lines.push('');
+    const focusMode = result.comments.length > 0 && result.comments[0] ? result.comments[0].focus : 'all';
+    lines.push(`**Focus:** ${focusMode} | ` +
+        `**Files:** ${filesReviewed.length} | ` +
+        `**Lines:** ${linesAnalyzed.toLocaleString()} | ` +
+        `**Duration:** ${formatDuration(durationMs)}`);
+    lines.push('');
+    // Summary table
+    lines.push('## Summary');
+    lines.push('');
+    lines.push('| Severity | Count |');
+    lines.push('|----------|-------|');
+    lines.push(`| Critical | ${summary.bySeverity.critical} |`);
+    lines.push(`| Warning | ${summary.bySeverity.warning} |`);
+    lines.push(`| Suggestion | ${summary.bySeverity.suggestion} |`);
+    lines.push(`| Note | ${summary.bySeverity.note} |`);
+    lines.push('');
+    lines.push(`**Health Score:** ${summary.healthScore}/100`);
+    lines.push(`**Verdict:** ${summary.verdict}`);
+    lines.push('');
+    // Provider info
+    lines.push(`*Reviewed by ${providerId}*`);
+    lines.push('');
+    if (sortedComments.length === 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('No issues found.');
+        return lines.join('\n');
+    }
+    // Group comments by severity
+    const critical = sortedComments.filter((c) => c.severity === 'critical');
+    const warnings = sortedComments.filter((c) => c.severity === 'warning');
+    const suggestions = sortedComments.filter((c) => c.severity === 'suggestion');
+    const notes = sortedComments.filter((c) => c.severity === 'note');
+    // Critical Issues
+    if (critical.length > 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('## Critical Issues');
+        lines.push('');
+        for (const comment of critical) {
+            lines.push(...formatComment(comment, 'CRITICAL'));
+        }
+    }
+    // Warnings
+    if (warnings.length > 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('## Warnings');
+        lines.push('');
+        for (const comment of warnings) {
+            lines.push(...formatComment(comment, 'WARNING'));
+        }
+    }
+    // Suggestions
+    if (suggestions.length > 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('## Suggestions');
+        lines.push('');
+        for (const comment of suggestions) {
+            lines.push(...formatComment(comment, 'SUGGESTION'));
+        }
+    }
+    // Notes
+    if (notes.length > 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('## Notes');
+        lines.push('');
+        for (const comment of notes) {
+            lines.push(...formatComment(comment, 'NOTE'));
+        }
+    }
+    // Hotspots
+    if (summary.hotspots.length > 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('## File Hotspots');
+        lines.push('');
+        lines.push('Files with the most issues:');
+        lines.push('');
+        for (const hotspot of summary.hotspots) {
+            lines.push(`- \`${hotspot.file}\`: ${hotspot.commentCount} issue(s)`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a single comment
+ */
+function formatComment(comment, badge) {
+    const lines = [];
+    // Title with severity badge
+    lines.push(`### [${badge}] ${comment.title}`);
+    // Location
+    const location = comment.lineEnd
+        ? `\`${comment.file}:${comment.line}-${comment.lineEnd}\``
+        : `\`${comment.file}:${comment.line}\``;
+    lines.push(`**File:** ${location}`);
+    lines.push(`**Confidence:** ${Math.round(comment.confidence * 100)}%`);
+    lines.push(`**Category:** ${comment.category}`);
+    lines.push('');
+    // Body (explanation)
+    lines.push(comment.body);
+    lines.push('');
+    // Rationale (if present)
+    if (comment.rationale) {
+        lines.push('**Why this matters:**');
+        lines.push(comment.rationale);
+        lines.push('');
+    }
+    // Suggestion (if present)
+    if (comment.suggestion) {
+        lines.push('**Suggestion:**');
+        lines.push(comment.suggestion);
+        lines.push('');
+    }
+    // Suggested code (if present)
+    if (comment.suggestedCode) {
+        lines.push('**Suggested fix:**');
+        lines.push('```');
+        lines.push(comment.suggestedCode);
+        lines.push('```');
+        lines.push('');
+    }
+    return lines;
+}
+/**
+ * Format duration in human-readable format
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const seconds = Math.round(ms / 1000);
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${minutes}m ${remainingSeconds}s`;
+}
+/**
+ * Format a compact summary for CLI output
+ */
+export function formatCompactSummary(result) {
+    const { summary, durationMs } = result;
+    const parts = [];
+    if (summary.bySeverity.critical > 0) {
+        parts.push(`${summary.bySeverity.critical} critical`);
+    }
+    if (summary.bySeverity.warning > 0) {
+        parts.push(`${summary.bySeverity.warning} warning`);
+    }
+    if (summary.bySeverity.suggestion > 0) {
+        parts.push(`${summary.bySeverity.suggestion} suggestion`);
+    }
+    if (summary.bySeverity.note > 0) {
+        parts.push(`${summary.bySeverity.note} note`);
+    }
+    const issuesSummary = parts.length > 0 ? parts.join(', ') : 'No issues';
+    return `${issuesSummary} | Health: ${summary.healthScore}/100 | ${formatDuration(durationMs)}`;
+}
+//# sourceMappingURL=markdown-formatter.js.map

package/dist/markdown-formatter.js.map

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

package/dist/review-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Review Service
+ *
+ * Orchestrates the AI code review process.
+ * Implements:
+ * - INV-REV-OPS-001: Timeout Handling
+ * - INV-REV-OPS-002: Provider Fallback
+ */
+import { type ReviewRequest, type ReviewResult } from '@defai.digital/contracts';
+import type { ReviewServiceConfig, ReviewPromptExecutor, ReviewExecutionOptions, DryRunResult } from './types.js';
+/**
+ * Review service for orchestrating AI code review
+ */
+export declare class ReviewService {
+    private readonly config;
+    private readonly promptExecutor;
+    constructor(config?: ReviewServiceConfig, promptExecutor?: ReviewPromptExecutor);
+    /**
+     * Execute a code review
+     * INV-REV-OPS-001: Reviews MUST complete or fail within configured timeout
+     */
+    review(request: ReviewRequest, options?: ReviewExecutionOptions): Promise<ReviewResult>;
+    /**
+     * Execute dry run - show what would be analyzed
+     */
+    dryRun(request: ReviewRequest): Promise<DryRunResult>;
+    /**
+     * Format result based on output format
+     */
+    formatResult(result: ReviewResult, format: 'markdown' | 'json' | 'sarif'): string;
+    /**
+     * Get compact summary for CLI
+     */
+    getCompactSummary(result: ReviewResult): string;
+    /**
+     * Collect files from paths
+     */
+    private collectFiles;
+    /**
+     * Recursively collect files from directory
+     */
+    private collectFromDirectory;
+    /**
+     * Read a single file
+     */
+    private readFile;
+    /**
+     * Execute prompt with timeout
+     * INV-REV-OPS-001: Timeout Handling
+     */
+    private executeWithTimeout;
+    /**
+     * Create empty result for dry run
+     */
+    private createEmptyResult;
+}
+/**
+ * Review error with error code
+ */
+export declare class ReviewError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Create a review service instance
+ */
+export declare function createReviewService(config?: ReviewServiceConfig, promptExecutor?: ReviewPromptExecutor): ReviewService;
+//# sourceMappingURL=review-service.d.ts.map

package/dist/review-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-service.d.ts","sourceRoot":"","sources":["../src/review-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EAKlB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACb,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;gBAEtD,MAAM,CAAC,EAAE,mBAAmB,EAAE,cAAc,CAAC,EAAE,oBAAoB;IAK/E;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,YAAY,CAAC;IA8DxB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAW3D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM;IAWjF;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAI/C;;OAEG;YACW,YAAY;IAqC1B;;OAEG;YACW,oBAAoB;IAsClC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;;OAGG;YACW,kBAAkB;IAyChC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAyB1B;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,mBAAmB,EAC5B,cAAc,CAAC,EAAE,oBAAoB,GACpC,aAAa,CAEf"}