faces-cli 1.6.16 → 1.6.17

package/oclif.manifest.json

@@ -120,23 +120,10 @@
         "state.js"
       ]
     },
-    "auth:connect": {
+    "billing:balance": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to connect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
-      "examples": [
-        "<%= config.bin %> auth connect openai",
-        "<%= config.bin %> auth connect openai --manual"
-      ],
+      "args": {},
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -168,17 +155,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "manual": {
-          "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
-          "name": "manual",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connect",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -188,18 +169,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connect.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "auth:connections": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "List connected OAuth provider accounts",
-      "examples": [
-        "<%= config.bin %> auth connections",
-        "<%= config.bin %> auth connections --json"
-      ],
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -235,7 +212,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connections",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -245,26 +222,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connections.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "auth:disconnect": {
+    "billing:llm-costs": {
       "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 available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -296,11 +261,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:disconnect",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -310,14 +282,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "disconnect.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "auth:login": {
+    "billing:quota": {
       "aliases": [],
       "args": {},
-      "description": "Login and save JWT credentials",
+      "description": "Show compilation stats per face (deprecated — use compile:stats)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -349,27 +321,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "email": {
-          "description": "Account email",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Account password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "billing:quota",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -379,14 +335,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "billing",
+        "quota.js"
       ]
     },
-    "auth:logout": {
+    "billing:subscription": {
       "aliases": [],
       "args": {},
-      "description": "Clear saved credentials",
+      "description": "Show current plan, face count, and renewal date",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -422,7 +378,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "billing:subscription",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -432,14 +388,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "billing",
+        "subscription.js"
       ]
     },
-    "auth:refresh": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Exchange current JWT for a fresh one",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -471,11 +427,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": "auth:refresh",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -485,14 +456,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "refresh.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "auth:register": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Faces account",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -525,53 +496,37 @@
           "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,
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
           "type": "option"
         },
-        "invite-key": {
-          "description": "Invite key (if required)",
-          "name": "invite-key",
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
           "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",
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "free",
-            "connect"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:register",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -581,14 +536,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "register.js"
+        "billing",
+        "usage.js"
       ]
     },
-    "auth:whoami": {
+    "auth:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Print current user profile and auth diagnostic",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to connect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
+      "examples": [
+        "<%= config.bin %> auth connect openai",
+        "<%= config.bin %> auth connect openai --manual"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -620,11 +588,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "manual": {
+          "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
+          "name": "manual",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:connect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -635,13 +609,17 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "connect.js"
       ]
     },
-    "billing:balance": {
+    "auth:connections": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "List connected OAuth provider accounts",
+      "examples": [
+        "<%= config.bin %> auth connections",
+        "<%= config.bin %> auth connections --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -677,7 +655,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "auth:connections",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -687,14 +665,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "auth",
+        "connections.js"
       ]
     },
-    "billing:card-setup": {
+    "auth:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "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.",
@@ -730,7 +720,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "auth:disconnect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -740,14 +730,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "auth",
+        "disconnect.js"
       ]
     },
-    "billing:llm-costs": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "description": "Login and save JWT credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -780,9 +770,18 @@
           "multiple": false,
           "type": "option"
         },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
+        "email": {
+          "description": "Account email",
+          "name": "email",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Account password",
+          "name": "password",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -790,7 +789,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "auth:login",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -800,14 +799,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "auth",
+        "login.js"
       ]
     },
-    "billing:quota": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Show compilation stats per face (deprecated — use compile:stats)",
+      "description": "Clear saved credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -843,7 +842,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:quota",
+      "id": "auth:logout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -853,14 +852,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "quota.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "billing:subscription": {
+    "auth:refresh": {
       "aliases": [],
       "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "description": "Exchange current JWT for a fresh one",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -896,7 +895,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "auth:refresh",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -906,14 +905,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription.js"
+        "auth",
+        "refresh.js"
       ]
     },
-    "billing:topup": {
+    "auth:register": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Create a new Faces account",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -946,25 +945,53 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
+        "email": {
+          "description": "Email address",
+          "name": "email",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "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": "billing:topup",
+      "id": "auth:register",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -974,14 +1001,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "auth",
+        "register.js"
       ]
     },
