faces-cli 1.7.8 → 1.7.10

package/oclif.manifest.json

@@ -120,23 +120,10 @@
         "state.js"
       ]
     },
-    "auth:connect": {
+    "billing:balance": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to connect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
-      "examples": [
-        "<%= config.bin %> auth connect openai",
-        "<%= config.bin %> auth connect openai --json"
-      ],
+      "args": {},
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -172,7 +159,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connect",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -182,18 +169,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connect.js"
+        "billing",
+        "balance.js"
       ]
     },
-    "auth:connections": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "List connected OAuth provider accounts",
-      "examples": [
-        "<%= config.bin %> auth connections",
-        "<%= config.bin %> auth connections --json"
-      ],
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -229,7 +212,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connections",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -239,26 +222,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connections.js"
+        "billing",
+        "card-setup.js"
       ]
     },
-    "auth:disconnect": {
+    "billing:llm-costs": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to disconnect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Disconnect a linked OAuth provider account",
-      "examples": [
-        "<%= config.bin %> auth disconnect openai"
-      ],
+      "args": {},
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -290,11 +261,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:disconnect",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -304,14 +282,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "disconnect.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "auth:login": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Login and save JWT credentials",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -344,18 +322,17 @@
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Account email",
-          "name": "email",
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "password": {
-          "description": "Account password",
-          "name": "password",
-          "required": true,
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -363,7 +340,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -373,14 +350,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "auth:logout": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Clear saved credentials",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -412,11 +389,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": "auth:logout",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -426,14 +430,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "billing",
+        "usage.js"
       ]
     },
-    "auth:refresh": {
+    "auth:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Exchange current JWT for a fresh one",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to connect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
+      "examples": [
+        "<%= config.bin %> auth connect openai",
+        "<%= config.bin %> auth connect openai --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -469,7 +486,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:refresh",
+      "id": "auth:connect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -480,13 +497,17 @@
         "dist",
         "commands",
         "auth",
-        "refresh.js"
+        "connect.js"
       ]
     },
-    "auth:register": {
+    "auth:connections": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Faces account",
+      "description": "List connected OAuth provider accounts",
+      "examples": [
+        "<%= config.bin %> auth connections",
+        "<%= config.bin %> auth connections --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -518,54 +539,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "email": {
-          "description": "Email address",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "username": {
-          "description": "Username (lowercase, dashes, numbers)",
-          "name": "username",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "invite-key": {
-          "description": "Invite key (if required)",
-          "name": "invite-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "plan": {
-          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
-          "name": "plan",
-          "default": "free",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "free",
-            "connect"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:register",
+      "id": "auth:connections",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -576,13 +554,25 @@
         "dist",
         "commands",
         "auth",
-        "register.js"
+        "connections.js"
       ]
     },
-    "auth:whoami": {
+    "auth:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "Print current user profile and auth diagnostic",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to disconnect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Disconnect a linked OAuth provider account",
+      "examples": [
+        "<%= config.bin %> auth disconnect openai"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -618,7 +608,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:disconnect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -629,13 +619,13 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "disconnect.js"
       ]
     },
-    "catalog:backup": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "description": "Login and save JWT credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -667,11 +657,27 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "email": {
+          "description": "Account email",
+          "name": "email",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Account password",
+          "name": "password",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:backup",
+      "id": "auth:login",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -681,14 +687,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "auth",
+        "login.js"
       ]
     },
-    "catalog:doctor": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Clear saved credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -720,23 +726,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": "auth:logout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -746,14 +740,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "catalog:list": {
+    "auth:refresh": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "Exchange current JWT for a fresh one",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -789,7 +783,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "auth:refresh",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -799,14 +793,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "auth",
+        "refresh.js"
       ]
     },
-    "catalog:manyfaced": {
+    "auth:register": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Create a new Faces account",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -839,37 +833,53 @@
           "multiple": false,
           "type": "option"
         },
