faces-cli 1.7.5 → 1.7.6

package/oclif.manifest.json

@@ -632,10 +632,10 @@
         "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.",
@@ -671,7 +671,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -681,14 +681,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.",
@@ -720,11 +720,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",
@@ -734,14 +746,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.",
@@ -773,18 +785,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",
@@ -794,14 +799,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "billing:quota": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Show compilation stats per face (deprecated — use compile:stats)",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -833,11 +838,38 @@
           "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": "billing:quota",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -847,14 +879,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "quota.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "billing:subscription": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "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.",
@@ -886,11 +923,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -900,14 +943,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "subscription.js"
+        "catalog",
+        "restore.js"
       ]
     },
-    "billing:topup": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -939,26 +982,11 @@
           "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:topup",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -969,13 +997,13 @@
         "dist",
         "commands",
         "billing",
-        "topup.js"
+        "balance.js"
       ]
     },
-    "billing:usage": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1007,38 +1035,11 @@
           "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:usage",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1049,13 +1050,13 @@
         "dist",
         "commands",
         "billing",
-        "usage.js"
+        "card-setup.js"
       ]
     },
-    "catalog:backup": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1087,11 +1088,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:backup",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1101,14 +1109,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "catalog:doctor": {
+    "billing:quota": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Show compilation stats per face (deprecated — use compile:stats)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1140,23 +1148,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:quota",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1166,14 +1162,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "billing",
+        "quota.js"
       ]
     },
-    "catalog:list": {
+    "billing:subscription": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "Show current plan, face count, and renewal date",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1209,7 +1205,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "billing:subscription",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1219,14 +1215,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "billing",
+        "subscription.js"
       ]
     },
-    "catalog:manyfaced": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1259,37 +1255,25 @@
           "multiple": false,
           "type": "option"
         },
-        "skill": {
-          "description": "Show details for a specific skill",
-          "name": "skill",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "install": {
-          "description": "Install a skill by name",
-          "name": "install",
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "refresh": {
-          "description": "Force refresh the skill index (ignore cache)",
-          "name": "refresh",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:manyfaced",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1299,19 +1283,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "catalog:restore": {
+    "billing:usage": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
-          "name": "file"
-        }
-      },
-      "description": "Restore faces, teams, and source material from a backup snapshot",
+      "args": {},
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1344,16 +1323,37 @@
           "multiple": false,
           "type": "option"
         },
-        "compile": {
-          "description": "Run compile:all after restoring",
-          "name": "compile",
-          "allowNo": false,
-          "type": "boolean"
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
+          "type": "option"
+        },
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:restore",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1363,8 +1363,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "billing",
+        "usage.js"
       ]
     },
     "chat:chat": {
@@ -3161,19 +3161,10 @@
         "remove.js"
       ]
     },
-    "voiceprint:build-status": {
+    "face:attributes": {
       "aliases": [],
-      "args": {
-        "job_id": {
-          "description": "Build job id",
-          "name": "job_id",
-          "required": true
-        }
-      },
-      "description": "Get the status/result of a voiceprint build job (from voiceprint:build without --wait)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "args": {},
+      "description": "List all supported attribute keys",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3209,7 +3200,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:build-status",
+      "id": "face:attributes",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3219,24 +3210,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "build-status.js"
+        "face",
+        "attributes.js"
       ]
     },
