@shrkcrft/inspector 0.1.0-alpha.1

package/dist/repository-stats.js

@@ -0,0 +1,329 @@
+/**
+ * Repository statistics — per-language file counts, bytes, line totals,
+ * code/comment/blank line breakdowns, averages, and the top-N largest
+ * files in the workspace.
+ *
+ * Deterministic and read-only: given the same project, two consecutive
+ * calls produce the same output (modulo `generatedAt`).
+ *
+ * Comment detection is line-prefix based (`//`, `#`, `--`, `<!--`) and
+ * tracks the most common single-line and block forms per language. It is
+ * intentionally not a real parser — that would couple this module to
+ * every language toolchain we support.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+export const REPOSITORY_STATS_SCHEMA = 'sharkcraft.repository-stats/v1';
+const IGNORED_DIR_NAMES = new Set([
+    'node_modules',
+    '.git',
+    '.nx',
+    '.sharkcraft',
+    '.claude',
+    '.idea',
+    '.vscode',
+    '.next',
+    '.nuxt',
+    '.svelte-kit',
+    '.turbo',
+    'dist',
+    'build',
+    'out',
+    'target',
+    'bin',
+    'obj',
+    '__pycache__',
+    '.venv',
+    'venv',
+    'vendor',
+    'coverage',
+    '.gradle',
+    '.mvn',
+]);
+var CommentSyntax;
+(function (CommentSyntax) {
+    CommentSyntax["CFamily"] = "c-family";
+    CommentSyntax["Hash"] = "hash";
+    CommentSyntax["Html"] = "html";
+    CommentSyntax["Sql"] = "sql";
+    CommentSyntax["Lua"] = "lua";
+    CommentSyntax["Lisp"] = "lisp";
+    CommentSyntax["None"] = "none";
+})(CommentSyntax || (CommentSyntax = {}));
+const LANGUAGES = [
+    { id: 'typescript', extensions: ['.ts', '.tsx', '.mts', '.cts'], comment: CommentSyntax.CFamily },
+    { id: 'javascript', extensions: ['.js', '.jsx', '.mjs', '.cjs'], comment: CommentSyntax.CFamily },
+    { id: 'java', extensions: ['.java'], comment: CommentSyntax.CFamily },
+    { id: 'kotlin', extensions: ['.kt', '.kts'], comment: CommentSyntax.CFamily },
+    { id: 'scala', extensions: ['.scala'], comment: CommentSyntax.CFamily },
+    { id: 'groovy', extensions: ['.groovy'], comment: CommentSyntax.CFamily },
+    { id: 'csharp', extensions: ['.cs'], comment: CommentSyntax.CFamily },
+    { id: 'cpp', extensions: ['.cpp', '.cc', '.cxx', '.hpp', '.hh', '.hxx'], comment: CommentSyntax.CFamily },
+    { id: 'c', extensions: ['.c', '.h'], comment: CommentSyntax.CFamily },
+    { id: 'go', extensions: ['.go'], comment: CommentSyntax.CFamily },
+    { id: 'rust', extensions: ['.rs'], comment: CommentSyntax.CFamily },
+    { id: 'swift', extensions: ['.swift'], comment: CommentSyntax.CFamily },
+    { id: 'php', extensions: ['.php'], comment: CommentSyntax.CFamily },
+    { id: 'dart', extensions: ['.dart'], comment: CommentSyntax.CFamily },
+    { id: 'python', extensions: ['.py', '.pyi'], comment: CommentSyntax.Hash },
+    { id: 'ruby', extensions: ['.rb'], comment: CommentSyntax.Hash },
+    { id: 'shell', extensions: ['.sh', '.bash', '.zsh', '.fish'], comment: CommentSyntax.Hash },
+    { id: 'perl', extensions: ['.pl', '.pm'], comment: CommentSyntax.Hash },
+    { id: 'r', extensions: ['.r', '.R'], comment: CommentSyntax.Hash },
+    { id: 'yaml', extensions: ['.yaml', '.yml'], comment: CommentSyntax.Hash },
+    { id: 'toml', extensions: ['.toml'], comment: CommentSyntax.Hash },
+    { id: 'ini', extensions: ['.ini', '.cfg', '.conf'], comment: CommentSyntax.Hash },
+    { id: 'dockerfile', extensions: ['.dockerfile'], comment: CommentSyntax.Hash },
+    { id: 'makefile', extensions: ['.mk'], comment: CommentSyntax.Hash },
+    { id: 'html', extensions: ['.html', '.htm'], comment: CommentSyntax.Html },
+    { id: 'xml', extensions: ['.xml', '.xsd', '.xsl'], comment: CommentSyntax.Html },
+    { id: 'vue', extensions: ['.vue'], comment: CommentSyntax.Html },
+    { id: 'svelte', extensions: ['.svelte'], comment: CommentSyntax.Html },
+    { id: 'sql', extensions: ['.sql'], comment: CommentSyntax.Sql },
+    { id: 'css', extensions: ['.css', '.scss', '.sass', '.less'], comment: CommentSyntax.CFamily },
+    { id: 'lua', extensions: ['.lua'], comment: CommentSyntax.Lua },
+    { id: 'elixir', extensions: ['.ex', '.exs'], comment: CommentSyntax.Hash },
+    { id: 'clojure', extensions: ['.clj', '.cljs'], comment: CommentSyntax.Lisp },
+    { id: 'lisp', extensions: ['.lisp', '.lsp', '.el'], comment: CommentSyntax.Lisp },
+    { id: 'json', extensions: ['.json', '.jsonc'], comment: CommentSyntax.None },
+    { id: 'markdown', extensions: ['.md', '.mdx'], comment: CommentSyntax.None },
+    { id: 'text', extensions: ['.txt'], comment: CommentSyntax.None },
+];
+const EXTENSION_INDEX = (() => {
+    const m = new Map();
+    for (const def of LANGUAGES) {
+        for (const ext of def.extensions) {
+            m.set(ext.toLowerCase(), def);
+        }
+    }
+    return m;
+})();
+const BASENAME_OVERRIDES = new Map([
+    ['dockerfile', 'dockerfile'],
+    ['makefile', 'makefile'],
+    ['gnumakefile', 'makefile'],
+]);
+function walkRepository(root, maxFiles) {
+    const out = [];
+    const stack = [root];
+    let truncated = false;
+    while (stack.length > 0) {
+        if (out.length >= maxFiles) {
+            truncated = true;
+            break;
+        }
+        const cur = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(cur);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (IGNORED_DIR_NAMES.has(entry))
+                continue;
+            const abs = nodePath.join(cur, entry);
+            let st;
+            try {
+                st = statSync(abs);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                stack.push(abs);
+                continue;
+            }
+            if (st.isFile()) {
+                out.push(abs);
+                if (out.length >= maxFiles) {
+                    truncated = true;
+                    break;
+                }
+            }
+        }
+    }
+    return { files: out, truncated };
+}
+function classify(absPath) {
+    const base = nodePath.basename(absPath).toLowerCase();
+    const override = BASENAME_OVERRIDES.get(base);
+    if (override) {
+        const def = LANGUAGES.find((d) => d.id === override);
+        if (def)
+            return def;
+    }
+    const ext = nodePath.extname(absPath).toLowerCase();
+    if (!ext)
+        return null;
+    return EXTENSION_INDEX.get(ext) ?? null;
+}
+function countLines(text, syntax) {
+    if (text.length === 0)
+        return { total: 0, code: 0, comment: 0, blank: 0 };
+    const lines = text.split(/\r?\n/);
+    // Trailing empty entry from final newline shouldn't count.
+    if (lines.length > 0 && lines[lines.length - 1] === '')
+        lines.pop();
+    let code = 0;
+    let comment = 0;
+    let blank = 0;
+    let inBlock = false;
+    for (const raw of lines) {
+        const trimmed = raw.trim();
+        if (trimmed.length === 0) {
+            blank++;
+            continue;
+        }
+        if (inBlock) {
+            comment++;
+            if (syntax === CommentSyntax.CFamily && trimmed.includes('*/'))
+                inBlock = false;
+            else if (syntax === CommentSyntax.Html && trimmed.includes('-->'))
+                inBlock = false;
+            else if (syntax === CommentSyntax.Sql && trimmed.includes('*/'))
+                inBlock = false;
+            continue;
+        }
+        if (isCommentLine(trimmed, syntax)) {
+            comment++;
+            if (opensBlockComment(trimmed, syntax))
+                inBlock = true;
+            continue;
+        }
+        code++;
+    }
+    return { total: lines.length, code, comment, blank };
+}
+function isCommentLine(trimmed, syntax) {
+    switch (syntax) {
+        case CommentSyntax.CFamily:
+            return trimmed.startsWith('//') || trimmed.startsWith('/*') || trimmed.startsWith('*');
+        case CommentSyntax.Hash:
+            return trimmed.startsWith('#');
+        case CommentSyntax.Html:
+            return trimmed.startsWith('<!--');
+        case CommentSyntax.Sql:
+            return trimmed.startsWith('--') || trimmed.startsWith('/*');
+        case CommentSyntax.Lua:
+            return trimmed.startsWith('--');
+        case CommentSyntax.Lisp:
+            return trimmed.startsWith(';');
+        case CommentSyntax.None:
+        default:
+            return false;
+    }
+}
+function opensBlockComment(trimmed, syntax) {
+    if (syntax === CommentSyntax.CFamily || syntax === CommentSyntax.Sql) {
+        return trimmed.includes('/*') && !trimmed.includes('*/');
+    }
+    if (syntax === CommentSyntax.Html) {
+        return trimmed.startsWith('<!--') && !trimmed.includes('-->');
+    }
+    return false;
+}
+export async function buildRepositoryStats(opts) {
+    const projectRoot = nodePath.resolve(opts.cwd);
+    const maxFiles = opts.maxFiles ?? 50_000;
+    const maxTop = opts.maxTopFiles ?? 10;
+    const filter = opts.language?.toLowerCase();
+    const walk = walkRepository(projectRoot, maxFiles);
+    const accs = new Map();
+    const allFiles = [];
+    for (const abs of walk.files) {
+        const def = classify(abs);
+        if (!def)
+            continue;
+        if (filter && def.id !== filter)
+            continue;
+        let bytes = 0;
+        let counts = { total: 0, code: 0, comment: 0, blank: 0 };
+        try {
+            const st = statSync(abs);
+            bytes = st.size;
+            if (bytes > 0 && bytes < 4_000_000) {
+                const text = readFileSync(abs, 'utf8');
+                counts = countLines(text, def.comment);
+            }
+            else if (bytes >= 4_000_000) {
+                // Skip line counting for very large files but still tally bytes.
+                counts = { total: 0, code: 0, comment: 0, blank: 0 };
+            }
+        }
+        catch {
+            continue;
+        }
+        let acc = accs.get(def.id);
+        if (!acc) {
+            acc = {
+                def,
+                files: 0,
+                bytes: 0,
+                totalLines: 0,
+                codeLines: 0,
+                commentLines: 0,
+                blankLines: 0,
+                largest: null,
+            };
+            accs.set(def.id, acc);
+        }
+        acc.files++;
+        acc.bytes += bytes;
+        acc.totalLines += counts.total;
+        acc.codeLines += counts.code;
+        acc.commentLines += counts.comment;
+        acc.blankLines += counts.blank;
+        if (!acc.largest || bytes > acc.largest.bytes) {
+            acc.largest = {
+                path: nodePath.relative(projectRoot, abs).replace(/\\/g, '/'),
+                bytes,
+                lines: counts.total,
+            };
+        }
+        allFiles.push({
+            path: nodePath.relative(projectRoot, abs).replace(/\\/g, '/'),
+            language: def.id,
+            bytes,
+            lines: counts.total,
+        });
+    }
+    const byLanguage = [];
+    for (const acc of accs.values()) {
+        byLanguage.push({
+            language: acc.def.id,
+            extensions: acc.def.extensions,
+            files: acc.files,
+            bytes: acc.bytes,
+            totalLines: acc.totalLines,
+            codeLines: acc.codeLines,
+            commentLines: acc.commentLines,
+            blankLines: acc.blankLines,
+            averageFileBytes: acc.files > 0 ? Math.round(acc.bytes / acc.files) : 0,
+            averageFileLines: acc.files > 0 ? Math.round(acc.totalLines / acc.files) : 0,
+            largestFile: acc.largest,
+        });
+    }
+    byLanguage.sort((a, b) => b.files - a.files || b.bytes - a.bytes);
+    const totals = byLanguage.reduce((acc, l) => ({
+        files: acc.files + l.files,
+        bytes: acc.bytes + l.bytes,
+        totalLines: acc.totalLines + l.totalLines,
+        codeLines: acc.codeLines + l.codeLines,
+        commentLines: acc.commentLines + l.commentLines,
+        blankLines: acc.blankLines + l.blankLines,
+    }), { files: 0, bytes: 0, totalLines: 0, codeLines: 0, commentLines: 0, blankLines: 0 });
+    allFiles.sort((a, b) => b.bytes - a.bytes);
+    const topFiles = allFiles.slice(0, Math.max(0, maxTop));
+    return {
+        schema: REPOSITORY_STATS_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        projectRoot,
+        totals,
+        byLanguage,
+        topFiles,
+        ignoredDirectories: [...IGNORED_DIR_NAMES].sort((a, b) => a.localeCompare(b)),
+        truncated: walk.truncated,
+    };
+}

