sourceverity 1.0.0

package/dist/core/paths.js

@@ -0,0 +1,30 @@
+import path from "node:path";
+/**
+ * Normalizes any file system path into a standardized POSIX relative path.
+ * Ensures consistent output across Windows and POSIX systems.
+ */
+export function normalizePath(filePath, relativeTo) {
+    if (!filePath) {
+        return "";
+    }
+    let resolved = filePath;
+    if (relativeTo && path.isAbsolute(filePath)) {
+        resolved = path.relative(relativeTo, filePath);
+    }
+    // Convert Windows backslashes to POSIX forward slashes
+    let normalized = resolved.replace(/\\/g, "/");
+    // Remove leading './' if present
+    if (normalized.startsWith("./")) {
+        normalized = normalized.slice(2);
+    }
+    // Normalize duplicate slashes
+    normalized = normalized.replace(/\/{2,}/g, "/");
+    return normalized;
+}
+/**
+ * Determines whether a file path has an accepted TypeScript or JavaScript extension.
+ */
+export function isSourceFile(filePath) {
+    return /\.(?:[cm]?[jt]sx?|json)$/i.test(filePath);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,UAAmB;IACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,uDAAuD;IACvD,IAAI,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE9C,iCAAiC;IACjC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,8BAA8B;IAC9B,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAEhD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC"}

package/dist/core/suppressions.d.ts

@@ -0,0 +1,24 @@
+import type { Finding } from "./types.js";
+export interface LineSuppression {
+    readonly line: number;
+    readonly ruleIds: readonly string[];
+    readonly reason?: string | undefined;
+}
+export interface BlockSuppression {
+    readonly startLine: number;
+    readonly endLine?: number | undefined;
+    readonly ruleIds: readonly string[];
+}
+export interface FileSuppressions {
+    readonly nextLineSuppressions: readonly LineSuppression[];
+    readonly blockSuppressions: readonly BlockSuppression[];
+}
+/**
+ * Parses source text to identify all line and block level sourceverity suppressions.
+ */
+export declare function parseSourceSuppressions(sourceText: string): FileSuppressions;
+/**
+ * Evaluates whether a specific finding is suppressed by comment directives.
+ */
+export declare function isFindingSuppressed(finding: Finding, suppressions: FileSuppressions): boolean;
+//# sourceMappingURL=suppressions.d.ts.map

package/dist/core/suppressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.d.ts","sourceRoot":"","sources":["../../src/core/suppressions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,oBAAoB,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAiF5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAsB7F"}

package/dist/core/suppressions.js

@@ -0,0 +1,100 @@
+/**
+ * Parses source text to identify all line and block level sourceverity suppressions.
+ */
+export function parseSourceSuppressions(sourceText) {
+    const lines = sourceText.split("\n");
+    const nextLineSuppressions = [];
+    const blockSuppressions = [];
+    const activeBlocks = new Map();
+    for (let i = 0; i < lines.length; i++) {
+        const lineIndex = i + 1; // 1-indexed line
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        // 1. Check // sourceverity-disable-next-line <ruleIds> [-- <reason>]
+        const disableNextIdx = trimmed.indexOf("sourceverity-disable-next-line");
+        if (trimmed.startsWith("//") && disableNextIdx !== -1) {
+            const rest = trimmed.slice(disableNextIdx + "sourceverity-disable-next-line".length).trim();
+            const parts = rest.split(/\s+--\s*/);
+            const rulesPart = parts[0]?.trim() ?? "";
+            const reason = parts[1]?.trim();
+            const ruleIds = rulesPart
+                .split(",")
+                .map((r) => r.trim())
+                .filter((r) => r.length > 0);
+            if (ruleIds.length > 0) {
+                nextLineSuppressions.push({
+                    line: lineIndex + 1, // Target line is the NEXT line
+                    ruleIds,
+                    reason: reason || undefined,
+                });
+            }
+            continue;
+        }
+        // 2. Check /* sourceverity-disable <ruleIds> */
+        const blockDisableMatch = trimmed.match(/\/\*\s*sourceverity-disable\s+([^*]+)\*\//);
+        if (blockDisableMatch && !trimmed.includes("sourceverity-disable-next-line")) {
+            const rawRules = blockDisableMatch[1]?.trim() ?? "";
+            const ruleIds = rawRules
+                .split(",")
+                .map((r) => r.trim())
+                .filter((r) => r.length > 0);
+            for (const ruleId of ruleIds) {
+                activeBlocks.set(ruleId, lineIndex);
+            }
+            continue;
+        }
+        // 3. Check /* sourceverity-enable <ruleIds> */
+        const blockEnableMatch = trimmed.match(/\/\*\s*sourceverity-enable\s+([^*]+)\*\//);
+        if (blockEnableMatch) {
+            const rawRules = blockEnableMatch[1]?.trim() ?? "";
+            const ruleIds = rawRules
+                .split(",")
+                .map((r) => r.trim())
+                .filter((r) => r.length > 0);
+            for (const ruleId of ruleIds) {
+                const startLine = activeBlocks.get(ruleId);
+                if (startLine !== undefined) {
+                    blockSuppressions.push({
+                        startLine,
+                        endLine: lineIndex,
+                        ruleIds: [ruleId],
+                    });
+                    activeBlocks.delete(ruleId);
+                }
+            }
+        }
+    }
+    // Any unclosed block suppressions extend to the end of the file
+    for (const [ruleId, startLine] of activeBlocks.entries()) {
+        blockSuppressions.push({
+            startLine,
+            endLine: undefined,
+            ruleIds: [ruleId],
+        });
+    }
+    return { nextLineSuppressions, blockSuppressions };
+}
+/**
+ * Evaluates whether a specific finding is suppressed by comment directives.
+ */
+export function isFindingSuppressed(finding, suppressions) {
+    const line = finding.range.start.line;
+    // Check next-line suppressions
+    for (const supp of suppressions.nextLineSuppressions) {
+        if (supp.line === line) {
+            if (supp.ruleIds.includes(finding.ruleId) || supp.ruleIds.includes("all")) {
+                return true;
+            }
+        }
+    }
+    // Check block suppressions
+    for (const block of suppressions.blockSuppressions) {
+        if (line >= block.startLine && (block.endLine === undefined || line <= block.endLine)) {
+            if (block.ruleIds.includes(finding.ruleId) || block.ruleIds.includes("all")) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=suppressions.js.map

package/dist/core/suppressions.js.map

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

package/dist/core/terminal.d.ts

@@ -0,0 +1,18 @@
+export interface TerminalStyler {
+    readonly enabled: boolean;
+    bold(text: string): string;
+    dim(text: string): string;
+    red(text: string): string;
+    green(text: string): string;
+    yellow(text: string): string;
+    blue(text: string): string;
+    cyan(text: string): string;
+    gray(text: string): string;
+}
+/**
+ * Creates an ANSI terminal styler respecting NO_COLOR, FORCE_COLOR, and TTY status.
+ */
+export declare function createStyler(options?: {
+    readonly color?: boolean;
+}): TerminalStyler;
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/core/terminal.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAkCnF"}

package/dist/core/terminal.js

@@ -0,0 +1,39 @@
+/**
+ * Creates an ANSI terminal styler respecting NO_COLOR, FORCE_COLOR, and TTY status.
+ */
+export function createStyler(options) {
+    const envNoColor = Boolean(process.env["NO_COLOR"]);
+    const envForceColor = Boolean(process.env["FORCE_COLOR"]);
+    const isTTY = Boolean(process.stdout && process.stdout.isTTY);
+    let enabled = false;
+    if (options?.color !== undefined) {
+        enabled = options.color;
+    }
+    else if (envNoColor) {
+        enabled = false;
+    }
+    else if (envForceColor) {
+        enabled = true;
+    }
+    else {
+        enabled = isTTY;
+    }
+    const wrap = (open, close) => (text) => {
+        if (!enabled || !text) {
+            return text;
+        }
+        return `\u001B[${open}m${text}\u001B[${close}m`;
+    };
+    return {
+        enabled,
+        bold: wrap("1", "22"),
+        dim: wrap("2", "22"),
+        red: wrap("31", "39"),
+        green: wrap("32", "39"),
+        yellow: wrap("33", "39"),
+        blue: wrap("34", "39"),
+        cyan: wrap("36", "39"),
+        gray: wrap("90", "39"),
+    };
+}
+//# sourceMappingURL=terminal.js.map

package/dist/core/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/core/terminal.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsC;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE;QAC7D,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,UAAU,IAAI,IAAI,IAAI,UAAU,KAAK,GAAG,CAAC;IAClD,CAAC,CAAC;IAEF,OAAO;QACL,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QACrB,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QACvB,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,119 @@
+import type * as ts from "typescript";
+export type Severity = "error" | "warning" | "info";
+export type Confidence = "high" | "medium" | "low";
+export type RuleCategory = "typescript" | "react" | "async" | "browser" | "network" | "security" | "performance" | "a11y" | "config";
+export interface SourcePosition {
+    readonly line: number;
+    readonly column: number;
+}
+export interface SourceRange {
+    readonly start: SourcePosition;
+    readonly end: SourcePosition;
+}
+export interface Evidence {
+    readonly message: string;
+    readonly range?: SourceRange | undefined;
+}
+export interface Finding {
+    readonly fingerprint: string;
+    readonly ruleId: string;
+    readonly category: RuleCategory;
+    readonly severity: Severity;
+    readonly confidence: Confidence;
+    readonly message: string;
+    readonly file: string;
+    readonly projectRoot?: string | undefined;
+    readonly range: SourceRange;
+    readonly evidence: readonly Evidence[];
+    readonly suggestedAction?: string | null | undefined;
+    readonly safeAutomaticFix: boolean;
+    readonly repositoryAccepted?: boolean | undefined;
+}
+export type FindingInput = Omit<Finding, "fingerprint"> & {
+    readonly fingerprint?: string | undefined;
+};
+export interface RuleMetadata {
+    readonly id: string;
+    readonly category: RuleCategory;
+    readonly defaultSeverity: Severity;
+    readonly defaultConfidence: Confidence;
+    readonly description: string;
+    readonly requiresTypeInformation: boolean;
+    readonly framework?: string | undefined;
+}
+export interface RepositorySummary {
+    readonly typescriptVersion?: string | undefined;
+    readonly reactVersion?: string | undefined;
+    readonly packageManager: string;
+    readonly projectCount: number;
+    readonly workspaceType?: string | undefined;
+}
+export interface AuditSummary {
+    readonly errors: number;
+    readonly warnings: number;
+    readonly info: number;
+    readonly highConfidence: number;
+    readonly mediumConfidence: number;
+    readonly lowConfidence: number;
+    readonly filesAnalyzed: number;
+    readonly projectsCount: number;
+}
+export interface AuditResult {
+    readonly findings: readonly Finding[];
+    readonly summary: AuditSummary;
+    readonly repository: RepositorySummary;
+    readonly skippedSemanticRules?: readonly string[] | undefined;
+}
+export interface PackageJsonData {
+    readonly name?: string | undefined;
+    readonly version?: string | undefined;
+    readonly private?: boolean | undefined;
+    readonly workspaces?: readonly string[] | {
+        readonly packages?: readonly string[] | undefined;
+    } | undefined;
+    readonly dependencies?: Record<string, string> | undefined;
+    readonly devDependencies?: Record<string, string> | undefined;
+    readonly peerDependencies?: Record<string, string> | undefined;
+}
+export interface WorkspacePackage {
+    readonly name: string;
+    readonly packageDir: string;
+    readonly relativePath: string;
+    readonly packageJson: PackageJsonData;
+    readonly isRoot: boolean;
+}
+export interface FrameworkInfo {
+    readonly name: string;
+    readonly version?: string | undefined;
+}
+export interface RepositoryContext {
+    readonly rootDir: string;
+    readonly packageManager: "npm" | "pnpm" | "yarn" | "bun" | "unknown";
+    readonly rootManifest?: PackageJsonData | undefined;
+    readonly isMonorepo: boolean;
+    readonly workspaceType?: "pnpm" | "npm" | "yarn" | "bun" | undefined;
+    readonly packages: readonly WorkspacePackage[];
+    readonly reactVersion?: string | undefined;
+    readonly reactDomVersion?: string | undefined;
+    readonly hasReactCompiler: boolean;
+    readonly reactCompilerConfig?: Record<string, unknown> | undefined;
+    readonly frameworks: readonly FrameworkInfo[];
+}
+export interface RuleContext {
+    readonly ts?: typeof ts | undefined;
+    readonly program?: ts.Program | undefined;
+    readonly checker?: ts.TypeChecker | undefined;
+    readonly sourceFile: ts.SourceFile;
+    readonly repoContext: RepositoryContext;
+    readonly projectRoot: string;
+    readonly typeScriptAvailable: boolean;
+    report(finding: FindingInput): void;
+    visitNodes(visitor: (node: ts.Node) => void): void;
+    findEnclosingScope(node: ts.Node): ts.Node | undefined;
+    resolveSymbol(node: ts.Node): ts.Symbol | undefined;
+}
+export interface Rule {
+    readonly meta: RuleMetadata;
+    analyze(context: RuleContext): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/engine/context.d.ts

@@ -0,0 +1,16 @@
+import type * as tsType from "typescript";
+import type { FindingInput, RepositoryContext, RuleContext } from "../core/types.js";
+export interface CreateRuleContextOptions {
+    readonly ts?: typeof tsType | undefined;
+    readonly program?: tsType.Program | undefined;
+    readonly checker?: tsType.TypeChecker | undefined;
+    readonly sourceFile: tsType.SourceFile;
+    readonly repoContext: RepositoryContext;
+    readonly projectRoot: string;
+    readonly reportFinding: (finding: FindingInput) => void;
+}
+/**
+ * Creates an execution context for a single SourceFile during rule analysis.
+ */
+export declare function createRuleContext(options: CreateRuleContextOptions): RuleContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/engine/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/engine/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CAwDhF"}

package/dist/engine/context.js

@@ -0,0 +1,57 @@
+/**
+ * Creates an execution context for a single SourceFile during rule analysis.
+ */
+export function createRuleContext(options) {
+    const { ts, program, checker, sourceFile, repoContext, projectRoot, reportFinding } = options;
+    return {
+        ts,
+        program,
+        checker,
+        sourceFile,
+        repoContext,
+        projectRoot,
+        typeScriptAvailable: Boolean(program && checker),
+        report(finding) {
+            reportFinding(finding);
+        },
+        visitNodes(visitor) {
+            function walk(node) {
+                if (!node)
+                    return;
+                visitor(node);
+                node.forEachChild(walk);
+            }
+            walk(sourceFile);
+        },
+        findEnclosingScope(node) {
+            let current = node.parent;
+            while (current) {
+                if (ts) {
+                    if (ts.isFunctionDeclaration(current) ||
+                        ts.isArrowFunction(current) ||
+                        ts.isFunctionExpression(current) ||
+                        ts.isMethodDeclaration(current) ||
+                        ts.isClassDeclaration(current) ||
+                        ts.isSourceFile(current)) {
+                        return current;
+                    }
+                }
+                else {
+                    // Fallback to numeric SyntaxKind
+                    const k = current.kind;
+                    if (k === 262 || k === 219 || k === 218 || k === 173 || k === 263 || k === 312) {
+                        return current;
+                    }
+                }
+                current = current.parent;
+            }
+            return undefined;
+        },
+        resolveSymbol(node) {
+            if (!checker)
+                return undefined;
+            return checker.getSymbolAtLocation(node);
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/engine/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/engine/context.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAE9F,OAAO;QACL,EAAE;QACF,OAAO;QACP,OAAO;QACP,UAAU;QACV,WAAW;QACX,WAAW;QACX,mBAAmB,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;QAEhD,MAAM,CAAC,OAAqB;YAC1B,aAAa,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,UAAU,CAAC,OAAoC;YAC7C,SAAS,IAAI,CAAC,IAA6B;gBACzC,IAAI,CAAC,IAAI;oBAAE,OAAO;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,CAAC;QACnB,CAAC;QAED,kBAAkB,CAAC,IAAiB;YAClC,IAAI,OAAO,GAA4B,IAAI,CAAC,MAAM,CAAC;YACnD,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,EAAE,EAAE,CAAC;oBACP,IACE,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC;wBACjC,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;wBAC3B,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC;wBAChC,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC;wBAC/B,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC;wBAC9B,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EACxB,CAAC;wBACD,OAAO,OAAO,CAAC;oBACjB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,iCAAiC;oBACjC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;oBACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;wBAC/E,OAAO,OAAO,CAAC;oBACjB,CAAC;gBACH,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YAC3B,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,aAAa,CAAC,IAAiB;YAC7B,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YAC/B,OAAO,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/registry.d.ts

@@ -0,0 +1,26 @@
+import type { Rule, RuleCategory } from "../core/types.js";
+export declare class RuleRegistry {
+    private readonly rulesById;
+    /**
+     * Registers a new audit rule. Throws if a duplicate rule ID is registered.
+     */
+    register(rule: Rule): void;
+    /**
+     * Retrieves a rule by its unique ID.
+     */
+    get(ruleId: string): Rule | undefined;
+    /**
+     * Returns all registered rules.
+     */
+    getAll(): readonly Rule[];
+    /**
+     * Returns all rules matching a specific category.
+     */
+    getByCategory(category: RuleCategory): readonly Rule[];
+    /**
+     * Clears all registered rules (useful for test isolation).
+     */
+    clear(): void;
+}
+export declare const globalRuleRegistry: RuleRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/engine/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/engine/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE3D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IAErD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC;;OAEG;IACH,MAAM,IAAI,SAAS,IAAI,EAAE;IAIzB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,IAAI,EAAE;IAItD;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}

package/dist/engine/registry.js

@@ -0,0 +1,38 @@
+export class RuleRegistry {
+    rulesById = new Map();
+    /**
+     * Registers a new audit rule. Throws if a duplicate rule ID is registered.
+     */
+    register(rule) {
+        if (this.rulesById.has(rule.meta.id)) {
+            throw new Error(`Duplicate rule ID registered: '${rule.meta.id}'`);
+        }
+        this.rulesById.set(rule.meta.id, rule);
+    }
+    /**
+     * Retrieves a rule by its unique ID.
+     */
+    get(ruleId) {
+        return this.rulesById.get(ruleId);
+    }
+    /**
+     * Returns all registered rules.
+     */
+    getAll() {
+        return Array.from(this.rulesById.values());
+    }
+    /**
+     * Returns all rules matching a specific category.
+     */
+    getByCategory(category) {
+        return this.getAll().filter((rule) => rule.meta.category === category);
+    }
+    /**
+     * Clears all registered rules (useful for test isolation).
+     */
+    clear() {
+        this.rulesById.clear();
+    }
+}
+export const globalRuleRegistry = new RuleRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/engine/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/engine/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACN,SAAS,GAAG,IAAI,GAAG,EAAgB,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAsB;QAClC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/engine/runner.d.ts

@@ -0,0 +1,14 @@
+import "../rules/index.js";
+import type { AuditResult, Rule } from "../core/types.js";
+export interface RunAuditOptions {
+    readonly targetDir: string;
+    readonly minConfidence?: "high" | "medium" | "low" | undefined;
+    readonly rules?: readonly Rule[] | undefined;
+    readonly customIgnores?: readonly string[] | undefined;
+    readonly changedFiles?: readonly string[] | undefined;
+}
+/**
+ * Executes a full SourceVerity audit across the target repository.
+ */
+export declare function runAudit(options: RunAuditOptions): Promise<AuditResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/engine/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/engine/runner.ts"],"names":[],"mappings":"AAWA,OAAO,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAKV,WAAW,EAGX,IAAI,EACL,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACvD;AAcD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAuJ7E"}