projscan 4.14.0 → 4.15.0

package/dist/core/adoptionFirstRunDiagnostics.js

@@ -0,0 +1,240 @@
+import { execFile } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { INSTALL } from './adoptionMcpConfig.js';
+import { buildFirstTenMinutes } from './onboarding.js';
+import { PLUGIN_PREVIEW_FLAG, discoverPluginManifests } from './plugins.js';
+const execFileAsync = promisify(execFile);
+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);
+    const firstTenMinutes = buildFirstTenMinutes();
+    return {
+        schemaVersion: 1,
+        rootPath,
+        overall,
+        diagnostics,
+        firstTenMinutes,
+        nextCommands: dedupeCommands([
+            ...firstTenMinutes.commands.map((step) => step.command),
+            'projscan init mcp --client all',
+            'projscan recipes',
+            'projscan preflight --mode before_edit --format json',
+            'projscan doctor',
+        ]),
+    };
+}
+export 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) {
+    let inside;
+    try {
+        inside = await git(rootPath, ['rev-parse', '--is-inside-work-tree']);
+    }
+    catch (err) {
+        return {
+            id: 'git',
+            label: 'Git',
+            status: 'warn',
+            summary: 'Git metadata is unavailable.',
+            detail: err instanceof Error ? err.message : String(err),
+            command: 'git 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.',
+        };
+    }
+    let status;
+    try {
+        status = await git(rootPath, ['status', '--short']);
+    }
+    catch (err) {
+        return {
+            id: 'git',
+            label: 'Git',
+            status: 'warn',
+            summary: 'Git worktree detected, but status is unavailable.',
+            detail: formatGitError(err),
+            command: 'git status --short',
+        };
+    }
+    const remote = await git(rootPath, ['remote']).catch((err) => err);
+    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: gitRemoteDetail(remote),
+    };
+}
+function gitRemoteDetail(remote) {
+    if (isGitResult(remote)) {
+        return remote.stdout.trim().length > 0
+            ? `Remotes: ${remote.stdout.trim().split(/\s+/).join(', ')}`
+            : 'No git remote configured.';
+    }
+    return `Remote metadata unavailable: ${formatGitError(remote)}`;
+}
+function isGitResult(value) {
+    return typeof value === 'object' && value !== null && 'stdout' in value && !('code' in value);
+}
+function formatGitError(err) {
+    return err instanceof Error ? err.message.trim() : String(err);
+}
+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';
+}
+function dedupeCommands(commands) {
+    return [...new Set(commands)];
+}
+async function git(rootPath, args) {
+    return execFileAsync('git', args, {
+        cwd: rootPath,
+        timeout: 5000,
+        maxBuffer: 1024 * 1024,
+    });
+}
+//# sourceMappingURL=adoptionFirstRunDiagnostics.js.map

package/dist/core/adoptionFirstRunDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoptionFirstRunDiagnostics.js","sourceRoot":"","sources":["../../src/core/adoptionFirstRunDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5E,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAsB1C,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,QAAgB;IAC/D,MAAM,WAAW,GAAyB;QACxC,gBAAgB,EAAE;QAClB,MAAM,gBAAgB,CAAC,QAAQ,CAAC;QAChC,MAAM,QAAQ,CAAC,QAAQ,CAAC;QACxB,MAAM,WAAW,CAAC,QAAQ,CAAC;QAC3B,MAAM,eAAe,CAAC,QAAQ,CAAC;QAC/B,MAAM,YAAY,CAAC,QAAQ,CAAC;QAC5B,eAAe,EAAE;KAClB,CAAC;IACF,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,oBAAoB,EAAE,CAAC;IAC/C,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,QAAQ;QACR,OAAO;QACP,WAAW;QACX,eAAe;QACf,YAAY,EAAE,cAAc,CAAC;YAC3B,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;YACvD,gCAAgC;YAChC,kBAAkB;YAClB,qDAAqD;YACrD,iBAAiB;SAClB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,yCAAyC;SAChF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,wCAAwC;QAC9E,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0C,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrF,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,OAAO;YACL,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,kBAAkB;YACzB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,0BAA0B,IAAI,GAAG;YAC1C,MAAM,EACJ,OAAO,GAAG,CAAC;gBACT,CAAC,CAAC,GAAG,OAAO,mDAAmD;gBAC/D,CAAC,CAAC,0BAA0B;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,kBAAkB;YACzB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,oFAAoF;YAC7F,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,QAAgB;IACtC,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,8BAA8B;YACvC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACxD,OAAO,EAAE,qCAAqC;SAC/C,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,8CAA8C;YACvD,MAAM,EAAE,+DAA+D;SACxE,CAAC;IACJ,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,mDAAmD;YAC5D,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC;YAC3B,OAAO,EAAE,oBAAoB;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC/B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,kCAAkC;QACvF,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAoC;IAC3D,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACpC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC5D,CAAC,CAAC,2BAA2B,CAAC;IAClC,CAAC;IACD,OAAO,gCAAgC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,cAAc,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,yBAAyB;SACnC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,2DAA2D;YACpE,OAAO,EAAE,eAAe;SACzB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,CAAC;KAChE,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,OAAO;gBACL,EAAE,EAAE,aAAa;gBACjB,KAAK,EAAE,qBAAqB;gBAC5B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,sCAAsC;aAChD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,6DAA6D;QACtE,MAAM,EAAE,6EAA6E;KACtF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,kCAAkC;YAC3C,MAAM,EAAE,OAAO,mBAAmB,kEAAkE;YACpG,OAAO,EAAE,oDAAoD;SAC9D,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;IAClE,OAAO;QACL,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC3C,OAAO,EACL,MAAM,CAAC,MAAM,GAAG,CAAC;YACf,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,qCAAqC;YAC5E,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,+BAA+B;QACtD,OAAO,EAAE,sBAAsB;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,yCAAyC;QAClD,MAAM,EAAE,OAAO,CAAC,gBAAgB;QAChC,OAAO,EAAE,qBAAqB;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAiC;IAC7D,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAClF,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAClF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,QAAkB;IACxC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,QAAgB,EAAE,IAAc;IACjD,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;QAChC,GAAG,EAAE,QAAQ;QACb,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI,GAAG,IAAI;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/core/adoptionMcpConfig.d.ts