-    "billing:usage": {
+    "auth:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "Print current user profile and auth diagnostic",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1013,38 +1040,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:whoami",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1054,8 +1054,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "auth",
+        "whoami.js"
       ]
     },
     "catalog:backup": {
@@ -2320,63 +2320,10 @@
         "show.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": {
+    "keys:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new face",
+      "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.",
@@ -2410,67 +2357,51 @@
           "type": "option"
         },
         "name": {
-          "description": "Display name",
+          "description": "Key name/label",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "alias": {
-          "description": "Unique alias slug",
-          "name": "alias",
-          "required": true,
+        "expires-days": {
+          "description": "Expiry in days (omit for no expiry)",
+          "name": "expires-days",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
+        "budget": {
+          "description": "Spend budget in USD",
+          "name": "budget",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
+        "face": {
+          "description": "Allowed face alias (repeatable)",
+          "name": "face",
           "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",
+        "model": {
+          "description": "Allowed model name (repeatable)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "tool": {
-          "description": "Tool name to enable (repeatable)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "save": {
+          "description": "Save the new key to ~/.faces/config.json as api_key (default: true; use --no-save to skip)",
+          "name": "save",
+          "allowNo": true,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:create",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2480,20 +2411,73 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "keys",
         "create.js"
       ]
     },
-    "face:delete": {
+    "keys:list": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Delete a face permanently",
+      "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,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "keys:list",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "list.js"
+      ]
+    },
+    "keys:revoke": {
+      "aliases": [],
+      "args": {
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
+          "required": true
+        }
+      },
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2535,7 +2519,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:delete",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2545,14 +2529,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "delete.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "face:diff": {
+    "keys:update": {
       "aliases": [],
-      "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
+      "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.",
@@ -2585,18 +2575,30 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
+        "name": {
+          "description": "New key name",
+          "name": "name",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
+        },
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2606,20 +2608,67 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "diff.js"
+        "keys",
+        "update.js"
       ]
     },
-    "face:edit": {
+    "face:attributes": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
+      "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"
         }
       },
-      "description": "Edit a face's metadata",
+      "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.",
@@ -2653,8 +2702,17 @@
           "type": "option"
         },
         "name": {
-          "description": "New display 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"
@@ -2667,7 +2725,7 @@
           "type": "option"
         },
         "tag": {
-          "description": "Replace all tags (repeatable, lowercase)",
+          "description": "Tag label (repeatable, lowercase)",
           "name": "tag",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -2681,21 +2739,21 @@
           "type": "option"
         },
         "formula": {
-          "description": "New boolean formula (synthetic faces only)",
+          "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": "Update attribute KEY=VALUE (repeatable)",
+          "description": "Attribute KEY=VALUE (repeatable)",
           "name": "attr",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "tool": {
-          "description": "Tool names to set (replaces list, repeatable)",
+          "description": "Tool name to enable (repeatable)",
           "name": "tool",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -2704,7 +2762,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:edit",
+      "id": "face:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2715,10 +2773,10 @@
         "dist",
         "commands",
         "face",
-        "edit.js"
+        "create.js"
       ]
     },
-    "face:get": {
+    "face:delete": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2727,7 +2785,7 @@
           "required": true
         }
       },
-      "description": "Get details for a face by alias",
+      "description": "Delete a face permanently",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2760,17 +2818,16 @@
           "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2781,13 +2838,13 @@
         "dist",
         "commands",
         "face",
-        "get.js"
+        "delete.js"
       ]
     },
-    "face:list": {
+    "face:diff": {
       "aliases": [],
       "args": {},
-      "description": "List all owned faces",
+      "description": "Compare owned faces pairwise across all centroid components",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2820,31 +2877,18 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Filter by tag (repeatable, AND logic)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "team": {
-          "description": "Filter by team ID (repeatable, OR logic)",
-          "name": "team",
+        "face": {
+          "description": "Face alias to include (repeatable, min 2)",
+          "name": "face",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
-        },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "face:diff",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2855,10 +2899,10 @@
         "dist",
         "commands",
         "face",
-        "list.js"
+        "diff.js"
       ]
     },
-    "face:neighbors": {
+    "face:edit": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2867,7 +2911,7 @@
           "required": true
         }
       },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "description": "Edit a face's metadata",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2900,97 +2944,59 @@
           "multiple": false,
           "type": "option"
         },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
