faces-cli 1.8.6 → 1.8.8

package/oclif.manifest.json

@@ -1265,14 +1265,15 @@
       "aliases": [],
       "args": {
         "face_username": {
-          "description": "Face alias (alias@model, owner:alias@model for a published face, or a composite formula like \"(a | b)@model\"). Omit when using --formula.",
+          "description": "Face alias (alias@model, owner:alias@model for a published face, or a composite formula like \"(a | b)@model\"). Prefix with + to use the face's captured style. Omit when using --formula.",
           "name": "face_username",
           "required": false
         }
       },
-      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.",
+      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog. Prefix the alias with + to answer in the style the face captured, e.g. +alice; without it the face uses its ordinary voice.",
       "examples": [
         "<%= config.bin %> <%= command.id %> socrates -m \"What is virtue?\"",
+        "<%= config.bin %> <%= command.id %> +alice -m \"Reply to the note below.\" --medium email",
         "<%= config.bin %> <%= command.id %> \"(socrates | nietzsche)@claude-sonnet-4-6\" -m \"What is virtue?\"",
         "<%= config.bin %> <%= command.id %> --formula \"socrates | nietzsche\" --llm claude-sonnet-4-6 -m \"What is virtue?\""
       ],
@@ -1372,12 +1373,19 @@
           "type": "boolean"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "best-of": {
+          "description": "Write N replies and serve the one closest to the captured style (1-5, default 1). Only meaningful with a + alias, and it multiplies the cost of the request by N. Cannot be streamed.",
+          "name": "best-of",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "oauth-only": {
           "description": "Prevent fallback to paid system key (use OAuth only)",
           "name": "oauth-only",
@@ -1474,7 +1482,7 @@
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1568,7 +1576,7 @@
           "type": "boolean"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1601,12 +1609,12 @@
       "aliases": [],
       "args": {
         "face_username": {
-          "description": "Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread",
+          "description": "Face alias (alias@model, or owner:alias@model for a published face). Required when starting a new thread",
           "name": "face_username",
           "required": false
         }
       },
-      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
+      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json. Resume any thread later with --id.",
       "examples": [
         "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
         "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
@@ -1703,7 +1711,7 @@
           "type": "boolean"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1750,6 +1758,182 @@
         "thread.js"
       ]
     },
+    "config:clear": {
+      "aliases": [],
+      "args": {},
+      "description": "Delete all saved credentials and config",
+      "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": "config:clear",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "clear.js"
+      ]
+    },
+    "config:set": {
+      "aliases": [],
+      "args": {
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "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": "config:set",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "set.js"
+      ]
+    },
+    "config:show": {
+      "aliases": [],
+      "args": {},
+      "description": "Print current config (credentials are masked)",
+      "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": "config:show",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "show.js"
+      ]
+    },
     "compile:all": {
       "aliases": [],
       "args": {},
@@ -2043,7 +2227,7 @@
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. Only valid with --kind document.",
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. Only valid with --kind document.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2079,10 +2263,10 @@
         "upload.js"
       ]
     },
-    "config:clear": {
+    "keys:create": {
       "aliases": [],
       "args": {},
-      "description": "Delete all saved credentials and config",
+      "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.",
@@ -2115,16 +2299,52 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
+        "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": "config:clear",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2134,25 +2354,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "keys",
+        "create.js"
       ]
     },
-    "config:set": {
+    "keys:list": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "args": {},
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2188,7 +2397,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:set",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2198,14 +2407,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "keys",
+        "list.js"
       ]
     },
-    "config:show": {
+    "keys:revoke": {
       "aliases": [],
-      "args": {},
-      "description": "Print current config (credentials are masked)",
+      "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.",
@@ -2237,11 +2452,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:show",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2251,8 +2472,87 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "show.js"
+        "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": "keys:update",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "keys",
+        "update.js"
       ]
     },
     "face:attributes": {
@@ -2890,7 +3190,7 @@
           "required": true
         }
       },
-      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.",
+      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it, and everything it owns (documents, threads, captured style), cannot be changed until unlocked.",
       "examples": [
         "<%= config.bin %> <%= command.id %> socrates"
       ],
@@ -2986,7 +3286,7 @@
           "type": "option"
         },
         "k": {
-          "description": "Number of results (1–20)",
+          "description": "Number of results (1-20)",
           "name": "k",
           "default": 5,
           "hasDynamicHelp": false,
@@ -3153,7 +3453,7 @@
           "type": "boolean"
         },
         "add": {
-          "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
+          "description": "Add an account, keeping everyone already on the list. Username or email (repeatable)",
           "exclusive": [
             "with",
             "none"
@@ -3411,7 +3711,7 @@
           "required": true
         }
       },