@@ -0,0 +1,27 @@
+export declare const MCP_CLIENT_IDS: readonly ["all", "claude-desktop", "claude-code", "cursor", "codex", "continue", "windsurf", "cline", "zed", "gemini"];
+export type McpClientId = (typeof MCP_CLIENT_IDS)[number];
+export type SingleMcpClientId = Exclude<McpClientId, 'all'>;
+export interface McpConfigInstall {
+    command: string;
+    runWithoutInstall: string;
+    mcpServerCommand: string;
+}
+export interface McpConfigGuide {
+    schemaVersion: 1;
+    client: SingleMcpClientId;
+    displayName: string;
+    whereToPaste: string;
+    install: McpConfigInstall;
+    config: Record<string, unknown>;
+    configText: string;
+    notes: string[];
+}
+export interface McpConfigCatalog {
+    schemaVersion: 1;
+    client: 'all';
+    install: McpConfigInstall;
+    configs: McpConfigGuide[];
+}
+export declare const INSTALL: McpConfigInstall;
+export declare function isMcpClientId(value: unknown): value is McpClientId;
+export declare function getMcpConfigGuide(client?: McpClientId): McpConfigCatalog | McpConfigGuide;

package/dist/core/adoptionMcpConfig.js

@@ -0,0 +1,123 @@
+export const MCP_CLIENT_IDS = [
+    'all',
+    'claude-desktop',
+    'claude-code',
+    'cursor',
+    'codex',
+    'continue',
+    'windsurf',
+    'cline',
+    'zed',
+    'gemini',
+];
+export 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);
+}
+function buildGuide(client) {
+    return {
+        schemaVersion: 1,
+        install: INSTALL,
+        ...CLIENTS[client],
+    };
+}
+//# sourceMappingURL=adoptionMcpConfig.js.map

package/dist/core/adoptionMcpConfig.js.map

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

package/dist/core/adoptionMcpDoctor.d.ts

@@ -0,0 +1,23 @@
+import type { McpClientId } from './adoptionMcpConfig.js';
+export interface McpSetupDoctorCheck {
+    id: string;
+    status: 'pass' | 'warn' | 'fail' | 'info';
+    summary: string;
+    detail?: string;
+}
+export interface McpSetupDoctorReport {
+    schemaVersion: 1;
+    client: McpClientId;
+    status: 'pass' | 'warn' | 'fail';
+    summary: string;
+    expected: {
+        command: string;
+        runWithoutInstall: string;
+        install: string;
+    };
+    whereToPaste: string;
+    configText: string;
+    checks: McpSetupDoctorCheck[];
+    nextCommands: string[];
+}
+export declare function computeMcpSetupDoctor(rootPath: string, client?: McpClientId): Promise<McpSetupDoctorReport>;

package/dist/core/adoptionMcpDoctor.js

