faces-cli 1.7.14 → 1.8.0

package/oclif.manifest.json

@@ -632,10 +632,10 @@
         "whoami.js"
       ]
     },
-    "catalog:backup": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -671,7 +671,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:backup",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -681,14 +681,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "catalog:doctor": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -720,23 +720,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "fix": {
-          "description": "Rebuild missing or stale catalog entries from API",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "generate": {
-          "description": "Fix + generate missing descriptions via LLM",
-          "name": "generate",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:doctor",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -746,14 +734,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "catalog:list": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -785,11 +773,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -799,14 +794,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "catalog:manyfaced": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -839,37 +834,25 @@
           "multiple": false,
           "type": "option"
         },
-        "skill": {
-          "description": "Show details for a specific skill",
-          "name": "skill",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "install": {
-          "description": "Install a skill by name",
-          "name": "install",
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "refresh": {
-          "description": "Force refresh the skill index (ignore cache)",
-          "name": "refresh",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:manyfaced",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -879,19 +862,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "catalog:restore": {
+    "billing:usage": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
-          "name": "file"
-        }
-      },
-      "description": "Restore faces, teams, and source material from a backup snapshot",
+      "args": {},
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -924,16 +902,37 @@
           "multiple": false,
           "type": "option"
         },
-        "compile": {
-          "description": "Run compile:all after restoring",
-          "name": "compile",
-          "allowNo": false,
-          "type": "boolean"
+        "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": "catalog:restore",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -943,14 +942,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "billing",
+        "usage.js"
       ]
     },
-    "billing:balance": {
+    "catalog:backup": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Snapshot all faces, teams, and source material for migration",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -986,7 +985,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -996,14 +995,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "catalog",
+        "backup.js"
       ]
     },
-    "billing:card-setup": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "Diagnose and repair the local face and team catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1035,11 +1034,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1049,14 +1060,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "billing:llm-costs": {
+    "catalog:list": {
       "aliases": [],
       "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1088,18 +1099,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1109,14 +1113,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "billing:topup": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1149,25 +1153,37 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
-          "required": true,
+        "skill": {
+          "description": "Show details for a specific skill",
+          "name": "skill",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "install": {
+          "description": "Install a skill by name",
+          "name": "install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skills-dir": {
+          "description": "Directory to install skills into (required for --install)",
+          "name": "skills-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh": {
+          "description": "Force refresh the skill index (ignore cache)",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1177,14 +1193,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "billing:usage": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Aggregated usage analytics",
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces, teams, and source material from a backup snapshot",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1217,37 +1238,16 @@
           "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"
-        }
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
+        }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1257,8 +1257,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "catalog",
+        "restore.js"
       ]
     },
     "chat:chat": {
@@ -3201,6 +3201,81 @@
         "share.js"
       ]
     },
+    "face:sources": {
+      "aliases": [],
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --type thread",
+        "<%= config.bin %> <%= command.id %> alice --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "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"
+        },
+        "type": {
+          "description": "Show only one kind of source",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "doc",
+            "thread"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:sources",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "sources.js"
+      ]
+    },
     "face:stats": {
       "aliases": [],
       "args": {},
@@ -3358,18 +3433,457 @@
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:unlock",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "unlock.js"
+      ]
+    },
+    "face:unpublish": {
+      "aliases": [],
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an override on top of sharing, not a replacement for it.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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:unpublish",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "unpublish.js"
+      ]
+    },
+    "face:unshare": {
+      "aliases": [],
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --from dana --yes",
+        "<%= config.bin %> <%= command.id %> alice --all --yes"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "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"
+        },
+        "from": {
+          "description": "Account to revoke (repeatable)",
+          "exclusive": [
+            "all"
+          ],
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all": {
+          "description": "Revoke everyone",
+          "exclusive": [
+            "from"
+          ],
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:unshare",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "unshare.js"
+      ]
+    },
+    "keys:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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": "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",
+      "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,
+          "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.",
+          "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": "keys:revoke",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "revoke.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": "face:unlock",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3379,11 +3893,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unlock.js"
+        "keys",
+        "update.js"
       ]
     },
-    "face:unpublish": {
+    "style:delete": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3392,7 +3906,11 @@
           "required": true
         }
       },
-      "description": "Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an override on top of sharing, not a replacement for it.",
+      "description": "Delete a face's captured style. --scope map forgets the style and keeps the material it came from. --scope all deletes the uploaded material too, permanently. There is no default because the two differ by whether your material survives.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --scope map",
+        "<%= config.bin %> <%= command.id %> alice --scope all --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3424,11 +3942,29 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "scope": {
+          "description": "map: forget the style, keep the material. all: delete the material with it, permanently.",
+          "name": "scope",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "map",
+            "all"
+          ],
+          "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unpublish",
+      "id": "style:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3438,11 +3974,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unpublish.js"
+        "style",
+        "delete.js"
       ]
     },
