sourceverity 1.0.0

package/dist/reporters/agent.js

@@ -0,0 +1,40 @@
+/**
+ * Formats AuditResult into structured Agent JSON format for LLMs/Codex.
+ */
+export function renderAgentReport(result) {
+    const agentFindings = result.findings.map((f) => ({
+        fingerprint: f.fingerprint,
+        ruleId: f.ruleId,
+        category: f.category,
+        severity: f.severity,
+        confidence: f.confidence,
+        file: f.file,
+        range: {
+            start: { line: f.range.start.line, column: f.range.start.column },
+            end: { line: f.range.end.line, column: f.range.end.column },
+        },
+        message: f.message,
+        evidence: f.evidence.map((e) => e.message),
+        suggestedAction: f.suggestedAction ?? null,
+        safeAutomaticFix: f.safeAutomaticFix,
+    }));
+    const report = {
+        schemaVersion: 1,
+        tool: {
+            name: "sourceverity",
+            version: "1.0.0",
+        },
+        repository: {
+            typescript: result.repository.typescriptVersion,
+            react: result.repository.reactVersion,
+        },
+        summary: {
+            errors: result.summary.errors,
+            warnings: result.summary.warnings,
+            info: result.summary.info,
+        },
+        findings: agentFindings,
+    };
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=agent.js.map

package/dist/reporters/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/reporters/agent.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,aAAa,GAAmB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC;QACzE,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE;YACL,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;YACjE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;SAC5D;QACD,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1C,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;QAC1C,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;KACrC,CAAC,CAAC,CAAC;IAEJ,MAAM,MAAM,GAAgB;QAC1B,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,OAAO;SACjB;QACD,UAAU,EAAE;YACV,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,iBAAiB;YAC/C,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,YAAY;SACtC;QACD,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC7B,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;YACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;SAC1B;QACD,QAAQ,EAAE,aAAa;KACxB,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/reporters/json.d.ts

@@ -0,0 +1,6 @@
+import type { AuditResult } from "../core/types.js";
+/**
+ * Formats AuditResult as structured JSON.
+ */
+export declare function renderJsonReport(result: AuditResult): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/reporters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/reporters/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE5D"}

package/dist/reporters/json.js

@@ -0,0 +1,7 @@
+/**
+ * Formats AuditResult as structured JSON.
+ */
+export function renderJsonReport(result) {
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/reporters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/reporters/json.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/reporters/sarif.d.ts

@@ -0,0 +1,6 @@
+import type { AuditResult } from "../core/types.js";
+/**
+ * Formats AuditResult as standard SARIF 2.1.0 log format for GitHub Code Scanning.
+ */
+export declare function renderSarifReport(result: AuditResult): string;
+//# sourceMappingURL=sarif.d.ts.map

package/dist/reporters/sarif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/reporters/sarif.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA4D7D"}

package/dist/reporters/sarif.js

@@ -0,0 +1,60 @@
+/**
+ * Formats AuditResult as standard SARIF 2.1.0 log format for GitHub Code Scanning.
+ */
+export function renderSarifReport(result) {
+    const ruleMap = new Map();
+    for (const f of result.findings) {
+        if (!ruleMap.has(f.ruleId)) {
+            ruleMap.set(f.ruleId, { id: f.ruleId, name: f.ruleId });
+        }
+    }
+    const sarifResults = result.findings.map((f) => {
+        const level = f.severity === "error" ? "error" : f.severity === "warning" ? "warning" : "note";
+        return {
+            ruleId: f.ruleId,
+            level,
+            message: {
+                text: f.message,
+            },
+            locations: [
+                {
+                    physicalLocation: {
+                        artifactLocation: {
+                            uri: f.file,
+                        },
+                        region: {
+                            startLine: f.range.start.line,
+                            startColumn: f.range.start.column,
+                            endLine: f.range.end.line,
+                            endColumn: f.range.end.column,
+                        },
+                    },
+                },
+            ],
+            partialFingerprints: {
+                primaryLocationLineHash: f.fingerprint,
+            },
+        };
+    });
+    const sarifLog = {
+        $schema: "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
+        version: "2.1.0",
+        runs: [
+            {
+                tool: {
+                    driver: {
+                        name: "sourceverity",
+                        version: "1.0.0",
+                        rules: Array.from(ruleMap.values()).map((r) => ({
+                            id: r.id,
+                            name: r.name,
+                        })),
+                    },
+                },
+                results: sarifResults,
+            },
+        ],
+    };
+    return JSON.stringify(sarifLog, null, 2);
+}
+//# sourceMappingURL=sarif.js.map

package/dist/reporters/sarif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.js","sourceRoot":"","sources":["../../src/reporters/sarif.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwC,CAAC;IAEhE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAE/F,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,CAAC,OAAO;aAChB;YACD,SAAS,EAAE;gBACT;oBACE,gBAAgB,EAAE;wBAChB,gBAAgB,EAAE;4BAChB,GAAG,EAAE,CAAC,CAAC,IAAI;yBACZ;wBACD,MAAM,EAAE;4BACN,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;4BAC7B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;4BACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI;4BACzB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM;yBAC9B;qBACF;iBACF;aACF;YACD,mBAAmB,EAAE;gBACnB,uBAAuB,EAAE,CAAC,CAAC,WAAW;aACvC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,gGAAgG;QACzG,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE;wBACN,IAAI,EAAE,cAAc;wBACpB,OAAO,EAAE,OAAO;wBAChB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC9C,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,IAAI,EAAE,CAAC,CAAC,IAAI;yBACb,CAAC,CAAC;qBACJ;iBACF;gBACD,OAAO,EAAE,YAAY;aACtB;SACF;KACF,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/reporters/terminal.d.ts

@@ -0,0 +1,10 @@
+import type { AuditResult } from "../core/types.js";
+export interface TerminalReporterOptions {
+    readonly color?: boolean | undefined;
+    readonly verbose?: boolean | undefined;
+}
+/**
+ * Formats AuditResult as a clean, human-readable terminal report.
+ */
+export declare function renderTerminalReport(result: AuditResult, options?: TerminalReporterOptions | undefined): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/reporters/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/reporters/terminal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAcD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,SAAS,GAAG,MAAM,CAyE/G"}

package/dist/reporters/terminal.js

@@ -0,0 +1,105 @@
+import { createStyler } from "../core/terminal.js";
+const CATEGORY_NAMES = {
+    typescript: "Type safety",
+    react: "React",
+    async: "Async",
+    browser: "Browser",
+    network: "Network",
+    security: "Security",
+    performance: "Performance",
+    a11y: "Accessibility",
+    config: "Configuration",
+};
+/**
+ * Formats AuditResult as a clean, human-readable terminal report.
+ */
+export function renderTerminalReport(result, options) {
+    const styler = createStyler(options?.color !== undefined ? { color: options.color } : undefined);
+    const lines = [];
+    // 1. Header & Repository Overview
+    lines.push(styler.bold("SourceVerity 1.0.0"));
+    lines.push("");
+    lines.push(styler.bold("Repository"));
+    if (result.repository.typescriptVersion) {
+        lines.push(`  TypeScript   ${result.repository.typescriptVersion}`);
+    }
+    if (result.repository.reactVersion) {
+        lines.push(`  React        ${result.repository.reactVersion}`);
+    }
+    lines.push(`  Workspace    ${result.repository.workspaceType ?? result.repository.packageManager}`);
+    lines.push(`  Projects     ${result.repository.projectCount}`);
+    lines.push("");
+    lines.push(`Analyzing ${result.summary.filesAnalyzed} source files...`);
+    lines.push("");
+    // 2. Category Summary Table
+    const categoryCounts = new Map();
+    for (const f of result.findings) {
+        const cat = f.category;
+        let counts = categoryCounts.get(cat);
+        if (!counts) {
+            counts = { errors: 0, warnings: 0, info: 0 };
+            categoryCounts.set(cat, counts);
+        }
+        if (f.severity === "error")
+            counts.errors++;
+        else if (f.severity === "warning")
+            counts.warnings++;
+        else if (f.severity === "info")
+            counts.info++;
+    }
+    for (const [cat, name] of Object.entries(CATEGORY_NAMES)) {
+        const counts = categoryCounts.get(cat) ?? { errors: 0, warnings: 0, info: 0 };
+        if (counts.errors > 0 || counts.warnings > 0 || counts.info > 0 || options?.verbose) {
+            const paddedName = name.padEnd(16, " ");
+            const errStr = counts.errors > 0 ? styler.red(`${counts.errors} error${counts.errors === 1 ? "" : "s"}`) : `0 errors`;
+            const warnStr = counts.warnings > 0 ? styler.yellow(`${counts.warnings} warning${counts.warnings === 1 ? "" : "s"}`) : `0 warnings`;
+            lines.push(`${paddedName}  ${errStr}   ${warnStr}`);
+        }
+    }
+    lines.push("");
+    // 3. Individual Finding Cards
+    if (result.findings.length > 0) {
+        for (const finding of result.findings) {
+            lines.push(formatFindingCard(finding, styler));
+            lines.push("");
+        }
+    }
+    // 4. Skipped Semantic Rules Notice (if TS missing)
+    if (result.skippedSemanticRules && result.skippedSemanticRules.length > 0) {
+        lines.push(styler.yellow("Type-aware TypeScript analysis unavailable."));
+        lines.push("No local TypeScript installation was found.");
+        lines.push(`${result.skippedSemanticRules.length} semantic rules were skipped.`);
+        lines.push("");
+    }
+    // 5. Summary Footer
+    lines.push("────────────────────────────────────────");
+    lines.push(`${result.summary.highConfidence} high-confidence findings`);
+    if (result.summary.mediumConfidence > 0 || result.summary.lowConfidence > 0) {
+        lines.push(`${result.summary.mediumConfidence + result.summary.lowConfidence} advisory findings`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function formatFindingCard(finding, styler) {
+    const lines = [];
+    const loc = `${finding.file}:${finding.range.start.line}:${finding.range.start.column}`;
+    lines.push(styler.bold(loc));
+    lines.push("");
+    const sevStr = finding.severity === "error" ? styler.red("error") : finding.severity === "warning" ? styler.yellow("warning") : styler.dim("info");
+    lines.push(`${finding.ruleId}`);
+    lines.push(`${sevStr} · ${finding.confidence} confidence`);
+    lines.push("");
+    lines.push(finding.message);
+    if (finding.evidence.length > 0) {
+        lines.push("");
+        for (const ev of finding.evidence) {
+            lines.push(`  Evidence: ${ev.message}`);
+        }
+    }
+    if (finding.suggestedAction) {
+        lines.push("");
+        lines.push(styler.dim(`  Suggested: ${finding.suggestedAction}`));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=terminal.js.map

package/dist/reporters/terminal.js.map

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

package/dist/repository/detector.d.ts

@@ -0,0 +1,6 @@
+import type { RepositoryContext } from "./types.js";
+/**
+ * Audits repository directory and discovers packages, workspaces, package manager, and framework configuration.
+ */
+export declare function discoverRepository(rootDir: string): Promise<RepositoryContext>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/repository/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/repository/detector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA8JpB;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgFpF"}

package/dist/repository/detector.js

@@ -0,0 +1,231 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { normalizePath } from "../core/paths.js";
+/**
+ * Safely parses a JSON file, returning undefined if missing or malformed.
+ */
+async function readJsonFile(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf-8");
+        // sourceverity-disable-next-line typescript/unsafe-unvalidated-assertion -- generic raw JSON parser helper
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Checks if a file or directory exists.
+ */
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detects the package manager used in the repository root.
+ */
+async function detectPackageManager(rootDir) {
+    if (await pathExists(path.join(rootDir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (await pathExists(path.join(rootDir, "package-lock.json")))
+        return "npm";
+    if (await pathExists(path.join(rootDir, "yarn.lock")))
+        return "yarn";
+    if ((await pathExists(path.join(rootDir, "bun.lockb"))) || (await pathExists(path.join(rootDir, "bun.lock"))))
+        return "bun";
+    return "unknown";
+}
+/**
+ * Parses pnpm-workspace.yaml package patterns without external YAML libraries.
+ */
+async function parsePnpmWorkspaceYaml(pnpmYamlPath) {
+    try {
+        const content = await fs.readFile(pnpmYamlPath, "utf-8");
+        const patterns = [];
+        let inPackagesBlock = false;
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("packages:")) {
+                inPackagesBlock = true;
+                continue;
+            }
+            if (inPackagesBlock) {
+                if (trimmed.startsWith("-")) {
+                    const raw = trimmed.replace(/^-\s*/, "").replace(/['"]/g, "").trim();
+                    if (raw)
+                        patterns.push(raw);
+                }
+                else if (trimmed.length > 0 && !trimmed.startsWith("#")) {
+                    inPackagesBlock = false;
+                }
+            }
+        }
+        return patterns;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Expands workspace directory globs (e.g. "apps/*", "packages/*").
+ */
+async function expandWorkspacePatterns(rootDir, patterns) {
+    const result = [];
+    for (const pattern of patterns) {
+        const normalized = pattern.replace(/\\/g, "/");
+        if (normalized.endsWith("/*")) {
+            const parentDir = path.join(rootDir, normalized.slice(0, -2));
+            try {
+                const entries = await fs.readdir(parentDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory() && !entry.name.startsWith(".")) {
+                        const pkgDir = path.join(parentDir, entry.name);
+                        if (await pathExists(path.join(pkgDir, "package.json"))) {
+                            result.push(pkgDir);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Parent dir does not exist; continue
+            }
+        }
+        else {
+            const directDir = path.join(rootDir, normalized);
+            if (await pathExists(path.join(directDir, "package.json"))) {
+                result.push(directDir);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Extracts framework and tool dependencies across all discovered packages.
+ */
+function extractFrameworks(manifests) {
+    let reactVersion;
+    let reactDomVersion;
+    let hasReactCompiler = false;
+    const frameworksMap = new Map();
+    const KNOWN_FRAMEWORKS = [
+        { key: "next", name: "Next.js" },
+        { key: "vite", name: "Vite" },
+        { key: "@remix-run/react", name: "Remix" },
+        { key: "react-router", name: "React Router" },
+        { key: "astro", name: "Astro" },
+        { key: "gatsby", name: "Gatsby" },
+    ];
+    for (const manifest of manifests) {
+        const allDeps = {
+            ...manifest.peerDependencies,
+            ...manifest.devDependencies,
+            ...manifest.dependencies,
+        };
+        if (!reactVersion && allDeps["react"]) {
+            reactVersion = allDeps["react"];
+        }
+        if (!reactDomVersion && allDeps["react-dom"]) {
+            reactDomVersion = allDeps["react-dom"];
+        }
+        if (allDeps["babel-plugin-react-compiler"] || allDeps["eslint-plugin-react-compiler"]) {
+            hasReactCompiler = true;
+        }
+        for (const fw of KNOWN_FRAMEWORKS) {
+            const version = allDeps[fw.key];
+            if (version && !frameworksMap.has(fw.name)) {
+                frameworksMap.set(fw.name, version);
+            }
+        }
+    }
+    const frameworks = Array.from(frameworksMap.entries()).map(([name, version]) => ({
+        name,
+        version,
+    }));
+    return { reactVersion, reactDomVersion, hasReactCompiler, frameworks };
+}
+/**
+ * Audits repository directory and discovers packages, workspaces, package manager, and framework configuration.
+ */
+export async function discoverRepository(rootDir) {
+    const resolvedRoot = path.resolve(rootDir);
+    const packageManager = await detectPackageManager(resolvedRoot);
+    const rootManifestPath = path.join(resolvedRoot, "package.json");
+    const rootManifest = await readJsonFile(rootManifestPath);
+    const packages = [];
+    let isMonorepo = false;
+    let workspaceType;
+    // 1. Check pnpm-workspace.yaml
+    const pnpmWorkspacePath = path.join(resolvedRoot, "pnpm-workspace.yaml");
+    if (await pathExists(pnpmWorkspacePath)) {
+        isMonorepo = true;
+        workspaceType = "pnpm";
+        const patterns = await parsePnpmWorkspaceYaml(pnpmWorkspacePath);
+        const dirs = await expandWorkspacePatterns(resolvedRoot, patterns);
+        for (const pkgDir of dirs) {
+            const pkgManifest = await readJsonFile(path.join(pkgDir, "package.json"));
+            if (pkgManifest) {
+                packages.push({
+                    name: pkgManifest.name ?? path.basename(pkgDir),
+                    packageDir: pkgDir,
+                    relativePath: normalizePath(pkgDir, resolvedRoot),
+                    packageJson: pkgManifest,
+                    isRoot: false,
+                });
+            }
+        }
+    }
+    else if (rootManifest?.workspaces) {
+        // 2. Check package.json workspaces
+        isMonorepo = true;
+        workspaceType = packageManager === "unknown" ? "npm" : packageManager;
+        const rawWorkspaces = rootManifest.workspaces;
+        const rawPatterns = Array.isArray(rawWorkspaces)
+            ? rawWorkspaces
+            : typeof rawWorkspaces === "object" && rawWorkspaces && "packages" in rawWorkspaces && Array.isArray(rawWorkspaces.packages)
+                ? rawWorkspaces.packages
+                : [];
+        const dirs = await expandWorkspacePatterns(resolvedRoot, rawPatterns);
+        for (const pkgDir of dirs) {
+            const pkgManifest = await readJsonFile(path.join(pkgDir, "package.json"));
+            if (pkgManifest) {
+                packages.push({
+                    name: pkgManifest.name ?? path.basename(pkgDir),
+                    packageDir: pkgDir,
+                    relativePath: normalizePath(pkgDir, resolvedRoot),
+                    packageJson: pkgManifest,
+                    isRoot: false,
+                });
+            }
+        }
+    }
+    // Add root package if package.json exists
+    if (rootManifest) {
+        packages.unshift({
+            name: rootManifest.name ?? "root",
+            packageDir: resolvedRoot,
+            relativePath: ".",
+            packageJson: rootManifest,
+            isRoot: true,
+        });
+    }
+    const allManifests = packages.map((p) => p.packageJson);
+    const frameworkData = extractFrameworks(allManifests);
+    return {
+        rootDir: resolvedRoot,
+        packageManager,
+        isMonorepo,
+        workspaceType,
+        rootManifest,
+        packages,
+        reactVersion: frameworkData.reactVersion,
+        reactDomVersion: frameworkData.reactDomVersion,
+        hasReactCompiler: frameworkData.hasReactCompiler,
+        frameworks: frameworkData.frameworks,
+    };
+}
+//# sourceMappingURL=detector.js.map

package/dist/repository/detector.js.map

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

package/dist/repository/fileFilter.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_IGNORE_PATTERNS: readonly ["node_modules", "node_modules/**", "dist", "dist/**", "build", "build/**", "coverage", "coverage/**", ".git", ".git/**", ".next", ".next/**", ".turbo", ".turbo/**", ".nuxt", ".nuxt/**", ".cache", ".cache/**", ".sourceverity-cache", ".sourceverity-cache/**", "*.log", ".DS_Store"];
+/**
+ * Creates a repository file filter that checks file paths against default ignore rules,
+ * local .gitignore files, and optional custom patterns.
+ *
+ * Returns a predicate that returns true if the file should be INCLUDED in analysis,
+ * and false if the file should be IGNORED.
+ */
+export declare function createFileFilter(rootDir: string, customIgnores?: readonly string[] | undefined): Promise<(filePath: string) => boolean>;
+//# sourceMappingURL=fileFilter.d.ts.map

package/dist/repository/fileFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileFilter.d.ts","sourceRoot":"","sources":["../../src/repository/fileFilter.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,uBAAuB,mSAuB1B,CAAC;AAEX;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC5C,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CA+CxC"}

package/dist/repository/fileFilter.js

@@ -0,0 +1,78 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import ignore from "ignore";
+import { normalizePath } from "../core/paths.js";
+const createIgnore = typeof ignore === "function"
+    ? ignore
+    : ignore.default;
+export const DEFAULT_IGNORE_PATTERNS = [
+    "node_modules",
+    "node_modules/**",
+    "dist",
+    "dist/**",
+    "build",
+    "build/**",
+    "coverage",
+    "coverage/**",
+    ".git",
+    ".git/**",
+    ".next",
+    ".next/**",
+    ".turbo",
+    ".turbo/**",
+    ".nuxt",
+    ".nuxt/**",
+    ".cache",
+    ".cache/**",
+    ".sourceverity-cache",
+    ".sourceverity-cache/**",
+    "*.log",
+    ".DS_Store",
+];
+/**
+ * Creates a repository file filter that checks file paths against default ignore rules,
+ * local .gitignore files, and optional custom patterns.
+ *
+ * Returns a predicate that returns true if the file should be INCLUDED in analysis,
+ * and false if the file should be IGNORED.
+ */
+export async function createFileFilter(rootDir, customIgnores) {
+    const ig = createIgnore();
+    // 1. Add default ignore patterns
+    ig.add(DEFAULT_IGNORE_PATTERNS);
+    // 2. Add custom ignore patterns if provided
+    if (customIgnores && customIgnores.length > 0) {
+        ig.add(customIgnores);
+    }
+    // 3. Read root .gitignore if present
+    const rootGitignore = path.join(rootDir, ".gitignore");
+    try {
+        const content = await fs.readFile(rootGitignore, "utf-8");
+        ig.add(content);
+    }
+    catch {
+        // No .gitignore present, continue with defaults
+    }
+    const resolvedRoot = path.resolve(rootDir);
+    return (filePath) => {
+        if (!filePath)
+            return false;
+        // Resolve absolute path and compute relative path from repository root
+        const absoluteTarget = path.isAbsolute(filePath)
+            ? path.resolve(filePath)
+            : path.resolve(resolvedRoot, filePath);
+        const relativeFromRoot = path.relative(resolvedRoot, absoluteTarget);
+        // If path resolves outside the repository root, do not include it in repository scan
+        if (relativeFromRoot.startsWith("..") ||
+            relativeFromRoot === ".." ||
+            path.isAbsolute(relativeFromRoot)) {
+            return false;
+        }
+        const normalized = normalizePath(relativeFromRoot);
+        if (!normalized || normalized === ".")
+            return false;
+        // ig.ignores returns true if path matches ignore rules -> invert for inclusion
+        return !ig.ignores(normalized);
+    };
+}
+//# sourceMappingURL=fileFilter.js.map

package/dist/repository/fileFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileFilter.js","sourceRoot":"","sources":["../../src/repository/fileFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAuB,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,MAAM,YAAY,GAChB,OAAO,MAAM,KAAK,UAAU;IAC1B,CAAC,CAAE,MAAmC;IACtC,CAAC,CAAE,MAAgD,CAAC,OAAO,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,cAAc;IACd,iBAAiB;IACjB,MAAM;IACN,SAAS;IACT,OAAO;IACP,UAAU;IACV,UAAU;IACV,aAAa;IACb,MAAM;IACN,SAAS;IACT,OAAO;IACP,UAAU;IACV,QAAQ;IACR,WAAW;IACX,OAAO;IACP,UAAU;IACV,QAAQ;IACR,WAAW;IACX,qBAAqB;IACrB,wBAAwB;IACxB,OAAO;IACP,WAAW;CACH,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,aAA6C;IAE7C,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAE1B,iCAAiC;IACjC,EAAE,CAAC,GAAG,CAAC,uBAA8C,CAAC,CAAC;IAEvD,4CAA4C;IAC5C,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,EAAE,CAAC,GAAG,CAAC,aAAyB,CAAC,CAAC;IACpC,CAAC;IAED,qCAAqC;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC1D,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C,OAAO,CAAC,QAAgB,EAAW,EAAE;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5B,uEAAuE;QACvE,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAEzC,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAErE,qFAAqF;QACrF,IACE,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC;YACjC,gBAAgB,KAAK,IAAI;YACzB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EACjC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QAEpD,+EAA+E;QAC/E,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC"}

package/dist/repository/git.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Discovers modified, added, or uncommitted files in a git repository.
+ * Uses safe argument arrays without shell interpolation.
+ * Returns null if Git is unavailable or target directory is not a git repository.
+ */
+export declare function getChangedFiles(rootDir: string): Promise<string[] | null>;
+//# sourceMappingURL=git.d.ts.map

package/dist/repository/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/repository/git.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CA6C/E"}