@cleocode/contracts 2026.5.62 → 2026.5.64

package/dist/operations/llm.d.ts

@@ -52,6 +52,15 @@ export interface ModelConfig {
     cachePolicy?: PromptCachePolicy | null;
     /** Fallback model config used on final retry attempt. */
     fallback?: Omit<ModelConfig, 'fallback'> | null;
+    /**
+     * Extra HTTP headers to attach to the provider client (merged into the SDK's
+     * `defaultHeaders`). Populated from `authHeaders(cred)` when a credential is
+     * resolved with `authType: 'oauth'` so the provider client uses the
+     * `Authorization: Bearer …` scheme instead of `x-api-key`.
+     *
+     * @task T-LLM-CRED-CENTRALIZATION Phase 1
+     */
+    extraHeaders?: Record<string, string> | null;
 }
 /** Parameters for a single LLM call. */
 export interface LLMCallParams {
@@ -105,4 +114,375 @@ export interface LLMCallResult<T = string> {
     thinkingBlocks: Array<Record<string, unknown>>;
     reasoningDetails: Array<Record<string, unknown>>;
 }
+/**
+ * Which credential-resolution tier produced a {@link CredentialResultWire}.
+ *
+ * Mirrors `CredentialSource` in `@cleocode/core/llm/credentials.ts`. The set is
+ * append-only; new tiers (e.g. `aws-sdk`, `gcp-sdk` in Phase 3) extend this
+ * union.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 1
+ * @task T9255
+ */
+export type CredentialSourceWire = 'explicit' | 'env' | 'cred-file' | 'claude-creds' | 'global-config' | 'project-config';
+/**
+ * Authentication scheme used when sending the credential to the provider.
+ *
+ * - `api_key` — provider-issued long-lived key sent as `x-api-key` (Anthropic)
+ *   or `Authorization: Bearer …` (OpenAI, Gemini, Moonshot).
+ * - `oauth` — short-lived OAuth bearer token sent as `Authorization: Bearer …`
+ *   with the matching beta header.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 1
+ * @task T9255
+ */
+export type AuthTypeWire = 'api_key' | 'oauth';
+/**
+ * Resolved credential as returned by `resolveCredentials()` /
+ * `resolveLLMForRole()`. Mirrors `CredentialResult` in core. Compatible by
+ * structural typing.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 1
+ * @task T9255
+ */
+export interface CredentialResultWire {
+    /** Provider transport this credential is for. */
+    provider: ModelTransport;
+    /** API key or OAuth bearer token. `null` only when no credential was found. */
+    apiKey: string | null;
+    /** Which tier produced this credential. `undefined` when `apiKey` is `null`. */
+    source: CredentialSourceWire | undefined;
+    /** Scheme used to present the credential to the provider. */
+    authType: AuthTypeWire;
+}
+/**
+ * Which configuration tier produced a {@link ResolvedLLM}.
+ *
+ * Resolution chain order:
+ *   1. `role`               — `config.llm.roles[role]` (explicit override)
+ *   2. `default`            — `config.llm.default` (canonical default)
+ *   3. `daemon-legacy`      — `config.llm.daemon` (deprecated alias)
+ *   4. `implicit-fallback`  — hard-coded fallback inside the resolver
+ *
+ * Useful for `cleo llm whoami` diagnostics and for migration tooling that
+ * needs to identify call-sites still on the legacy `daemon` block.
+ *
+ * @task T9255
+ */
+export type ResolutionSource = 'role' | 'default' | 'daemon-legacy' | 'implicit-fallback';
+/**
+ * Result envelope returned by `resolveLLMForRole(role)`.
+ *
+ * Carries the fully-wired SDK client plus the {@link CredentialResultWire}
+ * so raw-fetch callers (sleep-consolidation, observer-reflector, hygiene-scan)
+ * can call `authHeaders(credential)` themselves when bypassing the SDK
+ * client (e.g. to call the Anthropic Messages REST API directly).
+ *
+ * `client` is `null` only when `credential.apiKey` is also `null` — in which
+ * case the caller MUST fall back to its graceful-degradation path
+ * (`return null` / skip / log warn).
+ *
+ * `client` is typed as `unknown` here because the concrete SDK classes
+ * (Anthropic, OpenAI, GoogleGenerativeAI) are not referenced from contracts
+ * to preserve its zero-dependency footprint. Consumers MUST narrow via the
+ * typed helpers in `@cleocode/core/llm/role-resolver` (e.g.
+ * `resolveAnthropicForRole`) rather than casting with `as unknown as X`.
+ *
+ * @task T9255
+ */
+export interface ResolvedLLM {
+    /** LLM provider transport that was resolved. */
+    provider: ModelTransport;
+    /** Full model identifier. */
+    model: string;
+    /**
+     * Fully-wired SDK client constructed via `clientForModelConfig`. `null`
+     * when no credential is available. Typed as `unknown` — consumers MUST
+     * narrow via a provider-specific helper (e.g. `resolveAnthropicForRole`
+     * in `@cleocode/core/llm/role-resolver`), NEVER via an `as unknown as X`
+     * cast.
+     */
+    client: unknown;
+    /**
+     * Resolved credential. `null` when no tier produced a token. Callers
+     * MUST handle this case.
+     */
+    credential: CredentialResultWire | null;
+    /** Which config path produced this resolution. */
+    source: ResolutionSource;
+    /** When `roles[role].credentialLabel` was set, the label that was used. */
+    credentialLabel?: string;
+}
+/**
+ * Options accepted by `resolveLLMForRole()`.
+ *
+ * @task T9255
+ */
+export interface ResolveLLMForRoleOptions {
+    /**
+     * Absolute path to the project root. Forwarded to `loadConfig()` and to
+     * `resolveCredentials({ projectRoot })` for tier-5 project-config lookup.
+     * Defaults to `process.cwd()`.
+     */
+    projectRoot?: string;
+}
+/**
+ * Storage-level authentication scheme as persisted in the credentials store.
+ *
+ * Wider than the wire-level {@link AuthTypeWire}: includes `'aws_sdk'` for
+ * Bedrock / Vertex entries where the AWS SDK supplies the credential
+ * out-of-band. The runtime resolver narrows `'aws_sdk' → 'api_key'` for
+ * wire-level use until Phase 3 widens {@link AuthTypeWire}.
+ *
+ * Mirrors `StoredAuthType` in `@cleocode/core/llm/credentials-store`.
+ *
+ * @task T9258
+ */
+export type StoredAuthTypeWire = 'api_key' | 'oauth' | 'aws_sdk';
+/**
+ * Strategy used by the credentials-store picker.
+ *
+ * Mirrors `CredentialsStoreStrategy` in
+ * `@cleocode/core/llm/credentials-store`. Held here so callers outside
+ * `core` can render UI without taking a dependency on the storage module.
+ *
+ * @task T9258
+ */
+export type CredentialsStoreStrategyWire = 'priorityWithFallback' | 'roundRobin' | 'priorityOnly';
+/**
+ * Token-redacted view of a single stored credential.
+ *
+ * `tokenPreview` is the last 4 characters of `accessToken` prefixed by
+ * `'…'` (e.g. `'…aB7q'`). The full token is NEVER returned by any
+ * `cleo llm` operation — callers that need the live token must resolve it
+ * through `resolveLLMForRole()`.
+ *
+ * @task T9258
+ */
+export interface LlmStoredCredentialView {
+    /** LLM transport this credential is for. */
+    provider: ModelTransport;
+    /** Human-readable identifier, unique within `provider`. */
+    label: string;
+    /** Storage-level auth scheme. */
+    authType: StoredAuthTypeWire;
+    /** Redacted token preview — last 4 chars, prefixed by `'…'`. */
+    tokenPreview: string;
+    /** Whether the entry carried a non-empty refresh token. */
+    hasRefreshToken: boolean;
+    /** Unix epoch ms; `null` means "never expires". */
+    expiresAt: number | null;
+    /** Lower wins. */
+    priority: number;
+    /** Free-form provenance label (`claude-code`, `cli-input`, etc.). */
+    source: string | undefined;
+    /** Optional override for provider base URL. */
+    baseUrl: string | null;
+    /** When `true`, the picker skips this entry. */
+    disabled: boolean;
+}
+/**
+ * Parameters for `llm.add` (mutate).
+ *
+ * Mirrors the `cleo llm add <provider> --api-key <k>` CLI surface. When
+ * `authType` is omitted, the dispatcher auto-detects from the token
+ * prefix: tokens beginning with `sk-ant-oat-` are stored as `'oauth'`,
+ * everything else as `'api_key'`.
+ *
+ * @task T9258
+ */
+export interface LlmAddParams {
+    /** Target provider transport. */
+    provider: ModelTransport;
+    /** API key or OAuth bearer token to persist. */
+    apiKey: string;
+    /** Human-readable label, unique within `provider`. Defaults to `'default'`. */
+    label?: string;
+    /** Optional override for the provider base URL. */
+    baseUrl?: string;
+    /** Optional explicit auth type override (skips prefix auto-detect). */
+    authType?: StoredAuthTypeWire;
+    /** Optional priority override (lower wins). */
+    priority?: number;
+}
+/**
+ * Result envelope for `llm.add`.
+ *
+ * @task T9258
+ */
+export interface LlmAddResult {
+    /** Token-redacted view of the newly stored entry. */
+    credential: LlmStoredCredentialView;
+    /** Detected auth type (`'oauth'` for `sk-ant-oat-*`, else `'api_key'`). */
+    detectedAuthType: StoredAuthTypeWire;
+}
+/**
+ * Parameters for `llm.list` (query).
+ *
+ * @task T9258
+ */
+export interface LlmListParams {
+    /** Optional provider filter — when set, only entries for that provider. */
+    provider?: ModelTransport;
+}
+/**
+ * Result envelope for `llm.list`.
+ *
+ * @task T9258
+ */
+export interface LlmListResult {
+    /** Token-redacted credentials, in store order (priority asc). */
+    credentials: LlmStoredCredentialView[];
+}
+/**
+ * Parameters for `llm.remove` (mutate).
+ *
+ * @task T9258
+ */
+export interface LlmRemoveParams {
+    /** Target provider transport. */
+    provider: ModelTransport;
+    /** Label of the credential to remove. */
+    label: string;
+}
+/**
+ * Result envelope for `llm.remove`.
+ *
+ * @task T9258
+ */
+export interface LlmRemoveResult {
+    /** `true` when a matching entry was deleted. */
+    removed: boolean;
+    /** Echo of the targeted `(provider, label)` pair. */
+    provider: ModelTransport;
+    /** Echo of the targeted label. */
+    label: string;
+}
+/**
+ * Parameters for `llm.use` (mutate) — set `llm.default.{provider,model}`.
+ *
+ * @task T9258
+ */
+export interface LlmUseParams {
+    /** Provider transport to mark as the default. */
+    provider: ModelTransport;
+    /** Optional default model identifier. When omitted, `default.model` is left untouched. */
+    model?: string;
+}
+/**
+ * Result envelope for `llm.use`.
+ *
+ * @task T9258
+ */
+export interface LlmUseResult {
+    /** Provider written to `llm.default.provider`. */
+    provider: ModelTransport;
+    /** Model written to `llm.default.model` — `null` when not provided. */
+    model: string | null;
+    /** Config scope the write landed in (`'global'` for `cleo llm use`). */
+    scope: 'project' | 'global';
+}
+/**
+ * Parameters for `llm.profile` (mutate) — set `llm.roles[role]`.
+ *
+ * @task T9258
+ */
+export interface LlmProfileParams {
+    /** Logical role name. */
+    role: string;
+    /** Provider transport for this role. */
+    provider: ModelTransport;
+    /** Optional model identifier for this role. */
+    model?: string;
+    /** Optional credential label to pin this role to a specific store entry. */
+    credentialLabel?: string;
+}
+/**
+ * Result envelope for `llm.profile`.
+ *
+ * @task T9258
+ */
+export interface LlmProfileResult {
+    /** Role name written to `llm.roles[role]`. */
+    role: string;
+    /** Provider written for the role. */
+    provider: ModelTransport;
+    /** Model written for the role (or `null` when not supplied). */
+    model: string | null;
+    /** Credential label written for the role (or `null` when not supplied). */
+    credentialLabel: string | null;
+    /** Config scope the write landed in. */
+    scope: 'project' | 'global';
+}
+/**
+ * Parameters for `llm.test` (query).
+ *
+ * @task T9258
+ */
+export interface LlmTestParams {
+    /** Provider transport to test. */
+    provider: ModelTransport;
+    /** Optional credential label to pin the test to a specific store entry. */
+    label?: string;
+    /** Optional model override. Defaults to the provider's implicit fallback. */
+    model?: string;
+}
+/**
+ * Result envelope for `llm.test`. Tokens are NEVER included.
+ *
+ * @task T9258
+ */
+export interface LlmTestResult {
+    /** Provider transport that was probed. */
+    provider: ModelTransport;
+    /** Model identifier used for the probe. */
+    model: string;
+    /** End-to-end round-trip latency in ms. */
+    latencyMs: number;
+    /** Provider response identifier (e.g. Anthropic `msg_…`). `null` when unavailable. */
+    providerResponseId: string | null;
+    /** Redacted credential preview (last 4 chars) — confirms which entry was used. */
+    credentialPreview: string;
+    /** Resolution tier that produced the credential (`env`, `cred-file`, etc.). */
+    credentialSource: CredentialSourceWire;
+}
+/**
+ * Single `whoami` row — one entry per `RoleName`.
+ *
+ * @task T9258
+ */
+export interface LlmWhoamiEntry {
+    /** Role name (`'extraction' | 'consolidation' | ...`). */
+    role: string;
+    /** Provider that would be picked for this role. */
+    provider: ModelTransport;
+    /** Model that would be used. */
+    model: string;
+    /** Which config tier produced the resolution. */
+    source: ResolutionSource;
+    /** Credential label, when the role pinned a specific store entry. */
+    credentialLabel: string | undefined;
+    /** Resolution tier of the eventual credential, when one was reachable. */
+    credentialSource: CredentialSourceWire | undefined;
+    /** Whether a usable credential exists for this role. */
+    hasCredential: boolean;
+}
+/**
+ * Parameters for `llm.whoami` (query). Reserved for future filters.
+ *
+ * @task T9258
+ */
+export interface LlmWhoamiParams {
+    /** Optional role filter — when set, only that role is resolved. */
+    role?: string;
+}
+/**
+ * Result envelope for `llm.whoami`.
+ *
+ * @task T9258
+ */
+export interface LlmWhoamiResult {
+    /** One entry per role resolved (filtered by `params.role` when set). */
+    entries: LlmWhoamiEntry[];
+}
 //# sourceMappingURL=llm.d.ts.map

package/dist/operations/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/operations/llm.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/operations/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE5E,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,SAAS,EAAE,cAAc,CAAC;IAC1B,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IAChD;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAYD;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,KAAK,GACL,WAAW,GACX,cAAc,GACd,eAAe,GACf,gBAAgB,CAAC;AAErB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,EAAE,cAAc,CAAC;IACzB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gFAAgF;IAChF,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,EAAE,YAAY,CAAC;CACxB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,kDAAkD;IAClD,MAAM,EAAE,gBAAgB,CAAC;IACzB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAeD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG,YAAY,GAAG,cAAc,CAAC;AAElG;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,UAAU,EAAE,uBAAuB,CAAC;IACpC,2EAA2E;IAC3E,gBAAgB,EAAE,kBAAkB,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,QAAQ,EAAE,cAAc,CAAC;IACzB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,EAAE,cAAc,CAAC;IACzB,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,cAAc,CAAC;IACzB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wCAAwC;IACxC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,cAAc,CAAC;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,gBAAgB,EAAE,oBAAoB,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,cAAc,CAAC;IACzB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,EAAE,gBAAgB,CAAC;IACzB,qEAAqE;IACrE,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,0EAA0E;IAC1E,gBAAgB,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACnD,wDAAwD;IACxD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B"}

package/dist/project-context.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Project context — canonical ecosystem detection types.
+ *
+ * Defines the shape of `.cleo/project-context.json` and the smaller hint
+ * envelope consumed by release-flow / spawn-engine / codebase-map analyzers.
+ *
+ * Type-only: the detector implementation lives in `@cleocode/core/store/
+ * project-detect.ts`. Centralising the types here lets any package (release,
+ * studio, agents, …) reason about ecosystem signals without importing core.
+ *
+ * @adr ADR-013
+ */
+/** Detected project ecosystem. Matches the writer in `detectProjectType`. */
+export type ProjectType = 'node' | 'python' | 'rust' | 'go' | 'ruby' | 'java' | 'dotnet' | 'bash' | 'elixir' | 'php' | 'deno' | 'bun' | 'unknown';
+/** Detected test framework. */
+export type TestFramework = 'jest' | 'vitest' | 'mocha' | 'pytest' | 'bats' | 'cargo' | 'go' | 'rspec' | 'junit' | 'playwright' | 'cypress' | 'ava' | 'uvu' | 'tap' | 'node:test' | 'deno' | 'bun' | 'custom' | 'unknown';
+/** File-naming convention detected from source files. */
+export type FileNamingConvention = 'kebab-case' | 'snake_case' | 'camelCase' | 'PascalCase';
+/** Module import style. */
+export type ImportStyle = 'esm' | 'commonjs' | 'mixed';
+/** Schema-compliant project context for LLM agent consumption. */
+export interface ProjectContext {
+    schemaVersion: string;
+    detectedAt: string;
+    projectTypes: ProjectType[];
+    primaryType?: ProjectType;
+    monorepo: boolean;
+    testing?: {
+        framework?: TestFramework;
+        command?: string;
+        testFilePatterns?: string[];
+        directories?: {
+            unit?: string;
+            integration?: string;
+        };
+    };
+    build?: {
+        command?: string;
+        outputDir?: string;
+    };
+    directories?: {
+        source?: string;
+        tests?: string;
+        docs?: string;
+    };
+    conventions?: {
+        fileNaming?: FileNamingConvention;
+        importStyle?: ImportStyle;
+        typeSystem?: string;
+    };
+    llmHints?: {
+        preferredTestStyle?: string;
+        typeSystem?: string;
+        commonPatterns?: string[];
+        avoidPatterns?: string[];
+    };
+}
+/**
+ * Narrow subset of {@link ProjectContext} consumed by the release engine's
+ * workspace discovery and other ecosystem-aware flows. Avoid passing the
+ * full {@link ProjectContext} when only the three discriminating fields are
+ * needed.
+ */
+export interface EcosystemHint {
+    primaryType?: ProjectType;
+    projectTypes?: ProjectType[];
+    monorepo?: boolean;
+}
+//# sourceMappingURL=project-context.d.ts.map

package/dist/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,IAAI,GACJ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,IAAI,GACJ,OAAO,GACP,OAAO,GACP,YAAY,GACZ,SAAS,GACT,KAAK,GACL,KAAK,GACL,KAAK,GACL,WAAW,GACX,MAAM,GACN,KAAK,GACL,QAAQ,GACR,SAAS,CAAC;AAEd,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5F,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,aAAa,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,EAAE;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAClC,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/project-context.js

@@ -0,0 +1,14 @@
+/**
+ * Project context — canonical ecosystem detection types.
+ *
+ * Defines the shape of `.cleo/project-context.json` and the smaller hint
+ * envelope consumed by release-flow / spawn-engine / codebase-map analyzers.
+ *
+ * Type-only: the detector implementation lives in `@cleocode/core/store/
+ * project-detect.ts`. Centralising the types here lets any package (release,
+ * studio, agents, …) reason about ecosystem signals without importing core.
+ *
+ * @adr ADR-013
+ */
+export {};
+//# sourceMappingURL=project-context.js.map

package/dist/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/release/channel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Release channel contracts — types describing the npm dist-tag channel
+ * model used by the release pipeline.
+ *
+ * The implementation (branch→channel resolution, version validation) lives
+ * in `@cleocode/core/release/channel.ts`. The types live here so consumers
+ * can describe / validate the same shapes without depending on core.
+ *
+ * @adr ADR-063
+ */
+/** npm dist-tag channel for a release. */
+export type ReleaseChannel = 'latest' | 'beta' | 'alpha';
+/** Result of validating a version string against a channel's expectations. */
+export interface ChannelValidationResult {
+    valid: boolean;
+    expected?: string;
+    actual?: string;
+    message: string;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/release/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/release/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/release/channel.js

@@ -0,0 +1,12 @@
+/**
+ * Release channel contracts — types describing the npm dist-tag channel
+ * model used by the release pipeline.
+ *
+ * The implementation (branch→channel resolution, version validation) lives
+ * in `@cleocode/core/release/channel.ts`. The types live here so consumers
+ * can describe / validate the same shapes without depending on core.
+ *
+ * @adr ADR-063
+ */
+export {};
+//# sourceMappingURL=channel.js.map

package/dist/release/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/release/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/release/github-pr.d.ts

@@ -0,0 +1,79 @@
+/**
+ * GitHub PR contracts — types describing the PR-creation surface used by
+ * the release pipeline.
+ *
+ * The implementation lives in `@cleocode/core/release/github-pr.ts`. The
+ * types live here so consumers (CLI, studio, downstream tools) can describe
+ * / validate the same shapes without depending on core.
+ *
+ * @adr ADR-063
+ */
+import type { ReleaseChannel } from './channel.js';
+/** Outcome of `detectBranchProtection`. */
+export interface BranchProtectionResult {
+    protected: boolean;
+    detectionMethod: 'gh-api' | 'push-dry-run' | 'unknown';
+    error?: string;
+}
+/** Input to `createPullRequest`. */
+export interface PRCreateOptions {
+    base: string;
+    head: string;
+    title: string;
+    body: string;
+    /**
+     * Requested PR labels. Non-existent ones are filtered or auto-created by
+     * the resolver; the engine never passes a bare list to `gh pr create`.
+     */
+    labels?: string[];
+    version: string;
+    epicId?: string;
+    projectRoot?: string;
+}
+/** How a PR-create attempt resolved. */
+export type PRMode = 'created' | 'manual' | 'skipped';
+/** Outcome of `createPullRequest`. */
+export interface PRResult {
+    mode: PRMode;
+    prUrl?: string;
+    prNumber?: number;
+    instructions?: string;
+    error?: string;
+}
+/** Parsed `owner/repo` pair extracted from a git remote URL. */
+export interface RepoIdentity {
+    owner: string;
+    repo: string;
+}
+/**
+ * Names of the labels CLEO knows how to auto-create when they are missing
+ * on a repo. Includes the universal `release` flag plus one label per npm
+ * dist-tag channel.
+ */
+export type CleoKnownLabel = 'release' | ReleaseChannel;
+/** Color + description used when CLEO auto-creates one of its known labels. */
+export interface LabelDefinition {
+    color: string;
+    description: string;
+}
+/** Static palette of CLEO-known labels keyed by label name. */
+export type CleoLabelPalette = Readonly<Record<CleoKnownLabel, LabelDefinition>>;
+/** Outcome of {@link ensureCleoLabelsExist}. */
+export interface LabelEnsureResult {
+    /** Labels that exist on the repo after this call (pre-existed or auto-created). */
+    ensured: string[];
+    /** Labels that this call created. */
+    created: string[];
+    /** Labels that could not be ensured (unknown to CLEO, or `gh label create` failed). */
+    missing: string[];
+}
+/** Outcome of {@link resolvePRLabels} — what to actually pass to `gh pr create`. */
+export interface PRLabelResolution {
+    /** Labels safe to pass to `gh pr create`. */
+    labels: string[];
+    /** Labels auto-created during resolution. */
+    created: string[];
+    /** Labels dropped because they could not be ensured. */
+    missing: string[];
+}
+//# sourceMappingURL=github-pr.d.ts.map

package/dist/release/github-pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pr.d.ts","sourceRoot":"","sources":["../../src/release/github-pr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,sCAAsC;AACtC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,cAAc,CAAC;AAExD,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;AAEjF,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uFAAuF;IACvF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/release/github-pr.js

@@ -0,0 +1,12 @@
+/**
+ * GitHub PR contracts — types describing the PR-creation surface used by
+ * the release pipeline.
+ *
+ * The implementation lives in `@cleocode/core/release/github-pr.ts`. The
+ * types live here so consumers (CLI, studio, downstream tools) can describe
+ * / validate the same shapes without depending on core.
+ *
+ * @adr ADR-063
+ */
+export {};
+//# sourceMappingURL=github-pr.js.map

package/dist/release/github-pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pr.js","sourceRoot":"","sources":["../../src/release/github-pr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}