@allocator-one/rcl 4.4.19

package/dist/converge/legacy-roster.js

@@ -0,0 +1,268 @@
+import { isDeepStrictEqual } from 'node:util';
+import { LEGACY_BUILTIN_ROLES_4_1_10 } from '../roles/legacy-4.1.10.js';
+import { LEGACY_BUILTIN_ROLES_4_4_9 } from '../roles/legacy-4.4.9.js';
+const CATALOGS = {
+    '4.1.10': {
+        roles: [
+            'general', 'security-auditor', 'performance-engineer', 'api-design',
+            'test-coverage', 'dx-critic', 'architecture', 'bug-hunter',
+            'accessibility-auditor', 'project-rules', 'spec-compliance',
+            'regression-hunter', 'dead-code', 'dependency-hygiene', 'edge-case-hunter',
+        ],
+        defaultVerifier: 'google/gemini-3.8-flash',
+    },
+    '4.1.11': {
+        roles: [
+            'general', 'security-auditor', 'performance-engineer', 'api-design',
+            'test-coverage', 'dx-critic', 'architecture', 'bug-hunter',
+            'accessibility-auditor', 'project-rules', 'spec-compliance',
+            'regression-hunter', 'dead-code', 'dependency-hygiene', 'edge-case-hunter',
+        ],
+        defaultVerifier: 'google/gemini-3.8-flash',
+    },
+    '4.1.12': {
+        roles: [
+            'general', 'security-auditor', 'performance-engineer', 'api-design',
+            'test-coverage', 'dx-critic', 'architecture', 'bug-hunter',
+            'accessibility-auditor', 'spec-compliance', 'regression-hunter',
+            'dependency-hygiene', 'edge-case-hunter',
+        ],
+        defaultVerifier: 'openai/gpt-6-astra',
+        verificationReasoningEffort: 'high',
+    },
+};
+function legacyRoleCatalog(catalog) {
+    const available = new Map(LEGACY_BUILTIN_ROLES_4_1_10.map(role => [role.name, role]));
+    const roles = new Map();
+    for (const name of catalog.roles) {
+        const role = available.get(name);
+        if (!role)
+            return new Map();
+        roles.set(name, role);
+    }
+    return roles;
+}
+/** Rebuild the flawed 4.4.9 dispatch plan whose digest is stored on the pending claim. */
+export function legacyPendingClaimRoles(config, specContent) {
+    if ((config.customRoles?.length ?? 0) > 0 || (config.reviewers?.length ?? 0) > 0)
+        return undefined;
+    const available = new Map(LEGACY_BUILTIN_ROLES_4_4_9.map(role => [role.name, role]));
+    const requested = config.roles;
+    let roles;
+    if (requested?.length) {
+        const all = requested.some(name => name.toLowerCase() === 'all');
+        if (all && requested.length !== 1)
+            return undefined;
+        roles = all ? [...available.values()] : requested.flatMap(name => {
+            const role = available.get(name) ?? available.get(name.toLowerCase());
+            return role ? [role] : [];
+        });
+        if ((!all && roles.length !== requested.length) || roles.length === 0)
+            return undefined;
+    }
+    else {
+        roles = [...available.values()];
+    }
+    if (!specContent)
+        roles = roles.filter(role => role.name !== 'spec-compliance');
+    return roles.map(role => role.name === 'spec-compliance' && specContent
+        ? { ...role, systemPrompt: `${role.systemPrompt}\n\n## Specification Content\n\n${specContent}` }
+        : role);
+}
+/** Rebuild dispatch-bearing role prompts and verifier settings from a supported producer. */
+export function historicalExecutionPlan(run, config, projectRulesContent, specContent) {
+    if (!Object.hasOwn(CATALOGS, run.rcl_version))
+        return undefined;
+    const catalog = CATALOGS[run.rcl_version];
+    if (!catalog || (config.customRoles?.length ?? 0) > 0 || (config.reviewers?.length ?? 0) > 0 ||
+        !authenticHistoricalRoster(run, config))
+        return undefined;
+    const authenticatedRoleNames = new Set(run.roster.map(seat => seat.role));
+    if (authenticatedRoleNames.has('project-rules') && projectRulesContent === undefined)
+        return undefined;
+    if (authenticatedRoleNames.has('spec-compliance') && specContent === undefined)
+        return undefined;
+    const definitions = legacyRoleCatalog(catalog);
+    if (definitions.size !== catalog.roles.length)
+        return undefined;
+    const selected = resolveRequestedRoles(config, catalog, run.spec !== undefined, projectRulesContent !== undefined);
+    if (!selected)
+        return undefined;
+    const roles = selected.flatMap(identity => {
+        const base = definitions.get(identity.name);
+        if (!base)
+            return [];
+        if (base.name === 'project-rules' && projectRulesContent !== undefined) {
+            return [{ ...base, systemPrompt: `${base.systemPrompt}\n\n## Project Rules File Content\n\n${projectRulesContent}` }];
+        }
+        if (base.name === 'spec-compliance' && specContent !== undefined) {
+            return [{ ...base, systemPrompt: `${base.systemPrompt}\n\n## Specification Content\n\n${specContent}` }];
+        }
+        return [base];
+    });
+    if (roles.length !== selected.length)
+        return undefined;
+    const gating = run.gating;
+    return {
+        roles,
+        gating: {
+            mode: gating.mode,
+            minModels: gating.min_models,
+            verificationModel: gating.verification_model,
+            ...(gating.verification_reasoning_effort
+                ? { verificationReasoningEffort: gating.verification_reasoning_effort } : {}),
+            verificationTimeoutMs: gating.verification_timeout_ms,
+            verificationPassTimeoutMs: gating.verification_pass_timeout_ms ?? gating.verification_timeout_ms,
+        },
+        embedsProjectRules: roles.some(role => role.name === 'project-rules'),
+    };
+}
+function historicalProvider(model) {
+    if (model.startsWith('anthropic/'))
+        return 'anthropic';
+    if (model.startsWith('openai/'))
+        return 'openai';
+    if (model.startsWith('google/'))
+        return 'google';
+    if (model.startsWith('openrouter/'))
+        return 'openrouter';
+    if (model.startsWith('openai-compat/'))
+        return 'openai-compat';
+    if (model.startsWith('claude'))
+        return 'anthropic';
+    if (/^(?:gpt|o1|o3|o4)/.test(model))
+        return 'openai';
+    if (model.startsWith('gemini'))
+        return 'google';
+    return 'openai-compat';
+}
+function roleDefinitions(config, catalog) {
+    const roles = new Map(catalog.roles.map(name => [name, { name, specialized: name !== 'general' }]));
+    for (const custom of config.customRoles ?? []) {
+        const builtin = roles.get(custom.name) ?? roles.get(custom.name.toLowerCase());
+        const role = builtin ?? { name: custom.name, specialized: true };
+        roles.set(role.name, role);
+    }
+    return roles;
+}
+function resolveRequestedRoles(config, catalog, hasSpec, projectRulesPresent) {
+    const definitions = roleDefinitions(config, catalog);
+    const requested = config.roles;
+    if (requested && requested.length > 0) {
+        const all = requested.some(name => name.toLowerCase() === 'all');
+        if (all && requested.length !== 1)
+            return undefined;
+        if (all) {
+            return [...definitions.values()].filter(role => (role.name !== 'project-rules' || projectRulesPresent) &&
+                (role.name !== 'spec-compliance' || hasSpec));
+        }
+        const resolved = [];
+        for (const name of requested) {
+            const role = definitions.get(name) ?? definitions.get(name.toLowerCase());
+            if (!role)
+                return undefined;
+            resolved.push(role);
+        }
+        return resolved.length > 0 ? resolved : undefined;
+    }
+    return [...definitions.values()].filter(role => (role.name !== 'project-rules' || projectRulesPresent) &&
+        (role.name !== 'spec-compliance' || hasSpec));
+}
+function historicalGating(config, catalog, rosterModels) {
+    const input = config.gating;
+    const mode = input?.mode ?? 'verified-consensus';
+    const minModels = input?.minModels ?? 2;
+    if (!Number.isSafeInteger(minModels) || minModels < 2)
+        return undefined;
+    let verificationModel = input?.verificationModel;
+    if (verificationModel?.startsWith('openrouter/'))
+        return undefined;
+    if (verificationModel === undefined) {
+        const providers = new Set(rosterModels.map(historicalProvider));
+        verificationModel = providers.has(historicalProvider(catalog.defaultVerifier))
+            ? catalog.defaultVerifier
+            : rosterModels.find(model => ['anthropic', 'openai', 'google'].includes(historicalProvider(model)));
+    }
+    const effort = input?.verificationReasoningEffort ??
+        (verificationModel === catalog.defaultVerifier ? catalog.verificationReasoningEffort : undefined);
+    if (effort !== undefined && (!verificationModel || historicalProvider(verificationModel) !== 'openai'))
+        return undefined;
+    const passTimeout = input?.verificationPassTimeout ?? 180_000;
+    const timeout = input?.verificationTimeout ?? passTimeout;
+    if (![passTimeout, timeout].every(value => Number.isFinite(value) && value > 0 && value <= 2_147_483_647))
+        return undefined;
+    return {
+        mode,
+        min_models: minModels,
+        ...(verificationModel ? { verification_model: verificationModel } : {}),
+        ...(effort ? { verification_reasoning_effort: effort } : {}),
+        verification_timeout_ms: timeout,
+        verification_pass_timeout_ms: passTimeout,
+    };
+}
+function buildRoster(config, roles, gating) {
+    if (!gating)
+        return undefined;
+    const models = config.models ?? [];
+    const secondaryModels = config.secondaryModels ?? [];
+    const asyncModels = (config.asyncModels ?? []).filter(model => !models.includes(model));
+    const definitions = new Map(roles.map(role => [role.name, role]));
+    let blocking;
+    if ((config.reviewers?.length ?? 0) > 0) {
+        blocking = config.reviewers.flatMap(pair => {
+            const role = definitions.get(pair.role) ?? definitions.get(pair.role.toLowerCase());
+            return role ? [{ model: pair.model, role: role.name, provider: historicalProvider(pair.model), lane: 'blocking' }] : [];
+        });
+        if (blocking.length === 0)
+            return undefined;
+    }
+    else {
+        const core = new Set(models);
+        blocking = [];
+        for (const model of models) {
+            for (const role of roles.filter(candidate => !candidate.specialized)) {
+                blocking.push({ model, role: role.name, provider: historicalProvider(model), lane: 'blocking' });
+            }
+        }
+        const allModels = [...new Set([...models, ...secondaryModels])];
+        if (allModels.length === 0 && roles.some(role => role.specialized))
+            return undefined;
+        roles.filter(role => role.specialized).forEach((role, index) => {
+            const model = allModels[index % allModels.length];
+            blocking.push({ model, role: role.name, provider: historicalProvider(model),
+                lane: core.has(model) ? 'blocking' : 'secondary' });
+        });
+    }
+    const async = config.reviewers?.length ? [] : asyncModels.flatMap(model => roles.filter(role => !role.specialized).map(role => ({ model, role: role.name,
+        provider: historicalProvider(model), lane: 'async' })));
+    const verification = gating.mode === 'verified-consensus' && gating.verification_model
+        ? [{ model: gating.verification_model, role: 'verification',
+                provider: historicalProvider(gating.verification_model), lane: 'verification' }]
+        : [];
+    return [...blocking, ...async, ...verification];
+}
+/** Authenticate a removed producer's deterministic roster without consulting today's role/default registry. */
+export function authenticHistoricalRoster(run, config) {
+    if (!Object.hasOwn(CATALOGS, run.rcl_version))
+        return false;
+    const catalog = CATALOGS[run.rcl_version];
+    if (!catalog || !Array.isArray(run.roster) || run.roster.length === 0)
+        return false;
+    // A retained report has no authenticated source for either custom prompts or
+    // explicit reviewer selection. Preserve the current-roster path for those
+    // configurations, but never infer them from a historical default catalog.
+    if ((config.customRoles?.length ?? 0) > 0 || (config.reviewers?.length ?? 0) > 0)
+        return false;
+    const rosterModels = [...(config.models ?? []), ...(config.secondaryModels ?? []), ...(config.asyncModels ?? [])];
+    const gating = historicalGating(config, catalog, rosterModels);
+    if (!gating || !isDeepStrictEqual(run.gating, gating))
+        return false;
+    const projectVariants = catalog.roles.includes('project-rules') && !config.roles?.includes('project-rules')
+        ? [false, true] : [true];
+    return projectVariants.some(projectRulesPresent => {
+        const roles = resolveRequestedRoles(config, catalog, run.spec !== undefined, projectRulesPresent);
+        const roster = roles && buildRoster(config, roles, gating);
+        return roster !== undefined && isDeepStrictEqual(run.roster, roster);
+    });
+}
+//# sourceMappingURL=legacy-roster.js.map

