opencastle 0.31.7 → 0.32.0

package/dist/cli/convoy/effort-scaling.d.ts

@@ -0,0 +1,20 @@
+export interface EffortProfile {
+    complexity: number;
+    tier: 'economy' | 'standard' | 'utility' | 'premium';
+    max_agents: number;
+    timeout: string;
+    max_retries: number;
+    review: 'none' | 'auto' | 'fast' | 'panel';
+    expected_tokens: number;
+    description: string;
+}
+export declare const EFFORT_TABLE: EffortProfile[];
+/**
+ * Returns the EffortProfile for a given complexity score.
+ * - Exact match: returns that profile
+ * - Between defined values: rounds up to the next profile
+ * - Below 1: returns the complexity-1 profile
+ * - Above 13: returns the complexity-13 profile
+ */
+export declare function getEffortProfile(complexity: number): EffortProfile;
+//# sourceMappingURL=effort-scaling.d.ts.map

package/dist/cli/convoy/effort-scaling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-scaling.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/effort-scaling.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,EA6DvC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAQlE"}

package/dist/cli/convoy/effort-scaling.js

@@ -0,0 +1,82 @@
+export const EFFORT_TABLE = [
+    {
+        complexity: 1,
+        tier: 'economy',
+        max_agents: 1,
+        timeout: '5m',
+        max_retries: 1,
+        review: 'auto',
+        expected_tokens: 5_000,
+        description: 'Trivial — single file edit, copy change, config tweak',
+    },
+    {
+        complexity: 2,
+        tier: 'economy',
+        max_agents: 1,
+        timeout: '10m',
+        max_retries: 1,
+        review: 'auto',
+        expected_tokens: 15_000,
+        description: 'Simple — small bug fix, add a test, update docs',
+    },
+    {
+        complexity: 3,
+        tier: 'standard',
+        max_agents: 1,
+        timeout: '15m',
+        max_retries: 2,
+        review: 'fast',
+        expected_tokens: 30_000,
+        description: 'Moderate — new component, API endpoint, or utility',
+    },
+    {
+        complexity: 5,
+        tier: 'standard',
+        max_agents: 2,
+        timeout: '20m',
+        max_retries: 2,
+        review: 'fast',
+        expected_tokens: 60_000,
+        description: 'Significant — multi-file feature, integration work',
+    },
+    {
+        complexity: 8,
+        tier: 'standard',
+        max_agents: 3,
+        timeout: '30m',
+        max_retries: 2,
+        review: 'fast',
+        expected_tokens: 120_000,
+        description: 'Complex — cross-cutting feature, schema change + UI + tests',
+    },
+    {
+        complexity: 13,
+        tier: 'premium',
+        max_agents: 5,
+        timeout: '45m',
+        max_retries: 3,
+        review: 'panel',
+        expected_tokens: 250_000,
+        description: 'Epic — architecture change, security overhaul, major refactor',
+    },
+];
+/**
+ * Returns the EffortProfile for a given complexity score.
+ * - Exact match: returns that profile
+ * - Between defined values: rounds up to the next profile
+ * - Below 1: returns the complexity-1 profile
+ * - Above 13: returns the complexity-13 profile
+ */
+export function getEffortProfile(complexity) {
+    if (complexity <= EFFORT_TABLE[0].complexity)
+        return EFFORT_TABLE[0];
+    const last = EFFORT_TABLE[EFFORT_TABLE.length - 1];
+    if (complexity >= last.complexity)
+        return last;
+    for (const profile of EFFORT_TABLE) {
+        if (complexity <= profile.complexity)
+            return profile;
+    }
+    return last;
+}
+//# sourceMappingURL=effort-scaling.js.map

