@cleocode/cleo 2026.5.110 → 2026.5.111

package/dist/cli/index.js

@@ -16199,10 +16199,12 @@ import {
   getCleoDirAbsolute,
   getProjectRoot as getProjectRoot5,
   memoryObserve as memoryObserve2,
+  parseChangesetFrontmatter,
   releaseReservedSlug,
   reserveSlugForDispatch,
   resolveAttachmentBackend,
-  SlugCollisionError
+  SlugCollisionError,
+  writeChangesetEntry
 } from "@cleocode/core/internal";
 function getDocKindRegistry() {
   const root = getProjectRoot5();
@@ -16709,6 +16711,105 @@ var init_docs2 = __esm({
           }
           type2 = rawType;
         }
+        if (type2 === "changeset") {
+          if (!filePath) {
+            return lafsError(
+              "E_INVALID_INPUT",
+              "changeset writes require a --file path (URL attachments are not supported for changesets)",
+              "add"
+            );
+          }
+          const absPath = resolve2(filePath);
+          let bytes;
+          try {
+            bytes = await readFile(absPath);
+          } catch {
+            return lafsError("E_FILE_ERROR", `Cannot read file: ${absPath}`, "add");
+          }
+          const parsed = parseChangesetFrontmatter(bytes.toString("utf-8"));
+          if (!parsed.ok) {
+            let message;
+            if (parsed.error === "missing-frontmatter") {
+              message = "changeset file is missing the `---`-fenced YAML frontmatter. Required fields: id, tasks, kind, summary.";
+            } else if (parsed.error === "missing-required") {
+              message = `changeset frontmatter is missing required fields: ${parsed.missing.join(", ")}.`;
+            } else if (parsed.error === "yaml-invalid") {
+              const lineHint = parsed.line !== void 0 ? ` (line ${parsed.line})` : "";
+              message = `changeset frontmatter YAML is invalid${lineHint}: ${parsed.parserMessage}`;
+            } else {
+              message = `changeset frontmatter failed schema validation: ${parsed.issues.join("; ")}`;
+            }
+            return {
+              success: false,
+              error: {
+                code: "E_REQUIRES_CHANGESET_VERB",
+                message,
+                details: {
+                  fix: "Use `cleo changeset add --slug <id> --tasks <T####> --kind <kind> --summary <text>` for guided authoring.",
+                  parserError: parsed.error,
+                  ...parsed.error === "missing-required" ? { missing: parsed.missing } : {},
+                  ...parsed.error === "schema-invalid" ? { issues: parsed.issues } : {}
+                }
+              }
+            };
+          }
+          if (slug !== void 0 && slug !== parsed.entry.id) {
+            return {
+              success: false,
+              error: {
+                code: "E_SLUG_MISMATCH",
+                message: `--slug '${slug}' does not match changeset frontmatter id '${parsed.entry.id}'. The frontmatter is canonical \u2014 drop --slug or align it.`
+              }
+            };
+          }
+          const outcome = await writeChangesetEntry(parsed.entry, {
+            projectRoot: getProjectRoot5(),
+            attachedBy: typeof rawAttachedBy === "string" && rawAttachedBy.length > 0 ? rawAttachedBy : "cleo-docs-add"
+          });
+          if (!outcome.ok) {
+            const err = outcome.error;
+            if (err.code === "E_SLUG_PATTERN_MISMATCH") {
+              const hint = err.example ? ` (example: ${err.example})` : "";
+              return lafsError("E_SLUG_PATTERN_MISMATCH", `${err.message}${hint}`, "add");
+            }
+            if (err.code === "E_INVALID_ENTRY") {
+              return lafsError("E_INVALID_INPUT", err.message, "add");
+            }
+            if (err.code === "E_FILE_WRITE_FAILED") {
+              return lafsError("E_FILE_ERROR", err.message, "add");
+            }
+            return lafsError("E_SSOT_WRITE_FAILED", err.message, "add");
+          }
+          const changesetPayload = {
+            kind: "doc-attachment",
+            attachmentId: outcome.result.attachmentId,
+            ownerId: outcome.result.ownerId,
+            addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            slug: outcome.result.slug,
+            type: "changeset"
+          };
+          emitDocAttachmentObservation(changesetPayload, getProjectRoot5());
+          return lafsSuccess(
+            {
+              attachmentId: outcome.result.attachmentId,
+              sha256: outcome.result.sha256,
+              // writeChangesetEntry returns a freshly-minted ref so refCount is 1
+              // (or more if the same content was already addressed by another
+              // owner). The store sets the canonical value; mirroring it here
+              // keeps the envelope shape identical to the file/url branches.
+              refCount: 1,
+              kind: "blob",
+              ownerId: outcome.result.ownerId,
+              ownerType: "task",
+              // Changeset writes land in the legacy attachment store; v2 mirror
+              // is not applicable to the dual-write transaction.
+              attachmentBackend: "legacy",
+              slug: outcome.result.slug,
+              type: "changeset"
+            },
+            "add"
+          );
+        }
         if (type2 !== void 0 && slug !== void 0) {
           const patternCheck = getDocKindRegistry().validateSlug(type2, slug);
           if (!patternCheck.ok) {