-    "face:unshare": {
+    "style:make": {
       "aliases": [],
       "args": {
         "alias": {
@@ -3451,10 +3987,12 @@
           "required": true
         }
       },
-      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
+      "description": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> alice --from dana --yes",
-        "<%= config.bin %> <%= command.id %> alice --all --yes"
+        "<%= config.bin %> <%= command.id %> alice --all",
+        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
+        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
+        "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
       ],
       "flags": {
         "json": {
@@ -3488,35 +4026,70 @@
           "multiple": false,
           "type": "option"
         },
-        "from": {
-          "description": "Account to revoke (repeatable)",
-          "exclusive": [
-            "all"
-          ],
-          "name": "from",
+        "source": {
+          "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
+          "name": "source",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "all": {
-          "description": "Revoke everyone",
-          "exclusive": [
-            "from"
-          ],
+          "description": "Use every source on the face that is ready. Anything skipped is listed.",
           "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "medium": {
+          "description": "Medium for any selected source that does not declare one. Each medium is analysed on its own, so an essay never teaches a rule about email.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Analyst model (default: gpt-5.6-terra)",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "allow-paid": {
+          "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
+          "name": "allow-paid",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "compile": {
+          "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
+          "name": "compile",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "best-of": {
+          "description": "Generate N candidates and keep the best (1-5, default 1)",
+          "name": "best-of",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Start the build and return the job id without polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
+        },
+        "timeout": {
+          "description": "How long to wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:unshare",
+      "id": "style:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3526,14 +4099,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "unshare.js"
+        "style",
+        "make.js"
       ]
     },
-    "keys:create": {
+    "style:revert": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Go back to the style a face had before the last style:make. It steps backwards through the kept versions and there is no step forward, so the way to undo a revert is to capture the style again. It changes how the face writes immediately, so it asks first.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3566,52 +4148,16 @@
           "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,
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:create",
+      "id": "style:revert",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3621,14 +4167,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "style",
+        "revert.js"
       ]
     },
-    "keys:list": {
+    "style:status": {
       "aliases": [],
-      "args": {},
-      "description": "List all API keys (JWT required)",
+      "args": {
+        "job_id": {
+          "description": "Build job id",
+          "name": "job_id",
+          "required": false
+        }
+      },
+      "description": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> 7a8b9c0d",
+        "<%= config.bin %> <%= command.id %> --face alice",
+        "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3660,11 +4217,40 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "face": {
+          "description": "List recent builds for this face instead of reading one job",
+          "name": "face",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "How many builds to list with --face (default: 10)",
+          "name": "limit",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Block until the job finishes",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "How long to wait with --wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "style:status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3674,20 +4260,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "list.js"
+        "style",
+        "status.js"
       ]
     },
-    "keys:revoke": {
+    "style:upload": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        },
+        "file": {
+          "description": "Corpus file",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "Load a corpus of a person's own writing (a mail export, a message archive) as source material for style capture. This only stores the material: nothing is compiled and nothing is billed. Capture the style afterwards with style:make.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl",
+        "<%= config.bin %> <%= command.id %> alice ./thread.json --type thread_json",
+        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --messages-per-room 100 --strict"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3720,16 +4316,36 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "type": {
+          "description": "email_jsonl: one message per line, split across several rooms. thread_json: a JSON array that becomes a single room.",
+          "name": "type",
+          "default": "email_jsonl",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "email_jsonl",
+            "thread_json"
+          ],
+          "type": "option"
+        },
+        "messages-per-room": {
+          "description": "How many messages per room when the type is email_jsonl (1-1000, default: 50)",
+          "name": "messages-per-room",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "strict": {
+          "description": "Reject the whole upload if any message is invalid. By default invalid messages are skipped and reported, because a corpus is statistical and a few bad lines are not worth losing the rest.",
+          "name": "strict",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "style:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3739,20 +4355,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "style",
+        "upload.js"
       ]
     },
-    "keys:update": {
+    "style:versions": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Update API key metadata (JWT required)",
+      "description": "List the styles captured for a face, and which one it is writing in now. Each style:make keeps the previous one, so this is what style:revert has to go back to.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3784,31 +4404,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "New key name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "style:versions",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3818,8 +4418,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "style",
+        "versions.js"
       ]
     },
     "team:add": {
@@ -4993,7 +5593,7 @@
           "required": true
         }
       },
-      "description": "List documents for a face",
+      "description": "List documents for a face. Each document's full text is omitted unless --verbose, so a face with a real corpus stays readable. For a table of every source, documents and threads together, use face:sources.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5025,6 +5625,12 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "verbose": {
+          "description": "Include each document's full text",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -6517,5 +7123,5 @@
       ]
     }
   },
-  "version": "1.7.14"
+  "version": "1.8.0"
 }