package/dist/cli/convoy/effort-scaling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-scaling.js","sourceRoot":"","sources":["../../../src/cli/convoy/effort-scaling.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C;QACE,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,uDAAuD;KACrE;IACD;QACE,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,MAAM;QACvB,WAAW,EAAE,iDAAiD;KAC/D;IACD;QACE,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,MAAM;QACvB,WAAW,EAAE,oDAAoD;KAClE;IACD;QACE,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,MAAM;QACvB,WAAW,EAAE,oDAAoD;KAClE;IACD;QACE,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,6DAA6D;KAC3E;IACD;QACE,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,OAAO;QACf,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,+DAA+D;KAC7E;CACF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,UAAU,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU;QAAE,OAAO,YAAY,CAAC,CAAC,CAAC,CAAA;IACpE,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClD,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAC9C,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,UAAU,IAAI,OAAO,CAAC,UAAU;YAAE,OAAO,OAAO,CAAA;IACtD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/cli/convoy/effort-scaling.test.d.ts

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

package/dist/cli/convoy/effort-scaling.test.d.ts.map

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

package/dist/cli/convoy/effort-scaling.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect } from 'vitest';
+import { getEffortProfile, EFFORT_TABLE } from './effort-scaling.js';
+describe('getEffortProfile', () => {
+    it('returns complexity-1 profile for score 1', () => {
+        const p = getEffortProfile(1);
+        expect(p.complexity).toBe(1);
+        expect(p.tier).toBe('economy');
+        expect(p.timeout).toBe('5m');
+        expect(p.max_retries).toBe(1);
+        expect(p.review).toBe('auto');
+        expect(p.expected_tokens).toBe(5000);
+    });
+    it('returns complexity-2 profile for score 2', () => {
+        const p = getEffortProfile(2);
+        expect(p.complexity).toBe(2);
+        expect(p.tier).toBe('economy');
+        expect(p.timeout).toBe('10m');
+        expect(p.max_retries).toBe(1);
+        expect(p.review).toBe('auto');
+        expect(p.expected_tokens).toBe(15000);
+    });
+    it('returns complexity-3 profile for score 3', () => {
+        const p = getEffortProfile(3);
+        expect(p.complexity).toBe(3);
+        expect(p.tier).toBe('standard');
+        expect(p.timeout).toBe('15m');
+        expect(p.max_retries).toBe(2);
+        expect(p.review).toBe('fast');
+        expect(p.expected_tokens).toBe(30000);
+    });
+    it('returns complexity-5 profile for score 5', () => {
+        const p = getEffortProfile(5);
+        expect(p.complexity).toBe(5);
+        expect(p.tier).toBe('standard');
+        expect(p.timeout).toBe('20m');
+        expect(p.max_retries).toBe(2);
+        expect(p.review).toBe('fast');
+        expect(p.expected_tokens).toBe(60000);
+    });
+    it('returns complexity-8 profile for score 8', () => {
+        const p = getEffortProfile(8);
+        expect(p.complexity).toBe(8);
+        expect(p.tier).toBe('standard');
+        expect(p.timeout).toBe('30m');
+        expect(p.max_retries).toBe(2);
+        expect(p.review).toBe('fast');
+        expect(p.expected_tokens).toBe(120000);
+    });
+    it('returns complexity-13 profile for score 13', () => {
+        const p = getEffortProfile(13);
+        expect(p.complexity).toBe(13);
+        expect(p.tier).toBe('premium');
+        expect(p.timeout).toBe('45m');
+        expect(p.max_retries).toBe(3);
+        expect(p.review).toBe('panel');
+        expect(p.expected_tokens).toBe(250000);
+    });
+    it('rounds up score 4 to complexity-5 profile', () => {
+        const p = getEffortProfile(4);
+        expect(p.complexity).toBe(5);
+    });
+    it('rounds up score 6 to complexity-8 profile', () => {
+        const p = getEffortProfile(6);
+        expect(p.complexity).toBe(8);
+    });
+    it('rounds up score 7 to complexity-8 profile', () => {
+        const p = getEffortProfile(7);
+        expect(p.complexity).toBe(8);
+    });
+    it('rounds up score 9 to complexity-13 profile', () => {
+        const p = getEffortProfile(9);
+        expect(p.complexity).toBe(13);
+    });
+    it('rounds up score 10 to complexity-13 profile', () => {
+        const p = getEffortProfile(10);
+        expect(p.complexity).toBe(13);
+    });
+    it('rounds up score 12 to complexity-13 profile', () => {
+        const p = getEffortProfile(12);
+        expect(p.complexity).toBe(13);
+    });
+    it('clamps score 0 to complexity-1 profile', () => {
+        const p = getEffortProfile(0);
+        expect(p.complexity).toBe(1);
+    });
+    it('clamps negative score -5 to complexity-1 profile', () => {
+        const p = getEffortProfile(-5);
+        expect(p.complexity).toBe(1);
+    });
+    it('clamps large negative score -9999 to complexity-1 profile', () => {
+        const p = getEffortProfile(-9999);
+        expect(p.complexity).toBe(1);
+    });
+    it('clamps score 14 to complexity-13 profile', () => {
+        const p = getEffortProfile(14);
+        expect(p.complexity).toBe(13);
+    });
+    it('clamps score 100 to complexity-13 profile', () => {
+        const p = getEffortProfile(100);
+        expect(p.complexity).toBe(13);
+    });
+    it('clamps very large score 9999 to complexity-13 profile', () => {
+        const p = getEffortProfile(9999);
+        expect(p.complexity).toBe(13);
+    });
+    it('returns the same object reference from EFFORT_TABLE for exact matches', () => {
+        for (const entry of EFFORT_TABLE) {
+            expect(getEffortProfile(entry.complexity)).toBe(entry);
+        }
+    });
+    it('EFFORT_TABLE has 6 entries', () => {
+        expect(EFFORT_TABLE).toHaveLength(6);
+    });
+    it('EFFORT_TABLE entries are ordered by ascending complexity', () => {
+        for (let i = 1; i < EFFORT_TABLE.length; i++) {
+            expect(EFFORT_TABLE[i].complexity).toBeGreaterThan(EFFORT_TABLE[i - 1].complexity);
+        }
+    });
+});
+//# sourceMappingURL=effort-scaling.test.js.map

