mstro-app 0.3.8 → 0.4.0

package/dist/server/services/websocket/quality-persistence.js

@@ -0,0 +1,187 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * Quality Persistence — Persists quality config, reports, and history
+ * to .mstro/quality/ in the working directory.
+ *
+ * Files:
+ *   .mstro/quality/config.json       — Directory list (paths + labels)
+ *   .mstro/quality/reports/<slug>.json — Latest full report per directory
+ *   .mstro/quality/history.json       — Score history entries for trend tracking
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// Helpers
+// ============================================================================
+const MAX_HISTORY_ENTRIES = 100;
+function slugify(dirPath) {
+    if (dirPath === '.' || dirPath === './')
+        return '_root';
+    return dirPath.replace(/[/\\]/g, '_').replace(/^_+|_+$/g, '') || '_root';
+}
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function readJson(filePath, fallback) {
+    try {
+        if (existsSync(filePath)) {
+            return JSON.parse(readFileSync(filePath, 'utf-8'));
+        }
+    }
+    catch {
+        // Corrupted or unreadable — return fallback
+    }
+    return fallback;
+}
+function writeJson(filePath, data) {
+    try {
+        writeFileSync(filePath, JSON.stringify(data, null, 2));
+    }
+    catch (error) {
+        console.error('[QualityPersistence] Error writing:', filePath, error);
+    }
+}
+// ============================================================================
+// Quality Persistence
+// ============================================================================
+export class QualityPersistence {
+    qualityDir;
+    reportsDir;
+    configPath;
+    historyPath;
+    constructor(workingDir) {
+        this.qualityDir = join(workingDir, '.mstro', 'quality');
+        this.reportsDir = join(this.qualityDir, 'reports');
+        this.configPath = join(this.qualityDir, 'config.json');
+        this.historyPath = join(this.qualityDir, 'history.json');
+        ensureDir(this.reportsDir);
+    }
+    // ---- Config (directory list) ----
+    loadConfig() {
+        const config = readJson(this.configPath, { directories: [] });
+        return config.directories;
+    }
+    saveConfig(directories) {
+        writeJson(this.configPath, { directories });
+    }
+    addDirectory(path, label) {
+        const dirs = this.loadConfig();
+        if (!dirs.some((d) => d.path === path)) {
+            dirs.push({ path, label });
+            this.saveConfig(dirs);
+        }
+    }
+    removeDirectory(path) {
+        const dirs = this.loadConfig().filter((d) => d.path !== path);
+        this.saveConfig(dirs);
+    }
+    // ---- Reports (latest per directory) ----
+    loadReport(dirPath) {
+        const slug = slugify(dirPath);
+        const reportPath = join(this.reportsDir, `${slug}.json`);
+        return readJson(reportPath, null);
+    }
+    saveReport(dirPath, results) {
+        const slug = slugify(dirPath);
+        const reportPath = join(this.reportsDir, `${slug}.json`);
+        writeJson(reportPath, results);
+    }
+    loadAllReports(directories) {
+        const reports = {};
+        for (const dir of directories) {
+            const report = this.loadReport(dir.path);
+            if (report) {
+                reports[dir.path] = report;
+            }
+        }
+        return reports;
+    }
+    // ---- History (trend tracking) ----
+    loadHistory() {
+        const history = readJson(this.historyPath, { entries: [] });
+        return history.entries;
+    }
+    appendHistory(results, dirPath) {
+        const history = this.loadHistory();
+        // Find or create entry for this timestamp batch
+        // If the last entry was within 60 seconds, merge into it (for multi-dir scans)
+        const now = new Date();
+        const lastEntry = history[history.length - 1];
+        const lastTime = lastEntry ? new Date(lastEntry.timestamp).getTime() : 0;
+        const mergeWindow = 60_000; // 60 seconds
+        const dirEntry = {
+            path: dirPath,
+            score: results.overall,
+            grade: results.grade,
+        };
+        if (lastEntry && now.getTime() - lastTime < mergeWindow) {
+            // Merge: update or add this directory in the last entry
+            const existing = lastEntry.directories.findIndex((d) => d.path === dirPath);
+            if (existing >= 0) {
+                lastEntry.directories[existing] = dirEntry;
+            }
+            else {
+                lastEntry.directories.push(dirEntry);
+            }
+            // Recompute overall as average of all directories in this entry
+            const totalScore = lastEntry.directories.reduce((sum, d) => sum + d.score, 0);
+            lastEntry.overall = Math.round(totalScore / lastEntry.directories.length);
+            lastEntry.grade = gradeFromScore(lastEntry.overall);
+            lastEntry.timestamp = now.toISOString();
+        }
+        else {
+            // New entry
+            history.push({
+                timestamp: now.toISOString(),
+                overall: results.overall,
+                grade: results.grade,
+                directories: [dirEntry],
+            });
+        }
+        // Trim to max entries
+        while (history.length > MAX_HISTORY_ENTRIES) {
+            history.shift();
+        }
+        writeJson(this.historyPath, { entries: history });
+    }
+    // ---- Code Review (persisted per directory) ----
+    loadCodeReview(dirPath) {
+        const slug = slugify(dirPath);
+        const reviewPath = join(this.reportsDir, `${slug}-review.json`);
+        return readJson(reviewPath, null);
+    }
+    saveCodeReview(dirPath, findings, summary) {
+        const slug = slugify(dirPath);
+        const reviewPath = join(this.reportsDir, `${slug}-review.json`);
+        writeJson(reviewPath, { findings, summary, timestamp: new Date().toISOString() });
+    }
+    // ---- Full state load ----
+    loadState() {
+        const directories = this.loadConfig();
+        const reports = this.loadAllReports(directories);
+        const history = this.loadHistory();
+        // Merge persisted code reviews into reports
+        for (const dir of directories) {
+            const review = this.loadCodeReview(dir.path);
+            if (review && reports[dir.path]) {
+                reports[dir.path] = { ...reports[dir.path], codeReview: review.findings };
+            }
+        }
+        return { directories, reports, history };
+    }
+}
+function gradeFromScore(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 80)
+        return 'B';
+    if (score >= 70)
+        return 'C';
+    if (score >= 60)
+        return 'D';
+    return 'F';
+}
+//# sourceMappingURL=quality-persistence.js.map

