@clipit-ai/cli 0.2.9 → 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.9';
+const VERSION = '0.2.10';
 const DEFAULT_BASE_URL = 'https://clipit.dev';
 const DEFAULT_SCOPES = [
   'clippy_agent',
@@ -485,6 +485,46 @@ function usage() {
 }
 
 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:',
@@ -1808,6 +1848,9 @@ async function runTool(config, options, functionName) {
     return;
   }
   output(outputResult, options);
+  if (result?.success === false) {
+    process.exitCode = EXIT.SERVER;
+  }
 }
 
 function workflowEndpoint(jobId) {

package/package.json

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