@rolino/cli 0.1.0 → 0.3.0

package/dist/index.cjs

@@ -41,6 +41,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/cli.ts
 var import_node_crypto2 = require("crypto");
+var import_node_fs2 = require("fs");
 var import_promises2 = require("fs/promises");
 var import_node_path2 = require("path");
 var import_promises3 = require("readline/promises");
@@ -49,7 +50,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@rolino/cli",
-  version: "0.1.0",
+  version: "0.3.0",
   description: "Agent-friendly command-line interface for Rolino",
   type: "module",
   license: "MIT",
@@ -106,9 +107,9 @@ var package_default = {
     dev: "tsx src/bin.ts"
   },
   dependencies: {
-    "@rolino/contracts": "0.1.0",
-    "@rolino/local-auth": "0.1.0",
-    "@rolino/sdk": "0.1.0",
+    "@rolino/contracts": "0.3.0",
+    "@rolino/local-auth": "0.3.0",
+    "@rolino/sdk": "0.3.0",
     commander: "^15.0.0",
     open: "^11.0.0"
   },
@@ -492,7 +493,13 @@ function formatPost(post) {
     ] : [],
     ...post.publishedAt ? [`Published: ${post.publishedAt}`] : [],
     `Media: ${post.media.length}`,
-    `Destinations: ${post.destinations.map((destination) => `${destination.provider}:${queued && destination.status === "SCHEDULED" ? "QUEUED" : destination.status}`).join(", ") || "none"}`
+    `Destinations: ${post.destinations.map((destination) => `${destination.provider}:${queued && destination.status === "SCHEDULED" ? "QUEUED" : destination.status}`).join(", ") || "none"}`,
+    ...post.providerSettings?.TIKTOK ? [
+      `TikTok: ${post.providerSettings.TIKTOK.postMode}, ${post.providerSettings.TIKTOK.privacyLevel ?? "visibility not set"}, settings ${post.providerSettings.TIKTOK.consentedAt ? "reviewed" : "not reviewed"}`
+    ] : [],
+    ...post.providerSettings?.YOUTUBE ? [
+      `YouTube: ${post.providerSettings.YOUTUBE.privacyStatus}, ${post.providerSettings.YOUTUBE.title}`
+    ] : []
   ].join("\n");
 }
 function formatPostSchedulePending(pending) {
@@ -506,6 +513,28 @@ function formatIntegrationHealth(data) {
   const rows = data.items.map((item) => `${item.provider}	${item.connected ? "connected" : "disconnected"}	${item.health.status}	${item.health.isStale ? "stale" : "current"}	${item.health.message}`);
   return ["PROVIDER	CONNECTION	HEALTH	FRESHNESS	DETAIL", ...rows].join("\n");
 }
+function formatProviderDeliveryOptions(options) {
+  switch (options.provider) {
+    case "TIKTOK":
+      return [
+        `TikTok delivery options for ${options.account.displayName ?? options.account.username ?? "connected account"}`,
+        `Checked: ${options.checkedAt}`,
+        `Health: ${options.health.status} (${options.health.code}) ${options.health.message}`,
+        `Modes: ${options.allowedPostModes.join(", ") || "none"}`,
+        `Visibility: ${options.visibilityOptions.join(", ") || "none"}`,
+        `Interactions: comments ${options.interactions.comment.available ? "available" : "disabled"}, duet ${options.interactions.duet.available ? "available" : "disabled"}, stitch ${options.interactions.stitch.available ? "available" : "disabled"}`,
+        `Maximum video duration: ${options.maxVideoDurationMs === null ? "unknown" : `${options.maxVideoDurationMs} ms`}`
+      ].join("\n");
+    case "LINKEDIN":
+      return [
+        `LinkedIn delivery options for ${options.account.displayName ?? "connected member"}`,
+        `Checked: ${options.checkedAt}`,
+        `Health: ${options.health.status} (${options.health.code}) ${options.health.message}`,
+        `Post types: ${options.supportedPostTypes.join(", ")}`,
+        `Images: up to ${options.image.maxItems}; ${options.image.mimeTypes.join(", ")}; under ${options.image.maxPixelsExclusive.toLocaleString()} pixels`
+      ].join("\n");
+  }
+}
 function formatPostReadiness(readiness) {
   const attention = readiness.checks.filter((check) => check.status !== "pass");
   const summary = readiness.hasBlockingChecks ? "Post is not ready to publish." : readiness.requiresLiveRefresh.length ? "Local checks passed; live provider health must be refreshed." : "Post is ready to publish.";
@@ -850,7 +879,32 @@ function collectPublishingProvider(value, previous) {
   return [...previous ?? [], publishingProvider(value)];
 }
 function collectString(value, previous) {
-  return [...previous, value];
+  return [...previous ?? [], value];
+}
+function deliveryOptionsProvider(value) {
+  const normalized = value.toUpperCase();
+  const parsed = import_contracts2.ProviderDeliveryOptionsProviderSchema.safeParse(normalized);
+  if (parsed.success) return parsed.data;
+  throw new import_commander.InvalidArgumentError(
+    `Provider must be one of ${import_contracts2.ProviderDeliveryOptionsProviderSchema.options.join(", ")}.`
+  );
+}
+function tiktokPostMode(value) {
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "direct" || normalized === "direct_post") {
+    return "DIRECT_POST";
+  }
+  if (normalized === "inbox" || normalized === "media_upload") {
+    return "MEDIA_UPLOAD";
+  }
+  throw new import_commander.InvalidArgumentError("TikTok mode must be direct or inbox.");
+}
+function nonnegativeInteger(value) {
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed < 0) {
+    throw new import_commander.InvalidArgumentError("Expected a nonnegative integer.");
+  }
+  return parsed;
 }
 function youtubePrivacy(value) {
   const normalized = value.toUpperCase();
@@ -868,7 +922,7 @@ function yesOrNo(value) {
   throw new import_commander.InvalidArgumentError("Expected yes or no.");
 }
 function youtubeSettings(options) {
-  const hasYouTubeOptions = options.youtubeTitle !== void 0 || options.youtubeCategoryId !== void 0 || options.youtubePrivacy !== void 0 || options.youtubeMadeForKids !== void 0 || options.youtubeSyntheticMedia === true || options.youtubeNotifySubscribers === false || options.youtubeTag.length > 0;
+  const hasYouTubeOptions = options.youtubeTitle !== void 0 || options.youtubeCategoryId !== void 0 || options.youtubePrivacy !== void 0 || options.youtubeMadeForKids !== void 0 || options.youtubeSyntheticMedia === true || options.youtubeNotifySubscribers === false || (options.youtubeTag?.length ?? 0) > 0;
   if (!hasYouTubeOptions) return null;
   return import_contracts2.YouTubePostSettingsSchema.parse({
     title: options.youtubeTitle,
@@ -877,7 +931,7 @@ function youtubeSettings(options) {
     madeForKids: options.youtubeMadeForKids,
     containsSyntheticMedia: options.youtubeSyntheticMedia ?? false,
     notifySubscribers: options.youtubeNotifySubscribers ?? true,
-    tags: options.youtubeTag
+    tags: options.youtubeTag ?? []
   });
 }
 function positiveInteger(value) {
@@ -1023,6 +1077,23 @@ function errorForOutput(error) {
   }
   return { code: "CLI_ERROR", message: "The command failed unexpectedly." };
 }
+function tiktokSettings(options) {
+  const hasTikTokOptions = options.tiktokMode !== void 0 || options.tiktokVisibility !== void 0 || options.tiktokComments !== void 0 || options.tiktokDuet !== void 0 || options.tiktokStitch !== void 0 || options.tiktokCommercialContent !== void 0 || options.tiktokPromotesOwnBrand !== void 0 || options.tiktokPromotesThirdParty !== void 0 || options.tiktokAiGenerated !== void 0 || options.tiktokCoverTimestampMs !== void 0 || options.tiktokSettingsReviewed === true;
+  if (!hasTikTokOptions) return void 0;
+  return import_contracts2.TikTokDraftSettingsSchema.parse({
+    postMode: options.tiktokMode,
+    privacyLevel: options.tiktokVisibility,
+    allowComment: options.tiktokComments,
+    allowDuet: options.tiktokDuet,
+    allowStitch: options.tiktokStitch,
+    commercialContentEnabled: options.tiktokCommercialContent,
+    promotesOwnBrand: options.tiktokPromotesOwnBrand,
+    promotesThirdParty: options.tiktokPromotesThirdParty,
+    isAiGenerated: options.tiktokAiGenerated,
+    videoCoverTimestampMs: options.tiktokCoverTimestampMs,
+    reviewed: options.tiktokSettingsReviewed === true
+  });
+}
 function recoverySuggestions(code, command) {
   switch (code) {
     case "AUTH_REQUIRED":
@@ -1226,8 +1297,8 @@ async function runCli(argv = process.argv, overrides = {}) {
         const contentType = contentTypes[(0, import_node_path2.extname)(absolutePath).toLowerCase()];
         if (!contentType) throw new TypeError("Use a JPEG, PNG, WebP, MP4, or MOV file.");
         await requireWriteConsent({ yes: local.yes, global, runtime, subject: "media", preview: [`Upload ${(0, import_node_path2.basename)(absolutePath)} to Rolino?`, `Project: ${local.project}`, `Size: ${details.size} bytes`, "This adds a reusable media asset but does not create, schedule, or publish a post."].join("\n") });
-        const bytes = await (0, import_promises2.readFile)(absolutePath);
-        const asset = await client.media.upload(local.project, { fileName: (0, import_node_path2.basename)(absolutePath), contentType, fileSize: details.size, body: new Blob([bytes], { type: contentType }) }, { requestId: context.requestId });
+        const body = await (0, import_node_fs2.openAsBlob)(absolutePath, { type: contentType });
+        const asset = await client.media.upload(local.project, { fileName: (0, import_node_path2.basename)(absolutePath), contentType, fileSize: details.size, body }, { requestId: context.requestId });
         writeSuccess(context, asset, formatMediaAsset(asset), [`rolino posts create --project ${local.project} --caption <text> --media ${asset.id} --agent --yes`]);
       }
     });
@@ -1450,7 +1521,7 @@ async function runCli(argv = process.argv, overrides = {}) {
     });
   });
   const posts = program.command("posts").description("Read and prepare posts in a Rolino project");
