faces-cli 1.8.3 → 1.8.5

package/oclif.manifest.json

@@ -4100,7 +4100,7 @@
           "required": true
         }
       },
-      "description": "Go back to the style a face had before the last style:make. A face holds one style per medium, so name which one with --medium when it has more than one. Two versions are kept per medium, so this goes back exactly one step. It changes how the face writes immediately, so it asks first.",
+      "description": "Go back to the style a face had before the last style:make. Two versions are kept per medium, so this is a toggle: running it again returns to where you started. A face holds one style per medium, so name which one with --medium when it has more than one. It changes how the face writes immediately, so it asks first.",
       "examples": [
         "<%= config.bin %> <%= command.id %> alice --yes",
         "<%= config.bin %> <%= command.id %> alice --medium email --yes"
@@ -5148,7 +5148,7 @@
         "index.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5157,7 +5157,7 @@
           "required": true
         }
       },
-      "description": "Start a new thread for a face",
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5191,22 +5191,49 @@
           "type": "option"
         },
         "label": {
-          "description": "Thread label",
+          "description": "Document label/title",
           "name": "label",
           "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"
+        "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:create",
+      "id": "compile:doc:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5217,20 +5244,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "create.js"
       ]
     },
-    "compile:thread:delete": {
+    "compile:doc:delete": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Delete a thread",
+      "description": "Delete a document",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5262,17 +5289,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:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5283,20 +5304,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "delete.js"
       ]
     },
-    "compile:thread:edit": {
+    "compile:doc:edit": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Edit a thread (label and/or reassign face speaker)",
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5330,23 +5351,48 @@
           "type": "option"
         },
         "label": {
-          "description": "New thread label",
+          "description": "New 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": "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:edit",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5357,20 +5403,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "edit.js"
       ]
     },
-    "compile:thread:get": {
+    "compile:doc:get": {
       "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": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5406,7 +5452,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5417,11 +5463,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "get.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5430,7 +5476,11 @@
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "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.",
@@ -5462,11 +5512,68 @@
           "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:thread:list",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5477,20 +5584,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "list.js"
+        "doc",
+        "index.js"
       ]
     },
-    "compile:thread:make": {
+    "compile:doc:list": {
       "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": "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.",
@@ -5523,24 +5630,16 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
-          "name": "no-wait",
+        "verbose": {
+          "description": "Include each document's full text",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5551,20 +5650,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "make.js"
+        "doc",
+        "list.js"
       ]
     },
-    "compile:thread:message": {
+    "compile:doc:make": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Send a user message to a thread",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5597,25 +5696,24 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message to append",
-          "name": "message",
-          "required": true,
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "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:message",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5626,20 +5724,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "message.js"
+        "doc",
+        "make.js"
       ]
     },
-    "compile:thread:pause": {
+    "compile:doc:pause": {
       "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": "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.",
@@ -5689,7 +5787,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:pause",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5700,20 +5798,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "pause.js"
       ]
     },
-    "compile:thread:reset": {
+    "compile:doc:reset": {
       "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": "Reset document compilation progress (wipe extraction, keep content)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5755,7 +5853,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5766,20 +5864,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "reset.js"
       ]
     },
-    "compile:thread:sync": {
+    "compile:thread:create": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Archive and sync a thread into a face",
+      "description": "Start a new thread for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5811,11 +5909,24 @@
           "hasDynamicHelp": false,
           "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",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "compile:thread:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5827,19 +5938,19 @@
         "commands",
         "compile",
         "thread",
-        "sync.js"
+        "create.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:delete": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Delete a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5872,50 +5983,16 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Document label/title",
-          "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"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:create",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5926,20 +6003,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "create.js"
+        "thread",
+        "delete.js"
       ]
     },
-    "compile:doc:delete": {
+    "compile:thread:edit": {
       "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": "Edit a thread (label and/or reassign face speaker)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5971,11 +6048,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "New thread label",
+          "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5986,20 +6077,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "delete.js"
+        "thread",
+        "edit.js"
       ]
     },
-    "compile:doc:edit": {
+    "compile:thread:get": {
       "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": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6031,50 +6122,11 @@
           "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:doc:edit",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6085,20 +6137,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "edit.js"
+        "thread",
+        "get.js"
       ]
     },
-    "compile:doc:get": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Get a document by ID",
+      "description": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6134,7 +6186,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6145,24 +6197,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "get.js"
+        "thread",
+        "list.js"
       ]
     },
-    "compile:doc": {
+    "compile:thread:make": {
       "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": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6195,51 +6243,8 @@
           "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)",
+          "description": "Compile timeout in seconds (default: 600)",
           "name": "timeout",
           "default": 600,
           "hasDynamicHelp": false,
@@ -6247,7 +6252,7 @@
           "type": "option"
         },
         "no-wait": {
-          "description": "Create and trigger compilation, then return immediately without polling.",
+          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
           "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
@@ -6255,7 +6260,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6266,20 +6271,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "index.js"
+        "thread",
+        "make.js"
       ]
     },
-    "compile:doc:list": {
+    "compile:thread:message": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "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": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6312,16 +6317,25 @@
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "description": "Include each document's full text",
-          "name": "verbose",
+        "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:list",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6332,20 +6346,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "list.js"
+        "thread",
+        "message.js"
       ]
     },
-    "compile:doc:make": {
+    "compile:thread:pause": {
       "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": "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.",
@@ -6378,24 +6392,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": "Compile timeout in seconds (default: 600)",
+          "description": "Seconds to wait for the compile to stop (default: 60)",
           "name": "timeout",
-          "default": 600,
+          "default": 60,
           "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:doc:make",
+      "id": "compile:thread:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6406,20 +6420,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "make.js"
+        "thread",
+        "pause.js"
       ]
     },
-    "compile:doc:pause": {
+    "compile:thread:reset": {
       "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": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6452,24 +6466,16 @@
           "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",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "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:pause",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6480,20 +6486,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "pause.js"
+        "thread",
+        "reset.js"
       ]
     },
-    "compile:doc:reset": {
+    "compile:thread:sync": {
       "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": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6525,17 +6531,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:reset",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6546,8 +6546,8 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "reset.js"
+        "thread",
+        "sync.js"
       ]
     },
     "face:tag:add": {
@@ -7127,5 +7127,5 @@
       ]
     }
   },
-  "version": "1.8.3"
+  "version": "1.8.5"
 }