-      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
+      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, captured style).",
       "examples": [
         "<%= config.bin %> <%= command.id %> socrates"
       ],
@@ -3473,7 +3773,7 @@
           "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": "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.",
@@ -3532,7 +3832,7 @@
           "required": true
         }
       },
-      "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
+      "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"
@@ -3611,10 +3911,20 @@
         "unshare.js"
       ]
     },
-    "keys:create": {
+    "style:delete": {
       "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": "Delete a face's captured style. The material it was learned from is kept, so the style can be captured again without re-uploading. This never deletes documents or threads: remove those with compile:doc:delete or compile:thread:delete.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice",
+        "<%= config.bin %> <%= command.id %> alice --yes"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3647,52 +3957,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:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3702,14 +3976,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "style",
+        "delete.js"
       ]
     },
-    "keys:list": {
+    "style:make": {
       "aliases": [],
-      "args": {},
-      "description": "List all API keys (JWT required)",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --all",
+        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
+        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
+        "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3741,11 +4027,71 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "source": {
+          "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
+          "name": "source",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all": {
+          "description": "Use every source on the face that is ready. Anything skipped is listed.",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "medium": {
+          "description": "Medium for selected sources that do not already declare one. It does not override a source that does. Each medium is analysed on its own, so an essay never teaches a rule about email.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Analyst model (default: gpt-5.6-terra)",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "allow-paid": {
+          "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
+          "name": "allow-paid",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "compile": {
+          "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
+          "name": "compile",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "best-of": {
+          "description": "Generate N candidates and keep the best (1-5, default 1)",
+          "name": "best-of",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Start the build and return the job id without polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "How long to wait, in seconds (default: 3600)",
+          "name": "timeout",
+          "default": 3600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "style:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3755,346 +4101,8 @@
       "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": "keys:update",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "keys",
-        "update.js"
-      ]
-    },
-    "style:delete": {
-      "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Delete a face's captured style. The material it was learned from is kept, so the style can be captured again without re-uploading. This never deletes documents or threads: remove those with compile:doc:delete or compile:thread:delete.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice",
-        "<%= config.bin %> <%= command.id %> alice --yes"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "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": "style:delete",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "style",
-        "delete.js"
-      ]
-    },
-    "style:make": {
-      "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --all",
-        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
-        "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
-        "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
-      ],
-      "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"
-        },
-        "source": {
-          "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
-          "name": "source",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "all": {
-          "description": "Use every source on the face that is ready. Anything skipped is listed.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "medium": {
-          "description": "Medium for selected sources that do not already declare one. It does not override a source that does. Each medium is analysed on its own, so an essay never teaches a rule about email.",
-          "name": "medium",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Analyst model (default: gpt-5.6-terra)",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "allow-paid": {
-          "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
-          "name": "allow-paid",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "compile": {
-          "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
-          "name": "compile",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "best-of": {
-          "description": "Generate N candidates and keep the best (1-5, default 1)",
-          "name": "best-of",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Start the build and return the job id without polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "How long to wait, in seconds (default: 3600)",
-          "name": "timeout",
-          "default": 3600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "style:make",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "style",
-        "make.js"
+        "style",
+        "make.js"
       ]
     },
     "style:revert": {
@@ -5154,7 +5162,7 @@
         "index.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5163,7 +5171,7 @@
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Start a new thread for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5197,49 +5205,22 @@
           "type": "option"
         },
         "label": {
-          "description": "Document label/title",
+          "description": "Thread label",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "Inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read content from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective (first-person or third-person)",
-          "name": "perspective",
-          "default": "first-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:create",
+      "id": "compile:thread:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5250,20 +5231,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "create.js"
       ]
     },
-    "compile:doc:delete": {
+    "compile:thread:delete": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Delete a document",
+      "description": "Delete a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5295,11 +5276,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5310,20 +5297,25 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "delete.js"
       ]
     },
-    "compile:doc:edit": {
+    "compile:thread:edit": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Edit a document (label, content, or perspective)",
+      "description": "Edit a thread: its label, what medium it is read as, and/or which speaker is the face.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> THREAD_ID --label \"Interview\"",
+        "<%= config.bin %> <%= command.id %> THREAD_ID --medium lecture",
+        "<%= config.bin %> <%= command.id %> THREAD_ID --clear-medium"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5357,108 +5349,42 @@
           "type": "option"
         },
         "label": {
-          "description": "New label/title",
+          "description": "New thread label",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "New inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read new content from file",
-          "name": "file",
+        "face-speaker": {
+          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "description": "What this thread should be read as. What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. This is a correction that sticks: it overrides what an imported corpus arrived as, without changing the record of what that was.",
+          "exclusive": [
+            "clear-medium"
+          ],
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "perspective": {
-          "description": "Perspective (first-person or third-person)",
-          "name": "perspective",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
+        "clear-medium": {
+          "description": "Remove a medium correction, so the thread is read as whatever it arrived as.",
+          "exclusive": [
+            "medium"
           ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "compile:doc:edit",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "compile",
-        "doc",
-        "edit.js"
-      ]
-    },
-    "compile:doc:get": {
-      "aliases": [],
-      "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
-          "required": true
-        }
-      },
-      "description": "Get a document by ID",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+          "name": "clear-medium",
           "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": "compile:doc:get",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5469,24 +5395,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "get.js"
+        "thread",
+        "edit.js"
       ]
     },
-    "compile:doc": {
+    "compile:thread:get": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Compile one or more documents into a face (create → make in one step). Repeat --file to submit several documents in a single command; each file becomes its own document rather than being concatenated.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --file notes.txt",
-        "<%= config.bin %> <%= command.id %> alice --file a.txt --file b.txt --file c.txt --no-wait --json"
-      ],
+      "description": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5518,68 +5440,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "label": {
-          "description": "Document label/title (single document only; with several files each is labelled by its filename)",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "description": "Inline text content",
-          "exclusive": [
-            "file"
-          ],
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read content from file (repeatable — each file becomes its own document)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "medium": {
-          "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
-          "name": "medium",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective",
-          "name": "perspective",
-          "default": "first-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "timeout": {
-          "description": "Compile timeout in seconds, per document (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Create and trigger compilation, then return immediately without polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5590,11 +5455,11 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "index.js"
+        "thread",
+        "get.js"
       ]
     },
-    "compile:doc:list": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5603,7 +5468,7 @@
           "required": true
         }
       },
