opencastle 0.31.6 → 0.32.0

package/dist/cli/convoy/artifacts.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { getArtifactDir, writeArtifact, listArtifacts, readArtifact, extractArtifactRefs, pruneArtifacts, } from './artifacts.js';
+describe('artifacts', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'artifacts-test-'));
+        vi.spyOn(process, 'cwd').mockReturnValue(tmpDir);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    describe('writeArtifact', () => {
+        it('creates file in correct directory structure', () => {
+            const artifact = writeArtifact('convoy-1', 'task-1', 'report.md', '# Report\nContent here', 'report');
+            expect(artifact.path).toContain('convoy-1');
+            expect(artifact.path).toContain('task-1');
+            expect(artifact.path).toContain('report.md');
+            expect(existsSync(artifact.path)).toBe(true);
+        });
+        it('creates .meta.json sidecar', () => {
+            const artifact = writeArtifact('convoy-1', 'task-1', 'report.md', '# Report\nContent here', 'report');
+            const metaPath = artifact.path + '.meta.json';
+            expect(existsSync(metaPath)).toBe(true);
+        });
+        it('returns Artifact with correct metadata', () => {
+            const content = '# Report\nLine 2';
+            const artifact = writeArtifact('convoy-1', 'task-1', 'report.md', content, 'report');
+            expect(artifact.task_id).toBe('task-1');
+            expect(artifact.convoy_id).toBe('convoy-1');
+            expect(artifact.filename).toBe('report.md');
+            expect(artifact.type).toBe('report');
+            expect(artifact.size_bytes).toBe(Buffer.byteLength(content, 'utf8'));
+            expect(artifact.summary).toBe('# Report');
+        });
+        it('summary is truncated to 120 chars when first line is long', () => {
+            const longFirstLine = 'A'.repeat(200);
+            const content = longFirstLine + '\nSecond line';
+            const artifact = writeArtifact('convoy-1', 'task-1', 'long.md', content, 'report');
+            expect(artifact.summary.length).toBe(120);
+        });
+    });
+    describe('listArtifacts', () => {
+        it('returns refs for all files in task dir excluding .meta.json', () => {
+            writeArtifact('convoy-1', 'task-1', 'report.md', '# Report', 'report');
+            writeArtifact('convoy-1', 'task-1', 'migration.sql', 'ALTER TABLE users', 'code');
+            const refs = listArtifacts('convoy-1', 'task-1');
+            expect(refs).toHaveLength(2);
+            const filenames = refs.map(r => r.filename);
+            expect(filenames).toContain('report.md');
+            expect(filenames).toContain('migration.sql');
+        });
+        it('returns empty array when dir does not exist', () => {
+            const refs = listArtifacts('nonexistent-convoy', 'nonexistent-task');
+            expect(refs).toHaveLength(0);
+        });
+        it('populates summary from .meta.json sidecar', () => {
+            writeArtifact('convoy-1', 'task-1', 'diff.patch', 'diff --git a/file.ts\nchanges here', 'diff');
+            const refs = listArtifacts('convoy-1', 'task-1');
+            expect(refs[0].summary).toBe('diff --git a/file.ts');
+        });
+    });
+    describe('readArtifact', () => {
+        it('returns file content', () => {
+            const content = '# Report\nDetailed content here';
+            const artifact = writeArtifact('convoy-1', 'task-1', 'report.md', content, 'report');
+            const ref = { task_id: 'task-1', filename: 'report.md', summary: '# Report', path: artifact.path };
+            expect(readArtifact(ref)).toBe(content);
+        });
+    });
+    describe('extractArtifactRefs', () => {
+        it('parses [ARTIFACT: filename] summary pattern correctly', () => {
+            writeArtifact('convoy-1', 'task-1', 'report.md', '# Report', 'report');
+            const output = 'I completed the work.\n[ARTIFACT: report.md] Full analysis report\nSee the artifact for details.';
+            const refs = extractArtifactRefs('task-1', 'convoy-1', output);
+            expect(refs).toHaveLength(1);
+            expect(refs[0].filename).toBe('report.md');
+            expect(refs[0].summary).toBe('Full analysis report');
+        });
+        it('parses multiple artifacts in one output', () => {
+            writeArtifact('convoy-1', 'task-1', 'report.md', '# Report', 'report');
+            writeArtifact('convoy-1', 'task-1', 'migration.sql', 'ALTER TABLE', 'code');
+            const output = '[ARTIFACT: report.md] Analysis report\n[ARTIFACT: migration.sql] Database migration script';
+            const refs = extractArtifactRefs('task-1', 'convoy-1', output);
+            expect(refs).toHaveLength(2);
+        });
+        it('logs warning to stderr for referenced but missing artifacts', () => {
+            const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            const output = '[ARTIFACT: missing.md] A report that does not exist on disk';
+            const refs = extractArtifactRefs('task-1', 'convoy-1', output);
+            expect(refs).toHaveLength(0);
+            expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('[artifacts] Warning'));
+        });
+        it('returns empty array when no artifact patterns found', () => {
+            const refs = extractArtifactRefs('task-1', 'convoy-1', 'No artifacts here, just a normal response.');
+            expect(refs).toHaveLength(0);
+        });
+    });
+    describe('pruneArtifacts', () => {
+        it('removes convoy dirs beyond keepCount', () => {
+            writeArtifact('convoy-a', 'task-1', 'file.md', 'content', 'report');
+            writeArtifact('convoy-b', 'task-1', 'file.md', 'content', 'report');
+            writeArtifact('convoy-c', 'task-1', 'file.md', 'content', 'report');
+            const result = pruneArtifacts(1);
+            expect(result.removed).toBe(2);
+            expect(result.freed_bytes).toBeGreaterThan(0);
+        });
+        it('returns zero removed when within keepCount', () => {
+            writeArtifact('convoy-1', 'task-1', 'file.md', 'content', 'report');
+            writeArtifact('convoy-2', 'task-1', 'file.md', 'content', 'report');
+            const result = pruneArtifacts(5);
+            expect(result.removed).toBe(0);
+            expect(result.freed_bytes).toBe(0);
+        });
+        it('returns zero when no artifacts directory exists', () => {
+            const result = pruneArtifacts(10);
+            expect(result.removed).toBe(0);
+            expect(result.freed_bytes).toBe(0);
+        });
+        it('returns correct freed bytes count', () => {
+            const content = 'A'.repeat(1000);
+            writeArtifact('convoy-old1', 'task-1', 'large.md', content, 'report');
+            writeArtifact('convoy-old2', 'task-1', 'large.md', content, 'report');
+            writeArtifact('convoy-new', 'task-1', 'large.md', content, 'report');
+            const result = pruneArtifacts(1);
+            expect(result.removed).toBe(2);
+            expect(result.freed_bytes).toBeGreaterThan(0);
+        });
+    });
+    describe('round-trip', () => {
+        it('write → list → read produces identical content', () => {
+            const content = '# Report\nLine 2\nLine 3';
+            writeArtifact('convoy-1', 'task-1', 'report.md', content, 'report');
+            const refs = listArtifacts('convoy-1', 'task-1');
+            expect(refs).toHaveLength(1);
+            const retrieved = readArtifact(refs[0]);
+            expect(retrieved).toBe(content);
+        });
+    });
+    describe('path sanitization', () => {
+        it('rejects filenames with ..', () => {
+            expect(() => writeArtifact('convoy-1', 'task-1', '../evil.ts', 'content', 'code')).toThrow();
+        });
+        it('rejects filenames with /', () => {
+            expect(() => writeArtifact('convoy-1', 'task-1', 'sub/evil.ts', 'content', 'code')).toThrow();
+        });
+        it('rejects convoy IDs with path traversal', () => {
+            expect(() => writeArtifact('../evil', 'task-1', 'file.md', 'content', 'report')).toThrow();
+        });
+        it('rejects task IDs with backslash', () => {
+            expect(() => writeArtifact('convoy-1', 'task\\evil', 'file.md', 'content', 'report')).toThrow();
+        });
+    });
+    describe('getArtifactDir', () => {
+        it('returns path ending with trailing slash', () => {
+            const dir = getArtifactDir('convoy-1', 'task-1');
+            expect(dir.endsWith('/')).toBe(true);
+        });
+        it('includes convoy-id and task-id in path', () => {
+            const dir = getArtifactDir('convoy-abc', 'task-xyz');
+            expect(dir).toContain('convoy-abc');
+            expect(dir).toContain('task-xyz');
+        });
+    });
+});
+//# sourceMappingURL=artifacts.test.js.map

