faces-cli 1.7.4 → 1.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/base.js +6 -0
  2. package/dist/commands/face/get.js +2 -0
  3. package/dist/commands/face/list.js +2 -0
  4. package/dist/commands/face/lock.d.ts +14 -0
  5. package/dist/commands/face/lock.js +34 -0
  6. package/dist/commands/face/unlock.d.ts +14 -0
  7. package/dist/commands/face/unlock.js +34 -0
  8. package/dist/commands/voiceprint/build-status.d.ts +14 -0
  9. package/dist/commands/voiceprint/build-status.js +46 -0
  10. package/dist/commands/voiceprint/build.d.ts +23 -0
  11. package/dist/commands/voiceprint/build.js +109 -0
  12. package/dist/commands/voiceprint/get.d.ts +14 -0
  13. package/dist/commands/voiceprint/get.js +47 -0
  14. package/dist/commands/voiceprint/refine-status.d.ts +14 -0
  15. package/dist/commands/voiceprint/refine-status.js +43 -0
  16. package/dist/commands/voiceprint/refine.d.ts +23 -0
  17. package/dist/commands/voiceprint/refine.js +88 -0
  18. package/dist/commands/voiceprint/revert.d.ts +14 -0
  19. package/dist/commands/voiceprint/revert.js +36 -0
  20. package/dist/commands/voiceprint/score-status.d.ts +14 -0
  21. package/dist/commands/voiceprint/score-status.js +46 -0
  22. package/dist/commands/voiceprint/score.d.ts +24 -0
  23. package/dist/commands/voiceprint/score.js +114 -0
  24. package/dist/commands/voiceprint/upload.d.ts +17 -0
  25. package/dist/commands/voiceprint/upload.js +66 -0
  26. package/dist/commands/voiceprint/versions.d.ts +14 -0
  27. package/dist/commands/voiceprint/versions.js +44 -0
  28. package/dist/utils.d.ts +15 -0
  29. package/dist/utils.js +75 -0
  30. package/dist/voiceprint.d.ts +28 -0
  31. package/dist/voiceprint.js +55 -0
  32. package/oclif.manifest.json +1821 -937
  33. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -632,10 +632,10 @@
632
632
  "whoami.js"
633
633
  ]
634
634
  },
