faces-cli 1.7.6 → 1.7.7

package/oclif.manifest.json

@@ -1113,112 +1113,6 @@
         "llm-costs.js"
       ]
     },
-    "billing:quota": {
-      "aliases": [],
-      "args": {},
-      "description": "Show compilation stats per face (deprecated — use compile:stats)",
-      "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": "billing:quota",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "billing",
-        "quota.js"
-      ]
-    },
-    "billing:subscription": {
-      "aliases": [],
-      "args": {},
-      "description": "Show current plan, face count, and renewal date",
-      "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": "billing:subscription",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "billing",
-        "subscription.js"
-      ]
-    },
     "billing:topup": {
       "aliases": [],
       "args": {},
@@ -2326,10 +2220,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.",
@@ -2361,53 +2255,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",
@@ -2417,14 +2269,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.",
@@ -2456,11 +2308,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",
@@ -2470,20 +2397,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.",
@@ -2525,7 +2452,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2535,879 +2462,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "face",
+        "delete.js"
       ]
     },
-    "keys:update": {
-      "aliases": [],
-      "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
-          "required": true
-        }
-      },
-      "description": "Update API key metadata (JWT required)",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "New key name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "keys:update",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "keys",
-        "update.js"
-      ]
-    },
-    "team:add": {
-      "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Add face(s) to a team",
-      "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"
-        },
-        "face": {
-          "description": "Face alias to add (repeatable)",
-          "name": "face",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "team:add",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "add.js"
-      ]
-    },
-    "team:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a new team",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "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",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "create.js"
-      ]
-    },
-    "team:delete": {
-      "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Delete a team",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "team:delete",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "delete.js"
-      ]
-    },
-    "team:edit": {
-      "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Edit a team",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "New 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",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "edit.js"
-      ]
-    },
-    "team:get": {
-      "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Get a team by ID",
-      "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": "team:get",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "get.js"
-      ]
-    },
-    "team:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List your teams",
-      "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": "team:list",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "list.js"
-      ]
-    },
-    "team:members": {
-      "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "List members of a team",
-      "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": "team:members",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "members.js"
-      ]
-    },
-    "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": "Remove a face from a team",
-      "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": "team:remove",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "remove.js"
-      ]
-    },
-    "face:attributes": {
-      "aliases": [],
-      "args": {},
-      "description": "List all supported attribute keys",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "face:attributes",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "attributes.js"
-      ]
-    },
-    "face:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a new face",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "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": "face:create",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "create.js"
-      ]
-    },
-    "face:delete": {
-      "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Delete a face permanently",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "face:delete",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "delete.js"
-      ]
-    },
-    "face:diff": {
+    "face:diff": {
       "aliases": [],
       "args": {},
       "description": "Compare owned faces pairwise across all centroid components",
@@ -4112,16 +3171,10 @@
         "unlock.js"
       ]
     },
-    "face:upload": {
+    "keys:create": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Upload a file (text/PDF/audio/video) to a face",
+      "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.",
@@ -4154,41 +3207,97 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
+        "name": {
+          "description": "Key name/label",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
+        "expires-days": {
+          "description": "Expiry in days (omit for no expiry)",
+          "name": "expires-days",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
+        "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",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "create.js"
+      ]
+    },
+    "keys:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all API keys (JWT required)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
-          "name": "face-speaker",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4196,7 +3305,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:upload",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4206,23 +3315,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "upload.js"
+        "keys",
+        "list.js"
       ]
     },
