specrails-core 5.3.0 → 5.4.0

package/dist/agent-runtime/evaluation.js

@@ -0,0 +1,171 @@
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { tmpdir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { EVALUATION_CORPUS } from './evaluation-corpus.js';
+import { fingerprint } from './durable-store.js';
+import { runCoreWorkflow, coreRuntimeIdentity } from './core-host.js';
+import { ExecutorRegistry } from './executors.js';
+import { OpenSpecTools } from './openspec.js';
+import { validatePipelineContext } from '../installer/runtime/pipeline-state.js';
+import { runtimeEfficiency } from './efficiency.js';
+function oracle(test, file) {
+    return spawnSync(process.execPath, ['-e', 'const assert = require("node:assert/strict"); const api = require(process.argv[1]);' + test.oracle, file], { encoding: 'utf8', timeout: 10000 }).status === 0;
+}
+function prepare(test, root) {
+    const repositories = test.repositories.map(id => {
+        const directory = path.join(root, id);
+        mkdirSync(directory);
+        writeFileSync(path.join(directory, 'implementation.cjs'), test.source);
+        writeFileSync(path.join(directory, 'AGENTS.md'), '# Repository guidance\n' + 'Keep public behavior stable. Follow the existing implementation.cjs convention.\n'.repeat(180));
+        execFileSync('git', ['init', '-q', directory]);
+        execFileSync('git', ['-C', directory, 'add', '.']);
+        execFileSync('git', ['-C', directory, '-c', 'user.name=Evaluation', '-c', 'user.email=evaluation@example.invalid', 'commit', '-qm', 'frozen fixture']);
+        return { id, name: id, path: directory, baseSha: execFileSync('git', ['-C', directory, 'rev-parse', 'HEAD'], { encoding: 'utf8' }).trim() };
+    });
+    return validatePipelineContext({ schemaVersion: 1, runId: randomUUID(), backlogRoot: root, artifactRoot: repositories[0].path, artifactRepositoryId: repositories[0].id, repositories, ownership: { git: 'host', backlog: 'host', worktrees: 'host' }, specs: [{ id: 1, title: test.id, description: test.description + ' Implement behavior in implementation.cjs in every selected repository.', repositoryIds: test.repositories, acceptanceCriteria: [test.description] }] });
+}
+function fixtureRegistry(test, context) {
+    let developers = 0, reviews = 0;
+    const sessions = new Map();
+    return new ExecutorRegistry().register('fixture', {
+        capabilities: () => ({ transport: 'offline-fixture', continuation: 'supported', effortSupport: 'unsupported', supportedEfforts: [], observedModel: false, observedEffort: false }),
+        async execute(request) {
+            const sessionId = 'fixture-' + request.role;
+            if (request.resumeSessionId && !sessions.has(request.resumeSessionId))
+                throw new Error('Fixture session was not restored');
+            const history = sessions.get(sessionId) ?? [];
+            history.push(request.prompt);
+            sessions.set(sessionId, history);
+            const tools = new OpenSpecTools(request.openspec);
+            await tools.execute({ action: 'load_skill' });
+            let output;
+            if (request.role === 'architect') {
+                await tools.execute({ action: 'new' });
+                const artifacts = [
+                    ['proposal', 'proposal.md', `## Why\n${test.description}\n## What Changes\n- Implement the requested behavior.\n## Capabilities\n### New Capabilities\n- \`fixture-behavior\`: ${test.description}\n### Modified Capabilities\nNone.\n## Impact\nSelected repositories.\n`],
+                    ['design', 'design.md', `## Context\n${test.description}\n## Decisions\nUse the existing implementation.cjs pattern and keep the public function boundary.`],
+                    ['specs', 'specs/fixture-behavior/spec.md', `## ADDED Requirements\n### Requirement: Requested behavior\nThe implementation SHALL satisfy the frozen behavior.\n#### Scenario: Supported input\n- **WHEN** a supported input is supplied\n- **THEN** the expected value is returned without losing required ordering or boundary behavior\n`],
+                    ['tasks', 'tasks.md', '## 1. Implementation\n- [ ] 1.1 Implement and test the requested behavior\n'],
+                ];
+                for (const [artifact, file, content] of artifacts) {
+                    await tools.execute({ action: 'instructions', artifact });
+                    await tools.execute({ action: 'write_artifact', path: file, content });
+                }
+                output = { confidence: 'high', planningDepth: context.repositories.length > 1 ? 'full' : 'focused', referencePatterns: ['implementation.cjs'], riskFlags: [], verification: [] };
+            }
+            else {
+                await tools.execute({ action: 'instructions', artifact: 'apply' });
+                if (request.role === 'developer') {
+                    developers++;
+                    for (const repo of context.repositories)
+                        writeFileSync(path.join(repo.path, 'implementation.cjs'), test.correction && developers === 1 ? test.defects[0] : test.solution);
+                    writeFileSync(path.join(context.artifactRoot, 'openspec/changes/evaluation-change/tasks.md'), '## 1. Implementation\n- [x] 1.1 Implement and test the requested behavior\n');
+                    output = { summary: 'Implemented fixture behavior', files: ['implementation.cjs'], tests: [], verification: 'Core executes the frozen checks', incomplete: [] };
+                }
+                else {
+                    reviews++;
+                    const approved = !(test.correction === 'review' && reviews === 1);
+                    output = { approved, summary: approved ? 'Behavior reviewed' : 'Stable order is missing', issues: approved ? [] : ['Preserve original order'], score: approved ? 95 : 50, aspects: Object.fromEntries(['type_correctness', 'pattern_adherence', 'test_coverage', 'security', 'architectural_alignment'].map(key => [key, approved ? 95 : 50])), acceptance: { criteria: [{ specId: '1', criterionIndex: 0, status: approved ? 'met' : 'blocked', evidence: ['implementation.cjs inspected against frozen behavior'] }], checks: [], findings: [] } };
+                }
+            }
+            return { text: JSON.stringify(output), structuredOutput: output, sessionId, usage: { inputTokens: Math.ceil(request.prompt.length / 4), outputTokens: 100, costUsd: 0 } };
+        },
+    });
+}
+export async function runEvaluation(options) {
+    const repetitions = options.repetitions ?? 1;
+    if (!Number.isSafeInteger(repetitions) || repetitions < 1 || repetitions > 20)
+        throw new Error('Evaluation repetitions must be 1–20');
+    if (options.real && (!options.config || !Number.isFinite(options.maxCostUsd) || options.maxCostUsd <= 0 || Object.values(options.config.agents).some(role => !role.model)))
+        throw new Error('Real evaluation requires explicit per-role models and a positive aggregate spend limit');
+    const identity = coreRuntimeIdentity();
+    const observations = [];
+    let spend = 0, stopReason = null;
+    const root = mkdtempSync(path.join(tmpdir(), 'specrails-evaluation-'));
+    try {
+        for (let repeat = 0; repeat < repetitions && !stopReason; repeat++)
+            for (const test of EVALUATION_CORPUS) {
+                // Check the independent oracle itself against defective candidates.
+                const probe = path.join(root, 'oracle-probe.cjs');
+                writeFileSync(probe, test.solution);
+                if (!oracle(test, probe))
+                    throw new Error('Acceptance oracle rejects reference solution: ' + test.id);
+                for (const defect of test.defects) {
+                    writeFileSync(probe, defect);
+                    if (oracle(test, probe))
+                        throw new Error('Acceptance oracle admits defective variant: ' + test.id);
+                }
+                const order = options.real && Math.random() < 0.5 ? ['optimized', 'full'] : ['full', 'optimized'];
+                for (const mode of order) {
+                    if (stopReason)
+                        break;
+                    const workspace = path.join(root, `${test.id}-${repeat}-${mode}`);
+                    mkdirSync(workspace);
+                    const context = prepare(test, workspace);
+                    const base = options.config ?? { schemaVersion: 1, enabled: true, providers: [], agents: { architect: { provider: 'fixture', model: 'fixture' }, developer: { provider: 'fixture', model: 'fixture' }, reviewer: { provider: 'fixture', model: 'fixture' } }, verification: [] };
+                    const config = { ...structuredClone(base), approvalBeforeArchive: false, efficiency: { schemaVersion: 1, contextMode: mode === 'full' ? 'full' : 'incremental', reviewMode: mode === 'full' ? 'full' : 'incremental', planning: mode === 'full' ? 'full' : 'proportional', verification: { maxConcurrency: 1 } }, limits: { ...base.limits, maxAttempts: 3, timeoutMs: 300000, ...(options.real ? { maxCostUsd: options.maxCostUsd - spend } : {}) }, verification: context.repositories.map(repo => ({ repositoryId: repo.id, command: process.execPath, args: ['-e', 'const assert = require("node:assert/strict"); const api = require("./implementation.cjs");' + (test.verification ?? '')] })) };
+                    if (options.real && config.limits.maxCostUsd <= 0) {
+                        stopReason = 'Aggregate spend limit reached';
+                        break;
+                    }
+                    const started = Date.now();
+                    let state;
+                    try {
+                        state = await runCoreWorkflow({ context, change: 'evaluation-change', config, ...(options.real ? {} : { registry: fixtureRegistry(test, context) }) });
+                    }
+                    catch (error) {
+                        observations.push({ caseId: test.id, repeat, mode, status: 'blocked', independentAccepted: false, error: error instanceof Error ? error.message : String(error), runtimeIdentity: identity, taskHash: fingerprint(test), oracleHash: fingerprint(test.oracle), repositories: context.repositories.map(({ id, baseSha }) => ({ id, baseSha })), configHash: fingerprint(config) });
+                        stopReason = 'Runtime preflight failed; experiment stopped without retry';
+                        break;
+                    }
+                    const accepted = context.repositories.every(repo => oracle(test, path.join(repo.path, 'implementation.cjs')));
+                    const metrics = runtimeEfficiency(state);
+                    const calls = state.history.flatMap(attempt => attempt.invocations ?? []);
+                    observations.push({ caseId: test.id, repeat, mode, order, taskHash: fingerprint(test), oracleHash: fingerprint(test.oracle), repositories: context.repositories.map(({ id, baseSha }) => ({ id, baseSha })), configHash: fingerprint(config), runtimeIdentity: identity, cacheState: 'uncontrolled-provider-cache; fresh workspace and role sessions', status: state.status, independentAccepted: accepted && state.status === 'succeeded', activeDurationMs: Date.now() - started, metrics, invocations: calls.map(call => ({ kind: call.kind, promptBytes: call.promptBytes, provider: call.provider, model: call.model, status: call.status })), failures: state.history.filter(attempt => attempt.status !== 'succeeded' || attempt.output?.valid === false || attempt.output?.approved === false).map(attempt => ({ role: attempt.stepId, status: attempt.status, error: attempt.error ?? null })) });
+                    if (options.real) {
+                        if (metrics.total.costUsd === null)
+                            stopReason = 'Billing incomplete; monetary comparison is inconclusive and further spend is stopped';
+                        else
+                            spend += metrics.total.costUsd;
+                    }
+                }
+                if (stopReason)
+                    break;
+            }
+        const median = (values) => { const sorted = [...values].sort((a, b) => a - b); return sorted.length ? (sorted[Math.floor((sorted.length - 1) / 2)] + sorted[Math.floor(sorted.length / 2)]) / 2 : null; };
+        const groups = Object.fromEntries(['full', 'optimized'].map(mode => {
+            const rows = observations.filter(row => row.mode === mode);
+            const accepted = rows.filter(row => row.independentAccepted).length;
+            const costs = rows.map(row => row.metrics?.total.costUsd);
+            const knownCost = costs.every(value => typeof value === 'number') ? costs.reduce((sum, value) => sum + value, 0) : null;
+            const durations = rows.flatMap(row => typeof row.activeDurationMs === 'number' ? [row.activeDurationMs] : []);
+            const average = durations.length ? durations.reduce((sum, value) => sum + value, 0) / durations.length : null;
+            return [mode, { samples: rows.length, independentlyAccepted: accepted, costPerAcceptedUsd: options.real && knownCost !== null && accepted ? knownCost / accepted : null, medianActiveDurationMs: median(durations), minActiveDurationMs: durations.length ? Math.min(...durations) : null, maxActiveDurationMs: durations.length ? Math.max(...durations) : null, standardDeviationMs: average === null ? null : Math.sqrt(durations.reduce((sum, value) => sum + (value - average) ** 2, 0) / durations.length) }];
+        }));
+        const full = groups.full, optimized = groups.optimized;
+        const paired = observations.length === EVALUATION_CORPUS.length * repetitions * 2 && full.samples === optimized.samples;
+        const noObservedQualityDrop = paired && optimized.independentlyAccepted >= full.independentlyAccepted;
+        const promptPairs = observations.filter(row => row.mode === 'full' && row.caseId === 'verification-correction').map(row => {
+            const other = observations.find(item => item.mode === 'optimized' && item.caseId === row.caseId && item.repeat === row.repeat);
+            const correction = (value) => value?.invocations?.find(call => call.kind === 'correction')?.promptBytes;
+            const before = correction(row), after = correction(other);
+            return { caseId: row.caseId, repeat: row.repeat, fullBytes: before ?? null, optimizedBytes: after ?? null, reduction: before && after !== undefined ? 1 - after / before : null };
+        });
+        const noExtraInvocations = paired && observations.filter(row => row.mode === 'full').every(row => {
+            const other = observations.find(item => item.mode === 'optimized' && item.caseId === row.caseId && item.repeat === row.repeat);
+            return Array.isArray(row.invocations) && Array.isArray(other?.invocations) && other.invocations.length <= row.invocations.length;
+        });
+        const monetaryConclusion = options.real && paired && full.costPerAcceptedUsd !== null && optimized.costPerAcceptedUsd !== null && full.costPerAcceptedUsd > 0 ? optimized.costPerAcceptedUsd <= full.costPerAcceptedUsd * 0.8 && noObservedQualityDrop ? 'target-met-in-this-sample' : 'target-not-met-in-this-sample' : 'inconclusive';
+        const report = { schemaVersion: 1, experiment: Object.values(options.config?.agents ?? {}).some(role => role.escalation) ? 'routing' : 'same-model', noExtraInvocations, mode: options.real ? 'real' : 'offline', runtimeIdentity: identity, corpusHash: fingerprint(EVALUATION_CORPUS), measurement: options.real ? 'reported-provider-usage' : 'synthetic-fixture-usage; no actual AI savings measured', monetaryTarget: 0.2, monetaryConclusion, groups, noObservedQualityDrop, promptPairs, correctionPromptTargetMet: promptPairs.length > 0 && promptPairs.every(pair => pair.reduction !== null && pair.reduction >= 0.4), sampleLimitations: 'Small descriptive paired sample; does not establish a universal quality or savings guarantee.', stopReason, reportedSpendUsd: options.real ? spend : 0, observations };
+        mkdirSync(options.output, { recursive: true });
+        writeFileSync(path.join(options.output, 'evaluation.json'), JSON.stringify(report, null, 2) + '\n');
+        writeFileSync(path.join(options.output, 'evaluation.md'), `# Implementation efficiency evaluation\n\nMode: ${report.mode}. ${report.measurement}.\n\nMonetary target: 20% lower aggregate cost per independently accepted output. Conclusion: ${monetaryConclusion}.\n\n${JSON.stringify(groups, null, 2)}\n\nCorrection prompt comparison: ${JSON.stringify(promptPairs)}\n\n${observations.map(row => `- ${row.caseId}, ${row.mode}: ${row.status}; independent acceptance ${row.independentAccepted}; ${row.activeDurationMs} ms`).join('\n')}\n\n${stopReason ?? (options.real ? report.sampleLimitations : 'No paid benchmark has established monetary savings.')}\n`);
+        return report;
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=evaluation.js.map

package/dist/agent-runtime/evaluation.js.map

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

package/dist/agent-runtime/executor-types.d.ts

@@ -1,4 +1,5 @@
 import type { VerificationCommand } from '../installer/runtime/pipeline-state.js';
+import type { CacheTokenUsage } from './efficiency-types.js';
 export type AgentRole = 'architect' | 'developer' | 'reviewer';
 export type CliProvider = 'claude' | 'codex' | 'gemini' | 'kimi';
 export type RuntimeProviderConfig = {
@@ -15,10 +16,35 @@ export interface RuntimeAgentConfig {
     provider: string;
     model?: string;
     maxTurns?: number;
+    effort?: string;
+    escalation?: {
+        model: string;
+        effort?: string;
+    };
+}
+export interface EfficiencyPolicy {
+    schemaVersion: 1;
+    contextMode?: 'full' | 'incremental';
+    reviewMode?: 'full' | 'incremental';
+    planning?: 'full' | 'proportional';
+    acceptDeveloperChecks?: boolean;
+    verification?: {
+        maxConcurrency?: number;
+    };
+}
+export interface ExecutorCapabilities {
+    transport: string;
+    continuation: 'supported' | 'unsupported' | 'unknown';
+    effortSupport: 'supported' | 'unsupported' | 'unknown';
+    supportedEfforts: string[] | null;
+    observedModel: boolean;
+    observedEffort: boolean;
 }
 export type ReviewAspectName = 'type_correctness' | 'pattern_adherence' | 'test_coverage' | 'security' | 'architectural_alignment';
 export interface RuntimeConfig {
     schemaVersion: 1;
+    rolePrompts?: Partial<Record<AgentRole, string>>;
+    efficiency?: EfficiencyPolicy;
     enabled: boolean;
     providers: RuntimeProviderConfig[];
     agents: Record<AgentRole, RuntimeAgentConfig>;
@@ -41,7 +67,7 @@ export interface RuntimeConfig {
     };
 }
 /** Null means unavailable, including when a CLI never reports billing. */
-export interface AgentUsage {
+export interface AgentUsage extends CacheTokenUsage {
     inputTokens: number | null;
     outputTokens: number | null;
     costUsd: number | null;
@@ -52,19 +78,24 @@ export interface AgentEvent {
     tool?: string;
     /** Short human-readable tool target, such as a file path or command. Never a complete transcript. */
     detail?: string;
+    /** Untruncated tool paths for repository attribution; never file contents. */
+    targetPaths?: string[];
+    cwd?: string;
     usage?: AgentUsage;
 }
 export interface AgentRequest {
+    openspec?: import('./openspec.js').OpenSpecRoleContext;
     role: AgentRole;
     prompt: string;
     cwd: string;
     allowedRoots: string[];
     model?: string;
+    effort?: string;
     maxTurns?: number;
     timeoutMs?: number;
     maxTokens?: number;
     maxCostUsd?: number;
-    /** Continue an earlier provider session when the executor supports it. Executors without sessions ignore it. */
+    /** Only send a partial follow-up when capabilities guarantee restored history before inference. */
     resumeSessionId?: string;
     /** JSON Schema for the final structured reply. Executors with native structured output enforce it; the prompt remains authoritative elsewhere. */
     outputSchema?: Record<string, unknown>;
@@ -79,7 +110,9 @@ export interface AgentResult {
 }
 export type AgentLimits = Pick<AgentRequest, 'maxTokens' | 'maxCostUsd'>;
 export interface AgentExecutor {
+    capabilities?(model?: string): ExecutorCapabilities | Promise<ExecutorCapabilities>;
     /** Side-effect-free preflight. Custom executors own their limit capabilities. */
+    validateOpenSpec?(context: import('./openspec.js').OpenSpecRoleContext): Promise<void>;
     validateLimits?(limits: AgentLimits): void;
     execute(request: AgentRequest): Promise<AgentResult>;
 }

package/dist/agent-runtime/executor-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor-types.js","sourceRoot":"","sources":["../../src/agent-runtime/executor-types.ts"],"names":[],"mappings":"AA8DA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACC;IAA8B;IAA3E,YAAY,OAAe,EAAkB,IAAY,EAAkB,QAAoB,YAAY,EAAE;QAC3G,KAAK,CAAC,OAAO,CAAC,CAAA;QAD6B,SAAI,GAAJ,IAAI,CAAQ;QAAkB,UAAK,GAAL,KAAK,CAA6B;QAE3G,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AACD,MAAM,UAAU,YAAY,KAAiB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA,CAAC,CAAC;AAC9G,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;IAC7O,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAA;IACvQ,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAU,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,WAAW,GAAG,EAAE,EAAE,eAAe,CAAC,CAAA;IAChM,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAA;IAClP,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAA;IAC/N,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAA;AAC1F,CAAC"}
+{"version":3,"file":"executor-types.js","sourceRoot":"","sources":["../../src/agent-runtime/executor-types.ts"],"names":[],"mappings":"AA8FA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACC;IAA8B;IAA3E,YAAY,OAAe,EAAkB,IAAY,EAAkB,QAAoB,YAAY,EAAE;QAC3G,KAAK,CAAC,OAAO,CAAC,CAAA;QAD6B,SAAI,GAAJ,IAAI,CAAQ;QAAkB,UAAK,GAAL,KAAK,CAA6B;QAE3G,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AACD,MAAM,UAAU,YAAY,KAAiB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA,CAAC,CAAC;AAC9G,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;IAC7O,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAA;IACvQ,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAU,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,WAAW,GAAG,EAAE,EAAE,eAAe,CAAC,CAAA;IAChM,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAA;IAClP,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAA;IAC/N,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAA;AAC1F,CAAC"}

package/dist/agent-runtime/executors.d.ts

@@ -10,6 +10,7 @@ export declare class ExecutorRegistry {
     register(id: string, executor: AgentExecutor): this;
     get(id: string): AgentExecutor;
     ids(): string[];
+    capabilities(id: string, model?: string): Promise<import("./executor-types.js").ExecutorCapabilities>;
     validateLimits(id: string, limits: AgentLimits): void;
     execute(id: string, request: AgentRequest): Promise<AgentResult>;
 }

package/dist/agent-runtime/executors.js

@@ -2,6 +2,7 @@ import { AgentExecutionError, validateAgentRequest } from './executor-types.js';
 import { validateRuntimeConfig } from './config.js';
 import { CliExecutor } from './cli-executor.js';
 import { OpenAICompatibleExecutor } from './openai-executor.js';
+import { assertEffortSupported, unknownCapabilities } from './capabilities.js';
 export { CliExecutor, buildCliInvocation, parseCliOutput } from './cli-executor.js';
 export { OpenAICompatibleExecutor } from './openai-executor.js';
 export { AgentExecutionError } from './executor-types.js';
@@ -20,9 +21,12 @@ export class ExecutorRegistry {
         return executor;
     }
     ids() { return [...this.executors.keys()]; }
+    async capabilities(id, model) { return await this.get(id).capabilities?.(model) ?? unknownCapabilities('registered:' + id); }
     validateLimits(id, limits) { this.get(id).validateLimits?.(limits); }
     async execute(id, request) {
         validateAgentRequest(request);
+        if (request.effort !== undefined)
+            assertEffortSupported(request, await this.capabilities(id, request.model));
         const result = await this.get(id).execute(request);
         if (!result || typeof result.text !== 'string' || !result.text.trim() || !result.usage || ['inputTokens', 'outputTokens', 'costUsd'].some(key => {
             const value = result.usage[key];

package/dist/agent-runtime/executors.js.map

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

package/dist/agent-runtime/graph/artifacts.d.ts

@@ -9,32 +9,18 @@ export declare function parseAgentObject(text: string): Record<string, unknown>;
 export declare function child(root: string, relative: string): string;
 export declare function write(file: string, content: string): void;
 export declare function journal(context: PipelineContext): PipelineState;
-export interface Architecture {
-    proposal: string;
-    design: string;
-    tasks: string[];
-    specs: Array<{
-        name: string;
-        content: string;
-    }>;
+export declare function parseArchitecture(raw: Record<string, unknown>): {
     confidence: DesignConfidence;
     question?: string;
     verification: unknown;
-}
-/** Validates the architect's structured reply; throws `Invalid …` so the role gets one repair turn. */
-export declare function parseArchitecture(raw: Record<string, unknown>): Architecture;
-/**
- * Writes the reviewed architecture artifacts. A low-confidence design that the
- * project chose to proceed with is recorded as `medium` (the contract for a
- * design resting on one named assumption) with its provenance kept alongside,
- * because Core's design gate admits only high or medium confidence.
- */
-export declare function writeArchitecture(context: PipelineContext, change: string, architecture: Architecture, options?: {
+    planningDepth: 'focused' | 'full';
+    planningReason?: string;
+    referencePatterns: string[];
+    riskFlags: string[];
+};
+export declare function writeDesignConfidence(context: PipelineContext, change: string, architecture: ReturnType<typeof parseArchitecture>, options?: {
     assumed?: boolean;
 }): void;
 /** Commands the architect proposed for repositories the configuration leaves uncovered. */
 export declare function proposedVerification(context: PipelineContext, configured: VerificationCommand[], verification: unknown): VerificationCommand[];
-export declare function openTasks(context: PipelineContext, change: string): string[];
-/** Archive is deterministic and replayable only with explicit write recovery.
- * The reviewed specification documents are complete replacements, not deltas. */
-export declare function archive(context: PipelineContext, change: string): void;
+export declare function archive(context: PipelineContext, change: string, signal?: AbortSignal): Promise<void>;

package/dist/agent-runtime/graph/artifacts.js

@@ -1,5 +1,6 @@
+import { artifactPath, hash, resolveOpenSpecCli, runOpenSpec } from '../openspec.js';
 import { randomUUID } from 'node:crypto';
-import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { checkArchive, pipelineStateDirectory, transitionPipeline, validateVerificationRequest, } from '../../installer/runtime/pipeline-state.js';
 export const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
@@ -8,11 +9,6 @@ export function object(value) {
         throw new Error('Expected a structured JSON object from agent');
     return value;
 }
-function markdown(value, name) {
-    if (typeof value !== 'string' || !value.trim() || value.length > 500_000)
-        throw new Error('Invalid agent field: ' + name);
-    return value.trim() + '\n';
-}
 /** Accepts the object wherever the model put it: bare, fenced, or surrounded by commentary. */
 export function parseAgentObject(text) {
     if (text.length > 2_000_000)
@@ -65,56 +61,36 @@ export function write(file, content) {
 export function journal(context) {
     return JSON.parse(readFileSync(path.join(pipelineStateDirectory(context), 'state.json'), 'utf8'));
 }
-/** Validates the architect's structured reply; throws `Invalid …` so the role gets one repair turn. */
 export function parseArchitecture(raw) {
-    const proposal = markdown(raw.proposal, 'proposal');
-    const design = markdown(raw.design, 'design');
     if (!['high', 'medium', 'low'].includes(String(raw.confidence)))
         throw new Error('Invalid design confidence');
-    if (!Array.isArray(raw.tasks) || !raw.tasks.length || raw.tasks.length > 200)
-        throw new Error('Architecture requires 1–200 tasks');
-    const tasks = raw.tasks.map(task => {
-        const title = object(task).title;
-        if (typeof title !== 'string' || !title.trim() || /[\r\n]/.test(title) || title.length > 1000)
-            throw new Error('Invalid task title');
-        return title.trim();
-    });
-    if (!Array.isArray(raw.specs) || !raw.specs.length || raw.specs.length > 100)
-        throw new Error('Architecture requires 1–100 specifications');
-    const specs = raw.specs.map((item) => {
-        const spec = object(item);
-        if (typeof spec.name !== 'string' || !SLUG.test(spec.name) || spec.name.length > 100)
-            throw new Error('Invalid specification name');
-        return { name: spec.name, content: markdown(spec.content, 'spec.content') };
-    });
-    if (new Set(specs.map(s => s.name)).size !== specs.length)
-        throw new Error('Duplicate specification names');
-    if (raw.question !== undefined && raw.question !== null && (typeof raw.question !== 'string' || raw.question.length > 4000))
+    if (raw.question !== undefined && (typeof raw.question !== 'string' || raw.question.length > 4000))
         throw new Error('Invalid architect question');
-    const question = typeof raw.question === 'string' && raw.question.trim() ? raw.question.trim() : undefined;
-    return { proposal, design, tasks, specs, confidence: raw.confidence, ...(question ? { question } : {}), verification: raw.verification };
+    if (raw.planningDepth !== undefined && raw.planningDepth !== 'focused' && raw.planningDepth !== 'full')
+        throw new Error('Invalid planning depth');
+    if (raw.planningReason !== undefined && (typeof raw.planningReason !== 'string' || !raw.planningReason.trim() || raw.planningReason.length > 2000))
+        throw new Error('Invalid planning reason');
+    const references = (key) => {
+        const value = raw[key];
+        if (value === undefined)
+            return [];
+        if (!Array.isArray(value) || value.length > 20 || value.some(item => typeof item !== 'string' || !item.trim() || item.length > 1000))
+            throw new Error('Invalid architect ' + key);
+        return value;
+    };
+    const referencePatterns = references('referencePatterns'), riskFlags = references('riskFlags');
+    return { confidence: raw.confidence, ...(typeof raw.question === 'string' && raw.question.trim() ? { question: raw.question.trim() } : {}), verification: raw.verification,
+        planningDepth: raw.planningDepth === 'focused' && referencePatterns.length > 0 && riskFlags.length === 0 ? 'focused' : 'full',
+        ...(typeof raw.planningReason === 'string' ? { planningReason: raw.planningReason } : {}), referencePatterns, riskFlags, };
 }
-/**
- * Writes the reviewed architecture artifacts. A low-confidence design that the
- * project chose to proceed with is recorded as `medium` (the contract for a
- * design resting on one named assumption) with its provenance kept alongside,
- * because Core's design gate admits only high or medium confidence.
- */
-export function writeArchitecture(context, change, architecture, options = {}) {
-    const tasks = architecture.tasks.map((title, i) => '- [ ] ' + (i + 1) + '. ' + title).join('\n') + '\n';
-    const prefix = 'openspec/changes/' + change + '/';
+export function writeDesignConfidence(context, change, architecture, options = {}) {
+    // A question may precede change creation. Do not fabricate a change directory in that case.
+    if (!existsSync(child(context.artifactRoot, 'openspec/changes/' + change + '/.openspec.yaml')))
+        return;
     const confidence = options.assumed && architecture.confidence === 'low'
-        ? { confidence: 'medium', assumed: true, reportedConfidence: 'low', ...(architecture.question ? { question: architecture.question } : {}) }
-        : { confidence: architecture.confidence, ...(architecture.question ? { question: architecture.question } : {}) };
-    const files = [
-        ['proposal.md', architecture.proposal], ['design.md', architecture.design], ['tasks.md', tasks],
-        ['design-confidence.json', JSON.stringify(confidence, null, 2) + '\n'],
-        ...architecture.specs.map(s => ['specs/' + s.name + '/spec.md', s.content]),
-    ];
-    // Validate every destination before the first write.
-    const targets = files.map(([name, content]) => [child(context.artifactRoot, prefix + name), content]);
-    for (const [target, content] of targets)
-        write(target, content);
+        ? { confidence: 'medium', assumed: true, reportedConfidence: 'low', question: architecture.question }
+        : { confidence: architecture.confidence, question: architecture.question };
+    write(child(context.artifactRoot, 'openspec/changes/' + change + '/design-confidence.json'), JSON.stringify(confidence, null, 2) + '\n');
 }
 /** Commands the architect proposed for repositories the configuration leaves uncovered. */
 export function proposedVerification(context, configured, verification) {
@@ -133,35 +109,85 @@ export function proposedVerification(context, configured, verification) {
         validateVerificationRequest(context, { kind: 'scoped', commands: proposed });
     return proposed;
 }
-export function openTasks(context, change) {
-    const file = child(context.artifactRoot, 'openspec/changes/' + change + '/tasks.md');
-    if (!existsSync(file))
-        return [];
-    return readFileSync(file, 'utf8').split(/\r?\n/).filter(line => /^\s*-\s+\[ \]/.test(line)).map(line => line.replace(/^\s*-\s+\[ \]\s*/, '').trim()).slice(0, 50);
+/** Publish an archive prepared by the real CLI. The durable write set makes a
+ * crash between main-spec updates recoverable without applying a delta twice. */
+async function archiveWithOpenSpec(context, change, active, signal) {
+    const directory = pipelineStateDirectory(context);
+    const receipt = path.join(directory, 'openspec-archive.json');
+    const files = (root, prefix = '') => {
+        if (!existsSync(root))
+            return [];
+        return readdirSync(root, { withFileTypes: true }).flatMap(entry => {
+            const relative = prefix + entry.name;
+            if (entry.isSymbolicLink())
+                throw new Error('OpenSpec archive refuses symlink trees');
+            return entry.isDirectory() ? files(path.join(root, entry.name), relative + '/') : [relative];
+        });
+    };
+    const activeHash = hash(JSON.stringify(files(active).sort().map(file => [file, readFileSync(artifactPath(active, file), 'utf8')])));
+    let plan;
+    if (existsSync(receipt))
+        plan = JSON.parse(readFileSync(receipt, 'utf8'));
+    else {
+        const staging = mkdtempSync(path.join(directory, '.openspec-archive-'));
+        try {
+            const source = artifactPath(context.artifactRoot, 'openspec');
+            files(source); // Reject symlinks before copying or invoking the external CLI.
+            cpSync(source, path.join(staging, 'openspec'), { recursive: true });
+            await runOpenSpec(resolveOpenSpecCli(), staging, ['archive', change, '--yes'], signal);
+            const archives = readdirSync(path.join(staging, 'openspec/changes/archive')).filter(name => name.endsWith('-' + change));
+            if (archives.length !== 1)
+                throw new Error('OpenSpec archive destination is ambiguous');
+            const destination = 'openspec/changes/archive/' + archives[0];
+            if (existsSync(artifactPath(context.artifactRoot, destination)))
+                throw new Error('OpenSpec archive destination already exists');
+            const beforeRoot = path.join(source, 'specs'), afterRoot = path.join(staging, 'openspec/specs');
+            const names = new Set([...files(beforeRoot), ...files(afterRoot)]);
+            const contents = (root, name) => existsSync(path.join(root, name)) ? readFileSync(path.join(root, name), 'utf8') : null;
+            plan = { activeHash, destination, writes: [...names].map(name => ({ path: 'openspec/specs/' + name, before: contents(beforeRoot, name), after: contents(afterRoot, name) })).filter(item => item.before !== item.after) };
+            write(receipt, JSON.stringify(plan));
+        }
+        finally {
+            rmSync(staging, { recursive: true, force: true });
+        }
+    }
+    if (plan.activeHash !== activeHash)
+        throw new Error('Reviewed artifacts changed since the OpenSpec archive was prepared');
+    if (!new RegExp('^openspec/changes/archive/[0-9]{4}-[0-9]{2}-[0-9]{2}-' + change + '$').test(plan.destination))
+        throw new Error('Invalid OpenSpec archive receipt');
+    const targets = plan.writes.map(item => {
+        if (!item.path.startsWith('openspec/specs/'))
+            throw new Error('Invalid OpenSpec archive write');
+        const target = artifactPath(context.artifactRoot, item.path);
+        const current = existsSync(target) ? readFileSync(target, 'utf8') : null;
+        if (current !== item.before && current !== item.after)
+            throw new Error('Main specification changed during archive; refusing to overwrite: ' + item.path);
+        return { ...item, target };
+    });
+    // The external CLI ran asynchronously; recheck the candidate and artifacts before publishing.
+    signal?.throwIfAborted();
+    checkArchive(context);
+    // Validate every path and preimage before publishing the first output.
+    const destination = artifactPath(context.artifactRoot, plan.destination);
+    if (existsSync(destination))
+        throw new Error('Archive destination already exists');
+    for (const item of targets) {
+        if (item.after === null)
+            rmSync(item.target, { force: true });
+        else
+            write(item.target, item.after);
+    }
+    mkdirSync(path.dirname(destination), { recursive: true });
+    renameSync(active, destination);
 }
-/** Archive is deterministic and replayable only with explicit write recovery.
- * The reviewed specification documents are complete replacements, not deltas. */
-export function archive(context, change) {
+export async function archive(context, change, signal) {
     const state = journal(context);
     if (state.phases.archive.status !== 'done') {
-        const active = child(context.artifactRoot, 'openspec/changes/' + change);
+        const active = artifactPath(context.artifactRoot, 'openspec/changes/' + change);
         if (existsSync(active)) {
             checkArchive(context);
             transitionPipeline(context, 'archive', 'running');
-            const specsDir = child(context.artifactRoot, 'openspec/changes/' + change + '/specs');
-            const specs = readdirSync(specsDir, { withFileTypes: true }).filter(item => item.isDirectory());
-            const writes = specs.map(spec => {
-                if (!SLUG.test(spec.name))
-                    throw new Error('Invalid archived specification name');
-                return [child(context.artifactRoot, 'openspec/specs/' + spec.name + '/spec.md'), readFileSync(child(context.artifactRoot, 'openspec/changes/' + change + '/specs/' + spec.name + '/spec.md'), 'utf8')];
-            });
-            const destination = child(context.artifactRoot, 'openspec/changes/archive/' + state.createdAt.slice(0, 10) + '-' + change);
-            if (existsSync(destination))
-                throw new Error('Archive destination already exists');
-            for (const [file, content] of writes)
-                write(file, content);
-            mkdirSync(path.dirname(destination), { recursive: true });
-            renameSync(active, destination);
+            await archiveWithOpenSpec(context, change, active, signal);
         }
         // If the process died after rename, Core rechecks the saved archive approval.
         transitionPipeline(context, 'archive', 'done');