@descix/platform-api 4.0.0 → 5.0.0

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.
@@ -0,0 +1,2039 @@
1
+ [
2
+ {
3
+ "verbPath": "admin-login",
4
+ "description": "Bootstrap CLI credentials for platform admins (requires admin group membership)",
5
+ "arguments": [],
6
+ "options": [
7
+ {
8
+ "flags": "-e, --email <email>",
9
+ "description": "Admin email (must be in platform admin Google Group)",
10
+ "required": true
11
+ },
12
+ {
13
+ "flags": "-u, --url <url>",
14
+ "description": "API URL override",
15
+ "required": false
16
+ }
17
+ ],
18
+ "runbookAnchor": null
19
+ },
20
+ {
21
+ "verbPath": "app delete",
22
+ "description": "Delete an app with full cascade cleanup (Pinecone, GCS, Firestore, Products)",
23
+ "arguments": [],
24
+ "options": [
25
+ {
26
+ "flags": "-a, --app <app_id>",
27
+ "description": "App ID to delete",
28
+ "required": true
29
+ },
30
+ {
31
+ "flags": "-c, --community <community_id>",
32
+ "description": "Community ID (auto-resolved from Products if omitted)",
33
+ "required": false
34
+ },
35
+ {
36
+ "flags": "--dry-run",
37
+ "description": "Preview what would be deleted without executing",
38
+ "required": false
39
+ },
40
+ {
41
+ "flags": "--soft",
42
+ "description": "Soft delete only (mark as hidden, no cascade)",
43
+ "required": false
44
+ },
45
+ {
46
+ "flags": "--yes",
47
+ "description": "Skip confirmation prompt",
48
+ "required": false
49
+ }
50
+ ],
51
+ "runbookAnchor": null
52
+ },
53
+ {
54
+ "verbPath": "app init",
55
+ "description": "Create (if needed) and initialize an app: platform record + default KB + local workspace registration and scaffold. Idempotent. Pass -c to create a new app; omit it to initialize one that already exists.",
56
+ "arguments": [],
57
+ "options": [
58
+ {
59
+ "flags": "-a, --app <app_id>",
60
+ "description": "App ID (e.g. daita). With -c this is the app NAME to create.",
61
+ "required": true
62
+ },
63
+ {
64
+ "flags": "-c, --community <id>",
65
+ "description": "Community ID — REQUIRED to create an app that does not exist yet. The community must already be materialized in this environment.",
66
+ "required": false
67
+ },
68
+ {
69
+ "flags": "-s, --short <short_name>",
70
+ "description": "SHORT id segment (no hyphens) used when creating; the app_id is composed server-side as {community}-{short}. Defaults to --app.",
71
+ "required": false
72
+ },
73
+ {
74
+ "flags": "--overwrite",
75
+ "description": "When creating, overwrite an existing app record intentionally",
76
+ "required": false
77
+ },
78
+ {
79
+ "flags": "--kb <name>",
80
+ "description": "Knowledge base name",
81
+ "required": false
82
+ }
83
+ ],
84
+ "runbookAnchor": "#_4-connect-the-repository-to-its-app"
85
+ },
86
+ {
87
+ "verbPath": "app invite",
88
+ "description": "Generate invite links to share your app",
89
+ "arguments": [],
90
+ "options": [
91
+ {
92
+ "flags": "-a, --app <id>",
93
+ "description": "App ID",
94
+ "required": true
95
+ },
96
+ {
97
+ "flags": "--type <type>",
98
+ "description": "Invite type: try or install",
99
+ "required": false
100
+ },
101
+ {
102
+ "flags": "--hint <text>",
103
+ "description": "Context for the AI agent (e.g., \"Physics students, no coding background\")",
104
+ "required": false
105
+ },
106
+ {
107
+ "flags": "--expires <duration>",
108
+ "description": "Expiry duration (e.g., 30d, 7d, 24h)",
109
+ "required": false
110
+ }
111
+ ],
112
+ "runbookAnchor": null
113
+ },
114
+ {
115
+ "verbPath": "app list",
116
+ "description": "List apps you have access to (purchases + owned)",
117
+ "arguments": [],
118
+ "options": [],
119
+ "runbookAnchor": null
120
+ },
121
+ {
122
+ "verbPath": "app media-upload",
123
+ "description": "Upload media/asset files to an app's GCS assets prefix (200 MB per app today; app owners, community admins and platform admins may upload — returns asset references)",
124
+ "arguments": [],
125
+ "options": [
126
+ {
127
+ "flags": "-a, --app <id>",
128
+ "description": "App ID (community is resolved server-side from Products)",
129
+ "required": true
130
+ },
131
+ {
132
+ "flags": "-f, --file <path...>",
133
+ "description": "One or more local file paths to upload",
134
+ "required": true
135
+ },
136
+ {
137
+ "flags": "--prefix <relPath>",
138
+ "description": "Optional sub-path under the app assets/ prefix (e.g. \"shows/myshow\")",
139
+ "required": false
140
+ },
141
+ {
142
+ "flags": "--json",
143
+ "description": "Print the asset references as JSON (for scripting)",
144
+ "required": false
145
+ }
146
+ ],
147
+ "runbookAnchor": null
148
+ },
149
+ {
150
+ "verbPath": "app open",
151
+ "description": "Resolve (and optionally open) an app's local gateway dev URL. Hard-fails if the app has no site config.",
152
+ "arguments": [],
153
+ "options": [
154
+ {
155
+ "flags": "-a, --app <app_id>",
156
+ "description": "App ID (an app this workspace serves, with a site)",
157
+ "required": true
158
+ },
159
+ {
160
+ "flags": "--open",
161
+ "description": "Open the resolved URL in the default browser",
162
+ "required": false
163
+ }
164
+ ],
165
+ "runbookAnchor": null
166
+ },
167
+ {
168
+ "verbPath": "app records delete",
169
+ "description": "Delete records by id (or by file_id grouping key)",
170
+ "arguments": [],
171
+ "options": [
172
+ {
173
+ "flags": "-a, --app <app_id>",
174
+ "description": "App ID",
175
+ "required": true
176
+ },
177
+ {
178
+ "flags": "-k, --kb <kb_id>",
179
+ "description": "Record collection ID",
180
+ "required": true
181
+ },
182
+ {
183
+ "flags": "-i, --ids <csv>",
184
+ "description": "Comma-separated record ids to delete",
185
+ "required": false
186
+ },
187
+ {
188
+ "flags": "--file-ids <csv>",
189
+ "description": "Comma-separated file_id grouping keys to delete",
190
+ "required": false
191
+ }
192
+ ],
193
+ "runbookAnchor": null
194
+ },
195
+ {
196
+ "verbPath": "app records get",
197
+ "description": "Fetch specific records by id (point lookup) with an arbitrary metadata projection",
198
+ "arguments": [],
199
+ "options": [
200
+ {
201
+ "flags": "-a, --app <app_id>",
202
+ "description": "App ID",
203
+ "required": true
204
+ },
205
+ {
206
+ "flags": "-k, --kb <kb_id>",
207
+ "description": "Record collection ID",
208
+ "required": true
209
+ },
210
+ {
211
+ "flags": "-i, --ids <csv>",
212
+ "description": "Comma-separated record ids to fetch",
213
+ "required": true
214
+ },
215
+ {
216
+ "flags": "--fields <csv>",
217
+ "description": "Comma-separated metadata projection (omit or \"*\" for all metadata)",
218
+ "required": false
219
+ }
220
+ ],
221
+ "runbookAnchor": null
222
+ },
223
+ {
224
+ "verbPath": "app records put",
225
+ "description": "Store/replace records in your app data store with custom metadata (your app as a database table). You supply file_id (+ optional chunk_idx); the id is built for you.",
226
+ "arguments": [],
227
+ "options": [
228
+ {
229
+ "flags": "-a, --app <app_id>",
230
+ "description": "App ID",
231
+ "required": true
232
+ },
233
+ {
234
+ "flags": "-k, --kb <kb_id>",
235
+ "description": "Record collection ID (acts like a table)",
236
+ "required": true
237
+ },
238
+ {
239
+ "flags": "-r, --records <json>",
240
+ "description": "JSON array of records: [{ \"file_id\", \"text\"?, \"chunk_idx\"?, ...customMetadata }] — id is built from file_id (+ chunk_idx); pass a full \"id\" only for back-compat. Example: '[{\"file_id\":\"e1\",\"text\":\"...\",\"type\":\"episode\",\"show\":\"x\"}]'",
241
+ "required": true
242
+ },
243
+ {
244
+ "flags": "--mode <mode>",
245
+ "description": "upsert (default) | create — \"create\" is an atomic all-or-nothing conditional create: it fails if any key already exists and reports who holds it, instead of overwriting",
246
+ "required": false
247
+ }
248
+ ],
249
+ "runbookAnchor": null
250
+ },
251
+ {
252
+ "verbPath": "app records query",
253
+ "description": "STRUCTURED metadata-filtered scan (non-ANN) returning full records: \"all records where type=episode AND show=X\"",
254
+ "arguments": [],
255
+ "options": [
256
+ {
257
+ "flags": "-a, --app <app_id>",
258
+ "description": "App ID",
259
+ "required": true
260
+ },
261
+ {
262
+ "flags": "-k, --kb <kb_id>",
263
+ "description": "Record collection ID",
264
+ "required": true
265
+ },
266
+ {
267
+ "flags": "-f, --filter <json>",
268
+ "description": "Metadata predicate JSON. Scalar fields: $eq/$ne/$in or a bare value; ARRAY fields: $contains. e.g. '{\"type\":\"episode\",\"tags\":{\"$contains\":\"handoff\"}}'",
269
+ "required": false
270
+ },
271
+ {
272
+ "flags": "--fields <csv>",
273
+ "description": "Comma-separated metadata projection (omit or \"*\" for all metadata)",
274
+ "required": false
275
+ },
276
+ {
277
+ "flags": "--limit <n>",
278
+ "description": "Cap on returned records",
279
+ "required": false
280
+ }
281
+ ],
282
+ "runbookAnchor": null
283
+ },
284
+ {
285
+ "verbPath": "app set-api-url",
286
+ "description": "Set API base URL for app's own backend",
287
+ "arguments": [],
288
+ "options": [
289
+ {
290
+ "flags": "-c, --community <id>",
291
+ "description": "Community ID",
292
+ "required": true
293
+ },
294
+ {
295
+ "flags": "-a, --app <id>",
296
+ "description": "App ID",
297
+ "required": true
298
+ },
299
+ {
300
+ "flags": "-u, --url <url>",
301
+ "description": "API base URL (e.g., https://api.example.com)",
302
+ "required": true
303
+ }
304
+ ],
305
+ "runbookAnchor": null
306
+ },
307
+ {
308
+ "verbPath": "app set-default-model",
309
+ "description": "Set or clear App.default_app_model (model used when no KB override is set)",
310
+ "arguments": [],
311
+ "options": [
312
+ {
313
+ "flags": "-a, --app <app_id>",
314
+ "description": "App ID (e.g. unk-cos)",
315
+ "required": true
316
+ },
317
+ {
318
+ "flags": "-m, --model <model_name>",
319
+ "description": "Model name (e.g. gemini-3.8-flash). Mutually exclusive with --clear.",
320
+ "required": false
321
+ },
322
+ {
323
+ "flags": "--clear",
324
+ "description": "Delete App.default_app_model via FieldValue.delete() (resets to platform-default inheritance)",
325
+ "required": false
326
+ }
327
+ ],
328
+ "runbookAnchor": null
329
+ },
330
+ {
331
+ "verbPath": "app set-listed",
332
+ "description": "List or unlist your app in the app store (on: shown in the public store; off: not shown to non-admin visitors)",
333
+ "arguments": [
334
+ {
335
+ "name": "state",
336
+ "required": true,
337
+ "variadic": false,
338
+ "description": "on or off"
339
+ }
340
+ ],
341
+ "options": [
342
+ {
343
+ "flags": "-c, --community <id>",
344
+ "description": "Community ID",
345
+ "required": true
346
+ },
347
+ {
348
+ "flags": "-a, --app <id>",
349
+ "description": "App ID",
350
+ "required": true
351
+ }
352
+ ],
353
+ "runbookAnchor": "#_9-list-it-and-discover-the-rest"
354
+ },
355
+ {
356
+ "verbPath": "app set-name",
357
+ "description": "Set app display name",
358
+ "arguments": [],
359
+ "options": [
360
+ {
361
+ "flags": "-c, --community <id>",
362
+ "description": "Community ID",
363
+ "required": true
364
+ },
365
+ {
366
+ "flags": "-a, --app <id>",
367
+ "description": "App ID",
368
+ "required": true
369
+ },
370
+ {
371
+ "flags": "--name <name>",
372
+ "description": "Display name for the app",
373
+ "required": true
374
+ }
375
+ ],
376
+ "runbookAnchor": null
377
+ },
378
+ {
379
+ "verbPath": "app set-port",
380
+ "description": "Set the microservice port for this workspace's app (writes env.app.microservice.port). Pass \"n\" to remove.",
381
+ "arguments": [],
382
+ "options": [
383
+ {
384
+ "flags": "-a, --app <app_id>",
385
+ "description": "App ID (must be this workspace's app, env.app)",
386
+ "required": true
387
+ },
388
+ {
389
+ "flags": "-p, --port <port>",
390
+ "description": "Microservice port number (1-65535), or \"n\" to remove",
391
+ "required": true
392
+ }
393
+ ],
394
+ "runbookAnchor": null
395
+ },
396
+ {
397
+ "verbPath": "app set-price",
398
+ "description": "Set app price in USDCX",
399
+ "arguments": [],
400
+ "options": [
401
+ {
402
+ "flags": "-c, --community <id>",
403
+ "description": "Community ID",
404
+ "required": true
405
+ },
406
+ {
407
+ "flags": "-a, --app <id>",
408
+ "description": "App ID",
409
+ "required": true
410
+ },
411
+ {
412
+ "flags": "-p, --price <amount>",
413
+ "description": "Price in USDCX (decimal number)",
414
+ "required": true
415
+ }
416
+ ],
417
+ "runbookAnchor": null
418
+ },
419
+ {
420
+ "verbPath": "app set-repo",
421
+ "description": "Link a GitHub repository to your app",
422
+ "arguments": [],
423
+ "options": [
424
+ {
425
+ "flags": "-a, --app <id>",
426
+ "description": "App ID",
427
+ "required": true
428
+ },
429
+ {
430
+ "flags": "--repo <url>",
431
+ "description": "SSH git URL (e.g., git@github.com:user/repo.git)",
432
+ "required": false
433
+ },
434
+ {
435
+ "flags": "--unlink",
436
+ "description": "Remove the linked repository",
437
+ "required": false
438
+ },
439
+ {
440
+ "flags": "--branch <name>",
441
+ "description": "Default branch",
442
+ "required": false
443
+ },
444
+ {
445
+ "flags": "--subfolder <path>",
446
+ "description": "Subfolder within repo",
447
+ "required": false
448
+ }
449
+ ],
450
+ "runbookAnchor": null
451
+ },
452
+ {
453
+ "verbPath": "app set-site",
454
+ "description": "Set this workspace app's site config (env.app.site). One active mode per write: --static <dir> (built site served at /p/<app>/) or --port <n> [--protocol http|https] (dev server proxied at /p/<app>); setting one clears the other. Pass both flags together to keep both — the gateway then serves the dev server (site.port wins). --unset clears site.{} entirely.",
455
+ "arguments": [],
456
+ "options": [
457
+ {
458
+ "flags": "-a, --app <app_id>",
459
+ "description": "App ID (must be this workspace's app, env.app)",
460
+ "required": true
461
+ },
462
+ {
463
+ "flags": "--static <path>",
464
+ "description": "Static mode: a dir relative to the workspace root (the repo root), e.g. \"site\" or \"../scratch\"; \".\" = the root itself. An absolute path is refused. Alone, it clears site.port and site.protocol (one active mode per write).",
465
+ "required": false
466
+ },
467
+ {
468
+ "flags": "--port <port>",
469
+ "description": "Dev-server mode: proxy /p/<app> to your local dev server on this port (1-65535). Alone, it clears site.static. With --static in the same call, both are kept and the gateway serves the dev server.",
470
+ "required": false
471
+ },
472
+ {
473
+ "flags": "--protocol <scheme>",
474
+ "description": "Dev-server upstream scheme: \"http\" or \"https\" (default https when unset). Dev-server mode only — requires site.port. A wrong scheme fails loud at the gateway (502); there is no auto-detection.",
475
+ "required": false
476
+ },
477
+ {
478
+ "flags": "--unset",
479
+ "description": "Remove site.static, site.port and site.protocol for the app, clearing the site.{} slot",
480
+ "required": false
481
+ }
482
+ ],
483
+ "runbookAnchor": "#_5-run-it-locally-descix-serve"
484
+ },
485
+ {
486
+ "verbPath": "app sync-assets",
487
+ "description": "Sync local assets (system_instructions.md, app_description.md, icon.png) to platform.",
488
+ "arguments": [],
489
+ "options": [
490
+ {
491
+ "flags": "-a, --app <app_id>",
492
+ "description": "App ID",
493
+ "required": true
494
+ },
495
+ {
496
+ "flags": "-k, --kb <name>",
497
+ "description": "Target KB for system_instructions",
498
+ "required": false
499
+ },
500
+ {
501
+ "flags": "-p, --path <dir>",
502
+ "description": "App directory (default: auto-detected)",
503
+ "required": false
504
+ }
505
+ ],
506
+ "runbookAnchor": null
507
+ },
508
+ {
509
+ "verbPath": "chat",
510
+ "description": "Chat with an app agent. Usage: descix chat \"Your question\" or descix chat -q \"Your question\"",
511
+ "arguments": [
512
+ {
513
+ "name": "question",
514
+ "required": false,
515
+ "variadic": true,
516
+ "description": ""
517
+ }
518
+ ],
519
+ "options": [
520
+ {
521
+ "flags": "-c, --community <id>",
522
+ "description": "Community ID (optional; server resolves it from Products)",
523
+ "required": false
524
+ },
525
+ {
526
+ "flags": "-a, --app <id>",
527
+ "description": "App ID (required unless run from inside a mapped app directory)",
528
+ "required": false
529
+ },
530
+ {
531
+ "flags": "-q, --question <text>",
532
+ "description": "Question to ask (alternative to positional argument)",
533
+ "required": false
534
+ },
535
+ {
536
+ "flags": "-k, --kb <id...>",
537
+ "description": "Knowledge Base ID(s) — repeat for multi-KB, use * for all",
538
+ "required": false
539
+ },
540
+ {
541
+ "flags": "--apps <ids>",
542
+ "description": "Comma-separated app IDs for cross-app query",
543
+ "required": false
544
+ },
545
+ {
546
+ "flags": "--level <n>",
547
+ "description": "Intelligence level (1-5)",
548
+ "required": false
549
+ },
550
+ {
551
+ "flags": "--model <name>",
552
+ "description": "Explicit model override",
553
+ "required": false
554
+ },
555
+ {
556
+ "flags": "--thinking-level <level>",
557
+ "description": "Thinking level for this call: minimal, low, medium or high. The server refuses a level the resolved model does not support.",
558
+ "required": false
559
+ },
560
+ {
561
+ "flags": "--tokens",
562
+ "description": "Show token usage in response footer",
563
+ "required": false
564
+ },
565
+ {
566
+ "flags": "--new",
567
+ "description": "Start a new conversation (clear session)",
568
+ "required": false
569
+ }
570
+ ],
571
+ "runbookAnchor": "#_6-knowledge-bases"
572
+ },
573
+ {
574
+ "verbPath": "clone",
575
+ "description": "Clone a DeSciX app repository",
576
+ "arguments": [],
577
+ "options": [
578
+ {
579
+ "flags": "-a, --app <id>",
580
+ "description": "App ID",
581
+ "required": true
582
+ },
583
+ {
584
+ "flags": "--path <dir>",
585
+ "description": "Target directory",
586
+ "required": false
587
+ }
588
+ ],
589
+ "runbookAnchor": null
590
+ },
591
+ {
592
+ "verbPath": "community check-token",
593
+ "description": "Check if a token symbol is available",
594
+ "arguments": [
595
+ {
596
+ "name": "symbol",
597
+ "required": true,
598
+ "variadic": false,
599
+ "description": "Token symbol to check (1-7 chars)"
600
+ }
601
+ ],
602
+ "options": [],
603
+ "runbookAnchor": null
604
+ },
605
+ {
606
+ "verbPath": "community contract",
607
+ "description": "Get details about a deployed contract",
608
+ "arguments": [],
609
+ "options": [
610
+ {
611
+ "flags": "-a, --address <address>",
612
+ "description": "Contract address",
613
+ "required": false
614
+ },
615
+ {
616
+ "flags": "-t, --token <symbol>",
617
+ "description": "Token symbol",
618
+ "required": false
619
+ },
620
+ {
621
+ "flags": "-c, --community <id>",
622
+ "description": "Community ID",
623
+ "required": false
624
+ }
625
+ ],
626
+ "runbookAnchor": null
627
+ },
628
+ {
629
+ "verbPath": "community create",
630
+ "description": "Create a new community with token contract (requires platform admin, deploys to live Polygon)",
631
+ "arguments": [],
632
+ "options": [
633
+ {
634
+ "flags": "-n, --name <name>",
635
+ "description": "Community display name (e.g. \"SMILE\")",
636
+ "required": true
637
+ },
638
+ {
639
+ "flags": "-t, --token <symbol>",
640
+ "description": "Token symbol (e.g. SMILE)",
641
+ "required": true
642
+ },
643
+ {
644
+ "flags": "--icon <url>",
645
+ "description": "Icon URL for the community",
646
+ "required": false
647
+ },
648
+ {
649
+ "flags": "--yes",
650
+ "description": "Skip confirmation prompt (use with caution)",
651
+ "required": false
652
+ }
653
+ ],
654
+ "runbookAnchor": null
655
+ },
656
+ {
657
+ "verbPath": "community delete",
658
+ "description": "Delete a community with full cascade cleanup (all apps, KBs, vectors, GCS)",
659
+ "arguments": [],
660
+ "options": [
661
+ {
662
+ "flags": "-n, --name <community_id>",
663
+ "description": "Community ID to delete",
664
+ "required": true
665
+ },
666
+ {
667
+ "flags": "--dry-run",
668
+ "description": "Preview what would be deleted without executing",
669
+ "required": false
670
+ },
671
+ {
672
+ "flags": "--soft",
673
+ "description": "Soft delete only (mark as hidden, no cascade)",
674
+ "required": false
675
+ },
676
+ {
677
+ "flags": "--yes",
678
+ "description": "Skip confirmation prompt",
679
+ "required": false
680
+ }
681
+ ],
682
+ "runbookAnchor": null
683
+ },
684
+ {
685
+ "verbPath": "community deploy-token",
686
+ "description": "Deploy a new token contract (without creating a community)",
687
+ "arguments": [],
688
+ "options": [
689
+ {
690
+ "flags": "-t, --token <symbol>",
691
+ "description": "Token symbol (e.g., POWCH)",
692
+ "required": true
693
+ },
694
+ {
695
+ "flags": "-n, --name <name>",
696
+ "description": "Token name (e.g., \"Powch Token\")",
697
+ "required": true
698
+ },
699
+ {
700
+ "flags": "--treasury <address>",
701
+ "description": "Treasury wallet address (defaults to platform wallet)",
702
+ "required": false
703
+ },
704
+ {
705
+ "flags": "-c, --community <id>",
706
+ "description": "Community ID to link the token to (optional)",
707
+ "required": false
708
+ }
709
+ ],
710
+ "runbookAnchor": null
711
+ },
712
+ {
713
+ "verbPath": "community info",
714
+ "description": "Get community information",
715
+ "arguments": [],
716
+ "options": [
717
+ {
718
+ "flags": "-c, --community <id>",
719
+ "description": "Community ID",
720
+ "required": false
721
+ },
722
+ {
723
+ "flags": "-n, --name <id>",
724
+ "description": "Community ID (alias for -c)",
725
+ "required": false
726
+ }
727
+ ],
728
+ "runbookAnchor": null
729
+ },
730
+ {
731
+ "verbPath": "community link-token",
732
+ "description": "Link an existing token contract to a community",
733
+ "arguments": [],
734
+ "options": [
735
+ {
736
+ "flags": "-c, --community <id>",
737
+ "description": "Community ID to link to",
738
+ "required": true
739
+ },
740
+ {
741
+ "flags": "-a, --address <address>",
742
+ "description": "Contract address to link",
743
+ "required": true
744
+ },
745
+ {
746
+ "flags": "-t, --token <symbol>",
747
+ "description": "Token symbol (optional, uses contract symbol if not provided)",
748
+ "required": false
749
+ }
750
+ ],
751
+ "runbookAnchor": null
752
+ },
753
+ {
754
+ "verbPath": "community list",
755
+ "description": "List all communities",
756
+ "arguments": [],
757
+ "options": [],
758
+ "runbookAnchor": null
759
+ },
760
+ {
761
+ "verbPath": "community refresh-identity",
762
+ "description": "Mirror a community's token symbol and icon from the descix-chain registry into this environment (the icon only if it serves)",
763
+ "arguments": [],
764
+ "options": [
765
+ {
766
+ "flags": "-c, --community <id>",
767
+ "description": "Community ID",
768
+ "required": true
769
+ }
770
+ ],
771
+ "runbookAnchor": null
772
+ },
773
+ {
774
+ "verbPath": "community rename",
775
+ "description": "Rename a community_id across all surfaces (Firestore, Products, Pinecone metadata, ServiceManifests, descix-chain registry). On-chain contract + token symbol are UNTOUCHED. Dry-run first.",
776
+ "arguments": [
777
+ {
778
+ "name": "old_community_id",
779
+ "required": true,
780
+ "variadic": false,
781
+ "description": "Current community_id (e.g. unkamon)"
782
+ },
783
+ {
784
+ "name": "new_community_id",
785
+ "required": true,
786
+ "variadic": false,
787
+ "description": "New canonical community_id (e.g. unk)"
788
+ }
789
+ ],
790
+ "options": [
791
+ {
792
+ "flags": "--dry-run",
793
+ "description": "Preview the full cascade plan without executing",
794
+ "required": false
795
+ },
796
+ {
797
+ "flags": "--yes",
798
+ "description": "Skip confirmation prompt",
799
+ "required": false
800
+ }
801
+ ],
802
+ "runbookAnchor": null
803
+ },
804
+ {
805
+ "verbPath": "config gateway add-repo",
806
+ "description": "List a repo whose app the gateway serves at /p/<appId> (env.gateway.appRepos[])",
807
+ "arguments": [
808
+ {
809
+ "name": "repo",
810
+ "required": true,
811
+ "variadic": false,
812
+ "description": "Repo root relative to the workspace root"
813
+ }
814
+ ],
815
+ "options": [],
816
+ "runbookAnchor": null
817
+ },
818
+ {
819
+ "verbPath": "config gateway remove-repo",
820
+ "description": "Remove a listed repo from env.gateway.appRepos[]",
821
+ "arguments": [
822
+ {
823
+ "name": "repo",
824
+ "required": true,
825
+ "variadic": false,
826
+ "description": "Repo root relative to the workspace root, as listed"
827
+ }
828
+ ],
829
+ "options": [],
830
+ "runbookAnchor": null
831
+ },
832
+ {
833
+ "verbPath": "config gateway set-shell",
834
+ "description": "Set the repo whose app the gateway serves at / (env.gateway.shell)",
835
+ "arguments": [
836
+ {
837
+ "name": "repo",
838
+ "required": true,
839
+ "variadic": false,
840
+ "description": "Repo root relative to the workspace root, or \"none\" to remove"
841
+ }
842
+ ],
843
+ "options": [],
844
+ "runbookAnchor": null
845
+ },
846
+ {
847
+ "verbPath": "config init",
848
+ "description": "Pin this workspace to an environment (requires the global --env dev|demo|prod)",
849
+ "arguments": [],
850
+ "options": [
851
+ {
852
+ "flags": "--url <url>",
853
+ "description": "Explicit origin (for a self-hosted or port-forwarded gateway)",
854
+ "required": false
855
+ },
856
+ {
857
+ "flags": "-g, --global",
858
+ "description": "Save to global config (~/.descixrc)",
859
+ "required": false
860
+ }
861
+ ],
862
+ "runbookAnchor": "#_3-pin-production-then-sign-in"
863
+ },
864
+ {
865
+ "verbPath": "config set-dev-certs",
866
+ "description": "Point local dev servers at your own TLS cert pair (env.devCerts) — the gateway AND every app behind it",
867
+ "arguments": [],
868
+ "options": [
869
+ {
870
+ "flags": "-d, --dir <path>",
871
+ "description": "Directory holding cert.pem + key.pem",
872
+ "required": false
873
+ },
874
+ {
875
+ "flags": "-c, --cert <path>",
876
+ "description": "Certificate file",
877
+ "required": false
878
+ },
879
+ {
880
+ "flags": "-k, --key <path>",
881
+ "description": "Private key file",
882
+ "required": false
883
+ },
884
+ {
885
+ "flags": "--clear",
886
+ "description": "Remove the setting and fall back to the SDK-tracked SAN pair",
887
+ "required": false
888
+ }
889
+ ],
890
+ "runbookAnchor": null
891
+ },
892
+ {
893
+ "verbPath": "config set-env",
894
+ "description": "Set target environment persistently (updates workspace.json, auto-reconnects)",
895
+ "arguments": [
896
+ {
897
+ "name": "env",
898
+ "required": true,
899
+ "variadic": false,
900
+ "description": "Environment: dev, demo, prod, or custom name"
901
+ }
902
+ ],
903
+ "options": [
904
+ {
905
+ "flags": "-u, --url <url>",
906
+ "description": "API URL override (for custom environments)",
907
+ "required": false
908
+ }
909
+ ],
910
+ "runbookAnchor": null
911
+ },
912
+ {
913
+ "verbPath": "config set-gateway-port",
914
+ "description": "Set the port `descix serve` listens on (env.gateway.port)",
915
+ "arguments": [
916
+ {
917
+ "name": "port",
918
+ "required": true,
919
+ "variadic": false,
920
+ "description": "Port number 1-65535, or \"none\" to remove"
921
+ }
922
+ ],
923
+ "options": [],
924
+ "runbookAnchor": null
925
+ },
926
+ {
927
+ "verbPath": "config set-powch-url",
928
+ "description": "Set where Powch lives (env.powchUrl) — its OWN origin; Powch is cross-origin from the shell by design",
929
+ "arguments": [
930
+ {
931
+ "name": "url",
932
+ "required": true,
933
+ "variadic": false,
934
+ "description": "Powch origin (e.g. https://powch.dev.descix.net), or \"none\" to remove"
935
+ }
936
+ ],
937
+ "options": [],
938
+ "runbookAnchor": null
939
+ },
940
+ {
941
+ "verbPath": "config set-site-url",
942
+ "description": "Set the App Shell origin `descix serve` proxies / to (env.siteUrl)",
943
+ "arguments": [
944
+ {
945
+ "name": "url",
946
+ "required": true,
947
+ "variadic": false,
948
+ "description": "App Shell origin, or \"none\" to remove"
949
+ }
950
+ ],
951
+ "options": [],
952
+ "runbookAnchor": null
953
+ },
954
+ {
955
+ "verbPath": "config show",
956
+ "description": "Show current configuration",
957
+ "arguments": [],
958
+ "options": [],
959
+ "runbookAnchor": "#_3-pin-production-then-sign-in"
960
+ },
961
+ {
962
+ "verbPath": "credits balance",
963
+ "description": "Show your AI-credits balance",
964
+ "arguments": [],
965
+ "options": [],
966
+ "runbookAnchor": null
967
+ },
968
+ {
969
+ "verbPath": "credits buy",
970
+ "description": "Buy AI credits: starts a Powch checkout and prints its Stripe Checkout URL (the Powch Buy menu is the same purchase)",
971
+ "arguments": [],
972
+ "options": [
973
+ {
974
+ "flags": "--usd <amount>",
975
+ "description": "USD amount of credits to buy: a listed bundle (`descix credits balance` lists them)",
976
+ "required": true
977
+ }
978
+ ],
979
+ "runbookAnchor": null
980
+ },
981
+ {
982
+ "verbPath": "credits grant",
983
+ "description": "Grant AI credits to a user",
984
+ "arguments": [],
985
+ "options": [
986
+ {
987
+ "flags": "--user <user_id>",
988
+ "description": "Target user id",
989
+ "required": true
990
+ },
991
+ {
992
+ "flags": "--usd <amount>",
993
+ "description": "USD amount to grant",
994
+ "required": true
995
+ },
996
+ {
997
+ "flags": "--reason <text>",
998
+ "description": "Audit reason",
999
+ "required": true
1000
+ }
1001
+ ],
1002
+ "runbookAnchor": null
1003
+ },
1004
+ {
1005
+ "verbPath": "credits history",
1006
+ "description": "Show your credit ledger (purchases, debits, grants)",
1007
+ "arguments": [],
1008
+ "options": [
1009
+ {
1010
+ "flags": "--limit <n>",
1011
+ "description": "Max entries (default 50)",
1012
+ "required": false
1013
+ }
1014
+ ],
1015
+ "runbookAnchor": null
1016
+ },
1017
+ {
1018
+ "verbPath": "credits refund",
1019
+ "description": "Remove AI credits from a user (e.g. after a Stripe refund)",
1020
+ "arguments": [],
1021
+ "options": [
1022
+ {
1023
+ "flags": "--user <user_id>",
1024
+ "description": "Target user id",
1025
+ "required": true
1026
+ },
1027
+ {
1028
+ "flags": "--usd <amount>",
1029
+ "description": "USD amount to remove",
1030
+ "required": true
1031
+ },
1032
+ {
1033
+ "flags": "--reason <text>",
1034
+ "description": "Audit reason",
1035
+ "required": true
1036
+ }
1037
+ ],
1038
+ "runbookAnchor": null
1039
+ },
1040
+ {
1041
+ "verbPath": "dev-certs check",
1042
+ "description": "Check whether the dev-server cert is trusted for https://localhost (exit 0 only when trusted)",
1043
+ "arguments": [],
1044
+ "options": [
1045
+ {
1046
+ "flags": "--json",
1047
+ "description": "Output raw JSON",
1048
+ "required": false
1049
+ }
1050
+ ],
1051
+ "runbookAnchor": "#_5-run-it-locally-descix-serve"
1052
+ },
1053
+ {
1054
+ "verbPath": "dev-certs trust",
1055
+ "description": "Trust the dev-server cert in the macOS keychain (prompts for your password)",
1056
+ "arguments": [],
1057
+ "options": [],
1058
+ "runbookAnchor": "#_5-run-it-locally-descix-serve"
1059
+ },
1060
+ {
1061
+ "verbPath": "doctor",
1062
+ "description": "Diagnose environment issues (Node, Auth, gcloud, ADC)",
1063
+ "arguments": [],
1064
+ "options": [],
1065
+ "runbookAnchor": "#_3-pin-production-then-sign-in"
1066
+ },
1067
+ {
1068
+ "verbPath": "drive pull",
1069
+ "description": "Pull content from Drive and convert to local markdown",
1070
+ "arguments": [],
1071
+ "options": [
1072
+ {
1073
+ "flags": "-c, --community <id>",
1074
+ "description": "Community ID",
1075
+ "required": false
1076
+ },
1077
+ {
1078
+ "flags": "-a, --app <id>",
1079
+ "description": "App ID",
1080
+ "required": false
1081
+ },
1082
+ {
1083
+ "flags": "-k, --kb <id>",
1084
+ "description": "Knowledge Base ID (default: General)",
1085
+ "required": false
1086
+ },
1087
+ {
1088
+ "flags": "--folder <id_or_url>",
1089
+ "description": "Override Drive folder (raw ID or full Drive URL) — one-time import without modifying workspace.json",
1090
+ "required": false
1091
+ },
1092
+ {
1093
+ "flags": "-v, --verbose",
1094
+ "description": "Show verbose output",
1095
+ "required": false
1096
+ },
1097
+ {
1098
+ "flags": "--merge-mode <mode>",
1099
+ "description": "Merge mode: merge|overwrite|force-overwrite (default: merge)",
1100
+ "required": false
1101
+ },
1102
+ {
1103
+ "flags": "--dry-run",
1104
+ "description": "Show what would happen without making changes",
1105
+ "required": false
1106
+ }
1107
+ ],
1108
+ "runbookAnchor": null
1109
+ },
1110
+ {
1111
+ "verbPath": "drive push",
1112
+ "description": "Push staging files to Drive",
1113
+ "arguments": [],
1114
+ "options": [
1115
+ {
1116
+ "flags": "-c, --community <id>",
1117
+ "description": "Community ID",
1118
+ "required": false
1119
+ },
1120
+ {
1121
+ "flags": "-a, --app <id>",
1122
+ "description": "App ID",
1123
+ "required": false
1124
+ },
1125
+ {
1126
+ "flags": "-k, --kb <id>",
1127
+ "description": "Knowledge Base ID (default: General)",
1128
+ "required": false
1129
+ },
1130
+ {
1131
+ "flags": "-v, --verbose",
1132
+ "description": "Show verbose output",
1133
+ "required": false
1134
+ },
1135
+ {
1136
+ "flags": "-i, --interactive",
1137
+ "description": "Enable interactive prompts for conflicts",
1138
+ "required": false
1139
+ },
1140
+ {
1141
+ "flags": "--on-conflict <action>",
1142
+ "description": "Conflict handling: overwrite|skip (default: overwrite)",
1143
+ "required": false
1144
+ },
1145
+ {
1146
+ "flags": "--no-move",
1147
+ "description": "Do not move files to .processed after upload",
1148
+ "required": false
1149
+ },
1150
+ {
1151
+ "flags": "--dry-run",
1152
+ "description": "Show what would happen without making changes",
1153
+ "required": false
1154
+ }
1155
+ ],
1156
+ "runbookAnchor": null
1157
+ },
1158
+ {
1159
+ "verbPath": "health",
1160
+ "description": "Check platform service health (env-aware: local-port in DEV, gcloud+HTTPS in DEMO/PROD)",
1161
+ "arguments": [],
1162
+ "options": [
1163
+ {
1164
+ "flags": "--env <name>",
1165
+ "description": "Target environment: dev|demo|prod (default: dev). Also accepted at top level: descix --env=demo health ...",
1166
+ "required": false
1167
+ },
1168
+ {
1169
+ "flags": "-m, --microservice <name>",
1170
+ "description": "Check a specific service/app by appId",
1171
+ "required": false
1172
+ },
1173
+ {
1174
+ "flags": "-j, --json",
1175
+ "description": "Output raw JSON",
1176
+ "required": false
1177
+ }
1178
+ ],
1179
+ "runbookAnchor": null
1180
+ },
1181
+ {
1182
+ "verbPath": "init",
1183
+ "description": "Initialize workspace for DeSciX app development (Git-aware)",
1184
+ "arguments": [],
1185
+ "options": [
1186
+ {
1187
+ "flags": "-c, --community <id>",
1188
+ "description": "Community ID",
1189
+ "required": false
1190
+ },
1191
+ {
1192
+ "flags": "-a, --app <name>",
1193
+ "description": "App name",
1194
+ "required": false
1195
+ },
1196
+ {
1197
+ "flags": "-p, --path <path>",
1198
+ "description": "Project path (defaults to current directory)",
1199
+ "required": false
1200
+ },
1201
+ {
1202
+ "flags": "-f, --force",
1203
+ "description": "Restart the app registrations in an existing workspace (its environment settings are kept)",
1204
+ "required": false
1205
+ },
1206
+ {
1207
+ "flags": "-y, --yes",
1208
+ "description": "Skip the confirmation — with -c and -a, init runs without a terminal",
1209
+ "required": false
1210
+ },
1211
+ {
1212
+ "flags": "--from-invite <token>",
1213
+ "description": "Resolve an invite token to pre-fill app context",
1214
+ "required": false
1215
+ }
1216
+ ],
1217
+ "runbookAnchor": null
1218
+ },
1219
+ {
1220
+ "verbPath": "kb clear-override-model",
1221
+ "description": "Delete KB.kb_model_override via FieldValue.delete() (resets to App.default_app_model inheritance)",
1222
+ "arguments": [],
1223
+ "options": [
1224
+ {
1225
+ "flags": "-a, --app <app_id>",
1226
+ "description": "App ID",
1227
+ "required": true
1228
+ },
1229
+ {
1230
+ "flags": "-k, --kb <kb_name>",
1231
+ "description": "KB name",
1232
+ "required": true
1233
+ }
1234
+ ],
1235
+ "runbookAnchor": null
1236
+ },
1237
+ {
1238
+ "verbPath": "kb corpus status",
1239
+ "description": "Show corpus sync state (files, chunks, last sync, resolved ref)",
1240
+ "arguments": [],
1241
+ "options": [
1242
+ {
1243
+ "flags": "-a, --app <id>",
1244
+ "description": "App ID",
1245
+ "required": true
1246
+ },
1247
+ {
1248
+ "flags": "-k, --kb <name>",
1249
+ "description": "KB name (default: all)",
1250
+ "required": false
1251
+ },
1252
+ {
1253
+ "flags": "--ref <ref>",
1254
+ "description": "Preview status as if --ref were applied to a sync (does not change manifests)",
1255
+ "required": false
1256
+ },
1257
+ {
1258
+ "flags": "-v, --verbose",
1259
+ "description": "Show verbose output including change detection",
1260
+ "required": false
1261
+ }
1262
+ ],
1263
+ "runbookAnchor": "#_6-knowledge-bases"
1264
+ },
1265
+ {
1266
+ "verbPath": "kb corpus sync",
1267
+ "description": "Sync the files a corpus manifest names into the app's knowledge base",
1268
+ "arguments": [],
1269
+ "options": [
1270
+ {
1271
+ "flags": "-a, --app <id>",
1272
+ "description": "App ID",
1273
+ "required": true
1274
+ },
1275
+ {
1276
+ "flags": "-c, --community <community_id>",
1277
+ "description": "Community ID (optional; resolved from Products when omitted)",
1278
+ "required": false
1279
+ },
1280
+ {
1281
+ "flags": "-k, --kb <name>",
1282
+ "description": "KB name (syncs specific manifest; default: all)",
1283
+ "required": false
1284
+ },
1285
+ {
1286
+ "flags": "-v, --verbose",
1287
+ "description": "Show verbose output",
1288
+ "required": false
1289
+ },
1290
+ {
1291
+ "flags": "--ref <ref>",
1292
+ "description": "Override the git ref for ALL manifest sources (e.g., --ref my-feature-branch). Precedence: --ref > manifest source.ref > \"main\".",
1293
+ "required": false
1294
+ },
1295
+ {
1296
+ "flags": "--rebuild",
1297
+ "description": "Delete EVERYTHING in the knowledge base, then re-sync the whole corpus. Not needed to remove deleted or changed files — an ordinary sync already removes any corpus file that is live in the knowledge base but no longer in the corpus (see --dry-run, which names them). Use --rebuild only to clear content an ordinary sync cannot see. Prompts before deleting unless --yes is supplied.",
1298
+ "required": false
1299
+ },
1300
+ {
1301
+ "flags": "--dry-run",
1302
+ "description": "Show what a sync would add and remove — naming each file it would remove — without changing anything. Exit 0 if nothing would change, 1 if something would.",
1303
+ "required": false
1304
+ },
1305
+ {
1306
+ "flags": "--show-walk",
1307
+ "description": "Print the resolved ref and the first 50 files the manifest selects, before syncing anything. Useful for checking --ref and the manifest sources.",
1308
+ "required": false
1309
+ },
1310
+ {
1311
+ "flags": "--yes",
1312
+ "description": "Skip the interactive purge confirmation in --rebuild mode. Use in scripting/CI.",
1313
+ "required": false
1314
+ },
1315
+ {
1316
+ "flags": "--skip-retrieval-canary",
1317
+ "description": "Skip the post-sync check that a synced passage is actually searchable (a large sync can take several minutes to become searchable). Skipping saves one credit-metered query and up to ~25 s; the sync then reports success on upload alone. Leave the check on for anything user-facing.",
1318
+ "required": false
1319
+ }
1320
+ ],
1321
+ "runbookAnchor": "#_6-knowledge-bases"
1322
+ },
1323
+ {
1324
+ "verbPath": "kb delete",
1325
+ "description": "Delete a knowledge base registry doc (refuses a non-empty KB unless --force)",
1326
+ "arguments": [],
1327
+ "options": [
1328
+ {
1329
+ "flags": "-a, --app <app_id>",
1330
+ "description": "App ID",
1331
+ "required": true
1332
+ },
1333
+ {
1334
+ "flags": "-k, --kb <kb_name>",
1335
+ "description": "KB name",
1336
+ "required": true
1337
+ },
1338
+ {
1339
+ "flags": "--force",
1340
+ "description": "Purge the KB's live vectors and delete it even if non-empty. An empty KB deletes without this flag.",
1341
+ "required": false
1342
+ }
1343
+ ],
1344
+ "runbookAnchor": null
1345
+ },
1346
+ {
1347
+ "verbPath": "kb doctor",
1348
+ "description": "Check a KB against its last sync by FILE IDENTITY: live corpus files that were not walked (orphans) and walked files that are not live (missing)",
1349
+ "arguments": [],
1350
+ "options": [
1351
+ {
1352
+ "flags": "-a, --app <id>",
1353
+ "description": "App ID",
1354
+ "required": true
1355
+ },
1356
+ {
1357
+ "flags": "-k, --kb <name>",
1358
+ "description": "KB name",
1359
+ "required": true
1360
+ },
1361
+ {
1362
+ "flags": "--live",
1363
+ "description": "Compute vectorCount from the TRUE live Pinecone scope (bypass the cached counter, which lies after an interrupted op)",
1364
+ "required": false
1365
+ },
1366
+ {
1367
+ "flags": "--reconcile",
1368
+ "description": "Compute the live count AND write it back to rag_vector_count so the cached read is truthful again (implies --live)",
1369
+ "required": false
1370
+ }
1371
+ ],
1372
+ "runbookAnchor": null
1373
+ },
1374
+ {
1375
+ "verbPath": "kb list",
1376
+ "description": "List knowledge bases for an app",
1377
+ "arguments": [],
1378
+ "options": [
1379
+ {
1380
+ "flags": "-a, --app <app_id>",
1381
+ "description": "App ID",
1382
+ "required": true
1383
+ },
1384
+ {
1385
+ "flags": "--cached",
1386
+ "description": "Show the fast cached vector counter instead of the TRUE live Pinecone count. The cached counter is written ONLY by the CLI/PWA sync path, so it reports 0 for KBs ingested by any other route even when their vectors retrieve. Default is the live count.",
1387
+ "required": false
1388
+ }
1389
+ ],
1390
+ "runbookAnchor": "#_6-knowledge-bases"
1391
+ },
1392
+ {
1393
+ "verbPath": "kb set-override-model",
1394
+ "description": "Set KB.kb_model_override (per-KB model selection)",
1395
+ "arguments": [],
1396
+ "options": [
1397
+ {
1398
+ "flags": "-a, --app <app_id>",
1399
+ "description": "App ID",
1400
+ "required": true
1401
+ },
1402
+ {
1403
+ "flags": "-k, --kb <kb_name>",
1404
+ "description": "KB name",
1405
+ "required": true
1406
+ },
1407
+ {
1408
+ "flags": "-m, --model <model_name>",
1409
+ "description": "Model name (e.g. gemini-3.8-flash)",
1410
+ "required": true
1411
+ }
1412
+ ],
1413
+ "runbookAnchor": null
1414
+ },
1415
+ {
1416
+ "verbPath": "login",
1417
+ "description": "Authenticate with DeSciX via device login (opens browser)",
1418
+ "arguments": [],
1419
+ "options": [
1420
+ {
1421
+ "flags": "-u, --url <url>",
1422
+ "description": "API URL override",
1423
+ "required": false
1424
+ },
1425
+ {
1426
+ "flags": "--wallet",
1427
+ "description": "Use direct wallet connection (advanced, not yet implemented)",
1428
+ "required": false
1429
+ },
1430
+ {
1431
+ "flags": "--no-oauth",
1432
+ "description": "Skip the OAuth long-lived token leg (wallet-signature login only)",
1433
+ "required": false
1434
+ },
1435
+ {
1436
+ "flags": "--scope <scope>",
1437
+ "description": "OAuth scope to request (default: mcp:read mcp:tools mcp:write mcp:admin)",
1438
+ "required": false
1439
+ }
1440
+ ],
1441
+ "runbookAnchor": "#_3-pin-production-then-sign-in"
1442
+ },
1443
+ {
1444
+ "verbPath": "logout",
1445
+ "description": "Clear saved credentials",
1446
+ "arguments": [],
1447
+ "options": [],
1448
+ "runbookAnchor": "#_3-pin-production-then-sign-in"
1449
+ },
1450
+ {
1451
+ "verbPath": "mcp execute",
1452
+ "description": "Execute a registered MCP tool by name with JSON parameters",
1453
+ "arguments": [],
1454
+ "options": [
1455
+ {
1456
+ "flags": "--tool <name>",
1457
+ "description": "Tool/command name (e.g., find_communities, ask_question_to_app)",
1458
+ "required": true
1459
+ },
1460
+ {
1461
+ "flags": "--params <json>",
1462
+ "description": "JSON parameters for the tool",
1463
+ "required": false
1464
+ },
1465
+ {
1466
+ "flags": "-a, --app <app_id>",
1467
+ "description": "App context (sets app_id in params if not already present)",
1468
+ "required": false
1469
+ },
1470
+ {
1471
+ "flags": "--json",
1472
+ "description": "Output raw JSON response",
1473
+ "required": false
1474
+ }
1475
+ ],
1476
+ "runbookAnchor": null
1477
+ },
1478
+ {
1479
+ "verbPath": "mcp-serve",
1480
+ "description": "Start MCP server for Cursor/VS Code integration (used by npx)",
1481
+ "arguments": [],
1482
+ "options": [],
1483
+ "runbookAnchor": null
1484
+ },
1485
+ {
1486
+ "verbPath": "microservice health",
1487
+ "description": "Check health of a registered microservice",
1488
+ "arguments": [
1489
+ {
1490
+ "name": "name",
1491
+ "required": true,
1492
+ "variadic": false,
1493
+ "description": ""
1494
+ }
1495
+ ],
1496
+ "options": [],
1497
+ "runbookAnchor": null
1498
+ },
1499
+ {
1500
+ "verbPath": "microservice init",
1501
+ "description": "Initialize microservice scaffold in current app",
1502
+ "arguments": [],
1503
+ "options": [
1504
+ {
1505
+ "flags": "-f, --force",
1506
+ "description": "Overwrite existing microservice/ folder",
1507
+ "required": false
1508
+ },
1509
+ {
1510
+ "flags": "-c, --community <id>",
1511
+ "description": "Community ID (auto-detects from context)",
1512
+ "required": false
1513
+ },
1514
+ {
1515
+ "flags": "-a, --app <id>",
1516
+ "description": "App ID (auto-detects from context)",
1517
+ "required": false
1518
+ }
1519
+ ],
1520
+ "runbookAnchor": null
1521
+ },
1522
+ {
1523
+ "verbPath": "microservice list",
1524
+ "description": "List all registered microservices",
1525
+ "arguments": [],
1526
+ "options": [],
1527
+ "runbookAnchor": null
1528
+ },
1529
+ {
1530
+ "verbPath": "microservice register",
1531
+ "description": "Register microservice with gateway (-r <local SERVICE_README>; git-mode only — no Drive)",
1532
+ "arguments": [],
1533
+ "options": [
1534
+ {
1535
+ "flags": "-m, --manifest <path>",
1536
+ "description": "Path to manifest.json",
1537
+ "required": false
1538
+ },
1539
+ {
1540
+ "flags": "-r, --readme <path>",
1541
+ "description": "Path to local SERVICE_README file",
1542
+ "required": false
1543
+ },
1544
+ {
1545
+ "flags": "-c, --community <id>",
1546
+ "description": "Community ID (auto-detects from context)",
1547
+ "required": false
1548
+ },
1549
+ {
1550
+ "flags": "-a, --app <id>",
1551
+ "description": "App ID (auto-detects from context)",
1552
+ "required": false
1553
+ },
1554
+ {
1555
+ "flags": "--skip-readme-check",
1556
+ "description": "Skip SERVICE_README check (not recommended)",
1557
+ "required": false
1558
+ }
1559
+ ],
1560
+ "runbookAnchor": null
1561
+ },
1562
+ {
1563
+ "verbPath": "microservice reload",
1564
+ "description": "Reload microservice manifests",
1565
+ "arguments": [],
1566
+ "options": [],
1567
+ "runbookAnchor": null
1568
+ },
1569
+ {
1570
+ "verbPath": "microservice restart",
1571
+ "description": "Restart a local microservice (DEV only; DEMO/PROD use deploy scripts)",
1572
+ "arguments": [
1573
+ {
1574
+ "name": "name",
1575
+ "required": true,
1576
+ "variadic": false,
1577
+ "description": ""
1578
+ }
1579
+ ],
1580
+ "options": [
1581
+ {
1582
+ "flags": "--env <env>",
1583
+ "description": "Target environment: dev | demo | prod",
1584
+ "required": false
1585
+ }
1586
+ ],
1587
+ "runbookAnchor": null
1588
+ },
1589
+ {
1590
+ "verbPath": "microservice vectorize",
1591
+ "description": "Vectorize SERVICE_README for tell_me_how discovery",
1592
+ "arguments": [],
1593
+ "options": [
1594
+ {
1595
+ "flags": "-n, --name <name>",
1596
+ "description": "Service name (reads from manifest.json if not provided)",
1597
+ "required": false
1598
+ },
1599
+ {
1600
+ "flags": "-c, --community <id>",
1601
+ "description": "Community ID (auto-detects from context)",
1602
+ "required": false
1603
+ },
1604
+ {
1605
+ "flags": "-a, --app <id>",
1606
+ "description": "App ID (auto-detects from context)",
1607
+ "required": false
1608
+ },
1609
+ {
1610
+ "flags": "-r, --readme <path>",
1611
+ "description": "Path to SERVICE_README file",
1612
+ "required": false
1613
+ }
1614
+ ],
1615
+ "runbookAnchor": null
1616
+ },
1617
+ {
1618
+ "verbPath": "new-chat",
1619
+ "description": "Clear chat session for an app (start fresh conversation)",
1620
+ "arguments": [],
1621
+ "options": [
1622
+ {
1623
+ "flags": "-c, --community <id>",
1624
+ "description": "Community ID (optional; clears only that community key)",
1625
+ "required": false
1626
+ },
1627
+ {
1628
+ "flags": "-a, --app <id>",
1629
+ "description": "App ID (required)",
1630
+ "required": false
1631
+ }
1632
+ ],
1633
+ "runbookAnchor": null
1634
+ },
1635
+ {
1636
+ "verbPath": "purchases",
1637
+ "description": "List your purchased communities and apps",
1638
+ "arguments": [],
1639
+ "options": [],
1640
+ "runbookAnchor": null
1641
+ },
1642
+ {
1643
+ "verbPath": "quickstart",
1644
+ "description": "One-command setup: sign in → workspace → app (with -c and -a) → agent files → MCP config",
1645
+ "arguments": [],
1646
+ "options": [
1647
+ {
1648
+ "flags": "-u, --url <url>",
1649
+ "description": "API URL override",
1650
+ "required": false
1651
+ },
1652
+ {
1653
+ "flags": "-c, --community <id>",
1654
+ "description": "Community to create the app in",
1655
+ "required": false
1656
+ },
1657
+ {
1658
+ "flags": "-a, --app <name>",
1659
+ "description": "Name of the app to create (the platform issues its id; see app init)",
1660
+ "required": false
1661
+ },
1662
+ {
1663
+ "flags": "-y, --yes",
1664
+ "description": "Skip the confirmation — with -c and -a, quickstart runs without a terminal",
1665
+ "required": false
1666
+ }
1667
+ ],
1668
+ "runbookAnchor": null
1669
+ },
1670
+ {
1671
+ "verbPath": "reconnect",
1672
+ "description": "Reconnect using saved wallet credentials",
1673
+ "arguments": [],
1674
+ "options": [],
1675
+ "runbookAnchor": null
1676
+ },
1677
+ {
1678
+ "verbPath": "referral create",
1679
+ "description": "Generate a referral code for a community/app",
1680
+ "arguments": [],
1681
+ "options": [
1682
+ {
1683
+ "flags": "-c, --community <id>",
1684
+ "description": "Community ID",
1685
+ "required": true
1686
+ },
1687
+ {
1688
+ "flags": "-a, --app <id>",
1689
+ "description": "App ID (optional)",
1690
+ "required": false
1691
+ }
1692
+ ],
1693
+ "runbookAnchor": null
1694
+ },
1695
+ {
1696
+ "verbPath": "role create",
1697
+ "description": "Create a new role",
1698
+ "arguments": [],
1699
+ "options": [
1700
+ {
1701
+ "flags": "--scope <scope>",
1702
+ "description": "Scope: PLATFORM, COMMUNITY, or APP",
1703
+ "required": true
1704
+ },
1705
+ {
1706
+ "flags": "--scope-id <id>",
1707
+ "description": "Scope ID (community_id or app_id)",
1708
+ "required": true
1709
+ },
1710
+ {
1711
+ "flags": "--role-id <id>",
1712
+ "description": "Role ID (e.g., \"member\", \"admin\")",
1713
+ "required": true
1714
+ },
1715
+ {
1716
+ "flags": "--name <name>",
1717
+ "description": "Role display name",
1718
+ "required": true
1719
+ },
1720
+ {
1721
+ "flags": "--description <text>",
1722
+ "description": "Role description",
1723
+ "required": false
1724
+ },
1725
+ {
1726
+ "flags": "--price-usdsci <amount>",
1727
+ "description": "Price in USDCX (default: 0 = free)",
1728
+ "required": false
1729
+ }
1730
+ ],
1731
+ "runbookAnchor": null
1732
+ },
1733
+ {
1734
+ "verbPath": "serve",
1735
+ "description": "Start the unified local gateway (one HTTPS origin: App Shell at /, your app at /p/<app>, /apifront to the API)",
1736
+ "arguments": [],
1737
+ "options": [
1738
+ {
1739
+ "flags": "-p, --port <port>",
1740
+ "description": "Gateway port for this run (default: env.gateway.port, else 5173)",
1741
+ "required": false
1742
+ },
1743
+ {
1744
+ "flags": "-w, --workspace <path>",
1745
+ "description": "Workspace root override",
1746
+ "required": false
1747
+ },
1748
+ {
1749
+ "flags": "--site-url <url>",
1750
+ "description": "App Shell target for this run (default: env.siteUrl, a local platform site, else the API origin)",
1751
+ "required": false
1752
+ },
1753
+ {
1754
+ "flags": "-a, --app <id>",
1755
+ "description": "App to serve standalone (default: detected from the directory you are standing in)",
1756
+ "required": false
1757
+ }
1758
+ ],
1759
+ "runbookAnchor": "#_5-run-it-locally-descix-serve"
1760
+ },
1761
+ {
1762
+ "verbPath": "site delete",
1763
+ "description": "Delete deployed site",
1764
+ "arguments": [],
1765
+ "options": [
1766
+ {
1767
+ "flags": "-c, --community <id>",
1768
+ "description": "Community ID (auto-detects from context)",
1769
+ "required": false
1770
+ },
1771
+ {
1772
+ "flags": "-a, --app <id>",
1773
+ "description": "App ID (auto-detects from context)",
1774
+ "required": false
1775
+ },
1776
+ {
1777
+ "flags": "--preview",
1778
+ "description": "Delete preview site only",
1779
+ "required": false
1780
+ },
1781
+ {
1782
+ "flags": "--confirm",
1783
+ "description": "Skip confirmation prompt",
1784
+ "required": false
1785
+ }
1786
+ ],
1787
+ "runbookAnchor": null
1788
+ },
1789
+ {
1790
+ "verbPath": "site init",
1791
+ "description": "Initialize site scaffold in current app",
1792
+ "arguments": [],
1793
+ "options": [
1794
+ {
1795
+ "flags": "-f, --force",
1796
+ "description": "Overwrite existing site/ folder",
1797
+ "required": false
1798
+ },
1799
+ {
1800
+ "flags": "-c, --community <id>",
1801
+ "description": "Community ID (auto-detects from context)",
1802
+ "required": false
1803
+ },
1804
+ {
1805
+ "flags": "-a, --app <id>",
1806
+ "description": "App ID (auto-detects from context)",
1807
+ "required": false
1808
+ }
1809
+ ],
1810
+ "runbookAnchor": null
1811
+ },
1812
+ {
1813
+ "verbPath": "site list",
1814
+ "description": "List deployed site files",
1815
+ "arguments": [],
1816
+ "options": [
1817
+ {
1818
+ "flags": "-c, --community <id>",
1819
+ "description": "Community ID (auto-detects from context)",
1820
+ "required": false
1821
+ },
1822
+ {
1823
+ "flags": "-a, --app <id>",
1824
+ "description": "App ID (auto-detects from context)",
1825
+ "required": false
1826
+ },
1827
+ {
1828
+ "flags": "--preview",
1829
+ "description": "List preview site",
1830
+ "required": false
1831
+ }
1832
+ ],
1833
+ "runbookAnchor": null
1834
+ },
1835
+ {
1836
+ "verbPath": "site status",
1837
+ "description": "Get deployment status and manifest",
1838
+ "arguments": [],
1839
+ "options": [
1840
+ {
1841
+ "flags": "-c, --community <id>",
1842
+ "description": "Community ID (auto-detects from context)",
1843
+ "required": false
1844
+ },
1845
+ {
1846
+ "flags": "-a, --app <id>",
1847
+ "description": "App ID (auto-detects from context)",
1848
+ "required": false
1849
+ },
1850
+ {
1851
+ "flags": "--preview",
1852
+ "description": "Check preview site",
1853
+ "required": false
1854
+ }
1855
+ ],
1856
+ "runbookAnchor": "#_8-deploy-the-site"
1857
+ },
1858
+ {
1859
+ "verbPath": "site upload",
1860
+ "description": "Upload site to GCS and update app metadata (uses .descix/manifests/site.json when present)",
1861
+ "arguments": [],
1862
+ "options": [
1863
+ {
1864
+ "flags": "-c, --community <id>",
1865
+ "description": "Community ID (auto-detects from context)",
1866
+ "required": false
1867
+ },
1868
+ {
1869
+ "flags": "-a, --app <id>",
1870
+ "description": "App ID (auto-detects from context; in a gateway workspace, the listed repo holding this app supplies the manifest and files)",
1871
+ "required": false
1872
+ },
1873
+ {
1874
+ "flags": "-p, --path <localPath>",
1875
+ "description": "Local directory to deploy (ignored when site manifest exists; in a gateway workspace only an explicit -p counts, and it uploads that directory for an app no listed repo holds)",
1876
+ "required": false
1877
+ },
1878
+ {
1879
+ "flags": "--preview",
1880
+ "description": "Deploy to preview path",
1881
+ "required": false
1882
+ },
1883
+ {
1884
+ "flags": "--dry-run",
1885
+ "description": "Show what would be uploaded and which server files would be removed",
1886
+ "required": false
1887
+ },
1888
+ {
1889
+ "flags": "--no-cache",
1890
+ "description": "Set Cache-Control: no-cache",
1891
+ "required": false
1892
+ }
1893
+ ],
1894
+ "runbookAnchor": "#_8-deploy-the-site"
1895
+ },
1896
+ {
1897
+ "verbPath": "stats",
1898
+ "description": "Get user stats (REP/REF/DIP) for a community",
1899
+ "arguments": [],
1900
+ "options": [
1901
+ {
1902
+ "flags": "-c, --community <id>",
1903
+ "description": "Community ID",
1904
+ "required": true
1905
+ }
1906
+ ],
1907
+ "runbookAnchor": null
1908
+ },
1909
+ {
1910
+ "verbPath": "status",
1911
+ "description": "Show comprehensive status of developer environment",
1912
+ "arguments": [],
1913
+ "options": [],
1914
+ "runbookAnchor": null
1915
+ },
1916
+ {
1917
+ "verbPath": "store generate-summary",
1918
+ "description": "Generate AI summary for an entity",
1919
+ "arguments": [],
1920
+ "options": [
1921
+ {
1922
+ "flags": "-t, --type <type>",
1923
+ "description": "Entity type (COMMUNITY, APP, KB, IPDOC)",
1924
+ "required": true
1925
+ },
1926
+ {
1927
+ "flags": "-i, --id <id>",
1928
+ "description": "Entity ID",
1929
+ "required": true
1930
+ },
1931
+ {
1932
+ "flags": "-c, --community <id>",
1933
+ "description": "Community ID (required for APP, KB, IPDOC)",
1934
+ "required": false
1935
+ },
1936
+ {
1937
+ "flags": "-a, --app <id>",
1938
+ "description": "App ID (required for KB, IPDOC)",
1939
+ "required": false
1940
+ },
1941
+ {
1942
+ "flags": "-k, --kb <id>",
1943
+ "description": "KB ID (required for IPDOC)",
1944
+ "required": false
1945
+ }
1946
+ ],
1947
+ "runbookAnchor": null
1948
+ },
1949
+ {
1950
+ "verbPath": "store search",
1951
+ "description": "Search store catalog (communities, apps, products, documents)",
1952
+ "arguments": [],
1953
+ "options": [
1954
+ {
1955
+ "flags": "-q, --query <text>",
1956
+ "description": "Search query",
1957
+ "required": false
1958
+ },
1959
+ {
1960
+ "flags": "-t, --type <types>",
1961
+ "description": "Entity types (comma-separated: COMMUNITY,APP,KB,IPDOC,ROLE)",
1962
+ "required": false
1963
+ },
1964
+ {
1965
+ "flags": "-c, --community <id>",
1966
+ "description": "Filter by community ID",
1967
+ "required": false
1968
+ },
1969
+ {
1970
+ "flags": "-a, --app <id>",
1971
+ "description": "Filter by app ID",
1972
+ "required": false
1973
+ },
1974
+ {
1975
+ "flags": "-k, --kb <id>",
1976
+ "description": "Filter by knowledge base ID",
1977
+ "required": false
1978
+ },
1979
+ {
1980
+ "flags": "--price-min <number>",
1981
+ "description": "Minimum price filter",
1982
+ "required": false
1983
+ },
1984
+ {
1985
+ "flags": "--price-max <number>",
1986
+ "description": "Maximum price filter",
1987
+ "required": false
1988
+ },
1989
+ {
1990
+ "flags": "--tags <tags>",
1991
+ "description": "Filter by tags (comma-separated)",
1992
+ "required": false
1993
+ },
1994
+ {
1995
+ "flags": "-l, --limit <number>",
1996
+ "description": "Number of results",
1997
+ "required": false
1998
+ },
1999
+ {
2000
+ "flags": "--offset <number>",
2001
+ "description": "Pagination offset",
2002
+ "required": false
2003
+ }
2004
+ ],
2005
+ "runbookAnchor": null
2006
+ },
2007
+ {
2008
+ "verbPath": "tell-me-how",
2009
+ "description": "Discover platform tools using natural language (Intelligent MCP Mesh)",
2010
+ "arguments": [
2011
+ {
2012
+ "name": "question",
2013
+ "required": true,
2014
+ "variadic": false,
2015
+ "description": "What do you want to accomplish? Use natural language."
2016
+ }
2017
+ ],
2018
+ "options": [
2019
+ {
2020
+ "flags": "-s, --scope <scope>",
2021
+ "description": "Search scope (validated against the published tell_me_how enum): bootstrap, artifact, project, entitlements (default), discovery",
2022
+ "required": false
2023
+ },
2024
+ {
2025
+ "flags": "-j, --json",
2026
+ "description": "Output raw JSON response",
2027
+ "required": false
2028
+ }
2029
+ ],
2030
+ "runbookAnchor": "#_9-list-it-and-discover-the-rest"
2031
+ },
2032
+ {
2033
+ "verbPath": "whoami",
2034
+ "description": "Show current authentication status",
2035
+ "arguments": [],
2036
+ "options": [],
2037
+ "runbookAnchor": "#_3-pin-production-then-sign-in"
2038
+ }
2039
+ ]