@rigour-labs/core 3.0.5 → 4.0.0

package/dist/deep/fact-extractor.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Facts extracted from a single file.
+ */
+export interface FileFacts {
+    path: string;
+    language: string;
+    lineCount: number;
+    classes: ClassFact[];
+    functions: FunctionFact[];
+    imports: string[];
+    exports: string[];
+    errorHandling: ErrorHandlingFact[];
+    testAssertions: number;
+    hasTests: boolean;
+    structs?: StructFact[];
+    interfaces?: InterfaceFact[];
+    goroutines?: number;
+    channels?: number;
+    defers?: number;
+    mutexes?: number;
+    cyclomaticComplexity?: number;
+    commentRatio?: number;
+    magicNumbers?: number;
+    todoCount?: number;
+}
+export interface StructFact {
+    name: string;
+    lineStart: number;
+    lineEnd: number;
+    fieldCount: number;
+    methodCount: number;
+    methods: string[];
+    lineCount: number;
+    embeds: string[];
+}
+export interface InterfaceFact {
+    name: string;
+    lineStart: number;
+    methodCount: number;
+    methods: string[];
+}
+export interface ClassFact {
+    name: string;
+    lineStart: number;
+    lineEnd: number;
+    methodCount: number;
+    methods: string[];
+    publicMethods: string[];
+    lineCount: number;
+    dependencies: string[];
+}
+export interface FunctionFact {
+    name: string;
+    lineStart: number;
+    lineEnd: number;
+    lineCount: number;
+    paramCount: number;
+    params: string[];
+    maxNesting: number;
+    hasReturn: boolean;
+    isAsync: boolean;
+    isExported: boolean;
+}
+export interface ErrorHandlingFact {
+    type: 'try-catch' | 'catch-only' | 'if-error' | 'promise-catch' | 'error-callback';
+    lineStart: number;
+    isEmpty: boolean;
+    strategy: string;
+}
+/**
+ * Lightweight regex-based fact extraction.
+ * Works across languages without tree-sitter grammar loading.
+ * Fast enough for the deep analysis pipeline.
+ */
+export declare function extractFacts(cwd: string, ignore?: string[]): Promise<FileFacts[]>;
+/**
+ * Serialize facts into a compact string for LLM prompts.
+ * Keeps only the most relevant information within token budget.
+ */
+export declare function factsToPromptString(facts: FileFacts[], maxChars?: number): string;