-    "voiceprint:build": {
+    "face:create": {
       "aliases": [],
-      "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
-          "required": true
-        }
-      },
-      "description": "Build a self face's voice map from its uploaded corpus. Auto-creates the hidden <self>-voiceprint face and installs the map. Async — use --wait to block.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --wait",
-        "<%= config.bin %> <%= command.id %> alice --holdout-count 120 --oauth-only --wait"
-      ],
+      "args": {},
+      "description": "Create a new face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3269,43 +3250,85 @@
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model that forges the voice map (default: gpt-5.4)",
-          "name": "model",
+        "name": {
+          "description": "Display name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "holdout-count": {
-          "description": "Stratified scoring holdout size (default: 120)",
-          "name": "holdout-count",
+        "alias": {
+          "description": "Unique alias slug",
+          "name": "alias",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "min-valid": {
-          "description": "Corpus floor below which no holdout is split — train on all (default: 550)",
-          "name": "min-valid",
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Only run on a free (OAuth) route; never fall back to billed inference",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
+        "tag": {
+          "description": "Tag label (repeatable, lowercase)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         },
-        "wait": {
-          "description": "Block and poll until the build finishes (default: print the job_id and return)",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "formula": {
+          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
+          "name": "formula",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attr": {
+          "description": "Attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool name to enable (repeatable)",
+          "name": "tool",
+          "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,
       "hiddenAliases": [],
-      "id": "voiceprint:build",
+      "id": "face:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3315,23 +3338,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "build.js"
+        "face",
+        "create.js"
       ]
     },
-    "voiceprint:get": {
+    "face:delete": {
       "aliases": [],
       "args": {
-        "job_id": {
-          "description": "Scoring job id (from voiceprint:score --no-wait)",
-          "name": "job_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Get the status/result of a voiceprint scoring job started with voiceprint:score --no-wait",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "description": "Delete a face permanently",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3363,11 +3383,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:get",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3377,23 +3403,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "get.js"
+        "face",
+        "delete.js"
       ]
     },
-    "voiceprint:refine-status": {
+    "face:diff": {
       "aliases": [],
-      "args": {
-        "job_id": {
-          "description": "Refine job id",
-          "name": "job_id",
-          "required": true
-        }
-      },
-      "description": "Get the status/result of a voiceprint refine job (from voiceprint:refine without --wait)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "args": {},
+      "description": "Compare owned faces pairwise across all centroid components",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3425,11 +3442,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "face": {
+          "description": "Face alias to include (repeatable, min 2)",
+          "name": "face",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:refine-status",
+      "id": "face:diff",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3439,24 +3464,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "refine-status.js"
+        "face",
+        "diff.js"
       ]
     },
-    "voiceprint:refine": {
+    "face:edit": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Tune the active version's post-processing recipe and promote it only if it beats the current one. Requires an existing build with a holdout ≥ 20. Undo with voiceprint:revert.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice --wait",
-        "<%= config.bin %> <%= command.id %> alice --temperature 0.4 --n-samples 6 --wait"
-      ],
+      "description": "Edit a face's metadata",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3489,43 +3510,86 @@
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model used to forge candidate drafts (default: the active version's build model)",
-          "name": "model",
+        "name": {
+          "description": "New display name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "temperature": {
-          "description": "Sampling temperature for candidate drafts (default: 0.4)",
-          "name": "temperature",
+        "description": {
+          "description": "Plain-text description / bio (max 1500 chars)",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "n-samples": {
-          "description": "Drafts forged per holdout pair (default: 6)",
-          "name": "n-samples",
+        "tag": {
+          "description": "Replace all tags (repeatable, lowercase)",
+          "name": "tag",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Only run on a free (OAuth) route; never fall back to billed inference",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "wait": {
-          "description": "Block and poll until refine finishes (default: print the job_id and return)",
-          "name": "wait",
+        "formula": {
+          "description": "New boolean formula (synthetic faces only)",
+          "name": "formula",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attr": {
+          "description": "Update attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool names to set (replaces list, repeatable)",
+          "name": "tool",
+          "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,
       "hiddenAliases": [],
-      "id": "voiceprint:refine",
+      "id": "face:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3535,23 +3599,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "refine.js"
+        "face",
+        "edit.js"
       ]
     },
-    "voiceprint:revert": {
+    "face:get": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Revert a self face's voice map to its prior version (one-deep undo; re-running toggles back). Only changes which stored recipe/baseline is active — the map text is frozen.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice"
-      ],
+      "description": "Get details for a face by alias",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3583,11 +3644,24 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
+          "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,
       "hiddenAliases": [],
-      "id": "voiceprint:revert",
+      "id": "face:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3597,23 +3671,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "revert.js"
+        "face",
+        "get.js"
       ]
     },
-    "voiceprint:score-status": {
+    "face:list": {
       "aliases": [],
-      "args": {
-        "job_id": {
-          "description": "Scoring job id",
-          "name": "job_id",
-          "required": true
-        }
-      },
-      "description": "Get the status/result of a voiceprint scoring job (from voiceprint:score without --wait)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
-      ],
+      "args": {},
+      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3645,11 +3710,58 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tag": {
+          "description": "Filter by tag (repeatable, AND logic)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "team": {
+          "description": "Filter by team ID (repeatable, OR logic)",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "include": {
+          "description": "Include extra fields: tags, teams (comma-separated)",
+          "name": "include",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "public": {
+          "description": "Include published faces from other accounts",
+          "name": "public",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "system": {
+          "description": "Show only the curated system faces (published faces owned by 'head')",
+          "name": "system",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "from-users": {
+          "description": "Only published faces from these owners (repeatable/comma-separated)",
+          "name": "from-users",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "not-from-users": {
+          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
+          "name": "not-from-users",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:score-status",
+      "id": "face:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3659,24 +3771,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "score-status.js"
+        "face",
+        "list.js"
       ]
     },
-    "voiceprint:score": {
+    "face:lock": {
       "aliases": [],
       "args": {
-        "face": {
-          "description": "Face to score (alias, owner:alias, or a union like \"(alice-voiceprint | alice)\")",
-          "name": "face",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Score how closely a face writes like a specific person. Returns VCI (closeness, 0–100) and VFI (voice captured vs a generic baseline, 0–100). Deterministic — ideal for before/after tuning.",
+      "description": "Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> \"(alice-voiceprint | alice)\" --emails ./sent.jsonl --wait",
-        "<%= config.bin %> <%= command.id %> alice --emails-dir ./sent-emails/ --wait",
-        "<%= config.bin %> <%= command.id %> alice --emails ./sent.json   # prints job_id; poll with voiceprint:score-status"
+        "<%= config.bin %> <%= command.id %> socrates"
       ],
       "flags": {
         "json": {
@@ -3709,55 +3819,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "emails": {
-          "description": "JSON or JSONL file of the person's real writing — {id?, text} objects or plain strings (provide at least 20)",
-          "name": "emails",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "emails-dir": {
-          "description": "Directory with one sample per file (id = filename). Alternative to --emails.",
-          "exclusive": [
-            "emails"
-          ],
-          "name": "emails-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "author-corpus": {
-          "description": "Optional larger reference of the person's writing (JSON/JSONL/dir) used to define their voice; defaults to --emails",
-          "name": "author-corpus",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Model used to generate comparison drafts",
-          "name": "model",
-          "default": "gpt-5.4",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth-only": {
-          "description": "Only run when a free (OAuth) model route is available; never fall back to billed inference",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "description": "Block and poll until the score is ready, then print it (default: print the job_id and return)",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:score",
+      "id": "face:lock",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3767,29 +3833,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "score.js"
+        "face",
+        "lock.js"
       ]
     },
-    "voiceprint:upload": {
+    "face:neighbors": {
       "aliases": [],
       "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
-          "required": true
-        },
-        "file": {
-          "description": "Corpus file (JSON array for thread_json, JSONL for email_jsonl)",
-          "name": "file",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Write a self face's email corpus as threads (the source for a voiceprint build). Pure data write — no compilation, no per-message billing.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice ./corpus.json",
-        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --type email_jsonl --emails-per-thread 50"
-      ],
+      "description": "Find the most similar or dissimilar owned faces to a given face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3822,30 +3879,44 @@
           "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "thread_json: a JSON array of canonical email objects → one room. email_jsonl: JSONL (one email/line) → chunked into several rooms.",
-          "name": "type",
-          "default": "thread_json",
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "thread_json",
-            "email_jsonl"
-          ],
           "type": "option"
         },
-        "emails-per-thread": {
-          "description": "For --type email_jsonl: emails per room (default 50)",
-          "name": "emails-per-thread",
-          "default": 50,
+        "component": {
+          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
+          "name": "component",
+          "default": "face",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "face",
+            "beta",
+            "delta",
+            "epsilon"
+          ],
+          "type": "option"
+        },
+        "direction": {
+          "description": "nearest (most similar) or furthest (most dissimilar)",
+          "name": "direction",
+          "default": "nearest",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "nearest",
+            "furthest"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:upload",
+      "id": "face:neighbors",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3855,23 +3926,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "upload.js"
+        "face",
+        "neighbors.js"
       ]
     },
-    "voiceprint:versions": {
+    "face:stats": {
       "aliases": [],
-      "args": {
-        "self_alias": {
-          "description": "Self face alias",
-          "name": "self_alias",
-          "required": true
-        }
-      },
-      "description": "List a self face's voice-map versions (active + one prior). Retention is one-deep; toggle with voiceprint:revert.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> alice"
-      ],
+      "args": {},
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3907,7 +3969,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "voiceprint:versions",
+      "id": "face:stats",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3917,14 +3979,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "voiceprint",
-        "versions.js"
+        "face",
+        "stats.js"
       ]
     },
-    "face:attributes": {
+    "face:teams": {
       "aliases": [],
-      "args": {},
-      "description": "List all supported attribute keys",
+      "args": {
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Set a face's team memberships (replaces all)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3956,11 +4024,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "team": {
+          "description": "Team ID (repeatable, replaces all memberships)",
+          "name": "team",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:attributes",
+      "id": "face:teams",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3971,13 +4047,22 @@
         "dist",
         "commands",
         "face",
-        "attributes.js"
+        "teams.js"
       ]
     },
-    "face:create": {
+    "face:unlock": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new face",
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4009,78 +4094,101 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:unlock",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "unlock.js"
+      ]
+    },
+    "face:upload": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Upload a file (text/PDF/audio/video) to a face",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "name": {
-          "description": "Display name",
-          "name": "name",
-          "required": true,
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "alias": {
-          "description": "Unique alias slug",
-          "name": "alias",
-          "required": true,
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Tag label (repeatable, lowercase)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "default-model": {
-          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "default-model",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "formula": {
-          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
-          "name": "formula",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "attr": {
-          "description": "Attribute KEY=VALUE (repeatable)",
-          "name": "attr",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Tool name to enable (repeatable)",
-          "name": "tool",
-          "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",
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "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",
+        "face-speaker": {
+          "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4088,7 +4196,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:create",
+      "id": "face:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4099,19 +4207,22 @@
         "dist",
         "commands",
         "face",
-        "create.js"
+        "upload.js"
       ]
     },
-    "face:delete": {
+    "voiceprint:build-status": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "job_id": {
+          "description": "Build job id",
+          "name": "job_id",
           "required": true
         }
       },
-      "description": "Delete a face permanently",
+      "description": "Get the status/result of a voiceprint build job (from voiceprint:build without --wait)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4143,17 +4254,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:delete",
+      "id": "voiceprint:build-status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4163,14 +4268,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "delete.js"
+        "voiceprint",
+        "build-status.js"
       ]
     },
-    "face:diff": {
+    "voiceprint:build": {
       "aliases": [],
-      "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
+      "args": {
+        "self_alias": {
+          "description": "Self face alias",
+          "name": "self_alias",
+          "required": true
+        }
+      },
+      "description": "Build a self face's voice map from its uploaded corpus. Auto-creates the hidden <self>-voiceprint face and installs the map. Async — use --wait to block.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --wait",
+        "<%= config.bin %> <%= command.id %> alice --holdout-count 120 --oauth-only --wait"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4203,18 +4318,43 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
+        "model": {
+          "description": "Model that forges the voice map (default: gpt-5.4)",
+          "name": "model",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "holdout-count": {
+          "description": "Stratified scoring holdout size (default: 120)",
+          "name": "holdout-count",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "min-valid": {
+          "description": "Corpus floor below which no holdout is split — train on all (default: 550)",
+          "name": "min-valid",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
+        },
+        "oauth-only": {
+          "description": "Only run on a free (OAuth) route; never fall back to billed inference",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "description": "Block and poll until the build finishes (default: print the job_id and return)",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "voiceprint:build",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4224,20 +4364,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "diff.js"
+        "voiceprint",
+        "build.js"
       ]
     },
-    "face:edit": {
+    "voiceprint:get": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "job_id": {
+          "description": "Scoring job id (from voiceprint:score --no-wait)",
+          "name": "job_id",
           "required": true
         }
       },
-      "description": "Edit a face's metadata",
+      "description": "Get the status/result of a voiceprint scoring job started with voiceprint:score --no-wait",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4269,87 +4412,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "New display name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Plain-text description / bio (max 1500 chars)",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "description": "Replace all tags (repeatable, lowercase)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "default-model": {
-          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "default-model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "formula": {
-          "description": "New boolean formula (synthetic faces only)",
-          "name": "formula",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "attr": {
-          "description": "Update attribute KEY=VALUE (repeatable)",
-          "name": "attr",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Tool names to set (replaces list, repeatable)",
-          "name": "tool",
-          "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,
       "hiddenAliases": [],
-      "id": "face:edit",
+      "id": "voiceprint:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4359,20 +4426,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "edit.js"
+        "voiceprint",
+        "get.js"
       ]
     },
-    "face:get": {
+    "voiceprint:refine-status": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "job_id": {
+          "description": "Refine job id",
+          "name": "job_id",
           "required": true
         }
       },
-      "description": "Get details for a face by alias",
+      "description": "Get the status/result of a voiceprint refine job (from voiceprint:refine without --wait)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4404,24 +4474,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
-          "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,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "voiceprint:refine-status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4431,14 +4488,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "get.js"
+        "voiceprint",
+        "refine-status.js"
       ]
     },
-    "face:list": {
+    "voiceprint:refine": {
       "aliases": [],
-      "args": {},
-      "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
+      "args": {
+        "self_alias": {
+          "description": "Self face alias",
+          "name": "self_alias",
+          "required": true
+        }
+      },
+      "description": "Tune the active version's post-processing recipe and promote it only if it beats the current one. Requires an existing build with a holdout ≥ 20. Undo with voiceprint:revert.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice --wait",
+        "<%= config.bin %> <%= command.id %> alice --temperature 0.4 --n-samples 6 --wait"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4471,57 +4538,105 @@
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "description": "Filter by tag (repeatable, AND logic)",
-          "name": "tag",
+        "model": {
+          "description": "Model used to forge candidate drafts (default: the active version's build model)",
+          "name": "model",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "team": {
-          "description": "Filter by team ID (repeatable, OR logic)",
-          "name": "team",
+        "temperature": {
+          "description": "Sampling temperature for candidate drafts (default: 0.4)",
+          "name": "temperature",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Include extra fields: tags, teams (comma-separated)",
-          "name": "include",
+        "n-samples": {
+          "description": "Drafts forged per holdout pair (default: 6)",
+          "name": "n-samples",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "public": {
-          "description": "Include published faces from other accounts",
-          "name": "public",
+        "oauth-only": {
+          "description": "Only run on a free (OAuth) route; never fall back to billed inference",
+          "name": "oauth-only",
           "allowNo": false,
           "type": "boolean"
         },
-        "system": {
-          "description": "Show only the curated system faces (published faces owned by 'head')",
-          "name": "system",
+        "wait": {
+          "description": "Block and poll until refine finishes (default: print the job_id and return)",
+          "name": "wait",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "voiceprint:refine",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "voiceprint",
+        "refine.js"
+      ]
+    },
+    "voiceprint:revert": {
+      "aliases": [],
+      "args": {
+        "self_alias": {
+          "description": "Self face alias",
+          "name": "self_alias",
+          "required": true
+        }
+      },
+      "description": "Revert a self face's voice map to its prior version (one-deep undo; re-running toggles back). Only changes which stored recipe/baseline is active — the map text is frozen.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice"
+      ],
+      "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"
         },
-        "from-users": {
-          "description": "Only published faces from these owners (repeatable/comma-separated)",
-          "name": "from-users",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "not-from-users": {
-          "description": "Exclude published faces from these owners (repeatable/comma-separated)",
-          "name": "not-from-users",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "voiceprint:revert",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4531,20 +4646,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "list.js"
+        "voiceprint",
+        "revert.js"
       ]
     },
-    "face:neighbors": {
+    "voiceprint:score-status": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "job_id": {
+          "description": "Scoring job id",
+          "name": "job_id",
           "required": true
         }
       },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "description": "Get the status/result of a voiceprint scoring job (from voiceprint:score without --wait)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4576,45 +4694,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "component": {
-          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
-          "name": "component",
-          "default": "face",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "face",
-            "beta",
-            "delta",
-            "epsilon"
-          ],
-          "type": "option"
-        },
-        "direction": {
-          "description": "nearest (most similar) or furthest (most dissimilar)",
-          "name": "direction",
-          "default": "nearest",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "nearest",
-            "furthest"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:neighbors",
+      "id": "voiceprint:score-status",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4624,14 +4708,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "neighbors.js"
+        "voiceprint",
+        "score-status.js"
       ]
     },
-    "face:stats": {
+    "voiceprint:score": {
       "aliases": [],
-      "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "args": {
+        "face": {
+          "description": "Face to score (alias, owner:alias, or a union like \"(alice-voiceprint | alice)\")",
+          "name": "face",
+          "required": true
+        }
+      },
+      "description": "Score how closely a face writes like a specific person. Returns VCI (closeness, 0–100) and VFI (voice captured vs a generic baseline, 0–100). Deterministic — ideal for before/after tuning.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> \"(alice-voiceprint | alice)\" --emails ./sent.jsonl --wait",
+        "<%= config.bin %> <%= command.id %> alice --emails-dir ./sent-emails/ --wait",
+        "<%= config.bin %> <%= command.id %> alice --emails ./sent.json   # prints job_id; poll with voiceprint:score-status"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4663,11 +4758,55 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "emails": {
+          "description": "JSON or JSONL file of the person's real writing — {id?, text} objects or plain strings (provide at least 20)",
+          "name": "emails",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "emails-dir": {
+          "description": "Directory with one sample per file (id = filename). Alternative to --emails.",
+          "exclusive": [
+            "emails"
+          ],
+          "name": "emails-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "author-corpus": {
+          "description": "Optional larger reference of the person's writing (JSON/JSONL/dir) used to define their voice; defaults to --emails",
+          "name": "author-corpus",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Model used to generate comparison drafts",
+          "name": "model",
+          "default": "gpt-5.4",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Only run when a free (OAuth) model route is available; never fall back to billed inference",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "description": "Block and poll until the score is ready, then print it (default: print the job_id and return)",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:stats",
+      "id": "voiceprint:score",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4677,20 +4816,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "stats.js"
+        "voiceprint",
+        "score.js"
       ]
     },
-    "face:teams": {
+    "voiceprint:upload": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
+        "self_alias": {
+          "description": "Self face alias",
+          "name": "self_alias",
+          "required": true
+        },
+        "file": {
+          "description": "Corpus file (JSON array for thread_json, JSONL for email_jsonl)",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Set a face's team memberships (replaces all)",
+      "description": "Write a self face's email corpus as threads (the source for a voiceprint build). Pure data write — no compilation, no per-message billing.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice ./corpus.json",
+        "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --type email_jsonl --emails-per-thread 50"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4723,18 +4871,30 @@
           "multiple": false,
           "type": "option"
         },
-        "team": {
-          "description": "Team ID (repeatable, replaces all memberships)",
-          "name": "team",
-          "required": true,
+        "type": {
+          "description": "thread_json: a JSON array of canonical email objects → one room. email_jsonl: JSONL (one email/line) → chunked into several rooms.",
+          "name": "type",
+          "default": "thread_json",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "options": [
+            "thread_json",
+            "email_jsonl"
+          ],
+          "type": "option"
+        },
+        "emails-per-thread": {
+          "description": "For --type email_jsonl: emails per room (default 50)",
+          "name": "emails-per-thread",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:teams",
+      "id": "voiceprint:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4744,20 +4904,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "teams.js"
+        "voiceprint",
+        "upload.js"
       ]
     },
-    "face:upload": {
+    "voiceprint:versions": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "self_alias": {
+          "description": "Self face alias",
+          "name": "self_alias",
           "required": true
         }
       },
-      "description": "Upload a file (text/PDF/audio/video) to a face",
+      "description": "List a self face's voice-map versions (active + one prior). Retention is one-deep; toggle with voiceprint:revert.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> alice"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -4789,50 +4952,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
-          "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
-          "name": "face-speaker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:upload",
+      "id": "voiceprint:versions",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -4842,8 +4966,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "upload.js"
+        "voiceprint",
+        "versions.js"
       ]
     },
     "billing:subscription:activate": {
@@ -6888,5 +7012,5 @@
       ]
     }
   },
-  "version": "1.7.5"
+  "version": "1.7.6"
 }