package/dist/server/services/websocket/quality-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-persistence.js","sourceRoot":"","sources":["../../../../server/services/websocket/quality-persistence.ts"],"names":[],"mappings":"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"}

package/dist/server/services/websocket/quality-service.d.ts

@@ -38,7 +38,7 @@ export interface ScanProgress {
     current: number;
     total: number;
 }
-type Ecosystem = 'node' | 'python' | 'rust' | 'go' | 'unknown';
+type Ecosystem = 'node' | 'python' | 'rust' | 'go' | 'swift' | 'kotlin' | 'unknown';
 export declare function detectEcosystem(dirPath: string): Ecosystem[];
 export declare function detectTools(dirPath: string): Promise<{
     tools: QualityTool[];
@@ -48,7 +48,17 @@ export declare function installTools(dirPath: string, toolNames?: string[]): Pro
     tools: QualityTool[];
     ecosystem: string[];
 }>;
+export declare function computeAiReviewScore(findings: Array<{
+    severity: string;
+}>, totalLines: number): number;
 export type ProgressCallback = (progress: ScanProgress) => void;
-export declare function runQualityScan(dirPath: string, onProgress?: ProgressCallback): Promise<QualityResults>;
+export declare function runQualityScan(dirPath: string, onProgress?: ProgressCallback, installedToolNames?: string[]): Promise<QualityResults>;
+/**
+ * Recompute the overall score after AI code review findings become available.
+ * Returns a new QualityResults with the AI Review category enabled and score updated.
+ */
+export declare function recomputeWithAiReview(results: QualityResults, aiFindings: Array<{
+    severity: string;
+}>): QualityResults;
 export {};
 //# sourceMappingURL=quality-service.d.ts.map

