faces-cli 1.8.2 → 1.8.3

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 (6) hide show
  1. package/dist/commands/team/add.d.ts +1 -0
  2. package/dist/commands/team/add.js +10 -15
  3. package/dist/commands/team/members.d.ts +1 -0
  4. package/dist/commands/team/members.js +53 -4
  5. package/oclif.manifest.json +1396 -1388
  6. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -120,10 +120,23 @@
120
120
  "state.js"
121
121
  ]
122
122
  },
123
- "billing:balance": {
123
+ "auth:connect": {
124
124
  "aliases": [],
125
- "args": {},
126
- "description": "Show credit balance and payment method status",
125
+ "args": {
126
+ "provider": {
127
+ "description": "OAuth provider to connect",
128
+ "name": "provider",
129
+ "options": [
130
+ "openai"
131
+ ],
132
+ "required": true
133
+ }
134
+ },
135
+ "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
136
+ "examples": [
137
+ "<%= config.bin %> auth connect openai",
138
+ "<%= config.bin %> auth connect openai --json"
139
+ ],
127
140
  "flags": {
128
141
  "json": {
129
142
  "description": "Format output as json.",
@@ -159,7 +172,7 @@
159
172
  },
160
173
  "hasDynamicHelp": false,
161
174
  "hiddenAliases": [],
162
- "id": "billing:balance",
175
+ "id": "auth:connect",
163
176
  "pluginAlias": "faces-cli",
164
177
  "pluginName": "faces-cli",
165
178
  "pluginType": "core",
@@ -169,14 +182,18 @@
169
182
  "relativePath": [
170
183
  "dist",
171
184
  "commands",
172
- "billing",
173
- "balance.js"
185
+ "auth",
186
+ "connect.js"
174
187
  ]
175
188
  },
176
- "billing:card-setup": {
189
+ "auth:connections": {
177
190
  "aliases": [],
178
191
  "args": {},
179
- "description": "Get a Stripe card setup URL to save a payment method",
192
+ "description": "List connected OAuth provider accounts",
193
+ "examples": [
194
+ "<%= config.bin %> auth connections",
195
+ "<%= config.bin %> auth connections --json"
196
+ ],
180
197
  "flags": {
181
198
  "json": {
182
199
  "description": "Format output as json.",
@@ -212,7 +229,7 @@
212
229
  },
213
230
  "hasDynamicHelp": false,
214
231
  "hiddenAliases": [],
215
- "id": "billing:card-setup",
232
+ "id": "auth:connections",
216
233
  "pluginAlias": "faces-cli",
217
234
  "pluginName": "faces-cli",
218
235
  "pluginType": "core",
@@ -222,14 +239,26 @@
222
239
  "relativePath": [
223
240
  "dist",
224
241
  "commands",
225
- "billing",
226
- "card-setup.js"
242
+ "auth",
243
+ "connections.js"
227
244
  ]
228
245
  },
229
- "billing:llm-costs": {
246
+ "auth:disconnect": {
230
247
  "aliases": [],
231
- "args": {},
232
- "description": "List available LLMs and their per-token costs",
248
+ "args": {
249
+ "provider": {
250
+ "description": "OAuth provider to disconnect",
251
+ "name": "provider",
252
+ "options": [
253
+ "openai"
254
+ ],
255
+ "required": true
256
+ }
257
+ },
258
+ "description": "Disconnect a linked OAuth provider account",
259
+ "examples": [
260
+ "<%= config.bin %> auth disconnect openai"
261
+ ],
233
262
  "flags": {
234
263
  "json": {
235
264
  "description": "Format output as json.",
@@ -261,18 +290,11 @@
261
290
  "hasDynamicHelp": false,
262
291
  "multiple": false,
263
292
  "type": "option"
264
- },
265
- "provider": {
266
- "description": "Filter by provider (e.g. openai, anthropic)",
267
- "name": "provider",
268
- "hasDynamicHelp": false,
269
- "multiple": false,
270
- "type": "option"
271
293
  }
272
294
  },
273
295
  "hasDynamicHelp": false,
274
296
  "hiddenAliases": [],
275
- "id": "billing:llm-costs",
297
+ "id": "auth:disconnect",
276
298
  "pluginAlias": "faces-cli",
277
299
  "pluginName": "faces-cli",
278
300
  "pluginType": "core",
@@ -282,14 +304,14 @@
282
304
  "relativePath": [
283
305
  "dist",
284
306
  "commands",
285
- "billing",
286
- "llm-costs.js"
307
+ "auth",
308
+ "disconnect.js"
287
309
  ]
288
310
  },
289
- "billing:topup": {
311
+ "auth:login": {
290
312
  "aliases": [],
291
313
  "args": {},
292
- "description": "Top up credit balance using saved payment method",
314
+ "description": "Login and save JWT credentials",
293
315
  "flags": {
294
316
  "json": {
295
317
  "description": "Format output as json.",
@@ -322,17 +344,18 @@
322
344
  "multiple": false,
323
345
  "type": "option"
324
346
  },
325
- "amount": {
326
- "description": "Top-up amount in USD (min $1)",
327
- "name": "amount",
347
+ "email": {
348
+ "description": "Account email",
349
+ "name": "email",
328
350
  "required": true,
329
351
  "hasDynamicHelp": false,
330
352
  "multiple": false,
331
353
  "type": "option"
332
354
  },
333
- "payment-ref": {
334
- "description": "Payment reference (admin/test path)",
335
- "name": "payment-ref",
355
+ "password": {
356
+ "description": "Account password",
357
+ "name": "password",
358
+ "required": true,
336
359
  "hasDynamicHelp": false,
337
360
  "multiple": false,
338
361
  "type": "option"
@@ -340,7 +363,7 @@
340
363
  },
341
364
  "hasDynamicHelp": false,
342
365
  "hiddenAliases": [],
343
- "id": "billing:topup",
366
+ "id": "auth:login",
344
367
  "pluginAlias": "faces-cli",
345
368
  "pluginName": "faces-cli",
346
369
  "pluginType": "core",
@@ -350,14 +373,14 @@
350
373
  "relativePath": [
351
374
  "dist",
352
375
  "commands",
353
- "billing",
354
- "topup.js"
376
+ "auth",
377
+ "login.js"
355
378
  ]
356
379
  },
357
- "billing:usage": {
380
+ "auth:logout": {
358
381
  "aliases": [],
359
382
  "args": {},
360
- "description": "Aggregated usage analytics",
383
+ "description": "Clear saved credentials",
361
384
  "flags": {
362
385
  "json": {
363
386
  "description": "Format output as json.",
@@ -389,38 +412,11 @@
389
412
  "hasDynamicHelp": false,
390
413
  "multiple": false,
391
414
  "type": "option"
392
- },
393
- "group-by": {
394
- "description": "Group results",
395
- "name": "group-by",
396
- "hasDynamicHelp": false,
397
- "multiple": false,
398
- "options": [
399
- "api_key",
400
- "model",
401
- "llm",
402
- "date"
403
- ],
404
- "type": "option"
405
- },
406
- "from": {
407
- "description": "Start date (YYYY-MM-DD)",
408
- "name": "from",
409
- "hasDynamicHelp": false,
410
- "multiple": false,
411
- "type": "option"
412
- },
413
- "to": {
414
- "description": "End date (YYYY-MM-DD)",
415
- "name": "to",
416
- "hasDynamicHelp": false,
417
- "multiple": false,
418
- "type": "option"
419
415
  }
420
416
  },
421
417
  "hasDynamicHelp": false,
422
418
  "hiddenAliases": [],
423
- "id": "billing:usage",
419
+ "id": "auth:logout",
424
420
  "pluginAlias": "faces-cli",
425
421
  "pluginName": "faces-cli",
426
422
  "pluginType": "core",
@@ -430,27 +426,14 @@
430
426
  "relativePath": [
431
427
  "dist",
432
428
  "commands",
433
- "billing",
434
- "usage.js"
429
+ "auth",
430
+ "logout.js"
435
431
  ]
436
432
  },
437
- "auth:connect": {
433
+ "auth:refresh": {
438
434
  "aliases": [],
439
- "args": {
440
- "provider": {
441
- "description": "OAuth provider to connect",
442
- "name": "provider",
443
- "options": [
444
- "openai"
445
- ],
446
- "required": true
447
- }
448
- },
449
- "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
450
- "examples": [
451
- "<%= config.bin %> auth connect openai",
452
- "<%= config.bin %> auth connect openai --json"
453
- ],
435
+ "args": {},
436
+ "description": "Exchange current JWT for a fresh one",
454
437
  "flags": {
455
438
  "json": {
456
439
  "description": "Format output as json.",
@@ -486,7 +469,7 @@
486
469
  },
487
470
  "hasDynamicHelp": false,
488
471
  "hiddenAliases": [],
489
- "id": "auth:connect",
472
+ "id": "auth:refresh",
490
473
  "pluginAlias": "faces-cli",
491
474
  "pluginName": "faces-cli",
492
475
  "pluginType": "core",
@@ -497,17 +480,13 @@
497
480
  "dist",
498
481
  "commands",
499
482
  "auth",
500
- "connect.js"
483
+ "refresh.js"
501
484
  ]
502
485
  },
503
- "auth:connections": {
486
+ "auth:register": {
504
487
  "aliases": [],
505
488
  "args": {},
506
- "description": "List connected OAuth provider accounts",
507
- "examples": [
508
- "<%= config.bin %> auth connections",
509
- "<%= config.bin %> auth connections --json"
510
- ],
489
+ "description": "Create a new Faces account",
511
490
  "flags": {
512
491
  "json": {
513
492
  "description": "Format output as json.",
@@ -539,11 +518,54 @@
539
518
  "hasDynamicHelp": false,
540
519
  "multiple": false,
541
520
  "type": "option"
521
+ },
522
+ "email": {
523
+ "description": "Email address",
524
+ "name": "email",
525
+ "required": true,
526
+ "hasDynamicHelp": false,
527
+ "multiple": false,
528
+ "type": "option"
529
+ },
530
+ "password": {
531
+ "description": "Password",
532
+ "name": "password",
533
+ "required": true,
534
+ "hasDynamicHelp": false,
535
+ "multiple": false,
536
+ "type": "option"
537
+ },
538
+ "username": {
539
+ "description": "Username (lowercase, dashes, numbers)",
540
+ "name": "username",
541
+ "required": true,
542
+ "hasDynamicHelp": false,
543
+ "multiple": false,
544
+ "type": "option"
545
+ },
546
+ "invite-key": {
547
+ "description": "Invite key (if required)",
548
+ "name": "invite-key",
549
+ "hasDynamicHelp": false,
550
+ "multiple": false,
551
+ "type": "option"
552
+ },
553
+ "plan": {
554
+ "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
555
+ "name": "plan",
556
+ "default": "free",
557
+ "hasDynamicHelp": false,
558
+ "multiple": false,
559
+ "options": [
560
+ "free",
561
+ "connect"
562
+ ],
563
+ "type": "option"
542
564
  }
543
565
  },
544
566
  "hasDynamicHelp": false,
545
567
  "hiddenAliases": [],
546
- "id": "auth:connections",
568
+ "id": "auth:register",
547
569
  "pluginAlias": "faces-cli",
548
570
  "pluginName": "faces-cli",
549
571
  "pluginType": "core",
@@ -554,25 +576,13 @@
554
576
  "dist",
555
577
  "commands",
556
578
  "auth",
557
- "connections.js"
579
+ "register.js"
558
580
  ]
559
581
  },
560
- "auth:disconnect": {
582
+ "auth:whoami": {
561
583
  "aliases": [],
562
- "args": {
563
- "provider": {
564
- "description": "OAuth provider to disconnect",
565
- "name": "provider",
566
- "options": [
567
- "openai"
568
- ],
569
- "required": true
570
- }
571
- },
572
- "description": "Disconnect a linked OAuth provider account",
573
- "examples": [
574
- "<%= config.bin %> auth disconnect openai"
575
- ],
584
+ "args": {},
585
+ "description": "Print current user profile and auth diagnostic",
576
586
  "flags": {
577
587
  "json": {
578
588
  "description": "Format output as json.",
@@ -608,7 +618,7 @@
608
618
  },
609
619
  "hasDynamicHelp": false,
610
620
  "hiddenAliases": [],
611
- "id": "auth:disconnect",
621
+ "id": "auth:whoami",
612
622
  "pluginAlias": "faces-cli",
613
623
  "pluginName": "faces-cli",
614
624
  "pluginType": "core",
@@ -619,13 +629,13 @@
619
629
  "dist",
620
630
  "commands",
621
631
  "auth",
622
- "disconnect.js"
632
+ "whoami.js"
623
633
  ]
624
634
  },
625
- "auth:login": {
635
+ "billing:balance": {
626
636
  "aliases": [],
627
637
  "args": {},
628
- "description": "Login and save JWT credentials",
638
+ "description": "Show credit balance and payment method status",
629
639
  "flags": {
630
640
  "json": {
631
641
  "description": "Format output as json.",
@@ -657,27 +667,11 @@
657
667
  "hasDynamicHelp": false,
658
668
  "multiple": false,
659
669
  "type": "option"
660
- },
661
- "email": {
662
- "description": "Account email",
663
- "name": "email",
664
- "required": true,
665
- "hasDynamicHelp": false,
666
- "multiple": false,
667
- "type": "option"
668
- },
669
- "password": {
670
- "description": "Account password",
671
- "name": "password",
672
- "required": true,
673
- "hasDynamicHelp": false,
674
- "multiple": false,
675
- "type": "option"
676
670
  }
677
671
  },
678
672
  "hasDynamicHelp": false,
679
673
  "hiddenAliases": [],
680
- "id": "auth:login",
674
+ "id": "billing:balance",
681
675
  "pluginAlias": "faces-cli",
682
676
  "pluginName": "faces-cli",
683
677
  "pluginType": "core",
@@ -687,14 +681,14 @@
687
681
  "relativePath": [
688
682
  "dist",
689
683
  "commands",
690
- "auth",
691
- "login.js"
684
+ "billing",
685
+ "balance.js"
692
686
  ]
693
687
  },
694
- "auth:logout": {
688
+ "billing:card-setup": {
695
689
  "aliases": [],
696
690
  "args": {},
697
- "description": "Clear saved credentials",
691
+ "description": "Get a Stripe card setup URL to save a payment method",
698
692
  "flags": {
699
693
  "json": {
700
694
  "description": "Format output as json.",
@@ -730,7 +724,7 @@
730
724
  },
731
725
  "hasDynamicHelp": false,
732
726
  "hiddenAliases": [],
733
- "id": "auth:logout",
727
+ "id": "billing:card-setup",
734
728
  "pluginAlias": "faces-cli",
735
729
  "pluginName": "faces-cli",
736
730
  "pluginType": "core",
@@ -740,14 +734,14 @@
740
734
  "relativePath": [
741
735
  "dist",
742
736
  "commands",
743
- "auth",
744
- "logout.js"
737
+ "billing",
738
+ "card-setup.js"
745
739
  ]
746
740
  },
747
- "auth:refresh": {
741
+ "billing:llm-costs": {
748
742
  "aliases": [],
749
743
  "args": {},
750
- "description": "Exchange current JWT for a fresh one",
744
+ "description": "List available LLMs and their per-token costs",
751
745
  "flags": {
752
746
  "json": {
753
747
  "description": "Format output as json.",
@@ -779,11 +773,18 @@
779
773
  "hasDynamicHelp": false,
780
774
  "multiple": false,
781
775
  "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"
782
783
  }
783
784
  },
784
785
  "hasDynamicHelp": false,
785
786
  "hiddenAliases": [],
786
- "id": "auth:refresh",
787
+ "id": "billing:llm-costs",
787
788
  "pluginAlias": "faces-cli",
788
789
  "pluginName": "faces-cli",
789
790
  "pluginType": "core",
@@ -793,14 +794,14 @@
793
794
  "relativePath": [
794
795
  "dist",
795
796
  "commands",
796
- "auth",
797
- "refresh.js"
797
+ "billing",
798
+ "llm-costs.js"
798
799
  ]
799
800
  },
800
- "auth:register": {
801
+ "billing:topup": {
801
802
  "aliases": [],
802
803
  "args": {},
803
- "description": "Create a new Faces account",
804
+ "description": "Top up credit balance using saved payment method",
804
805
  "flags": {
805
806
  "json": {
806
807
  "description": "Format output as json.",
@@ -833,53 +834,25 @@
833
834
  "multiple": false,
834
835
  "type": "option"
835
836
  },
836
- "email": {
837
- "description": "Email address",
838
- "name": "email",
839
- "required": true,
840
- "hasDynamicHelp": false,
841
- "multiple": false,
842
- "type": "option"
843
- },
844
- "password": {
845
- "description": "Password",
846
- "name": "password",
847
- "required": true,
848
- "hasDynamicHelp": false,
849
- "multiple": false,
850
- "type": "option"
851
- },
852
- "username": {
853
- "description": "Username (lowercase, dashes, numbers)",
854
- "name": "username",
837
+ "amount": {
838
+ "description": "Top-up amount in USD (min $1)",
839
+ "name": "amount",
855
840
  "required": true,
856
841
  "hasDynamicHelp": false,
857
842
  "multiple": false,
858
843
  "type": "option"
859
844
  },
860
- "invite-key": {
861
- "description": "Invite key (if required)",
862
- "name": "invite-key",
863
- "hasDynamicHelp": false,
864
- "multiple": false,
865
- "type": "option"
866
- },
867
- "plan": {
868
- "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
869
- "name": "plan",
870
- "default": "free",
845
+ "payment-ref": {
846
+ "description": "Payment reference (admin/test path)",
847
+ "name": "payment-ref",
871
848
  "hasDynamicHelp": false,
872
849
  "multiple": false,
873
- "options": [
874
- "free",
875
- "connect"
876
- ],
877
850
  "type": "option"
878
851
  }
879
852
  },
880
853
  "hasDynamicHelp": false,
881
854
  "hiddenAliases": [],
882
- "id": "auth:register",
855
+ "id": "billing:topup",
883
856
  "pluginAlias": "faces-cli",
884
857
  "pluginName": "faces-cli",
885
858
  "pluginType": "core",
@@ -889,14 +862,14 @@
889
862
  "relativePath": [
890
863
  "dist",
891
864
  "commands",
892
- "auth",
893
- "register.js"
865
+ "billing",
866
+ "topup.js"
894
867
  ]
895
868
  },
896
- "auth:whoami": {
869
+ "billing:usage": {
897
870
  "aliases": [],
898
871
  "args": {},
899
- "description": "Print current user profile and auth diagnostic",
872
+ "description": "Aggregated usage analytics",
900
873
  "flags": {
901
874
  "json": {
902
875
  "description": "Format output as json.",
@@ -928,11 +901,38 @@
928
901
  "hasDynamicHelp": false,
929
902
  "multiple": false,
930
903
  "type": "option"
904
+ },
905
+ "group-by": {
906
+ "description": "Group results",
907
+ "name": "group-by",
908
+ "hasDynamicHelp": false,
909
+ "multiple": false,
910
+ "options": [
911
+ "api_key",
912
+ "model",
913
+ "llm",
914
+ "date"
915
+ ],
916
+ "type": "option"
917
+ },
918
+ "from": {
919
+ "description": "Start date (YYYY-MM-DD)",
920
+ "name": "from",
921
+ "hasDynamicHelp": false,
922
+ "multiple": false,
923
+ "type": "option"
924
+ },
925
+ "to": {
926
+ "description": "End date (YYYY-MM-DD)",
927
+ "name": "to",
928
+ "hasDynamicHelp": false,
929
+ "multiple": false,
930
+ "type": "option"
931
931
  }
932
932
  },
933
933
  "hasDynamicHelp": false,
934
934
  "hiddenAliases": [],
935
- "id": "auth:whoami",
935
+ "id": "billing:usage",
936
936
  "pluginAlias": "faces-cli",
937
937
  "pluginName": "faces-cli",
938
938
  "pluginType": "core",
@@ -942,8 +942,8 @@
942
942
  "relativePath": [
943
943
  "dist",
944
944
  "commands",
945
- "auth",
946
- "whoami.js"
945
+ "billing",
946
+ "usage.js"
947
947
  ]
948
948
  },
949
949
  "catalog:backup": {
@@ -2547,20 +2547,10 @@
2547
2547
  "update.js"
2548
2548
  ]
2549
2549
  },
2550
- "style:delete": {
2550
+ "face:attributes": {
2551
2551
  "aliases": [],
2552
- "args": {
2553
- "alias": {
2554
- "description": "Face alias",
2555
- "name": "alias",
2556
- "required": true
2557
- }
2558
- },
2559
- "description": "Delete a face's captured style. The material it was learned from is kept, so the style can be captured again without re-uploading. This never deletes documents or threads: remove those with compile:doc:delete or compile:thread:delete.",
2560
- "examples": [
2561
- "<%= config.bin %> <%= command.id %> alice",
2562
- "<%= config.bin %> <%= command.id %> alice --yes"
2563
- ],
2552
+ "args": {},
2553
+ "description": "List all supported attribute keys",
2564
2554
  "flags": {
2565
2555
  "json": {
2566
2556
  "description": "Format output as json.",
@@ -2592,17 +2582,11 @@
2592
2582
  "hasDynamicHelp": false,
2593
2583
  "multiple": false,
2594
2584
  "type": "option"
2595
- },
2596
- "yes": {
2597
- "description": "Skip confirmation",
2598
- "name": "yes",
2599
- "allowNo": false,
2600
- "type": "boolean"
2601
2585
  }
2602
2586
  },
2603
2587
  "hasDynamicHelp": false,
2604
2588
  "hiddenAliases": [],
2605
- "id": "style:delete",
2589
+ "id": "face:attributes",
2606
2590
  "pluginAlias": "faces-cli",
2607
2591
  "pluginName": "faces-cli",
2608
2592
  "pluginType": "core",
@@ -2612,26 +2596,14 @@
2612
2596
  "relativePath": [
2613
2597
  "dist",
2614
2598
  "commands",
2615
- "style",
2616
- "delete.js"
2599
+ "face",
2600
+ "attributes.js"
2617
2601
  ]
2618
2602
  },
2619
- "style:make": {
2603
+ "face:create": {
2620
2604
  "aliases": [],
2621
- "args": {
2622
- "alias": {
2623
- "description": "Face alias",
2624
- "name": "alias",
2625
- "required": true
2626
- }
2627
- },
2628
- "description": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
2629
- "examples": [
2630
- "<%= config.bin %> <%= command.id %> alice --all",
2631
- "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
2632
- "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
2633
- "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
2634
- ],
2605
+ "args": {},
2606
+ "description": "Create a new face",
2635
2607
  "flags": {
2636
2608
  "json": {
2637
2609
  "description": "Format output as json.",
@@ -2664,62 +2636,77 @@
2664
2636
  "multiple": false,
2665
2637
  "type": "option"
2666
2638
  },
2667
- "source": {
2668
- "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
2669
- "name": "source",
2639
+ "name": {
2640
+ "description": "Display name",
2641
+ "name": "name",
2642
+ "required": true,
2670
2643
  "hasDynamicHelp": false,
2671
- "multiple": true,
2644
+ "multiple": false,
2672
2645
  "type": "option"
2673
2646
  },
2674
- "all": {
2675
- "description": "Use every source on the face that is ready. Anything skipped is listed.",
2676
- "name": "all",
2677
- "allowNo": false,
2678
- "type": "boolean"
2679
- },
2680
- "medium": {
2681
- "description": "Medium for selected sources that do not already declare one. It does not override a source that does. Each medium is analysed on its own, so an essay never teaches a rule about email.",
2682
- "name": "medium",
2647
+ "alias": {
2648
+ "description": "Unique alias slug",
2649
+ "name": "alias",
2650
+ "required": true,
2683
2651
  "hasDynamicHelp": false,
2684
2652
  "multiple": false,
2685
2653
  "type": "option"
2686
2654
  },
2687
- "model": {
2688
- "description": "Analyst model (default: gpt-5.6-terra)",
2689
- "name": "model",
2655
+ "description": {
2656
+ "description": "Plain-text description / bio (max 1500 chars)",
2657
+ "name": "description",
2690
2658
  "hasDynamicHelp": false,
2691
2659
  "multiple": false,
2692
2660
  "type": "option"
2693
2661
  },
2694
- "allow-paid": {
2695
- "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
2696
- "name": "allow-paid",
2697
- "allowNo": false,
2698
- "type": "boolean"
2662
+ "tag": {
2663
+ "description": "Tag label (repeatable, lowercase)",
2664
+ "name": "tag",
2665
+ "hasDynamicHelp": false,
2666
+ "multiple": true,
2667
+ "type": "option"
2699
2668
  },
2700
- "compile": {
2701
- "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
2702
- "name": "compile",
2703
- "allowNo": true,
2704
- "type": "boolean"
2669
+ "default-model": {
2670
+ "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2671
+ "name": "default-model",
2672
+ "hasDynamicHelp": false,
2673
+ "multiple": false,
2674
+ "type": "option"
2705
2675
  },
2706
- "best-of": {
2707
- "description": "Generate N candidates and keep the best (1-5, default 1)",
2708
- "name": "best-of",
2676
+ "formula": {
2677
+ "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
2678
+ "name": "formula",
2709
2679
  "hasDynamicHelp": false,
2710
2680
  "multiple": false,
2711
2681
  "type": "option"
2712
2682
  },
2713
- "no-wait": {
2714
- "description": "Start the build and return the job id without polling.",
2715
- "name": "no-wait",
2716
- "allowNo": false,
2717
- "type": "boolean"
2683
+ "attr": {
2684
+ "description": "Attribute KEY=VALUE (repeatable)",
2685
+ "name": "attr",
2686
+ "hasDynamicHelp": false,
2687
+ "multiple": true,
2688
+ "type": "option"
2718
2689
  },
2719
- "timeout": {
2720
- "description": "How long to wait, in seconds (default: 3600)",
2721
- "name": "timeout",
2722
- "default": 3600,
2690
+ "tool": {
2691
+ "description": "Tool name to enable (repeatable)",
2692
+ "name": "tool",
2693
+ "hasDynamicHelp": false,
2694
+ "multiple": true,
2695
+ "type": "option"
2696
+ },
2697
+ "profile-addendum": {
2698
+ "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
2699
+ "name": "profile-addendum",
2700
+ "hasDynamicHelp": false,
2701
+ "multiple": false,
2702
+ "type": "option"
2703
+ },
2704
+ "profile-addendum-file": {
2705
+ "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
2706
+ "exclusive": [
2707
+ "profile-addendum"
2708
+ ],
2709
+ "name": "profile-addendum-file",
2723
2710
  "hasDynamicHelp": false,
2724
2711
  "multiple": false,
2725
2712
  "type": "option"
@@ -2727,7 +2714,7 @@
2727
2714
  },
2728
2715
  "hasDynamicHelp": false,
2729
2716
  "hiddenAliases": [],
2730
- "id": "style:make",
2717
+ "id": "face:create",
2731
2718
  "pluginAlias": "faces-cli",
2732
2719
  "pluginName": "faces-cli",
2733
2720
  "pluginType": "core",
@@ -2737,24 +2724,20 @@
2737
2724
  "relativePath": [
2738
2725
  "dist",
2739
2726
  "commands",
2740
- "style",
2741
- "make.js"
2742
- ]
2727
+ "face",
2728
+ "create.js"
2729
+ ]
2743
2730
  },
2744
- "style:revert": {
2731
+ "face:delete": {
2745
2732
  "aliases": [],
2746
2733
  "args": {
2747
- "alias": {
2734
+ "face_id": {
2748
2735
  "description": "Face alias",
2749
- "name": "alias",
2736
+ "name": "face_id",
2750
2737
  "required": true
2751
2738
  }
2752
2739
  },
2753
- "description": "Go back to the style a face had before the last style:make. A face holds one style per medium, so name which one with --medium when it has more than one. Two versions are kept per medium, so this goes back exactly one step. It changes how the face writes immediately, so it asks first.",
2754
- "examples": [
2755
- "<%= config.bin %> <%= command.id %> alice --yes",
2756
- "<%= config.bin %> <%= command.id %> alice --medium email --yes"
2757
- ],
2740
+ "description": "Delete a face permanently",
2758
2741
  "flags": {
2759
2742
  "json": {
2760
2743
  "description": "Format output as json.",
@@ -2787,13 +2770,6 @@
2787
2770
  "multiple": false,
2788
2771
  "type": "option"
2789
2772
  },
2790
- "medium": {
2791
- "description": "Which style to step back, when the face has more than one. See faces style:versions <alias>.",
2792
- "name": "medium",
2793
- "hasDynamicHelp": false,
2794
- "multiple": false,
2795
- "type": "option"
2796
- },
2797
2773
  "yes": {
2798
2774
  "description": "Skip confirmation",
2799
2775
  "name": "yes",
@@ -2803,7 +2779,7 @@
2803
2779
  },
2804
2780
  "hasDynamicHelp": false,
2805
2781
  "hiddenAliases": [],
2806
- "id": "style:revert",
2782
+ "id": "face:delete",
2807
2783
  "pluginAlias": "faces-cli",
2808
2784
  "pluginName": "faces-cli",
2809
2785
  "pluginType": "core",
@@ -2813,25 +2789,14 @@
2813
2789
  "relativePath": [
2814
2790
  "dist",
2815
2791
  "commands",
2816
- "style",
2817
- "revert.js"
2792
+ "face",
2793
+ "delete.js"
2818
2794
  ]
2819
2795
  },
2820
- "style:status": {
2796
+ "face:diff": {
2821
2797
  "aliases": [],
2822
- "args": {
2823
- "job_id": {
2824
- "description": "Build job id",
2825
- "name": "job_id",
2826
- "required": false
2827
- }
2828
- },
2829
- "description": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
2830
- "examples": [
2831
- "<%= config.bin %> <%= command.id %> 7a8b9c0d",
2832
- "<%= config.bin %> <%= command.id %> --face alice",
2833
- "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
2834
- ],
2798
+ "args": {},
2799
+ "description": "Compare owned faces pairwise across all centroid components",
2835
2800
  "flags": {
2836
2801
  "json": {
2837
2802
  "description": "Format output as json.",
@@ -2865,38 +2830,17 @@
2865
2830
  "type": "option"
2866
2831
  },
2867
2832
  "face": {
2868
- "description": "List recent builds for this face instead of reading one job",
2833
+ "description": "Face alias to include (repeatable, min 2)",
2869
2834
  "name": "face",
2835
+ "required": true,
2870
2836
  "hasDynamicHelp": false,
2871
- "multiple": false,
2872
- "type": "option"
2873
- },
2874
- "limit": {
2875
- "description": "How many builds to list with --face (default: 10)",
2876
- "name": "limit",
2877
- "default": 10,
2878
- "hasDynamicHelp": false,
2879
- "multiple": false,
2880
- "type": "option"
2881
- },
2882
- "wait": {
2883
- "description": "Block until the job finishes",
2884
- "name": "wait",
2885
- "allowNo": false,
2886
- "type": "boolean"
2887
- },
2888
- "timeout": {
2889
- "description": "How long to wait with --wait, in seconds (default: 3600)",
2890
- "name": "timeout",
2891
- "default": 3600,
2892
- "hasDynamicHelp": false,
2893
- "multiple": false,
2837
+ "multiple": true,
2894
2838
  "type": "option"
2895
2839
  }
2896
2840
  },
2897
2841
  "hasDynamicHelp": false,
2898
2842
  "hiddenAliases": [],
2899
- "id": "style:status",
2843
+ "id": "face:diff",
2900
2844
  "pluginAlias": "faces-cli",
2901
2845
  "pluginName": "faces-cli",
2902
2846
  "pluginType": "core",
@@ -2906,30 +2850,20 @@
2906
2850
  "relativePath": [
2907
2851
  "dist",
2908
2852
  "commands",
2909
- "style",
2910
- "status.js"
2853
+ "face",
2854
+ "diff.js"
2911
2855
  ]
2912
2856
  },
2913
- "style:upload": {
2857
+ "face:edit": {
2914
2858
  "aliases": [],
2915
2859
  "args": {
2916
- "alias": {
2860
+ "face_id": {
2917
2861
  "description": "Face alias",
2918
- "name": "alias",
2919
- "required": true
2920
- },
2921
- "file": {
2922
- "description": "Corpus file",
2923
- "name": "file",
2862
+ "name": "face_id",
2924
2863
  "required": true
2925
2864
  }
2926
2865
  },
2927
- "description": "Load a corpus of a person's own writing (a mail export, a message archive) as source material for style capture. This only stores the material: nothing is compiled and nothing is billed. Capture the style afterwards with style:make.",
2928
- "examples": [
2929
- "<%= config.bin %> <%= command.id %> alice ./mail.jsonl",
2930
- "<%= config.bin %> <%= command.id %> alice ./thread.json --type thread_json",
2931
- "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --messages-per-room 100 --strict"
2932
- ],
2866
+ "description": "Edit a face's metadata",
2933
2867
  "flags": {
2934
2868
  "json": {
2935
2869
  "description": "Format output as json.",
@@ -2962,36 +2896,86 @@
2962
2896
  "multiple": false,
2963
2897
  "type": "option"
2964
2898
  },
2965
- "type": {
2966
- "description": "email_jsonl: one message per line, split across several rooms. thread_json: a JSON array that becomes a single room.",
2967
- "name": "type",
2968
- "default": "email_jsonl",
2899
+ "name": {
2900
+ "description": "New display name",
2901
+ "name": "name",
2969
2902
  "hasDynamicHelp": false,
2970
2903
  "multiple": false,
2971
- "options": [
2972
- "email_jsonl",
2973
- "thread_json"
2974
- ],
2975
2904
  "type": "option"
2976
2905
  },
2977
- "messages-per-room": {
2978
- "description": "How many messages per room when the type is email_jsonl (1-1000, default: 50)",
2979
- "name": "messages-per-room",
2980
- "default": 50,
2906
+ "description": {
2907
+ "description": "Plain-text description / bio (max 1500 chars)",
2908
+ "name": "description",
2981
2909
  "hasDynamicHelp": false,
2982
2910
  "multiple": false,
2983
2911
  "type": "option"
2984
2912
  },
2985
- "strict": {
2986
- "description": "Reject the whole upload if any message is invalid. By default invalid messages are skipped and reported, because a corpus is statistical and a few bad lines are not worth losing the rest.",
2987
- "name": "strict",
2913
+ "tag": {
2914
+ "description": "Replace all tags (repeatable, lowercase)",
2915
+ "name": "tag",
2916
+ "hasDynamicHelp": false,
2917
+ "multiple": true,
2918
+ "type": "option"
2919
+ },
2920
+ "default-model": {
2921
+ "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2922
+ "name": "default-model",
2923
+ "hasDynamicHelp": false,
2924
+ "multiple": false,
2925
+ "type": "option"
2926
+ },
2927
+ "formula": {
2928
+ "description": "New boolean formula (synthetic faces only)",
2929
+ "name": "formula",
2930
+ "hasDynamicHelp": false,
2931
+ "multiple": false,
2932
+ "type": "option"
2933
+ },
2934
+ "attr": {
2935
+ "description": "Update attribute KEY=VALUE (repeatable)",
2936
+ "name": "attr",
2937
+ "hasDynamicHelp": false,
2938
+ "multiple": true,
2939
+ "type": "option"
2940
+ },
2941
+ "tool": {
2942
+ "description": "Tool names to set (replaces list, repeatable)",
2943
+ "name": "tool",
2944
+ "hasDynamicHelp": false,
2945
+ "multiple": true,
2946
+ "type": "option"
2947
+ },
2948
+ "profile-addendum": {
2949
+ "description": "Replace the per-face system prompt (max 100,000 chars).",
2950
+ "name": "profile-addendum",
2951
+ "hasDynamicHelp": false,
2952
+ "multiple": false,
2953
+ "type": "option"
2954
+ },
2955
+ "profile-addendum-file": {
2956
+ "description": "Replace the per-face system prompt from a file.",
2957
+ "exclusive": [
2958
+ "profile-addendum"
2959
+ ],
2960
+ "name": "profile-addendum-file",
2961
+ "hasDynamicHelp": false,
2962
+ "multiple": false,
2963
+ "type": "option"
2964
+ },
2965
+ "clear-profile-addendum": {
2966
+ "description": "Remove the per-face system prompt.",
2967
+ "exclusive": [
2968
+ "profile-addendum",
2969
+ "profile-addendum-file"
2970
+ ],
2971
+ "name": "clear-profile-addendum",
2988
2972
  "allowNo": false,
2989
2973
  "type": "boolean"
2990
2974
  }
2991
2975
  },
2992
2976
  "hasDynamicHelp": false,
2993
2977
  "hiddenAliases": [],
2994
- "id": "style:upload",
2978
+ "id": "face:edit",
2995
2979
  "pluginAlias": "faces-cli",
2996
2980
  "pluginName": "faces-cli",
2997
2981
  "pluginType": "core",
@@ -3001,24 +2985,20 @@
3001
2985
  "relativePath": [
3002
2986
  "dist",
3003
2987
  "commands",
3004
- "style",
3005
- "upload.js"
2988
+ "face",
2989
+ "edit.js"
3006
2990
  ]
3007
2991
  },
3008
- "style:versions": {
2992
+ "face:get": {
3009
2993
  "aliases": [],
3010
2994
  "args": {
3011
- "alias": {
2995
+ "face_id": {
3012
2996
  "description": "Face alias",
3013
- "name": "alias",
2997
+ "name": "face_id",
3014
2998
  "required": true
3015
2999
  }
3016
3000
  },
3017
- "description": "List the styles captured for a face, and which one it writes in now. A face holds one style per medium, so more than one can be in use at once: an email style and an essay style are separate and do not replace each other. Two versions are kept per medium, which is what style:revert has to go back to.",
3018
- "examples": [
3019
- "<%= config.bin %> <%= command.id %> alice",
3020
- "<%= config.bin %> <%= command.id %> alice --json"
3021
- ],
3001
+ "description": "Get details for a face, by alias or owner:alias. A published or shared face is reachable under the same owner:alias address chat uses; it is shown with a note that you do not own it.",
3022
3002
  "flags": {
3023
3003
  "json": {
3024
3004
  "description": "Format output as json.",
@@ -3050,11 +3030,24 @@
3050
3030
  "hasDynamicHelp": false,
3051
3031
  "multiple": false,
3052
3032
  "type": "option"
3033
+ },
3034
+ "include": {
3035
+ "description": "Include extra fields: tags, teams (comma-separated)",
3036
+ "name": "include",
3037
+ "hasDynamicHelp": false,
3038
+ "multiple": false,
3039
+ "type": "option"
3040
+ },
3041
+ "full": {
3042
+ "description": "Print the full profile_addendum instead of a truncated preview",
3043
+ "name": "full",
3044
+ "allowNo": false,
3045
+ "type": "boolean"
3053
3046
  }
3054
3047
  },
3055
3048
  "hasDynamicHelp": false,
3056
3049
  "hiddenAliases": [],
3057
- "id": "style:versions",
3050
+ "id": "face:get",
3058
3051
  "pluginAlias": "faces-cli",
3059
3052
  "pluginName": "faces-cli",
3060
3053
  "pluginType": "core",
@@ -3064,20 +3057,14 @@
3064
3057
  "relativePath": [
3065
3058
  "dist",
3066
3059
  "commands",
3067
- "style",
3068
- "versions.js"
3060
+ "face",
3061
+ "get.js"
3069
3062
  ]
3070
3063
  },
3071
- "team:add": {
3064
+ "face:list": {
3072
3065
  "aliases": [],
3073
- "args": {
3074
- "team_id": {
3075
- "description": "Team ID",
3076
- "name": "team_id",
3077
- "required": true
3078
- }
3079
- },
3080
- "description": "Add face(s) to a team. A team may only contain faces this account owns: a published or shared face can be chatted with but cannot be a member.",
3066
+ "args": {},
3067
+ "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
3081
3068
  "flags": {
3082
3069
  "json": {
3083
3070
  "description": "Format output as json.",
@@ -3110,99 +3097,55 @@
3110
3097
  "multiple": false,
3111
3098
  "type": "option"
3112
3099
  },
3113
- "face": {
3114
- "description": "Face alias to add (repeatable)",
3115
- "name": "face",
3116
- "required": true,
3100
+ "tag": {
3101
+ "description": "Filter by tag (repeatable, AND logic)",
3102
+ "name": "tag",
3117
3103
  "hasDynamicHelp": false,
3118
3104
  "multiple": true,
3119
3105
  "type": "option"
3120
- }
3121
- },
3122
- "hasDynamicHelp": false,
3123
- "hiddenAliases": [],
3124
- "id": "team:add",
3125
- "pluginAlias": "faces-cli",
3126
- "pluginName": "faces-cli",
3127
- "pluginType": "core",
3128
- "strict": true,
3129
- "enableJsonFlag": true,
3130
- "isESM": true,
3131
- "relativePath": [
3132
- "dist",
3133
- "commands",
3134
- "team",
3135
- "add.js"
3136
- ]
3137
- },
3138
- "team:create": {
3139
- "aliases": [],
3140
- "args": {},
3141
- "description": "Create a new team",
3142
- "flags": {
3143
- "json": {
3144
- "description": "Format output as json.",
3145
- "helpGroup": "GLOBAL",
3146
- "name": "json",
3147
- "allowNo": false,
3148
- "type": "boolean"
3149
- },
3150
- "base-url": {
3151
- "description": "API base URL",
3152
- "env": "FACES_BASE_URL",
3153
- "name": "base-url",
3154
- "hasDynamicHelp": false,
3155
- "multiple": false,
3156
- "type": "option"
3157
3106
  },
3158
- "token": {
3159
- "description": "JWT bearer token",
3160
- "env": "FACES_TOKEN",
3161
- "name": "token",
3107
+ "team": {
3108
+ "description": "Filter by team ID (repeatable, OR logic)",
3109
+ "name": "team",
3162
3110
  "hasDynamicHelp": false,
3163
- "multiple": false,
3111
+ "multiple": true,
3164
3112
  "type": "option"
3165
3113
  },
3166
- "api-key": {
3167
- "description": "API key",
3168
- "env": "FACES_API_KEY",
3169
- "name": "api-key",
3114
+ "include": {
3115
+ "description": "Include extra fields: tags, teams (comma-separated)",
3116
+ "name": "include",
3170
3117
  "hasDynamicHelp": false,
3171
3118
  "multiple": false,
3172
3119
  "type": "option"
3173
3120
  },
3174
- "name": {
3175
- "description": "Team name",
3176
- "name": "name",
3177
- "required": true,
3178
- "hasDynamicHelp": false,
3179
- "multiple": false,
3180
- "type": "option"
3121
+ "public": {
3122
+ "description": "Include published faces from other accounts (open to everybody)",
3123
+ "name": "public",
3124
+ "allowNo": false,
3125
+ "type": "boolean"
3181
3126
  },
3182
- "description": {
3183
- "description": "Plain-text team description (max 1500 chars)",
3184
- "name": "description",
3185
- "hasDynamicHelp": false,
3186
- "multiple": false,
3187
- "type": "option"
3127
+ "shared": {
3128
+ "description": "Include faces other accounts have shared with YOU in particular",
3129
+ "name": "shared",
3130
+ "allowNo": false,
3131
+ "type": "boolean"
3188
3132
  },
3189
- "protocol": {
3190
- "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
3191
- "name": "protocol",
3192
- "hasDynamicHelp": false,
3193
- "multiple": false,
3194
- "type": "option"
3133
+ "system": {
3134
+ "description": "Show only the curated system faces (published faces owned by 'head')",
3135
+ "name": "system",
3136
+ "allowNo": false,
3137
+ "type": "boolean"
3195
3138
  },
3196
- "protocol-file": {
3197
- "description": "Read protocol from file",
3198
- "name": "protocol-file",
3139
+ "from-users": {
3140
+ "description": "Only published faces from these owners (repeatable/comma-separated)",
3141
+ "name": "from-users",
3199
3142
  "hasDynamicHelp": false,
3200
- "multiple": false,
3143
+ "multiple": true,
3201
3144
  "type": "option"
3202
3145
  },
3203
- "tag": {
3204
- "description": "Tag label (repeatable, lowercase)",
3205
- "name": "tag",
3146
+ "not-from-users": {
3147
+ "description": "Exclude published faces from these owners (repeatable/comma-separated)",
3148
+ "name": "not-from-users",
3206
3149
  "hasDynamicHelp": false,
3207
3150
  "multiple": true,
3208
3151
  "type": "option"
@@ -3210,7 +3153,7 @@
3210
3153
  },
3211
3154
  "hasDynamicHelp": false,
3212
3155
  "hiddenAliases": [],
3213
- "id": "team:create",
3156
+ "id": "face:list",
3214
3157
  "pluginAlias": "faces-cli",
3215
3158
  "pluginName": "faces-cli",
3216
3159
  "pluginType": "core",
@@ -3220,20 +3163,23 @@
3220
3163
  "relativePath": [
3221
3164
  "dist",
3222
3165
  "commands",
3223
- "team",
3224
- "create.js"
3166
+ "face",
3167
+ "list.js"
3225
3168
  ]
3226
3169
  },
3227
- "team:delete": {
3170
+ "face:lock": {
3228
3171
  "aliases": [],
3229
3172
  "args": {
3230
- "team_id": {
3231
- "description": "Team ID",
3232
- "name": "team_id",
3173
+ "face_id": {
3174
+ "description": "Face alias",
3175
+ "name": "face_id",
3233
3176
  "required": true
3234
3177
  }
3235
3178
  },
3236
- "description": "Delete a team",
3179
+ "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.",
3180
+ "examples": [
3181
+ "<%= config.bin %> <%= command.id %> socrates"
3182
+ ],
3237
3183
  "flags": {
3238
3184
  "json": {
3239
3185
  "description": "Format output as json.",
@@ -3265,17 +3211,11 @@
3265
3211
  "hasDynamicHelp": false,
3266
3212
  "multiple": false,
3267
3213
  "type": "option"
3268
- },
3269
- "yes": {
3270
- "description": "Skip confirmation",
3271
- "name": "yes",
3272
- "allowNo": false,
3273
- "type": "boolean"
3274
3214
  }
3275
3215
  },
3276
3216
  "hasDynamicHelp": false,
3277
3217
  "hiddenAliases": [],
3278
- "id": "team:delete",
3218
+ "id": "face:lock",
3279
3219
  "pluginAlias": "faces-cli",
3280
3220
  "pluginName": "faces-cli",
3281
3221
  "pluginType": "core",
@@ -3285,20 +3225,20 @@
3285
3225
  "relativePath": [
3286
3226
  "dist",
3287
3227
  "commands",
3288
- "team",
3289
- "delete.js"
3228
+ "face",
3229
+ "lock.js"
3290
3230
  ]
3291
3231
  },
3292
- "team:edit": {
3232
+ "face:neighbors": {
3293
3233
  "aliases": [],
3294
3234
  "args": {
3295
- "team_id": {
3296
- "description": "Team ID",
3297
- "name": "team_id",
3235
+ "face_id": {
3236
+ "description": "Face alias",
3237
+ "name": "face_id",
3298
3238
  "required": true
3299
3239
  }
3300
3240
  },
3301
- "description": "Edit a team",
3241
+ "description": "Find the most similar or dissimilar owned faces to a given face",
3302
3242
  "flags": {
3303
3243
  "json": {
3304
3244
  "description": "Format output as json.",
@@ -3331,38 +3271,38 @@
3331
3271
  "multiple": false,
3332
3272
  "type": "option"
3333
3273
  },
3334
- "name": {
3335
- "description": "New team name",
3336
- "name": "name",
3337
- "hasDynamicHelp": false,
3338
- "multiple": false,
3339
- "type": "option"
3340
- },
3341
- "description": {
3342
- "description": "New description (max 1500 chars)",
3343
- "name": "description",
3274
+ "k": {
3275
+ "description": "Number of results (1–20)",
3276
+ "name": "k",
3277
+ "default": 5,
3344
3278
  "hasDynamicHelp": false,
3345
3279
  "multiple": false,
3346
3280
  "type": "option"
3347
3281
  },
3348
- "protocol": {
3349
- "description": "New protocol content",
3350
- "name": "protocol",
3282
+ "component": {
3283
+ "description": "What to rank on: `face` for overall similarity, or a component position such as 1. Which positions are comparable varies; the API names them if you pick a wrong one.",
3284
+ "name": "component",
3285
+ "default": "face",
3351
3286
  "hasDynamicHelp": false,
3352
3287
  "multiple": false,
3353
3288
  "type": "option"
3354
3289
  },
3355
- "protocol-file": {
3356
- "description": "Read protocol from file",
3357
- "name": "protocol-file",
3290
+ "direction": {
3291
+ "description": "nearest (most similar) or furthest (most dissimilar)",
3292
+ "name": "direction",
3293
+ "default": "nearest",
3358
3294
  "hasDynamicHelp": false,
3359
3295
  "multiple": false,
3296
+ "options": [
3297
+ "nearest",
3298
+ "furthest"
3299
+ ],
3360
3300
  "type": "option"
3361
3301
  }
3362
3302
  },
3363
3303
  "hasDynamicHelp": false,
3364
3304
  "hiddenAliases": [],
3365
- "id": "team:edit",
3305
+ "id": "face:neighbors",
3366
3306
  "pluginAlias": "faces-cli",
3367
3307
  "pluginName": "faces-cli",
3368
3308
  "pluginType": "core",
@@ -3372,20 +3312,23 @@
3372
3312
  "relativePath": [
3373
3313
  "dist",
3374
3314
  "commands",
3375
- "team",
3376
- "edit.js"
3315
+ "face",
3316
+ "neighbors.js"
3377
3317
  ]
3378
3318
  },
3379
- "team:get": {
3319
+ "face:publish": {
3380
3320
  "aliases": [],
3381
3321
  "args": {
3382
- "team_id": {
3383
- "description": "Team ID",
3384
- "name": "team_id",
3322
+ "alias": {
3323
+ "description": "Face alias",
3324
+ "name": "alias",
3385
3325
  "required": true
3386
3326
  }
3387
3327
  },
3388
- "description": "Get a team by ID",
3328
+ "description": "Publish a face so EVERY account can chat with it. This is a global override: while it is on, everyone can reach the face regardless of who it is shared with. You still pay only to compile it; whoever chats pays for their own inference.",
3329
+ "examples": [
3330
+ "<%= config.bin %> <%= command.id %> alice --yes"
3331
+ ],
3389
3332
  "flags": {
3390
3333
  "json": {
3391
3334
  "description": "Format output as json.",
@@ -3417,11 +3360,17 @@
3417
3360
  "hasDynamicHelp": false,
3418
3361
  "multiple": false,
3419
3362
  "type": "option"
3363
+ },
3364
+ "yes": {
3365
+ "description": "Skip confirmation",
3366
+ "name": "yes",
3367
+ "allowNo": false,
3368
+ "type": "boolean"
3420
3369
  }
3421
3370
  },
3422
3371
  "hasDynamicHelp": false,
3423
3372
  "hiddenAliases": [],
3424
- "id": "team:get",
3373
+ "id": "face:publish",
3425
3374
  "pluginAlias": "faces-cli",
3426
3375
  "pluginName": "faces-cli",
3427
3376
  "pluginType": "core",
@@ -3431,14 +3380,26 @@
3431
3380
  "relativePath": [
3432
3381
  "dist",
3433
3382
  "commands",
3434
- "team",
3435
- "get.js"
3383
+ "face",
3384
+ "publish.js"
3436
3385
  ]
3437
3386
  },
3438
- "team:list": {
3387
+ "face:share": {
3439
3388
  "aliases": [],
3440
- "args": {},
3441
- "description": "List your teams",
3389
+ "args": {
3390
+ "alias": {
3391
+ "description": "Face alias",
3392
+ "name": "alias",
3393
+ "required": true
3394
+ }
3395
+ },
3396
+ "description": "Share a face so named accounts can chat with it. Sharing grants chat and nothing else: no reading its documents, no compiling, no re-sharing, and never its profile addendum. --add keeps the current list; --with replaces it.",
3397
+ "examples": [
3398
+ "<%= config.bin %> <%= command.id %> alice --list",
3399
+ "<%= config.bin %> <%= command.id %> alice --add dana",
3400
+ "<%= config.bin %> <%= command.id %> alice --with dana --with sam@example.com",
3401
+ "<%= config.bin %> <%= command.id %> alice --none --yes"
3402
+ ],
3442
3403
  "flags": {
3443
3404
  "json": {
3444
3405
  "description": "Format output as json.",
@@ -3470,11 +3431,55 @@
3470
3431
  "hasDynamicHelp": false,
3471
3432
  "multiple": false,
3472
3433
  "type": "option"
3434
+ },
3435
+ "list": {
3436
+ "description": "Show who the face is shared with, and change nothing",
3437
+ "name": "list",
3438
+ "allowNo": false,
3439
+ "type": "boolean"
3440
+ },
3441
+ "add": {
3442
+ "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
3443
+ "exclusive": [
3444
+ "with",
3445
+ "none"
3446
+ ],
3447
+ "name": "add",
3448
+ "hasDynamicHelp": false,
3449
+ "multiple": true,
3450
+ "type": "option"
3451
+ },
3452
+ "with": {
3453
+ "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
3454
+ "exclusive": [
3455
+ "add",
3456
+ "none"
3457
+ ],
3458
+ "name": "with",
3459
+ "hasDynamicHelp": false,
3460
+ "multiple": true,
3461
+ "type": "option"
3462
+ },
3463
+ "none": {
3464
+ "description": "Revoke everyone",
3465
+ "exclusive": [
3466
+ "add",
3467
+ "with"
3468
+ ],
3469
+ "name": "none",
3470
+ "allowNo": false,
3471
+ "type": "boolean"
3472
+ },
3473
+ "yes": {
3474
+ "description": "Skip the confirmation shown when someone would lose access",
3475
+ "name": "yes",
3476
+ "allowNo": false,
3477
+ "type": "boolean"
3473
3478
  }
3474
3479
  },
3475
3480
  "hasDynamicHelp": false,
3476
3481
  "hiddenAliases": [],
3477
- "id": "team:list",
3482
+ "id": "face:share",
3478
3483
  "pluginAlias": "faces-cli",
3479
3484
  "pluginName": "faces-cli",
3480
3485
  "pluginType": "core",
@@ -3484,20 +3489,25 @@
3484
3489
  "relativePath": [
3485
3490
  "dist",
3486
3491
  "commands",
3487
- "team",
3488
- "list.js"
3492
+ "face",
3493
+ "share.js"
3489
3494
  ]
3490
3495
  },
3491
- "team:members": {
3496
+ "face:sources": {
3492
3497
  "aliases": [],
3493
3498
  "args": {
3494
- "team_id": {
3495
- "description": "Team ID",
3496
- "name": "team_id",
3499
+ "alias": {
3500
+ "description": "Face alias",
3501
+ "name": "alias",
3497
3502
  "required": true
3498
3503
  }
3499
3504
  },
3500
- "description": "List members of a team",
3505
+ "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
3506
+ "examples": [
3507
+ "<%= config.bin %> <%= command.id %> alice",
3508
+ "<%= config.bin %> <%= command.id %> alice --type thread",
3509
+ "<%= config.bin %> <%= command.id %> alice --json"
3510
+ ],
3501
3511
  "flags": {
3502
3512
  "json": {
3503
3513
  "description": "Format output as json.",
@@ -3529,11 +3539,22 @@
3529
3539
  "hasDynamicHelp": false,
3530
3540
  "multiple": false,
3531
3541
  "type": "option"
3542
+ },
3543
+ "type": {
3544
+ "description": "Show only one kind of source",
3545
+ "name": "type",
3546
+ "hasDynamicHelp": false,
3547
+ "multiple": false,
3548
+ "options": [
3549
+ "doc",
3550
+ "thread"
3551
+ ],
3552
+ "type": "option"
3532
3553
  }
3533
3554
  },
3534
3555
  "hasDynamicHelp": false,
3535
3556
  "hiddenAliases": [],
3536
- "id": "team:members",
3557
+ "id": "face:sources",
3537
3558
  "pluginAlias": "faces-cli",
3538
3559
  "pluginName": "faces-cli",
3539
3560
  "pluginType": "core",
@@ -3543,25 +3564,14 @@
3543
3564
  "relativePath": [
3544
3565
  "dist",
3545
3566
  "commands",
3546
- "team",
3547
- "members.js"
3567
+ "face",
3568
+ "sources.js"
3548
3569
  ]
3549
3570
  },
3550
- "team:remove": {
3571
+ "face:stats": {
3551
3572
  "aliases": [],
3552
- "args": {
3553
- "team_id": {
3554
- "description": "Team ID",
3555
- "name": "team_id",
3556
- "required": true
3557
- },
3558
- "alias": {
3559
- "description": "Face alias to remove",
3560
- "name": "alias",
3561
- "required": true
3562
- }
3563
- },
3564
- "description": "Remove a face from a team",
3573
+ "args": {},
3574
+ "description": "Compile and chat stats for all owned faces",
3565
3575
  "flags": {
3566
3576
  "json": {
3567
3577
  "description": "Format output as json.",
@@ -3597,7 +3607,7 @@
3597
3607
  },
3598
3608
  "hasDynamicHelp": false,
3599
3609
  "hiddenAliases": [],
3600
- "id": "team:remove",
3610
+ "id": "face:stats",
3601
3611
  "pluginAlias": "faces-cli",
3602
3612
  "pluginName": "faces-cli",
3603
3613
  "pluginType": "core",
@@ -3607,14 +3617,20 @@
3607
3617
  "relativePath": [
3608
3618
  "dist",
3609
3619
  "commands",
3610
- "team",
3611
- "remove.js"
3620
+ "face",
3621
+ "stats.js"
3612
3622
  ]
3613
3623
  },
3614
- "face:attributes": {
3624
+ "face:teams": {
3615
3625
  "aliases": [],
3616
- "args": {},
3617
- "description": "List all supported attribute keys",
3626
+ "args": {
3627
+ "alias": {
3628
+ "description": "Face alias",
3629
+ "name": "alias",
3630
+ "required": true
3631
+ }
3632
+ },
3633
+ "description": "Set a face's team memberships (replaces all)",
3618
3634
  "flags": {
3619
3635
  "json": {
3620
3636
  "description": "Format output as json.",
@@ -3646,11 +3662,19 @@
3646
3662
  "hasDynamicHelp": false,
3647
3663
  "multiple": false,
3648
3664
  "type": "option"
3665
+ },
3666
+ "team": {
3667
+ "description": "Team ID (repeatable, replaces all memberships)",
3668
+ "name": "team",
3669
+ "required": true,
3670
+ "hasDynamicHelp": false,
3671
+ "multiple": true,
3672
+ "type": "option"
3649
3673
  }
3650
3674
  },
3651
3675
  "hasDynamicHelp": false,
3652
3676
  "hiddenAliases": [],
3653
- "id": "face:attributes",
3677
+ "id": "face:teams",
3654
3678
  "pluginAlias": "faces-cli",
3655
3679
  "pluginName": "faces-cli",
3656
3680
  "pluginType": "core",
@@ -3661,13 +3685,22 @@
3661
3685
  "dist",
3662
3686
  "commands",
3663
3687
  "face",
3664
- "attributes.js"
3688
+ "teams.js"
3665
3689
  ]
3666
3690
  },
3667
- "face:create": {
3691
+ "face:unlock": {
3668
3692
  "aliases": [],
3669
- "args": {},
3670
- "description": "Create a new face",
3693
+ "args": {
3694
+ "face_id": {
3695
+ "description": "Face alias",
3696
+ "name": "face_id",
3697
+ "required": true
3698
+ }
3699
+ },
3700
+ "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
3701
+ "examples": [
3702
+ "<%= config.bin %> <%= command.id %> socrates"
3703
+ ],
3671
3704
  "flags": {
3672
3705
  "json": {
3673
3706
  "description": "Format output as json.",
@@ -3699,78 +3732,62 @@
3699
3732
  "hasDynamicHelp": false,
3700
3733
  "multiple": false,
3701
3734
  "type": "option"
3702
- },
3703
- "name": {
3704
- "description": "Display name",
3705
- "name": "name",
3706
- "required": true,
3707
- "hasDynamicHelp": false,
3708
- "multiple": false,
3709
- "type": "option"
3710
- },
3735
+ }
3736
+ },
3737
+ "hasDynamicHelp": false,
3738
+ "hiddenAliases": [],
3739
+ "id": "face:unlock",
3740
+ "pluginAlias": "faces-cli",
3741
+ "pluginName": "faces-cli",
3742
+ "pluginType": "core",
3743
+ "strict": true,
3744
+ "enableJsonFlag": true,
3745
+ "isESM": true,
3746
+ "relativePath": [
3747
+ "dist",
3748
+ "commands",
3749
+ "face",
3750
+ "unlock.js"
3751
+ ]
3752
+ },
3753
+ "face:unpublish": {
3754
+ "aliases": [],
3755
+ "args": {
3711
3756
  "alias": {
3712
- "description": "Unique alias slug",
3757
+ "description": "Face alias",
3713
3758
  "name": "alias",
3714
- "required": true,
3715
- "hasDynamicHelp": false,
3716
- "multiple": false,
3717
- "type": "option"
3718
- },
3719
- "description": {
3720
- "description": "Plain-text description / bio (max 1500 chars)",
3721
- "name": "description",
3722
- "hasDynamicHelp": false,
3723
- "multiple": false,
3724
- "type": "option"
3725
- },
3726
- "tag": {
3727
- "description": "Tag label (repeatable, lowercase)",
3728
- "name": "tag",
3729
- "hasDynamicHelp": false,
3730
- "multiple": true,
3731
- "type": "option"
3732
- },
3733
- "default-model": {
3734
- "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
3735
- "name": "default-model",
3736
- "hasDynamicHelp": false,
3737
- "multiple": false,
3738
- "type": "option"
3759
+ "required": true
3760
+ }
3761
+ },
3762
+ "description": "Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an override on top of sharing, not a replacement for it.",
3763
+ "flags": {
3764
+ "json": {
3765
+ "description": "Format output as json.",
3766
+ "helpGroup": "GLOBAL",
3767
+ "name": "json",
3768
+ "allowNo": false,
3769
+ "type": "boolean"
3739
3770
  },
3740
- "formula": {
3741
- "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
3742
- "name": "formula",
3771
+ "base-url": {
3772
+ "description": "API base URL",
3773
+ "env": "FACES_BASE_URL",
3774
+ "name": "base-url",
3743
3775
  "hasDynamicHelp": false,
3744
3776
  "multiple": false,
3745
3777
  "type": "option"
3746
3778
  },
3747
- "attr": {
3748
- "description": "Attribute KEY=VALUE (repeatable)",
3749
- "name": "attr",
3750
- "hasDynamicHelp": false,
3751
- "multiple": true,
3752
- "type": "option"
3753
- },
3754
- "tool": {
3755
- "description": "Tool name to enable (repeatable)",
3756
- "name": "tool",
3757
- "hasDynamicHelp": false,
3758
- "multiple": true,
3759
- "type": "option"
3760
- },
3761
- "profile-addendum": {
3762
- "description": "Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).",
3763
- "name": "profile-addendum",
3779
+ "token": {
3780
+ "description": "JWT bearer token",
3781
+ "env": "FACES_TOKEN",
3782
+ "name": "token",
3764
3783
  "hasDynamicHelp": false,
3765
3784
  "multiple": false,
3766
3785
  "type": "option"
3767
3786
  },
3768
- "profile-addendum-file": {
3769
- "description": "Read the per-face system prompt from a file (alternative to --profile-addendum).",
3770
- "exclusive": [
3771
- "profile-addendum"
3772
- ],
3773
- "name": "profile-addendum-file",
3787
+ "api-key": {
3788
+ "description": "API key",
3789
+ "env": "FACES_API_KEY",
3790
+ "name": "api-key",
3774
3791
  "hasDynamicHelp": false,
3775
3792
  "multiple": false,
3776
3793
  "type": "option"
@@ -3778,7 +3795,7 @@
3778
3795
  },
3779
3796
  "hasDynamicHelp": false,
3780
3797
  "hiddenAliases": [],
3781
- "id": "face:create",
3798
+ "id": "face:unpublish",
3782
3799
  "pluginAlias": "faces-cli",
3783
3800
  "pluginName": "faces-cli",
3784
3801
  "pluginType": "core",
@@ -3789,19 +3806,23 @@
3789
3806
  "dist",
3790
3807
  "commands",
3791
3808
  "face",
3792
- "create.js"
3809
+ "unpublish.js"
3793
3810
  ]
3794
3811
  },
3795
- "face:delete": {
3812
+ "face:unshare": {
3796
3813
  "aliases": [],
3797
3814
  "args": {
3798
- "face_id": {
3815
+ "alias": {
3799
3816
  "description": "Face alias",
3800
- "name": "face_id",
3817
+ "name": "alias",
3801
3818
  "required": true
3802
3819
  }
3803
3820
  },
3804
- "description": "Delete a face permanently",
3821
+ "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
3822
+ "examples": [
3823
+ "<%= config.bin %> <%= command.id %> alice --from dana --yes",
3824
+ "<%= config.bin %> <%= command.id %> alice --all --yes"
3825
+ ],
3805
3826
  "flags": {
3806
3827
  "json": {
3807
3828
  "description": "Format output as json.",
@@ -3834,6 +3855,25 @@
3834
3855
  "multiple": false,
3835
3856
  "type": "option"
3836
3857
  },
3858
+ "from": {
3859
+ "description": "Account to revoke (repeatable)",
3860
+ "exclusive": [
3861
+ "all"
3862
+ ],
3863
+ "name": "from",
3864
+ "hasDynamicHelp": false,
3865
+ "multiple": true,
3866
+ "type": "option"
3867
+ },
3868
+ "all": {
3869
+ "description": "Revoke everyone",
3870
+ "exclusive": [
3871
+ "from"
3872
+ ],
3873
+ "name": "all",
3874
+ "allowNo": false,
3875
+ "type": "boolean"
3876
+ },
3837
3877
  "yes": {
3838
3878
  "description": "Skip confirmation",
3839
3879
  "name": "yes",
@@ -3843,7 +3883,7 @@
3843
3883
  },
3844
3884
  "hasDynamicHelp": false,
3845
3885
  "hiddenAliases": [],
3846
- "id": "face:delete",
3886
+ "id": "face:unshare",
3847
3887
  "pluginAlias": "faces-cli",
3848
3888
  "pluginName": "faces-cli",
3849
3889
  "pluginType": "core",
@@ -3854,13 +3894,23 @@
3854
3894
  "dist",
3855
3895
  "commands",
3856
3896
  "face",
3857
- "delete.js"
3897
+ "unshare.js"
3858
3898
  ]
3859
3899
  },
3860
- "face:diff": {
3900
+ "style:delete": {
3861
3901
  "aliases": [],
3862
- "args": {},
3863
- "description": "Compare owned faces pairwise across all centroid components",
3902
+ "args": {
3903
+ "alias": {
3904
+ "description": "Face alias",
3905
+ "name": "alias",
3906
+ "required": true
3907
+ }
3908
+ },
3909
+ "description": "Delete a face's captured style. The material it was learned from is kept, so the style can be captured again without re-uploading. This never deletes documents or threads: remove those with compile:doc:delete or compile:thread:delete.",
3910
+ "examples": [
3911
+ "<%= config.bin %> <%= command.id %> alice",
3912
+ "<%= config.bin %> <%= command.id %> alice --yes"
3913
+ ],
3864
3914
  "flags": {
3865
3915
  "json": {
3866
3916
  "description": "Format output as json.",
@@ -3893,18 +3943,16 @@
3893
3943
  "multiple": false,
3894
3944
  "type": "option"
3895
3945
  },
3896
- "face": {
3897
- "description": "Face alias to include (repeatable, min 2)",
3898
- "name": "face",
3899
- "required": true,
3900
- "hasDynamicHelp": false,
3901
- "multiple": true,
3902
- "type": "option"
3946
+ "yes": {
3947
+ "description": "Skip confirmation",
3948
+ "name": "yes",
3949
+ "allowNo": false,
3950
+ "type": "boolean"
3903
3951
  }
3904
3952
  },
3905
3953
  "hasDynamicHelp": false,
3906
3954
  "hiddenAliases": [],
3907
- "id": "face:diff",
3955
+ "id": "style:delete",
3908
3956
  "pluginAlias": "faces-cli",
3909
3957
  "pluginName": "faces-cli",
3910
3958
  "pluginType": "core",
@@ -3914,20 +3962,26 @@
3914
3962
  "relativePath": [
3915
3963
  "dist",
3916
3964
  "commands",
3917
- "face",
3918
- "diff.js"
3965
+ "style",
3966
+ "delete.js"
3919
3967
  ]
3920
3968
  },
3921
- "face:edit": {
3969
+ "style:make": {
3922
3970
  "aliases": [],
3923
3971
  "args": {
3924
- "face_id": {
3972
+ "alias": {
3925
3973
  "description": "Face alias",
3926
- "name": "face_id",
3974
+ "name": "alias",
3927
3975
  "required": true
3928
3976
  }
3929
3977
  },
3930
- "description": "Edit a face's metadata",
3978
+ "description": "Capture how a face writes, from its own material, and install it. This is style, not knowledge: compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn from with --source, or take everything ready with --all.",
3979
+ "examples": [
3980
+ "<%= config.bin %> <%= command.id %> alice --all",
3981
+ "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d --source 5e6f7a8b",
3982
+ "<%= config.bin %> <%= command.id %> alice --source 1a2b3c4d:essay",
3983
+ "<%= config.bin %> <%= command.id %> alice --all --medium essay --no-wait"
3984
+ ],
3931
3985
  "flags": {
3932
3986
  "json": {
3933
3987
  "description": "Format output as json.",
@@ -3960,86 +4014,70 @@
3960
4014
  "multiple": false,
3961
4015
  "type": "option"
3962
4016
  },
3963
- "name": {
3964
- "description": "New display name",
3965
- "name": "name",
3966
- "hasDynamicHelp": false,
3967
- "multiple": false,
3968
- "type": "option"
3969
- },
3970
- "description": {
3971
- "description": "Plain-text description / bio (max 1500 chars)",
3972
- "name": "description",
3973
- "hasDynamicHelp": false,
3974
- "multiple": false,
3975
- "type": "option"
3976
- },
3977
- "tag": {
3978
- "description": "Replace all tags (repeatable, lowercase)",
3979
- "name": "tag",
4017
+ "source": {
4018
+ "description": "A document or thread to learn from, by id (repeatable). Append :<medium> to declare what it is, e.g. --source 1a2b3c4d:essay, when the source does not already say.",
4019
+ "name": "source",
3980
4020
  "hasDynamicHelp": false,
3981
4021
  "multiple": true,
3982
4022
  "type": "option"
3983
4023
  },
3984
- "default-model": {
3985
- "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
3986
- "name": "default-model",
4024
+ "all": {
4025
+ "description": "Use every source on the face that is ready. Anything skipped is listed.",
4026
+ "name": "all",
4027
+ "allowNo": false,
4028
+ "type": "boolean"
4029
+ },
4030
+ "medium": {
4031
+ "description": "Medium for selected sources that do not already declare one. It does not override a source that does. Each medium is analysed on its own, so an essay never teaches a rule about email.",
4032
+ "name": "medium",
3987
4033
  "hasDynamicHelp": false,
3988
4034
  "multiple": false,
3989
4035
  "type": "option"
3990
4036
  },
3991
- "formula": {
3992
- "description": "New boolean formula (synthetic faces only)",
3993
- "name": "formula",
4037
+ "model": {
4038
+ "description": "Analyst model (default: gpt-5.6-terra)",
4039
+ "name": "model",
3994
4040
  "hasDynamicHelp": false,
3995
4041
  "multiple": false,
3996
4042
  "type": "option"
3997
4043
  },
3998
- "attr": {
3999
- "description": "Update attribute KEY=VALUE (repeatable)",
4000
- "name": "attr",
4001
- "hasDynamicHelp": false,
4002
- "multiple": true,
4003
- "type": "option"
4044
+ "allow-paid": {
4045
+ "description": "Permit a build that bills. Without this a build is free or it does not run. Needed for any model outside the free tier, and to allow the paid route when a free quota is exhausted.",
4046
+ "name": "allow-paid",
4047
+ "allowNo": false,
4048
+ "type": "boolean"
4004
4049
  },
4005
- "tool": {
4006
- "description": "Tool names to set (replaces list, repeatable)",
4007
- "name": "tool",
4008
- "hasDynamicHelp": false,
4009
- "multiple": true,
4010
- "type": "option"
4050
+ "compile": {
4051
+ "description": "Compile any named source that is not compiled yet, before capturing style. On by default. --no-compile captures style from what is already compiled and never bills for compilation.",
4052
+ "name": "compile",
4053
+ "allowNo": true,
4054
+ "type": "boolean"
4011
4055
  },
4012
- "profile-addendum": {
4013
- "description": "Replace the per-face system prompt (max 100,000 chars).",
4014
- "name": "profile-addendum",
4056
+ "best-of": {
4057
+ "description": "Generate N candidates and keep the best (1-5, default 1)",
4058
+ "name": "best-of",
4015
4059
  "hasDynamicHelp": false,
4016
4060
  "multiple": false,
4017
4061
  "type": "option"
4018
4062
  },
4019
- "profile-addendum-file": {
4020
- "description": "Replace the per-face system prompt from a file.",
4021
- "exclusive": [
4022
- "profile-addendum"
4023
- ],
4024
- "name": "profile-addendum-file",
4063
+ "no-wait": {
4064
+ "description": "Start the build and return the job id without polling.",
4065
+ "name": "no-wait",
4066
+ "allowNo": false,
4067
+ "type": "boolean"
4068
+ },
4069
+ "timeout": {
4070
+ "description": "How long to wait, in seconds (default: 3600)",
4071
+ "name": "timeout",
4072
+ "default": 3600,
4025
4073
  "hasDynamicHelp": false,
4026
4074
  "multiple": false,
4027
4075
  "type": "option"
4028
- },
4029
- "clear-profile-addendum": {
4030
- "description": "Remove the per-face system prompt.",
4031
- "exclusive": [
4032
- "profile-addendum",
4033
- "profile-addendum-file"
4034
- ],
4035
- "name": "clear-profile-addendum",
4036
- "allowNo": false,
4037
- "type": "boolean"
4038
4076
  }
4039
4077
  },
4040
4078
  "hasDynamicHelp": false,
4041
4079
  "hiddenAliases": [],
4042
- "id": "face:edit",
4080
+ "id": "style:make",
4043
4081
  "pluginAlias": "faces-cli",
4044
4082
  "pluginName": "faces-cli",
4045
4083
  "pluginType": "core",
@@ -4049,20 +4087,24 @@
4049
4087
  "relativePath": [
4050
4088
  "dist",
4051
4089
  "commands",
4052
- "face",
4053
- "edit.js"
4090
+ "style",
4091
+ "make.js"
4054
4092
  ]
4055
4093
  },
4056
- "face:get": {
4094
+ "style:revert": {
4057
4095
  "aliases": [],
4058
4096
  "args": {
4059
- "face_id": {
4097
+ "alias": {
4060
4098
  "description": "Face alias",
4061
- "name": "face_id",
4099
+ "name": "alias",
4062
4100
  "required": true
4063
4101
  }
4064
4102
  },
4065
- "description": "Get details for a face, by alias or owner:alias. A published or shared face is reachable under the same owner:alias address chat uses; it is shown with a note that you do not own it.",
4103
+ "description": "Go back to the style a face had before the last style:make. A face holds one style per medium, so name which one with --medium when it has more than one. Two versions are kept per medium, so this goes back exactly one step. It changes how the face writes immediately, so it asks first.",
4104
+ "examples": [
4105
+ "<%= config.bin %> <%= command.id %> alice --yes",
4106
+ "<%= config.bin %> <%= command.id %> alice --medium email --yes"
4107
+ ],
4066
4108
  "flags": {
4067
4109
  "json": {
4068
4110
  "description": "Format output as json.",
@@ -4095,23 +4137,23 @@
4095
4137
  "multiple": false,
4096
4138
  "type": "option"
4097
4139
  },
4098
- "include": {
4099
- "description": "Include extra fields: tags, teams (comma-separated)",
4100
- "name": "include",
4140
+ "medium": {
4141
+ "description": "Which style to step back, when the face has more than one. See faces style:versions <alias>.",
4142
+ "name": "medium",
4101
4143
  "hasDynamicHelp": false,
4102
4144
  "multiple": false,
4103
4145
  "type": "option"
4104
4146
  },
4105
- "full": {
4106
- "description": "Print the full profile_addendum instead of a truncated preview",
4107
- "name": "full",
4147
+ "yes": {
4148
+ "description": "Skip confirmation",
4149
+ "name": "yes",
4108
4150
  "allowNo": false,
4109
4151
  "type": "boolean"
4110
4152
  }
4111
4153
  },
4112
4154
  "hasDynamicHelp": false,
4113
4155
  "hiddenAliases": [],
4114
- "id": "face:get",
4156
+ "id": "style:revert",
4115
4157
  "pluginAlias": "faces-cli",
4116
4158
  "pluginName": "faces-cli",
4117
4159
  "pluginType": "core",
@@ -4121,14 +4163,25 @@
4121
4163
  "relativePath": [
4122
4164
  "dist",
4123
4165
  "commands",
4124
- "face",
4125
- "get.js"
4166
+ "style",
4167
+ "revert.js"
4126
4168
  ]
4127
4169
  },
4128
- "face:list": {
4170
+ "style:status": {
4129
4171
  "aliases": [],
4130
- "args": {},
4131
- "description": "List faces. By default lists owned faces; use --public to include published faces from other accounts.",
4172
+ "args": {
4173
+ "job_id": {
4174
+ "description": "Build job id",
4175
+ "name": "job_id",
4176
+ "required": false
4177
+ }
4178
+ },
4179
+ "description": "Read a style build. Give a job id for one build, or --face to list a face's recent builds. Listing is how you find a job id you no longer have.",
4180
+ "examples": [
4181
+ "<%= config.bin %> <%= command.id %> 7a8b9c0d",
4182
+ "<%= config.bin %> <%= command.id %> --face alice",
4183
+ "<%= config.bin %> <%= command.id %> 7a8b9c0d --wait"
4184
+ ],
4132
4185
  "flags": {
4133
4186
  "json": {
4134
4187
  "description": "Format output as json.",
@@ -4161,63 +4214,39 @@
4161
4214
  "multiple": false,
4162
4215
  "type": "option"
4163
4216
  },
4164
- "tag": {
4165
- "description": "Filter by tag (repeatable, AND logic)",
4166
- "name": "tag",
4167
- "hasDynamicHelp": false,
4168
- "multiple": true,
4169
- "type": "option"
4170
- },
4171
- "team": {
4172
- "description": "Filter by team ID (repeatable, OR logic)",
4173
- "name": "team",
4217
+ "face": {
4218
+ "description": "List recent builds for this face instead of reading one job",
4219
+ "name": "face",
4174
4220
  "hasDynamicHelp": false,
4175
- "multiple": true,
4221
+ "multiple": false,
4176
4222
  "type": "option"
4177
4223
  },
4178
- "include": {
4179
- "description": "Include extra fields: tags, teams (comma-separated)",
4180
- "name": "include",
4224
+ "limit": {
4225
+ "description": "How many builds to list with --face (default: 10)",
4226
+ "name": "limit",
4227
+ "default": 10,
4181
4228
  "hasDynamicHelp": false,
4182
4229
  "multiple": false,
4183
4230
  "type": "option"
4184
4231
  },
4185
- "public": {
4186
- "description": "Include published faces from other accounts (open to everybody)",
4187
- "name": "public",
4188
- "allowNo": false,
4189
- "type": "boolean"
4190
- },
4191
- "shared": {
4192
- "description": "Include faces other accounts have shared with YOU in particular",
4193
- "name": "shared",
4194
- "allowNo": false,
4195
- "type": "boolean"
4196
- },
4197
- "system": {
4198
- "description": "Show only the curated system faces (published faces owned by 'head')",
4199
- "name": "system",
4232
+ "wait": {
4233
+ "description": "Block until the job finishes",
4234
+ "name": "wait",
4200
4235
  "allowNo": false,
4201
4236
  "type": "boolean"
4202
4237
  },
4203
- "from-users": {
4204
- "description": "Only published faces from these owners (repeatable/comma-separated)",
4205
- "name": "from-users",
4206
- "hasDynamicHelp": false,
4207
- "multiple": true,
4208
- "type": "option"
4209
- },
4210
- "not-from-users": {
4211
- "description": "Exclude published faces from these owners (repeatable/comma-separated)",
4212
- "name": "not-from-users",
4238
+ "timeout": {
4239
+ "description": "How long to wait with --wait, in seconds (default: 3600)",
4240
+ "name": "timeout",
4241
+ "default": 3600,
4213
4242
  "hasDynamicHelp": false,
4214
- "multiple": true,
4243
+ "multiple": false,
4215
4244
  "type": "option"
4216
4245
  }
4217
4246
  },
4218
4247
  "hasDynamicHelp": false,
4219
4248
  "hiddenAliases": [],
4220
- "id": "face:list",
4249
+ "id": "style:status",
4221
4250
  "pluginAlias": "faces-cli",
4222
4251
  "pluginName": "faces-cli",
4223
4252
  "pluginType": "core",
@@ -4227,22 +4256,29 @@
4227
4256
  "relativePath": [
4228
4257
  "dist",
4229
4258
  "commands",
4230
- "face",
4231
- "list.js"
4259
+ "style",
4260
+ "status.js"
4232
4261
  ]
4233
4262
  },
4234
- "face:lock": {
4263
+ "style:upload": {
4235
4264
  "aliases": [],
4236
4265
  "args": {
4237
- "face_id": {
4266
+ "alias": {
4238
4267
  "description": "Face alias",
4239
- "name": "face_id",
4268
+ "name": "alias",
4269
+ "required": true
4270
+ },
4271
+ "file": {
4272
+ "description": "Corpus file",
4273
+ "name": "file",
4240
4274
  "required": true
4241
4275
  }
4242
4276
  },
4243
- "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.",
4277
+ "description": "Load a corpus of a person's own writing (a mail export, a message archive) as source material for style capture. This only stores the material: nothing is compiled and nothing is billed. Capture the style afterwards with style:make.",
4244
4278
  "examples": [
4245
- "<%= config.bin %> <%= command.id %> socrates"
4279
+ "<%= config.bin %> <%= command.id %> alice ./mail.jsonl",
4280
+ "<%= config.bin %> <%= command.id %> alice ./thread.json --type thread_json",
4281
+ "<%= config.bin %> <%= command.id %> alice ./mail.jsonl --messages-per-room 100 --strict"
4246
4282
  ],
4247
4283
  "flags": {
4248
4284
  "json": {
@@ -4275,11 +4311,37 @@
4275
4311
  "hasDynamicHelp": false,
4276
4312
  "multiple": false,
4277
4313
  "type": "option"
4314
+ },
4315
+ "type": {
4316
+ "description": "email_jsonl: one message per line, split across several rooms. thread_json: a JSON array that becomes a single room.",
4317
+ "name": "type",
4318
+ "default": "email_jsonl",
4319
+ "hasDynamicHelp": false,
4320
+ "multiple": false,
4321
+ "options": [
4322
+ "email_jsonl",
4323
+ "thread_json"
4324
+ ],
4325
+ "type": "option"
4326
+ },
4327
+ "messages-per-room": {
4328
+ "description": "How many messages per room when the type is email_jsonl (1-1000, default: 50)",
4329
+ "name": "messages-per-room",
4330
+ "default": 50,
4331
+ "hasDynamicHelp": false,
4332
+ "multiple": false,
4333
+ "type": "option"
4334
+ },
4335
+ "strict": {
4336
+ "description": "Reject the whole upload if any message is invalid. By default invalid messages are skipped and reported, because a corpus is statistical and a few bad lines are not worth losing the rest.",
4337
+ "name": "strict",
4338
+ "allowNo": false,
4339
+ "type": "boolean"
4278
4340
  }
4279
4341
  },
4280
4342
  "hasDynamicHelp": false,
4281
4343
  "hiddenAliases": [],
4282
- "id": "face:lock",
4344
+ "id": "style:upload",
4283
4345
  "pluginAlias": "faces-cli",
4284
4346
  "pluginName": "faces-cli",
4285
4347
  "pluginType": "core",
@@ -4289,20 +4351,24 @@
4289
4351
  "relativePath": [
4290
4352
  "dist",
4291
4353
  "commands",
4292
- "face",
4293
- "lock.js"
4354
+ "style",
4355
+ "upload.js"
4294
4356
  ]
4295
4357
  },
4296
- "face:neighbors": {
4358
+ "style:versions": {
4297
4359
  "aliases": [],
4298
4360
  "args": {
4299
- "face_id": {
4361
+ "alias": {
4300
4362
  "description": "Face alias",
4301
- "name": "face_id",
4363
+ "name": "alias",
4302
4364
  "required": true
4303
4365
  }
4304
4366
  },
4305
- "description": "Find the most similar or dissimilar owned faces to a given face",
4367
+ "description": "List the styles captured for a face, and which one it writes in now. A face holds one style per medium, so more than one can be in use at once: an email style and an essay style are separate and do not replace each other. Two versions are kept per medium, which is what style:revert has to go back to.",
4368
+ "examples": [
4369
+ "<%= config.bin %> <%= command.id %> alice",
4370
+ "<%= config.bin %> <%= command.id %> alice --json"
4371
+ ],
4306
4372
  "flags": {
4307
4373
  "json": {
4308
4374
  "description": "Format output as json.",
@@ -4334,39 +4400,11 @@
4334
4400
  "hasDynamicHelp": false,
4335
4401
  "multiple": false,
4336
4402
  "type": "option"
4337
- },
4338
- "k": {
4339
- "description": "Number of results (1–20)",
4340
- "name": "k",
4341
- "default": 5,
4342
- "hasDynamicHelp": false,
4343
- "multiple": false,
4344
- "type": "option"
4345
- },
4346
- "component": {
4347
- "description": "What to rank on: `face` for overall similarity, or a component position such as 1. Which positions are comparable varies; the API names them if you pick a wrong one.",
4348
- "name": "component",
4349
- "default": "face",
4350
- "hasDynamicHelp": false,
4351
- "multiple": false,
4352
- "type": "option"
4353
- },
4354
- "direction": {
4355
- "description": "nearest (most similar) or furthest (most dissimilar)",
4356
- "name": "direction",
4357
- "default": "nearest",
4358
- "hasDynamicHelp": false,
4359
- "multiple": false,
4360
- "options": [
4361
- "nearest",
4362
- "furthest"
4363
- ],
4364
- "type": "option"
4365
4403
  }
4366
4404
  },
4367
4405
  "hasDynamicHelp": false,
4368
4406
  "hiddenAliases": [],
4369
- "id": "face:neighbors",
4407
+ "id": "style:versions",
4370
4408
  "pluginAlias": "faces-cli",
4371
4409
  "pluginName": "faces-cli",
4372
4410
  "pluginType": "core",
@@ -4376,22 +4414,23 @@
4376
4414
  "relativePath": [
4377
4415
  "dist",
4378
4416
  "commands",
4379
- "face",
4380
- "neighbors.js"
4417
+ "style",
4418
+ "versions.js"
4381
4419
  ]
4382
4420
  },
4383
- "face:publish": {
4421
+ "team:add": {
4384
4422
  "aliases": [],
4385
4423
  "args": {
4386
- "alias": {
4387
- "description": "Face alias",
4388
- "name": "alias",
4424
+ "team_id": {
4425
+ "description": "Team ID",
4426
+ "name": "team_id",
4389
4427
  "required": true
4390
4428
  }
4391
4429
  },
4392
- "description": "Publish a face so EVERY account can chat with it. This is a global override: while it is on, everyone can reach the face regardless of who it is shared with. You still pay only to compile it; whoever chats pays for their own inference.",
4430
+ "description": "Add face(s) to a team. Any face this account can reach may join: your own, a published one, or one shared with you. Name someone else's as owner:alias, the same address chat uses.",
4393
4431
  "examples": [
4394
- "<%= config.bin %> <%= command.id %> alice --yes"
4432
+ "<%= config.bin %> <%= command.id %> TEAM_ID --face alice --face bob",
4433
+ "<%= config.bin %> <%= command.id %> TEAM_ID --face head:socrates"
4395
4434
  ],
4396
4435
  "flags": {
4397
4436
  "json": {
@@ -4425,16 +4464,18 @@
4425
4464
  "multiple": false,
4426
4465
  "type": "option"
4427
4466
  },
4428
- "yes": {
4429
- "description": "Skip confirmation",
4430
- "name": "yes",
4431
- "allowNo": false,
4432
- "type": "boolean"
4467
+ "face": {
4468
+ "description": "Face alias to add (repeatable)",
4469
+ "name": "face",
4470
+ "required": true,
4471
+ "hasDynamicHelp": false,
4472
+ "multiple": true,
4473
+ "type": "option"
4433
4474
  }
4434
4475
  },
4435
4476
  "hasDynamicHelp": false,
4436
4477
  "hiddenAliases": [],
4437
- "id": "face:publish",
4478
+ "id": "team:add",
4438
4479
  "pluginAlias": "faces-cli",
4439
4480
  "pluginName": "faces-cli",
4440
4481
  "pluginType": "core",
@@ -4444,26 +4485,14 @@
4444
4485
  "relativePath": [
4445
4486
  "dist",
4446
4487
  "commands",
4447
- "face",
4448
- "publish.js"
4488
+ "team",
4489
+ "add.js"
4449
4490
  ]
4450
4491
  },
4451
- "face:share": {
4492
+ "team:create": {
4452
4493
  "aliases": [],
4453
- "args": {
4454
- "alias": {
4455
- "description": "Face alias",
4456
- "name": "alias",
4457
- "required": true
4458
- }
4459
- },
4460
- "description": "Share a face so named accounts can chat with it. Sharing grants chat and nothing else: no reading its documents, no compiling, no re-sharing, and never its profile addendum. --add keeps the current list; --with replaces it.",
4461
- "examples": [
4462
- "<%= config.bin %> <%= command.id %> alice --list",
4463
- "<%= config.bin %> <%= command.id %> alice --add dana",
4464
- "<%= config.bin %> <%= command.id %> alice --with dana --with sam@example.com",
4465
- "<%= config.bin %> <%= command.id %> alice --none --yes"
4466
- ],
4494
+ "args": {},
4495
+ "description": "Create a new team",
4467
4496
  "flags": {
4468
4497
  "json": {
4469
4498
  "description": "Format output as json.",
@@ -4496,54 +4525,46 @@
4496
4525
  "multiple": false,
4497
4526
  "type": "option"
4498
4527
  },
4499
- "list": {
4500
- "description": "Show who the face is shared with, and change nothing",
4501
- "name": "list",
4502
- "allowNo": false,
4503
- "type": "boolean"
4528
+ "name": {
4529
+ "description": "Team name",
4530
+ "name": "name",
4531
+ "required": true,
4532
+ "hasDynamicHelp": false,
4533
+ "multiple": false,
4534
+ "type": "option"
4504
4535
  },
4505
- "add": {
4506
- "description": "Add an account, keeping everyone already on the list — username or email (repeatable)",
4507
- "exclusive": [
4508
- "with",
4509
- "none"
4510
- ],
4511
- "name": "add",
4536
+ "description": {
4537
+ "description": "Plain-text team description (max 1500 chars)",
4538
+ "name": "description",
4512
4539
  "hasDynamicHelp": false,
4513
- "multiple": true,
4540
+ "multiple": false,
4514
4541
  "type": "option"
4515
4542
  },
4516
- "with": {
4517
- "description": "Set the list to exactly these accounts, dropping anyone else (repeatable)",
4518
- "exclusive": [
4519
- "add",
4520
- "none"
4521
- ],
4522
- "name": "with",
4543
+ "protocol": {
4544
+ "description": "Protocol content (mermaid diagram or markdown, max 1000 words)",
4545
+ "name": "protocol",
4523
4546
  "hasDynamicHelp": false,
4524
- "multiple": true,
4547
+ "multiple": false,
4525
4548
  "type": "option"
4526
4549
  },
4527
- "none": {
4528
- "description": "Revoke everyone",
4529
- "exclusive": [
4530
- "add",
4531
- "with"
4532
- ],
4533
- "name": "none",
4534
- "allowNo": false,
4535
- "type": "boolean"
4550
+ "protocol-file": {
4551
+ "description": "Read protocol from file",
4552
+ "name": "protocol-file",
4553
+ "hasDynamicHelp": false,
4554
+ "multiple": false,
4555
+ "type": "option"
4536
4556
  },
4537
- "yes": {
4538
- "description": "Skip the confirmation shown when someone would lose access",
4539
- "name": "yes",
4540
- "allowNo": false,
4541
- "type": "boolean"
4557
+ "tag": {
4558
+ "description": "Tag label (repeatable, lowercase)",
4559
+ "name": "tag",
4560
+ "hasDynamicHelp": false,
4561
+ "multiple": true,
4562
+ "type": "option"
4542
4563
  }
4543
4564
  },
4544
4565
  "hasDynamicHelp": false,
4545
4566
  "hiddenAliases": [],
4546
- "id": "face:share",
4567
+ "id": "team:create",
4547
4568
  "pluginAlias": "faces-cli",
4548
4569
  "pluginName": "faces-cli",
4549
4570
  "pluginType": "core",
@@ -4553,25 +4574,20 @@
4553
4574
  "relativePath": [
4554
4575
  "dist",
4555
4576
  "commands",
4556
- "face",
4557
- "share.js"
4577
+ "team",
4578
+ "create.js"
4558
4579
  ]
4559
4580
  },
4560
- "face:sources": {
4581
+ "team:delete": {
4561
4582
  "aliases": [],
4562
4583
  "args": {
4563
- "alias": {
4564
- "description": "Face alias",
4565
- "name": "alias",
4584
+ "team_id": {
4585
+ "description": "Team ID",
4586
+ "name": "team_id",
4566
4587
  "required": true
4567
4588
  }
4568
4589
  },
4569
- "description": "List every source compiled into a face: documents and threads together, one row each. Exits 4 if the face does not exist, which is a different answer from a face that has no sources. Content is never printed; read a single source with compile:doc:get or compile:thread:get.",
4570
- "examples": [
4571
- "<%= config.bin %> <%= command.id %> alice",
4572
- "<%= config.bin %> <%= command.id %> alice --type thread",
4573
- "<%= config.bin %> <%= command.id %> alice --json"
4574
- ],
4590
+ "description": "Delete a team",
4575
4591
  "flags": {
4576
4592
  "json": {
4577
4593
  "description": "Format output as json.",
@@ -4604,21 +4620,16 @@
4604
4620
  "multiple": false,
4605
4621
  "type": "option"
4606
4622
  },
4607
- "type": {
4608
- "description": "Show only one kind of source",
4609
- "name": "type",
4610
- "hasDynamicHelp": false,
4611
- "multiple": false,
4612
- "options": [
4613
- "doc",
4614
- "thread"
4615
- ],
4616
- "type": "option"
4623
+ "yes": {
4624
+ "description": "Skip confirmation",
4625
+ "name": "yes",
4626
+ "allowNo": false,
4627
+ "type": "boolean"
4617
4628
  }
4618
4629
  },
4619
4630
  "hasDynamicHelp": false,
4620
4631
  "hiddenAliases": [],
4621
- "id": "face:sources",
4632
+ "id": "team:delete",
4622
4633
  "pluginAlias": "faces-cli",
4623
4634
  "pluginName": "faces-cli",
4624
4635
  "pluginType": "core",
@@ -4628,14 +4639,20 @@
4628
4639
  "relativePath": [
4629
4640
  "dist",
4630
4641
  "commands",
4631
- "face",
4632
- "sources.js"
4642
+ "team",
4643
+ "delete.js"
4633
4644
  ]
4634
4645
  },
4635
- "face:stats": {
4646
+ "team:edit": {
4636
4647
  "aliases": [],
4637
- "args": {},
4638
- "description": "Compile and chat stats for all owned faces",
4648
+ "args": {
4649
+ "team_id": {
4650
+ "description": "Team ID",
4651
+ "name": "team_id",
4652
+ "required": true
4653
+ }
4654
+ },
4655
+ "description": "Edit a team",
4639
4656
  "flags": {
4640
4657
  "json": {
4641
4658
  "description": "Format output as json.",
@@ -4667,11 +4684,39 @@
4667
4684
  "hasDynamicHelp": false,
4668
4685
  "multiple": false,
4669
4686
  "type": "option"
4687
+ },
4688
+ "name": {
4689
+ "description": "New team name",
4690
+ "name": "name",
4691
+ "hasDynamicHelp": false,
4692
+ "multiple": false,
4693
+ "type": "option"
4694
+ },
4695
+ "description": {
4696
+ "description": "New description (max 1500 chars)",
4697
+ "name": "description",
4698
+ "hasDynamicHelp": false,
4699
+ "multiple": false,
4700
+ "type": "option"
4701
+ },
4702
+ "protocol": {
4703
+ "description": "New protocol content",
4704
+ "name": "protocol",
4705
+ "hasDynamicHelp": false,
4706
+ "multiple": false,
4707
+ "type": "option"
4708
+ },
4709
+ "protocol-file": {
4710
+ "description": "Read protocol from file",
4711
+ "name": "protocol-file",
4712
+ "hasDynamicHelp": false,
4713
+ "multiple": false,
4714
+ "type": "option"
4670
4715
  }
4671
4716
  },
4672
4717
  "hasDynamicHelp": false,
4673
4718
  "hiddenAliases": [],
4674
- "id": "face:stats",
4719
+ "id": "team:edit",
4675
4720
  "pluginAlias": "faces-cli",
4676
4721
  "pluginName": "faces-cli",
4677
4722
  "pluginType": "core",
@@ -4681,20 +4726,20 @@
4681
4726
  "relativePath": [
4682
4727
  "dist",
4683
4728
  "commands",
4684
- "face",
4685
- "stats.js"
4729
+ "team",
4730
+ "edit.js"
4686
4731
  ]
4687
4732
  },
4688
- "face:teams": {
4733
+ "team:get": {
4689
4734
  "aliases": [],
4690
4735
  "args": {
4691
- "alias": {
4692
- "description": "Face alias",
4693
- "name": "alias",
4736
+ "team_id": {
4737
+ "description": "Team ID",
4738
+ "name": "team_id",
4694
4739
  "required": true
4695
4740
  }
4696
4741
  },
4697
- "description": "Set a face's team memberships (replaces all)",
4742
+ "description": "Get a team by ID",
4698
4743
  "flags": {
4699
4744
  "json": {
4700
4745
  "description": "Format output as json.",
@@ -4726,19 +4771,11 @@
4726
4771
  "hasDynamicHelp": false,
4727
4772
  "multiple": false,
4728
4773
  "type": "option"
4729
- },
4730
- "team": {
4731
- "description": "Team ID (repeatable, replaces all memberships)",
4732
- "name": "team",
4733
- "required": true,
4734
- "hasDynamicHelp": false,
4735
- "multiple": true,
4736
- "type": "option"
4737
4774
  }
4738
4775
  },
4739
4776
  "hasDynamicHelp": false,
4740
4777
  "hiddenAliases": [],
4741
- "id": "face:teams",
4778
+ "id": "team:get",
4742
4779
  "pluginAlias": "faces-cli",
4743
4780
  "pluginName": "faces-cli",
4744
4781
  "pluginType": "core",
@@ -4748,23 +4785,14 @@
4748
4785
  "relativePath": [
4749
4786
  "dist",
4750
4787
  "commands",
4751
- "face",
4752
- "teams.js"
4788
+ "team",
4789
+ "get.js"
4753
4790
  ]
4754
4791
  },
4755
- "face:unlock": {
4792
+ "team:list": {
4756
4793
  "aliases": [],
4757
- "args": {
4758
- "face_id": {
4759
- "description": "Face alias",
4760
- "name": "face_id",
4761
- "required": true
4762
- }
4763
- },
4764
- "description": "Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).",
4765
- "examples": [
4766
- "<%= config.bin %> <%= command.id %> socrates"
4767
- ],
4794
+ "args": {},
4795
+ "description": "List your teams",
4768
4796
  "flags": {
4769
4797
  "json": {
4770
4798
  "description": "Format output as json.",
@@ -4800,7 +4828,7 @@
4800
4828
  },
4801
4829
  "hasDynamicHelp": false,
4802
4830
  "hiddenAliases": [],
4803
- "id": "face:unlock",
4831
+ "id": "team:list",
4804
4832
  "pluginAlias": "faces-cli",
4805
4833
  "pluginName": "faces-cli",
4806
4834
  "pluginType": "core",
@@ -4810,20 +4838,24 @@
4810
4838
  "relativePath": [
4811
4839
  "dist",
4812
4840
  "commands",
4813
- "face",
4814
- "unlock.js"
4841
+ "team",
4842
+ "list.js"
4815
4843
  ]
4816
4844
  },
4817
- "face:unpublish": {
4845
+ "team:members": {
4818
4846
  "aliases": [],
4819
4847
  "args": {
4820
- "alias": {
4821
- "description": "Face alias",
4822
- "name": "alias",
4848
+ "team_id": {
4849
+ "description": "Team ID",
4850
+ "name": "team_id",
4823
4851
  "required": true
4824
4852
  }
4825
4853
  },
4826
- "description": "Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an override on top of sharing, not a replacement for it.",
4854
+ "description": "List members of a team. A member you do not own can stop being reachable if its owner revokes access or deletes it; those are listed with the reason rather than dropped.",
4855
+ "examples": [
4856
+ "<%= config.bin %> <%= command.id %> TEAM_ID",
4857
+ "<%= config.bin %> <%= command.id %> TEAM_ID --json"
4858
+ ],
4827
4859
  "flags": {
4828
4860
  "json": {
4829
4861
  "description": "Format output as json.",
@@ -4859,7 +4891,7 @@
4859
4891
  },
4860
4892
  "hasDynamicHelp": false,
4861
4893
  "hiddenAliases": [],
4862
- "id": "face:unpublish",
4894
+ "id": "team:members",
4863
4895
  "pluginAlias": "faces-cli",
4864
4896
  "pluginName": "faces-cli",
4865
4897
  "pluginType": "core",
@@ -4869,24 +4901,25 @@
4869
4901
  "relativePath": [
4870
4902
  "dist",
4871
4903
  "commands",
4872
- "face",
4873
- "unpublish.js"
4904
+ "team",
4905
+ "members.js"
4874
4906
  ]
4875
4907
  },
4876
- "face:unshare": {
4908
+ "team:remove": {
4877
4909
  "aliases": [],
4878
4910
  "args": {
4911
+ "team_id": {
4912
+ "description": "Team ID",
4913
+ "name": "team_id",
4914
+ "required": true
4915
+ },
4879
4916
  "alias": {
4880
- "description": "Face alias",
4917
+ "description": "Face alias to remove",
4881
4918
  "name": "alias",
4882
4919
  "required": true
4883
4920
  }
4884
4921
  },
4885
- "description": "Revoke access to a shared face. Takes effect immediately — there is no grace period.",
4886
- "examples": [
4887
- "<%= config.bin %> <%= command.id %> alice --from dana --yes",
4888
- "<%= config.bin %> <%= command.id %> alice --all --yes"
4889
- ],
4922
+ "description": "Remove a face from a team",
4890
4923
  "flags": {
4891
4924
  "json": {
4892
4925
  "description": "Format output as json.",
@@ -4918,36 +4951,11 @@
4918
4951
  "hasDynamicHelp": false,
4919
4952
  "multiple": false,
4920
4953
  "type": "option"
4921
- },
4922
- "from": {
4923
- "description": "Account to revoke (repeatable)",
4924
- "exclusive": [
4925
- "all"
4926
- ],
4927
- "name": "from",
4928
- "hasDynamicHelp": false,
4929
- "multiple": true,
4930
- "type": "option"
4931
- },
4932
- "all": {
4933
- "description": "Revoke everyone",
4934
- "exclusive": [
4935
- "from"
4936
- ],
4937
- "name": "all",
4938
- "allowNo": false,
4939
- "type": "boolean"
4940
- },
4941
- "yes": {
4942
- "description": "Skip confirmation",
4943
- "name": "yes",
4944
- "allowNo": false,
4945
- "type": "boolean"
4946
4954
  }
4947
4955
  },
4948
4956
  "hasDynamicHelp": false,
4949
4957
  "hiddenAliases": [],
4950
- "id": "face:unshare",
4958
+ "id": "team:remove",
4951
4959
  "pluginAlias": "faces-cli",
4952
4960
  "pluginName": "faces-cli",
4953
4961
  "pluginType": "core",
@@ -4957,8 +4965,8 @@
4957
4965
  "relativePath": [
4958
4966
  "dist",
4959
4967
  "commands",
4960
- "face",
4961
- "unshare.js"
4968
+ "team",
4969
+ "remove.js"
4962
4970
  ]
4963
4971
  },
4964
4972
  "billing:subscription:activate": {
@@ -5140,7 +5148,7 @@
5140
5148
  "index.js"
5141
5149
  ]
5142
5150
  },
5143
- "compile:doc:create": {
5151
+ "compile:thread:create": {
5144
5152
  "aliases": [],
5145
5153
  "args": {
5146
5154
  "face_id": {
@@ -5149,7 +5157,7 @@
5149
5157
  "required": true
5150
5158
  }
5151
5159
  },
5152
- "description": "Submit a document to a face",
5160
+ "description": "Start a new thread for a face",
5153
5161
  "flags": {
5154
5162
  "json": {
5155
5163
  "description": "Format output as json.",
@@ -5183,49 +5191,88 @@
5183
5191
  "type": "option"
5184
5192
  },
5185
5193
  "label": {
5186
- "description": "Document label/title",
5194
+ "description": "Thread label",
5187
5195
  "name": "label",
5188
5196
  "hasDynamicHelp": false,
5189
5197
  "multiple": false,
5190
5198
  "type": "option"
5191
5199
  },
5192
- "content": {
5193
- "description": "Inline text content",
5194
- "name": "content",
5195
- "hasDynamicHelp": false,
5196
- "multiple": false,
5197
- "type": "option"
5200
+ "oauth-only": {
5201
+ "description": "Prevent fallback to paid system key (use OAuth only)",
5202
+ "name": "oauth-only",
5203
+ "allowNo": false,
5204
+ "type": "boolean"
5205
+ }
5206
+ },
5207
+ "hasDynamicHelp": false,
5208
+ "hiddenAliases": [],
5209
+ "id": "compile:thread:create",
5210
+ "pluginAlias": "faces-cli",
5211
+ "pluginName": "faces-cli",
5212
+ "pluginType": "core",
5213
+ "strict": true,
5214
+ "enableJsonFlag": true,
5215
+ "isESM": true,
5216
+ "relativePath": [
5217
+ "dist",
5218
+ "commands",
5219
+ "compile",
5220
+ "thread",
5221
+ "create.js"
5222
+ ]
5223
+ },
5224
+ "compile:thread:delete": {
5225
+ "aliases": [],
5226
+ "args": {
5227
+ "thread_id": {
5228
+ "description": "Thread ID",
5229
+ "name": "thread_id",
5230
+ "required": true
5231
+ }
5232
+ },
5233
+ "description": "Delete a thread",
5234
+ "flags": {
5235
+ "json": {
5236
+ "description": "Format output as json.",
5237
+ "helpGroup": "GLOBAL",
5238
+ "name": "json",
5239
+ "allowNo": false,
5240
+ "type": "boolean"
5198
5241
  },
5199
- "file": {
5200
- "description": "Read content from file",
5201
- "name": "file",
5242
+ "base-url": {
5243
+ "description": "API base URL",
5244
+ "env": "FACES_BASE_URL",
5245
+ "name": "base-url",
5202
5246
  "hasDynamicHelp": false,
5203
5247
  "multiple": false,
5204
5248
  "type": "option"
5205
5249
  },
5206
- "medium": {
5207
- "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
5208
- "name": "medium",
5250
+ "token": {
5251
+ "description": "JWT bearer token",
5252
+ "env": "FACES_TOKEN",
5253
+ "name": "token",
5209
5254
  "hasDynamicHelp": false,
5210
5255
  "multiple": false,
5211
5256
  "type": "option"
5212
5257
  },
5213
- "perspective": {
5214
- "description": "Perspective (first-person or third-person)",
5215
- "name": "perspective",
5216
- "default": "first-person",
5258
+ "api-key": {
5259
+ "description": "API key",
5260
+ "env": "FACES_API_KEY",
5261
+ "name": "api-key",
5217
5262
  "hasDynamicHelp": false,
5218
5263
  "multiple": false,
5219
- "options": [
5220
- "first-person",
5221
- "third-person"
5222
- ],
5223
5264
  "type": "option"
5265
+ },
5266
+ "yes": {
5267
+ "description": "Skip confirmation",
5268
+ "name": "yes",
5269
+ "allowNo": false,
5270
+ "type": "boolean"
5224
5271
  }
5225
5272
  },
5226
5273
  "hasDynamicHelp": false,
5227
5274
  "hiddenAliases": [],
5228
- "id": "compile:doc:create",
5275
+ "id": "compile:thread:delete",
5229
5276
  "pluginAlias": "faces-cli",
5230
5277
  "pluginName": "faces-cli",
5231
5278
  "pluginType": "core",
@@ -5236,20 +5283,20 @@
5236
5283
  "dist",
5237
5284
  "commands",
5238
5285
  "compile",
5239
- "doc",
5240
- "create.js"
5286
+ "thread",
5287
+ "delete.js"
5241
5288
  ]
5242
5289
  },
5243
- "compile:doc:delete": {
5290
+ "compile:thread:edit": {
5244
5291
  "aliases": [],
5245
5292
  "args": {
5246
- "doc_id": {
5247
- "description": "Document ID",
5248
- "name": "doc_id",
5293
+ "thread_id": {
5294
+ "description": "Thread ID",
5295
+ "name": "thread_id",
5249
5296
  "required": true
5250
5297
  }
5251
5298
  },
5252
- "description": "Delete a document",
5299
+ "description": "Edit a thread (label and/or reassign face speaker)",
5253
5300
  "flags": {
5254
5301
  "json": {
5255
5302
  "description": "Format output as json.",
@@ -5281,11 +5328,25 @@
5281
5328
  "hasDynamicHelp": false,
5282
5329
  "multiple": false,
5283
5330
  "type": "option"
5331
+ },
5332
+ "label": {
5333
+ "description": "New thread label",
5334
+ "name": "label",
5335
+ "hasDynamicHelp": false,
5336
+ "multiple": false,
5337
+ "type": "option"
5338
+ },
5339
+ "face-speaker": {
5340
+ "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
5341
+ "name": "face-speaker",
5342
+ "hasDynamicHelp": false,
5343
+ "multiple": false,
5344
+ "type": "option"
5284
5345
  }
5285
5346
  },
5286
5347
  "hasDynamicHelp": false,
5287
5348
  "hiddenAliases": [],
5288
- "id": "compile:doc:delete",
5349
+ "id": "compile:thread:edit",
5289
5350
  "pluginAlias": "faces-cli",
5290
5351
  "pluginName": "faces-cli",
5291
5352
  "pluginType": "core",
@@ -5296,20 +5357,20 @@
5296
5357
  "dist",
5297
5358
  "commands",
5298
5359
  "compile",
5299
- "doc",
5300
- "delete.js"
5360
+ "thread",
5361
+ "edit.js"
5301
5362
  ]
5302
5363
  },
5303
- "compile:doc:edit": {
5364
+ "compile:thread:get": {
5304
5365
  "aliases": [],
5305
5366
  "args": {
5306
- "doc_id": {
5307
- "description": "Document ID",
5308
- "name": "doc_id",
5367
+ "thread_id": {
5368
+ "description": "Thread ID",
5369
+ "name": "thread_id",
5309
5370
  "required": true
5310
5371
  }
5311
5372
  },
5312
- "description": "Edit a document (label, content, or perspective)",
5373
+ "description": "Get a thread by ID",
5313
5374
  "flags": {
5314
5375
  "json": {
5315
5376
  "description": "Format output as json.",
@@ -5341,50 +5402,11 @@
5341
5402
  "hasDynamicHelp": false,
5342
5403
  "multiple": false,
5343
5404
  "type": "option"
5344
- },
5345
- "label": {
5346
- "description": "New label/title",
5347
- "name": "label",
5348
- "hasDynamicHelp": false,
5349
- "multiple": false,
5350
- "type": "option"
5351
- },
5352
- "content": {
5353
- "description": "New inline text content",
5354
- "name": "content",
5355
- "hasDynamicHelp": false,
5356
- "multiple": false,
5357
- "type": "option"
5358
- },
5359
- "file": {
5360
- "description": "Read new content from file",
5361
- "name": "file",
5362
- "hasDynamicHelp": false,
5363
- "multiple": false,
5364
- "type": "option"
5365
- },
5366
- "medium": {
5367
- "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
5368
- "name": "medium",
5369
- "hasDynamicHelp": false,
5370
- "multiple": false,
5371
- "type": "option"
5372
- },
5373
- "perspective": {
5374
- "description": "Perspective (first-person or third-person)",
5375
- "name": "perspective",
5376
- "hasDynamicHelp": false,
5377
- "multiple": false,
5378
- "options": [
5379
- "first-person",
5380
- "third-person"
5381
- ],
5382
- "type": "option"
5383
5405
  }
5384
5406
  },
5385
5407
  "hasDynamicHelp": false,
5386
5408
  "hiddenAliases": [],
5387
- "id": "compile:doc:edit",
5409
+ "id": "compile:thread:get",
5388
5410
  "pluginAlias": "faces-cli",
5389
5411
  "pluginName": "faces-cli",
5390
5412
  "pluginType": "core",
@@ -5395,20 +5417,20 @@
5395
5417
  "dist",
5396
5418
  "commands",
5397
5419
  "compile",
5398
- "doc",
5399
- "edit.js"
5420
+ "thread",
5421
+ "get.js"
5400
5422
  ]
5401
5423
  },
5402
- "compile:doc:get": {
5424
+ "compile:thread:list": {
5403
5425
  "aliases": [],
5404
5426
  "args": {
5405
- "doc_id": {
5406
- "description": "Document ID",
5407
- "name": "doc_id",
5427
+ "face_id": {
5428
+ "description": "Face alias",
5429
+ "name": "face_id",
5408
5430
  "required": true
5409
5431
  }
5410
5432
  },
5411
- "description": "Get a document by ID",
5433
+ "description": "List threads for a face",
5412
5434
  "flags": {
5413
5435
  "json": {
5414
5436
  "description": "Format output as json.",
@@ -5444,7 +5466,7 @@
5444
5466
  },
5445
5467
  "hasDynamicHelp": false,
5446
5468
  "hiddenAliases": [],
5447
- "id": "compile:doc:get",
5469
+ "id": "compile:thread:list",
5448
5470
  "pluginAlias": "faces-cli",
5449
5471
  "pluginName": "faces-cli",
5450
5472
  "pluginType": "core",
@@ -5455,24 +5477,20 @@
5455
5477
  "dist",
5456
5478
  "commands",
5457
5479
  "compile",
5458
- "doc",
5459
- "get.js"
5480
+ "thread",
5481
+ "list.js"
5460
5482
  ]
5461
5483
  },
5462
- "compile:doc": {
5484
+ "compile:thread:make": {
5463
5485
  "aliases": [],
5464
5486
  "args": {
5465
- "face_id": {
5466
- "description": "Face alias",
5467
- "name": "face_id",
5487
+ "thread_id": {
5488
+ "description": "Thread ID",
5489
+ "name": "thread_id",
5468
5490
  "required": true
5469
5491
  }
5470
5492
  },
5471
- "description": "Compile one or more documents into a face (create → make in one step). Repeat --file to submit several documents in a single command; each file becomes its own document rather than being concatenated.",
5472
- "examples": [
5473
- "<%= config.bin %> <%= command.id %> alice --file notes.txt",
5474
- "<%= config.bin %> <%= command.id %> alice --file a.txt --file b.txt --file c.txt --no-wait --json"
5475
- ],
5493
+ "description": "Compile an existing thread (prepare + sync in one step)",
5476
5494
  "flags": {
5477
5495
  "json": {
5478
5496
  "description": "Format output as json.",
@@ -5505,51 +5523,8 @@
5505
5523
  "multiple": false,
5506
5524
  "type": "option"
5507
5525
  },
5508
- "label": {
5509
- "description": "Document label/title (single document only; with several files each is labelled by its filename)",
5510
- "name": "label",
5511
- "hasDynamicHelp": false,
5512
- "multiple": false,
5513
- "type": "option"
5514
- },
5515
- "content": {
5516
- "description": "Inline text content",
5517
- "exclusive": [
5518
- "file"
5519
- ],
5520
- "name": "content",
5521
- "hasDynamicHelp": false,
5522
- "multiple": false,
5523
- "type": "option"
5524
- },
5525
- "file": {
5526
- "description": "Read content from file (repeatable — each file becomes its own document)",
5527
- "name": "file",
5528
- "hasDynamicHelp": false,
5529
- "multiple": true,
5530
- "type": "option"
5531
- },
5532
- "medium": {
5533
- "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
5534
- "name": "medium",
5535
- "hasDynamicHelp": false,
5536
- "multiple": false,
5537
- "type": "option"
5538
- },
5539
- "perspective": {
5540
- "description": "Perspective",
5541
- "name": "perspective",
5542
- "default": "first-person",
5543
- "hasDynamicHelp": false,
5544
- "multiple": false,
5545
- "options": [
5546
- "first-person",
5547
- "third-person"
5548
- ],
5549
- "type": "option"
5550
- },
5551
5526
  "timeout": {
5552
- "description": "Compile timeout in seconds, per document (default: 600)",
5527
+ "description": "Compile timeout in seconds (default: 600)",
5553
5528
  "name": "timeout",
5554
5529
  "default": 600,
5555
5530
  "hasDynamicHelp": false,
@@ -5557,7 +5532,7 @@
5557
5532
  "type": "option"
5558
5533
  },
5559
5534
  "no-wait": {
5560
- "description": "Create and trigger compilation, then return immediately without polling.",
5535
+ "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
5561
5536
  "name": "no-wait",
5562
5537
  "allowNo": false,
5563
5538
  "type": "boolean"
@@ -5565,7 +5540,7 @@
5565
5540
  },
5566
5541
  "hasDynamicHelp": false,
5567
5542
  "hiddenAliases": [],
5568
- "id": "compile:doc",
5543
+ "id": "compile:thread:make",
5569
5544
  "pluginAlias": "faces-cli",
5570
5545
  "pluginName": "faces-cli",
5571
5546
  "pluginType": "core",
@@ -5576,20 +5551,20 @@
5576
5551
  "dist",
5577
5552
  "commands",
5578
5553
  "compile",
5579
- "doc",
5580
- "index.js"
5554
+ "thread",
5555
+ "make.js"
5581
5556
  ]
5582
5557
  },
5583
- "compile:doc:list": {
5558
+ "compile:thread:message": {
5584
5559
  "aliases": [],
5585
5560
  "args": {
5586
- "face_id": {
5587
- "description": "Face alias",
5588
- "name": "face_id",
5561
+ "thread_id": {
5562
+ "description": "Thread ID",
5563
+ "name": "thread_id",
5589
5564
  "required": true
5590
5565
  }
5591
5566
  },
5592
- "description": "List documents for a face. Each document's full text is omitted unless --verbose, so a face with a real corpus stays readable. For a table of every source, documents and threads together, use face:sources.",
5567
+ "description": "Send a user message to a thread",
5593
5568
  "flags": {
5594
5569
  "json": {
5595
5570
  "description": "Format output as json.",
@@ -5622,16 +5597,25 @@
5622
5597
  "multiple": false,
5623
5598
  "type": "option"
5624
5599
  },
5625
- "verbose": {
5626
- "description": "Include each document's full text",
5627
- "name": "verbose",
5600
+ "message": {
5601
+ "char": "m",
5602
+ "description": "User message to append",
5603
+ "name": "message",
5604
+ "required": true,
5605
+ "hasDynamicHelp": false,
5606
+ "multiple": false,
5607
+ "type": "option"
5608
+ },
5609
+ "oauth-only": {
5610
+ "description": "Prevent fallback to paid system key (use OAuth only)",
5611
+ "name": "oauth-only",
5628
5612
  "allowNo": false,
5629
5613
  "type": "boolean"
5630
5614
  }
5631
5615
  },
5632
5616
  "hasDynamicHelp": false,
5633
5617
  "hiddenAliases": [],
5634
- "id": "compile:doc:list",
5618
+ "id": "compile:thread:message",
5635
5619
  "pluginAlias": "faces-cli",
5636
5620
  "pluginName": "faces-cli",
5637
5621
  "pluginType": "core",
@@ -5642,20 +5626,20 @@
5642
5626
  "dist",
5643
5627
  "commands",
5644
5628
  "compile",
5645
- "doc",
5646
- "list.js"
5629
+ "thread",
5630
+ "message.js"
5647
5631
  ]
5648
5632
  },
5649
- "compile:doc:make": {
5633
+ "compile:thread:pause": {
5650
5634
  "aliases": [],
5651
5635
  "args": {
5652
- "doc_id": {
5653
- "description": "Document ID",
5654
- "name": "doc_id",
5636
+ "thread_id": {
5637
+ "description": "Thread ID",
5638
+ "name": "thread_id",
5655
5639
  "required": true
5656
5640
  }
5657
5641
  },
5658
- "description": "Compile an existing document (prepare + sync in one step)",
5642
+ "description": "Ask a running thread compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
5659
5643
  "flags": {
5660
5644
  "json": {
5661
5645
  "description": "Format output as json.",
@@ -5688,24 +5672,24 @@
5688
5672
  "multiple": false,
5689
5673
  "type": "option"
5690
5674
  },
5675
+ "no-wait": {
5676
+ "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
5677
+ "name": "no-wait",
5678
+ "allowNo": false,
5679
+ "type": "boolean"
5680
+ },
5691
5681
  "timeout": {
5692
- "description": "Compile timeout in seconds (default: 600)",
5682
+ "description": "Seconds to wait for the compile to stop (default: 60)",
5693
5683
  "name": "timeout",
5694
- "default": 600,
5684
+ "default": 60,
5695
5685
  "hasDynamicHelp": false,
5696
5686
  "multiple": false,
5697
5687
  "type": "option"
5698
- },
5699
- "no-wait": {
5700
- "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
5701
- "name": "no-wait",
5702
- "allowNo": false,
5703
- "type": "boolean"
5704
5688
  }
5705
5689
  },
5706
5690
  "hasDynamicHelp": false,
5707
5691
  "hiddenAliases": [],
5708
- "id": "compile:doc:make",
5692
+ "id": "compile:thread:pause",
5709
5693
  "pluginAlias": "faces-cli",
5710
5694
  "pluginName": "faces-cli",
5711
5695
  "pluginType": "core",
@@ -5716,20 +5700,20 @@
5716
5700
  "dist",
5717
5701
  "commands",
5718
5702
  "compile",
5719
- "doc",
5720
- "make.js"
5703
+ "thread",
5704
+ "pause.js"
5721
5705
  ]
5722
5706
  },
5723
- "compile:doc:pause": {
5707
+ "compile:thread:reset": {
5724
5708
  "aliases": [],
5725
5709
  "args": {
5726
- "doc_id": {
5727
- "description": "Document ID",
5728
- "name": "doc_id",
5710
+ "thread_id": {
5711
+ "description": "Thread ID",
5712
+ "name": "thread_id",
5729
5713
  "required": true
5730
5714
  }
5731
5715
  },
5732
- "description": "Ask a running document compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
5716
+ "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
5733
5717
  "flags": {
5734
5718
  "json": {
5735
5719
  "description": "Format output as json.",
@@ -5762,24 +5746,16 @@
5762
5746
  "multiple": false,
5763
5747
  "type": "option"
5764
5748
  },
5765
- "no-wait": {
5766
- "description": "Return as soon as the pause is accepted, without waiting for the compile to stop.",
5767
- "name": "no-wait",
5749
+ "yes": {
5750
+ "description": "Skip confirmation",
5751
+ "name": "yes",
5768
5752
  "allowNo": false,
5769
5753
  "type": "boolean"
5770
- },
5771
- "timeout": {
5772
- "description": "Seconds to wait for the compile to stop (default: 60)",
5773
- "name": "timeout",
5774
- "default": 60,
5775
- "hasDynamicHelp": false,
5776
- "multiple": false,
5777
- "type": "option"
5778
5754
  }
5779
5755
  },
5780
5756
  "hasDynamicHelp": false,
5781
5757
  "hiddenAliases": [],
5782
- "id": "compile:doc:pause",
5758
+ "id": "compile:thread:reset",
5783
5759
  "pluginAlias": "faces-cli",
5784
5760
  "pluginName": "faces-cli",
5785
5761
  "pluginType": "core",
@@ -5790,20 +5766,20 @@
5790
5766
  "dist",
5791
5767
  "commands",
5792
5768
  "compile",
5793
- "doc",
5794
- "pause.js"
5769
+ "thread",
5770
+ "reset.js"
5795
5771
  ]
5796
5772
  },
5797
- "compile:doc:reset": {
5773
+ "compile:thread:sync": {
5798
5774
  "aliases": [],
5799
5775
  "args": {
5800
- "doc_id": {
5801
- "description": "Document ID",
5802
- "name": "doc_id",
5776
+ "thread_id": {
5777
+ "description": "Thread ID",
5778
+ "name": "thread_id",
5803
5779
  "required": true
5804
5780
  }
5805
5781
  },
5806
- "description": "Reset document compilation progress (wipe extraction, keep content)",
5782
+ "description": "Archive and sync a thread into a face",
5807
5783
  "flags": {
5808
5784
  "json": {
5809
5785
  "description": "Format output as json.",
@@ -5835,17 +5811,11 @@
5835
5811
  "hasDynamicHelp": false,
5836
5812
  "multiple": false,
5837
5813
  "type": "option"
5838
- },
5839
- "yes": {
5840
- "description": "Skip confirmation",
5841
- "name": "yes",
5842
- "allowNo": false,
5843
- "type": "boolean"
5844
5814
  }
5845
5815
  },
5846
5816
  "hasDynamicHelp": false,
5847
5817
  "hiddenAliases": [],
5848
- "id": "compile:doc:reset",
5818
+ "id": "compile:thread:sync",
5849
5819
  "pluginAlias": "faces-cli",
5850
5820
  "pluginName": "faces-cli",
5851
5821
  "pluginType": "core",
@@ -5856,11 +5826,11 @@
5856
5826
  "dist",
5857
5827
  "commands",
5858
5828
  "compile",
5859
- "doc",
5860
- "reset.js"
5829
+ "thread",
5830
+ "sync.js"
5861
5831
  ]
5862
5832
  },
5863
- "compile:thread:create": {
5833
+ "compile:doc:create": {
5864
5834
  "aliases": [],
5865
5835
  "args": {
5866
5836
  "face_id": {
@@ -5869,7 +5839,7 @@
5869
5839
  "required": true
5870
5840
  }
5871
5841
  },
5872
- "description": "Start a new thread for a face",
5842
+ "description": "Submit a document to a face",
5873
5843
  "flags": {
5874
5844
  "json": {
5875
5845
  "description": "Format output as json.",
@@ -5903,22 +5873,49 @@
5903
5873
  "type": "option"
5904
5874
  },
5905
5875
  "label": {
5906
- "description": "Thread label",
5876
+ "description": "Document label/title",
5907
5877
  "name": "label",
5908
5878
  "hasDynamicHelp": false,
5909
5879
  "multiple": false,
5910
5880
  "type": "option"
5911
5881
  },
5912
- "oauth-only": {
5913
- "description": "Prevent fallback to paid system key (use OAuth only)",
5914
- "name": "oauth-only",
5915
- "allowNo": false,
5916
- "type": "boolean"
5882
+ "content": {
5883
+ "description": "Inline text content",
5884
+ "name": "content",
5885
+ "hasDynamicHelp": false,
5886
+ "multiple": false,
5887
+ "type": "option"
5888
+ },
5889
+ "file": {
5890
+ "description": "Read content from file",
5891
+ "name": "file",
5892
+ "hasDynamicHelp": false,
5893
+ "multiple": false,
5894
+ "type": "option"
5895
+ },
5896
+ "medium": {
5897
+ "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
5898
+ "name": "medium",
5899
+ "hasDynamicHelp": false,
5900
+ "multiple": false,
5901
+ "type": "option"
5902
+ },
5903
+ "perspective": {
5904
+ "description": "Perspective (first-person or third-person)",
5905
+ "name": "perspective",
5906
+ "default": "first-person",
5907
+ "hasDynamicHelp": false,
5908
+ "multiple": false,
5909
+ "options": [
5910
+ "first-person",
5911
+ "third-person"
5912
+ ],
5913
+ "type": "option"
5917
5914
  }
5918
5915
  },
5919
5916
  "hasDynamicHelp": false,
5920
5917
  "hiddenAliases": [],
5921
- "id": "compile:thread:create",
5918
+ "id": "compile:doc:create",
5922
5919
  "pluginAlias": "faces-cli",
5923
5920
  "pluginName": "faces-cli",
5924
5921
  "pluginType": "core",
@@ -5929,20 +5926,20 @@
5929
5926
  "dist",
5930
5927
  "commands",
5931
5928
  "compile",
5932
- "thread",
5929
+ "doc",
5933
5930
  "create.js"
5934
5931
  ]
5935
5932
  },
5936
- "compile:thread:delete": {
5933
+ "compile:doc:delete": {
5937
5934
  "aliases": [],
5938
5935
  "args": {
5939
- "thread_id": {
5940
- "description": "Thread ID",
5941
- "name": "thread_id",
5936
+ "doc_id": {
5937
+ "description": "Document ID",
5938
+ "name": "doc_id",
5942
5939
  "required": true
5943
5940
  }
5944
5941
  },
5945
- "description": "Delete a thread",
5942
+ "description": "Delete a document",
5946
5943
  "flags": {
5947
5944
  "json": {
5948
5945
  "description": "Format output as json.",
@@ -5974,17 +5971,11 @@
5974
5971
  "hasDynamicHelp": false,
5975
5972
  "multiple": false,
5976
5973
  "type": "option"
5977
- },
5978
- "yes": {
5979
- "description": "Skip confirmation",
5980
- "name": "yes",
5981
- "allowNo": false,
5982
- "type": "boolean"
5983
5974
  }
5984
5975
  },
5985
5976
  "hasDynamicHelp": false,
5986
5977
  "hiddenAliases": [],
5987
- "id": "compile:thread:delete",
5978
+ "id": "compile:doc:delete",
5988
5979
  "pluginAlias": "faces-cli",
5989
5980
  "pluginName": "faces-cli",
5990
5981
  "pluginType": "core",
@@ -5995,20 +5986,20 @@
5995
5986
  "dist",
5996
5987
  "commands",
5997
5988
  "compile",
5998
- "thread",
5989
+ "doc",
5999
5990
  "delete.js"
6000
5991
  ]
6001
5992
  },
6002
- "compile:thread:edit": {
5993
+ "compile:doc:edit": {
6003
5994
  "aliases": [],
6004
5995
  "args": {
6005
- "thread_id": {
6006
- "description": "Thread ID",
6007
- "name": "thread_id",
5996
+ "doc_id": {
5997
+ "description": "Document ID",
5998
+ "name": "doc_id",
6008
5999
  "required": true
6009
6000
  }
6010
6001
  },
6011
- "description": "Edit a thread (label and/or reassign face speaker)",
6002
+ "description": "Edit a document (label, content, or perspective)",
6012
6003
  "flags": {
6013
6004
  "json": {
6014
6005
  "description": "Format output as json.",
@@ -6042,23 +6033,48 @@
6042
6033
  "type": "option"
6043
6034
  },
6044
6035
  "label": {
6045
- "description": "New thread label",
6036
+ "description": "New label/title",
6046
6037
  "name": "label",
6047
6038
  "hasDynamicHelp": false,
6048
6039
  "multiple": false,
6049
6040
  "type": "option"
6050
6041
  },
6051
- "face-speaker": {
6052
- "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
6053
- "name": "face-speaker",
6042
+ "content": {
6043
+ "description": "New inline text content",
6044
+ "name": "content",
6045
+ "hasDynamicHelp": false,
6046
+ "multiple": false,
6047
+ "type": "option"
6048
+ },
6049
+ "file": {
6050
+ "description": "Read new content from file",
6051
+ "name": "file",
6054
6052
  "hasDynamicHelp": false,
6055
6053
  "multiple": false,
6056
6054
  "type": "option"
6055
+ },
6056
+ "medium": {
6057
+ "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
6058
+ "name": "medium",
6059
+ "hasDynamicHelp": false,
6060
+ "multiple": false,
6061
+ "type": "option"
6062
+ },
6063
+ "perspective": {
6064
+ "description": "Perspective (first-person or third-person)",
6065
+ "name": "perspective",
6066
+ "hasDynamicHelp": false,
6067
+ "multiple": false,
6068
+ "options": [
6069
+ "first-person",
6070
+ "third-person"
6071
+ ],
6072
+ "type": "option"
6057
6073
  }
6058
6074
  },
6059
6075
  "hasDynamicHelp": false,
6060
6076
  "hiddenAliases": [],
6061
- "id": "compile:thread:edit",
6077
+ "id": "compile:doc:edit",
6062
6078
  "pluginAlias": "faces-cli",
6063
6079
  "pluginName": "faces-cli",
6064
6080
  "pluginType": "core",
@@ -6069,20 +6085,20 @@
6069
6085
  "dist",
6070
6086
  "commands",
6071
6087
  "compile",
6072
- "thread",
6088
+ "doc",
6073
6089
  "edit.js"
6074
6090
  ]
6075
6091
  },
6076
- "compile:thread:get": {
6092
+ "compile:doc:get": {
6077
6093
  "aliases": [],
6078
6094
  "args": {
6079
- "thread_id": {
6080
- "description": "Thread ID",
6081
- "name": "thread_id",
6095
+ "doc_id": {
6096
+ "description": "Document ID",
6097
+ "name": "doc_id",
6082
6098
  "required": true
6083
6099
  }
6084
6100
  },
6085
- "description": "Get a thread by ID",
6101
+ "description": "Get a document by ID",
6086
6102
  "flags": {
6087
6103
  "json": {
6088
6104
  "description": "Format output as json.",
@@ -6118,7 +6134,7 @@
6118
6134
  },
6119
6135
  "hasDynamicHelp": false,
6120
6136
  "hiddenAliases": [],
6121
- "id": "compile:thread:get",
6137
+ "id": "compile:doc:get",
6122
6138
  "pluginAlias": "faces-cli",
6123
6139
  "pluginName": "faces-cli",
6124
6140
  "pluginType": "core",
@@ -6129,11 +6145,11 @@
6129
6145
  "dist",
6130
6146
  "commands",
6131
6147
  "compile",
6132
- "thread",
6148
+ "doc",
6133
6149
  "get.js"
6134
6150
  ]
6135
6151
  },
6136
- "compile:thread:list": {
6152
+ "compile:doc": {
6137
6153
  "aliases": [],
6138
6154
  "args": {
6139
6155
  "face_id": {
@@ -6142,7 +6158,11 @@
6142
6158
  "required": true
6143
6159
  }
6144
6160
  },
6145
- "description": "List threads for a face",
6161
+ "description": "Compile one or more documents into a face (create → make in one step). Repeat --file to submit several documents in a single command; each file becomes its own document rather than being concatenated.",
6162
+ "examples": [
6163
+ "<%= config.bin %> <%= command.id %> alice --file notes.txt",
6164
+ "<%= config.bin %> <%= command.id %> alice --file a.txt --file b.txt --file c.txt --no-wait --json"
6165
+ ],
6146
6166
  "flags": {
6147
6167
  "json": {
6148
6168
  "description": "Format output as json.",
@@ -6174,11 +6194,68 @@
6174
6194
  "hasDynamicHelp": false,
6175
6195
  "multiple": false,
6176
6196
  "type": "option"
6197
+ },
6198
+ "label": {
6199
+ "description": "Document label/title (single document only; with several files each is labelled by its filename)",
6200
+ "name": "label",
6201
+ "hasDynamicHelp": false,
6202
+ "multiple": false,
6203
+ "type": "option"
6204
+ },
6205
+ "content": {
6206
+ "description": "Inline text content",
6207
+ "exclusive": [
6208
+ "file"
6209
+ ],
6210
+ "name": "content",
6211
+ "hasDynamicHelp": false,
6212
+ "multiple": false,
6213
+ "type": "option"
6214
+ },
6215
+ "file": {
6216
+ "description": "Read content from file (repeatable — each file becomes its own document)",
6217
+ "name": "file",
6218
+ "hasDynamicHelp": false,
6219
+ "multiple": true,
6220
+ "type": "option"
6221
+ },
6222
+ "medium": {
6223
+ "description": "What sort of writing this is — e.g. email, text message, social post, essay, academic paper, blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is worse than none, because a declaration is trusted and an absence is not.",
6224
+ "name": "medium",
6225
+ "hasDynamicHelp": false,
6226
+ "multiple": false,
6227
+ "type": "option"
6228
+ },
6229
+ "perspective": {
6230
+ "description": "Perspective",
6231
+ "name": "perspective",
6232
+ "default": "first-person",
6233
+ "hasDynamicHelp": false,
6234
+ "multiple": false,
6235
+ "options": [
6236
+ "first-person",
6237
+ "third-person"
6238
+ ],
6239
+ "type": "option"
6240
+ },
6241
+ "timeout": {
6242
+ "description": "Compile timeout in seconds, per document (default: 600)",
6243
+ "name": "timeout",
6244
+ "default": 600,
6245
+ "hasDynamicHelp": false,
6246
+ "multiple": false,
6247
+ "type": "option"
6248
+ },
6249
+ "no-wait": {
6250
+ "description": "Create and trigger compilation, then return immediately without polling.",
6251
+ "name": "no-wait",
6252
+ "allowNo": false,
6253
+ "type": "boolean"
6177
6254
  }
6178
6255
  },
6179
6256
  "hasDynamicHelp": false,
6180
6257
  "hiddenAliases": [],
6181
- "id": "compile:thread:list",
6258
+ "id": "compile:doc",
6182
6259
  "pluginAlias": "faces-cli",
6183
6260
  "pluginName": "faces-cli",
6184
6261
  "pluginType": "core",
@@ -6189,20 +6266,20 @@
6189
6266
  "dist",
6190
6267
  "commands",
6191
6268
  "compile",
6192
- "thread",
6193
- "list.js"
6269
+ "doc",
6270
+ "index.js"
6194
6271
  ]
6195
6272
  },
6196
- "compile:thread:make": {
6273
+ "compile:doc:list": {
6197
6274
  "aliases": [],
6198
6275
  "args": {
6199
- "thread_id": {
6200
- "description": "Thread ID",
6201
- "name": "thread_id",
6276
+ "face_id": {
6277
+ "description": "Face alias",
6278
+ "name": "face_id",
6202
6279
  "required": true
6203
6280
  }
6204
6281
  },
6205
- "description": "Compile an existing thread (prepare + sync in one step)",
6282
+ "description": "List documents for a face. Each document's full text is omitted unless --verbose, so a face with a real corpus stays readable. For a table of every source, documents and threads together, use face:sources.",
6206
6283
  "flags": {
6207
6284
  "json": {
6208
6285
  "description": "Format output as json.",
@@ -6235,24 +6312,16 @@
6235
6312
  "multiple": false,
6236
6313
  "type": "option"
6237
6314
  },
6238
- "timeout": {
6239
- "description": "Compile timeout in seconds (default: 600)",
6240
- "name": "timeout",
6241
- "default": 600,
6242
- "hasDynamicHelp": false,
6243
- "multiple": false,
6244
- "type": "option"
6245
- },
6246
- "no-wait": {
6247
- "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
6248
- "name": "no-wait",
6315
+ "verbose": {
6316
+ "description": "Include each document's full text",
6317
+ "name": "verbose",
6249
6318
  "allowNo": false,
6250
6319
  "type": "boolean"
6251
6320
  }
6252
6321
  },
6253
6322
  "hasDynamicHelp": false,
6254
6323
  "hiddenAliases": [],
6255
- "id": "compile:thread:make",
6324
+ "id": "compile:doc:list",
6256
6325
  "pluginAlias": "faces-cli",
6257
6326
  "pluginName": "faces-cli",
6258
6327
  "pluginType": "core",
@@ -6263,20 +6332,20 @@
6263
6332
  "dist",
6264
6333
  "commands",
6265
6334
  "compile",
6266
- "thread",
6267
- "make.js"
6335
+ "doc",
6336
+ "list.js"
6268
6337
  ]
6269
6338
  },
6270
- "compile:thread:message": {
6339
+ "compile:doc:make": {
6271
6340
  "aliases": [],
6272
6341
  "args": {
6273
- "thread_id": {
6274
- "description": "Thread ID",
6275
- "name": "thread_id",
6342
+ "doc_id": {
6343
+ "description": "Document ID",
6344
+ "name": "doc_id",
6276
6345
  "required": true
6277
6346
  }
6278
6347
  },
6279
- "description": "Send a user message to a thread",
6348
+ "description": "Compile an existing document (prepare + sync in one step)",
6280
6349
  "flags": {
6281
6350
  "json": {
6282
6351
  "description": "Format output as json.",
@@ -6309,25 +6378,24 @@
6309
6378
  "multiple": false,
6310
6379
  "type": "option"
6311
6380
  },
6312
- "message": {
6313
- "char": "m",
6314
- "description": "User message to append",
6315
- "name": "message",
6316
- "required": true,
6381
+ "timeout": {
6382
+ "description": "Compile timeout in seconds (default: 600)",
6383
+ "name": "timeout",
6384
+ "default": 600,
6317
6385
  "hasDynamicHelp": false,
6318
6386
  "multiple": false,
6319
6387
  "type": "option"
6320
6388
  },
6321
- "oauth-only": {
6322
- "description": "Prevent fallback to paid system key (use OAuth only)",
6323
- "name": "oauth-only",
6389
+ "no-wait": {
6390
+ "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
6391
+ "name": "no-wait",
6324
6392
  "allowNo": false,
6325
6393
  "type": "boolean"
6326
6394
  }
6327
6395
  },
6328
6396
  "hasDynamicHelp": false,
6329
6397
  "hiddenAliases": [],
6330
- "id": "compile:thread:message",
6398
+ "id": "compile:doc:make",
6331
6399
  "pluginAlias": "faces-cli",
6332
6400
  "pluginName": "faces-cli",
6333
6401
  "pluginType": "core",
@@ -6338,20 +6406,20 @@
6338
6406
  "dist",
6339
6407
  "commands",
6340
6408
  "compile",
6341
- "thread",
6342
- "message.js"
6409
+ "doc",
6410
+ "make.js"
6343
6411
  ]
6344
6412
  },
6345
- "compile:thread:pause": {
6413
+ "compile:doc:pause": {
6346
6414
  "aliases": [],
6347
6415
  "args": {
6348
- "thread_id": {
6349
- "description": "Thread ID",
6350
- "name": "thread_id",
6416
+ "doc_id": {
6417
+ "description": "Document ID",
6418
+ "name": "doc_id",
6351
6419
  "required": true
6352
6420
  }
6353
6421
  },
6354
- "description": "Ask a running thread compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
6422
+ "description": "Ask a running document compilation to stop (preserves progress, resume with make). The compile stops at the next chunk boundary; this waits for it unless --no-wait.",
6355
6423
  "flags": {
6356
6424
  "json": {
6357
6425
  "description": "Format output as json.",
@@ -6401,7 +6469,7 @@
6401
6469
  },
6402
6470
  "hasDynamicHelp": false,
6403
6471
  "hiddenAliases": [],
6404
- "id": "compile:thread:pause",
6472
+ "id": "compile:doc:pause",
6405
6473
  "pluginAlias": "faces-cli",
6406
6474
  "pluginName": "faces-cli",
6407
6475
  "pluginType": "core",
@@ -6412,20 +6480,20 @@
6412
6480
  "dist",
6413
6481
  "commands",
6414
6482
  "compile",
6415
- "thread",
6483
+ "doc",
6416
6484
  "pause.js"
6417
6485
  ]
6418
6486
  },
6419
- "compile:thread:reset": {
6487
+ "compile:doc:reset": {
6420
6488
  "aliases": [],
6421
6489
  "args": {
6422
- "thread_id": {
6423
- "description": "Thread ID",
6424
- "name": "thread_id",
6490
+ "doc_id": {
6491
+ "description": "Document ID",
6492
+ "name": "doc_id",
6425
6493
  "required": true
6426
6494
  }
6427
6495
  },
6428
- "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
6496
+ "description": "Reset document compilation progress (wipe extraction, keep content)",
6429
6497
  "flags": {
6430
6498
  "json": {
6431
6499
  "description": "Format output as json.",
@@ -6467,7 +6535,7 @@
6467
6535
  },
6468
6536
  "hasDynamicHelp": false,
6469
6537
  "hiddenAliases": [],
6470
- "id": "compile:thread:reset",
6538
+ "id": "compile:doc:reset",
6471
6539
  "pluginAlias": "faces-cli",
6472
6540
  "pluginName": "faces-cli",
6473
6541
  "pluginType": "core",
@@ -6478,20 +6546,20 @@
6478
6546
  "dist",
6479
6547
  "commands",
6480
6548
  "compile",
6481
- "thread",
6549
+ "doc",
6482
6550
  "reset.js"
6483
6551
  ]
6484
6552
  },
6485
- "compile:thread:sync": {
6553
+ "face:tag:add": {
6486
6554
  "aliases": [],
6487
6555
  "args": {
6488
- "thread_id": {
6489
- "description": "Thread ID",
6490
- "name": "thread_id",
6556
+ "alias": {
6557
+ "description": "Face alias",
6558
+ "name": "alias",
6491
6559
  "required": true
6492
6560
  }
6493
6561
  },
6494
- "description": "Archive and sync a thread into a face",
6562
+ "description": "Add tags to a face (appends, idempotent)",
6495
6563
  "flags": {
6496
6564
  "json": {
6497
6565
  "description": "Format output as json.",
@@ -6523,11 +6591,19 @@
6523
6591
  "hasDynamicHelp": false,
6524
6592
  "multiple": false,
6525
6593
  "type": "option"
6594
+ },
6595
+ "tag": {
6596
+ "description": "Tag to add (repeatable)",
6597
+ "name": "tag",
6598
+ "required": true,
6599
+ "hasDynamicHelp": false,
6600
+ "multiple": true,
6601
+ "type": "option"
6526
6602
  }
6527
6603
  },
6528
6604
  "hasDynamicHelp": false,
6529
6605
  "hiddenAliases": [],
6530
- "id": "compile:thread:sync",
6606
+ "id": "face:tag:add",
6531
6607
  "pluginAlias": "faces-cli",
6532
6608
  "pluginName": "faces-cli",
6533
6609
  "pluginType": "core",
@@ -6537,21 +6613,15 @@
6537
6613
  "relativePath": [
6538
6614
  "dist",
6539
6615
  "commands",
6540
- "compile",
6541
- "thread",
6542
- "sync.js"
6616
+ "face",
6617
+ "tag",
6618
+ "add.js"
6543
6619
  ]
6544
6620
  },
6545
- "team:tag:add": {
6621
+ "face:tag:all": {
6546
6622
  "aliases": [],
6547
- "args": {
6548
- "team_id": {
6549
- "description": "Team ID",
6550
- "name": "team_id",
6551
- "required": true
6552
- }
6553
- },
6554
- "description": "Add tags to a team (appends, idempotent)",
6623
+ "args": {},
6624
+ "description": "List all tags across all your faces",
6555
6625
  "flags": {
6556
6626
  "json": {
6557
6627
  "description": "Format output as json.",
@@ -6583,19 +6653,11 @@
6583
6653
  "hasDynamicHelp": false,
6584
6654
  "multiple": false,
6585
6655
  "type": "option"
6586
- },
6587
- "tag": {
6588
- "description": "Tag to add (repeatable)",
6589
- "name": "tag",
6590
- "required": true,
6591
- "hasDynamicHelp": false,
6592
- "multiple": true,
6593
- "type": "option"
6594
6656
  }
6595
6657
  },
6596
6658
  "hasDynamicHelp": false,
6597
6659
  "hiddenAliases": [],
6598
- "id": "team:tag:add",
6660
+ "id": "face:tag:all",
6599
6661
  "pluginAlias": "faces-cli",
6600
6662
  "pluginName": "faces-cli",
6601
6663
  "pluginType": "core",
@@ -6605,21 +6667,21 @@
6605
6667
  "relativePath": [
6606
6668
  "dist",
6607
6669
  "commands",
6608
- "team",
6670
+ "face",
6609
6671
  "tag",
6610
- "add.js"
6672
+ "all.js"
6611
6673
  ]
6612
6674
  },
6613
- "team:tag:list": {
6675
+ "face:tag:list": {
6614
6676
  "aliases": [],
6615
6677
  "args": {
6616
- "team_id": {
6617
- "description": "Team ID",
6618
- "name": "team_id",
6678
+ "alias": {
6679
+ "description": "Face alias",
6680
+ "name": "alias",
6619
6681
  "required": true
6620
6682
  }
6621
6683
  },
6622
- "description": "List tags on a team",
6684
+ "description": "List tags on a face",
6623
6685
  "flags": {
6624
6686
  "json": {
6625
6687
  "description": "Format output as json.",
@@ -6655,7 +6717,7 @@
6655
6717
  },
6656
6718
  "hasDynamicHelp": false,
6657
6719
  "hiddenAliases": [],
6658
- "id": "team:tag:list",
6720
+ "id": "face:tag:list",
6659
6721
  "pluginAlias": "faces-cli",
6660
6722
  "pluginName": "faces-cli",
6661
6723
  "pluginType": "core",
@@ -6665,17 +6727,17 @@
6665
6727
  "relativePath": [
6666
6728
  "dist",
6667
6729
  "commands",
6668
- "team",
6730
+ "face",
6669
6731
  "tag",
6670
6732
  "list.js"
6671
6733
  ]
6672
6734
  },
6673
- "team:tag:remove": {
6735
+ "face:tag:remove": {
6674
6736
  "aliases": [],
6675
6737
  "args": {
6676
- "team_id": {
6677
- "description": "Team ID",
6678
- "name": "team_id",
6738
+ "alias": {
6739
+ "description": "Face alias",
6740
+ "name": "alias",
6679
6741
  "required": true
6680
6742
  },
6681
6743
  "tag": {
@@ -6684,7 +6746,7 @@
6684
6746
  "required": true
6685
6747
  }
6686
6748
  },
6687
- "description": "Remove a tag from a team",
6749
+ "description": "Remove a tag from a face",
6688
6750
  "flags": {
6689
6751
  "json": {
6690
6752
  "description": "Format output as json.",
@@ -6720,7 +6782,7 @@
6720
6782
  },
6721
6783
  "hasDynamicHelp": false,
6722
6784
  "hiddenAliases": [],
6723
- "id": "team:tag:remove",
6785
+ "id": "face:tag:remove",
6724
6786
  "pluginAlias": "faces-cli",
6725
6787
  "pluginName": "faces-cli",
6726
6788
  "pluginType": "core",
@@ -6730,21 +6792,21 @@
6730
6792
  "relativePath": [
6731
6793
  "dist",
6732
6794
  "commands",
6733
- "team",
6795
+ "face",
6734
6796
  "tag",
6735
6797
  "remove.js"
6736
6798
  ]
6737
6799
  },
6738
- "team:tag:set": {
6800
+ "face:tag:set": {
6739
6801
  "aliases": [],
6740
6802
  "args": {
6741
- "team_id": {
6742
- "description": "Team ID",
6743
- "name": "team_id",
6803
+ "alias": {
6804
+ "description": "Face alias",
6805
+ "name": "alias",
6744
6806
  "required": true
6745
6807
  }
6746
6808
  },
6747
- "description": "Replace all tags on a team",
6809
+ "description": "Replace all tags on a face",
6748
6810
  "flags": {
6749
6811
  "json": {
6750
6812
  "description": "Format output as json.",
@@ -6788,7 +6850,7 @@
6788
6850
  },
6789
6851
  "hasDynamicHelp": false,
6790
6852
  "hiddenAliases": [],
6791
- "id": "team:tag:set",
6853
+ "id": "face:tag:set",
6792
6854
  "pluginAlias": "faces-cli",
6793
6855
  "pluginName": "faces-cli",
6794
6856
  "pluginType": "core",
@@ -6798,21 +6860,21 @@
6798
6860
  "relativePath": [
6799
6861
  "dist",
6800
6862
  "commands",
6801
- "team",
6863
+ "face",
6802
6864
  "tag",
6803
6865
  "set.js"
6804
6866
  ]
6805
6867
  },
6806
- "face:tag:add": {
6868
+ "team:tag:add": {
6807
6869
  "aliases": [],
6808
6870
  "args": {
6809
- "alias": {
6810
- "description": "Face alias",
6811
- "name": "alias",
6871
+ "team_id": {
6872
+ "description": "Team ID",
6873
+ "name": "team_id",
6812
6874
  "required": true
6813
6875
  }
6814
6876
  },
6815
- "description": "Add tags to a face (appends, idempotent)",
6877
+ "description": "Add tags to a team (appends, idempotent)",
6816
6878
  "flags": {
6817
6879
  "json": {
6818
6880
  "description": "Format output as json.",
@@ -6856,7 +6918,7 @@
6856
6918
  },
6857
6919
  "hasDynamicHelp": false,
6858
6920
  "hiddenAliases": [],
6859
- "id": "face:tag:add",
6921
+ "id": "team:tag:add",
6860
6922
  "pluginAlias": "faces-cli",
6861
6923
  "pluginName": "faces-cli",
6862
6924
  "pluginType": "core",
@@ -6866,75 +6928,21 @@
6866
6928
  "relativePath": [
6867
6929
  "dist",
6868
6930
  "commands",
6869
- "face",
6931
+ "team",
6870
6932
  "tag",
6871
6933
  "add.js"
6872
6934
  ]
6873
6935
  },
6874
- "face:tag:all": {
6875
- "aliases": [],
6876
- "args": {},
6877
- "description": "List all tags across all your faces",
6878
- "flags": {
6879
- "json": {
6880
- "description": "Format output as json.",
6881
- "helpGroup": "GLOBAL",
6882
- "name": "json",
6883
- "allowNo": false,
6884
- "type": "boolean"
6885
- },
6886
- "base-url": {
6887
- "description": "API base URL",
6888
- "env": "FACES_BASE_URL",
6889
- "name": "base-url",
6890
- "hasDynamicHelp": false,
6891
- "multiple": false,
6892
- "type": "option"
6893
- },
6894
- "token": {
6895
- "description": "JWT bearer token",
6896
- "env": "FACES_TOKEN",
6897
- "name": "token",
6898
- "hasDynamicHelp": false,
6899
- "multiple": false,
6900
- "type": "option"
6901
- },
6902
- "api-key": {
6903
- "description": "API key",
6904
- "env": "FACES_API_KEY",
6905
- "name": "api-key",
6906
- "hasDynamicHelp": false,
6907
- "multiple": false,
6908
- "type": "option"
6909
- }
6910
- },
6911
- "hasDynamicHelp": false,
6912
- "hiddenAliases": [],
6913
- "id": "face:tag:all",
6914
- "pluginAlias": "faces-cli",
6915
- "pluginName": "faces-cli",
6916
- "pluginType": "core",
6917
- "strict": true,
6918
- "enableJsonFlag": true,
6919
- "isESM": true,
6920
- "relativePath": [
6921
- "dist",
6922
- "commands",
6923
- "face",
6924
- "tag",
6925
- "all.js"
6926
- ]
6927
- },
6928
- "face:tag:list": {
6936
+ "team:tag:list": {
6929
6937
  "aliases": [],
6930
6938
  "args": {
6931
- "alias": {
6932
- "description": "Face alias",
6933
- "name": "alias",
6939
+ "team_id": {
6940
+ "description": "Team ID",
6941
+ "name": "team_id",
6934
6942
  "required": true
6935
6943
  }
6936
6944
  },
6937
- "description": "List tags on a face",
6945
+ "description": "List tags on a team",
6938
6946
  "flags": {
6939
6947
  "json": {
6940
6948
  "description": "Format output as json.",
@@ -6970,7 +6978,7 @@
6970
6978
  },
6971
6979
  "hasDynamicHelp": false,
6972
6980
  "hiddenAliases": [],
6973
- "id": "face:tag:list",
6981
+ "id": "team:tag:list",
6974
6982
  "pluginAlias": "faces-cli",
6975
6983
  "pluginName": "faces-cli",
6976
6984
  "pluginType": "core",
@@ -6980,17 +6988,17 @@
6980
6988
  "relativePath": [
6981
6989
  "dist",
6982
6990
  "commands",
6983
- "face",
6991
+ "team",
6984
6992
  "tag",
6985
6993
  "list.js"
6986
6994
  ]
6987
6995
  },
6988
- "face:tag:remove": {
6996
+ "team:tag:remove": {
6989
6997
  "aliases": [],
6990
6998
  "args": {
6991
- "alias": {
6992
- "description": "Face alias",
6993
- "name": "alias",
6999
+ "team_id": {
7000
+ "description": "Team ID",
7001
+ "name": "team_id",
6994
7002
  "required": true
6995
7003
  },
6996
7004
  "tag": {
@@ -6999,7 +7007,7 @@
6999
7007
  "required": true
7000
7008
  }
7001
7009
  },
7002
- "description": "Remove a tag from a face",
7010
+ "description": "Remove a tag from a team",
7003
7011
  "flags": {
7004
7012
  "json": {
7005
7013
  "description": "Format output as json.",
@@ -7035,7 +7043,7 @@
7035
7043
  },
7036
7044
  "hasDynamicHelp": false,
7037
7045
  "hiddenAliases": [],
7038
- "id": "face:tag:remove",
7046
+ "id": "team:tag:remove",
7039
7047
  "pluginAlias": "faces-cli",
7040
7048
  "pluginName": "faces-cli",
7041
7049
  "pluginType": "core",
@@ -7045,21 +7053,21 @@
7045
7053
  "relativePath": [
7046
7054
  "dist",
7047
7055
  "commands",
7048
- "face",
7056
+ "team",
7049
7057
  "tag",
7050
7058
  "remove.js"
7051
7059
  ]
7052
7060
  },
7053
- "face:tag:set": {
7061
+ "team:tag:set": {
7054
7062
  "aliases": [],
7055
7063
  "args": {
7056
- "alias": {
7057
- "description": "Face alias",
7058
- "name": "alias",
7064
+ "team_id": {
7065
+ "description": "Team ID",
7066
+ "name": "team_id",
7059
7067
  "required": true
7060
7068
  }
7061
7069
  },
7062
- "description": "Replace all tags on a face",
7070
+ "description": "Replace all tags on a team",
7063
7071
  "flags": {
7064
7072
  "json": {
7065
7073
  "description": "Format output as json.",
@@ -7103,7 +7111,7 @@
7103
7111
  },
7104
7112
  "hasDynamicHelp": false,
7105
7113
  "hiddenAliases": [],
7106
- "id": "face:tag:set",
7114
+ "id": "team:tag:set",
7107
7115
  "pluginAlias": "faces-cli",
7108
7116
  "pluginName": "faces-cli",
7109
7117
  "pluginType": "core",
@@ -7113,11 +7121,11 @@
7113
7121
  "relativePath": [
7114
7122
  "dist",
7115
7123
  "commands",
7116
- "face",
7124
+ "team",
7117
7125
  "tag",
7118
7126
  "set.js"
7119
7127
  ]
7120
7128
  }
7121
7129
  },
7122
- "version": "1.8.2"
7130
+ "version": "1.8.3"
7123
7131
  }