+        "name": {
+          "description": "New display name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "component": {
-          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
-          "name": "component",
-          "default": "face",
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "face",
-            "beta",
-            "delta",
-            "epsilon"
-          ],
           "type": "option"
         },
-        "direction": {
-          "description": "nearest (most similar) or furthest (most dissimilar)",
-          "name": "direction",
-          "default": "nearest",
+        "tag": {
+          "description": "Replace all tags (repeatable, lowercase)",
+          "name": "tag",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "nearest",
-            "furthest"
-          ],
+          "multiple": true,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "face:neighbors",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "face",
-        "neighbors.js"
-      ]
-    },
-    "face:stats": {
-      "aliases": [],
-      "args": {},
-      "description": "Compile and chat stats for all owned faces",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
+        "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"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "formula": {
+          "description": "New boolean formula (synthetic faces only)",
+          "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "attr": {
+          "description": "Update attribute KEY=VALUE (repeatable)",
+          "name": "attr",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool names to set (replaces list, repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:stats",
+      "id": "face:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3001,19 +3007,19 @@
         "dist",
         "commands",
         "face",
-        "stats.js"
+        "edit.js"
       ]
     },
-    "face:teams": {
+    "face:get": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Set a face's team memberships (replaces all)",
+      "description": "Get details for a face by alias",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3046,18 +3052,17 @@
           "multiple": false,
           "type": "option"
         },
-        "team": {
-          "description": "Team ID (repeatable, replaces all memberships)",
-          "name": "team",
-          "required": true,
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:teams",
+      "id": "face:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3068,19 +3073,13 @@
         "dist",
         "commands",
         "face",
-        "teams.js"
+        "get.js"
       ]
     },
-    "face:upload": {
+    "face:list": {
       "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": "List all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3113,41 +3112,23 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
+        "tag": {
+          "description": "Filter by tag (repeatable, AND logic)",
+          "name": "tag",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
+          "multiple": true,
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
+        "team": {
+          "description": "Filter by team ID (repeatable, OR logic)",
+          "name": "team",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
+          "multiple": true,
           "type": "option"
         },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
-          "name": "face-speaker",
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3155,7 +3136,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:upload",
+      "id": "face:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3166,13 +3147,19 @@
         "dist",
         "commands",
         "face",
-        "upload.js"
+        "list.js"
       ]
     },
-    "keys:create": {
+    "face:neighbors": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new API key (JWT required)",
+      "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.",
@@ -3205,46 +3192,44 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Key name/label",
-          "name": "name",
-          "required": true,
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "expires-days": {
-          "description": "Expiry in days (omit for no expiry)",
-          "name": "expires-days",
+        "component": {
+          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
+          "name": "component",
+          "default": "face",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "face",
+            "beta",
+            "delta",
+            "epsilon"
+          ],
           "type": "option"
         },
-        "budget": {
-          "description": "Spend budget in USD",
-          "name": "budget",
+        "direction": {
+          "description": "nearest (most similar) or furthest (most dissimilar)",
+          "name": "direction",
+          "default": "nearest",
           "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,
+          "options": [
+            "nearest",
+            "furthest"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:create",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3254,14 +3239,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "face",
+        "neighbors.js"
       ]
     },
-    "keys:list": {
+    "face:stats": {
       "aliases": [],
       "args": {},
-      "description": "List all API keys (JWT required)",
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3297,7 +3282,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "face:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3307,20 +3292,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "list.js"
+        "face",
+        "stats.js"
       ]
     },
-    "keys:revoke": {
+    "face:teams": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "Set a face's team memberships (replaces all)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3353,16 +3338,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": "keys:revoke",
+      "id": "face:teams",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3372,20 +3359,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "face",
+        "teams.js"
       ]
     },
-    "keys:update": {
+    "face:upload": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Update API key metadata (JWT required)",
+      "description": "Upload a file (text/PDF/audio/video) to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3418,30 +3405,49 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "New key name",
-          "name": "name",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
+          "type": "option"
+        },
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
+        "face-speaker": {
+          "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
+          "name": "face-speaker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "face:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3451,8 +3457,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "face",
+        "upload.js"
       ]
     },
     "team:add": {
@@ -6040,5 +6046,5 @@
       ]
     }
   },
-  "version": "1.6.16"
+  "version": "1.6.17"
 }