package/dist/server/services/websocket/quality-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-service.d.ts","sourceRoot":"","sources":["../../../../server/services/websocket/quality-service.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AA+D/D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAa5D;AAkBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkBzG;AAMD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAYxD;AAunBD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEhE,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAgGzB"}
+{"version":3,"file":"quality-service.d.ts","sourceRoot":"","sources":["../../../../server/services/websocket/quality-service.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAqFpF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAe5D;AAyCD,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuBzG;AAMD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCxD;AAonBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EACrC,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAqBD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEhE,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,gBAAgB,EAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,OAAO,CAAC,cAAc,CAAC,CAiHzB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GACtC,cAAc,CA8BhB"}

package/dist/server/services/websocket/quality-service.js

@@ -14,9 +14,9 @@ const ECOSYSTEM_TOOLS = {
         { name: 'typescript', check: ['npx', 'tsc', '--version'], category: 'general', installCmd: 'npm install -D typescript' },
     ],
     python: [
-        { name: 'ruff', check: ['ruff', '--version'], category: 'linter', installCmd: 'pip install ruff' },
-        { name: 'black', check: ['black', '--version'], category: 'formatter', installCmd: 'pip install black' },
-        { name: 'radon', check: ['radon', '--version'], category: 'complexity', installCmd: 'pip install radon' },
+        { name: 'ruff', check: ['ruff', '--version'], category: 'linter', installCmd: 'uv tool install ruff || pip install ruff' },
+        { name: 'black', check: ['black', '--version'], category: 'formatter', installCmd: 'uv tool install black || pip install black' },
+        { name: 'radon', check: ['radon', '--version'], category: 'complexity', installCmd: 'uv tool install radon || pip install radon' },
     ],
     rust: [
         { name: 'clippy', check: ['cargo', 'clippy', '--version'], category: 'linter', installCmd: 'rustup component add clippy' },
@@ -26,6 +26,14 @@ const ECOSYSTEM_TOOLS = {
         { name: 'golangci-lint', check: ['golangci-lint', '--version'], category: 'linter', installCmd: 'go install github.com/golangci-lint/golangci-lint/cmd/golangci-lint@latest' },
         { name: 'gofmt', check: ['gofmt', '-h'], category: 'formatter', installCmd: '(built-in with Go)' },
     ],
+    swift: [
+        { name: 'swiftlint', check: ['swiftlint', '--version'], category: 'linter', installCmd: 'brew install swiftlint' },
+        { name: 'swiftformat', check: ['swiftformat', '--version'], category: 'formatter', installCmd: 'brew install swiftformat' },
+    ],
+    kotlin: [
+        { name: 'ktlint', check: ['ktlint', '--version'], category: 'linter', installCmd: 'brew install ktlint' },
+        { name: 'ktfmt', check: ['ktfmt', '--version'], category: 'formatter', installCmd: 'brew install ktfmt' },
+    ],
     unknown: [],
 };
 const SOURCE_EXTENSIONS = new Set([
@@ -48,6 +56,16 @@ const IGNORE_DIRS = new Set([
 const FILE_LENGTH_THRESHOLD = 300;
 const FUNCTION_LENGTH_THRESHOLD = 50;
 const TOTAL_STEPS = 7;
+function hasInstalledToolInCategory(installedSet, ecosystems, category) {
+    for (const eco of ecosystems) {
+        const specs = ECOSYSTEM_TOOLS[eco] || [];
+        for (const spec of specs) {
+            if (spec.category === category && installedSet.has(spec.name))
+                return true;
+        }
+    }
+    return false;
+}
 // ============================================================================
 // Ecosystem Detection
 // ============================================================================
@@ -63,6 +81,10 @@ export function detectEcosystem(dirPath) {
             ecosystems.push('rust');
         if (files.includes('go.mod'))
             ecosystems.push('go');
+        if (files.includes('Package.swift') || files.some(f => f.endsWith('.xcodeproj') || f.endsWith('.xcworkspace')))
+            ecosystems.push('swift');
+        if (files.includes('build.gradle') || files.includes('build.gradle.kts'))
+            ecosystems.push('kotlin');
     }
     catch {
         // Directory not readable
@@ -71,6 +93,31 @@ export function detectEcosystem(dirPath) {
         ecosystems.push('unknown');
     return ecosystems;
 }
+/** Detect the Node.js package manager from lockfiles */
+function detectNodePackageManager(dirPath) {
+    try {
+        const files = readdirSync(dirPath);
+        if (files.includes('bun.lockb') || files.includes('bun.lock'))
+            return 'bun';
+        if (files.includes('pnpm-lock.yaml'))
+            return 'pnpm';
+        if (files.includes('yarn.lock'))
+            return 'yarn';
+    }
+    catch {
+        // Directory not readable
+    }
+    return 'npm';
+}
+/** Build the install command for a Node.js dev dependency */
+function nodeInstallCmd(pm, pkg) {
+    switch (pm) {
+        case 'yarn': return `yarn add -D ${pkg}`;
+        case 'pnpm': return `pnpm add -D ${pkg}`;
+        case 'bun': return `bun add -d ${pkg}`;
+        default: return `npm install -D ${pkg}`;
+    }
+}
 // ============================================================================
 // Tool Detection
 // ============================================================================
@@ -88,14 +135,19 @@ async function checkToolInstalled(check, cwd) {
 export async function detectTools(dirPath) {
     const ecosystems = detectEcosystem(dirPath);
     const tools = [];
+    const nodePm = ecosystems.includes('node') ? detectNodePackageManager(dirPath) : 'npm';
     for (const eco of ecosystems) {
         const specs = ECOSYSTEM_TOOLS[eco] || [];
         for (const spec of specs) {
             const installed = await checkToolInstalled(spec.check, dirPath);
+            // For node tools, resolve install command using the project's package manager
+            const installCommand = eco === 'node'
+                ? nodeInstallCmd(nodePm, spec.installCmd.replace(/^npm install -D /, ''))
+                : spec.installCmd;
             tools.push({
                 name: spec.name,
                 installed,
-                installCommand: spec.installCmd,
+                installCommand,
                 category: spec.category,
             });
         }
@@ -108,14 +160,35 @@ export async function detectTools(dirPath) {
 export async function installTools(dirPath, toolNames) {
     const { tools } = await detectTools(dirPath);
     const toInstall = tools.filter((t) => !t.installed && (!toolNames || toolNames.includes(t.name)));
+    const failures = [];
     for (const tool of toInstall) {
         if (tool.installCommand.startsWith('('))
             continue; // built-in, skip
-        const parts = tool.installCommand.split(' ');
-        await runCommand(parts[0], parts.slice(1), dirPath);
+        // Support chained commands with || (try first, fallback to second)
+        const commands = tool.installCommand.split(' || ');
+        let installed = false;
+        for (const cmd of commands) {
+            const parts = cmd.trim().split(' ');
+            const result = await runCommand(parts[0], parts.slice(1), dirPath);
+            if (result.exitCode === 0) {
+                installed = true;
+                break;
+            }
+        }
+        if (!installed) {
+            failures.push(`${tool.name}: all install methods failed`);
+        }
     }
     // Re-detect after install
-    return detectTools(dirPath);
+    const detected = await detectTools(dirPath);
+    // Check if any requested tools are still missing after install
+    const requestedNames = new Set(toolNames ?? toInstall.map((t) => t.name));
+    const stillMissing = detected.tools.filter((t) => !t.installed && requestedNames.has(t.name)).map((t) => t.name);
+    if (stillMissing.length > 0) {
+        const detail = failures.length > 0 ? ` ${failures.join('; ')}` : '';
+        throw new Error(`Failed to install: ${stillMissing.join(', ')}.${detail}`);
+    }
+    return detected;
 }
 function tryStatSync(path) {
     try {
@@ -291,7 +364,7 @@ async function lintNode(dirPath, acc) {
 }
 async function lintPython(dirPath, acc) {
     const result = await runCommand('ruff', ['check', '--output-format=json', '.'], dirPath);
-    if (result.exitCode > 1)
+    if (result.exitCode !== 0 && !result.stdout.trim().startsWith('['))
         return;
     acc.ran = true;
     try {
@@ -658,12 +731,32 @@ function computeGrade(score) {
     return 'F';
 }
 const DEFAULT_WEIGHTS = {
-    linting: 0.30,
-    formatting: 0.15,
-    complexity: 0.25,
-    fileLength: 0.15,
-    functionLength: 0.15,
+    linting: 0.25,
+    formatting: 0.10,
+    complexity: 0.20,
+    fileLength: 0.12,
+    functionLength: 0.13,
+    aiReview: 0.20,
 };
+// ============================================================================
+// AI Code Review Score
+// ============================================================================
+const SEVERITY_PENALTY = {
+    critical: 10.0,
+    high: 5.0,
+    medium: 2.0,
+    low: 0.5,
+};
+/** Exponential decay constant — higher = harsher scoring */
+const AI_REVIEW_DECAY = 0.10;
+export function computeAiReviewScore(findings, totalLines) {
+    if (findings.length === 0)
+        return 100;
+    const effectiveKloc = Math.max(totalLines / 1000, 1.0);
+    const totalPenalty = findings.reduce((sum, f) => sum + (SEVERITY_PENALTY[f.severity] ?? 2.0), 0);
+    const penaltyDensity = totalPenalty / effectiveKloc;
+    return Math.round(100 * Math.exp(-AI_REVIEW_DECAY * penaltyDensity));
+}
 function computeOverallScore(categories) {
     const available = categories.filter((c) => c.available);
     if (available.length === 0)
@@ -677,20 +770,28 @@ function computeOverallScore(categories) {
     }
     return Math.round(Math.max(0, Math.min(100, weighted)));
 }
-export async function runQualityScan(dirPath, onProgress) {
+export async function runQualityScan(dirPath, onProgress, installedToolNames) {
     const ecosystems = detectEcosystem(dirPath);
+    // Build set of installed tools for gating analyses
+    const installedSet = installedToolNames ? new Set(installedToolNames) : null;
     const progress = (step, current) => {
         onProgress?.({ step, current, total: TOTAL_STEPS });
     };
     // Step 1: Collect source files
     progress('Collecting source files', 1);
     const files = collectSourceFiles(dirPath, dirPath);
-    // Step 2: Run linting
+    // Step 2: Run linting (only if a linter is installed)
     progress('Running linters', 2);
-    const lintResult = await analyzeLinting(dirPath, ecosystems, files);
-    // Step 3: Check formatting
+    const hasLinter = !installedSet || hasInstalledToolInCategory(installedSet, ecosystems, 'linter');
+    const lintResult = hasLinter
+        ? await analyzeLinting(dirPath, ecosystems, files)
+        : { score: 0, findings: [], available: false, issueCount: 0 };
+    // Step 3: Check formatting (only if a formatter is installed)
     progress('Checking formatting', 3);
-    const fmtResult = await analyzeFormatting(dirPath, ecosystems, files);
+    const hasFormatter = !installedSet || hasInstalledToolInCategory(installedSet, ecosystems, 'formatter');
+    const fmtResult = hasFormatter
+        ? await analyzeFormatting(dirPath, ecosystems, files)
+        : { score: 0, available: false, issueCount: 0 };
     // Step 4: Analyze complexity
     progress('Analyzing complexity', 4);
     const complexityResult = analyzeComplexity(files);
@@ -743,6 +844,14 @@ export async function runQualityScan(dirPath, onProgress) {
             available: true,
             issueCount: funcLengthResult.issueCount,
         },
+        {
+            name: 'AI Review',
+            score: 0,
+            weight: DEFAULT_WEIGHTS.aiReview,
+            effectiveWeight: DEFAULT_WEIGHTS.aiReview,
+            available: false,
+            issueCount: 0,
+        },
     ];
     const overall = computeOverallScore(categories);
     const allFindings = [
@@ -763,4 +872,39 @@ export async function runQualityScan(dirPath, onProgress) {
         ecosystem: ecosystems,
     };
 }
+// ============================================================================
+// Recompute with AI Review
+// ============================================================================
+/**
+ * Recompute the overall score after AI code review findings become available.
+ * Returns a new QualityResults with the AI Review category enabled and score updated.
+ */
+export function recomputeWithAiReview(results, aiFindings) {
+    const aiScore = computeAiReviewScore(aiFindings, results.totalLines);
+    // Update or add the AI Review category
+    const categories = results.categories.map((cat) => ({ ...cat }));
+    const aiCatIndex = categories.findIndex((c) => c.name === 'AI Review');
+    const aiCategory = {
+        name: 'AI Review',
+        score: aiScore,
+        weight: DEFAULT_WEIGHTS.aiReview,
+        effectiveWeight: DEFAULT_WEIGHTS.aiReview,
+        available: true,
+        issueCount: aiFindings.length,
+    };
+    if (aiCatIndex >= 0) {
+        categories[aiCatIndex] = aiCategory;
+    }
+    else {
+        categories.push(aiCategory);
+    }
+    const overall = computeOverallScore(categories);
+    return {
+        ...results,
+        overall,
+        grade: computeGrade(overall),
+        categories,
+        codeReview: results.codeReview,
+    };
+}
 //# sourceMappingURL=quality-service.js.map