faces-cli 1.8.3 → 1.8.4

package/oclif.manifest.json

@@ -1261,21 +1261,10 @@
         "restore.js"
       ]
     },
-    "chat:chat": {
+    "compile:all": {
       "aliases": [],
-      "args": {
-        "face_username": {
-          "description": "Face alias (alias@model, owner:alias@model for a published face, or a composite formula like \"(a | b)@model\"). Omit when using --formula.",
-          "name": "face_username",
-          "required": false
-        }
-      },
-      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> socrates -m \"What is virtue?\"",
-        "<%= config.bin %> <%= command.id %> \"(socrates | nietzsche)@claude-sonnet-4-6\" -m \"What is virtue?\"",
-        "<%= config.bin %> <%= command.id %> --formula \"socrates | nietzsche\" --llm claude-sonnet-4-6 -m \"What is virtue?\""
-      ],
+      "args": {},
+      "description": "Compile all uncompiled documents and threads across all faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1308,86 +1297,18 @@
           "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"
-        },
-        "formula": {
-          "description": "Compose a run-time composite from your own faces, e.g. \"socrates | nietzsche\" (operators: | & ^ -). Requires --llm. The composite takes the name of its first operand; use face:create --formula for a named, persisted composite.",
-          "name": "formula",
-          "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": "Force the OpenAI Responses API endpoint (escape hatch; routing is automatic otherwise)",
-          "name": "responses",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
+        "timeout": {
+          "description": "Per-item compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:chat",
+      "id": "compile:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1397,20 +1318,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "chat.js"
+        "compile",
+        "all.js"
       ]
     },
-    "chat:messages": {
+    "compile:import": {
       "aliases": [],
       "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface, myface@claude-sonnet-4-6, or head:socrates@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.",
@@ -1443,53 +1364,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"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "default": 1024,
+        "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"
         },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
+        "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"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "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",
@@ -1499,20 +1422,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "messages.js"
+        "compile",
+        "import.js"
       ]
     },
-    "chat:responses": {
+    "compile:stats": {
       "aliases": [],
-      "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface, myface@gpt-4o, or head:socrates@gpt-5.4)",
-          "name": "face_model",
-          "required": true
-        }
-      },
-      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
+      "args": {},
+      "description": "Show compilation stats per face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1544,46 +1461,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"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:responses",
+      "id": "compile:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1593,27 +1475,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "responses.js"
+        "compile",
+        "stats.js"
       ]
     },
-    "chat:thread": {
+    "compile:upload": {
       "aliases": [],
       "args": {
-        "face_username": {
-          "description": "Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread",
-          "name": "face_username",
-          "required": false
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
         }
       },
-      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
-        "<%= config.bin %> <%= command.id %> --list",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 --show",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 --delete"
-      ],
+      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1646,97 +1521,62 @@
           "multiple": false,
           "type": "option"
         },
