@cleocode/contracts 2026.5.61 → 2026.5.62

package/dist/tasks.d.ts

@@ -18,8 +18,6 @@ import type { TaskPriority, TaskStatus } from './task.js';
 /**
  * RCASD-IVTR+C pipeline stage values valid for `TaskView.pipelineStage`.
  *
- * Mirrors `TaskViewPipelineStage` from `packages/core/src/tasks/compute-task-view.ts`.
- *
  * @task T1703
  */
 export type TaskViewPipelineStage = 'research' | 'specification' | 'decomposition' | 'implementation' | 'validation' | 'testing' | 'release' | 'contribution';

package/dist/tasks.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.5.61",
+  "version": "2026.5.62",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -82,7 +82,7 @@
   "dependencies": {
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2",
-    "@cleocode/lafs": "2026.5.61"
+    "@cleocode/lafs": "2026.5.62"
   },
   "scripts": {
     "build": "tsc -b --force && node scripts/emit-schemas.mjs",

package/src/__tests__/nexus-scope-map.test.ts

@@ -0,0 +1,183 @@
+/**
+ * Unit tests for NEXUS_SCOPE_MAP SSoT helpers and ConfidenceProvenance
+ * discriminated union utilities (T9145).
+ *
+ * @task T9145
+ */
+
+import { describe, expect, it } from 'vitest';
+import { confidenceFromProvenance, provenanceFromNumeric } from '../graph.js';
+import type { NexusOps } from '../operations/nexus.js';
+import {
+  getNexusDescriptor,
+  listOpsByScope,
+  NEXUS_SCOPE_MAP,
+} from '../operations/nexus-scope-map.js';
+
+// ---------------------------------------------------------------------------
+// NEXUS_SCOPE_MAP completeness
+// ---------------------------------------------------------------------------
+
+describe('NEXUS_SCOPE_MAP completeness', () => {
+  it('contains an entry for every NexusOps key (exhaustiveness check)', () => {
+    // This test verifies the compile-time check also holds at runtime.
+    // If the TypeScript exhaustiveness check passes, this test is redundant,
+    // but it makes the intent explicit for CI reviewers.
+    const keys = Object.keys(NEXUS_SCOPE_MAP) as Array<keyof NexusOps>;
+    expect(keys.length).toBeGreaterThan(50);
+  });
+
+  it('every descriptor has a non-empty description', () => {
+    for (const [key, desc] of Object.entries(NEXUS_SCOPE_MAP)) {
+      expect(
+        desc.description.length,
+        `NEXUS_SCOPE_MAP['${key}'].description must be non-empty`,
+      ).toBeGreaterThan(0);
+    }
+  });
+
+  it('every descriptor has a valid scope', () => {
+    const validScopes = new Set(['project', 'living-brain', 'cross', 'hybrid', 'global']);
+    for (const [key, desc] of Object.entries(NEXUS_SCOPE_MAP)) {
+      expect(
+        validScopes.has(desc.scope),
+        `NEXUS_SCOPE_MAP['${key}'].scope '${desc.scope}' is not a valid NexusScope`,
+      ).toBe(true);
+    }
+  });
+
+  it('every descriptor has a valid effect', () => {
+    const validEffects = new Set(['read', 'write', 'admin']);
+    for (const [key, desc] of Object.entries(NEXUS_SCOPE_MAP)) {
+      expect(
+        validEffects.has(desc.effect),
+        `NEXUS_SCOPE_MAP['${key}'].effect '${desc.effect}' is not a valid NexusEffect`,
+      ).toBe(true);
+    }
+  });
+
+  it('global-scope ops do not require a project', () => {
+    for (const [key, desc] of Object.entries(NEXUS_SCOPE_MAP)) {
+      if (desc.scope === 'global') {
+        expect(
+          desc.requiresProject,
+          `NEXUS_SCOPE_MAP['${key}'] has scope=global but requiresProject=true`,
+        ).toBe(false);
+      }
+    }
+  });
+});
+
+// ---------------------------------------------------------------------------
+// getNexusDescriptor helper
+// ---------------------------------------------------------------------------
+
+describe('getNexusDescriptor', () => {
+  it('returns the correct descriptor for a known op', () => {
+    const desc = getNexusDescriptor('status');
+    expect(desc.op).toBe('status');
+    expect(desc.scope).toBe('project');
+    expect(desc.effect).toBe('read');
+  });
+
+  it('returns the correct descriptor for a global op', () => {
+    const desc = getNexusDescriptor('register');
+    expect(desc.scope).toBe('global');
+    expect(desc.effect).toBe('admin');
+    expect(desc.requiresProject).toBe(false);
+  });
+
+  it('returns the correct descriptor for a hybrid op', () => {
+    const desc = getNexusDescriptor('brain-anchors');
+    expect(desc.scope).toBe('hybrid');
+    expect(desc.stores).toContain('brain');
+    expect(desc.stores).toContain('nexus-graph');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// listOpsByScope helper
+// ---------------------------------------------------------------------------
+
+describe('listOpsByScope', () => {
+  it('returns only project-scope ops when filtering by project', () => {
+    const ops = listOpsByScope('project');
+    expect(ops.length).toBeGreaterThan(10);
+    for (const op of ops) {
+      expect(NEXUS_SCOPE_MAP[op].scope).toBe('project');
+    }
+  });
+
+  it('returns only global-scope ops when filtering by global', () => {
+    const ops = listOpsByScope('global');
+    expect(ops.length).toBeGreaterThan(0);
+    for (const op of ops) {
+      expect(NEXUS_SCOPE_MAP[op].scope).toBe('global');
+    }
+  });
+
+  it('returns hybrid ops including brain-anchors', () => {
+    const ops = listOpsByScope('hybrid');
+    expect(ops).toContain('brain-anchors');
+  });
+
+  it('returns living-brain ops including profile.view', () => {
+    const ops = listOpsByScope('living-brain');
+    expect(ops).toContain('profile.view');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// ConfidenceProvenance helpers
+// ---------------------------------------------------------------------------
+
+describe('provenanceFromNumeric', () => {
+  it('maps confidence=1.0 to extracted+ast', () => {
+    const p = provenanceFromNumeric(1.0);
+    expect(p.kind).toBe('extracted');
+    if (p.kind === 'extracted') expect(p.source).toBe('ast');
+  });
+
+  it('maps confidence=0.95 to extracted+legacy', () => {
+    const p = provenanceFromNumeric(0.95);
+    expect(p.kind).toBe('extracted');
+    if (p.kind === 'extracted') expect(p.source).toBe('legacy');
+  });
+
+  it('maps confidence=0.85 to inferred+legacy', () => {
+    const p = provenanceFromNumeric(0.85);
+    expect(p.kind).toBe('inferred');
+    if (p.kind === 'inferred') expect(p.heuristic).toBe('legacy');
+  });
+
+  it('maps confidence=0.5 to ambiguous with empty candidates', () => {
+    const p = provenanceFromNumeric(0.5);
+    expect(p.kind).toBe('ambiguous');
+    if (p.kind === 'ambiguous') expect(p.candidates).toHaveLength(0);
+  });
+});
+
+describe('confidenceFromProvenance', () => {
+  it('extracted+ast → 1.0', () => {
+    expect(confidenceFromProvenance({ kind: 'extracted', source: 'ast' })).toBe(1.0);
+  });
+
+  it('extracted+legacy → 0.95', () => {
+    expect(confidenceFromProvenance({ kind: 'extracted', source: 'legacy' })).toBe(0.95);
+  });
+
+  it('inferred → 0.85', () => {
+    expect(confidenceFromProvenance({ kind: 'inferred', heuristic: 'heritage-map' })).toBe(0.85);
+  });
+
+  it('ambiguous → 0.5', () => {
+    expect(confidenceFromProvenance({ kind: 'ambiguous', candidates: ['a', 'b'] })).toBe(0.5);
+  });
+
+  it('round-trips cleanly for all three tiers', () => {
+    for (const confidence of [1.0, 0.95, 0.85, 0.5]) {
+      const recovered = confidenceFromProvenance(provenanceFromNumeric(confidence));
+      expect(recovered).toBe(confidence);
+    }
+  });
+});

package/src/branch-lock.ts

@@ -281,6 +281,17 @@ export const BRANCH_LOCK_ERROR_CODES = {
    * the git-shim which only intercepts `git` binary calls.
    */
   E_BOUNDARY_VIOLATION: 'E_BOUNDARY_VIOLATION',
+  /**
+   * T1927: the `task/<taskId>` branch already exists and contains commits that
+   * are NOT reachable from the current integration base (i.e. orphan history from
+   * a prior test fixture, aborted session, or unrelated spawn). Reusing such a
+   * branch would import garbage history on merge.
+   *
+   * Fix: delete the branch manually (`git branch -D task/<taskId>`) then
+   * re-run spawn, or pass `{ forceReset: true }` to `createWorktree` to have it
+   * reset the branch automatically.
+   */
+  E_DIRTY_BRANCH: 'E_DIRTY_BRANCH',
 } as const;
 
 /** Union of all branch-lock error code strings. */

package/src/config.ts

@@ -505,6 +505,28 @@ export interface CleoConfig {
    * @task T1828
    */
   decisions?: DecisionsConfig;
+  /**
+   * Briefing pipeline settings (T1904 / BBTT-W2-3).
+   *
+   * @defaultValue undefined
+   */
+  briefing?: BriefingConfig;
+}
+
+/**
+ * Configuration for the `cleo briefing` pipeline (T1904 / BBTT-W2-3).
+ */
+export interface BriefingConfig {
+  /**
+   * Whether `cleo briefing` opportunistically triggers a dream cycle after
+   * computing the briefing response.
+   *
+   * The dream cycle is always subject to its own 5-minute cooldown guard and
+   * never blocks the briefing response.
+   *
+   * @defaultValue true
+   */
+  opportunisticDream?: boolean;
 }
 
 /**

package/src/data-accessor.ts

@@ -179,6 +179,9 @@ export interface DataAccessor {
     reason?: string,
   ): Promise<void>;
 
+  /** Remove a row from the task_relations table (T9240). */
+  removeRelation(taskId: string, relatedTo: string, relationType?: string): Promise<void>;
+
   // ---- Metadata (schema_meta KV store) ----
 
   /** Read a typed value from the metadata store. Returns null if not found. */

package/src/engine-result.ts

@@ -0,0 +1,220 @@
+/**
+ * Canonical EngineResult type — the single discriminated-union shape used by
+ * all SDK return paths, dispatch engines, and CLI domain handlers.
+ *
+ * Defined here in @cleocode/contracts so it is available to every consumer
+ * without creating a dependency on @cleocode/core. @cleocode/core re-exports
+ * these types and helpers transparently.
+ *
+ * @epic T1685 — T-CSL-RESET Wave 1: EngineResult canonicalization
+ */
+
+import type { LAFSPage } from '@cleocode/lafs';
+
+// ---------------------------------------------------------------------------
+// RFC 9457 Problem Details — canonical definition (moved from core/errors.ts)
+// ---------------------------------------------------------------------------
+
+/**
+ * RFC 9457 Problem Details object.
+ * Structured error representation for API responses.
+ *
+ * @see https://www.rfc-editor.org/rfc/rfc9457
+ */
+export interface ProblemDetails {
+  /** URI reference identifying the problem type. */
+  type: string;
+  /** Short human-readable summary of the problem type. */
+  title: string;
+  /** HTTP status code. */
+  status: number;
+  /** Human-readable explanation specific to this occurrence. */
+  detail: string;
+  /** URI reference identifying the specific problem instance. */
+  instance?: string;
+  /** Extension members carrying additional problem information. */
+  extensions?: Record<string, unknown>;
+}
+
+// ---------------------------------------------------------------------------
+// EngineResult — discriminated union
+// ---------------------------------------------------------------------------
+
+/**
+ * Successful engine result branch — carries `data` and optional `page`.
+ *
+ * @task T1685 — canonical home moved to contracts
+ */
+export interface EngineSuccess<T = unknown> {
+  readonly success: true;
+  readonly data: T;
+  readonly page?: LAFSPage;
+}
+
+/**
+ * Structured engine error payload — carries machine-readable code + human
+ * message plus optional exitCode, details, fix hint, alternative actions,
+ * and RFC 9457 problem details.
+ *
+ * @task T1707 — problemDetails field
+ * @task T1685 — canonical home moved to contracts
+ */
+export interface EngineErrorPayload {
+  code: string;
+  message: string;
+  exitCode?: number;
+  details?: unknown;
+  fix?: string;
+  alternatives?: Array<{ action: string; command: string }>;
+  /**
+   * RFC 9457 problem details for structured error reporting.
+   *
+   * @see ProblemDetails
+   */
+  problemDetails?: ProblemDetails;
+}
+
+/**
+ * Failed engine result branch — carries structured `error`.
+ *
+ * @task T1685 — canonical home moved to contracts
+ */
+export interface EngineFailure {
+  readonly success: false;
+  readonly error: EngineErrorPayload;
+}
+
+/**
+ * Canonical EngineResult — discriminated union of success and failure.
+ *
+ * Use `result.success` to narrow:
+ * - `true`  → `result.data: T` is present; `result.error` does not exist
+ * - `false` → `result.error: EngineErrorPayload` is present; `result.data` does not exist
+ *
+ * @task T1685 — canonical home moved to contracts
+ */
+export type EngineResult<T = unknown> = EngineSuccess<T> | EngineFailure;
+
+// ---------------------------------------------------------------------------
+// Constructors
+// ---------------------------------------------------------------------------
+
+/**
+ * Construct a successful EngineResult.
+ *
+ * @param data - the operation's payload
+ * @param page - optional pagination metadata
+ *
+ * @example
+ * ```ts
+ * import { engineSuccess } from '@cleocode/contracts';
+ * return engineSuccess({ items: [], total: 0 });
+ * return engineSuccess(items, { mode: 'offset', limit: 10, offset: 0, total: 100, hasMore: true });
+ * ```
+ */
+export function engineSuccess<T>(data: T, page?: LAFSPage): EngineResult<T> {
+  return page ? { success: true, data, page } : { success: true, data };
+}
+
+/**
+ * Construct a failed EngineResult with structured error.
+ *
+ * @param code - stable machine-readable error code (e.g. `'E_NOT_FOUND'`)
+ * @param message - human-readable error description
+ * @param options - optional `exitCode`, `details`, `fix`, `alternatives`, `problemDetails`
+ *
+ * @example
+ * ```ts
+ * import { engineError } from '@cleocode/contracts';
+ * return engineError('E_NOT_FOUND', `Task ${id} not found`, { fix: `cleo show ${id}` });
+ * ```
+ */
+export function engineError<T = unknown>(
+  code: string,
+  message: string,
+  options?: {
+    exitCode?: number;
+    details?: unknown;
+    fix?: string;
+    alternatives?: Array<{ action: string; command: string }>;
+    problemDetails?: ProblemDetails;
+  },
+): EngineResult<T> {
+  return {
+    success: false,
+    error: {
+      code,
+      message,
+      ...(options?.exitCode !== undefined ? { exitCode: options.exitCode } : {}),
+      ...(options?.details !== undefined ? { details: options.details } : {}),
+      ...(options?.fix !== undefined ? { fix: options.fix } : {}),
+      ...(options?.alternatives ? { alternatives: options.alternatives } : {}),
+      ...(options?.problemDetails !== undefined ? { problemDetails: options.problemDetails } : {}),
+    },
+  };
+}
+
+// ---------------------------------------------------------------------------
+// unwrap() — throw-style ergonomic helper for SDK consumers
+// ---------------------------------------------------------------------------
+
+/**
+ * Error thrown by {@link unwrap} when an {@link EngineResult} carries a
+ * failure. Preserves the full {@link EngineErrorPayload} shape so callers
+ * can inspect `code`, `message`, `exitCode`, `details`, `fix`,
+ * `alternatives`, and `problemDetails` after catching.
+ *
+ * @task T1725
+ */
+export class EngineResultError extends Error {
+  /** Machine-readable error code (e.g. `'E_NOT_FOUND'`). */
+  readonly code: string;
+  /** Numeric process exit code, if present. */
+  readonly exitCode?: number;
+  /** Structured field-level details, if present. */
+  readonly details?: unknown;
+  /** Human-readable fix hint, if present. */
+  readonly fix?: string;
+  /** Alternative actions the caller may take, if present. */
+  readonly alternatives?: Array<{ action: string; command: string }>;
+  /** RFC 9457 problem details, if present. */
+  readonly problemDetails?: ProblemDetails;
+
+  constructor(payload: EngineErrorPayload) {
+    super(payload.message);
+    this.name = 'EngineResultError';
+    this.code = payload.code;
+    if (payload.exitCode !== undefined) this.exitCode = payload.exitCode;
+    if (payload.details !== undefined) this.details = payload.details;
+    if (payload.fix !== undefined) this.fix = payload.fix;
+    if (payload.alternatives !== undefined) this.alternatives = payload.alternatives;
+    if (payload.problemDetails !== undefined) this.problemDetails = payload.problemDetails;
+  }
+}
+
+/**
+ * Unwrap an {@link EngineResult}, returning the payload data on success or
+ * throwing an {@link EngineResultError} on failure.
+ *
+ * Intended for public SDK consumers who prefer a throw-style API over the
+ * internal discriminated-union pattern. Internal dispatch code SHOULD
+ * continue using the `if (result.success)` pattern directly.
+ *
+ * @param result - an {@link EngineResult} to unwrap
+ * @returns the `data` value when `result.success` is `true`
+ * @throws {@link EngineResultError} when `result.success` is `false`
+ *
+ * @example
+ * ```ts
+ * import { unwrap } from '@cleocode/contracts';
+ * const task = unwrap(await engine.getTask(id));
+ * ```
+ *
+ * @task T1725
+ */
+export function unwrap<T>(result: EngineResult<T>): T {
+  if (result.success) {
+    return result.data;
+  }
+  throw new EngineResultError(result.error);
+}

package/src/errors.ts

@@ -199,6 +199,40 @@ export class DecisionValidatorFailedError extends Error {
   }
 }
 
+/**
+ * Thrown when a Lead session attempts to end without delegating any work.
+ *
+ * Hard gate enforcement for T9230 (ADR-070): a Lead session with
+ * `delegate_task_count=0` and `tasks_completed > 0` is a bypass attempt.
+ * Leads MUST fan out work to Workers via `delegate_task`.
+ *
+ * @codeName E_LEAD_BYPASS_DETECTED
+ * @task T9230
+ * @adr ADR-070
+ */
+export class LeadBypassDetectedError extends Error {
+  /** Stable LAFS error code string for envelope emission. */
+  readonly code = 'E_LEAD_BYPASS_DETECTED';
+  /** Numeric exit code aligned with {@link ExitCode.LEAD_BYPASS_DETECTED} (107). */
+  readonly exitCode = 107;
+
+  /**
+   * @param tasksCompleted - Number of tasks completed in the session.
+   * @param sessionId - The session ID being ended.
+   */
+  constructor(
+    public readonly tasksCompleted: number,
+    public readonly sessionId: string,
+  ) {
+    super(
+      `E_LEAD_BYPASS_DETECTED: Lead session ${sessionId} completed ${tasksCompleted} task(s) ` +
+        `without any delegate_task call. Leads MUST fan out work to Workers (T9230 / ADR-070). ` +
+        `Set CLEO_OWNER_OVERRIDE=1 with reason to override (audited).`,
+    );
+    this.name = 'LeadBypassDetectedError';
+  }
+}
+
 /**
  * Normalize any thrown value into a standardized error object.
  *

package/src/exit-codes.ts

@@ -216,6 +216,14 @@ export enum ExitCode {
    * @task T1828
    */
   DECISION_VALIDATOR_FAILED = 106,
+
+  /**
+   * Lead session attempted to end without delegating any work — `delegate_task_count=0`
+   * with `tasks_completed > 0`. Leads MUST fan out to Workers (T9230 / ADR-070).
+   * @codeName E_LEAD_BYPASS_DETECTED
+   * @task T9230
+   */
+  LEAD_BYPASS_DETECTED = 107,
 }
 
 /** Check if an exit code represents an error (1-99). */

package/src/graph.ts

@@ -204,6 +204,118 @@ export function confidenceLabelFromNumeric(confidence: number): GraphEdgeConfide
   return 'AMBIGUOUS';
 }
 
+// ---------------------------------------------------------------------------
+// ConfidenceProvenance — structured provenance for confidence scores
+// ---------------------------------------------------------------------------
+
+/**
+ * Structured provenance for an EXTRACTED confidence assignment.
+ *
+ * Used when confidence was derived from direct AST evidence (same-file
+ * lookup, import-scoped resolution) or an explicit source annotation.
+ *
+ * @since T9145
+ */
+export interface ExtractedProvenance {
+  /** Discriminant. */
+  readonly kind: 'extracted';
+  /**
+   * AST / static-analysis source that produced this confidence value.
+   * Examples: `"ast"`, `"import-scope"`, `"same-file"`, `"defines"`.
+   */
+  readonly source: string;
+}
+
+/**
+ * Structured provenance for an INFERRED confidence assignment.
+ *
+ * Used when confidence was derived from resolution heuristics (cross-file
+ * type lookup, heritage-map inference, name matching).
+ *
+ * @since T9145
+ */
+export interface InferredProvenance {
+  /** Discriminant. */
+  readonly kind: 'inferred';
+  /**
+   * Heuristic or rule that produced this confidence value.
+   * Examples: `"heritage-map"`, `"name-match"`, `"global-tier"`.
+   */
+  readonly heuristic: string;
+}
+
+/**
+ * Structured provenance for an AMBIGUOUS confidence assignment.
+ *
+ * Used when confidence is low because multiple candidates were found,
+ * the parent is external / unresolvable, or resolution fell to a global stub.
+ *
+ * @since T9145
+ */
+export interface AmbiguousProvenance {
+  /** Discriminant. */
+  readonly kind: 'ambiguous';
+  /**
+   * Candidate node IDs that competed for this resolution slot.
+   * May be empty when the ambiguity is due to an unresolvable external type.
+   */
+  readonly candidates: ReadonlyArray<string>;
+}
+
+/**
+ * Discriminated union of structured confidence provenance variants.
+ *
+ * Replaces the bare numeric `confidence` field on {@link GraphRelation} as
+ * part of the Beta gradient deprecation (phase 0: addition, phase 1:
+ * co-existence, removal at v2026.9).
+ *
+ * **Backfill mapping** for existing records created without structured
+ * provenance:
+ * - `confidence === 1.0` → `{ kind: 'extracted', source: 'ast' }`
+ * - `confidence >= 0.90` → `{ kind: 'extracted', source: 'legacy' }`
+ * - `confidence >= 0.80` → `{ kind: 'inferred', heuristic: 'legacy' }`
+ * - `confidence < 0.80`  → `{ kind: 'ambiguous', candidates: [] }`
+ *
+ * @since T9145
+ * @deprecated Numeric `confidence` on {@link GraphRelation} will be removed in v2026.9.
+ *   Use `confidenceProvenance` instead. Migration: `confidenceFromProvenance()` maps back.
+ */
+export type ConfidenceProvenance = ExtractedProvenance | InferredProvenance | AmbiguousProvenance;
+
+/**
+ * Backfill a {@link ConfidenceProvenance} from a legacy numeric confidence value.
+ *
+ * @param confidence - Numeric confidence in range [0.0, 1.0]
+ * @returns A structured provenance record consistent with the numeric value
+ * @since T9145
+ */
+export function provenanceFromNumeric(confidence: number): ConfidenceProvenance {
+  if (confidence === 1.0) return { kind: 'extracted', source: 'ast' };
+  if (confidence >= 0.9) return { kind: 'extracted', source: 'legacy' };
+  if (confidence >= 0.8) return { kind: 'inferred', heuristic: 'legacy' };
+  return { kind: 'ambiguous', candidates: [] };
+}
+
+/**
+ * Recover a numeric confidence value from a {@link ConfidenceProvenance} record.
+ *
+ * Inverse of {@link provenanceFromNumeric} for backward-compat bridging.
+ *
+ * @param provenance - Structured provenance record
+ * @returns Best-effort numeric confidence in range [0.0, 1.0]
+ * @since T9145
+ */
+export function confidenceFromProvenance(provenance: ConfidenceProvenance): number {
+  switch (provenance.kind) {
+    case 'extracted':
+      return provenance.source === 'ast' ? 1.0 : 0.95;
+    case 'inferred':
+      return 0.85;
+    case 'ambiguous':
+      return 0.5;
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Relation interface
 // ---------------------------------------------------------------------------