projscan 4.7.0 → 4.8.0

package/dist/reporters/htmlReviewReporter.js

@@ -0,0 +1,94 @@
+import { escapeHtml, htmlShell, signed } from './htmlShared.js';
+export function reportReviewHtml(report) {
+    if (!report.available) {
+        console.log(unavailableReviewHtml(report));
+        return;
+    }
+    console.log(htmlShell(`PR Review (${reviewTitleLabel(report)})`, reviewBodyHtml(report)));
+}
+function unavailableReviewHtml(report) {
+    return htmlShell('PR Review — unavailable', `<h1>PR Review</h1><p class="muted">${escapeHtml(report.reason ?? 'Review unavailable.')}</p>`);
+}
+function reviewBodyHtml(report) {
+    const verdictLabel = reviewVerdictLabel(report);
+    return `
+<h1>PR Review</h1>
+<div class="card">
+<p class="muted">base <code>${escapeHtml(report.base.ref)}</code> (${report.base.resolvedSha?.slice(0, 7) ?? '?'}) → head <code>${escapeHtml(report.head.ref)}</code> (${report.head.resolvedSha?.slice(0, 7) ?? '?'})</p>
+<p class="verdict-${report.verdict}" style="font-size: 1.4rem; margin: 0.5rem 0;">${verdictLabel}</p>
+<ul>${report.summary.map((s) => `<li>${escapeHtml(s)}</li>`).join('\n')}</ul>
+</div>
+<h2>Changed files</h2>
+${changedFilesHtml(report)}
+${cyclesHtml(report)}
+${riskyFunctionsHtml(report)}
+${dependencyChangesHtml(report)}
+`;
+}
+function reviewTitleLabel(report) {
+    return reviewVerdictLabel(report).replace(/[^A-Za-z]/g, '').trim();
+}
+function reviewVerdictLabel(report) {
+    if (report.verdict === 'block')
+        return '🚫 BLOCK';
+    if (report.verdict === 'review')
+        return '👀 REVIEW';
+    return '✅ OK';
+}
+function changedFilesHtml(report) {
+    if (report.changedFiles.length === 0)
+        return '<p class="muted">No structural changes.</p>';
+    return `<table>
+<thead><tr><th>File</th><th>Status</th><th class="right">Risk</th><th class="right">CC</th><th class="right">ΔCC</th></tr></thead>
+<tbody>${report.changedFiles
+        .slice(0, 100)
+        .map((f) => `<tr>
+<td><code>${escapeHtml(f.relativePath)}</code></td>
+<td class="muted">${f.status}</td>
+<td class="right">${f.riskScore !== null ? f.riskScore.toFixed(1) : '-'}</td>
+<td class="right">${f.cyclomaticComplexity ?? '-'}</td>
+<td class="right">${f.cyclomaticDelta === null ? '-' : signed(f.cyclomaticDelta)}</td>
+</tr>`)
+        .join('\n')}</tbody>
+</table>`;
+}
+function cyclesHtml(report) {
+    if (report.newCycles.length === 0)
+        return '';
+    return `<h2>New / expanded cycles</h2>
+<ul>${report.newCycles
+        .map((c) => `<li><span class="tag tag-${c.classification}">${c.classification}</span> (${c.size} files): ${c.files.map((f) => `<code>${escapeHtml(f)}</code>`).join(' → ')}</li>`)
+        .join('\n')}</ul>`;
+}
+function riskyFunctionsHtml(report) {
+    if (report.riskyFunctions.length === 0)
+        return '';
+    return `<h2>Risky functions</h2>
+<table>
+<thead><tr><th>Function</th><th>File</th><th class="right">CC</th><th>Reason</th><th>Δ</th></tr></thead>
+<tbody>${report.riskyFunctions
+        .slice(0, 50)
+        .map((fn) => `<tr>
+<td><code>${escapeHtml(fn.name)}</code></td>
+<td><code>${escapeHtml(fn.file)}</code>:L${fn.line}</td>
+<td class="right">${fn.cyclomaticComplexity}</td>
+<td class="muted">${fn.reason}</td>
+<td>${fn.baseCc === null ? 'new' : `${fn.baseCc} → ${fn.cyclomaticComplexity}`}</td>
+</tr>`)
+        .join('\n')}</tbody>
+</table>`;
+}
+function dependencyChangesHtml(report) {
+    if (report.dependencyChanges.length === 0)
+        return '';
+    return `<h2>Dependency changes</h2>${report.dependencyChanges
+        .map((d) => `
+<h3>${escapeHtml(d.manifestFile)}${d.workspace ? ` <span class="muted">(${escapeHtml(d.workspace)})</span>` : ''}</h3>
+<ul>
+${d.added.map((a) => `<li>➕ <code>${escapeHtml(a.name)}@${escapeHtml(a.version)}</code> <span class="muted">(${a.kind})</span></li>`).join('\n')}
+${d.removed.map((r) => `<li>➖ <code>${escapeHtml(r.name)}@${escapeHtml(r.version)}</code> <span class="muted">(${r.kind})</span></li>`).join('\n')}
+${d.bumped.map((b) => `<li>🔄 <code>${escapeHtml(b.name)}</code>: ${escapeHtml(b.from)} → ${escapeHtml(b.to)} <span class="muted">(${b.kind})</span></li>`).join('\n')}
+</ul>`)
+        .join('\n')}`;
+}
+//# sourceMappingURL=htmlReviewReporter.js.map

