@runhalo/engine 0.4.0 → 0.5.0

package/dist/ast-engine.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Halo AST Rule Engine
+ *
+ * Takes a parsed tree-sitter AST + rule ID and returns an AST-based verdict
+ * that supplements the regex scanner. AST analysis can suppress false positives
+ * (e.g., a Schema that already has TTL) or confirm true positives with higher
+ * confidence.
+ *
+ * Sprint 8: 10 rule analyzers for JS/TS.
+ * HARD SCOPE: Single-file only (via DataFlowTracer).
+ */
+import Parser from 'tree-sitter';
+export type ASTVerdict = 'confirmed' | 'suppressed' | 'regex_only';
+export interface ASTResult {
+    /** Whether the violation is confirmed, suppressed, or not analyzable by AST */
+    verdict: ASTVerdict;
+    /** Confidence in the verdict: 0.0 to 1.0 */
+    confidence: number;
+    /** Human-readable reason for the verdict */
+    reason?: string;
+}
+/** Minimal violation info needed for AST analysis */
+export interface ViolationInfo {
+    ruleId: string;
+    line: number;
+    column: number;
+    codeSnippet: string;
+}
+export declare class ASTRuleEngine {
+    private scopeAnalyzer;
+    constructor();
+    /**
+     * Analyze a regex-detected violation using AST context.
+     *
+     * @param ruleId   - The COPPA/ethical rule ID
+     * @param content  - Full file content
+     * @param violation - The violation from the regex scanner
+     * @param tree     - Parsed tree-sitter AST
+     * @returns ASTResult with verdict, confidence, and reason
+     */
+    analyzeViolation(ruleId: string, content: string, violation: ViolationInfo, tree: Parser.Tree): ASTResult;
+    /**
+     * Analyze a violation with a known file path (used from scanFileWithAST integration).
+     * This version passes the real file path for scope analysis.
+     */
+    analyzeViolationWithPath(ruleId: string, filePath: string, content: string, violation: ViolationInfo, tree: Parser.Tree): ASTResult;
+    private getAnalyzer;
+    private analyzeTracking003;
+    private analyzeRetention005;
+    private analyzeExtLinks017;
+    private analyzeXSS015;
+    private analyzeAuth001;
+    private analyzeUI008;
+    private checkPrivacyInContent;
+    private analyzeUGC014;
+    private analyzeFlow009;
+    private analyzeCookies016;
+    private analyzeInfiniteScroll001;
+}
+export default ASTRuleEngine;