@h-rig/cli 0.0.6-alpha.26 → 0.0.6-alpha.27

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 (5) hide show
  1. package/dist/bin/rig.js +48 -19
  2. package/dist/src/commands/_help-catalog.js +48 -19
  3. package/dist/src/commands.js +48 -19
  4. package/dist/src/index.js +48 -19
  5. package/package.json +6 -6
package/dist/bin/rig.js CHANGED
@@ -10787,6 +10787,23 @@ Warnings:`);
10787
10787
  // packages/cli/src/commands/_help-catalog.ts
10788
10788
  import pc4 from "picocolors";
10789
10789
  var PRIMARY_GROUPS = [
10790
+ {
10791
+ name: "init",
10792
+ summary: "Set up Rig for this repo: server, GitHub auth, checkout strategy, task source, and Pi wiring.",
10793
+ usage: ["rig init [--yes] [--server local|remote] [--repo owner/repo] [--remote-url <url>]"],
10794
+ commands: [
10795
+ { command: "init", description: "Interactive setup wizard for a new or existing Rig repo.", primary: true },
10796
+ { command: "init --yes", description: "Non-interactive setup using detected/default settings.", primary: true },
10797
+ { command: "init --server remote --remote-url <url>", description: "Link this repo to a remote Rig server.", primary: true },
10798
+ { command: "init --repair", description: "Repair missing private state without replacing project config." }
10799
+ ],
10800
+ examples: [
10801
+ "rig init",
10802
+ "rig init --yes --repo humanity-org/humanwork",
10803
+ "rig init --server remote --remote-url https://where.rig-does.work --repo owner/repo"
10804
+ ],
10805
+ next: ["After init, run `rig server status`.", "Then use `rig task list` and `rig task run --next` for day-to-day work."]
10806
+ },
10790
10807
  {
10791
10808
  name: "server",
10792
10809
  summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
@@ -10852,7 +10869,6 @@ var PRIMARY_GROUPS = [
10852
10869
  }
10853
10870
  ];
10854
10871
  var ADVANCED_GROUPS = [
10855
- { name: "init", summary: "Initialize or repair Rig project state.", usage: ["rig init [options]"], commands: [{ command: "init", description: "Configure project/server/GitHub integration." }] },
10856
10872
  { name: "connect", summary: "Compatibility alias for `rig server` selection commands.", usage: ["rig connect <status|list|add|use>"], commands: [{ command: "status|list|add|use", description: "Use `rig server ...` for the primary UX." }] },
10857
10873
  { name: "github", summary: "GitHub auth helpers.", usage: ["rig github auth <status|import-gh|token>"], commands: [{ command: "auth status", description: "Show GitHub auth state." }] },
10858
10874
  { name: "doctor", summary: "Diagnostics for project/server/GitHub/Pi state.", usage: ["rig doctor [check|run|shared|...]"], commands: [{ command: "check", description: "Run diagnostics." }] },
@@ -10880,7 +10896,7 @@ function heading(title) {
10880
10896
  }
10881
10897
  function commandLine(command, description) {
10882
10898
  const commandColumn = command.length >= 34 ? `${command} ` : command.padEnd(34);
10883
- return ` ${pc4.bold(commandColumn)} ${description}`;
10899
+ return `${pc4.dim("\u2502")} ${pc4.bold(commandColumn)} ${description}`;
10884
10900
  }
10885
10901
  function renderGroup(group) {
10886
10902
  const lines = [
@@ -10906,27 +10922,40 @@ function renderGroup(group) {
10906
10922
  }
10907
10923
  function renderTopLevelHelp() {
10908
10924
  return [
10909
- `${heading("rig")} \u2014 server-owned task/run control plane`,
10925
+ `${heading("rig")} ${pc4.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
10926
+ pc4.dim("A repo-local CLI for setup, server selection, task runs, live attach, and completion review."),
10927
+ "",
10928
+ `${pc4.bold(pc4.magenta("\u25C7 Start here"))} \u2014 ${pc4.dim("bootstrap a repo and choose where Rig runs")}`,
10929
+ commandLine("rig init", "Interactive setup: project config, GitHub auth, task source, server, checkout, Pi."),
10930
+ commandLine("rig init --yes", "Non-interactive setup using detected defaults; good for repeatable installs."),
10931
+ commandLine("rig server status", "Show whether this repo is using local Rig or a remote server."),
10932
+ commandLine("rig server use <alias|local>", "Switch the server that owns task/run state for this repo."),
10933
+ "",
10934
+ `${pc4.bold(pc4.magenta("\u25C7 Daily task loop"))} \u2014 ${pc4.dim("find work, start a worker, and rejoin it later")}`,
10935
+ commandLine("rig task list", "List tasks from the selected task source/server with status, labels, and source."),
10936
+ commandLine("rig task next", "Pick the next matching task without starting it."),
10937
+ commandLine("rig task run --next", "Start the next task and attach to the live bundled Pi frontend."),
10938
+ commandLine("rig task run #123 --detach", "Submit a specific issue/task and return immediately."),
10910
10939
  "",
10911
- pc4.bold("Common workflows"),
10912
- " rig server status Show selected local/remote server",
10913
- " rig task list List available work",
10914
- " rig task run --next Start next task and attach with native Pi",
10915
- " rig run list List recent runs",
10916
- " rig run attach <run-id> --follow Rejoin a live run",
10940
+ `${pc4.bold(pc4.magenta("\u25C7 Live run control"))} \u2014 ${pc4.dim("observe, steer, stop, or inspect active runs")}`,
10941
+ commandLine("rig run list", "Show recent/active runs from the selected server or local state."),
10942
+ commandLine("rig run attach <run-id> --follow", "Open the native Pi live view for a worker-backed run."),
10943
+ commandLine("rig run show --run <id>", "Print one run record; add `--json` for automation."),
10944
+ commandLine("rig run stop <run-id>", "Request cancellation for a running worker."),
10917
10945
  "",
10918
- pc4.bold("Primary groups"),
10946
+ `${pc4.bold(pc4.magenta("\u25C7 Core groups"))} \u2014 ${pc4.dim("run `rig <group> --help` for detailed commands and examples")}`,
10919
10947
  ...PRIMARY_GROUPS.map((group) => commandLine(group.name, group.summary)),
10948
+ commandLine("doctor", "Diagnose project/server/GitHub/task/Pi wiring when setup or runs misbehave."),
10920
10949
  "",
10921
- pc4.bold("Help"),
10922
- " rig <group> --help Rich help for server, task, run, and other groups",
10923
- " rig help --advanced Legacy/dev/compat command surface",
10924
- " rig --version Print version",
10950
+ `${pc4.bold(pc4.magenta("\u25C7 More"))}`,
10951
+ commandLine("rig help --advanced", "Legacy, dev, diagnostics, browser, queue, agent, remote, git, harness commands."),
10952
+ commandLine("rig <group> --help", "Rich per-group help with usage, descriptions, examples, and next steps."),
10953
+ commandLine("rig --version", "Print the installed Rig CLI version."),
10925
10954
  "",
10926
- pc4.bold("Global options"),
10927
- " --project <path> Use a project root instead of auto-discovery",
10928
- " --json Output structured JSON",
10929
- " --dry-run Print command execution plan only"
10955
+ `${pc4.bold(pc4.magenta("\u25C7 Global options"))}`,
10956
+ commandLine("--project <path>", "Use a project root instead of auto-discovery."),
10957
+ commandLine("--json", "Emit structured output for scripts/agents."),
10958
+ commandLine("--dry-run", "Print the command plan without mutating state.")
10930
10959
  ].join(`
10931
10960
  `);