-        "id": {
-          "description": "Resume an existing thread by id",
-          "name": "id",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message",
-          "name": "message",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "file": {
-          "description": "Read message from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "llm": {
-          "description": "LLM override (only honored when starting a new thread)",
-          "name": "llm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt (only honored when starting a new thread)",
-          "name": "system",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "temperature": {
-          "description": "Temperature (0.0-2.0, OpenAI/Chat Completions only)",
-          "name": "temperature",
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. Only valid with --kind document.",
+          "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
+        "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"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "list": {
-          "description": "List saved threads",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "show": {
-          "description": "Show the thread transcript (requires --id)",
-          "name": "show",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete": {
-          "description": "Delete the thread (requires --id)",
-          "name": "delete",
+        "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:thread",
+      "id": "compile:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1746,14 +1586,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "thread.js"
+        "compile",
+        "upload.js"
       ]
     },
-    "compile:all": {
+    "config:clear": {
       "aliases": [],
       "args": {},
-      "description": "Compile all uncompiled documents and threads across all faces",
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1786,18 +1626,16 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Per-item compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:all",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1807,20 +1645,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "all.js"
+        "config",
+        "clear.js"
       ]
     },
-    "compile:import": {
+    "config:set": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "description": "Set a config value (e.g. base_url, api_key, token)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1852,56 +1695,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"
-        },
-        "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": "compile:import",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1911,14 +1709,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.js"
+        "config",
+        "set.js"
       ]
     },
-    "compile:stats": {
+    "config:show": {
       "aliases": [],
       "args": {},
-      "description": "Show compilation stats per face",
+      "description": "Print current config (credentials are masked)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1954,7 +1752,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:stats",
+      "id": "config:show",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1964,20 +1762,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "stats.js"
+        "config",
+        "show.js"
       ]
     },
-    "compile:upload": {
+    "chat:chat": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
+        "face_username": {
+          "description": "Face alias (alias@model, owner:alias@model for a published face, or a composite formula like \"(a | b)@model\"). Omit when using --formula.",
+          "name": "face_username",
+          "required": false
         }
       },
-      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
+      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates -m \"What is virtue?\"",
+        "<%= config.bin %> <%= command.id %> \"(socrates | nietzsche)@claude-sonnet-4-6\" -m \"What is virtue?\"",
+        "<%= config.bin %> <%= command.id %> --formula \"socrates | nietzsche\" --llm claude-sonnet-4-6 -m \"What is virtue?\""
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2010,121 +1813,86 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "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"
         },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
+        "formula": {
+          "description": "Compose a run-time composite from your own faces, e.g. \"socrates | nietzsche\" (operators: | & ^ -). Requires --llm. The composite takes the name of its first operand; use face:create --formula for a named, persisted composite.",
+          "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
+        "system": {
+          "description": "System prompt / instructions",
+          "name": "system",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. Only valid with --kind document.",
-          "name": "medium",
+        "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"
         },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
-          "name": "face-speaker",
+        "temperature": {
+          "description": "Temperature (0.0-2.0)",
+          "name": "temperature",
           "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",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "compile",
-        "upload.js"
-      ]
-    },
-    "config:clear": {
-      "aliases": [],
-      "args": {},
-      "description": "Delete all saved credentials and config",
-      "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",
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "responses": {
+          "description": "Force the OpenAI Responses API endpoint (escape hatch; routing is automatic otherwise)",
+          "name": "responses",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:clear",
+      "id": "chat:chat",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2134,25 +1902,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "chat",
+        "chat.js"
       ]
     },
-    "config:set": {
+    "chat:messages": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
+        "face_model": {
+          "description": "Face model (e.g. myface, myface@claude-sonnet-4-6, or head:socrates@claude-sonnet-4-6)",
+          "name": "face_model",
           "required": true
         }
       },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2184,64 +1947,54 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "config:set",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "config",
-        "set.js"
-      ]
-    },
-    "config:show": {
-      "aliases": [],
-      "args": {},
-      "description": "Print current config (credentials are masked)",
-      "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",
+        "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"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "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"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:show",
+      "id": "chat:messages",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2251,14 +2004,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "show.js"
+        "chat",
+        "messages.js"
       ]
     },
