faces-cli 1.8.5 → 1.8.7

package/oclif.manifest.json

@@ -120,23 +120,10 @@
         "state.js"
       ]
     },
-    "auth:connect": {
+    "catalog:backup": {
       "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": "Snapshot all faces, teams, and source material for migration",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -172,7 +159,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connect",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -182,18 +169,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connect.js"
+        "catalog",
+        "backup.js"
       ]
     },
-    "auth:connections": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "List connected OAuth provider accounts",
-      "examples": [
-        "<%= config.bin %> auth connections",
-        "<%= config.bin %> auth connections --json"
-      ],
+      "description": "Diagnose and repair the local face and team catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -225,11 +208,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connections",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -239,26 +234,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connections.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "auth:disconnect": {
+    "catalog:list": {
       "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": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -294,7 +277,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:disconnect",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -304,14 +287,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "disconnect.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "auth:login": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Login and save JWT credentials",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -344,26 +327,37 @@
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Account email",
-          "name": "email",
-          "required": true,
+        "skill": {
+          "description": "Show details for a specific skill",
+          "name": "skill",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "password": {
-          "description": "Account password",
-          "name": "password",
-          "required": true,
+        "install": {
+          "description": "Install a skill by name",
+          "name": "install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skills-dir": {
+          "description": "Directory to install skills into (required for --install)",
+          "name": "skills-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh": {
+          "description": "Force refresh the skill index (ignore cache)",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -373,14 +367,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "auth:logout": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Clear saved credentials",
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces, teams, and source material from a backup snapshot",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -412,11 +411,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -426,14 +431,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "catalog",
+        "restore.js"
       ]
     },
-    "auth:refresh": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "Exchange current JWT for a fresh one",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -469,7 +474,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:refresh",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -479,14 +484,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "refresh.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "auth:register": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Faces account",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -518,54 +523,11 @@
           "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:register",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -575,14 +537,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "register.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "auth:whoami": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "Print current user profile and auth diagnostic",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -614,11 +576,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:whoami",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -628,14 +597,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "whoami.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "billing:balance": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -667,11 +636,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -682,13 +666,13 @@
         "dist",
         "commands",
         "billing",
-        "balance.js"
+        "topup.js"
       ]
     },
-    "billing:card-setup": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -720,63 +704,30 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "billing:card-setup",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "billing",
-        "card-setup.js"
-      ]
-    },
-    "billing:llm-costs": {
-      "aliases": [],
-      "args": {},
-      "description": "List available LLMs and their per-token costs",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -784,7 +735,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -795,13 +746,26 @@
         "dist",
         "commands",
         "billing",
-        "llm-costs.js"
+        "usage.js"
       ]
     },
-    "billing:topup": {
+    "auth:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "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.",
@@ -833,26 +797,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "auth:connect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -862,14 +811,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "auth",
+        "connect.js"
       ]
     },
-    "billing:usage": {
+    "auth:connections": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "List connected OAuth provider accounts",
+      "examples": [
+        "<%= config.bin %> auth connections",
+        "<%= config.bin %> auth connections --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -901,38 +854,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:connections",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -942,14 +868,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "auth",
+        "connections.js"
       ]
     },
-    "catalog:backup": {
+    "auth:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "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.",
@@ -985,7 +923,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:backup",
+      "id": "auth:disconnect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -995,14 +933,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "auth",
+        "disconnect.js"
       ]
     },
-    "catalog:doctor": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Login and save JWT credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1035,22 +973,26 @@
           "multiple": false,
           "type": "option"
         },