-        "skill": {
-          "description": "Show details for a specific skill",
-          "name": "skill",
+        "email": {
+          "description": "Email address",
+          "name": "email",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "install": {
-          "description": "Install a skill by name",
-          "name": "install",
+        "password": {
+          "description": "Password",
+          "name": "password",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
+        "username": {
+          "description": "Username (lowercase, dashes, numbers)",
+          "name": "username",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "refresh": {
-          "description": "Force refresh the skill index (ignore cache)",
-          "name": "refresh",
-          "allowNo": false,
-          "type": "boolean"
+        "invite-key": {
+          "description": "Invite key (if required)",
+          "name": "invite-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plan": {
+          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
+          "name": "plan",
+          "default": "free",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "free",
+            "connect"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:manyfaced",
+      "id": "auth:register",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -879,19 +889,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "auth",
+        "register.js"
       ]
     },
-    "catalog:restore": {
+    "auth:whoami": {
       "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": "Print current user profile and auth diagnostic",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -923,17 +928,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": "auth:whoami",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -943,14 +942,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "auth",
+        "whoami.js"
       ]
     },
-    "billing:balance": {
+    "catalog:backup": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Snapshot all faces, teams, and source material for migration",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -986,7 +985,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -996,14 +995,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "catalog",
+        "backup.js"
       ]
     },
-    "billing:card-setup": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "Diagnose and repair the local face and team catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1035,11 +1034,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1049,14 +1060,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "billing:llm-costs": {
+    "catalog:list": {
       "aliases": [],
       "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1088,18 +1099,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1109,14 +1113,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "billing:topup": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1149,25 +1153,37 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
-          "required": true,
+        "skill": {
+          "description": "Show details for a specific skill",
+          "name": "skill",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "install": {
+          "description": "Install a skill by name",
+          "name": "install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skills-dir": {
+          "description": "Directory to install skills into (required for --install)",
+          "name": "skills-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh": {
+          "description": "Force refresh the skill index (ignore cache)",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1177,14 +1193,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "topup.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "billing:usage": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Aggregated usage analytics",
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces, teams, and source material from a backup snapshot",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1217,37 +1238,16 @@
           "multiple": false,
           "type": "option"
         },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
-          ],
-          "type": "option"
-        },
-        "from": {
-          "description": "Start date (YYYY-MM-DD)",
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "to": {
-          "description": "End date (YYYY-MM-DD)",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1257,8 +1257,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "catalog",
+        "restore.js"
       ]
     },
     "chat:chat": {
@@ -1949,7 +1949,7 @@
           "required": true
         }
       },
-      "description": "Upload a file (text/PDF/audio/video) to compile into a face",
+      "description": "Upload a file (text/PDF/Word .docx/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4185,7 +4185,7 @@
         "index.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -4194,7 +4194,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.",
@@ -4228,22 +4228,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"
-        }
-      },
-      "hasDynamicHelp": false,
+        "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",
@@ -4254,20 +4274,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.",
@@ -4299,17 +4319,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",
@@ -4320,20 +4334,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.",
@@ -4367,23 +4381,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",
@@ -4394,20 +4426,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.",
@@ -4443,7 +4475,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4454,11 +4486,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "get.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -4467,7 +4499,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.",
@@ -4499,11 +4535,61 @@
           "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"
+        },
+        "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",
@@ -4514,20 +4600,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",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4559,25 +4645,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 thread ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4588,20 +4660,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.",
@@ -4634,25 +4706,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",
@@ -4663,20 +4734,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.",
@@ -4726,7 +4797,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:pause",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4737,20 +4808,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.",
@@ -4792,7 +4863,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:reset",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4803,20 +4874,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.",
@@ -4848,11 +4919,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",
@@ -4864,19 +4948,19 @@
         "commands",
         "compile",
         "thread",
-        "sync.js"
+        "create.js"
       ]
     },
-    "face:tag:add": {
+    "compile:thread:delete": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Add tags to a face (appends, idempotent)",
+      "description": "Delete a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4909,18 +4993,16 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to add (repeatable)",
-          "name": "tag",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:add",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4930,15 +5012,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "add.js"
+        "compile",
+        "thread",
+        "delete.js"
       ]
     },
-    "face:tag:all": {
+    "compile:thread:edit": {
       "aliases": [],
-      "args": {},
-      "description": "List all tags across all your faces",
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Edit a thread (label and/or reassign face speaker)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4970,11 +5058,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": "face:tag:all",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4984,21 +5086,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "all.js"
+        "compile",
+        "thread",
+        "edit.js"
       ]
     },
-    "face:tag:list": {
+    "compile:thread:get": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "List tags on a face",
+      "description": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5034,7 +5136,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:list",
+      "id": "compile:thread:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5044,26 +5146,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "list.js"
+        "compile",
+        "thread",
+        "get.js"
       ]
     },
-    "face:tag:remove": {
+    "compile:thread:list": {
       "aliases": [],
       "args": {
-        "alias": {
+        "face_id": {
           "description": "Face alias",
-          "name": "alias",
-          "required": true
-        },
-        "tag": {
-          "description": "Tag to remove",
-          "name": "tag",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Remove a tag from a face",
+      "description": "List threads for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5099,7 +5196,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:remove",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5109,21 +5206,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "remove.js"
+        "compile",
+        "thread",
+        "list.js"
       ]
     },
-    "face:tag:set": {
+    "compile:thread:make": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Replace all tags on a face",
+      "description": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5156,18 +5253,24 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to set (repeatable, replaces all)",
-          "name": "tag",
-          "required": true,
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:tag:set",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5177,21 +5280,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "tag",
-        "set.js"
+        "compile",
+        "thread",
+        "make.js"
       ]
     },
-    "team:tag:add": {
+    "compile:thread:message": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Add tags to a team (appends, idempotent)",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5224,18 +5327,25 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag to add (repeatable)",
-          "name": "tag",
+        "message": {
+          "char": "m",
+          "description": "User message to append",
+          "name": "message",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "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": "team:tag:add",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5245,21 +5355,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "add.js"
+        "compile",
+        "thread",
+        "message.js"
       ]
     },
-    "team:tag:list": {
+    "compile:thread:pause": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "List tags on a team",
+      "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.",
@@ -5291,11 +5401,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the compile to stop (default: 60)",
+          "name": "timeout",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:list",
+      "id": "compile:thread:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5305,26 +5429,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "list.js"
+        "compile",
+        "thread",
+        "pause.js"
       ]
     },
-    "team:tag:remove": {
+    "compile:thread:reset": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
-          "required": true
-        },
-        "tag": {
-          "description": "Tag to remove",
-          "name": "tag",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Remove a tag from a team",
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5356,11 +5475,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:remove",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5370,21 +5495,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "remove.js"
+        "compile",
+        "thread",
+        "reset.js"
       ]
     },
