@cleocode/contracts 2026.5.61 → 2026.5.63

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":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM1D;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,SAAS,GACT,SAAS,GACT,cAAc,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,mBAAmB,GACnB,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,yDAAyD;IACzD,WAAW,EAAE,mBAAmB,CAAC;IACjC;;;OAGG;IACH,WAAW,EAAE,mBAAmB,CAAC;IACjC;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,kDAAkD;IAClD,QAAQ,EAAE,YAAY,CAAC;IACvB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,iCAAiC;IACjC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,qCAAqC;IACrC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sBAAsB;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,kCAAkC;IAClC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.5.61",
+  "version": "2026.5.63",
   "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.63"
   },
   "scripts": {
     "build": "tsc -b --force && node scripts/emit-schemas.mjs",

package/src/__tests__/llm-config-schema.test.ts

@@ -0,0 +1,135 @@
+/**
+ * Schema roundtrip tests for the extended `LlmConfig` shape.
+ *
+ * Asserts that:
+ *
+ * 1. A literal `LlmConfig` object containing the new `default`, `roles`, and
+ *    the legacy `daemon` fields typechecks and survives a JSON
+ *    serialize/deserialize cycle without structural loss.
+ * 2. All five `RoleName` values (`extraction`, `consolidation`, `derivation`,
+ *    `hygiene`, `judgement`) are accepted as keys of `roles`.
+ * 3. Omitting `default` and/or `roles` still typechecks (both are optional).
+ *
+ * These tests guard the Phase 2 schema extension of
+ * T-LLM-CRED-CENTRALIZATION against accidental regressions.
+ *
+ * @task T9256
+ * @epic T-LLM-CRED-CENTRALIZATION
+ */
+
+import { describe, expect, it } from 'vitest';
+import type { LlmConfig, LlmDefaultConfig, LlmRoleConfig, RoleName } from '../config.js';
+
+describe('LlmConfig — Phase 2 schema extension (T9256)', () => {
+  it('accepts a fully-populated config with default, roles, and legacy daemon', () => {
+    const cfg: LlmConfig = {
+      daemon: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
+      providers: {
+        anthropic: { apiKey: 'sk-test-anthropic' },
+        openai: { apiKey: 'sk-test-openai' },
+      },
+      default: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
+      roles: {
+        extraction: {
+          provider: 'anthropic',
+          model: 'claude-haiku-4-5',
+          credentialLabel: 'ext-key',
+        },
+        consolidation: {
+          provider: 'openai',
+          model: 'gpt-4o',
+        },
+        derivation: {
+          provider: 'gemini',
+          model: 'gemini-2.5-pro',
+        },
+        hygiene: {
+          provider: 'moonshot',
+          model: 'kimi-k2',
+        },
+        judgement: {
+          provider: 'anthropic',
+          model: 'claude-opus-4-7',
+          credentialLabel: 'judge-key',
+        },
+      },
+    };
+
+    const roundtripped: LlmConfig = JSON.parse(JSON.stringify(cfg));
+    expect(roundtripped).toEqual(cfg);
+  });
+
+  it('preserves structural identity across JSON serialize/deserialize', () => {
+    const cfg: LlmConfig = {
+      default: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
+      roles: {
+        extraction: { provider: 'anthropic', model: 'claude-haiku-4-5' },
+      },
+    };
+
+    const serialized = JSON.stringify(cfg);
+    const parsed = JSON.parse(serialized) as LlmConfig;
+
+    expect(parsed.default).toEqual(cfg.default);
+    expect(parsed.roles).toEqual(cfg.roles);
+    expect(parsed.roles?.extraction?.provider).toBe('anthropic');
+    expect(parsed.roles?.extraction?.model).toBe('claude-haiku-4-5');
+  });
+
+  it('accepts all five RoleName values as keys of roles', () => {
+    const roleNames: readonly RoleName[] = [
+      'extraction',
+      'consolidation',
+      'derivation',
+      'hygiene',
+      'judgement',
+    ] as const;
+
+    // Build a `roles` map populated with one entry per role name. The TS
+    // compiler enforces that only valid `RoleName` keys appear here — any
+    // typo would be a compile-time error.
+    const roles: Partial<Record<RoleName, LlmRoleConfig>> = {};
+    for (const name of roleNames) {
+      roles[name] = { provider: 'anthropic', model: 'claude-sonnet-4-6' };
+    }
+
+    const cfg: LlmConfig = { roles };
+    expect(Object.keys(cfg.roles ?? {})).toHaveLength(5);
+    for (const name of roleNames) {
+      expect(cfg.roles?.[name]?.provider).toBe('anthropic');
+      expect(cfg.roles?.[name]?.model).toBe('claude-sonnet-4-6');
+    }
+  });
+
+  it('typechecks when default and roles are both omitted', () => {
+    const cfg: LlmConfig = {
+      daemon: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
+    };
+
+    expect(cfg.default).toBeUndefined();
+    expect(cfg.roles).toBeUndefined();
+    expect(cfg.daemon?.provider).toBe('anthropic');
+  });
+
+  it('typechecks an empty LlmConfig (all fields optional)', () => {
+    const cfg: LlmConfig = {};
+    expect(cfg).toEqual({});
+  });
+
+  it('allows a role entry without an optional credentialLabel', () => {
+    const role: LlmRoleConfig = {
+      provider: 'openai',
+      model: 'gpt-4o-mini',
+    };
+    expect(role.credentialLabel).toBeUndefined();
+  });
+
+  it('allows LlmDefaultConfig with only provider + model (no credential)', () => {
+    const def: LlmDefaultConfig = {
+      provider: 'anthropic',
+      model: 'claude-sonnet-4-6',
+    };
+    expect(def.provider).toBe('anthropic');
+    expect(def.model).toBe('claude-sonnet-4-6');
+  });
+});

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

@@ -9,6 +9,8 @@
  * @task T5710
  */
 
+import type { ModelTransport } from './operations/llm.js';
+
 /** Output format options. */
 export type OutputFormat = 'json' | 'text' | 'jsonl' | 'markdown' | 'table';
 
@@ -282,7 +284,11 @@ export interface BrainTieringConfig {
 export interface BrainLlmExtractionConfig {
   /** Enable LLM-driven extraction gate (default: true). */
   enabled: boolean;
-  /** Anthropic model to use for extraction (default: 'claude-haiku-4-5-20251001'). */
+  /**
+   * Anthropic model to use for extraction. Default lives in
+   * `@cleocode/core/llm/role-resolver` (`IMPLICIT_FALLBACK_MODEL`) so the
+   * literal stays in a single source location (T9255 grep guard).
+   */
   model: string;
   /** Minimum importance score (0.0–1.0) below which extractions are dropped (default: 0.6). */
   minImportance: number;
@@ -325,10 +331,11 @@ export interface BrainConfig {
    * LLM-driven extraction gate settings.
    * When enabled and ANTHROPIC_API_KEY is present, session transcripts are
    * processed by an LLM to extract typed structured memories instead of the
-   * legacy keyword regex. Defaults are enabled: true and model is the cheap
-   * Haiku class so extraction cost stays bounded.
+   * legacy keyword regex. Defaults are enabled: true and model defaults to
+   * the centralised implicit fallback (cheap Haiku class) defined in
+   * `@cleocode/core/llm/role-resolver` so extraction cost stays bounded.
    *
-   * @defaultValue { enabled: true, model: 'claude-haiku-4-5-20251001', minImportance: 0.6, maxExtractions: 7, maxTranscriptChars: 60000 }
+   * @defaultValue { enabled: true, model: IMPLICIT_FALLBACK_MODEL, minImportance: 0.6, maxExtractions: 7, maxTranscriptChars: 60000 }
    */
   llmExtraction?: BrainLlmExtractionConfig;
 }
@@ -381,7 +388,7 @@ export interface DaemonLLMConfig {
    * LLM provider transport used by daemon loops.
    * @defaultValue 'anthropic'
    */
-  provider: 'anthropic' | 'openai' | 'gemini' | 'moonshot';
+  provider: ModelTransport;
   /**
    * Full model identifier for the selected provider.
    * @defaultValue 'claude-sonnet-4-6'
@@ -389,14 +396,85 @@ export interface DaemonLLMConfig {
   model: string;
 }
 
+/**
+ * Canonical model transport identifier — re-export of {@link ModelTransport}
+ * from `operations/llm.ts` so config-layer types stay in lock-step with the
+ * operations layer with no risk of drift.
+ *
+ * Previously declared as a separate string-literal union; collapsed in the
+ * T-LLM-CRED Phase 2 DRY/SOLID review (P1-2). Adding a new transport now
+ * requires editing only `operations/llm.ts`.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 2 — DRY review P1-2
+ */
+export type LlmTransport = ModelTransport;
+
+/**
+ * Logical LLM role name used by role-aware resolvers (BRAIN, sentient, etc.).
+ *
+ * Each role can pin its own provider + model + credential label, with
+ * resolution falling back to `LlmConfig.default` and finally to the legacy
+ * `LlmConfig.daemon` block.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+ */
+export type RoleName = 'extraction' | 'consolidation' | 'derivation' | 'hygiene' | 'judgement';
+
+/**
+ * Canonical default LLM target for unscoped (non-role) calls.
+ *
+ * Replaces the role previously played by `LlmConfig.daemon`. The `daemon`
+ * field stays as a deprecated alias for one release cycle to give downstream
+ * consumers time to migrate.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+ */
+export interface LlmDefaultConfig {
+  /** LLM provider transport for the default model. */
+  provider: LlmTransport;
+  /** Full model identifier for the selected provider. */
+  model: string;
+}
+
+/**
+ * Per-role LLM configuration entry.
+ *
+ * Each role may optionally pin to a specific credential label (matching a
+ * `CredentialResult.label`) so that, e.g., the `extraction` role can use a
+ * different Anthropic API key than `judgement` without changing the global
+ * default.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+ */
+export interface LlmRoleConfig {
+  /** LLM provider transport for this role. */
+  provider: LlmTransport;
+  /** Full model identifier for the selected provider. */
+  model: string;
+  /**
+   * Optional credential label to pin this role to a specific credential
+   * entry resolved by `resolveCredentials()`. When omitted, the role
+   * inherits the default credential resolution order.
+   */
+  credentialLabel?: string;
+}
+
 /**
  * Top-level LLM configuration block inside CleoConfig.
  *
  * Stored at `llm` in config.json.
+ *
+ * Resolution order for role-scoped calls:
+ *   `roles[role]` → `default` → `daemon` (legacy).
  */
 export interface LlmConfig {
   /**
    * Daemon LLM settings (provider + model for background loops).
+   *
+   * @deprecated Use `default` instead. Retained as a fallback alias for
+   * one release cycle (T-LLM-CRED-CENTRALIZATION Phase 2 · T9256). New
+   * code must read `default` first and only fall through to `daemon` when
+   * `default` is absent.
    * @defaultValue { provider: 'anthropic', model: 'claude-sonnet-4-6' }
    */
   daemon?: DaemonLLMConfig;
@@ -405,6 +483,23 @@ export interface LlmConfig {
    * Keys are provider names: 'anthropic' | 'openai' | 'gemini' | 'moonshot'.
    */
   providers?: Record<string, LlmProviderEntry>;
+  /**
+   * Canonical default LLM for unscoped calls. Replaces the role previously
+   * played by `daemon`, which stays as a deprecated alias for one release
+   * cycle.
+   *
+   * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+   */
+  default?: LlmDefaultConfig;
+  /**
+   * Per-role LLM overrides. Each role optionally pins to a credential
+   * label.
+   *
+   * Resolution order: `roles[role]` → `default` → `daemon` (legacy).
+   *
+   * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+   */
+  roles?: Partial<Record<RoleName, LlmRoleConfig>>;
 }
 
 /** SignalDock transport mode. */
@@ -505,6 +600,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. */