faces-cli 1.8.1 → 1.8.2

package/oclif.manifest.json

@@ -1372,7 +1372,7 @@
           "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 (covers speech: transcripts, interviews, calls). 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.",
+          "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,
@@ -1474,7 +1474,7 @@
           "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 (covers speech: transcripts, interviews, calls). 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.",
+          "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,
@@ -1568,7 +1568,7 @@
           "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 (covers speech: transcripts, interviews, calls). 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.",
+          "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,
@@ -1703,7 +1703,7 @@
           "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 (covers speech: transcripts, interviews, calls). 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.",
+          "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,
@@ -1750,10 +1750,10 @@
         "thread.js"
       ]
     },
-    "config:clear": {
+    "compile:all": {
       "aliases": [],
       "args": {},
-      "description": "Delete all saved credentials and config",
+      "description": "Compile all uncompiled documents and threads across all faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1786,16 +1786,18 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "timeout": {
+          "description": "Per-item compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:clear",
+      "id": "compile:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1805,25 +1807,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "compile",
+        "all.js"
       ]
     },
-    "config:set": {
+    "compile:import": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "description": "Import a YouTube video into a face via server-side download and transcription",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1855,64 +1852,56 @@
           "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",
+        "url": {
+          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
+          "name": "url",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "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"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "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": "config:show",
+      "id": "compile:import",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1922,14 +1911,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "show.js"
+        "compile",
+        "import.js"
       ]
     },
-    "face:attributes": {
+    "compile:stats": {
       "aliases": [],
       "args": {},
-      "description": "List all supported attribute keys",
+      "description": "Show compilation stats per face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1965,7 +1954,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:attributes",
+      "id": "compile:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1975,14 +1964,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "attributes.js"
+        "compile",
+        "stats.js"
       ]
     },