-    "voiceprint:build-status": {
+    "keys:revoke": {
       "aliases": [],
       "args": {
-        "job_id": {
-          "description": "Build job id",
-          "name": "job_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Get the status/result of a voiceprint build job (from voiceprint:build without --wait)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4254,11 +3360,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:build-status",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4268,24 +3380,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "build-status.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "voiceprint:build": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Build a self face's voice map from its uploaded corpus. Auto-creates the hidden <self>-voiceprint face and installs the map. Async — use --wait to block.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --wait",
-        "<%= config.bin %> <%= command.id %> alice --holdout-count 120 --oauth-only --wait"
-      ],
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4318,43 +3426,30 @@
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model that forges the voice map (default: gpt-5.4)",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "holdout-count": {
-          "description": "Stratified scoring holdout size (default: 120)",
-          "name": "holdout-count",
+        "name": {
+          "description": "New key name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "min-valid": {
-          "description": "Corpus floor below which no holdout is split — train on all (default: 550)",
-          "name": "min-valid",
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Only run on a free (OAuth) route; never fall back to billed inference",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "description": "Block and poll until the build finishes (default: print the job_id and return)",
-          "name": "wait",
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:build",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4364,23 +3459,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "build.js"
+        "keys",
+        "update.js"
       ]
     },
-    "voiceprint:get": {
+    "team:add": {
       "aliases": [],
       "args": {
-        "job_id": {
-          "description": "Scoring job id (from voiceprint:score --no-wait)",
-          "name": "job_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Get the status/result of a voiceprint scoring job started with voiceprint:score --no-wait",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "description": "Add face(s) to a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4412,11 +3504,19 @@
           "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": "voiceprint:get",
+      "id": "team:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4426,23 +3526,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "get.js"
+        "team",
+        "add.js"
       ]
     },
-    "voiceprint:refine-status": {
+    "team:create": {
       "aliases": [],
-      "args": {
-        "job_id": {
-          "description": "Refine job id",
-          "name": "job_id",
-          "required": true
-        }
-      },
-      "description": "Get the status/result of a voiceprint refine job (from voiceprint:refine without --wait)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "args": {},
+      "description": "Create a new team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4474,11 +3565,47 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Team name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Plain-text team description (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol": {
+          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
+          "name": "protocol",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:refine-status",
+      "id": "team:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4488,24 +3615,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "refine-status.js"
+        "team",
+        "create.js"
       ]
     },
-    "voiceprint:refine": {
+    "team:delete": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Tune the active version's post-processing recipe and promote it only if it beats the current one. Requires an existing build with a holdout ≥ 20. Undo with voiceprint:revert.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --wait",
-        "<%= config.bin %> <%= command.id %> alice --temperature 0.4 --n-samples 6 --wait"
-      ],
+      "description": "Delete a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4538,43 +3661,16 @@
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model used to forge candidate drafts (default: the active version's build model)",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "temperature": {
-          "description": "Sampling temperature for candidate drafts (default: 0.4)",
-          "name": "temperature",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "n-samples": {
-          "description": "Drafts forged per holdout pair (default: 6)",
-          "name": "n-samples",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Only run on a free (OAuth) route; never fall back to billed inference",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "description": "Block and poll until refine finishes (default: print the job_id and return)",
-          "name": "wait",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:refine",
+      "id": "team:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4584,23 +3680,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "refine.js"
+        "team",
+        "delete.js"
       ]
     },
-    "voiceprint:revert": {
+    "team:edit": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Revert a self face's voice map to its prior version (one-deep undo; re-running toggles back). Only changes which stored recipe/baseline is active — the map text is frozen.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice"
-      ],
+      "description": "Edit a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4632,11 +3725,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": "voiceprint:revert",
+      "id": "team:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4646,23 +3767,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "revert.js"
+        "team",
+        "edit.js"
       ]
     },
-    "voiceprint:score-status": {
+    "team:get": {
       "aliases": [],
       "args": {
-        "job_id": {
-          "description": "Scoring job id",
-          "name": "job_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Get the status/result of a voiceprint scoring job (from voiceprint:score without --wait)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "description": "Get a team by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4698,7 +3816,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:score-status",
+      "id": "team:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4708,25 +3826,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "score-status.js"
+        "team",
+        "get.js"
       ]
     },
-    "voiceprint:score": {
+    "team:list": {
       "aliases": [],
-      "args": {
-        "face": {
-          "description": "Face to score (alias, owner:alias, or a union like \"(alice-voiceprint | alice)\")",
-          "name": "face",
-          "required": true
-        }
-      },
-      "description": "Score how closely a face writes like a specific person. Returns VCI (closeness, 0–100) and VFI (voice captured vs a generic baseline, 0–100). Deterministic — ideal for before/after tuning.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> \"(alice-voiceprint | alice)\" --emails ./sent.jsonl --wait",
-        "<%= config.bin %> <%= command.id %> alice --emails-dir ./sent-emails/ --wait",
-        "<%= config.bin %> <%= command.id %> alice --emails ./sent.json   # prints job_id; poll with voiceprint:score-status"
-      ],
+      "args": {},
+      "description": "List your teams",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4758,55 +3865,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "emails": {
-          "description": "JSON or JSONL file of the person's real writing — {id?, text} objects or plain strings (provide at least 20)",
-          "name": "emails",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "emails-dir": {
-          "description": "Directory with one sample per file (id = filename). Alternative to --emails.",
-          "exclusive": [
-            "emails"
-          ],
-          "name": "emails-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "author-corpus": {
-          "description": "Optional larger reference of the person's writing (JSON/JSONL/dir) used to define their voice; defaults to --emails",
-          "name": "author-corpus",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Model used to generate comparison drafts",
-          "name": "model",
-          "default": "gpt-5.4",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Only run when a free (OAuth) model route is available; never fall back to billed inference",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "description": "Block and poll until the score is ready, then print it (default: print the job_id and return)",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:score",
+      "id": "team:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4816,29 +3879,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "score.js"
+        "team",
+        "list.js"
       ]
     },
-    "voiceprint:upload": {
+    "team:members": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
-          "required": true
-        },
-        "file": {
-          "description": "Corpus file (JSON array for thread_json, JSONL for email_jsonl)",
-          "name": "file",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Write a self face's email corpus as threads (the source for a voiceprint build). Pure data write — no compilation, no per-message billing.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice ./corpus.json",
-        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --type email_jsonl --emails-per-thread 50"
-      ],
+      "description": "List members of a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4870,31 +3924,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "type": {
-          "description": "thread_json: a JSON array of canonical email objects → one room. email_jsonl: JSONL (one email/line) → chunked into several rooms.",
-          "name": "type",
-          "default": "thread_json",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "thread_json",
-            "email_jsonl"
-          ],
-          "type": "option"
-        },
-        "emails-per-thread": {
-          "description": "For --type email_jsonl: emails per room (default 50)",
-          "name": "emails-per-thread",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:upload",
+      "id": "team:members",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4904,23 +3938,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "upload.js"
+        "team",
+        "members.js"
       ]
     },
-    "voiceprint:versions": {
+    "team:remove": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        },
+        "alias": {
+          "description": "Face alias to remove",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "List a self face's voice-map versions (active + one prior). Retention is one-deep; toggle with voiceprint:revert.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice"
-      ],
+      "description": "Remove a face from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4956,7 +3992,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:versions",
+      "id": "team:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4966,8 +4002,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "versions.js"
+        "team",
+        "remove.js"
       ]
     },
     "billing:subscription:activate": {
@@ -5095,6 +4131,60 @@
         "cancel.js"
       ]
     },