package/dist/cli/convoy/artifacts.test.js.map

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

package/dist/cli/convoy/compaction.d.ts

@@ -0,0 +1,23 @@
+import type { CompactionConfig } from './types.js';
+export interface CompactionSummary {
+    task_id: string;
+    convoy_id: string;
+    phase: string;
+    completed_steps: string[];
+    pending_steps: string[];
+    key_decisions: string[];
+    files_modified: string[];
+    artifact_refs: string[];
+    timestamp: string;
+}
+export declare const MODEL_CONTEXT_WINDOWS: Record<string, number>;
+export declare function shouldCompact(tokensUsed: number, model: string, config: CompactionConfig): boolean;
+export declare function generateCompactionPrompt(taskId: string): string;
+export declare function parseCompactionSummary(output: string, taskId: string, convoyId: string): CompactionSummary | null;
+export declare function getCompactionDir(convoyId: string, taskId: string): string;
+export declare function saveCompaction(convoyId: string, taskId: string, summary: CompactionSummary, compactionCount: number): string;
+export declare function loadCompaction(summaryPath: string): CompactionSummary | null;
+export declare function buildContinuationPrompt(originalPrompt: string, summaryPath: string, isolationPreamble: string): string;
+export declare function canCompact(compactionCount: number): boolean;
+export declare function getMaxCompactions(): number;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/cli/convoy/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/compaction.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAIlD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMxD,CAAA;AAOD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAIT;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkB/D;AAID,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,iBAAiB,GAAG,IAAI,CAoB1B;AAID,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,EAC1B,eAAe,EAAE,MAAM,GACtB,MAAM,CAOR;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAO5E;AAID,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,GACxB,MAAM,CA2BR;AAID,wBAAgB,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/cli/convoy/compaction.js

