@clipit-ai/cli 0.2.8 → 0.2.10

package/bin/clipit.mjs

@@ -9,7 +9,7 @@ import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 
-const VERSION = '0.2.8';
+const VERSION = '0.2.10';
 const DEFAULT_BASE_URL = 'https://clipit.dev';
 const DEFAULT_SCOPES = [
   'clippy_agent',
@@ -484,6 +484,91 @@ function usage() {
   ].join('\n');
 }
 
+function commandUsage(command, subcommand) {
+  if (command === 'clips' && subcommand === 'initialize-snapshot') {
+    return [
+      'Usage:',
+      '  clipit clips initialize-snapshot <clipId> [options]',
+      '',
+      'Required:',
+      '  <clipId>                    Clip to initialize or safely reinitialize',
+      '',
+      'Optional:',
+      '  --aspect-ratio <ratio>      16:9, 9:16, 1:1, or 4:5',
+      '  --fit-background <mode>     black or blur',
+      '  --quality <quality>         standard, high, or 4k',
+      '  --captions <true|false>     Explicitly enable or disable captions',
+      '  --caption-style <style>     bold, minimal, neon, or classic',
+      '  --params <json|@file>        Supply the full initializer request, including captionPresetId',
+      '  --profile <name>            Named ClipIt credential profile',
+      '  --json                      Emit machine-readable JSON',
+      '',
+      'Omitted snapshot settings preserve the clip\'s exact current editor state.',
+    ].join('\n');
+  }
+  if (command === 'exports' && subcommand === 'start') {
+    return [
+      'Usage:',
+      '  clipit exports start --clip-id <id> --confirm [options]',
+      '',
+      'Required:',
+      '  --clip-id <id>           Clip to export from its verified current snapshot',
+      '  --confirm                Confirm the export mutation',
+      '',
+      'Optional:',
+      '  --params <json|@file>    Additional export settings',
+      '  --idempotency-key <key>  Stable retry identity; generated when omitted',
+      '  --max-credits <n>        Refuse an estimated client charge above this amount',
+      '  --profile <name>         Named ClipIt credential profile',
+      '  --json                   Emit machine-readable JSON',
+      '',
+      'The CLI pins the current editor version and state hash before starting the export.',
+    ].join('\n');
+  }
+  if (command === 'social' && subcommand === 'schedule') {
+    return [
+      'Usage:',
+      '  clipit social schedule --clip-id <id> --platforms <platform[,platform]> --caption <text> --at <ISO-8601> --confirm',
+      '',
+      'Required:',
+      '  --clip-id <id>       Clip to schedule',
+      '  --platforms <list>   Comma-separated destination platforms',
+      '  --caption <text>     Post caption',
+      '  --at <ISO-8601>      Scheduled publish time',
+      '  --confirm            Confirm the scheduling mutation',
+      '',
+      'Optional:',
+      '  --export-id <id>     Pin the exact completed export',
+      '  --account-ids <map>  Exact accounts as platform=accountId pairs',
+      '  --title <text>        Post title',
+      '  --hashtags <list>    Comma-separated hashtags',
+      '  --profile <name>     Named ClipIt credential profile',
+      '  --json               Emit machine-readable JSON',
+      '',
+      'Enterprise scheduling requires a client-selected deliverable and a granted connected account.',
+    ].join('\n');
+  }
+  if (command === 'deliverables' && subcommand === 'create') {
+    return [
+      'Usage:',
+      '  clipit deliverables create --export-id <id> --title <text> --confirm',
+      '',
+      'Required:',
+      '  --export-id <id>   Exact completed export to deliver',
+      '  --title <text>     Client-facing deliverable title',
+      '  --confirm          Confirm the delivery mutation',
+      '',
+      'Optional:',
+      '  --note <text>      Client-facing note',
+      '  --profile <name>   Named ClipIt credential profile',
+      '  --json             Emit machine-readable JSON',
+      '',
+      'The response includes clientSelectionUrl; the client must select the delivery before enterprise social publishing.',
+    ].join('\n');
+  }
+  return null;
+}
+
 function getBaseUrl(config, options) {
   const profile = profileData(config, options);
   const selected = profileIsAuthoritative(config, options);
@@ -1763,6 +1848,9 @@ async function runTool(config, options, functionName) {
     return;
   }
   output(outputResult, options);
+  if (result?.success === false) {
+    process.exitCode = EXIT.SERVER;
+  }
 }
 
 function workflowEndpoint(jobId) {
@@ -4438,7 +4526,7 @@ async function main() {
     return;
   }
   if (!command || options.help) {
-    console.log(usage());
+    console.log(commandUsage(command, subcommand) ?? usage());
     return;
   }
   if (command === 'version' || command === '--version' || command === '-v') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipit-ai/cli",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "ClipIt CLI for connecting shell-capable agents to ClipIt.",
   "type": "module",
   "bin": {