faces-cli 1.7.2 → 1.7.4

package/oclif.manifest.json

@@ -632,10 +632,10 @@
         "whoami.js"
       ]
     },
-    "catalog:backup": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -671,7 +671,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:backup",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -681,14 +681,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "catalog:doctor": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -720,23 +720,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "fix": {
-          "description": "Rebuild missing or stale catalog entries from API",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "generate": {
-          "description": "Fix + generate missing descriptions via LLM",
-          "name": "generate",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:doctor",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -746,14 +734,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "catalog:list": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -785,11 +773,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -799,14 +794,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "catalog:manyfaced": {
+    "billing:quota": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Show compilation stats per face (deprecated — use compile:stats)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -838,38 +833,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "skill": {
-          "description": "Show details for a specific skill",
-          "name": "skill",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "install": {
-          "description": "Install a skill by name",
-          "name": "install",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "refresh": {
-          "description": "Force refresh the skill index (ignore cache)",
-          "name": "refresh",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:manyfaced",
+      "id": "billing:quota",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -879,19 +847,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "billing",
+        "quota.js"
       ]
     },
-    "catalog:restore": {
+    "billing:subscription": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
-          "name": "file"
-        }
-      },
-      "description": "Restore faces, teams, and source material from a backup snapshot",
+      "args": {},
+      "description": "Show current plan, face count, and renewal date",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -923,17 +886,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "compile": {
-          "description": "Run compile:all after restoring",
-          "name": "compile",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:restore",
+      "id": "billing:subscription",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -943,14 +900,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "billing",
+        "subscription.js"
       ]
     },
-    "billing:balance": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -982,11 +939,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -997,13 +969,13 @@
         "dist",
         "commands",
         "billing",
-        "balance.js"
+        "topup.js"
       ]
     },
-    "billing:card-setup": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1035,11 +1007,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
+          "type": "option"
+        },
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1050,13 +1049,13 @@
         "dist",
         "commands",
         "billing",
-        "card-setup.js"
+        "usage.js"
       ]
     },
-    "billing:llm-costs": {
+    "catalog:backup": {
       "aliases": [],
       "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "description": "Snapshot all faces, teams, and source material for migration",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1088,18 +1087,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1109,14 +1101,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "catalog",
+        "backup.js"
       ]
     },
-    "billing:quota": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Show compilation stats per face (deprecated — use compile:stats)",
+      "description": "Diagnose and repair the local face and team catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1148,11 +1140,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:quota",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1162,14 +1166,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "quota.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "billing:subscription": {
+    "catalog:list": {
       "aliases": [],
       "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1205,7 +1209,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1215,14 +1219,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "billing:topup": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1255,25 +1259,37 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
-          "required": true,
+        "skill": {
+          "description": "Show details for a specific skill",
+          "name": "skill",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "install": {
+          "description": "Install a skill by name",
+          "name": "install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skills-dir": {
+          "description": "Directory to install skills into (required for --install)",
+          "name": "skills-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh": {
+          "description": "Force refresh the skill index (ignore cache)",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1283,14 +1299,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "billing:usage": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Aggregated usage analytics",
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces, teams, and source material from a backup snapshot",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1323,37 +1344,16 @@
           "multiple": false,
           "type": "option"
         },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
-          ],
-          "type": "option"
-        },
-        "from": {
-          "description": "Start date (YYYY-MM-DD)",
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "to": {
-          "description": "End date (YYYY-MM-DD)",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1363,8 +1363,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "catalog",
+        "restore.js"
       ]
     },
     "chat:chat": {
@@ -1431,7 +1431,7 @@
           "type": "option"
         },
         "formula": {
-          "description": "Compose a run-time composite from your own faces, e.g. \"socrates | nietzsche\" (operators: | & ^ -). Requires --llm.",
+          "description": "Compose a run-time composite from your own faces, e.g. \"socrates | nietzsche\" (operators: | & ^ -). Requires --llm. The composite takes the name of its first operand; use face:create --formula for a named, persisted composite.",
           "name": "formula",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1828,182 +1828,6 @@
         "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": {},
@@ -2326,10 +2150,10 @@
         "upload.js"
       ]
     },
-    "keys:create": {
+    "config:clear": {
       "aliases": [],
       "args": {},
-      "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2362,105 +2186,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,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "keys:create",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "keys",
-        "create.js"
-      ]
-    },
-    "keys:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all API keys (JWT required)",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2470,20 +2205,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "list.js"
+        "config",
+        "clear.js"
       ]
     },
-    "keys:revoke": {
+    "config:set": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "Set a config value (e.g. base_url, api_key, token)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2515,17 +2255,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2535,20 +2269,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "config",
+        "set.js"
       ]
     },
