@cleocode/contracts 2026.5.114 → 2026.5.121

package/dist/changesets.d.ts

@@ -52,6 +52,64 @@ import { z } from 'zod';
 export declare const CHANGESET_KINDS: readonly ["feat", "fix", "perf", "refactor", "docs", "test", "chore", "breaking"];
 /** Allowed values of {@link ChangesetEntry.kind}. */
 export type ChangesetKind = (typeof CHANGESET_KINDS)[number];
+/**
+ * Deterministic release-note section override used by zero-token renderers.
+ *
+ * These values intentionally mirror Keep-a-Changelog style headings so release
+ * tooling can render higher-quality notes without an LLM/API/token dependency.
+ */
+export declare const CHANGESET_RELEASE_NOTE_SECTIONS: readonly ["added", "changed", "fixed", "deprecated", "removed", "security", "breaking"];
+/** Allowed values of {@link ChangesetReleaseNotesMetadata.section}. */
+export type ChangesetReleaseNoteSection = (typeof CHANGESET_RELEASE_NOTE_SECTIONS)[number];
+/** Audience labels for deterministic release-note routing. */
+export declare const CHANGESET_RELEASE_NOTE_AUDIENCES: readonly ["users", "operators", "developers", "maintainers"];
+/** Allowed values of {@link ChangesetReleaseNotesMetadata.audience}. */
+export type ChangesetReleaseNoteAudience = (typeof CHANGESET_RELEASE_NOTE_AUDIENCES)[number];
+/** Scope labels for deterministic release-note routing. */
+export declare const CHANGESET_RELEASE_NOTE_SCOPES: readonly ["project", "package", "component", "docs", "ops", "security"];
+/** Allowed values of {@link ChangesetReleaseNotesMetadata.scope}. */
+export type ChangesetReleaseNoteScope = (typeof CHANGESET_RELEASE_NOTE_SCOPES)[number];
+/**
+ * Optional deterministic metadata for release-note rendering.
+ *
+ * This is deliberately small, explicit, and strict: it gives release tooling
+ * structured author-provided facts (section, audience, target, impact, etc.)
+ * while preserving zero-token defaults and failing loudly on misspelled fields.
+ */
+export declare const ChangesetReleaseNotesMetadataSchema: z.ZodObject<{
+    section: z.ZodOptional<z.ZodEnum<{
+        removed: "removed";
+        deprecated: "deprecated";
+        security: "security";
+        fixed: "fixed";
+        breaking: "breaking";
+        added: "added";
+        changed: "changed";
+    }>>;
+    audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        users: "users";
+        operators: "operators";
+        developers: "developers";
+        maintainers: "maintainers";
+    }>>>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        project: "project";
+        security: "security";
+        docs: "docs";
+        package: "package";
+        component: "component";
+        ops: "ops";
+    }>>;
+    targets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    impact: z.ZodOptional<z.ZodString>;
+    migration: z.ZodOptional<z.ZodString>;
+    deprecation: z.ZodOptional<z.ZodString>;
+    security: z.ZodOptional<z.ZodString>;
+    operatorNotes: z.ZodOptional<z.ZodString>;
+    includeInChangelog: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** Inferred TypeScript type for deterministic release-note metadata. */
+export type ChangesetReleaseNotesMetadata = z.infer<typeof ChangesetReleaseNotesMetadataSchema>;
 /**
  * Zod schema for a single changeset entry. Validates frontmatter fields
  * + markdown body of a file under `.changeset/*.md`.
@@ -66,6 +124,7 @@ export type ChangesetKind = (typeof CHANGESET_KINDS)[number];
  * - `prs`      — linked PR numbers
  * - `notes`    — longer-form markdown body
  * - `breaking` — required migration note when `kind === 'breaking'`
+ * - `releaseNotes` — deterministic zero-token release-note metadata
  */
 export declare const ChangesetEntrySchema: z.ZodObject<{
     id: z.ZodString;
@@ -84,6 +143,38 @@ export declare const ChangesetEntrySchema: z.ZodObject<{
     prs: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     notes: z.ZodOptional<z.ZodString>;
     breaking: z.ZodOptional<z.ZodString>;
+    releaseNotes: z.ZodOptional<z.ZodObject<{
+        section: z.ZodOptional<z.ZodEnum<{
+            removed: "removed";
+            deprecated: "deprecated";
+            security: "security";
+            fixed: "fixed";
+            breaking: "breaking";
+            added: "added";
+            changed: "changed";
+        }>>;
+        audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            users: "users";
+            operators: "operators";
+            developers: "developers";
+            maintainers: "maintainers";
+        }>>>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            project: "project";
+            security: "security";
+            docs: "docs";
+            package: "package";
+            component: "component";
+            ops: "ops";
+        }>>;
+        targets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        impact: z.ZodOptional<z.ZodString>;
+        migration: z.ZodOptional<z.ZodString>;
+        deprecation: z.ZodOptional<z.ZodString>;
+        security: z.ZodOptional<z.ZodString>;
+        operatorNotes: z.ZodOptional<z.ZodString>;
+        includeInChangelog: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 /**
  * Inferred TypeScript type for a parsed changeset entry.

package/dist/changesets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changesets.d.ts","sourceRoot":"","sources":["../src/changesets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,mFASlB,CAAC;AAEX,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAc7D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;iBAyB7B,CAAC;AAEL;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"changesets.d.ts","sourceRoot":"","sources":["../src/changesets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,mFASlB,CAAC;AAEX,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAI7D;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,yFAQlC,CAAC;AAEX,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3F,8DAA8D;AAC9D,eAAO,MAAM,gCAAgC,8DAKnC,CAAC;AAEX,wEAAwE;AACxE,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7F,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B,yEAOhC,CAAC;AAEX,qEAAqE;AACrE,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAOvF;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBrC,CAAC;AAEZ,wEAAwE;AACxE,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAchG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8B7B,CAAC;AAEL;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/changesets.js

@@ -60,6 +60,73 @@ export const CHANGESET_KINDS = [
     'chore',
     'breaking',
 ];
+// ─── Release-note metadata ───────────────────────────────────────────────────
+/**
+ * Deterministic release-note section override used by zero-token renderers.
+ *
+ * These values intentionally mirror Keep-a-Changelog style headings so release
+ * tooling can render higher-quality notes without an LLM/API/token dependency.
+ */
+export const CHANGESET_RELEASE_NOTE_SECTIONS = [
+    'added',
+    'changed',
+    'fixed',
+    'deprecated',
+    'removed',
+    'security',
+    'breaking',
+];
+/** Audience labels for deterministic release-note routing. */
+export const CHANGESET_RELEASE_NOTE_AUDIENCES = [
+    'users',
+    'operators',
+    'developers',
+    'maintainers',
+];
+/** Scope labels for deterministic release-note routing. */
+export const CHANGESET_RELEASE_NOTE_SCOPES = [
+    'project',
+    'package',
+    'component',
+    'docs',
+    'ops',
+    'security',
+];
+const nonEmptyReleaseNoteText = z.string().min(1, 'release-note metadata text must be non-empty');
+const nonEmptyReleaseNoteList = z
+    .array(nonEmptyReleaseNoteText)
+    .min(1, 'release-note metadata list must contain at least one item');
+/**
+ * Optional deterministic metadata for release-note rendering.
+ *
+ * This is deliberately small, explicit, and strict: it gives release tooling
+ * structured author-provided facts (section, audience, target, impact, etc.)
+ * while preserving zero-token defaults and failing loudly on misspelled fields.
+ */
+export const ChangesetReleaseNotesMetadataSchema = z
+    .object({
+    /** Keep-a-Changelog style section/category override. */
+    section: z.enum(CHANGESET_RELEASE_NOTE_SECTIONS).optional(),
+    /** Intended readers for the note. */
+    audience: z.array(z.enum(CHANGESET_RELEASE_NOTE_AUDIENCES)).min(1).optional(),
+    /** Release-note scope. */
+    scope: z.enum(CHANGESET_RELEASE_NOTE_SCOPES).optional(),
+    /** Package/project/component targets affected by this entry. */
+    targets: nonEmptyReleaseNoteList.optional(),
+    /** User- or operator-visible impact statement. */
+    impact: nonEmptyReleaseNoteText.optional(),
+    /** Deterministic migration/action text, separate from breaking changes. */
+    migration: nonEmptyReleaseNoteText.optional(),
+    /** Deprecation detail for Deprecated sections. */
+    deprecation: nonEmptyReleaseNoteText.optional(),
+    /** Security detail for Security sections. */
+    security: nonEmptyReleaseNoteText.optional(),
+    /** Operator-facing rollout/verification note. */
+    operatorNotes: nonEmptyReleaseNoteText.optional(),
+    /** Explicit inclusion toggle for future release-scope filters. */
+    includeInChangelog: z.boolean().optional(),
+})
+    .strict();
 // ─── Task ID validator ────────────────────────────────────────────────────────
 /**
  * Matches a CLEO task identifier: `T####` (task) or `E-####` (epic display
@@ -83,14 +150,15 @@ const TASK_ID_RE = /^(T\d+(-[A-Z][A-Za-z0-9]*)?|E-\d+(-[A-Z][A-Za-z0-9]*)?)$/;
  * - `prs`      — linked PR numbers
  * - `notes`    — longer-form markdown body
  * - `breaking` — required migration note when `kind === 'breaking'`
+ * - `releaseNotes` — deterministic zero-token release-note metadata
  */
 export const ChangesetEntrySchema = z
     .object({
-    /** Filename slug (without the `.md` extension). */
+    /** Filename identifier (without the `.md` extension); lowercase kebab-case for new files, legacy uppercase task IDs accepted. */
     id: z
         .string()
         .min(1, 'id must be non-empty')
-        .regex(/^[a-z0-9][a-z0-9-]*$/, 'id must be kebab-case (lowercase, digits, hyphens)'),
+        .regex(/^[A-Za-z0-9][A-Za-z0-9-]*$/, 'id must contain only ASCII letters, digits, and hyphens'),
     /** One or more CLEO task IDs this change is anchored to. */
     tasks: z
         .array(z.string().regex(TASK_ID_RE, 'task ID must match T#### or E-#### format'))
@@ -105,6 +173,8 @@ export const ChangesetEntrySchema = z
     notes: z.string().optional(),
     /** Migration note. Required iff `kind === 'breaking'`. */
     breaking: z.string().optional(),
+    /** Structured author-provided metadata for deterministic release notes. */
+    releaseNotes: ChangesetReleaseNotesMetadataSchema.optional(),
 })
     .refine((entry) => entry.kind !== 'breaking' || (entry.breaking?.length ?? 0) > 0, {
     message: 'breaking entries must include a non-empty `breaking` migration note',

package/dist/changesets.js.map

@@ -1 +1 @@
-{"version":3,"file":"changesets.js","sourceRoot":"","sources":["../src/changesets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,KAAK;IACL,MAAM;IACN,UAAU;IACV,MAAM;IACN,MAAM;IACN,OAAO;IACP,UAAU;CACF,CAAC;AAKX,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,GAAG,0DAA0D,CAAC;AAE9E,iFAAiF;AAEjF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,mDAAmD;IACnD,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;SAC9B,KAAK,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;IACtF,4DAA4D;IAC5D,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,2CAA2C,CAAC,CAAC;SAChF,GAAG,CAAC,CAAC,EAAE,yCAAyC,CAAC;IACpD,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACvD,qCAAqC;IACrC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,+CAA+C;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,0DAA0D;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE;IACjF,OAAO,EAAE,qEAAqE;IAC9E,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CAAC,CAAC"}
+{"version":3,"file":"changesets.js","sourceRoot":"","sources":["../src/changesets.ts"],"names":[],"mappings":"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"}

package/dist/dispatch/operations-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAMD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EAu1PpC,CAAC"}
+{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAMD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EAk/PpC,CAAC"}

package/dist/dispatch/operations-registry.js

@@ -2286,6 +2286,39 @@ export const OPERATIONS = [
             },
         ],
     },
+    {
+        gateway: 'mutate',
+        domain: 'tasks',
+        operation: 'relates.remove',
+        description: 'tasks.relates.remove (mutate) — delete a relation between two tasks. Pass `type` to scope deletion to a single relation kind; omit to remove any type.',
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ['taskId', 'relatedId'],
+        params: [
+            {
+                name: 'taskId',
+                type: 'string',
+                required: true,
+                description: 'Source task ID',
+                cli: { positional: true },
+            },
+            {
+                name: 'relatedId',
+                type: 'string',
+                required: true,
+                description: 'Target task ID to remove the relation to',
+                cli: { positional: true },
+            },
+            {
+                name: 'type',
+                type: 'string',
+                required: false,
+                description: 'Optional relation type (blocks|related|duplicates|absorbs|fixes|extends|supersedes). Omit to remove any type.',
+                cli: { flag: 'type' },
+            },
+        ],
+    },
     // === saga sub-domain (ADR-073 — above-epic grouping tier) ===
     {
         gateway: 'mutate',
@@ -6577,6 +6610,39 @@ export const OPERATIONS = [
             },
         ],
     },
+    // ── docs.supersede (T10162) ──────────────────────────────────────────────
+    {
+        gateway: 'mutate',
+        domain: 'docs',
+        operation: 'supersede',
+        description: 'docs.supersede (mutate) — atomically flip an older doc to `superseded` and link both rows via the supersedes/superseded_by self-FK pointers (T10162 · Saga T9855)',
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ['oldSlug', 'newSlug'],
+        params: [
+            {
+                name: 'oldSlug',
+                type: 'string',
+                required: true,
+                description: 'Slug of the doc being replaced',
+                cli: { positional: true },
+            },
+            {
+                name: 'newSlug',
+                type: 'string',
+                required: true,
+                description: 'Slug of the doc that replaces oldSlug',
+                cli: { positional: true },
+            },
+            {
+                name: 'reason',
+                type: 'string',
+                required: false,
+                description: 'Optional human-readable reason carried back on the response',
+            },
+        ],
+    },
     // ── docs.generate (T798) ─────────────────────────────────────────────────
     {
         gateway: 'query',
@@ -6602,6 +6668,59 @@ export const OPERATIONS = [
             },
         ],
     },
+    // ── docs.update (T10161 — Epic T10157 / Saga T9855) ──────────────────────
+    {
+        gateway: 'mutate',
+        domain: 'docs',
+        operation: 'update',
+        description: 'docs.update (mutate) — replace blob content for an existing slug while preserving the slug. ' +
+            'New sha256 + new attachment row; the old row stays reachable by ID for history. ' +
+            'NO supersession edge (use `cleo docs supersede` for that). ' +
+            'Audit log entry appended to .cleo/audit/docs-versioning.jsonl (squashed within a 5-min window).',
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ['slug'],
+        params: [
+            {
+                name: 'slug',
+                type: 'string',
+                required: true,
+                description: 'Slug of the existing attachment to update',
+            },
+            {
+                name: 'file',
+                type: 'string',
+                required: false,
+                description: 'Path to a local file containing the new content',
+            },
+            {
+                name: 'content',
+                type: 'string',
+                required: false,
+                description: 'Inline UTF-8 content (mutually exclusive with file)',
+            },
+            {
+                name: 'message',
+                type: 'string',
+                required: false,
+                description: 'One-line summary describing the change (recorded in the audit log)',
+            },
+            {
+                name: 'status',
+                type: 'string',
+                required: false,
+                description: 'Override the new lifecycle status. Defaults to "draft" on every update. ' +
+                    'Valid: draft|proposed|accepted|superseded|archived|deprecated.',
+            },
+            {
+                name: 'attachedBy',
+                type: 'string',
+                required: false,
+                description: 'Agent identity that performed the update (defaults to "human")',
+            },
+        ],
+    },
     // ── playbook.* HITL CLI surface (T935) ───────────────────────────────────
     {
         gateway: 'mutate',
@@ -7262,6 +7381,35 @@ export const OPERATIONS = [
             },
         ],
     },
+    // release query: validate-changelog (T9937 / Saga T9862 — canonical CHANGELOG
+    // header validator that replaces the brittle inline grep step in
+    // .github/workflows/release.yml). Read-only — exposed only under the query
+    // gateway because no DB or filesystem mutation occurs.
+    {
+        gateway: 'query',
+        domain: 'release',
+        operation: 'validate-changelog',
+        description: 'release.validate-changelog (query) — validate that CHANGELOG.md contains the canonical `## [VERSION]` header per ADR-028 §2.5. Replaces the brittle inline grep in .github/workflows/release.yml (T9937 / Saga T9862).',
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ['version'],
+        params: [
+            {
+                name: 'version',
+                type: 'string',
+                required: true,
+                description: 'Release version (accepts v2026.5.94 or 2026.5.94)',
+                cli: { positional: true },
+            },
+            {
+                name: 'changelogPath',
+                type: 'string',
+                required: false,
+                description: 'Override the CHANGELOG file path (default: <projectRoot>/CHANGELOG.md)',
+            },
+        ],
+    },
     // ---------------------------------------------------------------------------
     // Provenance domain — `cleo provenance` CLI surface (T9528 · Phase 2 of T9493)
     // ---------------------------------------------------------------------------