ghagga-core 2.8.0 → 2.9.0

package/dist/semantic-diff/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Semantic diff extraction.
+ *
+ * Instead of raw line diffs, extracts WHAT changed at the entity level:
+ * function renamed, class added, method signature changed, etc.
+ *
+ * Implementation is regex-based — no tree-sitter required.
+ */
+export type EntityChangeKind = 'function_added' | 'function_removed' | 'function_modified' | 'class_added' | 'class_removed' | 'method_added' | 'method_removed' | 'method_modified' | 'import_added' | 'import_removed' | 'export_added' | 'export_removed' | 'type_added' | 'type_removed' | 'type_modified';
+export interface EntityChange {
+    kind: EntityChangeKind;
+    name: string;
+    filePath: string;
+    /** Full declaration line for the old version (modifications only). */
+    oldSignature?: string;
+    /** Full declaration line for the new version (modifications only). */
+    newSignature?: string;
+}
+export interface SemanticDiff {
+    changes: EntityChange[];
+    /** Human-readable summary, e.g. "3 functions modified, 1 class added" */
+    summary: string;
+}
+/**
+ * Extract entity-level changes from a unified diff string.
+ *
+ * Returns a SemanticDiff with individual EntityChange items and a
+ * human-readable summary string.
+ */
+export declare function extractSemanticDiff(unifiedDiff: string): SemanticDiff;
+//# sourceMappingURL=index.d.ts.map

package/dist/semantic-diff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic-diff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAqJD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAiCrE"}

package/dist/semantic-diff/index.js