-        "fix": {
-          "description": "Rebuild missing or stale catalog entries from API",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
+        "email": {
+          "description": "Account email",
+          "name": "email",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "generate": {
-          "description": "Fix + generate missing descriptions via LLM",
-          "name": "generate",
-          "allowNo": false,
-          "type": "boolean"
+        "password": {
+          "description": "Account password",
+          "name": "password",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:doctor",
+      "id": "auth:login",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1060,14 +1002,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "auth",
+        "login.js"
       ]
     },
-    "catalog:list": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "Clear saved credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1103,7 +1045,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "auth:logout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1113,14 +1055,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "catalog:manyfaced": {
+    "auth:refresh": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Exchange current JWT for a fresh one",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1152,38 +1094,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "skill": {
-          "description": "Show details for a specific skill",
-          "name": "skill",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "install": {
-          "description": "Install a skill by name",
-          "name": "install",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "refresh": {
-          "description": "Force refresh the skill index (ignore cache)",
-          "name": "refresh",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:manyfaced",
+      "id": "auth:refresh",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1193,19 +1108,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "auth",
+        "refresh.js"
       ]
     },
-    "catalog:restore": {
+    "auth:register": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
-          "name": "file"
-        }
-      },
-      "description": "Restore faces, teams, and source material from a backup snapshot",
+      "args": {},
+      "description": "Create a new Faces account",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1238,16 +1148,53 @@
           "multiple": false,
           "type": "option"
         },
-        "compile": {
-          "description": "Run compile:all after restoring",
-          "name": "compile",
-          "allowNo": false,
-          "type": "boolean"
-        }
+        "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": "catalog:restore",
+      "id": "auth:register",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1257,8 +1204,61 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "auth",
+        "register.js"
+      ]
+    },
+    "auth:whoami": {
+      "aliases": [],
+      "args": {},
+      "description": "Print current user profile and auth diagnostic",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:whoami",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "whoami.js"
       ]
     },
     "chat:chat": {
@@ -1372,7 +1372,7 @@
           "type": "boolean"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1474,7 +1474,7 @@
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1568,7 +1568,7 @@
           "type": "boolean"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "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,
@@ -1601,12 +1601,12 @@
       "aliases": [],
       "args": {
         "face_username": {
-          "description": "Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread",
+          "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.",
+      "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\"",
@@ -1703,7 +1703,7 @@
           "type": "boolean"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "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,
@@ -2043,7 +2043,7 @@
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "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,
@@ -2255,10 +2255,10 @@
         "show.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,67 +2558,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "face",
+        "diff.js"
       ]
     },
-    "face:attributes": {
+    "face:edit": {
       "aliases": [],
-      "args": {},
-      "description": "List all supported attribute keys",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
         }
       },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "face:attributes",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "attributes.js"
-      ]
-    },
-    "face:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a new face",
+      "description": "Edit a face's metadata",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2637,17 +2605,8 @@
           "type": "option"
         },
         "name": {
-          "description": "Display name",
+          "description": "New 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"
@@ -2660,7 +2619,7 @@
           "type": "option"
         },
         "tag": {
-          "description": "Tag label (repeatable, lowercase)",
+          "description": "Replace all tags (repeatable, lowercase)",
           "name": "tag",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -2674,35 +2633,35 @@
           "type": "option"
         },
         "formula": {
-          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
+          "description": "New boolean formula (synthetic faces only)",
           "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "attr": {
-          "description": "Attribute KEY=VALUE (repeatable)",
+          "description": "Update attribute KEY=VALUE (repeatable)",
           "name": "attr",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "tool": {
-          "description": "Tool name to enable (repeatable)",
+          "description": "Tool names to set (replaces list, 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).",
+          "description": "Replace the per-face 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).",
+          "description": "Replace the per-face system prompt from a file.",
           "exclusive": [
             "profile-addendum"
           ],
@@ -2710,11 +2669,21 @@
           "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:create",
+      "id": "face:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2725,10 +2694,10 @@
         "dist",
         "commands",
         "face",
-        "create.js"
+        "edit.js"
       ]
     },
-    "face:delete": {
+    "face:get": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2737,7 +2706,7 @@
           "required": true
         }
       },
