ghagga-core 2.8.1 → 2.9.1

package/dist/self-improve/index.js

@@ -0,0 +1,136 @@
+/**
+ * Self-Improving Review Loop
+ *
+ * Tracks which findings get accepted/rejected by users and uses that
+ * signal to derive improvement rules for future reviews.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+// ─── Storage ─────────────────────────────────────────────────────
+/**
+ * Append a feedback record to the JSONL file at storagePath.
+ * Creates the file (and parent directories) if they do not exist.
+ */
+export async function recordFeedback(feedback, storagePath) {
+    const dir = dirname(storagePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const line = `${JSON.stringify(feedback)}\n`;
+    appendFileSync(storagePath, line, 'utf-8');
+}
+/**
+ * Load all feedback records from a JSONL file.
+ * Returns an empty array if the file does not exist.
+ */
+export async function loadFeedback(storagePath) {
+    if (!existsSync(storagePath)) {
+        return [];
+    }
+    const raw = readFileSync(storagePath, 'utf-8').trim();
+    if (!raw)
+        return [];
+    const records = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            records.push(parsed);
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return records;
+}
+// ─── Rule Derivation ─────────────────────────────────────────────
+const MIN_SAMPLE_COUNT = 5;
+const SUPPRESS_REJECTION_THRESHOLD = 0.7;
+const BOOST_ACCEPTANCE_THRESHOLD = 0.8;
+/**
+ * Derive improvement rules from accumulated feedback.
+ *
+ * Logic per category:
+ * - rejection_rate > 0.7 AND sampleCount >= 5 → suppress
+ * - acceptance_rate > 0.8 AND sampleCount >= 5 → boost_priority
+ *
+ * Returns rules sorted by confidence descending.
+ */
+export function deriveRules(feedback) {
+    if (feedback.length === 0)
+        return [];
+    // Group by category
+    const byCategory = new Map();
+    for (const fb of feedback) {
+        const existing = byCategory.get(fb.category) ?? [];
+        existing.push(fb);
+        byCategory.set(fb.category, existing);
+    }
+    const rules = [];
+    for (const [category, records] of byCategory) {
+        const total = records.length;
+        if (total < MIN_SAMPLE_COUNT)
+            continue;
+        const rejected = records.filter((r) => r.outcome === 'rejected').length;
+        const accepted = records.filter((r) => r.outcome === 'accepted').length;
+        const rejectionRate = rejected / total;
+        const acceptanceRate = accepted / total;
+        if (rejectionRate > SUPPRESS_REJECTION_THRESHOLD) {
+            rules.push({
+                pattern: `category:${category}`,
+                category,
+                action: 'suppress',
+                confidence: Math.round(rejectionRate * 100) / 100,
+                sampleCount: total,
+            });
+        }
+        else if (acceptanceRate > BOOST_ACCEPTANCE_THRESHOLD) {
+            rules.push({
+                pattern: `category:${category}`,
+                category,
+                action: 'boost_priority',
+                confidence: Math.round(acceptanceRate * 100) / 100,
+                sampleCount: total,
+            });
+        }
+    }
+    // Sort by confidence descending
+    return rules.sort((a, b) => b.confidence - a.confidence);
+}
+// ─── Prompt Formatting ────────────────────────────────────────────
+/**
+ * Format derived improvement rules as a prompt section.
+ *
+ * Injects rules into the system prompt so the agent adjusts its behavior
+ * based on historical feedback.
+ *
+ * @param rules - Derived rules from deriveRules()
+ * @returns Formatted string for injection into system prompt
+ */
+export function formatRulesForPrompt(rules) {
+    if (rules.length === 0)
+        return '';
+    const lines = [
+        '## Review Improvement Rules',
+        '',
+        'Based on past feedback, apply these adjustments to your review:',
+        '',
+    ];
+    for (const rule of rules) {
+        if (rule.action === 'suppress') {
+            lines.push(`- **SUPPRESS** findings in category \`${rule.category}\` — ` +
+                `${Math.round(rule.confidence * 100)}% rejection rate across ${rule.sampleCount} samples. ` +
+                `Only report if you have very strong evidence.`);
+        }
+        else {
+            lines.push(`- **PRIORITIZE** findings in category \`${rule.category}\` — ` +
+                `${Math.round(rule.confidence * 100)}% acceptance rate across ${rule.sampleCount} samples. ` +
+                `These findings are highly valued by the team.`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/self-improve/index.js.map

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

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"}