-    "keys:create": {
+    "chat:responses": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
+      "args": {
+        "face_model": {
+          "description": "Face model (e.g. myface, myface@gpt-4o, or head:socrates@gpt-5.4)",
+          "name": "face_model",
+          "required": true
+        }
+      },
+      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2291,52 +2050,45 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Key name/label",
-          "name": "name",
+        "message": {
+          "char": "m",
+          "description": "User input message",
+          "name": "message",
           "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",
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Allowed face alias (repeatable)",
-          "name": "face",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "model": {
-          "description": "Allowed model name (repeatable)",
-          "name": "model",
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "save": {
-          "description": "Save the new key to ~/.faces/config.json as api_key (default: true; use --no-save to skip)",
-          "name": "save",
-          "allowNo": true,
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:create",
+      "id": "chat:responses",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2346,14 +2098,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "chat",
+        "responses.js"
       ]
     },
-    "keys:list": {
+    "chat:thread": {
       "aliases": [],
-      "args": {},
-      "description": "List all API keys (JWT required)",
+      "args": {
+        "face_username": {
+          "description": "Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread",
+          "name": "face_username",
+          "required": false
+        }
+      },
+      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
+        "<%= config.bin %> <%= command.id %> --list",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 --show",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 --delete"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2385,155 +2150,98 @@
           "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",
+        "id": {
+          "description": "Resume an existing thread by id",
+          "name": "id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "message": {
+          "char": "m",
+          "description": "User message",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
           "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",
+        "llm": {
+          "description": "LLM override (only honored when starting a new thread)",
+          "name": "llm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "system": {
+          "description": "System prompt (only honored when starting a new thread)",
+          "name": "system",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "New key name",
-          "name": "name",
+        "temperature": {
+          "description": "Temperature (0.0-2.0, OpenAI/Chat Completions only)",
+          "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "list": {
+          "description": "List saved threads",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "show": {
+          "description": "Show the thread transcript (requires --id)",
+          "name": "show",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "delete": {
+          "description": "Delete the thread (requires --id)",
+          "name": "delete",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "chat:thread",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2543,8 +2251,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "chat",
+        "thread.js"
       ]
     },
     "face:attributes": {
@@ -2952,30 +2660,270 @@
           "multiple": false,
           "type": "option"
         },
-        "profile-addendum-file": {
-          "description": "Replace the per-face system prompt from a file.",
-          "exclusive": [
-            "profile-addendum"
-          ],
-          "name": "profile-addendum-file",
+        "profile-addendum-file": {
+          "description": "Replace the per-face system prompt from a file.",
+          "exclusive": [
+            "profile-addendum"
+          ],
+          "name": "profile-addendum-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "clear-profile-addendum": {
+          "description": "Remove the per-face system prompt.",
+          "exclusive": [
+            "profile-addendum",
+            "profile-addendum-file"
+          ],
+          "name": "clear-profile-addendum",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:edit",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "edit.js"
+      ]
+    },
+    "face:get": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Get details for a face, by alias or owner:alias. A published or shared face is reachable under the same owner:alias address chat uses; it is shown with a note that you do not own it.",
+      "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"
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "full": {
+          "description": "Print the full profile_addendum instead of a truncated preview",
+          "name": "full",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:get",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "get.js"
+      ]
+    },
+    "face:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
+      "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"
+        },
+        "tag": {
+          "description": "Filter by tag (repeatable, AND logic)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "team": {
+          "description": "Filter by team ID (repeatable, OR logic)",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "public": {
+          "description": "Include published faces from other accounts (open to everybody)",
+          "name": "public",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "shared": {
+          "description": "Include faces other accounts have shared with YOU in particular",
+          "name": "shared",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "system": {
+          "description": "Show only the curated system faces (published faces owned by 'head')",
+          "name": "system",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "from-users": {
+          "description": "Only published faces from these owners (repeatable/comma-separated)",
+          "name": "from-users",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "not-from-users": {
+          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
+          "name": "not-from-users",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:list",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "list.js"
+      ]
+    },
+    "face:lock": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates"
+      ],
+      "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"
         },
-        "clear-profile-addendum": {
-          "description": "Remove the per-face system prompt.",
-          "exclusive": [
-            "profile-addendum",
-            "profile-addendum-file"
-          ],
-          "name": "clear-profile-addendum",
-          "allowNo": false,
-          "type": "boolean"
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:edit",
+      "id": "face:lock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2986,10 +2934,10 @@
         "dist",
         "commands",
         "face",
-        "edit.js"
+        "lock.js"
       ]
     },
-    "face:get": {
+    "face:neighbors": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2998,7 +2946,7 @@
           "required": true
         }
       },
-      "description": "Get details for a face, by alias or owner:alias. A published or shared face is reachable under the same owner:alias address chat uses; it is shown with a note that you do not own it.",
+      "description": "Find the most similar or dissimilar owned faces to a given face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3031,23 +2979,38 @@
           "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "full": {
-          "description": "Print the full profile_addendum instead of a truncated preview",
-          "name": "full",
-          "allowNo": false,
-          "type": "boolean"
+        "component": {
+          "description": "What to rank on: `face` for overall similarity, or a component position such as 1. Which positions are comparable varies; the API names them if you pick a wrong one.",
+          "name": "component",
+          "default": "face",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "direction": {
+          "description": "nearest (most similar) or furthest (most dissimilar)",
+          "name": "direction",
+          "default": "nearest",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "nearest",
+            "furthest"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3058,13 +3021,22 @@
         "dist",
         "commands",
         "face",
-        "get.js"
+        "neighbors.js"
       ]
     },
-    "face:list": {
+    "face:publish": {
       "aliases": [],
-      "args": {},
-      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Publish a face so EVERY account can chat with it. This is a global override: while it is on, everyone can reach the face regardless of who it is shared with. You still pay only to compile it; whoever chats pays for their own inference.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3097,63 +3069,16 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Filter by tag (repeatable, AND logic)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "team": {
-          "description": "Filter by team ID (repeatable, OR logic)",
-          "name": "team",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "public": {
-          "description": "Include published faces from other accounts (open to everybody)",
-          "name": "public",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "shared": {
-          "description": "Include faces other accounts have shared with YOU in particular",
-          "name": "shared",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "system": {
-          "description": "Show only the curated system faces (published faces owned by 'head')",
-          "name": "system",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "from-users": {
-          "description": "Only published faces from these owners (repeatable/comma-separated)",
-          "name": "from-users",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "not-from-users": {
-          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
-          "name": "not-from-users",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "face:publish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3164,21 +3089,24 @@
         "dist",
         "commands",
         "face",
-        "list.js"
+        "publish.js"
       ]
     },
-    "face:lock": {
+    "face:share": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.",
+      "description": "Share a face so named accounts can chat with it. Sharing grants chat and nothing else: no reading its documents, no compiling, no re-sharing, and never its profile addendum. --add keeps the current list; --with replaces it.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> socrates"
+        "<%= config.bin %> <%= command.id %> alice --list",
+        "<%= config.bin %> <%= command.id %> alice --add dana",
+        "<%= config.bin %> <%= command.id %> alice --with dana --with sam@example.com",
+        "<%= config.bin %> <%= command.id %> alice --none --yes"
       ],
       "flags": {
         "json": {
@@ -3211,11 +3139,55 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "list": {
+          "description": "Show who the face is shared with, and change nothing",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "add": {
+          "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
+          "exclusive": [
+            "with",
+            "none"
+          ],
+          "name": "add",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "with": {
+          "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
+          "exclusive": [
+            "add",
+            "none"
+          ],
+          "name": "with",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "none": {
+          "description": "Revoke everyone",
+          "exclusive": [
+            "add",
+            "with"
+          ],
+          "name": "none",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Skip the confirmation shown when someone would lose access",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:lock",
+      "id": "face:share",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3226,19 +3198,24 @@
         "dist",
         "commands",
         "face",
-        "lock.js"
+        "share.js"
       ]
     },
-    "face:neighbors": {
+    "face:sources": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --type thread",
+        "<%= config.bin %> <%= command.id %> alice --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3271,38 +3248,74 @@
           "multiple": false,
           "type": "option"
         },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
+        "type": {
+          "description": "Show only one kind of source",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "doc",
+            "thread"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:sources",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "sources.js"
+      ]
+    },
+    "face:stats": {
+      "aliases": [],
+      "args": {},
+      "description": "Compile and chat stats for all owned faces",
+      "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"
         },
-        "component": {
-          "description": "What to rank on: `face` for overall similarity, or a component position such as 1. Which positions are comparable varies; the API names them if you pick a wrong one.",
-          "name": "component",
-          "default": "face",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:neighbors",
+      "id": "face:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3313,10 +3326,10 @@
         "dist",
         "commands",
         "face",
-        "neighbors.js"
+        "stats.js"
       ]
     },
-    "face:publish": {
+    "face:teams": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3325,10 +3338,7 @@
           "required": true
         }
       },
-      "description": "Publish a face so EVERY account can chat with it. This is a global override: while it is on, everyone can reach the face regardless of who it is shared with. You still pay only to compile it; whoever chats pays for their own inference.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --yes"
-      ],
+      "description": "Set a face's team memberships (replaces all)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3361,16 +3371,18 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "team": {
+          "description": "Team ID (repeatable, replaces all memberships)",
+          "name": "team",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:publish",
+      "id": "face:teams",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3381,24 +3393,21 @@
         "dist",
         "commands",
         "face",
-        "publish.js"
+        "teams.js"
       ]
     },
-    "face:share": {
+    "face:unlock": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Share a face so named accounts can chat with it. Sharing grants chat and nothing else: no reading its documents, no compiling, no re-sharing, and never its profile addendum. --add keeps the current list; --with replaces it.",
+      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice --list",
-        "<%= config.bin %> <%= command.id %> alice --add dana",
-        "<%= config.bin %> <%= command.id %> alice --with dana --with sam@example.com",
-        "<%= config.bin %> <%= command.id %> alice --none --yes"
+        "<%= config.bin %> <%= command.id %> socrates"
       ],
       "flags": {
         "json": {
@@ -3431,55 +3440,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "list": {
-          "description": "Show who the face is shared with, and change nothing",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "add": {
-          "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
-          "exclusive": [
-            "with",
-            "none"
-          ],
-          "name": "add",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "with": {
-          "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
-          "exclusive": [
-            "add",
-            "none"
-          ],
-          "name": "with",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "none": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "add",
-            "with"
-          ],
-          "name": "none",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "description": "Skip the confirmation shown when someone would lose access",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:share",
+      "id": "face:unlock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3490,10 +3455,10 @@
         "dist",
         "commands",
         "face",
-        "share.js"
+        "unlock.js"
       ]
     },
-    "face:sources": {
+    "face:unpublish": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3502,12 +3467,7 @@
           "required": true
         }
       },
-      "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --type thread",
-        "<%= config.bin %> <%= command.id %> alice --json"
-      ],
+      "description": "Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an override on top of sharing, not a replacement for it.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3539,22 +3499,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "type": {
-          "description": "Show only one kind of source",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "doc",
-            "thread"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:sources",
+      "id": "face:unpublish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3565,13 +3514,23 @@
         "dist",
         "commands",
         "face",
-        "sources.js"
+        "unpublish.js"
       ]
     },
-    "face:stats": {
+    "face:unshare": {
       "aliases": [],
-      "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --from dana --yes",
+        "<%= config.bin %> <%= command.id %> alice --all --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3603,11 +3562,36 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "from": {
+          "description": "Account to revoke (repeatable)",
+          "exclusive": [
+            "all"
+          ],
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all": {
+          "description": "Revoke everyone",
+          "exclusive": [
+            "from"
+          ],
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:stats",
+      "id": "face:unshare",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3618,19 +3602,13 @@
         "dist",
         "commands",
         "face",
-        "stats.js"
+        "unshare.js"
       ]
     },
-    "face:teams": {
+    "keys:create": {
       "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Set a face's team memberships (replaces all)",
+      "args": {},
+      "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3663,18 +3641,52 @@
           "multiple": false,
           "type": "option"
         },
-        "team": {
-          "description": "Team ID (repeatable, replaces all memberships)",
-          "name": "team",
+        "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"
+        },
+        "save": {
+          "description": "Save the new key to ~/.faces/config.json as api_key (default: true; use --no-save to skip)",
+          "name": "save",
+          "allowNo": true,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:teams",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3684,23 +3696,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "teams.js"
+        "keys",
+        "create.js"
       ]
-    },
-    "face:unlock": {
-      "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> socrates"
-      ],
+    },
+    "keys:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3736,7 +3739,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unlock",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3746,20 +3749,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unlock.js"
+        "keys",
+        "list.js"
       ]
     },
-    "face:unpublish": {
+    "keys:revoke": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an override on top of sharing, not a replacement for it.",
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3791,11 +3794,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unpublish",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3805,24 +3814,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unpublish.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "face:unshare": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --from dana --yes",
-        "<%= config.bin %> <%= command.id %> alice --all --yes"
-      ],
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3855,35 +3860,30 @@
           "multiple": false,
           "type": "option"
         },
-        "from": {
-          "description": "Account to revoke (repeatable)",
-          "exclusive": [
-            "all"
-          ],
-          "name": "from",
+        "name": {
+          "description": "New key name",
+          "name": "name",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "from"
-          ],
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unshare",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3893,8 +3893,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unshare.js"
+        "keys",
+        "update.js"
       ]
     },
     "style:delete": {
@@ -4100,7 +4100,7 @@
           "required": true
         }
       },
-      "description": "Go back to the style a face had before the last style:make. A face holds one style per medium, so name which one with --medium when it has more than one. Two versions are kept per medium, so this goes back exactly one step. It changes how the face writes immediately, so it asks first.",
+      "description": "Go back to the style a face had before the last style:make. Two versions are kept per medium, so this is a toggle: running it again returns to where you started. A face holds one style per medium, so name which one with --medium when it has more than one. It changes how the face writes immediately, so it asks first.",
       "examples": [
         "<%= config.bin %> <%= command.id %> alice --yes",
         "<%= config.bin %> <%= command.id %> alice --medium email --yes"
@@ -5148,7 +5148,7 @@
         "index.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5157,7 +5157,7 @@
           "required": true
         }
       },
