@myna-sh/cli 0.7.0 → 0.8.0

package/dist/main.js

@@ -590,12 +590,40 @@ var ManagementClient = class {
       body
     ),
     /** Field-level before/after for everything this change set would change. */
+    /**
+     * Replay the change set's edits on top of what is published now.
+     *
+     * Refuses by default when a field changed on both sides; pass
+     * `onConflict` to take one side, or `dryRun` to see the plan first.
+     */
+    rebase: (project, changeSet, body = {}) => this.mutate(
+      "POST",
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/rebase`,
+      body
+    ),
     diff: (project, changeSet, signal) => this.get(
       `/projects/${enc(project)}/change-sets/${enc(changeSet)}/diff`,
       void 0,
       signal
     )
   };
+  // --- Releases -------------------------------------------------------------
+  /**
+   * What shipped, and how to take it back.
+   *
+   * `revert` returns an open change set rather than publishing: it goes through
+   * the same review, preview, and gate path as anything written by hand.
+   */
+  releases = {
+    list: (project, opts = {}) => this.page(`/projects/${enc(project)}/releases`, opts),
+    /** `release` is a release number or the published change set's id. */
+    get: (project, release, signal) => this.get(`/projects/${enc(project)}/releases/${enc(String(release))}`, void 0, signal),
+    revert: (project, release, body = {}) => this.mutate(
+      "POST",
+      `/projects/${enc(project)}/releases/${enc(String(release))}/revert`,
+      body
+    )
+  };
   // --- Declared external checks ---------------------------------------------
   checks = {
     list: (project, signal) => this.get(`/projects/${enc(project)}/checks`, void 0, signal),
@@ -2459,6 +2487,38 @@ function registerChanges(program) {
       });
     })
   );
+  changes.command("rebase").description("Replay a change set's edits on top of what is published now").argument("<id>", "change set id").option("--dry-run", "show what a rebase would do without writing", false).option("--take-mine", "on conflict, keep this change set's value", false).option("--take-theirs", "on conflict, accept what was published", false).action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      if (opts.takeMine && opts.takeTheirs) {
+        throw new UsageError("Provide at most one of --take-mine or --take-theirs.");
+      }
+      const result = await ctx.management().changeSets.rebase(project, args[0], {
+        ...opts.dryRun ? { dryRun: true } : {},
+        ...opts.takeMine ? { onConflict: "take-mine" } : {},
+        ...opts.takeTheirs ? { onConflict: "take-theirs" } : {}
+      });
+      emit(result, () => {
+        if (result.items.length === 0) {
+          diag(`Nothing to rebase; ${result.upToDate.length} item(s) already on the current head.`);
+          return;
+        }
+        for (const item of result.items) {
+          const label = item.collection && item.slug ? `${item.collection}/${item.slug}` : item.entryId;
+          diag(`${label} \u2014 ${item.appliedPaths.length} field(s) replayed, ${item.conflicts.length} conflict(s)`);
+          if (item.conflicts.length > 0) {
+            table(item.conflicts, [
+              { header: "FIELD", value: (c) => c.path },
+              { header: "MINE", value: (c) => preview(c.mine) },
+              { header: "THEIRS", value: (c) => preview(c.theirs) }
+            ]);
+          }
+        }
+        diag(result.dryRun ? "Dry run \u2014 nothing written." : "Rebased. Approvals are now stale; re-review.");
+      });
+      if (result.items.some((i) => i.conflicts.length > 0) && result.dryRun) process.exitCode = 1;
+    })
+  );
   changes.command("update").description("Retitle a change set or mark it ready for review").argument("<id>", "change set id").option("--title <title>", "new title").option("--description <text>", "new description").option("--ready", "mark ready for review", false).action(
     handle(async (ctx, args, opts) => {
       const project = ctx.requireProject();
@@ -2510,6 +2570,75 @@ function preview(value) {
   return flat.length > 48 ? `${flat.slice(0, 47)}\u2026` : flat;
 }
 
+// src/commands/releases.ts
+function registerReleases(program) {
+  const releases = program.command("releases").description("Inspect what shipped and generate a revert");
+  releases.command("list").description("List releases, newest first").option("--limit <n>", "page size", "25").action(
+    handle(async (ctx, _args, opts) => {
+      const project = ctx.requireProject();
+      const page = await ctx.management().releases.list(project, { limit: Number(opts.limit) });
+      emit(
+        { data: page.data, nextCursor: page.nextCursor },
+        () => table(page.data, [
+          { header: "#", value: (r) => String(r.number) },
+          { header: "TITLE", value: (r) => r.title },
+          { header: "PUBLISHED", value: (r) => r.publishedAt },
+          { header: "BY", value: (r) => r.publishedBy?.displayName ?? "\u2014" },
+          { header: "ITEMS", value: (r) => String(r.itemCount) },
+          {
+            header: "STATE",
+            value: (r) => r.revertedBy ? r.revertedBy.status === "published" ? `reverted by #${r.revertedBy.releaseNumber ?? "?"}` : `revert ${r.revertedBy.status}` : r.revertsReleaseNumber ? `reverts #${r.revertsReleaseNumber}` : "live"
+          }
+        ])
+      );
+    })
+  );
+  releases.command("inspect").description("Show one release").argument("<release>", "release number or published change set id").action(
+    handle(async (ctx, args) => {
+      const project = ctx.requireProject();
+      const release = await ctx.management().releases.get(project, args[0]);
+      emit(release, () => {
+        diag(`#${release.number} \u2014 ${release.title}`);
+        diag(`published ${release.publishedAt} by ${release.publishedBy?.displayName ?? "unknown"}`);
+        diag(`${release.itemCount} item(s), change set ${release.id}`);
+        if (release.revertsReleaseNumber) diag(`reverts release #${release.revertsReleaseNumber}`);
+        if (release.revertedBy) {
+          diag(`revert ${release.revertedBy.status}: change set ${release.revertedBy.changeSetId}`);
+        }
+      });
+    })
+  );
+  releases.command("revert").description("Generate a change set restoring the state before a release").argument("<release>", "release number or published change set id").option("--title <title>", "title for the generated change set").option("--force", "revert resources a later release already changed", false).action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const result = await ctx.management().releases.revert(project, args[0], {
+        ...opts.title ? { title: opts.title } : {},
+        ...opts.force ? { force: true } : {}
+      });
+      emit(result, () => {
+        diag(`Created change set ${result.changeSet.id} \u2014 ${result.changeSet.title}`);
+        table(result.reverted, [
+          { header: "OP", value: (r) => r.operation },
+          {
+            header: "RESOURCE",
+            value: (r) => r.collection && r.slug ? `${r.collection}/${r.slug}` : r.resourceId
+          },
+          { header: "RESTORES", value: (r) => r.restoredFromRevisionId ?? "\u2014" }
+        ]);
+        if (result.skipped.length > 0) {
+          diag(`${result.skipped.length} resource(s) skipped:`);
+          for (const s of result.skipped) {
+            const label = s.collection && s.slug ? `${s.collection}/${s.slug}` : s.resourceId;
+            process.stderr.write(`  ${label} \u2014 ${s.reason}: ${s.message}
+`);
+          }
+        }
+        diag(`Not published. Review, then: myna changes publish ${result.changeSet.id} --confirm-publish`);
+      });
+    })
+  );
+}
+
 // src/commands/previews.ts
 function previewTarget(ref) {
   if (ref.startsWith("chs_")) return { changeSetId: ref };
@@ -3334,7 +3463,7 @@ import { existsSync as existsSync4, readFileSync as readFileSync3, readdirSync a
 import { join as join6 } from "path";
 
 // src/version.ts
-var VERSION = true ? "0.7.0" : "0.0.0-dev";
+var VERSION = true ? "0.8.0" : "0.0.0-dev";
 
 // src/commands/doctor.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -3856,6 +3985,7 @@ function buildProgram() {
   registerEntries(program);
   registerSync(program);
   registerChanges(program);
+  registerReleases(program);
   registerPreviews(program);
   registerAssets(program);
   registerAdmin(program);