@@ -0,0 +1,117 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+export const MODEL_CONTEXT_WINDOWS = {
+    'claude-opus-4-6': 200_000,
+    'claude-sonnet-4-6': 200_000,
+    'gemini-3.1-pro': 2_000_000,
+    'gpt-5.3-codex': 200_000,
+    'gpt-5-mini': 128_000,
+};
+const DEFAULT_CONTEXT_WINDOW = 128_000;
+const MAX_COMPACTIONS_PER_TASK = 3;
+// --- Threshold detection ---
+export function shouldCompact(tokensUsed, model, config) {
+    if (!config.enabled)
+        return false;
+    const contextWindow = MODEL_CONTEXT_WINDOWS[model] ?? DEFAULT_CONTEXT_WINDOW;
+    return tokensUsed / contextWindow >= config.token_threshold_pct / 100;
+}
+// --- Compaction prompt ---
+export function generateCompactionPrompt(taskId) {
+    return [
+        '## Context Compaction Required',
+        'You are approaching your context limit. Before continuing, produce a COMPACTION_SUMMARY:',
+        '',
+        '<!-- COMPACTION_SUMMARY',
+        '{',
+        '  "phase": "current work phase",',
+        '  "completed_steps": ["step 1 done", "step 2 done"],',
+        '  "pending_steps": ["step 3 todo", "step 4 todo"],',
+        '  "key_decisions": ["chose approach A because..."],',
+        '  "files_modified": ["src/foo.ts", "src/bar.ts"],',
+        '  "artifact_refs": [".opencastle/artifacts/.../report.md"]',
+        '}',
+        '-->',
+        '',
+        'Be concise. Focus on WHAT was decided and WHAT remains, not HOW you got here.',
+    ].join('\n');
+}
+// --- Parse compaction summary from agent output ---
+export function parseCompactionSummary(output, taskId, convoyId) {
+    const match = output.match(/<!--\s*COMPACTION_SUMMARY\s*\n([\s\S]*?)-->/);
+    if (!match)
+        return null;
+    try {
+        const parsed = JSON.parse(match[1].trim());
+        return {
+            task_id: taskId,
+            convoy_id: convoyId,
+            phase: typeof parsed.phase === 'string' ? parsed.phase : 'unknown',
+            completed_steps: Array.isArray(parsed.completed_steps) ? parsed.completed_steps.filter((s) => typeof s === 'string') : [],
+            pending_steps: Array.isArray(parsed.pending_steps) ? parsed.pending_steps.filter((s) => typeof s === 'string') : [],
+            key_decisions: Array.isArray(parsed.key_decisions) ? parsed.key_decisions.filter((s) => typeof s === 'string') : [],
+            files_modified: Array.isArray(parsed.files_modified) ? parsed.files_modified.filter((s) => typeof s === 'string') : [],
+            artifact_refs: Array.isArray(parsed.artifact_refs) ? parsed.artifact_refs.filter((s) => typeof s === 'string') : [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// --- Save / restore ---
+export function getCompactionDir(convoyId, taskId) {
+    return join(resolve(process.cwd()), '.opencastle', 'artifacts', convoyId, taskId);
+}
+export function saveCompaction(convoyId, taskId, summary, compactionCount) {
+    const dir = getCompactionDir(convoyId, taskId);
+    mkdirSync(dir, { recursive: true });
+    const filename = `compaction-${compactionCount}.json`;
+    const filePath = join(dir, filename);
+    writeFileSync(filePath, JSON.stringify(summary, null, 2));
+    return filePath;
+}
+export function loadCompaction(summaryPath) {
+    try {
+        const content = readFileSync(summaryPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+// --- Build continuation prompt ---
+export function buildContinuationPrompt(originalPrompt, summaryPath, isolationPreamble) {
+    const summary = loadCompaction(summaryPath);
+    if (!summary) {
+        return isolationPreamble + '\n\n' + originalPrompt;
+    }
+    const summaryBlock = [
+        '## Continuation from Compacted Context',
+        'You are CONTINUING a task that was compacted. Previous progress:',
+        '',
+        '**Phase:** ' + summary.phase,
+        '**Completed steps:**',
+        ...summary.completed_steps.map(s => '- ' + s),
+        '**Pending steps:**',
+        ...summary.pending_steps.map(s => '- ' + s),
+        '**Key decisions:**',
+        ...summary.key_decisions.map(s => '- ' + s),
+        '**Files already modified:**',
+        ...summary.files_modified.map(f => '- ' + f),
+        ...(summary.artifact_refs.length > 0
+            ? ['**Artifacts:**', ...summary.artifact_refs.map(a => '- ' + a)]
+            : []),
+        '',
+        'Focus on the PENDING steps. Do NOT redo completed steps.',
+    ].join('\n');
+    return isolationPreamble + '\n\n' + summaryBlock + '\n\n' + originalPrompt;
+}
+// --- Compaction count helpers ---
+export function canCompact(compactionCount) {
+    return compactionCount < MAX_COMPACTIONS_PER_TASK;
+}
+export function getMaxCompactions() {
+    return MAX_COMPACTIONS_PER_TASK;
+}
+//# sourceMappingURL=compaction.js.map

package/dist/cli/convoy/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../../src/cli/convoy/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiBzC,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,OAAO;IAC5B,gBAAgB,EAAE,SAAS;IAC3B,eAAe,EAAE,OAAO;IACxB,YAAY,EAAE,OAAO;CACtB,CAAA;AAED,MAAM,sBAAsB,GAAG,OAAO,CAAA;AACtC,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAElC,8BAA8B;AAE9B,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,KAAa,EACb,MAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IACjC,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,sBAAsB,CAAA;IAC5E,OAAO,UAAU,GAAG,aAAa,IAAI,MAAM,CAAC,mBAAmB,GAAG,GAAG,CAAA;AACvE,CAAC;AAED,4BAA4B;AAE5B,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,OAAO;QACL,gCAAgC;QAChC,0FAA0F;QAC1F,EAAE;QACF,yBAAyB;QACzB,GAAG;QACH,kCAAkC;QAClC,sDAAsD;QACtD,oDAAoD;QACpD,qDAAqD;QACrD,mDAAmD;QACnD,4DAA4D;QAC5D,GAAG;QACH,KAAK;QACL,EAAE;QACF,+EAA+E;KAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,qDAAqD;AAErD,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,MAAc,EACd,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAA;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAEvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAA;QACrE,OAAO;YACL,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAClE,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACtI,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YAChI,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YAChI,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACnI,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YAChI,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,yBAAyB;AAEzB,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,MAAc;IAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AACnF,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,EACd,OAA0B,EAC1B,eAAuB;IAEvB,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC9C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,cAAc,eAAe,OAAO,CAAA;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACpC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IACzD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,oCAAoC;AAEpC,MAAM,UAAU,uBAAuB,CACrC,cAAsB,EACtB,WAAmB,EACnB,iBAAyB;IAEzB,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,iBAAiB,GAAG,MAAM,GAAG,cAAc,CAAA;IACpD,CAAC;IAED,MAAM,YAAY,GAAG;QACnB,wCAAwC;QACxC,kEAAkE;QAClE,EAAE;QACF,aAAa,GAAG,OAAO,CAAC,KAAK;QAC7B,sBAAsB;QACtB,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7C,oBAAoB;QACpB,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3C,oBAAoB;QACpB,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3C,6BAA6B;QAC7B,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YAClC,CAAC,CAAC,CAAC,gBAAgB,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;QACF,0DAA0D;KAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,OAAO,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,CAAA;AAC5E,CAAC;AAED,mCAAmC;AAEnC,MAAM,UAAU,UAAU,CAAC,eAAuB;IAChD,OAAO,eAAe,GAAG,wBAAwB,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,wBAAwB,CAAA;AACjC,CAAC"}

package/dist/cli/convoy/compaction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compaction.test.d.ts.map

package/dist/cli/convoy/compaction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.test.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/compaction.test.ts"],"names":[],"mappings":""}

package/dist/cli/convoy/compaction.test.js

@@ -0,0 +1,205 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { shouldCompact, generateCompactionPrompt, parseCompactionSummary, saveCompaction, loadCompaction, buildContinuationPrompt, canCompact, getMaxCompactions, getCompactionDir, MODEL_CONTEXT_WINDOWS, } from './compaction.js';
+const baseConfig = {
+    enabled: true,
+    token_threshold_pct: 70,
+    summary_max_tokens: 4096,
+};
+describe('shouldCompact', () => {
+    it('returns false when config.enabled is false', () => {
+        expect(shouldCompact(150_000, 'claude-sonnet-4-6', { ...baseConfig, enabled: false })).toBe(false);
+    });
+    it('returns false below threshold', () => {
+        // 69% of 200_000 = 138_000
+        expect(shouldCompact(138_000, 'claude-sonnet-4-6', baseConfig)).toBe(false);
+    });
+    it('returns true at exactly the threshold', () => {
+        // 70% of 200_000 = 140_000
+        expect(shouldCompact(140_000, 'claude-sonnet-4-6', baseConfig)).toBe(true);
+    });
+    it('returns true above threshold', () => {
+        expect(shouldCompact(180_000, 'claude-sonnet-4-6', baseConfig)).toBe(true);
+    });
+    it('uses DEFAULT_CONTEXT_WINDOW (128_000) for unknown model', () => {
+        // 70% of 128_000 = 89_600
+        expect(shouldCompact(90_000, 'unknown-model-xyz', baseConfig)).toBe(true);
+        expect(shouldCompact(88_000, 'unknown-model-xyz', baseConfig)).toBe(false);
+    });
+    it('uses correct window for gpt-5-mini (128_000)', () => {
+        expect(MODEL_CONTEXT_WINDOWS['gpt-5-mini']).toBe(128_000);
+        expect(shouldCompact(90_000, 'gpt-5-mini', baseConfig)).toBe(true);
+    });
+});
+describe('generateCompactionPrompt', () => {
+    it('returns a string containing COMPACTION_SUMMARY marker', () => {
+        const prompt = generateCompactionPrompt('task-42');
+        expect(prompt).toContain('COMPACTION_SUMMARY');
+        expect(prompt).toContain('Context Compaction Required');
+        expect(typeof prompt).toBe('string');
+    });
+    it('includes JSON structure placeholders', () => {
+        const prompt = generateCompactionPrompt('task-1');
+        expect(prompt).toContain('"phase"');
+        expect(prompt).toContain('"completed_steps"');
+        expect(prompt).toContain('"pending_steps"');
+    });
+});
+describe('parseCompactionSummary', () => {
+    it('parses valid summary from agent output', () => {
+        const output = [
+            'Some output text',
+            '',
+            '<!-- COMPACTION_SUMMARY',
+            '{',
+            '  "phase": "implementation",',
+            '  "completed_steps": ["created types", "wrote tests"],',
+            '  "pending_steps": ["integrate with engine"],',
+            '  "key_decisions": ["used valibot for validation"],',
+            '  "files_modified": ["src/foo.ts"],',
+            '  "artifact_refs": [".opencastle/artifacts/convoy-1/task-1/report.md"]',
+            '}',
+            '-->',
+            '',
+            'More text',
+        ].join('\n');
+        const result = parseCompactionSummary(output, 'task-1', 'convoy-1');
+        expect(result).not.toBeNull();
+        expect(result.task_id).toBe('task-1');
+        expect(result.convoy_id).toBe('convoy-1');
+        expect(result.phase).toBe('implementation');
+        expect(result.completed_steps).toEqual(['created types', 'wrote tests']);
+        expect(result.pending_steps).toEqual(['integrate with engine']);
+        expect(result.key_decisions).toEqual(['used valibot for validation']);
+        expect(result.files_modified).toEqual(['src/foo.ts']);
+        expect(result.artifact_refs).toEqual(['.opencastle/artifacts/convoy-1/task-1/report.md']);
+        expect(typeof result.timestamp).toBe('string');
+    });
+    it('returns null when no COMPACTION_SUMMARY marker found', () => {
+        const result = parseCompactionSummary('just some output without the marker', 'task-1', 'convoy-1');
+        expect(result).toBeNull();
+    });
+    it('returns null for invalid JSON inside the marker', () => {
+        const output = '<!-- COMPACTION_SUMMARY\nnot valid json\n-->';
+        const result = parseCompactionSummary(output, 'task-1', 'convoy-1');
+        expect(result).toBeNull();
+    });
+    it('uses empty arrays for missing or non-array fields', () => {
+        const output = '<!-- COMPACTION_SUMMARY\n{"phase": "testing"}\n-->';
+        const result = parseCompactionSummary(output, 'task-1', 'convoy-1');
+        expect(result).not.toBeNull();
+        expect(result.completed_steps).toEqual([]);
+        expect(result.pending_steps).toEqual([]);
+        expect(result.files_modified).toEqual([]);
+    });
+});
+describe('saveCompaction / loadCompaction', () => {
+    let tmpDir;
+    afterEach(() => {
+        if (tmpDir && existsSync(tmpDir)) {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('saves and restores a compaction summary', () => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'compaction-test-'));
+        const summary = {
+            task_id: 'task-1',
+            convoy_id: 'convoy-abc',
+            phase: 'testing',
+            completed_steps: ['step A'],
+            pending_steps: ['step B'],
+            key_decisions: ['chose approach X'],
+            files_modified: ['src/foo.ts'],
+            artifact_refs: [],
+            timestamp: new Date().toISOString(),
+        };
+        const origCwd = process.cwd();
+        process.chdir(tmpDir);
+        try {
+            const savedPath = saveCompaction('convoy-abc', 'task-1', summary, 1);
+            expect(existsSync(savedPath)).toBe(true);
+            const loaded = loadCompaction(savedPath);
+            expect(loaded).not.toBeNull();
+            expect(loaded.task_id).toBe('task-1');
+            expect(loaded.phase).toBe('testing');
+            expect(loaded.completed_steps).toEqual(['step A']);
+        }
+        finally {
+            process.chdir(origCwd);
+        }
+    });
+    it('returns null for a non-existent path', () => {
+        const result = loadCompaction('/tmp/definitely-does-not-exist-abc123.json');
+        expect(result).toBeNull();
+    });
+});
+describe('buildContinuationPrompt', () => {
+    let tmpDir;
+    afterEach(() => {
+        if (tmpDir && existsSync(tmpDir)) {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('includes original prompt, summary, and isolation preamble', () => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'compaction-test-'));
+        const origCwd = process.cwd();
+        process.chdir(tmpDir);
+        try {
+            const summary = {
+                task_id: 'task-1',
+                convoy_id: 'convoy-abc',
+                phase: 'integration',
+                completed_steps: ['wrote types'],
+                pending_steps: ['update engine'],
+                key_decisions: ['decided to reuse store'],
+                files_modified: ['src/types.ts'],
+                artifact_refs: [],
+                timestamp: new Date().toISOString(),
+            };
+            const savedPath = saveCompaction('convoy-abc', 'task-1', summary, 1);
+            const result = buildContinuationPrompt('Do the remaining work', savedPath, '## Isolation preamble\n');
+            expect(result).toContain('## Isolation preamble');
+            expect(result).toContain('Do the remaining work');
+            expect(result).toContain('Continuation from Compacted Context');
+            expect(result).toContain('wrote types');
+            expect(result).toContain('update engine');
+        }
+        finally {
+            process.chdir(origCwd);
+        }
+    });
+    it('handles missing summary file gracefully', () => {
+        const result = buildContinuationPrompt('Do the work', '/tmp/missing-summary-def456.json', '## Preamble\n');
+        expect(result).toContain('Do the work');
+        expect(result).toContain('## Preamble');
+        expect(result).not.toContain('Continuation from Compacted Context');
+    });
+});
+describe('canCompact', () => {
+    it('returns true below max (3)', () => {
+        expect(canCompact(0)).toBe(true);
+        expect(canCompact(1)).toBe(true);
+        expect(canCompact(2)).toBe(true);
+    });
+    it('returns false at max (3)', () => {
+        expect(canCompact(3)).toBe(false);
+        expect(canCompact(4)).toBe(false);
+    });
+});
+describe('getMaxCompactions', () => {
+    it('returns 3', () => {
+        expect(getMaxCompactions()).toBe(3);
+    });
+});
+describe('getCompactionDir', () => {
+    it('returns path inside .opencastle/artifacts/{convoyId}/{taskId}', () => {
+        const result = getCompactionDir('convoy-abc', 'task-1');
+        expect(result).toContain('.opencastle');
+        expect(result).toContain('artifacts');
+        expect(result).toContain('convoy-abc');
+        expect(result).toContain('task-1');
+    });
+});
+//# sourceMappingURL=compaction.test.js.map

package/dist/cli/convoy/compaction.test.js.map

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

package/dist/cli/convoy/contracts.d.ts

@@ -0,0 +1,22 @@
+export interface FieldSpec {
+    type: 'string' | 'string[]' | 'number' | 'boolean' | 'object';
+    description: string;
+    validation?: 'non-empty' | 'file-paths' | 'positive-int';
+}
+export interface OutputContract {
+    agent: string;
+    required_fields: string[];
+    optional_fields: string[];
+    schema: Record<string, FieldSpec>;
+}
+export interface ContractResult {
+    valid: boolean;
+    missing: string[];
+    warnings: string[];
+    data?: Record<string, unknown>;
+}
+export declare const AGENT_CONTRACTS: Record<string, OutputContract>;
+export declare function validateOutput(agent: string, output: string): ContractResult;
+export declare function buildContractInstruction(agent: string): string | null;
+export declare function buildContractRetryPrompt(result: ContractResult): string;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/cli/convoy/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;IAC7D,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,cAAc,CAAA;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAuK1D,CAAA;AAuBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAgC5E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBrE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CASvE"}