@cleocode/adapters 2026.5.114 → 2026.5.121

package/dist/index.js

@@ -786,7 +786,7 @@ var init_branch_lock = __esm({
 
 // packages/contracts/src/changesets.ts
 import { z as z3 } from "zod";
-var CHANGESET_KINDS, TASK_ID_RE, ChangesetEntrySchema;
+var CHANGESET_KINDS, CHANGESET_RELEASE_NOTE_SECTIONS, CHANGESET_RELEASE_NOTE_AUDIENCES, CHANGESET_RELEASE_NOTE_SCOPES, nonEmptyReleaseNoteText, nonEmptyReleaseNoteList, ChangesetReleaseNotesMetadataSchema, TASK_ID_RE, ChangesetEntrySchema;
 var init_changesets = __esm({
   "packages/contracts/src/changesets.ts"() {
     "use strict";
@@ -800,10 +800,60 @@ var init_changesets = __esm({
       "chore",
       "breaking"
     ];
+    CHANGESET_RELEASE_NOTE_SECTIONS = [
+      "added",
+      "changed",
+      "fixed",
+      "deprecated",
+      "removed",
+      "security",
+      "breaking"
+    ];
+    CHANGESET_RELEASE_NOTE_AUDIENCES = [
+      "users",
+      "operators",
+      "developers",
+      "maintainers"
+    ];
+    CHANGESET_RELEASE_NOTE_SCOPES = [
+      "project",
+      "package",
+      "component",
+      "docs",
+      "ops",
+      "security"
+    ];
+    nonEmptyReleaseNoteText = z3.string().min(1, "release-note metadata text must be non-empty");
+    nonEmptyReleaseNoteList = z3.array(nonEmptyReleaseNoteText).min(1, "release-note metadata list must contain at least one item");
+    ChangesetReleaseNotesMetadataSchema = z3.object({
+      /** Keep-a-Changelog style section/category override. */
+      section: z3.enum(CHANGESET_RELEASE_NOTE_SECTIONS).optional(),
+      /** Intended readers for the note. */
+      audience: z3.array(z3.enum(CHANGESET_RELEASE_NOTE_AUDIENCES)).min(1).optional(),
+      /** Release-note scope. */
+      scope: z3.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: z3.boolean().optional()
+    }).strict();
     TASK_ID_RE = /^(T\d+(-[A-Z][A-Za-z0-9]*)?|E-\d+(-[A-Z][A-Za-z0-9]*)?)$/;
     ChangesetEntrySchema = z3.object({
-      /** Filename slug (without the `.md` extension). */
-      id: z3.string().min(1, "id must be non-empty").regex(/^[a-z0-9][a-z0-9-]*$/, "id must be kebab-case (lowercase, digits, hyphens)"),
+      /** Filename identifier (without the `.md` extension); lowercase kebab-case for new files, legacy uppercase task IDs accepted. */
+      id: z3.string().min(1, "id must be non-empty").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: z3.array(z3.string().regex(TASK_ID_RE, "task ID must match T#### or E-#### format")).min(1, "tasks must contain at least one task ID"),
       /** Type of change. */
@@ -815,7 +865,9 @@ var init_changesets = __esm({
       /** Markdown body — longer-form explanation. */
       notes: z3.string().optional(),
       /** Migration note. Required iff `kind === 'breaking'`. */
-      breaking: z3.string().optional()
+      breaking: z3.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",
       path: ["breaking"]
@@ -1359,7 +1411,7 @@ var init_errors = __esm({
 
 // packages/contracts/src/evidence-atom-schema.ts
 import { z as z6 } from "zod";
-var commitAtomSchema, filesAtomSchema, testRunAtomSchema, toolAtomSchema, urlAtomSchema, noteAtomSchema, decisionAtomSchema, prAtomSchema, locDropAtomSchema, callsiteCoverageAtomSchema, EvidenceAtomSchema, GATE_EVIDENCE_REQUIREMENTS;
+var commitAtomSchema, filesAtomSchema, testRunAtomSchema, toolAtomSchema, urlAtomSchema, noteAtomSchema, decisionAtomSchema, prAtomSchema, locDropAtomSchema, callsiteCoverageAtomSchema, EvidenceAtomSchema, GATE_EVIDENCE_REQUIREMENTS, ATOM_EXAMPLES;
 var init_evidence_atom_schema = __esm({
   "packages/contracts/src/evidence-atom-schema.ts"() {
     "use strict";
@@ -1434,6 +1486,18 @@ var init_evidence_atom_schema = __esm({
       cleanupDone: { oneOf: [["note"]] },
       nexusImpact: { oneOf: [["tool"], ["note"]] }
     });
+    ATOM_EXAMPLES = Object.freeze({
+      commit: "commit:<sha>",
+      files: "files:path/a.ts,path/b.ts",
+      "test-run": "test-run:/tmp/vitest-out.json",
+      tool: "tool:test",
+      url: "url:https://example.com/docs",
+      note: "note:<short description>",
+      decision: "decision:D-arch-001",
+      pr: "pr:357",
+      "loc-drop": "loc-drop:<fromLines>:<toLines>",
+      "callsite-coverage": "callsite-coverage:<symbolName>:<relativeSourcePath>"
+    });
   }
 });