package/dist/review-comment-renderer.d.ts

@@ -0,0 +1,59 @@
+import type { IReviewPacket } from './review-packet.js';
+export interface IRenderReviewCommentOptions {
+    /** Optional title for the comment header. */
+    title?: string;
+    /** Include the AI reviewer instructions block. Default true. */
+    includeReviewerInstructions?: boolean;
+    /** Include the artifacts note at the bottom. Default true. */
+    includeArtifactsNote?: boolean;
+    /** Output format. 'github' wraps long sections in <details>, 'markdown' is plain. Default 'github'. */
+    format?: 'github' | 'markdown';
+    /** Truncate changed files list to N entries. Default 20. */
+    maxFiles?: number;
+    /** Truncate relevant rules list to N entries. Default 30. */
+    maxRules?: number;
+    /** Wrap long sections in <details> (GitHub-only). Default true when format='github'. */
+    collapseLongSections?: boolean;
+    /** Include boundary issues section. Default true. */
+    includeBoundaries?: boolean;
+    /** Include coverage summary when artifact is provided. */
+    includeCoverage?: boolean;
+    /** Include drift summary when artifact is provided. */
+    includeDrift?: boolean;
+    /** Optional boundaries artifact (parsed from `shrk check boundaries --json`). */
+    boundariesArtifact?: {
+        counts?: {
+            error?: number;
+            warning?: number;
+            info?: number;
+        };
+        rulesEvaluated?: number;
+    };
+    /** Optional coverage artifact (parsed from `shrk coverage --json`). */
+    coverageArtifact?: {
+        overall?: number;
+        categories?: readonly {
+            id: string;
+            score: number;
+        }[];
+    };
+    /** Optional drift artifact (parsed from `shrk drift --json`). */
+    driftArtifact?: {
+        stale?: readonly {
+            id: string;
+        }[];
+        total?: number;
+    };
+    /** Artifact links/names to render in the artifacts section. */
+    artifactLinks?: readonly {
+        name: string;
+        href?: string;
+    }[];
+}
+/**
+ * Render a review packet as a human-readable Markdown PR comment. The function
+ * accepts a packet read from JSON (the runtime shape may have extra fields —
+ * we read only the documented ones). Returns Markdown only.
+ */
+export declare function renderReviewComment(packet: IReviewPacket, options?: IRenderReviewCommentOptions): string;
+//# sourceMappingURL=review-comment-renderer.d.ts.map

