npm - faces-cli - Versions diffs - 1.8.2 → 1.8.4 - Mend

faces-cli 1.8.2 → 1.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/commands/style/revert.js +9 -12
package/dist/commands/team/add.d.ts +1 -0
package/dist/commands/team/add.js +10 -15
package/dist/commands/team/members.d.ts +1 -0
package/dist/commands/team/members.js +53 -4
package/oclif.manifest.json +1527 -1519
package/package.json +1 -1

package/oclif.manifest.json CHANGED Viewed

@@ -120,10 +120,23 @@
         "state.js"
       ]
     },
-    "billing:balance": {
+    "auth:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Show credit balance and payment method status",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to connect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
+      "examples": [
+        "<%= config.bin %> auth connect openai",
+        "<%= config.bin %> auth connect openai --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -159,7 +172,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "auth:connect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -169,14 +182,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "auth",
+        "connect.js"
       ]
     },
-    "billing:card-setup": {
+    "auth:connections": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "List connected OAuth provider accounts",
+      "examples": [
+        "<%= config.bin %> auth connections",
+        "<%= config.bin %> auth connections --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -212,7 +229,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "auth:connections",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -222,14 +239,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "auth",
+        "connections.js"
       ]
     },
-    "billing:llm-costs": {
+    "auth:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to disconnect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Disconnect a linked OAuth provider account",
+      "examples": [
+        "<%= config.bin %> auth disconnect openai"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -261,18 +290,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "auth:disconnect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -282,14 +304,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "auth",
+        "disconnect.js"
       ]
     },
-    "billing:topup": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Login and save JWT credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -322,17 +344,18 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
+        "email": {
+          "description": "Account email",
+          "name": "email",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "password": {
+          "description": "Account password",
+          "name": "password",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -340,7 +363,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "auth:login",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -350,14 +373,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "auth",
+        "login.js"
       ]
     },
-    "billing:usage": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "Clear saved credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -389,38 +412,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
-          ],
-          "type": "option"
-        },
-        "from": {
-          "description": "Start date (YYYY-MM-DD)",
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "to": {
-          "description": "End date (YYYY-MM-DD)",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "auth:logout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -430,27 +426,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "auth:connect": {
+    "auth:refresh": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to connect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
-      "examples": [
-        "<%= config.bin %> auth connect openai",
-        "<%= config.bin %> auth connect openai --json"
-      ],
+      "args": {},
+      "description": "Exchange current JWT for a fresh one",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -486,7 +469,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connect",
+      "id": "auth:refresh",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -497,17 +480,13 @@
         "dist",
         "commands",
         "auth",
-        "connect.js"
+        "refresh.js"
       ]
     },
