@cleocode/cleo 2026.10.3 → 2026.10.5-rc.ci.672

package/dist/cli/changeset-RYPHPN2B.js

@@ -0,0 +1,246 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import {
+  defineCommand,
+  showUsage
+} from "./chunk-PKKZPOOP.js";
+import {
+  cliError,
+  cliOutput,
+  humanInfo,
+  humanLine,
+  isHumanOutput
+} from "./chunk-4RGSNUUP.js";
+import "./chunk-6JSJNYH2.js";
+
+// packages/cleo/src/cli/commands/changeset.ts
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { CHANGESET_KINDS } from "@cleocode/contracts/changesets.js";
+import { ExitCode } from "@cleocode/contracts/exit-codes.js";
+import {
+  changesets,
+  dataTable,
+  detectStrayCleoDb,
+  getProjectRoot,
+  resolveWorktreeRouting
+} from "@cleocode/core";
+function isValidKind(raw) {
+  return typeof raw === "string" && CHANGESET_KINDS.includes(raw);
+}
+function parseTasksFlag(raw) {
+  if (typeof raw !== "string" || raw.length === 0) return void 0;
+  const tasks = raw.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+  return tasks.length > 0 ? tasks : void 0;
+}
+function parsePrsFlag(raw) {
+  if (typeof raw !== "string" || raw.length === 0) return void 0;
+  const numbers = [];
+  for (const segment of raw.split(",")) {
+    const trimmed = segment.trim();
+    if (trimmed.length === 0) continue;
+    const n = Number.parseInt(trimmed, 10);
+    if (Number.isFinite(n) && n > 0) numbers.push(n);
+  }
+  return numbers.length > 0 ? numbers : void 0;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Author a task-anchored changeset entry. Dual-writes to .changeset/<slug>.md AND the docs SSoT blob store. Slug must match /^t\\d+-[a-z0-9-]+$/ (e.g. t9793-changeset-ssot-integration)."
+  },
+  args: {
+    slug: {
+      type: "string",
+      description: "Filename slug (sans .md). Must match /^t\\d+-[a-z0-9-]+$/. Example: t9793-changeset-ssot-integration",
+      required: true
+    },
+    tasks: {
+      type: "string",
+      description: "Comma-separated CLEO task IDs (T####). Example: T9793,T9788",
+      required: true
+    },
+    kind: {
+      type: "string",
+      description: `Type of change: ${CHANGESET_KINDS.join(" | ")}`,
+      required: true
+    },
+    summary: {
+      type: "string",
+      description: "One-line user-facing description of the change",
+      required: true
+    },
+    prs: {
+      type: "string",
+      description: "Comma-separated PR numbers, when known. Example: 349,357"
+    },
+    notes: {
+      type: "string",
+      description: "Optional longer-form markdown body (becomes the file body)"
+    },
+    breaking: {
+      type: "string",
+      description: "Migration note. REQUIRED when --kind is `breaking`."
+    },
+    "attached-by": {
+      type: "string",
+      description: "Agent identity recorded on the SSoT row (default: cleo-changeset)"
+    }
+  },
+  async run({ args }) {
+    if (!isValidKind(args.kind)) {
+      cliError(`--kind must be one of: ${CHANGESET_KINDS.join(" | ")} \u2014 got '${args.kind}'`, 6, {
+        name: "E_VALIDATION",
+        fix: `cleo changeset add --kind feat ... (or one of: ${CHANGESET_KINDS.join(", ")})`
+      });
+      process.exit(6);
+    }
+    const kind = args.kind;
+    const tasks = parseTasksFlag(args.tasks);
+    if (!tasks) {
+      cliError("--tasks must contain at least one task ID", 6, { name: "E_VALIDATION" });
+      process.exit(6);
+    }
+    const prs = parsePrsFlag(args.prs);
+    const entry = {
+      id: String(args.slug),
+      tasks,
+      kind,
+      summary: String(args.summary),
+      ...prs !== void 0 ? { prs } : {},
+      ...typeof args.notes === "string" && args.notes.length > 0 ? { notes: args.notes } : {},
+      ...typeof args.breaking === "string" && args.breaking.length > 0 ? { breaking: args.breaking } : {}
+    };
+    const routing = resolveWorktreeRouting();
+    const strayDb = detectStrayCleoDb(routing);
+    if (strayDb) {
+      cliError(
+        `stray .cleo/tasks.db detected inside worktree at ${routing.worktreePath}. This is a leaked CLEO state directory.`,
+        ExitCode.VALIDATION_ERROR,
+        {
+          name: "E_STRAY_WORKTREE_DB",
+          fix: `Remove it with: rm -rf ${routing.worktreePath}/.cleo \u2014 then retry. See ADR-068 \xA73 for the worktree DB isolation rationale.`
+        }
+      );
+      process.exit(ExitCode.VALIDATION_ERROR);
+    }
+    if (routing.isWorktree && process.env["CLEO_QUIET"] !== "1") {
+      const routingLog = `[T10389] routing SSoT write from worktree cwd ${routing.cwd} \u2192 canonical project root ${routing.canonicalRoot}
+`;
+      process.stderr.write(routingLog);
+    }
+    const projectRoot = routing.canonicalRoot;
+    const outcome = await changesets.writeChangesetEntry(entry, {
+      projectRoot,
+      ...typeof args["attached-by"] === "string" && args["attached-by"].length > 0 ? { attachedBy: args["attached-by"] } : {}
+    });
+    if (!outcome.ok) {
+      const err = outcome.error;
+      const hint = err.code === "E_SLUG_PATTERN_MISMATCH" && err.example ? `example slug: ${err.example}` : err.code === "E_SLUG_RESERVED" ? `try: ${err.suggestions.join(", ")}` : void 0;
+      cliError(err.message, ExitCode.VALIDATION_ERROR, {
+        name: err.code,
+        ...hint ? { fix: hint } : {}
+      });
+      process.exit(ExitCode.VALIDATION_ERROR);
+    }
+    const result = outcome.result;
+    humanInfo(`Wrote ${result.filePath}`);
+    humanInfo(`Wrote SSoT blob ${result.attachmentId} (sha=${result.sha256.slice(0, 12)}\u2026)`);
+    cliOutput(result, { command: "changeset add", operation: "changeset.add" });
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List every changeset entry under .changeset/*.md using the same parser the release-plan aggregator consumes. JSON envelope by default, aligned table on --human."
+  },
+  args: {
+    unshipped: {
+      type: "boolean",
+      description: "List only top-level unshipped .changeset/*.md entries (excludes .changeset/shipped/**)."
+    }
+  },
+  async run({ args }) {
+    const projectRoot = getProjectRoot();
+    const dir = join(projectRoot, ".changeset");
+    if (!existsSync(dir)) {
+      const empty = {
+        entries: [],
+        count: 0,
+        dir,
+        unshipped: args.unshipped === true,
+        note: "no .changeset/ dir"
+      };
+      if (isHumanOutput()) {
+        humanLine("No changeset entries found (.changeset/ directory absent).");
+      }
+      cliOutput(empty, { command: "changeset list", operation: "changeset.list" });
+      return;
+    }
+    let entries = [];
+    try {
+      entries = changesets.parseChangesetDir(dir);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      cliError(`Failed to parse .changeset directory: ${msg}`, ExitCode.VALIDATION_ERROR, {
+        name: "E_VALIDATION",
+        fix: "run `node scripts/lint-changesets.mjs` to surface every offending entry"
+      });
+      process.exit(ExitCode.VALIDATION_ERROR);
+    }
+    if (isHumanOutput()) {
+      if (entries.length === 0) {
+        humanLine("No changeset entries found (.changeset/ has no *.md files).");
+      } else {
+        const rendered = dataTable(entries, [
+          { header: "SLUG", get: (e) => e.id, maxWidth: 40 },
+          { header: "KIND", get: (e) => e.kind, maxWidth: 10 },
+          { header: "TASKS", get: (e) => e.tasks.join(","), maxWidth: 22 },
+          {
+            header: "PR",
+            get: (e) => e.prs && e.prs.length > 0 ? `#${e.prs.join(",#")}` : "-",
+            maxWidth: 10
+          },
+          { header: "SUMMARY", get: (e) => e.summary }
+        ]);
+        humanLine(rendered);
+      }
+    }
+    cliOutput(
+      { entries, count: entries.length, dir, unshipped: args.unshipped === true },
+      { command: "changeset list", operation: "changeset.list" }
+    );
+  }
+});
+var changesetCommand = defineCommand({
+  meta: {
+    name: "changeset",
+    description: "Author + list task-anchored changeset entries \u2014 dual-writes go to .changeset/*.md AND the docs SSoT blob store (Saga T9782)."
+  },
+  subCommands: {
+    add: addCommand,
+    list: listCommand
+  },
+  async run({ cmd, rawArgs }) {
+    const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
+    if (firstArg && cmd.subCommands && firstArg in cmd.subCommands) return;
+    await showUsage(cmd);
+  }
+});
+export {
+  changesetCommand
+};
+//# sourceMappingURL=changeset-RYPHPN2B.js.map