@allocator-one/rcl 4.4.19

package/dist/discuss.js

@@ -0,0 +1,112 @@
+import { readFile } from 'fs/promises';
+import { detectProvider } from './roles/dispatcher.js';
+import { defaultAdapterFactory } from './dispatch/runner.js';
+/**
+ * Resolve `--finding <id>` against kept findings first, then the
+ * below-threshold appendix (appendix findings are prime discussion
+ * targets — one model saw something nobody confirmed). Model-generated ids
+ * can collide across reviewers, so `<id>:<n>` picks the nth match (1-based).
+ */
+export function resolveFinding(result, findingRef) {
+    const all = [...result.findings, ...(result.belowThresholdFindings ?? [])];
+    const nthMatch = findingRef.match(/^(.+):(\d+)$/);
+    const id = nthMatch ? nthMatch[1] : findingRef;
+    const matches = all.filter((f) => f.id === id);
+    if (matches.length === 0) {
+        const available = all
+            .slice(0, 30)
+            .map((f) => `  ${f.id}  ${f.file}:${f.startLine}  ${f.title.slice(0, 70)}`)
+            .join('\n');
+        throw new Error(`No finding with id "${id}" in the report. Available (first 30):\n${available}`);
+    }
+    if (matches.length === 1)
+        return matches[0];
+    if (nthMatch) {
+        const n = parseInt(nthMatch[2], 10);
+        const picked = matches[n - 1];
+        if (!picked) {
+            throw new Error(`Finding id "${id}" has ${matches.length} matches; :${n} is out of range.`);
+        }
+        return picked;
+    }
+    const candidates = matches
+        .map((f, i) => `  ${id}:${i + 1}  ${f.file}:${f.startLine}  ${f.title.slice(0, 70)}`)
+        .join('\n');
+    throw new Error(`Finding id "${id}" is ambiguous (${matches.length} matches). Pick one with:\n${candidates}`);
+}
+export function buildDiscussPrompts(input) {
+    const { finding, question, contextDocs } = input;
+    const c = finding.consensus;
+    const systemPrompt = `You are a reviewer on a multi-model code review council, discussing one of the council's findings with the engineer who must decide whether to act on it. Answer the question directly and concretely, grounded in the finding's context. If the question or context shows the finding is wrong, overstated, or unexploitable, say so plainly — changing your mind under new information is good reviewing, not weakness. If you lack the code context to be sure, say exactly what you would need to see. Keep the answer under 300 words.`;
+    const lines = [
+        '## Finding under discussion',
+        '',
+        `- File: ${finding.file} (lines ${finding.startLine}–${finding.endLine})`,
+        `- Severity: ${finding.severity} · Category: ${finding.category}`,
+        `- Council agreement: ${c.disputed ? 'DISPUTED' : c.tier} — flagged by ${c.models.join(', ')} (roles: ${c.roles.join(', ')}) · confidence ${c.confidenceLabel}`,
+        `- Title: ${finding.title}`,
+        '',
+        finding.description,
+    ];
+    if (finding.suggestedFix) {
+        lines.push('', '### Suggested fix on record', finding.suggestedFix);
+    }
+    if (c.disputed && c.disputeDetails) {
+        lines.push('', `### Dispute`, c.disputeDetails);
+    }
+    if (c.positions?.length) {
+        lines.push('', '### Positions taken by council members');
+        for (const p of c.positions) {
+            lines.push(`- ${p.model} (${p.role}) rated ${p.severity}: ${p.title} — ${p.excerpt}`);
+        }
+    }
+    if (contextDocs?.length) {
+        for (const doc of contextDocs) {
+            lines.push('', `### Context: ${doc.label}`, '```', doc.content, '```');
+        }
+    }
+    lines.push('', '## Question', question);
+    return { systemPrompt, userPrompt: lines.join('\n') };
+}
+/** Ask every target model the same question in parallel. */
+export async function runDiscussion(models, prompts, options) {
+    const factory = options.adapterFactory ??
+        ((provider) => defaultAdapterFactory(provider, options.reasoningEffort));
+    return Promise.all(models.map(async (model) => {
+        try {
+            const adapter = factory(detectProvider(model));
+            return await adapter.ask(model, prompts.systemPrompt, prompts.userPrompt, options);
+        }
+        catch (err) {
+            // A missing API key for one provider must not sink the other answers.
+            return {
+                model,
+                provider: detectProvider(model),
+                text: '',
+                durationMs: 0,
+                status: 'error',
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }));
+}
+const MAX_CONTEXT_BYTES = 200_000;
+export async function loadContextDocs(paths) {
+    const docs = [];
+    for (const path of paths) {
+        try {
+            const content = await readFile(path, 'utf-8');
+            docs.push({
+                label: path,
+                content: Buffer.byteLength(content, 'utf-8') > MAX_CONTEXT_BYTES
+                    ? `${content.slice(0, MAX_CONTEXT_BYTES)}\n[truncated]`
+                    : content,
+            });
+        }
+        catch {
+            console.warn(`Warning: could not read context file: ${path}`);
+        }
+    }
+    return docs;
+}
+//# sourceMappingURL=discuss.js.map

package/dist/discuss.js.map

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

package/dist/dispatch/adapter.d.ts

@@ -0,0 +1,32 @@
+import type { VerificationReasoningEffort } from '../config/schema.js';
+import type { ModelReview } from '../consensus/types.js';
+export interface AdapterOptions {
+    /** Explicit OpenAI ask effort; omitted calls retain their provider default. */
+    reasoningEffort?: VerificationReasoningEffort;
+    timeoutMs: number;
+    maxRetries: number;
+    /**
+     * External cancellation (quorum round closure). Adapters must abort the
+     * in-flight request when it fires so canceled calls stop consuming
+     * provider time and the process can exit.
+     */
+    signal?: AbortSignal;
+}
+/** A free-text answer from one model (discuss path — no findings schema). */
+export interface ModelAnswer {
+    /** Observed SDK invocations, including ambiguous failures; not wire requests or billing. */
+    adapterAttempts?: number;
+    model: string;
+    provider: string;
+    text: string;
+    durationMs: number;
+    status: 'success' | 'timeout' | 'error';
+    error?: string;
+}
+export interface ReviewAdapter {
+    name: string;
+    provider: string;
+    review(model: string, role: string, systemPrompt: string, userPrompt: string, options: AdapterOptions): Promise<ModelReview>;
+    /** One-shot free-text question — used by `rcl discuss`. */
+    ask(model: string, systemPrompt: string, userPrompt: string, options: AdapterOptions): Promise<ModelAnswer>;
+}

package/dist/dispatch/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/dispatch/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/dispatch/adapter.ts"],"names":[],"mappings":""}

package/dist/dispatch/anthropic.d.ts

@@ -0,0 +1,10 @@
+import type { ModelReview } from '../consensus/types.js';
+import type { ReviewAdapter, AdapterOptions, ModelAnswer } from './adapter.js';
+export declare class AnthropicAdapter implements ReviewAdapter {
+    name: string;
+    provider: string;
+    private client;
+    constructor(apiKey?: string);
+    review(model: string, role: string, systemPrompt: string, userPrompt: string, options: AdapterOptions): Promise<ModelReview>;
+    ask(model: string, systemPrompt: string, userPrompt: string, options: AdapterOptions): Promise<ModelAnswer>;
+}

package/dist/dispatch/anthropic.js

@@ -0,0 +1,235 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { parseReviewOutput } from '../consensus/parser.js';
+import { stripKnownProviderPrefix, isRetryableStatus, attemptWithRetries, isRetryableConnectionError, failedReview, isBlankOutput, reviewFromParse, usageFromAnthropic, ASK_MAX_OUTPUT_TOKENS, TruncatedAnswerError, } from './utils.js';
+function isRetryable(err) {
+    if (err instanceof Anthropic.APIConnectionError)
+        return isRetryableConnectionError(err, true);
+    return err instanceof Anthropic.APIError && isRetryableStatus(err.status);
+}
+function isRetryableReview(err, stream) {
+    if (err instanceof Anthropic.APIConnectionError || err instanceof Anthropic.APIUserAbortError)
+        return isRetryable(err);
+    if (isRetryable(err))
+        return true;
+    if (!stream)
+        return false;
+    // The SDK can reject finalMessage() without an HTTP status when a stream
+    // disconnects, receives a transient SSE error, or ends before message_stop.
+    // An abort, invalid request, or malformed response stays terminal.
+    if (err instanceof Anthropic.APIError && err.status === undefined &&
+        (err.type === 'overloaded_error' || err.type === 'api_error' ||
+            err.type === 'rate_limit_error' || err.type === 'timeout_error'))
+        return true;
+    return err instanceof Anthropic.AnthropicError &&
+        (err.message === 'stream ended without producing a Message with role=assistant' ||
+            err.message === 'request ended without sending any chunks');
+}
+const DEFAULT_PROFILE = { maxTokens: 16384, stream: false };
+// Always-on thinking counts against max_tokens, so high effort needs headroom
+// for thinking plus findings. Keep streaming and the existing whole-call
+// deadline from RCL-103. Opus 5.5 defaults to medium effort; a review is
+// intelligence-sensitive work, so request high explicitly.
+const THINKING_REVIEW_PROFILE = { maxTokens: 65536, effort: 'high', stream: true };
+// Claude 4.6+ uses dateless pinned API IDs; these profiles apply to the
+// documented IDs only, without guessing future model capabilities.
+// https://platform.claude.com/docs/en/about-claude/models/model-ids-and-versions
+const MODEL_PROFILES = {
+    'claude-opus-5-5': THINKING_REVIEW_PROFILE,
+    'claude-fable-5-1': THINKING_REVIEW_PROFILE,
+};
+function profileFor(modelId) {
+    return MODEL_PROFILES[modelId] ?? DEFAULT_PROFILE;
+}
+export class AnthropicAdapter {
+    name = 'anthropic';
+    provider = 'anthropic';
+    client;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey ?? process.env['ANTHROPIC_API_KEY'],
+            // The adapter's retry loop owns all retries; SDK-internal retries
+            // would multiply wire attempts inside one timeout budget.
+            maxRetries: 0,
+        });
+    }
+    async review(model, role, systemPrompt, userPrompt, options) {
+        const start = Date.now();
+        let adapterAttempts = 0;
+        const modelId = stripKnownProviderPrefix(model);
+        // Opus 5.5 and Fable 5.1 count adaptive thinking against max_tokens. Large
+        // review chunks exhausted the old ceiling before any findings arrived.
+        const profile = profileFor(modelId);
+        const outcome = await attemptWithRetries({
+            timeoutMs: options.timeoutMs,
+            maxRetries: options.maxRetries ?? 3,
+            signal: options.signal,
+            isRetryable: (err) => isRetryableReview(err, profile.stream),
+            attempt: async (signal) => {
+                // Use tool use for reliable JSON extraction
+                const request = {
+                    model: modelId,
+                    max_tokens: profile.maxTokens,
+                    ...(profile.effort ? { output_config: { effort: profile.effort } } : {}),
+                    system: systemPrompt,
+                    messages: [{ role: 'user', content: userPrompt }],
+                    tools: [
+                        {
+                            name: 'report_findings',
+                            description: 'Report code review findings as structured JSON',
+                            input_schema: {
+                                type: 'object',
+                                properties: {
+                                    findings: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'object',
+                                            properties: {
+                                                id: { type: 'string' },
+                                                file: { type: 'string' },
+                                                startLine: { type: 'number' },
+                                                endLine: { type: 'number' },
+                                                severity: {
+                                                    type: 'string',
+                                                    enum: ['critical', 'important', 'minor', 'nitpick'],
+                                                },
+                                                category: {
+                                                    type: 'string',
+                                                    enum: ['security', 'correctness', 'best-practices', 'tests', 'api-design'],
+                                                },
+                                                title: { type: 'string' },
+                                                description: { type: 'string' },
+                                                suggestedFix: { type: 'string' },
+                                            },
+                                            required: ['id', 'file', 'startLine', 'endLine', 'severity', 'category', 'title', 'description'],
+                                        },
+                                    },
+                                },
+                                required: ['findings'],
+                            },
+                        },
+                    ],
+                    tool_choice: { type: 'auto' },
+                };
+                // The larger thinking-model output budget requires the SDK's streaming path.
+                // finalMessage() keeps the same complete-response parsing and
+                // truncation checks used by the nonstreaming path.
+                const requestOptions = {
+                    signal: signal,
+                    timeout: options.timeoutMs + 30_000,
+                };
+                adapterAttempts++;
+                const response = profile.stream
+                    ? await this.client.messages.stream(request, requestOptions).finalMessage()
+                    : await this.client.messages.create(request, requestOptions);
+                const usage = usageFromAnthropic(response.usage);
+                if (response.stop_reason === 'max_tokens') {
+                    return failedReview({
+                        model,
+                        role,
+                        provider: 'anthropic',
+                        startedAt: start,
+                        usage,
+                        error: 'Response truncated at max_tokens; findings would be incomplete',
+                    });
+                }
+                // Safety classifiers decline in-band: HTTP 200, no content. Left
+                // unhandled this reads as a clean review of code nobody looked at.
+                if (response.stop_reason === 'refusal') {
+                    const details = response.stop_details;
+                    const category = details !== null && details !== undefined && 'category' in details
+                        ? details.category
+                        : null;
+                    return failedReview({
+                        model,
+                        role,
+                        provider: 'anthropic',
+                        startedAt: start,
+                        usage,
+                        error: `Model refused this review${category ? ` (${category})` : ''} — the diff was not reviewed`,
+                    });
+                }
+                // Extract from tool use
+                let rawOutput = '';
+                for (const block of response.content) {
+                    if (block.type === 'tool_use' && block.name === 'report_findings') {
+                        rawOutput = JSON.stringify(block.input);
+                        break;
+                    }
+                    if (block.type === 'text') {
+                        rawOutput += block.text;
+                    }
+                }
+                if (isBlankOutput(rawOutput)) {
+                    return failedReview({
+                        model,
+                        role,
+                        provider: 'anthropic',
+                        startedAt: start,
+                        usage,
+                        error: 'Model returned an empty response; the diff was not reviewed',
+                    });
+                }
+                // If tool wasn't used, parse text output
+                const parsed = parseReviewOutput(rawOutput, model, role);
+                for (const w of parsed.warnings)
+                    console.warn(w);
+                return reviewFromParse({
+                    model,
+                    role,
+                    provider: 'anthropic',
+                    startedAt: start,
+                    parsed,
+                    usage,
+                });
+            },
+        });
+        return outcome.ok
+            ? { ...outcome.value, adapterAttempts }
+            : { ...failedReview({ model, role, provider: 'anthropic', startedAt: start,
+                    status: outcome.timedOut ? 'timeout' : 'error', error: outcome.error }), adapterAttempts };
+    }
+    async ask(model, systemPrompt, userPrompt, options) {
+        const start = Date.now();
+        const modelId = stripKnownProviderPrefix(model);
+        let adapterAttempts = 0;
+        const outcome = await attemptWithRetries({
+            timeoutMs: options.timeoutMs,
+            maxRetries: options.maxRetries ?? 3,
+            signal: options.signal,
+            isRetryable,
+            attempt: async (signal) => {
+                adapterAttempts++;
+                const response = await this.client.messages.create({
+                    model: modelId,
+                    max_tokens: ASK_MAX_OUTPUT_TOKENS,
+                    system: systemPrompt,
+                    messages: [{ role: 'user', content: userPrompt }],
+                }, { signal, timeout: options.timeoutMs + 30_000 });
+                // An answer cut off at the ceiling is not a short answer: the verifier
+                // emits one entry per finding, and a partial list parses to nothing,
+                // which gates every candidate it never reached (RCL-60).
+                if (response.stop_reason === 'max_tokens') {
+                    throw new TruncatedAnswerError('anthropic');
+                }
+                return response.content
+                    .filter((block) => block.type === 'text')
+                    .map((block) => block.text)
+                    .join('\n')
+                    .trim();
+            },
+        });
+        const durationMs = Date.now() - start;
+        return outcome.ok
+            ? { model, provider: 'anthropic', text: outcome.value, durationMs, adapterAttempts, status: 'success' }
+            : {
+                model,
+                provider: 'anthropic',
+                text: '',
+                durationMs,
+                adapterAttempts,
+                status: outcome.timedOut ? 'timeout' : 'error',
+                error: outcome.error,
+            };
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/dispatch/anthropic.js.map

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

package/dist/dispatch/async-lane.d.ts

@@ -0,0 +1,127 @@
+import { AmbiguousReviewerIdentityError, type ReviewerIdentity } from './reviewer-identity.js';
+import type { ModelReview } from '../consensus/types.js';
+import type { ReviewAdapter } from './adapter.js';
+import type { ReasoningEffort } from '../config/schema.js';
+/**
+ * Async review lane (RCL-25). Async models are fired with the round but never
+ * awaited: the main process writes a spool file per call and launches a
+ * detached worker (`rcl async-worker`) that runs the call and drops the
+ * completed ModelReview into the store. The NEXT review of the same target
+ * collects whatever has arrived and merges it into its dedup, marked async.
+ *
+ * The store lives in the repository's git common dir (durable across rounds,
+ * repo-scoped, not world-writable), falling back to a per-user tmp dir when
+ * reviewing outside a repository.
+ */
+export interface AsyncCallSpec {
+    model: string;
+    role: string;
+    provider: string;
+    systemPrompt: string;
+    userPrompt: string;
+}
+export interface AsyncLaneOptions {
+    storeDir: string;
+    targetKey: string;
+    timeoutMs: number;
+    maxRetries: number;
+    reasoningEffort?: ReasoningEffort;
+}
+/**
+ * Detached workers are one Node process each; a huge chunked diff must not
+ * fan out into an unbounded process swarm. Beyond this, extra async calls
+ * are dropped (the lane is a bonus, never load-bearing).
+ */
+export declare const MAX_ASYNC_CALLS_PER_ROUND = 8;
+/** Split assignments so async models never sit on the blocking path. */
+export declare function partitionAsyncAssignments<A extends {
+    model: string;
+}>(assignments: A[], asyncModels: readonly string[]): {
+    blocking: A[];
+    async: A[];
+};
+/**
+ * Stable, filesystem-safe key for a review target, so consecutive rounds of
+ * the same converge run find each other's async results and different targets
+ * never collide. Same alphabet rule as the converge attempt store.
+ * For a converging patch, pass the validated convergence target instead of
+ * identifying the loop by its per-round capture path. Prefix the complete
+ * key to keep this namespace separate without changing legacy target keys.
+ */
+export declare function asyncTargetKey(target: string, convergeTarget?: string, cycleId?: string): string;
+/**
+ * Store directory: `<gitCommonDir>/rcl-async` inside a repository, else a
+ * per-user directory under the OS tmpdir (mode 0700 either way).
+ *
+ * The directory is verified before use — spools contain the diff, and a
+ * forged result file would inject findings into the next round. A tmpdir
+ * path in particular is predictable, so a pre-created symlink or another
+ * user's directory must be rejected, never chmod'd or written into.
+ */
+export declare function resolveAsyncStoreDir(cwd?: string): Promise<string>;
+/** Resolve an existing async store without creating or changing it. */
+export declare function resolveExistingAsyncStoreDir(cwd?: string): Promise<string>;
+/**
+ * Current branch name for git-mode target labels, so `--staged` /
+ * `--working-tree` reviews on different branches of one repository never
+ * exchange async results. Best-effort: '' outside a repo or on detached
+ * HEAD (the store is repo-scoped, so the label only needs to split
+ * branches).
+ */
+export declare function currentBranchLabel(cwd?: string): Promise<string>;
+/** Write one spool file per async call; returns the spool paths. */
+export declare function spoolAsyncCalls(calls: AsyncCallSpec[], options: AsyncLaneOptions): Promise<string[]>;
+/**
+ * Environment for a detached worker: provider credentials/config, proxy and
+ * locale basics — nothing else. The worker only ever talks to its model
+ * provider, so unrelated secrets in the parent env (GITHUB_TOKEN, cloud
+ * credentials, …) have no business outliving the review in a background
+ * process.
+ */
+export declare function workerEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Launch one detached worker process per spool. Fire-and-forget by design:
+ * the parent exits when the blocking council is done, and the workers keep
+ * running until their call completes or times out. Launch failures are
+ * contained: an unhandled child 'error' event would crash the review
+ * process that is doing the real work.
+ */
+export declare function launchAsyncWorkers(spoolPaths: string[], cliScript?: string): void;
+/**
+ * Worker body: consume one spool file, run the call, publish the completed
+ * review atomically (tmp + rename, so collect never reads a half-written
+ * file). A failed call still publishes — an async reviewer that silently
+ * vanishes would be invisible in every report.
+ */
+export declare function runAsyncWorker(spoolFile: string, adapterFactory?: (provider: string) => ReviewAdapter): Promise<void>;
+/** Publish a derived opportunistic opinion; this store is never physical-call authority. */
+export declare function publishAsyncReview(storeDir: string, targetKey: string, review: ModelReview): Promise<void>;
+/**
+ * Exact bytes observed before a refusal. The original file remains untouched,
+ * while the private refusal artifact can still recover it after normal store
+ * cleanup removes the source path.
+ */
+export interface AsyncResultReference {
+    path: string;
+    sha256: string;
+    bytesBase64: string;
+}
+/** Immutable read-only snapshot for a target-locked interrupted-launch resume. */
+export declare function snapshotAsyncResults(storeDir: string, targetKey: string, blockingReviews?: readonly ReviewerIdentity[], expectedSha256?: readonly string[]): Promise<{
+    reviews: ModelReview[];
+    reviewBytes: string[];
+    artifacts: AsyncResultReference[];
+}>;
+/** Consume only the exact reviewed async artifacts after terminal recovery. */
+export declare function consumeBoundAsyncResults(storeDir: string, targetKey: string, expectedSha256: readonly string[], options?: {
+    allowAlreadyConsumed?: boolean;
+}): Promise<void>;
+/**
+ * Collect (and consume) every arrived async result for this target. Corrupt
+ * files are skipped and removed; other targets' files are left alone except
+ * for a TTL sweep of stale leftovers.
+ */
+export declare function collectAsyncResults(storeDir: string, targetKey: string, options?: {
+    blockingReviews?: readonly ReviewerIdentity[];
+    onIdentityRefused?: (error: AmbiguousReviewerIdentityError, artifacts: AsyncResultReference[]) => Promise<void>;
+}): Promise<ModelReview[]>;