package/dist/cli/convoy/effort-scaling.test.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/engine.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAQ,QAAQ,EAAE,YAAY,EAAiB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChG,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAG1F,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3E,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAElF,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAoB,WAAW,EAAE,oBAAoB,EAAwD,MAAM,YAAY,CAAA;AAuBrK,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,eAAe,CAAA;IAClC,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,4DAA4D;IAC5D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CACvG;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3F,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5F,IAAI,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;IAC5B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC/C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QACjC,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;QACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;KACvC,GAAG,UAAU,CAAA;CACf;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAe;gBAExB,MAAM,CAAC,EAAE,oBAAoB,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAY7F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAI5C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,mBAAmB,CAAA;KAAE;IA2B9E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAgBjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAmBjC,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,SAAS,IAAI,MAAM;CAGpB;AAID;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC9G;AAID,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,EAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,WAAW,GACxB,iBAAiB,CA8EnB;AAID,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAExD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,SAAS,EACf,UAAU,CAAC,EAAE,gBAAgB,EAC7B,cAAc,CAAC,EAAE,OAAO,GACvB,WAAW,CAsBb;AAk8ED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAsb7E"}

package/dist/cli/convoy/engine.js

@@ -20,6 +20,13 @@ import { readLessons, captureLessons, consolidateLessons } from './lessons.js';
 import { updateExpertise, feedCircuitBreaker } from './expertise.js';
 import { buildKnowledgeGraph } from './knowledge.js';
 import { injectDiscoveredIssuesInstruction, checkDiscoveredIssues, consolidateIssues } from './issues.js';