@@ -0,0 +1,87 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { checkNodeVersion } from './adoptionFirstRunDiagnostics.js';
+import { getMcpConfigGuide, INSTALL } from './adoptionMcpConfig.js';
+export async function computeMcpSetupDoctor(rootPath, client = 'all') {
+    const guide = getMcpConfigGuide(client);
+    const configText = guide.client === 'all'
+        ? guide.configs.map((entry) => `# ${entry.displayName}\n${entry.configText}`).join('\n\n')
+        : guide.configText;
+    const whereToPaste = guide.client === 'all' ? 'Use the matching client-specific config block.' : guide.whereToPaste;
+    const checks = [
+        checkNodeVersion(),
+        {
+            id: 'server-command',
+            status: 'pass',
+            summary: 'MCP server command uses local stdio startup.',
+            detail: INSTALL.mcpServerCommand,
+        },
+        {
+            id: 'config-shape',
+            status: configText.includes('projscan') && configText.includes('npx') ? 'pass' : 'fail',
+            summary: 'Config snippet includes the projscan stdio server.',
+            detail: whereToPaste,
+        },
+        await checkProjectMcpConfig(rootPath, client),
+    ];
+    const status = checks.some((check) => check.status === 'fail')
+        ? 'fail'
+        : checks.some((check) => check.status === 'warn')
+            ? 'warn'
+            : 'pass';
+    return {
+        schemaVersion: 1,
+        client,
+        status,
+        summary: `${status}: ${client} MCP setup uses ${INSTALL.mcpServerCommand}`,
+        expected: {
+            command: INSTALL.mcpServerCommand,
+            runWithoutInstall: INSTALL.runWithoutInstall,
+            install: INSTALL.command,
+        },
+        whereToPaste,
+        configText,
+        checks,
+        nextCommands: [
+            'projscan init mcp --client all',
+            `projscan mcp doctor --client ${client} --format json`,
+            'npx -y projscan mcp',
+        ],
+    };
+}
+async function checkProjectMcpConfig(rootPath, client) {
+    const candidates = clientConfigCandidates(client);
+    for (const candidate of candidates) {
+        try {
+            const raw = await fs.readFile(path.join(rootPath, candidate), 'utf-8');
+            return {
+                id: 'project-config',
+                status: raw.includes('projscan') ? 'pass' : 'warn',
+                summary: raw.includes('projscan')
+                    ? `Found projscan in ${candidate}.`
+                    : `Found ${candidate}, but it does not mention projscan.`,
+                detail: candidate,
+            };
+        }
+        catch {
+            // try next
+        }
+    }
+    return {
+        id: 'project-config',
+        status: 'info',
+        summary: 'No project-local MCP config found; paste the snippet into the client settings if needed.',
+    };
+}
+function clientConfigCandidates(client) {
+    if (client === 'cursor')
+        return ['.cursor/mcp.json'];
+    if (client === 'continue')
+        return ['.continue/config.json'];
+    if (client === 'codex')
+        return ['.codex/config.toml'];
+    if (client === 'all')
+        return ['.cursor/mcp.json', '.continue/config.json', '.codex/config.toml'];
+    return [];
+}
+//# sourceMappingURL=adoptionMcpDoctor.js.map

package/dist/core/adoptionMcpDoctor.js.map

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

package/dist/core/adoptionWorkflowRecipes.d.ts

@@ -0,0 +1,14 @@
+export interface AgentWorkflowRecipe {
+    id: string;
+    name: string;
+    useWhen: string;
+    outcome: string;
+    commands: string[];
+    mcpTools: string[];
+    handoff: string;
+}
+export interface WorkflowRecipeCatalog {
+    schemaVersion: 1;
+    recipes: AgentWorkflowRecipe[];
+}
+export declare function getWorkflowRecipes(): WorkflowRecipeCatalog;

package/dist/core/adoptionWorkflowRecipes.js

@@ -0,0 +1,110 @@
+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: 'team_bootstrap',
+                name: 'Team Bootstrap',
+                useWhen: 'Adopt projscan for a team or new repository.',
+                outcome: 'A team policy, PR workflow, ownership starter, baseline memory, MCP setup check, and first start report that make adoption repeatable.',
+                commands: [
+                    'projscan init team --team platform',
+                    'projscan start --mode before_edit --format json',
+                    'projscan mcp doctor --client codex --format json',
+                ],
+                mcpTools: ['projscan_adoption', 'projscan_start'],
+                handoff: 'Run init team once, commit the generated policy/workflow/ownership/baseline files, then tune thresholds after the first PR.',
+            },
+            {
+                id: 'pr_automation',
+                name: 'PR Automation',
+                useWhen: 'Put projscan evidence directly in pull request review.',
+                outcome: 'Pull requests receive an approval comment and fail CI only when preflight returns block.',
+                commands: [
+                    'projscan init github-action',
+                    'projscan preflight --mode before_merge --format json',
+                    'projscan evidence-pack --pr-comment',
+                ],
+                mcpTools: ['projscan_preflight', 'projscan_evidence_pack'],
+                handoff: 'Treat block as a hard CI failure; use PR comment next actions for caution-level follow-up.',
+            },
+            {
+                id: 'bug_hunt',
+                name: 'Bug Hunt',
+                useWhen: 'Run a focused polish or stabilization pass.',
+                outcome: 'A ranked action 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: 'before_handoff',
+                name: 'Before handoff or commit',
+                useWhen: 'Check a branch before committing or handing it to a reviewer.',
+                outcome: 'Concrete fix targets, manual review gates, and proof commands are separated.',
+                commands: [
+                    'projscan bug-hunt --format json',
+                    'projscan preflight --mode before_commit --format json',
+                    'projscan evidence-pack --pr-comment',
+                ],
+                mcpTools: ['projscan_bug_hunt', 'projscan_preflight', 'projscan_evidence_pack'],
+                handoff: 'Fix concrete blockers first, document manual review gates, then share the evidence pack.',
+            },
+            {
+                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.',
+            },
+        ],
+    };
+}
+//# sourceMappingURL=adoptionWorkflowRecipes.js.map

package/dist/core/adoptionWorkflowRecipes.js.map

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