-    "team:tag:set": {
+    "compile:thread:sync": {
       "aliases": [],
       "args": {
-        "team_id": {
-          "description": "Team ID",
-          "name": "team_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Replace all tags on a team",
+      "description": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5416,19 +5541,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "tag": {
-          "description": "Tag to set (repeatable, replaces all)",
-          "name": "tag",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "team:tag:set",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5438,21 +5555,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "team",
-        "tag",
-        "set.js"
+        "compile",
+        "thread",
+        "sync.js"
       ]
     },
-    "compile:doc:create": {
+    "face:tag:add": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Add tags to a face (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5485,43 +5602,18 @@
           "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 (first-person or third-person)",
-          "name": "perspective",
-          "default": "first-person",
+        "tag": {
+          "description": "Tag to add (repeatable)",
+          "name": "tag",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:create",
+      "id": "face:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5531,21 +5623,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "create.js"
+        "face",
+        "tag",
+        "add.js"
       ]
     },
-    "compile:doc:delete": {
+    "face:tag:all": {
       "aliases": [],
-      "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
-          "required": true
-        }
-      },
-      "description": "Delete a document",
+      "args": {},
+      "description": "List all tags across all your faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5581,7 +5667,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "face:tag:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5591,21 +5677,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "delete.js"
+        "face",
+        "tag",
+        "all.js"
       ]
     },
-    "compile:doc:edit": {
+    "face:tag:list": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Edit a document (label, content, or perspective)",
+      "description": "List tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5637,43 +5723,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": "face:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5683,21 +5737,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "edit.js"
+        "face",
+        "tag",
+        "list.js"
       ]
     },
-    "compile:doc:get": {
+    "face:tag:remove": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        },
+        "tag": {
+          "description": "Tag to remove",
+          "name": "tag",
           "required": true
         }
       },
-      "description": "Get a document by ID",
+      "description": "Remove a tag from a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5733,7 +5792,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "face:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5743,21 +5802,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "get.js"
+        "face",
+        "tag",
+        "remove.js"
       ]
     },
-    "compile:doc": {
+    "face:tag:set": {
       "aliases": [],
       "args": {
-        "face_id": {
+        "alias": {
           "description": "Face alias",
-          "name": "face_id",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Compile a document into a face (create → make in one step)",
+      "description": "Replace all tags on a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5790,57 +5849,18 @@
           "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",
-          "default": 600,
+        "tag": {
+          "description": "Tag to set (repeatable, replaces all)",
+          "name": "tag",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
-        },
-        "no-wait": {
-          "description": "Create and trigger compilation, then return immediately without polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc",
+      "id": "face:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5850,21 +5870,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "index.js"
+        "face",
+        "tag",
+        "set.js"
       ]
     },
-    "compile:doc:list": {
+    "team:tag:add": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "List documents for a face",
+      "description": "Add tags to a team (appends, idempotent)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5896,11 +5916,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Tag to add (repeatable)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "team:tag:add",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5910,21 +5938,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "list.js"
+        "team",
+        "tag",
+        "add.js"
       ]
     },
-    "compile:doc:make": {
+    "team:tag:list": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Compile an existing document (prepare + sync in one step)",
+      "description": "List tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -5956,25 +5984,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": "team:tag:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -5984,21 +5998,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "make.js"
+        "team",
+        "tag",
+        "list.js"
       ]
     },
-    "compile:doc:pause": {
+    "team:tag:remove": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
+          "required": true
+        },
+        "tag": {
+          "description": "Tag to remove",
+          "name": "tag",
           "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": "Remove a tag from a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6030,25 +6049,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-wait": {
-          "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the compile to stop (default: 60)",
-          "name": "timeout",
-          "default": 60,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:pause",
+      "id": "team:tag:remove",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6058,21 +6063,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "pause.js"
+        "team",
+        "tag",
+        "remove.js"
       ]
     },
-    "compile:doc:reset": {
+    "team:tag:set": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "team_id": {
+          "description": "Team ID",
+          "name": "team_id",
           "required": true
         }
       },
-      "description": "Reset document compilation progress (wipe extraction, keep content)",
+      "description": "Replace all tags on a team",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -6105,16 +6110,18 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "tag": {
+          "description": "Tag to set (repeatable, replaces all)",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:reset",
+      "id": "team:tag:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -6124,11 +6131,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "doc",
-        "reset.js"
+        "team",
+        "tag",
+        "set.js"
       ]
     }
   },
-  "version": "1.7.8"
+  "version": "1.7.10"
 }