-      "description": "Delete a face permanently",
+      "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.",
@@ -2770,16 +2739,23 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "full": {
+          "description": "Print the full profile_addendum instead of a truncated preview",
+          "name": "full",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:delete",
+      "id": "face:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2790,13 +2766,13 @@
         "dist",
         "commands",
         "face",
-        "delete.js"
+        "get.js"
       ]
     },
-    "face:diff": {
+    "face:list": {
       "aliases": [],
       "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
+      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2829,10 +2805,61 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
+        "tag": {
+          "description": "Filter by tag (repeatable, AND logic)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "team": {
+          "description": "Filter by team ID (repeatable, OR logic)",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "public": {
+          "description": "Include published faces from other accounts (open to everybody)",
+          "name": "public",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "has-style": {
+          "description": "Show only faces with a captured style (the ones that write in their own voice)",
+          "name": "has-style",
+          "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"
@@ -2840,7 +2867,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "face:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2851,10 +2878,10 @@
         "dist",
         "commands",
         "face",
-        "diff.js"
+        "list.js"
       ]
     },
-    "face:edit": {
+    "face:lock": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2863,7 +2890,10 @@
           "required": true
         }
       },
-      "description": "Edit a face's metadata",
+      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it, and everything it owns (documents, threads, voiceprint), cannot be changed until unlocked.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2895,87 +2925,98 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:lock",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "lock.js"
+      ]
+    },
+    "face:neighbors": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "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",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attr": {
-          "description": "Update attribute KEY=VALUE (repeatable)",
-          "name": "attr",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "description": "Tool names to set (replaces list, repeatable)",
-          "name": "tool",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "profile-addendum": {
-          "description": "Replace the per-face system prompt (max 100,000 chars).",
-          "name": "profile-addendum",
+        "k": {
+          "description": "Number of results (1-20)",
+          "name": "k",
+          "default": 5,
           "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",
+        "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"
         },
-        "clear-profile-addendum": {
-          "description": "Remove the per-face system prompt.",
-          "exclusive": [
-            "profile-addendum",
-            "profile-addendum-file"
+        "direction": {
+          "description": "nearest (most similar) or furthest (most dissimilar)",
+          "name": "direction",
+          "default": "nearest",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "nearest",
+            "furthest"
           ],
-          "name": "clear-profile-addendum",
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:edit",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2986,19 +3027,22 @@
         "dist",
         "commands",
         "face",
-        "edit.js"
+        "neighbors.js"
       ]
     },
-    "face:get": {
+    "face:publish": {
       "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": "Publish a face so EVERY account can chat with it. This is a global override: while it is on, everyone can reach the face regardless of who it is shared with. You still pay only to compile it; whoever chats pays for their own inference.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3031,23 +3075,16 @@
           "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "full": {
-          "description": "Print the full profile_addendum instead of a truncated preview",
-          "name": "full",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "face:publish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3058,13 +3095,25 @@
         "dist",
         "commands",
         "face",
-        "get.js"
+        "publish.js"
       ]
     },
-    "face:list": {
+    "face:share": {
       "aliases": [],
-      "args": {},
-      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "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.",
@@ -3097,63 +3146,54 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Filter by tag (repeatable, AND logic)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "list": {
+          "description": "Show who the face is shared with, and change nothing",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "team": {
-          "description": "Filter by team ID (repeatable, OR logic)",
-          "name": "team",
+        "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"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
+        "with": {
+          "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
+          "exclusive": [
+            "add",
+            "none"
+          ],
+          "name": "with",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "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",
+        "none": {
+          "description": "Revoke everyone",
+          "exclusive": [
+            "add",
+            "with"
+          ],
+          "name": "none",
           "allowNo": false,
           "type": "boolean"
         },
-        "system": {
-          "description": "Show only the curated system faces (published faces owned by 'head')",
-          "name": "system",
+        "yes": {
+          "description": "Skip the confirmation shown when someone would lose access",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "from-users": {
-          "description": "Only published faces from these owners (repeatable/comma-separated)",
-          "name": "from-users",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "not-from-users": {
-          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
-          "name": "not-from-users",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "face:share",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3164,21 +3204,23 @@
         "dist",
         "commands",
         "face",
-        "list.js"
+        "share.js"
       ]
     },
-    "face:lock": {
+    "face:sources": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.",
+      "description": "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 %> socrates"
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --type thread",
+        "<%= config.bin %> <%= command.id %> alice --json"
       ],
       "flags": {
         "json": {
@@ -3211,11 +3253,22 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "type": {
+          "description": "Show only one kind of source",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "doc",
+            "thread"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:lock",
+      "id": "face:sources",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3226,19 +3279,13 @@
         "dist",
         "commands",
         "face",
-        "lock.js"
+        "sources.js"
       ]
     },
-    "face:neighbors": {
+    "face:stats": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "args": {},
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3270,39 +3317,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": "face:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3313,10 +3332,10 @@
         "dist",
         "commands",
         "face",
-        "neighbors.js"
+        "stats.js"
       ]
     },
-    "face:publish": {
+    "face:teams": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3325,10 +3344,7 @@
           "required": true
         }
       },
-      "description": "Publish a face so EVERY account can chat with it. This is a global override: while it is on, everyone can reach the face regardless of who it is shared with. You still pay only to compile it; whoever chats pays for their own inference.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --yes"
-      ],
+      "description": "Set a face's team memberships (replaces all)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3361,16 +3377,18 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "team": {
+          "description": "Team ID (repeatable, replaces all memberships)",
+          "name": "team",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:publish",
+      "id": "face:teams",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3381,24 +3399,21 @@
         "dist",
         "commands",
         "face",
-        "publish.js"
+        "teams.js"
       ]
     },
-    "face:share": {
+    "face:unlock": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Share a face so named accounts can chat with it. Sharing grants chat and nothing else: no reading its documents, no compiling, no re-sharing, and never its profile addendum. --add keeps the current list; --with replaces it.",
+      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice --list",
-        "<%= config.bin %> <%= command.id %> alice --add dana",
-        "<%= config.bin %> <%= command.id %> alice --with dana --with sam@example.com",
-        "<%= config.bin %> <%= command.id %> alice --none --yes"
+        "<%= config.bin %> <%= command.id %> socrates"
       ],
       "flags": {
         "json": {
@@ -3431,55 +3446,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "list": {
-          "description": "Show who the face is shared with, and change nothing",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "add": {
-          "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
-          "exclusive": [
-            "with",
-            "none"
-          ],
-          "name": "add",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "with": {
-          "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
-          "exclusive": [
-            "add",
-            "none"
-          ],
-          "name": "with",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "none": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "add",
-            "with"
-          ],
-          "name": "none",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "description": "Skip the confirmation shown when someone would lose access",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:share",
+      "id": "face:unlock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3490,10 +3461,10 @@
         "dist",
         "commands",
         "face",
-        "share.js"
+        "unlock.js"
       ]
     },
-    "face:sources": {
+    "face:unpublish": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3502,12 +3473,7 @@
           "required": true
         }
       },
-      "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --type thread",
-        "<%= config.bin %> <%= command.id %> alice --json"
-      ],
+      "description": "Stop publishing a face. Anyone it is individually shared with keeps their access. Publishing is an override on top of sharing, not a replacement for it.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3539,22 +3505,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "type": {
-          "description": "Show only one kind of source",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "doc",
-            "thread"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:sources",
+      "id": "face:unpublish",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3565,13 +3520,23 @@
         "dist",
         "commands",
         "face",
-        "sources.js"
+        "unpublish.js"
       ]
     },
-    "face:stats": {
+    "face:unshare": {
       "aliases": [],
-      "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Revoke access to a shared face. Takes effect immediately. There is no grace period.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --from dana --yes",
+        "<%= config.bin %> <%= command.id %> alice --all --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3603,11 +3568,36 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "from": {
+          "description": "Account to revoke (repeatable)",
+          "exclusive": [
+            "all"
+          ],
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all": {
+          "description": "Revoke everyone",
+          "exclusive": [
+            "from"
+          ],
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:stats",
+      "id": "face:unshare",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3618,10 +3608,10 @@
         "dist",
         "commands",
         "face",
-        "stats.js"
+        "unshare.js"
       ]
     },
-    "face:teams": {
+    "style:delete": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3630,7 +3620,11 @@
           "required": true
         }
       },
-      "description": "Set a face's team memberships (replaces all)",
+      "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.",
@@ -3663,18 +3657,16 @@
           "multiple": false,
           "type": "option"
         },
