@rolino/cli 0.5.0-beta.0 → 0.5.0

package/dist/index.cjs

@@ -50,7 +50,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@rolino/cli",
-  version: "0.5.0-beta.0",
+  version: "0.5.0",
   description: "Agent-friendly command-line interface for Rolino",
   type: "module",
   license: "MIT",
@@ -107,9 +107,9 @@ var package_default = {
     dev: "tsx src/bin.ts"
   },
   dependencies: {
-    "@rolino/contracts": "0.5.0-beta.0",
-    "@rolino/local-auth": "0.5.0-beta.0",
-    "@rolino/sdk": "0.5.0-beta.0",
+    "@rolino/contracts": "0.5.0",
+    "@rolino/local-auth": "0.5.0",
+    "@rolino/sdk": "0.5.0",
     commander: "^15.0.0",
     open: "^11.0.0"
   },
@@ -1069,6 +1069,10 @@ async function requireWriteConsent(options) {
     );
   }
 }
+function requireBlogExecutionConsent(options) {
+  if (options.yes || resolveFormat(options.global, options.runtime) !== "human") return;
+  throw new TypeError("This Blog execute command requires explicit consent. Review the confirmed operation and pass --yes.");
+}
 function formatMcpSetupPreview(result) {
   return [
     `Client: ${result.client === "codex" ? "Codex" : "Claude Code"}`,
@@ -2129,6 +2133,103 @@ Article: ${articleId}` });
       writeSuccess(context, data, JSON.stringify(data, null, 2));
     } });
   });
+  const blogImages = blog.command("images").description("Create and review Blog images with blog:write; cannot approve or publish");
+  blogImages.command("generate").description("Queue one exact-revision featured image with blog:write; cannot approve or publish").argument("<article-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--revision <revision-id>", "exact Blog revision ID").option("--editorial-brief <text>", "bounded visual direction; provider controls stay on the server").option("--idempotency-key <key>", "stable retry key; defaults to request ID").action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog images generate", global, runtime, async action(context, client) {
+      const data = await client.blog.articles.generateImage(local.project, articleId, { revisionId: local.revision, idempotencyKey: local.idempotencyKey ?? context.requestId, editorialBrief: local.editorialBrief }, { requestId: context.requestId });
+      writeSuccess(context, data, `Blog image generation queued.
+Image: ${data.image.id}
+Job: ${data.job.id}`);
+    } });
+  });
+  blogImages.command("upload").description("Upload one JPEG, PNG, or WebP for an exact Blog revision with blog:write; cannot approve or publish").argument("<article-id>").argument("<file-path>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--revision <revision-id>", "exact Blog revision ID").requiredOption("--alt-text <text>", "reviewable image alt text").action(async (articleId, filePath, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog images upload", global, runtime, async action(context, client) {
+      const absolutePath = (0, import_node_path2.resolve)(runtime.cwd, filePath);
+      const details = await (0, import_promises2.stat)(absolutePath).catch(() => null);
+      if (!details?.isFile()) throw new TypeError("The Blog image path must point to a readable file.");
+      const contentTypes = { ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".png": "image/png", ".webp": "image/webp" };
+      const extension = (0, import_node_path2.extname)(absolutePath).toLowerCase();
+      const contentType = contentTypes[extension];
+      if (!contentType) throw new TypeError("Use a JPEG, PNG, or WebP Blog image.");
+      const body = await (0, import_node_fs2.openAsBlob)(absolutePath, { type: contentType });
+      const data = await client.blog.articles.uploadImage(local.project, articleId, { revisionId: local.revision, fileName: (0, import_node_path2.basename)(absolutePath), contentType, fileSize: details.size, altText: local.altText, body }, { requestId: context.requestId });
+      writeSuccess(context, data, `Blog image uploaded for review.
+Image: ${data.id}
+State: ${data.state}`);
+    } });
+  });
+  blogImages.command("review").description("Review one exact Blog image with blog:write; does not approve the article or publish").argument("<article-id>").argument("<image-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--decision <decision>", "APPROVED or REJECTED").requiredOption("--expected-version <version>", "current image version", positiveInteger).option("--alt-text <text>", "final image alt text; required by the server for approval").option("--idempotency-key <key>", "stable retry key; defaults to request ID").action(async (articleId, imageId, local) => {
+    const decision = local.decision.toUpperCase();
+    if (decision !== "APPROVED" && decision !== "REJECTED") throw new TypeError("--decision must be APPROVED or REJECTED.");
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog images review", global, runtime, async action(context, client) {
+      const data = await client.blog.articles.reviewImage(local.project, articleId, imageId, { decision, expectedVersion: local.expectedVersion, altText: local.altText ?? "", idempotencyKey: local.idempotencyKey ?? context.requestId }, { requestId: context.requestId });
+      writeSuccess(context, data, `Blog image review saved.
+Image: ${data.id}
+State: ${data.state}`);
+    } });
+  });
+  const blogApprove = blog.command("approve").description("Approve one exact Blog bundle with blog:approve; cannot publish");
+  blogApprove.command("preview").description("Preview one exact approval bundle with blog:approve; creates a confirmation but cannot publish").argument("<article-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--revision <revision-id>", "exact Blog revision ID").action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog approve preview", global, runtime, async action(context, client) {
+      const data = await client.blog.articles.previewApproval(local.project, articleId, { revisionId: local.revision }, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  blogApprove.command("execute").description("Approve the confirmed exact bundle with blog:approve; separate blog:publish access is still required").argument("<article-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--revision <revision-id>", "same exact revision used for preview").requiredOption("--confirmation-token <token>", "short-lived token returned by preview").requiredOption("--idempotency-key <key>", "stable retry key").option("--yes", "confirm exact bundle approval").action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog approve execute", global, runtime, async action(context, client) {
+      requireBlogExecutionConsent({ yes: local.yes, global, runtime });
+      const data = await client.blog.articles.executeApproval(local.project, articleId, { revisionId: local.revision, confirmationToken: local.confirmationToken, idempotencyKey: local.idempotencyKey }, { requestId: context.requestId });
+      writeSuccess(context, data, `Exact Blog bundle approved.
+Revision: ${data.revisionId}
+Publishing still requires blog:publish.`);
+    } });
+  });
+  const blogSchedule = blog.command("schedule").description("Schedule exact approved Blog bundles with blog:publish; does not grant approval");
+  const addScheduleOptions = (command, executeSchedule) => {
+    command.argument("<article-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--revision <revision-id>", "exact approved Blog revision ID").requiredOption("--at <iso>", "future ISO date-time with UTC offset").requiredOption("--timezone <iana>", "explicit IANA timezone").option("--destination <destination-id...>", "exact destination IDs; defaults to the current primary");
+    if (executeSchedule) command.requiredOption("--confirmation-token <token>", "short-lived token returned by preview").requiredOption("--idempotency-key <key>", "stable retry key").option("--yes", "confirm future external publication");
+    return command;
+  };
+  addScheduleOptions(blogSchedule.command("preview").description("Preview an exact future Blog schedule with blog:publish; does not publish now"), false).action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog schedule preview", global, runtime, async action(context, client) {
+      const data = await client.blog.articles.previewSchedule(local.project, articleId, { revisionId: local.revision, scheduledAt: local.at, timezone: local.timezone, destinationIds: local.destination }, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  addScheduleOptions(blogSchedule.command("execute").description("Execute a confirmed future Blog schedule with blog:publish; causes future external publication"), true).action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog schedule execute", global, runtime, async action(context, client) {
+      requireBlogExecutionConsent({ yes: local.yes, global, runtime });
+      const data = await client.blog.articles.executeSchedule(local.project, articleId, { revisionId: local.revision, scheduledAt: local.at, timezone: local.timezone, destinationIds: local.destination, confirmationToken: local.confirmationToken, idempotencyKey: local.idempotencyKey }, { requestId: context.requestId });
+      writeSuccess(context, data, `Blog article scheduled.
+Time: ${data.scheduledAt}
+Timezone: ${data.timezone}`);
+    } });
+  });
+  const blogScheduleCancel = blogSchedule.command("cancel").description("Cancel one future Blog schedule with blog:publish; never unpublishes a live article");
+  blogScheduleCancel.command("preview").description("Preview exact schedule cancellation with blog:publish; does not unpublish").argument("<article-id>").requiredOption("--project <project-id>", "exact Rolino project ID").action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog schedule cancel preview", global, runtime, async action(context, client) {
+      const data = await client.blog.articles.previewScheduleCancellation(local.project, articleId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  blogScheduleCancel.command("execute").description("Cancel the confirmed future schedule with blog:publish; never unpublishes a live article").argument("<article-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--confirmation-token <token>", "short-lived token returned by preview").requiredOption("--idempotency-key <key>", "stable retry key").option("--yes", "confirm schedule cancellation").action(async (articleId, local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "blog schedule cancel execute", global, runtime, async action(context, client) {
+      requireBlogExecutionConsent({ yes: local.yes, global, runtime });
+      const data = await client.blog.articles.executeScheduleCancellation(local.project, articleId, { confirmationToken: local.confirmationToken, idempotencyKey: local.idempotencyKey }, { requestId: context.requestId });
+      writeSuccess(context, data, `Future Blog schedule canceled.
+Article: ${data.articleId}
+A live article was not unpublished.`);
+    } });
+  });
   blog.command("job").argument("<job-id>").requiredOption("--project <project-id>", "exact Rolino project ID").action(async (jobId, local) => {
     const global = program.opts();
     commandExitCode = await execute({ command: "blog job", global, runtime, async action(context, client) {