@cleocode/core 2026.6.12 → 2026.6.14

package/dist/llm/system-of-use-registry.js

@@ -0,0 +1,200 @@
+/**
+ * `registerSystemOfUse` — runtime extension point for the E9 system-of-use
+ * taxonomy (T11751 · AC1).
+ *
+ * ## Why a runtime registry
+ *
+ * {@link BUILTIN_SYSTEMS_OF_USE} is the static, closed-axis registry of the
+ * well-known systems (orchestration tiers + roles + aux subsystems). Plugins,
+ * extensions, and downstream packages need to declare NEW systems-of-use (e.g.
+ * a `tool:my-search` or a bespoke `aux`-like subsystem) and give each a default
+ * provider/model binding — WITHOUT editing the contracts SSoT.
+ *
+ * `registerSystemOfUse(key, displayName, defaults)` adds such a system to a
+ * process-level registry. The registered default binding is consulted by the
+ * single E9 resolution chokepoint (`resolveLLMForSystem` → `resolveLLMForRole`)
+ * **strictly BELOW user config** — after `llm.systems[key]`, `llm.default`, and
+ * `llm.defaultProfile` — so the user ALWAYS wins (AC1). A registered default
+ * only supplies a binding when the user has configured nothing for that key.
+ *
+ * ## Import-time purity
+ *
+ * This module performs NO registration at import time — the registry starts
+ * empty and is populated only by explicit `registerSystemOfUse(...)` calls. It
+ * holds no I/O, no config reads, and no side effects on load (so importing it
+ * is always safe). It is the runtime half intentionally split out of the
+ * type-only `@cleocode/contracts` (Gate 10).
+ *
+ * @module llm/system-of-use-registry
+ * @task T11751
+ * @epic T11745
+ */
+import { BUILTIN_SYSTEMS_OF_USE, } from '@cleocode/contracts';
+import { getLogger } from '../logger.js';
+import { formatSystemKey, systemKeyKind } from './system-key.js';
+const logger = getLogger('llm-system-of-use-registry');
+/**
+ * Process-level registry of runtime-registered systems-of-use, keyed by encoded
+ * system key. Starts EMPTY — populated only by {@link registerSystemOfUse}.
+ *
+ * Module-private: callers reach it through the exported functions so the
+ * "user wins" / "register vs read" contract is enforced in one place.
+ */
+const REGISTRY = new Map();
+/**
+ * A registered system-of-use whose `defaults` carry neither a `profile` nor a
+ * complete `provider`+`model` tuple is structurally incomplete: it can declare
+ * presence in the picker but cannot supply a resolution binding. Such a default
+ * is skipped at resolution time (the chain falls through) — never an error.
+ *
+ * @param defaults - The candidate default binding.
+ * @returns `true` when the default can actually bind a provider/model.
+ * @task T11751
+ */
+export function isResolvableSystemDefault(defaults) {
+    if (defaults.profile)
+        return true;
+    return Boolean(defaults.provider && defaults.model);
+}
+/**
+ * Register a new system-of-use with a default provider/model binding (AC1).
+ *
+ * The registration is merged UNDER user config: the resolver consults
+ * `defaults` only when the user has configured nothing more specific for `key`
+ * (no `llm.systems[key]`, no `llm.default`, no `llm.defaultProfile`). Re-calling
+ * with the same `key` REPLACES the prior registration (last-write-wins) so a
+ * package can update its own default idempotently.
+ *
+ * `key` MAY be a flat label (e.g. `'sentient'`) or an open-axis encoded key
+ * (`'tool:web-search'`). Passing a structured `SystemOfUse` descriptor is also
+ * supported via {@link registerSystemOfUseDescriptor}.
+ *
+ * @param key         - Encoded system-of-use key (non-empty).
+ * @param displayName - Human-readable name for the picker surface (non-empty).
+ * @param defaults    - Default binding consulted strictly below user config.
+ * @returns The stored {@link RegisteredSystemOfUse} record.
+ * @throws {RangeError} When `key` or `displayName` is empty.
+ * @task T11751
+ * @epic T11745
+ */
+export function registerSystemOfUse(key, displayName, defaults) {
+    if (!key.trim()) {
+        throw new RangeError('registerSystemOfUse: `key` must be a non-empty string');
+    }
+    if (!displayName.trim()) {
+        throw new RangeError('registerSystemOfUse: `displayName` must be a non-empty string');
+    }
+    const record = {
+        key,
+        displayName,
+        // Defensive copy — the registry owns its records and never aliases the
+        // caller's object (so a later caller mutation cannot rewrite a binding).
+        defaults: { ...defaults },
+    };
+    REGISTRY.set(key, record);
+    if (!isResolvableSystemDefault(defaults)) {
+        logger.debug({ key }, 'registerSystemOfUse: registered with a non-binding default (picker-only) ' +
+            '— resolution will fall through past this entry');
+    }
+    return record;
+}
+/**
+ * Register a system-of-use from a structured {@link SystemOfUse} descriptor,
+ * encoding it to its canonical string key via {@link formatSystemKey}.
+ *
+ * Convenience wrapper over {@link registerSystemOfUse} for callers that already
+ * hold a `{ kind, id }` descriptor (e.g. plugin-declared tools/skills).
+ *
+ * @param system      - The structured descriptor to register.
+ * @param displayName - Human-readable name for the picker surface.
+ * @param defaults    - Default binding consulted strictly below user config.
+ * @returns The stored {@link RegisteredSystemOfUse} record.
+ * @task T11751
+ */
+export function registerSystemOfUseDescriptor(system, displayName, defaults) {
+    return registerSystemOfUse(formatSystemKey(system), displayName, defaults);
+}
+/**
+ * Look up the runtime-registered default binding for an encoded system key.
+ *
+ * Returns `undefined` when no system is registered under `key` OR when its
+ * default is structurally incomplete (so the resolver falls through). This is
+ * the read surface the E9 resolver calls AFTER exhausting all user-config tiers.
+ *
+ * @param key - Encoded system-of-use key (may be undefined — returns undefined).
+ * @returns The resolvable {@link SystemOfUseDefaults}, or `undefined`.
+ * @task T11751
+ */
+export function getRegisteredSystemDefault(key) {
+    if (!key)
+        return undefined;
+    const record = REGISTRY.get(key);
+    if (!record)
+        return undefined;
+    if (!isResolvableSystemDefault(record.defaults))
+        return undefined;
+    return record.defaults;
+}
+/**
+ * Enumerate every system-of-use for the TUI / Studio profile picker (AC2):
+ * the static {@link BUILTIN_SYSTEMS_OF_USE} table followed by every
+ * runtime-registered system, de-duplicated by key (a registration for a builtin
+ * key overrides the builtin entry — "user/runtime wins" for the picker label).
+ *
+ * Each entry carries its encoded `key`, a `displayName`, the discriminant
+ * `kind`, and its `source` (`'builtin'` | `'registered'`) so the picker can
+ * render and group them. Registered entries also surface their `defaults`.
+ *
+ * @param kind - Optional kind filter — when set, only that axis is returned.
+ * @returns The merged, ordered picker entries.
+ * @task T11751
+ * @epic T11745
+ */
+export function listSystemsOfUse(kind) {
+    const byKey = new Map();
+    // 1. Builtins first (stable order from the contracts SSoT).
+    for (const sys of BUILTIN_SYSTEMS_OF_USE) {
+        const key = formatSystemKey(sys);
+        byKey.set(key, {
+            key,
+            displayName: defaultDisplayName(sys.kind, sys.id),
+            kind: sys.kind,
+            source: 'builtin',
+        });
+    }
+    // 2. Runtime registrations override/extend (registered wins on key collision).
+    for (const record of REGISTRY.values()) {
+        byKey.set(record.key, {
+            key: record.key,
+            displayName: record.displayName,
+            kind: systemKeyKind(record.key),
+            source: 'registered',
+            defaults: record.defaults,
+        });
+    }
+    const entries = [...byKey.values()];
+    return kind ? entries.filter((e) => e.kind === kind) : entries;
+}
+/**
+ * Clear all runtime registrations.
+ *
+ * Intended for test isolation — production code never needs to un-register a
+ * system. Builtins are unaffected (they live in the contracts SSoT, not here).
+ *
+ * @internal
+ * @task T11751
+ */
+export function clearRegisteredSystemsOfUse() {
+    REGISTRY.clear();
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Derive a human-readable default display name for a builtin system. Plain
+ * id-with-kind-prefix; the picker may localise/override on top of this.
+ */
+function defaultDisplayName(kind, id) {
+    return `${kind}: ${id}`;
+}
+//# sourceMappingURL=system-of-use-registry.js.map

package/dist/llm/system-of-use-registry.js.map

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

package/dist/llm/system-resolver.d.ts

@@ -33,7 +33,7 @@
  * @task T11749
  * @epic T11745
  */
-import type { ResolveLLMForSystemOptions, RoleName, SystemOfUse } from '@cleocode/contracts';
+import type { ResolveLLMForSystemOptions, RoleName, SystemResolverInput } from '@cleocode/contracts';
 import { type ResolvedLLM } from './role-resolver.js';
 /**
  * Result of {@link resolveLLMForSystem}.
@@ -46,11 +46,13 @@ import { type ResolvedLLM } from './role-resolver.js';
  */
 export interface ResolvedLLMForSystem extends ResolvedLLM {
     /**
-     * The {@link SystemOfUse} label that initiated this resolution.
+     * The {@link SystemResolverInput} that initiated this resolution — either the
+     * flat {@link SystemOfUseLabel} or the structured {@link RoleSystem}
+     * descriptor (`{ kind: 'role', id }`) the caller passed.
      *
      * Preserved verbatim from the call argument — not normalised or remapped.
      */
-    system: SystemOfUse;
+    system: SystemResolverInput;
     /**
      * The {@link RoleName} that was actually used for config lookup.
      *
@@ -60,35 +62,55 @@ export interface ResolvedLLMForSystem extends ResolvedLLM {
     resolvedRole: RoleName | null;
 }
 /**
- * Resolve the LLM client + credential for a semantic system-of-use label.
+ * Resolve the LLM client + credential for a semantic system-of-use label OR a
+ * structured {@link RoleSystem} descriptor.
  *
  * This is the single DRY chokepoint for all LLM resolution in CLEO (E9 ·
  * T11745). It wraps `resolveLLMForRole` with:
  *
- *   - System label → role mapping (via {@link SYSTEM_ROLE_MAP}).
+ *   - System label → role mapping (via {@link SYSTEM_ROLE_MAP}); OR direct
+ *     `{ kind: 'role', id }` descriptor resolution (T11750 · AC1).
  *   - SSoT default model from the provider registry when `implicit-fallback`
  *     is reached (the hardcoded haiku literal is NOT used as the final model).
  *   - Full CredentialPool (E3) binding via `resolveLLMForRole` delegation.
  *
+ * ## Role equivalence (T11750 · AC1)
+ *
+ * `resolveLLMForSystem({ kind: 'role', id })` is the chokepoint expression of a
+ * direct role resolution — identical to `resolveLLMForRole(id)` for every
+ * resolution-relevant field (`provider` / `model` / `source` / `credential` /
+ * `sealedCredential` / `apiMode` / …), differing ONLY by the additive `system`
+ * + `resolvedRole` envelope fields. There is exactly ONE resolution
+ * implementation (`resolveLLMForRole`); both input forms funnel through it with
+ * ZERO duplicated logic. The descriptor form does NOT thread a `systemKey`
+ * (there is no flat label to key the `llm.systems[key]` override tier on), so it
+ * walks the same tier chain a bare `resolveLLMForRole(id)` call walks.
+ *
  * Like `resolveLLMForRole`, this function **never throws**: when no credential
  * is reachable the caller receives `{ credential: null, client: null, … }` and
  * is responsible for its own graceful-degradation path.
  *
  * @example
  * ```ts
- * const resolved = await resolveLLMForSystem('sentient', { projectRoot });
- * if (!resolved.credential?.apiKey || !resolved.client) {
+ * // Flat label (background subsystem):
+ * const a = await resolveLLMForSystem('sentient', { projectRoot });
+ * // Structured role descriptor (T11750 · AC1) — equivalent to
+ * // resolveLLMForRole('consolidation'):
+ * const b = await resolveLLMForSystem({ kind: 'role', id: 'consolidation' }, { projectRoot });
+ * if (!a.sealedCredential || !a.client) {
  *   return null; // graceful no-op — no credential available
  * }
- * // Use resolved.model, resolved.client, resolved.credential
+ * // Use resolved.model, resolved.client, resolved.credential (metadata only);
+ * // materialize the secret at the wire via resolved.sealedCredential.fetch().
  * ```
  *
- * @param system - Semantic label for the subsystem requesting an LLM client.
+ * @param system - Flat {@link SystemOfUseLabel} or {@link RoleSystem} descriptor.
  * @param opts   - Optional overrides (project root, role override, skipCatalogDefault).
  * @returns A {@link ResolvedLLMForSystem} envelope; never throws.
  *
  * @task T11749
+ * @task T11750
  * @epic T11745
  */
-export declare function resolveLLMForSystem(system: SystemOfUse, opts?: ResolveLLMForSystemOptions): Promise<ResolvedLLMForSystem>;
+export declare function resolveLLMForSystem(system: SystemResolverInput, opts?: ResolveLLMForSystemOptions): Promise<ResolvedLLMForSystem>;
 //# sourceMappingURL=system-resolver.d.ts.map

package/dist/llm/system-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-resolver.d.ts","sourceRoot":"","sources":["../../src/llm/system-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG7F,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;;;;OAKG;IACH,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC/B;AAqED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,0BAA0B,GAChC,OAAO,CAAC,oBAAoB,CAAC,CA+C/B"}
+{"version":3,"file":"system-resolver.d.ts","sourceRoot":"","sources":["../../src/llm/system-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,QAAQ,EAER,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD;;;;;;OAMG;IACH,MAAM,EAAE,mBAAmB,CAAC;IAE5B;;;;;OAKG;IACH,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC/B;AA4ID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,CAAC,EAAE,0BAA0B,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAuE/B"}

package/dist/llm/system-resolver.js

@@ -35,37 +35,86 @@
  */
 import { SYSTEM_ROLE_MAP } from '@cleocode/contracts';
 import { getLogger } from '../logger.js';
+import { proposeRoleForPrompt } from './complexity-classifier.js';
 import { IMPLICIT_FALLBACK_PROVIDER, resolveLLMForRole, } from './role-resolver.js';
 const logger = getLogger('llm-system-resolver');
 // ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
 /**
- * Map a {@link SystemOfUse} to the {@link RoleName} that `resolveLLMForRole`
- * will use for config lookup.
+ * Type guard: is `input` the structured {@link RoleSystem} descriptor form
+ * (`{ kind: 'role', id: RoleName }`) rather than a flat {@link SystemOfUseLabel}?
+ *
+ * A flat label is always a `string`; the descriptor is the only object form the
+ * chokepoint accepts — so a single `typeof === 'object'` test is sufficient and
+ * narrows `input` to {@link RoleSystem}.
+ *
+ * @task T11750
+ */
+function isRoleSystem(input) {
+    return typeof input === 'object' && input !== null && input.kind === 'role';
+}
+/**
+ * Map a {@link SystemResolverInput} to the {@link RoleName} that
+ * `resolveLLMForRole` will use for config lookup.
  *
  * Priority:
- *   1. `opts.roleOverride` — explicit caller override.
- *   2. {@link SYSTEM_ROLE_MAP} — static default for the system label.
+ *   1. `opts.roleOverride` — explicit caller override (both input forms).
+ *   2. Structured {@link RoleSystem} descriptor → its `id` IS the role (T11750).
+ *   3. {@link SYSTEM_ROLE_MAP} — static default for the flat system label.
+ *   4. L1 complexity proposer (T11906) — when the label maps to NO role AND a
+ *      `complexityPrompt` was supplied, classify it and propose a role from the
+ *      resulting tier. This is the "derive a tier from prompt complexity when no
+ *      explicit tier/role is given" wiring (AC2): it COMPLEMENTS the resolver,
+ *      only filling in a role the input left blank. The classifier returns a
+ *      tier and constructs no LLM client.
  *
- * Returns `null` when the system maps to the global default (no role entry).
+ * Returns `null` when a flat label maps to the global default (no role entry)
+ * and no `complexityPrompt` was supplied. The descriptor form always carries a
+ * concrete {@link RoleName}, so it never returns `null`.
  */
-function deriveRole(system, opts) {
+function deriveRole(input, opts) {
     if (opts?.roleOverride)
         return opts.roleOverride;
-    return SYSTEM_ROLE_MAP[system] ?? null;
+    if (isRoleSystem(input))
+        return input.id;
+    const mapped = SYSTEM_ROLE_MAP[input] ?? null;
+    if (mapped !== null)
+        return mapped;
+    // No role from the label (e.g. flat `'default'`). If the caller handed us a
+    // prompt, let the L1 complexity classifier propose a tier → role.
+    if (opts?.complexityPrompt !== undefined) {
+        const proposed = proposeRoleForPrompt(opts.complexityPrompt);
+        logger.debug({ system: input, proposedRole: proposed }, 'system-resolver: derived role from L1 complexity classifier (no explicit tier/role)');
+        return proposed;
+    }
+    return null;
 }
 /**
- * When `resolveLLMForRole` returns `source === 'implicit-fallback'`, the
- * model is the hardcoded `IMPLICIT_FALLBACK_MODEL` literal. This function
- * replaces it with the SSoT `defaultModel` from the provider registry so
- * the resolved model tracks catalog updates rather than a frozen constant.
+ * When `resolveLLMForRole` returns `source === 'implicit-fallback'`, the model is
+ * the hardcoded `IMPLICIT_FALLBACK_MODEL` literal. This function derives the
+ * default from the **`models_catalog` SSoT** (latest `release_date` for the
+ * provider) so the resolved model tracks the catalog rather than a frozen
+ * constant — the "catalog-driven models, NO hardcoded" North Star (E8 · T11944).
+ *
+ * ## Resolution order (offline-first degrade — T11944 AC1/AC2)
  *
- * On any lookup error the original `resolved` envelope is returned unchanged
- * so the caller is never blocked — graceful degradation is preserved.
+ *   1. **`models_catalog` table** (via the {@link resolveCatalogEntry} table-first
+ *      chokepoint — T11737): newest `release_date` row for the provider. When the
+ *      table is seeded this WINS and the static builtin literal is never reached.
+ *   2. **provider-registry `defaultModel`** (the static builtin
+ *      `ProviderDef.defaultModel`) — reached ONLY when the catalog (table + disk
+ *      cache + shipped seed) yields nothing for the provider.
+ *   3. **the existing `IMPLICIT_FALLBACK_MODEL` literal** already on `resolved` —
+ *      the absolute offline floor, preserved for a fresh/offline install with no
+ *      catalog AND no provider profile (degrade does NOT break — AC2).
+ *
+ * NO network is issued at resolve time (table-or-cache only — AC4). On any lookup
+ * error the original `resolved` envelope is returned unchanged so the caller is
+ * never blocked.
  *
  * @param resolved - The envelope returned by `resolveLLMForRole`.
- * @returns The same envelope, possibly with `model` replaced from the registry.
+ * @returns The same envelope, possibly with `model` replaced from the catalog SSoT.
  */
 async function upgradeCatalogDefault(resolved) {
     if (resolved.source !== 'implicit-fallback') {
@@ -73,19 +122,31 @@ async function upgradeCatalogDefault(resolved) {
         return resolved;
     }
     try {
-        // Lazy import to avoid pulling the full registry chain at module-init time.
-        const { getProviderProfile } = await import('./provider-registry/index.js');
-        const profile = await getProviderProfile(resolved.provider);
-        if (!profile?.defaultModel) {
-            // Registry has no default for this provider — fall back to the existing model.
-            return resolved;
+        // Lazy imports to avoid pulling the full registry/catalog chain at module-init.
+        const { resolveCatalogEntry } = await import('./catalog-resolver.js');
+        const { catalogKeyForProvider } = await import('./catalog-model-resolver.js');
+        // 1. Table-first catalog SSoT (release_date DESC) — the canonical default.
+        const catalogKey = catalogKeyForProvider(resolved.provider);
+        const entry = await resolveCatalogEntry(catalogKey);
+        if (entry?.id && entry.id !== resolved.model) {
+            logger.debug({ provider: resolved.provider, from: resolved.model, to: entry.id, source: entry.source }, 'system-resolver: upgrading implicit-fallback model to models_catalog default');
+            return { ...resolved, model: entry.id };
         }
-        if (profile.defaultModel === resolved.model) {
-            // Already the same — no mutation needed.
+        if (entry?.id) {
+            // Catalog already agrees with the resolved model — no mutation needed.
             return resolved;
         }
-        logger.debug({ provider: resolved.provider, from: resolved.model, to: profile.defaultModel }, 'system-resolver: upgrading implicit-fallback model to catalog default');
-        return { ...resolved, model: profile.defaultModel };
+        // 2. OFFLINE FLOOR: catalog empty/unseeded (fresh/offline install). Fall back to
+        //    the static builtin provider-registry default so degrade never breaks.
+        const { getProviderProfile } = await import('./provider-registry/index.js');
+        const profile = await getProviderProfile(resolved.provider);
+        if (profile?.defaultModel && profile.defaultModel !== resolved.model) {
+            logger.debug({ provider: resolved.provider, from: resolved.model, to: profile.defaultModel }, 'system-resolver: catalog empty — degrading to static builtin defaultModel floor');
+            return { ...resolved, model: profile.defaultModel };
+        }
+        // 3. Neither catalog nor profile yielded a model — keep the existing
+        //    IMPLICIT_FALLBACK_MODEL literal already on `resolved` (the last floor).
+        return resolved;
     }
     catch (err) {
         logger.warn({ err: err instanceof Error ? err.message : String(err) }, 'system-resolver: catalog default lookup failed; keeping existing fallback model');
@@ -96,60 +157,102 @@ async function upgradeCatalogDefault(resolved) {
 // Public API
 // ---------------------------------------------------------------------------
 /**
- * Resolve the LLM client + credential for a semantic system-of-use label.
+ * Resolve the LLM client + credential for a semantic system-of-use label OR a
+ * structured {@link RoleSystem} descriptor.
  *
  * This is the single DRY chokepoint for all LLM resolution in CLEO (E9 ·
  * T11745). It wraps `resolveLLMForRole` with:
  *
- *   - System label → role mapping (via {@link SYSTEM_ROLE_MAP}).
+ *   - System label → role mapping (via {@link SYSTEM_ROLE_MAP}); OR direct
+ *     `{ kind: 'role', id }` descriptor resolution (T11750 · AC1).
  *   - SSoT default model from the provider registry when `implicit-fallback`
  *     is reached (the hardcoded haiku literal is NOT used as the final model).
  *   - Full CredentialPool (E3) binding via `resolveLLMForRole` delegation.
  *
+ * ## Role equivalence (T11750 · AC1)
+ *
+ * `resolveLLMForSystem({ kind: 'role', id })` is the chokepoint expression of a
+ * direct role resolution — identical to `resolveLLMForRole(id)` for every
+ * resolution-relevant field (`provider` / `model` / `source` / `credential` /
+ * `sealedCredential` / `apiMode` / …), differing ONLY by the additive `system`
+ * + `resolvedRole` envelope fields. There is exactly ONE resolution
+ * implementation (`resolveLLMForRole`); both input forms funnel through it with
+ * ZERO duplicated logic. The descriptor form does NOT thread a `systemKey`
+ * (there is no flat label to key the `llm.systems[key]` override tier on), so it
+ * walks the same tier chain a bare `resolveLLMForRole(id)` call walks.
+ *
  * Like `resolveLLMForRole`, this function **never throws**: when no credential
  * is reachable the caller receives `{ credential: null, client: null, … }` and
  * is responsible for its own graceful-degradation path.
  *
  * @example
  * ```ts
- * const resolved = await resolveLLMForSystem('sentient', { projectRoot });
- * if (!resolved.credential?.apiKey || !resolved.client) {
+ * // Flat label (background subsystem):
+ * const a = await resolveLLMForSystem('sentient', { projectRoot });
+ * // Structured role descriptor (T11750 · AC1) — equivalent to
+ * // resolveLLMForRole('consolidation'):
+ * const b = await resolveLLMForSystem({ kind: 'role', id: 'consolidation' }, { projectRoot });
+ * if (!a.sealedCredential || !a.client) {
  *   return null; // graceful no-op — no credential available
  * }
- * // Use resolved.model, resolved.client, resolved.credential
+ * // Use resolved.model, resolved.client, resolved.credential (metadata only);
+ * // materialize the secret at the wire via resolved.sealedCredential.fetch().
  * ```
  *
- * @param system - Semantic label for the subsystem requesting an LLM client.
+ * @param system - Flat {@link SystemOfUseLabel} or {@link RoleSystem} descriptor.
  * @param opts   - Optional overrides (project root, role override, skipCatalogDefault).
  * @returns A {@link ResolvedLLMForSystem} envelope; never throws.
  *
  * @task T11749
+ * @task T11750
  * @epic T11745
  */
 export async function resolveLLMForSystem(system, opts) {
     const resolvedRole = deriveRole(system, opts);
-    // When the role is null (system === 'default'), fall back to treating it as
-    // the 'consolidation' role — this exercises the same config tiers as all
-    // other roles (roles[role] → default → defaultProfile → implicit-fallback)
+    // When the role is null (flat `system === 'default'`), fall back to treating
+    // it as the 'consolidation' role — this exercises the same config tiers as
+    // all other roles (roles[role] → default → defaultProfile → implicit-fallback)
     // and avoids a special code path. If `config.llm.roles['consolidation']` is
     // not set, resolution cascades to `config.llm.default` and then the catalog
-    // default exactly as desired.
+    // default exactly as desired. The descriptor form always carries a concrete
+    // role id, so `resolvedRole` is never null there.
     const roleForResolution = resolvedRole ?? 'consolidation';
+    // Thread the flat label as the `llm.systems[key]` granular-override key (E9 ·
+    // T11748). The structured `{ kind: 'role', id }` descriptor carries NO label
+    // to key that tier on, so it omits `systemKey` and walks the same tier chain
+    // a bare `resolveLLMForRole(id)` call walks — preserving the AC1 equivalence.
+    //
+    // T11759 (M4): an explicit `opts.systemKey` OVERRIDES the label-derived key.
+    // This lets an OPEN-axis caller (a `.cantbook` node keyed
+    // `cantbook:<playbook>#<nodeId>`) drive the `llm.systems[key]` granular tier +
+    // audit identity while passing a resolvable background label as `system`.
+    const systemKey = opts?.systemKey ?? (isRoleSystem(system) ? undefined : system);
     let base;
     try {
         base = await resolveLLMForRole(roleForResolution, {
             projectRoot: opts?.projectRoot,
+            systemKey,
+            // T11759: pin a named profile (e.g. a `.cantbook` stage's `profile:`) as
+            // the highest-priority resolution tier. Absent/incomplete → falls through.
+            ...(opts?.profile !== undefined ? { profileOverride: opts.profile } : {}),
         });
     }
     catch (err) {
         // Mirror role-resolver's never-throw contract: return a null-credential
         // envelope on unexpected failure.
-        logger.warn({ err: err instanceof Error ? err.message : String(err), system, role: roleForResolution }, 'system-resolver: resolveLLMForRole threw unexpectedly; returning null-credential envelope');
+        logger.warn({
+            err: err instanceof Error ? err.message : String(err),
+            system,
+            role: roleForResolution,
+        }, 'system-resolver: resolveLLMForRole threw unexpectedly; returning null-credential envelope');
         base = {
             provider: IMPLICIT_FALLBACK_PROVIDER,
             model: 'unknown',
             client: null,
             credential: null,
+            // E10 (T11753): no credential resolved → null sealed handle, paired with
+            // the null `credential` metadata above.
+            sealedCredential: null,
             source: 'implicit-fallback',
             // SSoT wire facts (E9 · T11745): the implicit-fallback provider is
             // anthropic and there is no credential, so the descriptor advertises the

package/dist/llm/system-resolver.js.map

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

package/dist/memory/brain-writer-thread.d.ts.map

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