@madkid/relay-ctx 0.1.0

package/dist/commands/sync.d.ts

@@ -0,0 +1,17 @@
+/**
+ * relay sync — Scan project and update context.
+ *
+ * Options:
+ * --silent  Suppress all output (used by git hooks)
+ *
+ * Flow:
+ * 1. Scan the project directory
+ * 2. Read existing PROJECT.md
+ * 3. Update auto-generated sections, preserve human-written ones
+ * 4. Write updated PROJECT.md
+ * 5. Show diff summary (unless --silent)
+ */
+export declare function syncCommand(options?: {
+    silent?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAsIA;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgH/E"}

package/dist/commands/sync.js

@@ -0,0 +1,239 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncCommand = syncCommand;
+const scanner_1 = require("../core/scanner");
+const storage_1 = require("../core/storage");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Format GitContext data into a markdown string.
+ */
+function formatGitSection(git) {
+    if (!git.isGitRepo) {
+        return '';
+    }
+    const lines = [];
+    lines.push(`- **Branch:** ${git.currentBranch || 'unknown'}`);
+    lines.push(`- **Last Commit:** ${git.lastCommitHash ? `\`${git.lastCommitHash.slice(0, 7)}\`` : 'none'}`);
+    lines.push('\n### Uncommitted changes');
+    if (git.uncommittedChanges.length === 0) {
+        lines.push('Uncommitted changes: (clean)');
+    }
+    else {
+        git.uncommittedChanges.forEach((change) => {
+            lines.push(`- \`${change.file}\` (${change.status}) | +${change.additions} -${change.deletions}`);
+        });
+    }
+    if (git.stagedFiles.length > 0) {
+        lines.push('\n### Staged files');
+        git.stagedFiles.forEach((file) => {
+            lines.push(`- \`${file}\``);
+        });
+    }
+    if (git.recentCommits.length > 0) {
+        lines.push('\n### Recent commits');
+        git.recentCommits.forEach((commit) => {
+            lines.push(`- \`${commit.hash}\` (${commit.timeAgo}) - ${commit.message}`);
+            if (commit.filesChanged.length > 0) {
+                lines.push(`  _Changed:_ ${commit.filesChanged.map((f) => `\`${f}\``).join(', ')}`);
+            }
+        });
+    }
+    return '\n' + lines.join('\n');
+}
+/**
+ * Sections that are auto-updated by sync.
+ * These are regenerated from the scan data.
+ */
+const AUTO_SECTIONS = new Set([
+    'File structure',
+    'Tech stack',
+]);
+/**
+ * Sections that are human-written and never overwritten by sync.
+ */
+const PROTECTED_SECTIONS = new Set([
+    "What we're building",
+    'Conventions',
+    "What's next",
+    "What we're NOT building",
+]);
+/**
+ * Parse PROJECT.md into sections by ## headings.
+ */
+function parseSections(md) {
+    const sections = new Map();
+    const lines = md.split('\n');
+    let currentHeading = '__preamble__';
+    let currentLines = [];
+    for (const line of lines) {
+        const match = line.match(/^##\s+(.+)/);
+        if (match) {
+            sections.set(currentHeading, currentLines.join('\n').trimEnd());
+            currentHeading = match[1].trim();
+            currentLines = [];
+        }
+        else {
+            currentLines.push(line);
+        }
+    }
+    sections.set(currentHeading, currentLines.join('\n').trimEnd());
+    return sections;
+}
+/**
+ * Render a ProjectScan as a file structure section.
+ */
+function renderFileStructure(scan) {
+    let content = '\n```\n' + scan.structure + '\n```\n';
+    // File counts
+    const counts = Object.entries(scan.fileCount)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([ext, count]) => `  ${ext}: ${count}`)
+        .join('\n');
+    content += `\n**File counts:**\n${counts}`;
+    return content;
+}
+/**
+ * Render tech stack section.
+ */
+function renderTechStack(scan) {
+    return '\n' + scan.techStack.map((t) => `- ${t}`).join('\n');
+}
+/**
+ * Render "What's in progress" section from recently modified files.
+ */
+function renderInProgress(scan, existing) {
+    const recentFiles = scan.recentlyModified
+        .map((f) => `- \`${f}\``)
+        .join('\n');
+    // Strip out any previously generated "Recently modified:" section
+    const cleanedExisting = existing.replace(/\*\*Recently modified:\*\*[\s\S]*/i, '').trim();
+    // Keep any existing human-written content and append recent changes
+    const lines = [];
+    if (cleanedExisting) {
+        lines.push(cleanedExisting);
+    }
+    lines.push(`\n**Recently modified:**\n${recentFiles}`);
+    return '\n' + lines.join('\n');
+}
+/**
+ * relay sync — Scan project and update context.
+ *
+ * Options:
+ * --silent  Suppress all output (used by git hooks)
+ *
+ * Flow:
+ * 1. Scan the project directory
+ * 2. Read existing PROJECT.md
+ * 3. Update auto-generated sections, preserve human-written ones
+ * 4. Write updated PROJECT.md
+ * 5. Show diff summary (unless --silent)
+ */
+async function syncCommand(options) {
+    const silent = options?.silent ?? false;
+    const projectName = (0, storage_1.getProjectName)();
+    const projectPath = (0, storage_1.getProjectPath)();
+    if (!fs_1.default.existsSync(projectPath)) {
+        if (silent)
+            return;
+        console.log('❌ Relay not initialized for this project. Run `relay init` first.');
+        process.exit(1);
+    }
+    if (!silent) {
+        console.log(`\n🔄 Syncing "${projectName}"...\n`);
+    }
+    // 1. Scan
+    const scan = await (0, scanner_1.scanProject)(process.cwd());
+    // 2. Read existing PROJECT.md
+    let existingMd = (0, storage_1.readProjectMd)();
+    // Strip any historical/duplicated sync footers
+    existingMd = existingMd.replace(/\n*---\n*_Last synced:[0-9: \-_]+_\s*/gi, '').trimEnd();
+    const sections = parseSections(existingMd);
+    // 3. Update sections
+    const updated = [];
+    // Track what changed
+    const changes = [];
+    // Preamble (title etc.)
+    if (sections.has('__preamble__')) {
+        updated.push(sections.get('__preamble__'));
+    }
+    // Update timestamp in preamble
+    const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
+    // Rebuild the document section by section
+    const sectionOrder = [
+        "What we're building",
+        'Tech stack',
+        'Git context',
+        "What's in progress",
+        "What's next",
+        'Conventions',
+        'File structure',
+        "What's working",
+        "What we're NOT building",
+        'Checkpoints',
+    ];
+    for (const heading of sectionOrder) {
+        const existing = sections.get(heading) || '';
+        if (heading === 'File structure') {
+            updated.push(`## File structure\n${renderFileStructure(scan)}`);
+            changes.push('file structure');
+        }
+        else if (heading === 'Tech stack') {
+            updated.push(`## Tech stack\n${renderTechStack(scan)}`);
+            changes.push('tech stack');
+        }
+        else if (heading === "What's in progress") {
+            updated.push(`## What's in progress\n${renderInProgress(scan, existing)}`);
+            changes.push('recently modified');
+        }
+        else if (heading === 'Git context') {
+            const gitContent = formatGitSection(scan.gitContext);
+            if (gitContent) {
+                updated.push(`## Git context\n${gitContent}`);
+                changes.push('git context');
+            }
+        }
+        else if (existing || sections.has(heading)) {
+            // Keep human-written sections as-is
+            updated.push(`## ${heading}\n${existing}`);
+        }
+    }
+    // Add any extra sections not in our known order
+    for (const [heading, content] of sections) {
+        if (heading === '__preamble__')
+            continue;
+        if (sectionOrder.includes(heading))
+            continue;
+        updated.push(`## ${heading}\n${content}`);
+    }
+    // Append sync timestamp
+    const footer = `\n\n---\n_Last synced: ${timestamp}_`;
+    // 4. Write
+    (0, storage_1.writeProjectMd)(updated.join('\n\n') + footer + '\n');
+    // Update meta.json
+    const metaPath = path_1.default.join(projectPath, 'meta.json');
+    let meta = {};
+    if (fs_1.default.existsSync(metaPath)) {
+        try {
+            meta = JSON.parse(fs_1.default.readFileSync(metaPath, 'utf-8'));
+        }
+        catch {
+            // ignore
+        }
+    }
+    meta.name = projectName;
+    meta.cwd = process.cwd();
+    meta.lastSync = new Date().toISOString();
+    fs_1.default.writeFileSync(metaPath, JSON.stringify(meta, null, 2), 'utf-8');
+    // 5. Report
+    if (!silent) {
+        console.log(`✅ Sync complete for "${projectName}"`);
+        console.log(`   Updated: ${changes.join(', ')}`);
+        console.log(`   📁 ${projectPath}\n`);
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/core/compressor.d.ts

@@ -0,0 +1,16 @@
+export type InjectIntent = 'continue' | 'newTask' | 'debug';
+/**
+ * Compress PROJECT.md to under 1800 tokens using Claude Haiku.
+ */
+export declare function compressContext(projectMd: string, apiKey: string, intent?: InjectIntent): Promise<string>;
+/**
+ * Fallback naive truncation respecting section priority.
+ * Used when no API key is available.
+ */
+export declare function truncateContext(projectMd: string): string;
+/**
+ * Preprocesses PROJECT.md content based on intent.
+ * Enforces intent-specific section inclusion, ordering, formatting, and the 1800-token limit.
+ */
+export declare function preprocessContext(projectMd: string, intent: InjectIntent, errorMessage?: string): string;
+//# sourceMappingURL=compressor.d.ts.map

package/dist/core/compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../src/core/compressor.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAwCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAwEzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAsOR"}

package/dist/core/compressor.js

@@ -0,0 +1,354 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compressContext = compressContext;
+exports.truncateContext = truncateContext;
+exports.preprocessContext = preprocessContext;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+/**
+ * Section priority order for context compression.
+ * Lower index = higher priority = kept first.
+ */
+const SECTION_PRIORITY = [
+    "What we're building", // 1 — always kept, max 3 sentences
+    'Tech stack', // 2 — always kept
+    'Git context', // 3 — always kept
+    "What's in progress", // 4 — always kept
+    "What's next", // 5 — always kept
+    'Conventions', // 6 — truncated if needed
+    'File structure', // 7 — collapsed to top level only
+    "What's working", // 8 — dropped if token pressure
+    'Checkpoints', // 9 — always dropped
+];
+/**
+ * Compress PROJECT.md to under 1800 tokens using Claude Haiku.
+ */
+async function compressContext(projectMd, apiKey, intent) {
+    const client = new sdk_1.default({ apiKey });
+    let systemPrompt = `You are a context compressor. Given a PROJECT.md file, compress it to under 1800 tokens while preserving the most important information.`;
+    if (intent) {
+        systemPrompt += `\n\nOptimize the compression for the following developer intent: "${intent}". Keep the focus on the sections priority listed in the user's intent.`;
+    }
+    systemPrompt += `\n\nOutput ONLY the compressed context, no explanations or meta-commentary.`;
+    const response = await client.messages.create({
+        model: 'claude-3-haiku-20240307',
+        max_tokens: 2048,
+        system: systemPrompt,
+        messages: [
+            {
+                role: 'user',
+                content: `Compress this PROJECT.md:\n\n${projectMd}`,
+            },
+        ],
+    });
+    const block = response.content[0];
+    if (block.type === 'text') {
+        return block.text;
+    }
+    // Fallback if response isn't text
+    return truncateContext(projectMd);
+}
+/**
+ * Parse PROJECT.md into sections by ## headings.
+ */
+function parseSections(projectMd) {
+    const lines = projectMd.split('\n');
+    const sections = [];
+    let currentHeading = '';
+    let currentLines = [];
+    for (const line of lines) {
+        const headingMatch = line.match(/^##\s+(.+)/);
+        if (headingMatch) {
+            if (currentHeading || currentLines.length > 0) {
+                sections.push({
+                    heading: currentHeading,
+                    content: currentLines.join('\n').trim(),
+                });
+            }
+            currentHeading = headingMatch[1].trim();
+            currentLines = [];
+        }
+        else {
+            currentLines.push(line);
+        }
+    }
+    // Push final section
+    if (currentHeading || currentLines.length > 0) {
+        sections.push({
+            heading: currentHeading,
+            content: currentLines.join('\n').trim(),
+        });
+    }
+    return sections;
+}
+/**
+ * Fallback naive truncation respecting section priority.
+ * Used when no API key is available.
+ */
+function truncateContext(projectMd) {
+    const sections = parseSections(projectMd);
+    const TOKEN_LIMIT = 2000;
+    // Rough approximation: 1 token ≈ 4 chars
+    const CHAR_LIMIT = TOKEN_LIMIT * 4;
+    const result = [];
+    let charCount = 0;
+    // First pass: add sections in priority order
+    for (const priorityName of SECTION_PRIORITY) {
+        const section = sections.find((s) => s.heading.toLowerCase() === priorityName.toLowerCase());
+        if (!section || !section.content)
+            continue;
+        // Always drop checkpoints
+        if (priorityName === 'Checkpoints')
+            continue;
+        let sectionText = `## ${section.heading}\n\n${section.content}`;
+        // Drop "What's working" if we're over 75% of limit
+        if (priorityName === "What's working" &&
+            charCount > CHAR_LIMIT * 0.75) {
+            continue;
+        }
+        // Collapse file structure to top level
+        if (priorityName === 'File structure') {
+            const lines = section.content.split('\n');
+            const topLevel = lines.filter((l) => !l.startsWith('    ') && !l.startsWith('\t\t'));
+            sectionText = `## ${section.heading}\n\n${topLevel.join('\n')}`;
+        }
+        // Truncate conventions if over budget
+        if (priorityName === 'Conventions' && charCount + sectionText.length > CHAR_LIMIT) {
+            const remaining = Math.max(0, CHAR_LIMIT - charCount - 50);
+            sectionText = sectionText.slice(0, remaining) + '\n...(truncated)';
+        }
+        if (charCount + sectionText.length > CHAR_LIMIT)
+            continue;
+        result.push(sectionText);
+        charCount += sectionText.length;
+    }
+    // Second pass: add custom user-defined sections that are not in SECTION_PRIORITY
+    for (const section of sections) {
+        if (section.heading === '')
+            continue; // preamble handled separately
+        const isPredefined = SECTION_PRIORITY.some((p) => p.toLowerCase() === section.heading.toLowerCase());
+        if (isPredefined)
+            continue;
+        const sectionText = `## ${section.heading}\n\n${section.content}`;
+        if (charCount + sectionText.length < CHAR_LIMIT) {
+            result.push(sectionText);
+            charCount += sectionText.length;
+        }
+    }
+    // Add any preamble (content before first ## heading)
+    const preamble = sections.find((s) => s.heading === '');
+    if (preamble && preamble.content && charCount + preamble.content.length < CHAR_LIMIT) {
+        result.unshift(preamble.content);
+    }
+    return result.join('\n\n');
+}
+/**
+ * Preprocesses PROJECT.md content based on intent.
+ * Enforces intent-specific section inclusion, ordering, formatting, and the 1800-token limit.
+ */
+function preprocessContext(projectMd, intent, errorMessage) {
+    const sections = parseSections(projectMd);
+    const result = [];
+    const findSection = (name) => sections.find((s) => s.heading.toLowerCase() === name.toLowerCase());
+    const getSentences = (text, max) => {
+        if (!text.trim())
+            return '';
+        const sentences = text.split(/(?<=[.!?])\s+/);
+        return sentences.slice(0, max).join(' ').trim();
+    };
+    const trimList = (text, max) => {
+        const lines = text.split('\n');
+        const listLines = [];
+        let count = 0;
+        for (const line of lines) {
+            if (line.trim().startsWith('-') || line.trim().startsWith('*')) {
+                if (count < max) {
+                    listLines.push(line);
+                    count++;
+                }
+            }
+            else {
+                if (count === 0) {
+                    listLines.push(line);
+                }
+            }
+        }
+        return listLines.join('\n').trim();
+    };
+    const collapseStructure = (text) => {
+        const lines = text.split('\n');
+        const topLevel = lines.filter((l) => !l.startsWith('    ') && !l.startsWith('\t\t'));
+        return topLevel.join('\n').trim();
+    };
+    const formatGitContext = (text, rule) => {
+        const lines = text.split('\n');
+        const outputLines = [];
+        let inRecentCommits = false;
+        let commitCount = 0;
+        const maxCommits = rule === 'continue' ? 3 : 5;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.includes('### Uncommitted changes')) {
+                if (rule === 'newTask') {
+                    while (i + 1 < lines.length && !lines[i + 1].startsWith('###') && !lines[i + 1].startsWith('##')) {
+                        i++;
+                    }
+                    continue;
+                }
+                outputLines.push(line);
+                continue;
+            }
+            if (line.includes('### Staged files')) {
+                if (rule === 'newTask' || rule === 'continue') {
+                    while (i + 1 < lines.length && !lines[i + 1].startsWith('###') && !lines[i + 1].startsWith('##')) {
+                        i++;
+                    }
+                    continue;
+                }
+                outputLines.push(line);
+                continue;
+            }
+            if (line.includes('### Recent commits')) {
+                outputLines.push(line);
+                inRecentCommits = true;
+                commitCount = 0;
+                continue;
+            }
+            if (inRecentCommits) {
+                if (line.trim().startsWith('- ')) {
+                    if (commitCount < maxCommits) {
+                        outputLines.push(line);
+                        commitCount++;
+                    }
+                    else {
+                        inRecentCommits = false;
+                    }
+                }
+                else if (line.trim().startsWith('_Changed:_')) {
+                    if (rule !== 'newTask') {
+                        outputLines.push(line);
+                    }
+                }
+                else {
+                    outputLines.push(line);
+                }
+                continue;
+            }
+            outputLines.push(line);
+        }
+        return outputLines.join('\n').trim();
+    };
+    if (intent === 'continue') {
+        // 1. What We're Building (2 sentences max, truncated)
+        const building = findSection("What we're building") || findSection("What We're Building");
+        if (building) {
+            result.push(`## ${building.heading}\n\n${getSentences(building.content, 2)}`);
+        }
+        // 2. Current Session State
+        const sessionState = findSection("Current Session State") || findSection("Current session state");
+        if (sessionState) {
+            result.push(`## ${sessionState.heading}\n\n${sessionState.content}`);
+        }
+        // 3. What's In Progress
+        const inProgress = findSection("What's in progress") || findSection("What's In Progress");
+        if (inProgress) {
+            result.push(`## ${inProgress.heading}\n\n${inProgress.content}`);
+        }
+        // 4. Recent Activity (Git) — full uncommitted changes + last 3 commits
+        const git = findSection("Git context") || findSection("Recent Activity (Git)") || findSection("Recent Activity");
+        if (git) {
+            result.push(`## ${git.heading}\n\n${formatGitContext(git.content, 'continue')}`);
+        }
+        // 5. Tech Stack (just the list, no descriptions)
+        const tech = findSection("Tech stack") || findSection("Tech Stack");
+        if (tech) {
+            const listOnly = tech.content
+                .split('\n')
+                .filter((l) => l.trim().startsWith('-') || l.trim().startsWith('*'))
+                .join('\n');
+            result.push(`## ${tech.heading}\n\n${listOnly}`);
+        }
+        // 6. What's Next (first 3 items only)
+        const next = findSection("What's next") || findSection("What's Next");
+        if (next) {
+            result.push(`## ${next.heading}\n\n${trimList(next.content, 3)}`);
+        }
+    }
+    else if (intent === 'newTask') {
+        // 1. What We're Building (full)
+        const building = findSection("What we're building") || findSection("What We're Building");
+        if (building) {
+            result.push(`## ${building.heading}\n\n${building.content}`);
+        }
+        // 2. Tech Stack (full)
+        const tech = findSection("Tech stack") || findSection("Tech Stack");
+        if (tech) {
+            result.push(`## ${tech.heading}\n\n${tech.content}`);
+        }
+        // 3. Repo Structure (collapsed to top level)
+        const structure = findSection("File structure") || findSection("Repo Structure") || findSection("File Structure");
+        if (structure) {
+            result.push(`## ${structure.heading}\n\n${collapseStructure(structure.content)}`);
+        }
+        // 4. Conventions (full)
+        const conventions = findSection("Conventions");
+        if (conventions) {
+            result.push(`## ${conventions.heading}\n\n${conventions.content}`);
+        }
+        // 5. What's Working
+        const working = findSection("What's working") || findSection("What's Working");
+        if (working) {
+            result.push(`## ${working.heading}\n\n${working.content}`);
+        }
+        // 6. What's Next (full)
+        const next = findSection("What's next") || findSection("What's Next");
+        if (next) {
+            result.push(`## ${next.heading}\n\n${next.content}`);
+        }
+        // 7. Recent Activity (Git) — last 5 commits only, no diff details
+        const git = findSection("Git context") || findSection("Recent Activity (Git)") || findSection("Recent Activity");
+        if (git) {
+            result.push(`## ${git.heading}\n\n${formatGitContext(git.content, 'newTask')}`);
+        }
+    }
+    else if (intent === 'debug') {
+        // 1. What We're Building (1 sentence)
+        const building = findSection("What we're building") || findSection("What We're Building");
+        if (building) {
+            result.push(`## ${building.heading}\n\n${getSentences(building.content, 1)}`);
+        }
+        // 2. Recent Activity (Git) — full uncommitted changes + last 5 commits + staged files
+        const git = findSection("Git context") || findSection("Recent Activity (Git)") || findSection("Recent Activity");
+        if (git) {
+            result.push(`## ${git.heading}\n\n${formatGitContext(git.content, 'debug')}`);
+        }
+        // 3. What's In Progress
+        const inProgress = findSection("What's in progress") || findSection("What's In Progress");
+        if (inProgress) {
+            result.push(`## ${inProgress.heading}\n\n${inProgress.content}`);
+        }
+        // 4. Tech Stack
+        const tech = findSection("Tech stack") || findSection("Tech Stack");
+        if (tech) {
+            result.push(`## ${tech.heading}\n\n${tech.content}`);
+        }
+        // 5. Current Error (multi-line input collected from user)
+        if (errorMessage) {
+            result.push(`## Current Error\n\n${errorMessage}`);
+        }
+        // 6. Repo Structure
+        const structure = findSection("File structure") || findSection("Repo Structure") || findSection("File Structure");
+        if (structure) {
+            result.push(`## ${structure.heading}\n\n${structure.content}`);
+        }
+    }
+    // Enforce token budget by dropping lowest priority sections
+    const CHARACTER_BUDGET = 1800 * 4;
+    while (result.length > 0 && result.join('\n\n').length > CHARACTER_BUDGET) {
+        result.pop();
+    }
+    return result.join('\n\n');
+}
+//# sourceMappingURL=compressor.js.map