code-auditor-mcp 4.1.0 → 5.0.1

package/dist/conventions/conventionMiner.d.ts

@@ -17,10 +17,12 @@ import type { Convention, ConventionMiningConfig } from '../types.js';
 import type { ExportInfo } from '../languages/types.js';
 /** Escape regex special characters in a string. */
 export declare function escapeRegex(s: string): string;
-/** Detect whether a string contains non-Latin-script characters (Spec 21 R5.4). */
+/** Detect whether a string contains non-Latin-script characters (Spec 21 R5.4). @param name The string to inspect. @returns True when the string contains non-Latin-script characters. */
 export declare function hasNonLatinChars(name: string): boolean;
 /** Classify a symbol name into a casing convention. Returns null for
- *  non-Latin, unclassifiable, or ambiguous names. */
+ *  non-Latin, unclassifiable, or ambiguous names.
+ *  @param name The symbol name to classify.
+ *  @returns The casing convention name, or null when unclassifiable. */
 export declare function detectCase(name: string): string | null;
 /**
  * Parse import statements from raw file content.
@@ -28,6 +30,8 @@ export declare function detectCase(name: string): string | null;
  * Handles: import default, import named, import namespace, import side-effect,
  * require default, require destructured.
  * Multi-line imports supported via {}-accumulation.
+ * @param content The raw file content.
+ * @returns The parsed import statements.
  */
 export declare function parseFileImports(content: string): Array<{
     source: string;
@@ -38,6 +42,9 @@ export declare function parseFileImports(content: string): Array<{
 /**
  * Parse the export form for a specific exported function from AST-extracted
  * export data. Returns null if the function isn't found in the export list.
+ * @param functionName The function name to look up.
+ * @param exports The AST-extracted export list.
+ * @returns The export form, or null when the function is not in the list.
  */
 export declare function detectExportForm(functionName: string, exports: ExportInfo[]): 'default' | 'named' | null;
 /**
@@ -59,8 +66,98 @@ export declare function detectExportForm(functionName: string, exports: ExportIn
  * A string/comment containing `try {` or `if (err)` no longer registers, and a
  * body that mixes two shapes is no longer collapsed to whichever the regex
  * happened to see first.
+ * @param body The function body source (may be null/undefined).
+ * @returns The detected error-handling shape, or null when none is present.
  */
 export declare function detectErrorHandlingShape(body: string | undefined | null): string | null;
+/** Cap the number of conventions per domain. @param conventions The conventions to cap. @param max The per-domain maximum. @returns The capped conventions. */
+export declare function capPerDomain(conventions: Convention[], max: number): Convention[];
+/** The import form a parsed import statement was classified as (regex, not AST). */
+type ImportFormShape = 'default' | 'named' | 'namespace' | 'side-effect' | 'require';
+/**
+ * The pure import-form miner — byte-identical logic to the legacy `mineImportForm`
+ * DB miner, over a per-file import projection.
+ *
+ * The legacy miner read `SELECT DISTINCT file_path FROM functions` (files that
+ * *have indexed functions*), parsed each file's source with `parseFileImports`,
+ * and reduced the `(source, directory)` histogram to a dominant-form convention.
+ * This pure miner drives off the same distinct file set (the caller derives it
+ * from the `function-index` fact, preserving first-appearance order) and reads
+ * each file's imports from the projection — so a file with imports but no
+ * indexed functions contributes nothing on either path.
+ * @param files The distinct file paths to mine.
+ * @param getImports Callback returning a file's parsed imports.
+ * @param config The convention mining config.
+ * @returns The mined import-form conventions.
+ */
+export declare function mineImportFormFromFacts(files: readonly string[], getImports: (filePath: string) => ReadonlyArray<{
+    source: string;
+    form: ImportFormShape;
+    line: number;
+}> | undefined, config: ConventionMiningConfig): Convention[];
+/**
+ * One exported-function row for `mineExportShapeFromFacts` — the same
+ * projection the DB miner reads (`SELECT id, name, file_path, line_number FROM
+ * functions WHERE is_exported = 1`). The `id` is a key only (the exemplar
+ * anchor is `(file, line)`), so the phase fact's array index is equivalent.
+ */
+export interface ExportShapeFuncRow {
+    id: number;
+    name: string;
+    file_path: string;
+    line_number: number;
+}
+/**
+ * Mine `export-shape` conventions from facts — the pure, AST-served path the
+ * phase model runs (`function-index` + `export-form` facts). `getExportForm`
+ * resolves a file's exported `(name, isDefault)` pairs from the `export-form`
+ * fact, which is the AST-extracted exports set (`extractExports`) the legacy
+ * reducer read as `exportsMap`. No source fallback: the phase model always has
+ * the export-form fact, so an absent file simply contributes no row.
+ * @param funcs The function-index rows to mine.
+ * @param config The convention mining config.
+ * @param getExportForm Callback resolving a file's exported (name, isDefault) pairs.
+ * @returns The mined export-shape conventions.
+ */
+export declare function mineExportShapeFromFacts(funcs: ExportShapeFuncRow[], config: ConventionMiningConfig, getExportForm?: (filePath: string) => Array<{
+    name: string;
+    isDefault: boolean;
+}> | undefined): Convention[];
+/** The function-row projection usage-pair mining needs. */
+export interface UsagePairFuncRow {
+    id: number;
+    name: string;
+    file_path: string;
+    line_number: number;
+}
+/** The function-row projection error-handling mining needs. */
+export interface ErrorHandlingFuncRow {
+    id: number;
+    name: string;
+    file_path: string;
+    line_number: number;
+    body: string | null;
+}
+/** The function-row projection naming mining needs. */
+export interface NamingFuncRow {
+    id: number;
+    name: string;
+    file_path: string;
+    line_number: number;
+    entity_type: string;
+    component_type: string | null;
+}
+/** A function-call row (caller → callee), shared by both callers of the miner. */
+export interface MineCallRow {
+    caller_id: number;
+    callee_name: string;
+}
+/** The pure usage-pair miner — byte-identical logic to `mineUsagePairs`, over rows. @param funcs The function rows. @param calls The caller→callee call rows. @param config The convention mining config. @returns The mined usage-pair conventions. */
+export declare function mineUsagePairsFromFacts(funcs: UsagePairFuncRow[], calls: MineCallRow[], config: ConventionMiningConfig): Convention[];
+/** The pure error-handling miner — byte-identical logic to `mineErrorHandling`. @param funcs The function rows carrying bodies. @param config The convention mining config. @returns The mined error-handling conventions. */
+export declare function mineErrorHandlingFromFacts(funcs: ErrorHandlingFuncRow[], config: ConventionMiningConfig): Convention[];
+/** The pure naming miner — byte-identical logic to `mineNaming`. @param funcs The function rows to classify. @param config The convention mining config. @returns The mined naming conventions. */
+export declare function mineNamingFromFacts(funcs: NamingFuncRow[], config: ConventionMiningConfig): Convention[];
 /**
  * Compute a content hash of the miner inputs for change detection.
  * Callers can store this in the meta table to skip re-mining when unchanged.
@@ -76,6 +173,9 @@ export declare const MINER_VERSION = 2;
  * Compute a content hash of the miner inputs for change detection.
  * Callers can store this in the meta table to skip re-mining when unchanged.
  * Includes MINER_VERSION so that algorithm changes force a re-mine.
+ * @param db The SQLite database to hash inputs from.
+ * @param config The convention mining config.
+ * @returns The computed input hash string.
  */
 export declare function computeMinerInputHash(db: SqliteDatabase, config: ConventionMiningConfig): string;
 /**
@@ -85,7 +185,10 @@ export declare function computeMinerInputHash(db: SqliteDatabase, config: Conven
  * @param config       Threshold configuration for the miner.
  * @param projectRoot  Optional project root — required for import-form and
  *                     export-shape mining to resolve file paths.
+ * @param getSource    Optional callback to read a file's source (avoids disk reads).
+ * @param getExports   Optional callback for AST-based export-form detection.
  * @returns Array of mined conventions (uncapped — caller should upsert).
  */
 export declare function mineConventions(db: SqliteDatabase, config: ConventionMiningConfig, projectRoot?: string, getSource?: (filePath: string) => string | undefined, getExports?: (filePath: string) => ExportInfo[] | undefined): Convention[];
+export {};
 //# sourceMappingURL=conventionMiner.d.ts.map

package/dist/conventions/conventionMiner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conventionMiner.d.ts","sourceRoot":"","sources":["../../src/conventions/conventionMiner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AA4DxD,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBtD;AAED;qDACqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBtD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6HpI;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,UAAU,EAAE,GACpB,SAAS,GAAG,OAAO,GAAG,IAAI,CAI5B;AAoCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA6CvF;AAkqBD;;;GAGG;AACH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,sBAAsB,GAC7B,MAAM,CAgBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,sBAAsB,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACpD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,EAAE,GAAG,SAAS,GAC1D,UAAU,EAAE,CAqBd"}
+{"version":3,"file":"conventionMiner.d.ts","sourceRoot":"","sources":["../../src/conventions/conventionMiner.ts"],"names":[],"mappings":"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"}