ghagga-core 2.8.0 → 2.9.0

package/dist/latent-comms.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Latent-space communication — compress inter-agent messages to reduce
+ * token consumption in multi-agent review modes.
+ *
+ * Instead of passing full specialist text (~5K tokens) to synthesis,
+ * extracts structured findings + compact summary (~1.5K tokens).
+ * Zero extra LLM calls — pure extraction + template merge.
+ */
+export interface StructuredFinding {
+    severity: 'critical' | 'major' | 'minor' | 'info';
+    description: string;
+    file?: string;
+    line?: number;
+    suggestion?: string;
+}
+export interface CompressedOutput {
+    agentName: string;
+    summary: string;
+    findings: StructuredFinding[];
+    tokenEstimate: number;
+    originalTokens: number;
+}
+export interface LatentMergeResult {
+    mergedPrompt: string;
+    totalTokensSaved: number;
+    agentCount: number;
+}
+export declare function estimateTokens(text: string): number;
+export declare function compressAgentOutput(agentName: string, rawOutput: string, budgetTokens?: number): CompressedOutput;
+export declare function mergeCompressed(outputs: CompressedOutput[]): LatentMergeResult;
+//# sourceMappingURL=latent-comms.d.ts.map

package/dist/latent-comms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latent-comms.d.ts","sourceRoot":"","sources":["../src/latent-comms.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAoFD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CA0ClB;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CA4B9E"}

package/dist/latent-comms.js