-  posts.command("create").description("Create a draft post without scheduling or publishing it").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--caption <text>", "draft caption; use an empty string for media-only drafts").option("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, or BLUESKY; repeat as needed", collectPublishingProvider, []).option("--media <asset-id>", "existing project media asset ID; repeat for multiple", collectString, []).option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "YouTube tag; repeat as needed", collectString, []).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm creation without an interactive prompt").action(async (local) => {
+  posts.command("create").description("Create a draft post without scheduling or publishing it").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--caption <text>", "draft caption; use an empty string for media-only drafts").option("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, BLUESKY, or LINKEDIN; repeat as needed", collectPublishingProvider, []).option("--media <asset-id>", "existing project media asset ID; repeat for multiple", collectString, []).option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--tiktok-mode <mode>", "direct publishing or inbox draft delivery", tiktokPostMode).option("--tiktok-visibility <value>", "exact visibility returned by integrations delivery-options").option("--tiktok-comments <yes|no>", "allow TikTok comments", yesOrNo).option("--tiktok-duet <yes|no>", "allow TikTok duets", yesOrNo).option("--tiktok-stitch <yes|no>", "allow TikTok stitches", yesOrNo).option("--tiktok-commercial-content <yes|no>", "declare commercial TikTok content", yesOrNo).option("--tiktok-promotes-own-brand <yes|no>", "declare own-brand promotion", yesOrNo).option("--tiktok-promotes-third-party <yes|no>", "declare third-party promotion", yesOrNo).option("--tiktok-ai-generated <yes|no>", "declare AI-generated TikTok content", yesOrNo).option("--tiktok-cover-timestamp-ms <number>", "video cover timestamp in milliseconds", nonnegativeInteger).option("--tiktok-settings-reviewed", "confirm the TikTok account choices were reviewed; separate from --yes").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--linkedin-caption <text>", "LinkedIn-specific caption override; limited to 3,000 characters").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "YouTube tag; repeat as needed", collectString, []).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm creation without an interactive prompt").action(async (local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "posts create",
@@ -1476,9 +1547,10 @@ async function runCli(argv = process.argv, overrides = {}) {
             ...local.instagramCaption === void 0 ? {} : { INSTAGRAM: local.instagramCaption },
             ...local.tiktokCaption === void 0 ? {} : { TIKTOK: local.tiktokCaption },
             ...local.youtubeCaption === void 0 ? {} : { YOUTUBE: local.youtubeCaption },
-            ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption }
+            ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption },
+            ...local.linkedinCaption === void 0 ? {} : { LINKEDIN: local.linkedinCaption }
           },
