@proletariat/cli 0.3.110 → 0.3.111

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 (39) hide show
  1. package/dist/commands/orchestrator/attach.d.ts +2 -0
  2. package/dist/commands/orchestrator/attach.js +80 -118
  3. package/dist/commands/orchestrator/attach.js.map +1 -1
  4. package/dist/commands/orchestrator/start.js +21 -0
  5. package/dist/commands/orchestrator/start.js.map +1 -1
  6. package/dist/commands/orchestrator/status.d.ts +3 -0
  7. package/dist/commands/orchestrator/status.js +104 -130
  8. package/dist/commands/orchestrator/status.js.map +1 -1
  9. package/dist/commands/orchestrator/stop.d.ts +2 -0
  10. package/dist/commands/orchestrator/stop.js +105 -107
  11. package/dist/commands/orchestrator/stop.js.map +1 -1
  12. package/dist/commands/session/attach.d.ts +2 -6
  13. package/dist/commands/session/attach.js +68 -97
  14. package/dist/commands/session/attach.js.map +1 -1
  15. package/dist/commands/session/list.d.ts +4 -1
  16. package/dist/commands/session/list.js +160 -326
  17. package/dist/commands/session/list.js.map +1 -1
  18. package/dist/commands/work/start.js +104 -49
  19. package/dist/commands/work/start.js.map +1 -1
  20. package/dist/lib/execution/session-utils.d.ts +4 -1
  21. package/dist/lib/execution/session-utils.js +3 -0
  22. package/dist/lib/execution/session-utils.js.map +1 -1
  23. package/dist/lib/machine-db-mirror.d.ts +64 -0
  24. package/dist/lib/machine-db-mirror.js +82 -0
  25. package/dist/lib/machine-db-mirror.js.map +1 -0
  26. package/dist/lib/machine-db.d.ts +11 -0
  27. package/dist/lib/machine-db.js +17 -0
  28. package/dist/lib/machine-db.js.map +1 -1
  29. package/dist/lib/orchestrate/prompt-chain.d.ts +19 -4
  30. package/dist/lib/orchestrate/prompt-chain.js +19 -4
  31. package/dist/lib/orchestrate/prompt-chain.js.map +1 -1
  32. package/dist/lib/session/renderer.d.ts +121 -0
  33. package/dist/lib/session/renderer.js +547 -0
  34. package/dist/lib/session/renderer.js.map +1 -0
  35. package/dist/lib/update-check.d.ts +64 -7
  36. package/dist/lib/update-check.js +164 -20
  37. package/dist/lib/update-check.js.map +1 -1
  38. package/oclif.manifest.json +1194 -1083
  39. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -5300,6 +5300,205 @@
5300
5300
  "sync.js"
5301
5301
  ]
5302
5302
  },
5303
+ "orchestrate": {
5304
+ "aliases": [],
5305
+ "args": {},
5306
+ "description": "Start the autonomous pipeline daemon with event-driven hooks",
5307
+ "examples": [
5308
+ "<%= config.bin %> <%= command.id %>",
5309
+ "<%= config.bin %> <%= command.id %> --preset supervised",
5310
+ "<%= config.bin %> <%= command.id %> --load-yaml",
5311
+ "<%= config.bin %> <%= command.id %> --poll-interval 300",
5312
+ "<%= config.bin %> <%= command.id %> --once on_ci_green --pr 123"
5313
+ ],
5314
+ "flags": {
5315
+ "json": {
5316
+ "description": "Output as JSON for AI agents/scripts",
5317
+ "name": "json",
5318
+ "allowNo": false,
5319
+ "type": "boolean"
5320
+ },
5321
+ "machine": {
5322
+ "char": "m",
5323
+ "description": "Output as JSON for AI agents/scripts",
5324
+ "name": "machine",
5325
+ "allowNo": false,
5326
+ "type": "boolean"
5327
+ },
5328
+ "preset": {
5329
+ "description": "Apply a preset before starting (aggressive, conservative, supervised)",
5330
+ "name": "preset",
5331
+ "hasDynamicHelp": false,
5332
+ "multiple": false,
5333
+ "options": [
5334
+ "aggressive",
5335
+ "conservative",
5336
+ "supervised"
5337
+ ],
5338
+ "type": "option"
5339
+ },
5340
+ "load-yaml": {
5341
+ "description": "Load hooks from .proletariat/hooks.yml before starting",
5342
+ "name": "load-yaml",
5343
+ "allowNo": false,
5344
+ "type": "boolean"
5345
+ },
5346
+ "poll-interval": {
5347
+ "description": "Poll interval in seconds for external event sources (0 to disable)",
5348
+ "name": "poll-interval",
5349
+ "default": 0,
5350
+ "hasDynamicHelp": false,
5351
+ "multiple": false,
5352
+ "type": "option"
5353
+ },
5354
+ "once": {
5355
+ "description": "Fire a single event and exit (useful for CI/GitHub Actions)",
5356
+ "name": "once",
5357
+ "hasDynamicHelp": false,
5358
+ "multiple": false,
5359
+ "type": "option"
5360
+ },
5361
+ "ticket": {
5362
+ "char": "t",
5363
+ "description": "Ticket ID (for --once)",
5364
+ "name": "ticket",
5365
+ "hasDynamicHelp": false,
5366
+ "multiple": false,
5367
+ "type": "option"
5368
+ },
5369
+ "pr": {
5370
+ "description": "PR number (for --once)",
5371
+ "name": "pr",
5372
+ "hasDynamicHelp": false,
5373
+ "multiple": false,
5374
+ "type": "option"
5375
+ },
5376
+ "branch": {
5377
+ "description": "Branch name (for --once)",
5378
+ "name": "branch",
5379
+ "hasDynamicHelp": false,
5380
+ "multiple": false,
5381
+ "type": "option"
5382
+ },
5383
+ "agent": {
5384
+ "description": "Agent name (for --once)",
5385
+ "name": "agent",
5386
+ "hasDynamicHelp": false,
5387
+ "multiple": false,
5388
+ "type": "option"
5389
+ },
5390
+ "verbose": {
5391
+ "char": "v",
5392
+ "description": "Show detailed output",
5393
+ "name": "verbose",
5394
+ "allowNo": false,
5395
+ "type": "boolean"
5396
+ }
5397
+ },
5398
+ "hasDynamicHelp": false,
5399
+ "hiddenAliases": [],
5400
+ "id": "orchestrate",
5401
+ "pluginAlias": "@proletariat/cli",
5402
+ "pluginName": "@proletariat/cli",
5403
+ "pluginType": "core",
5404
+ "strict": true,
5405
+ "isESM": true,
5406
+ "relativePath": [
5407
+ "dist",
5408
+ "commands",
5409
+ "orchestrate",
5410
+ "index.js"
5411
+ ]
5412
+ },
5413
+ "orchestrate:machine": {
5414
+ "aliases": [],
5415
+ "args": {},
5416
+ "description": "Start the machine-level orchestrator — root supervisor for all agents across all repos",
5417
+ "examples": [
5418
+ "<%= config.bin %> <%= command.id %>",
5419
+ "<%= config.bin %> <%= command.id %> --prompt \"restart died agents, then assess all repos\"",
5420
+ "<%= config.bin %> <%= command.id %> --name supervisor",
5421
+ "<%= config.bin %> <%= command.id %> --background"
5422
+ ],
5423
+ "flags": {
5424
+ "prompt": {
5425
+ "char": "p",
5426
+ "description": "Initial instructions for the orchestrator",
5427
+ "name": "prompt",
5428
+ "hasDynamicHelp": false,
5429
+ "multiple": false,
5430
+ "type": "option"
5431
+ },
5432
+ "name": {
5433
+ "char": "n",
5434
+ "description": "Orchestrator name (default: machine-orchestrator)",
5435
+ "name": "name",
5436
+ "hasDynamicHelp": false,
5437
+ "multiple": false,
5438
+ "type": "option"
5439
+ },
5440
+ "background": {
5441
+ "char": "b",
5442
+ "description": "Start detached (reattach later with prlt session attach)",
5443
+ "exclusive": [
5444
+ "foreground"
5445
+ ],
5446
+ "name": "background",
5447
+ "allowNo": false,
5448
+ "type": "boolean"
5449
+ },
5450
+ "foreground": {
5451
+ "char": "f",
5452
+ "description": "Attach to the session in the current terminal (blocking)",
5453
+ "exclusive": [
5454
+ "background"
5455
+ ],
5456
+ "name": "foreground",
5457
+ "allowNo": false,
5458
+ "type": "boolean"
5459
+ },
5460
+ "executor": {
5461
+ "char": "e",
5462
+ "description": "AI executor to use",
5463
+ "name": "executor",
5464
+ "default": "claude-code",
5465
+ "hasDynamicHelp": false,
5466
+ "multiple": false,
5467
+ "options": [
5468
+ "claude-code",
5469
+ "codex"
5470
+ ],
5471
+ "type": "option"
5472
+ },
5473
+ "json": {
5474
+ "description": "Output as JSON for AI agents/scripts",
5475
+ "name": "json",
5476
+ "allowNo": false,
5477
+ "type": "boolean"
5478
+ },
5479
+ "machine": {
5480
+ "char": "m",
5481
+ "description": "Output as JSON for AI agents/scripts",
5482
+ "name": "machine",
5483
+ "allowNo": false,
5484
+ "type": "boolean"
5485
+ }
5486
+ },
5487
+ "hasDynamicHelp": false,
5488
+ "hiddenAliases": [],
5489
+ "id": "orchestrate:machine",
5490
+ "pluginAlias": "@proletariat/cli",
5491
+ "pluginName": "@proletariat/cli",
5492
+ "pluginType": "core",
5493
+ "strict": true,
5494
+ "isESM": true,
5495
+ "relativePath": [
5496
+ "dist",
5497
+ "commands",
5498
+ "orchestrate",
5499
+ "machine.js"
5500
+ ]
5501
+ },
5303
5502
  "notify:connect": {
5304
5503
  "aliases": [],
5305
5504
  "args": {
@@ -5575,16 +5774,14 @@
5575
5774
  "test.js"
5576
5775
  ]
5577
5776
  },