@@ -0,0 +1,215 @@
+/**
+ * Semantic diff extraction.
+ *
+ * Instead of raw line diffs, extracts WHAT changed at the entity level:
+ * function renamed, class added, method signature changed, etc.
+ *
+ * Implementation is regex-based — no tree-sitter required.
+ */
+// ─── Regex Patterns ──────────────────────────────────────────────
+/**
+ * Patterns that match declaration lines.
+ * Each entry includes the entity category for grouping (function|class|method|import|export|type).
+ */
+const DECLARATION_PATTERNS = [
+    // import statements — match before export/function to avoid conflicts
+    {
+        kind: 'import',
+        pattern: /^\s*import\s+(?:type\s+)?(?:\{[^}]*\}|[\w*]+(?:\s+as\s+\w+)?)\s+from\s+['"][^'"]+['"]/,
+    },
+    // export default / named
+    {
+        kind: 'export',
+        pattern: /^\s*export\s+(?:default\s+)?(?:const|let|var|function\*?|async\s+function\*?)\s+(\w+)/,
+    },
+    // export type / interface
+    {
+        kind: 'type',
+        pattern: /^\s*export\s+(?:type|interface|enum)\s+(\w+)/,
+    },
+    // standalone type / interface / enum
+    {
+        kind: 'type',
+        pattern: /^\s*(?:type|interface|enum)\s+(\w+)/,
+    },
+    // class declaration
+    {
+        kind: 'class',
+        pattern: /^\s*(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/,
+    },
+    // method inside class (indented + no leading "function" keyword, has "()")
+    {
+        kind: 'method',
+        pattern: /^[ \t]+(?:(?:public|private|protected|static|async|override|readonly)\s+)*(\w+)\s*\(/,
+    },
+    // top-level function declaration
+    {
+        kind: 'function',
+        pattern: /^\s*(?:export\s+)?(?:async\s+)?function\*?\s+(\w+)\s*\(/,
+    },
+    // arrow function / const fn = ...
+    {
+        kind: 'function',
+        pattern: /^\s*(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\(/,
+    },
+    // const fn = async () => or const fn = () =>
+    {
+        kind: 'function',
+        pattern: /^\s*(?:export\s+)?(?:const|let|var)\s+(\w+)\s*(?::\s*\w[\w<>,\s]*?)?\s*=\s*(?:async\s+)?\(/,
+    },
+];
+/**
+ * Extract the entity name from a declaration line.
+ * Returns [category, name] or null if no pattern matches.
+ */
+function extractDeclaration(line) {
+    for (const { kind, pattern } of DECLARATION_PATTERNS) {
+        const match = pattern.exec(line);
+        if (match) {
+            if (kind === 'import') {
+                // For imports, use the from-module as the "name" for deduplication
+                const fromMatch = /from\s+['"]([^'"]+)['"]/.exec(line);
+                return { kind, name: fromMatch?.[1] ?? line.trim().slice(0, 40) };
+            }
+            // Capture group 1 is the entity name for all other patterns
+            const name = match[1];
+            if (name)
+                return { kind, name };
+        }
+    }
+    return null;
+}
+/**
+ * Parse a unified diff and split added/removed declaration lines per file.
+ */
+function parseHunks(unifiedDiff) {
+    const result = [];
+    const filePattern = /^diff --git a\/.+ b\/(.+)$/m;
+    const sections = unifiedDiff.split(/^diff --git /m).filter(Boolean);
+    for (const section of sections) {
+        const pathMatch = /a\/.+ b\/(.+)$/.exec(section.split('\n')[0] ?? '');
+        const filePath = pathMatch?.[1] ?? 'unknown';
+        const added = new Map();
+        const removed = new Map();
+        for (const line of section.split('\n')) {
+            if (line.startsWith('+') && !line.startsWith('+++')) {
+                const content = line.slice(1);
+                const decl = extractDeclaration(content);
+                if (decl) {
+                    added.set(decl.name, { name: decl.name, signature: content.trim(), kind: decl.kind });
+                }
+            }
+            else if (line.startsWith('-') && !line.startsWith('---')) {
+                const content = line.slice(1);
+                const decl = extractDeclaration(content);
+                if (decl) {
+                    removed.set(decl.name, { name: decl.name, signature: content.trim(), kind: decl.kind });
+                }
+            }
+        }
+        result.push({ filePath, added, removed });
+    }
+    // Suppress unused import warning — filePattern is used for documentation only
+    void filePattern;
+    return result;
+}
+// ─── Main Export ─────────────────────────────────────────────────
+/**
+ * Extract entity-level changes from a unified diff string.
+ *
+ * Returns a SemanticDiff with individual EntityChange items and a
+ * human-readable summary string.
+ */
+export function extractSemanticDiff(unifiedDiff) {
+    const hunkSets = parseHunks(unifiedDiff);
+    const changes = [];
+    for (const { filePath, added, removed } of hunkSets) {
+        // Entities in both added and removed → modified
+        for (const [name, addedDecl] of added) {
+            if (removed.has(name)) {
+                const removedDecl = removed.get(name);
+                const kind = mapToChangeKind(addedDecl.kind, 'modified');
+                changes.push({
+                    kind,
+                    name,
+                    filePath,
+                    oldSignature: removedDecl?.signature,
+                    newSignature: addedDecl.signature,
+                });
+            }
+            else {
+                const kind = mapToChangeKind(addedDecl.kind, 'added');
+                changes.push({ kind, name, filePath, newSignature: addedDecl.signature });
+            }
+        }
+        // Entities only in removed → removed
+        for (const [name, removedDecl] of removed) {
+            if (!added.has(name)) {
+                const kind = mapToChangeKind(removedDecl.kind, 'removed');
+                changes.push({ kind, name, filePath, oldSignature: removedDecl.signature });
+            }
+        }
+    }
+    return { changes, summary: buildSummary(changes) };
+}
+// ─── Helpers ─────────────────────────────────────────────────────
+function mapToChangeKind(category, direction) {
+    switch (category) {
+        case 'function':
+            return direction === 'added'
+                ? 'function_added'
+                : direction === 'removed'
+                    ? 'function_removed'
+                    : 'function_modified';
+        case 'class':
+            return direction === 'added'
+                ? 'class_added'
+                : direction === 'removed'
+                    ? 'class_removed'
+                    : 'function_modified'; // classes cannot be "modified" at entity level, treat as function_modified
+        case 'method':
+            return direction === 'added'
+                ? 'method_added'
+                : direction === 'removed'
+                    ? 'method_removed'
+                    : 'method_modified';
+        case 'import':
+            return direction === 'added' ? 'import_added' : 'import_removed';
+        case 'export':
+            return direction === 'added' ? 'export_added' : 'export_removed';
+        case 'type':
+            return direction === 'added'
+                ? 'type_added'
+                : direction === 'removed'
+                    ? 'type_removed'
+                    : 'type_modified';
+    }
+}
+function buildSummary(changes) {
+    const counts = {};
+    for (const c of changes) {
+        counts[c.kind] = (counts[c.kind] ?? 0) + 1;
+    }
+    const parts = [];
+    const groupSummary = (addedKind, removedKind, modifiedKind, label) => {
+        const added = counts[addedKind] ?? 0;
+        const removed = counts[removedKind] ?? 0;
+        const modified = counts[modifiedKind] ?? 0;
+        if (added)
+            parts.push(`${added} ${label} added`);
+        if (removed)
+            parts.push(`${removed} ${label} removed`);
+        if (modified)
+            parts.push(`${modified} ${label} modified`);
+    };
+    groupSummary('function_added', 'function_removed', 'function_modified', 'function');
+    groupSummary('class_added', 'class_removed', 'function_modified', 'class');
+    groupSummary('method_added', 'method_removed', 'method_modified', 'method');
+    groupSummary('import_added', 'import_removed', 'import_added', 'import');
+    groupSummary('export_added', 'export_removed', 'export_added', 'export');
+    groupSummary('type_added', 'type_removed', 'type_modified', 'type');
+    if (parts.length === 0)
+        return 'no entity-level changes detected';
+    return parts.join(', ');
+}
+//# sourceMappingURL=index.js.map

package/dist/semantic-diff/index.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Regression testing framework for GHAGGA reviews.
+ *
+ * Lets you record a ReviewInput → ReviewResult pair as a "trace",
+ * load it back later, and assert that the trace still satisfies a
+ * set of structural constraints.
+ *
+ * Designed to be used in CI to catch regressions in the review engine.
+ */
+import type { ReviewInput, ReviewResult } from '../types.js';
+export interface ReviewTrace {
+    input: ReviewInput;
+    output: ReviewResult;
+    recordedAt: string;
+    label: string;
+}
+/**
+ * A single assertion spec for a recorded trace.
+ * `mustFind` requires at least one matching finding.
+ * `mustNotFind` requires zero matching findings.
+ */
+export interface TraceAssertion {
+    label: string;
+    /** Each entry must match at least one finding in the trace output. */
+    mustFind: Array<{
+        filePath?: string;
+        category?: string;
+        severity?: string;
+        messageContains?: string;
+    }>;
+    /** Each entry must NOT match any finding in the trace output. */
+    mustNotFind?: Array<{
+        filePath?: string;
+        category?: string;
+        messageContains?: string;
+    }>;
+}
+/**
+ * Persist a ReviewTrace to disk as pretty-printed JSON.
+ *
+ * @param trace      - The trace to record
+ * @param outputPath - Absolute or relative path for the output file
+ */
+export declare function recordTrace(trace: ReviewTrace, outputPath: string): Promise<void>;
+/**
+ * Load a ReviewTrace from a JSON file on disk.
+ *
+ * @param tracePath - Path to the trace file written by {@link recordTrace}
+ * @returns         Parsed ReviewTrace
+ * @throws          If the file does not exist or contains invalid JSON
+ */
+export declare function loadTrace(tracePath: string): Promise<ReviewTrace>;
+/**
+ * Run a set of TraceAssertions against a loaded trace.
+ *
+ * Returns `{ passed: true, failures: [] }` when all assertions pass,
+ * or `{ passed: false, failures: [...] }` with a human-readable list
+ * of failures when something does not match.
+ *
+ * @param trace      - The loaded ReviewTrace to validate
+ * @param assertions - Array of {@link TraceAssertion} to evaluate
+ */
+export declare function assertTrace(trace: ReviewTrace, assertions: TraceAssertion[]): Promise<{
+    passed: boolean;
+    failures: string[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAiB,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IAEd,sEAAsE;IACtE,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IAEH,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;CACJ;AAID;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAGvE;AAsBD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,cAAc,EAAE,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2BlD"}

package/dist/testing/index.js

@@ -0,0 +1,76 @@
+/**
+ * Regression testing framework for GHAGGA reviews.
+ *
+ * Lets you record a ReviewInput → ReviewResult pair as a "trace",
+ * load it back later, and assert that the trace still satisfies a
+ * set of structural constraints.
+ *
+ * Designed to be used in CI to catch regressions in the review engine.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+// ─── I/O helpers ────────────────────────────────────────────────
+/**
+ * Persist a ReviewTrace to disk as pretty-printed JSON.
+ *
+ * @param trace      - The trace to record
+ * @param outputPath - Absolute or relative path for the output file
+ */
+export async function recordTrace(trace, outputPath) {
+    await writeFile(outputPath, JSON.stringify(trace, null, 2), 'utf8');
+}
+/**
+ * Load a ReviewTrace from a JSON file on disk.
+ *
+ * @param tracePath - Path to the trace file written by {@link recordTrace}
+ * @returns         Parsed ReviewTrace
+ * @throws          If the file does not exist or contains invalid JSON
+ */
+export async function loadTrace(tracePath) {
+    const raw = await readFile(tracePath, 'utf8');
+    return JSON.parse(raw);
+}
+// ─── Assertion engine ────────────────────────────────────────────
+function findingMatchesMatcher(finding, matcher) {
+    if (matcher.filePath !== undefined && finding.file !== matcher.filePath)
+        return false;
+    if (matcher.category !== undefined && finding.category !== matcher.category)
+        return false;
+    if (matcher.severity !== undefined && finding.severity !== matcher.severity)
+        return false;
+    if (matcher.messageContains !== undefined && !finding.message.includes(matcher.messageContains)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Run a set of TraceAssertions against a loaded trace.
+ *
+ * Returns `{ passed: true, failures: [] }` when all assertions pass,
+ * or `{ passed: false, failures: [...] }` with a human-readable list
+ * of failures when something does not match.
+ *
+ * @param trace      - The loaded ReviewTrace to validate
+ * @param assertions - Array of {@link TraceAssertion} to evaluate
+ */
+export async function assertTrace(trace, assertions) {
+    const findings = trace.output.findings;
+    const failures = [];
+    for (const assertion of assertions) {
+        // ── mustFind ────────────────────────────────────────────
+        for (const matcher of assertion.mustFind) {
+            const found = findings.some((f) => findingMatchesMatcher(f, matcher));
+            if (!found) {
+                failures.push(`[${assertion.label}] mustFind: no finding matched ${JSON.stringify(matcher)}`);
+            }
+        }
+        // ── mustNotFind ─────────────────────────────────────────
+        for (const matcher of assertion.mustNotFind ?? []) {
+            const found = findings.some((f) => findingMatchesMatcher(f, matcher));
+            if (found) {
+                failures.push(`[${assertion.label}] mustNotFind: unexpected finding matched ${JSON.stringify(matcher)}`);
+            }
+        }
+    }
+    return { passed: failures.length === 0, failures };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAoCvD,mEAAmE;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAkB,EAAE,UAAkB;IACtE,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;AACxC,CAAC;AAED,oEAAoE;AAEpE,SAAS,qBAAqB,CAC5B,OAAsB,EACtB,OAKC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1F,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1F,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAChG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAkB,EAClB,UAA4B;IAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,2DAA2D;QAC3D,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CACX,IAAI,SAAS,CAAC,KAAK,kCAAkC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAC/E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,2DAA2D;QAC3D,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,KAAK,EAAE,CAAC;gBACV,QAAQ,CAAC,IAAI,CACX,IAAI,SAAS,CAAC,KAAK,6CAA6C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAC1F,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC"}

package/dist/testing/vitest-helpers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Vitest integration helpers for the GHAGGA regression testing framework.
+ *
+ * Usage:
+ *   import { describeTrace } from "@ghagga/core/testing/vitest-helpers.js";
+ *
+ *   describeTrace("fixtures/my-trace.json", [
+ *     {
+ *       label: "finds SQL injection",
+ *       mustFind: [{ category: "security", messageContains: "SQL injection" }],
+ *     },
+ *   ]);
+ */
+import { type TraceAssertion } from './index.js';
+/**
+ * Create a vitest `describe` block that loads a trace from disk and runs
+ * all provided assertions as a single `it` test.
+ *
+ * Failing assertions produce an error message listing every failed check
+ * so the full picture is visible without multiple test-run iterations.
+ *
+ * @param tracePath  - Path to the JSON trace file (absolute or cwd-relative)
+ * @param assertions - Array of structural assertions to evaluate
+ */
+export declare function describeTrace(tracePath: string, assertions: TraceAssertion[]): void;
+//# sourceMappingURL=vitest-helpers.d.ts.map

package/dist/testing/vitest-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-helpers.d.ts","sourceRoot":"","sources":["../../src/testing/vitest-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,CASnF"}

package/dist/testing/vitest-helpers.js

@@ -0,0 +1,37 @@
+/**
+ * Vitest integration helpers for the GHAGGA regression testing framework.
+ *
+ * Usage:
+ *   import { describeTrace } from "@ghagga/core/testing/vitest-helpers.js";
+ *
+ *   describeTrace("fixtures/my-trace.json", [
+ *     {
+ *       label: "finds SQL injection",
+ *       mustFind: [{ category: "security", messageContains: "SQL injection" }],
+ *     },
+ *   ]);
+ */
+import { describe, expect, it } from 'vitest';
+import { assertTrace, loadTrace } from './index.js';
+/**
+ * Create a vitest `describe` block that loads a trace from disk and runs
+ * all provided assertions as a single `it` test.
+ *
+ * Failing assertions produce an error message listing every failed check
+ * so the full picture is visible without multiple test-run iterations.
+ *
+ * @param tracePath  - Path to the JSON trace file (absolute or cwd-relative)
+ * @param assertions - Array of structural assertions to evaluate
+ */
+export function describeTrace(tracePath, assertions) {
+    describe(`Trace: ${tracePath}`, () => {
+        it('passes all assertions', async () => {
+            const trace = await loadTrace(tracePath);
+            const result = await assertTrace(trace, assertions);
+            if (!result.passed)
+                throw new Error(result.failures.join('\n'));
+            expect(result.passed).toBe(true);
+        });
+    });
+}
+//# sourceMappingURL=vitest-helpers.js.map

package/dist/testing/vitest-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-helpers.js","sourceRoot":"","sources":["../../src/testing/vitest-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAuB,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,UAA4B;IAC3E,QAAQ,CAAC,UAAU,SAAS,EAAE,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;YACrC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAChE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/index.d.ts

@@ -13,5 +13,7 @@ export { runTools } from './orchestrator.js';
 export { createNodeExecutionContext } from './execution.js';
 export { initializeDefaultTools, resetInitialization } from './plugins/index.js';
 /** @deprecated Always returns true. Kept for backward compatibility. */
-export { isToolRegistryEnabled } from './runner.js';
+export { formatStaticAnalysisContext, isToolRegistryEnabled } from './runner.js';
+export type { RemoteQueryOptions } from './remote-query.js';
+export { fetchRemoteFile, searchRemoteCode } from './remote-query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI3D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAIrD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIjF,wEAAwE;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI3D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAIrD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIjF,wEAAwE;AACxE,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIjF,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -17,5 +17,6 @@ export { createNodeExecutionContext } from './execution.js';
 export { initializeDefaultTools, resetInitialization } from './plugins/index.js';
 // ─── Runner ─────────────────────────────────────────────────────
 /** @deprecated Always returns true. Kept for backward compatibility. */
-export { isToolRegistryEnabled } from './runner.js';
+export { formatStaticAnalysisContext, isToolRegistryEnabled } from './runner.js';
+export { fetchRemoteFile, searchRemoteCode } from './remote-query.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,mEAAmE;AAEnE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAK3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,mEAAmE;AAEnE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,mEAAmE;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,mEAAmE;AAEnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,mEAAmE;AAEnE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,mEAAmE;AAEnE,wEAAwE;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,mEAAmE;AAEnE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAK3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,mEAAmE;AAEnE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,mEAAmE;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,mEAAmE;AAEnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,mEAAmE;AAEnE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,mEAAmE;AAEnE,wEAAwE;AACxE,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKjF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/remote-query.d.ts

@@ -0,0 +1,40 @@
+/**
+ * codedb_remote — query public GitHub repos without cloning.
+ *
+ * Provides two utilities:
+ *  - fetchRemoteFile:   fetch a single file by path via raw.githubusercontent.com
+ *  - searchRemoteCode: search for code patterns via the GitHub Search API
+ *
+ * Both functions NEVER throw; they return null / [] on any error instead.
+ */
+export interface RemoteQueryOptions {
+    owner: string;
+    repo: string;
+    /** Git ref to target. Defaults to "HEAD". */
+    ref?: string;
+}
+/**
+ * Fetch a single file from a public (or token-accessible) GitHub repository.
+ *
+ * @param path   - Path to the file relative to the repo root (e.g. "src/index.ts")
+ * @param opts   - Owner, repo, and optional ref
+ * @param token  - Optional GitHub personal-access token or installation token
+ * @returns      File contents as a string, or null on any error (4xx, 5xx, network, etc.)
+ */
+export declare function fetchRemoteFile(path: string, opts: RemoteQueryOptions, token?: string): Promise<string | null>;
+/**
+ * Search for code matching a query inside a GitHub repository.
+ *
+ * Uses the GitHub Code Search API with text-match fragments enabled.
+ * Rate-limited: unauthenticated = 10 req/min, authenticated = 30 req/min.
+ *
+ * @param query  - Search query (will be scoped to the repo automatically)
+ * @param opts   - Owner and repo to search in (ref is not used by GitHub's search API)
+ * @param token  - Optional GitHub token; strongly recommended to avoid rate-limit errors
+ * @returns      Array of { path, snippet } objects, or [] on any error
+ */
+export declare function searchRemoteCode(query: string, opts: RemoteQueryOptions, token?: string): Promise<Array<{
+    path: string;
+    snippet: string;
+}>>;
+//# sourceMappingURL=remote-query.d.ts.map

package/dist/tools/remote-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-query.d.ts","sourceRoot":"","sources":["../../src/tools/remote-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kBAAkB,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAiBD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,kBAAkB,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAyBnD"}

package/dist/tools/remote-query.js

@@ -0,0 +1,71 @@
+/**
+ * codedb_remote — query public GitHub repos without cloning.
+ *
+ * Provides two utilities:
+ *  - fetchRemoteFile:   fetch a single file by path via raw.githubusercontent.com
+ *  - searchRemoteCode: search for code patterns via the GitHub Search API
+ *
+ * Both functions NEVER throw; they return null / [] on any error instead.
+ */
+/**
+ * Fetch a single file from a public (or token-accessible) GitHub repository.
+ *
+ * @param path   - Path to the file relative to the repo root (e.g. "src/index.ts")
+ * @param opts   - Owner, repo, and optional ref
+ * @param token  - Optional GitHub personal-access token or installation token
+ * @returns      File contents as a string, or null on any error (4xx, 5xx, network, etc.)
+ */
+export async function fetchRemoteFile(path, opts, token) {
+    const ref = opts.ref ?? 'HEAD';
+    const url = `https://raw.githubusercontent.com/${opts.owner}/${opts.repo}/${ref}/${path}`;
+    try {
+        const headers = {};
+        if (token) {
+            headers.Authorization = `Bearer ${token}`;
+        }
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            return null;
+        }
+        return await response.text();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Search for code matching a query inside a GitHub repository.
+ *
+ * Uses the GitHub Code Search API with text-match fragments enabled.
+ * Rate-limited: unauthenticated = 10 req/min, authenticated = 30 req/min.
+ *
+ * @param query  - Search query (will be scoped to the repo automatically)
+ * @param opts   - Owner and repo to search in (ref is not used by GitHub's search API)
+ * @param token  - Optional GitHub token; strongly recommended to avoid rate-limit errors
+ * @returns      Array of { path, snippet } objects, or [] on any error
+ */
+export async function searchRemoteCode(query, opts, token) {
+    const scopedQuery = `${query} repo:${opts.owner}/${opts.repo}`;
+    const url = `https://api.github.com/search/code?q=${encodeURIComponent(scopedQuery)}`;
+    try {
+        const headers = {
+            Accept: 'application/vnd.github.v3.text-match+json',
+        };
+        if (token) {
+            headers.Authorization = `Bearer ${token}`;
+        }
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            return [];
+        }
+        const data = (await response.json());
+        return (data.items ?? []).map((item) => ({
+            path: item.path,
+            snippet: item.text_matches?.[0]?.fragment ?? '',
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=remote-query.js.map

package/dist/tools/remote-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-query.js","sourceRoot":"","sources":["../../src/tools/remote-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAwB,EACxB,KAAc;IAEd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC;IAC/B,MAAM,GAAG,GAAG,qCAAqC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAE1F,IAAI,CAAC;QACH,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAiBD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAa,EACb,IAAwB,EACxB,KAAc;IAEd,MAAM,WAAW,GAAG,GAAG,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAG,wCAAwC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IAEtF,IAAI,CAAC;QACH,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,2CAA2C;SACpD,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE;SAChD,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}