faces-cli 1.5.14 → 1.5.15

package/oclif.manifest.json

@@ -537,6 +537,59 @@
         "usage.js"
       ]
     },
+    "catalog:backup": {
+      "aliases": [],
+      "args": {},
+      "description": "Snapshot all faces and source material for migration",
+      "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": "catalog:backup",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "catalog",
+        "backup.js"
+      ]
+    },
     "catalog:doctor": {
       "aliases": [],
       "args": {},
@@ -735,6 +788,70 @@
         "manyfaced.js"
       ]
     },
+    "catalog:restore": {
+      "aliases": [],
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces and source material from a backup snapshot",
+      "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"
+        },
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "catalog:restore",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "catalog",
+        "restore.js"
+      ]
+    },
     "auth:connect": {
       "aliases": [],
       "args": {
@@ -1260,16 +1377,16 @@
         "whoami.js"
       ]
     },
-    "compile:import": {
+    "chat:chat": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "face_username": {
+          "description": "Face alias (or alias@model)",
+          "name": "face_username",
           "required": true
         }
       },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "description": "Chat via a face. Auto-routes to the correct API endpoint based on model provider.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1302,55 +1419,66 @@
           "multiple": false,
           "type": "option"
         },
-        "url": {
-          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
-          "name": "url",
-          "required": true,
+        "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"
         },
-        "type": {
-          "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
-          "name": "type",
-          "default": "document",
+        "system": {
+          "description": "System prompt / instructions",
+          "name": "system",
           "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",
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "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",
+        "temperature": {
+          "description": "Temperature (0.0-2.0)",
+          "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
+        "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": "compile:import",
+      "id": "chat:chat",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1360,20 +1488,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.js"
+        "chat",
+        "chat.js"
       ]
     },
-    "compile:upload": {
+    "chat:messages": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "face_model": {
+          "description": "Face model (e.g. myface or myface@claude-sonnet-4-6)",
+          "name": "face_model",
           "required": true
         }
       },
-      "description": "Upload a file (text/PDF/audio/video) to compile into a face",
+      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1406,55 +1534,40 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
+        "message": {
+          "char": "m",
+          "description": "User message (repeatable)",
+          "name": "message",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
+        "system": {
+          "description": "System prompt",
+          "name": "system",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
-          "name": "face-speaker",
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "default": 1024,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:upload",
+      "id": "chat:messages",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1464,20 +1577,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "upload.js"
+        "chat",
+        "messages.js"
       ]
     },
-    "chat:chat": {
+    "chat:responses": {
       "aliases": [],
       "args": {
-        "face_username": {
-          "description": "Face alias (or alias@model)",
-          "name": "face_username",
+        "face_model": {
+          "description": "Face model (e.g. myface or myface@gpt-4o)",
+          "name": "face_model",
           "required": true
         }
       },
-      "description": "Chat via a face. Auto-routes to the correct API endpoint based on model provider.",
+      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1512,23 +1625,16 @@
         },
         "message": {
           "char": "m",
-          "description": "User message (repeatable)",
+          "description": "User input message",
           "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",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "system": {
-          "description": "System prompt / instructions",
-          "name": "system",
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1538,38 +1644,72 @@
           "name": "stream",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "chat:responses",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "chat",
+        "responses.js"
+      ]
+    },
+    "compile:all": {
+      "aliases": [],
+      "args": {},
+      "description": "Compile all uncompiled documents and threads across all faces",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "temperature": {
-          "description": "Temperature (0.0-2.0)",
-          "name": "temperature",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "Read message from file",
-          "name": "file",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "responses": {
-          "description": "Use OpenAI Responses API instead of Chat Completions",
-          "name": "responses",
-          "allowNo": false,
-          "type": "boolean"
+        "timeout": {
+          "description": "Per-item compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:chat",
+      "id": "compile:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1579,20 +1719,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "chat.js"
+        "compile",
+        "all.js"
       ]
     },
-    "chat:messages": {
+    "compile:import": {
       "aliases": [],
       "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface or myface@claude-sonnet-4-6)",
-          "name": "face_model",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
+      "description": "Import a YouTube video into a face via server-side download and transcription",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1625,40 +1765,55 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
+        "url": {
+          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
+          "name": "url",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "system": {
-          "description": "System prompt",
-          "name": "system",
+        "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"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "default": 1024,
+        "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"
+        },
+        "no-wait": {
+          "description": "Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:messages",
+      "id": "compile:import",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1668,20 +1823,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "messages.js"
+        "compile",
+        "import.js"
       ]
     },
-    "chat:responses": {
+    "compile:upload": {
       "aliases": [],
       "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface or myface@gpt-4o)",
-          "name": "face_model",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
+      "description": "Upload a file (text/PDF/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1714,32 +1869,55 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User input message",
-          "name": "message",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "instructions": {
-          "description": "System instructions",
-          "name": "instructions",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
+        },
+        "face-speaker": {
+          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
+          "name": "face-speaker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:responses",
+      "id": "compile:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1749,8 +1927,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "responses.js"
+        "compile",
+        "upload.js"
       ]
     },
     "config:clear": {
@@ -1929,10 +2107,10 @@
         "show.js"
       ]
     },
-    "keys:create": {
+    "face:attributes": {
       "aliases": [],
       "args": {},
-      "description": "Create a new API key (JWT required)",
+      "description": "List all supported attribute keys",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1964,47 +2142,11 @@
           "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 alias (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": "keys:create",
+      "id": "face:attributes",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2014,264 +2156,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "face",
+        "attributes.js"
       ]
     },
-    "keys:list": {
+    "face:create": {
       "aliases": [],
       "args": {},
-      "description": "List all API keys (JWT required)",
-      "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": "keys:list",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "keys",
-        "list.js"
-      ]
-    },
-    "keys:revoke": {
-      "aliases": [],
-      "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.",
-          "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"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "keys:revoke",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "keys",
-        "revoke.js"
-      ]
-    },
-    "keys:update": {
-      "aliases": [],
-      "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.",
-          "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"
-        },
-        "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": "keys:update",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "keys",
-        "update.js"
-      ]
-    },
-    "face:attributes": {
-      "aliases": [],
-      "args": {},
-      "description": "List all supported attribute keys",
-      "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": "face:attributes",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "attributes.js"
-      ]
-    },
-    "face:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a new face",
+      "description": "Create a new face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2955,16 +2847,10 @@
         "upload.js"
       ]
     },
-    "compile:thread:create": {
+    "keys:create": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Start a new thread for a face",
+      "args": {},
+      "description": "Create a new API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2997,17 +2883,46 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Thread label",
-          "name": "label",
+        "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 alias (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": "compile:thread:create",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3017,21 +2932,73 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
+        "keys",
         "create.js"
       ]
     },
