projscan 0.9.0 → 0.9.2

package/dist/mcp/tools.js

@@ -197,7 +197,7 @@ const tools = [
     },
     {
         name: 'projscan_outdated',
-        description: 'Compare declared vs installed versions of every package. Reports drift (patch/minor/major). Offline — does not hit the npm registry. Supports cursor pagination.',
+        description: 'Compare declared vs installed versions of every package. Reports drift (patch/minor/major). Offline - does not hit the npm registry. Supports cursor pagination.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -271,7 +271,7 @@ const tools = [
     },
     {
         name: 'projscan_coverage',
-        description: 'Join test coverage with hotspot risk. Returns files ranked by "risk × uncovered fraction" — the scariest untested files. Requires a coverage file at coverage/lcov.info, coverage/coverage-final.json, or coverage/coverage-summary.json.',
+        description: 'Join test coverage with hotspot risk. Returns files ranked by "risk × uncovered fraction" - the scariest untested files. Requires a coverage file at coverage/lcov.info, coverage/coverage-final.json, or coverage/coverage-summary.json.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -311,7 +311,7 @@ const tools = [
     },
     {
         name: 'projscan_graph',
-        description: 'Query the AST-based code graph directly. Returns imports, exports, importers, or symbol definitions for a file or symbol. Agents should prefer this over analyze/doctor/explain for targeted structural questions — it is much cheaper and more accurate.',
+        description: 'Query the AST-based code graph directly. Returns imports, exports, importers, or symbol definitions for a file or symbol. Agents should prefer this over analyze/doctor/explain for targeted structural questions - it is much cheaper and more accurate.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -421,7 +421,7 @@ const tools = [
             const cached = await loadCachedGraph(rootPath);
             const graph = await buildCodeGraph(rootPath, scan.files, cached);
             await saveCachedGraph(rootPath, graph);
-            // Files scope — simple substring scan; ranking adds no value
+            // Files scope - simple substring scan; ranking adds no value
             if (scope === 'files') {
                 const q = query.toLowerCase();
                 const all = scan.files
@@ -430,7 +430,7 @@ const tools = [
                 const page = paginate(all, readPageParams(args), listChecksum(all));
                 return { scope, query, matches: page.items, total: page.total, nextCursor: page.nextCursor };
             }
-            // Symbols scope — walk the graph's export table; rank exact/prefix/substring
+            // Symbols scope - walk the graph's export table; rank exact/prefix/substring
             if (scope === 'symbols') {
                 const q = query.toLowerCase();
                 const rawMatches = [];
@@ -453,7 +453,7 @@ const tools = [
                 const page = paginate(cleaned, readPageParams(args), listChecksum(cleaned));
                 return { scope, query, matches: page.items, total: page.total, nextCursor: page.nextCursor };
             }
-            // Content or auto scope — lexical BM25 by default, optionally semantic or hybrid
+            // Content or auto scope - lexical BM25 by default, optionally semantic or hybrid
             const mode = String(args.mode ?? 'lexical');
             const index = await buildSearchIndex(rootPath, scan.files, graph);
             const lexicalHits = searchIndex(index, query, { limit });
@@ -471,7 +471,7 @@ const tools = [
                     nextCursor: page.nextCursor,
                 };
             }
-            // Semantic or hybrid — both require the peer
+            // Semantic or hybrid - both require the peer
             const hasSemantic = await isSemanticAvailable();
             if (!hasSemantic) {
                 return {
@@ -518,7 +518,7 @@ const tools = [
                     nextCursor: page.nextCursor,
                 };
             }
-            // Hybrid — reciprocal rank fusion
+            // Hybrid - reciprocal rank fusion
             const fused = reciprocalRankFusion([lexicalHits, semHits]).slice(0, limit);
             const enriched = await attachExcerpts(rootPath, fused.map((f) => ({
                 file: f.file,

package/dist/reporters/consoleReporter.js

@@ -127,7 +127,7 @@ export function reportCi(issues, threshold) {
     const pass = score >= threshold;
     const status = pass ? chalk.green('PASS') : chalk.red('FAIL');
     const gradeColor = grade === 'A' || grade === 'B' ? chalk.green : grade === 'C' ? chalk.yellow : chalk.red;
-    console.log(`projscan: ${gradeColor(chalk.bold(`${grade} (${score}/100)`))} — ${errors} error${errors !== 1 ? 's' : ''}, ${warnings} warning${warnings !== 1 ? 's' : ''}, ${infos} info — ${status} (threshold: ${threshold})`);
+    console.log(`projscan: ${gradeColor(chalk.bold(`${grade} (${score}/100)`))} - ${errors} error${errors !== 1 ? 's' : ''}, ${warnings} warning${warnings !== 1 ? 's' : ''}, ${infos} info - ${status} (threshold: ${threshold})`);
     if (!pass) {
         for (const issue of issues) {
             console.log(`  ${severityIcon(issue.severity)} ${issue.title}`);
@@ -137,20 +137,20 @@ export function reportCi(issues, threshold) {
 // ── Report: diff ──────────────────────────────────────────
 export function reportDiff(diff) {
     console.log(header('Health Diff'));
-    const arrow = diff.scoreDelta > 0 ? chalk.green('↑') : diff.scoreDelta < 0 ? chalk.red('↓') : chalk.dim('—');
+    const arrow = diff.scoreDelta > 0 ? chalk.green('↑') : diff.scoreDelta < 0 ? chalk.red('↓') : chalk.dim('-');
     const delta = diff.scoreDelta > 0 ? `+${diff.scoreDelta}` : String(diff.scoreDelta);
     console.log(`\n  Score: ${diff.before.score} → ${diff.after.score} (${delta})  ${arrow}`);
     console.log(`  Grade: ${diff.before.grade} → ${diff.after.grade}`);
     if (diff.resolvedIssues.length > 0) {
         console.log(`\n  ${chalk.green('✓')} Resolved (${diff.resolvedIssues.length}):`);
         for (const title of diff.resolvedIssues) {
-            console.log(`    ${chalk.green('—')} ${title}`);
+            console.log(`    ${chalk.green('-')} ${title}`);
         }
     }
     if (diff.newIssues.length > 0) {
         console.log(`\n  ${chalk.red('✗')} New (${diff.newIssues.length}):`);
         for (const title of diff.newIssues) {
-            console.log(`    ${chalk.red('—')} ${title}`);
+            console.log(`    ${chalk.red('-')} ${title}`);
         }
     }
     if (diff.resolvedIssues.length === 0 && diff.newIssues.length === 0) {
@@ -182,7 +182,7 @@ export function reportDiff(diff) {
             if (hd.resolved.length > 0) {
                 console.log(`\n  ${chalk.green('✓')} No longer tracked (${hd.resolved.length}):`);
                 for (const delta of hd.resolved.slice(0, 5)) {
-                    console.log(`    ${chalk.green('—')}  ${delta.relativePath}`);
+                    console.log(`    ${chalk.green('-')}  ${delta.relativePath}`);
                 }
             }
         }
@@ -209,7 +209,7 @@ export function reportFixResults(results) {
             console.log(`  ${chalk.green('✔')} ${result.fix.title}`);
         }
         else {
-            console.log(`  ${chalk.red('✗')} ${result.fix.title} — ${chalk.dim(result.error ?? 'unknown error')}`);
+            console.log(`  ${chalk.red('✗')} ${result.fix.title} - ${chalk.dim(result.error ?? 'unknown error')}`);
         }
     }
     console.log('');
@@ -356,7 +356,7 @@ export function reportFileInspection(insp) {
             console.log(`  ${chalk.bold('Last change:')} ${h.daysSinceLastChange} days ago`);
         }
         if (h.busFactorOne) {
-            console.log(`  ${chalk.red('⚠')} Bus factor 1 — only one author has touched this.`);
+            console.log(`  ${chalk.red('⚠')} Bus factor 1 - only one author has touched this.`);
         }
         if (h.reasons.length > 0) {
             console.log(`  ${chalk.dim(h.reasons.join(', '))}`);
@@ -493,10 +493,10 @@ export function reportUpgrade(preview) {
         console.log(chalk.yellow(`\n  ${preview.reason ?? 'Upgrade preview unavailable'}\n`));
         return;
     }
-    console.log(header(`Upgrade Preview — ${preview.name}`));
+    console.log(header(`Upgrade Preview - ${preview.name}`));
     const drift = DRIFT_COLORS[preview.drift] ?? chalk.dim;
-    console.log(`  Declared:  ${chalk.dim(preview.declared ?? '—')}`);
-    console.log(`  Installed: ${chalk.bold(preview.installed ?? '—')}`);
+    console.log(`  Declared:  ${chalk.dim(preview.declared ?? '-')}`);
+    console.log(`  Installed: ${chalk.bold(preview.installed ?? '-')}`);
     console.log(`  Drift:     ${drift(preview.drift.toUpperCase())}`);
     console.log('');
     if (preview.breakingMarkers.length > 0) {
@@ -539,7 +539,7 @@ export function reportCoverage(report) {
         console.log(chalk.yellow(`\n  ${report.reason ?? 'Coverage report unavailable'}\n`));
         return;
     }
-    console.log(header('Coverage × Hotspots — "Scariest Untested Files"'));
+    console.log(header('Coverage × Hotspots - "Scariest Untested Files"'));
     const src = report.coverageSourceFile ? ` (${report.coverageSourceFile})` : '';
     console.log(chalk.dim(`  Source: ${report.coverageSource}${src}`));
     console.log('');

package/dist/reporters/markdownReporter.js

@@ -55,7 +55,7 @@ export function reportHealthMarkdown(issues) {
         lines.push('');
         for (const issue of issues) {
             const icon = issue.severity === 'error' ? '❌' : issue.severity === 'warning' ? '⚠️' : 'ℹ️';
-            lines.push(`- ${icon} **${issue.title}** — ${issue.description}`);
+            lines.push(`- ${icon} **${issue.title}** - ${issue.description}`);
         }
     }
     console.log(lines.join('\n'));
@@ -64,7 +64,7 @@ export function reportCiMarkdown(issues, threshold) {
     const { score, grade } = calculateScore(issues);
     const pass = score >= threshold;
     const lines = [
-        `# Projscan CI — ${pass ? 'PASS' : 'FAIL'}`,
+        `# Projscan CI - ${pass ? 'PASS' : 'FAIL'}`,
         '',
         `| Metric | Value |`,
         `| --- | --- |`,
@@ -77,14 +77,14 @@ export function reportCiMarkdown(issues, threshold) {
         lines.push('', '## Issues', '');
         for (const issue of issues) {
             const icon = issue.severity === 'error' ? '❌' : issue.severity === 'warning' ? '⚠️' : 'ℹ️';
-            lines.push(`- ${icon} **${issue.title}** — ${issue.description}`);
+            lines.push(`- ${icon} **${issue.title}** - ${issue.description}`);
         }
     }
     console.log(lines.join('\n'));
 }
 export function reportDiffMarkdown(diff) {
     const delta = diff.scoreDelta > 0 ? `+${diff.scoreDelta}` : String(diff.scoreDelta);
-    const arrow = diff.scoreDelta > 0 ? '↑' : diff.scoreDelta < 0 ? '↓' : '—';
+    const arrow = diff.scoreDelta > 0 ? '↑' : diff.scoreDelta < 0 ? '↓' : '-';
     const lines = [
         '# Health Diff',
         '',
@@ -224,7 +224,7 @@ export function reportFileMarkdown(insp) {
         if (h.daysSinceLastChange !== null)
             lines.push(`- **Last change:** ${h.daysSinceLastChange} days ago`);
         if (h.busFactorOne)
-            lines.push('- ⚠️ **Bus factor 1** — only one author has touched this.');
+            lines.push('- ⚠️ **Bus factor 1** - only one author has touched this.');
         if (h.reasons.length > 0)
             lines.push(`- ${h.reasons.join(', ')}`);
     }
@@ -232,7 +232,7 @@ export function reportFileMarkdown(insp) {
         lines.push('', '## Related Issues', '');
         for (const issue of insp.issues) {
             const icon = issue.severity === 'error' ? '❌' : issue.severity === 'warning' ? '⚠️' : 'ℹ️';
-            lines.push(`- ${icon} **${issue.title}** — ${issue.description}`);
+            lines.push(`- ${icon} **${issue.title}** - ${issue.description}`);
         }
     }
     if (insp.potentialIssues.length > 0) {
@@ -273,7 +273,7 @@ export function reportHotspotsMarkdown(report) {
     lines.push('| --- | ---: | --- | ---: | ---: | ---: | --- |');
     for (let i = 0; i < report.hotspots.length; i++) {
         const h = report.hotspots[i];
-        const reasons = h.reasons.length > 0 ? h.reasons.join(', ') : '—';
+        const reasons = h.reasons.length > 0 ? h.reasons.join(', ') : '-';
         lines.push(`| ${i + 1} | ${h.riskScore.toFixed(1)} | \`${h.relativePath}\` | ${h.churn} | ${h.lineCount} | ${h.issueCount} | ${reasons} |`);
     }
     console.log(lines.join('\n'));
@@ -298,7 +298,7 @@ export function reportOutdatedMarkdown(report) {
     lines.push('| Package | Scope | Declared | Installed | Drift |');
     lines.push('| --- | --- | --- | --- | --- |');
     for (const p of drifting) {
-        lines.push(`| \`${p.name}\` | ${p.scope === 'devDependency' ? 'dev' : 'prod'} | ${p.declared} | ${p.installed ?? '—'} | ${p.drift} |`);
+        lines.push(`| \`${p.name}\` | ${p.scope === 'devDependency' ? 'dev' : 'prod'} | ${p.declared} | ${p.installed ?? '-'} | ${p.drift} |`);
     }
     console.log(lines.join('\n'));
 }
@@ -313,7 +313,7 @@ export function reportAuditMarkdown(report) {
     }
     const s = report.summary;
     const total = s.critical + s.high + s.moderate + s.low + s.info;
-    lines.push(`**${total}** findings — ${s.critical} critical · ${s.high} high · ${s.moderate} moderate · ${s.low} low · ${s.info} info`);
+    lines.push(`**${total}** findings - ${s.critical} critical · ${s.high} high · ${s.moderate} moderate · ${s.low} low · ${s.info} info`);
     lines.push('');
     if (report.findings.length === 0) {
         lines.push('_No known vulnerabilities._');
@@ -330,15 +330,15 @@ export function reportAuditMarkdown(report) {
 }
 export function reportUpgradeMarkdown(preview) {
     const lines = [];
-    lines.push(`# Upgrade Preview — \`${preview.name}\``);
+    lines.push(`# Upgrade Preview - \`${preview.name}\``);
     lines.push('');
     if (!preview.available) {
         lines.push(`_${preview.reason ?? 'unavailable'}_`);
         console.log(lines.join('\n'));
         return;
     }
-    lines.push(`- Declared: \`${preview.declared ?? '—'}\``);
-    lines.push(`- Installed: \`${preview.installed ?? '—'}\``);
+    lines.push(`- Declared: \`${preview.declared ?? '-'}\``);
+    lines.push(`- Installed: \`${preview.installed ?? '-'}\``);
     lines.push(`- Drift: **${preview.drift}**`);
     lines.push('');
     if (preview.breakingMarkers.length > 0) {
@@ -383,8 +383,8 @@ export function reportCoverageMarkdown(report) {
     lines.push('| Priority | Coverage | Risk | Churn | File | Reasons |');
     lines.push('| ---: | ---: | ---: | ---: | --- | --- |');
     for (const e of report.entries) {
-        const cov = e.coverage === null ? '—' : `${e.coverage.toFixed(0)}%`;
-        const reasons = e.reasons.length > 0 ? e.reasons.join(', ') : '—';
+        const cov = e.coverage === null ? '-' : `${e.coverage.toFixed(0)}%`;
+        const reasons = e.reasons.length > 0 ? e.reasons.join(', ') : '-';
         lines.push(`| ${e.priority.toFixed(1)} | ${cov} | ${e.riskScore.toFixed(1)} | ${e.churn} | \`${e.relativePath}\` | ${reasons} |`);
     }
     console.log(lines.join('\n'));

package/dist/reporters/sarifReporter.js

@@ -2,7 +2,7 @@ const TOOL_INFO = {
     name: 'projscan',
     informationUri: 'https://github.com/abhiyoheswaran1/projscan',
     shortDescription: {
-        text: 'Instant codebase insights — doctor, x-ray, and architecture map.',
+        text: 'Instant codebase insights - doctor, x-ray, and architecture map.',
     },
 };
 const SEVERITY_TO_LEVEL = {

package/dist/utils/banner.d.ts

@@ -1,14 +1,14 @@
 /**
- * Full two-panel welcome screen — shown only on the default `projscan` command.
+ * Full two-panel welcome screen - shown only on the default `projscan` command.
  * Left panel: ASCII logo + version. Right panel: commands + what's new.
  */
 export declare function showBanner(): void;
 /**
- * Compact one-liner — shown on subcommands (doctor, fix, etc.).
+ * Compact one-liner - shown on subcommands (doctor, fix, etc.).
  */
 export declare function showCompactBanner(): void;
 /**
- * Help screen — shown by `projscan help`.
+ * Help screen - shown by `projscan help`.
  * Displays the full banner + detailed command reference.
  */
 export declare function showHelp(): void;

package/dist/utils/banner.js

@@ -14,7 +14,7 @@ function getVersion() {
     }
 }
 /**
- * Full two-panel welcome screen — shown only on the default `projscan` command.
+ * Full two-panel welcome screen - shown only on the default `projscan` command.
  * Left panel: ASCII logo + version. Right panel: commands + what's new.
  */
 export function showBanner() {
@@ -74,7 +74,7 @@ export function showBanner() {
     console.log('');
 }
 /**
- * Compact one-liner — shown on subcommands (doctor, fix, etc.).
+ * Compact one-liner - shown on subcommands (doctor, fix, etc.).
  */
 export function showCompactBanner() {
     const version = getVersion();
@@ -82,7 +82,7 @@ export function showCompactBanner() {
     console.log(`  ${chalk.cyan('◆')} ${chalk.white.bold('ProjScan')} ${chalk.dim(`v${version}`)}`);
 }
 /**
- * Help screen — shown by `projscan help`.
+ * Help screen - shown by `projscan help`.
  * Displays the full banner + detailed command reference.
  */
 export function showHelp() {
@@ -93,26 +93,26 @@ export function showHelp() {
     const g = chalk.gray;
     const commands = [
         { cmd: 'projscan', desc: 'Full project analysis (default)' },
-        { cmd: 'projscan doctor', desc: 'Health check — detect issues and score your project' },
-        { cmd: 'projscan hotspots', desc: 'Rank files by risk — churn × complexity × issues × ownership' },
+        { cmd: 'projscan doctor', desc: 'Health check - detect issues and score your project' },
+        { cmd: 'projscan hotspots', desc: 'Rank files by risk - churn × complexity × issues × ownership' },
         { cmd: 'projscan search <query>', desc: 'BM25-ranked search across content, symbols, and paths' },
-        { cmd: 'projscan file <path>', desc: 'Drill into a file — purpose, risk, ownership, issues' },
+        { cmd: 'projscan file <path>', desc: 'Drill into a file - purpose, risk, ownership, issues' },
         { cmd: 'projscan fix', desc: 'Auto-fix detected issues (interactive)' },
         { cmd: 'projscan fix -y', desc: 'Auto-fix without prompting' },
-        { cmd: 'projscan ci', desc: 'CI gate — exit 1 if score below threshold' },
+        { cmd: 'projscan ci', desc: 'CI gate - exit 1 if score below threshold' },
         { cmd: 'projscan ci --min-score 80', desc: 'Set custom minimum score' },
         { cmd: 'projscan ci --changed-only', desc: 'Gate only on issues in this PR\'s diff' },
         { cmd: 'projscan ci --format sarif', desc: 'Emit SARIF 2.1.0 for GitHub Code Scanning' },
         { cmd: 'projscan diff', desc: 'Compare current health against saved baseline' },
         { cmd: 'projscan diff --save-baseline', desc: 'Save current state as baseline' },
-        { cmd: 'projscan explain <file>', desc: 'Explain a file — purpose, imports, exports' },
+        { cmd: 'projscan explain <file>', desc: 'Explain a file - purpose, imports, exports' },
         { cmd: 'projscan diagram', desc: 'Show architecture layer diagram' },
         { cmd: 'projscan structure', desc: 'Show directory structure overview' },
         { cmd: 'projscan dependencies', desc: 'Analyze project dependencies' },
         { cmd: 'projscan outdated', desc: 'Declared-vs-installed drift (offline)' },
         { cmd: 'projscan audit', desc: 'Run npm audit; SARIF-ready vulnerability report' },
         { cmd: 'projscan upgrade <pkg>', desc: 'Preview upgrade impact (CHANGELOG + importers, offline)' },
-        { cmd: 'projscan coverage', desc: 'Coverage × hotspots — surface scariest untested files' },
+        { cmd: 'projscan coverage', desc: 'Coverage × hotspots - surface scariest untested files' },
         { cmd: 'projscan badge', desc: 'Generate a health badge for your README' },
         { cmd: 'projscan mcp', desc: 'Run as MCP server for AI agents (Claude Code, Cursor, …)' },
     ];

package/dist/utils/config.js

@@ -19,7 +19,7 @@ export async function loadConfig(rootPath, explicitPath) {
             raw = await fs.readFile(candidate, 'utf-8');
         }
         catch {
-            // File not present — try next candidate.
+            // File not present - try next candidate.
             continue;
         }
         const parsed = safeParse(raw, candidate);

package/dist/utils/packageJsonLocator.d.ts

@@ -5,7 +5,7 @@ export interface PackageJsonLocations {
 /**
  * Parse package.json and find the line number of each dependency name
  * (within dependencies, devDependencies, peerDependencies, optionalDependencies).
- * Line numbers are 1-based. Uses regex against the raw text — robust enough
+ * Line numbers are 1-based. Uses regex against the raw text - robust enough
  * for typical formatted package.json files.
  */
 export declare function findDependencyLines(rootPath: string): Promise<PackageJsonLocations | null>;

package/dist/utils/packageJsonLocator.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 /**
  * Parse package.json and find the line number of each dependency name
  * (within dependencies, devDependencies, peerDependencies, optionalDependencies).
- * Line numbers are 1-based. Uses regex against the raw text — robust enough
+ * Line numbers are 1-based. Uses regex against the raw text - robust enough
  * for typical formatted package.json files.
  */
 export async function findDependencyLines(rootPath) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "projscan",
-  "version": "0.9.0",
-  "description": "Agent-first code intelligence — MCP server (2025-03-26) with AST parsing, code graph, BM25 + optional semantic search, cursor pagination, progress notifications, and context-budgeted output; CLI on the side",
+  "version": "0.9.2",
+  "description": "Agent-first code intelligence. MCP server (2025-03-26) with AST parsing, code graph, BM25 + optional semantic search, cursor pagination, progress notifications, and context-budgeted output. CLI on the side.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",