-        "team": {
-          "description": "Team ID (repeatable, replaces all memberships)",
-          "name": "team",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:teams",
+      "id": "style:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3684,22 +3676,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "teams.js"
+        "style",
+        "delete.js"
       ]
     },
-    "face:unlock": {
+    "style:make": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
+      "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 %> socrates"
+        "<%= 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": {
@@ -3732,62 +3727,63 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "face:unlock",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "unlock.js"
-      ]
-    },
-    "face:unpublish": {
-      "aliases": [],
-      "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.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        },
+        "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"
         },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
+        "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"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "model": {
+          "description": "Analyst model (default: gpt-5.6-terra)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "allow-paid": {
+          "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
+          "name": "allow-paid",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "compile": {
+          "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
+          "name": "compile",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "best-of": {
+          "description": "Generate N candidates and keep the best (1-5, default 1)",
+          "name": "best-of",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Start the build and return the job id without polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "How long to wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3795,7 +3791,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unpublish",
+      "id": "style:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3805,11 +3801,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unpublish.js"
+        "style",
+        "make.js"
       ]
     },
-    "face:unshare": {
+    "style:revert": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3818,10 +3814,10 @@
           "required": true
         }
       },
-      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
+      "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 --from dana --yes",
-        "<%= config.bin %> <%= command.id %> alice --all --yes"
+        "<%= config.bin %> <%= command.id %> alice --yes",
+        "<%= config.bin %> <%= command.id %> alice --medium email --yes"
       ],
       "flags": {
         "json": {
@@ -3855,25 +3851,13 @@
           "multiple": false,
           "type": "option"
         },
-        "from": {
-          "description": "Account to revoke (repeatable)",
-          "exclusive": [
-            "all"
-          ],
-          "name": "from",
+        "medium": {
+          "description": "Which style to step back, when the face has more than one. See faces style:versions <alias>.",
+          "name": "medium",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "from"
-          ],
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "yes": {
           "description": "Skip confirmation",
           "name": "yes",
@@ -3883,7 +3867,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unshare",
+      "id": "style:revert",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3893,23 +3877,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unshare.js"
+        "style",
+        "revert.js"
       ]
     },
-    "style:delete": {
+    "style:status": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
+        "job_id": {
+          "description": "Build job id",
+          "name": "job_id",
+          "required": false
         }
       },
-      "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.",
+      "description": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --yes"
+        "<%= config.bin %> <%= command.id %> 7a8b9c0d",
+        "<%= config.bin %> <%= command.id %> --face alice",
+        "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
       ],
       "flags": {
         "json": {
@@ -3943,16 +3928,39 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "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:delete",
+      "id": "style:status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3963,24 +3971,28 @@
         "dist",
         "commands",
         "style",
-        "delete.js"
+        "status.js"
       ]
     },