-    "compile:thread:delete": {
+    "keys:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all API keys (JWT required)",
+      "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": "keys:list",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "list.js"
+      ]
+    },
+    "keys:revoke": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Delete a thread",
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3073,7 +3040,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:delete",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3083,21 +3050,99 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "delete.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "compile:thread:edit": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Edit a thread (label and/or reassign face speaker)",
+      "description": "Update API key metadata (JWT required)",
+      "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"
+        },
+        "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": "keys:update",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "update.js"
+      ]
+    },
+    "compile:doc:create": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3131,15 +3176,94 @@
           "type": "option"
         },
         "label": {
-          "description": "New thread label",
+          "description": "Document label/title",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "face-speaker": {
-          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
-          "name": "face-speaker",
+        "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": "compile:doc:create",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "doc",
+        "create.js"
+      ]
+    },
+    "compile:doc:delete": {
+      "aliases": [],
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Delete a document",
+      "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"
@@ -3147,7 +3271,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:edit",
+      "id": "compile:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3158,20 +3282,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "edit.js"
+        "doc",
+        "delete.js"
       ]
     },
-    "compile:thread:get": {
+    "compile:doc:edit": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Get a thread by ID",
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3203,11 +3327,43 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "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"
+        },
+        "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": "compile:thread:get",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3218,20 +3374,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "get.js"
+        "doc",
+        "edit.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc:get": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3267,7 +3423,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:list",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3278,20 +3434,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "list.js"
+        "doc",
+        "get.js"
       ]
     },
-    "compile:thread:make": {
+    "compile:doc": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Compile an existing thread (prepare + sync in one step)",
+      "description": "Compile a document into a face (create → make in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3324,6 +3480,39 @@
           "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",
+          "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",
@@ -3333,7 +3522,7 @@
           "type": "option"
         },
         "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
+          "description": "Create and trigger compilation, then return immediately without polling.",
           "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
@@ -3341,7 +3530,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3352,20 +3541,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "make.js"
+        "doc",
+        "index.js"
       ]
     },