package/dist/review-comment-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-comment-renderer.d.ts","sourceRoot":"","sources":["../src/review-comment-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uGAAuG;IACvG,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,kBAAkB,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/G,uEAAuE;IACvE,gBAAgB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IAC/F,iEAAiE;IACjE,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,+DAA+D;IAC/D,aAAa,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAsJR"}

package/dist/review-comment-renderer.js

@@ -0,0 +1,181 @@
+/**
+ * Render a review packet as a human-readable Markdown PR comment. The function
+ * accepts a packet read from JSON (the runtime shape may have extra fields —
+ * we read only the documented ones). Returns Markdown only.
+ */
+export function renderReviewComment(packet, options = {}) {
+    const includeReviewer = options.includeReviewerInstructions !== false;
+    const includeArtifacts = options.includeArtifactsNote !== false;
+    const includeBoundaries = options.includeBoundaries !== false;
+    const includeCoverage = options.includeCoverage === true && options.coverageArtifact !== undefined;
+    const includeDrift = options.includeDrift === true && options.driftArtifact !== undefined;
+    const format = options.format ?? 'github';
+    const maxFiles = options.maxFiles ?? 20;
+    const maxRules = options.maxRules ?? 30;
+    const collapse = options.collapseLongSections !== false && format === 'github';
+    const out = [];
+    const title = options.title ?? 'SharkCraft review';
+    out.push(`## ${title}`);
+    out.push('');
+    out.push(renderSummary(packet, options));
+    out.push('');
+    // Changed files — collapsible when long.
+    out.push('### Changed files');
+    out.push('');
+    if (packet.changedFiles.length === 0) {
+        out.push('_No changed files detected._');
+    }
+    else {
+        const slice = packet.changedFiles.slice(0, maxFiles);
+        const overflow = packet.changedFiles.length > maxFiles;
+        if (collapse && packet.changedFiles.length > 10) {
+            out.push('<details>');
+            out.push(`<summary>${packet.changedFiles.length} file(s) — click to expand</summary>`);
+            out.push('');
+        }
+        for (const f of slice)
+            out.push(`- \`${f}\``);
+        if (overflow)
+            out.push(`- …and ${packet.changedFiles.length - maxFiles} more.`);
+        if (collapse && packet.changedFiles.length > 10) {
+            out.push('');
+            out.push('</details>');
+        }
+    }
+    out.push('');
+    out.push('### Risks');
+    out.push('');
+    const risks = collectRisks(packet);
+    if (risks.length === 0) {
+        out.push('_No risks flagged by the deterministic checks._');
+    }
+    else {
+        for (const r of risks)
+            out.push(`- ${r}`);
+    }
+    out.push('');
+    if (includeBoundaries) {
+        out.push('### Boundary issues');
+        out.push('');
+        if (packet.boundaryViolations.length === 0) {
+            out.push('_No boundary violations in the change set._');
+        }
+        else {
+            for (const v of packet.boundaryViolations) {
+                out.push(`- **${v.severity.toUpperCase()}** \`${v.file}:${v.line}\` imports \`${v.importSpecifier}\` — rule \`${v.ruleId}\``);
+                if (v.message)
+                    out.push(`  - ${v.message}`);
+            }
+        }
+        out.push('');
+    }
+    if (includeCoverage) {
+        out.push('### Coverage summary');
+        out.push('');
+        const a = options.coverageArtifact;
+        if (typeof a.overall === 'number') {
+            out.push(`- Overall: **${a.overall}%**`);
+        }
+        if (Array.isArray(a.categories)) {
+            const low = a.categories.filter((c) => c.score < 80);
+            if (low.length === 0) {
+                out.push('- No categories below 80%.');
+            }
+            else {
+                for (const c of low)
+                    out.push(`- ${c.id}: ${c.score}%`);
+            }
+        }
+        out.push('');
+    }
+    if (includeDrift) {
+        out.push('### Drift summary');
+        out.push('');
+        const a = options.driftArtifact;
+        const stale = Array.isArray(a.stale) ? a.stale.length : 0;
+        out.push(`- Stale entries: **${stale}** of ${a.total ?? '?'}`);
+        if (Array.isArray(a.stale)) {
+            for (const s of a.stale.slice(0, 10))
+                out.push(`  - ${s.id}`);
+        }
+        out.push('');
+    }
+    out.push('### Suggested checks');
+    out.push('');
+    if (packet.verificationCommands.length === 0) {
+        out.push('_No verification commands configured._');
+    }
+    else {
+        for (const c of packet.verificationCommands) {
+            out.push(`- \`${c}\``);
+        }
+    }
+    out.push('');
+    if (packet.relevantRules.length > 0) {
+        out.push('### Relevant rules');
+        out.push('');
+        const rules = packet.relevantRules.slice(0, maxRules);
+        for (const r of rules) {
+            out.push(`- **${r.id}** — ${r.title}`);
+        }
+        if (packet.relevantRules.length > maxRules) {
+            out.push(`- …and ${packet.relevantRules.length - maxRules} more.`);
+        }
+        out.push('');
+    }
+    if (includeReviewer && packet.reviewerInstructions) {
+        out.push('### AI reviewer instructions');
+        out.push('');
+        if (collapse) {
+            out.push('<details>');
+            out.push('<summary>Click to expand</summary>');
+            out.push('');
+        }
+        out.push(packet.reviewerInstructions);
+        if (collapse) {
+            out.push('');
+            out.push('</details>');
+        }
+        out.push('');
+    }
+    if (options.artifactLinks && options.artifactLinks.length > 0) {
+        out.push('### Artifacts');
+        out.push('');
+        for (const a of options.artifactLinks) {
+            out.push(a.href ? `- [\`${a.name}\`](${a.href})` : `- \`${a.name}\``);
+        }
+        out.push('');
+    }
+    if (includeArtifacts) {
+        out.push('---');
+        out.push('_Generated by `shrk review render-comment`. The full review packet JSON is uploaded as a CI artifact._');
+    }
+    return out.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+function renderSummary(packet, options) {
+    const parts = [
+        `${packet.changedFiles.length} file(s) changed`,
+        `${packet.boundaryViolations.length} boundary violation(s)`,
+        `${packet.missingTestsHeuristic.length} potentially missing test(s)`,
+    ];
+    if (options.coverageArtifact?.overall !== undefined) {
+        parts.push(`coverage ${options.coverageArtifact.overall}%`);
+    }
+    if (options.driftArtifact?.stale && options.driftArtifact.stale.length > 0) {
+        parts.push(`${options.driftArtifact.stale.length} stale`);
+    }
+    return `**Summary:** ${parts.join(' · ')}`;
+}
+function collectRisks(packet) {
+    const out = [];
+    if (packet.boundaryViolations.length > 0) {
+        out.push(`${packet.boundaryViolations.length} boundary violation(s) in changed files — see below.`);
+    }
+    if (packet.missingTestsHeuristic.length > 0) {
+        out.push(`Possibly missing tests: ${packet.missingTestsHeuristic.length} source file(s) without a sibling spec.`);
+        for (const m of packet.missingTestsHeuristic.slice(0, 5)) {
+            out.push(`  • ${m}`);
+        }
+    }
+    return out;
+}

package/dist/review-comment-v2.d.ts

@@ -0,0 +1,9 @@
+import type { IReviewPacketV2 } from './review-packet-v2.js';
+export interface IRenderReviewCommentV2Options {
+    format?: 'github' | 'gitlab' | 'markdown' | 'html';
+    maxFiles?: number;
+    maxItems?: number;
+}
+export declare function renderReviewCommentV2Html(packet: IReviewPacketV2, options?: Omit<IRenderReviewCommentV2Options, 'format'>): string;
+export declare function renderReviewCommentV2(packet: IReviewPacketV2, options?: IRenderReviewCommentV2Options): string;
+//# sourceMappingURL=review-comment-v2.d.ts.map

package/dist/review-comment-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-comment-v2.d.ts","sourceRoot":"","sources":["../src/review-comment-v2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,QAAQ,CAAM,GAC1D,MAAM,CA8GR;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CA6FR"}