635
- "billing:balance": {
635
+ "catalog:backup": {
636
636
  "aliases": [],
637
637
  "args": {},
638
- "description": "Show credit balance and payment method status",
638
+ "description": "Snapshot all faces, teams, and source material for migration",
639
639
  "flags": {
640
640
  "json": {
641
641
  "description": "Format output as json.",
@@ -671,7 +671,7 @@
671
671
  },
672
672
  "hasDynamicHelp": false,
673
673
  "hiddenAliases": [],
674
- "id": "billing:balance",
674
+ "id": "catalog:backup",
675
675
  "pluginAlias": "faces-cli",
676
676
  "pluginName": "faces-cli",
677
677
  "pluginType": "core",
@@ -681,14 +681,14 @@
681
681
  "relativePath": [
682
682
  "dist",
683
683
  "commands",
684
- "billing",
685
- "balance.js"
684
+ "catalog",
685
+ "backup.js"
686
686
  ]
687
687
  },
688
- "billing:card-setup": {
688
+ "catalog:doctor": {
689
689
  "aliases": [],
690
690
  "args": {},
691
- "description": "Get a Stripe card setup URL to save a payment method",
691
+ "description": "Diagnose and repair the local face and team catalog",
692
692
  "flags": {
693
693
  "json": {
694
694
  "description": "Format output as json.",
@@ -720,11 +720,23 @@
720
720
  "hasDynamicHelp": false,
721
721
  "multiple": false,
722
722
  "type": "option"
723
+ },
724
+ "fix": {
725
+ "description": "Rebuild missing or stale catalog entries from API",
726
+ "name": "fix",
727
+ "allowNo": false,
728
+ "type": "boolean"
729
+ },
730
+ "generate": {
731
+ "description": "Fix + generate missing descriptions via LLM",
732
+ "name": "generate",
733
+ "allowNo": false,
734
+ "type": "boolean"
723
735
  }
724
736
  },
725
737
  "hasDynamicHelp": false,
726
738
  "hiddenAliases": [],
727
- "id": "billing:card-setup",
739
+ "id": "catalog:doctor",
728
740
  "pluginAlias": "faces-cli",
729
741
  "pluginName": "faces-cli",
730
742
  "pluginType": "core",
@@ -734,14 +746,14 @@
734
746
  "relativePath": [
735
747
  "dist",
736
748
  "commands",
737
- "billing",
738
- "card-setup.js"
749
+ "catalog",
750
+ "doctor.js"
739
751
  ]
740
752
  },
741
- "billing:llm-costs": {
753
+ "catalog:list": {
742
754
  "aliases": [],
743
755
  "args": {},
744
- "description": "List available LLMs and their per-token costs",
756
+ "description": "List all faces in the local catalog",
745
757
  "flags": {
746
758
  "json": {
747
759
  "description": "Format output as json.",
@@ -773,18 +785,11 @@
773
785
  "hasDynamicHelp": false,
774
786
  "multiple": false,
775
787
  "type": "option"
776
- },
777
- "provider": {
778
- "description": "Filter by provider (e.g. openai, anthropic)",
779
- "name": "provider",
780
- "hasDynamicHelp": false,
781
- "multiple": false,
782
- "type": "option"
783
788
  }
784
789
  },
785
790
  "hasDynamicHelp": false,
786
791
  "hiddenAliases": [],
787
- "id": "billing:llm-costs",
792
+ "id": "catalog:list",
788
793
  "pluginAlias": "faces-cli",
789
794
  "pluginName": "faces-cli",
790
795
  "pluginType": "core",
@@ -794,14 +799,14 @@
794
799
  "relativePath": [
795
800
  "dist",
796
801
  "commands",
797
- "billing",
798
- "llm-costs.js"
802
+ "catalog",
803
+ "list.js"
799
804
  ]
800
805
  },
801
- "billing:quota": {
806
+ "catalog:manyfaced": {
802
807
  "aliases": [],
803
808
  "args": {},
804
- "description": "Show compilation stats per face (deprecated — use compile:stats)",
809
+ "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
805
810
  "flags": {
806
811
  "json": {
807
812
  "description": "Format output as json.",
@@ -833,11 +838,38 @@
833
838
  "hasDynamicHelp": false,
834
839
  "multiple": false,
835
840
  "type": "option"
841
+ },
842
+ "skill": {
843
+ "description": "Show details for a specific skill",
844
+ "name": "skill",
845
+ "hasDynamicHelp": false,
846
+ "multiple": false,
847
+ "type": "option"
848
+ },
849
+ "install": {
850
+ "description": "Install a skill by name",
851
+ "name": "install",
852
+ "hasDynamicHelp": false,
853
+ "multiple": false,
854
+ "type": "option"
855
+ },
856
+ "skills-dir": {
857
+ "description": "Directory to install skills into (required for --install)",
858
+ "name": "skills-dir",
859
+ "hasDynamicHelp": false,
860
+ "multiple": false,
861
+ "type": "option"
862
+ },
863
+ "refresh": {
864
+ "description": "Force refresh the skill index (ignore cache)",
865
+ "name": "refresh",
866
+ "allowNo": false,
867
+ "type": "boolean"
836
868
  }
837
869
  },
838
870
  "hasDynamicHelp": false,
839
871
  "hiddenAliases": [],
840
- "id": "billing:quota",
872
+ "id": "catalog:manyfaced",
841
873
  "pluginAlias": "faces-cli",
842
874
  "pluginName": "faces-cli",
843
875
  "pluginType": "core",
@@ -847,14 +879,19 @@
847
879
  "relativePath": [
848
880
  "dist",
849
881
  "commands",
850
- "billing",
851
- "quota.js"
882
+ "catalog",
883
+ "manyfaced.js"
852
884
  ]
853
885
  },
854
- "billing:subscription": {
886
+ "catalog:restore": {
855
887
  "aliases": [],
856
- "args": {},
857
- "description": "Show current plan, face count, and renewal date",
888
+ "args": {
889
+ "file": {
890
+ "description": "Backup file path (default: most recent in ~/.faces/backups/)",
891
+ "name": "file"
892
+ }
893
+ },
894
+ "description": "Restore faces, teams, and source material from a backup snapshot",
858
895
  "flags": {
859
896
  "json": {
860
897
  "description": "Format output as json.",
@@ -886,11 +923,17 @@
886
923
  "hasDynamicHelp": false,
887
924
  "multiple": false,
888
925
  "type": "option"
926
+ },
927
+ "compile": {
928
+ "description": "Run compile:all after restoring",
929
+ "name": "compile",
930
+ "allowNo": false,
931
+ "type": "boolean"
889
932
  }
890
933
  },
891
934
  "hasDynamicHelp": false,
892
935
  "hiddenAliases": [],
893
- "id": "billing:subscription",
936
+ "id": "catalog:restore",
894
937
  "pluginAlias": "faces-cli",
895
938
  "pluginName": "faces-cli",
896
939
  "pluginType": "core",
@@ -900,14 +943,14 @@
900
943
  "relativePath": [
901
944
  "dist",
902
945
  "commands",
903
- "billing",
904
- "subscription.js"
946
+ "catalog",
947
+ "restore.js"
905
948
  ]
906
949
  },
907
- "billing:topup": {
950
+ "billing:balance": {
908
951
  "aliases": [],
909
952
  "args": {},
910
- "description": "Top up credit balance using saved payment method",
953
+ "description": "Show credit balance and payment method status",
911
954
  "flags": {
912
955
  "json": {
913
956
  "description": "Format output as json.",
@@ -939,26 +982,11 @@
939
982
  "hasDynamicHelp": false,
940
983
  "multiple": false,
941
984
  "type": "option"
942
- },
943
- "amount": {
944
- "description": "Top-up amount in USD (min $1)",
945
- "name": "amount",
946
- "required": true,
947
- "hasDynamicHelp": false,
948
- "multiple": false,
949
- "type": "option"
950
- },
951
- "payment-ref": {
952
- "description": "Payment reference (admin/test path)",
953
- "name": "payment-ref",
954
- "hasDynamicHelp": false,
955
- "multiple": false,
956
- "type": "option"
957
985
  }
958
986
  },
959
987
  "hasDynamicHelp": false,
960
988
  "hiddenAliases": [],
961
- "id": "billing:topup",
989
+ "id": "billing:balance",
962
990
  "pluginAlias": "faces-cli",
963
991
  "pluginName": "faces-cli",
964
992
  "pluginType": "core",
@@ -969,13 +997,13 @@
969
997
  "dist",
970
998
  "commands",
971
999
  "billing",
972
- "topup.js"
1000
+ "balance.js"
973
1001
  ]
974
1002
  },
975
- "billing:usage": {
1003
+ "billing:card-setup": {
976
1004
  "aliases": [],
977
1005
  "args": {},
978
- "description": "Aggregated usage analytics",
1006
+ "description": "Get a Stripe card setup URL to save a payment method",
979
1007
  "flags": {
980
1008
  "json": {
981
1009
  "description": "Format output as json.",
@@ -1007,38 +1035,11 @@
1007
1035
  "hasDynamicHelp": false,
1008
1036
  "multiple": false,
1009
1037
  "type": "option"
1010
- },
1011
- "group-by": {
1012
- "description": "Group results",
1013
- "name": "group-by",
1014
- "hasDynamicHelp": false,
1015
- "multiple": false,
1016
- "options": [
1017
- "api_key",
1018
- "model",
1019
- "llm",
1020
- "date"
1021
- ],
1022
- "type": "option"
1023
- },
1024
- "from": {
1025
- "description": "Start date (YYYY-MM-DD)",
1026
- "name": "from",
1027
- "hasDynamicHelp": false,
1028
- "multiple": false,
1029
- "type": "option"
1030
- },
1031
- "to": {
1032
- "description": "End date (YYYY-MM-DD)",
1033
- "name": "to",
1034
- "hasDynamicHelp": false,
1035
- "multiple": false,
1036
- "type": "option"
1037
1038
  }
1038
1039
  },
1039
1040
  "hasDynamicHelp": false,
1040
1041
  "hiddenAliases": [],
1041
- "id": "billing:usage",
1042
+ "id": "billing:card-setup",
1042
1043
  "pluginAlias": "faces-cli",
1043
1044
  "pluginName": "faces-cli",
1044
1045
  "pluginType": "core",
@@ -1049,13 +1050,13 @@
1049
1050
  "dist",
1050
1051
  "commands",
1051
1052
  "billing",
1052
- "usage.js"
1053
+ "card-setup.js"
1053
1054
  ]
1054
1055
  },
1055
- "catalog:backup": {
1056
+ "billing:llm-costs": {
1056
1057
  "aliases": [],
1057
1058
  "args": {},
1058
- "description": "Snapshot all faces, teams, and source material for migration",
1059
+ "description": "List available LLMs and their per-token costs",
1059
1060
  "flags": {
1060
1061
  "json": {
1061
1062
  "description": "Format output as json.",
@@ -1087,11 +1088,18 @@
1087
1088
  "hasDynamicHelp": false,
1088
1089
  "multiple": false,
1089
1090
  "type": "option"
1091
+ },
1092
+ "provider": {
1093
+ "description": "Filter by provider (e.g. openai, anthropic)",
1094
+ "name": "provider",
1095
+ "hasDynamicHelp": false,
1096
+ "multiple": false,
1097
+ "type": "option"
1090
1098
  }
1091
1099
  },
1092
1100
  "hasDynamicHelp": false,
1093
1101
  "hiddenAliases": [],
1094
- "id": "catalog:backup",
1102
+ "id": "billing:llm-costs",
1095
1103
  "pluginAlias": "faces-cli",
1096
1104
  "pluginName": "faces-cli",
1097
1105
  "pluginType": "core",
@@ -1101,14 +1109,14 @@
1101
1109
  "relativePath": [
1102
1110
  "dist",
1103
1111
  "commands",
1104
- "catalog",
1105
- "backup.js"
1112
+ "billing",
1113
+ "llm-costs.js"
1106
1114
  ]
1107
1115
  },
1108
- "catalog:doctor": {
1116
+ "billing:quota": {
1109
1117
  "aliases": [],
1110
1118
  "args": {},
1111
- "description": "Diagnose and repair the local face and team catalog",
1119
+ "description": "Show compilation stats per face (deprecated — use compile:stats)",
1112
1120
  "flags": {
1113
1121
  "json": {
1114
1122
  "description": "Format output as json.",
@@ -1140,23 +1148,11 @@
1140
1148
  "hasDynamicHelp": false,
1141
1149
  "multiple": false,
1142
1150
  "type": "option"
1143
- },
1144
- "fix": {
1145
- "description": "Rebuild missing or stale catalog entries from API",
1146
- "name": "fix",
1147
- "allowNo": false,
1148
- "type": "boolean"
1149
- },
1150
- "generate": {
1151
- "description": "Fix + generate missing descriptions via LLM",
1152
- "name": "generate",
1153
- "allowNo": false,
1154
- "type": "boolean"
1155
1151
  }
1156
1152
  },
1157
1153
  "hasDynamicHelp": false,
1158
1154
  "hiddenAliases": [],
1159
- "id": "catalog:doctor",
1155
+ "id": "billing:quota",
1160
1156
  "pluginAlias": "faces-cli",
1161
1157
  "pluginName": "faces-cli",
1162
1158
  "pluginType": "core",
@@ -1166,14 +1162,14 @@
1166
1162
  "relativePath": [
1167
1163
  "dist",
1168
1164
  "commands",
1169
- "catalog",
1170
- "doctor.js"
1165
+ "billing",
1166
+ "quota.js"
1171
1167
  ]
1172
1168
  },
1173
- "catalog:list": {
1169
+ "billing:subscription": {
1174
1170
  "aliases": [],
1175
1171
  "args": {},
1176
- "description": "List all faces in the local catalog",
1172
+ "description": "Show current plan, face count, and renewal date",
1177
1173
  "flags": {
1178
1174
  "json": {
1179
1175
  "description": "Format output as json.",
@@ -1209,7 +1205,7 @@
1209
1205
  },
1210
1206
  "hasDynamicHelp": false,
1211
1207
  "hiddenAliases": [],
1212
- "id": "catalog:list",
1208
+ "id": "billing:subscription",
1213
1209
  "pluginAlias": "faces-cli",
1214
1210
  "pluginName": "faces-cli",
1215
1211
  "pluginType": "core",
@@ -1219,14 +1215,14 @@
1219
1215
  "relativePath": [
1220
1216
  "dist",
1221
1217
  "commands",
1222
- "catalog",
1223
- "list.js"
1218
+ "billing",
1219
+ "subscription.js"
1224
1220
  ]
1225
1221
  },
1226
- "catalog:manyfaced": {
1222
+ "billing:topup": {
1227
1223
  "aliases": [],
1228
1224
  "args": {},
1229
- "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
1225
+ "description": "Top up credit balance using saved payment method",
1230
1226
  "flags": {
1231
1227
  "json": {
1232
1228
  "description": "Format output as json.",
@@ -1259,37 +1255,25 @@
1259
1255
  "multiple": false,
1260
1256
  "type": "option"
1261
1257
  },
1262
- "skill": {
1263
- "description": "Show details for a specific skill",
1264
- "name": "skill",
1265
- "hasDynamicHelp": false,
1266
- "multiple": false,
1267
- "type": "option"
1268
- },
1269
- "install": {
1270
- "description": "Install a skill by name",
1271
- "name": "install",
1258
+ "amount": {
1259
+ "description": "Top-up amount in USD (min $1)",
1260
+ "name": "amount",
1261
+ "required": true,
1272
1262
  "hasDynamicHelp": false,
1273
1263
  "multiple": false,
1274
1264
  "type": "option"
1275
1265
  },
1276
- "skills-dir": {
1277
- "description": "Directory to install skills into (required for --install)",
1278
- "name": "skills-dir",
1266
+ "payment-ref": {
1267
+ "description": "Payment reference (admin/test path)",
1268
+ "name": "payment-ref",
1279
1269
  "hasDynamicHelp": false,
1280
1270
  "multiple": false,
1281
1271
  "type": "option"
1282
- },
1283
- "refresh": {
1284
- "description": "Force refresh the skill index (ignore cache)",
1285
- "name": "refresh",
1286
- "allowNo": false,
1287
- "type": "boolean"
1288
1272
  }
1289
1273
  },
1290
1274
  "hasDynamicHelp": false,
1291
1275
  "hiddenAliases": [],
1292
- "id": "catalog:manyfaced",
1276
+ "id": "billing:topup",
1293
1277
  "pluginAlias": "faces-cli",
1294
1278
  "pluginName": "faces-cli",
1295
1279
  "pluginType": "core",
@@ -1299,19 +1283,14 @@
1299
1283
  "relativePath": [
1300
1284
  "dist",
1301
1285
  "commands",
1302
- "catalog",
1303
- "manyfaced.js"
1286
+ "billing",
1287
+ "topup.js"
1304
1288
  ]
1305
1289
  },
1306
- "catalog:restore": {
1290
+ "billing:usage": {
1307
1291
  "aliases": [],
1308
- "args": {
1309
- "file": {
1310
- "description": "Backup file path (default: most recent in ~/.faces/backups/)",
1311
- "name": "file"
1312
- }
1313
- },
1314
- "description": "Restore faces, teams, and source material from a backup snapshot",
1292
+ "args": {},
1293
+ "description": "Aggregated usage analytics",
1315
1294
  "flags": {
1316
1295
  "json": {
1317
1296
  "description": "Format output as json.",
@@ -1344,16 +1323,37 @@
1344
1323
  "multiple": false,
1345
1324
  "type": "option"
1346
1325
  },
1347
- "compile": {
1348
- "description": "Run compile:all after restoring",
1349
- "name": "compile",
1350
- "allowNo": false,
1351
- "type": "boolean"
1326
+ "group-by": {
1327
+ "description": "Group results",
1328
+ "name": "group-by",
1329
+ "hasDynamicHelp": false,
1330
+ "multiple": false,
1331
+ "options": [
1332
+ "api_key",
1333
+ "model",
1334
+ "llm",
1335
+ "date"
1336
+ ],
1337
+ "type": "option"
1338
+ },
1339
+ "from": {
1340
+ "description": "Start date (YYYY-MM-DD)",
1341
+ "name": "from",
1342
+ "hasDynamicHelp": false,
1343
+ "multiple": false,
1344
+ "type": "option"
1345
+ },
1346
+ "to": {
1347
+ "description": "End date (YYYY-MM-DD)",
1348
+ "name": "to",
1349
+ "hasDynamicHelp": false,
1350
+ "multiple": false,
1351
+ "type": "option"
1352
1352
  }
1353
1353
  },
1354
1354
  "hasDynamicHelp": false,
1355
1355
  "hiddenAliases": [],
1356
- "id": "catalog:restore",
1356
+ "id": "billing:usage",
1357
1357
  "pluginAlias": "faces-cli",
1358
1358
  "pluginName": "faces-cli",
1359
1359
  "pluginType": "core",
@@ -1363,8 +1363,8 @@
1363
1363
  "relativePath": [
1364
1364
  "dist",
1365
1365
  "commands",
1366
- "catalog",
1367
- "restore.js"
1366
+ "billing",
1367
+ "usage.js"
1368
1368
  ]
1369
1369
  },
1370
1370
  "chat:chat": {
@@ -2326,10 +2326,10 @@
2326
2326
  "show.js"
2327
2327
  ]
2328
2328
  },
2329
- "face:attributes": {
2329
+ "keys:create": {
2330
2330
  "aliases": [],
2331
2331
  "args": {},
2332
- "description": "List all supported attribute keys",
2332
+ "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
2333
2333
  "flags": {
2334
2334
  "json": {
2335
2335
  "description": "Format output as json.",
@@ -2361,11 +2361,53 @@
2361
2361
  "hasDynamicHelp": false,
2362
2362
  "multiple": false,
2363
2363
  "type": "option"
2364
+ },
2365
+ "name": {
2366
+ "description": "Key name/label",
2367
+ "name": "name",
2368
+ "required": true,
2369
+ "hasDynamicHelp": false,
2370
+ "multiple": false,
2371
+ "type": "option"
2372
+ },
2373
+ "expires-days": {
2374
+ "description": "Expiry in days (omit for no expiry)",
2375
+ "name": "expires-days",
2376
+ "hasDynamicHelp": false,
2377
+ "multiple": false,
2378
+ "type": "option"
2379
+ },
2380
+ "budget": {
2381
+ "description": "Spend budget in USD",
2382
+ "name": "budget",
2383
+ "hasDynamicHelp": false,
2384
+ "multiple": false,
2385
+ "type": "option"
2386
+ },
2387
+ "face": {
2388
+ "description": "Allowed face alias (repeatable)",
2389
+ "name": "face",
2390
+ "hasDynamicHelp": false,
2391
+ "multiple": true,
2392
+ "type": "option"
2393
+ },
2394
+ "model": {
2395
+ "description": "Allowed model name (repeatable)",
2396
+ "name": "model",
2397
+ "hasDynamicHelp": false,
2398
+ "multiple": true,
2399
+ "type": "option"
2400
+ },
2401
+ "save": {
2402
+ "description": "Save the new key to ~/.faces/config.json as api_key (default: true; use --no-save to skip)",
2403
+ "name": "save",
2404
+ "allowNo": true,
2405
+ "type": "boolean"
2364
2406
  }
2365
2407
  },
2366
2408
  "hasDynamicHelp": false,
2367
2409
  "hiddenAliases": [],
2368
- "id": "face:attributes",
2410
+ "id": "keys:create",
2369
2411
  "pluginAlias": "faces-cli",
2370
2412
  "pluginName": "faces-cli",
2371
2413
  "pluginType": "core",
@@ -2375,14 +2417,14 @@
2375
2417
  "relativePath": [
2376
2418
  "dist",
2377
2419
  "commands",
2378
- "face",
2379
- "attributes.js"
2420
+ "keys",
2421
+ "create.js"
2380
2422
  ]
2381
2423
  },
2382
- "face:create": {
2424
+ "keys:list": {
2383
2425
  "aliases": [],
2384
2426
  "args": {},
2385
- "description": "Create a new face",
2427
+ "description": "List all API keys (JWT required)",
2386
2428
  "flags": {
2387
2429
  "json": {
2388
2430
  "description": "Format output as json.",
@@ -2414,86 +2456,11 @@
2414
2456
  "hasDynamicHelp": false,
2415
2457
  "multiple": false,
2416
2458
  "type": "option"
2417
- },
2418
- "name": {
2419
- "description": "Display name",
2420
- "name": "name",
2421
- "required": true,
2422
- "hasDynamicHelp": false,
2423
- "multiple": false,
2424
- "type": "option"
2425
- },
2426
- "alias": {
2427
- "description": "Unique alias slug",
2428
- "name": "alias",
2429
- "required": true,
2430
- "hasDynamicHelp": false,
2431
- "multiple": false,
2432
- "type": "option"
2433
- },
2434
- "description": {
2435
- "description": "Plain-text description / bio (max 1500 chars)",
2436
- "name": "description",
2437
- "hasDynamicHelp": false,
2438
- "multiple": false,
2439
- "type": "option"
2440
- },
2441
- "tag": {
2442
- "description": "Tag label (repeatable, lowercase)",
2443
- "name": "tag",
2444
- "hasDynamicHelp": false,
2445
- "multiple": true,
2446
- "type": "option"
2447
- },
2448
- "default-model": {
2449
- "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2450
- "name": "default-model",
2451
- "hasDynamicHelp": false,
2452
- "multiple": false,
2453
- "type": "option"
2454
- },
2455
- "formula": {
2456
- "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
2457
- "name": "formula",
2458
- "hasDynamicHelp": false,
2459
- "multiple": false,
2460
- "type": "option"
2461
- },
2462
- "attr": {
2463
- "description": "Attribute KEY=VALUE (repeatable)",
2464
- "name": "attr",
2465
- "hasDynamicHelp": false,
2466
- "multiple": true,
2467
- "type": "option"
2468
- },
2469
- "tool": {
2470
- "description": "Tool name to enable (repeatable)",
2471
- "name": "tool",
2472
- "hasDynamicHelp": false,
2473
- "multiple": true,
2474
- "type": "option"
2475
- },
2476
- "profile-addendum": {
2477
- "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
2478
- "name": "profile-addendum",
2479
- "hasDynamicHelp": false,
2480
- "multiple": false,
2481
- "type": "option"
2482
- },
2483
- "profile-addendum-file": {
2484
- "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
2485
- "exclusive": [
2486
- "profile-addendum"
2487
- ],
2488
- "name": "profile-addendum-file",
2489
- "hasDynamicHelp": false,
2490
- "multiple": false,
2491
- "type": "option"
2492
2459
  }
2493
2460
  },
2494
2461
  "hasDynamicHelp": false,
2495
2462
  "hiddenAliases": [],
2496
- "id": "face:create",
2463
+ "id": "keys:list",
2497
2464
  "pluginAlias": "faces-cli",
2498
2465
  "pluginName": "faces-cli",
2499
2466
  "pluginType": "core",
@@ -2503,20 +2470,20 @@
2503
2470
  "relativePath": [
2504
2471
  "dist",
2505
2472
  "commands",
2506
- "face",
2507
- "create.js"
2473
+ "keys",
2474
+ "list.js"
2508
2475
  ]
2509
2476
  },
2510
- "face:delete": {
2477
+ "keys:revoke": {
2511
2478
  "aliases": [],
2512
2479
  "args": {
2513
- "face_id": {
2514
- "description": "Face alias",
2515
- "name": "face_id",
2480
+ "key_id": {
2481
+ "description": "Key ID",
2482
+ "name": "key_id",
2516
2483
  "required": true
2517
2484
  }
2518
2485
  },
2519
- "description": "Delete a face permanently",
2486
+ "description": "Revoke an API key (JWT required)",
2520
2487
  "flags": {
2521
2488
  "json": {
2522
2489
  "description": "Format output as json.",
@@ -2558,7 +2525,7 @@
2558
2525
  },
2559
2526
  "hasDynamicHelp": false,
2560
2527
  "hiddenAliases": [],
2561
- "id": "face:delete",
2528
+ "id": "keys:revoke",
2562
2529
  "pluginAlias": "faces-cli",
2563
2530
  "pluginName": "faces-cli",
2564
2531
  "pluginType": "core",
@@ -2568,14 +2535,20 @@
2568
2535
  "relativePath": [
2569
2536
  "dist",
2570
2537
  "commands",
2571
- "face",
2572
- "delete.js"
2538
+ "keys",
2539
+ "revoke.js"
2573
2540
  ]
2574
2541
  },
2575
- "face:diff": {
2542
+ "keys:update": {
2576
2543
  "aliases": [],
2577
- "args": {},
2578
- "description": "Compare owned faces pairwise across all centroid components",
2544
+ "args": {
2545
+ "key_id": {
2546
+ "description": "Key ID",
2547
+ "name": "key_id",
2548
+ "required": true
2549
+ }
2550
+ },
2551
+ "description": "Update API key metadata (JWT required)",
2579
2552
  "flags": {
2580
2553
  "json": {
2581
2554
  "description": "Format output as json.",
@@ -2608,18 +2581,30 @@
2608
2581
  "multiple": false,
2609
2582
  "type": "option"
2610
2583
  },
2611
- "face": {
2612
- "description": "Face alias to include (repeatable, min 2)",
2613
- "name": "face",
2614
- "required": true,
2584
+ "name": {
2585
+ "description": "New key name",
2586
+ "name": "name",
2615
2587
  "hasDynamicHelp": false,
2616
- "multiple": true,
2588
+ "multiple": false,
2589
+ "type": "option"
2590
+ },
2591
+ "budget": {
2592
+ "description": "New spend budget in USD",
2593
+ "name": "budget",
2594
+ "hasDynamicHelp": false,
2595
+ "multiple": false,
2617
2596
  "type": "option"
2597
+ },
2598
+ "reset-spent": {
2599
+ "description": "Reset spent amount to zero",
2600
+ "name": "reset-spent",
2601
+ "allowNo": false,
2602
+ "type": "boolean"
2618
2603
  }
2619
2604
  },
2620
2605
  "hasDynamicHelp": false,
2621
2606
  "hiddenAliases": [],
2622
- "id": "face:diff",
2607
+ "id": "keys:update",
2623
2608
  "pluginAlias": "faces-cli",
2624
2609
  "pluginName": "faces-cli",
2625
2610
  "pluginType": "core",
@@ -2629,20 +2614,20 @@
2629
2614
  "relativePath": [
2630
2615
  "dist",
2631
2616
  "commands",
2632
- "face",
2633
- "diff.js"
2617
+ "keys",
2618
+ "update.js"
2634
2619
  ]
2635
2620
  },
2636
- "face:edit": {
2621
+ "team:add": {
2637
2622
  "aliases": [],
2638
2623
  "args": {
2639
- "face_id": {
2640
- "description": "Face alias",
2641
- "name": "face_id",
2624
+ "team_id": {
2625
+ "description": "Team ID",
2626
+ "name": "team_id",
2642
2627
  "required": true
2643
2628
  }
2644
2629
  },
2645
- "description": "Edit a face's metadata",
2630
+ "description": "Add face(s) to a team",
2646
2631
  "flags": {
2647
2632
  "json": {
2648
2633
  "description": "Format output as json.",
@@ -2675,11 +2660,861 @@
2675
2660
  "multiple": false,
2676
2661
  "type": "option"
2677
2662
  },
2678
- "name": {
2679
- "description": "New display name",
2680
- "name": "name",
2663
+ "face": {
2664
+ "description": "Face alias to add (repeatable)",
2665
+ "name": "face",
2666
+ "required": true,
2681
2667
  "hasDynamicHelp": false,
2682
- "multiple": false,
2668
+ "multiple": true,
2669
+ "type": "option"
2670
+ }
2671
+ },
2672
+ "hasDynamicHelp": false,
2673
+ "hiddenAliases": [],
2674
+ "id": "team:add",
2675
+ "pluginAlias": "faces-cli",
2676
+ "pluginName": "faces-cli",
2677
+ "pluginType": "core",
2678
+ "strict": true,
2679
+ "enableJsonFlag": true,
2680
+ "isESM": true,
2681
+ "relativePath": [
2682
+ "dist",
2683
+ "commands",
2684
+ "team",
2685
+ "add.js"
2686
+ ]
2687
+ },
2688
+ "team:create": {
2689
+ "aliases": [],
2690
+ "args": {},
2691
+ "description": "Create a new team",
2692
+ "flags": {
2693
+ "json": {
2694
+ "description": "Format output as json.",
2695
+ "helpGroup": "GLOBAL",
2696
+ "name": "json",
2697
+ "allowNo": false,
2698
+ "type": "boolean"
2699
+ },
2700
+ "base-url": {
2701
+ "description": "API base URL",
2702
+ "env": "FACES_BASE_URL",
2703
+ "name": "base-url",
2704
+ "hasDynamicHelp": false,
2705
+ "multiple": false,
2706
+ "type": "option"
2707
+ },
2708
+ "token": {
2709
+ "description": "JWT bearer token",
2710
+ "env": "FACES_TOKEN",
2711
+ "name": "token",
2712
+ "hasDynamicHelp": false,
2713
+ "multiple": false,
2714
+ "type": "option"
2715
+ },
2716
+ "api-key": {
2717
+ "description": "API key",
2718
+ "env": "FACES_API_KEY",
2719
+ "name": "api-key",
2720
+ "hasDynamicHelp": false,
2721
+ "multiple": false,
2722
+ "type": "option"
2723
+ },
2724
+ "name": {
2725
+ "description": "Team name",
2726
+ "name": "name",
2727
+ "required": true,
2728
+ "hasDynamicHelp": false,
2729
+ "multiple": false,
2730
+ "type": "option"
2731
+ },
2732
+ "description": {
2733
+ "description": "Plain-text team description (max 1500 chars)",
2734
+ "name": "description",
2735
+ "hasDynamicHelp": false,
2736
+ "multiple": false,
2737
+ "type": "option"
2738
+ },
2739
+ "protocol": {
2740
+ "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
2741
+ "name": "protocol",
2742
+ "hasDynamicHelp": false,
2743
+ "multiple": false,
2744
+ "type": "option"
2745
+ },
2746
+ "protocol-file": {
2747
+ "description": "Read protocol from file",
2748
+ "name": "protocol-file",
2749
+ "hasDynamicHelp": false,
2750
+ "multiple": false,
2751
+ "type": "option"
2752
+ },
2753
+ "tag": {
2754
+ "description": "Tag label (repeatable, lowercase)",
2755
+ "name": "tag",
2756
+ "hasDynamicHelp": false,
2757
+ "multiple": true,
2758
+ "type": "option"
2759
+ }
2760
+ },
2761
+ "hasDynamicHelp": false,
2762
+ "hiddenAliases": [],
2763
+ "id": "team:create",
2764
+ "pluginAlias": "faces-cli",
2765
+ "pluginName": "faces-cli",
2766
+ "pluginType": "core",
2767
+ "strict": true,
2768
+ "enableJsonFlag": true,
2769
+ "isESM": true,
2770
+ "relativePath": [
2771
+ "dist",
2772
+ "commands",
2773
+ "team",
2774
+ "create.js"
2775
+ ]
2776
+ },
2777
+ "team:delete": {
2778
+ "aliases": [],
2779
+ "args": {
2780
+ "team_id": {
2781
+ "description": "Team ID",
2782
+ "name": "team_id",
2783
+ "required": true
2784
+ }
2785
+ },
2786
+ "description": "Delete a team",
2787
+ "flags": {
2788
+ "json": {
2789
+ "description": "Format output as json.",
2790
+ "helpGroup": "GLOBAL",
2791
+ "name": "json",
2792
+ "allowNo": false,
2793
+ "type": "boolean"
2794
+ },
2795
+ "base-url": {
2796
+ "description": "API base URL",
2797
+ "env": "FACES_BASE_URL",
2798
+ "name": "base-url",
2799
+ "hasDynamicHelp": false,
2800
+ "multiple": false,
2801
+ "type": "option"
2802
+ },
2803
+ "token": {
2804
+ "description": "JWT bearer token",
2805
+ "env": "FACES_TOKEN",
2806
+ "name": "token",
2807
+ "hasDynamicHelp": false,
2808
+ "multiple": false,
2809
+ "type": "option"
2810
+ },
2811
+ "api-key": {
2812
+ "description": "API key",
2813
+ "env": "FACES_API_KEY",
2814
+ "name": "api-key",
2815
+ "hasDynamicHelp": false,
2816
+ "multiple": false,
2817
+ "type": "option"
2818
+ },
2819
+ "yes": {
2820
+ "description": "Skip confirmation",
2821
+ "name": "yes",
2822
+ "allowNo": false,
2823
+ "type": "boolean"
2824
+ }
2825
+ },
2826
+ "hasDynamicHelp": false,
2827
+ "hiddenAliases": [],
2828
+ "id": "team:delete",
2829
+ "pluginAlias": "faces-cli",
2830
+ "pluginName": "faces-cli",
2831
+ "pluginType": "core",
2832
+ "strict": true,
2833
+ "enableJsonFlag": true,
2834
+ "isESM": true,
2835
+ "relativePath": [
2836
+ "dist",
2837
+ "commands",
2838
+ "team",
2839
+ "delete.js"
2840
+ ]
2841
+ },
2842
+ "team:edit": {
2843
+ "aliases": [],
2844
+ "args": {
2845
+ "team_id": {
2846
+ "description": "Team ID",
2847
+ "name": "team_id",
2848
+ "required": true
2849
+ }
2850
+ },
2851
+ "description": "Edit a team",
2852
+ "flags": {
2853
+ "json": {
2854
+ "description": "Format output as json.",
2855
+ "helpGroup": "GLOBAL",
2856
+ "name": "json",
2857
+ "allowNo": false,
2858
+ "type": "boolean"
2859
+ },
2860
+ "base-url": {
2861
+ "description": "API base URL",
2862
+ "env": "FACES_BASE_URL",
2863
+ "name": "base-url",
2864
+ "hasDynamicHelp": false,
2865
+ "multiple": false,
2866
+ "type": "option"
2867
+ },
2868
+ "token": {
2869
+ "description": "JWT bearer token",
2870
+ "env": "FACES_TOKEN",
2871
+ "name": "token",
2872
+ "hasDynamicHelp": false,
2873
+ "multiple": false,
2874
+ "type": "option"
2875
+ },
2876
+ "api-key": {
2877
+ "description": "API key",
2878
+ "env": "FACES_API_KEY",
2879
+ "name": "api-key",
2880
+ "hasDynamicHelp": false,
2881
+ "multiple": false,
2882
+ "type": "option"
2883
+ },
2884
+ "name": {
2885
+ "description": "New team name",
2886
+ "name": "name",
2887
+ "hasDynamicHelp": false,
2888
+ "multiple": false,
2889
+ "type": "option"
2890
+ },
2891
+ "description": {
2892
+ "description": "New description (max 1500 chars)",
2893
+ "name": "description",
2894
+ "hasDynamicHelp": false,
2895
+ "multiple": false,
2896
+ "type": "option"
2897
+ },
2898
+ "protocol": {
2899
+ "description": "New protocol content",
2900
+ "name": "protocol",
2901
+ "hasDynamicHelp": false,
2902
+ "multiple": false,
2903
+ "type": "option"
2904
+ },
2905
+ "protocol-file": {
2906
+ "description": "Read protocol from file",
2907
+ "name": "protocol-file",
2908
+ "hasDynamicHelp": false,
2909
+ "multiple": false,
2910
+ "type": "option"
2911
+ }
2912
+ },
2913
+ "hasDynamicHelp": false,
2914
+ "hiddenAliases": [],
2915
+ "id": "team:edit",
2916
+ "pluginAlias": "faces-cli",
2917
+ "pluginName": "faces-cli",
2918
+ "pluginType": "core",
2919
+ "strict": true,
2920
+ "enableJsonFlag": true,
2921
+ "isESM": true,
2922
+ "relativePath": [
2923
+ "dist",
2924
+ "commands",
2925
+ "team",
2926
+ "edit.js"
2927
+ ]
2928
+ },
2929
+ "team:get": {
2930
+ "aliases": [],
2931
+ "args": {
2932
+ "team_id": {
2933
+ "description": "Team ID",
2934
+ "name": "team_id",
2935
+ "required": true
2936
+ }
2937
+ },
2938
+ "description": "Get a team by ID",
2939
+ "flags": {
2940
+ "json": {
2941
+ "description": "Format output as json.",
2942
+ "helpGroup": "GLOBAL",
2943
+ "name": "json",
2944
+ "allowNo": false,
2945
+ "type": "boolean"
2946
+ },
2947
+ "base-url": {
2948
+ "description": "API base URL",
2949
+ "env": "FACES_BASE_URL",
2950
+ "name": "base-url",
2951
+ "hasDynamicHelp": false,
2952
+ "multiple": false,
2953
+ "type": "option"
2954
+ },
2955
+ "token": {
2956
+ "description": "JWT bearer token",
2957
+ "env": "FACES_TOKEN",
2958
+ "name": "token",
2959
+ "hasDynamicHelp": false,
2960
+ "multiple": false,
2961
+ "type": "option"
2962
+ },
2963
+ "api-key": {
2964
+ "description": "API key",
2965
+ "env": "FACES_API_KEY",
2966
+ "name": "api-key",
2967
+ "hasDynamicHelp": false,
2968
+ "multiple": false,
2969
+ "type": "option"
2970
+ }
2971
+ },
2972
+ "hasDynamicHelp": false,
2973
+ "hiddenAliases": [],
2974
+ "id": "team:get",
2975
+ "pluginAlias": "faces-cli",
2976
+ "pluginName": "faces-cli",
2977
+ "pluginType": "core",
2978
+ "strict": true,
2979
+ "enableJsonFlag": true,
2980
+ "isESM": true,
2981
+ "relativePath": [
2982
+ "dist",
2983
+ "commands",
2984
+ "team",
2985
+ "get.js"
2986
+ ]
2987
+ },
2988
+ "team:list": {
2989
+ "aliases": [],
2990
+ "args": {},
2991
+ "description": "List your teams",
2992
+ "flags": {
2993
+ "json": {
2994
+ "description": "Format output as json.",
2995
+ "helpGroup": "GLOBAL",
2996
+ "name": "json",
2997
+ "allowNo": false,
2998
+ "type": "boolean"
2999
+ },
3000
+ "base-url": {
3001
+ "description": "API base URL",
3002
+ "env": "FACES_BASE_URL",
3003
+ "name": "base-url",
3004
+ "hasDynamicHelp": false,
3005
+ "multiple": false,
3006
+ "type": "option"
3007
+ },
3008
+ "token": {
3009
+ "description": "JWT bearer token",
3010
+ "env": "FACES_TOKEN",
3011
+ "name": "token",
3012
+ "hasDynamicHelp": false,
3013
+ "multiple": false,
3014
+ "type": "option"
3015
+ },
3016
+ "api-key": {
3017
+ "description": "API key",
3018
+ "env": "FACES_API_KEY",
3019
+ "name": "api-key",
3020
+ "hasDynamicHelp": false,
3021
+ "multiple": false,
3022
+ "type": "option"
3023
+ }
3024
+ },
3025
+ "hasDynamicHelp": false,
3026
+ "hiddenAliases": [],
3027
+ "id": "team:list",
3028
+ "pluginAlias": "faces-cli",
3029
+ "pluginName": "faces-cli",
3030
+ "pluginType": "core",
3031
+ "strict": true,
3032
+ "enableJsonFlag": true,
3033
+ "isESM": true,
3034
+ "relativePath": [
3035
+ "dist",
3036
+ "commands",
3037
+ "team",
3038
+ "list.js"
3039
+ ]
3040
+ },
3041
+ "team:members": {
3042
+ "aliases": [],
3043
+ "args": {
3044
+ "team_id": {
3045
+ "description": "Team ID",
3046
+ "name": "team_id",
3047
+ "required": true
3048
+ }
3049
+ },
3050
+ "description": "List members of a team",
3051
+ "flags": {
3052
+ "json": {
3053
+ "description": "Format output as json.",
3054
+ "helpGroup": "GLOBAL",
3055
+ "name": "json",
3056
+ "allowNo": false,
3057
+ "type": "boolean"
3058
+ },
3059
+ "base-url": {
3060
+ "description": "API base URL",
3061
+ "env": "FACES_BASE_URL",
3062
+ "name": "base-url",
3063
+ "hasDynamicHelp": false,
3064
+ "multiple": false,
3065
+ "type": "option"
3066
+ },
3067
+ "token": {
3068
+ "description": "JWT bearer token",
3069
+ "env": "FACES_TOKEN",
3070
+ "name": "token",
3071
+ "hasDynamicHelp": false,
3072
+ "multiple": false,
3073
+ "type": "option"
3074
+ },
3075
+ "api-key": {
3076
+ "description": "API key",
3077
+ "env": "FACES_API_KEY",
3078
+ "name": "api-key",
3079
+ "hasDynamicHelp": false,
3080
+ "multiple": false,
3081
+ "type": "option"
3082
+ }
3083
+ },
3084
+ "hasDynamicHelp": false,
3085
+ "hiddenAliases": [],
3086
+ "id": "team:members",
3087
+ "pluginAlias": "faces-cli",
3088
+ "pluginName": "faces-cli",
3089
+ "pluginType": "core",
3090
+ "strict": true,
3091
+ "enableJsonFlag": true,
3092
+ "isESM": true,
3093
+ "relativePath": [
3094
+ "dist",
3095
+ "commands",
3096
+ "team",
3097
+ "members.js"
3098
+ ]
3099
+ },
3100
+ "team:remove": {
3101
+ "aliases": [],
3102
+ "args": {
3103
+ "team_id": {
3104
+ "description": "Team ID",
3105
+ "name": "team_id",
3106
+ "required": true
3107
+ },
3108
+ "alias": {
3109
+ "description": "Face alias to remove",
3110
+ "name": "alias",
3111
+ "required": true
3112
+ }
3113
+ },
3114
+ "description": "Remove a face from a team",
3115
+ "flags": {
3116
+ "json": {
3117
+ "description": "Format output as json.",
3118
+ "helpGroup": "GLOBAL",
3119
+ "name": "json",
3120
+ "allowNo": false,
3121
+ "type": "boolean"
3122
+ },
3123
+ "base-url": {
3124
+ "description": "API base URL",
3125
+ "env": "FACES_BASE_URL",
3126
+ "name": "base-url",
3127
+ "hasDynamicHelp": false,
3128
+ "multiple": false,
3129
+ "type": "option"
3130
+ },
3131
+ "token": {
3132
+ "description": "JWT bearer token",
3133
+ "env": "FACES_TOKEN",
3134
+ "name": "token",
3135
+ "hasDynamicHelp": false,
3136
+ "multiple": false,
3137
+ "type": "option"
3138
+ },
3139
+ "api-key": {
3140
+ "description": "API key",
3141
+ "env": "FACES_API_KEY",
3142
+ "name": "api-key",
3143
+ "hasDynamicHelp": false,
3144
+ "multiple": false,
3145
+ "type": "option"
3146
+ }
3147
+ },
3148
+ "hasDynamicHelp": false,
3149
+ "hiddenAliases": [],
3150
+ "id": "team:remove",
3151
+ "pluginAlias": "faces-cli",
3152
+ "pluginName": "faces-cli",
3153
+ "pluginType": "core",
3154
+ "strict": true,
3155
+ "enableJsonFlag": true,
3156
+ "isESM": true,
3157
+ "relativePath": [
3158
+ "dist",
3159
+ "commands",
3160
+ "team",
3161
+ "remove.js"
3162
+ ]
3163
+ },
3164
+ "face:attributes": {
3165
+ "aliases": [],
3166
+ "args": {},
3167
+ "description": "List all supported attribute keys",
3168
+ "flags": {
3169
+ "json": {
3170
+ "description": "Format output as json.",
3171
+ "helpGroup": "GLOBAL",
3172
+ "name": "json",
3173
+ "allowNo": false,
3174
+ "type": "boolean"
3175
+ },
3176
+ "base-url": {
3177
+ "description": "API base URL",
3178
+ "env": "FACES_BASE_URL",
3179
+ "name": "base-url",
3180
+ "hasDynamicHelp": false,
3181
+ "multiple": false,
3182
+ "type": "option"
3183
+ },
3184
+ "token": {
3185
+ "description": "JWT bearer token",
3186
+ "env": "FACES_TOKEN",
3187
+ "name": "token",
3188
+ "hasDynamicHelp": false,
3189
+ "multiple": false,
3190
+ "type": "option"
3191
+ },
3192
+ "api-key": {
3193
+ "description": "API key",
3194
+ "env": "FACES_API_KEY",
3195
+ "name": "api-key",
3196
+ "hasDynamicHelp": false,
3197
+ "multiple": false,
3198
+ "type": "option"
3199
+ }
3200
+ },
3201
+ "hasDynamicHelp": false,
3202
+ "hiddenAliases": [],
3203
+ "id": "face:attributes",
3204
+ "pluginAlias": "faces-cli",
3205
+ "pluginName": "faces-cli",
3206
+ "pluginType": "core",
3207
+ "strict": true,
3208
+ "enableJsonFlag": true,
3209
+ "isESM": true,
3210
+ "relativePath": [
3211
+ "dist",
3212
+ "commands",
3213
+ "face",
3214
+ "attributes.js"
3215
+ ]
3216
+ },
3217
+ "face:create": {
3218
+ "aliases": [],
3219
+ "args": {},
3220
+ "description": "Create a new face",
3221
+ "flags": {
3222
+ "json": {
3223
+ "description": "Format output as json.",
3224
+ "helpGroup": "GLOBAL",
3225
+ "name": "json",
3226
+ "allowNo": false,
3227
+ "type": "boolean"
3228
+ },
3229
+ "base-url": {
3230
+ "description": "API base URL",
3231
+ "env": "FACES_BASE_URL",
3232
+ "name": "base-url",
3233
+ "hasDynamicHelp": false,
3234
+ "multiple": false,
3235
+ "type": "option"
3236
+ },
3237
+ "token": {
3238
+ "description": "JWT bearer token",
3239
+ "env": "FACES_TOKEN",
3240
+ "name": "token",
3241
+ "hasDynamicHelp": false,
3242
+ "multiple": false,
3243
+ "type": "option"
3244
+ },
3245
+ "api-key": {
3246
+ "description": "API key",
3247
+ "env": "FACES_API_KEY",
3248
+ "name": "api-key",
3249
+ "hasDynamicHelp": false,
3250
+ "multiple": false,
3251
+ "type": "option"
3252
+ },
3253
+ "name": {
3254
+ "description": "Display name",
3255
+ "name": "name",
3256
+ "required": true,
3257
+ "hasDynamicHelp": false,
3258
+ "multiple": false,
3259
+ "type": "option"
3260
+ },
3261
+ "alias": {
3262
+ "description": "Unique alias slug",
3263
+ "name": "alias",
3264
+ "required": true,
3265
+ "hasDynamicHelp": false,
3266
+ "multiple": false,
3267
+ "type": "option"
3268
+ },
3269
+ "description": {
3270
+ "description": "Plain-text description / bio (max 1500 chars)",
3271
+ "name": "description",
3272
+ "hasDynamicHelp": false,
3273
+ "multiple": false,
3274
+ "type": "option"
3275
+ },
3276
+ "tag": {
3277
+ "description": "Tag label (repeatable, lowercase)",
3278
+ "name": "tag",
3279
+ "hasDynamicHelp": false,
3280
+ "multiple": true,
3281
+ "type": "option"
3282
+ },
3283
+ "default-model": {
3284
+ "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
3285
+ "name": "default-model",
3286
+ "hasDynamicHelp": false,
3287
+ "multiple": false,
3288
+ "type": "option"
3289
+ },
3290
+ "formula": {
3291
+ "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
3292
+ "name": "formula",
3293
+ "hasDynamicHelp": false,
3294
+ "multiple": false,
3295
+ "type": "option"
3296
+ },
3297
+ "attr": {
3298
+ "description": "Attribute KEY=VALUE (repeatable)",
3299
+ "name": "attr",
3300
+ "hasDynamicHelp": false,
3301
+ "multiple": true,
3302
+ "type": "option"
3303
+ },
3304
+ "tool": {
3305
+ "description": "Tool name to enable (repeatable)",
3306
+ "name": "tool",
3307
+ "hasDynamicHelp": false,
3308
+ "multiple": true,
3309
+ "type": "option"
3310
+ },
3311
+ "profile-addendum": {
3312
+ "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
3313
+ "name": "profile-addendum",
3314
+ "hasDynamicHelp": false,
3315
+ "multiple": false,
3316
+ "type": "option"
3317
+ },
3318
+ "profile-addendum-file": {
3319
+ "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
3320
+ "exclusive": [
3321
+ "profile-addendum"
3322
+ ],
3323
+ "name": "profile-addendum-file",
3324
+ "hasDynamicHelp": false,
3325
+ "multiple": false,
3326
+ "type": "option"
3327
+ }
3328
+ },
3329
+ "hasDynamicHelp": false,
3330
+ "hiddenAliases": [],
3331
+ "id": "face:create",
3332
+ "pluginAlias": "faces-cli",
3333
+ "pluginName": "faces-cli",
3334
+ "pluginType": "core",
3335
+ "strict": true,
3336
+ "enableJsonFlag": true,
3337
+ "isESM": true,
3338
+ "relativePath": [
3339
+ "dist",
3340
+ "commands",
3341
+ "face",
3342
+ "create.js"
3343
+ ]
3344
+ },
3345
+ "face:delete": {
3346
+ "aliases": [],
3347
+ "args": {
3348
+ "face_id": {
3349
+ "description": "Face alias",
3350
+ "name": "face_id",
3351
+ "required": true
3352
+ }
3353
+ },
3354
+ "description": "Delete a face permanently",
3355
+ "flags": {
3356
+ "json": {
3357
+ "description": "Format output as json.",
3358
+ "helpGroup": "GLOBAL",
3359
+ "name": "json",
3360
+ "allowNo": false,
3361
+ "type": "boolean"
3362
+ },
3363
+ "base-url": {
3364
+ "description": "API base URL",
3365
+ "env": "FACES_BASE_URL",
3366
+ "name": "base-url",
3367
+ "hasDynamicHelp": false,
3368
+ "multiple": false,
3369
+ "type": "option"
3370
+ },
3371
+ "token": {
3372
+ "description": "JWT bearer token",
3373
+ "env": "FACES_TOKEN",
3374
+ "name": "token",
3375
+ "hasDynamicHelp": false,
3376
+ "multiple": false,
3377
+ "type": "option"
3378
+ },
3379
+ "api-key": {
3380
+ "description": "API key",
3381
+ "env": "FACES_API_KEY",
3382
+ "name": "api-key",
3383
+ "hasDynamicHelp": false,
3384
+ "multiple": false,
3385
+ "type": "option"
3386
+ },
3387
+ "yes": {
3388
+ "description": "Skip confirmation",
3389
+ "name": "yes",
3390
+ "allowNo": false,
3391
+ "type": "boolean"
3392
+ }
3393
+ },
3394
+ "hasDynamicHelp": false,
3395
+ "hiddenAliases": [],
3396
+ "id": "face:delete",
3397
+ "pluginAlias": "faces-cli",
3398
+ "pluginName": "faces-cli",
3399
+ "pluginType": "core",
3400
+ "strict": true,
3401
+ "enableJsonFlag": true,
3402
+ "isESM": true,
3403
+ "relativePath": [
3404
+ "dist",
3405
+ "commands",
3406
+ "face",
3407
+ "delete.js"
3408
+ ]
3409
+ },
3410
+ "face:diff": {
3411
+ "aliases": [],
3412
+ "args": {},
3413
+ "description": "Compare owned faces pairwise across all centroid components",
3414
+ "flags": {
3415
+ "json": {
3416
+ "description": "Format output as json.",
3417
+ "helpGroup": "GLOBAL",
3418
+ "name": "json",
3419
+ "allowNo": false,
3420
+ "type": "boolean"
3421
+ },
3422
+ "base-url": {
3423
+ "description": "API base URL",
3424
+ "env": "FACES_BASE_URL",
3425
+ "name": "base-url",
3426
+ "hasDynamicHelp": false,
3427
+ "multiple": false,
3428
+ "type": "option"
3429
+ },
3430
+ "token": {
3431
+ "description": "JWT bearer token",
3432
+ "env": "FACES_TOKEN",
3433
+ "name": "token",
3434
+ "hasDynamicHelp": false,
3435
+ "multiple": false,
3436
+ "type": "option"
3437
+ },
3438
+ "api-key": {
3439
+ "description": "API key",
3440
+ "env": "FACES_API_KEY",
3441
+ "name": "api-key",
3442
+ "hasDynamicHelp": false,
3443
+ "multiple": false,
3444
+ "type": "option"
3445
+ },
3446
+ "face": {
3447
+ "description": "Face alias to include (repeatable, min 2)",
3448
+ "name": "face",
3449
+ "required": true,
3450
+ "hasDynamicHelp": false,
3451
+ "multiple": true,
3452
+ "type": "option"
3453
+ }
3454
+ },
3455
+ "hasDynamicHelp": false,
3456
+ "hiddenAliases": [],
3457
+ "id": "face:diff",
3458
+ "pluginAlias": "faces-cli",
3459
+ "pluginName": "faces-cli",
3460
+ "pluginType": "core",
3461
+ "strict": true,
3462
+ "enableJsonFlag": true,
3463
+ "isESM": true,
3464
+ "relativePath": [
3465
+ "dist",
3466
+ "commands",
3467
+ "face",
3468
+ "diff.js"
3469
+ ]
3470
+ },
3471
+ "face:edit": {
3472
+ "aliases": [],
3473
+ "args": {
3474
+ "face_id": {
3475
+ "description": "Face alias",
3476
+ "name": "face_id",
3477
+ "required": true
3478
+ }
3479
+ },
3480
+ "description": "Edit a face's metadata",
3481
+ "flags": {
3482
+ "json": {
3483
+ "description": "Format output as json.",
3484
+ "helpGroup": "GLOBAL",
3485
+ "name": "json",
3486
+ "allowNo": false,
3487
+ "type": "boolean"
3488
+ },
3489
+ "base-url": {
3490
+ "description": "API base URL",
3491
+ "env": "FACES_BASE_URL",
3492
+ "name": "base-url",
3493
+ "hasDynamicHelp": false,
3494
+ "multiple": false,
3495
+ "type": "option"
3496
+ },
3497
+ "token": {
3498
+ "description": "JWT bearer token",
3499
+ "env": "FACES_TOKEN",
3500
+ "name": "token",
3501
+ "hasDynamicHelp": false,
3502
+ "multiple": false,
3503
+ "type": "option"
3504
+ },
3505
+ "api-key": {
3506
+ "description": "API key",
3507
+ "env": "FACES_API_KEY",
3508
+ "name": "api-key",
3509
+ "hasDynamicHelp": false,
3510
+ "multiple": false,
3511
+ "type": "option"
3512
+ },
3513
+ "name": {
3514
+ "description": "New display name",
3515
+ "name": "name",
3516
+ "hasDynamicHelp": false,
3517
+ "multiple": false,
2683
3518
  "type": "option"
2684
3519
  },
2685
3520
  "description": {
@@ -2940,6 +3775,68 @@
2940
3775
  "list.js"
2941
3776
  ]
2942
3777
  },
3778
+ "face:lock": {
3779
+ "aliases": [],
3780
+ "args": {
3781
+ "face_id": {
3782
+ "description": "Face alias",
3783
+ "name": "face_id",
3784
+ "required": true
3785
+ }
3786
+ },
3787
+ "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.",
3788
+ "examples": [
3789
+ "<%= config.bin %> <%= command.id %> socrates"
3790
+ ],
3791
+ "flags": {
3792
+ "json": {
3793
+ "description": "Format output as json.",
3794
+ "helpGroup": "GLOBAL",
3795
+ "name": "json",
3796
+ "allowNo": false,
3797
+ "type": "boolean"
3798
+ },
3799
+ "base-url": {
3800
+ "description": "API base URL",
3801
+ "env": "FACES_BASE_URL",
3802
+ "name": "base-url",
3803
+ "hasDynamicHelp": false,
3804
+ "multiple": false,
3805
+ "type": "option"
3806
+ },
3807
+ "token": {
3808
+ "description": "JWT bearer token",
3809
+ "env": "FACES_TOKEN",
3810
+ "name": "token",
3811
+ "hasDynamicHelp": false,
3812
+ "multiple": false,
3813
+ "type": "option"
3814
+ },
3815
+ "api-key": {
3816
+ "description": "API key",
3817
+ "env": "FACES_API_KEY",
3818
+ "name": "api-key",
3819
+ "hasDynamicHelp": false,
3820
+ "multiple": false,
3821
+ "type": "option"
3822
+ }
3823
+ },
3824
+ "hasDynamicHelp": false,
3825
+ "hiddenAliases": [],
3826
+ "id": "face:lock",
3827
+ "pluginAlias": "faces-cli",
3828
+ "pluginName": "faces-cli",
3829
+ "pluginType": "core",
3830
+ "strict": true,
3831
+ "enableJsonFlag": true,
3832
+ "isESM": true,
3833
+ "relativePath": [
3834
+ "dist",
3835
+ "commands",
3836
+ "face",
3837
+ "lock.js"
3838
+ ]
3839
+ },
2943
3840
  "face:neighbors": {
2944
3841
  "aliases": [],
2945
3842
  "args": {
@@ -3153,7 +4050,7 @@
3153
4050
  "teams.js"
3154
4051
  ]
3155
4052
  },
3156
- "face:upload": {
4053
+ "face:unlock": {
3157
4054
  "aliases": [],
3158
4055
  "args": {
3159
4056
  "face_id": {
@@ -3162,7 +4059,10 @@
3162
4059
  "required": true
3163
4060
  }
3164
4061
  },
3165
- "description": "Upload a file (text/PDF/audio/video) to a face",
4062
+ "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
4063
+ "examples": [
4064
+ "<%= config.bin %> <%= command.id %> socrates"
4065
+ ],
3166
4066
  "flags": {
3167
4067
  "json": {
3168
4068
  "description": "Format output as json.",
@@ -3194,50 +4094,11 @@
3194
4094
  "hasDynamicHelp": false,
3195
4095
  "multiple": false,
3196
4096
  "type": "option"
3197
- },
3198
- "file": {
3199
- "description": "File to upload",
3200
- "name": "file",
3201
- "required": true,
3202
- "hasDynamicHelp": false,
3203
- "multiple": false,
3204
- "type": "option"
3205
- },
3206
- "kind": {
3207
- "description": "Upload kind: document or thread",
3208
- "name": "kind",
3209
- "default": "document",
3210
- "hasDynamicHelp": false,
3211
- "multiple": false,
3212
- "options": [
3213
- "document",
3214
- "thread"
3215
- ],
3216
- "type": "option"
3217
- },
3218
- "perspective": {
3219
- "description": "Perspective (document only)",
3220
- "name": "perspective",
3221
- "default": "third-person",
3222
- "hasDynamicHelp": false,
3223
- "multiple": false,
3224
- "options": [
3225
- "first-person",
3226
- "third-person"
3227
- ],
3228
- "type": "option"
3229
- },
3230
- "face-speaker": {
3231
- "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
3232
- "name": "face-speaker",
3233
- "hasDynamicHelp": false,
3234
- "multiple": false,
3235
- "type": "option"
3236
4097
  }
3237
4098
  },
3238
4099
  "hasDynamicHelp": false,
3239
4100
  "hiddenAliases": [],
3240
- "id": "face:upload",
4101
+ "id": "face:unlock",
3241
4102
  "pluginAlias": "faces-cli",
3242
4103
  "pluginName": "faces-cli",
3243
4104
  "pluginType": "core",
@@ -3248,13 +4109,19 @@
3248
4109
  "dist",
3249
4110
  "commands",
3250
4111
  "face",
3251
- "upload.js"
4112
+ "unlock.js"
3252
4113
  ]
3253
4114
  },
3254
- "keys:create": {
4115
+ "face:upload": {
3255
4116
  "aliases": [],
3256
- "args": {},
3257
- "description": "Create a new API key (JWT required). The new key is saved to ~/.faces/config.json as api_key by default; pass --no-save to skip.",
4117
+ "args": {
4118
+ "face_id": {
4119
+ "description": "Face alias",
4120
+ "name": "face_id",
4121
+ "required": true
4122
+ }
4123
+ },
4124
+ "description": "Upload a file (text/PDF/audio/video) to a face",
3258
4125
  "flags": {
3259
4126
  "json": {
3260
4127
  "description": "Format output as json.",
@@ -3287,97 +4154,41 @@
3287
4154
  "multiple": false,
3288
4155
  "type": "option"
3289
4156
  },
3290
- "name": {
3291
- "description": "Key name/label",
3292
- "name": "name",
4157
+ "file": {
4158
+ "description": "File to upload",
4159
+ "name": "file",
3293
4160
  "required": true,
3294
4161
  "hasDynamicHelp": false,
3295
4162
  "multiple": false,
3296
4163
  "type": "option"
3297
4164
  },
3298
- "expires-days": {
3299
- "description": "Expiry in days (omit for no expiry)",
3300
- "name": "expires-days",
3301
- "hasDynamicHelp": false,
3302
- "multiple": false,
3303
- "type": "option"
3304
- },
3305
- "budget": {
3306
- "description": "Spend budget in USD",
3307
- "name": "budget",
3308
- "hasDynamicHelp": false,
3309
- "multiple": false,
3310
- "type": "option"
3311
- },
3312
- "face": {
3313
- "description": "Allowed face alias (repeatable)",
3314
- "name": "face",
3315
- "hasDynamicHelp": false,
3316
- "multiple": true,
3317
- "type": "option"
3318
- },
3319
- "model": {
3320
- "description": "Allowed model name (repeatable)",
3321
- "name": "model",
3322
- "hasDynamicHelp": false,
3323
- "multiple": true,
3324
- "type": "option"
3325
- },
3326
- "save": {
3327
- "description": "Save the new key to ~/.faces/config.json as api_key (default: true; use --no-save to skip)",
3328
- "name": "save",
3329
- "allowNo": true,
3330
- "type": "boolean"
3331
- }
3332
- },
3333
- "hasDynamicHelp": false,
3334
- "hiddenAliases": [],
3335
- "id": "keys:create",
3336
- "pluginAlias": "faces-cli",
3337
- "pluginName": "faces-cli",
3338
- "pluginType": "core",
3339
- "strict": true,
3340
- "enableJsonFlag": true,
3341
- "isESM": true,
3342
- "relativePath": [
3343
- "dist",
3344
- "commands",
3345
- "keys",
3346
- "create.js"
3347
- ]
3348
- },
3349
- "keys:list": {
3350
- "aliases": [],
3351
- "args": {},
3352
- "description": "List all API keys (JWT required)",
3353
- "flags": {
3354
- "json": {
3355
- "description": "Format output as json.",
3356
- "helpGroup": "GLOBAL",
3357
- "name": "json",
3358
- "allowNo": false,
3359
- "type": "boolean"
3360
- },
3361
- "base-url": {
3362
- "description": "API base URL",
3363
- "env": "FACES_BASE_URL",
3364
- "name": "base-url",
4165
+ "kind": {
4166
+ "description": "Upload kind: document or thread",
4167
+ "name": "kind",
4168
+ "default": "document",
3365
4169
  "hasDynamicHelp": false,
3366
4170
  "multiple": false,
4171
+ "options": [
4172
+ "document",
4173
+ "thread"
4174
+ ],
3367
4175
  "type": "option"
3368
4176
  },
3369
- "token": {
3370
- "description": "JWT bearer token",
3371
- "env": "FACES_TOKEN",
3372
- "name": "token",
4177
+ "perspective": {
4178
+ "description": "Perspective (document only)",
4179
+ "name": "perspective",
4180
+ "default": "third-person",
3373
4181
  "hasDynamicHelp": false,
3374
4182
  "multiple": false,
4183
+ "options": [
4184
+ "first-person",
4185
+ "third-person"
4186
+ ],
3375
4187
  "type": "option"
3376
4188
  },
3377
- "api-key": {
3378
- "description": "API key",
3379
- "env": "FACES_API_KEY",
3380
- "name": "api-key",
4189
+ "face-speaker": {
4190
+ "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
4191
+ "name": "face-speaker",
3381
4192
  "hasDynamicHelp": false,
3382
4193
  "multiple": false,
3383
4194
  "type": "option"
@@ -3385,7 +4196,7 @@
3385
4196
  },
3386
4197
  "hasDynamicHelp": false,
3387
4198
  "hiddenAliases": [],
3388
- "id": "keys:list",
4199
+ "id": "face:upload",
3389
4200
  "pluginAlias": "faces-cli",
3390
4201
  "pluginName": "faces-cli",
3391
4202
  "pluginType": "core",
@@ -3395,20 +4206,23 @@
3395
4206
  "relativePath": [
3396
4207
  "dist",
3397
4208
  "commands",
3398
- "keys",
3399
- "list.js"
4209
+ "face",
4210
+ "upload.js"
3400
4211
  ]
3401
4212
  },
3402
- "keys:revoke": {
4213
+ "voiceprint:build-status": {
3403
4214
  "aliases": [],
3404
4215
  "args": {
3405
- "key_id": {
3406
- "description": "Key ID",
3407
- "name": "key_id",
4216
+ "job_id": {
4217
+ "description": "Build job id",
4218
+ "name": "job_id",
3408
4219
  "required": true
3409
4220
  }
3410
4221
  },
3411
- "description": "Revoke an API key (JWT required)",
4222
+ "description": "Get the status/result of a voiceprint build job (from voiceprint:build without --wait)",
4223
+ "examples": [
4224
+ "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
4225
+ ],
3412
4226
  "flags": {
3413
4227
  "json": {
3414
4228
  "description": "Format output as json.",
@@ -3440,17 +4254,11 @@
3440
4254
  "hasDynamicHelp": false,
3441
4255
  "multiple": false,
3442
4256
  "type": "option"
3443
- },
3444
- "yes": {
3445
- "description": "Skip confirmation",
3446
- "name": "yes",
3447
- "allowNo": false,
3448
- "type": "boolean"
3449
4257
  }
3450
4258
  },
3451
4259
  "hasDynamicHelp": false,
3452
4260
  "hiddenAliases": [],
3453
- "id": "keys:revoke",
4261
+ "id": "voiceprint:build-status",
3454
4262
  "pluginAlias": "faces-cli",
3455
4263
  "pluginName": "faces-cli",
3456
4264
  "pluginType": "core",
@@ -3460,20 +4268,24 @@
3460
4268
  "relativePath": [
3461
4269
  "dist",
3462
4270
  "commands",
3463
- "keys",
3464
- "revoke.js"
4271
+ "voiceprint",
4272
+ "build-status.js"
3465
4273
  ]
3466
4274
  },
3467
- "keys:update": {
4275
+ "voiceprint:build": {
3468
4276
  "aliases": [],
3469
4277
  "args": {
3470
- "key_id": {
3471
- "description": "Key ID",
3472
- "name": "key_id",
4278
+ "self_alias": {
4279
+ "description": "Self face alias",
4280
+ "name": "self_alias",
3473
4281
  "required": true
3474
4282
  }
3475
4283
  },
3476
- "description": "Update API key metadata (JWT required)",
4284
+ "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.",
4285
+ "examples": [
4286
+ "<%= config.bin %> <%= command.id %> alice --wait",
4287
+ "<%= config.bin %> <%= command.id %> alice --holdout-count 120 --oauth-only --wait"
4288
+ ],
3477
4289
  "flags": {
3478
4290
  "json": {
3479
4291
  "description": "Format output as json.",
@@ -3506,30 +4318,43 @@
3506
4318
  "multiple": false,
3507
4319
  "type": "option"
3508
4320
  },
3509
- "name": {
3510
- "description": "New key name",
3511
- "name": "name",
4321
+ "model": {
4322
+ "description": "Model that forges the voice map (default: gpt-5.4)",
4323
+ "name": "model",
3512
4324
  "hasDynamicHelp": false,
3513
4325
  "multiple": false,
3514
4326
  "type": "option"
3515
4327
  },
3516
- "budget": {
3517
- "description": "New spend budget in USD",
3518
- "name": "budget",
4328
+ "holdout-count": {
4329
+ "description": "Stratified scoring holdout size (default: 120)",
4330
+ "name": "holdout-count",
3519
4331
  "hasDynamicHelp": false,
3520
4332
  "multiple": false,
3521
4333
  "type": "option"
3522
4334
  },
3523
- "reset-spent": {
3524
- "description": "Reset spent amount to zero",
3525
- "name": "reset-spent",
4335
+ "min-valid": {
4336
+ "description": "Corpus floor below which no holdout is split — train on all (default: 550)",
4337
+ "name": "min-valid",
4338
+ "hasDynamicHelp": false,
4339
+ "multiple": false,
4340
+ "type": "option"
4341
+ },
4342
+ "oauth-only": {
4343
+ "description": "Only run on a free (OAuth) route; never fall back to billed inference",
4344
+ "name": "oauth-only",
4345
+ "allowNo": false,
4346
+ "type": "boolean"
4347
+ },
4348
+ "wait": {
4349
+ "description": "Block and poll until the build finishes (default: print the job_id and return)",
4350
+ "name": "wait",
3526
4351
  "allowNo": false,
3527
4352
  "type": "boolean"
3528
4353
  }
3529
4354
  },
3530
4355
  "hasDynamicHelp": false,
3531
4356
  "hiddenAliases": [],
3532
- "id": "keys:update",
4357
+ "id": "voiceprint:build",
3533
4358
  "pluginAlias": "faces-cli",
3534
4359
  "pluginName": "faces-cli",
3535
4360
  "pluginType": "core",
@@ -3539,20 +4364,23 @@
3539
4364
  "relativePath": [
3540
4365
  "dist",
3541
4366
  "commands",
3542
- "keys",
3543
- "update.js"
4367
+ "voiceprint",
4368
+ "build.js"
3544
4369
  ]
3545
4370
  },
3546
- "team:add": {
4371
+ "voiceprint:get": {
3547
4372
  "aliases": [],
3548
4373
  "args": {
3549
- "team_id": {
3550
- "description": "Team ID",
3551
- "name": "team_id",
4374
+ "job_id": {
4375
+ "description": "Scoring job id (from voiceprint:score --no-wait)",
4376
+ "name": "job_id",
3552
4377
  "required": true
3553
4378
  }
3554
4379
  },
3555
- "description": "Add face(s) to a team",
4380
+ "description": "Get the status/result of a voiceprint scoring job started with voiceprint:score --no-wait",
4381
+ "examples": [
4382
+ "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
4383
+ ],
3556
4384
  "flags": {
3557
4385
  "json": {
3558
4386
  "description": "Format output as json.",
@@ -3584,19 +4412,11 @@
3584
4412
  "hasDynamicHelp": false,
3585
4413
  "multiple": false,
3586
4414
  "type": "option"
3587
- },
3588
- "face": {
3589
- "description": "Face alias to add (repeatable)",
3590
- "name": "face",
3591
- "required": true,
3592
- "hasDynamicHelp": false,
3593
- "multiple": true,
3594
- "type": "option"
3595
4415
  }
3596
4416
  },
3597
4417
  "hasDynamicHelp": false,
3598
4418
  "hiddenAliases": [],
3599
- "id": "team:add",
4419
+ "id": "voiceprint:get",
3600
4420
  "pluginAlias": "faces-cli",
3601
4421
  "pluginName": "faces-cli",
3602
4422
  "pluginType": "core",
@@ -3606,14 +4426,23 @@
3606
4426
  "relativePath": [
3607
4427
  "dist",
3608
4428
  "commands",
3609
- "team",
3610
- "add.js"
4429
+ "voiceprint",
4430
+ "get.js"
3611
4431
  ]
3612
4432
  },
3613
- "team:create": {
4433
+ "voiceprint:refine-status": {
3614
4434
  "aliases": [],
3615
- "args": {},
3616
- "description": "Create a new team",
4435
+ "args": {
4436
+ "job_id": {
4437
+ "description": "Refine job id",
4438
+ "name": "job_id",
4439
+ "required": true
4440
+ }
4441
+ },
4442
+ "description": "Get the status/result of a voiceprint refine job (from voiceprint:refine without --wait)",
4443
+ "examples": [
4444
+ "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
4445
+ ],
3617
4446
  "flags": {
3618
4447
  "json": {
3619
4448
  "description": "Format output as json.",
@@ -3645,47 +4474,11 @@
3645
4474
  "hasDynamicHelp": false,
3646
4475
  "multiple": false,
3647
4476
  "type": "option"
3648
- },
3649
- "name": {
3650
- "description": "Team name",
3651
- "name": "name",
3652
- "required": true,
3653
- "hasDynamicHelp": false,
3654
- "multiple": false,
3655
- "type": "option"
3656
- },
3657
- "description": {
3658
- "description": "Plain-text team description (max 1500 chars)",
3659
- "name": "description",
3660
- "hasDynamicHelp": false,
3661
- "multiple": false,
3662
- "type": "option"
3663
- },
3664
- "protocol": {
3665
- "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
3666
- "name": "protocol",
3667
- "hasDynamicHelp": false,
3668
- "multiple": false,
3669
- "type": "option"
3670
- },
3671
- "protocol-file": {
3672
- "description": "Read protocol from file",
3673
- "name": "protocol-file",
3674
- "hasDynamicHelp": false,
3675
- "multiple": false,
3676
- "type": "option"
3677
- },
3678
- "tag": {
3679
- "description": "Tag label (repeatable, lowercase)",
3680
- "name": "tag",
3681
- "hasDynamicHelp": false,
3682
- "multiple": true,
3683
- "type": "option"
3684
4477
  }
3685
4478
  },
3686
4479
  "hasDynamicHelp": false,
3687
4480
  "hiddenAliases": [],
3688
- "id": "team:create",
4481
+ "id": "voiceprint:refine-status",
3689
4482
  "pluginAlias": "faces-cli",
3690
4483
  "pluginName": "faces-cli",
3691
4484
  "pluginType": "core",
@@ -3695,20 +4488,24 @@
3695
4488
  "relativePath": [
3696
4489
  "dist",
3697
4490
  "commands",
3698
- "team",
3699
- "create.js"
4491
+ "voiceprint",
4492
+ "refine-status.js"
3700
4493
  ]
3701
4494
  },
3702
- "team:delete": {
4495
+ "voiceprint:refine": {
3703
4496
  "aliases": [],
3704
4497
  "args": {
3705
- "team_id": {
3706
- "description": "Team ID",
3707
- "name": "team_id",
4498
+ "self_alias": {
4499
+ "description": "Self face alias",
4500
+ "name": "self_alias",
3708
4501
  "required": true
3709
4502
  }
3710
4503
  },
3711
- "description": "Delete a team",
4504
+ "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.",
4505
+ "examples": [
4506
+ "<%= config.bin %> <%= command.id %> alice --wait",
4507
+ "<%= config.bin %> <%= command.id %> alice --temperature 0.4 --n-samples 6 --wait"
4508
+ ],
3712
4509
  "flags": {
3713
4510
  "json": {
3714
4511
  "description": "Format output as json.",
@@ -3741,16 +4538,43 @@
3741
4538
  "multiple": false,
3742
4539
  "type": "option"
3743
4540
  },
3744
- "yes": {
3745
- "description": "Skip confirmation",
3746
- "name": "yes",
4541
+ "model": {
4542
+ "description": "Model used to forge candidate drafts (default: the active version's build model)",
4543
+ "name": "model",
4544
+ "hasDynamicHelp": false,
4545
+ "multiple": false,
4546
+ "type": "option"
4547
+ },
4548
+ "temperature": {
4549
+ "description": "Sampling temperature for candidate drafts (default: 0.4)",
4550
+ "name": "temperature",
4551
+ "hasDynamicHelp": false,
4552
+ "multiple": false,
4553
+ "type": "option"
4554
+ },
4555
+ "n-samples": {
4556
+ "description": "Drafts forged per holdout pair (default: 6)",
4557
+ "name": "n-samples",
4558
+ "hasDynamicHelp": false,
4559
+ "multiple": false,
4560
+ "type": "option"
4561
+ },
4562
+ "oauth-only": {
4563
+ "description": "Only run on a free (OAuth) route; never fall back to billed inference",
4564
+ "name": "oauth-only",
4565
+ "allowNo": false,
4566
+ "type": "boolean"
4567
+ },
4568
+ "wait": {
4569
+ "description": "Block and poll until refine finishes (default: print the job_id and return)",
4570
+ "name": "wait",
3747
4571
  "allowNo": false,
3748
4572
  "type": "boolean"
3749
4573
  }
3750
4574
  },
3751
4575
  "hasDynamicHelp": false,
3752
4576
  "hiddenAliases": [],
3753
- "id": "team:delete",
4577
+ "id": "voiceprint:refine",
3754
4578
  "pluginAlias": "faces-cli",
3755
4579
  "pluginName": "faces-cli",
3756
4580
  "pluginType": "core",
@@ -3760,20 +4584,23 @@
3760
4584
  "relativePath": [
3761
4585
  "dist",
3762
4586
  "commands",
3763
- "team",
3764
- "delete.js"
4587
+ "voiceprint",
4588
+ "refine.js"
3765
4589
  ]
3766
4590
  },
3767
- "team:edit": {
4591
+ "voiceprint:revert": {
3768
4592
  "aliases": [],
3769
4593
  "args": {
3770
- "team_id": {
3771
- "description": "Team ID",
3772
- "name": "team_id",
4594
+ "self_alias": {
4595
+ "description": "Self face alias",
4596
+ "name": "self_alias",
3773
4597
  "required": true
3774
4598
  }
3775
4599
  },
3776
- "description": "Edit a team",
4600
+ "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.",
4601
+ "examples": [
4602
+ "<%= config.bin %> <%= command.id %> alice"
4603
+ ],
3777
4604
  "flags": {
3778
4605
  "json": {
3779
4606
  "description": "Format output as json.",
@@ -3805,39 +4632,11 @@
3805
4632
  "hasDynamicHelp": false,
3806
4633
  "multiple": false,
3807
4634
  "type": "option"
3808
- },
3809
- "name": {
3810
- "description": "New team name",
3811
- "name": "name",
3812
- "hasDynamicHelp": false,
3813
- "multiple": false,
3814
- "type": "option"
3815
- },
3816
- "description": {
3817
- "description": "New description (max 1500 chars)",
3818
- "name": "description",
3819
- "hasDynamicHelp": false,
3820
- "multiple": false,
3821
- "type": "option"
3822
- },
3823
- "protocol": {
3824
- "description": "New protocol content",
3825
- "name": "protocol",
3826
- "hasDynamicHelp": false,
3827
- "multiple": false,
3828
- "type": "option"
3829
- },
3830
- "protocol-file": {
3831
- "description": "Read protocol from file",
3832
- "name": "protocol-file",
3833
- "hasDynamicHelp": false,
3834
- "multiple": false,
3835
- "type": "option"
3836
4635
  }
3837
4636
  },
3838
4637
  "hasDynamicHelp": false,
3839
4638
  "hiddenAliases": [],
3840
- "id": "team:edit",
4639
+ "id": "voiceprint:revert",
3841
4640
  "pluginAlias": "faces-cli",
3842
4641
  "pluginName": "faces-cli",
3843
4642
  "pluginType": "core",
@@ -3847,20 +4646,23 @@
3847
4646
  "relativePath": [
3848
4647
  "dist",
3849
4648
  "commands",
3850
- "team",
3851
- "edit.js"
4649
+ "voiceprint",
4650
+ "revert.js"
3852
4651
  ]
3853
4652
  },
3854
- "team:get": {
4653
+ "voiceprint:score-status": {
3855
4654
  "aliases": [],
3856
4655
  "args": {
3857
- "team_id": {
3858
- "description": "Team ID",
3859
- "name": "team_id",
4656
+ "job_id": {
4657
+ "description": "Scoring job id",
4658
+ "name": "job_id",
3860
4659
  "required": true
3861
4660
  }
3862
4661
  },
3863
- "description": "Get a team by ID",
4662
+ "description": "Get the status/result of a voiceprint scoring job (from voiceprint:score without --wait)",
4663
+ "examples": [
4664
+ "<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d"
4665
+ ],
3864
4666
  "flags": {
3865
4667
  "json": {
3866
4668
  "description": "Format output as json.",
@@ -3896,7 +4698,7 @@
3896
4698
  },
3897
4699
  "hasDynamicHelp": false,
3898
4700
  "hiddenAliases": [],
3899
- "id": "team:get",
4701
+ "id": "voiceprint:score-status",
3900
4702
  "pluginAlias": "faces-cli",
3901
4703
  "pluginName": "faces-cli",
3902
4704
  "pluginType": "core",
@@ -3906,14 +4708,25 @@
3906
4708
  "relativePath": [
3907
4709
  "dist",
3908
4710
  "commands",
3909
- "team",
3910
- "get.js"
4711
+ "voiceprint",
4712
+ "score-status.js"
3911
4713
  ]
3912
4714
  },
3913
- "team:list": {
4715
+ "voiceprint:score": {
3914
4716
  "aliases": [],
3915
- "args": {},
3916
- "description": "List your teams",
4717
+ "args": {
4718
+ "face": {
4719
+ "description": "Face to score (alias, owner:alias, or a union like \"(alice-voiceprint | alice)\")",
4720
+ "name": "face",
4721
+ "required": true
4722
+ }
4723
+ },
4724
+ "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.",
4725
+ "examples": [
4726
+ "<%= config.bin %> <%= command.id %> \"(alice-voiceprint | alice)\" --emails ./sent.jsonl --wait",
4727
+ "<%= config.bin %> <%= command.id %> alice --emails-dir ./sent-emails/ --wait",
4728
+ "<%= config.bin %> <%= command.id %> alice --emails ./sent.json # prints job_id; poll with voiceprint:score-status"
4729
+ ],
3917
4730
  "flags": {
3918
4731
  "json": {
3919
4732
  "description": "Format output as json.",
@@ -3945,11 +4758,55 @@
3945
4758
  "hasDynamicHelp": false,
3946
4759
  "multiple": false,
3947
4760
  "type": "option"
4761
+ },
4762
+ "emails": {
4763
+ "description": "JSON or JSONL file of the person's real writing — {id?, text} objects or plain strings (provide at least 20)",
4764
+ "name": "emails",
4765
+ "hasDynamicHelp": false,
4766
+ "multiple": false,
4767
+ "type": "option"
4768
+ },
4769
+ "emails-dir": {
4770
+ "description": "Directory with one sample per file (id = filename). Alternative to --emails.",
4771
+ "exclusive": [
4772
+ "emails"
4773
+ ],
4774
+ "name": "emails-dir",
4775
+ "hasDynamicHelp": false,
4776
+ "multiple": false,
4777
+ "type": "option"
4778
+ },
4779
+ "author-corpus": {
4780
+ "description": "Optional larger reference of the person's writing (JSON/JSONL/dir) used to define their voice; defaults to --emails",
4781
+ "name": "author-corpus",
4782
+ "hasDynamicHelp": false,
4783
+ "multiple": false,
4784
+ "type": "option"
4785
+ },
4786
+ "model": {
4787
+ "description": "Model used to generate comparison drafts",
4788
+ "name": "model",
4789
+ "default": "gpt-5.4",
4790
+ "hasDynamicHelp": false,
4791
+ "multiple": false,
4792
+ "type": "option"
4793
+ },
4794
+ "oauth-only": {
4795
+ "description": "Only run when a free (OAuth) model route is available; never fall back to billed inference",
4796
+ "name": "oauth-only",
4797
+ "allowNo": false,
4798
+ "type": "boolean"
4799
+ },
4800
+ "wait": {
4801
+ "description": "Block and poll until the score is ready, then print it (default: print the job_id and return)",
4802
+ "name": "wait",
4803
+ "allowNo": false,
4804
+ "type": "boolean"
3948
4805
  }
3949
4806
  },
3950
4807
  "hasDynamicHelp": false,
3951
4808
  "hiddenAliases": [],
3952
- "id": "team:list",
4809
+ "id": "voiceprint:score",
3953
4810
  "pluginAlias": "faces-cli",
3954
4811
  "pluginName": "faces-cli",
3955
4812
  "pluginType": "core",
@@ -3959,20 +4816,29 @@
3959
4816
  "relativePath": [
3960
4817
  "dist",
3961
4818
  "commands",
3962
- "team",
3963
- "list.js"
4819
+ "voiceprint",
4820
+ "score.js"
3964
4821
  ]
3965
4822
  },
3966
- "team:members": {
4823
+ "voiceprint:upload": {
3967
4824
  "aliases": [],
3968
4825
  "args": {
3969
- "team_id": {
3970
- "description": "Team ID",
3971
- "name": "team_id",
4826
+ "self_alias": {
4827
+ "description": "Self face alias",
4828
+ "name": "self_alias",
4829
+ "required": true
4830
+ },
4831
+ "file": {
4832
+ "description": "Corpus file (JSON array for thread_json, JSONL for email_jsonl)",
4833
+ "name": "file",
3972
4834
  "required": true
3973
4835
  }
3974
4836
  },
3975
- "description": "List members of a team",
4837
+ "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.",
4838
+ "examples": [
4839
+ "<%= config.bin %> <%= command.id %> alice ./corpus.json",
4840
+ "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --type email_jsonl --emails-per-thread 50"
4841
+ ],
3976
4842
  "flags": {
3977
4843
  "json": {
3978
4844
  "description": "Format output as json.",
@@ -4004,11 +4870,31 @@
4004
4870
  "hasDynamicHelp": false,
4005
4871
  "multiple": false,
4006
4872
  "type": "option"
4873
+ },
4874
+ "type": {
4875
+ "description": "thread_json: a JSON array of canonical email objects → one room. email_jsonl: JSONL (one email/line) → chunked into several rooms.",
4876
+ "name": "type",
4877
+ "default": "thread_json",
4878
+ "hasDynamicHelp": false,
4879
+ "multiple": false,
4880
+ "options": [
4881
+ "thread_json",
4882
+ "email_jsonl"
4883
+ ],
4884
+ "type": "option"
4885
+ },
4886
+ "emails-per-thread": {
4887
+ "description": "For --type email_jsonl: emails per room (default 50)",
4888
+ "name": "emails-per-thread",
4889
+ "default": 50,
4890
+ "hasDynamicHelp": false,
4891
+ "multiple": false,
4892
+ "type": "option"
4007
4893
  }
4008
4894
  },
4009
4895
  "hasDynamicHelp": false,
4010
4896
  "hiddenAliases": [],
4011
- "id": "team:members",
4897
+ "id": "voiceprint:upload",
4012
4898
  "pluginAlias": "faces-cli",
4013
4899
  "pluginName": "faces-cli",
4014
4900
  "pluginType": "core",
@@ -4018,25 +4904,23 @@
4018
4904
  "relativePath": [
4019
4905
  "dist",
4020
4906
  "commands",
4021
- "team",
4022
- "members.js"
4907
+ "voiceprint",
4908
+ "upload.js"
4023
4909
  ]
4024
4910
  },
4025
- "team:remove": {
4911
+ "voiceprint:versions": {
4026
4912
  "aliases": [],
4027
4913
  "args": {
4028
- "team_id": {
4029
- "description": "Team ID",
4030
- "name": "team_id",
4031
- "required": true
4032
- },
4033
- "alias": {
4034
- "description": "Face alias to remove",
4035
- "name": "alias",
4914
+ "self_alias": {
4915
+ "description": "Self face alias",
4916
+ "name": "self_alias",
4036
4917
  "required": true
4037
4918
  }
4038
4919
  },
4039
- "description": "Remove a face from a team",
4920
+ "description": "List a self face's voice-map versions (active + one prior). Retention is one-deep; toggle with voiceprint:revert.",
4921
+ "examples": [
4922
+ "<%= config.bin %> <%= command.id %> alice"
4923
+ ],
4040
4924
  "flags": {
4041
4925
  "json": {
4042
4926
  "description": "Format output as json.",
@@ -4072,7 +4956,7 @@
4072
4956
  },
4073
4957
  "hasDynamicHelp": false,
4074
4958
  "hiddenAliases": [],
4075
- "id": "team:remove",
4959
+ "id": "voiceprint:versions",
4076
4960
  "pluginAlias": "faces-cli",
4077
4961
  "pluginName": "faces-cli",
4078
4962
  "pluginType": "core",
@@ -4082,8 +4966,8 @@
4082
4966
  "relativePath": [
4083
4967
  "dist",
4084
4968
  "commands",
4085
- "team",
4086
- "remove.js"
4969
+ "voiceprint",
4970
+ "versions.js"
4087
4971
  ]
4088
4972
  },
4089
4973
  "billing:subscription:activate": {
@@ -4211,7 +5095,7 @@
4211
5095
  "cancel.js"
4212
5096
  ]
4213
5097
  },
4214
- "compile:thread:create": {
5098
+ "compile:doc:create": {
4215
5099
  "aliases": [],
4216
5100
  "args": {
4217
5101
  "face_id": {
@@ -4220,7 +5104,7 @@
4220
5104
  "required": true
4221
5105
  }
4222
5106
  },
4223
- "description": "Start a new thread for a face",
5107
+ "description": "Submit a document to a face",
4224
5108
  "flags": {
4225
5109
  "json": {
4226
5110
  "description": "Format output as json.",
@@ -4254,22 +5138,42 @@
4254
5138
  "type": "option"
4255
5139
  },
4256
5140
  "label": {
4257
- "description": "Thread label",
5141
+ "description": "Document label/title",
4258
5142
  "name": "label",
4259
5143
  "hasDynamicHelp": false,
4260
5144
  "multiple": false,
4261
5145
  "type": "option"
4262
5146
  },
4263
- "oauth-only": {
4264
- "description": "Prevent fallback to paid system key (use OAuth only)",
4265
- "name": "oauth-only",
4266
- "allowNo": false,
4267
- "type": "boolean"
5147
+ "content": {
5148
+ "description": "Inline text content",
5149
+ "name": "content",
5150
+ "hasDynamicHelp": false,
5151
+ "multiple": false,
5152
+ "type": "option"
5153
+ },
5154
+ "file": {
5155
+ "description": "Read content from file",
5156
+ "name": "file",
5157
+ "hasDynamicHelp": false,
5158
+ "multiple": false,
5159
+ "type": "option"
5160
+ },
5161
+ "perspective": {
5162
+ "description": "Perspective (first-person or third-person)",
5163
+ "name": "perspective",
5164
+ "default": "first-person",
5165
+ "hasDynamicHelp": false,
5166
+ "multiple": false,
5167
+ "options": [
5168
+ "first-person",
5169
+ "third-person"
5170
+ ],
5171
+ "type": "option"
4268
5172
  }
4269
5173
  },
4270
5174
  "hasDynamicHelp": false,
4271
5175
  "hiddenAliases": [],
4272
- "id": "compile:thread:create",
5176
+ "id": "compile:doc:create",
4273
5177
  "pluginAlias": "faces-cli",
4274
5178
  "pluginName": "faces-cli",
4275
5179
  "pluginType": "core",
@@ -4280,20 +5184,20 @@
4280
5184
  "dist",
4281
5185
  "commands",
4282
5186
  "compile",
4283
- "thread",
5187
+ "doc",
4284
5188
  "create.js"
4285
5189
  ]
4286
5190
  },
4287
- "compile:thread:delete": {
5191
+ "compile:doc:delete": {
4288
5192
  "aliases": [],
4289
5193
  "args": {
4290
- "thread_id": {
4291
- "description": "Thread ID",
4292
- "name": "thread_id",
5194
+ "doc_id": {
5195
+ "description": "Document ID",
5196
+ "name": "doc_id",
4293
5197
  "required": true
4294
5198
  }
4295
5199
  },
4296
- "description": "Delete a thread",
5200
+ "description": "Delete a document",
4297
5201
  "flags": {
4298
5202
  "json": {
4299
5203
  "description": "Format output as json.",
@@ -4325,17 +5229,11 @@
4325
5229
  "hasDynamicHelp": false,
4326
5230
  "multiple": false,
4327
5231
  "type": "option"
4328
- },
4329
- "yes": {
4330
- "description": "Skip confirmation",
4331
- "name": "yes",
4332
- "allowNo": false,
4333
- "type": "boolean"
4334
5232
  }
4335
5233
  },
4336
5234
  "hasDynamicHelp": false,
4337
5235
  "hiddenAliases": [],
4338
- "id": "compile:thread:delete",
5236
+ "id": "compile:doc:delete",
4339
5237
  "pluginAlias": "faces-cli",
4340
5238
  "pluginName": "faces-cli",
4341
5239
  "pluginType": "core",
@@ -4346,20 +5244,20 @@
4346
5244
  "dist",
4347
5245
  "commands",
4348
5246
  "compile",
4349
- "thread",
5247
+ "doc",
4350
5248
  "delete.js"
4351
5249
  ]
4352
5250
  },
4353
- "compile:thread:edit": {
5251
+ "compile:doc:edit": {
4354
5252
  "aliases": [],
4355
5253
  "args": {
4356
- "thread_id": {
4357
- "description": "Thread ID",
4358
- "name": "thread_id",
5254
+ "doc_id": {
5255
+ "description": "Document ID",
5256
+ "name": "doc_id",
4359
5257
  "required": true
4360
5258
  }
4361
5259
  },
4362
- "description": "Edit a thread (label and/or reassign face speaker)",
5260
+ "description": "Edit a document (label, content, or perspective)",
4363
5261
  "flags": {
4364
5262
  "json": {
4365
5263
  "description": "Format output as json.",
@@ -4393,23 +5291,41 @@
4393
5291
  "type": "option"
4394
5292
  },
4395
5293
  "label": {
4396
- "description": "New thread label",
5294
+ "description": "New label/title",
4397
5295
  "name": "label",
4398
5296
  "hasDynamicHelp": false,
4399
5297
  "multiple": false,
4400
5298
  "type": "option"
4401
5299
  },
4402
- "face-speaker": {
4403
- "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
4404
- "name": "face-speaker",
5300
+ "content": {
5301
+ "description": "New inline text content",
5302
+ "name": "content",
4405
5303
  "hasDynamicHelp": false,
4406
5304
  "multiple": false,
4407
5305
  "type": "option"
5306
+ },
5307
+ "file": {
5308
+ "description": "Read new content from file",
5309
+ "name": "file",
5310
+ "hasDynamicHelp": false,
5311
+ "multiple": false,
5312
+ "type": "option"
5313
+ },
5314
+ "perspective": {
5315
+ "description": "Perspective (first-person or third-person)",
5316
+ "name": "perspective",
5317
+ "hasDynamicHelp": false,
5318
+ "multiple": false,
5319
+ "options": [
5320
+ "first-person",
5321
+ "third-person"
5322
+ ],
5323
+ "type": "option"
4408
5324
  }
4409
5325
  },
4410
5326
  "hasDynamicHelp": false,
4411
5327
  "hiddenAliases": [],
4412
- "id": "compile:thread:edit",
5328
+ "id": "compile:doc:edit",
4413
5329
  "pluginAlias": "faces-cli",
4414
5330
  "pluginName": "faces-cli",
4415
5331
  "pluginType": "core",
@@ -4420,20 +5336,20 @@
4420
5336
  "dist",
4421
5337
  "commands",
4422
5338
  "compile",
4423
- "thread",
5339
+ "doc",
4424
5340
  "edit.js"
4425
5341
  ]
4426
5342
  },
4427
- "compile:thread:get": {
5343
+ "compile:doc:get": {
4428
5344
  "aliases": [],
4429
5345
  "args": {
4430
- "thread_id": {
4431
- "description": "Thread ID",
4432
- "name": "thread_id",
5346
+ "doc_id": {
5347
+ "description": "Document ID",
5348
+ "name": "doc_id",
4433
5349
  "required": true
4434
5350
  }
4435
5351
  },
4436
- "description": "Get a thread by ID",
5352
+ "description": "Get a document by ID",
4437
5353
  "flags": {
4438
5354
  "json": {
4439
5355
  "description": "Format output as json.",
@@ -4469,7 +5385,7 @@
4469
5385
  },
4470
5386
  "hasDynamicHelp": false,
4471
5387
  "hiddenAliases": [],
4472
- "id": "compile:thread:get",
5388
+ "id": "compile:doc:get",
4473
5389
  "pluginAlias": "faces-cli",
4474
5390
  "pluginName": "faces-cli",
4475
5391
  "pluginType": "core",
@@ -4480,11 +5396,11 @@
4480
5396
  "dist",
4481
5397
  "commands",
4482
5398
  "compile",
4483
- "thread",
5399
+ "doc",
4484
5400
  "get.js"
4485
5401
  ]
4486
5402
  },
4487
- "compile:thread:list": {
5403
+ "compile:doc": {
4488
5404
  "aliases": [],
4489
5405
  "args": {
4490
5406
  "face_id": {
@@ -4493,7 +5409,7 @@
4493
5409
  "required": true
4494
5410
  }
4495
5411
  },
4496
- "description": "List threads for a face",
5412
+ "description": "Compile a document into a face (create → make in one step)",
4497
5413
  "flags": {
4498
5414
  "json": {
4499
5415
  "description": "Format output as json.",
@@ -4525,11 +5441,58 @@
4525
5441
  "hasDynamicHelp": false,
4526
5442
  "multiple": false,
4527
5443
  "type": "option"
5444
+ },
5445
+ "label": {
5446
+ "description": "Document label/title",
5447
+ "name": "label",
5448
+ "hasDynamicHelp": false,
5449
+ "multiple": false,
5450
+ "type": "option"
5451
+ },
5452
+ "content": {
5453
+ "description": "Inline text content",
5454
+ "name": "content",
5455
+ "hasDynamicHelp": false,
5456
+ "multiple": false,
5457
+ "type": "option"
5458
+ },
5459
+ "file": {
5460
+ "description": "Read content from file",
5461
+ "name": "file",
5462
+ "hasDynamicHelp": false,
5463
+ "multiple": false,
5464
+ "type": "option"
5465
+ },
5466
+ "perspective": {
5467
+ "description": "Perspective",
5468
+ "name": "perspective",
5469
+ "default": "first-person",
5470
+ "hasDynamicHelp": false,
5471
+ "multiple": false,
5472
+ "options": [
5473
+ "first-person",
5474
+ "third-person"
5475
+ ],
5476
+ "type": "option"
5477
+ },
5478
+ "timeout": {
5479
+ "description": "Compile timeout in seconds (default: 600)",
5480
+ "name": "timeout",
5481
+ "default": 600,
5482
+ "hasDynamicHelp": false,
5483
+ "multiple": false,
5484
+ "type": "option"
5485
+ },
5486
+ "no-wait": {
5487
+ "description": "Create and trigger compilation, then return immediately without polling.",
5488
+ "name": "no-wait",
5489
+ "allowNo": false,
5490
+ "type": "boolean"
4528
5491
  }
4529
5492
  },
4530
5493
  "hasDynamicHelp": false,
4531
5494
  "hiddenAliases": [],
4532
- "id": "compile:thread:list",
5495
+ "id": "compile:doc",
4533
5496
  "pluginAlias": "faces-cli",
4534
5497
  "pluginName": "faces-cli",
4535
5498
  "pluginType": "core",
@@ -4540,20 +5503,20 @@
4540
5503
  "dist",
4541
5504
  "commands",
4542
5505
  "compile",
4543
- "thread",
4544
- "list.js"
5506
+ "doc",
5507
+ "index.js"
4545
5508
  ]
4546
5509
  },
4547
- "compile:thread:make": {
5510
+ "compile:doc:list": {
4548
5511
  "aliases": [],
4549
5512
  "args": {
4550
- "thread_id": {
4551
- "description": "Thread ID",
4552
- "name": "thread_id",
5513
+ "face_id": {
5514
+ "description": "Face alias",
5515
+ "name": "face_id",
4553
5516
  "required": true
4554
5517
  }
4555
5518
  },
4556
- "description": "Compile an existing thread (prepare + sync in one step)",
5519
+ "description": "List documents for a face",
4557
5520
  "flags": {
4558
5521
  "json": {
4559
5522
  "description": "Format output as json.",
@@ -4585,25 +5548,11 @@
4585
5548
  "hasDynamicHelp": false,
4586
5549
  "multiple": false,
4587
5550
  "type": "option"
4588
- },
4589
- "timeout": {
4590
- "description": "Compile timeout in seconds (default: 600)",
4591
- "name": "timeout",
4592
- "default": 600,
4593
- "hasDynamicHelp": false,
4594
- "multiple": false,
4595
- "type": "option"
4596
- },
4597
- "no-wait": {
4598
- "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
4599
- "name": "no-wait",
4600
- "allowNo": false,
4601
- "type": "boolean"
4602
5551
  }
4603
5552
  },
4604
5553
  "hasDynamicHelp": false,
4605
5554
  "hiddenAliases": [],
4606
- "id": "compile:thread:make",
5555
+ "id": "compile:doc:list",
4607
5556
  "pluginAlias": "faces-cli",
4608
5557
  "pluginName": "faces-cli",
4609
5558
  "pluginType": "core",
@@ -4614,20 +5563,20 @@
4614
5563
  "dist",
4615
5564
  "commands",
4616
5565
  "compile",
4617
- "thread",
4618
- "make.js"
5566
+ "doc",
5567
+ "list.js"
4619
5568
  ]
4620
5569
  },
4621
- "compile:thread:message": {
5570
+ "compile:doc:make": {
4622
5571
  "aliases": [],
4623
5572
  "args": {
4624
- "thread_id": {
4625
- "description": "Thread ID",
4626
- "name": "thread_id",
5573
+ "doc_id": {
5574
+ "description": "Document ID",
5575
+ "name": "doc_id",
4627
5576
  "required": true
4628
5577
  }
4629
5578
  },
4630
- "description": "Send a user message to a thread",
5579
+ "description": "Compile an existing document (prepare + sync in one step)",
4631
5580
  "flags": {
4632
5581
  "json": {
4633
5582
  "description": "Format output as json.",
@@ -4660,25 +5609,24 @@
4660
5609
  "multiple": false,
4661
5610
  "type": "option"
4662
5611
  },
4663
- "message": {
4664
- "char": "m",
4665
- "description": "User message to append",
4666
- "name": "message",
4667
- "required": true,
5612
+ "timeout": {
5613
+ "description": "Compile timeout in seconds (default: 600)",
5614
+ "name": "timeout",
5615
+ "default": 600,
4668
5616
  "hasDynamicHelp": false,
4669
5617
  "multiple": false,
4670
5618
  "type": "option"
4671
5619
  },
4672
- "oauth-only": {
4673
- "description": "Prevent fallback to paid system key (use OAuth only)",
4674
- "name": "oauth-only",
5620
+ "no-wait": {
5621
+ "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
5622
+ "name": "no-wait",
4675
5623
  "allowNo": false,
4676
5624
  "type": "boolean"
4677
5625
  }
4678
5626
  },
4679
5627
  "hasDynamicHelp": false,
4680
5628
  "hiddenAliases": [],
4681
- "id": "compile:thread:message",
5629
+ "id": "compile:doc:make",
4682
5630
  "pluginAlias": "faces-cli",
4683
5631
  "pluginName": "faces-cli",
4684
5632
  "pluginType": "core",
@@ -4689,20 +5637,20 @@
4689
5637
  "dist",
4690
5638
  "commands",
4691
5639
  "compile",
4692
- "thread",
4693
- "message.js"
5640
+ "doc",
5641
+ "make.js"
4694
5642
  ]
4695
5643
  },
4696
- "compile:thread:pause": {
5644
+ "compile:doc:pause": {
4697
5645
  "aliases": [],
4698
5646
  "args": {
4699
- "thread_id": {
4700
- "description": "Thread ID",
4701
- "name": "thread_id",
5647
+ "doc_id": {
5648
+ "description": "Document ID",
5649
+ "name": "doc_id",
4702
5650
  "required": true
4703
5651
  }
4704
5652
  },
4705
- "description": "Pause a running thread compilation (preserves progress, resume with make)",
5653
+ "description": "Pause a running document compilation (preserves progress, resume with make)",
4706
5654
  "flags": {
4707
5655
  "json": {
4708
5656
  "description": "Format output as json.",
@@ -4738,7 +5686,7 @@
4738
5686
  },
4739
5687
  "hasDynamicHelp": false,
4740
5688
  "hiddenAliases": [],
4741
- "id": "compile:thread:pause",
5689
+ "id": "compile:doc:pause",
4742
5690
  "pluginAlias": "faces-cli",
4743
5691
  "pluginName": "faces-cli",
4744
5692
  "pluginType": "core",
@@ -4749,20 +5697,20 @@
4749
5697
  "dist",
4750
5698
  "commands",
4751
5699
  "compile",
4752
- "thread",
5700
+ "doc",
4753
5701
  "pause.js"
4754
5702
  ]
4755
5703
  },
4756
- "compile:thread:reset": {
5704
+ "compile:doc:reset": {
4757
5705
  "aliases": [],
4758
5706
  "args": {
4759
- "thread_id": {
4760
- "description": "Thread ID",
4761
- "name": "thread_id",
5707
+ "doc_id": {
5708
+ "description": "Document ID",
5709
+ "name": "doc_id",
4762
5710
  "required": true
4763
5711
  }
4764
5712
  },
4765
- "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
5713
+ "description": "Reset document compilation progress (wipe extraction, keep content)",
4766
5714
  "flags": {
4767
5715
  "json": {
4768
5716
  "description": "Format output as json.",
@@ -4804,7 +5752,7 @@
4804
5752
  },
4805
5753
  "hasDynamicHelp": false,
4806
5754
  "hiddenAliases": [],
4807
- "id": "compile:thread:reset",
5755
+ "id": "compile:doc:reset",
4808
5756
  "pluginAlias": "faces-cli",
4809
5757
  "pluginName": "faces-cli",
4810
5758
  "pluginType": "core",
@@ -4815,20 +5763,20 @@
4815
5763
  "dist",
4816
5764
  "commands",
4817
5765
  "compile",
4818
- "thread",
5766
+ "doc",
4819
5767
  "reset.js"
4820
5768
  ]
4821
5769
  },
4822
- "compile:thread:sync": {
5770
+ "compile:thread:create": {
4823
5771
  "aliases": [],
4824
5772
  "args": {
4825
- "thread_id": {
4826
- "description": "Thread ID",
4827
- "name": "thread_id",
5773
+ "face_id": {
5774
+ "description": "Face alias",
5775
+ "name": "face_id",
4828
5776
  "required": true
4829
5777
  }
4830
5778
  },
4831
- "description": "Archive and sync a thread into a face",
5779
+ "description": "Start a new thread for a face",
4832
5780
  "flags": {
4833
5781
  "json": {
4834
5782
  "description": "Format output as json.",
@@ -4860,11 +5808,24 @@
4860
5808
  "hasDynamicHelp": false,
4861
5809
  "multiple": false,
4862
5810
  "type": "option"
5811
+ },
5812
+ "label": {
5813
+ "description": "Thread label",
5814
+ "name": "label",
5815
+ "hasDynamicHelp": false,
5816
+ "multiple": false,
5817
+ "type": "option"
5818
+ },
5819
+ "oauth-only": {
5820
+ "description": "Prevent fallback to paid system key (use OAuth only)",
5821
+ "name": "oauth-only",
5822
+ "allowNo": false,
5823
+ "type": "boolean"
4863
5824
  }
4864
5825
  },
4865
5826
  "hasDynamicHelp": false,
4866
5827
  "hiddenAliases": [],
4867
- "id": "compile:thread:sync",
5828
+ "id": "compile:thread:create",
4868
5829
  "pluginAlias": "faces-cli",
4869
5830
  "pluginName": "faces-cli",
4870
5831
  "pluginType": "core",
@@ -4876,19 +5837,19 @@
4876
5837
  "commands",
4877
5838
  "compile",
4878
5839
  "thread",
4879
- "sync.js"
5840
+ "create.js"
4880
5841
  ]
4881
5842
  },
4882
- "compile:doc:create": {
5843
+ "compile:thread:delete": {
4883
5844
  "aliases": [],
4884
5845
  "args": {
4885
- "face_id": {
4886
- "description": "Face alias",
4887
- "name": "face_id",
5846
+ "thread_id": {
5847
+ "description": "Thread ID",
5848
+ "name": "thread_id",
4888
5849
  "required": true
4889
5850
  }
4890
5851
  },
4891
- "description": "Submit a document to a face",
5852
+ "description": "Delete a thread",
4892
5853
  "flags": {
4893
5854
  "json": {
4894
5855
  "description": "Format output as json.",
@@ -4921,43 +5882,16 @@
4921
5882
  "multiple": false,
4922
5883
  "type": "option"
4923
5884
  },
4924
- "label": {
4925
- "description": "Document label/title",
4926
- "name": "label",
4927
- "hasDynamicHelp": false,
4928
- "multiple": false,
4929
- "type": "option"
4930
- },
4931
- "content": {
4932
- "description": "Inline text content",
4933
- "name": "content",
4934
- "hasDynamicHelp": false,
4935
- "multiple": false,
4936
- "type": "option"
4937
- },
4938
- "file": {
4939
- "description": "Read content from file",
4940
- "name": "file",
4941
- "hasDynamicHelp": false,
4942
- "multiple": false,
4943
- "type": "option"
4944
- },
4945
- "perspective": {
4946
- "description": "Perspective (first-person or third-person)",
4947
- "name": "perspective",
4948
- "default": "first-person",
4949
- "hasDynamicHelp": false,
4950
- "multiple": false,
4951
- "options": [
4952
- "first-person",
4953
- "third-person"
4954
- ],
4955
- "type": "option"
5885
+ "yes": {
5886
+ "description": "Skip confirmation",
5887
+ "name": "yes",
5888
+ "allowNo": false,
5889
+ "type": "boolean"
4956
5890
  }
4957
5891
  },
4958
5892
  "hasDynamicHelp": false,
4959
5893
  "hiddenAliases": [],
4960
- "id": "compile:doc:create",
5894
+ "id": "compile:thread:delete",
4961
5895
  "pluginAlias": "faces-cli",
4962
5896
  "pluginName": "faces-cli",
4963
5897
  "pluginType": "core",
@@ -4968,20 +5902,20 @@
4968
5902
  "dist",
4969
5903
  "commands",
4970
5904
  "compile",
4971
- "doc",
4972
- "create.js"
5905
+ "thread",
5906
+ "delete.js"
4973
5907
  ]
4974
5908
  },
4975
- "compile:doc:delete": {
5909
+ "compile:thread:edit": {
4976
5910
  "aliases": [],
4977
5911
  "args": {
4978
- "doc_id": {
4979
- "description": "Document ID",
4980
- "name": "doc_id",
5912
+ "thread_id": {
5913
+ "description": "Thread ID",
5914
+ "name": "thread_id",
4981
5915
  "required": true
4982
5916
  }
4983
5917
  },
4984
- "description": "Delete a document",
5918
+ "description": "Edit a thread (label and/or reassign face speaker)",
4985
5919
  "flags": {
4986
5920
  "json": {
4987
5921
  "description": "Format output as json.",
@@ -5013,11 +5947,25 @@
5013
5947
  "hasDynamicHelp": false,
5014
5948
  "multiple": false,
5015
5949
  "type": "option"
5950
+ },
5951
+ "label": {
5952
+ "description": "New thread label",
5953
+ "name": "label",
5954
+ "hasDynamicHelp": false,
5955
+ "multiple": false,
5956
+ "type": "option"
5957
+ },
5958
+ "face-speaker": {
5959
+ "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
5960
+ "name": "face-speaker",
5961
+ "hasDynamicHelp": false,
5962
+ "multiple": false,
5963
+ "type": "option"
5016
5964
  }
5017
5965
  },
5018
5966
  "hasDynamicHelp": false,
5019
5967
  "hiddenAliases": [],
5020
- "id": "compile:doc:delete",
5968
+ "id": "compile:thread:edit",
5021
5969
  "pluginAlias": "faces-cli",
5022
5970
  "pluginName": "faces-cli",
5023
5971
  "pluginType": "core",
@@ -5028,20 +5976,20 @@
5028
5976
  "dist",
5029
5977
  "commands",
5030
5978
  "compile",
5031
- "doc",
5032
- "delete.js"
5979
+ "thread",
5980
+ "edit.js"
5033
5981
  ]
5034
5982
  },
5035
- "compile:doc:edit": {
5983
+ "compile:thread:get": {
5036
5984
  "aliases": [],
5037
5985
  "args": {
5038
- "doc_id": {
5039
- "description": "Document ID",
5040
- "name": "doc_id",
5986
+ "thread_id": {
5987
+ "description": "Thread ID",
5988
+ "name": "thread_id",
5041
5989
  "required": true
5042
5990
  }
5043
5991
  },
5044
- "description": "Edit a document (label, content, or perspective)",
5992
+ "description": "Get a thread by ID",
5045
5993
  "flags": {
5046
5994
  "json": {
5047
5995
  "description": "Format output as json.",
@@ -5073,43 +6021,11 @@
5073
6021
  "hasDynamicHelp": false,
5074
6022
  "multiple": false,
5075
6023
  "type": "option"
5076
- },
5077
- "label": {
5078
- "description": "New label/title",
5079
- "name": "label",
5080
- "hasDynamicHelp": false,
5081
- "multiple": false,
5082
- "type": "option"
5083
- },
5084
- "content": {
5085
- "description": "New inline text content",
5086
- "name": "content",
5087
- "hasDynamicHelp": false,
5088
- "multiple": false,
5089
- "type": "option"
5090
- },
5091
- "file": {
5092
- "description": "Read new content from file",
5093
- "name": "file",
5094
- "hasDynamicHelp": false,
5095
- "multiple": false,
5096
- "type": "option"
5097
- },
5098
- "perspective": {
5099
- "description": "Perspective (first-person or third-person)",
5100
- "name": "perspective",
5101
- "hasDynamicHelp": false,
5102
- "multiple": false,
5103
- "options": [
5104
- "first-person",
5105
- "third-person"
5106
- ],
5107
- "type": "option"
5108
6024
  }
5109
6025
  },
5110
6026
  "hasDynamicHelp": false,
5111
6027
  "hiddenAliases": [],
5112
- "id": "compile:doc:edit",
6028
+ "id": "compile:thread:get",
5113
6029
  "pluginAlias": "faces-cli",
5114
6030
  "pluginName": "faces-cli",
5115
6031
  "pluginType": "core",
@@ -5120,20 +6036,20 @@
5120
6036
  "dist",
5121
6037
  "commands",
5122
6038
  "compile",
5123
- "doc",
5124
- "edit.js"
6039
+ "thread",
6040
+ "get.js"
5125
6041
  ]
5126
6042
  },
5127
- "compile:doc:get": {
6043
+ "compile:thread:list": {
5128
6044
  "aliases": [],
5129
6045
  "args": {
5130
- "doc_id": {
5131
- "description": "Document ID",
5132
- "name": "doc_id",
6046
+ "face_id": {
6047
+ "description": "Face alias",
6048
+ "name": "face_id",
5133
6049
  "required": true
5134
6050
  }
5135
6051
  },
5136
- "description": "Get a document by ID",
6052
+ "description": "List threads for a face",
5137
6053
  "flags": {
5138
6054
  "json": {
5139
6055
  "description": "Format output as json.",
@@ -5169,7 +6085,7 @@
5169
6085
  },
5170
6086
  "hasDynamicHelp": false,
5171
6087
  "hiddenAliases": [],
5172
- "id": "compile:doc:get",
6088
+ "id": "compile:thread:list",
5173
6089
  "pluginAlias": "faces-cli",
5174
6090
  "pluginName": "faces-cli",
5175
6091
  "pluginType": "core",
@@ -5180,20 +6096,20 @@
5180
6096
  "dist",
5181
6097
  "commands",
5182
6098
  "compile",
5183
- "doc",
5184
- "get.js"
6099
+ "thread",
6100
+ "list.js"
5185
6101
  ]
5186
6102
  },
5187
- "compile:doc": {
6103
+ "compile:thread:make": {
5188
6104
  "aliases": [],
5189
6105
  "args": {
5190
- "face_id": {
5191
- "description": "Face alias",
5192
- "name": "face_id",
6106
+ "thread_id": {
6107
+ "description": "Thread ID",
6108
+ "name": "thread_id",
5193
6109
  "required": true
5194
6110
  }
5195
6111
  },
5196
- "description": "Compile a document into a face (create → make in one step)",
6112
+ "description": "Compile an existing thread (prepare + sync in one step)",
5197
6113
  "flags": {
5198
6114
  "json": {
5199
6115
  "description": "Format output as json.",
@@ -5226,39 +6142,6 @@
5226
6142
  "multiple": false,
5227
6143
  "type": "option"
5228
6144
  },
5229
- "label": {
5230
- "description": "Document label/title",
5231
- "name": "label",
5232
- "hasDynamicHelp": false,
5233
- "multiple": false,
5234
- "type": "option"
5235
- },
5236
- "content": {
5237
- "description": "Inline text content",
5238
- "name": "content",
5239
- "hasDynamicHelp": false,
5240
- "multiple": false,
5241
- "type": "option"
5242
- },
5243
- "file": {
5244
- "description": "Read content from file",
5245
- "name": "file",
5246
- "hasDynamicHelp": false,
5247
- "multiple": false,
5248
- "type": "option"
5249
- },
5250
- "perspective": {
5251
- "description": "Perspective",
5252
- "name": "perspective",
5253
- "default": "first-person",
5254
- "hasDynamicHelp": false,
5255
- "multiple": false,
5256
- "options": [
5257
- "first-person",
5258
- "third-person"
5259
- ],
5260
- "type": "option"
5261
- },
5262
6145
  "timeout": {
5263
6146
  "description": "Compile timeout in seconds (default: 600)",
5264
6147
  "name": "timeout",
@@ -5268,7 +6151,7 @@
5268
6151
  "type": "option"
5269
6152
  },
5270
6153
  "no-wait": {
5271
- "description": "Create and trigger compilation, then return immediately without polling.",
6154
+ "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
5272
6155
  "name": "no-wait",
5273
6156
  "allowNo": false,
5274
6157
  "type": "boolean"
@@ -5276,7 +6159,7 @@
5276
6159
  },
5277
6160
  "hasDynamicHelp": false,
5278
6161
  "hiddenAliases": [],
5279
- "id": "compile:doc",
6162
+ "id": "compile:thread:make",
5280
6163
  "pluginAlias": "faces-cli",
5281
6164
  "pluginName": "faces-cli",
5282
6165
  "pluginType": "core",
@@ -5287,20 +6170,20 @@
5287
6170
  "dist",
5288
6171
  "commands",
5289
6172
  "compile",
5290
- "doc",
5291
- "index.js"
6173
+ "thread",
6174
+ "make.js"
5292
6175
  ]
5293
6176
  },
5294
- "compile:doc:list": {
6177
+ "compile:thread:message": {
5295
6178
  "aliases": [],
5296
6179
  "args": {
5297
- "face_id": {
5298
- "description": "Face alias",
5299
- "name": "face_id",
6180
+ "thread_id": {
6181
+ "description": "Thread ID",
6182
+ "name": "thread_id",
5300
6183
  "required": true
5301
6184
  }
5302
6185
  },
5303
- "description": "List documents for a face",
6186
+ "description": "Send a user message to a thread",
5304
6187
  "flags": {
5305
6188
  "json": {
5306
6189
  "description": "Format output as json.",
@@ -5332,11 +6215,26 @@
5332
6215
  "hasDynamicHelp": false,
5333
6216
  "multiple": false,
5334
6217
  "type": "option"
6218
+ },
6219
+ "message": {
6220
+ "char": "m",
6221
+ "description": "User message to append",
6222
+ "name": "message",
6223
+ "required": true,
6224
+ "hasDynamicHelp": false,
6225
+ "multiple": false,
6226
+ "type": "option"
6227
+ },
6228
+ "oauth-only": {
6229
+ "description": "Prevent fallback to paid system key (use OAuth only)",
6230
+ "name": "oauth-only",
6231
+ "allowNo": false,
6232
+ "type": "boolean"
5335
6233
  }
5336
6234
  },
5337
6235
  "hasDynamicHelp": false,
5338
6236
  "hiddenAliases": [],
5339
- "id": "compile:doc:list",
6237
+ "id": "compile:thread:message",
5340
6238
  "pluginAlias": "faces-cli",
5341
6239
  "pluginName": "faces-cli",
5342
6240
  "pluginType": "core",
@@ -5347,20 +6245,20 @@
5347
6245
  "dist",
5348
6246
  "commands",
5349
6247
  "compile",
5350
- "doc",
5351
- "list.js"
6248
+ "thread",
6249
+ "message.js"
5352
6250
  ]
5353
6251
  },
5354
- "compile:doc:make": {
6252
+ "compile:thread:pause": {
5355
6253
  "aliases": [],
5356
6254
  "args": {
5357
- "doc_id": {
5358
- "description": "Document ID",
5359
- "name": "doc_id",
6255
+ "thread_id": {
6256
+ "description": "Thread ID",
6257
+ "name": "thread_id",
5360
6258
  "required": true
5361
6259
  }
5362
6260
  },
5363
- "description": "Compile an existing document (prepare + sync in one step)",
6261
+ "description": "Pause a running thread compilation (preserves progress, resume with make)",
5364
6262
  "flags": {
5365
6263
  "json": {
5366
6264
  "description": "Format output as json.",
@@ -5392,25 +6290,11 @@
5392
6290
  "hasDynamicHelp": false,
5393
6291
  "multiple": false,
5394
6292
  "type": "option"
5395
- },
5396
- "timeout": {
5397
- "description": "Compile timeout in seconds (default: 600)",
5398
- "name": "timeout",
5399
- "default": 600,
5400
- "hasDynamicHelp": false,
5401
- "multiple": false,
5402
- "type": "option"
5403
- },
5404
- "no-wait": {
5405
- "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
5406
- "name": "no-wait",
5407
- "allowNo": false,
5408
- "type": "boolean"
5409
6293
  }
5410
6294
  },
5411
6295
  "hasDynamicHelp": false,
5412
6296
  "hiddenAliases": [],
5413
- "id": "compile:doc:make",
6297
+ "id": "compile:thread:pause",
5414
6298
  "pluginAlias": "faces-cli",
5415
6299
  "pluginName": "faces-cli",
5416
6300
  "pluginType": "core",
@@ -5421,20 +6305,20 @@
5421
6305
  "dist",
5422
6306
  "commands",
5423
6307
  "compile",
5424
- "doc",
5425
- "make.js"
6308
+ "thread",
6309
+ "pause.js"
5426
6310
  ]
5427
6311
  },
5428
- "compile:doc:pause": {
6312
+ "compile:thread:reset": {
5429
6313
  "aliases": [],
5430
6314
  "args": {
5431
- "doc_id": {
5432
- "description": "Document ID",
5433
- "name": "doc_id",
6315
+ "thread_id": {
6316
+ "description": "Thread ID",
6317
+ "name": "thread_id",
5434
6318
  "required": true
5435
6319
  }
5436
6320
  },
5437
- "description": "Pause a running document compilation (preserves progress, resume with make)",
6321
+ "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
5438
6322
  "flags": {
5439
6323
  "json": {
5440
6324
  "description": "Format output as json.",
@@ -5466,11 +6350,17 @@
5466
6350
  "hasDynamicHelp": false,
5467
6351
  "multiple": false,
5468
6352
  "type": "option"
6353
+ },
6354
+ "yes": {
6355
+ "description": "Skip confirmation",
6356
+ "name": "yes",
6357
+ "allowNo": false,
6358
+ "type": "boolean"
5469
6359
  }
5470
6360
  },
5471
6361
  "hasDynamicHelp": false,
5472
6362
  "hiddenAliases": [],
5473
- "id": "compile:doc:pause",
6363
+ "id": "compile:thread:reset",
5474
6364
  "pluginAlias": "faces-cli",
5475
6365
  "pluginName": "faces-cli",
5476
6366
  "pluginType": "core",
@@ -5481,20 +6371,20 @@
5481
6371
  "dist",
5482
6372
  "commands",
5483
6373
  "compile",
5484
- "doc",
5485
- "pause.js"
6374
+ "thread",
6375
+ "reset.js"
5486
6376
  ]
5487
6377
  },
5488
- "compile:doc:reset": {
6378
+ "compile:thread:sync": {
5489
6379
  "aliases": [],
5490
6380
  "args": {
5491
- "doc_id": {
5492
- "description": "Document ID",
5493
- "name": "doc_id",
6381
+ "thread_id": {
6382
+ "description": "Thread ID",
6383
+ "name": "thread_id",
5494
6384
  "required": true
5495
6385
  }
5496
6386
  },
5497
- "description": "Reset document compilation progress (wipe extraction, keep content)",
6387
+ "description": "Archive and sync a thread into a face",
5498
6388
  "flags": {
5499
6389
  "json": {
5500
6390
  "description": "Format output as json.",
@@ -5526,17 +6416,11 @@
5526
6416
  "hasDynamicHelp": false,
5527
6417
  "multiple": false,
5528
6418
  "type": "option"
5529
- },
5530
- "yes": {
5531
- "description": "Skip confirmation",
5532
- "name": "yes",
5533
- "allowNo": false,
5534
- "type": "boolean"
5535
6419
  }
5536
6420
  },
5537
6421
  "hasDynamicHelp": false,
5538
6422
  "hiddenAliases": [],
5539
- "id": "compile:doc:reset",
6423
+ "id": "compile:thread:sync",
5540
6424
  "pluginAlias": "faces-cli",
5541
6425
  "pluginName": "faces-cli",
5542
6426
  "pluginType": "core",
@@ -5547,20 +6431,20 @@
5547
6431
  "dist",
5548
6432
  "commands",
5549
6433
  "compile",
5550
- "doc",
5551
- "reset.js"
6434
+ "thread",
6435
+ "sync.js"
5552
6436
  ]
5553
6437
  },
5554
- "face:tag:add": {
6438
+ "team:tag:add": {
5555
6439
  "aliases": [],
5556
6440
  "args": {
5557
- "alias": {
5558
- "description": "Face alias",
5559
- "name": "alias",
6441
+ "team_id": {
6442
+ "description": "Team ID",
6443
+ "name": "team_id",
5560
6444
  "required": true
5561
6445
  }
5562
6446
  },
5563
- "description": "Add tags to a face (appends, idempotent)",
6447
+ "description": "Add tags to a team (appends, idempotent)",
5564
6448
  "flags": {
5565
6449
  "json": {
5566
6450
  "description": "Format output as json.",
@@ -5604,7 +6488,7 @@
5604
6488
  },
5605
6489
  "hasDynamicHelp": false,
5606
6490
  "hiddenAliases": [],
5607
- "id": "face:tag:add",
6491
+ "id": "team:tag:add",
5608
6492
  "pluginAlias": "faces-cli",
5609
6493
  "pluginName": "faces-cli",
5610
6494
  "pluginType": "core",
@@ -5614,15 +6498,21 @@
5614
6498
  "relativePath": [
5615
6499
  "dist",
5616
6500
  "commands",
5617
- "face",
6501
+ "team",
5618
6502
  "tag",
5619
6503
  "add.js"
5620
6504
  ]
5621
6505
  },
5622
- "face:tag:all": {
6506
+ "team:tag:list": {
5623
6507
  "aliases": [],
5624
- "args": {},
5625
- "description": "List all tags across all your faces",
6508
+ "args": {
6509
+ "team_id": {
6510
+ "description": "Team ID",
6511
+ "name": "team_id",
6512
+ "required": true
6513
+ }
6514
+ },
6515
+ "description": "List tags on a team",
5626
6516
  "flags": {
5627
6517
  "json": {
5628
6518
  "description": "Format output as json.",
@@ -5658,7 +6548,7 @@
5658
6548
  },
5659
6549
  "hasDynamicHelp": false,
5660
6550
  "hiddenAliases": [],
5661
- "id": "face:tag:all",
6551
+ "id": "team:tag:list",
5662
6552
  "pluginAlias": "faces-cli",
5663
6553
  "pluginName": "faces-cli",
5664
6554
  "pluginType": "core",
@@ -5668,21 +6558,26 @@
5668
6558
  "relativePath": [
5669
6559
  "dist",
5670
6560
  "commands",
5671
- "face",
6561
+ "team",
5672
6562
  "tag",
5673
- "all.js"
6563
+ "list.js"
5674
6564
  ]
5675
6565
  },
5676
- "face:tag:list": {
6566
+ "team:tag:remove": {
5677
6567
  "aliases": [],
5678
6568
  "args": {
5679
- "alias": {
5680
- "description": "Face alias",
5681
- "name": "alias",
6569
+ "team_id": {
6570
+ "description": "Team ID",
6571
+ "name": "team_id",
6572
+ "required": true
6573
+ },
6574
+ "tag": {
6575
+ "description": "Tag to remove",
6576
+ "name": "tag",
5682
6577
  "required": true
5683
6578
  }
5684
6579
  },
5685
- "description": "List tags on a face",
6580
+ "description": "Remove a tag from a team",
5686
6581
  "flags": {
5687
6582
  "json": {
5688
6583
  "description": "Format output as json.",
@@ -5718,7 +6613,7 @@
5718
6613
  },
5719
6614
  "hasDynamicHelp": false,
5720
6615
  "hiddenAliases": [],
5721
- "id": "face:tag:list",
6616
+ "id": "team:tag:remove",
5722
6617
  "pluginAlias": "faces-cli",
5723
6618
  "pluginName": "faces-cli",
5724
6619
  "pluginType": "core",
@@ -5728,26 +6623,21 @@
5728
6623
  "relativePath": [
5729
6624
  "dist",
5730
6625
  "commands",
5731
- "face",
6626
+ "team",
5732
6627
  "tag",
5733
- "list.js"
6628
+ "remove.js"
5734
6629
  ]
5735
6630
  },
5736
- "face:tag:remove": {
6631
+ "team:tag:set": {
5737
6632
  "aliases": [],
5738
6633
  "args": {
5739
- "alias": {
5740
- "description": "Face alias",
5741
- "name": "alias",
5742
- "required": true
5743
- },
5744
- "tag": {
5745
- "description": "Tag to remove",
5746
- "name": "tag",
6634
+ "team_id": {
6635
+ "description": "Team ID",
6636
+ "name": "team_id",
5747
6637
  "required": true
5748
6638
  }
5749
6639
  },
5750
- "description": "Remove a tag from a face",
6640
+ "description": "Replace all tags on a team",
5751
6641
  "flags": {
5752
6642
  "json": {
5753
6643
  "description": "Format output as json.",
@@ -5779,11 +6669,19 @@
5779
6669
  "hasDynamicHelp": false,
5780
6670
  "multiple": false,
5781
6671
  "type": "option"
6672
+ },
6673
+ "tag": {
6674
+ "description": "Tag to set (repeatable, replaces all)",
6675
+ "name": "tag",
6676
+ "required": true,
6677
+ "hasDynamicHelp": false,
6678
+ "multiple": true,
6679
+ "type": "option"
5782
6680
  }
5783
6681
  },
5784
6682
  "hasDynamicHelp": false,
5785
6683
  "hiddenAliases": [],
5786
- "id": "face:tag:remove",
6684
+ "id": "team:tag:set",
5787
6685
  "pluginAlias": "faces-cli",
5788
6686
  "pluginName": "faces-cli",
5789
6687
  "pluginType": "core",
@@ -5793,12 +6691,12 @@
5793
6691
  "relativePath": [
5794
6692
  "dist",
5795
6693
  "commands",
5796
- "face",
6694
+ "team",
5797
6695
  "tag",
5798
- "remove.js"
6696
+ "set.js"
5799
6697
  ]
5800
6698
  },
5801
- "face:tag:set": {
6699
+ "face:tag:add": {
5802
6700
  "aliases": [],
5803
6701
  "args": {
5804
6702
  "alias": {
@@ -5807,7 +6705,7 @@
5807
6705
  "required": true
5808
6706
  }
5809
6707
  },
5810
- "description": "Replace all tags on a face",
6708
+ "description": "Add tags to a face (appends, idempotent)",
5811
6709
  "flags": {
5812
6710
  "json": {
5813
6711
  "description": "Format output as json.",
@@ -5841,7 +6739,7 @@
5841
6739
  "type": "option"
5842
6740
  },
5843
6741
  "tag": {
5844
- "description": "Tag to set (repeatable, replaces all)",
6742
+ "description": "Tag to add (repeatable)",
5845
6743
  "name": "tag",
5846
6744
  "required": true,
5847
6745
  "hasDynamicHelp": false,
@@ -5851,7 +6749,7 @@
5851
6749
  },
5852
6750
  "hasDynamicHelp": false,
5853
6751
  "hiddenAliases": [],
5854
- "id": "face:tag:set",
6752
+ "id": "face:tag:add",
5855
6753
  "pluginAlias": "faces-cli",
5856
6754
  "pluginName": "faces-cli",
5857
6755
  "pluginType": "core",
@@ -5863,19 +6761,13 @@
5863
6761
  "commands",
5864
6762
  "face",
5865
6763
  "tag",
5866
- "set.js"
6764
+ "add.js"
5867
6765
  ]
5868
6766
  },
5869
- "team:tag:add": {
6767
+ "face:tag:all": {
5870
6768
  "aliases": [],
5871
- "args": {
5872
- "team_id": {
5873
- "description": "Team ID",
5874
- "name": "team_id",
5875
- "required": true
5876
- }
5877
- },
5878
- "description": "Add tags to a team (appends, idempotent)",
6769
+ "args": {},
6770
+ "description": "List all tags across all your faces",
5879
6771
  "flags": {
5880
6772
  "json": {
5881
6773
  "description": "Format output as json.",
@@ -5907,19 +6799,11 @@
5907
6799
  "hasDynamicHelp": false,
5908
6800
  "multiple": false,
5909
6801
  "type": "option"
5910
- },
5911
- "tag": {
5912
- "description": "Tag to add (repeatable)",
5913
- "name": "tag",
5914
- "required": true,
5915
- "hasDynamicHelp": false,
5916
- "multiple": true,
5917
- "type": "option"
5918
6802
  }
5919
6803
  },
5920
6804
  "hasDynamicHelp": false,
5921
6805
  "hiddenAliases": [],
5922
- "id": "team:tag:add",
6806
+ "id": "face:tag:all",
5923
6807
  "pluginAlias": "faces-cli",
5924
6808
  "pluginName": "faces-cli",
5925
6809
  "pluginType": "core",
@@ -5929,21 +6813,21 @@
5929
6813
  "relativePath": [
5930
6814
  "dist",
5931
6815
  "commands",
5932
- "team",
6816
+ "face",
5933
6817
  "tag",
5934
- "add.js"
6818
+ "all.js"
5935
6819
  ]
5936
6820
  },
5937
- "team:tag:list": {
6821
+ "face:tag:list": {
5938
6822
  "aliases": [],
5939
6823
  "args": {
5940
- "team_id": {
5941
- "description": "Team ID",
5942
- "name": "team_id",
6824
+ "alias": {
6825
+ "description": "Face alias",
6826
+ "name": "alias",
5943
6827
  "required": true
5944
6828
  }
5945
6829
  },
5946
- "description": "List tags on a team",
6830
+ "description": "List tags on a face",
5947
6831
  "flags": {
5948
6832
  "json": {
5949
6833
  "description": "Format output as json.",
@@ -5979,7 +6863,7 @@
5979
6863
  },
5980
6864
  "hasDynamicHelp": false,
5981
6865
  "hiddenAliases": [],
5982
- "id": "team:tag:list",
6866
+ "id": "face:tag:list",
5983
6867
  "pluginAlias": "faces-cli",
5984
6868
  "pluginName": "faces-cli",
5985
6869
  "pluginType": "core",
@@ -5989,17 +6873,17 @@
5989
6873
  "relativePath": [
5990
6874
  "dist",
5991
6875
  "commands",
5992
- "team",
6876
+ "face",
5993
6877
  "tag",
5994
6878
  "list.js"
5995
6879
  ]
5996
6880
  },
5997
- "team:tag:remove": {
6881
+ "face:tag:remove": {
5998
6882
  "aliases": [],
5999
6883
  "args": {
6000
- "team_id": {
6001
- "description": "Team ID",
6002
- "name": "team_id",
6884
+ "alias": {
6885
+ "description": "Face alias",
6886
+ "name": "alias",
6003
6887
  "required": true
6004
6888
  },
6005
6889
  "tag": {
@@ -6008,7 +6892,7 @@
6008
6892
  "required": true
6009
6893
  }
6010
6894
  },
6011
- "description": "Remove a tag from a team",
6895
+ "description": "Remove a tag from a face",
6012
6896
  "flags": {
6013
6897
  "json": {
6014
6898
  "description": "Format output as json.",
@@ -6044,7 +6928,7 @@
6044
6928
  },
6045
6929
  "hasDynamicHelp": false,
6046
6930
  "hiddenAliases": [],
6047
- "id": "team:tag:remove",
6931
+ "id": "face:tag:remove",
6048
6932
  "pluginAlias": "faces-cli",
6049
6933
  "pluginName": "faces-cli",
6050
6934
  "pluginType": "core",
@@ -6054,21 +6938,21 @@
6054
6938
  "relativePath": [
6055
6939
  "dist",
6056
6940
  "commands",
6057
- "team",
6941
+ "face",
6058
6942
  "tag",
6059
6943
  "remove.js"
6060
6944
  ]
6061
6945
  },
6062
- "team:tag:set": {
6946
+ "face:tag:set": {
6063
6947
  "aliases": [],
6064
6948
  "args": {
6065
- "team_id": {
6066
- "description": "Team ID",
6067
- "name": "team_id",
6949
+ "alias": {
6950
+ "description": "Face alias",
6951
+ "name": "alias",
6068
6952
  "required": true
6069
6953
  }
6070
6954
  },
6071
- "description": "Replace all tags on a team",
6955
+ "description": "Replace all tags on a face",
6072
6956
  "flags": {
6073
6957
  "json": {
6074
6958
  "description": "Format output as json.",
@@ -6112,7 +6996,7 @@
6112
6996
  },
6113
6997
  "hasDynamicHelp": false,
6114
6998
  "hiddenAliases": [],
6115
- "id": "team:tag:set",
6999
+ "id": "face:tag:set",
6116
7000
  "pluginAlias": "faces-cli",
6117
7001
  "pluginName": "faces-cli",
6118
7002
  "pluginType": "core",
@@ -6122,11 +7006,11 @@
6122
7006
  "relativePath": [
6123
7007
  "dist",
6124
7008
  "commands",
6125
- "team",
7009
+ "face",
6126
7010
  "tag",
6127
7011
  "set.js"
6128
7012
  ]
6129
7013
  }
6130
7014
  },
6131
- "version": "1.7.4"
7015
+ "version": "1.7.6"
6132
7016
  }