-      "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.",
+      "description": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5635,17 +5500,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "verbose": {
-          "description": "Include each document's full text",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5656,20 +5515,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "list.js"
       ]
     },
-    "compile:doc:make": {
+    "compile:thread:make": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Compile an existing document (prepare + sync in one step)",
+      "description": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5711,7 +5570,7 @@
           "type": "option"
         },
         "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
+          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
           "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
@@ -5719,7 +5578,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:make",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5730,20 +5589,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
+        "thread",
         "make.js"
       ]
     },
-    "compile:doc:pause": {
+    "compile:thread:message": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Ask a running document compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5776,24 +5635,25 @@
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the compile to stop (default: 60)",
-          "name": "timeout",
-          "default": 60,
+        "message": {
+          "char": "m",
+          "description": "User message to append",
+          "name": "message",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:pause",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5804,20 +5664,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "pause.js"
+        "thread",
+        "message.js"
       ]
     },
-    "compile:doc:reset": {
+    "compile:thread:pause": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Reset document compilation progress (wipe extraction, keep content)",
+      "description": "Ask a running thread compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5850,16 +5710,24 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "no-wait": {
+          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the compile to stop (default: 60)",
+          "name": "timeout",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:reset",
+      "id": "compile:thread:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5870,20 +5738,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "reset.js"
+        "thread",
+        "pause.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:thread:reset": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Start a new thread for a face",
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5916,23 +5784,16 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Thread label",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:create",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5944,10 +5805,10 @@
         "commands",
         "compile",
         "thread",
-        "create.js"
+        "reset.js"
       ]
     },
-    "compile:thread:delete": {
+    "compile:thread:sync": {
       "aliases": [],
       "args": {
         "thread_id": {
@@ -5956,7 +5817,7 @@
           "required": true
         }
       },
-      "description": "Delete a thread",
+      "description": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5988,17 +5849,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:delete",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6010,24 +5865,19 @@
         "commands",
         "compile",
         "thread",
-        "delete.js"
+        "sync.js"
       ]
     },