-    "compile:thread:message": {
+    "compile:doc:list": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Send a user message to a thread",
+      "description": "List documents for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3397,20 +3586,11 @@
           "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:thread:message",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3421,20 +3601,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "message.js"
+        "doc",
+        "list.js"
       ]
     },
-    "compile:thread:pause": {
+    "compile:doc:make": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Pause a running thread compilation (preserves progress, resume with make)",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3466,11 +3646,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:pause",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3481,20 +3675,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "pause.js"
+        "doc",
+        "make.js"
       ]
     },
-    "compile:thread:reset": {
+    "compile:doc:pause": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
+      "description": "Pause a running document compilation (preserves progress, resume with make)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3526,17 +3720,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3547,20 +3735,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "reset.js"
+        "doc",
+        "pause.js"
       ]
     },
-    "compile:thread:sync": {
+    "compile:doc:reset": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Archive and sync a thread into a face",
+      "description": "Reset document compilation progress (wipe extraction, keep content)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3592,11 +3780,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3607,11 +3801,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "sync.js"
+        "doc",
+        "reset.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -3620,7 +3814,7 @@
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Start a new thread for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3654,42 +3848,16 @@
           "type": "option"
         },
         "label": {
-          "description": "Document label/title",
+          "description": "Thread label",
           "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": "compile:doc:create",
+      "id": "compile:thread:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3700,20 +3868,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "create.js"
       ]
     },
-    "compile:doc:delete": {
+    "compile:thread:delete": {
       "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": "Delete a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3745,11 +3913,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3760,20 +3934,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "delete.js"
       ]
     },
-    "compile:doc:edit": {
+    "compile:thread:edit": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Edit a document (label, content, or perspective)",
+      "description": "Edit a thread (label and/or reassign face speaker)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3807,41 +3981,23 @@
           "type": "option"
         },
         "label": {
-          "description": "New label/title",
+          "description": "New thread label",
           "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"
-        },
-        "perspective": {
-          "description": "Perspective (first-person or third-person)",
-          "name": "perspective",
+        "face-speaker": {
+          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:edit",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3852,20 +4008,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "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.",
@@ -3901,7 +4057,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3912,11 +4068,11 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "get.js"
       ]
     },
-    "compile:doc": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -3925,7 +4081,7 @@
           "required": true
         }
       },
-      "description": "Compile a document into a face (create → make in one step)",
+      "description": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3957,38 +4113,65 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:thread:list",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "list.js"
+      ]
+    },
+    "compile:thread:make": {
+      "aliases": [],
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Compile an existing thread (prepare + sync in one step)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "label": {
-          "description": "Document label/title",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "description": "Inline text content",
-          "name": "content",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "Read content from file",
-          "name": "file",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective",
-          "name": "perspective",
-          "default": "first-person",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         },
         "timeout": {
@@ -4000,7 +4183,7 @@
           "type": "option"
         },
         "no-wait": {
-          "description": "Create and trigger compilation, then return immediately without polling.",
+          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
           "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
@@ -4008,7 +4191,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4019,20 +4202,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "index.js"
+        "thread",
+        "make.js"
       ]
     },
-    "compile:doc:list": {
+    "compile:thread:message": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "List documents for a face",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4064,11 +4247,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:list",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4079,20 +4271,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "list.js"
+        "thread",
+        "message.js"
       ]
     },
-    "compile:doc:make": {
+    "compile:thread:pause": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Compile an existing document (prepare + sync in one step)",
+      "description": "Pause a running thread compilation (preserves progress, resume with make)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4124,25 +4316,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:make",
+      "id": "compile:thread:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4153,20 +4331,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "make.js"
+        "thread",
+        "pause.js"
       ]
     },
-    "compile:doc:pause": {
+    "compile:thread:reset": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Pause a running document compilation (preserves progress, resume with make)",
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4198,11 +4376,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:pause",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4213,20 +4397,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "pause.js"
+        "thread",
+        "reset.js"
       ]
     },
-    "compile:doc:reset": {
+    "compile:thread:sync": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Reset document compilation progress (wipe extraction, keep content)",
+      "description": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4258,17 +4442,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:reset",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4279,10 +4457,10 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "reset.js"
+        "thread",
+        "sync.js"
       ]
     }
   },
-  "version": "1.5.14"
+  "version": "1.5.15"
 }