specrails-core 5.2.3 → 5.4.0

package/dist/agent-runtime/config.js

@@ -0,0 +1,263 @@
+import { readFileSync } from 'node:fs';
+import { DEFAULT_REVIEW_POLICY, REVIEW_ASPECTS } from './graph/review-policy.js';
+const ROLES = ['architect', 'developer', 'reviewer'];
+const ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+function fail(field, why) { throw new Error(`Invalid runtime config ${field}: ${why}`); }
+function object(value, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        fail(field, 'expected an object');
+    return value;
+}
+function keys(value, allowed, field) {
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            fail(`${field}.${key}`, 'unknown field');
+}
+function string(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value.includes('\0'))
+        fail(field, 'expected a nonempty string');
+    return value;
+}
+function identifier(value, field) {
+    const result = string(value, field);
+    if (!ID.test(result))
+        fail(field, 'expected a safe provider identifier');
+    return result;
+}
+function model(value, field) {
+    const result = string(value, field);
+    if (result.length > 256 || /[\r\n]/.test(result) || result.startsWith('-'))
+        fail(field, 'invalid model identifier');
+    return result;
+}
+function effort(value, field) {
+    const result = string(value, field);
+    if (!/^[a-z][a-z0-9_-]{0,31}$/.test(result))
+        fail(field, 'invalid effort identifier');
+    return result;
+}
+function boolean(value, field) {
+    if (typeof value !== 'boolean')
+        fail(field, 'expected boolean');
+}
+function choices(value, allowed, field) {
+    if (!allowed.includes(String(value)) || typeof value !== 'string')
+        fail(field, `expected ${allowed.join(' or ')}`);
+}
+function positive(value, field, integer = true) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0 || (integer && !Number.isSafeInteger(value)))
+        fail(field, 'expected a positive finite number' + (integer ? ' (integer)' : ''));
+    return value;
+}
+/** Review thresholds may only tighten Core's own gate; the pipeline journal enforces the floor regardless of configuration. */
+function score(value, field, floor) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > 100)
+        fail(field, 'expected a number from 0 to 100');
+    if (value < floor)
+        fail(field, `must be at least ${floor}, Core's own review gate`);
+    return value;
+}
+export function validateRuntimeConfig(input, options = {}) {
+    const config = object(input, '$');
+    keys(config, ['schemaVersion', 'enabled', 'providers', 'agents', 'limits', 'verification', 'approvalBeforeArchive', 'review', 'architect', 'rolePrompts', 'efficiency'], '$');
+    if (config.schemaVersion !== 1)
+        fail('schemaVersion', 'expected 1');
+    if (config.enabled !== undefined && typeof config.enabled !== 'boolean')
+        fail('enabled', 'expected boolean');
+    if (!Array.isArray(config.providers))
+        fail('providers', 'expected an array');
+    const providers = config.providers.map((item, i) => {
+        const field = `providers[${i}]`, provider = object(item, field);
+        const id = identifier(provider.id, `${field}.id`);
+        if (provider.kind === 'cli') {
+            keys(provider, ['id', 'kind', 'cli'], field);
+            if (!['claude', 'codex', 'gemini', 'kimi'].includes(String(provider.cli)))
+                fail(`${field}.cli`, 'unsupported CLI');
+            return { id, kind: 'cli', cli: provider.cli };
+        }
+        if (provider.kind !== 'openai-compatible')
+            fail(`${field}.kind`, 'unsupported executor kind');
+        keys(provider, ['id', 'kind', 'baseUrl', 'apiKeyEnv'], field);
+        const baseUrl = string(provider.baseUrl, `${field}.baseUrl`);
+        let url;
+        try {
+            url = new URL(baseUrl);
+        }
+        catch {
+            fail(`${field}.baseUrl`, 'expected an absolute HTTP(S) URL');
+        }
+        if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+            fail(`${field}.baseUrl`, 'use HTTP(S) without credentials, query or fragment');
+        if (provider.apiKeyEnv !== undefined && (typeof provider.apiKeyEnv !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(provider.apiKeyEnv)))
+            fail(`${field}.apiKeyEnv`, 'expected an environment variable name, never a credential value');
+        return { id, kind: 'openai-compatible', baseUrl, ...(provider.apiKeyEnv === undefined ? {} : { apiKeyEnv: provider.apiKeyEnv }) };
+    });
+    if (new Set(providers.map(p => p.id)).size !== providers.length)
+        fail('providers', 'duplicate provider id');
+    const known = new Set([...providers.map(p => p.id), ...options.registeredProviderIds ?? []]);
+    const rawAgents = object(config.agents, 'agents');
+    keys(rawAgents, ROLES, 'agents');
+    const agents = Object.fromEntries(ROLES.map(role => {
+        const field = `agents.${role}`, agent = object(rawAgents[role], field);
+        keys(agent, ['provider', 'model', 'maxTurns', 'effort', 'escalation'], field);
+        const provider = identifier(agent.provider, `${field}.provider`);
+        if (!known.has(provider))
+            fail(`${field}.provider`, `provider '${provider}' is not configured or registered`);
+        if (agent.model !== undefined) {
+            model(agent.model, `${field}.model`);
+        }
+        if (providers.find(p => p.id === provider)?.kind === 'openai-compatible' && agent.model === undefined)
+            fail(`${field}.model`, 'required for an OpenAI-compatible provider');
+        if (agent.maxTurns !== undefined)
+            positive(agent.maxTurns, `${field}.maxTurns`);
+        if (agent.effort !== undefined)
+            effort(agent.effort, `${field}.effort`);
+        if (agent.escalation !== undefined) {
+            const escalation = object(agent.escalation, `${field}.escalation`);
+            keys(escalation, ['model', 'effort'], `${field}.escalation`);
+            if (agent.model === undefined)
+                fail(`${field}.model`, 'an explicit base model is required for escalation');
+            model(escalation.model, `${field}.escalation.model`);
+            if (escalation.effort !== undefined)
+                effort(escalation.effort, `${field}.escalation.effort`);
+            if (escalation.model === agent.model && escalation.effort === agent.effort)
+                fail(`${field}.escalation`, 'must select a different model or effort');
+        }
+        return [role, structuredClone(agent)];
+    }));
+    if (config.limits !== undefined) {
+        const limits = object(config.limits, 'limits');
+        keys(limits, ['maxAttempts', 'maxTokens', 'maxCostUsd', 'timeoutMs'], 'limits');
+        for (const [key, value] of Object.entries(limits))
+            positive(value, `limits.${key}`, key !== 'maxCostUsd');
+    }
+    if (!Array.isArray(config.verification))
+        fail('verification', 'expected an array of verification commands');
+    const verification = config.verification.map((item, i) => {
+        const field = `verification[${i}]`, command = object(item, field);
+        keys(command, ['repositoryId', 'command', 'args', 'cwd', 'env', 'timeoutMs', 'key', 'label', 'policy'], field);
+        if (command.key !== undefined)
+            identifier(command.key, `${field}.key`);
+        if (command.label !== undefined && string(command.label, `${field}.label`).length > 256)
+            fail(`${field}.label`, 'maximum 256 characters');
+        if (command.policy !== undefined) {
+            const policy = object(command.policy, `${field}.policy`);
+            keys(policy, ['reuse', 'inputs', 'deterministic', 'readOnly', 'toolchainInputs', 'independentGroup', 'resources'], `${field}.policy`);
+            if (policy.reuse !== undefined)
+                choices(policy.reuse, ['never', 'snapshot-local'], `${field}.policy.reuse`);
+            for (const key of ['deterministic', 'readOnly'])
+                if (policy[key] !== undefined)
+                    boolean(policy[key], `${field}.policy.${key}`);
+            if (policy.independentGroup !== undefined)
+                identifier(policy.independentGroup, `${field}.policy.independentGroup`);
+            for (const key of ['inputs', 'toolchainInputs', 'resources']) {
+                const values = policy[key];
+                if (values === undefined)
+                    continue;
+                if (!Array.isArray(values) || values.length > 256)
+                    fail(`${field}.policy.${key}`, 'expected at most 256 entries');
+                for (const value of values)
+                    if (string(value, `${field}.policy.${key}`).length > 4096)
+                        fail(`${field}.policy.${key}`, 'entry exceeds 4096 characters');
+            }
+        }
+        identifier(command.repositoryId, `${field}.repositoryId`);
+        string(command.command, `${field}.command`);
+        if (!Array.isArray(command.args) || !command.args.every(arg => typeof arg === 'string' && !arg.includes('\0')))
+            fail(`${field}.args`, 'expected a string array');
+        if (command.cwd !== undefined)
+            string(command.cwd, `${field}.cwd`);
+        if (command.timeoutMs !== undefined)
+            positive(command.timeoutMs, `${field}.timeoutMs`);
+        if (command.env !== undefined) {
+            const env = object(command.env, `${field}.env`);
+            for (const [key, value] of Object.entries(env)) {
+                if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key) || typeof value !== 'string' || value.includes('\0'))
+                    fail(`${field}.env`, 'expected environment names and string values');
+                if (/(?:token|secret|password|api_?key|credential)/i.test(key))
+                    fail(`${field}.env.${key}`, 'credentials must be inherited from the process environment, never saved');
+            }
+        }
+        return structuredClone(command);
+    });
+    const checkKeys = verification.flatMap(check => check.key ? [check.key] : []);
+    if (new Set(checkKeys).size !== checkKeys.length)
+        fail('verification', 'duplicate check key');
+    if (config.efficiency !== undefined) {
+        const policy = object(config.efficiency, 'efficiency');
+        keys(policy, ['schemaVersion', 'contextMode', 'reviewMode', 'planning', 'acceptDeveloperChecks', 'verification'], 'efficiency');
+        if (policy.schemaVersion !== 1)
+            fail('efficiency.schemaVersion', 'expected 1');
+        for (const key of ['contextMode', 'reviewMode'])
+            if (policy[key] !== undefined)
+                choices(policy[key], ['full', 'incremental'], `efficiency.${key}`);
+        if (policy.planning !== undefined)
+            choices(policy.planning, ['full', 'proportional'], 'efficiency.planning');
+        if (policy.acceptDeveloperChecks !== undefined)
+            boolean(policy.acceptDeveloperChecks, 'efficiency.acceptDeveloperChecks');
+        if (policy.verification !== undefined) {
+            const verification = object(policy.verification, 'efficiency.verification');
+            keys(verification, ['maxConcurrency'], 'efficiency.verification');
+            if (verification.maxConcurrency !== undefined && positive(verification.maxConcurrency, 'efficiency.verification.maxConcurrency') > 4)
+                fail('efficiency.verification.maxConcurrency', 'maximum 4');
+        }
+    }
+    if (config.approvalBeforeArchive !== undefined && typeof config.approvalBeforeArchive !== 'boolean')
+        fail('approvalBeforeArchive', 'expected boolean');
+    let review;
+    if (config.review !== undefined) {
+        const raw = object(config.review, 'review');
+        keys(raw, ['minScore', 'aspects'], 'review');
+        review = {};
+        if (raw.minScore !== undefined)
+            review.minScore = score(raw.minScore, 'review.minScore', DEFAULT_REVIEW_POLICY.minScore);
+        if (raw.aspects !== undefined) {
+            const aspects = object(raw.aspects, 'review.aspects');
+            keys(aspects, [...REVIEW_ASPECTS], 'review.aspects');
+            review.aspects = Object.fromEntries(Object.entries(aspects).map(([name, value]) => [name, score(value, `review.aspects.${name}`, DEFAULT_REVIEW_POLICY.aspects[name])]));
+        }
+    }
+    let architect;
+    if (config.architect !== undefined) {
+        const raw = object(config.architect, 'architect');
+        keys(raw, ['onLowConfidence'], 'architect');
+        architect = {};
+        if (raw.onLowConfidence !== undefined) {
+            if (raw.onLowConfidence !== 'ask' && raw.onLowConfidence !== 'proceed')
+                fail('architect.onLowConfidence', 'expected "ask" or "proceed"');
+            architect.onLowConfidence = raw.onLowConfidence;
+        }
+    }
+    let rolePrompts;
+    if (config.rolePrompts !== undefined) {
+        const raw = object(config.rolePrompts, 'rolePrompts');
+        keys(raw, ROLES, 'rolePrompts');
+        rolePrompts = {};
+        for (const [role, value] of Object.entries(raw)) {
+            const text = string(value, `rolePrompts.${role}`);
+            if (text.length > 20000)
+                fail(`rolePrompts.${role}`, 'maximum 20000 characters');
+            rolePrompts[role] = text;
+        }
+    }
+    return { schemaVersion: 1, enabled: true, providers, agents, verification,
+        ...(config.efficiency === undefined ? {} : { efficiency: structuredClone(config.efficiency) }),
+        ...(rolePrompts === undefined ? {} : { rolePrompts }),
+        ...(config.limits === undefined ? {} : { limits: { ...config.limits } }),
+        ...(config.approvalBeforeArchive === undefined ? {} : { approvalBeforeArchive: config.approvalBeforeArchive }),
+        ...(review === undefined ? {} : { review }),
+        ...(architect === undefined ? {} : { architect }), };
+}
+export function loadRuntimeConfig(file, options) {
+    return validateRuntimeConfig(JSON.parse(readFileSync(file, 'utf8')), options);
+}
+/** New admissions normalize once; validation of a saved document is lossless. */
+export function normalizeRuntimeConfig(input, options) {
+    const config = JSON.parse(JSON.stringify(validateRuntimeConfig(input, options)));
+    config.efficiency = {
+        schemaVersion: 1, contextMode: 'incremental', reviewMode: 'incremental', planning: 'proportional', acceptDeveloperChecks: true,
+        ...config.efficiency, verification: { maxConcurrency: 1, ...config.efficiency?.verification },
+    };
+    return config;
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/agent-runtime/core-host.d.ts

@@ -0,0 +1,41 @@
+import { type PipelineContext } from '../installer/runtime/pipeline-state.js';
+import { type ExecutorRegistry } from './executors.js';
+import type { AgentEvent, AgentRole, RuntimeConfig } from './executor-types.js';
+import { parseAgentObject } from './graph/artifacts.js';
+import { type RuntimeIdentity } from './runtime-identity.js';
+import type { WorkflowEvent, WorkflowSpan, WorkflowState } from './workflow-types.js';
+export declare const RUNTIME_API_VERSION = 1;
+export declare const CORE_WORKFLOW_VERSION = "5";
+export declare const CORE_PACKAGE_VERSION: string;
+export declare function coreRuntimeIdentity(): RuntimeIdentity;
+export { parseAgentObject };
+export interface CoreWorkflowOptions {
+    context: PipelineContext | unknown;
+    change: string;
+    config: RuntimeConfig | unknown;
+    registry?: ExecutorRegistry;
+    signal?: AbortSignal;
+    resume?: boolean;
+    approve?: string[];
+    /** Answer to the architect's pending question; resumes the paused run. */
+    answer?: string;
+    recoverInterrupted?: string[];
+    invalidate?: string[];
+    onEvent?: (event: WorkflowEvent) => void | Promise<void>;
+    onSpan?: (span: WorkflowSpan) => void | Promise<void>;
+    onAgentEvent?: (role: AgentRole, event: AgentEvent) => void;
+    onVerificationOutput?: (text: string) => void;
+}
+/** Read-only admission: validate scope, limits and actual effort support before freezing a request. */
+export declare function preflightCoreWorkflow(options: Pick<CoreWorkflowOptions, 'context' | 'config' | 'change' | 'registry'>): Promise<{
+    context: PipelineContext;
+    config: RuntimeConfig;
+    registry: ExecutorRegistry;
+}>;
+/**
+ * Runs the Core implementation graph: architect → developer → verify → reviewer → archive,
+ * with bounded corrections routed back to the developer, an autonomous investigation pass
+ * before a low-confidence design asks the requester, real verification receipts, acceptance
+ * evidence bound to the exact candidate, and an optional approval before archive.
+ */
+export declare function runCoreWorkflow(options: CoreWorkflowOptions): Promise<WorkflowState>;

package/dist/agent-runtime/core-host.js

@@ -0,0 +1,132 @@
+import { fingerprint } from './durable-store.js';
+import { prepareOpenSpec, roleOpenSpecContext } from './openspec.js';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fingerprintCandidate, initializePipeline, inspectPipeline, pipelineStateDirectory, validatePipelineContext, validateVerificationRequest, } from '../installer/runtime/pipeline-state.js';
+import { normalizeRuntimeConfig } from './config.js';
+import { createExecutorRegistry } from './executors.js';
+import { archive, child, journal, parseAgentObject, SLUG } from './graph/artifacts.js';
+import { coreNodes } from './graph/nodes.js';
+import { resolveReviewPolicy } from './graph/review-policy.js';
+import { createRoleInvoker } from './graph/roles.js';
+import { CORE_NODE_ORDER, CoreState } from './graph/state.js';
+import { ROLE_INSTRUCTIONS_VERSION } from './prompts.js';
+import { assertEffortSupported } from './capabilities.js';
+import { runtimePackageIntegrity } from './runtime-identity.js';
+import { readWorkflowState, runWorkflow } from './workflow.js';
+export const RUNTIME_API_VERSION = 1;
+export const CORE_WORKFLOW_VERSION = '5';
+export const CORE_PACKAGE_VERSION = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version;
+export function coreRuntimeIdentity() {
+    return { packageVersion: CORE_PACKAGE_VERSION, workflowVersion: CORE_WORKFLOW_VERSION, instructionsVersion: String(ROLE_INSTRUCTIONS_VERSION), packageIntegrity: runtimePackageIntegrity(), apiVersion: 1 };
+}
+export { parseAgentObject };
+/** Read-only admission: validate scope, limits and actual effort support before freezing a request. */
+export async function preflightCoreWorkflow(options) {
+    const context = validatePipelineContext(options.context);
+    const config = normalizeRuntimeConfig(options.config, { registeredProviderIds: options.registry?.ids() });
+    if (context.ownership.git !== 'host')
+        throw new Error('Programmatic runtime requires host-owned delivery; Core shipping is not implemented by this workflow');
+    if (!SLUG.test(options.change) || options.change.length > 100)
+        throw new Error('Invalid workflow change name');
+    if (!context.specs.length)
+        throw new Error('Programmatic implementation requires a frozen spec or goal');
+    // Configured commands are validated against the frozen scope up front; coverage
+    // is completed by the architect (or left explicitly unverified) at run time.
+    if (config.verification.length)
+        validateVerificationRequest(context, { kind: 'scoped', commands: config.verification });
+    const registry = options.registry ?? createExecutorRegistry(config);
+    for (const selected of Object.values(config.agents)) {
+        registry.validateLimits(selected.provider, config.limits ?? {});
+        for (const tier of [selected, ...(selected.escalation ? [selected.escalation] : [])]) {
+            if (tier.effort !== undefined)
+                assertEffortSupported(tier, await registry.capabilities(selected.provider, tier.model));
+        }
+    }
+    return { context, config, registry };
+}
+/**
+ * Runs the Core implementation graph: architect → developer → verify → reviewer → archive,
+ * with bounded corrections routed back to the developer, an autonomous investigation pass
+ * before a low-confidence design asks the requester, real verification receipts, acceptance
+ * evidence bound to the exact candidate, and an optional approval before archive.
+ */
+export async function runCoreWorkflow(options) {
+    const { context, config, registry } = await preflightCoreWorkflow(options);
+    const directory = path.join(pipelineStateDirectory(context), 'agent-workflow');
+    const previous = await readWorkflowState(directory, context.runId);
+    if (previous && previous.workflowVersion !== CORE_WORKFLOW_VERSION)
+        throw new Error('This saved run requires its original runtime package. Restore the retained original Core runtime; its checkpoint has not been migrated.');
+    const state = initializePipeline(context, options.change);
+    if (!previous && existsSync(path.join(context.artifactRoot, 'openspec/changes', options.change))) {
+        throw new Error('Change already exists without a programmatic checkpoint; use a new change name');
+    }
+    if (state.phases.archive.status === 'done') {
+        const checked = inspectPipeline(context);
+        if (!checked.verification.valid || (checked.resumePhase && !['ship', 'ci'].includes(checked.resumePhase))) {
+            throw new Error('Archived run evidence changed; start a new run for the changed candidate or environment');
+        }
+    }
+    const prepared = prepareOpenSpec(context.artifactRoot, options.change, directory);
+    const openspec = Object.fromEntries(['architect', 'developer', 'reviewer'].map(role => {
+        const provider = config.providers.find(item => item.id === config.agents[role].provider);
+        return [role, roleOpenSpecContext(prepared, context.artifactRoot, options.change, directory, role, provider?.kind === 'cli' ? provider.cli : 'claude')];
+    }));
+    for (const role of ['architect', 'developer', 'reviewer'])
+        await registry.get(config.agents[role].provider).validateOpenSpec?.(openspec[role]);
+    const attempts = config.limits?.maxAttempts ?? 3;
+    const note = (role, text) => { try {
+        options.onAgentEvent?.(role, { kind: 'text', text });
+    }
+    catch { /* Observer cannot replay agent effects. */ } };
+    const invoke = createRoleInvoker({ context, config, registry, openspec, onAgentEvent: options.onAgentEvent });
+    let grantedArchiveScope;
+    const archiveConsent = () => {
+        const pipeline = journal(context);
+        return fingerprint({ candidate: fingerprintCandidate(pipeline), plan: pipeline.verificationPlan?.hash ?? null,
+            criteria: pipeline.acceptance?.criteria.map(({ evidence: _evidence, ...criterion }) => criterion) ?? null,
+            checks: pipeline.acceptance?.checks.map(({ evidence: _evidence, ...check }) => check) ?? null });
+    };
+    const nodes = coreNodes({ archiveApproved: () => grantedArchiveScope !== undefined && grantedArchiveScope === archiveConsent(), context, config, openspec, change: options.change, attempts, policy: resolveReviewPolicy(config), invoke, note, onVerificationOutput: options.onVerificationOutput });
+    return runWorkflow({
+        directory, runId: context.runId,
+        input: JSON.parse(JSON.stringify({ context, config, change: options.change, coreVersion: CORE_PACKAGE_VERSION, runtimeIdentity: coreRuntimeIdentity(), instructionsVersion: ROLE_INSTRUCTIONS_VERSION, openspec: prepared.identity })),
+        resume: options.resume, signal: options.signal, approve: options.approve, answer: options.answer, recoverInterrupted: options.recoverInterrupted, invalidate: options.invalidate,
+        budget: { maxCostUsd: config.limits?.maxCostUsd, maxTokens: config.limits?.maxTokens, maxDurationMs: config.limits?.timeoutMs },
+        onEvent: options.onEvent, onSpan: options.onSpan,
+        validateCompleted: async (stepId, _record, checkpoint) => {
+            // The engine invokes this only after acquiring its run lease and accepting
+            // an explicit interrupted-write recovery. A crash after the archive rename
+            // leaves Core's active artifact path temporarily absent. Reconcile that
+            // one deterministic operation before checking earlier phase fingerprints;
+            // transitionPipeline still verifies the saved exact-candidate approval.
+            if (stepId === 'architect' && checkpoint.nextStep === 'archive'
+                && checkpoint.steps.archive?.status === 'interrupted'
+                && options.recoverInterrupted?.includes('archive')
+                && journal(context).phases.archive.status === 'running'
+                && !existsSync(child(context.artifactRoot, 'openspec/changes/' + options.change))) {
+                await archive(context, options.change);
+            }
+            const inspection = inspectPipeline(context);
+            if (stepId === 'architect' && checkpoint.pendingApproval?.stepId === 'archive' && options.approve?.includes('archive') && inspection.verification.valid && inspection.acceptance.valid && inspection.phases.reviewer.status === 'done')
+                grantedArchiveScope = archiveConsent();
+            if (stepId === 'architect')
+                return inspection.phases.architect.status === 'done' && inspection.resumePhase !== 'architect';
+            if (stepId === 'verify' && checkpoint.status !== 'succeeded' && inspection.phases.archive.status !== 'done' && !(checkpoint.pendingApproval?.stepId === 'archive' && !options.approve?.includes('archive') && !checkpoint.pendingApproval.grantedAt))
+                return false;
+            if (stepId === 'verify')
+                return _record.output?.valid !== false && inspection.verification.valid;
+            if (stepId === 'reviewer')
+                return inspection.phases.reviewer.status === 'done' && inspection.verification.valid && !['architect', 'developer', 'reviewer'].includes(inspection.resumePhase ?? '');
+            if (stepId === 'archive')
+                return inspection.phases.archive.status === 'done';
+            return true;
+        },
+        workflow: {
+            id: 'specrails-implementation', version: CORE_WORKFLOW_VERSION, schema: CoreState, entry: 'architect',
+            maxTransitions: attempts * 3 + 3,
+            nodes: Object.fromEntries(CORE_NODE_ORDER.map(id => [id, nodes[id]])),
+        },
+    });
+}
+//# sourceMappingURL=core-host.js.map