10932
10961
  }
@@ -10935,7 +10964,7 @@ function renderAdvancedHelp() {
10935
10964
  `${heading("rig advanced")} \u2014 legacy, dev, and compatibility groups`,
10936
10965
  "",
10937
10966
  pc4.bold("Primary groups are still"),
10938
- " server, task, run",
10967
+ " init, server, task, run",
10939
10968
  "",
10940
10969
  pc4.bold("Advanced groups"),
10941
10970
  ...ADVANCED_GROUPS.map((group) => commandLine(group.name, group.summary)),
package/dist/src/commands/_help-catalog.js CHANGED
@@ -2,6 +2,23 @@
2
2
  // packages/cli/src/commands/_help-catalog.ts
3
3
  import pc from "picocolors";
4
4
  var PRIMARY_GROUPS = [
5
+ {
6
+ name: "init",
7
+ summary: "Set up Rig for this repo: server, GitHub auth, checkout strategy, task source, and Pi wiring.",
8
+ usage: ["rig init [--yes] [--server local|remote] [--repo owner/repo] [--remote-url <url>]"],
9
+ commands: [
10
+ { command: "init", description: "Interactive setup wizard for a new or existing Rig repo.", primary: true },
11
+ { command: "init --yes", description: "Non-interactive setup using detected/default settings.", primary: true },
12
+ { command: "init --server remote --remote-url <url>", description: "Link this repo to a remote Rig server.", primary: true },
13
+ { command: "init --repair", description: "Repair missing private state without replacing project config." }
14
+ ],
15
+ examples: [
16
+ "rig init",
17
+ "rig init --yes --repo humanity-org/humanwork",
18
+ "rig init --server remote --remote-url https://where.rig-does.work --repo owner/repo"
19
+ ],
20
+ next: ["After init, run `rig server status`.", "Then use `rig task list` and `rig task run --next` for day-to-day work."]
21
+ },
5
22
  {
6
23
  name: "server",
7
24
  summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
@@ -67,7 +84,6 @@ var PRIMARY_GROUPS = [
67
84
  }
68
85
  ];
69
86
  var ADVANCED_GROUPS = [
70
- { name: "init", summary: "Initialize or repair Rig project state.", usage: ["rig init [options]"], commands: [{ command: "init", description: "Configure project/server/GitHub integration." }] },
71
87
  { name: "connect", summary: "Compatibility alias for `rig server` selection commands.", usage: ["rig connect <status|list|add|use>"], commands: [{ command: "status|list|add|use", description: "Use `rig server ...` for the primary UX." }] },
72
88
  { name: "github", summary: "GitHub auth helpers.", usage: ["rig github auth <status|import-gh|token>"], commands: [{ command: "auth status", description: "Show GitHub auth state." }] },
73
89
  { name: "doctor", summary: "Diagnostics for project/server/GitHub/Pi state.", usage: ["rig doctor [check|run|shared|...]"], commands: [{ command: "check", description: "Run diagnostics." }] },
@@ -95,7 +111,7 @@ function heading(title) {
95
111
  }
96
112
  function commandLine(command, description) {
97
113
  const commandColumn = command.length >= 34 ? `${command} ` : command.padEnd(34);
98
- return ` ${pc.bold(commandColumn)} ${description}`;
114
+ return `${pc.dim("\u2502")} ${pc.bold(commandColumn)} ${description}`;
99
115
  }
100
116
  function renderGroup(group) {
101
117
  const lines = [
@@ -121,27 +137,40 @@ function renderGroup(group) {
121
137
  }
122
138
  function renderTopLevelHelp() {
123
139
  return [
124
- `${heading("rig")} \u2014 server-owned task/run control plane`,
140
+ `${heading("rig")} ${pc.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
141
+ pc.dim("A repo-local CLI for setup, server selection, task runs, live attach, and completion review."),
142
+ "",
143
+ `${pc.bold(pc.magenta("\u25C7 Start here"))} \u2014 ${pc.dim("bootstrap a repo and choose where Rig runs")}`,
144
+ commandLine("rig init", "Interactive setup: project config, GitHub auth, task source, server, checkout, Pi."),
145
+ commandLine("rig init --yes", "Non-interactive setup using detected defaults; good for repeatable installs."),
146
+ commandLine("rig server status", "Show whether this repo is using local Rig or a remote server."),
147
+ commandLine("rig server use <alias|local>", "Switch the server that owns task/run state for this repo."),
148
+ "",
149
+ `${pc.bold(pc.magenta("\u25C7 Daily task loop"))} \u2014 ${pc.dim("find work, start a worker, and rejoin it later")}`,
150
+ commandLine("rig task list", "List tasks from the selected task source/server with status, labels, and source."),
151
+ commandLine("rig task next", "Pick the next matching task without starting it."),
152
+ commandLine("rig task run --next", "Start the next task and attach to the live bundled Pi frontend."),
153
+ commandLine("rig task run #123 --detach", "Submit a specific issue/task and return immediately."),
125
154
  "",
126
- pc.bold("Common workflows"),
127
- " rig server status Show selected local/remote server",
128
- " rig task list List available work",
129
- " rig task run --next Start next task and attach with native Pi",
130
- " rig run list List recent runs",
131
- " rig run attach <run-id> --follow Rejoin a live run",
155
+ `${pc.bold(pc.magenta("\u25C7 Live run control"))} \u2014 ${pc.dim("observe, steer, stop, or inspect active runs")}`,
156
+ commandLine("rig run list", "Show recent/active runs from the selected server or local state."),
157
+ commandLine("rig run attach <run-id> --follow", "Open the native Pi live view for a worker-backed run."),
158
+ commandLine("rig run show --run <id>", "Print one run record; add `--json` for automation."),
159
+ commandLine("rig run stop <run-id>", "Request cancellation for a running worker."),
132
160
  "",
133
- pc.bold("Primary groups"),
161
+ `${pc.bold(pc.magenta("\u25C7 Core groups"))} \u2014 ${pc.dim("run `rig <group> --help` for detailed commands and examples")}`,
134
162
  ...PRIMARY_GROUPS.map((group) => commandLine(group.name, group.summary)),
163
+ commandLine("doctor", "Diagnose project/server/GitHub/task/Pi wiring when setup or runs misbehave."),
135
164
  "",
136
- pc.bold("Help"),
137
- " rig <group> --help Rich help for server, task, run, and other groups",
138
- " rig help --advanced Legacy/dev/compat command surface",
139
- " rig --version Print version",
165
+ `${pc.bold(pc.magenta("\u25C7 More"))}`,
166
+ commandLine("rig help --advanced", "Legacy, dev, diagnostics, browser, queue, agent, remote, git, harness commands."),
167
+ commandLine("rig <group> --help", "Rich per-group help with usage, descriptions, examples, and next steps."),
168
+ commandLine("rig --version", "Print the installed Rig CLI version."),
140
169
  "",
141
- pc.bold("Global options"),
142
- " --project <path> Use a project root instead of auto-discovery",
143
- " --json Output structured JSON",
144
- " --dry-run Print command execution plan only"
170
+ `${pc.bold(pc.magenta("\u25C7 Global options"))}`,
171
+ commandLine("--project <path>", "Use a project root instead of auto-discovery."),
172
+ commandLine("--json", "Emit structured output for scripts/agents."),
173
+ commandLine("--dry-run", "Print the command plan without mutating state.")
145
174
  ].join(`
146
175
  `);
147
176
  }
@@ -150,7 +179,7 @@ function renderAdvancedHelp() {
150
179
  `${heading("rig advanced")} \u2014 legacy, dev, and compatibility groups`,
151
180
  "",
152
181
  pc.bold("Primary groups are still"),
153
- " server, task, run",
182
+ " init, server, task, run",
154
183
  "",
155
184
  pc.bold("Advanced groups"),
156
185
  ...ADVANCED_GROUPS.map((group) => commandLine(group.name, group.summary)),
package/dist/src/commands.js CHANGED
@@ -10580,6 +10580,23 @@ Warnings:`);
10580
10580
  // packages/cli/src/commands/_help-catalog.ts
10581
10581
  import pc4 from "picocolors";
10582
10582
  var PRIMARY_GROUPS = [
10583
+ {
10584
+ name: "init",
10585
+ summary: "Set up Rig for this repo: server, GitHub auth, checkout strategy, task source, and Pi wiring.",
10586
+ usage: ["rig init [--yes] [--server local|remote] [--repo owner/repo] [--remote-url <url>]"],
10587
+ commands: [
10588
+ { command: "init", description: "Interactive setup wizard for a new or existing Rig repo.", primary: true },
10589
+ { command: "init --yes", description: "Non-interactive setup using detected/default settings.", primary: true },
10590
+ { command: "init --server remote --remote-url <url>", description: "Link this repo to a remote Rig server.", primary: true },
10591
+ { command: "init --repair", description: "Repair missing private state without replacing project config." }
10592
+ ],
10593
+ examples: [
10594
+ "rig init",
10595
+ "rig init --yes --repo humanity-org/humanwork",
10596
+ "rig init --server remote --remote-url https://where.rig-does.work --repo owner/repo"
10597
+ ],
10598
+ next: ["After init, run `rig server status`.", "Then use `rig task list` and `rig task run --next` for day-to-day work."]
10599
+ },
10583
10600
  {
10584
10601
  name: "server",
10585
10602
  summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
@@ -10645,7 +10662,6 @@ var PRIMARY_GROUPS = [
10645
10662
  }
10646
10663
  ];
10647
10664
  var ADVANCED_GROUPS = [
10648
- { name: "init", summary: "Initialize or repair Rig project state.", usage: ["rig init [options]"], commands: [{ command: "init", description: "Configure project/server/GitHub integration." }] },
10649
10665
  { name: "connect", summary: "Compatibility alias for `rig server` selection commands.", usage: ["rig connect <status|list|add|use>"], commands: [{ command: "status|list|add|use", description: "Use `rig server ...` for the primary UX." }] },
10650
10666
  { name: "github", summary: "GitHub auth helpers.", usage: ["rig github auth <status|import-gh|token>"], commands: [{ command: "auth status", description: "Show GitHub auth state." }] },
10651
10667
  { name: "doctor", summary: "Diagnostics for project/server/GitHub/Pi state.", usage: ["rig doctor [check|run|shared|...]"], commands: [{ command: "check", description: "Run diagnostics." }] },
@@ -10673,7 +10689,7 @@ function heading(title) {
10673
10689
  }
10674
10690
  function commandLine(command, description) {
10675
10691
  const commandColumn = command.length >= 34 ? `${command} ` : command.padEnd(34);
10676
- return ` ${pc4.bold(commandColumn)} ${description}`;
10692
+ return `${pc4.dim("\u2502")} ${pc4.bold(commandColumn)} ${description}`;
10677
10693
  }
10678
10694
  function renderGroup(group) {
10679
10695
  const lines = [
@@ -10699,27 +10715,40 @@ function renderGroup(group) {
10699
10715
  }
10700
10716
  function renderTopLevelHelp() {
10701
10717
  return [
10702
- `${heading("rig")} \u2014 server-owned task/run control plane`,
10718
+ `${heading("rig")} ${pc4.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
10719
+ pc4.dim("A repo-local CLI for setup, server selection, task runs, live attach, and completion review."),
10720
+ "",
10721
+ `${pc4.bold(pc4.magenta("\u25C7 Start here"))} \u2014 ${pc4.dim("bootstrap a repo and choose where Rig runs")}`,
10722
+ commandLine("rig init", "Interactive setup: project config, GitHub auth, task source, server, checkout, Pi."),
10723
+ commandLine("rig init --yes", "Non-interactive setup using detected defaults; good for repeatable installs."),
10724
+ commandLine("rig server status", "Show whether this repo is using local Rig or a remote server."),
10725
+ commandLine("rig server use <alias|local>", "Switch the server that owns task/run state for this repo."),
10726
+ "",
10727
+ `${pc4.bold(pc4.magenta("\u25C7 Daily task loop"))} \u2014 ${pc4.dim("find work, start a worker, and rejoin it later")}`,
10728
+ commandLine("rig task list", "List tasks from the selected task source/server with status, labels, and source."),
10729
+ commandLine("rig task next", "Pick the next matching task without starting it."),
10730
+ commandLine("rig task run --next", "Start the next task and attach to the live bundled Pi frontend."),
10731
+ commandLine("rig task run #123 --detach", "Submit a specific issue/task and return immediately."),
10703
10732
  "",
10704
- pc4.bold("Common workflows"),
10705
- " rig server status Show selected local/remote server",
10706
- " rig task list List available work",
10707
- " rig task run --next Start next task and attach with native Pi",
10708
- " rig run list List recent runs",
10709
- " rig run attach <run-id> --follow Rejoin a live run",
10733
+ `${pc4.bold(pc4.magenta("\u25C7 Live run control"))} \u2014 ${pc4.dim("observe, steer, stop, or inspect active runs")}`,
10734
+ commandLine("rig run list", "Show recent/active runs from the selected server or local state."),
10735
+ commandLine("rig run attach <run-id> --follow", "Open the native Pi live view for a worker-backed run."),
10736
+ commandLine("rig run show --run <id>", "Print one run record; add `--json` for automation."),
10737
+ commandLine("rig run stop <run-id>", "Request cancellation for a running worker."),
10710
10738
  "",
10711
- pc4.bold("Primary groups"),
10739
+ `${pc4.bold(pc4.magenta("\u25C7 Core groups"))} \u2014 ${pc4.dim("run `rig <group> --help` for detailed commands and examples")}`,
10712
10740
  ...PRIMARY_GROUPS.map((group) => commandLine(group.name, group.summary)),
10741
+ commandLine("doctor", "Diagnose project/server/GitHub/task/Pi wiring when setup or runs misbehave."),
10713
10742
  "",
10714
- pc4.bold("Help"),
10715
- " rig <group> --help Rich help for server, task, run, and other groups",
10716
- " rig help --advanced Legacy/dev/compat command surface",
10717
- " rig --version Print version",
10743
+ `${pc4.bold(pc4.magenta("\u25C7 More"))}`,
10744
+ commandLine("rig help --advanced", "Legacy, dev, diagnostics, browser, queue, agent, remote, git, harness commands."),
10745
+ commandLine("rig <group> --help", "Rich per-group help with usage, descriptions, examples, and next steps."),
10746
+ commandLine("rig --version", "Print the installed Rig CLI version."),
10718
10747
  "",
10719
- pc4.bold("Global options"),
10720
- " --project <path> Use a project root instead of auto-discovery",
10721
- " --json Output structured JSON",
10722
- " --dry-run Print command execution plan only"
10748
+ `${pc4.bold(pc4.magenta("\u25C7 Global options"))}`,
10749
+ commandLine("--project <path>", "Use a project root instead of auto-discovery."),
10750
+ commandLine("--json", "Emit structured output for scripts/agents."),
10751
+ commandLine("--dry-run", "Print the command plan without mutating state.")
10723
10752
  ].join(`
10724
10753
  `);
10725
10754
  }
@@ -10728,7 +10757,7 @@ function renderAdvancedHelp() {
10728
10757
  `${heading("rig advanced")} \u2014 legacy, dev, and compatibility groups`,
10729
10758
  "",
10730
10759
  pc4.bold("Primary groups are still"),
10731
- " server, task, run",
10760
+ " init, server, task, run",
10732
10761
  "",
10733
10762
  pc4.bold("Advanced groups"),
10734
10763
  ...ADVANCED_GROUPS.map((group) => commandLine(group.name, group.summary)),
package/dist/src/index.js CHANGED
@@ -10783,6 +10783,23 @@ Warnings:`);
10783
10783
  // packages/cli/src/commands/_help-catalog.ts
10784
10784
  import pc4 from "picocolors";
10785
10785
  var PRIMARY_GROUPS = [
10786
+ {
10787
+ name: "init",
10788
+ summary: "Set up Rig for this repo: server, GitHub auth, checkout strategy, task source, and Pi wiring.",
10789
+ usage: ["rig init [--yes] [--server local|remote] [--repo owner/repo] [--remote-url <url>]"],
10790
+ commands: [
10791
+ { command: "init", description: "Interactive setup wizard for a new or existing Rig repo.", primary: true },
10792
+ { command: "init --yes", description: "Non-interactive setup using detected/default settings.", primary: true },
10793
+ { command: "init --server remote --remote-url <url>", description: "Link this repo to a remote Rig server.", primary: true },
10794
+ { command: "init --repair", description: "Repair missing private state without replacing project config." }
10795
+ ],
10796
+ examples: [
10797
+ "rig init",
10798
+ "rig init --yes --repo humanity-org/humanwork",
10799
+ "rig init --server remote --remote-url https://where.rig-does.work --repo owner/repo"
10800
+ ],
10801
+ next: ["After init, run `rig server status`.", "Then use `rig task list` and `rig task run --next` for day-to-day work."]
10802
+ },
10786
10803
  {
10787
10804
  name: "server",
10788
10805
  summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
@@ -10848,7 +10865,6 @@ var PRIMARY_GROUPS = [
10848
10865
  }
10849
10866
  ];
10850
10867
  var ADVANCED_GROUPS = [
10851
- { name: "init", summary: "Initialize or repair Rig project state.", usage: ["rig init [options]"], commands: [{ command: "init", description: "Configure project/server/GitHub integration." }] },
10852
10868
  { name: "connect", summary: "Compatibility alias for `rig server` selection commands.", usage: ["rig connect <status|list|add|use>"], commands: [{ command: "status|list|add|use", description: "Use `rig server ...` for the primary UX." }] },
10853
10869
  { name: "github", summary: "GitHub auth helpers.", usage: ["rig github auth <status|import-gh|token>"], commands: [{ command: "auth status", description: "Show GitHub auth state." }] },
10854
10870
  { name: "doctor", summary: "Diagnostics for project/server/GitHub/Pi state.", usage: ["rig doctor [check|run|shared|...]"], commands: [{ command: "check", description: "Run diagnostics." }] },
@@ -10876,7 +10892,7 @@ function heading(title) {
10876
10892
  }
10877
10893
  function commandLine(command, description) {
10878
10894
  const commandColumn = command.length >= 34 ? `${command} ` : command.padEnd(34);
10879
- return ` ${pc4.bold(commandColumn)} ${description}`;
10895
+ return `${pc4.dim("\u2502")} ${pc4.bold(commandColumn)} ${description}`;
10880
10896
  }
10881
10897
  function renderGroup(group) {
10882
10898
  const lines = [
@@ -10902,27 +10918,40 @@ function renderGroup(group) {
10902
10918
  }
10903
10919
  function renderTopLevelHelp() {
10904
10920
  return [
10905
- `${heading("rig")} \u2014 server-owned task/run control plane`,
10921
+ `${heading("rig")} ${pc4.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
10922
+ pc4.dim("A repo-local CLI for setup, server selection, task runs, live attach, and completion review."),
10923
+ "",
10924
+ `${pc4.bold(pc4.magenta("\u25C7 Start here"))} \u2014 ${pc4.dim("bootstrap a repo and choose where Rig runs")}`,
10925
+ commandLine("rig init", "Interactive setup: project config, GitHub auth, task source, server, checkout, Pi."),
10926
+ commandLine("rig init --yes", "Non-interactive setup using detected defaults; good for repeatable installs."),
10927
+ commandLine("rig server status", "Show whether this repo is using local Rig or a remote server."),
10928
+ commandLine("rig server use <alias|local>", "Switch the server that owns task/run state for this repo."),
10929
+ "",
10930
+ `${pc4.bold(pc4.magenta("\u25C7 Daily task loop"))} \u2014 ${pc4.dim("find work, start a worker, and rejoin it later")}`,
10931
+ commandLine("rig task list", "List tasks from the selected task source/server with status, labels, and source."),
10932
+ commandLine("rig task next", "Pick the next matching task without starting it."),
10933
+ commandLine("rig task run --next", "Start the next task and attach to the live bundled Pi frontend."),
10934
+ commandLine("rig task run #123 --detach", "Submit a specific issue/task and return immediately."),
10906
10935
  "",
10907
- pc4.bold("Common workflows"),
10908
- " rig server status Show selected local/remote server",
10909
- " rig task list List available work",
10910
- " rig task run --next Start next task and attach with native Pi",
10911
- " rig run list List recent runs",
10912
- " rig run attach <run-id> --follow Rejoin a live run",
10936
+ `${pc4.bold(pc4.magenta("\u25C7 Live run control"))} \u2014 ${pc4.dim("observe, steer, stop, or inspect active runs")}`,
10937
+ commandLine("rig run list", "Show recent/active runs from the selected server or local state."),
10938
+ commandLine("rig run attach <run-id> --follow", "Open the native Pi live view for a worker-backed run."),
10939
+ commandLine("rig run show --run <id>", "Print one run record; add `--json` for automation."),
10940
+ commandLine("rig run stop <run-id>", "Request cancellation for a running worker."),
10913
10941
  "",
10914
- pc4.bold("Primary groups"),
10942
+ `${pc4.bold(pc4.magenta("\u25C7 Core groups"))} \u2014 ${pc4.dim("run `rig <group> --help` for detailed commands and examples")}`,
10915
10943
  ...PRIMARY_GROUPS.map((group) => commandLine(group.name, group.summary)),
10944
+ commandLine("doctor", "Diagnose project/server/GitHub/task/Pi wiring when setup or runs misbehave."),
10916
10945
  "",
10917
- pc4.bold("Help"),
10918
- " rig <group> --help Rich help for server, task, run, and other groups",
10919
- " rig help --advanced Legacy/dev/compat command surface",
10920
- " rig --version Print version",
10946
+ `${pc4.bold(pc4.magenta("\u25C7 More"))}`,
10947
+ commandLine("rig help --advanced", "Legacy, dev, diagnostics, browser, queue, agent, remote, git, harness commands."),
10948
+ commandLine("rig <group> --help", "Rich per-group help with usage, descriptions, examples, and next steps."),
10949
+ commandLine("rig --version", "Print the installed Rig CLI version."),
10921
10950
  "",
10922
- pc4.bold("Global options"),
10923
- " --project <path> Use a project root instead of auto-discovery",
10924
- " --json Output structured JSON",
10925
- " --dry-run Print command execution plan only"
10951
+ `${pc4.bold(pc4.magenta("\u25C7 Global options"))}`,
10952
+ commandLine("--project <path>", "Use a project root instead of auto-discovery."),
10953
+ commandLine("--json", "Emit structured output for scripts/agents."),
10954
+ commandLine("--dry-run", "Print the command plan without mutating state.")
10926
10955
  ].join(`
10927
10956
  `);
10928
10957
  }
@@ -10931,7 +10960,7 @@ function renderAdvancedHelp() {
10931
10960
  `${heading("rig advanced")} \u2014 legacy, dev, and compatibility groups`,
10932
10961
  "",
10933
10962
  pc4.bold("Primary groups are still"),
10934
- " server, task, run",
10963
+ " init, server, task, run",
10935
10964
  "",
10936
10965
  pc4.bold("Advanced groups"),
10937
10966
  ...ADVANCED_GROUPS.map((group) => commandLine(group.name, group.summary)),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@h-rig/cli",
3
- "version": "0.0.6-alpha.26",
3
+ "version": "0.0.6-alpha.27",
4
4
  "type": "module",
5
5
  "description": "Rig package",
6
6
  "license": "UNLICENSED",
@@ -23,11 +23,11 @@
23
23
  },
24
24
  "dependencies": {
25
25
  "@clack/prompts": "^1.2.0",
26
- "@earendil-works/pi-coding-agent": "npm:@h-rig/pi-coding-agent@0.0.6-alpha.26",
27
- "@rig/core": "npm:@h-rig/core@0.0.6-alpha.26",
28
- "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.26",
29
- "@rig/client": "npm:@h-rig/client@0.0.6-alpha.26",
30
- "@rig/server": "npm:@h-rig/server@0.0.6-alpha.26",
26
+ "@earendil-works/pi-coding-agent": "npm:@h-rig/pi-coding-agent@0.0.6-alpha.27",
27
+ "@rig/core": "npm:@h-rig/core@0.0.6-alpha.27",
28
+ "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.27",
29
+ "@rig/client": "npm:@h-rig/client@0.0.6-alpha.27",
30
+ "@rig/server": "npm:@h-rig/server@0.0.6-alpha.27",
31
31
  "picocolors": "^1.1.1"
32
32
  }
33
33
  }