@@ -0,0 +1,139 @@
+/**
+ * Latent-space communication — compress inter-agent messages to reduce
+ * token consumption in multi-agent review modes.
+ *
+ * Instead of passing full specialist text (~5K tokens) to synthesis,
+ * extracts structured findings + compact summary (~1.5K tokens).
+ * Zero extra LLM calls — pure extraction + template merge.
+ */
+// ── Token estimation ──
+export function estimateTokens(text) {
+    return Math.floor(text.length / 4);
+}
+// ── Finding extraction ──
+const SEVERITY_PATTERNS = [
+    { severity: 'critical', pattern: /\*\*(?:critical|security|sql injection|rce)/i },
+    { severity: 'major', pattern: /\*\*(?:major|missing|bug|error|vulnerability)/i },
+    { severity: 'minor', pattern: /\*\*(?:minor|nit|style|naming|hardcoded)/i },
+];
+const FINDING_RE = /^[-*]\s+\*\*(.+?)\*\*(?:\s+in\s+`([^`]+?)(?::(\d+))?`)?\s*[—–-]\s*(.+)/;
+const SUGGESTION_RE = /^\s+Suggestion:\s*(.+)/;
+function parseFinding(line, nextLine) {
+    const match = FINDING_RE.exec(line);
+    if (!match)
+        return null;
+    const title = match[1]?.trim();
+    const file = match[2] ?? undefined;
+    const lineNum = match[3] ? parseInt(match[3], 10) : undefined;
+    const description = match[4]?.trim();
+    const suggestion = nextLine ? SUGGESTION_RE.exec(nextLine)?.[1]?.trim() : undefined;
+    // Determine severity from title
+    let severity = 'info';
+    for (const { severity: sev, pattern } of SEVERITY_PATTERNS) {
+        if (pattern.test(`**${title}`)) {
+            severity = sev;
+            break;
+        }
+    }
+    return {
+        severity,
+        description: `${title}: ${description}`,
+        file,
+        line: lineNum,
+        suggestion,
+    };
+}
+function extractFindings(text) {
+    const lines = text.split('\n');
+    const findings = [];
+    for (let i = 0; i < lines.length; i++) {
+        const finding = parseFinding(lines[i], lines[i + 1]);
+        if (finding) {
+            findings.push(finding);
+        }
+    }
+    return findings;
+}
+function extractSummary(text) {
+    // Look for explicit summary section
+    const summaryMatch = text.match(/###?\s*Summary\n([\s\S]*?)(?=\n###?\s|\n$|$)/i);
+    if (summaryMatch) {
+        return summaryMatch[1]?.trim();
+    }
+    // Fallback: first non-heading paragraph
+    const lines = text.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed &&
+            !trimmed.startsWith('#') &&
+            !trimmed.startsWith('-') &&
+            !trimmed.startsWith('*')) {
+            return trimmed.slice(0, 200);
+        }
+    }
+    return '';
+}
+// ── Compression ──
+export function compressAgentOutput(agentName, rawOutput, budgetTokens) {
+    const originalTokens = estimateTokens(rawOutput);
+    if (!rawOutput.trim()) {
+        return {
+            agentName,
+            summary: '',
+            findings: [],
+            tokenEstimate: 0,
+            originalTokens: 0,
+        };
+    }
+    const findings = extractFindings(rawOutput);
+    const summary = extractSummary(rawOutput);
+    // Build compressed representation
+    let compressed = `[${agentName}] ${summary}`;
+    for (const f of findings) {
+        const loc = f.file ? ` (${f.file}${f.line ? `:${f.line}` : ''})` : '';
+        compressed += `\n- [${f.severity}]${loc} ${f.description}`;
+        if (f.suggestion) {
+            compressed += ` → ${f.suggestion}`;
+        }
+    }
+    let tokenEstimate = estimateTokens(compressed);
+    // Truncate if over budget
+    if (budgetTokens && tokenEstimate > budgetTokens) {
+        const charBudget = budgetTokens * 4;
+        compressed = compressed.slice(0, charBudget);
+        tokenEstimate = budgetTokens;
+    }
+    return {
+        agentName,
+        summary,
+        findings,
+        tokenEstimate,
+        originalTokens,
+    };
+}
+// ── Merge ──
+export function mergeCompressed(outputs) {
+    if (outputs.length === 0) {
+        return { mergedPrompt: '', totalTokensSaved: 0, agentCount: 0 };
+    }
+    const sections = [];
+    let totalOriginal = 0;
+    for (const output of outputs) {
+        totalOriginal += output.originalTokens;
+        let section = `### ${output.agentName}\n${output.summary}`;
+        for (const f of output.findings) {
+            const loc = f.file ? ` (${f.file}${f.line ? `:${f.line}` : ''})` : '';
+            section += `\n- [${f.severity}]${loc} ${f.description}`;
+        }
+        sections.push(section);
+    }
+    const mergedPrompt = sections.join('\n\n');
+    const mergedTokens = estimateTokens(mergedPrompt);
+    const totalTokensSaved = totalOriginal - mergedTokens;
+    return {
+        mergedPrompt,
+        totalTokensSaved: Math.max(0, totalTokensSaved),
+        agentCount: outputs.length,
+    };
+}
+//# sourceMappingURL=latent-comms.js.map

package/dist/latent-comms.js.map

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

package/dist/memory/pageindex/chunker.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PageIndex Chunker for GHAGGA
+ *
+ * Chunks project memory by topics and extracts file references.
+ */
+import type { ProjectPageChunk, CompactionCheck } from './types.js';
+export declare const GHAGGA_CHUNK_CONFIG: {
+    maxTokensPerPage: number;
+    overlapTokens: number;
+    maxTopicLength: number;
+};
+export declare function estimateTokens(text: string): number;
+/**
+ * Extract topics from content (headers, emphasized text, file refs)
+ */
+export declare function extractTopics(content: string): string[];
+/**
+ * Extract file references from content
+ */
+export declare function extractFileRefs(content: string): string[];
+/**
+ * Chunk project memory into pages
+ */
+export declare function chunkProjectMemory(projectId: string, content: string, config?: {
+    maxTokensPerPage: number;
+    overlapTokens: number;
+    maxTopicLength: number;
+}): Omit<ProjectPageChunk, 'id' | 'createdAt'>[];
+/**
+ * Check if compaction is needed
+ */
+export declare function shouldCompact(currentTokens: number, modelMaxTokens: number, safetyMargin?: number): CompactionCheck;
+//# sourceMappingURL=chunker.d.ts.map

package/dist/memory/pageindex/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../src/memory/pageindex/chunker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM;;;;CAAsB,GAC3B,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,WAAW,CAAC,EAAE,CAoC9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,SAAM,GACjB,eAAe,CAajB"}