-    "compile:thread:edit": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Edit a thread: its label, what medium it is read as, and/or which speaker is the face.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> THREAD_ID --label \"Interview\"",
-        "<%= config.bin %> <%= command.id %> THREAD_ID --medium lecture",
-        "<%= config.bin %> <%= command.id %> THREAD_ID --clear-medium"
-      ],
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6061,42 +5911,109 @@
           "type": "option"
         },
         "label": {
-          "description": "New thread label",
+          "description": "Document label/title",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "face-speaker": {
-          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
-          "name": "face-speaker",
+        "content": {
+          "description": "Inline text content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read content from file",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "medium": {
-          "description": "What this thread should be read as. What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not. This is a correction that sticks: it overrides what an imported corpus arrived as, without changing the record of what that was.",
-          "exclusive": [
-            "clear-medium"
-          ],
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
           "name": "medium",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "clear-medium": {
-          "description": "Remove a medium correction, so the thread is read as whatever it arrived as.",
-          "exclusive": [
-            "medium"
+        "perspective": {
+          "description": "Perspective (first-person or third-person)",
+          "name": "perspective",
+          "default": "first-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
           ],
-          "name": "clear-medium",
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:doc:create",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "doc",
+        "create.js"
+      ]
+    },
+    "compile:doc:delete": {
+      "aliases": [],
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Delete a document",
+      "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": "compile:thread:edit",
+      "id": "compile:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6107,20 +6024,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "edit.js"
+        "doc",
+        "delete.js"
       ]
     },
-    "compile:thread:get": {
+    "compile:doc:edit": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Get a thread by ID",
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6152,11 +6069,50 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "New label/title",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "New inline text content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read new content from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "medium": {
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "perspective": {
+          "description": "Perspective (first-person or third-person)",
+          "name": "perspective",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6167,20 +6123,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "get.js"
+        "doc",
+        "edit.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc:get": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6216,7 +6172,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:list",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6227,20 +6183,24 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "list.js"
+        "doc",
+        "get.js"
       ]
     },
-    "compile:thread:make": {
+    "compile:doc": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Compile an existing thread (prepare + sync in one step)",
+      "description": "Compile one or more documents into a face (create → make in one step). Repeat --file to submit several documents in a single command; each file becomes its own document rather than being concatenated.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --file notes.txt",
+        "<%= config.bin %> <%= command.id %> alice --file a.txt --file b.txt --file c.txt --no-wait --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6273,8 +6233,51 @@
           "multiple": false,
           "type": "option"
         },
+        "label": {
+          "description": "Document label/title (single document only; with several files each is labelled by its filename)",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "Inline text content",
+          "exclusive": [
+            "file"
+          ],
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read content from file (repeatable; each file becomes its own document)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "medium": {
+          "description": "What sort of writing this is, e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
+          "name": "medium",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "perspective": {
+          "description": "Perspective",
+          "name": "perspective",
+          "default": "first-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
+        },
         "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
+          "description": "Compile timeout in seconds, per document (default: 600)",
           "name": "timeout",
           "default": 600,
           "hasDynamicHelp": false,
@@ -6282,7 +6285,7 @@
           "type": "option"
         },
         "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
+          "description": "Create and trigger compilation, then return immediately without polling.",
           "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
@@ -6290,7 +6293,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6301,20 +6304,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "make.js"
+        "doc",
+        "index.js"
       ]
     },
-    "compile:thread:message": {
+    "compile:doc:list": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Send a user message to a thread",
+      "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.",
@@ -6347,25 +6350,16 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message to append",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "verbose": {
+          "description": "Include each document's full text",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:message",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6376,20 +6370,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "message.js"
+        "doc",
+        "list.js"
       ]
     },
-    "compile:thread:pause": {
+    "compile:doc:make": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Ask a running thread compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6422,24 +6416,24 @@
           "multiple": false,
           "type": "option"
         },
-        "no-wait": {
-          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "timeout": {
-          "description": "Seconds to wait for the compile to stop (default: 60)",
+          "description": "Compile timeout in seconds (default: 600)",
           "name": "timeout",
-          "default": 60,
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:pause",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6450,20 +6444,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "pause.js"
+        "doc",
+        "make.js"
       ]
     },
-    "compile:thread:reset": {
+    "compile:doc:pause": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
+      "description": "Ask a running document compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6496,16 +6490,24 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "no-wait": {
+          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the compile to stop (default: 60)",
+          "name": "timeout",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6516,20 +6518,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "reset.js"
+        "doc",
+        "pause.js"
       ]
     },
-    "compile:thread:sync": {
+    "compile:doc:reset": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Archive and sync a thread into a face",
+      "description": "Reset document compilation progress (wipe extraction, keep content)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6561,11 +6563,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6576,8 +6584,8 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "sync.js"
+        "doc",
+        "reset.js"
       ]
     },
     "face:tag:add": {
@@ -7157,5 +7165,5 @@
       ]
     }
   },
-  "version": "1.8.6"
+  "version": "1.8.8"
 }