ghagga-core 2.0.0

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * GHAGGA Core Types
+ *
+ * These types define the contract between the core review engine
+ * and all distribution adapters (server, CLI, action).
+ */
+export type ReviewMode = 'simple' | 'workflow' | 'consensus';
+export type LLMProvider = 'anthropic' | 'openai' | 'google' | 'github' | 'ollama';
+export type ReviewLevel = 'soft' | 'normal' | 'strict';
+/**
+ * Progress callback for pipeline steps.
+ * Used by the CLI in --verbose mode to show real-time progress.
+ */
+export type ProgressCallback = (event: ProgressEvent) => void;
+export interface ProgressEvent {
+    /** Pipeline step identifier */
+    step: string;
+    /** Human-readable message */
+    message: string;
+    /** Optional details (e.g., specialist output, vote reasoning) */
+    detail?: string;
+}
+export interface ReviewInput {
+    /** The unified diff string from the PR or local changes */
+    diff: string;
+    /** Review mode to use */
+    mode: ReviewMode;
+    /** Primary LLM provider */
+    provider: LLMProvider;
+    /** Model identifier (e.g., "claude-sonnet-4-20250514", "gpt-4o") */
+    model: string;
+    /** Decrypted API key for the LLM provider */
+    apiKey: string;
+    /** Tool and review configuration */
+    settings: ReviewSettings;
+    /** Optional context about the PR (not available in CLI mode) */
+    context?: ReviewContext;
+    /**
+     * Database connection for memory operations.
+     * Undefined in CLI/Action modes — memory gracefully degrades.
+     */
+    db?: unknown;
+    /**
+     * Optional progress callback for verbose/debug output.
+     * Called at each pipeline step with status updates.
+     */
+    onProgress?: ProgressCallback;
+}
+export interface ReviewSettings {
+    enableSemgrep: boolean;
+    enableTrivy: boolean;
+    enableCpd: boolean;
+    enableMemory: boolean;
+    customRules: string[];
+    ignorePatterns: string[];
+    reviewLevel: ReviewLevel;
+}
+export interface ReviewContext {
+    /** Repository full name (e.g., "owner/repo") */
+    repoFullName: string;
+    /** Pull request number */
+    prNumber: number;
+    /** Commit messages in the PR */
+    commitMessages: string[];
+    /** List of all file paths in the diff */
+    fileList: string[];
+}
+export type ReviewStatus = 'PASSED' | 'FAILED' | 'NEEDS_HUMAN_REVIEW' | 'SKIPPED';
+export type FindingSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+export type FindingSource = 'ai' | 'semgrep' | 'trivy' | 'cpd';
+export interface ReviewResult {
+    /** Overall review status */
+    status: ReviewStatus;
+    /** Human-readable summary (2-3 sentences) */
+    summary: string;
+    /** All findings from AI agents and static analysis */
+    findings: ReviewFinding[];
+    /** Static analysis results per tool */
+    staticAnalysis: StaticAnalysisResult;
+    /** Memory context that was injected into agent prompts (if any) */
+    memoryContext: string | null;
+    /** Execution metadata */
+    metadata: ReviewMetadata;
+}
+export interface ReviewFinding {
+    /** Severity level */
+    severity: FindingSeverity;
+    /** Category (e.g., "security", "performance", "style", "bug") */
+    category: string;
+    /** File path relative to repo root */
+    file: string;
+    /** Line number (if applicable) */
+    line?: number;
+    /** Description of the finding */
+    message: string;
+    /** Suggested fix or improvement */
+    suggestion?: string;
+    /** Which tool or agent produced this finding */
+    source: FindingSource;
+}
+export interface ReviewMetadata {
+    /** Review mode used */
+    mode: ReviewMode;
+    /** LLM provider used (may differ from requested if fallback occurred) */
+    provider: LLMProvider;
+    /** Model used */
+    model: string;
+    /** Total tokens consumed */
+    tokensUsed: number;
+    /** Total execution time in milliseconds */
+    executionTimeMs: number;
+    /** Static analysis tools that ran successfully */
+    toolsRun: string[];
+    /** Static analysis tools that were skipped or failed */
+    toolsSkipped: string[];
+}
+export type ToolStatus = 'success' | 'skipped' | 'error';
+export interface ToolResult {
+    /** Whether the tool ran successfully */
+    status: ToolStatus;
+    /** Findings from this tool */
+    findings: ReviewFinding[];
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+}
+export interface StaticAnalysisResult {
+    semgrep: ToolResult;
+    trivy: ToolResult;
+    cpd: ToolResult;
+}
+export type WorkflowSpecialist = 'scope-analysis' | 'coding-standards' | 'error-handling' | 'security-audit' | 'performance-review';
+export type ConsensusStance = 'for' | 'against' | 'neutral';
+export interface ConsensusVote {
+    /** Which provider cast this vote */
+    provider: LLMProvider;
+    /** Model used */
+    model: string;
+    /** Assigned stance */
+    stance: ConsensusStance;
+    /** Decision: approve, reject, or abstain */
+    decision: 'approve' | 'reject' | 'abstain';
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Reasoning for the decision */
+    reasoning: string;
+}
+export type ObservationType = 'decision' | 'pattern' | 'bugfix' | 'learning' | 'architecture' | 'config' | 'discovery';
+export interface MemoryObservation {
+    /** Observation type */
+    type: ObservationType;
+    /** Concise title */
+    title: string;
+    /** Structured content (what happened, why it matters, what was learned) */
+    content: string;
+    /** Project identifier (e.g., "owner/repo") */
+    project: string;
+    /** Session ID this observation belongs to */
+    sessionId?: number;
+    /** Stable key for upsert (evolving knowledge) */
+    topicKey?: string;
+    /** Affected file paths */
+    filePaths: string[];
+}
+export declare const DEFAULT_SETTINGS: ReviewSettings;
+export declare const DEFAULT_MODELS: Record<LLMProvider, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,24 @@
+/**
+ * GHAGGA Core Types
+ *
+ * These types define the contract between the core review engine
+ * and all distribution adapters (server, CLI, action).
+ */
+// ─── Configuration Defaults ─────────────────────────────────────
+export const DEFAULT_SETTINGS = {
+    enableSemgrep: true,
+    enableTrivy: true,
+    enableCpd: true,
+    enableMemory: true,
+    customRules: [],
+    ignorePatterns: ['*.md', '*.txt', '.gitignore', 'LICENSE', '*.lock'],
+    reviewLevel: 'normal',
+};
+export const DEFAULT_MODELS = {
+    anthropic: 'claude-sonnet-4-20250514',
+    openai: 'gpt-4o',
+    google: 'gemini-2.0-flash',
+    github: 'gpt-4o-mini',
+    ollama: 'qwen2.5-coder:7b',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqPH,mEAAmE;AAEnE,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,aAAa,EAAE,IAAI;IACnB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;IACpE,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD,SAAS,EAAE,0BAA0B;IACrC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,kBAAkB;CAC3B,CAAC"}

package/dist/utils/diff.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Unified diff parsing utilities.
+ *
+ * Provides functions to extract structured file information from unified
+ * diffs, filter out ignored files (e.g., lockfiles, docs), and truncate
+ * large diffs to fit within LLM token budgets.
+ */
+/** Represents a single file extracted from a unified diff. */
+export interface DiffFile {
+    /** File path relative to the repository root */
+    path: string;
+    /** Number of added lines */
+    additions: number;
+    /** Number of deleted lines */
+    deletions: number;
+    /** Raw diff content for this file (including headers and hunks) */
+    content: string;
+}
+/**
+ * Parse a unified diff string into structured file objects.
+ *
+ * Splits the diff by file boundaries (diff --git lines), extracts
+ * file paths, and counts additions/deletions per file.
+ *
+ * @param diff - Full unified diff string
+ * @returns Array of DiffFile objects
+ */
+export declare function parseDiffFiles(diff: string): DiffFile[];
+/**
+ * Filter out files matching ignore patterns (e.g., lockfiles, docs).
+ *
+ * Uses minimatch for glob pattern matching, consistent with .gitignore style.
+ *
+ * @param files - Array of DiffFile objects to filter
+ * @param patterns - Glob patterns to exclude (e.g., ["*.md", "*.lock"])
+ * @returns Filtered array with ignored files removed
+ */
+export declare function filterIgnoredFiles(files: DiffFile[], patterns: string[]): DiffFile[];
+/**
+ * Truncate a diff string to fit within a token budget.
+ *
+ * Uses a rough approximation of 1 token ≈ 4 characters, which is
+ * a reasonable middle ground across different LLM tokenizers.
+ *
+ * @param diff - The diff string to truncate
+ * @param maxTokens - Maximum number of tokens allowed
+ * @returns Object with the (possibly truncated) diff and a flag indicating truncation
+ */
+export declare function truncateDiff(diff: string, maxTokens: number): {
+    truncated: string;
+    wasTruncated: boolean;
+};
+//# sourceMappingURL=diff.d.ts.map

package/dist/utils/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CA2CvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAOpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAc9C"}

package/dist/utils/diff.js

@@ -0,0 +1,103 @@
+/**
+ * Unified diff parsing utilities.
+ *
+ * Provides functions to extract structured file information from unified
+ * diffs, filter out ignored files (e.g., lockfiles, docs), and truncate
+ * large diffs to fit within LLM token budgets.
+ */
+import { minimatch } from 'minimatch';
+// ─── Constants ──────────────────────────────────────────────────
+/**
+ * Regex to match the start of a file diff block.
+ * Handles both `a/path` and `b/path` formats from git diff.
+ */
+const FILE_HEADER_RE = /^diff --git a\/.+ b\/(.+)$/;
+// ─── Core Functions ─────────────────────────────────────────────
+/**
+ * Parse a unified diff string into structured file objects.
+ *
+ * Splits the diff by file boundaries (diff --git lines), extracts
+ * file paths, and counts additions/deletions per file.
+ *
+ * @param diff - Full unified diff string
+ * @returns Array of DiffFile objects
+ */
+export function parseDiffFiles(diff) {
+    const files = [];
+    const lines = diff.split('\n');
+    let currentFile = null;
+    const contentLines = [];
+    function flushCurrent() {
+        if (currentFile) {
+            currentFile.content = contentLines.join('\n');
+            files.push(currentFile);
+            contentLines.length = 0;
+        }
+    }
+    for (const line of lines) {
+        const match = FILE_HEADER_RE.exec(line);
+        if (match) {
+            // Start of a new file — flush previous
+            flushCurrent();
+            currentFile = {
+                path: match[1],
+                additions: 0,
+                deletions: 0,
+                content: '',
+            };
+            contentLines.push(line);
+        }
+        else if (currentFile) {
+            contentLines.push(line);
+            // Count additions and deletions (skip hunk headers and --- / +++ lines)
+            if (line.startsWith('+') && !line.startsWith('+++')) {
+                currentFile.additions++;
+            }
+            else if (line.startsWith('-') && !line.startsWith('---')) {
+                currentFile.deletions++;
+            }
+        }
+    }
+    // Flush last file
+    flushCurrent();
+    return files;
+}
+/**
+ * Filter out files matching ignore patterns (e.g., lockfiles, docs).
+ *
+ * Uses minimatch for glob pattern matching, consistent with .gitignore style.
+ *
+ * @param files - Array of DiffFile objects to filter
+ * @param patterns - Glob patterns to exclude (e.g., ["*.md", "*.lock"])
+ * @returns Filtered array with ignored files removed
+ */
+export function filterIgnoredFiles(files, patterns) {
+    if (patterns.length === 0)
+        return files;
+    return files.filter((file) => {
+        // Keep the file if it does NOT match any ignore pattern
+        return !patterns.some((pattern) => minimatch(file.path, pattern, { dot: true }));
+    });
+}
+/**
+ * Truncate a diff string to fit within a token budget.
+ *
+ * Uses a rough approximation of 1 token ≈ 4 characters, which is
+ * a reasonable middle ground across different LLM tokenizers.
+ *
+ * @param diff - The diff string to truncate
+ * @param maxTokens - Maximum number of tokens allowed
+ * @returns Object with the (possibly truncated) diff and a flag indicating truncation
+ */
+export function truncateDiff(diff, maxTokens) {
+    const maxChars = maxTokens * 4;
+    if (diff.length <= maxChars) {
+        return { truncated: diff, wasTruncated: false };
+    }
+    // Truncate at the character limit, then trim to the last complete line
+    const cutoff = diff.lastIndexOf('\n', maxChars);
+    const truncated = (cutoff > 0 ? diff.slice(0, cutoff) : diff.slice(0, maxChars)) +
+        '\n\n[... diff truncated to fit token budget ...]';
+    return { truncated, wasTruncated: true };
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

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

package/dist/utils/stack-detect.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tech stack detection from file extensions.
+ *
+ * Analyzes a list of file paths (typically from a diff) to determine
+ * which technology stacks are involved. This allows the review engine
+ * to inject stack-specific review hints into agent prompts.
+ */
+/**
+ * Detect technology stacks from a list of file paths.
+ *
+ * @param fileList - Array of file paths (e.g., ["src/index.ts", "lib/utils.py"])
+ * @returns Deduplicated array of stack names (e.g., ["typescript", "python"])
+ */
+export declare function detectStacks(fileList: string[]): string[];
+//# sourceMappingURL=stack-detect.d.ts.map

package/dist/utils/stack-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detect.d.ts","sourceRoot":"","sources":["../../src/utils/stack-detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAczD"}

package/dist/utils/stack-detect.js

@@ -0,0 +1,54 @@
+/**
+ * Tech stack detection from file extensions.
+ *
+ * Analyzes a list of file paths (typically from a diff) to determine
+ * which technology stacks are involved. This allows the review engine
+ * to inject stack-specific review hints into agent prompts.
+ */
+import { extname } from 'node:path';
+/**
+ * Mapping of file extensions to the technology stacks they represent.
+ * Some extensions map to multiple stacks (e.g., .tsx → typescript + react).
+ */
+const EXTENSION_MAP = {
+    '.ts': ['typescript'],
+    '.tsx': ['typescript', 'react'],
+    '.js': ['javascript'],
+    '.jsx': ['javascript', 'react'],
+    '.mjs': ['javascript'],
+    '.cjs': ['javascript'],
+    '.py': ['python'],
+    '.java': ['java'],
+    '.kt': ['kotlin'],
+    '.kts': ['kotlin'],
+    '.go': ['go'],
+    '.rs': ['rust'],
+    '.sql': ['sql'],
+    '.cs': ['csharp'],
+    '.rb': ['ruby'],
+    '.php': ['php'],
+    '.swift': ['swift'],
+    '.scala': ['scala'],
+    '.ex': ['elixir'],
+    '.exs': ['elixir'],
+};
+/**
+ * Detect technology stacks from a list of file paths.
+ *
+ * @param fileList - Array of file paths (e.g., ["src/index.ts", "lib/utils.py"])
+ * @returns Deduplicated array of stack names (e.g., ["typescript", "python"])
+ */
+export function detectStacks(fileList) {
+    const stacks = new Set();
+    for (const filePath of fileList) {
+        const ext = extname(filePath).toLowerCase();
+        const mapped = EXTENSION_MAP[ext];
+        if (mapped) {
+            for (const stack of mapped) {
+                stacks.add(stack);
+            }
+        }
+    }
+    return [...stacks];
+}
+//# sourceMappingURL=stack-detect.js.map

package/dist/utils/stack-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detect.js","sourceRoot":"","sources":["../../src/utils/stack-detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,aAAa,GAA6B;IAC9C,KAAK,EAAE,CAAC,YAAY,CAAC;IACrB,MAAM,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,KAAK,EAAE,CAAC,YAAY,CAAC;IACrB,MAAM,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,MAAM,EAAE,CAAC,YAAY,CAAC;IACtB,MAAM,EAAE,CAAC,YAAY,CAAC;IACtB,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,KAAK,EAAE,CAAC,IAAI,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,KAAK,CAAC;IACf,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,KAAK,CAAC;IACf,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,MAAM,EAAE,CAAC,QAAQ,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC"}

package/dist/utils/token-budget.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Token budget management for LLM context windows.
+ *
+ * Different models have different context window sizes. This module
+ * provides utilities to calculate how much of the token budget should
+ * be allocated to the diff vs. surrounding context (system prompt,
+ * static analysis, memory, stack hints).
+ */
+/**
+ * Get the context window size for a given model.
+ *
+ * @param model - Model identifier (e.g., "claude-sonnet-4-20250514", "gpt-4o")
+ * @returns Context window size in tokens
+ */
+export declare function getContextWindow(model: string): number;
+/**
+ * Calculate token budgets for diff and context.
+ *
+ * The diff gets 70% of the total context window, while surrounding
+ * context (system prompt, memory, static analysis hints) gets 30%.
+ * This ensures the diff always has enough room while leaving space
+ * for enrichment.
+ *
+ * @param model - Model identifier
+ * @returns Object with diffBudget and contextBudget in tokens
+ */
+export declare function calculateTokenBudget(model: string): {
+    diffBudget: number;
+    contextBudget: number;
+};
+//# sourceMappingURL=token-budget.d.ts.map

package/dist/utils/token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../src/utils/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoCH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,CAOA"}

package/dist/utils/token-budget.js

@@ -0,0 +1,62 @@
+/**
+ * Token budget management for LLM context windows.
+ *
+ * Different models have different context window sizes. This module
+ * provides utilities to calculate how much of the token budget should
+ * be allocated to the diff vs. surrounding context (system prompt,
+ * static analysis, memory, stack hints).
+ */
+// ─── Context Window Sizes ───────────────────────────────────────
+/**
+ * Known model context window sizes (in tokens).
+ * Sourced from official provider documentation as of 2025.
+ */
+const MODEL_CONTEXT_WINDOWS = {
+    // Anthropic
+    'claude-sonnet-4-20250514': 200_000,
+    'claude-3-5-sonnet-20241022': 200_000,
+    'claude-3-5-haiku-20241022': 200_000,
+    // OpenAI
+    'gpt-4o': 128_000,
+    'gpt-4o-mini': 128_000,
+    'gpt-4-turbo': 128_000,
+    // Google
+    'gemini-2.0-flash': 1_048_576,
+    'gemini-1.5-pro': 2_097_152,
+    'gemini-1.5-flash': 1_048_576,
+};
+/** Default context window when the model is not in our lookup table. */
+const DEFAULT_CONTEXT_WINDOW = 128_000;
+/** Fraction of total budget allocated to the diff content. */
+const DIFF_BUDGET_RATIO = 0.7;
+/** Fraction of total budget allocated to context (system, memory, static analysis). */
+const CONTEXT_BUDGET_RATIO = 0.3;
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Get the context window size for a given model.
+ *
+ * @param model - Model identifier (e.g., "claude-sonnet-4-20250514", "gpt-4o")
+ * @returns Context window size in tokens
+ */
+export function getContextWindow(model) {
+    return MODEL_CONTEXT_WINDOWS[model] ?? DEFAULT_CONTEXT_WINDOW;
+}
+/**
+ * Calculate token budgets for diff and context.
+ *
+ * The diff gets 70% of the total context window, while surrounding
+ * context (system prompt, memory, static analysis hints) gets 30%.
+ * This ensures the diff always has enough room while leaving space
+ * for enrichment.
+ *
+ * @param model - Model identifier
+ * @returns Object with diffBudget and contextBudget in tokens
+ */
+export function calculateTokenBudget(model) {
+    const total = getContextWindow(model);
+    return {
+        diffBudget: Math.floor(total * DIFF_BUDGET_RATIO),
+        contextBudget: Math.floor(total * CONTEXT_BUDGET_RATIO),
+    };
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/utils/token-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../src/utils/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,qBAAqB,GAA2B;IACpD,YAAY;IACZ,0BAA0B,EAAE,OAAO;IACnC,4BAA4B,EAAE,OAAO;IACrC,2BAA2B,EAAE,OAAO;IAEpC,SAAS;IACT,QAAQ,EAAE,OAAO;IACjB,aAAa,EAAE,OAAO;IACtB,aAAa,EAAE,OAAO;IAEtB,SAAS;IACT,kBAAkB,EAAE,SAAS;IAC7B,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,SAAS;CAC9B,CAAC;AAEF,wEAAwE;AACxE,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAEvC,8DAA8D;AAC9D,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,uFAAuF;AACvF,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,mEAAmE;AAEnE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,sBAAsB,CAAC;AAChE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAIhD,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAEtC,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,iBAAiB,CAAC;QACjD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,oBAAoB,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "ghagga-core",
+  "version": "2.0.0",
+  "private": false,
+  "type": "module",
+  "description": "Core review engine for GHAGGA — AI-powered multi-agent code reviewer",
+  "author": "JNZader",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JNZader/ghagga.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/JNZader/ghagga#readme",
+  "bugs": {
+    "url": "https://github.com/JNZader/ghagga/issues"
+  },
+  "keywords": [
+    "ghagga",
+    "code-review",
+    "ai",
+    "multi-agent",
+    "llm",
+    "static-analysis",
+    "github"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:mutate": "stryker run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^1.2.0",
+    "@ai-sdk/google": "^1.2.0",
+    "@ai-sdk/openai": "^1.3.0",
+    "ghagga-db": "workspace:^",
+    "ai": "^4.3.0",
+    "minimatch": "^10.0.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@stryker-mutator/core": "^9.6.0",
+    "@stryker-mutator/vitest-runner": "^9.6.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}