package/dist/converge/legacy-roster.js.map

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

package/dist/converge/native-lock.d.ts

@@ -0,0 +1,18 @@
+import { type RegistryHooks } from '../coordination/registry-lock.js';
+import { type LockScope } from '../evidence/original-run/lock-scope.js';
+interface UnqualifiedScope {
+    platform: 'ordinary-unqualified';
+    operating_system: string;
+}
+export type NativeLockScope = LockScope | UnqualifiedScope;
+export declare function validNativeLockScope(value: unknown): value is NativeLockScope;
+/** Windows flushes file bytes but does not expose fsync-able directory handles. */
+export declare function syncNativeDirectory(path: string): Promise<void>;
+/** Existing ordinary storage is not thereby qualified for recovery durability. */
+export declare function withNativeLock<T>(root: string, target: string, work: () => Promise<T>, hooks?: RegistryHooks<NativeLockScope>, timing?: {
+    lockTimeoutMs?: number;
+    lockRetryMs?: number;
+}): Promise<T>;
+/** Native atomic replacement uses the same JSON bytes and platform durability as attempts. */
+export declare function writeNativeStateExclusive(path: string, value: unknown): Promise<void>;
+export {};

package/dist/converge/native-lock.js

@@ -0,0 +1,122 @@
+import { constants } from 'node:fs';
+import { lstat, mkdir, open, realpath } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { withRegistryLock } from '../coordination/registry-lock.js';
+import { serializeRecoveryDocument } from '../evidence/original-run/journal.js';
+import { localLockScope, validLockScope } from '../evidence/original-run/lock-scope.js';
+const scopes = new Map();
+/** Boot and this process's PID namespace cannot change during its lifetime. */
+async function nativeScope() {
+    const platform = process.platform;
+    if (platform === 'darwin' || platform === 'linux') {
+        let pending = scopes.get(platform);
+        if (!pending) {
+            pending = localLockScope();
+            scopes.set(platform, pending);
+            void pending.catch(() => { if (scopes.get(platform) === pending)
+                scopes.delete(platform); });
+        }
+        try {
+            return await pending;
+        }
+        catch { /* No invented boot or PID namespace. */ }
+    }
+    return { platform: 'ordinary-unqualified', operating_system: platform };
+}
+export function validNativeLockScope(value) {
+    if (validLockScope(value))
+        return true;
+    if (!value || typeof value !== 'object')
+        return false;
+    const scope = value;
+    return scope.platform === 'ordinary-unqualified' && typeof scope.operating_system === 'string' &&
+        /^[a-z0-9_-]{1,32}$/.test(scope.operating_system) && Object.keys(value).length === 2;
+}
+/** Windows flushes file bytes but does not expose fsync-able directory handles. */
+export async function syncNativeDirectory(path) {
+    if (process.platform === 'win32')
+        return;
+    const handle = await open(path, 'r');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function inspectNativeDirectory(path) {
+    const info = await lstat(path);
+    if (!info.isDirectory() || info.isSymbolicLink() || await realpath(path) !== path ||
+        (process.platform !== 'win32' && ((info.mode & 0o7777) !== 0o700 || info.uid !== process.geteuid?.()))) {
+        throw new Error('unsafe_native_lock_directory');
+    }
+}
+async function prepareNativeRoot(input) {
+    const path = resolve(input);
+    if (await realpath(dirname(path)) !== dirname(path))
+        throw new Error('unsafe_native_lock_directory');
+    try {
+        await mkdir(path, { mode: 0o700 });
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+    await inspectNativeDirectory(path);
+    return path;
+}
+/** Bounded atomic-registration read, including platforms without O_NOFOLLOW. */
+async function readNativeRegistration(path) {
+    const entry = await lstat(path);
+    if (!entry.isFile() || entry.isSymbolicLink())
+        throw new Error('invalid_native_lock_registration');
+    const handle = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
+    try {
+        const before = await handle.stat();
+        if (!before.isFile() || before.size > 2048 || entry.ino !== before.ino || entry.dev !== before.dev)
+            throw new Error('changing_source');
+        const bytes = Buffer.alloc(before.size + 1);
+        let length = 0;
+        while (length < bytes.length) {
+            const next = await handle.read(bytes, length, bytes.length - length, length);
+            if (!next.bytesRead)
+                break;
+            length += next.bytesRead;
+        }
+        const after = await handle.stat(), current = await lstat(path);
+        if (length !== before.size || before.size !== after.size || before.mtimeMs !== after.mtimeMs ||
+            before.ctimeMs !== after.ctimeMs || current.ino !== before.ino || current.dev !== before.dev || !current.isFile()) {
+            throw new Error('changing_source');
+        }
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes.subarray(0, length));
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Existing ordinary storage is not thereby qualified for recovery durability. */
+export function withNativeLock(root, target, work, hooks = {}, timing = {}) {
+    return withRegistryLock(root, target, work, {
+        scope: nativeScope, validScope: validNativeLockScope, prepareRoot: prepareNativeRoot,
+        inspectRegistry: inspectNativeDirectory, sync: syncNativeDirectory, read: readNativeRegistration,
+        // Unqualified registrations are never reaped using a PID or elapsed time.
+        // Interrupted owners need inspection, including after a reboot.
+        mayProbePid: validLockScope,
+        ...timing,
+    }, hooks);
+}
+/** Native atomic replacement uses the same JSON bytes and platform durability as attempts. */
+export async function writeNativeStateExclusive(path, value) {
+    if (await realpath(dirname(path)) !== dirname(path))
+        throw new Error('symlink_directory');
+    const handle = await open(path, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | (constants.O_NOFOLLOW ?? 0), 0o600);
+    try {
+        await handle.writeFile(serializeRecoveryDocument(value));
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    await syncNativeDirectory(dirname(path));
+}
+//# sourceMappingURL=native-lock.js.map

package/dist/converge/native-lock.js.map

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

package/dist/converge/ordinary-pending-export.d.ts

@@ -0,0 +1,67 @@
+interface OrdinaryLaunchInputs {
+    gitCommonDir: string;
+    target: string;
+    headSha: string;
+    baseSha: string | null;
+    guardedInput: Record<string, unknown>;
+    attempt: number;
+    round: number;
+    cycleId?: string;
+    asyncDescriptors?: Array<{
+        model: string;
+        role: string;
+        provider: string;
+    }>;
+}
+export interface RetainedOrdinaryInputs {
+    path: string;
+    sha256: string;
+    baseSha: string | null;
+}
+/** Called under native target ownership before spending the claim or dispatching. */
+export declare function retainOrdinaryLaunchInputs(options: OrdinaryLaunchInputs): Promise<RetainedOrdinaryInputs>;
+interface OrdinaryPendingExportOptions {
+    gitCommonDir: string;
+    target: string;
+    headSha: string;
+    baseSha: string;
+    expectedBaseSha: string;
+    expectedRound?: number;
+    guardedInput: Record<string, unknown>;
+    asyncStoreDir: string;
+    asyncTargetKey: string;
+    asyncDescriptors: Array<{
+        model: string;
+        role: string;
+        provider: string;
+    }>;
+    path: string;
+    preview: boolean;
+}
+/**
+ * Authenticate reconstructed ordinary inputs without locks, claims or native writes.
+ * Historical launch digests did not include base: the receipt explicitly limits
+ * that assertion to the caller's expected and currently resolved review target.
+ * Async bytes are supplemental history, never durable blocking-call receipts.
+ */
+export declare function exportOrdinaryPendingPackage(options: OrdinaryPendingExportOptions): Promise<{
+    mode: string;
+    path: string;
+    packageSha256: string;
+    target: string;
+    headSha: string;
+    baseSha: string;
+    baseBinding: string;
+    blockingOutcome: string;
+    asyncBinding: string;
+    inputSha256: string;
+    attempt: number;
+    round: number;
+    pid: number;
+    attemptsUsed: number;
+    cap: number;
+    nativeStateSha256: string;
+    attemptStateSha256: string;
+    retainedAsyncSha256: string[];
+}>;
+export {};