-          tiktokSettings: null,
+          tiktokSettings: tiktokSettings(local) ?? null,
           youtubeSettings: youtubeSettings(local)
         };
         const post = await client.posts.create(local.project, input, {
@@ -1494,7 +1566,7 @@ async function runCli(argv = process.argv, overrides = {}) {
       }
     });
   });
-  posts.command("update").description("Replace an existing draft using optimistic concurrency").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).requiredOption("--caption <text>", "replacement draft caption").option("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, or BLUESKY; repeat as needed", collectPublishingProvider, []).option("--media <asset-id>", "replacement media asset ID; repeat for multiple", collectString, []).option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "YouTube tag; repeat as needed", collectString, []).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm the update without an interactive prompt").action(async (postId, local) => {
+  posts.command("update").description("Update selected draft fields using optimistic concurrency").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).option("--caption <text>", "replacement draft caption; omitted fields are preserved").option("--platform <provider>", "replacement destinations; repeat as needed", collectPublishingProvider).option("--clear-platforms", "remove every draft destination").option("--media <asset-id>", "replacement media asset ID; repeat for multiple", collectString).option("--clear-media", "remove every media asset from the draft").option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--tiktok-mode <mode>", "direct publishing or inbox draft delivery", tiktokPostMode).option("--tiktok-visibility <value>", "exact visibility returned by integrations delivery-options").option("--tiktok-comments <yes|no>", "allow TikTok comments", yesOrNo).option("--tiktok-duet <yes|no>", "allow TikTok duets", yesOrNo).option("--tiktok-stitch <yes|no>", "allow TikTok stitches", yesOrNo).option("--tiktok-commercial-content <yes|no>", "declare commercial TikTok content", yesOrNo).option("--tiktok-promotes-own-brand <yes|no>", "declare own-brand promotion", yesOrNo).option("--tiktok-promotes-third-party <yes|no>", "declare third-party promotion", yesOrNo).option("--tiktok-ai-generated <yes|no>", "declare AI-generated TikTok content", yesOrNo).option("--tiktok-cover-timestamp-ms <number>", "video cover timestamp in milliseconds", nonnegativeInteger).option("--tiktok-settings-reviewed", "confirm the TikTok account choices were reviewed; separate from --yes").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--linkedin-caption <text>", "LinkedIn-specific caption override; limited to 3,000 characters").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "replacement YouTube tag; repeat as needed", collectString).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm the update without an interactive prompt").action(async (postId, local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "posts update",
@@ -1506,24 +1578,34 @@ async function runCli(argv = process.argv, overrides = {}) {
           global,
           runtime,
           preview: [
-            `Replace draft ${postId}?`,
+            `Update draft ${postId}?`,
             `Project: ${local.project}`,
             `Expected version: ${local.expectedVersion}`,
             "This will not schedule or publish the post."
           ].join("\n")
         });