package/dist/reporters/htmlReviewReporter.js.map

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

package/dist/reporters/htmlShared.d.ts

@@ -0,0 +1,7 @@
+import type { ReportControlsMetadata } from '../core/reportScope.js';
+/** Wrap inner HTML in a complete document. Title is required for accessibility. */
+export declare function htmlShell(title: string, bodyHtml: string): string;
+export declare function escapeHtml(s: string): string;
+export declare function severityIcon(s: 'info' | 'warning' | 'error'): string;
+export declare function signed(n: number): string;
+export declare function reportControlsHtml(reportControls: ReportControlsMetadata | undefined): string;

package/dist/reporters/htmlShared.js

@@ -0,0 +1,106 @@
+const STYLE = `
+:root {
+  color-scheme: light dark;
+}
+* { box-sizing: border-box; }
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  margin: 0;
+  padding: 2rem;
+  max-width: 1100px;
+  margin-inline: auto;
+  line-height: 1.5;
+  color: #222;
+  background: #fafafa;
+}
+@media (prefers-color-scheme: dark) {
+  body { color: #ddd; background: #181818; }
+  .card { background: #222; border-color: #333; }
+  table { background: #222; }
+  th { background: #2a2a2a; }
+  tr:nth-child(even) td { background: #1f1f1f; }
+  code { background: #2a2a2a; }
+  a { color: #6cb6ff; }
+}
+h1 { margin-top: 0; font-size: 1.6rem; }
+h2 { margin-top: 2rem; font-size: 1.2rem; border-bottom: 1px solid #ccc; padding-bottom: 0.3rem; }
+.card {
+  background: #fff;
+  border: 1px solid #ddd;
+  border-radius: 8px;
+  padding: 1rem 1.2rem;
+  margin-bottom: 1rem;
+}
+.score { font-size: 2.5rem; font-weight: 700; }
+.grade-A, .grade-A\\+ { color: #1a8a4a; }
+.grade-B { color: #4a8a1a; }
+.grade-C { color: #c79100; }
+.grade-D { color: #d6582d; }
+.grade-F { color: #d63333; }
+table { width: 100%; border-collapse: collapse; margin: 0.5rem 0; background: #fff; }
+th, td { padding: 0.4rem 0.6rem; text-align: left; border-bottom: 1px solid #eee; }
+th { background: #f3f3f3; font-weight: 600; }
+tr:nth-child(even) td { background: #f9f9f9; }
+code { background: #f0f0f0; padding: 0.05em 0.4em; border-radius: 3px; font-size: 0.95em; }
+.severity-error { color: #d63333; }
+.severity-warning { color: #c79100; }
+.severity-info { color: #4a6a8a; }
+.muted { color: #888; font-size: 0.9rem; }
+.verdict-ok { color: #1a8a4a; font-weight: 700; }
+.verdict-review { color: #c79100; font-weight: 700; }
+.verdict-block { color: #d63333; font-weight: 700; }
+.right { text-align: right; }
+.tag { display: inline-block; padding: 0.05em 0.5em; border-radius: 3px; background: #e8e8e8; font-size: 0.85em; }
+.tag-new { background: #ffd6d6; color: #8a0000; }
+.tag-expanded { background: #fff3c4; color: #6a4a00; }
+`.trim();
+/** Wrap inner HTML in a complete document. Title is required for accessibility. */
+export function htmlShell(title, bodyHtml) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(title)}</title>
+<style>${STYLE}</style>
+</head>
+<body>
+${bodyHtml}
+<footer class="muted" style="margin-top: 3rem; padding-top: 1rem; border-top: 1px solid #ccc;">
+Generated by <a href="https://github.com/abhiyoheswaran1/projscan">projscan</a> at ${new Date().toISOString()}
+</footer>
+</body>
+</html>`;
+}
+export function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+export function severityIcon(s) {
+    switch (s) {
+        case 'error':
+            return '✕';
+        case 'warning':
+            return '!';
+        default:
+            return 'i';
+    }
+}
+export function signed(n) {
+    return n >= 0 ? `+${n}` : String(n);
+}
+export function reportControlsHtml(reportControls) {
+    if (!reportControls)
+        return '';
+    const redaction = reportControls.redactPaths
+        ? (reportControls.pathLabelFormat ?? 'enabled')
+        : 'disabled';
+    return `<div class="card">
+<strong>Report controls:</strong> active; scopes: ${reportControls.scopeCount}; path redaction: ${escapeHtml(redaction)}.
+</div>`;
+}
+//# sourceMappingURL=htmlShared.js.map

package/dist/reporters/htmlShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlShared.js","sourceRoot":"","sources":["../../src/reporters/htmlShared.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDb,CAAC,IAAI,EAAE,CAAC;AAET,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,QAAgB;IACvD,OAAO;;;;;SAKA,UAAU,CAAC,KAAK,CAAC;SACjB,KAAK;;;EAGZ,QAAQ;;qFAE2E,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;QAGrG,CAAC;AACT,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAA+B;IAC1D,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,OAAO;YACV,OAAO,GAAG,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,cAAkD;IACnF,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW;QAC1C,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,IAAI,SAAS,CAAC;QAC/C,CAAC,CAAC,UAAU,CAAC;IACf,OAAO;oDAC2C,cAAc,CAAC,UAAU,qBAAqB,UAAU,CAAC,SAAS,CAAC;OAChH,CAAC;AACR,CAAC"}

package/dist/tool-manifest.json

@@ -1,8 +1,8 @@
 {
   "name": "projscan",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "mcpProtocolVersion": null,
-  "generatedAt": "2026-06-17T22:15:49.227Z",
+  "generatedAt": "2026-06-18T04:20:35.546Z",
   "toolCount": 45,
   "tools": [
     {

package/dist/types/preflight.d.ts

@@ -105,6 +105,25 @@ export interface PreflightEvidence {
             medium: number;
         };
         contendedClaims: number;
+        commandPath?: string;
+        command?: string;
+        localOnly?: true;
+        currentWorktree?: {
+            path: string;
+            branch: string | null;
+            changedFileCount: number;
+            uncommittedChangedFileCount: number;
+            baseRef: string | null;
+        } | null;
+        validationWorkflow?: Array<{
+            command: string;
+            purpose: string;
+        }>;
+        sessionSeparation?: {
+            currentEvidence: string;
+            rememberedContext: string;
+            command: string;
+        };
     };
 }
 export interface PreflightReport {