-      "description": "Start a new thread for a face",
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5191,22 +5191,49 @@
           "type": "option"
         },
         "label": {
-          "description": "Thread label",
+          "description": "Document label/title",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "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:thread:create",
+      "id": "compile:doc:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5217,20 +5244,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "create.js"
       ]
     },
-    "compile:thread:delete": {
+    "compile:doc:delete": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Delete a thread",
+      "description": "Delete a document",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5262,17 +5289,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:delete",
+      "id": "compile:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5283,20 +5304,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "delete.js"
       ]
     },
-    "compile:thread:edit": {
+    "compile:doc:edit": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Edit a thread (label and/or reassign face speaker)",
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5330,23 +5351,48 @@
           "type": "option"
         },
         "label": {
-          "description": "New thread label",
+          "description": "New 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": "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"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "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:edit",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5357,20 +5403,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "edit.js"
       ]
     },
-    "compile:thread:get": {
+    "compile:doc:get": {
       "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": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5406,7 +5452,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5417,11 +5463,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "get.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5430,7 +5476,11 @@
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "Compile one or more documents into a face (create → make in one step). Repeat --file to submit several documents in a single command; each file becomes its own document rather than being concatenated.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --file notes.txt",
+        "<%= config.bin %> <%= command.id %> alice --file a.txt --file b.txt --file c.txt --no-wait --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5439,34 +5489,91 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
+        "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"
+        },
+        "label": {
+          "description": "Document label/title (single document only; with several files each is labelled by its filename)",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "Inline text content",
+          "exclusive": [
+            "file"
+          ],
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read content from file (repeatable — each file becomes its own document)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "perspective": {
+          "description": "Perspective",
+          "name": "perspective",
+          "default": "first-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "timeout": {
+          "description": "Compile timeout in seconds, per document (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Create and trigger compilation, then return immediately without polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:list",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5477,20 +5584,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "list.js"
+        "doc",
+        "index.js"
       ]
     },
-    "compile:thread:make": {
+    "compile:doc:list": {
       "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": "List documents for a face. Each document's full text is omitted unless --verbose, so a face with a real corpus stays readable. For a table of every source, documents and threads together, use face:sources.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5523,24 +5630,16 @@
           "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 thread ID for manual polling.",
-          "name": "no-wait",
+        "verbose": {
+          "description": "Include each document's full text",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5551,20 +5650,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "make.js"
+        "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.",
@@ -5597,25 +5696,24 @@
           "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"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "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:message",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5626,20 +5724,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "message.js"
+        "doc",
+        "make.js"
       ]
     },
-    "compile:thread:pause": {
+    "compile:doc:pause": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Ask a running thread compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
+      "description": "Ask a running document compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5689,7 +5787,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:pause",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5700,20 +5798,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "pause.js"
       ]
     },
-    "compile:thread:reset": {
+    "compile:doc:reset": {
       "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": "Reset document compilation progress (wipe extraction, keep content)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5755,7 +5853,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5766,20 +5864,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "reset.js"
       ]
     },
-    "compile:thread:sync": {
+    "compile:thread:create": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "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.",
@@ -5811,11 +5909,24 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "Thread label",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "compile:thread:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5827,19 +5938,19 @@
         "commands",
         "compile",
         "thread",
-        "sync.js"
+        "create.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:delete": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "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.",
@@ -5872,50 +5983,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"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "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"
+        "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",
@@ -5926,20 +6003,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 and/or reassign face speaker)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5971,11 +6048,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "New thread label",
+          "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",
+          "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",
@@ -5985,21 +6076,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "delete.js"
+        "compile",
+        "thread",
+        "edit.js"
       ]
     },