-    "auth:connections": {
+    "auth:register": {
       "aliases": [],
       "args": {},
-      "description": "List connected OAuth provider accounts",
-      "examples": [
-        "<%= config.bin %> auth connections",
-        "<%= config.bin %> auth connections --json"
-      ],
+      "description": "Create a new Faces account",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -539,11 +518,54 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "email": {
+          "description": "Email address",
+          "name": "email",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Password",
+          "name": "password",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "username": {
+          "description": "Username (lowercase, dashes, numbers)",
+          "name": "username",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "invite-key": {
+          "description": "Invite key (if required)",
+          "name": "invite-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plan": {
+          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
+          "name": "plan",
+          "default": "free",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "free",
+            "connect"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connections",
+      "id": "auth:register",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -554,25 +576,13 @@
         "dist",
         "commands",
         "auth",
-        "connections.js"
+        "register.js"
       ]
     },
-    "auth:disconnect": {
+    "auth:whoami": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to disconnect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Disconnect a linked OAuth provider account",
-      "examples": [
-        "<%= config.bin %> auth disconnect openai"
-      ],
+      "args": {},
+      "description": "Print current user profile and auth diagnostic",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -608,7 +618,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:disconnect",
+      "id": "auth:whoami",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -619,13 +629,13 @@
         "dist",
         "commands",
         "auth",
-        "disconnect.js"
+        "whoami.js"
       ]
     },
-    "auth:login": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "Login and save JWT credentials",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -657,27 +667,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "email": {
-          "description": "Account email",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Account password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -687,14 +681,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "auth:logout": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Clear saved credentials",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -730,7 +724,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -740,14 +734,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "auth:refresh": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "Exchange current JWT for a fresh one",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -779,11 +773,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:refresh",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -793,14 +794,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "refresh.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "auth:register": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Faces account",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -833,53 +834,25 @@
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Email address",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "username": {
-          "description": "Username (lowercase, dashes, numbers)",
-          "name": "username",
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "invite-key": {
-          "description": "Invite key (if required)",
-          "name": "invite-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "plan": {
-          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
-          "name": "plan",
-          "default": "free",
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "free",
-            "connect"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:register",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -889,14 +862,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "register.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "auth:whoami": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Print current user profile and auth diagnostic",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -928,11 +901,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
+          "type": "option"
+        },
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -942,8 +942,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "whoami.js"
+        "billing",
+        "usage.js"
       ]
     },
     "catalog:backup": {
@@ -1261,21 +1261,10 @@
         "restore.js"
       ]
     },
-    "chat:chat": {
+    "compile:all": {
       "aliases": [],
-      "args": {
-        "face_username": {
-          "description": "Face alias (alias@model, owner:alias@model for a published face, or a composite formula like \"(a | b)@model\"). Omit when using --formula.",
-          "name": "face_username",
-          "required": false
-        }
-      },
-      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> socrates -m \"What is virtue?\"",
-        "<%= config.bin %> <%= command.id %> \"(socrates | nietzsche)@claude-sonnet-4-6\" -m \"What is virtue?\"",
-        "<%= config.bin %> <%= command.id %> --formula \"socrates | nietzsche\" --llm claude-sonnet-4-6 -m \"What is virtue?\""
-      ],
+      "args": {},
+      "description": "Compile all uncompiled documents and threads across all faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1308,86 +1297,18 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "llm": {
-          "description": "LLM override (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "llm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "formula": {
-          "description": "Compose a run-time composite from your own faces, e.g. \"socrates | nietzsche\" (operators: | & ^ -). Requires --llm. The composite takes the name of its first operand; use face:create --formula for a named, persisted composite.",
-          "name": "formula",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt / instructions",
-          "name": "system",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "temperature": {
-          "description": "Temperature (0.0-2.0)",
-          "name": "temperature",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read message from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "responses": {
-          "description": "Force the OpenAI Responses API endpoint (escape hatch; routing is automatic otherwise)",
-          "name": "responses",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
+        "timeout": {
+          "description": "Per-item compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:chat",
+      "id": "compile:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1397,20 +1318,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "chat.js"
+        "compile",
+        "all.js"
       ]
     },
-    "chat:messages": {
+    "compile:import": {
       "aliases": [],
       "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface, myface@claude-sonnet-4-6, or head:socrates@claude-sonnet-4-6)",
-          "name": "face_model",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
+      "description": "Import a YouTube video into a face via server-side download and transcription",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1443,53 +1364,55 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
+        "url": {
+          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
+          "name": "url",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt",
-          "name": "system",
-          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "default": 1024,
+        "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"
         },
-        "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",
+        "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"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "face-speaker": {
+          "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
+          "name": "face-speaker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:messages",
+      "id": "compile:import",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1499,20 +1422,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "messages.js"
+        "compile",
+        "import.js"
       ]
     },
-    "chat:responses": {
+    "compile:stats": {
       "aliases": [],
-      "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface, myface@gpt-4o, or head:socrates@gpt-5.4)",
-          "name": "face_model",
-          "required": true
-        }
-      },
-      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
+      "args": {},
+      "description": "Show compilation stats per face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1544,46 +1461,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "User input message",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "instructions": {
-          "description": "System instructions",
-          "name": "instructions",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:responses",
+      "id": "compile:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1593,27 +1475,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "responses.js"
+        "compile",
+        "stats.js"
       ]
     },
-    "chat:thread": {
+    "compile:upload": {
       "aliases": [],
       "args": {
-        "face_username": {
-          "description": "Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread",
-          "name": "face_username",
-          "required": false
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
         }
       },
-      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
-        "<%= config.bin %> <%= command.id %> --list",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 --show",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 --delete"
-      ],
+      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1646,97 +1521,62 @@
           "multiple": false,
           "type": "option"
         },
-        "id": {
-          "description": "Resume an existing thread by id",
-          "name": "id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "User message",
-          "name": "message",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "file": {
-          "description": "Read message from file",
+          "description": "File to upload",
           "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "llm": {
-          "description": "LLM override (only honored when starting a new thread)",
-          "name": "llm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt (only honored when starting a new thread)",
-          "name": "system",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "temperature": {
-          "description": "Temperature (0.0-2.0, OpenAI/Chat Completions only)",
-          "name": "temperature",
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. Only valid with --kind document.",
+          "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
+        "face-speaker": {
+          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "list": {
-          "description": "List saved threads",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "show": {
-          "description": "Show the thread transcript (requires --id)",
-          "name": "show",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete": {
-          "description": "Delete the thread (requires --id)",
-          "name": "delete",
+        "no-wait": {
+          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:thread",
+      "id": "compile:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1746,14 +1586,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "thread.js"
+        "compile",
+        "upload.js"
       ]
     },
-    "compile:all": {
+    "config:clear": {
       "aliases": [],
       "args": {},
-      "description": "Compile all uncompiled documents and threads across all faces",
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1786,18 +1626,16 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Per-item compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:all",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1807,20 +1645,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "all.js"
+        "config",
+        "clear.js"
       ]
     },
-    "compile:import": {
+    "config:set": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "description": "Set a config value (e.g. base_url, api_key, token)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1852,56 +1695,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "url": {
-          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
-          "name": "url",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
-          "name": "type",
-          "default": "document",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
-          "type": "option"
-        },
-        "perspective": {
-          "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
-          "name": "perspective",
-          "default": "third-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "face-speaker": {
-          "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
-          "name": "face-speaker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:import",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1911,14 +1709,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.js"
+        "config",
+        "set.js"
       ]
     },
-    "compile:stats": {
+    "config:show": {
       "aliases": [],
       "args": {},
-      "description": "Show compilation stats per face",
+      "description": "Print current config (credentials are masked)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1954,7 +1752,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:stats",
+      "id": "config:show",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1964,20 +1762,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "stats.js"
+        "config",
+        "show.js"
       ]
     },
-    "compile:upload": {
+    "chat:chat": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
+        "face_username": {
+          "description": "Face alias (alias@model, owner:alias@model for a published face, or a composite formula like \"(a | b)@model\"). Omit when using --formula.",
+          "name": "face_username",
+          "required": false
         }
       },
-      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
+      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates -m \"What is virtue?\"",
+        "<%= config.bin %> <%= command.id %> \"(socrates | nietzsche)@claude-sonnet-4-6\" -m \"What is virtue?\"",
+        "<%= config.bin %> <%= command.id %> --formula \"socrates | nietzsche\" --llm claude-sonnet-4-6 -m \"What is virtue?\""
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2010,62 +1813,86 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "required": true,
+        "message": {
+          "char": "m",
+          "description": "User message (repeatable)",
+          "name": "message",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "llm": {
+          "description": "LLM override (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "llm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
+        "formula": {
+          "description": "Compose a run-time composite from your own faces, e.g. \"socrates | nietzsche\" (operators: | & ^ -). Requires --llm. The composite takes the name of its first operand; use face:create --formula for a named, persisted composite.",
+          "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
+        "system": {
+          "description": "System prompt / instructions",
+          "name": "system",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. Only valid with --kind document.",
-          "name": "medium",
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
-          "name": "face-speaker",
+        "temperature": {
+          "description": "Temperature (0.0-2.0)",
+          "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "responses": {
+          "description": "Force the OpenAI Responses API endpoint (escape hatch; routing is automatic otherwise)",
+          "name": "responses",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "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:upload",
+      "id": "chat:chat",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2075,14 +1902,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "upload.js"
+        "chat",
+        "chat.js"
       ]
     },
-    "config:clear": {
+    "chat:messages": {
       "aliases": [],
-      "args": {},
-      "description": "Delete all saved credentials and config",
+      "args": {
+        "face_model": {
+          "description": "Face model (e.g. myface, myface@claude-sonnet-4-6, or head:socrates@claude-sonnet-4-6)",
+          "name": "face_model",
+          "required": true
+        }
+      },
+      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2115,16 +1948,53 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "message": {
+          "char": "m",
+          "description": "User message (repeatable)",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "system": {
+          "description": "System prompt",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "default": 1024,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:clear",
+      "id": "chat:messages",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2134,25 +2004,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "chat",
+        "messages.js"
       ]
     },
-    "config:set": {
+    "chat:responses": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
+        "face_model": {
+          "description": "Face model (e.g. myface, myface@gpt-4o, or head:socrates@gpt-5.4)",
+          "name": "face_model",
           "required": true
         }
       },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2184,11 +2049,46 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User input message",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:set",
+      "id": "chat:responses",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2198,14 +2098,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "chat",
+        "responses.js"
       ]
     },
-    "config:show": {
+    "chat:thread": {
       "aliases": [],
-      "args": {},
-      "description": "Print current config (credentials are masked)",
+      "args": {
+        "face_username": {
+          "description": "Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread",
+          "name": "face_username",
+          "required": false
+        }
+      },
+      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
+        "<%= config.bin %> <%= command.id %> --list",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 --show",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 --delete"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2237,11 +2150,98 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "id": {
+          "description": "Resume an existing thread by id",
+          "name": "id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User message",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "llm": {
+          "description": "LLM override (only honored when starting a new thread)",
+          "name": "llm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "system": {
+          "description": "System prompt (only honored when starting a new thread)",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "description": "Temperature (0.0-2.0, OpenAI/Chat Completions only)",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "medium": {
+          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "list": {
+          "description": "List saved threads",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "show": {
+          "description": "Show the thread transcript (requires --id)",
+          "name": "show",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "delete": {
+          "description": "Delete the thread (requires --id)",
+          "name": "delete",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:show",
+      "id": "chat:thread",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2251,14 +2251,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "show.js"
+        "chat",
+        "thread.js"
       ]
     },
-    "keys:create": {
+    "face:attributes": {
       "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.",
+      "description": "List all supported attribute keys",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2290,53 +2290,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": "face:attributes",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2346,14 +2304,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "face",
+        "attributes.js"
       ]
     },
-    "keys:list": {
+    "face:create": {
       "aliases": [],
       "args": {},
-      "description": "List all API keys (JWT required)",
+      "description": "Create a new face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2385,11 +2343,86 @@
           "hasDynamicHelp": false,
           "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",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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",
+          "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "face:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2399,20 +2432,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "list.js"
+        "face",
+        "create.js"
       ]
     },
-    "keys:revoke": {
+    "face:delete": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "Delete a face permanently",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2454,7 +2487,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2464,20 +2497,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "face",
+        "delete.js"
       ]
     },
-    "keys:update": {
+    "face:diff": {
       "aliases": [],
-      "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
-          "required": true
-        }
-      },
-      "description": "Update API key metadata (JWT required)",
+      "args": {},
+      "description": "Compare owned faces pairwise across all centroid components",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2510,30 +2537,18 @@
           "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",
+        "face": {
+          "description": "Face alias to include (repeatable, min 2)",
+          "name": "face",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
-        },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "face:diff",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2543,24 +2558,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "face",
+        "diff.js"
       ]
     },
-    "style:delete": {
+    "face:edit": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "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"
-      ],
+      "description": "Edit a face's metadata",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2593,16 +2604,86 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "name": {
+          "description": "New display name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "description": "Replace all tags (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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "formula": {
+          "description": "New boolean formula (synthetic faces only)",
+          "name": "formula",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attr": {
+          "description": "Update attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool names to set (replaces list, repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "profile-addendum": {
+          "description": "Replace the per-face system prompt (max 100,000 chars).",
+          "name": "profile-addendum",
+          "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",
+          "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:delete",
+      "id": "face:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2612,26 +2693,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "delete.js"
+        "face",
+        "edit.js"
       ]
     },
-    "style:make": {
+    "face:get": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "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"
-      ],
+      "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.",
@@ -2663,71 +2738,24 @@
           "hasDynamicHelp": false,
           "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",
-          "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"
-        },
-        "model": {
-          "description": "Analyst model (default: gpt-5.6-terra)",
-          "name": "model",
-          "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"
-        },
-        "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,
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "full": {
+          "description": "Print the full profile_addendum instead of a truncated preview",
+          "name": "full",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:make",
+      "id": "face:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2737,24 +2765,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "make.js"
+        "face",
+        "get.js"
       ]
     },
-    "style:revert": {
+    "face:list": {
       "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Go back to the style a face had before the last style:make. A face holds one style per medium, so name which one with --medium when it has more than one. Two versions are kept per medium, so this goes back exactly one step. It changes how the face writes immediately, so it asks first.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --yes",
-        "<%= config.bin %> <%= command.id %> alice --medium email --yes"
-      ],
+      "args": {},
+      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2787,23 +2805,63 @@
           "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",
+        "tag": {
+          "description": "Filter by tag (repeatable, AND logic)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "team": {
+          "description": "Filter by team ID (repeatable, OR logic)",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "public": {
+          "description": "Include published faces from other accounts (open to everybody)",
+          "name": "public",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "shared": {
+          "description": "Include faces other accounts have shared with YOU in particular",
+          "name": "shared",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "system": {
+          "description": "Show only the curated system faces (published faces owned by 'head')",
+          "name": "system",
           "allowNo": false,
           "type": "boolean"
+        },
+        "from-users": {
+          "description": "Only published faces from these owners (repeatable/comma-separated)",
+          "name": "from-users",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "not-from-users": {
+          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
+          "name": "not-from-users",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:revert",
+      "id": "face:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2813,24 +2871,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "revert.js"
+        "face",
+        "list.js"
       ]
     },
-    "style:status": {
+    "face:lock": {
       "aliases": [],
       "args": {
-        "job_id": {
-          "description": "Build job id",
-          "name": "job_id",
-          "required": false
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
         }
       },
-      "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.",
+      "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 %> 7a8b9c0d",
-        "<%= config.bin %> <%= command.id %> --face alice",
-        "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
+        "<%= config.bin %> <%= command.id %> socrates"
       ],
       "flags": {
         "json": {
@@ -2863,40 +2919,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "face": {
-          "description": "List recent builds for this face instead of reading one job",
-          "name": "face",
-          "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,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:status",
+      "id": "face:lock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2906,30 +2933,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "status.js"
+        "face",
+        "lock.js"
       ]
     },
-    "style:upload": {
+    "face:neighbors": {
       "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": "Find the most similar or dissimilar owned faces to a given face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2962,36 +2979,38 @@
           "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",
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
           "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,
+        "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"
         },
-        "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"
+        "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": "style:upload",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3001,11 +3020,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "upload.js"
+        "face",
+        "neighbors.js"
       ]
     },
-    "style:versions": {
+    "face:publish": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3014,10 +3033,9 @@
           "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.",
+      "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",
-        "<%= config.bin %> <%= command.id %> alice --json"
+        "<%= config.bin %> <%= command.id %> alice --yes"
       ],
       "flags": {
         "json": {
@@ -3050,11 +3068,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:versions",
+      "id": "face:publish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3064,20 +3088,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "versions.js"
+        "face",
+        "publish.js"
       ]
     },
-    "team:add": {
+    "face:share": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "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.",
+      "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.",
@@ -3110,18 +3140,54 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to add (repeatable)",
-          "name": "face",
-          "required": true,
+        "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:add",
+      "id": "face:share",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3131,14 +3197,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "add.js"
+        "face",
+        "share.js"
       ]
     },
-    "team:create": {
+    "face:sources": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new team",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --type thread",
+        "<%= config.bin %> <%= command.id %> alice --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3171,46 +3248,21 @@
           "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",
+        "type": {
+          "description": "Show only one kind of source",
+          "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
+          "options": [
+            "doc",
+            "thread"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:create",
+      "id": "face:sources",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3220,20 +3272,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "create.js"
+        "face",
+        "sources.js"
       ]
     },
-    "team:delete": {
+    "face:stats": {
       "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Delete a team",
+      "args": {},
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3265,17 +3311,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:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3285,20 +3325,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "delete.js"
+        "face",
+        "stats.js"
       ]
     },
-    "team:edit": {
+    "face:teams": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Edit a team",
+      "description": "Set a face's team memberships (replaces all)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3331,38 +3371,18 @@
           "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol": {
-          "description": "New protocol content",
-          "name": "protocol",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol-file": {
-          "description": "Read protocol from file",
-          "name": "protocol-file",
+        "team": {
+          "description": "Team ID (repeatable, replaces all memberships)",
+          "name": "team",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:edit",
+      "id": "face:teams",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3372,20 +3392,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "edit.js"
+        "face",
+        "teams.js"
       ]
     },
-    "team:get": {
+    "face:unlock": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Get a team by ID",
+      "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.",
@@ -3421,7 +3444,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:get",
+      "id": "face:unlock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3431,14 +3454,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "get.js"
+        "face",
+        "unlock.js"
       ]
     },
-    "team:list": {
+    "face:unpublish": {
       "aliases": [],
-      "args": {},
-      "description": "List your teams",
+      "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.",
@@ -3474,7 +3503,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:list",
+      "id": "face:unpublish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3484,20 +3513,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "list.js"
+        "face",
+        "unpublish.js"
       ]
     },
-    "team:members": {
+    "face:unshare": {
       "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": "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.",
@@ -3529,11 +3562,36 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "from": {
+          "description": "Account to revoke (repeatable)",
+          "exclusive": [
+            "all"
+          ],
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all": {
+          "description": "Revoke everyone",
+          "exclusive": [
+            "from"
+          ],
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:members",
+      "id": "face:unshare",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3543,25 +3601,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "members.js"
+        "face",
+        "unshare.js"
       ]
     },
-    "team:remove": {
+    "keys:create": {
       "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": "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.",
@@ -3593,11 +3640,53 @@
           "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": "team:remove",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3607,14 +3696,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "remove.js"
+        "keys",
+        "create.js"
       ]
     },
-    "face:attributes": {
+    "keys:list": {
       "aliases": [],
       "args": {},
-      "description": "List all supported attribute keys",
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3650,7 +3739,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:attributes",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3660,14 +3749,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "attributes.js"
+        "keys",
+        "list.js"
       ]
     },
-    "face:create": {
+    "keys:revoke": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new face",
+      "args": {
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
+          "required": true
+        }
+      },
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3700,85 +3795,16 @@
           "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",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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"
-        },
-        "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",
-          "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"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:create",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3788,20 +3814,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "create.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "face:delete": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Delete a face permanently",
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3834,16 +3860,30 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "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": "face:delete",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3853,14 +3893,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "delete.js"
+        "keys",
+        "update.js"
       ]
     },
-    "face:diff": {
+    "style:delete": {
       "aliases": [],
-      "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
+      "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"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3893,18 +3943,16 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "style:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3914,20 +3962,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "diff.js"
+        "style",
+        "delete.js"
       ]
     },
-    "face:edit": {
+    "style:make": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Edit a face's metadata",
+      "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.",
@@ -3952,94 +4006,78 @@
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "New display name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Replace all tags (repeatable, lowercase)",
-          "name": "tag",
+        "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"
         },
-        "default-model": {
-          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "default-model",
+        "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"
         },
-        "formula": {
-          "description": "New boolean formula (synthetic faces only)",
-          "name": "formula",
+        "model": {
+          "description": "Analyst model (default: gpt-5.6-terra)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attr": {
-          "description": "Update attribute KEY=VALUE (repeatable)",
-          "name": "attr",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "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"
         },
-        "tool": {
-          "description": "Tool names to set (replaces list, repeatable)",
-          "name": "tool",
-          "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"
         },
-        "profile-addendum": {
-          "description": "Replace the per-face system prompt (max 100,000 chars).",
-          "name": "profile-addendum",
+        "best-of": {
+          "description": "Generate N candidates and keep the best (1-5, default 1)",
+          "name": "best-of",
           "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",
+        "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,
           "type": "option"
-        },
-        "clear-profile-addendum": {
-          "description": "Remove the per-face system prompt.",
-          "exclusive": [
-            "profile-addendum",
-            "profile-addendum-file"
-          ],
-          "name": "clear-profile-addendum",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:edit",
+      "id": "style:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4049,20 +4087,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "edit.js"
+        "style",
+        "make.js"
       ]
     },
-    "face:get": {
+    "style:revert": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Get details for a face, by alias or owner:alias. A published or shared face is reachable under the same owner:alias address chat uses; it is shown with a note that you do not own it.",
+      "description": "Go back to the style a face had before the last style:make. Two versions are kept per medium, so this is a toggle: running it again returns to where you started. A face holds one style per medium, so name which one with --medium when it has more than one. It changes how the face writes immediately, so it asks first.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --yes",
+        "<%= config.bin %> <%= command.id %> alice --medium email --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4095,23 +4137,23 @@
           "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
+        "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"
         },
-        "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": "style:revert",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4121,14 +4163,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "get.js"
+        "style",
+        "revert.js"
       ]
     },
-    "face:list": {
+    "style:status": {
       "aliases": [],
-      "args": {},
-      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
+      "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"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4161,63 +4214,39 @@
           "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",
+        "face": {
+          "description": "List recent builds for this face instead of reading one job",
+          "name": "face",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
+        "limit": {
+          "description": "How many builds to list with --face (default: 10)",
+          "name": "limit",
+          "default": 10,
           "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",
+        "wait": {
+          "description": "Block until the job finishes",
+          "name": "wait",
           "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",
+        "timeout": {
+          "description": "How long to wait with --wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "style:status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4227,22 +4256,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "list.js"
+        "style",
+        "status.js"
       ]
     },
-    "face:lock": {
+    "style:upload": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
+          "required": true
+        },
+        "file": {
+          "description": "Corpus file",
+          "name": "file",
           "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": "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 %> socrates"
+        "<%= 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": {
@@ -4275,11 +4311,37 @@
           "hasDynamicHelp": false,
           "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",
+          "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,
+          "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:lock",
+      "id": "style:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4289,20 +4351,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "lock.js"
+        "style",
+        "upload.js"
       ]
     },
-    "face:neighbors": {
+    "style:versions": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "description": "List 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.",
@@ -4334,39 +4400,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "component": {
-          "description": "What to rank on: `face` for overall similarity, or a component position such as 1. Which positions are comparable varies; the API names them if you pick a wrong one.",
-          "name": "component",
-          "default": "face",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "direction": {
-          "description": "nearest (most similar) or furthest (most dissimilar)",
-          "name": "direction",
-          "default": "nearest",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "nearest",
-            "furthest"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:neighbors",
+      "id": "style:versions",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4376,22 +4414,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "neighbors.js"
+        "style",
+        "versions.js"
       ]
     },
-    "face:publish": {
+    "team:add": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "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": "Add face(s) to a team. Any face this account can reach may join: your own, a published one, or one shared with you. Name someone else's as owner:alias, the same address chat uses.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice --yes"
+        "<%= config.bin %> <%= command.id %> TEAM_ID --face alice --face bob",
+        "<%= config.bin %> <%= command.id %> TEAM_ID --face head:socrates"
       ],
       "flags": {
         "json": {
@@ -4425,16 +4464,18 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "face": {
+          "description": "Face alias to add (repeatable)",
+          "name": "face",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:publish",
+      "id": "team:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4444,26 +4485,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "publish.js"
+        "team",
+        "add.js"
       ]
     },
-    "face:share": {
+    "team:create": {
       "aliases": [],
-      "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"
-      ],
+      "args": {},
+      "description": "Create a new team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4496,54 +4525,46 @@
           "multiple": false,
           "type": "option"
         },
-        "list": {
-          "description": "Show who the face is shared with, and change nothing",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
+        "name": {
+          "description": "Team name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "add": {
-          "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
-          "exclusive": [
-            "with",
-            "none"
-          ],
-          "name": "add",
+        "description": {
+          "description": "Plain-text team description (max 1500 chars)",
+          "name": "description",
           "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",
+        "protocol": {
+          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
+          "name": "protocol",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "none": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "add",
-            "with"
-          ],
-          "name": "none",
-          "allowNo": false,
-          "type": "boolean"
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "yes": {
-          "description": "Skip the confirmation shown when someone would lose access",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:share",
+      "id": "team:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4553,25 +4574,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "share.js"
+        "team",
+        "create.js"
       ]
     },
-    "face:sources": {
+    "team:delete": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --type thread",
-        "<%= config.bin %> <%= command.id %> alice --json"
-      ],
+      "description": "Delete a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4604,21 +4620,16 @@
           "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "Show only one kind of source",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "doc",
-            "thread"
-          ],
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:sources",
+      "id": "team:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4628,14 +4639,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "sources.js"
+        "team",
+        "delete.js"
       ]
     },
-    "face:stats": {
+    "team:edit": {
       "aliases": [],
-      "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "args": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        }
+      },
+      "description": "Edit a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4667,11 +4684,39 @@
           "hasDynamicHelp": false,
           "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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:stats",
+      "id": "team:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4681,20 +4726,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "stats.js"
+        "team",
+        "edit.js"
       ]
     },
-    "face:teams": {
+    "team:get": {
       "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": "Get a team by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4719,26 +4764,18 @@
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "team": {
-          "description": "Team ID (repeatable, replaces all memberships)",
-          "name": "team",
-          "required": true,
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:teams",
+      "id": "team:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4748,23 +4785,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "teams.js"
+        "team",
+        "get.js"
       ]
     },
-    "face:unlock": {
+    "team:list": {
       "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": "List your teams",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4800,7 +4828,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unlock",
+      "id": "team:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4810,20 +4838,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unlock.js"
+        "team",
+        "list.js"
       ]
     },
-    "face:unpublish": {
+    "team:members": {
       "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": "List members of a team. A member you do not own can stop being reachable if its owner revokes access or deletes it; those are listed with the reason rather than dropped.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> TEAM_ID",
+        "<%= config.bin %> <%= command.id %> TEAM_ID --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4859,7 +4891,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unpublish",
+      "id": "team:members",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4869,24 +4901,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unpublish.js"
+        "team",
+        "members.js"
       ]
     },
-    "face:unshare": {
+    "team:remove": {
       "aliases": [],
       "args": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        },
         "alias": {
-          "description": "Face alias",
+          "description": "Face alias to remove",
           "name": "alias",
           "required": true
         }
       },
-      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --from dana --yes",
-        "<%= config.bin %> <%= command.id %> alice --all --yes"
-      ],
+      "description": "Remove a face from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4918,36 +4951,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "from": {
-          "description": "Account to revoke (repeatable)",
-          "exclusive": [
-            "all"
-          ],
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "all": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "from"
-          ],
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unshare",
+      "id": "team:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4957,8 +4965,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unshare.js"
+        "team",
+        "remove.js"
       ]
     },
     "billing:subscription:activate": {
@@ -6542,16 +6550,16 @@
         "sync.js"
       ]
     },
-    "team:tag:add": {
+    "face:tag:add": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Add tags to a team (appends, idempotent)",
+      "description": "Add tags to a face (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6595,7 +6603,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:add",
+      "id": "face:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6605,21 +6613,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
         "add.js"
       ]
     },
-    "team:tag:list": {
+    "face:tag:all": {
       "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "List tags on a team",
+      "args": {},
+      "description": "List all tags across all your faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6655,7 +6657,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:list",
+      "id": "face:tag:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6665,26 +6667,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
-        "list.js"
+        "all.js"
       ]
     },
-    "team:tag:remove": {
+    "face:tag:list": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        },
-        "tag": {
-          "description": "Tag to remove",
-          "name": "tag",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Remove a tag from a team",
+      "description": "List tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6720,7 +6717,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:remove",
+      "id": "face:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6730,21 +6727,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
-        "remove.js"
+        "list.js"
       ]
     },
-    "team:tag:set": {
+    "face:tag:remove": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        },
+        "tag": {
+          "description": "Tag to remove",
+          "name": "tag",
           "required": true
         }
       },
-      "description": "Replace all tags on a team",
+      "description": "Remove a tag from a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6776,19 +6778,11 @@
           "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": "team:tag:set",
+      "id": "face:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6798,12 +6792,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
-        "set.js"
+        "remove.js"
       ]
     },
-    "face:tag:add": {
+    "face:tag:set": {
       "aliases": [],
       "args": {
         "alias": {
@@ -6812,7 +6806,7 @@
           "required": true
         }
       },
-      "description": "Add tags to a face (appends, idempotent)",
+      "description": "Replace all tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6846,7 +6840,7 @@
           "type": "option"
         },
         "tag": {
-          "description": "Tag to add (repeatable)",
+          "description": "Tag to set (repeatable, replaces all)",
           "name": "tag",
           "required": true,
           "hasDynamicHelp": false,
@@ -6856,7 +6850,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:add",
+      "id": "face:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6868,13 +6862,19 @@
         "commands",
         "face",
         "tag",
-        "add.js"
+        "set.js"
       ]
     },
-    "face:tag:all": {
+    "team:tag:add": {
       "aliases": [],
-      "args": {},
-      "description": "List all tags across all your faces",
+      "args": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        }
+      },
+      "description": "Add tags to a team (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6906,11 +6906,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Tag to add (repeatable)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:all",
+      "id": "team:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6920,21 +6928,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
-        "all.js"
+        "add.js"
       ]
     },
-    "face:tag:list": {
+    "team:tag:list": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "List tags on a face",
+      "description": "List tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6970,7 +6978,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:list",
+      "id": "team:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6980,17 +6988,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
         "list.js"
       ]
     },
-    "face:tag:remove": {
+    "team:tag:remove": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         },
         "tag": {
@@ -6999,7 +7007,7 @@
           "required": true
         }
       },
-      "description": "Remove a tag from a face",
+      "description": "Remove a tag from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -7035,7 +7043,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:remove",
+      "id": "team:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -7045,21 +7053,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
         "remove.js"
       ]
     },
-    "face:tag:set": {
+    "team:tag:set": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Replace all tags on a face",
+      "description": "Replace all tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -7103,7 +7111,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:set",
+      "id": "team:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -7113,11 +7121,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
         "set.js"
       ]
     }
   },
-  "version": "1.8.2"
+  "version": "1.8.4"
 }