5578
- "orchestrate": {
5777
+ "orchestrator:attach": {
5579
5778
  "aliases": [],
5580
5779
  "args": {},
5581
- "description": "Start the autonomous pipeline daemon with event-driven hooks",
5780
+ "description": "Attach to the running orchestrator tmux session",
5582
5781
  "examples": [
5583
5782
  "<%= config.bin %> <%= command.id %>",
5584
- "<%= config.bin %> <%= command.id %> --preset supervised",
5585
- "<%= config.bin %> <%= command.id %> --load-yaml",
5586
- "<%= config.bin %> <%= command.id %> --poll-interval 300",
5587
- "<%= config.bin %> <%= command.id %> --once on_ci_green --pr 123"
5783
+ "<%= config.bin %> <%= command.id %> --new-tab",
5784
+ "<%= config.bin %> <%= command.id %> --new-tab --terminal Ghostty"
5588
5785
  ],
5589
5786
  "flags": {
5590
5787
  "json": {
@@ -5600,221 +5797,43 @@
5600
5797
  "allowNo": false,
5601
5798
  "type": "boolean"
5602
5799
  },
5603
- "preset": {
5604
- "description": "Apply a preset before starting (aggressive, conservative, supervised)",
5605
- "name": "preset",
5800
+ "name": {
5801
+ "char": "n",
5802
+ "description": "Name of the orchestrator to attach to (matches agentName)",
5803
+ "name": "name",
5606
5804
  "hasDynamicHelp": false,
5607
5805
  "multiple": false,
5608
- "options": [
5609
- "aggressive",
5610
- "conservative",
5611
- "supervised"
5612
- ],
5613
5806
  "type": "option"
5614
5807
  },
5615
- "load-yaml": {
5616
- "description": "Load hooks from .proletariat/hooks.yml before starting",
5617
- "name": "load-yaml",
5808
+ "here": {
5809
+ "description": "Filter to orchestrators in the current HQ only",
5810
+ "exclusive": [
5811
+ "hq"
5812
+ ],
5813
+ "name": "here",
5618
5814
  "allowNo": false,
5619
5815
  "type": "boolean"
5620
5816
  },
5621
- "poll-interval": {
5622
- "description": "Poll interval in seconds for external event sources (0 to disable)",
5623
- "name": "poll-interval",
5624
- "default": 0,
5817
+ "hq": {
5818
+ "description": "Filter to orchestrators in a specific HQ path",
5819
+ "exclusive": [
5820
+ "here"
5821
+ ],
5822
+ "name": "hq",
5625
5823
  "hasDynamicHelp": false,
5626
5824
  "multiple": false,
5627
5825
  "type": "option"
5628
5826
  },
5629
- "once": {
5630
- "description": "Fire a single event and exit (useful for CI/GitHub Actions)",
5631
- "name": "once",
5632
- "hasDynamicHelp": false,
5633
- "multiple": false,
5634
- "type": "option"
5827
+ "new-tab": {
5828
+ "description": "Open in a new terminal tab instead of attaching in the current terminal",
5829
+ "name": "new-tab",
5830
+ "allowNo": false,
5831
+ "type": "boolean"
5635
5832
  },
5636
- "ticket": {
5833
+ "terminal": {
5637
5834
  "char": "t",
5638
- "description": "Ticket ID (for --once)",
5639
- "name": "ticket",
5640
- "hasDynamicHelp": false,
5641
- "multiple": false,
5642
- "type": "option"
5643
- },
5644
- "pr": {
5645
- "description": "PR number (for --once)",
5646
- "name": "pr",
5647
- "hasDynamicHelp": false,
5648
- "multiple": false,
5649
- "type": "option"
5650
- },
5651
- "branch": {
5652
- "description": "Branch name (for --once)",
5653
- "name": "branch",
5654
- "hasDynamicHelp": false,
5655
- "multiple": false,
5656
- "type": "option"
5657
- },
5658
- "agent": {
5659
- "description": "Agent name (for --once)",
5660
- "name": "agent",
5661
- "hasDynamicHelp": false,
5662
- "multiple": false,
5663
- "type": "option"
5664
- },
5665
- "verbose": {
5666
- "char": "v",
5667
- "description": "Show detailed output",
5668
- "name": "verbose",
5669
- "allowNo": false,
5670
- "type": "boolean"
5671
- }
5672
- },
5673
- "hasDynamicHelp": false,
5674
- "hiddenAliases": [],
5675
- "id": "orchestrate",
5676
- "pluginAlias": "@proletariat/cli",
5677
- "pluginName": "@proletariat/cli",
5678
- "pluginType": "core",
5679
- "strict": true,
5680
- "isESM": true,
5681
- "relativePath": [
5682
- "dist",
5683
- "commands",
5684
- "orchestrate",
5685
- "index.js"
5686
- ]
5687
- },
5688
- "orchestrate:machine": {
5689
- "aliases": [],
5690
- "args": {},
5691
- "description": "Start the machine-level orchestrator — root supervisor for all agents across all repos",
5692
- "examples": [
5693
- "<%= config.bin %> <%= command.id %>",
5694
- "<%= config.bin %> <%= command.id %> --prompt \"restart died agents, then assess all repos\"",
5695
- "<%= config.bin %> <%= command.id %> --name supervisor",
5696
- "<%= config.bin %> <%= command.id %> --background"
5697
- ],
5698
- "flags": {
5699
- "prompt": {
5700
- "char": "p",
5701
- "description": "Initial instructions for the orchestrator",
5702
- "name": "prompt",
5703
- "hasDynamicHelp": false,
5704
- "multiple": false,
5705
- "type": "option"
5706
- },
5707
- "name": {
5708
- "char": "n",
5709
- "description": "Orchestrator name (default: machine-orchestrator)",
5710
- "name": "name",
5711
- "hasDynamicHelp": false,
5712
- "multiple": false,
5713
- "type": "option"
5714
- },
5715
- "background": {
5716
- "char": "b",
5717
- "description": "Start detached (reattach later with prlt session attach)",
5718
- "exclusive": [
5719
- "foreground"
5720
- ],
5721
- "name": "background",
5722
- "allowNo": false,
5723
- "type": "boolean"
5724
- },
5725
- "foreground": {
5726
- "char": "f",
5727
- "description": "Attach to the session in the current terminal (blocking)",
5728
- "exclusive": [
5729
- "background"
5730
- ],
5731
- "name": "foreground",
5732
- "allowNo": false,
5733
- "type": "boolean"
5734
- },
5735
- "executor": {
5736
- "char": "e",
5737
- "description": "AI executor to use",
5738
- "name": "executor",
5739
- "default": "claude-code",
5740
- "hasDynamicHelp": false,
5741
- "multiple": false,
5742
- "options": [
5743
- "claude-code",
5744
- "codex"
5745
- ],
5746
- "type": "option"
5747
- },
5748
- "json": {
5749
- "description": "Output as JSON for AI agents/scripts",
5750
- "name": "json",
5751
- "allowNo": false,
5752
- "type": "boolean"
5753
- },
5754
- "machine": {
5755
- "char": "m",
5756
- "description": "Output as JSON for AI agents/scripts",
5757
- "name": "machine",
5758
- "allowNo": false,
5759
- "type": "boolean"
5760
- }
5761
- },
5762
- "hasDynamicHelp": false,
5763
- "hiddenAliases": [],
5764
- "id": "orchestrate:machine",
5765
- "pluginAlias": "@proletariat/cli",
5766
- "pluginName": "@proletariat/cli",
5767
- "pluginType": "core",
5768
- "strict": true,
5769
- "isESM": true,
5770
- "relativePath": [
5771
- "dist",
5772
- "commands",
5773
- "orchestrate",
5774
- "machine.js"
5775
- ]
5776
- },
5777
- "orchestrator:attach": {
5778
- "aliases": [],
5779
- "args": {},
5780
- "description": "Attach to the running orchestrator tmux session",
5781
- "examples": [
5782
- "<%= config.bin %> <%= command.id %>",
5783
- "<%= config.bin %> <%= command.id %> --new-tab",
5784
- "<%= config.bin %> <%= command.id %> --new-tab --terminal Ghostty"
5785
- ],
5786
- "flags": {
5787
- "json": {
5788
- "description": "Output as JSON for AI agents/scripts",
5789
- "name": "json",
5790
- "allowNo": false,
5791
- "type": "boolean"
5792
- },
5793
- "machine": {
5794
- "char": "m",
5795
- "description": "Output as JSON for AI agents/scripts",
5796
- "name": "machine",
5797
- "allowNo": false,
5798
- "type": "boolean"
5799
- },
5800
- "name": {
5801
- "char": "n",
5802
- "description": "Name of the orchestrator session to attach to (default: main)",
5803
- "name": "name",
5804
- "hasDynamicHelp": false,
5805
- "multiple": false,
5806
- "type": "option"
5807
- },
5808
- "new-tab": {
5809
- "description": "Open in a new terminal tab instead of attaching in the current terminal",
5810
- "name": "new-tab",
5811
- "allowNo": false,
5812
- "type": "boolean"
5813
- },
5814
- "terminal": {
5815
- "char": "t",
5816
- "description": "Terminal app to use for new tab (iTerm, Terminal, Ghostty). Auto-detected if not specified.",
5817
- "name": "terminal",
5835
+ "description": "Terminal app to use for new tab (iTerm, Terminal, Ghostty). Auto-detected if not specified.",
5836
+ "name": "terminal",
5818
5837
  "hasDynamicHelp": false,
5819
5838
  "multiple": false,
5820
5839
  "type": "option"
@@ -6026,9 +6045,11 @@
6026
6045
  "orchestrator:status": {
6027
6046
  "aliases": [],
6028
6047
  "args": {},
6029
- "description": "Check if the orchestrator is running",
6048
+ "description": "Check orchestrator sessions across the entire machine, grouped by HQ.",
6030
6049
  "examples": [
6031
6050
  "<%= config.bin %> <%= command.id %>",
6051
+ "<%= config.bin %> <%= command.id %> --here",
6052
+ "<%= config.bin %> <%= command.id %> --hq ~/Projects/backend-hq",
6032
6053
  "<%= config.bin %> <%= command.id %> --peek",
6033
6054
  "<%= config.bin %> <%= command.id %> --peek --lines 50"
6034
6055
  ],
@@ -6048,14 +6069,33 @@
6048
6069
  },
6049
6070
  "name": {
6050
6071
  "char": "n",
6051
- "description": "Name of the orchestrator session to check (default: main)",
6072
+ "description": "Filter to a single orchestrator by name (matches agentName)",
6052
6073
  "name": "name",
6053
6074
  "hasDynamicHelp": false,
6054
6075
  "multiple": false,
6055
6076
  "type": "option"
6056
6077
  },
6078
+ "here": {
6079
+ "description": "Filter to orchestrators in the current HQ only",
6080
+ "exclusive": [
6081
+ "hq"
6082
+ ],
6083
+ "name": "here",
6084
+ "allowNo": false,
6085
+ "type": "boolean"
6086
+ },
6087
+ "hq": {
6088
+ "description": "Filter to orchestrators in a specific HQ path",
6089
+ "exclusive": [
6090
+ "here"
6091
+ ],
6092
+ "name": "hq",
6093
+ "hasDynamicHelp": false,
6094
+ "multiple": false,
6095
+ "type": "option"
6096
+ },
6057
6097
  "peek": {
6058
- "description": "Show recent output from the orchestrator",
6098
+ "description": "Show recent output from each orchestrator",
6059
6099
  "name": "peek",
6060
6100
  "allowNo": false,
6061
6101
  "type": "boolean"
@@ -6108,12 +6148,31 @@
6108
6148
  },
6109
6149
  "name": {
6110
6150
  "char": "n",
6111
- "description": "Name of the orchestrator session to stop (default: main)",
6151
+ "description": "Name of the orchestrator to stop (matches agentName)",
6112
6152
  "name": "name",
6113
6153
  "hasDynamicHelp": false,
6114
6154
  "multiple": false,
6115
6155
  "type": "option"
6116
6156
  },
6157
+ "here": {
6158
+ "description": "Filter to orchestrators in the current HQ only",
6159
+ "exclusive": [
6160
+ "hq"
6161
+ ],
6162
+ "name": "here",
6163
+ "allowNo": false,
6164
+ "type": "boolean"
6165
+ },
6166
+ "hq": {
6167
+ "description": "Filter to orchestrators in a specific HQ path",
6168
+ "exclusive": [
6169
+ "here"
6170
+ ],
6171
+ "name": "hq",
6172
+ "hasDynamicHelp": false,
6173
+ "multiple": false,
6174
+ "type": "option"
6175
+ },
6117
6176
  "force": {
6118
6177
  "char": "f",
6119
6178
  "description": "Skip confirmation",
@@ -7493,6 +7552,25 @@
7493
7552
  "hasDynamicHelp": false,
7494
7553
  "multiple": false,
7495
7554
  "type": "option"
7555
+ },
7556
+ "here": {
7557
+ "description": "Filter picker to sessions in the current HQ only",
7558
+ "exclusive": [
7559
+ "hq"
7560
+ ],
7561
+ "name": "here",
7562
+ "allowNo": false,
7563
+ "type": "boolean"
7564
+ },
7565
+ "hq": {
7566
+ "description": "Filter picker to sessions in a specific HQ path",
7567
+ "exclusive": [
7568
+ "here"
7569
+ ],
7570
+ "name": "hq",
7571
+ "hasDynamicHelp": false,
7572
+ "multiple": false,
7573
+ "type": "option"
7496
7574
  }
7497
7575
  },
7498
7576
  "hasDynamicHelp": false,
@@ -7869,11 +7947,13 @@
7869
7947
  "session:list": {
7870
7948
  "aliases": [],
7871
7949
  "args": {},
7872
- "description": "List active agent sessions (DB-first: shows tracked executions with runtime liveness)",
7950
+ "description": "List active agent sessions across the entire machine, grouped by current HQ vs other locations.",
7873
7951
  "examples": [
7874
7952
  "<%= config.bin %> <%= command.id %>",
7875
- "<%= config.bin %> <%= command.id %> --all",
7876
- "<%= config.bin %> <%= command.id %> --orphans"
7953
+ "<%= config.bin %> <%= command.id %> --here",
7954
+ "<%= config.bin %> <%= command.id %> --hq ~/Projects/backend-hq",
7955
+ "<%= config.bin %> <%= command.id %> --role orchestrator",
7956
+ "<%= config.bin %> <%= command.id %> --all"
7877
7957
  ],
7878
7958
  "flags": {
7879
7959
  "json": {
@@ -7889,16 +7969,47 @@
7889
7969
  "allowNo": false,
7890
7970
  "type": "boolean"
7891
7971
  },
7972
+ "here": {
7973
+ "description": "Filter to sessions in the current HQ only",
7974
+ "exclusive": [
7975
+ "hq"
7976
+ ],
7977
+ "name": "here",
7978
+ "allowNo": false,
7979
+ "type": "boolean"
7980
+ },
7981
+ "hq": {
7982
+ "description": "Filter to sessions in a specific HQ path",
7983
+ "exclusive": [
7984
+ "here"
7985
+ ],
7986
+ "name": "hq",
7987
+ "hasDynamicHelp": false,
7988
+ "multiple": false,
7989
+ "type": "option"
7990
+ },
7991
+ "role": {
7992
+ "description": "Filter by session role",
7993
+ "name": "role",
7994
+ "hasDynamicHelp": false,
7995
+ "multiple": false,
7996
+ "options": [
7997
+ "orchestrator",
7998
+ "worker",
7999
+ "headless"
8000
+ ],
8001
+ "type": "option"
8002
+ },
7892
8003
  "all": {
7893
8004
  "char": "a",
7894
- "description": "Show all sessions including stale DB records (dead runtime)",
8005
+ "description": "Include stopped/completed sessions (default excludes them)",
7895
8006
  "name": "all",
7896
8007
  "allowNo": false,
7897
8008
  "type": "boolean"
7898
8009
  },
7899
- "orphans": {
7900
- "description": "Also show orphan tmux sessions not tracked in the DB (garbage to prune)",
7901
- "name": "orphans",
8010
+ "grouped": {
8011
+ "description": "In --json mode, emit the grouped { sessions, grouped } object instead of the flat array",
8012
+ "name": "grouped",
7902
8013
  "allowNo": false,
7903
8014
  "type": "boolean"
7904
8015
  }
@@ -8626,14 +8737,23 @@
8626
8737
  "logs.js"
8627
8738
  ]
8628
8739
  },
8629
- "telemetry:disable": {
8740
+ "sync": {
8630
8741
  "aliases": [],
8631
8742
  "args": {},
8632
- "description": "Disable anonymous telemetry",
8743
+ "description": "Reconcile ticket state with GitHub PR status",
8633
8744
  "examples": [
8634
- "<%= config.bin %> <%= command.id %>"
8745
+ "<%= config.bin %> <%= command.id %>",
8746
+ "<%= config.bin %> <%= command.id %> --dry-run"
8635
8747
  ],
8636
8748
  "flags": {
8749
+ "project": {
8750
+ "char": "P",
8751
+ "description": "Project ID (uses first project if only one exists)",
8752
+ "name": "project",
8753
+ "hasDynamicHelp": false,
8754
+ "multiple": false,
8755
+ "type": "option"
8756
+ },
8637
8757
  "json": {
8638
8758
  "description": "Output as JSON for AI agents/scripts",
8639
8759
  "name": "json",
@@ -8646,28 +8766,33 @@
8646
8766
  "name": "machine",
8647
8767
  "allowNo": false,
8648
8768
  "type": "boolean"
8769
+ },
8770
+ "dry-run": {
8771
+ "description": "Show what would change without applying",
8772
+ "name": "dry-run",
8773
+ "allowNo": false,
8774
+ "type": "boolean"
8649
8775
  }
8650
8776
  },
8651
8777
  "hasDynamicHelp": false,
8652
8778
  "hiddenAliases": [],
8653
- "id": "telemetry:disable",
8779
+ "id": "sync",
8654
8780
  "pluginAlias": "@proletariat/cli",
8655
8781
  "pluginName": "@proletariat/cli",
8656
8782
  "pluginType": "core",
8657
8783
  "strict": true,
8658
- "enableJsonFlag": false,
8659
8784
  "isESM": true,
8660
8785
  "relativePath": [
8661
8786
  "dist",
8662
8787
  "commands",
8663
- "telemetry",
8664
- "disable.js"
8788
+ "sync",
8789
+ "index.js"
8665
8790
  ]
8666
8791
  },
8667
- "telemetry:enable": {
8792
+ "sync:pause": {
8668
8793
  "aliases": [],
8669
8794
  "args": {},
8670
- "description": "Enable anonymous telemetry",
8795
+ "description": "Pause the merge queue (keep monitoring but stop merging)",
8671
8796
  "examples": [
8672
8797
  "<%= config.bin %> <%= command.id %>"
8673
8798
  ],
@@ -8688,27 +8813,25 @@
8688
8813
  },
8689
8814
  "hasDynamicHelp": false,
8690
8815
  "hiddenAliases": [],
8691
- "id": "telemetry:enable",
8816
+ "id": "sync:pause",
8692
8817
  "pluginAlias": "@proletariat/cli",
8693
8818
  "pluginName": "@proletariat/cli",
8694
8819
  "pluginType": "core",
8695
8820
  "strict": true,
8696
- "enableJsonFlag": false,
8697
8821
  "isESM": true,
8698
8822
  "relativePath": [
8699
8823
  "dist",
8700
8824
  "commands",
8701
- "telemetry",
8702
- "enable.js"
8825
+ "sync",
8826
+ "pause.js"
8703
8827
  ]
8704
8828
  },
8705
- "telemetry": {
8829
+ "sync:queue": {
8706
8830
  "aliases": [],
8707
8831
  "args": {},
8708
- "description": "Show telemetry status",
8832
+ "description": "Show the merge queue state",
8709
8833
  "examples": [
8710
- "<%= config.bin %> <%= command.id %>",
8711
- "<%= config.bin %> <%= command.id %> --json"
8834
+ "<%= config.bin %> <%= command.id %>"
8712
8835
  ],
8713
8836
  "flags": {
8714
8837
  "json": {
@@ -8727,26 +8850,25 @@
8727
8850
  },
8728
8851
  "hasDynamicHelp": false,
8729
8852
  "hiddenAliases": [],
8730
- "id": "telemetry",
8853
+ "id": "sync:queue",
8731
8854
  "pluginAlias": "@proletariat/cli",
8732
8855
  "pluginName": "@proletariat/cli",
8733
8856
  "pluginType": "core",
8734
8857
  "strict": true,
8735
- "enableJsonFlag": false,
8736
8858
  "isESM": true,
8737
8859
  "relativePath": [
8738
8860
  "dist",
8739
8861
  "commands",
8740
- "telemetry",
8741
- "index.js"
8862
+ "sync",
8863
+ "queue.js"
8742
8864
  ]
8743
8865
  },
8744
- "telemetry:status": {
8866
+ "sync:resume": {
8745
8867
  "aliases": [],
8746
8868
  "args": {},
8747
- "description": "Show telemetry status",
8869
+ "description": "Resume the merge queue",
8748
8870
  "examples": [
8749
- "<%= config.bin %> telemetry status"
8871
+ "<%= config.bin %> <%= command.id %>"
8750
8872
  ],
8751
8873
  "flags": {
8752
8874
  "json": {
@@ -8765,37 +8887,28 @@
8765
8887
  },
8766
8888
  "hasDynamicHelp": false,
8767
8889
  "hiddenAliases": [],
8768
- "id": "telemetry:status",
8890
+ "id": "sync:resume",
8769
8891
  "pluginAlias": "@proletariat/cli",
8770
8892
  "pluginName": "@proletariat/cli",
8771
8893
  "pluginType": "core",
8772
8894
  "strict": true,
8773
- "enableJsonFlag": false,
8774
8895
  "isESM": true,
8775
8896
  "relativePath": [
8776
8897
  "dist",
8777
8898
  "commands",
8778
- "telemetry",
8779
- "status.js"
8899
+ "sync",
8900
+ "resume.js"
8780
8901
  ]
8781
8902
  },
8782
- "sync": {
8903
+ "sync:start": {
8783
8904
  "aliases": [],
8784
8905
  "args": {},
8785
- "description": "Reconcile ticket state with GitHub PR status",
8906
+ "description": "Start the board sync daemon",
8786
8907
  "examples": [
8787
8908
  "<%= config.bin %> <%= command.id %>",
8788
- "<%= config.bin %> <%= command.id %> --dry-run"
8909
+ "<%= config.bin %> <%= command.id %> --interval 30"
8789
8910
  ],
8790
8911
  "flags": {
8791
- "project": {
8792
- "char": "P",
8793
- "description": "Project ID (uses first project if only one exists)",
8794
- "name": "project",
8795
- "hasDynamicHelp": false,
8796
- "multiple": false,
8797
- "type": "option"
8798
- },
8799
8912
  "json": {
8800
8913
  "description": "Output as JSON for AI agents/scripts",
8801
8914
  "name": "json",
@@ -8809,16 +8922,19 @@
8809
8922
  "allowNo": false,
8810
8923
  "type": "boolean"
8811
8924
  },
8812
- "dry-run": {
8813
- "description": "Show what would change without applying",
8814
- "name": "dry-run",
8815
- "allowNo": false,
8816
- "type": "boolean"
8925
+ "interval": {
8926
+ "char": "i",
8927
+ "description": "Poll interval in seconds",
8928
+ "name": "interval",
8929
+ "default": 60,
8930
+ "hasDynamicHelp": false,
8931
+ "multiple": false,
8932
+ "type": "option"
8817
8933
  }
8818
8934
  },
8819
8935
  "hasDynamicHelp": false,
8820
8936
  "hiddenAliases": [],
8821
- "id": "sync",
8937
+ "id": "sync:start",
8822
8938
  "pluginAlias": "@proletariat/cli",
8823
8939
  "pluginName": "@proletariat/cli",
8824
8940
  "pluginType": "core",
@@ -8828,13 +8944,13 @@
8828
8944
  "dist",
8829
8945
  "commands",
8830
8946
  "sync",
8831
- "index.js"
8947
+ "start.js"
8832
8948
  ]
8833
8949
  },
8834
- "sync:pause": {
8950
+ "sync:status": {
8835
8951
  "aliases": [],
8836
8952
  "args": {},
8837
- "description": "Pause the merge queue (keep monitoring but stop merging)",
8953
+ "description": "Check the board sync daemon status",
8838
8954
  "examples": [
8839
8955
  "<%= config.bin %> <%= command.id %>"
8840
8956
  ],
@@ -8855,7 +8971,7 @@
8855
8971
  },
8856
8972
  "hasDynamicHelp": false,
8857
8973
  "hiddenAliases": [],
8858
- "id": "sync:pause",
8974
+ "id": "sync:status",
8859
8975
  "pluginAlias": "@proletariat/cli",
8860
8976
  "pluginName": "@proletariat/cli",
8861
8977
  "pluginType": "core",
@@ -8865,13 +8981,13 @@
8865
8981
  "dist",
8866
8982
  "commands",
8867
8983
  "sync",
8868
- "pause.js"
8984
+ "status.js"
8869
8985
  ]
8870
8986
  },
8871
- "sync:queue": {
8987
+ "sync:stop": {
8872
8988
  "aliases": [],
8873
8989
  "args": {},
8874
- "description": "Show the merge queue state",
8990
+ "description": "Stop the board sync daemon",
8875
8991
  "examples": [
8876
8992
  "<%= config.bin %> <%= command.id %>"
8877
8993
  ],
@@ -8892,7 +9008,7 @@
8892
9008
  },
8893
9009
  "hasDynamicHelp": false,
8894
9010
  "hiddenAliases": [],
8895
- "id": "sync:queue",
9011
+ "id": "sync:stop",
8896
9012
  "pluginAlias": "@proletariat/cli",
8897
9013
  "pluginName": "@proletariat/cli",
8898
9014
  "pluginType": "core",
@@ -8902,13 +9018,13 @@
8902
9018
  "dist",
8903
9019
  "commands",
8904
9020
  "sync",
8905
- "queue.js"
9021
+ "stop.js"
8906
9022
  ]
8907
9023
  },
8908
- "sync:resume": {
9024
+ "telemetry:disable": {
8909
9025
  "aliases": [],
8910
9026
  "args": {},
8911
- "description": "Resume the merge queue",
9027
+ "description": "Disable anonymous telemetry",
8912
9028
  "examples": [
8913
9029
  "<%= config.bin %> <%= command.id %>"
8914
9030
  ],
@@ -8929,26 +9045,26 @@
8929
9045
  },
8930
9046
  "hasDynamicHelp": false,
8931
9047
  "hiddenAliases": [],
8932
- "id": "sync:resume",
9048
+ "id": "telemetry:disable",
8933
9049
  "pluginAlias": "@proletariat/cli",
8934
9050
  "pluginName": "@proletariat/cli",
8935
9051
  "pluginType": "core",
8936
9052
  "strict": true,
9053
+ "enableJsonFlag": false,
8937
9054
  "isESM": true,
8938
9055
  "relativePath": [
8939
9056
  "dist",
8940
9057
  "commands",
8941
- "sync",
8942
- "resume.js"
9058
+ "telemetry",
9059
+ "disable.js"
8943
9060
  ]
8944
9061
  },
8945
- "sync:start": {
9062
+ "telemetry:enable": {
8946
9063
  "aliases": [],
8947
9064
  "args": {},
8948
- "description": "Start the board sync daemon",
9065
+ "description": "Enable anonymous telemetry",
8949
9066
  "examples": [
8950
- "<%= config.bin %> <%= command.id %>",
8951
- "<%= config.bin %> <%= command.id %> --interval 30"
9067
+ "<%= config.bin %> <%= command.id %>"
8952
9068
  ],
8953
9069
  "flags": {
8954
9070
  "json": {
@@ -8963,38 +9079,31 @@
8963
9079
  "name": "machine",
8964
9080
  "allowNo": false,
8965
9081
  "type": "boolean"
8966
- },
8967
- "interval": {
8968
- "char": "i",
8969
- "description": "Poll interval in seconds",
8970
- "name": "interval",
8971
- "default": 60,
8972
- "hasDynamicHelp": false,
8973
- "multiple": false,
8974
- "type": "option"
8975
9082
  }
8976
9083
  },
8977
9084
  "hasDynamicHelp": false,
8978
9085
  "hiddenAliases": [],
8979
- "id": "sync:start",
9086
+ "id": "telemetry:enable",
8980
9087
  "pluginAlias": "@proletariat/cli",
8981
9088
  "pluginName": "@proletariat/cli",
8982
9089
  "pluginType": "core",
8983
9090
  "strict": true,
9091
+ "enableJsonFlag": false,
8984
9092
  "isESM": true,
8985
9093
  "relativePath": [
8986
9094
  "dist",
8987
9095
  "commands",
8988
- "sync",
8989
- "start.js"
9096
+ "telemetry",
9097
+ "enable.js"
8990
9098
  ]
8991
9099
  },
8992
- "sync:status": {
9100
+ "telemetry": {
8993
9101
  "aliases": [],
8994
9102
  "args": {},
8995
- "description": "Check the board sync daemon status",
9103
+ "description": "Show telemetry status",
8996
9104
  "examples": [
8997
- "<%= config.bin %> <%= command.id %>"
9105
+ "<%= config.bin %> <%= command.id %>",
9106
+ "<%= config.bin %> <%= command.id %> --json"
8998
9107
  ],
8999
9108
  "flags": {
9000
9109
  "json": {
@@ -9013,25 +9122,26 @@
9013
9122
  },
9014
9123
  "hasDynamicHelp": false,
9015
9124
  "hiddenAliases": [],
9016
- "id": "sync:status",
9125
+ "id": "telemetry",
9017
9126
  "pluginAlias": "@proletariat/cli",
9018
9127
  "pluginName": "@proletariat/cli",
9019
9128
  "pluginType": "core",
9020
9129
  "strict": true,
9130
+ "enableJsonFlag": false,
9021
9131
  "isESM": true,
9022
9132
  "relativePath": [
9023
9133
  "dist",
9024
9134
  "commands",
9025
- "sync",
9026
- "status.js"
9135
+ "telemetry",
9136
+ "index.js"
9027
9137
  ]
9028
9138
  },
9029
- "sync:stop": {
9139
+ "telemetry:status": {
9030
9140
  "aliases": [],
9031
9141
  "args": {},
9032
- "description": "Stop the board sync daemon",
9142
+ "description": "Show telemetry status",
9033
9143
  "examples": [
9034
- "<%= config.bin %> <%= command.id %>"
9144
+ "<%= config.bin %> telemetry status"
9035
9145
  ],
9036
9146
  "flags": {
9037
9147
  "json": {
@@ -9050,17 +9160,18 @@
9050
9160
  },
9051
9161
  "hasDynamicHelp": false,
9052
9162
  "hiddenAliases": [],
9053
- "id": "sync:stop",
9163
+ "id": "telemetry:status",
9054
9164
  "pluginAlias": "@proletariat/cli",
9055
9165
  "pluginName": "@proletariat/cli",
9056
9166
  "pluginType": "core",
9057
9167
  "strict": true,
9168
+ "enableJsonFlag": false,
9058
9169
  "isESM": true,
9059
9170
  "relativePath": [
9060
9171
  "dist",
9061
9172
  "commands",
9062
- "sync",
9063
- "stop.js"
9173
+ "telemetry",
9174
+ "status.js"
9064
9175
  ]
9065
9176
  },
9066
9177
  "terminal:title": {
@@ -9116,72 +9227,32 @@
9116
9227
  "title.js"
9117
9228
  ]
9118
9229
  },
9119
- "theme:add-names": {
9230
+ "ticket:create": {
9120
9231
  "aliases": [],
9121
- "args": {
9122
- "theme": {
9123
- "description": "Theme ID",
9124
- "name": "theme",
9125
- "required": true
9126
- },
9127
- "names": {
9128
- "description": "Names to add to the theme (space-separated)",
9129
- "name": "names",
9130
- "required": false
9131
- }
9132
- },
9133
- "description": "Add names to a theme",
9232
+ "args": {},
9233
+ "description": "Create a new ticket (routes to Linear when configured, or local PMO)",
9134
9234
  "examples": [
9135
- "<%= config.bin %> <%= command.id %> greek-gods zeus athena poseidon",
9136
- "<%= config.bin %> <%= command.id %> my-theme agent-a agent-b"
9235
+ "<%= config.bin %> <%= command.id %>",
9236
+ "<%= config.bin %> <%= command.id %> --title \"Fix login bug\" --column Backlog",
9237
+ "<%= config.bin %> <%= command.id %> -t \"Add feature\" -c \"In Progress\" -p P1",
9238
+ "<%= config.bin %> <%= command.id %> --project mobile-app -t \"New feature\"",
9239
+ "<%= config.bin %> <%= command.id %> --epic EPIC-001 -t \"Implement auth flow\"",
9240
+ "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file ./ticket-desc.md",
9241
+ "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file - # Read from stdin",
9242
+ "<%= config.bin %> <%= command.id %> --json # Output column choices as JSON",
9243
+ "<%= config.bin %> <%= command.id %> --title \"Test\" -P PROJ-001 --dry-run --json # Validate without creating",
9244
+ "<%= config.bin %> <%= command.id %> --source linear -t \"Fix bug\" --team ENG",
9245
+ "<%= config.bin %> <%= command.id %> --source pmo -t \"Local task\" -c Backlog"
9137
9246
  ],
9138
9247
  "flags": {
9139
- "json": {
9140
- "description": "Output as JSON for AI agents/scripts",
9141
- "name": "json",
9142
- "allowNo": false,
9143
- "type": "boolean"
9248
+ "project": {
9249
+ "char": "P",
9250
+ "description": "Project ID (uses first project if only one exists)",
9251
+ "name": "project",
9252
+ "hasDynamicHelp": false,
9253
+ "multiple": false,
9254
+ "type": "option"
9144
9255
  },
9145
- "machine": {
9146
- "char": "m",
9147
- "description": "Output as JSON for AI agents/scripts",
9148
- "name": "machine",
9149
- "allowNo": false,
9150
- "type": "boolean"
9151
- }
9152
- },
9153
- "hasDynamicHelp": false,
9154
- "hiddenAliases": [],
9155
- "id": "theme:add-names",
9156
- "pluginAlias": "@proletariat/cli",
9157
- "pluginName": "@proletariat/cli",
9158
- "pluginType": "core",
9159
- "strict": false,
9160
- "enableJsonFlag": false,
9161
- "isESM": true,
9162
- "relativePath": [
9163
- "dist",
9164
- "commands",
9165
- "theme",
9166
- "add-names.js"
9167
- ]
9168
- },
9169
- "theme:create": {
9170
- "aliases": [],
9171
- "args": {
9172
- "name": {
9173
- "description": "Theme name (used as ID, lowercase with hyphens)",
9174
- "name": "name",
9175
- "required": true
9176
- }
9177
- },
9178
- "description": "Create a custom agent theme",
9179
- "examples": [
9180
- "<%= config.bin %> <%= command.id %> greek-gods",
9181
- "<%= config.bin %> <%= command.id %> greek-gods --description \"Mount Olympus crew\"",
9182
- "<%= config.bin %> <%= command.id %> greek-gods --display-name \"Greek Gods\""
9183
- ],
9184
- "flags": {
9185
9256
  "json": {
9186
9257
  "description": "Output as JSON for AI agents/scripts",
9187
9258
  "name": "json",
@@ -9195,130 +9266,165 @@
9195
9266
  "allowNo": false,
9196
9267
  "type": "boolean"
9197
9268
  },
9198
- "description": {
9199
- "char": "d",
9200
- "description": "Theme description",
9201
- "name": "description",
9269
+ "title": {
9270
+ "char": "t",
9271
+ "description": "Ticket title [required for non-interactive]",
9272
+ "name": "title",
9202
9273
  "hasDynamicHelp": false,
9203
9274
  "multiple": false,
9204
9275
  "type": "option"
9205
9276
  },
9206
- "display-name": {
9207
- "description": "Display name (defaults to formatted name)",
9208
- "name": "display-name",
9277
+ "column": {
9278
+ "char": "c",
9279
+ "description": "Column to place the ticket in",
9280
+ "name": "column",
9209
9281
  "hasDynamicHelp": false,
9210
9282
  "multiple": false,
9211
9283
  "type": "option"
9212
- }
9213
- },
9214
- "hasDynamicHelp": false,
9215
- "hiddenAliases": [],
9216
- "id": "theme:create",
9217
- "pluginAlias": "@proletariat/cli",
9218
- "pluginName": "@proletariat/cli",
9219
- "pluginType": "core",
9220
- "strict": true,
9221
- "enableJsonFlag": false,
9222
- "isESM": true,
9223
- "relativePath": [
9224
- "dist",
9225
- "commands",
9226
- "theme",
9227
- "create.js"
9228
- ]
9229
- },
9230
- "theme": {
9231
- "aliases": [],
9232
- "args": {},
9233
- "description": "Manage agent naming themes",
9234
- "examples": [
9235
- "<%= config.bin %> <%= command.id %> list",
9236
- "<%= config.bin %> <%= command.id %> create greek-gods",
9237
- "<%= config.bin %> <%= command.id %> add-names greek-gods zeus athena"
9238
- ],
9239
- "flags": {
9240
- "json": {
9241
- "description": "Output as JSON for AI agents/scripts",
9242
- "name": "json",
9243
- "allowNo": false,
9244
- "type": "boolean"
9245
9284
  },
9246
- "machine": {
9247
- "char": "m",
9248
- "description": "Output as JSON for AI agents/scripts",
9249
- "name": "machine",
9250
- "allowNo": false,
9251
- "type": "boolean"
9252
- }
9253
- },
9254
- "hasDynamicHelp": false,
9255
- "hiddenAliases": [],
9256
- "id": "theme",
9257
- "pluginAlias": "@proletariat/cli",
9258
- "pluginName": "@proletariat/cli",
9259
- "pluginType": "core",
9260
- "strict": true,
9261
- "isESM": true,
9262
- "relativePath": [
9263
- "dist",
9264
- "commands",
9265
- "theme",
9266
- "index.js"
9267
- ]
9268
- },
9269
- "theme:list": {
9270
- "aliases": [],
9271
- "args": {},
9272
- "description": "List available agent themes",
9273
- "examples": [
9274
- "<%= config.bin %> <%= command.id %>"
9275
- ],
9276
- "flags": {
9277
- "json": {
9278
- "description": "Output as JSON for AI agents/scripts",
9279
- "name": "json",
9285
+ "priority": {
9286
+ "char": "p",
9287
+ "description": "Ticket priority (uses workspace priority scale)",
9288
+ "name": "priority",
9289
+ "hasDynamicHelp": false,
9290
+ "multiple": false,
9291
+ "type": "option"
9292
+ },
9293
+ "category": {
9294
+ "description": "Ticket category (e.g., bug, feature, refactor)",
9295
+ "name": "category",
9296
+ "hasDynamicHelp": false,
9297
+ "multiple": false,
9298
+ "type": "option"
9299
+ },
9300
+ "description": {
9301
+ "char": "d",
9302
+ "description": "Ticket description",
9303
+ "name": "description",
9304
+ "hasDynamicHelp": false,
9305
+ "multiple": false,
9306
+ "type": "option"
9307
+ },
9308
+ "description-file": {
9309
+ "char": "D",
9310
+ "description": "Path to a markdown file for the ticket description (use - for stdin)",
9311
+ "exclusive": [
9312
+ "description"
9313
+ ],
9314
+ "name": "description-file",
9315
+ "hasDynamicHelp": false,
9316
+ "multiple": false,
9317
+ "type": "option"
9318
+ },
9319
+ "id": {
9320
+ "description": "Custom ticket ID (auto-generated if not provided)",
9321
+ "name": "id",
9322
+ "hasDynamicHelp": false,
9323
+ "multiple": false,
9324
+ "type": "option"
9325
+ },
9326
+ "interactive": {
9327
+ "char": "i",
9328
+ "description": "Interactive mode",
9329
+ "name": "interactive",
9280
9330
  "allowNo": false,
9281
9331
  "type": "boolean"
9282
9332
  },
9283
- "machine": {
9284
- "char": "m",
9285
- "description": "Output as JSON for AI agents/scripts",
9286
- "name": "machine",
9333
+ "epic": {
9334
+ "char": "e",
9335
+ "description": "Link ticket to an epic (e.g., EPIC-001)",
9336
+ "name": "epic",
9337
+ "hasDynamicHelp": false,
9338
+ "multiple": false,
9339
+ "type": "option"
9340
+ },
9341
+ "template": {
9342
+ "char": "T",
9343
+ "description": "Create from a template (e.g., bug-report, feature-request)",
9344
+ "name": "template",
9345
+ "hasDynamicHelp": false,
9346
+ "multiple": false,
9347
+ "type": "option"
9348
+ },
9349
+ "labels": {
9350
+ "aliases": [
9351
+ "label"
9352
+ ],
9353
+ "char": "l",
9354
+ "description": "Labels (comma-separated)",
9355
+ "name": "labels",
9356
+ "hasDynamicHelp": false,
9357
+ "multiple": false,
9358
+ "type": "option"
9359
+ },
9360
+ "dry-run": {
9361
+ "description": "Validate inputs without creating ticket (use with --json for structured output)",
9362
+ "name": "dry-run",
9287
9363
  "allowNo": false,
9288
9364
  "type": "boolean"
9365
+ },
9366
+ "source": {
9367
+ "description": "Ticket source: \"pmo\" for local DB, \"linear\" for Linear API, or \"auto\" to detect (default: auto)",
9368
+ "name": "source",
9369
+ "default": "auto",
9370
+ "hasDynamicHelp": false,
9371
+ "multiple": false,
9372
+ "options": [
9373
+ "auto",
9374
+ "pmo",
9375
+ "linear"
9376
+ ],
9377
+ "type": "option"
9378
+ },
9379
+ "team": {
9380
+ "description": "Linear team key (fallback: PRLT_LINEAR_TEAM)",
9381
+ "name": "team",
9382
+ "hasDynamicHelp": false,
9383
+ "multiple": false,
9384
+ "type": "option"
9289
9385
  }
9290
9386
  },
9291
9387
  "hasDynamicHelp": false,
9292
9388
  "hiddenAliases": [],
9293
- "id": "theme:list",
9389
+ "id": "ticket:create",
9294
9390
  "pluginAlias": "@proletariat/cli",
9295
9391
  "pluginName": "@proletariat/cli",
9296
9392
  "pluginType": "core",
9297
9393
  "strict": true,
9298
- "enableJsonFlag": false,
9299
9394
  "isESM": true,
9300
9395
  "relativePath": [
9301
9396
  "dist",
9302
9397
  "commands",
9303
- "theme",
9304
- "list.js"
9398
+ "ticket",
9399
+ "create.js"
9305
9400
  ]
9306
9401
  },
9307
- "theme:set": {
9402
+ "ticket:delete": {
9308
9403
  "aliases": [],
9309
9404
  "args": {
9310
- "theme": {
9311
- "description": "Theme ID to set as active",
9312
- "name": "theme",
9405
+ "ticketId": {
9406
+ "description": "Ticket ID to delete - prompts with dropdown if not provided",
9407
+ "name": "ticketId",
9313
9408
  "required": false
9314
9409
  }
9315
9410
  },
9316
- "description": "Set the active theme for this workspace",
9411
+ "description": "Delete ticket(s) permanently",
9317
9412
  "examples": [
9318
- "<%= config.bin %> <%= command.id %> billionaires",
9319
- "<%= config.bin %> <%= command.id %>"
9413
+ "<%= config.bin %> <%= command.id %> TICK-001",
9414
+ "<%= config.bin %> <%= command.id %> TICK-001 --force",
9415
+ "<%= config.bin %> <%= command.id %> # Interactive mode",
9416
+ "<%= config.bin %> <%= command.id %> --bulk",
9417
+ "<%= config.bin %> <%= command.id %> --json # Output choices as JSON"
9320
9418
  ],
9321
9419
  "flags": {
9420
+ "project": {
9421
+ "char": "P",
9422
+ "description": "Project ID (uses first project if only one exists)",
9423
+ "name": "project",
9424
+ "hasDynamicHelp": false,
9425
+ "multiple": false,
9426
+ "type": "option"
9427
+ },
9322
9428
  "json": {
9323
9429
  "description": "Output as JSON for AI agents/scripts",
9324
9430
  "name": "json",
@@ -9331,11 +9437,25 @@
9331
9437
  "name": "machine",
9332
9438
  "allowNo": false,
9333
9439
  "type": "boolean"
9440
+ },
9441
+ "force": {
9442
+ "char": "f",
9443
+ "description": "Skip confirmation prompt",
9444
+ "name": "force",
9445
+ "allowNo": false,
9446
+ "type": "boolean"
9447
+ },
9448
+ "bulk": {
9449
+ "char": "b",
9450
+ "description": "Enable bulk mode to delete multiple tickets",
9451
+ "name": "bulk",
9452
+ "allowNo": false,
9453
+ "type": "boolean"
9334
9454
  }
9335
9455
  },
9336
9456
  "hasDynamicHelp": false,
9337
9457
  "hiddenAliases": [],
9338
- "id": "theme:set",
9458
+ "id": "ticket:delete",
9339
9459
  "pluginAlias": "@proletariat/cli",
9340
9460
  "pluginName": "@proletariat/cli",
9341
9461
  "pluginType": "core",
@@ -9344,35 +9464,37 @@
9344
9464
  "relativePath": [
9345
9465
  "dist",
9346
9466
  "commands",
9347
- "agent",
9348
- "themes",
9349
- "set.js"
9467
+ "ticket",
9468
+ "delete.js"
9350
9469
  ]
9351
9470
  },
9352
- "tools:add": {
9471
+ "ticket:edit": {
9353
9472
  "aliases": [],
9354
9473
  "args": {
9355
- "type": {
9356
- "description": "Tool type (mcp or cli)",
9357
- "name": "type",
9358
- "options": [
9359
- "mcp",
9360
- "cli"
9361
- ],
9362
- "required": true
9363
- },
9364
- "name": {
9365
- "description": "Tool name (unique identifier)",
9366
- "name": "name",
9367
- "required": true
9474
+ "ticketId": {
9475
+ "description": "Ticket ID to edit - prompts with dropdown if not provided",
9476
+ "name": "ticketId",
9477
+ "required": false
9368
9478
  }
9369
9479
  },
9370
- "description": "Register an MCP server or CLI tool",
9480
+ "description": "Edit an existing ticket",
9371
9481
  "examples": [
9372
- "<%= config.bin %> tools add mcp arcade --url https://api.arcade.dev/mcp --auth ARCADE_API_KEY --description \"Arcade integrations\"",
9373
- "<%= config.bin %> tools add cli gh --command gh --detect \"which gh\" --install \"brew install gh\" --description \"GitHub CLI\""
9482
+ "<%= config.bin %> <%= command.id %> TICK-001",
9483
+ "<%= config.bin %> <%= command.id %> TICK-001 --title \"New title\"",
9484
+ "<%= config.bin %> <%= command.id %> TICK-001 --priority P1 --category bug",
9485
+ "<%= config.bin %> <%= command.id %> TICK-001 --add-subtask \"Implement feature\" --add-subtask \"Write tests\"",
9486
+ "<%= config.bin %> <%= command.id %> TICK-001 --owner \"john\" --assignee \"agent-1\"",
9487
+ "<%= config.bin %> <%= command.id %> # Interactive mode"
9374
9488
  ],
9375
9489
  "flags": {
9490
+ "project": {
9491
+ "char": "P",
9492
+ "description": "Project ID (uses first project if only one exists)",
9493
+ "name": "project",
9494
+ "hasDynamicHelp": false,
9495
+ "multiple": false,
9496
+ "type": "option"
9497
+ },
9376
9498
  "json": {
9377
9499
  "description": "Output as JSON for AI agents/scripts",
9378
9500
  "name": "json",
@@ -9386,205 +9508,122 @@
9386
9508
  "allowNo": false,
9387
9509
  "type": "boolean"
9388
9510
  },
9389
- "url": {
9390
- "description": "MCP server URL (for remote servers)",
9391
- "name": "url",
9511
+ "title": {
9512
+ "char": "t",
9513
+ "description": "New ticket title",
9514
+ "name": "title",
9392
9515
  "hasDynamicHelp": false,
9393
9516
  "multiple": false,
9394
9517
  "type": "option"
9395
9518
  },
9396
- "command": {
9397
- "description": "Command to run (MCP server command or CLI tool binary)",
9398
- "name": "command",
9519
+ "description": {
9520
+ "char": "d",
9521
+ "description": "New ticket description",
9522
+ "name": "description",
9399
9523
  "hasDynamicHelp": false,
9400
9524
  "multiple": false,
9401
9525
  "type": "option"
9402
9526
  },
9403
- "auth": {
9404
- "description": "Environment variable for authentication (e.g., ARCADE_API_KEY)",
9405
- "name": "auth",
9527
+ "priority": {
9528
+ "char": "p",
9529
+ "description": "New ticket priority (uses workspace priority scale, \"none\" to clear)",
9530
+ "name": "priority",
9406
9531
  "hasDynamicHelp": false,
9407
9532
  "multiple": false,
9408
9533
  "type": "option"
9409
9534
  },
9410
- "detect": {
9411
- "description": "Shell command to detect if CLI tool is installed",
9412
- "name": "detect",
9535
+ "category": {
9536
+ "description": "New ticket category",
9537
+ "name": "category",
9413
9538
  "hasDynamicHelp": false,
9414
9539
  "multiple": false,
9415
9540
  "type": "option"
9416
9541
  },
9417
- "install": {
9418
- "description": "Shell command to install the CLI tool",
9419
- "name": "install",
9542
+ "owner": {
9543
+ "char": "o",
9544
+ "description": "Ticket owner (human responsible)",
9545
+ "name": "owner",
9420
9546
  "hasDynamicHelp": false,
9421
9547
  "multiple": false,
9422
9548
  "type": "option"
9423
9549
  },
9424
- "description": {
9425
- "char": "d",
9426
- "description": "Human-readable description",
9427
- "name": "description",
9428
- "required": true,
9550
+ "assignee": {
9551
+ "char": "a",
9552
+ "description": "Ticket assignee (who executes)",
9553
+ "name": "assignee",
9429
9554
  "hasDynamicHelp": false,
9430
9555
  "multiple": false,
9431
9556
  "type": "option"
9432
- }
9433
- },
9434
- "hasDynamicHelp": false,
9435
- "hiddenAliases": [],
9436
- "id": "tools:add",
9437
- "pluginAlias": "@proletariat/cli",
9438
- "pluginName": "@proletariat/cli",
9439
- "pluginType": "core",
9440
- "strict": true,
9441
- "isESM": true,
9442
- "relativePath": [
9443
- "dist",
9444
- "commands",
9445
- "tools",
9446
- "add.js"
9447
- ]
9448
- },
9449
- "tools:check": {
9450
- "aliases": [],
9451
- "args": {},
9452
- "description": "Verify all registered tools are available and healthy",
9453
- "examples": [
9454
- "<%= config.bin %> tools check",
9455
- "<%= config.bin %> tools check --json"
9456
- ],
9457
- "flags": {
9458
- "json": {
9459
- "description": "Output as JSON for AI agents/scripts",
9460
- "name": "json",
9461
- "allowNo": false,
9462
- "type": "boolean"
9463
9557
  },
9464
- "machine": {
9465
- "char": "m",
9466
- "description": "Output as JSON for AI agents/scripts",
9467
- "name": "machine",
9468
- "allowNo": false,
9469
- "type": "boolean"
9470
- }
9471
- },
9472
- "hasDynamicHelp": false,
9473
- "hiddenAliases": [],
9474
- "id": "tools:check",
9475
- "pluginAlias": "@proletariat/cli",
9476
- "pluginName": "@proletariat/cli",
9477
- "pluginType": "core",
9478
- "strict": true,
9479
- "enableJsonFlag": false,
9480
- "isESM": true,
9481
- "relativePath": [
9482
- "dist",
9483
- "commands",
9484
- "tools",
9485
- "check.js"
9486
- ]
9487
- },
9488
- "tools:detect": {
9489
- "aliases": [],
9490
- "args": {},
9491
- "description": "Auto-detect common CLI tools on the system and register them",
9492
- "examples": [
9493
- "<%= config.bin %> tools detect",
9494
- "<%= config.bin %> tools detect --auto",
9495
- "<%= config.bin %> tools detect --json"
9496
- ],
9497
- "flags": {
9498
- "json": {
9499
- "description": "Output as JSON for AI agents/scripts",
9500
- "name": "json",
9501
- "allowNo": false,
9502
- "type": "boolean"
9558
+ "add-subtask": {
9559
+ "description": "Add a subtask (can be used multiple times)",
9560
+ "name": "add-subtask",
9561
+ "hasDynamicHelp": false,
9562
+ "multiple": true,
9563
+ "type": "option"
9503
9564
  },
9504
- "machine": {
9505
- "char": "m",
9506
- "description": "Output as JSON for AI agents/scripts",
9507
- "name": "machine",
9565
+ "clear-subtasks": {
9566
+ "description": "Clear all existing subtasks before adding new ones",
9567
+ "name": "clear-subtasks",
9508
9568
  "allowNo": false,
9509
9569
  "type": "boolean"
9510
9570
  },
9511
- "auto": {
9512
- "description": "Automatically register all detected tools without prompting",
9513
- "name": "auto",
9514
- "allowNo": false,
9515
- "type": "boolean"
9516
- }
9517
- },
9518
- "hasDynamicHelp": false,
9519
- "hiddenAliases": [],
9520
- "id": "tools:detect",
9521
- "pluginAlias": "@proletariat/cli",
9522
- "pluginName": "@proletariat/cli",
9523
- "pluginType": "core",
9524
- "strict": true,
9525
- "enableJsonFlag": false,
9526
- "isESM": true,
9527
- "relativePath": [
9528
- "dist",
9529
- "commands",
9530
- "tools",
9531
- "detect.js"
9532
- ]
9533
- },
9534
- "tools": {
9535
- "aliases": [
9536
- "tools:list"
9537
- ],
9538
- "args": {},
9539
- "description": "Show all registered MCP servers and CLI tools",
9540
- "examples": [
9541
- "<%= config.bin %> tools",
9542
- "<%= config.bin %> tools --json"
9543
- ],
9544
- "flags": {
9545
- "json": {
9546
- "description": "Output as JSON for AI agents/scripts",
9547
- "name": "json",
9571
+ "add-label": {
9572
+ "description": "Add a label (can be used multiple times)",
9573
+ "name": "add-label",
9574
+ "hasDynamicHelp": false,
9575
+ "multiple": true,
9576
+ "type": "option"
9577
+ },
9578
+ "remove-label": {
9579
+ "description": "Remove a label",
9580
+ "name": "remove-label",
9581
+ "hasDynamicHelp": false,
9582
+ "multiple": true,
9583
+ "type": "option"
9584
+ },
9585
+ "add-ac": {
9586
+ "description": "Add an acceptance criterion (can be used multiple times)",
9587
+ "name": "add-ac",
9588
+ "hasDynamicHelp": false,
9589
+ "multiple": true,
9590
+ "type": "option"
9591
+ },
9592
+ "clear-ac": {
9593
+ "description": "Clear all existing acceptance criteria before adding new ones",
9594
+ "name": "clear-ac",
9548
9595
  "allowNo": false,
9549
9596
  "type": "boolean"
9550
9597
  },
9551
- "machine": {
9552
- "char": "m",
9553
- "description": "Output as JSON for AI agents/scripts",
9554
- "name": "machine",
9598
+ "interactive": {
9599
+ "char": "i",
9600
+ "description": "Interactive mode - prompts for all fields",
9601
+ "name": "interactive",
9555
9602
  "allowNo": false,
9556
9603
  "type": "boolean"
9557
9604
  }
9558
9605
  },
9559
9606
  "hasDynamicHelp": false,
9560
9607
  "hiddenAliases": [],
9561
- "id": "tools",
9608
+ "id": "ticket:edit",
9562
9609
  "pluginAlias": "@proletariat/cli",
9563
9610
  "pluginName": "@proletariat/cli",
9564
9611
  "pluginType": "core",
9565
9612
  "strict": true,
9566
- "enableJsonFlag": false,
9567
9613
  "isESM": true,
9568
9614
  "relativePath": [
9569
9615
  "dist",
9570
9616
  "commands",
9571
- "tools",
9572
- "index.js"
9617
+ "ticket",
9618
+ "edit.js"
9573
9619
  ]
9574
9620
  },
9575
- "tools:remove": {
9621
+ "ticket": {
9576
9622
  "aliases": [],
9577
- "args": {
9578
- "name": {
9579
- "description": "Tool name to remove",
9580
- "name": "name",
9581
- "required": true
9582
- }
9583
- },
9584
- "description": "Remove a tool from the registry",
9623
+ "args": {},
9624
+ "description": "Interactive menu for ticket operations",
9585
9625
  "examples": [
9586
- "<%= config.bin %> tools remove arcade",
9587
- "<%= config.bin %> tools remove ffmpeg"
9626
+ "<%= config.bin %> <%= command.id %>"
9588
9627
  ],
9589
9628
  "flags": {
9590
9629
  "json": {
@@ -9603,36 +9642,35 @@
9603
9642
  },
9604
9643
  "hasDynamicHelp": false,
9605
9644
  "hiddenAliases": [],
9606
- "id": "tools:remove",
9645
+ "id": "ticket",
9607
9646
  "pluginAlias": "@proletariat/cli",
9608
9647
  "pluginName": "@proletariat/cli",
9609
9648
  "pluginType": "core",
9610
9649
  "strict": true,
9611
- "enableJsonFlag": false,
9612
9650
  "isESM": true,
9613
9651
  "relativePath": [
9614
9652
  "dist",
9615
9653
  "commands",
9616
- "tools",
9617
- "remove.js"
9654
+ "ticket",
9655
+ "index.js"
9618
9656
  ]
9619
9657
  },
9620
- "ticket:create": {
9658
+ "ticket:list": {
9621
9659
  "aliases": [],
9622
9660
  "args": {},
9623
- "description": "Create a new ticket (routes to Linear when configured, or local PMO)",
9661
+ "description": "List tickets from the PMO board",
9624
9662
  "examples": [
9625
9663
  "<%= config.bin %> <%= command.id %>",
9626
- "<%= config.bin %> <%= command.id %> --title \"Fix login bug\" --column Backlog",
9627
- "<%= config.bin %> <%= command.id %> -t \"Add feature\" -c \"In Progress\" -p P1",
9628
- "<%= config.bin %> <%= command.id %> --project mobile-app -t \"New feature\"",
9629
- "<%= config.bin %> <%= command.id %> --epic EPIC-001 -t \"Implement auth flow\"",
9630
- "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file ./ticket-desc.md",
9631
- "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file - # Read from stdin",
9632
- "<%= config.bin %> <%= command.id %> --json # Output column choices as JSON",
9633
- "<%= config.bin %> <%= command.id %> --title \"Test\" -P PROJ-001 --dry-run --json # Validate without creating",
9634
- "<%= config.bin %> <%= command.id %> --source linear -t \"Fix bug\" --team ENG",
9635
- "<%= config.bin %> <%= command.id %> --source pmo -t \"Local task\" -c Backlog"
9664
+ "<%= config.bin %> <%= command.id %> --column Backlog",
9665
+ "<%= config.bin %> <%= command.id %> --priority P0",
9666
+ "<%= config.bin %> <%= command.id %> --category bug",
9667
+ "<%= config.bin %> <%= command.id %> --search \"login\"",
9668
+ "<%= config.bin %> <%= command.id %> --project mobile-app",
9669
+ "<%= config.bin %> <%= command.id %> --all",
9670
+ "<%= config.bin %> <%= command.id %> --all --group-by priority",
9671
+ "<%= config.bin %> <%= command.id %> -g priority",
9672
+ "<%= config.bin %> <%= command.id %> --limit 10",
9673
+ "<%= config.bin %> <%= command.id %> --limit 10 --offset 20"
9636
9674
  ],
9637
9675
  "flags": {
9638
9676
  "project": {
@@ -9656,17 +9694,9 @@
9656
9694
  "allowNo": false,
9657
9695
  "type": "boolean"
9658
9696
  },
9659
- "title": {
9660
- "char": "t",
9661
- "description": "Ticket title [required for non-interactive]",
9662
- "name": "title",
9663
- "hasDynamicHelp": false,
9664
- "multiple": false,
9665
- "type": "option"
9666
- },
9667
9697
  "column": {
9668
9698
  "char": "c",
9669
- "description": "Column to place the ticket in",
9699
+ "description": "Filter by column",
9670
9700
  "name": "column",
9671
9701
  "hasDynamicHelp": false,
9672
9702
  "multiple": false,
@@ -9674,84 +9704,82 @@
9674
9704
  },
9675
9705
  "priority": {
9676
9706
  "char": "p",
9677
- "description": "Ticket priority (uses workspace priority scale)",
9707
+ "description": "Filter by priority (uses workspace priority scale)",
9678
9708
  "name": "priority",
9679
9709
  "hasDynamicHelp": false,
9680
9710
  "multiple": false,
9681
9711
  "type": "option"
9682
9712
  },
9683
9713
  "category": {
9684
- "description": "Ticket category (e.g., bug, feature, refactor)",
9714
+ "description": "Filter by category",
9685
9715
  "name": "category",
9686
9716
  "hasDynamicHelp": false,
9687
9717
  "multiple": false,
9688
9718
  "type": "option"
9689
9719
  },
9690
- "description": {
9691
- "char": "d",
9692
- "description": "Ticket description",
9693
- "name": "description",
9694
- "hasDynamicHelp": false,
9695
- "multiple": false,
9696
- "type": "option"
9697
- },
9698
- "description-file": {
9699
- "char": "D",
9700
- "description": "Path to a markdown file for the ticket description (use - for stdin)",
9701
- "exclusive": [
9702
- "description"
9703
- ],
9704
- "name": "description-file",
9720
+ "search": {
9721
+ "char": "s",
9722
+ "description": "Search in title and description",
9723
+ "name": "search",
9705
9724
  "hasDynamicHelp": false,
9706
9725
  "multiple": false,
9707
9726
  "type": "option"
9708
9727
  },
9709
- "id": {
9710
- "description": "Custom ticket ID (auto-generated if not provided)",
9711
- "name": "id",
9728
+ "format": {
9729
+ "char": "f",
9730
+ "description": "Output format",
9731
+ "name": "format",
9732
+ "default": "table",
9712
9733
  "hasDynamicHelp": false,
9713
9734
  "multiple": false,
9735
+ "options": [
9736
+ "table",
9737
+ "compact",
9738
+ "json"
9739
+ ],
9714
9740
  "type": "option"
9715
9741
  },
9716
- "interactive": {
9717
- "char": "i",
9718
- "description": "Interactive mode",
9719
- "name": "interactive",
9742
+ "all": {
9743
+ "char": "a",
9744
+ "description": "Show tickets across all projects",
9745
+ "name": "all",
9720
9746
  "allowNo": false,
9721
9747
  "type": "boolean"
9722
9748
  },
9723
- "epic": {
9724
- "char": "e",
9725
- "description": "Link ticket to an epic (e.g., EPIC-001)",
9726
- "name": "epic",
9749
+ "label": {
9750
+ "description": "Filter by label name",
9751
+ "name": "label",
9727
9752
  "hasDynamicHelp": false,
9728
9753
  "multiple": false,
9729
9754
  "type": "option"
9730
9755
  },
9731
- "template": {
9732
- "char": "T",
9733
- "description": "Create from a template (e.g., bug-report, feature-request)",
9734
- "name": "template",
9756
+ "group-by": {
9757
+ "char": "g",
9758
+ "description": "Group tickets by field",
9759
+ "name": "group-by",
9760
+ "default": "status",
9735
9761
  "hasDynamicHelp": false,
9736
9762
  "multiple": false,
9763
+ "options": [
9764
+ "status",
9765
+ "priority"
9766
+ ],
9737
9767
  "type": "option"
9738
9768
  },
9739
- "labels": {
9740
- "aliases": [
9741
- "label"
9742
- ],
9769
+ "limit": {
9743
9770
  "char": "l",
9744
- "description": "Labels (comma-separated)",
9745
- "name": "labels",
9771
+ "description": "Maximum number of tickets to display",
9772
+ "name": "limit",
9746
9773
  "hasDynamicHelp": false,
9747
9774
  "multiple": false,
9748
9775
  "type": "option"
9749
9776
  },
9750
- "dry-run": {
9751
- "description": "Validate inputs without creating ticket (use with --json for structured output)",
9752
- "name": "dry-run",
9753
- "allowNo": false,
9754
- "type": "boolean"
9777
+ "offset": {
9778
+ "description": "Skip first N tickets (for pagination)",
9779
+ "name": "offset",
9780
+ "hasDynamicHelp": false,
9781
+ "multiple": false,
9782
+ "type": "option"
9755
9783
  },
9756
9784
  "source": {
9757
9785
  "description": "Ticket source: \"pmo\" for local DB, \"linear\" for Linear API, or \"auto\" to detect (default: auto)",
@@ -9759,24 +9787,128 @@
9759
9787
  "default": "auto",
9760
9788
  "hasDynamicHelp": false,
9761
9789
  "multiple": false,
9762
- "options": [
9763
- "auto",
9764
- "pmo",
9765
- "linear"
9766
- ],
9790
+ "options": [
9791
+ "auto",
9792
+ "pmo",
9793
+ "linear"
9794
+ ],
9795
+ "type": "option"
9796
+ },
9797
+ "team": {
9798
+ "description": "Linear team key (fallback: PRLT_LINEAR_TEAM)",
9799
+ "name": "team",
9800
+ "hasDynamicHelp": false,
9801
+ "multiple": false,
9802
+ "type": "option"
9803
+ }
9804
+ },
9805
+ "hasDynamicHelp": false,
9806
+ "hiddenAliases": [],
9807
+ "id": "ticket:list",
9808
+ "pluginAlias": "@proletariat/cli",
9809
+ "pluginName": "@proletariat/cli",
9810
+ "pluginType": "core",
9811
+ "strict": true,
9812
+ "enableJsonFlag": false,
9813
+ "isESM": true,
9814
+ "relativePath": [
9815
+ "dist",
9816
+ "commands",
9817
+ "ticket",
9818
+ "list.js"
9819
+ ]
9820
+ },
9821
+ "ticket:move": {
9822
+ "aliases": [],
9823
+ "args": {
9824
+ "ticketId": {
9825
+ "description": "Ticket ID - prompts with dropdown if not provided",
9826
+ "name": "ticketId",
9827
+ "required": false
9828
+ },
9829
+ "column": {
9830
+ "description": "Target column - prompts with dropdown if not provided",
9831
+ "name": "column",
9832
+ "required": false
9833
+ }
9834
+ },
9835
+ "description": "Move ticket(s) to a different column",
9836
+ "examples": [
9837
+ "<%= config.bin %> <%= command.id %> my-ticket \"In Progress\"",
9838
+ "<%= config.bin %> <%= command.id %> implement-auth Done",
9839
+ "<%= config.bin %> <%= command.id %> TKT-123 --status \"In Review\"",
9840
+ "<%= config.bin %> <%= command.id %> fix-bug \"In Review\" --position 0",
9841
+ "<%= config.bin %> <%= command.id %> TKT-123 --to-project PROJ-002",
9842
+ "<%= config.bin %> <%= command.id %> --bulk"
9843
+ ],
9844
+ "flags": {
9845
+ "project": {
9846
+ "char": "P",
9847
+ "description": "Project ID (uses first project if only one exists)",
9848
+ "name": "project",
9849
+ "hasDynamicHelp": false,
9850
+ "multiple": false,
9851
+ "type": "option"
9852
+ },
9853
+ "json": {
9854
+ "description": "Output as JSON for AI agents/scripts",
9855
+ "name": "json",
9856
+ "allowNo": false,
9857
+ "type": "boolean"
9858
+ },
9859
+ "machine": {
9860
+ "char": "m",
9861
+ "description": "Output as JSON for AI agents/scripts",
9862
+ "name": "machine",
9863
+ "allowNo": false,
9864
+ "type": "boolean"
9865
+ },
9866
+ "status": {
9867
+ "char": "s",
9868
+ "description": "Target status/column (alternative to positional column argument)",
9869
+ "name": "status",
9870
+ "hasDynamicHelp": false,
9871
+ "multiple": false,
9872
+ "type": "option"
9873
+ },
9874
+ "position": {
9875
+ "description": "Position within the column (0 = top)",
9876
+ "name": "position",
9877
+ "hasDynamicHelp": false,
9878
+ "multiple": false,
9767
9879
  "type": "option"
9768
9880
  },
9769
- "team": {
9770
- "description": "Linear team key (fallback: PRLT_LINEAR_TEAM)",
9771
- "name": "team",
9881
+ "to-project": {
9882
+ "description": "Move ticket to a different project (uses Backlog/default column)",
9883
+ "name": "to-project",
9772
9884
  "hasDynamicHelp": false,
9773
9885
  "multiple": false,
9774
9886
  "type": "option"
9887
+ },
9888
+ "bulk": {
9889
+ "char": "b",
9890
+ "description": "Enable bulk mode to move multiple tickets",
9891
+ "name": "bulk",
9892
+ "allowNo": false,
9893
+ "type": "boolean"
9894
+ },
9895
+ "force": {
9896
+ "char": "f",
9897
+ "description": "Skip confirmation prompt (bulk mode only)",
9898
+ "name": "force",
9899
+ "allowNo": false,
9900
+ "type": "boolean"
9901
+ },
9902
+ "no-cleanup": {
9903
+ "description": "Skip automatic worktree cleanup when moving to Done",
9904
+ "name": "no-cleanup",
9905
+ "allowNo": false,
9906
+ "type": "boolean"
9775
9907
  }
9776
9908
  },
9777
9909
  "hasDynamicHelp": false,
9778
9910
  "hiddenAliases": [],
9779
- "id": "ticket:create",
9911
+ "id": "ticket:move",
9780
9912
  "pluginAlias": "@proletariat/cli",
9781
9913
  "pluginName": "@proletariat/cli",
9782
9914
  "pluginType": "core",
@@ -9786,25 +9918,22 @@
9786
9918
  "dist",
9787
9919
  "commands",
9788
9920
  "ticket",
9789
- "create.js"
9921
+ "move.js"
9790
9922
  ]
9791
9923
  },
9792
- "ticket:delete": {
9924
+ "ticket:show": {
9793
9925
  "aliases": [],
9794
9926
  "args": {
9795
9927
  "ticketId": {
9796
- "description": "Ticket ID to delete - prompts with dropdown if not provided",
9928
+ "description": "Ticket ID to view - prompts with dropdown if not provided",
9797
9929
  "name": "ticketId",
9798
9930
  "required": false
9799
9931
  }
9800
9932
  },
9801
- "description": "Delete ticket(s) permanently",
9933
+ "description": "View detailed ticket information",
9802
9934
  "examples": [
9803
9935
  "<%= config.bin %> <%= command.id %> TICK-001",
9804
- "<%= config.bin %> <%= command.id %> TICK-001 --force",
9805
- "<%= config.bin %> <%= command.id %> # Interactive mode",
9806
- "<%= config.bin %> <%= command.id %> --bulk",
9807
- "<%= config.bin %> <%= command.id %> --json # Output choices as JSON"
9936
+ "<%= config.bin %> <%= command.id %> # Interactive mode"
9808
9937
  ],
9809
9938
  "flags": {
9810
9939
  "project": {
@@ -9827,25 +9956,11 @@
9827
9956
  "name": "machine",
9828
9957
  "allowNo": false,
9829
9958
  "type": "boolean"
9830
- },
9831
- "force": {
9832
- "char": "f",
9833
- "description": "Skip confirmation prompt",
9834
- "name": "force",
9835
- "allowNo": false,
9836
- "type": "boolean"
9837
- },
9838
- "bulk": {
9839
- "char": "b",
9840
- "description": "Enable bulk mode to delete multiple tickets",
9841
- "name": "bulk",
9842
- "allowNo": false,
9843
- "type": "boolean"
9844
9959
  }
9845
9960
  },
9846
9961
  "hasDynamicHelp": false,
9847
9962
  "hiddenAliases": [],
9848
- "id": "ticket:delete",
9963
+ "id": "ticket:show",
9849
9964
  "pluginAlias": "@proletariat/cli",
9850
9965
  "pluginName": "@proletariat/cli",
9851
9966
  "pluginType": "core",
@@ -9855,26 +9970,29 @@
9855
9970
  "dist",
9856
9971
  "commands",
9857
9972
  "ticket",
9858
- "delete.js"
9973
+ "show.js"
9859
9974
  ]
9860
9975
  },
9861
- "ticket:edit": {
9976
+ "ticket:update": {
9862
9977
  "aliases": [],
9863
9978
  "args": {
9864
9979
  "ticketId": {
9865
- "description": "Ticket ID to edit - prompts with dropdown if not provided",
9980
+ "description": "Ticket ID - prompts with dropdown if not provided",
9866
9981
  "name": "ticketId",
9867
9982
  "required": false
9868
9983
  }
9869
9984
  },
9870
- "description": "Edit an existing ticket",
9985
+ "description": "Update ticket fields (title, description, priority, category, labels, status)",
9871
9986
  "examples": [
9872
- "<%= config.bin %> <%= command.id %> TICK-001",
9873
- "<%= config.bin %> <%= command.id %> TICK-001 --title \"New title\"",
9874
- "<%= config.bin %> <%= command.id %> TICK-001 --priority P1 --category bug",
9875
- "<%= config.bin %> <%= command.id %> TICK-001 --add-subtask \"Implement feature\" --add-subtask \"Write tests\"",
9876
- "<%= config.bin %> <%= command.id %> TICK-001 --owner \"john\" --assignee \"agent-1\"",
9877
- "<%= config.bin %> <%= command.id %> # Interactive mode"
9987
+ "<%= config.bin %> <%= command.id %> TKT-001 --title \"New title\"",
9988
+ "<%= config.bin %> <%= command.id %> TKT-001 --description \"Updated description\"",
9989
+ "<%= config.bin %> <%= command.id %> TKT-001 --description-file ./spec.md",
9990
+ "<%= config.bin %> <%= command.id %> TKT-001 --priority P1",
9991
+ "<%= config.bin %> <%= command.id %> TKT-001 --category bug",
9992
+ "<%= config.bin %> <%= command.id %> TKT-001 --labels frontend,urgent",
9993
+ "<%= config.bin %> <%= command.id %> TKT-001 --status \"In Progress\"",
9994
+ "<%= config.bin %> <%= command.id %> TKT-001 --title \"Fix auth\" --priority P0 --status \"In Progress\" --json",
9995
+ "<%= config.bin %> <%= command.id %> --bulk --priority P1"
9878
9996
  ],
9879
9997
  "flags": {
9880
9998
  "project": {
@@ -9900,7 +10018,7 @@
9900
10018
  },
9901
10019
  "title": {
9902
10020
  "char": "t",
9903
- "description": "New ticket title",
10021
+ "description": "Set ticket title",
9904
10022
  "name": "title",
9905
10023
  "hasDynamicHelp": false,
9906
10024
  "multiple": false,
@@ -9908,94 +10026,219 @@
9908
10026
  },
9909
10027
  "description": {
9910
10028
  "char": "d",
9911
- "description": "New ticket description",
10029
+ "description": "Set ticket description",
9912
10030
  "name": "description",
9913
10031
  "hasDynamicHelp": false,
9914
10032
  "multiple": false,
9915
10033
  "type": "option"
9916
10034
  },
10035
+ "description-file": {
10036
+ "description": "Read ticket description from a file",
10037
+ "name": "description-file",
10038
+ "hasDynamicHelp": false,
10039
+ "multiple": false,
10040
+ "type": "option"
10041
+ },
9917
10042
  "priority": {
9918
10043
  "char": "p",
9919
- "description": "New ticket priority (uses workspace priority scale, \"none\" to clear)",
10044
+ "description": "Set priority (uses workspace priority scale, \"none\" to clear)",
9920
10045
  "name": "priority",
9921
10046
  "hasDynamicHelp": false,
9922
10047
  "multiple": false,
9923
10048
  "type": "option"
9924
10049
  },
9925
10050
  "category": {
9926
- "description": "New ticket category",
10051
+ "char": "c",
10052
+ "description": "Set category (e.g., feature, bug, refactor, \"none\" to clear)",
9927
10053
  "name": "category",
9928
10054
  "hasDynamicHelp": false,
9929
10055
  "multiple": false,
9930
10056
  "type": "option"
9931
10057
  },
9932
- "owner": {
9933
- "char": "o",
9934
- "description": "Ticket owner (human responsible)",
9935
- "name": "owner",
10058
+ "labels": {
10059
+ "char": "l",
10060
+ "description": "Set labels (comma-separated, replaces existing labels; use \"\" to clear)",
10061
+ "name": "labels",
9936
10062
  "hasDynamicHelp": false,
9937
10063
  "multiple": false,
9938
10064
  "type": "option"
9939
10065
  },
9940
- "assignee": {
9941
- "char": "a",
9942
- "description": "Ticket assignee (who executes)",
9943
- "name": "assignee",
10066
+ "status": {
10067
+ "char": "s",
10068
+ "description": "Set status/column (e.g., \"In Progress\", \"Done\")",
10069
+ "name": "status",
9944
10070
  "hasDynamicHelp": false,
9945
10071
  "multiple": false,
9946
10072
  "type": "option"
9947
10073
  },
9948
- "add-subtask": {
9949
- "description": "Add a subtask (can be used multiple times)",
9950
- "name": "add-subtask",
9951
- "hasDynamicHelp": false,
9952
- "multiple": true,
9953
- "type": "option"
10074
+ "bulk": {
10075
+ "char": "b",
10076
+ "description": "Enable bulk mode to update multiple tickets",
10077
+ "name": "bulk",
10078
+ "allowNo": false,
10079
+ "type": "boolean"
9954
10080
  },
9955
- "clear-subtasks": {
9956
- "description": "Clear all existing subtasks before adding new ones",
9957
- "name": "clear-subtasks",
10081
+ "force": {
10082
+ "char": "f",
10083
+ "description": "Skip confirmation prompt",
10084
+ "name": "force",
9958
10085
  "allowNo": false,
9959
10086
  "type": "boolean"
10087
+ }
10088
+ },
10089
+ "hasDynamicHelp": false,
10090
+ "hiddenAliases": [],
10091
+ "id": "ticket:update",
10092
+ "pluginAlias": "@proletariat/cli",
10093
+ "pluginName": "@proletariat/cli",
10094
+ "pluginType": "core",
10095
+ "strict": true,
10096
+ "isESM": true,
10097
+ "relativePath": [
10098
+ "dist",
10099
+ "commands",
10100
+ "ticket",
10101
+ "update.js"
10102
+ ]
10103
+ },
10104
+ "theme:add-names": {
10105
+ "aliases": [],
10106
+ "args": {
10107
+ "theme": {
10108
+ "description": "Theme ID",
10109
+ "name": "theme",
10110
+ "required": true
9960
10111
  },
9961
- "add-label": {
9962
- "description": "Add a label (can be used multiple times)",
9963
- "name": "add-label",
9964
- "hasDynamicHelp": false,
9965
- "multiple": true,
9966
- "type": "option"
10112
+ "names": {
10113
+ "description": "Names to add to the theme (space-separated)",
10114
+ "name": "names",
10115
+ "required": false
10116
+ }
10117
+ },
10118
+ "description": "Add names to a theme",
10119
+ "examples": [
10120
+ "<%= config.bin %> <%= command.id %> greek-gods zeus athena poseidon",
10121
+ "<%= config.bin %> <%= command.id %> my-theme agent-a agent-b"
10122
+ ],
10123
+ "flags": {
10124
+ "json": {
10125
+ "description": "Output as JSON for AI agents/scripts",
10126
+ "name": "json",
10127
+ "allowNo": false,
10128
+ "type": "boolean"
9967
10129
  },
9968
- "remove-label": {
9969
- "description": "Remove a label",
9970
- "name": "remove-label",
9971
- "hasDynamicHelp": false,
9972
- "multiple": true,
9973
- "type": "option"
10130
+ "machine": {
10131
+ "char": "m",
10132
+ "description": "Output as JSON for AI agents/scripts",
10133
+ "name": "machine",
10134
+ "allowNo": false,
10135
+ "type": "boolean"
10136
+ }
10137
+ },
10138
+ "hasDynamicHelp": false,
10139
+ "hiddenAliases": [],
10140
+ "id": "theme:add-names",
10141
+ "pluginAlias": "@proletariat/cli",
10142
+ "pluginName": "@proletariat/cli",
10143
+ "pluginType": "core",
10144
+ "strict": false,
10145
+ "enableJsonFlag": false,
10146
+ "isESM": true,
10147
+ "relativePath": [
10148
+ "dist",
10149
+ "commands",
10150
+ "theme",
10151
+ "add-names.js"
10152
+ ]
10153
+ },
10154
+ "theme:create": {
10155
+ "aliases": [],
10156
+ "args": {
10157
+ "name": {
10158
+ "description": "Theme name (used as ID, lowercase with hyphens)",
10159
+ "name": "name",
10160
+ "required": true
10161
+ }
10162
+ },
10163
+ "description": "Create a custom agent theme",
10164
+ "examples": [
10165
+ "<%= config.bin %> <%= command.id %> greek-gods",
10166
+ "<%= config.bin %> <%= command.id %> greek-gods --description \"Mount Olympus crew\"",
10167
+ "<%= config.bin %> <%= command.id %> greek-gods --display-name \"Greek Gods\""
10168
+ ],
10169
+ "flags": {
10170
+ "json": {
10171
+ "description": "Output as JSON for AI agents/scripts",
10172
+ "name": "json",
10173
+ "allowNo": false,
10174
+ "type": "boolean"
9974
10175
  },
9975
- "add-ac": {
9976
- "description": "Add an acceptance criterion (can be used multiple times)",
9977
- "name": "add-ac",
10176
+ "machine": {
10177
+ "char": "m",
10178
+ "description": "Output as JSON for AI agents/scripts",
10179
+ "name": "machine",
10180
+ "allowNo": false,
10181
+ "type": "boolean"
10182
+ },
10183
+ "description": {
10184
+ "char": "d",
10185
+ "description": "Theme description",
10186
+ "name": "description",
9978
10187
  "hasDynamicHelp": false,
9979
- "multiple": true,
10188
+ "multiple": false,
9980
10189
  "type": "option"
9981
10190
  },
9982
- "clear-ac": {
9983
- "description": "Clear all existing acceptance criteria before adding new ones",
9984
- "name": "clear-ac",
10191
+ "display-name": {
10192
+ "description": "Display name (defaults to formatted name)",
10193
+ "name": "display-name",
10194
+ "hasDynamicHelp": false,
10195
+ "multiple": false,
10196
+ "type": "option"
10197
+ }
10198
+ },
10199
+ "hasDynamicHelp": false,
10200
+ "hiddenAliases": [],
10201
+ "id": "theme:create",
10202
+ "pluginAlias": "@proletariat/cli",
10203
+ "pluginName": "@proletariat/cli",
10204
+ "pluginType": "core",
10205
+ "strict": true,
10206
+ "enableJsonFlag": false,
10207
+ "isESM": true,
10208
+ "relativePath": [
10209
+ "dist",
10210
+ "commands",
10211
+ "theme",
10212
+ "create.js"
10213
+ ]
10214
+ },
10215
+ "theme": {
10216
+ "aliases": [],
10217
+ "args": {},
10218
+ "description": "Manage agent naming themes",
10219
+ "examples": [
10220
+ "<%= config.bin %> <%= command.id %> list",
10221
+ "<%= config.bin %> <%= command.id %> create greek-gods",
10222
+ "<%= config.bin %> <%= command.id %> add-names greek-gods zeus athena"
10223
+ ],
10224
+ "flags": {
10225
+ "json": {
10226
+ "description": "Output as JSON for AI agents/scripts",
10227
+ "name": "json",
9985
10228
  "allowNo": false,
9986
10229
  "type": "boolean"
9987
10230
  },
9988
- "interactive": {
9989
- "char": "i",
9990
- "description": "Interactive mode - prompts for all fields",
9991
- "name": "interactive",
10231
+ "machine": {
10232
+ "char": "m",
10233
+ "description": "Output as JSON for AI agents/scripts",
10234
+ "name": "machine",
9992
10235
  "allowNo": false,
9993
10236
  "type": "boolean"
9994
10237
  }
9995
10238
  },
9996
10239
  "hasDynamicHelp": false,
9997
10240
  "hiddenAliases": [],
9998
- "id": "ticket:edit",
10241
+ "id": "theme",
9999
10242
  "pluginAlias": "@proletariat/cli",
10000
10243
  "pluginName": "@proletariat/cli",
10001
10244
  "pluginType": "core",
@@ -10004,14 +10247,14 @@
10004
10247
  "relativePath": [
10005
10248
  "dist",
10006
10249
  "commands",
10007
- "ticket",
10008
- "edit.js"
10250
+ "theme",
10251
+ "index.js"
10009
10252
  ]
10010
10253
  },
10011
- "ticket": {
10254
+ "theme:list": {
10012
10255
  "aliases": [],
10013
10256
  "args": {},
10014
- "description": "Interactive menu for ticket operations",
10257
+ "description": "List available agent themes",
10015
10258
  "examples": [
10016
10259
  "<%= config.bin %> <%= command.id %>"
10017
10260
  ],
@@ -10032,45 +10275,35 @@
10032
10275
  },
10033
10276
  "hasDynamicHelp": false,
10034
10277
  "hiddenAliases": [],
10035
- "id": "ticket",
10278
+ "id": "theme:list",
10036
10279
  "pluginAlias": "@proletariat/cli",
10037
10280
  "pluginName": "@proletariat/cli",
10038
10281
  "pluginType": "core",
10039
10282
  "strict": true,
10283
+ "enableJsonFlag": false,
10040
10284
  "isESM": true,
10041
10285
  "relativePath": [
10042
10286
  "dist",
10043
10287
  "commands",
10044
- "ticket",
10045
- "index.js"
10288
+ "theme",
10289
+ "list.js"
10046
10290
  ]
10047
10291
  },
10048
- "ticket:list": {
10292
+ "theme:set": {
10049
10293
  "aliases": [],
10050
- "args": {},
10051
- "description": "List tickets from the PMO board",
10294
+ "args": {
10295
+ "theme": {
10296
+ "description": "Theme ID to set as active",
10297
+ "name": "theme",
10298
+ "required": false
10299
+ }
10300
+ },
10301
+ "description": "Set the active theme for this workspace",
10052
10302
  "examples": [
10053
- "<%= config.bin %> <%= command.id %>",
10054
- "<%= config.bin %> <%= command.id %> --column Backlog",
10055
- "<%= config.bin %> <%= command.id %> --priority P0",
10056
- "<%= config.bin %> <%= command.id %> --category bug",
10057
- "<%= config.bin %> <%= command.id %> --search \"login\"",
10058
- "<%= config.bin %> <%= command.id %> --project mobile-app",
10059
- "<%= config.bin %> <%= command.id %> --all",
10060
- "<%= config.bin %> <%= command.id %> --all --group-by priority",
10061
- "<%= config.bin %> <%= command.id %> -g priority",
10062
- "<%= config.bin %> <%= command.id %> --limit 10",
10063
- "<%= config.bin %> <%= command.id %> --limit 10 --offset 20"
10303
+ "<%= config.bin %> <%= command.id %> billionaires",
10304
+ "<%= config.bin %> <%= command.id %>"
10064
10305
  ],
10065
10306
  "flags": {
10066
- "project": {
10067
- "char": "P",
10068
- "description": "Project ID (uses first project if only one exists)",
10069
- "name": "project",
10070
- "hasDynamicHelp": false,
10071
- "multiple": false,
10072
- "type": "option"
10073
- },
10074
10307
  "json": {
10075
10308
  "description": "Output as JSON for AI agents/scripts",
10076
10309
  "name": "json",
@@ -10083,118 +10316,147 @@
10083
10316
  "name": "machine",
10084
10317
  "allowNo": false,
10085
10318
  "type": "boolean"
10319
+ }
10320
+ },
10321
+ "hasDynamicHelp": false,
10322
+ "hiddenAliases": [],
10323
+ "id": "theme:set",
10324
+ "pluginAlias": "@proletariat/cli",
10325
+ "pluginName": "@proletariat/cli",
10326
+ "pluginType": "core",
10327
+ "strict": true,
10328
+ "isESM": true,
10329
+ "relativePath": [
10330
+ "dist",
10331
+ "commands",
10332
+ "agent",
10333
+ "themes",
10334
+ "set.js"
10335
+ ]
10336
+ },
10337
+ "tools:add": {
10338
+ "aliases": [],
10339
+ "args": {
10340
+ "type": {
10341
+ "description": "Tool type (mcp or cli)",
10342
+ "name": "type",
10343
+ "options": [
10344
+ "mcp",
10345
+ "cli"
10346
+ ],
10347
+ "required": true
10086
10348
  },
10087
- "column": {
10088
- "char": "c",
10089
- "description": "Filter by column",
10090
- "name": "column",
10091
- "hasDynamicHelp": false,
10092
- "multiple": false,
10093
- "type": "option"
10094
- },
10095
- "priority": {
10096
- "char": "p",
10097
- "description": "Filter by priority (uses workspace priority scale)",
10098
- "name": "priority",
10099
- "hasDynamicHelp": false,
10100
- "multiple": false,
10101
- "type": "option"
10102
- },
10103
- "category": {
10104
- "description": "Filter by category",
10105
- "name": "category",
10106
- "hasDynamicHelp": false,
10107
- "multiple": false,
10108
- "type": "option"
10349
+ "name": {
10350
+ "description": "Tool name (unique identifier)",
10351
+ "name": "name",
10352
+ "required": true
10353
+ }
10354
+ },
10355
+ "description": "Register an MCP server or CLI tool",
10356
+ "examples": [
10357
+ "<%= config.bin %> tools add mcp arcade --url https://api.arcade.dev/mcp --auth ARCADE_API_KEY --description \"Arcade integrations\"",
10358
+ "<%= config.bin %> tools add cli gh --command gh --detect \"which gh\" --install \"brew install gh\" --description \"GitHub CLI\""
10359
+ ],
10360
+ "flags": {
10361
+ "json": {
10362
+ "description": "Output as JSON for AI agents/scripts",
10363
+ "name": "json",
10364
+ "allowNo": false,
10365
+ "type": "boolean"
10109
10366
  },
10110
- "search": {
10111
- "char": "s",
10112
- "description": "Search in title and description",
10113
- "name": "search",
10114
- "hasDynamicHelp": false,
10115
- "multiple": false,
10116
- "type": "option"
10367
+ "machine": {
10368
+ "char": "m",
10369
+ "description": "Output as JSON for AI agents/scripts",
10370
+ "name": "machine",
10371
+ "allowNo": false,
10372
+ "type": "boolean"
10117
10373
  },
10118
- "format": {
10119
- "char": "f",
10120
- "description": "Output format",
10121
- "name": "format",
10122
- "default": "table",
10374
+ "url": {
10375
+ "description": "MCP server URL (for remote servers)",
10376
+ "name": "url",
10123
10377
  "hasDynamicHelp": false,
10124
10378
  "multiple": false,
10125
- "options": [
10126
- "table",
10127
- "compact",
10128
- "json"
10129
- ],
10130
10379
  "type": "option"
10131
10380
  },
10132
- "all": {
10133
- "char": "a",
10134
- "description": "Show tickets across all projects",
10135
- "name": "all",
10136
- "allowNo": false,
10137
- "type": "boolean"
10138
- },
10139
- "label": {
10140
- "description": "Filter by label name",
10141
- "name": "label",
10381
+ "command": {
10382
+ "description": "Command to run (MCP server command or CLI tool binary)",
10383
+ "name": "command",
10142
10384
  "hasDynamicHelp": false,
10143
10385
  "multiple": false,
10144
10386
  "type": "option"
10145
10387
  },
10146
- "group-by": {
10147
- "char": "g",
10148
- "description": "Group tickets by field",
10149
- "name": "group-by",
10150
- "default": "status",
10388
+ "auth": {
10389
+ "description": "Environment variable for authentication (e.g., ARCADE_API_KEY)",
10390
+ "name": "auth",
10151
10391
  "hasDynamicHelp": false,
10152
10392
  "multiple": false,
10153
- "options": [
10154
- "status",
10155
- "priority"
10156
- ],
10157
10393
  "type": "option"
10158
10394
  },
10159
- "limit": {
10160
- "char": "l",
10161
- "description": "Maximum number of tickets to display",
10162
- "name": "limit",
10395
+ "detect": {
10396
+ "description": "Shell command to detect if CLI tool is installed",
10397
+ "name": "detect",
10163
10398
  "hasDynamicHelp": false,
10164
10399
  "multiple": false,
10165
10400
  "type": "option"
10166
10401
  },
10167
- "offset": {
10168
- "description": "Skip first N tickets (for pagination)",
10169
- "name": "offset",
10402
+ "install": {
10403
+ "description": "Shell command to install the CLI tool",
10404
+ "name": "install",
10170
10405
  "hasDynamicHelp": false,
10171
10406
  "multiple": false,
10172
10407
  "type": "option"
10173
10408
  },
10174
- "source": {
10175
- "description": "Ticket source: \"pmo\" for local DB, \"linear\" for Linear API, or \"auto\" to detect (default: auto)",
10176
- "name": "source",
10177
- "default": "auto",
10409
+ "description": {
10410
+ "char": "d",
10411
+ "description": "Human-readable description",
10412
+ "name": "description",
10413
+ "required": true,
10178
10414
  "hasDynamicHelp": false,
10179
10415
  "multiple": false,
10180
- "options": [
10181
- "auto",
10182
- "pmo",
10183
- "linear"
10184
- ],
10185
10416
  "type": "option"
10417
+ }
10418
+ },
10419
+ "hasDynamicHelp": false,
10420
+ "hiddenAliases": [],
10421
+ "id": "tools:add",
10422
+ "pluginAlias": "@proletariat/cli",
10423
+ "pluginName": "@proletariat/cli",
10424
+ "pluginType": "core",
10425
+ "strict": true,
10426
+ "isESM": true,
10427
+ "relativePath": [
10428
+ "dist",
10429
+ "commands",
10430
+ "tools",
10431
+ "add.js"
10432
+ ]
10433
+ },
10434
+ "tools:check": {
10435
+ "aliases": [],
10436
+ "args": {},
10437
+ "description": "Verify all registered tools are available and healthy",
10438
+ "examples": [
10439
+ "<%= config.bin %> tools check",
10440
+ "<%= config.bin %> tools check --json"
10441
+ ],
10442
+ "flags": {
10443
+ "json": {
10444
+ "description": "Output as JSON for AI agents/scripts",
10445
+ "name": "json",
10446
+ "allowNo": false,
10447
+ "type": "boolean"
10186
10448
  },
10187
- "team": {
10188
- "description": "Linear team key (fallback: PRLT_LINEAR_TEAM)",
10189
- "name": "team",
10190
- "hasDynamicHelp": false,
10191
- "multiple": false,
10192
- "type": "option"
10449
+ "machine": {
10450
+ "char": "m",
10451
+ "description": "Output as JSON for AI agents/scripts",
10452
+ "name": "machine",
10453
+ "allowNo": false,
10454
+ "type": "boolean"
10193
10455
  }
10194
10456
  },
10195
10457
  "hasDynamicHelp": false,
10196
10458
  "hiddenAliases": [],
10197
- "id": "ticket:list",
10459
+ "id": "tools:check",
10198
10460
  "pluginAlias": "@proletariat/cli",
10199
10461
  "pluginName": "@proletariat/cli",
10200
10462
  "pluginType": "core",
@@ -10204,42 +10466,20 @@
10204
10466
  "relativePath": [
10205
10467
  "dist",
10206
10468
  "commands",
10207
- "ticket",
10208
- "list.js"
10469
+ "tools",
10470
+ "check.js"
10209
10471
  ]
10210
10472
  },
10211
- "ticket:move": {
10473
+ "tools:detect": {
10212
10474
  "aliases": [],
10213
- "args": {
10214
- "ticketId": {
10215
- "description": "Ticket ID - prompts with dropdown if not provided",
10216
- "name": "ticketId",
10217
- "required": false
10218
- },
10219
- "column": {
10220
- "description": "Target column - prompts with dropdown if not provided",
10221
- "name": "column",
10222
- "required": false
10223
- }
10224
- },
10225
- "description": "Move ticket(s) to a different column",
10475
+ "args": {},
10476
+ "description": "Auto-detect common CLI tools on the system and register them",
10226
10477
  "examples": [
10227
- "<%= config.bin %> <%= command.id %> my-ticket \"In Progress\"",
10228
- "<%= config.bin %> <%= command.id %> implement-auth Done",
10229
- "<%= config.bin %> <%= command.id %> TKT-123 --status \"In Review\"",
10230
- "<%= config.bin %> <%= command.id %> fix-bug \"In Review\" --position 0",
10231
- "<%= config.bin %> <%= command.id %> TKT-123 --to-project PROJ-002",
10232
- "<%= config.bin %> <%= command.id %> --bulk"
10478
+ "<%= config.bin %> tools detect",
10479
+ "<%= config.bin %> tools detect --auto",
10480
+ "<%= config.bin %> tools detect --json"
10233
10481
  ],
10234
10482
  "flags": {
10235
- "project": {
10236
- "char": "P",
10237
- "description": "Project ID (uses first project if only one exists)",
10238
- "name": "project",
10239
- "hasDynamicHelp": false,
10240
- "multiple": false,
10241
- "type": "option"
10242
- },
10243
10483
  "json": {
10244
10484
  "description": "Output as JSON for AI agents/scripts",
10245
10485
  "name": "json",
@@ -10253,87 +10493,40 @@
10253
10493
  "allowNo": false,
10254
10494
  "type": "boolean"
10255
10495
  },
10256
- "status": {
10257
- "char": "s",
10258
- "description": "Target status/column (alternative to positional column argument)",
10259
- "name": "status",
10260
- "hasDynamicHelp": false,
10261
- "multiple": false,
10262
- "type": "option"
10263
- },
10264
- "position": {
10265
- "description": "Position within the column (0 = top)",
10266
- "name": "position",
10267
- "hasDynamicHelp": false,
10268
- "multiple": false,
10269
- "type": "option"
10270
- },
10271
- "to-project": {
10272
- "description": "Move ticket to a different project (uses Backlog/default column)",
10273
- "name": "to-project",
10274
- "hasDynamicHelp": false,
10275
- "multiple": false,
10276
- "type": "option"
10277
- },
10278
- "bulk": {
10279
- "char": "b",
10280
- "description": "Enable bulk mode to move multiple tickets",
10281
- "name": "bulk",
10282
- "allowNo": false,
10283
- "type": "boolean"
10284
- },
10285
- "force": {
10286
- "char": "f",
10287
- "description": "Skip confirmation prompt (bulk mode only)",
10288
- "name": "force",
10289
- "allowNo": false,
10290
- "type": "boolean"
10291
- },
10292
- "no-cleanup": {
10293
- "description": "Skip automatic worktree cleanup when moving to Done",
10294
- "name": "no-cleanup",
10496
+ "auto": {
10497
+ "description": "Automatically register all detected tools without prompting",
10498
+ "name": "auto",
10295
10499
  "allowNo": false,
10296
10500
  "type": "boolean"
10297
10501
  }
10298
10502
  },
10299
10503
  "hasDynamicHelp": false,
10300
10504
  "hiddenAliases": [],
10301
- "id": "ticket:move",
10505
+ "id": "tools:detect",
10302
10506
  "pluginAlias": "@proletariat/cli",
10303
10507
  "pluginName": "@proletariat/cli",
10304
10508
  "pluginType": "core",
10305
10509
  "strict": true,
10510
+ "enableJsonFlag": false,
10306
10511
  "isESM": true,
10307
10512
  "relativePath": [
10308
10513
  "dist",
10309
10514
  "commands",
10310
- "ticket",
10311
- "move.js"
10515
+ "tools",
10516
+ "detect.js"
10312
10517
  ]
10313
10518
  },
10314
- "ticket:show": {
10315
- "aliases": [],
10316
- "args": {
10317
- "ticketId": {
10318
- "description": "Ticket ID to view - prompts with dropdown if not provided",
10319
- "name": "ticketId",
10320
- "required": false
10321
- }
10322
- },
10323
- "description": "View detailed ticket information",
10519
+ "tools": {
10520
+ "aliases": [
10521
+ "tools:list"
10522
+ ],
10523
+ "args": {},
10524
+ "description": "Show all registered MCP servers and CLI tools",
10324
10525
  "examples": [
10325
- "<%= config.bin %> <%= command.id %> TICK-001",
10326
- "<%= config.bin %> <%= command.id %> # Interactive mode"
10526
+ "<%= config.bin %> tools",
10527
+ "<%= config.bin %> tools --json"
10327
10528
  ],
10328
10529
  "flags": {
10329
- "project": {
10330
- "char": "P",
10331
- "description": "Project ID (uses first project if only one exists)",
10332
- "name": "project",
10333
- "hasDynamicHelp": false,
10334
- "multiple": false,
10335
- "type": "option"
10336
- },
10337
10530
  "json": {
10338
10531
  "description": "Output as JSON for AI agents/scripts",
10339
10532
  "name": "json",
@@ -10350,49 +10543,35 @@
10350
10543
  },
10351
10544
  "hasDynamicHelp": false,
10352
10545
  "hiddenAliases": [],
10353
- "id": "ticket:show",
10546
+ "id": "tools",
10354
10547
  "pluginAlias": "@proletariat/cli",
10355
10548
  "pluginName": "@proletariat/cli",
10356
10549
  "pluginType": "core",
10357
10550
  "strict": true,
10551
+ "enableJsonFlag": false,
10358
10552
  "isESM": true,
10359
10553
  "relativePath": [
10360
10554
  "dist",
10361
10555
  "commands",
10362
- "ticket",
10363
- "show.js"
10556
+ "tools",
10557
+ "index.js"
10364
10558
  ]
10365
10559
  },
10366
- "ticket:update": {
10560
+ "tools:remove": {
10367
10561
  "aliases": [],
10368
10562
  "args": {
10369
- "ticketId": {
10370
- "description": "Ticket ID - prompts with dropdown if not provided",
10371
- "name": "ticketId",
10372
- "required": false
10563
+ "name": {
10564
+ "description": "Tool name to remove",
10565
+ "name": "name",
10566
+ "required": true
10373
10567
  }
10374
10568
  },
10375
- "description": "Update ticket fields (title, description, priority, category, labels, status)",
10569
+ "description": "Remove a tool from the registry",
10376
10570
  "examples": [
10377
- "<%= config.bin %> <%= command.id %> TKT-001 --title \"New title\"",
10378
- "<%= config.bin %> <%= command.id %> TKT-001 --description \"Updated description\"",
10379
- "<%= config.bin %> <%= command.id %> TKT-001 --description-file ./spec.md",
10380
- "<%= config.bin %> <%= command.id %> TKT-001 --priority P1",
10381
- "<%= config.bin %> <%= command.id %> TKT-001 --category bug",
10382
- "<%= config.bin %> <%= command.id %> TKT-001 --labels frontend,urgent",
10383
- "<%= config.bin %> <%= command.id %> TKT-001 --status \"In Progress\"",
10384
- "<%= config.bin %> <%= command.id %> TKT-001 --title \"Fix auth\" --priority P0 --status \"In Progress\" --json",
10385
- "<%= config.bin %> <%= command.id %> --bulk --priority P1"
10571
+ "<%= config.bin %> tools remove arcade",
10572
+ "<%= config.bin %> tools remove ffmpeg"
10386
10573
  ],
10387
10574
  "flags": {
10388
- "project": {
10389
- "char": "P",
10390
- "description": "Project ID (uses first project if only one exists)",
10391
- "name": "project",
10392
- "hasDynamicHelp": false,
10393
- "multiple": false,
10394
- "type": "option"
10395
- },
10396
10575
  "json": {
10397
10576
  "description": "Output as JSON for AI agents/scripts",
10398
10577
  "name": "json",
@@ -10405,90 +10584,22 @@
10405
10584
  "name": "machine",
10406
10585
  "allowNo": false,
10407
10586
  "type": "boolean"
10408
- },
10409
- "title": {
10410
- "char": "t",
10411
- "description": "Set ticket title",
10412
- "name": "title",
10413
- "hasDynamicHelp": false,
10414
- "multiple": false,
10415
- "type": "option"
10416
- },
10417
- "description": {
10418
- "char": "d",
10419
- "description": "Set ticket description",
10420
- "name": "description",
10421
- "hasDynamicHelp": false,
10422
- "multiple": false,
10423
- "type": "option"
10424
- },
10425
- "description-file": {
10426
- "description": "Read ticket description from a file",
10427
- "name": "description-file",
10428
- "hasDynamicHelp": false,
10429
- "multiple": false,
10430
- "type": "option"
10431
- },
10432
- "priority": {
10433
- "char": "p",
10434
- "description": "Set priority (uses workspace priority scale, \"none\" to clear)",
10435
- "name": "priority",
10436
- "hasDynamicHelp": false,
10437
- "multiple": false,
10438
- "type": "option"
10439
- },
10440
- "category": {
10441
- "char": "c",
10442
- "description": "Set category (e.g., feature, bug, refactor, \"none\" to clear)",
10443
- "name": "category",
10444
- "hasDynamicHelp": false,
10445
- "multiple": false,
10446
- "type": "option"
10447
- },
10448
- "labels": {
10449
- "char": "l",
10450
- "description": "Set labels (comma-separated, replaces existing labels; use \"\" to clear)",
10451
- "name": "labels",
10452
- "hasDynamicHelp": false,
10453
- "multiple": false,
10454
- "type": "option"
10455
- },
10456
- "status": {
10457
- "char": "s",
10458
- "description": "Set status/column (e.g., \"In Progress\", \"Done\")",
10459
- "name": "status",
10460
- "hasDynamicHelp": false,
10461
- "multiple": false,
10462
- "type": "option"
10463
- },
10464
- "bulk": {
10465
- "char": "b",
10466
- "description": "Enable bulk mode to update multiple tickets",
10467
- "name": "bulk",
10468
- "allowNo": false,
10469
- "type": "boolean"
10470
- },
10471
- "force": {
10472
- "char": "f",
10473
- "description": "Skip confirmation prompt",
10474
- "name": "force",
10475
- "allowNo": false,
10476
- "type": "boolean"
10477
10587
  }
10478
10588
  },
10479
10589
  "hasDynamicHelp": false,
10480
10590
  "hiddenAliases": [],
10481
- "id": "ticket:update",
10591
+ "id": "tools:remove",
10482
10592
  "pluginAlias": "@proletariat/cli",
10483
10593
  "pluginName": "@proletariat/cli",
10484
10594
  "pluginType": "core",
10485
10595
  "strict": true,
10596
+ "enableJsonFlag": false,
10486
10597
  "isESM": true,
10487
10598
  "relativePath": [
10488
10599
  "dist",
10489
10600
  "commands",
10490
- "ticket",
10491
- "update.js"
10601
+ "tools",
10602
+ "remove.js"
10492
10603
  ]
10493
10604
  },
10494
10605
  "trello:configure": {
@@ -14665,5 +14776,5 @@
14665
14776
  ]
14666
14777
  }
14667
14778
  },
14668
- "version": "0.3.110"
14779
+ "version": "0.3.111"
14669
14780
  }