+import { validateOutput, buildContractInstruction, buildContractRetryPrompt } from './contracts.js';
+import { runTwoStageReview } from './review-stages.js';
+import { buildIsolationPreamble, resolveDependencyResults, detectPartitionViolations } from './isolation.js';
+import { checkTDD, formatTDDFailure, DEFAULT_TDD_CONFIG } from './tdd-gate.js';
+import { runSkillRefinementCheck } from './skill-refinement.js';
+import { getArtifactDir, extractArtifactRefs } from './artifacts.js';
+import { shouldCompact, parseCompactionSummary, saveCompaction, canCompact, getMaxCompactions, generateCompactionPrompt, buildContinuationPrompt } from './compaction.js';
 const execFile = promisify(execFileCb);
 export class CircuitBreakerManager {
     states = new Map();
@@ -620,6 +627,7 @@ function pollInjectFile(convoyId, store, events, basePath) {
             dispute_id: null,
             drift_score: null,
             drift_retried: 0,
+            compaction_count: 0,
             outputs: null,
             inputs: null,
             discovered_issues: null,
@@ -995,6 +1003,33 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
         const specTask = (spec.tasks ?? []).find(t => t.id === taskRecord.id);
         const steps = specTask?.steps;
         const taskHooks = specTask?.hooks ?? [];
+        // ── Context isolation preamble (Phase 41) ────────────────────────────
+        try {
+            const taskFiles = taskRecord.files ? JSON.parse(taskRecord.files) : [];
+            const depIds = taskRecord.depends_on ? JSON.parse(taskRecord.depends_on) : [];
+            const depResults = resolveDependencyResults(store, convoyId, depIds);
+            const preamble = buildIsolationPreamble({ id: taskRecord.id, description: taskRecord.prompt.slice(0, 200), prompt: taskRecord.prompt, files: taskFiles, agent: taskRecord.agent }, depResults);
+            task.prompt = preamble + '\n\n' + task.prompt;
+        }
+        catch { /* non-critical — isolation preamble is best-effort */ }
+        // ── Artifact output instructions (Phase 43) ────────────────────────────
+        try {
+            const artifactDir = getArtifactDir(convoyId, taskRecord.id);
+            const artifactInstructions = [
+                '',
+                '## Artifact Output (for large results)',
+                'If your output includes large content (>100 lines of code, full reports, data dumps),',
+                'write it to an artifact file instead of including it inline:',
+                '',
+                '1. Write the content to: ' + artifactDir + '{filename}',
+                '2. In your response, reference it: `[ARTIFACT: {filename}] {1-line summary}`',
+                '3. Keep your inline response focused on the summary and key decisions.',
+                '',
+                'Small outputs (< 100 lines) can remain inline.',
+            ].join('\n');
+            task.prompt = task.prompt + '\n' + artifactInstructions;
+        }
+        catch { /* non-critical */ }
         // ── Intelligence: inject lessons (Phase 18.1) ─────────────────────────
         if (spec.defaults?.inject_lessons !== false) {
             try {
@@ -1027,6 +1062,11 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
         if (spec.defaults?.track_discovered_issues) {
             task.prompt = injectDiscoveredIssuesInstruction(task.prompt);
         }
+        // ── Output contract injection ─────────────────────────────────────────
+        const contractInstruction = buildContractInstruction(taskRecord.agent);
+        if (contractInstruction) {
+            task.prompt = task.prompt + '\n\n' + contractInstruction;
+        }
         // ── pre_task hooks ────────────────────────────────────────────────────────
         if (taskHooks.length > 0) {
             const preResult = await runHooks(taskHooks, 'pre_task', {
@@ -1369,6 +1409,91 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                         return;
                     }
                 }
+                // ── Partition violation check (Phase 41) ────────────────────────────
+                if (changedFiles.length > 0) {
+                    try {
+                        const taskFiles = taskRecord.files ? JSON.parse(taskRecord.files) : [];
+                        if (taskFiles.length > 0) {
+                            const violation = detectPartitionViolations(taskRecord.id, taskFiles, changedFiles);
+                            if (violation) {
+                                events.emit('partition_violation', {
+                                    task_id: taskRecord.id,
+                                    allowed: violation.allowedFiles,
+                                    actual: violation.actualFiles,
+                                    violations: violation.violations,
+                                }, { convoy_id: convoyId, task_id: taskRecord.id });
+                                process.stdout.write(`  ${c.yellow('⚠')} ${c.bold(`[${taskRecord.id}]`)} partition violation: ${violation.violations.join(', ')}\n`);
+                            }
+                        }
+                    }
+                    catch { /* non-critical */ }
+                }
+                // ── TDD gate ──────────────────────────────────────────────────────────
+                if (builtInGates.tdd_check && changedFiles.length > 0) {
+                    const tddConfig = typeof builtInGates.tdd_check === 'object'
+                        ? { ...DEFAULT_TDD_CONFIG, ...builtInGates.tdd_check }
+                        : DEFAULT_TDD_CONFIG;
+                    const specTaskForTDD = (spec.tasks ?? []).find(t => t.id === taskRecord.id);
+                    const tddResult = checkTDD(changedFiles, changedFiles, tddConfig, specTaskForTDD?.agent ?? taskRecord.agent);
+                    if (tddResult.skipped) {
+                        events.emit('tdd_check_skipped', {
+                            task_id: taskRecord.id,
+                            reason: tddResult.skip_reason,
+                            agent: specTaskForTDD?.agent ?? taskRecord.agent,
+                        }, { convoy_id: convoyId, task_id: taskRecord.id });
+                    }
+                    else if (tddResult.passed) {
+                        events.emit('tdd_check_passed', {
+                            task_id: taskRecord.id,
+                            new_source_files: tddResult.new_source_files.length,
+                            existing_test_files: tddResult.existing_test_files.length,
+                        }, { convoy_id: convoyId, task_id: taskRecord.id });
+                    }
+                    else {
+                        const failureMsg = formatTDDFailure(tddResult);
+                        events.emit('tdd_check_failed', {
+                            task_id: taskRecord.id,
+                            missing_test_files: tddResult.missing_test_files,
+                            new_source_files: tddResult.new_source_files.length,
+                        }, { convoy_id: convoyId, task_id: taskRecord.id });
+                        if (tddConfig.mode === 'block') {
+                            await removeWorktree();
+                            const freshRecord = store.getTask(taskRecord.id, convoyId);
+                            if (freshRecord.retries < freshRecord.max_retries && spec.on_failure !== 'stop') {
+                                store.updateTaskStatus(taskRecord.id, convoyId, 'pending', {
+                                    retries: freshRecord.retries + 1,
+                                    worker_id: null,
+                                    worktree: null,
+                                    started_at: null,
+                                    finished_at: null,
+                                    prompt: `TDD gate failed.\n${failureMsg}\n\nCreate the missing test files and try again.\n\n${taskRecord.prompt}`,
+                                });
+                                store.updateWorkerStatus(workerId, 'failed', { finished_at: finishedAt });
+                                process.stdout.write(`  ${c.yellow('⟳')} ${c.bold(`[${taskRecord.id}]`)} TDD gate failed, retry ${freshRecord.retries + 1}/${freshRecord.max_retries}\n`);
+                            }
+                            else {
+                                store.withTransaction(() => {
+                                    store.updateTaskStatus(taskRecord.id, convoyId, 'gate-failed', {
+                                        finished_at: finishedAt,
+                                        output: `Built-in gate (tdd_check) failed:\n${failureMsg}`,
+                                        exit_code: 1,
+                                    });
+                                    store.updateWorkerStatus(workerId, 'failed', { finished_at: finishedAt });
+                                });
+                                completedCount++;
+                                process.stdout.write(`  ${c.red('✗')} ${c.bold(`[${taskRecord.id}]`)} TDD gate failed ${elapsed} ${c.dim(`[${completedCount}/${totalTasks}]`)}\n`);
+                                events.emit('task_failed', { reason: 'gate-failed', gate: 'tdd_check', worker_id: workerId }, { convoy_id: convoyId, task_id: taskRecord.id, worker_id: workerId });
+                                handleExhaustion(freshRecord, 'tdd-check', failureMsg);
+                            }
+                            taskAdapterMap.delete(taskRecord.id);
+                            return;
+                        }
+                        else {
+                            // warn mode — log but continue
+                            process.stdout.write(`  ${c.yellow('⚠')} ${c.bold(`[${taskRecord.id}]`)} TDD gate warning: ${tddResult.missing_test_files.length} source file(s) without tests\n`);
+                        }
+                    }
+                }
             }
             // ── Drift detection ──────────────────────────────────────────────────
             const specTaskForDrift = (spec.tasks ?? []).find(t => t.id === taskRecord.id);
@@ -1478,7 +1603,20 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                         await reviewSemaphore.acquire();
                         let reviewResult;
                         try {
-                            if (reviewRunner) {
+                            if (reviewRunner && spec.defaults?.review_stages !== false) {
+                                // Two-stage review: spec compliance first, then code quality
+                                const twoStageResult = await runTwoStageReview(taskRecord, reviewRunner, reviewerModel);
+                                for (const stage of twoStageResult.stages) {
+                                    events.emit('review_stage_completed', { stage: stage.stage, verdict: stage.verdict, tokens: stage.tokens_used, task_id: taskRecord.id, model: reviewerModel }, { convoy_id: convoyId, task_id: taskRecord.id });
+                                }
+                                reviewResult = {
+                                    verdict: twoStageResult.overall_verdict,
+                                    feedback: twoStageResult.stages.flatMap(s => s.issues).join('\n'),
+                                    tokens: twoStageResult.total_tokens,
+                                    model: reviewerModel,
+                                };
+                            }
+                            else if (reviewRunner) {
                                 reviewResult = await reviewRunner(taskRecord, 'fast', reviewerModel);
                             }
                             else {
@@ -1541,11 +1679,33 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                     try {
                         const noopRunner = (_t, _l, m) => Promise.resolve({ verdict: 'pass', feedback: '', tokens: 0, model: m });
                         const runner = reviewRunner ?? noopRunner;
-                        panelResults = await Promise.all([
-                            runner(taskRecord, 'panel', reviewerModel),
-                            runner(taskRecord, 'panel', reviewerModel),
-                            runner(taskRecord, 'panel', reviewerModel),
-                        ]);
+                        const twoStageEnabled = spec.defaults?.review_stages !== false;
+                        if (twoStageEnabled && reviewRunner) {
+                            // Each panel reviewer runs both stages; majority vote on overall_verdict
+                            const twoStageResults = await Promise.all([
+                                runTwoStageReview(taskRecord, runner, reviewerModel),
+                                runTwoStageReview(taskRecord, runner, reviewerModel),
+                                runTwoStageReview(taskRecord, runner, reviewerModel),
+                            ]);
+                            for (const tsr of twoStageResults) {
+                                for (const stage of tsr.stages) {
+                                    events.emit('review_stage_completed', { stage: stage.stage, verdict: stage.verdict, tokens: stage.tokens_used, task_id: taskRecord.id, model: reviewerModel }, { convoy_id: convoyId, task_id: taskRecord.id });
+                                }
+                            }
+                            panelResults = twoStageResults.map(tsr => ({
+                                verdict: tsr.overall_verdict,
+                                feedback: tsr.stages.flatMap(s => s.issues).join('\n'),
+                                tokens: tsr.total_tokens,
+                                model: reviewerModel,
+                            }));
+                        }
+                        else {
+                            panelResults = await Promise.all([
+                                runner(taskRecord, 'panel', reviewerModel),
+                                runner(taskRecord, 'panel', reviewerModel),
+                                runner(taskRecord, 'panel', reviewerModel),
+                            ]);
+                        }
                     }
                     finally {
                         reviewSemaphore.release();
@@ -1770,6 +1930,7 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                                 dispute_id: null,
                                 drift_score: null,
                                 drift_retried: 0,
+                                compaction_count: 0,
                                 outputs: null,
                                 inputs: null,
                                 discovered_issues: null,
@@ -1815,6 +1976,64 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                 if (result.usage.total_tokens != null)
                     usageExtra.total_tokens = result.usage.total_tokens;
             }
+            // ── Context compaction check (Phase 44) ─────────────────────────────
+            const compactionConfig = spec.defaults?.compaction;
+            if (compactionConfig?.enabled && usageExtra.total_tokens != null && taskRecord.model) {
+                if (shouldCompact(usageExtra.total_tokens, taskRecord.model, compactionConfig)) {
+                    if (canCompact(taskRecord.compaction_count)) {
+                        const newCount = taskRecord.compaction_count + 1;
+                        store.updateTaskCompaction(taskRecord.id, convoyId, newCount);
+                        const summaryFromOutput = parseCompactionSummary(result.output, taskRecord.id, convoyId);
+                        let summaryPath;
+                        if (summaryFromOutput) {
+                            try {
+                                summaryPath = saveCompaction(convoyId, taskRecord.id, summaryFromOutput, newCount);
+                            }
+                            catch { /* non-critical */ }
+                        }
+                        const compactionTaskFiles = taskRecord.files ? JSON.parse(taskRecord.files) : [];
+                        const compactionDepIds = taskRecord.depends_on ? JSON.parse(taskRecord.depends_on) : [];
+                        const compactionDepResults = resolveDependencyResults(store, convoyId, compactionDepIds);
+                        const compactionPreamble = buildIsolationPreamble({ id: taskRecord.id, description: taskRecord.prompt.slice(0, 200), prompt: taskRecord.prompt, files: compactionTaskFiles, agent: taskRecord.agent }, compactionDepResults);
+                        const continuationPrompt = summaryPath
+                            ? buildContinuationPrompt(taskRecord.prompt, summaryPath, compactionPreamble)
+                            : compactionPreamble + '\n\n' + generateCompactionPrompt(taskRecord.id) + '\n\n' + taskRecord.prompt;
+                        store.updateTaskStatus(taskRecord.id, convoyId, 'pending', {
+                            worker_id: null,
+                            worktree: null,
+                            started_at: null,
+                            finished_at: null,
+                            prompt: continuationPrompt,
+                        });
+                        store.updateWorkerStatus(workerId, 'failed', { finished_at: finishedAt });
+                        events.emit('context_compacted', {
+                            task_id: taskRecord.id,
+                            compaction_count: newCount,
+                            summary_path: summaryPath ?? '',
+                            model: taskRecord.model,
+                            tokens_used: usageExtra.total_tokens,
+                        }, { convoy_id: convoyId, task_id: taskRecord.id });
+                        taskAdapterMap.delete(taskRecord.id);
+                        return;
+                    }
+                    else {
+                        // Max compactions exceeded — fail the task
+                        const exhaustedAt = new Date().toISOString();
+                        store.updateTaskStatus(taskRecord.id, convoyId, 'failed', {
+                            finished_at: exhaustedAt,
+                            output: `Context exhausted: reached maximum ${getMaxCompactions()} compactions`,
+                            exit_code: 1,
+                        });
+                        store.updateWorkerStatus(workerId, 'failed', { finished_at: exhaustedAt });
+                        events.emit('task_failed', {
+                            reason: 'context_exhausted',
+                            worker_id: workerId,
+                        }, { convoy_id: convoyId, task_id: taskRecord.id });
+                        taskAdapterMap.delete(taskRecord.id);
+                        return;
+                    }
+                }
+            }
             // ── Capture outputs as artifacts ────────────────────────────────────────
             if (taskRecord.outputs) {
                 const outputs = JSON.parse(taskRecord.outputs);
@@ -1854,6 +2073,47 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                     }
                 }
             }
+            // ── Extract filesystem artifacts (Phase 43) ────────────────────────
+            try {
+                const fsArtifactRefs = extractArtifactRefs(taskRecord.id, convoyId, result.output);
+                if (fsArtifactRefs.length > 0) {
+                    events.emit('artifacts_extracted', {
+                        task_id: taskRecord.id,
+                        count: fsArtifactRefs.length,
+                        artifacts: fsArtifactRefs.map(r => ({ filename: r.filename, summary: r.summary })),
+                    }, { convoy_id: convoyId, task_id: taskRecord.id });
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[artifacts] Warning: extraction failed for task ${taskRecord.id}: ${err.message}\n`);
+            }
+            // ── Output contract validation ────────────────────────────────────────
+            const contractResult = validateOutput(taskRecord.agent, result.output);
+            if (!contractResult.valid) {
+                const freshRecordForContract = store.getTask(taskRecord.id, convoyId);
+                if (freshRecordForContract.retries < freshRecordForContract.max_retries) {
+                    const retryPrefix = buildContractRetryPrompt(contractResult) + '\n\n';
+                    store.updateTaskStatus(taskRecord.id, convoyId, 'pending', {
+                        retries: freshRecordForContract.retries + 1,
+                        worker_id: null,
+                        worktree: null,
+                        started_at: null,
+                        finished_at: null,
+                        prompt: retryPrefix + taskRecord.prompt,
+                    });
+                    store.updateWorkerStatus(workerId, 'failed', { finished_at: finishedAt });
+                    process.stdout.write(`  ${c.yellow('⟳')} ${c.bold(`[${taskRecord.id}]`)} contract retry ${freshRecordForContract.retries + 1}/${freshRecordForContract.max_retries}\n`);
+                    taskAdapterMap.delete(taskRecord.id);
+                    return;
+                }
+                events.emit('contract_violation', {
+                    task_id: taskRecord.id,
+                    agent: taskRecord.agent,
+                    missing: contractResult.missing,
+                    warnings: contractResult.warnings,
+                }, { convoy_id: convoyId, task_id: taskRecord.id });
+                process.stdout.write(`  ${c.yellow('⚠')} ${c.bold(`[${taskRecord.id}]`)} contract violation: missing ${contractResult.missing.join(', ')}\n`);
+            }
             // ── Intelligence: capture persistent agent identity (Phase 17.2) ─────
             const specTaskForCapture = (spec.tasks ?? []).find(t => t.id === taskRecord.id);
             if (specTaskForCapture?.persistent && result.output) {
@@ -1895,6 +2155,7 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
                     output: result.output,
                     exit_code: result.exitCode,
                     ...usageExtra,
+                    contract_result: JSON.stringify(contractResult),
                 });
                 store.updateWorkerStatus(workerId, 'done', { finished_at: finishedAt });
             });
@@ -2175,6 +2436,18 @@ async function runConvoy(convoyId, spec, adapter, store, events, wtManager, merg
         }
         catch { /* non-critical */ }
     }
+    // ── Intelligence: skill refinement check ───────────────────────────────
+    try {
+        const proposals = runSkillRefinementCheck(convoyId, basePath);
+        for (const p of proposals) {
+            events.emit('skill_refinement_proposed', {
+                skill_name: p.skill,
+                proposal_path: p.proposalPath,
+            }, { convoy_id: convoyId });
+            process.stdout.write(`  ${c.yellow('◆')} Skill refinement proposed for "${p.skill}". Review at ${p.proposalPath}\n`);
+        }
+    }
+    catch { /* non-critical */ }
     // ── Final status & summary ────────────────────────────────────────────────
     const allTasksFinal = store.getTasksByConvoy(convoyId);
     const summary = {
@@ -2590,6 +2863,7 @@ export function createConvoyEngine(options) {
                 dispute_id: null,
                 drift_score: null,
                 drift_retried: 0,
+                compaction_count: 0,
                 outputs: null,
                 inputs: null,
                 discovered_issues: null,