-    "style:make": {
+    "style:upload": {
       "aliases": [],
       "args": {
         "alias": {
           "description": "Face alias",
           "name": "alias",
           "required": true
+        },
+        "file": {
+          "description": "Corpus file",
+          "name": "file",
+          "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.",
+      "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 --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"
+        "<%= 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": {
@@ -4014,62 +4026,91 @@
           "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",
+        "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"
         },
-        "model": {
-          "description": "Analyst model (default: gpt-5.6-terra)",
-          "name": "model",
+        "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"
         },
-        "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",
+        "strict": {
+          "description": "Reject the whole upload if any message is invalid. By default invalid messages are skipped and reported, because a corpus is statistical and a few bad lines are not worth losing the rest.",
+          "name": "strict",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "style:upload",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "style",
+        "upload.js"
+      ]
+    },
+    "style:versions": {
+      "aliases": [],
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "List the styles captured for a face, and which one it 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.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "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",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "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"
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "timeout": {
-          "description": "How long to wait, in seconds (default: 3600)",
-          "name": "timeout",
-          "default": 3600,
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4077,7 +4118,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:make",
+      "id": "style:versions",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4088,22 +4129,22 @@
         "dist",
         "commands",
         "style",
-        "make.js"
+        "versions.js"
       ]
     },
-    "style:revert": {
+    "team:add": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "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.",
+      "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 %> alice --medium email --yes"
+        "<%= config.bin %> <%= command.id %> TEAM_ID --face alice --face bob",
+        "<%= config.bin %> <%= command.id %> TEAM_ID --face head:socrates"
       ],
       "flags": {
         "json": {
@@ -4137,23 +4178,18 @@
           "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",
+        "face": {
+          "description": "Face alias to add (repeatable)",
+          "name": "face",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:revert",
+      "id": "team:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4163,25 +4199,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "revert.js"
+        "team",
+        "add.js"
       ]
     },
-    "style:status": {
+    "team:create": {
       "aliases": [],
-      "args": {
-        "job_id": {
-          "description": "Build job id",
-          "name": "job_id",
-          "required": false
-        }
-      },
-      "description": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 7a8b9c0d",
-        "<%= config.bin %> <%= command.id %> --face alice",
-        "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
-      ],
+      "args": {},
+      "description": "Create a new team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4214,39 +4239,46 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "List recent builds for this face instead of reading one job",
-          "name": "face",
+        "name": {
+          "description": "Team name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "How many builds to list with --face (default: 10)",
-          "name": "limit",
-          "default": 10,
+        "description": {
+          "description": "Plain-text team description (max 1500 chars)",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "description": "Block until the job finishes",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
+        "protocol": {
+          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
+          "name": "protocol",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "timeout": {
-          "description": "How long to wait with --wait, in seconds (default: 3600)",
-          "name": "timeout",
-          "default": 3600,
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:status",
+      "id": "team:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4256,30 +4288,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "status.js"
+        "team",
+        "create.js"
       ]
     },
-    "style:upload": {
+    "team:delete": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        },
-        "file": {
-          "description": "Corpus file",
-          "name": "file",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_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": "Delete a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4312,36 +4334,16 @@
           "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",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "style:upload",
+      "id": "team:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4351,24 +4353,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "upload.js"
+        "team",
+        "delete.js"
       ]
     },
-    "style:versions": {
+    "team:edit": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "List the styles captured for a face, and which one it writes in now. A face holds one style per medium, so more than one can be in use at once: an email style and an essay style are separate and do not replace each other. Two versions are kept per medium, which is what style:revert has to go back to.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --json"
-      ],
+      "description": "Edit a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4400,11 +4398,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": "style:versions",
+      "id": "team:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4414,11 +4440,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "style",
-        "versions.js"
+        "team",
+        "edit.js"
       ]
     },
-    "team:add": {
+    "team:get": {
       "aliases": [],
       "args": {
         "team_id": {
@@ -4427,11 +4453,7 @@
           "required": true
         }
       },
-      "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 %> TEAM_ID --face alice --face bob",
-        "<%= config.bin %> <%= command.id %> TEAM_ID --face head:socrates"
-      ],
+      "description": "Get a team by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4463,19 +4485,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "face": {
-          "description": "Face alias to add (repeatable)",
-          "name": "face",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:add",
+      "id": "team:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4486,13 +4500,13 @@
         "dist",
         "commands",
         "team",
-        "add.js"
+        "get.js"
       ]
     },
-    "team:create": {
+    "team:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new team",
+      "description": "List your teams",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4524,47 +4538,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "Team name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Plain-text team description (max 1500 chars)",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol": {
-          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
-          "name": "protocol",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol-file": {
-          "description": "Read protocol from file",
-          "name": "protocol-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:create",
+      "id": "team:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4575,10 +4553,10 @@
         "dist",
         "commands",
         "team",
-        "create.js"
+        "list.js"
       ]
     },
-    "team:delete": {
+    "team:members": {
       "aliases": [],
       "args": {
         "team_id": {
@@ -4587,7 +4565,11 @@
           "required": true
         }
       },
-      "description": "Delete a team",
+      "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.",
@@ -4619,17 +4601,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:delete",
+      "id": "team:members",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4640,19 +4616,24 @@
         "dist",
         "commands",
         "team",
-        "delete.js"
+        "members.js"
       ]
     },
-    "team:edit": {
+    "team:remove": {
       "aliases": [],
       "args": {
         "team_id": {
           "description": "Team ID",
           "name": "team_id",
           "required": true
+        },
+        "alias": {
+          "description": "Face alias to remove",
+          "name": "alias",
+          "required": true
         }
       },
-      "description": "Edit a team",
+      "description": "Remove a face from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4684,39 +4665,11 @@
           "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": "team:edit",
+      "id": "team:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4727,19 +4680,13 @@
         "dist",
         "commands",
         "team",
-        "edit.js"
+        "remove.js"
       ]
     },
-    "team:get": {
+    "keys:create": {
       "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Get a team by ID",
+      "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.",
@@ -4771,11 +4718,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:get",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4785,14 +4774,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "get.js"
+        "keys",
+        "create.js"
       ]
     },
-    "team:list": {
+    "keys:list": {
       "aliases": [],
       "args": {},
-      "description": "List your teams",
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4828,7 +4817,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:list",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4838,24 +4827,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "keys",
         "list.js"
       ]
     },
-    "team:members": {
+    "keys:revoke": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "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"
-      ],
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4887,11 +4872,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:members",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4901,25 +4892,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "members.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "team:remove": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        },
-        "alias": {
-          "description": "Face alias to remove",
-          "name": "alias",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Remove a face from a team",
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4951,11 +4937,31 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "New key name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:remove",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4965,8 +4971,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "remove.js"
+        "keys",
+        "update.js"
       ]
     },
     "billing:subscription:activate": {
@@ -5212,7 +5218,7 @@
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "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,
@@ -5372,7 +5378,7 @@
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (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.",
+          "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,
@@ -5531,14 +5537,14 @@
           "type": "option"
         },
         "file": {
-          "description": "Read content from file (repeatable — each file becomes its own document)",
+          "description": "Read content from file (repeatable; each file becomes its own document)",
           "name": "file",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "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,
@@ -6016,7 +6022,12 @@
           "required": true
         }
       },
-      "description": "Edit a thread (label and/or reassign face speaker)",
+      "description": "Edit a thread: its label, what medium it is read as, and/or which speaker is the face.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> THREAD_ID --label \"Interview\"",
+        "<%= config.bin %> <%= command.id %> THREAD_ID --medium lecture",
+        "<%= config.bin %> <%= command.id %> THREAD_ID --clear-medium"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6062,6 +6073,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "medium": {
+          "description": "What this thread should be read as. 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. This is a correction that sticks: it overrides what an imported corpus arrived as, without changing the record of what that was.",
+          "exclusive": [
+            "clear-medium"
+          ],
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "clear-medium": {
+          "description": "Remove a medium correction, so the thread is read as whatever it arrived as.",
+          "exclusive": [
+            "medium"
+          ],
+          "name": "clear-medium",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -7127,5 +7157,5 @@
       ]
     }
   },
-  "version": "1.8.5"
+  "version": "1.8.7"
 }