-    "keys:update": {
+    "config:show": {
       "aliases": [],
-      "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
-          "required": true
-        }
-      },
-      "description": "Update API key metadata (JWT required)",
+      "args": {},
+      "description": "Print current config (credentials are masked)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2580,31 +2308,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "New key name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "config:show",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2614,8 +2322,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "config",
+        "show.js"
       ]
     },
     "face:attributes": {
@@ -2764,6 +2472,23 @@
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "profile-addendum": {
+          "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
+          "name": "profile-addendum",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile-addendum-file": {
+          "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
+          "exclusive": [
+            "profile-addendum"
+          ],
+          "name": "profile-addendum-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -2998,6 +2723,33 @@
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "profile-addendum": {
+          "description": "Replace the per-face system prompt (max 100,000 chars).",
+          "name": "profile-addendum",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile-addendum-file": {
+          "description": "Replace the per-face system prompt from a file.",
+          "exclusive": [
+            "profile-addendum"
+          ],
+          "name": "profile-addendum-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "clear-profile-addendum": {
+          "description": "Remove the per-face system prompt.",
+          "exclusive": [
+            "profile-addendum",
+            "profile-addendum-file"
+          ],
+          "name": "clear-profile-addendum",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -3064,6 +2816,12 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "full": {
+          "description": "Print the full profile_addendum instead of a truncated preview",
+          "name": "full",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -3493,16 +3251,10 @@
         "upload.js"
       ]
     },
-    "team:add": {
+    "keys:create": {
       "aliases": [],
-      "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        }
-      },
-      "description": "Add face(s) to a team",
+      "args": {},
+      "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3535,18 +3287,52 @@
           "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": "Face alias to add (repeatable)",
+          "description": "Allowed face alias (repeatable)",
           "name": "face",
-          "required": true,
           "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": "team:add",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3556,14 +3342,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "add.js"
+        "keys",
+        "create.js"
       ]
     },
-    "team:create": {
+    "keys:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new team",
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3595,47 +3381,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "Team name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Plain-text team description (max 1500 chars)",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol": {
-          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
-          "name": "protocol",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol-file": {
-          "description": "Read protocol from file",
-          "name": "protocol-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:create",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3645,20 +3395,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "create.js"
+        "keys",
+        "list.js"
       ]
     },
-    "team:delete": {
+    "keys:revoke": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Delete a team",
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3700,7 +3450,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:delete",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3710,20 +3460,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "delete.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "team:edit": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Edit a team",
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3757,37 +3507,29 @@
           "type": "option"
         },
         "name": {
-          "description": "New team name",
+          "description": "New key name",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "New description (max 1500 chars)",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol": {
-          "description": "New protocol content",
-          "name": "protocol",
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "protocol-file": {
-          "description": "Read protocol from file",
-          "name": "protocol-file",
-          "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": "team:edit",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3797,11 +3539,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "edit.js"
+        "keys",
+        "update.js"
       ]
     },
-    "team:get": {
+    "team:add": {
       "aliases": [],
       "args": {
         "team_id": {
@@ -3810,7 +3552,7 @@
           "required": true
         }
       },
-      "description": "Get a team by ID",
+      "description": "Add face(s) to a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3842,11 +3584,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "face": {
+          "description": "Face alias to add (repeatable)",
+          "name": "face",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:get",
+      "id": "team:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3857,13 +3607,13 @@
         "dist",
         "commands",
         "team",
-        "get.js"
+        "add.js"
       ]
     },
-    "team:list": {
+    "team:create": {
       "aliases": [],
       "args": {},
-      "description": "List your teams",
+      "description": "Create a new team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3895,11 +3645,47 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Team name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Plain-text team description (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol": {
+          "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
+          "name": "protocol",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:list",
+      "id": "team:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3910,10 +3696,10 @@
         "dist",
         "commands",
         "team",
-        "list.js"
+        "create.js"
       ]
     },
-    "team:members": {
+    "team:delete": {
       "aliases": [],
       "args": {
         "team_id": {
@@ -3922,7 +3708,7 @@
           "required": true
         }
       },
-      "description": "List members of a team",
+      "description": "Delete a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3954,11 +3740,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:members",
+      "id": "team:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3969,24 +3761,19 @@
         "dist",
         "commands",
         "team",
-        "members.js"
+        "delete.js"
       ]
     },
-    "team:remove": {
+    "team:edit": {
       "aliases": [],
       "args": {
         "team_id": {
           "description": "Team ID",
           "name": "team_id",
           "required": true
-        },
-        "alias": {
-          "description": "Face alias to remove",
-          "name": "alias",
-          "required": true
         }
       },
-      "description": "Remove a face from a team",
+      "description": "Edit a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4018,11 +3805,39 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "New team name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "New description (max 1500 chars)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol": {
+          "description": "New protocol content",
+          "name": "protocol",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "protocol-file": {
+          "description": "Read protocol from file",
+          "name": "protocol-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:remove",
+      "id": "team:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4033,13 +3848,19 @@
         "dist",
         "commands",
         "team",
-        "remove.js"
+        "edit.js"
       ]
     },
-    "billing:subscription:activate": {
+    "team:get": {
       "aliases": [],
-      "args": {},
-      "description": "Activate or reactivate a subscription plan",
+      "args": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        }
+      },
+      "description": "Get a team by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4071,22 +3892,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "plan": {
-          "description": "Plan to activate",
-          "name": "plan",
-          "default": "connect",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "connect"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription:activate",
+      "id": "team:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4096,15 +3906,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription",
-        "activate.js"
+        "team",
+        "get.js"
       ]
     },
-    "billing:subscription:cancel": {
+    "team:list": {
       "aliases": [],
       "args": {},
-      "description": "Cancel your subscription (keeps access until period end)",
+      "description": "List your teams",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4136,17 +3945,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription:cancel",
+      "id": "team:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4156,21 +3959,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription",
-        "cancel.js"
+        "team",
+        "list.js"
       ]
     },
-    "compile:doc:create": {
+    "team:members": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "List members of a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4202,44 +4004,272 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "team:members",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "team",
+        "members.js"
+      ]
+    },
+    "team:remove": {
+      "aliases": [],
+      "args": {
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
         },
-        "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"
-        },
-        "perspective": {
-          "description": "Perspective (first-person or third-person)",
-          "name": "perspective",
-          "default": "first-person",
+        "alias": {
+          "description": "Face alias to remove",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Remove a face from a team",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "team:remove",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "team",
+        "remove.js"
+      ]
+    },
+    "billing:subscription:activate": {
+      "aliases": [],
+      "args": {},
+      "description": "Activate or reactivate a subscription plan",
+      "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"
+        },
+        "plan": {
+          "description": "Plan to activate",
+          "name": "plan",
+          "default": "connect",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "first-person",
-            "third-person"
+            "connect"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:create",
+      "id": "billing:subscription:activate",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "subscription",
+        "activate.js"
+      ]
+    },
+    "billing:subscription:cancel": {
+      "aliases": [],
+      "args": {},
+      "description": "Cancel your subscription (keeps access until period end)",
+      "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": "billing:subscription:cancel",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "subscription",
+        "cancel.js"
+      ]
+    },
+    "compile:thread:create": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Start a new thread for a face",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4250,20 +4280,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.",
@@ -4295,11 +4325,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",
@@ -4310,20 +4346,94 @@
         "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 (label and/or reassign face speaker)",
