agent-qa 0.2.4 → 0.2.6

package/dist/index.d.ts

@@ -1,16 +1,18 @@
-import { AgentQaConfig, resolveKnowledgeRoot } from '@vostride/agent-qa-core';
-export * from '@vostride/agent-qa-core';
-import { MaskFn, CompletedRunHandoff, CanaryOutcome, RecordId, Anchor, RunAnalysisArtifact, CurationSnapshot } from '@vostride/agent-qa-schema';
-import { CuratorAuthor, CurationCandidateProjection, EnqueueCurationCandidateProjectionOutcome, OpenServingKnowledgeReaderConfig, LocalCurationCapabilities } from '@vostride/agent-qa-agent-local';
-import { ModelProfile, ResolvedModelAuth, createModel, resolveCapabilities, createTokenAccounting } from '@vostride/agent-qa-model';
-import { KnowledgeHintReader } from '@vostride/agent-qa-runner';
-import { loadCompletedRunHandoff } from '@vostride/agent-qa-runner-local';
-import { runSafetyScope } from '@vostride/agent-qa-safety-local';
-import { z } from 'zod';
-
-declare class ConfigFileNotYamlError extends Error {
-    readonly configPath: string;
-    constructor(configPath: string, cause: unknown);
+import { AgentQaConfig, resolveKnowledgeRoot } from "@vostride/agent-qa-core";
+import { ModelProfile, ResolvedModelAuth, createModel, createTokenAccounting, resolveCapabilities } from "@vostride/agent-qa-model";
+import "commander";
+import { CurationCandidateProjection, CuratorAuthor, EnqueueCurationCandidateProjectionOutcome, LocalCurationCapabilities, OpenServingKnowledgeReaderConfig } from "@vostride/agent-qa-agent-local";
+import { z } from "zod";
+import { Anchor, CanaryOutcome, CompletedRunHandoff, CurationSnapshot, MaskFn, RecordId, RunAnalysisArtifact } from "@vostride/agent-qa-schema";
+import { loadCompletedRunHandoff } from "@vostride/agent-qa-runner-local";
+import { runSafetyScope } from "@vostride/agent-qa-safety-local";
+import "@vostride/agent-qa-agent";
+import "@vostride/agent-qa-analytics";
+import { KnowledgeHintReader } from "@vostride/agent-qa-runner";
+export * from "@vostride/agent-qa-core";
+export declare class ConfigFileNotYamlError extends Error {
+  readonly configPath: string;
+  constructor(configPath: string, cause: unknown);
 }
 /**
  * THE READ AND THE PARSE GET SEPARATE CATCHES, and that separation is load-bearing.
@@ -20,298 +22,286 @@ declare class ConfigFileNotYamlError extends Error {
  * fact about the filesystem and not about the file's content, and is rethrown untouched. Only the
  * PARSE throw is reworded — one guard, aimed at one channel.
  */
-declare function loadConfigFile(configPath: string): Promise<unknown>;
-declare class ConfigFileNotFoundError extends Error {
-    readonly configPath: string;
-    constructor(configPath: string);
+export declare function loadConfigFile(configPath: string): Promise<unknown>;
+export declare class ConfigFileNotFoundError extends Error {
+  readonly configPath: string;
+  constructor(configPath: string);
 }
-declare function loadRequiredConfigFile(configPath: string): Promise<unknown>;
-declare function loadEnvOverrides(): Record<string, unknown>;
-declare function mergeConfigs(file: unknown, env: Record<string, unknown>, flags: Record<string, unknown>): unknown;
-declare function deepMerge(base: unknown, override: unknown): unknown;
-declare function mergeWithTestConfig(globalConfig: unknown, testConfig: unknown, flagOverrides: Record<string, unknown>): unknown;
-declare function normalizeConfigForValidation(config: unknown): unknown;
-declare function mergeUseBlocks(globalUse: Record<string, unknown> | undefined, suiteUse: Record<string, unknown> | undefined, testUse: Record<string, unknown> | undefined, cliFlags: Record<string, unknown>): Record<string, unknown>;
-declare function formatConfigDebug(globalConfig: unknown, testConfig: unknown, flagOverrides: Record<string, unknown>, mask: MaskFn): string;
-declare function readAnalyticsPrivacyDeclaration(configPath?: string): Promise<{
-    analytics: {
-        privacy: boolean;
-    };
+export declare function loadRequiredConfigFile(configPath: string): Promise<unknown>;
+export declare function loadEnvOverrides(): Record<string, unknown>;
+export declare function mergeConfigs(file: unknown, env: Record<string, unknown>, flags: Record<string, unknown>): unknown;
+export declare function deepMerge(base: unknown, override: unknown): unknown;
+export declare function mergeWithTestConfig(globalConfig: unknown, testConfig: unknown, flagOverrides: Record<string, unknown>): unknown;
+export declare function normalizeConfigForValidation(config: unknown): unknown;
+export declare function mergeUseBlocks(globalUse: Record<string, unknown> | undefined, suiteUse: Record<string, unknown> | undefined, testUse: Record<string, unknown> | undefined, cliFlags: Record<string, unknown>): Record<string, unknown>;
+export declare function formatConfigDebug(globalConfig: unknown, testConfig: unknown, flagOverrides: Record<string, unknown>, mask: MaskFn): string;
+export declare function readAnalyticsPrivacyDeclaration(configPath?: string): Promise<{
+  analytics: {
+    privacy: boolean;
+  };
 } | undefined>;
-declare function resolveConfig(options: {
-    configPath?: string;
-    flags?: Record<string, unknown>;
-    loadAuthPlugins?: boolean;
+export declare function resolveConfig(options: {
+  configPath?: string;
+  flags?: Record<string, unknown>;
+  loadAuthPlugins?: boolean;
 }): Promise<AgentQaConfig>;
-declare function loadConfigPlugins(config: AgentQaConfig, configPath: string): Promise<void>;
+export declare function loadConfigPlugins(config: AgentQaConfig, configPath: string): Promise<void>;
 /** Resolve the writer-gated knowledge root without making each CLI surface import core directly. */
-declare function resolveConfiguredKnowledgeRoot(config: AgentQaConfig, configDir: string): string;
-declare function resolveRawConfigKnowledgeRoot(config: Record<string, unknown> | null, configPath: string): string | null;
-
-interface ResolvedTarget {
-    name: string;
-    product: string;
-    platform: 'web' | 'android' | 'ios';
-    url?: string;
-    bundleId?: string;
-    appPackage?: string;
-    appActivity?: string;
-    device?: string;
-    environment?: 'local' | 'shared' | 'production';
+export declare function resolveConfiguredKnowledgeRoot(config: AgentQaConfig, configDir: string): string;
+export declare function resolveRawConfigKnowledgeRoot(config: Record<string, unknown> | null, configPath: string): string | null;
+export interface ResolvedTarget {
+  name: string;
+  product: string;
+  platform: 'web' | 'android' | 'ios';
+  url?: string;
+  bundleId?: string;
+  appPackage?: string;
+  appActivity?: string;
+  device?: string;
+  environment?: 'local' | 'shared' | 'production';
 }
-interface TargetSummary {
-    name: string;
-    platform: 'web' | 'android' | 'ios';
+export interface TargetSummary {
+  name: string;
+  platform: 'web' | 'android' | 'ios';
 }
-declare function resolveTarget(config: AgentQaConfig, targetName: string): ResolvedTarget;
-declare function listTargets(config: AgentQaConfig): TargetSummary[];
-
-declare function purgeAll(cacheDir: string): Promise<number>;
-
+export declare function resolveTarget(config: AgentQaConfig, targetName: string): ResolvedTarget;
+export declare function listTargets(config: AgentQaConfig): TargetSummary[];
+export declare function purgeAll(cacheDir: string): Promise<number>;
 /** Malformed-output retry cap; deliberately not a user-facing config key. */
-declare const CURATOR_RETRY_CAP = 2;
+export declare const CURATOR_RETRY_CAP = 2;
 /** Neighbor presentation cap; deliberately not a user-facing config key. */
-declare const CURATOR_MAX_NEIGHBORS = 12;
+export declare const CURATOR_MAX_NEIGHBORS = 12;
 interface BuildCuratorAuthorDependencies {
-    /** The run's already-resolved registry profile. It is reused verbatim. */
-    profile: ModelProfile;
-    auth: ResolvedModelAuth;
-    mask: MaskFn;
-    createModelImpl?: typeof createModel;
-    resolveCapabilitiesImpl?: typeof resolveCapabilities;
-    createTokenAccountingImpl?: typeof createTokenAccounting;
-    signal?: AbortSignal;
+  /** The run's already-resolved registry profile. It is reused verbatim. */
+  profile: ModelProfile;
+  auth: ResolvedModelAuth;
+  mask: MaskFn;
+  createModelImpl?: typeof createModel;
+  resolveCapabilitiesImpl?: typeof resolveCapabilities;
+  createTokenAccountingImpl?: typeof createTokenAccounting;
+  signal?: AbortSignal;
 }
 /**
  * Build the CLI-owned Curator author over the run's already-resolved model. The returned function
  * reads no config and every provider call therefore traverses createModel's registry middleware.
  */
-declare function buildCuratorAuthor(deps: BuildCuratorAuthorDependencies): CuratorAuthor;
-
+export declare function buildCuratorAuthor(deps: BuildCuratorAuthorDependencies): CuratorAuthor;
 declare const nudgeResponseSchema: z.ZodObject<{
-    sessionId: z.ZodString;
+  sessionId: z.ZodUUID;
 }, z.core.$strict>;
 type NudgeResponse = z.infer<typeof nudgeResponseSchema>;
-
 interface NudgeDaemonOptions {
-    /** Resolved configured root; defaults only for legacy project-local callers. */
-    readonly knowledgeRoot?: string;
-    /** Absolute wall-clock deadline shared with the caller's complete operation. */
-    readonly deadlineMs?: number;
-    /** Request an empty terminal receipt when the caller gates completion on it. */
-    readonly requireReceipt?: boolean;
-    readonly signal?: AbortSignal;
+  /** Resolved configured root; defaults only for legacy project-local callers. */
+  readonly knowledgeRoot?: string;
+  /** Absolute wall-clock deadline shared with the caller's complete operation. */
+  readonly deadlineMs?: number;
+  /** Request an empty terminal receipt when the caller gates completion on it. */
+  readonly requireReceipt?: boolean;
+  readonly signal?: AbortSignal;
 }
 /** Best-effort curation wake-up returning the durable session identity when acknowledged. */
 declare function nudgeDaemon(agentQaRoot: string, options?: NudgeDaemonOptions): Promise<NudgeResponse | undefined>;
-
 interface CanaryCreditCounters {
-    rideAlongUncredited: number;
-    rerunExcluded: number;
-    nonSignal: Record<NonSignalClass, number>;
+  rideAlongUncredited: number;
+  rerunExcluded: number;
+  nonSignal: Record<NonSignalClass, number>;
 }
-
 type NonSignalClass = 'environment' | 'timeout' | 'flake';
 interface ProjectCanaryOutcomesInput {
-    handoff: CompletedRunHandoff;
-    artifact?: RunAnalysisArtifact;
-    resolveCandidateAnchors: (id: RecordId) => CandidateAnchorResolution;
+  handoff: CompletedRunHandoff;
+  artifact?: RunAnalysisArtifact;
+  resolveCandidateAnchors: (id: RecordId) => CandidateAnchorResolution;
 }
 type CandidateAnchorResolution = {
-    kind: 'resolved';
-    anchors: Anchor[];
+  kind: 'resolved';
+  anchors: Anchor[];
 } | {
-    kind: 'unresolved';
-    reason: 'not-found' | 'invalid' | 'lookup-error';
-    detail?: string;
+  kind: 'unresolved';
+  reason: 'not-found' | 'invalid' | 'lookup-error';
+  detail?: string;
 };
 type EmitCanaryOutcomeResult = {
-    kind: 'non-signal';
-    class: NonSignalClass;
+  kind: 'non-signal';
+  class: NonSignalClass;
 } | {
-    kind: 'emitted';
+  kind: 'emitted';
 } | {
-    kind: 'refused';
-    reason: 'emit-error';
+  kind: 'refused';
+  reason: 'emit-error';
 } | {
+  kind: 'unresolved';
+  reason: Extract<CandidateAnchorResolution, {
     kind: 'unresolved';
-    reason: Extract<CandidateAnchorResolution, {
-        kind: 'unresolved';
-    }>['reason'];
-    detail?: string;
+  }>['reason'];
+  detail?: string;
 };
 type EmitCanaryOutcomeDetail = {
-    benefit?: never;
-    candidateId?: never;
-    stepIndex?: never;
-    testId: string;
-    testIndex: number;
-    outcome: {
-        kind: 'rerun-excluded';
-    };
+  benefit?: never;
+  candidateId?: never;
+  stepIndex?: never;
+  testId: string;
+  testIndex: number;
+  outcome: {
+    kind: 'rerun-excluded';
+  };
 } | {
-    benefit: CanaryOutcome['benefit'];
-    candidateId: RecordId;
-    testId: string;
-    testIndex: number;
-    stepIndex: number;
-    outcome: EmitCanaryOutcomeResult;
+  benefit: CanaryOutcome['benefit'];
+  candidateId: RecordId;
+  testId: string;
+  testIndex: number;
+  stepIndex: number;
+  outcome: EmitCanaryOutcomeResult;
 };
 interface EmitCanaryOutcomeReport {
-    canary: CanaryCreditCounters;
+  canary: CanaryCreditCounters;
+  emitted: number;
+  refused: number;
+  unresolved: number;
+  procedure: {
     emitted: number;
     refused: number;
     unresolved: number;
-    procedure: {
-        emitted: number;
-        refused: number;
-        unresolved: number;
-    };
-    details: EmitCanaryOutcomeDetail[];
+  };
+  details: EmitCanaryOutcomeDetail[];
 }
 interface EmitCanaryOutcomesOptions {
-    handoff: CompletedRunHandoff;
-    /** Absolute agent-qa-knowledge root used for store lookup and durable queue emission. */
-    knowledgeRoot: string;
-    /** Absolute completed-run directory retained to keep the two post-verdict emit seams aligned. */
-    runDir: string;
-    emit: (outcome: CanaryOutcome) => void;
+  handoff: CompletedRunHandoff;
+  /** Absolute agent-qa-knowledge root used for store lookup and durable queue emission. */
+  knowledgeRoot: string;
+  /** Absolute completed-run directory retained to keep the two post-verdict emit seams aligned. */
+  runDir: string;
+  emit: (outcome: CanaryOutcome) => void;
 }
 /** Pure Pin-1 projection: identical handoff + canonical snapshot yields identical outcome bytes. */
-declare function projectCanaryOutcomes(input: ProjectCanaryOutcomesInput): CanaryOutcome[];
+export declare function projectCanaryOutcomes(input: ProjectCanaryOutcomesInput): CanaryOutcome[];
 /** Resolves anchors read-only, sets each benefit, then emits every attribution in isolation. */
-declare function emitCanaryOutcomes(opts: EmitCanaryOutcomesOptions): Promise<EmitCanaryOutcomeReport>;
-
+export declare function emitCanaryOutcomes(opts: EmitCanaryOutcomesOptions): Promise<EmitCanaryOutcomeReport>;
 interface EmitCurationCandidatesOptions {
-    handoff: CompletedRunHandoff;
-    /** Absolute completed-run directory containing runner-local's blobs/ subdirectory. */
-    runDir: string;
-    /** Absolute agent-qa-knowledge root that owns the durable queue. */
-    knowledgeRoot: string;
-    mask?: MaskFn;
+  handoff: CompletedRunHandoff;
+  /** Absolute completed-run directory containing runner-local's blobs/ subdirectory. */
+  runDir: string;
+  /** Absolute agent-qa-knowledge root that owns the durable queue. */
+  knowledgeRoot: string;
+  mask?: MaskFn;
 }
 type EmitCandidateOutcome = EnqueueCurationCandidateProjectionOutcome | {
-    kind: 'refused';
-    reason: 'artifact-io-error';
+  kind: 'refused';
+  reason: 'artifact-io-error';
 };
 interface EmitCandidateDetail {
-    candidateId?: string;
-    /** The projecting candidate's kind: per-kind outcome attribution from the report alone. */
-    kind: CurationCandidateProjection['kind'];
-    outcome: EmitCandidateOutcome;
+  candidateId?: string;
+  /** The projecting candidate's kind: per-kind outcome attribution from the report alone. */
+  kind: CurationCandidateProjection['kind'];
+  outcome: EmitCandidateOutcome;
 }
 interface EmitReport {
-    enqueued: number;
-    coalesced: number;
-    capExceeded: number;
-    refused: number;
-    details: EmitCandidateDetail[];
+  enqueued: number;
+  coalesced: number;
+  capExceeded: number;
+  refused: number;
+  details: EmitCandidateDetail[];
 }
 /**
  * Resolves runner-local artifact blobs and synchronously publishes each candidate in isolation.
  * Queue publication owns temp-write, fsync, cap enforcement, and atomic rename semantics.
  */
 declare function emitCurationCandidates(opts: EmitCurationCandidatesOptions): EmitReport;
-
 type RunCurationContext = {
-    readonly mask: MaskFn;
-    readonly knowledgeRoot: string;
+  readonly mask: MaskFn;
+  readonly knowledgeRoot: string;
 } | {
-    readonly handBack: string;
+  readonly handBack: string;
 };
 declare function resolveRunCurationContext(input: {
-    readonly agentQaRoot: string;
-    readonly runId: string;
-    readonly drainerKnowledgeRoot: string;
+  readonly agentQaRoot: string;
+  readonly runId: string;
+  readonly drainerKnowledgeRoot: string;
 }): Promise<RunCurationContext>;
-
-declare const CURATION_TAIL_RECEIPT_FILE = "curation-tail-receipt.json";
+export declare const CURATION_TAIL_RECEIPT_FILE = "curation-tail-receipt.json";
 /** The receipt's key set and stamp must match exactly; anything else refolds the run once. */
-declare const CURATION_TAIL_RECEIPT_SCHEMA_VERSION = 2;
+export declare const CURATION_TAIL_RECEIPT_SCHEMA_VERSION = 2;
 interface CurationTailReceipt {
-    /** Fixed successful membership; absent on handed-off receipts and when no validated snapshot was recorded. */
-    snapshot?: CurationSnapshot;
-    /** Counts recorded beside the snapshot. */
-    curated?: number;
-    deprecated?: number;
-    canary: CanaryCreditCounters;
-    schemaVersion: typeof CURATION_TAIL_RECEIPT_SCHEMA_VERSION;
-    runId: string;
-    handoffDigest: string;
-    projectionVersion: number;
-    drainKind: 'drained' | 'handed-off';
-    /** The standing writer that accepted the handoff; null when this run drained inline. */
-    handoffHolderPid: number | null;
-    /** Stable run-side provenance, ordered before the receipt bytes are committed. */
-    candidateIds: string[];
+  /** Fixed successful membership; absent on handed-off receipts and when no validated snapshot was recorded. */
+  snapshot?: CurationSnapshot;
+  /** Counts recorded beside the snapshot. */
+  curated?: number;
+  deprecated?: number;
+  canary: CanaryCreditCounters;
+  schemaVersion: typeof CURATION_TAIL_RECEIPT_SCHEMA_VERSION;
+  runId: string;
+  handoffDigest: string;
+  projectionVersion: number;
+  drainKind: 'drained' | 'handed-off';
+  /** The standing writer that accepted the handoff; null when this run drained inline. */
+  handoffHolderPid: number | null;
+  /** Stable run-side provenance, ordered before the receipt bytes are committed. */
+  candidateIds: string[];
 }
 type CurationTailModelDeps = Pick<BuildCuratorAuthorDependencies, 'profile' | 'auth'>;
 interface CurationTailLogger {
-    warn(message: string): void;
-    info?(message: string): void;
+  warn(message: string): void;
+  info?(message: string): void;
 }
 interface CurationTailOperations {
-    loadCompletedRunHandoff: typeof loadCompletedRunHandoff;
-    resolveKnowledgeRoot: typeof resolveKnowledgeRoot;
-    runSafetyScope: typeof runSafetyScope;
-    emitCurationCandidates: typeof emitCurationCandidates;
-    openKnowledgeReader(config: OpenServingKnowledgeReaderConfig): KnowledgeHintReader;
-    emitCanaryOutcomes: typeof emitCanaryOutcomes;
-    foldRunOutcomes: LocalCurationCapabilities['foldRunOutcomes'];
-    reconcileRunOutcomesProjection: LocalCurationCapabilities['reconcileRunOutcomesProjection'];
-    acquireWriterLease: LocalCurationCapabilities['maintenance']['acquireWriterLease'];
-    releaseLease: LocalCurationCapabilities['maintenance']['releaseLease'];
-    buildCuratorAuthor: typeof buildCuratorAuthor;
-    drainQueue: LocalCurationCapabilities['drainQueue'];
-    listCompletedRunDirs(agentQaRoot: string): string[];
-    readCurationTailReceipt(runDir: string): CurationTailReceipt | undefined;
-    writeCurationTailReceipt(runDir: string, receipt: CurationTailReceipt): void;
-    nudgeDaemon: typeof nudgeDaemon;
-    resolveRunCurationContext: typeof resolveRunCurationContext;
+  loadCompletedRunHandoff: typeof loadCompletedRunHandoff;
+  resolveKnowledgeRoot: typeof resolveKnowledgeRoot;
+  runSafetyScope: typeof runSafetyScope;
+  emitCurationCandidates: typeof emitCurationCandidates;
+  openKnowledgeReader(config: OpenServingKnowledgeReaderConfig): KnowledgeHintReader;
+  emitCanaryOutcomes: typeof emitCanaryOutcomes;
+  foldRunOutcomes: LocalCurationCapabilities['foldRunOutcomes'];
+  reconcileRunOutcomesProjection: LocalCurationCapabilities['reconcileRunOutcomesProjection'];
+  acquireWriterLease: LocalCurationCapabilities['maintenance']['acquireWriterLease'];
+  releaseLease: LocalCurationCapabilities['maintenance']['releaseLease'];
+  buildCuratorAuthor: typeof buildCuratorAuthor;
+  drainQueue: LocalCurationCapabilities['drainQueue'];
+  listCompletedRunDirs(agentQaRoot: string): string[];
+  readCurationTailReceipt(runDir: string): CurationTailReceipt | undefined;
+  writeCurationTailReceipt(runDir: string, receipt: CurationTailReceipt): void;
+  nudgeDaemon: typeof nudgeDaemon;
+  resolveRunCurationContext: typeof resolveRunCurationContext;
 }
 interface CurationWriterAuthority {
-    leaseId: string;
-    epoch: number;
+  leaseId: string;
+  epoch: number;
 }
 interface RunCurationTailOptions {
-    runId: string;
-    /** Absolute `.agent-qa` runtime root the run handoff lives under. */
-    agentQaRoot: string;
-    knowledgeConfig: {
-        dir: string;
-    };
-    configDir: string;
-    mask?: MaskFn;
-    /** The exact already-resolved planner profile and auth used by the run. */
-    modelDeps?: CurationTailModelDeps;
-    signal?: AbortSignal;
-    log: CurationTailLogger;
-    authority?: CurationWriterAuthority;
-    deadlineMs?: number;
-    /** Focused test seam. Production callers omit it. */
-    operations?: Partial<CurationTailOperations>;
+  runId: string;
+  /** Absolute `.agent-qa` runtime root the run handoff lives under. */
+  agentQaRoot: string;
+  knowledgeConfig: {
+    dir: string;
+  };
+  configDir: string;
+  mask?: MaskFn;
+  /** The exact already-resolved planner profile and auth used by the run. */
+  modelDeps?: CurationTailModelDeps;
+  signal?: AbortSignal;
+  log: CurationTailLogger;
+  authority?: CurationWriterAuthority;
+  deadlineMs?: number;
+  /** Focused test seam. Production callers omit it. */
+  operations?: Partial<CurationTailOperations>;
 }
-declare function curationTailHandoffDigest(handoff: unknown): string;
+export declare function curationTailHandoffDigest(handoff: unknown): string;
 /**
  * Run the post-verdict curation fold. The caller fixes its exit code before awaiting this function;
  * every failure is logged here and intentionally resolves so learning can never change the verdict.
  */
-declare function runCurationTail(opts: RunCurationTailOptions): Promise<void>;
+export declare function runCurationTail(opts: RunCurationTailOptions): Promise<void>;
 interface RunVerdictFirstCurationTailOptions {
-    /** The complete verdict-derived process code, fixed before the tail begins. */
-    exitCode: number;
-    detach: boolean;
-    enqueue?(): Promise<void>;
-    runTail(): Promise<void>;
-    finish?(input: {
-        detached: boolean;
-    }): Promise<void>;
-    /** Defensive call-site boundary; runCurationTail itself already never rejects. */
-    onUnexpectedError?(error: unknown): void;
+  /** The complete verdict-derived process code, fixed before the tail begins. */
+  exitCode: number;
+  detach: boolean;
+  enqueue?(): Promise<void>;
+  runTail(): Promise<void>;
+  finish?(input: {
+    detached: boolean;
+  }): Promise<void>;
+  /** Defensive call-site boundary; runCurationTail itself already never rejects. */
+  onUnexpectedError?(error: unknown): void;
 }
 /** Await the optional tail without permitting it to replace the already-fixed verdict code. */
-declare function runVerdictFirstCurationTail(opts: RunVerdictFirstCurationTailOptions): Promise<number>;
-
-declare const VERSION: string;
-
-export { type BuildCuratorAuthorDependencies, CURATION_TAIL_RECEIPT_FILE, CURATION_TAIL_RECEIPT_SCHEMA_VERSION, CURATOR_MAX_NEIGHBORS, CURATOR_RETRY_CAP, ConfigFileNotFoundError, ConfigFileNotYamlError, type CurationTailLogger, type CurationTailModelDeps, type CurationTailOperations, type CurationTailReceipt, type EmitCanaryOutcomeDetail, type EmitCanaryOutcomeReport, type EmitCanaryOutcomeResult, type EmitCanaryOutcomesOptions, type ProjectCanaryOutcomesInput, type ResolvedTarget, type RunCurationTailOptions, type RunVerdictFirstCurationTailOptions, type TargetSummary, VERSION, buildCuratorAuthor, curationTailHandoffDigest, deepMerge, emitCanaryOutcomes, formatConfigDebug, listTargets, loadConfigFile, loadConfigPlugins, loadEnvOverrides, loadRequiredConfigFile, mergeConfigs, mergeUseBlocks, mergeWithTestConfig, normalizeConfigForValidation, projectCanaryOutcomes, purgeAll, readAnalyticsPrivacyDeclaration, resolveConfig, resolveConfiguredKnowledgeRoot, resolveRawConfigKnowledgeRoot, resolveTarget, runCurationTail, runVerdictFirstCurationTail };
+export declare function runVerdictFirstCurationTail(opts: RunVerdictFirstCurationTailOptions): Promise<number>;
+export declare const VERSION: string;
+export type { BuildCuratorAuthorDependencies, CurationTailLogger, CurationTailModelDeps, CurationTailOperations, CurationTailReceipt, EmitCanaryOutcomeDetail, EmitCanaryOutcomeReport, EmitCanaryOutcomeResult, EmitCanaryOutcomesOptions, ProjectCanaryOutcomesInput, RunCurationTailOptions, RunVerdictFirstCurationTailOptions };