+        if (local.clearPlatforms && local.platform !== void 0) {
+          throw new TypeError("Use either --platform or --clear-platforms, not both.");
+        }
+        if (local.clearMedia && local.media !== void 0) {
+          throw new TypeError("Use either --media or --clear-media, not both.");
+        }
+        const captionOverrides = {
+          ...local.instagramCaption === void 0 ? {} : { INSTAGRAM: local.instagramCaption },
+          ...local.tiktokCaption === void 0 ? {} : { TIKTOK: local.tiktokCaption },
+          ...local.youtubeCaption === void 0 ? {} : { YOUTUBE: local.youtubeCaption },
+          ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption },
+          ...local.linkedinCaption === void 0 ? {} : { LINKEDIN: local.linkedinCaption }
+        };
+        const resolvedTikTokSettings = tiktokSettings(local);
+        const resolvedYouTubeSettings = youtubeSettings(local);
         const input = {
-          caption: local.caption,
-          platforms: local.platform,
-          mediaAssetIds: local.media,
-          captionOverrides: {
-            ...local.instagramCaption === void 0 ? {} : { INSTAGRAM: local.instagramCaption },
-            ...local.tiktokCaption === void 0 ? {} : { TIKTOK: local.tiktokCaption },
-            ...local.youtubeCaption === void 0 ? {} : { YOUTUBE: local.youtubeCaption },
-            ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption }
-          },
-          tiktokSettings: null,
-          youtubeSettings: youtubeSettings(local)
+          ...local.caption === void 0 ? {} : { caption: local.caption },
+          ...local.platform === void 0 && !local.clearPlatforms ? {} : { platforms: local.clearPlatforms ? [] : local.platform },
+          ...local.media === void 0 && !local.clearMedia ? {} : { mediaAssetIds: local.clearMedia ? [] : local.media },
+          ...Object.keys(captionOverrides).length ? { captionOverrides } : {},
+          ...resolvedTikTokSettings === void 0 ? {} : { tiktokSettings: resolvedTikTokSettings },
+          ...resolvedYouTubeSettings === null ? {} : { youtubeSettings: resolvedYouTubeSettings }
         };
         const post = await client.posts.update(local.project, postId, input, {
           requestId: context.requestId,
@@ -1661,7 +1743,7 @@ async function runCli(argv = process.argv, overrides = {}) {
     });
   });
   const publish = posts.command("publish").description("Preview and queue server-confirmed immediate publishing");
