projscan 2.2.0 → 2.9.0

package/dist/core/adoption.js

@@ -0,0 +1,392 @@
+import { execFile } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { PLUGIN_PREVIEW_FLAG, discoverPluginManifests } from './plugins.js';
+const execFileAsync = promisify(execFile);
+export const MCP_CLIENT_IDS = [
+    'all',
+    'claude-desktop',
+    'claude-code',
+    'cursor',
+    'codex',
+    'continue',
+    'windsurf',
+    'cline',
+    'zed',
+    'gemini',
+];
+const INSTALL = {
+    command: 'npm install -g projscan',
+    runWithoutInstall: 'npx projscan',
+    mcpServerCommand: 'npx -y projscan mcp',
+};
+const SERVER = {
+    command: 'npx',
+    args: ['-y', 'projscan', 'mcp'],
+};
+const CLIENTS = {
+    'claude-desktop': {
+        client: 'claude-desktop',
+        displayName: 'Claude Desktop',
+        whereToPaste: 'Claude Desktop MCP settings JSON.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Restart Claude Desktop after saving the config.'],
+    },
+    'claude-code': {
+        client: 'claude-code',
+        displayName: 'Claude Code',
+        whereToPaste: 'Claude Code MCP server settings.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Keep projscan as a stdio server so code never leaves the repo.'],
+    },
+    cursor: {
+        client: 'cursor',
+        displayName: 'Cursor',
+        whereToPaste: 'Cursor MCP settings, usually `.cursor/mcp.json` or Settings > MCP.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Open a repo before invoking projscan tools so the server starts in the project root.'],
+    },
+    codex: {
+        client: 'codex',
+        displayName: 'Codex CLI',
+        whereToPaste: 'Codex MCP server configuration.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: [
+            '[mcp_servers.projscan]',
+            'command = "npx"',
+            'args = ["-y", "projscan", "mcp"]',
+        ].join('\n'),
+        notes: ['Use this as a local stdio MCP server config; no projscan API key is required.'],
+    },
+    continue: {
+        client: 'continue',
+        displayName: 'Continue',
+        whereToPaste: 'Continue MCP server config.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Use alongside Continue context providers when agents need structured repo evidence.'],
+    },
+    windsurf: {
+        client: 'windsurf',
+        displayName: 'Windsurf',
+        whereToPaste: 'Windsurf MCP settings.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Run `projscan first-run` in the target repo if tools fail to start.'],
+    },
+    cline: {
+        client: 'cline',
+        displayName: 'Cline',
+        whereToPaste: 'Cline MCP settings JSON.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Keep the command as `npx` so Cline can launch the published server directly.'],
+    },
+    zed: {
+        client: 'zed',
+        displayName: 'Zed',
+        whereToPaste: 'Zed assistant MCP/context server settings.',
+        config: { context_servers: { projscan: SERVER } },
+        configText: JSON.stringify({ context_servers: { projscan: SERVER } }, null, 2),
+        notes: ['If your Zed build expects `mcpServers`, use the generic MCP JSON from `--client all`.'],
+    },
+    gemini: {
+        client: 'gemini',
+        displayName: 'Gemini CLI',
+        whereToPaste: 'Gemini CLI MCP settings.',
+        config: { mcpServers: { projscan: SERVER } },
+        configText: JSON.stringify({ mcpServers: { projscan: SERVER } }, null, 2),
+        notes: ['Use `npx -y projscan mcp` as the stdio server command.'],
+    },
+};
+export function isMcpClientId(value) {
+    return typeof value === 'string' && MCP_CLIENT_IDS.includes(value);
+}
+export function getMcpConfigGuide(client = 'all') {
+    if (client === 'all') {
+        return {
+            schemaVersion: 1,
+            client: 'all',
+            install: INSTALL,
+            configs: MCP_CLIENT_IDS.filter((id) => id !== 'all').map((id) => buildGuide(id)),
+        };
+    }
+    return buildGuide(client);
+}
+export function getWorkflowRecipes() {
+    return {
+        schemaVersion: 1,
+        recipes: [
+            {
+                id: 'before_edit',
+                name: 'Before Edit',
+                useWhen: 'Start here before an agent changes code.',
+                outcome: 'A proceed/caution/block gate plus the next tool calls that explain any risk.',
+                commands: [
+                    'projscan preflight --mode before_edit --format json',
+                    'projscan workplan --mode before_edit --format json',
+                ],
+                mcpTools: ['projscan_preflight', 'projscan_workplan'],
+                handoff: 'If preflight returns caution or block, follow suggestedNextActions before editing.',
+            },
+            {
+                id: 'bug_hunt',
+                name: 'Bug Hunt',
+                useWhen: 'Run a focused polish or stabilization pass.',
+                outcome: 'A ranked fix queue with evidence and verification commands.',
+                commands: [
+                    'projscan bug-hunt --format json',
+                    'projscan quality-scorecard --format json',
+                    'projscan regression-plan --level focused --format json',
+                ],
+                mcpTools: ['projscan_bug_hunt', 'projscan_quality_scorecard', 'projscan_regression_plan'],
+                handoff: 'Fix top-ranked targets first, then rerun the regression plan.',
+            },
+            {
+                id: 'release_approval',
+                name: 'Release Approval',
+                useWhen: 'Prepare a maintainer or CI environment approval packet.',
+                outcome: 'Version readiness, risks, regression commands, and website update copy in one loop.',
+                commands: [
+                    'projscan release-train --format json',
+                    'projscan evidence-pack --website-prompt --format json',
+                    'projscan regression-plan --level full --format json',
+                ],
+                mcpTools: ['projscan_release_train', 'projscan_evidence_pack', 'projscan_regression_plan'],
+                handoff: 'Use the evidence pack as the approval artifact; do not skip the full release gate.',
+            },
+            {
+                id: 'handoff',
+                name: 'Agent Handoff',
+                useWhen: 'Compress repo context for the next agent or a resumed session.',
+                outcome: 'A compact brief with focus items, guardrails, and suggested next actions.',
+                commands: [
+                    'projscan agent-brief --intent handoff --format json',
+                    'projscan handoff --format json',
+                ],
+                mcpTools: ['projscan_agent_brief', 'projscan_workplan'],
+                handoff: 'Paste the brief into the next agent session before asking it to edit.',
+            },
+            {
+                id: 'pre_merge',
+                name: 'Pre-Merge',
+                useWhen: 'Check a branch before merge or release tagging.',
+                outcome: 'Changed-file health, review verdict, taint flow evidence, and required checks.',
+                commands: [
+                    'projscan preflight --mode before_merge --format json',
+                    'projscan review --format json',
+                    'projscan regression-plan --level smoke --format json',
+                ],
+                mcpTools: ['projscan_preflight', 'projscan_review', 'projscan_regression_plan'],
+                handoff: 'Treat block as a hard stop and caution as a request for explicit review.',
+            },
+        ],
+    };
+}
+export async function computeFirstRunDiagnostics(rootPath) {
+    const diagnostics = [
+        checkNodeVersion(),
+        await checkPackageJson(rootPath),
+        await checkGit(rootPath),
+        await checkConfig(rootPath),
+        await checkTreeSitter(rootPath),
+        await checkPlugins(rootPath),
+        checkMcpStartup(),
+    ];
+    const overall = summarizeDiagnostics(diagnostics);
+    return {
+        schemaVersion: 1,
+        rootPath,
+        overall,
+        diagnostics,
+        nextCommands: [
+            'projscan init mcp --client all',
+            'projscan recipes',
+            'projscan preflight --mode before_edit --format json',
+            'projscan doctor',
+        ],
+    };
+}
+function buildGuide(client) {
+    return {
+        schemaVersion: 1,
+        install: INSTALL,
+        ...CLIENTS[client],
+    };
+}
+function checkNodeVersion() {
+    const major = Number.parseInt(process.versions.node.split('.')[0] ?? '0', 10);
+    if (Number.isFinite(major) && major >= 18) {
+        return {
+            id: 'node',
+            label: 'Node.js',
+            status: 'pass',
+            summary: `Node ${process.versions.node} satisfies projscan's >=18 requirement.`,
+        };
+    }
+    return {
+        id: 'node',
+        label: 'Node.js',
+        status: 'fail',
+        summary: `Node ${process.versions.node} is below projscan's >=18 requirement.`,
+        command: 'node --version',
+    };
+}
+async function checkPackageJson(rootPath) {
+    const file = path.join(rootPath, 'package.json');
+    try {
+        const raw = await fs.readFile(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const name = typeof parsed.name === 'string' ? parsed.name : path.basename(rootPath);
+        const scripts = parsed.scripts && typeof parsed.scripts === 'object' ? Object.keys(parsed.scripts).length : 0;
+        return {
+            id: 'package-json',
+            label: 'Package metadata',
+            status: 'pass',
+            summary: `Found package.json for ${name}.`,
+            detail: scripts > 0 ? `${scripts} npm script(s) detected for release/test recipes.` : 'No npm scripts detected.',
+        };
+    }
+    catch (err) {
+        return {
+            id: 'package-json',
+            label: 'Package metadata',
+            status: 'warn',
+            summary: 'No readable package.json found; Node dependency and script checks will be limited.',
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+async function checkGit(rootPath) {
+    try {
+        const inside = await git(rootPath, ['rev-parse', '--is-inside-work-tree']);
+        if (inside.stdout.trim() !== 'true') {
+            return {
+                id: 'git',
+                label: 'Git',
+                status: 'warn',
+                summary: 'This directory is not inside a Git worktree.',
+                detail: 'Review, changed-file, and pre-merge recipes need Git history.',
+            };
+        }
+        const status = await git(rootPath, ['status', '--short']);
+        const remote = await git(rootPath, ['remote']);
+        const dirty = status.stdout.trim().length > 0;
+        return {
+            id: 'git',
+            label: 'Git',
+            status: dirty ? 'warn' : 'pass',
+            summary: dirty ? 'Git worktree has local changes.' : 'Git worktree detected and clean.',
+            detail: remote.stdout.trim().length > 0 ? `Remotes: ${remote.stdout.trim().split(/\s+/).join(', ')}` : 'No git remote configured.',
+        };
+    }
+    catch (err) {
+        return {
+            id: 'git',
+            label: 'Git',
+            status: 'warn',
+            summary: 'Git metadata is unavailable.',
+            detail: err instanceof Error ? err.message : String(err),
+            command: 'git status --short',
+        };
+    }
+}
+async function checkConfig(rootPath) {
+    try {
+        await fs.access(path.join(rootPath, '.projscanrc.json'));
+        return {
+            id: 'projscan-config',
+            label: 'projscan config',
+            status: 'pass',
+            summary: 'Found .projscanrc.json.',
+        };
+    }
+    catch {
+        return {
+            id: 'projscan-config',
+            label: 'projscan config',
+            status: 'info',
+            summary: 'No .projscanrc.json yet; defaults are fine for first use.',
+            command: 'projscan init',
+        };
+    }
+}
+async function checkTreeSitter(rootPath) {
+    const candidates = [
+        path.join(rootPath, 'node_modules', 'web-tree-sitter', 'tree-sitter.wasm'),
+        path.join(rootPath, 'dist', 'grammars', 'web-tree-sitter.wasm'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            await fs.access(candidate);
+            return {
+                id: 'tree-sitter',
+                label: 'Tree-sitter runtime',
+                status: 'pass',
+                summary: 'Tree-sitter WASM runtime is present.',
+            };
+        }
+        catch {
+            // try next
+        }
+    }
+    return {
+        id: 'tree-sitter',
+        label: 'Tree-sitter runtime',
+        status: 'info',
+        summary: 'Tree-sitter runtime was not found in this project checkout.',
+        detail: 'This is normal when using npx; projscan ships its runtime with the package.',
+    };
+}
+async function checkPlugins(rootPath) {
+    const entries = await discoverPluginManifests(rootPath);
+    if (entries.length === 0) {
+        return {
+            id: 'plugins',
+            label: 'Local plugins',
+            status: 'info',
+            summary: 'No local plugin manifests found.',
+            detail: `Set ${PLUGIN_PREVIEW_FLAG}=1 only when you want projscan to execute trusted local plugins.`,
+            command: 'projscan plugin init --kind analyzer --name policy',
+        };
+    }
+    const broken = entries.filter((entry) => entry.manifest === null);
+    return {
+        id: 'plugins',
+        label: 'Local plugins',
+        status: broken.length > 0 ? 'warn' : 'pass',
+        summary: broken.length > 0
+            ? `${broken.length} of ${entries.length} plugin manifest(s) need attention.`
+            : `${entries.length} plugin manifest(s) validate.`,
+        command: 'projscan plugin list',
+    };
+}
+function checkMcpStartup() {
+    return {
+        id: 'mcp-startup',
+        label: 'MCP startup',
+        status: 'pass',
+        summary: 'Use stdio startup for every MCP client.',
+        detail: INSTALL.mcpServerCommand,
+        command: 'npx -y projscan mcp',
+    };
+}
+function summarizeDiagnostics(diagnostics) {
+    if (diagnostics.some((diagnostic) => diagnostic.status === 'fail'))
+        return 'fail';
+    if (diagnostics.some((diagnostic) => diagnostic.status === 'warn'))
+        return 'warn';
+    return 'pass';
+}
+async function git(rootPath, args) {
+    return execFileAsync('git', args, {
+        cwd: rootPath,
+        timeout: 5000,
+        maxBuffer: 1024 * 1024,
+    });
+}
+//# sourceMappingURL=adoption.js.map

package/dist/core/adoption.js.map

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

package/dist/core/agentBrief.d.ts

@@ -0,0 +1,6 @@
+import type { AgentBriefIntent, AgentBriefReport } from '../types.js';
+export interface ComputeAgentBriefOptions {
+    intent?: AgentBriefIntent;
+    maxItems?: number;
+}
+export declare function computeAgentBrief(rootPath: string, options?: ComputeAgentBriefOptions): Promise<AgentBriefReport>;

package/dist/core/agentBrief.js

@@ -0,0 +1,192 @@
+import { analyzeHotspots } from './hotspotAnalyzer.js';
+import { collectIssues } from './issueEngine.js';
+import { scanRepository } from './repositoryScanner.js';
+import { buildRiskNow } from './sessionResources.js';
+import { applyConfigToIssues, loadConfig } from '../utils/config.js';
+import { calculateScore } from '../utils/scoreCalculator.js';
+const DEFAULT_MAX_ITEMS = 6;
+export async function computeAgentBrief(rootPath, options = {}) {
+    const intent = normalizeIntent(options.intent);
+    const maxItems = normalizeMax(options.maxItems);
+    const configResult = await loadConfig(rootPath).catch(() => ({ config: { ignore: [] } }));
+    const scan = await scanRepository(rootPath, { ignore: configResult.config.ignore });
+    const issues = applyConfigToIssues(await collectIssues(rootPath, scan.files), configResult.config);
+    const health = calculateScore(issues);
+    const [riskNow, hotspots] = await Promise.all([
+        safeRiskNow(rootPath),
+        safeHotspots(rootPath, scan.files, issues, maxItems),
+    ]);
+    const allFocus = rankFocus([
+        ...issues.slice(0, maxItems * 2).map(issueToFocus),
+        ...riskNow.conflicts.map(conflictToFocus),
+        ...(hotspots.available ? hotspots.hotspots.map(hotspotToFocus) : []),
+    ]);
+    const focus = allFocus.length > 0 ? allFocus.slice(0, maxItems) : [baselineFocus(intent)];
+    const guardrails = buildGuardrails(intent);
+    return {
+        schemaVersion: 1,
+        intent,
+        summary: summarize(intent, focus, health),
+        health,
+        context: {
+            totalFiles: scan.totalFiles,
+            totalDirectories: scan.totalDirectories,
+            topDirectories: topDirectories(scan.files),
+            touchedFiles: riskNow.touchedFiles.slice(0, 12),
+            conflicts: riskNow.conflicts.length,
+        },
+        focus,
+        guardrails,
+        suggestedNextActions: suggestedActions(focus, guardrails),
+        ...(allFocus.length > focus.length || riskNow.touchedFiles.length > 12 ? { truncated: true } : {}),
+    };
+}
+async function safeRiskNow(rootPath) {
+    try {
+        return await buildRiskNow(rootPath);
+    }
+    catch {
+        return { touchedFiles: [], conflicts: [] };
+    }
+}
+async function safeHotspots(rootPath, files, issues, limit) {
+    try {
+        return await analyzeHotspots(rootPath, files, issues, { limit });
+    }
+    catch (err) {
+        return {
+            available: false,
+            reason: err instanceof Error ? err.message : String(err),
+            window: { since: null, commitsScanned: 0 },
+            hotspots: [],
+            totalFilesRanked: 0,
+        };
+    }
+}
+function issueToFocus(issue) {
+    const files = issueFiles(issue);
+    return {
+        id: `ab-issue-${issue.id}`,
+        priority: severityPriority(issue.severity),
+        title: issue.title,
+        why: issue.description,
+        files,
+        commands: ['projscan doctor --format json', `projscan explain-issue ${issue.id} --format json`],
+    };
+}
+function conflictToFocus(conflict, index) {
+    return {
+        id: `ab-conflict-${index + 1}`,
+        priority: conflict.severity === 'error' ? 'p0' : 'p1',
+        title: 'Resolve coordination conflict',
+        why: conflict.message,
+        files: conflict.files,
+        commands: ['projscan session touched --format json', 'projscan agent-brief --format json'],
+    };
+}
+function hotspotToFocus(hotspot) {
+    return {
+        id: `ab-hotspot-${slug(hotspot.relativePath)}`,
+        priority: hotspot.riskScore >= 70 ? 'p0' : hotspot.riskScore >= 30 ? 'p1' : 'p2',
+        title: `Inspect hotspot ${hotspot.relativePath}`,
+        why: hotspot.reasons[0] ?? `Risk score ${Math.round(hotspot.riskScore)}`,
+        files: [hotspot.relativePath],
+        commands: [`projscan file ${hotspot.relativePath} --format json`, 'projscan hotspots --format json'],
+    };
+}
+function baselineFocus(intent) {
+    return {
+        id: 'ab-baseline',
+        priority: 'p2',
+        title: 'Keep the clean baseline reproducible',
+        why: `No immediate focus targets were found for ${intent}. Preserve the baseline with repeatable checks before handoff.`,
+        files: [],
+        commands: ['projscan doctor --format json', 'projscan preflight --mode before_edit --format json'],
+    };
+}
+function buildGuardrails(intent) {
+    return [
+        {
+            id: 'ab-guardrail-health',
+            label: 'Health check',
+            reason: 'Start with the fastest repo-wide signal before editing.',
+            command: 'projscan doctor --format json',
+        },
+        {
+            id: 'ab-guardrail-preflight',
+            label: 'Preflight check',
+            reason: 'Confirm the current session is safe for the selected intent.',
+            command: intent === 'release'
+                ? 'projscan preflight --mode before_merge --format json'
+                : 'projscan preflight --mode before_edit --format json',
+        },
+        {
+            id: 'ab-guardrail-tests',
+            label: 'Regression check',
+            reason: 'Keep the brief tied to repeatable verification.',
+            command: intent === 'release' ? 'projscan regression-plan --level focused --format json' : 'npm test',
+        },
+    ];
+}
+function rankFocus(items) {
+    const seen = new Set();
+    return items
+        .filter((item) => {
+        if (seen.has(item.id))
+            return false;
+        seen.add(item.id);
+        return true;
+    })
+        .sort((a, b) => priorityRank(a.priority) - priorityRank(b.priority) || a.id.localeCompare(b.id));
+}
+function suggestedActions(focus, guardrails) {
+    return [
+        ...focus.slice(0, 5).map((item) => ({ label: item.title, command: item.commands[0] })),
+        ...guardrails.map((guardrail) => ({ label: guardrail.label, command: guardrail.command })),
+    ].slice(0, 10);
+}
+function summarize(intent, focus, health) {
+    return `agent brief: ${intent} has ${focus.length} focus item(s), health ${health.grade} (${health.score})`;
+}
+function topDirectories(files) {
+    const counts = new Map();
+    for (const file of files) {
+        const dir = file.directory || '.';
+        counts.set(dir, (counts.get(dir) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .map(([directory, count]) => ({ directory, files: count }))
+        .sort((a, b) => b.files - a.files || a.directory.localeCompare(b.directory))
+        .slice(0, 8);
+}
+function issueFiles(issue) {
+    return [...new Set((issue.locations ?? []).map((location) => location.file).filter(Boolean))];
+}
+function normalizeIntent(value) {
+    if (value === 'bug_hunt' || value === 'release' || value === 'refactor' || value === 'hardening')
+        return value;
+    return 'next_agent';
+}
+function normalizeMax(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return DEFAULT_MAX_ITEMS;
+    return Math.max(1, Math.min(20, Math.floor(value)));
+}
+function severityPriority(severity) {
+    if (severity === 'error')
+        return 'p0';
+    if (severity === 'warning')
+        return 'p1';
+    return 'p2';
+}
+function priorityRank(priority) {
+    if (priority === 'p0')
+        return 0;
+    if (priority === 'p1')
+        return 1;
+    return 2;
+}
+function slug(value) {
+    return value.replace(/[^a-zA-Z0-9]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase() || 'root';
+}
+//# sourceMappingURL=agentBrief.js.map

package/dist/core/agentBrief.js.map

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

package/dist/core/bugHunt.d.ts

@@ -0,0 +1,6 @@
+import type { BugHuntReport } from '../types.js';
+export interface ComputeBugHuntOptions {
+    maxFindings?: number;
+    since?: string;
+}
+export declare function computeBugHunt(rootPath: string, options?: ComputeBugHuntOptions): Promise<BugHuntReport>;