package/dist/memory/pageindex/chunker.js

@@ -0,0 +1,112 @@
+/**
+ * PageIndex Chunker for GHAGGA
+ *
+ * Chunks project memory by topics and extracts file references.
+ */
+export const GHAGGA_CHUNK_CONFIG = {
+    maxTokensPerPage: 1500,
+    overlapTokens: 200,
+    maxTopicLength: 50,
+};
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Extract topics from content (headers, emphasized text, file refs)
+ */
+export function extractTopics(content) {
+    const topics = [];
+    // Headers (### Topic)
+    const headers = content.match(/^#{1,3}\s+(.+)$/gm);
+    if (headers) {
+        headers.slice(0, 5).forEach(h => {
+            topics.push(h.replace(/^#+\s+/, '').slice(0, 50));
+        });
+    }
+    // Bold text (**topic**)
+    const bold = content.match(/\*\*(.+?)\*\*/g);
+    if (bold && topics.length < 10) {
+        bold.slice(0, 3).forEach(b => {
+            const topic = b.replace(/\*\*/g, '').slice(0, 50);
+            if (!topics.includes(topic))
+                topics.push(topic);
+        });
+    }
+    return topics.slice(0, 8);
+}
+/**
+ * Extract file references from content
+ */
+export function extractFileRefs(content) {
+    const refs = [];
+    // File paths (src/... or **/*.ts)
+    const paths = content.match(/(?:src\/|apps\/|packages\/)[\w\/\-]+\.\w+/g);
+    if (paths) {
+        paths.slice(0, 10).forEach(p => {
+            if (!refs.includes(p))
+                refs.push(p);
+        });
+    }
+    // Glob patterns
+    const globs = content.match(/\*\*\/\*\.\w+/g);
+    if (globs) {
+        globs.slice(0, 5).forEach(g => {
+            if (!refs.includes(g))
+                refs.push(g);
+        });
+    }
+    return refs.slice(0, 15);
+}
+/**
+ * Chunk project memory into pages
+ */
+export function chunkProjectMemory(projectId, content, config = GHAGGA_CHUNK_CONFIG) {
+    const maxChars = config.maxTokensPerPage * 4;
+    const overlapChars = config.overlapTokens * 4;
+    const chunks = [];
+    let pos = 0;
+    while (pos < content.length) {
+        let end = Math.min(pos + maxChars, content.length);
+        if (end < content.length) {
+            // Try to break at section boundary
+            const sectionBreak = content.lastIndexOf('\n\n## ', end);
+            if (sectionBreak > pos + maxChars * 0.5) {
+                end = sectionBreak + 1;
+            }
+            else {
+                // Try paragraph
+                const para = content.lastIndexOf('\n\n', end);
+                if (para > pos + maxChars * 0.7)
+                    end = para + 2;
+            }
+        }
+        chunks.push(content.slice(pos, end).trim());
+        pos = Math.max(pos + 1, end - overlapChars);
+    }
+    // Create page chunks with metadata
+    return chunks.map((chunk, idx) => ({
+        projectId,
+        pageNum: idx + 1,
+        totalPages: chunks.length,
+        content: chunk,
+        topics: extractTopics(chunk),
+        fileRefs: extractFileRefs(chunk),
+        tokenCount: estimateTokens(chunk),
+    }));
+}
+/**
+ * Check if compaction is needed
+ */
+export function shouldCompact(currentTokens, modelMaxTokens, safetyMargin = 0.3) {
+    const threshold = modelMaxTokens * (1 - safetyMargin);
+    const shouldCompact = currentTokens > threshold;
+    return {
+        currentTokens,
+        maxTokens: modelMaxTokens,
+        projectId: '',
+        shouldCompact,
+        safeToProceed: !shouldCompact,
+        suggestedAction: shouldCompact ? 'paginate' : 'none',
+    };
+}
+//# sourceMappingURL=chunker.js.map

package/dist/memory/pageindex/chunker.js.map

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

package/dist/memory/pageindex/example.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PageIndex Usage Example for GHAGGA
+ *
+ * Demonstrates how to use ProjectPageIndexService in review workflows.
+ */
+import { ProjectPageIndexService } from './index.js';
+export declare function exampleReviewWorkflow(pageIndex: ProjectPageIndexService, projectId: string, pr: {
+    title: string;
+    description: string;
+    files: string[];
+}, modelMaxTokens?: number): Promise<{
+    context: string;
+    tokens: number;
+    pagesUsed: number;
+    safe: boolean;
+}>;
+export declare function exampleCreatePageIndex(pageIndex: ProjectPageIndexService, projectId: string, projectMemory: string): Promise<{
+    pages: number;
+    tokens: number;
+}>;
+export declare function exampleContextWindow(pageIndex: ProjectPageIndexService, projectId: string, targetPage: number): string;
+//# sourceMappingURL=example.d.ts.map

package/dist/memory/pageindex/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../../src/memory/pageindex/example.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAiB,MAAM,YAAY,CAAC;AAGpE,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,uBAAuB,EAClC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAC3D,cAAc,GAAE,MAAa;;;;;GAmE9B;AAGD,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,uBAAuB,EAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM;;;GAUtB;AAGD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,uBAAuB,EAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,UA2BnB"}

package/dist/memory/pageindex/example.js

@@ -0,0 +1,94 @@
+/**
+ * PageIndex Usage Example for GHAGGA
+ *
+ * Demonstrates how to use ProjectPageIndexService in review workflows.
+ */
+import { PageDirection } from './index.js';
+// Example: Using PageIndex in a review workflow
+export async function exampleReviewWorkflow(pageIndex, projectId, pr, modelMaxTokens = 4096 // Small model like llama-3.2-3b
+) {
+    // Step 1: Check if we need pagination
+    const compactionCheck = pageIndex.checkCompaction(projectId, modelMaxTokens);
+    if (compactionCheck.shouldCompact) {
+        console.log(`⚠️ Project memory ${compactionCheck.currentTokens} tokens exceeds safe limit for ${modelMaxTokens} model`);
+        console.log(`💡 Using PageIndex to paginate into manageable chunks`);
+    }
+    // Step 2: Find relevant pages based on PR context
+    console.log('🔍 Finding relevant pages for PR context...');
+    const relevantPages = pageIndex.findRelevantPages({
+        projectId,
+        prContext: {
+            title: pr.title,
+            description: pr.description,
+            files: pr.files,
+        },
+        maxPages: 3, // Only get top 3 most relevant pages
+    });
+    console.log(`📄 Found ${relevantPages.length} relevant pages`);
+    // Step 3: Build context from relevant pages
+    let context = '';
+    let totalTokens = 0;
+    for (const page of relevantPages) {
+        // Check if adding this page would exceed limit
+        if (totalTokens + page.tokenCount > modelMaxTokens * 0.6) {
+            console.log(`⚠️ Stopping at ${totalTokens} tokens to leave room for response`);
+            break;
+        }
+        context += `\n\n--- Page ${page.pageNum}/${page.totalPages} ---\n`;
+        context += `Topics: ${page.topics.join(', ')}\n`;
+        context += page.content;
+        totalTokens += page.tokenCount;
+    }
+    console.log(`📊 Total context: ${totalTokens} tokens from ${relevantPages.length} pages`);
+    console.log(`✅ Safe to proceed: ${totalTokens < modelMaxTokens * 0.7}`);
+    // Step 4: If we need more context, navigate to adjacent pages
+    if (relevantPages.length > 0) {
+        const lastPage = relevantPages[relevantPages.length - 1];
+        if (lastPage.pageNum < lastPage.totalPages) {
+            const nextPage = pageIndex.navigate({
+                projectId,
+                currentPageNum: lastPage.pageNum,
+                direction: PageDirection.NEXT,
+            });
+            if (nextPage) {
+                console.log(`➡️ Can navigate to page ${nextPage.pageNum} if needed`);
+            }
+        }
+    }
+    return {
+        context,
+        tokens: totalTokens,
+        pagesUsed: relevantPages.length,
+        safe: totalTokens < modelMaxTokens * 0.7,
+    };
+}
+// Example: Creating page index for large project
+export async function exampleCreatePageIndex(pageIndex, projectId, projectMemory) {
+    console.log('📚 Creating PageIndex for large project memory...');
+    const result = await pageIndex.createPageIndex(projectId, projectMemory);
+    console.log(`✅ Created ${result.pages} pages (${result.tokens} tokens total)`);
+    console.log(`📄 Average ${Math.round(result.tokens / result.pages)} tokens per page`);
+    return result;
+}
+// Example: Reading with context window
+export function exampleContextWindow(pageIndex, projectId, targetPage) {
+    console.log(`📖 Reading page ${targetPage} with context window...`);
+    const context = pageIndex.getContext({
+        projectId,
+        pageNum: targetPage,
+        windowSize: 1, // Get previous, current, and next page
+    });
+    console.log(`📄 Context window: ${context.previousPages.length} before, ${context.nextPages.length} after`);
+    console.log(`📊 Total in window: ${context.totalInContext} pages (${context.totalTokens} tokens)`);
+    // Build full context text
+    let fullContext = '';
+    for (const page of context.previousPages) {
+        fullContext += `\n[Prev Page ${page.pageNum}]\n${page.content.substring(0, 200)}...\n`;
+    }
+    fullContext += `\n[CURRENT PAGE ${context.currentPage.pageNum}]\n${context.currentPage.content}\n`;
+    for (const page of context.nextPages) {
+        fullContext += `\n[Next Page ${page.pageNum}]\n${page.content.substring(0, 200)}...\n`;
+    }
+    return fullContext;
+}
+//# sourceMappingURL=example.js.map

package/dist/memory/pageindex/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../../src/memory/pageindex/example.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA2B,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAkC,EAClC,SAAiB,EACjB,EAA2D,EAC3D,iBAAyB,IAAI,CAAC,gCAAgC;;IAE9D,sCAAsC;IACtC,MAAM,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAE7E,IAAI,eAAe,CAAC,aAAa,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,qBAAqB,eAAe,CAAC,aAAa,kCAAkC,cAAc,QAAQ,CAAC,CAAC;QACxH,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;IAED,kDAAkD;IAClD,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,SAAS,CAAC,iBAAiB,CAAC;QAChD,SAAS;QACT,SAAS,EAAE;YACT,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,KAAK,EAAE,EAAE,CAAC,KAAK;SAChB;QACD,QAAQ,EAAE,CAAC,EAAE,qCAAqC;KACnD,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,YAAY,aAAa,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAE/D,4CAA4C;IAC5C,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,+CAA+C;QAC/C,IAAI,WAAW,GAAG,IAAI,CAAC,UAAU,GAAG,cAAc,GAAG,GAAG,EAAE,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,kBAAkB,WAAW,oCAAoC,CAAC,CAAC;YAC/E,MAAM;QACR,CAAC;QAED,OAAO,IAAI,gBAAgB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,QAAQ,CAAC;QACnE,OAAO,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACjD,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QACxB,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,WAAW,gBAAgB,aAAa,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,sBAAsB,WAAW,GAAG,cAAc,GAAG,GAAG,EAAE,CAAC,CAAC;IAExE,8DAA8D;IAC9D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEzD,IAAI,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;gBAClC,SAAS;gBACT,cAAc,EAAE,QAAQ,CAAC,OAAO;gBAChC,SAAS,EAAE,aAAa,CAAC,IAAI;aAC9B,CAAC,CAAC;YAEH,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,CAAC,OAAO,YAAY,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,aAAa,CAAC,MAAM;QAC/B,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,GAAG;KACzC,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAkC,EAClC,SAAiB,EACjB,aAAqB;IAErB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAEzE,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,MAAM,gBAAgB,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEtF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,oBAAoB,CAClC,SAAkC,EAClC,SAAiB,EACjB,UAAkB;IAElB,OAAO,CAAC,GAAG,CAAC,mBAAmB,UAAU,yBAAyB,CAAC,CAAC;IAEpE,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC;QACnC,SAAS;QACT,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,CAAC,EAAE,uCAAuC;KACvD,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,CAAC,aAAa,CAAC,MAAM,YAAY,OAAO,CAAC,SAAS,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC5G,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,cAAc,WAAW,OAAO,CAAC,WAAW,UAAU,CAAC,CAAC;IAEnG,0BAA0B;IAC1B,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,WAAW,IAAI,gBAAgB,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACzF,CAAC;IAED,WAAW,IAAI,mBAAmB,OAAO,CAAC,WAAW,CAAC,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC;IAEnG,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACrC,WAAW,IAAI,gBAAgB,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACzF,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/memory/pageindex/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PageIndex for GHAGGA Project Memory
+ *
+ * Exports all PageIndex components for navigable project memory.
+ */
+export * from './types.js';
+export * from './chunker.js';
+export * from './service.js';
+import { ProjectPageIndexService } from './service.js';
+export { ProjectPageIndexService };
+/**
+ * Quick factory function
+ */
+export declare function createProjectPageIndex(db: any): ProjectPageIndexService;
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/pageindex/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/pageindex/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,GAAG,2BAE7C"}

package/dist/memory/pageindex/index.js

@@ -0,0 +1,17 @@
+/**
+ * PageIndex for GHAGGA Project Memory
+ *
+ * Exports all PageIndex components for navigable project memory.
+ */
+export * from './types.js';
+export * from './chunker.js';
+export * from './service.js';
+import { ProjectPageIndexService } from './service.js';
+export { ProjectPageIndexService };
+/**
+ * Quick factory function
+ */
+export function createProjectPageIndex(db) {
+    return new ProjectPageIndexService(db);
+}
+//# sourceMappingURL=index.js.map

package/dist/memory/pageindex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/pageindex/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAO;IAC5C,OAAO,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/memory/pageindex/service.d.ts

@@ -0,0 +1,53 @@
+/**
+ * PageIndex Service for GHAGGA
+ *
+ * Manages paginated project memory using GHAGGA's sql.js database.
+ */
+import type { Database } from 'fts5-sql-bundle';
+import type { ProjectPageChunk, PageContextRequest, PageContextResponse, PageNavigationRequest, CompactionCheck, RelevantPageRequest } from './types.js';
+export declare class ProjectPageIndexService {
+    private db;
+    constructor(db: Database);
+    private initSchema;
+    /**
+     * Create page index for project memory
+     */
+    createPageIndex(projectId: string, content: string): Promise<{
+        pages: number;
+        tokens: number;
+    }>;
+    /**
+     * Get a specific page
+     */
+    getPage(projectId: string, pageNum: number): ProjectPageChunk | null;
+    /**
+     * Get context window around a page
+     */
+    getContext(request: PageContextRequest): PageContextResponse;
+    /**
+     * Navigate to adjacent page
+     */
+    navigate(request: PageNavigationRequest): ProjectPageChunk | null;
+    /**
+     * Find pages relevant to PR context
+     */
+    findRelevantPages(request: RelevantPageRequest): ProjectPageChunk[];
+    /**
+     * Check if compaction is needed
+     */
+    checkCompaction(projectId: string, modelMaxTokens: number): CompactionCheck;
+    /**
+     * Get project stats
+     */
+    getProjectStats(projectId: string): {
+        pages: number;
+        tokens: number;
+    };
+    /**
+     * Delete project page index
+     */
+    deletePageIndex(projectId: string): void;
+    private rowToPageChunk;
+    private rowsToPageChunks;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/memory/pageindex/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/memory/pageindex/service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAcpB,qBAAa,uBAAuB;IAClC,OAAO,CAAC,EAAE,CAAqB;gBAEnB,EAAE,EAAE,QAAQ;IAKxB,OAAO,CAAC,UAAU;IA4BlB;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAwDrG;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAapE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB;IAiC5D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,IAAI;IAkBjE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,EAAE;IA4CnE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,eAAe;IAO3E;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAoBrE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOxC,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,gBAAgB;CAMzB"}