package/dist/agent-runtime/core-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-host.js","sourceRoot":"","sources":["../../src/agent-runtime/core-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,2BAA2B,GAExI,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAyB,MAAM,gBAAgB,CAAA;AAE9E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAsB,MAAM,kBAAkB,CAAA;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,uBAAuB,EAAwB,MAAM,uBAAuB,CAAA;AACrF,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA;AACpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC,OAAO,CAAA;AACrJ,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,CAAC,yBAAyB,CAAC,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;AAC7M,CAAC;AACD,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAoB3B,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgF;IAC1H,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,qBAAqB,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;IACzG,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAA;IAC7J,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IAC9G,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IACxG,gFAAgF;IAChF,6EAA6E;IAC7E,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM;QAAE,2BAA2B,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;IACvH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACnE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;QAC/D,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACrF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,qBAAqB,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QACxH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA4B;IAChE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAA;IAC9E,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAClE,IAAI,QAAQ,IAAI,QAAQ,CAAC,eAAe,KAAK,qBAAqB;QAAE,MAAM,IAAI,KAAK,CAAC,yIAAyI,CAAC,CAAA;IAC9N,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACzD,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAA;IACnG,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QACxC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YAC1G,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAA;QAC5G,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACjF,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAE,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC/F,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;QACxF,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzJ,CAAC,CAAC,CAA8D,CAAA;IAChE,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAU;QAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IACvJ,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,CAAA;IAChD,MAAM,IAAI,GAAG,CAAC,IAAe,EAAE,IAAY,EAAQ,EAAE,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5K,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC7G,IAAI,mBAAuC,CAAA;IAC3C,MAAM,cAAc,GAAG,GAAW,EAAE;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;QACjC,OAAO,WAAW,CAAC,EAAE,SAAS,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,gBAAgB,EAAE,IAAI,IAAI,IAAI;YAC3G,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI;YACzG,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IACpG,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,mBAAmB,KAAK,SAAS,IAAI,mBAAmB,KAAK,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACrS,OAAO,WAAW,CAAgB;QAChC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAc;QACnP,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU;QAChL,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE;QAC/H,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;QAChD,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;YACvD,2EAA2E;YAC3E,2EAA2E;YAC3E,wEAAwE;YACxE,0EAA0E;YAC1E,wEAAwE;YACxE,IAAI,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS;mBAC1D,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa;mBAClD,OAAO,CAAC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAAC;mBAC/C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;mBACpD,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACpF,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;YACxC,CAAC;YACD,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;YAC3C,IAAI,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,eAAe,EAAE,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM;gBAAE,mBAAmB,GAAG,cAAc,EAAE,CAAA;YAC9Q,IAAI,MAAM,KAAK,WAAW;gBAAE,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,WAAW,KAAK,WAAW,CAAA;YAC1H,IAAI,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,eAAe,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC;gBAAE,OAAO,KAAK,CAAA;YAClQ,IAAI,MAAM,KAAK,QAAQ;gBAAE,OAAQ,OAAO,CAAC,MAA0C,EAAE,KAAK,KAAK,KAAK,IAAI,UAAU,CAAC,YAAY,CAAC,KAAK,CAAA;YACrI,IAAI,MAAM,KAAK,UAAU;gBAAE,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAA;YACjM,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAA;YAC5E,OAAO,IAAI,CAAA;QACb,CAAC;QACD,QAAQ,EAAE;YACR,EAAE,EAAE,0BAA0B,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW;YACrG,cAAc,EAAE,QAAQ,GAAG,CAAC,GAAG,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACtE;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/agent-runtime/durable-store.d.ts

