@cleocode/contracts 2026.5.77 → 2026.5.79

package/dist/release/plan.test.js

@@ -0,0 +1,414 @@
+/**
+ * Zod schema tests for the Release Plan envelope (T9527).
+ *
+ * Validates the canonical SPEC-T9345 §6.1 shape against the Zod schema defined
+ * in {@link ./plan.ts}. Coverage targets:
+ *
+ * - Happy-path parse round-trip
+ * - Each enum field rejects unknown literal values
+ * - Required fields cannot be missing
+ * - `evidenceAtoms` stays permissive (verb-level enforcement, NOT contract)
+ * - All 8 `status` FSM values parse
+ * - `meta` is forward-compat (unknown keys pass through via `.catchall`)
+ *
+ * @task T9527
+ */
+import { describe, expect, it } from 'vitest';
+import { GATE_NAME, GATE_STATUS, IMPACT, PLATFORM_TUPLE, PUBLISHER, parseReleasePlan, RELEASE_CHANNEL, RELEASE_KIND, RELEASE_PLAN_SCHEMA_URL, RELEASE_PLAN_SCHEMA_VERSION, RELEASE_SCHEME, RELEASE_STATUS, RESOLVED_SOURCE, ReleaseGateSchema, ReleasePlanChangelogSchema, ReleasePlanMetaSchema, ReleasePlanSchema, ReleasePlanTaskSchema, ReleasePlatformMatrixEntrySchema, ReleasePreflightSummarySchema, safeParseReleasePlan, TASK_KIND, } from './plan.js';
+// ─── Fixtures ────────────────────────────────────────────────────────────────
+/**
+ * Returns a fresh deep clone of a minimal-but-complete valid plan. Each test
+ * mutates its own copy to test field-level rejection paths.
+ */
+function makeValidPlan() {
+    return {
+        $schema: RELEASE_PLAN_SCHEMA_URL,
+        version: 'v2026.6.0',
+        resolvedVersion: 'v2026.6.0',
+        suffixApplied: false,
+        scheme: 'calver',
+        channel: 'latest',
+        epicId: 'T9999',
+        releaseKind: 'regular',
+        createdAt: '2026-06-01T12:00:00Z',
+        createdBy: 'cleo-prime',
+        previousVersion: 'v2026.5.74',
+        previousTag: 'v2026.5.74',
+        previousShippedAt: '2026-05-15T08:00:00Z',
+        tasks: [
+            {
+                id: 'T10001',
+                kind: 'feat',
+                impact: 'minor',
+                userFacingSummary: 'Add release plan schema',
+                evidenceAtoms: ['commit:abc123', 'test-run:vitest.json', 'tool:lint'],
+                ivtrPhaseAtPlan: 'released',
+                epicAncestor: 'T9999',
+            },
+        ],
+        changelog: {
+            features: ['T10001'],
+            fixes: [],
+            chores: [],
+            breaking: [],
+        },
+        gates: [
+            {
+                name: 'test',
+                atom: 'tool:test',
+                status: 'passed',
+                lastVerifiedAt: '2026-06-01T11:50:00Z',
+                resolvedCommand: 'pnpm run test',
+                resolvedSource: 'project-context',
+            },
+        ],
+        platformMatrix: [
+            {
+                platform: 'linux-x64',
+                publisher: 'npm',
+                package: '@cleocode/cleo',
+                smoke: true,
+            },
+        ],
+        preflightSummary: {
+            esbuildExternalsDrift: false,
+            lockfileDrift: false,
+            epicCompletenessClean: true,
+            doubleListingClean: true,
+            preflightWarnings: [],
+        },
+        workflowRunUrl: null,
+        prUrl: null,
+        mergeCommitSha: null,
+        status: 'planned',
+        meta: {
+            firstEverRelease: false,
+            unresolvedTools: [],
+            archetype: 'monorepo-w-workspaces',
+        },
+    };
+}
+// ─── Constant tuples ─────────────────────────────────────────────────────────
+describe('Release plan constant tuples', () => {
+    it('exports an 8-state status FSM', () => {
+        expect(RELEASE_STATUS).toEqual([
+            'planned',
+            'pr-opened',
+            'pr-merged',
+            'published',
+            'reconciled',
+            'rolled_back',
+            'failed',
+            'cancelled',
+        ]);
+        expect(RELEASE_STATUS).toHaveLength(8);
+    });
+    it('exports the 4-channel set (latest|beta|alpha|rc)', () => {
+        expect(new Set(RELEASE_CHANNEL)).toEqual(new Set(['latest', 'beta', 'alpha', 'rc']));
+    });
+    it('exports the 3-scheme set including calver-suffix', () => {
+        expect(RELEASE_SCHEME).toContain('calver');
+        expect(RELEASE_SCHEME).toContain('semver');
+        expect(RELEASE_SCHEME).toContain('calver-suffix');
+    });
+    it('exports release-kind variants', () => {
+        expect(new Set(RELEASE_KIND)).toEqual(new Set(['regular', 'hotfix', 'prerelease']));
+    });
+    it('exports the 4-status gate enum', () => {
+        expect(new Set(GATE_STATUS)).toEqual(new Set(['passed', 'failed', 'skipped', 'unresolved']));
+    });
+    it('exports canonical gate names (R-310)', () => {
+        expect(GATE_NAME).toContain('test');
+        expect(GATE_NAME).toContain('build');
+        expect(GATE_NAME).toContain('lint');
+        expect(GATE_NAME).toContain('typecheck');
+        expect(GATE_NAME).toContain('audit');
+        expect(GATE_NAME).toContain('security-scan');
+    });
+    it('exports platform tuples aligned with T1737', () => {
+        expect(PLATFORM_TUPLE).toContain('linux-x64');
+        expect(PLATFORM_TUPLE).toContain('linux-arm64');
+        expect(PLATFORM_TUPLE).toContain('macos-x64');
+        expect(PLATFORM_TUPLE).toContain('macos-arm64');
+        expect(PLATFORM_TUPLE).toContain('windows-x64');
+        expect(PLATFORM_TUPLE).toContain('any');
+    });
+    it('exports publisher backends covering npm/cargo/docker/pypi/github-release/binary', () => {
+        expect(new Set(PUBLISHER)).toEqual(new Set(['npm', 'cargo', 'docker', 'pypi', 'github-release', 'binary']));
+    });
+    it('exports task-kind classification', () => {
+        expect(TASK_KIND).toContain('feat');
+        expect(TASK_KIND).toContain('fix');
+        expect(TASK_KIND).toContain('hotfix');
+        expect(TASK_KIND).toContain('breaking');
+    });
+    it('exports SemVer impact tuple', () => {
+        expect(IMPACT).toEqual(['major', 'minor', 'patch']);
+    });
+    it('exports resolved-source attribution per ADR-061', () => {
+        expect(RESOLVED_SOURCE).toEqual(['project-context', 'language-default', 'legacy-alias']);
+    });
+    it('exposes a stable schema version + URL', () => {
+        expect(RELEASE_PLAN_SCHEMA_VERSION).toBe('1.0.0');
+        expect(RELEASE_PLAN_SCHEMA_URL).toBe('https://cleocode.io/schemas/release-plan/v1.json');
+    });
+});
+// ─── Happy path ──────────────────────────────────────────────────────────────
+describe('ReleasePlanSchema — happy path', () => {
+    it('parses a complete valid plan', () => {
+        const plan = parseReleasePlan(makeValidPlan());
+        expect(plan.version).toBe('v2026.6.0');
+        expect(plan.status).toBe('planned');
+        expect(plan.tasks).toHaveLength(1);
+        expect(plan.tasks[0]?.id).toBe('T10001');
+        expect(plan.platformMatrix[0]?.publisher).toBe('npm');
+    });
+    it('safeParse returns success for a valid plan', () => {
+        const result = safeParseReleasePlan(makeValidPlan());
+        expect(result.success).toBe(true);
+    });
+    it('round-trips through JSON.stringify / parse', () => {
+        const original = makeValidPlan();
+        const serialized = JSON.stringify(original);
+        const reparsed = parseReleasePlan(JSON.parse(serialized));
+        expect(reparsed).toEqual(original);
+    });
+    it('accepts a first-ever release with null previousVersion + meta.firstEverRelease', () => {
+        const plan = makeValidPlan();
+        plan.previousVersion = null;
+        plan.previousTag = null;
+        plan.previousShippedAt = null;
+        plan.meta = { firstEverRelease: true };
+        expect(() => parseReleasePlan(plan)).not.toThrow();
+    });
+});
+// ─── Status FSM coverage ─────────────────────────────────────────────────────
+describe('ReleasePlanSchema — status FSM', () => {
+    it.each(RELEASE_STATUS)('accepts status = "%s"', (status) => {
+        const plan = makeValidPlan();
+        plan.status = status;
+        expect(() => parseReleasePlan(plan)).not.toThrow();
+    });
+    it('rejects unknown status literals', () => {
+        const plan = { ...makeValidPlan(), status: 'in-flight' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+});
+// ─── Enum rejection per field ────────────────────────────────────────────────
+describe('ReleasePlanSchema — enum rejection', () => {
+    it('rejects unknown channel', () => {
+        const plan = { ...makeValidPlan(), channel: 'canary' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown scheme', () => {
+        const plan = { ...makeValidPlan(), scheme: 'rolling' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown releaseKind', () => {
+        const plan = { ...makeValidPlan(), releaseKind: 'patch' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown task kind', () => {
+        const plan = makeValidPlan();
+        plan.tasks[0] = { ...plan.tasks[0], kind: 'misc' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown impact', () => {
+        const plan = makeValidPlan();
+        plan.tasks[0] = { ...plan.tasks[0], impact: 'huge' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown gate name', () => {
+        const plan = makeValidPlan();
+        plan.gates[0] = { ...plan.gates[0], name: 'fmt' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown gate status', () => {
+        const plan = makeValidPlan();
+        plan.gates[0] = { ...plan.gates[0], status: 'flaky' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown platform tuple', () => {
+        const plan = makeValidPlan();
+        plan.platformMatrix[0] = { ...plan.platformMatrix[0], platform: 'haiku-x64' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown publisher', () => {
+        const plan = makeValidPlan();
+        plan.platformMatrix[0] = { ...plan.platformMatrix[0], publisher: 'gemfury' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown resolvedSource', () => {
+        const plan = makeValidPlan();
+        plan.gates[0] = { ...plan.gates[0], resolvedSource: 'env-override' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+});
+// ─── Required-field rejection ────────────────────────────────────────────────
+describe('ReleasePlanSchema — required fields', () => {
+    it('rejects missing version', () => {
+        const plan = makeValidPlan();
+        delete plan.version;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing epicId', () => {
+        const plan = makeValidPlan();
+        delete plan.epicId;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects empty epicId string', () => {
+        const plan = { ...makeValidPlan(), epicId: '' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing tasks array', () => {
+        const plan = makeValidPlan();
+        delete plan.tasks;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing changelog object', () => {
+        const plan = makeValidPlan();
+        delete plan.changelog;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing preflightSummary', () => {
+        const plan = makeValidPlan();
+        delete plan.preflightSummary;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing epicAncestor on a task row', () => {
+        const plan = makeValidPlan();
+        const taskWithoutAncestor = { ...plan.tasks[0] };
+        delete taskWithoutAncestor.epicAncestor;
+        plan.tasks[0] = taskWithoutAncestor;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects malformed createdAt timestamp', () => {
+        const plan = { ...makeValidPlan(), createdAt: 'yesterday' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+});
+// ─── Evidence atoms (contract permissive — R-301 verb-enforced) ─────────────
+describe('ReleasePlanTaskSchema — evidenceAtoms', () => {
+    it('accepts a string[] for evidenceAtoms', () => {
+        const result = ReleasePlanTaskSchema.parse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: ['commit:abc'],
+            epicAncestor: 'E1',
+        });
+        expect(result.evidenceAtoms).toEqual(['commit:abc']);
+    });
+    it('permits an empty evidenceAtoms array at the contract layer (R-301 is verb-enforced)', () => {
+        const result = ReleasePlanTaskSchema.safeParse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: [],
+            epicAncestor: 'E1',
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects non-array evidenceAtoms', () => {
+        const result = ReleasePlanTaskSchema.safeParse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: 'commit:abc',
+            epicAncestor: 'E1',
+        });
+        expect(result.success).toBe(false);
+    });
+    it('rejects empty-string atom entries (NonEmptyString)', () => {
+        const result = ReleasePlanTaskSchema.safeParse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: [''],
+            epicAncestor: 'E1',
+        });
+        expect(result.success).toBe(false);
+    });
+});
+// ─── meta forward-compat ─────────────────────────────────────────────────────
+describe('ReleasePlanMetaSchema — forward compatibility', () => {
+    it('preserves unknown keys via catchall', () => {
+        const result = ReleasePlanMetaSchema.parse({
+            firstEverRelease: false,
+            futureField: 'someValue',
+            anotherUnknown: { nested: true },
+        });
+        expect(result.futureField).toBe('someValue');
+        expect(result.anotherUnknown).toEqual({ nested: true });
+    });
+    it('still validates known fields strictly', () => {
+        const result = ReleasePlanMetaSchema.safeParse({
+            firstEverRelease: 'yes',
+        });
+        expect(result.success).toBe(false);
+    });
+    it('accepts a fully-empty meta object', () => {
+        expect(() => ReleasePlanMetaSchema.parse({})).not.toThrow();
+    });
+});
+// ─── Nested-schema sanity ────────────────────────────────────────────────────
+describe('Nested schemas — sanity', () => {
+    it('ReleaseGateSchema requires lastVerifiedAt to be ISO-8601', () => {
+        const result = ReleaseGateSchema.safeParse({
+            name: 'test',
+            atom: 'tool:test',
+            status: 'passed',
+            lastVerifiedAt: 'Tuesday',
+        });
+        expect(result.success).toBe(false);
+    });
+    it('ReleasePlatformMatrixEntrySchema applies smoke=true default when omitted', () => {
+        const result = ReleasePlatformMatrixEntrySchema.parse({
+            platform: 'any',
+            publisher: 'npm',
+            package: '@cleocode/lafs',
+        });
+        expect(result.smoke).toBe(true);
+    });
+    it('ReleasePreflightSummarySchema requires the four boolean preflight gates', () => {
+        const result = ReleasePreflightSummarySchema.safeParse({
+            esbuildExternalsDrift: false,
+            lockfileDrift: false,
+            epicCompletenessClean: true,
+            // doubleListingClean omitted
+        });
+        expect(result.success).toBe(false);
+    });
+    it('ReleasePlanChangelogSchema applies empty-array defaults for omitted buckets', () => {
+        const result = ReleasePlanChangelogSchema.parse({});
+        expect(result.features).toEqual([]);
+        expect(result.fixes).toEqual([]);
+        expect(result.chores).toEqual([]);
+        expect(result.breaking).toEqual([]);
+    });
+    it('ReleasePlanSchema accepts plans with no tasks (e.g. config-only releases)', () => {
+        const plan = makeValidPlan();
+        plan.tasks = [];
+        plan.changelog.features = [];
+        expect(() => parseReleasePlan(plan)).not.toThrow();
+    });
+    it('safeParseReleasePlan surfaces issues for bad enums', () => {
+        const result = safeParseReleasePlan({ ...makeValidPlan(), channel: 'invalid-channel' });
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error.issues.length).toBeGreaterThan(0);
+        }
+    });
+});
+// ─── Schema export sanity ────────────────────────────────────────────────────
+describe('ReleasePlanSchema — module surface', () => {
+    it('exports a Zod object schema at the top level', () => {
+        expect(typeof ReleasePlanSchema.parse).toBe('function');
+        expect(typeof ReleasePlanSchema.safeParse).toBe('function');
+    });
+});
+//# sourceMappingURL=plan.test.js.map

package/dist/release/plan.test.js.map

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

package/dist/tasks/archive.d.ts

@@ -51,8 +51,8 @@ import { z } from 'zod';
 export declare const ArchiveReason: z.ZodEnum<{
     cancelled: "cancelled";
     superseded: "superseded";
-    verified: "verified";
     reconciled: "reconciled";
+    verified: "verified";
     shadowed: "shadowed";
     "completed-unverified": "completed-unverified";
 }>;
@@ -67,8 +67,8 @@ export declare const ArchiveReason: z.ZodEnum<{
 export declare const ArchiveReasonSchema: z.ZodEnum<{
     cancelled: "cancelled";
     superseded: "superseded";
-    verified: "verified";
     reconciled: "reconciled";
+    verified: "verified";
     shadowed: "shadowed";
     "completed-unverified": "completed-unverified";
 }>;
@@ -93,7 +93,7 @@ export type ArchiveReasonValue = z.infer<typeof ArchiveReason>;
  * Useful when a Drizzle column or a discriminated union needs the raw
  * tuple form (e.g. `text('archive_reason', { enum: ARCHIVE_REASON_VALUES })`).
  */
-export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "verified" | "reconciled" | "shadowed" | "completed-unverified")[];
+export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "reconciled" | "verified" | "shadowed" | "completed-unverified")[];
 /**
  * The single tombstone value within {@link ArchiveReason}.
  *

package/package.json

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

package/src/config.ts

@@ -175,14 +175,19 @@ export interface SharingConfig {
 /**
  * Memory bridge injection mode.
  *
- * - `'cli'`  — AGENTS.md receives a `cleo memory digest --brief` CLI directive instead of
- *              `@.cleo/memory-bridge.md`. The bridge markdown file is NOT written on refresh.
- *              This is the default for new installations (T999).
- * - `'file'` — Legacy behavior: `.cleo/memory-bridge.md` is written on refresh and
- *              `@.cleo/memory-bridge.md` is injected into AGENTS.md verbatim.
- *              Use this for backcompat with tooling that reads the file directly.
+ * - `'cli'`      — AGENTS.md receives a `cleo memory digest --brief` CLI directive instead of
+ *                  `@.cleo/memory-bridge.md`. The bridge markdown file is NOT written on refresh.
+ *                  This is the default for new installations (T999). Also surfaced to operators
+ *                  as the `digest` mode in `cleo setup` (T9425) — the wire value stays `'cli'`
+ *                  so existing project configs keep working unchanged.
+ * - `'file'`     — Legacy behavior: `.cleo/memory-bridge.md` is written on refresh and
+ *                  `@.cleo/memory-bridge.md` is injected into AGENTS.md verbatim.
+ *                  Use this for backcompat with tooling that reads the file directly.
+ * - `'disabled'` — Bridge injection is suppressed entirely; AGENTS.md gets neither a CLI
+ *                  directive nor a file include. Operators select this from `cleo setup`
+ *                  when they want to opt out of BRAIN-driven AGENTS.md augmentation (T9425).
  */
-export type MemoryBridgeMode = 'cli' | 'file';
+export type MemoryBridgeMode = 'cli' | 'file' | 'disabled';
 
 /**
  * Brain memory bridge refresh configuration.
@@ -588,6 +593,61 @@ export interface CleoConfig {
    * @defaultValue undefined
    */
   briefing?: BriefingConfig;
+  /**
+   * Auth-source consent gates for credential seeders.
+   *
+   * Gates third-party credential imports (e.g. Claude Code OAuth) behind
+   * explicit operator opt-in. Mirrors Hermes Agent's PR #4210 consent gate.
+   *
+   * @defaultValue undefined
+   * @task T9410
+   */
+  auth?: AuthConfig;
+}
+
+/**
+ * Auth-source consent configuration.
+ *
+ * Concrete `CredentialSeeder` implementations consult these flags before
+ * reading any third-party credential file (e.g. `~/.claude/.credentials.json`).
+ * Defaulting every flag to `false` keeps auxiliary fallback chains opt-in:
+ * aux callers cannot silently read user credentials they were never granted.
+ *
+ * @task T9410
+ */
+export interface AuthConfig {
+  /**
+   * Whether the operator has explicitly opted in to import the Claude Code
+   * OAuth token (`~/.claude/.credentials.json`) into the CLEO credential
+   * pool.
+   *
+   * When `false` (default), the `claude-code` seeder MUST NOT read the file
+   * and MUST return an empty seeder result. When `true`, the seeder reads
+   * the file and emits a single `source: 'claude-code'` entry for the
+   * `anthropic` provider.
+   *
+   * @defaultValue false
+   */
+  claudeCodeConsentGiven?: boolean;
+  /**
+   * Whether CLEO writes refreshed Anthropic OAuth tokens back to Claude
+   * Code's credential file (`~/.claude/.credentials.json`) in addition to
+   * CLEO's own canonical token file (`${getCleoHome()}/anthropic-oauth.json`).
+   *
+   * CLEO ALWAYS writes its own file on every refresh. The cooperative write
+   * to Claude Code's file is gated by this flag AND by either
+   * (a) the Claude Code file already existing on disk, or
+   * (b) `claudeCodeConsentGiven` being `true`.
+   *
+   * This mirrors the OQ-1 decision in `docs/plans/E-CONFIG-AUTH-UNIFY.md`:
+   * cooperative write-back is enabled by default so two CLIs sharing one
+   * machine stay token-coherent, but CLEO never creates Claude Code's file
+   * unless the operator has explicitly opted in.
+   *
+   * @defaultValue true
+   * @task T9411
+   */
+  cooperativeWriteBack?: boolean;
 }
 
 /**

package/src/credentials.ts

@@ -32,6 +32,16 @@ export interface ClaudeCodeOAuthBlock {
   expiresAt?: number;
   /** Refresh token for obtaining new access tokens. Optional. */
   refreshToken?: string;
+  /**
+   * OAuth scopes granted to the token, e.g. `['user:inference']`.
+   *
+   * Claude Code >= 2.1.81 requires the `user:inference` scope on its OAuth
+   * tokens; cooperative write-back (T9411) preserves whatever scopes are
+   * already on disk so we never strip the field on refresh.
+   *
+   * @task T9411
+   */
+  scopes?: string[];
 }
 
 /**
@@ -47,6 +57,16 @@ export interface ParsedClaudeCodeCredential {
   expiresAt?: number;
   /** Refresh token, if present in the credentials file. */
   refreshToken?: string;
+  /**
+   * OAuth scopes granted to the token, if present in the credentials file.
+   *
+   * Preserved verbatim by the parser — `parseClaudeCodeCredentials` does not
+   * filter or normalize the array. Cooperative write-back (T9411) relies on
+   * this to keep Claude Code's `user:inference` scope intact across refreshes.
+   *
+   * @task T9411
+   */
+  scopes?: string[];
 }
 
 // ---------------------------------------------------------------------------
@@ -103,10 +123,19 @@ export function parseClaudeCodeCredentials(
         ? block['refreshToken']
         : undefined;
 
+    // T9411 — preserve `scopes` verbatim so cooperative write-back keeps
+    // Claude Code's `user:inference` grant intact across refreshes.
+    const rawScopes = block['scopes'];
+    const scopes =
+      Array.isArray(rawScopes) && rawScopes.every((s) => typeof s === 'string')
+        ? (rawScopes as string[])
+        : undefined;
+
     return {
       accessToken: accessToken.trim(),
       ...(expiresAt !== undefined ? { expiresAt } : {}),
       ...(refreshToken !== undefined ? { refreshToken } : {}),
+      ...(scopes !== undefined ? { scopes } : {}),
     };
   } catch {
     return null;