+    "billing:subscription": {
+      "aliases": [],
+      "args": {},
+      "description": "Show current plan, face count, and renewal date",
+      "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": "billing:subscription",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "subscription",
+        "index.js"
+      ]
+    },
     "compile:doc:create": {
       "aliases": [],
       "args": {
@@ -6435,16 +5525,16 @@
         "sync.js"
       ]
     },
-    "team:tag:add": {
+    "face:tag:add": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Add tags to a team (appends, idempotent)",
+      "description": "Add tags to a face (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6488,7 +5578,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:add",
+      "id": "face:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6498,21 +5588,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
         "add.js"
       ]
     },
-    "team:tag:list": {
+    "face:tag:all": {
       "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "List tags on a team",
+      "args": {},
+      "description": "List all tags across all your faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6548,7 +5632,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:list",
+      "id": "face:tag:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6558,26 +5642,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
-        "list.js"
+        "all.js"
       ]
     },
-    "team:tag:remove": {
+    "face:tag:list": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        },
-        "tag": {
-          "description": "Tag to remove",
-          "name": "tag",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Remove a tag from a team",
+      "description": "List tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6613,7 +5692,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:remove",
+      "id": "face:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6623,21 +5702,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
-        "remove.js"
+        "list.js"
       ]
     },
-    "team:tag:set": {
+    "face:tag:remove": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        },
+        "tag": {
+          "description": "Tag to remove",
+          "name": "tag",
           "required": true
         }
       },
-      "description": "Replace all tags on a team",
+      "description": "Remove a tag from a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6669,19 +5753,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "tag": {
-          "description": "Tag to set (repeatable, replaces all)",
-          "name": "tag",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:set",
+      "id": "face:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6691,12 +5767,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
+        "face",
         "tag",
-        "set.js"
+        "remove.js"
       ]
     },
-    "face:tag:add": {
+    "face:tag:set": {
       "aliases": [],
       "args": {
         "alias": {
@@ -6705,7 +5781,7 @@
           "required": true
         }
       },
-      "description": "Add tags to a face (appends, idempotent)",
+      "description": "Replace all tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6739,7 +5815,7 @@
           "type": "option"
         },
         "tag": {
-          "description": "Tag to add (repeatable)",
+          "description": "Tag to set (repeatable, replaces all)",
           "name": "tag",
           "required": true,
           "hasDynamicHelp": false,
@@ -6749,7 +5825,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:add",
+      "id": "face:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6761,13 +5837,19 @@
         "commands",
         "face",
         "tag",
-        "add.js"
+        "set.js"
       ]
     },
-    "face:tag:all": {
+    "team:tag:add": {
       "aliases": [],
-      "args": {},
-      "description": "List all tags across all your faces",
+      "args": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        }
+      },
+      "description": "Add tags to a team (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6799,11 +5881,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Tag to add (repeatable)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:all",
+      "id": "team:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6813,21 +5903,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
-        "all.js"
+        "add.js"
       ]
     },
-    "face:tag:list": {
+    "team:tag:list": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "List tags on a face",
+      "description": "List tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6863,7 +5953,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:list",
+      "id": "team:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6873,17 +5963,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
         "list.js"
       ]
     },
-    "face:tag:remove": {
+    "team:tag:remove": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         },
         "tag": {
@@ -6892,7 +5982,7 @@
           "required": true
         }
       },
-      "description": "Remove a tag from a face",
+      "description": "Remove a tag from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6928,7 +6018,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:remove",
+      "id": "team:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6938,21 +6028,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
         "remove.js"
       ]
     },
-    "face:tag:set": {
+    "team:tag:set": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Replace all tags on a face",
+      "description": "Replace all tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6996,7 +6086,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:set",
+      "id": "team:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -7006,11 +6096,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "team",
         "tag",
         "set.js"
       ]
     }
   },
-  "version": "1.7.6"
+  "version": "1.7.7"
 }