-  publish.command("preview").description("Validate exact destinations and issue a five-minute confirmation").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).requiredOption("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, or BLUESKY; repeat as needed", collectPublishingProvider).action(async (postId, local) => {
+  publish.command("preview").description("Validate exact destinations and issue a five-minute confirmation").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).requiredOption("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, BLUESKY, or LINKEDIN; repeat as needed", collectPublishingProvider).action(async (postId, local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "posts publish preview",
@@ -1744,6 +1826,27 @@ async function runCli(argv = process.argv, overrides = {}) {
       }
     });
   });
+  integrations.command("delivery-options").description("Refresh secret-safe creator delivery choices for one provider").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--provider <provider>", "publishing provider; TIKTOK or LINKEDIN", deliveryOptionsProvider).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({
+      command: "integrations delivery-options",
+      global,
+      runtime,
+      async action(context, client) {
+        const options = await client.integrations.deliveryOptions(
+          local.project,
+          local.provider,
+          { requestId: context.requestId }
+        );
+        writeSuccess(
+          context,
+          options,
+          formatProviderDeliveryOptions(options),
+          [`rolino posts create --project ${local.project} --caption <text> --platform ${local.provider} --agent --yes`]
+        );
+      }
+    });
+  });
   const calendar = program.command("calendar").description("Read scheduled publishing events");
   calendar.command("list").description("List scheduled posts in a bounded calendar window").requiredOption("--project <project-id>", "exact Rolino project ID").option("--from <datetime>", "inclusive ISO-8601 window start", isoDateTime).option("--to <datetime>", "exclusive ISO-8601 window end", isoDateTime).option("--limit <number>", "maximum events to return", (value) => {
     const parsed = Number(value);