-    "compile:doc:edit": {
+    "compile:thread:get": {
       "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": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6031,50 +6122,11 @@
           "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"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "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:doc:edit",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6085,20 +6137,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "edit.js"
+        "thread",
+        "get.js"
       ]
     },
-    "compile:doc:get": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Get a document by ID",
+      "description": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6134,7 +6186,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6145,24 +6197,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "get.js"
+        "thread",
+        "list.js"
       ]
     },
-    "compile:doc": {
+    "compile:thread:make": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Compile one or more documents into a face (create → make in one step). Repeat --file to submit several documents in a single command; each file becomes its own document rather than being concatenated.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --file notes.txt",
-        "<%= config.bin %> <%= command.id %> alice --file a.txt --file b.txt --file c.txt --no-wait --json"
-      ],
+      "description": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6195,51 +6243,8 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Document label/title (single document only; with several files each is labelled by its filename)",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "description": "Inline text content",
-          "exclusive": [
-            "file"
-          ],
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read content from file (repeatable — each file becomes its own document)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "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, per document (default: 600)",
+          "description": "Compile timeout in seconds (default: 600)",
           "name": "timeout",
           "default": 600,
           "hasDynamicHelp": false,
@@ -6247,7 +6252,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"
@@ -6255,7 +6260,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6266,20 +6271,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. Each document's full text is omitted unless --verbose, so a face with a real corpus stays readable. For a table of every source, documents and threads together, use face:sources.",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6312,16 +6317,25 @@
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "description": "Include each document's full text",
-          "name": "verbose",
+        "message": {
+          "char": "m",
+          "description": "User message to append",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6332,20 +6346,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": "Ask a running thread compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6378,24 +6392,24 @@
           "multiple": false,
           "type": "option"
         },
+        "no-wait": {
+          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
+          "description": "Seconds to wait for the compile to stop (default: 60)",
           "name": "timeout",
-          "default": 600,
+          "default": 60,
           "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",
@@ -6406,20 +6420,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": "Ask a running document compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6452,24 +6466,16 @@
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
-          "name": "no-wait",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the compile to stop (default: 60)",
-          "name": "timeout",
-          "default": 60,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:pause",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6480,20 +6486,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.",
@@ -6525,17 +6531,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",
@@ -6546,8 +6546,8 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "reset.js"
+        "thread",
+        "sync.js"
       ]
     },
     "face:tag:add": {
@@ -7127,5 +7127,5 @@
       ]
     }
   },
-  "version": "1.8.3"
+  "version": "1.8.4"
 }