faces-cli 1.3.2 → 1.4.0

package/oclif.manifest.json

@@ -566,16 +566,10 @@
         "whoami.js"
       ]
     },
-    "chat:chat": {
+    "catalog:doctor": {
       "aliases": [],
-      "args": {
-        "face_username": {
-          "description": "Face username",
-          "name": "face_username",
-          "required": true
-        }
-      },
-      "description": "OpenAI-compatible chat completion via a face",
+      "args": {},
+      "description": "Diagnose and repair the local face catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -608,60 +602,22 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "llm": {
-          "description": "LLM override (e.g. claude-sonnet-4-6)",
-          "name": "llm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt override",
-          "name": "system",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
           "allowNo": false,
           "type": "boolean"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "temperature": {
-          "description": "Temperature (0.0-2.0)",
-          "name": "temperature",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read message from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:chat",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -671,20 +627,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "chat.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "chat:messages": {
+    "catalog:list": {
       "aliases": [],
-      "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface or myface@claude-sonnet-4-6)",
-          "name": "face_model",
-          "required": true
-        }
-      },
-      "description": "Anthropic Messages API proxy via a face (e.g. face@claude-sonnet-4-6)",
+      "args": {},
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -716,41 +666,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt",
-          "name": "system",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "default": 1024,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:messages",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -760,20 +680,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "messages.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "chat:responses": {
+    "billing:balance": {
       "aliases": [],
-      "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface or myface@gpt-4o)",
-          "name": "face_model",
-          "required": true
-        }
-      },
-      "description": "OpenAI Responses API proxy via a face",
+      "args": {},
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -805,33 +719,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "User input message",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "instructions": {
-          "description": "System instructions",
-          "name": "instructions",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:responses",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -841,20 +733,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "responses.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "compile:import": {
+    "billing:card-setup": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face ID or username",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "args": {},
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -886,50 +772,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "url": {
-          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
-          "name": "url",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
-          "name": "type",
-          "default": "document",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
-          "type": "option"
-        },
-        "perspective": {
-          "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
-          "name": "perspective",
-          "default": "third-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "face-speaker": {
-          "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
-          "name": "face-speaker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:import",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -939,14 +786,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "config:clear": {
+    "billing:checkout": {
       "aliases": [],
       "args": {},
-      "description": "Delete all saved credentials and config",
+      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -979,16 +826,22 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "plan": {
+          "description": "Plan to upgrade to",
+          "name": "plan",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "standard",
+            "pro"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:clear",
+      "id": "billing:checkout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -998,25 +851,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "billing",
+        "checkout.js"
       ]
     },
-    "config:set": {
+    "billing:llm-costs": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "args": {},
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1048,11 +890,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:set",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1062,14 +911,478 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "billing",
+        "llm-costs.js"
+      ]
+    },
+    "billing:quota": {
+      "aliases": [],
+      "args": {},
+      "description": "Show compile token quota and per-face stats",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:quota",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "quota.js"
+      ]
+    },
+    "billing:subscription": {
+      "aliases": [],
+      "args": {},
+      "description": "Show current plan, face count, and renewal date",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:subscription",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "subscription.js"
+      ]
+    },
+    "billing:topup": {
+      "aliases": [],
+      "args": {},
+      "description": "Top up credit balance using saved payment method",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:topup",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "topup.js"
+      ]
+    },
+    "billing:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Aggregated usage analytics",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
+          "type": "option"
+        },
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:usage",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "usage.js"
+      ]
+    },
+    "chat:chat": {
+      "aliases": [],
+      "args": {
+        "face_username": {
+          "description": "Face username (or face@model)",
+          "name": "face_username",
+          "required": true
+        }
+      },
+      "description": "Chat via a face. Auto-routes to the correct API endpoint based on model provider.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User message (repeatable)",
+          "name": "message",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "llm": {
+          "description": "LLM override (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "llm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "system": {
+          "description": "System prompt / instructions",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "description": "Temperature (0.0-2.0)",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "responses": {
+          "description": "Use OpenAI Responses API instead of Chat Completions",
+          "name": "responses",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "chat:chat",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "chat",
+        "chat.js"
+      ]
+    },
+    "chat:messages": {
+      "aliases": [],
+      "args": {
+        "face_model": {
+          "description": "Face model (e.g. myface or myface@claude-sonnet-4-6)",
+          "name": "face_model",
+          "required": true
+        }
+      },
+      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User message (repeatable)",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "system": {
+          "description": "System prompt",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "default": 1024,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "chat:messages",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "chat",
+        "messages.js"
       ]
     },
-    "config:show": {
+    "chat:responses": {
       "aliases": [],
-      "args": {},
-      "description": "Print current config (credentials are masked)",
+      "args": {
+        "face_model": {
+          "description": "Face model (e.g. myface or myface@gpt-4o)",
+          "name": "face_model",
+          "required": true
+        }
+      },
+      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1101,11 +1414,33 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User input message",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:show",
+      "id": "chat:responses",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1115,14 +1450,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "show.js"
+        "chat",
+        "responses.js"
       ]
     },
-    "face:create": {
+    "compile:import": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new face",
+      "args": {
+        "face_id": {
+          "description": "Face ID or username",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Import a YouTube video into a face via server-side download and transcription",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1155,47 +1496,49 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Display name",
-          "name": "name",
+        "url": {
+          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
+          "name": "url",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "username": {
-          "description": "Unique username slug",
-          "name": "username",
-          "required": true,
+        "type": {
+          "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
+          "name": "type",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "formula": {
-          "description": "Boolean formula over owned concrete face usernames (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
-          "name": "formula",
+        "perspective": {
+          "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
+          "name": "perspective",
+          "default": "third-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "attr": {
-          "description": "Attribute KEY=VALUE (repeatable)",
-          "name": "attr",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Tool name to enable (repeatable)",
-          "name": "tool",
+        "face-speaker": {
+          "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:create",
+      "id": "compile:import",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1205,20 +1548,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "create.js"
+        "compile",
+        "import.js"
       ]
     },
-    "face:delete": {
+    "config:clear": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face ID or username",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Delete a face permanently",
+      "args": {},
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1260,7 +1597,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:delete",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1270,14 +1607,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "delete.js"
+        "config",
+        "clear.js"
       ]
     },
-    "face:diff": {
+    "config:set": {
       "aliases": [],
-      "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
+      "args": {
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Set a config value (e.g. base_url, api_key, token)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1309,19 +1657,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "face": {
-          "description": "Face username to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1331,20 +1671,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "diff.js"
+        "config",
+        "set.js"
       ]
     },
-    "face:get": {
+    "config:show": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face ID or username",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Get details for a face by ID or username",
+      "args": {},
+      "description": "Print current config (credentials are masked)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1380,7 +1714,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "config:show",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1390,14 +1724,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "get.js"
+        "config",
+        "show.js"
       ]
     },
-    "face:list": {
+    "face:create": {
       "aliases": [],
       "args": {},
-      "description": "List all owned faces",
+      "description": "Create a new face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1429,11 +1763,62 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Display name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "username": {
+          "description": "Unique username slug",
+          "name": "username",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Description for local catalog",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "formula": {
+          "description": "Boolean formula over owned concrete face usernames (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
+          "name": "formula",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attr": {
+          "description": "Attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool name to enable (repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "face:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1444,19 +1829,19 @@
         "dist",
         "commands",
         "face",
-        "list.js"
+        "create.js"
       ]
     },
-    "face:neighbors": {
+    "face:delete": {
       "aliases": [],
       "args": {
         "face_id": {
-          "description": "Face username",
+          "description": "Face ID or username",
           "name": "face_id",
           "required": true
         }
       },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "description": "Delete a face permanently",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1474,59 +1859,31 @@
           "type": "option"
         },
         "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "component": {
-          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
-          "name": "component",
-          "default": "face",
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "face",
-            "beta",
-            "delta",
-            "epsilon"
-          ],
           "type": "option"
         },
-        "direction": {
-          "description": "nearest (most similar) or furthest (most dissimilar)",
-          "name": "direction",
-          "default": "nearest",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "nearest",
-            "furthest"
-          ],
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:neighbors",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1537,13 +1894,13 @@
         "dist",
         "commands",
         "face",
-        "neighbors.js"
+        "delete.js"
       ]
     },
-    "face:stats": {
+    "face:diff": {
       "aliases": [],
       "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "description": "Compare owned faces pairwise across all centroid components",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1575,11 +1932,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "face": {
+          "description": "Face username to include (repeatable, min 2)",
+          "name": "face",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:stats",
+      "id": "face:diff",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1590,10 +1955,10 @@
         "dist",
         "commands",
         "face",
-        "stats.js"
+        "diff.js"
       ]
     },
-    "face:update": {
+    "face:get": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -1602,7 +1967,7 @@
           "required": true
         }
       },
-      "description": "Update a face's metadata",
+      "description": "Get details for a face by ID or username",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1634,39 +1999,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "New display name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "formula": {
-          "description": "New boolean formula (synthetic faces only)",
-          "name": "formula",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "attr": {
-          "description": "Update attribute KEY=VALUE (repeatable)",
-          "name": "attr",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Tool names to set (replaces list, repeatable)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:update",
+      "id": "face:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1677,19 +2014,13 @@
         "dist",
         "commands",
         "face",
-        "update.js"
+        "get.js"
       ]
     },
-    "face:upload": {
+    "face:list": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face ID or username",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Upload a file (text/PDF/audio/video) to a face",
+      "args": {},
+      "description": "List all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1721,31 +2052,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:upload",
+      "id": "face:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1756,13 +2067,19 @@
         "dist",
         "commands",
         "face",
-        "upload.js"
+        "list.js"
       ]
     },
-    "keys:create": {
+    "face:neighbors": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new API key (JWT required)",
+      "args": {
+        "face_id": {
+          "description": "Face username",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Find the most similar or dissimilar owned faces to a given face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1795,46 +2112,44 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Key name/label",
-          "name": "name",
-          "required": true,
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "expires-days": {
-          "description": "Expiry in days (omit for no expiry)",
-          "name": "expires-days",
+        "component": {
+          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
+          "name": "component",
+          "default": "face",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "face",
+            "beta",
+            "delta",
+            "epsilon"
+          ],
           "type": "option"
         },
-        "budget": {
-          "description": "Spend budget in USD",
-          "name": "budget",
+        "direction": {
+          "description": "nearest (most similar) or furthest (most dissimilar)",
+          "name": "direction",
+          "default": "nearest",
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "face": {
-          "description": "Allowed face username (repeatable)",
-          "name": "face",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "model": {
-          "description": "Allowed model name (repeatable)",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": true,
+          "options": [
+            "nearest",
+            "furthest"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:create",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1844,14 +2159,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "face",
+        "neighbors.js"
       ]
     },
-    "keys:list": {
+    "face:stats": {
       "aliases": [],
       "args": {},
-      "description": "List all API keys (JWT required)",
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1887,7 +2202,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "face:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1897,20 +2212,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "list.js"
+        "face",
+        "stats.js"
       ]
     },
-    "keys:revoke": {
+    "face:update": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "face_id": {
+          "description": "Face ID or username",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "Update a face's metadata",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1943,16 +2258,52 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "name": {
+          "description": "New display name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Description for local catalog",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "formula": {
+          "description": "New boolean formula (synthetic faces only)",
+          "name": "formula",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attr": {
+          "description": "Update attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool names to set (replaces list, repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "face:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1962,20 +2313,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "face",
+        "update.js"
       ]
     },
-    "keys:update": {
+    "face:upload": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "face_id": {
+          "description": "Face ID or username",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Update API key metadata (JWT required)",
+      "description": "Upload a file (text/PDF/audio/video) to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2008,30 +2359,30 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "New key name",
-          "name": "name",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
-        },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "face:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2041,14 +2392,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "face",
+        "upload.js"
       ]
     },
-    "billing:balance": {
+    "keys:create": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Create a new API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2080,11 +2431,47 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Key name/label",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "expires-days": {
+          "description": "Expiry in days (omit for no expiry)",
+          "name": "expires-days",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "budget": {
+          "description": "Spend budget in USD",
+          "name": "budget",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "face": {
+          "description": "Allowed face username (repeatable)",
+          "name": "face",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "model": {
+          "description": "Allowed model name (repeatable)",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2094,14 +2481,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "keys",
+        "create.js"
       ]
     },
-    "billing:card-setup": {
+    "keys:list": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2137,7 +2524,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2147,14 +2534,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "keys",
+        "list.js"
       ]
     },
-    "billing:checkout": {
+    "keys:revoke": {
       "aliases": [],
-      "args": {},
-      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
+      "args": {
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
+          "required": true
+        }
+      },
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2187,22 +2580,16 @@
           "multiple": false,
           "type": "option"
         },
-        "plan": {
-          "description": "Plan to upgrade to",
-          "name": "plan",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "standard",
-            "pro"
-          ],
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:checkout",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2212,14 +2599,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "checkout.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "billing:llm-costs": {
+    "keys:update": {
       "aliases": [],
-      "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "args": {
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
+          "required": true
+        }
+      },
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2252,17 +2645,30 @@
           "multiple": false,
           "type": "option"
         },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
+        "name": {
+          "description": "New key name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2272,14 +2678,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "keys",
+        "update.js"
       ]
     },
-    "billing:quota": {
+    "compile:doc:create": {
       "aliases": [],
-      "args": {},
-      "description": "Show compile token quota and per-face stats",
+      "args": {
+        "face_id": {
+          "description": "Face ID or username",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2311,11 +2723,44 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "Document label/title",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "Inline text content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read content from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "perspective": {
+          "description": "Perspective (first-person or third-person)",
+          "name": "perspective",
+          "default": "first-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:quota",
+      "id": "compile:doc:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2325,14 +2770,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "quota.js"
+        "compile",
+        "doc",
+        "create.js"
       ]
     },
-    "billing:subscription": {
+    "compile:doc:delete": {
       "aliases": [],
-      "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Delete a document",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2368,7 +2820,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "compile:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2378,14 +2830,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription.js"
+        "compile",
+        "doc",
+        "delete.js"
       ]
     },
-    "billing:topup": {
+    "compile:doc:edit": {
       "aliases": [],
-      "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2418,25 +2877,42 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
-          "required": true,
+        "label": {
+          "description": "New label/title",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "New inline text content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read new content from file",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "perspective": {
+          "description": "Perspective (first-person or third-person)",
+          "name": "perspective",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2446,14 +2922,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "compile",
+        "doc",
+        "edit.js"
       ]
     },
-    "billing:usage": {
+    "compile:doc:get": {
       "aliases": [],
-      "args": {},
-      "description": "Aggregated usage analytics",
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2485,38 +2968,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
-          ],
-          "type": "option"
-        },
-        "from": {
-          "description": "Start date (YYYY-MM-DD)",
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "to": {
-          "description": "End date (YYYY-MM-DD)",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2526,11 +2982,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "compile",
+        "doc",
+        "get.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:doc": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2539,7 +2996,7 @@
           "required": true
         }
       },
-      "description": "Start a new thread for a face",
+      "description": "Compile a document into a face (create → make in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2573,16 +3030,50 @@
           "type": "option"
         },
         "label": {
-          "description": "Thread label",
+          "description": "Document label/title",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "content": {
+          "description": "Inline text content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read content from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "perspective": {
+          "description": "Perspective",
+          "name": "perspective",
+          "default": "first-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
+        },
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:create",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2593,11 +3084,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "create.js"
+        "doc",
+        "index.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc:list": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2606,7 +3097,7 @@
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "List documents for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2642,7 +3133,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:list",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2653,20 +3144,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "list.js"
       ]
     },
-    "compile:thread:message": {
+    "compile:doc:make": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Send a user message to a thread",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2699,11 +3190,10 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message to append",
-          "name": "message",
-          "required": true,
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2711,7 +3201,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:message",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2722,20 +3212,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "message.js"
+        "doc",
+        "make.js"
       ]
     },
-    "compile:thread:sync": {
+    "compile:thread:create": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face ID or username",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Archive and sync a thread into a face",
+      "description": "Start a new thread for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2767,11 +3257,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "Thread label",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "compile:thread:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2783,19 +3280,19 @@
         "commands",
         "compile",
         "thread",
-        "sync.js"
+        "create.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:delete": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face ID or username",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Delete a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2828,31 +3325,16 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Document label/title",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "description": "Inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read content from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:create",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2863,20 +3345,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "create.js"
+        "thread",
+        "delete.js"
       ]
     },
-    "compile:doc:delete": {
+    "compile:thread:edit": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Delete a document",
+      "description": "Edit a thread (label)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2908,11 +3390,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "New thread label",
+          "name": "label",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2923,20 +3413,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "delete.js"
+        "thread",
+        "edit.js"
       ]
     },
-    "compile:doc:get": {
+    "compile:thread:get": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Get a document by ID",
+      "description": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2972,7 +3462,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2983,11 +3473,11 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "get.js"
       ]
     },
-    "compile:doc:list": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2996,7 +3486,7 @@
           "required": true
         }
       },
-      "description": "List documents for a face",
+      "description": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3032,7 +3522,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3043,20 +3533,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "list.js"
       ]
     },
-    "compile:doc:prepare": {
+    "compile:thread:message": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Run LLM extraction pipeline on a document",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3088,11 +3578,20 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User message to append",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:prepare",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3103,20 +3602,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "prepare.js"
+        "thread",
+        "message.js"
       ]
     },
-    "compile:doc:sync": {
+    "compile:thread:sync": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Sync a document into a face (charges compile quota)",
+      "description": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3148,17 +3647,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation (quota will be charged)",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:sync",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3169,10 +3662,10 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "sync.js"
       ]
     }
   },
-  "version": "1.3.2"
+  "version": "1.4.0"
 }