+      "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"
+        },
+        "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:thread:edit",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "edit.js"
+      ]
+    },
+    "compile:thread:get": {
+      "aliases": [],
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4355,43 +4465,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"
-        },
-        "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",
@@ -4402,20 +4480,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.",
@@ -4451,7 +4529,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4462,20 +4540,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 a document into a face (create → make in one step)",
+      "description": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4508,39 +4586,6 @@
           "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"
-        },
-        "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)",
           "name": "timeout",
@@ -4550,7 +4595,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"
@@ -4558,7 +4603,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4569,20 +4614,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",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4614,11 +4659,26 @@
           "hasDynamicHelp": false,
           "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",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4629,20 +4689,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": "Pause a running thread compilation (preserves progress, resume with make)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4674,25 +4734,11 @@
           "hasDynamicHelp": false,
           "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 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",
@@ -4703,20 +4749,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": "Pause a running document compilation (preserves progress, resume with make)",
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4748,11 +4794,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:pause",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4763,20 +4815,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.",
@@ -4808,17 +4860,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",
@@ -4829,11 +4875,11 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "reset.js"
+        "thread",
+        "sync.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -4842,7 +4888,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.",
@@ -4876,22 +4922,42 @@
           "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"
+        },
+        "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",
@@ -4902,20 +4968,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "create.js"
       ]
     },
-    "compile:thread:delete": {
+    "compile:doc:delete": {
       "aliases": [],
-      "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+      "args": {
+        "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.",
@@ -4947,17 +5013,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",
@@ -4968,20 +5028,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.",
@@ -5015,23 +5075,41 @@
           "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"
+        },
+        "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",
@@ -5042,20 +5120,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.",
@@ -5091,7 +5169,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5102,11 +5180,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "get.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -5115,7 +5193,7 @@
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "Compile a document into a face (create → make in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5147,65 +5225,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "compile:thread:list",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "compile",
-        "thread",
-        "list.js"
-      ]
-    },
-    "compile:thread:make": {
-      "aliases": [],
-      "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
-          "required": true
-        }
-      },
-      "description": "Compile an existing thread (prepare + sync in one step)",
-      "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",
+        "label": {
+          "description": "Document label/title",
+          "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "content": {
+          "description": "Inline text content",
+          "name": "content",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "file": {
+          "description": "Read content from file",
+          "name": "file",
+          "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": {
@@ -5217,7 +5268,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"
@@ -5225,7 +5276,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5236,20 +5287,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",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5281,26 +5332,11 @@
           "hasDynamicHelp": false,
           "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",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:message",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5311,20 +5347,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": "Pause a running thread compilation (preserves progress, resume with make)",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5356,11 +5392,25 @@
           "hasDynamicHelp": false,
           "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 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",
@@ -5371,20 +5421,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": "Pause a running document compilation (preserves progress, resume with make)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5416,17 +5466,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5437,20 +5481,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.",
@@ -5482,11 +5526,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",
@@ -5497,8 +5547,8 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "sync.js"
+        "doc",
+        "reset.js"
       ]
     },
     "face:tag:add": {
@@ -6078,5 +6128,5 @@
       ]
     }
   },
-  "version": "1.7.2"
+  "version": "1.7.4"
 }