-    "face:create": {
+    "compile:upload": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new face",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2015,85 +2010,62 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Display name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "alias": {
-          "description": "Unique alias slug",
-          "name": "alias",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "default-model": {
-          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "default-model",
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "formula": {
-          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
-          "name": "formula",
+        "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"
         },
-        "attr": {
-          "description": "Attribute KEY=VALUE (repeatable)",
-          "name": "attr",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Tool name to enable (repeatable)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "profile-addendum": {
-          "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
-          "name": "profile-addendum",
+        "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"
         },
-        "profile-addendum-file": {
-          "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
-          "exclusive": [
-            "profile-addendum"
-          ],
-          "name": "profile-addendum-file",
-          "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": "face:create",
+      "id": "compile:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2103,20 +2075,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "create.js"
+        "compile",
+        "upload.js"
       ]
     },
-    "face:delete": {
+    "config:clear": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Delete a face permanently",
+      "args": {},
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2158,7 +2124,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:delete",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2168,21 +2134,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "delete.js"
+        "config",
+        "clear.js"
       ]
     },
-    "face:diff": {
+    "config:set": {
       "aliases": [],
-      "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+      "args": {
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
         "base-url": {
           "description": "API base URL",
@@ -2207,19 +2184,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "face": {
-          "description": "Face alias to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2229,20 +2198,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "diff.js"
+        "config",
+        "set.js"
       ]
     },
-    "face:edit": {
+    "config:show": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Edit a face's metadata",
+      "args": {},
+      "description": "Print current config (credentials are masked)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2274,87 +2237,159 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:show",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "show.js"
+      ]
+    },
+    "keys:create": {
+      "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.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "name": {
-          "description": "New display name",
-          "name": "name",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Replace all tags (repeatable, lowercase)",
-          "name": "tag",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "default-model": {
-          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "default-model",
+        "name": {
+          "description": "Key name/label",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "formula": {
-          "description": "New boolean formula (synthetic faces only)",
-          "name": "formula",
+        "expires-days": {
+          "description": "Expiry in days (omit for no expiry)",
+          "name": "expires-days",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attr": {
-          "description": "Update attribute KEY=VALUE (repeatable)",
-          "name": "attr",
+        "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"
         },
-        "tool": {
-          "description": "Tool names to set (replaces list, repeatable)",
-          "name": "tool",
+        "model": {
+          "description": "Allowed model name (repeatable)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "profile-addendum": {
-          "description": "Replace the per-face system prompt (max 100,000 chars).",
-          "name": "profile-addendum",
+        "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": "keys:create",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "create.js"
+      ]
+    },
+    "keys:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all API keys (JWT required)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "profile-addendum-file": {
-          "description": "Replace the per-face system prompt from a file.",
-          "exclusive": [
-            "profile-addendum"
-          ],
-          "name": "profile-addendum-file",
+        "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": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2364,20 +2399,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "edit.js"
+        "keys",
+        "list.js"
       ]
     },
-    "face:get": {
+    "keys:revoke": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Get details for a face by alias",
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2410,23 +2445,16 @@
           "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",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2436,14 +2464,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "get.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "face:list": {
+    "keys:update": {
       "aliases": [],
-      "args": {},
-      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
+      "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.",
@@ -2476,63 +2510,30 @@
           "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",
+        "name": {
+          "description": "New key name",
+          "name": "name",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
           "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",
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
           "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": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2542,22 +2543,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "list.js"
+        "keys",
+        "update.js"
       ]
     },
-    "face:lock": {
+    "style:delete": {
       "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": "Delete a face's captured style. The material it was learned from is kept, so the style can be captured again without re-uploading. This never deletes documents or threads: remove those with compile:doc:delete or compile:thread:delete.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> socrates"
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --yes"
       ],
       "flags": {
         "json": {
@@ -2590,11 +2592,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:lock",
+      "id": "style:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2604,20 +2612,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "lock.js"
+        "style",
+        "delete.js"
       ]
     },
-    "face:neighbors": {
+    "style:make": {
       "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": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --all",
+        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
+        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
+        "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2650,38 +2664,70 @@
           "multiple": false,
           "type": "option"
         },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
+        "source": {
+          "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
+          "name": "source",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all": {
+          "description": "Use every source on the face that is ready. Anything skipped is listed.",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "medium": {
+          "description": "Medium for selected sources that do not already declare one. It does not override a source that does. Each medium is analysed on its own, so an essay never teaches a rule about email.",
+          "name": "medium",
           "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",
+        "model": {
+          "description": "Analyst model (default: gpt-5.6-terra)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "direction": {
-          "description": "nearest (most similar) or furthest (most dissimilar)",
-          "name": "direction",
-          "default": "nearest",
+        "allow-paid": {
+          "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
+          "name": "allow-paid",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "compile": {
+          "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
+          "name": "compile",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "best-of": {
+          "description": "Generate N candidates and keep the best (1-5, default 1)",
+          "name": "best-of",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Start the build and return the job id without polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "How long to wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "nearest",
-            "furthest"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:neighbors",
+      "id": "style:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2691,11 +2737,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "neighbors.js"
+        "style",
+        "make.js"
       ]
     },
-    "face:publish": {
+    "style:revert": {
       "aliases": [],
       "args": {
         "alias": {
@@ -2704,9 +2750,10 @@
           "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.",
+      "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.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice --yes"
+        "<%= config.bin %> <%= command.id %> alice --yes",
+        "<%= config.bin %> <%= command.id %> alice --medium email --yes"
       ],
       "flags": {
         "json": {
@@ -2740,6 +2787,13 @@
           "multiple": false,
           "type": "option"
         },
+        "medium": {
+          "description": "Which style to step back, when the face has more than one. See faces style:versions <alias>.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "description": "Skip confirmation",
           "name": "yes",
@@ -2749,7 +2803,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:publish",
+      "id": "style:revert",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2759,25 +2813,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "publish.js"
+        "style",
+        "revert.js"
       ]
     },
-    "face:share": {
+    "style:status": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
+        "job_id": {
+          "description": "Build job id",
+          "name": "job_id",
+          "required": false
         }
       },
-      "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": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
       "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 %> 7a8b9c0d",
+        "<%= config.bin %> <%= command.id %> --face alice",
+        "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
       ],
       "flags": {
         "json": {
@@ -2811,54 +2864,39 @@
           "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",
+        "face": {
+          "description": "List recent builds for this face instead of reading one job",
+          "name": "face",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "with": {
-          "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
-          "exclusive": [
-            "add",
-            "none"
-          ],
-          "name": "with",
+        "limit": {
+          "description": "How many builds to list with --face (default: 10)",
+          "name": "limit",
+          "default": 10,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "none": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "add",
-            "with"
-          ],
-          "name": "none",
+        "wait": {
+          "description": "Block until the job finishes",
+          "name": "wait",
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "description": "Skip the confirmation shown when someone would lose access",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "timeout": {
+          "description": "How long to wait with --wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:share",
+      "id": "style:status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2868,24 +2906,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "share.js"
+        "style",
+        "status.js"
       ]
     },
-    "face:sources": {
+    "style:upload": {
       "aliases": [],
       "args": {
         "alias": {
           "description": "Face alias",
           "name": "alias",
           "required": true
+        },
+        "file": {
+          "description": "Corpus file",
+          "name": "file",
+          "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.",
+      "description": "Load a corpus of a person's own writing (a mail export, a message archive) as source material for style capture. This only stores the material: nothing is compiled and nothing is billed. Capture the style afterwards with style:make.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --type thread",
-        "<%= config.bin %> <%= command.id %> alice --json"
+        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl",
+        "<%= config.bin %> <%= command.id %> alice ./thread.json --type thread_json",
+        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --messages-per-room 100 --strict"
       ],
       "flags": {
         "json": {
@@ -2920,20 +2963,35 @@
           "type": "option"
         },
         "type": {
-          "description": "Show only one kind of source",
+          "description": "email_jsonl: one message per line, split across several rooms. thread_json: a JSON array that becomes a single room.",
           "name": "type",
+          "default": "email_jsonl",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "doc",
-            "thread"
+            "email_jsonl",
+            "thread_json"
           ],
           "type": "option"
+        },
+        "messages-per-room": {
+          "description": "How many messages per room when the type is email_jsonl (1-1000, default: 50)",
+          "name": "messages-per-room",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "strict": {
+          "description": "Reject the whole upload if any message is invalid. By default invalid messages are skipped and reported, because a corpus is statistical and a few bad lines are not worth losing the rest.",
+          "name": "strict",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:sources",
+      "id": "style:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2943,14 +3001,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "sources.js"
+        "style",
+        "upload.js"
       ]
     },
-    "face:stats": {
+    "style:versions": {
       "aliases": [],
-      "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "List the styles captured for a face, and which one it writes in now. A face holds one style per medium, so more than one can be in use at once: an email style and an essay style are separate and do not replace each other. Two versions are kept per medium, which is what style:revert has to go back to.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2986,7 +3054,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:stats",
+      "id": "style:versions",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2996,20 +3064,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "stats.js"
+        "style",
+        "versions.js"
       ]
     },
-    "face:teams": {
+    "team:add": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Set a face's team memberships (replaces all)",
+      "description": "Add face(s) to a team. A team may only contain faces this account owns: a published or shared face can be chatted with but cannot be a member.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3042,9 +3110,9 @@
           "multiple": false,
           "type": "option"
         },
-        "team": {
-          "description": "Team ID (repeatable, replaces all memberships)",
-          "name": "team",
+        "face": {
+          "description": "Face alias to add (repeatable)",
+          "name": "face",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
@@ -3053,7 +3121,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:teams",
+      "id": "team:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3063,23 +3131,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "teams.js"
+        "team",
+        "add.js"
       ]
     },
-    "face:unlock": {
+    "team:create": {
       "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"
-      ],
+      "args": {},
+      "description": "Create a new team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3111,11 +3170,47 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Team name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Plain-text team description (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol": {
+          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
+          "name": "protocol",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unlock",
+      "id": "team:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3125,20 +3220,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unlock.js"
+        "team",
+        "create.js"
       ]
     },
-    "face:unpublish": {
+    "team:delete": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_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": "Delete a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3170,11 +3265,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unpublish",
+      "id": "team:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3184,24 +3285,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unpublish.js"
+        "team",
+        "delete.js"
       ]
     },
-    "face:unshare": {
+    "team:edit": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_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": "Edit a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3234,35 +3331,38 @@
           "multiple": false,
           "type": "option"
         },
-        "from": {
-          "description": "Account to revoke (repeatable)",
-          "exclusive": [
-            "all"
-          ],
-          "name": "from",
+        "name": {
+          "description": "New team name",
+          "name": "name",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "from"
-          ],
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "description": {
+          "description": "New description (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "protocol": {
+          "description": "New protocol content",
+          "name": "protocol",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unshare",
+      "id": "team:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3272,14 +3372,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unshare.js"
+        "team",
+        "edit.js"
       ]
     },
-    "keys:create": {
+    "team:get": {
       "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": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        }
+      },
+      "description": "Get a team by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3311,53 +3417,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "Key name/label",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "expires-days": {
-          "description": "Expiry in days (omit for no expiry)",
-          "name": "expires-days",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "budget": {
-          "description": "Spend budget in USD",
-          "name": "budget",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "face": {
-          "description": "Allowed face alias (repeatable)",
-          "name": "face",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "model": {
-          "description": "Allowed model name (repeatable)",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "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": "keys:create",
+      "id": "team:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3367,14 +3431,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "team",
+        "get.js"
       ]
     },
-    "keys:list": {
+    "team:list": {
       "aliases": [],
       "args": {},
-      "description": "List all API keys (JWT required)",
+      "description": "List your teams",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3410,7 +3474,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "team:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3420,20 +3484,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
+        "team",
         "list.js"
       ]
     },
-    "keys:revoke": {
+    "team:members": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "List members of a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3465,17 +3529,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "team:members",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3485,20 +3543,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "team",
+        "members.js"
       ]
     },
-    "keys:update": {
+    "team:remove": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        },
+        "alias": {
+          "description": "Face alias to remove",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Update API key metadata (JWT required)",
+      "description": "Remove a face from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3530,31 +3593,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "New key name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "team:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3564,24 +3607,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "team",
+        "remove.js"
       ]
     },
-    "style:delete": {
+    "face:attributes": {
       "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Delete a face's captured style. The material it was learned from is kept, so the style can be captured again without re-uploading. This never deletes documents or threads: remove those with compile:doc:delete or compile:thread:delete.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --yes"
-      ],
+      "args": {},
+      "description": "List all supported attribute keys",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3613,17 +3646,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:delete",
+      "id": "face:attributes",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3633,26 +3660,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "delete.js"
+        "face",
+        "attributes.js"
       ]
     },
-    "style:make": {
+    "face:create": {
       "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --all",
-        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
-        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
-        "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
-      ],
+      "args": {},
+      "description": "Create a new face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3685,62 +3700,77 @@
           "multiple": false,
           "type": "option"
         },
-        "source": {
-          "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
-          "name": "source",
+        "name": {
+          "description": "Display name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Use every source on the face that is ready. Anything skipped is listed.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "Medium for any selected source that does not declare one. Each medium is analysed on its own, so an essay never teaches a rule about email.",
-          "name": "medium",
+        "alias": {
+          "description": "Unique alias slug",
+          "name": "alias",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Analyst model (default: gpt-5.6-terra)",
-          "name": "model",
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "allow-paid": {
-          "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
-          "name": "allow-paid",
-          "allowNo": false,
-          "type": "boolean"
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         },
-        "compile": {
-          "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
-          "name": "compile",
-          "allowNo": true,
-          "type": "boolean"
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "best-of": {
-          "description": "Generate N candidates and keep the best (1-5, default 1)",
-          "name": "best-of",
+        "formula": {
+          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
+          "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Start the build and return the job id without polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
+        "attr": {
+          "description": "Attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         },
-        "timeout": {
-          "description": "How long to wait, in seconds (default: 3600)",
-          "name": "timeout",
-          "default": 3600,
+        "tool": {
+          "description": "Tool name to enable (repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "profile-addendum": {
+          "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
+          "name": "profile-addendum",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile-addendum-file": {
+          "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
+          "exclusive": [
+            "profile-addendum"
+          ],
+          "name": "profile-addendum-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3748,7 +3778,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:make",
+      "id": "face:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3758,23 +3788,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "make.js"
+        "face",
+        "create.js"
       ]
     },
-    "style:revert": {
+    "face:delete": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Go back to the style a face had before the last style:make. It steps backwards through the kept versions and there is no step forward, so the way to undo a revert is to capture the style again. It changes how the face writes immediately, so it asks first.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --yes"
-      ],
+      "description": "Delete a face permanently",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3816,7 +3843,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:revert",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3826,25 +3853,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "revert.js"
+        "face",
+        "delete.js"
       ]
     },
-    "style:status": {
+    "face:diff": {
       "aliases": [],
-      "args": {
-        "job_id": {
-          "description": "Build job id",
-          "name": "job_id",
-          "required": false
-        }
-      },
-      "description": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 7a8b9c0d",
-        "<%= config.bin %> <%= command.id %> --face alice",
-        "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
-      ],
+      "args": {},
+      "description": "Compare owned faces pairwise across all centroid components",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3878,38 +3894,17 @@
           "type": "option"
         },
         "face": {
-          "description": "List recent builds for this face instead of reading one job",
+          "description": "Face alias to include (repeatable, min 2)",
           "name": "face",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "description": "How many builds to list with --face (default: 10)",
-          "name": "limit",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "Block until the job finishes",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "How long to wait with --wait, in seconds (default: 3600)",
-          "name": "timeout",
-          "default": 3600,
-          "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:status",
+      "id": "face:diff",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3919,30 +3914,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "status.js"
+        "face",
+        "diff.js"
       ]
     },
-    "style:upload": {
+    "face:edit": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
-          "required": true
-        },
-        "file": {
-          "description": "Corpus file",
-          "name": "file",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Load a corpus of a person's own writing (a mail export, a message archive) as source material for style capture. This only stores the material: nothing is compiled and nothing is billed. Capture the style afterwards with style:make.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl",
-        "<%= config.bin %> <%= command.id %> alice ./thread.json --type thread_json",
-        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --messages-per-room 100 --strict"
-      ],
+      "description": "Edit a face's metadata",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3975,99 +3960,86 @@
           "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "email_jsonl: one message per line, split across several rooms. thread_json: a JSON array that becomes a single room.",
-          "name": "type",
-          "default": "email_jsonl",
+        "name": {
+          "description": "New display name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "email_jsonl",
-            "thread_json"
-          ],
           "type": "option"
         },
-        "messages-per-room": {
-          "description": "How many messages per room when the type is email_jsonl (1-1000, default: 50)",
-          "name": "messages-per-room",
-          "default": 50,
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "strict": {
-          "description": "Reject the whole upload if any message is invalid. By default invalid messages are skipped and reported, because a corpus is statistical and a few bad lines are not worth losing the rest.",
-          "name": "strict",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "style:upload",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "style",
-        "upload.js"
-      ]
-    },
-    "style:versions": {
-      "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "List the styles captured for a face, and which one it is writing in now. Each style:make keeps the previous one, so this is what style:revert has to go back to.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "tag": {
+          "description": "Replace all tags (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "formula": {
+          "description": "New boolean formula (synthetic faces only)",
+          "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "attr": {
+          "description": "Update attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool names to set (replaces list, repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "profile-addendum": {
+          "description": "Replace the per-face system prompt (max 100,000 chars).",
+          "name": "profile-addendum",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "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": "style:versions",
+      "id": "face:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4077,20 +4049,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "versions.js"
+        "face",
+        "edit.js"
       ]
     },
-    "team:add": {
+    "face:get": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Add face(s) to a team",
+      "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.",
@@ -4123,18 +4095,23 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to add (repeatable)",
-          "name": "face",
-          "required": true,
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "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": "team:add",
+      "id": "face:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4144,14 +4121,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "add.js"
+        "face",
+        "get.js"
       ]
     },
-    "team:create": {
+    "face:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new team",
+      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4184,38 +4161,55 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Team name",
-          "name": "name",
-          "required": true,
+        "tag": {
+          "description": "Filter by tag (repeatable, AND logic)",
+          "name": "tag",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "description": {
-          "description": "Plain-text team description (max 1500 chars)",
-          "name": "description",
+        "team": {
+          "description": "Filter by team ID (repeatable, OR logic)",
+          "name": "team",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "protocol": {
-          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
-          "name": "protocol",
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "protocol-file": {
-          "description": "Read protocol from file",
-          "name": "protocol-file",
+        "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": false,
+          "multiple": true,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
+        "not-from-users": {
+          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
+          "name": "not-from-users",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -4223,7 +4217,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:create",
+      "id": "face:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4233,20 +4227,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "create.js"
+        "face",
+        "list.js"
       ]
     },
-    "team:delete": {
+    "face:lock": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Delete a team",
+      "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.",
@@ -4278,17 +4275,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:delete",
+      "id": "face:lock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4298,20 +4289,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "delete.js"
+        "face",
+        "lock.js"
       ]
     },
-    "team:edit": {
+    "face:neighbors": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Edit a team",
+      "description": "Find the most similar or dissimilar owned faces to a given face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4344,38 +4335,38 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "New team name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "New description (max 1500 chars)",
-          "name": "description",
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "protocol": {
-          "description": "New protocol content",
-          "name": "protocol",
+        "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"
         },
-        "protocol-file": {
-          "description": "Read protocol from file",
-          "name": "protocol-file",
+        "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": "team:edit",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4385,20 +4376,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "edit.js"
+        "face",
+        "neighbors.js"
       ]
     },
-    "team:get": {
+    "face:publish": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Get a team by ID",
+      "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.",
@@ -4430,11 +4424,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:get",
+      "id": "face:publish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4444,14 +4444,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "get.js"
+        "face",
+        "publish.js"
       ]
     },
-    "team:list": {
+    "face:share": {
       "aliases": [],
-      "args": {},
-      "description": "List your teams",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "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.",
+      "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"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4483,11 +4495,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": "team:list",
+      "id": "face:share",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4497,20 +4553,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "list.js"
+        "face",
+        "share.js"
       ]
     },
-    "team:members": {
+    "face:sources": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "List members of a team",
+      "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.",
@@ -4542,11 +4603,22 @@
           "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": "team:members",
+      "id": "face:sources",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4556,25 +4628,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "members.js"
+        "face",
+        "sources.js"
       ]
     },
-    "team:remove": {
+    "face:stats": {
       "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        },
-        "alias": {
-          "description": "Face alias to remove",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Remove a face from a team",
+      "args": {},
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4610,7 +4671,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:remove",
+      "id": "face:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4620,14 +4681,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "remove.js"
+        "face",
+        "stats.js"
       ]
     },
-    "compile:all": {
+    "face:teams": {
       "aliases": [],
-      "args": {},
-      "description": "Compile all uncompiled documents and threads across all faces",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Set a face's team memberships (replaces all)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4660,18 +4727,18 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Per-item compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
+        "team": {
+          "description": "Team ID (repeatable, replaces all memberships)",
+          "name": "team",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:all",
+      "id": "face:teams",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4681,11 +4748,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "all.js"
+        "face",
+        "teams.js"
       ]
     },
-    "compile:import": {
+    "face:unlock": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -4694,7 +4761,10 @@
           "required": true
         }
       },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4726,56 +4796,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": "face:unlock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4785,14 +4810,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.js"
+        "face",
+        "unlock.js"
       ]
     },
-    "compile:stats": {
+    "face:unpublish": {
       "aliases": [],
-      "args": {},
-      "description": "Show compilation stats per face",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "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.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4828,7 +4859,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:stats",
+      "id": "face:unpublish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4838,11 +4869,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "stats.js"
+        "face",
+        "unpublish.js"
       ]
     },
-    "compile:upload": {
+    "face:unshare": {
       "aliases": [],
       "args": {
         "alias": {
@@ -4851,7 +4882,11 @@
           "required": true
         }
       },
-      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
+      "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.",
@@ -4860,86 +4895,59 @@
           "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"
-        },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "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 (covers speech: transcripts, interviews, calls). 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",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "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",
+        "from": {
+          "description": "Account to revoke (repeatable)",
+          "exclusive": [
+            "all"
+          ],
+          "name": "from",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
+        "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": "compile:upload",
+      "id": "face:unshare",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4949,8 +4957,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "upload.js"
+        "face",
+        "unshare.js"
       ]
     },
     "billing:subscription:activate": {
@@ -5132,16 +5140,16 @@
         "index.js"
       ]
     },
-    "face:tag:add": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Add tags to a face (appends, idempotent)",
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5174,18 +5182,50 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to add (repeatable)",
-          "name": "tag",
-          "required": true,
+        "label": {
+          "description": "Document label/title",
+          "name": "label",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:add",
+      "id": "compile:doc:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5195,15 +5235,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "add.js"
+        "compile",
+        "doc",
+        "create.js"
       ]
     },
-    "face:tag:all": {
+    "compile:doc:delete": {
       "aliases": [],
-      "args": {},
-      "description": "List all tags across all your faces",
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Delete a document",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5239,7 +5285,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:all",
+      "id": "compile:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5249,21 +5295,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "all.js"
+        "compile",
+        "doc",
+        "delete.js"
       ]
     },
-    "face:tag:list": {
+    "compile:doc:edit": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "List tags on a face",
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5295,11 +5341,50 @@
           "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": "face:tag:list",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5309,26 +5394,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "list.js"
+        "compile",
+        "doc",
+        "edit.js"
       ]
     },
-    "face:tag:remove": {
+    "compile:doc:get": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        },
-        "tag": {
-          "description": "Tag to remove",
-          "name": "tag",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Remove a tag from a face",
+      "description": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5364,7 +5444,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:remove",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5374,21 +5454,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "remove.js"
+        "compile",
+        "doc",
+        "get.js"
       ]
     },
-    "face:tag:set": {
+    "compile:doc": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Replace all tags on 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.",
@@ -5405,34 +5489,83 @@
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "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"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "perspective": {
+          "description": "Perspective",
+          "name": "perspective",
+          "default": "first-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to set (repeatable, replaces all)",
-          "name": "tag",
-          "required": true,
+        "timeout": {
+          "description": "Compile timeout in seconds, per document (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "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": "face:tag:set",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5442,21 +5575,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "set.js"
+        "compile",
+        "doc",
+        "index.js"
       ]
     },
-    "team:tag:add": {
+    "compile:doc:list": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Add tags to a team (appends, idempotent)",
+      "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.",
@@ -5489,18 +5622,16 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to add (repeatable)",
-          "name": "tag",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "verbose": {
+          "description": "Include each document's full text",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:add",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5510,21 +5641,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "add.js"
+        "compile",
+        "doc",
+        "list.js"
       ]
     },
-    "team:tag:list": {
+    "compile:doc:make": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "List tags on a team",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5556,11 +5687,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:list",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5570,26 +5715,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "list.js"
+        "compile",
+        "doc",
+        "make.js"
       ]
     },
-    "team:tag:remove": {
+    "compile:doc:pause": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        },
-        "tag": {
-          "description": "Tag to remove",
-          "name": "tag",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Remove a tag from a team",
+      "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.",
@@ -5621,11 +5761,25 @@
           "hasDynamicHelp": false,
           "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": "Seconds to wait for the compile to stop (default: 60)",
+          "name": "timeout",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:remove",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5635,21 +5789,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "remove.js"
+        "compile",
+        "doc",
+        "pause.js"
       ]
     },
-    "team:tag:set": {
+    "compile:doc:reset": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Replace all tags on a team",
+      "description": "Reset document compilation progress (wipe extraction, keep content)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5682,18 +5836,16 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to set (repeatable, replaces all)",
-          "name": "tag",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:set",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5703,12 +5855,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "set.js"
+        "compile",
+        "doc",
+        "reset.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5717,7 +5869,7 @@
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Start a new thread for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5751,49 +5903,22 @@
           "type": "option"
         },
         "label": {
-          "description": "Document label/title",
+          "description": "Thread label",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "Inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read content from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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 (covers speech: transcripts, interviews, calls). 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"
+        "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:create",
+      "id": "compile:thread:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5804,20 +5929,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "create.js"
       ]
     },
-    "compile:doc:delete": {
+    "compile:thread:delete": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Delete a document",
+      "description": "Delete a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5849,11 +5974,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5864,20 +5995,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "delete.js"
       ]
     },
-    "compile:doc:edit": {
+    "compile:thread:edit": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Edit a document (label, content, or perspective)",
+      "description": "Edit a thread (label and/or reassign face speaker)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5911,48 +6042,23 @@
           "type": "option"
         },
         "label": {
-          "description": "New label/title",
+          "description": "New thread label",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "New inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read new content from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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 (covers speech: transcripts, interviews, calls). 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",
+        "face-speaker": {
+          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:edit",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5963,20 +6069,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "edit.js"
       ]
     },
-    "compile:doc:get": {
+    "compile:thread:get": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Get a document by ID",
+      "description": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6012,7 +6118,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6023,11 +6129,11 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "get.js"
       ]
     },
-    "compile:doc": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -6036,11 +6142,7 @@
           "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": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6072,68 +6174,11 @@
           "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 (covers speech: transcripts, interviews, calls). 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)",
-          "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:doc",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6144,20 +6189,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "index.js"
+        "thread",
+        "list.js"
       ]
     },
-    "compile:doc:list": {
+    "compile:thread:make": {
       "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": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6190,16 +6235,24 @@
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "description": "Include each document's full text",
-          "name": "verbose",
+        "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",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6210,20 +6263,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "list.js"
+        "thread",
+        "make.js"
       ]
     },
-    "compile:doc:make": {
+    "compile:thread:message": {
       "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": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6256,24 +6309,25 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
+        "message": {
+          "char": "m",
+          "description": "User message to append",
+          "name": "message",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
-          "name": "no-wait",
+        "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:make",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6284,20 +6338,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "make.js"
+        "thread",
+        "message.js"
       ]
     },
-    "compile:doc:pause": {
+    "compile:thread:pause": {
       "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": "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.",
@@ -6347,7 +6401,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:pause",
+      "id": "compile:thread:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6358,20 +6412,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "pause.js"
       ]
     },
-    "compile:doc:reset": {
+    "compile:thread:reset": {
       "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": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6413,7 +6467,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:reset",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6424,20 +6478,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "reset.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:thread:sync": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Start a new thread for a face",
+      "description": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6469,24 +6523,11 @@
           "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:create",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6498,19 +6539,19 @@
         "commands",
         "compile",
         "thread",
-        "create.js"
+        "sync.js"
       ]
     },
-    "compile:thread:delete": {
+    "team:tag:add": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Delete a thread",
+      "description": "Add tags to a team (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6540,19 +6581,21 @@
           "env": "FACES_API_KEY",
           "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "description": "Tag to add (repeatable)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:delete",
+      "id": "team:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6562,21 +6605,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "delete.js"
+        "team",
+        "tag",
+        "add.js"
       ]
     },
-    "compile:thread:edit": {
+    "team:tag:list": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Edit a thread (label and/or reassign face speaker)",
+      "description": "List tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6608,25 +6651,11 @@
           "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:thread:edit",
+      "id": "team:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6636,21 +6665,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "edit.js"
+        "team",
+        "tag",
+        "list.js"
       ]
     },
-    "compile:thread:get": {
+    "team:tag:remove": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        },
+        "tag": {
+          "description": "Tag to remove",
+          "name": "tag",
           "required": true
         }
       },
-      "description": "Get a thread by ID",
+      "description": "Remove a tag from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6686,7 +6720,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "team:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6696,21 +6730,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "get.js"
+        "team",
+        "tag",
+        "remove.js"
       ]
     },
-    "compile:thread:list": {
+    "team:tag:set": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "Replace all tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6742,11 +6776,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Tag to set (repeatable, replaces all)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:list",
+      "id": "team:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6756,21 +6798,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "list.js"
+        "team",
+        "tag",
+        "set.js"
       ]
     },
-    "compile:thread:make": {
+    "face:tag:add": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Compile an existing thread (prepare + sync in one step)",
+      "description": "Add tags to a face (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6803,24 +6845,18 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
+        "tag": {
+          "description": "Tag to add (repeatable)",
+          "name": "tag",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "face:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6830,21 +6866,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "make.js"
+        "face",
+        "tag",
+        "add.js"
       ]
     },
-    "compile:thread:message": {
+    "face:tag:all": {
       "aliases": [],
-      "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
-          "required": true
-        }
-      },
-      "description": "Send a user message to a thread",
+      "args": {},
+      "description": "List all tags across all your faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6876,26 +6906,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "User message to append",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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:message",
+      "id": "face:tag:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6905,21 +6920,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "message.js"
+        "face",
+        "tag",
+        "all.js"
       ]
     },
-    "compile:thread:pause": {
+    "face:tag:list": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "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": "List tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6951,25 +6966,11 @@
           "hasDynamicHelp": false,
           "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": "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:thread:pause",
+      "id": "face:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6979,21 +6980,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "pause.js"
+        "face",
+        "tag",
+        "list.js"
       ]
     },
-    "compile:thread:reset": {
+    "face:tag:remove": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        },
+        "tag": {
+          "description": "Tag to remove",
+          "name": "tag",
           "required": true
         }
       },
-      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
+      "description": "Remove a tag from a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -7025,17 +7031,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "face:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -7045,21 +7045,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "reset.js"
+        "face",
+        "tag",
+        "remove.js"
       ]
     },
-    "compile:thread:sync": {
+    "face:tag:set": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Archive and sync a thread into a face",
+      "description": "Replace all tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -7091,11 +7091,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Tag to set (repeatable, replaces all)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "face:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -7105,11 +7113,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "thread",
-        "sync.js"
+        "face",
+        "tag",
+        "set.js"
       ]
     }
   },
-  "version": "1.8.1"
+  "version": "1.8.2"
 }