@@ -0,0 +1,22 @@
+import type { SerializedGraphStore } from './graph-checkpointer.js';
+import type { WorkflowState } from './workflow-types.js';
+export declare class WorkflowStoreError extends Error {
+    readonly code: 'INVALID_ID' | 'LOCKED' | 'CORRUPT_STATE';
+    constructor(code: 'INVALID_ID' | 'LOCKED' | 'CORRUPT_STATE', message: string);
+}
+/** The durable run: the host ledger plus the LangGraph checkpoint history, written together. */
+export interface WorkflowEnvelope {
+    state: WorkflowState;
+    graph?: SerializedGraphStore;
+}
+export declare const ENVELOPE_FORMAT = 2;
+/** Reject non-JSON data instead of silently changing the fingerprint on serialization. */
+export declare function fingerprint(value: unknown): string;
+export declare function readWorkflowEnvelope(directory: string, runId: string): Promise<WorkflowEnvelope | null>;
+/** Read-only view of the host ledger. */
+export declare function readWorkflowState(directory: string, runId: string): Promise<WorkflowState | null>;
+/** Publish a complete checkpoint, receipt, usage, event ledger and graph history in one atomic rename. */
+export declare function writeWorkflowEnvelope(directory: string, envelope: WorkflowEnvelope): Promise<void>;
+export declare function writeWorkflowState(directory: string, state: WorkflowState, graph?: SerializedGraphStore): Promise<void>;
+/** Atomic directory leases avoid platform-specific flock and native dependencies. */
+export declare function acquireWorkflowLease(directory: string, runId: string): Promise<() => Promise<void>>;