@exla/rudder 4.0.0-alpha.7 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/README.md +33 -69
  2. package/dist/agent-efficiency/backend-observer.d.ts +13 -0
  3. package/dist/agent-efficiency/backend-observer.js +77 -0
  4. package/dist/agent-efficiency/backend-observer.js.map +1 -0
  5. package/dist/agent-efficiency/handoff.d.ts +9 -0
  6. package/dist/agent-efficiency/handoff.js +42 -0
  7. package/dist/agent-efficiency/handoff.js.map +1 -0
  8. package/dist/agent-efficiency/index.d.ts +11 -0
  9. package/dist/agent-efficiency/index.js +7 -0
  10. package/dist/agent-efficiency/index.js.map +1 -0
  11. package/dist/agent-efficiency/lessons.d.ts +55 -0
  12. package/dist/agent-efficiency/lessons.js +107 -0
  13. package/dist/agent-efficiency/lessons.js.map +1 -0
  14. package/dist/agent-efficiency/privacy.d.ts +6 -0
  15. package/dist/agent-efficiency/privacy.js +28 -0
  16. package/dist/agent-efficiency/privacy.js.map +1 -0
  17. package/dist/agent-efficiency/production.d.ts +16 -0
  18. package/dist/agent-efficiency/production.js +120 -0
  19. package/dist/agent-efficiency/production.js.map +1 -0
  20. package/dist/agent-efficiency/storage.d.ts +3 -0
  21. package/dist/agent-efficiency/storage.js +28 -0
  22. package/dist/agent-efficiency/storage.js.map +1 -0
  23. package/dist/agent-efficiency/telemetry.d.ts +59 -0
  24. package/dist/agent-efficiency/telemetry.js +143 -0
  25. package/dist/agent-efficiency/telemetry.js.map +1 -0
  26. package/dist/agent-efficiency/trace-lessons.d.ts +21 -0
  27. package/dist/agent-efficiency/trace-lessons.js +36 -0
  28. package/dist/agent-efficiency/trace-lessons.js.map +1 -0
  29. package/dist/agent-efficiency/waits.d.ts +52 -0
  30. package/dist/agent-efficiency/waits.js +131 -0
  31. package/dist/agent-efficiency/waits.js.map +1 -0
  32. package/dist/backends.js +14 -8
  33. package/dist/backends.js.map +1 -1
  34. package/dist/board/authority.d.ts +48 -0
  35. package/dist/board/authority.js +125 -0
  36. package/dist/board/authority.js.map +1 -0
  37. package/dist/board/board.js +6 -2
  38. package/dist/board/daemon.d.ts +3 -6
  39. package/dist/board/daemon.js +242 -222
  40. package/dist/board/daemon.js.map +1 -1
  41. package/dist/board/host-access.d.ts +8 -0
  42. package/dist/board/host-access.js +222 -0
  43. package/dist/board/host-access.js.map +1 -0
  44. package/dist/board/project-files.d.ts +12 -0
  45. package/dist/board/project-files.js +78 -0
  46. package/dist/board/project-files.js.map +1 -0
  47. package/dist/brain.d.ts +2 -1
  48. package/dist/brain.js +15 -21
  49. package/dist/brain.js.map +1 -1
  50. package/dist/claude-sdk-protocol.js +10 -7
  51. package/dist/claude-sdk-protocol.js.map +1 -1
  52. package/dist/cloud-build-profile.d.ts +22 -0
  53. package/dist/cloud-build-profile.js +160 -0
  54. package/dist/cloud-build-profile.js.map +1 -0
  55. package/dist/cloud.js +23 -470
  56. package/dist/cloud.js.map +1 -1
  57. package/dist/codex-binary.d.ts +1 -0
  58. package/dist/codex-binary.js +8 -1
  59. package/dist/codex-binary.js.map +1 -1
  60. package/dist/daemon.d.ts +2 -0
  61. package/dist/daemon.js +14 -2
  62. package/dist/daemon.js.map +1 -1
  63. package/dist/effort.d.ts +8 -0
  64. package/dist/effort.js +15 -2
  65. package/dist/effort.js.map +1 -1
  66. package/dist/engine-authority.js +16 -0
  67. package/dist/engine-authority.js.map +1 -1
  68. package/dist/engine.d.ts +1 -1
  69. package/dist/engine.js +11 -2
  70. package/dist/engine.js.map +1 -1
  71. package/dist/fabric-fetch.d.ts +25 -0
  72. package/dist/fabric-fetch.js +402 -0
  73. package/dist/fabric-fetch.js.map +1 -0
  74. package/dist/fabric-local.d.ts +5 -2
  75. package/dist/fabric-local.js +36 -1
  76. package/dist/fabric-local.js.map +1 -1
  77. package/dist/fabric-remote.d.ts +76 -1
  78. package/dist/fabric-remote.js +333 -61
  79. package/dist/fabric-remote.js.map +1 -1
  80. package/dist/git.js +23 -0
  81. package/dist/git.js.map +1 -1
  82. package/dist/graph.js +9 -1
  83. package/dist/graph.js.map +1 -1
  84. package/dist/jj.d.ts +3 -1
  85. package/dist/jj.js +34 -2
  86. package/dist/jj.js.map +1 -1
  87. package/dist/main.js +102 -310
  88. package/dist/main.js.map +1 -1
  89. package/dist/migration.d.ts +2 -0
  90. package/dist/migration.js +3 -0
  91. package/dist/migration.js.map +1 -1
  92. package/dist/models.js +11 -6
  93. package/dist/models.js.map +1 -1
  94. package/dist/native/darwin-arm64/native-manifest.json +19 -0
  95. package/dist/native/darwin-arm64/rudder-jj +0 -0
  96. package/dist/native/darwin-arm64/rudder-native +0 -0
  97. package/dist/native/darwin-x64/native-manifest.json +19 -0
  98. package/dist/native/darwin-x64/rudder-jj +0 -0
  99. package/dist/native/darwin-x64/rudder-native +0 -0
  100. package/dist/native/linux-x64/native-manifest.json +19 -0
  101. package/dist/native/linux-x64/rudder-jj +0 -0
  102. package/dist/native/linux-x64/rudder-native +0 -0
  103. package/dist/native-agents.js +3 -7
  104. package/dist/native-agents.js.map +1 -1
  105. package/dist/native-binary.js +11 -1
  106. package/dist/native-binary.js.map +1 -1
  107. package/dist/operations/cli.d.ts +23 -0
  108. package/dist/operations/cli.js +110 -0
  109. package/dist/operations/cli.js.map +1 -0
  110. package/dist/operations/registry.d.ts +1076 -0
  111. package/dist/operations/registry.js +69 -0
  112. package/dist/operations/registry.js.map +1 -0
  113. package/dist/operations/registry.json +124 -0
  114. package/dist/operations/requests.d.ts +167 -0
  115. package/dist/operations/requests.js +223 -0
  116. package/dist/operations/requests.js.map +1 -0
  117. package/dist/planning-ownership/index.d.ts +134 -0
  118. package/dist/planning-ownership/index.js +291 -0
  119. package/dist/planning-ownership/index.js.map +1 -0
  120. package/dist/planning-ownership/ingress.d.ts +30 -0
  121. package/dist/planning-ownership/ingress.js +41 -0
  122. package/dist/planning-ownership/ingress.js.map +1 -0
  123. package/dist/planning-ownership/store.d.ts +19 -0
  124. package/dist/planning-ownership/store.js +30 -0
  125. package/dist/planning-ownership/store.js.map +1 -0
  126. package/dist/private-access/cli.d.ts +22 -0
  127. package/dist/private-access/cli.js +76 -0
  128. package/dist/private-access/cli.js.map +1 -0
  129. package/dist/private-access/engine.d.ts +20 -0
  130. package/dist/private-access/engine.js +47 -0
  131. package/dist/private-access/engine.js.map +1 -0
  132. package/dist/private-access/home.d.ts +21 -0
  133. package/dist/private-access/home.js +80 -0
  134. package/dist/private-access/home.js.map +1 -0
  135. package/dist/private-access/previews.d.ts +101 -0
  136. package/dist/private-access/previews.js +447 -0
  137. package/dist/private-access/previews.js.map +1 -0
  138. package/dist/project-files/cli.d.ts +7 -0
  139. package/dist/project-files/cli.js +22 -0
  140. package/dist/project-files/cli.js.map +1 -0
  141. package/dist/project-files/engine.d.ts +14 -0
  142. package/dist/project-files/engine.js +52 -0
  143. package/dist/project-files/engine.js.map +1 -0
  144. package/dist/project-files/home.d.ts +13 -0
  145. package/dist/project-files/home.js +46 -0
  146. package/dist/project-files/home.js.map +1 -0
  147. package/dist/project-files/http.d.ts +9 -0
  148. package/dist/project-files/http.js +54 -0
  149. package/dist/project-files/http.js.map +1 -0
  150. package/dist/project-files/open.d.ts +10 -0
  151. package/dist/project-files/open.js +37 -0
  152. package/dist/project-files/open.js.map +1 -0
  153. package/dist/project-files/references.d.ts +9 -0
  154. package/dist/project-files/references.js +29 -0
  155. package/dist/project-files/references.js.map +1 -0
  156. package/dist/project-files/service.d.ts +32 -0
  157. package/dist/project-files/service.js +236 -0
  158. package/dist/project-files/service.js.map +1 -0
  159. package/dist/project-files/types.d.ts +40 -0
  160. package/dist/project-files/types.js +2 -0
  161. package/dist/project-files/types.js.map +1 -0
  162. package/dist/run-manager.d.ts +2 -0
  163. package/dist/run-manager.js +183 -13
  164. package/dist/run-manager.js.map +1 -1
  165. package/dist/run-timeline.d.ts +29 -0
  166. package/dist/run-timeline.js +112 -0
  167. package/dist/run-timeline.js.map +1 -0
  168. package/dist/scheduler.js +72 -13
  169. package/dist/scheduler.js.map +1 -1
  170. package/dist/surfaces.js +3 -8
  171. package/dist/surfaces.js.map +1 -1
  172. package/dist/tailscale-preview.d.ts +6 -2
  173. package/dist/tailscale-preview.js +58 -13
  174. package/dist/tailscale-preview.js.map +1 -1
  175. package/dist/task-routing.d.ts +2 -0
  176. package/dist/task-routing.js +42 -25
  177. package/dist/task-routing.js.map +1 -1
  178. package/dist/terminal-screen.d.ts +6 -0
  179. package/dist/terminal-screen.js +23 -0
  180. package/dist/terminal-screen.js.map +1 -0
  181. package/dist/tool-cache.d.ts +23 -0
  182. package/dist/tool-cache.js +144 -0
  183. package/dist/tool-cache.js.map +1 -0
  184. package/dist/types.d.ts +0 -17
  185. package/dist/types.js.map +1 -1
  186. package/dist/util.d.ts +8 -0
  187. package/dist/util.js +38 -2
  188. package/dist/util.js.map +1 -1
  189. package/dist/v4-migration/capture.d.ts +53 -0
  190. package/dist/v4-migration/capture.js +197 -0
  191. package/dist/v4-migration/capture.js.map +1 -0
  192. package/dist/v4-migration/cli.d.ts +4 -0
  193. package/dist/v4-migration/cli.js +38 -0
  194. package/dist/v4-migration/cli.js.map +1 -0
  195. package/dist/v4-migration/recovery.d.ts +43 -0
  196. package/dist/v4-migration/recovery.js +180 -0
  197. package/dist/v4-migration/recovery.js.map +1 -0
  198. package/dist/version-check.d.ts +2 -0
  199. package/dist/version-check.js +23 -0
  200. package/dist/version-check.js.map +1 -1
  201. package/dist/warm-snapshot.d.ts +55 -0
  202. package/dist/warm-snapshot.js +381 -0
  203. package/dist/warm-snapshot.js.map +1 -0
  204. package/package.json +4 -3
  205. package/scripts/copy-native.mjs +35 -48
  206. package/scripts/native-artifacts.mjs +248 -0
  207. package/dist/improve/advisor.d.ts +0 -10
  208. package/dist/improve/advisor.js +0 -115
  209. package/dist/improve/advisor.js.map +0 -1
  210. package/dist/improve/collect.d.ts +0 -49
  211. package/dist/improve/collect.js +0 -274
  212. package/dist/improve/collect.js.map +0 -1
  213. package/dist/improve/gate.d.ts +0 -17
  214. package/dist/improve/gate.js +0 -60
  215. package/dist/improve/gate.js.map +0 -1
  216. package/dist/improve/index.d.ts +0 -9
  217. package/dist/improve/index.js +0 -376
  218. package/dist/improve/index.js.map +0 -1
  219. package/dist/improve/judge.d.ts +0 -32
  220. package/dist/improve/judge.js +0 -114
  221. package/dist/improve/judge.js.map +0 -1
  222. package/dist/improve/mine.d.ts +0 -31
  223. package/dist/improve/mine.js +0 -192
  224. package/dist/improve/mine.js.map +0 -1
  225. package/dist/improve/propose.d.ts +0 -51
  226. package/dist/improve/propose.js +0 -150
  227. package/dist/improve/propose.js.map +0 -1
  228. package/dist/improve/rank.d.ts +0 -16
  229. package/dist/improve/rank.js +0 -49
  230. package/dist/improve/rank.js.map +0 -1
  231. package/dist/improve/schedule.d.ts +0 -1
  232. package/dist/improve/schedule.js +0 -95
  233. package/dist/improve/schedule.js.map +0 -1
  234. package/dist/improve/ship.d.ts +0 -25
  235. package/dist/improve/ship.js +0 -82
  236. package/dist/improve/ship.js.map +0 -1
  237. package/dist/improve/state.d.ts +0 -157
  238. package/dist/improve/state.js +0 -264
  239. package/dist/improve/state.js.map +0 -1
package/dist/main.js CHANGED
@@ -9,7 +9,7 @@ import { authStoreExists, runDoctor, runOnboard } from "./auth.js";
9
9
  import { codexLaunchEnv } from "./codex-binary.js";
10
10
  import { runCloudCommand } from "./cloud.js";
11
11
  import { printContextAudit } from "./context-audit.js";
12
- import { currentBranch, findRepoRoot } from "./git.js";
12
+ import { findRepoRoot } from "./git.js";
13
13
  import { runGc } from "./gc.js";
14
14
  import { capture, pendingTelemetryNotice, projectHash, setTelemetryEnabled, telemetryEnabled, TELEMETRY_NOTICE } from "./analytics.js";
15
15
  import { submitFeedback } from "./feedback.js";
@@ -17,19 +17,41 @@ import { dashboardRoot, runHandoff } from "./handoff.js";
17
17
  import { ensureBoardRunning } from "./daemon.js";
18
18
  import { ensureJjAvailable } from "./jj-binary.js";
19
19
  import { createNodeWorkspace, currentJjChangeId, currentOpId, ensureColocated, ensureJj, isJjRepo, undoLast, undoToOp, } from "./jj.js";
20
- import { graphPath, mirrorPlanIntoGraph, updateGraph } from "./graph.js";
20
+ import { mirrorPlanIntoGraph, updateGraph } from "./graph.js";
21
21
  import { adoptMovedAgents } from "./move-home.js";
22
- import { buildFanoutDag, gateDecision, planTask, scaffoldPlan } from "./planner.js";
23
- import { backfillLlmTaskSummaries, listRuns, loadConfig, popUndoEntry, projectStateDir, registerProject, runsDir } from "./state.js";
22
+ import { backfillLlmTaskSummaries, loadConfig, popUndoEntry, projectStateDir, registerProject, runsDir } from "./state.js";
24
23
  import { discoverModelOptions } from "./models.js";
25
24
  import { resolveNativeBinaryPath } from "./native-binary.js";
25
+ import { toolCacheEnv } from "./tool-cache.js";
26
26
  import { ensureEngineRunning, persistentProjectEngineRequested, runEngineCommand } from "./engine.js";
27
27
  import { cleanupRuns, deleteRun, listProjectRuns, mergeRun, printLogs, startRun, statusRuns, stopRun, syncRun, watchRun, workerRun, } from "./run-manager.js";
28
- import { appendCompletionNote, appendDecision, appendSharedContext, parseCompletionNoteArg, SHARED_CONTEXT_FILE, syncSharedContextToWorkspaces, writeCompletionNoteFile } from "./surfaces.js";
28
+ import { parseCompletionNoteArg, writeCompletionNoteFile } from "./surfaces.js";
29
29
  import { commandExists, isTty, MissingToolError, newRunId, runCommand } from "./util.js";
30
30
  import { autoUpdateAndRerunIfNeeded, getUpdateAvailable } from "./version-check.js";
31
31
  import { printReport } from "./report.js";
32
+ import { applyCommandSurface, printCommandDiscovery } from "./operations/cli.js";
33
+ import { commandHelp } from "./operations/registry.js";
32
34
  export async function main() {
35
+ if (process.argv[2] === "__open-project-files") {
36
+ const [repo, ...args] = process.argv.slice(3);
37
+ if (!repo || repo.length > 4096 || args.length !== 1 || args[0].length > 256)
38
+ throw new Error("Invalid project file action");
39
+ const { runProjectFilesCommand } = await import("./project-files/cli.js");
40
+ await runProjectFilesCommand(repo, args);
41
+ return;
42
+ }
43
+ // This private transport owns binary stdio. Setup, notices and general flag
44
+ // parsing must never write into its frame stream.
45
+ if (process.argv[2] === "__migrate-v4") {
46
+ const { runMigrationCaptureCommand } = await import("./v4-migration/cli.js");
47
+ await runMigrationCaptureCommand();
48
+ return;
49
+ }
50
+ if (process.argv[2] === "__fabric-fetch") {
51
+ const { runFabricFetchHelper } = await import("./fabric-fetch.js");
52
+ await runFabricFetchHelper();
53
+ return;
54
+ }
33
55
  // The SDK renderer owns its provider argv and stdio/control protocol. Route
34
56
  // before general flag parsing so provider options never become Rudder tasks.
35
57
  if (process.argv[2] === "__claude-sdk") {
@@ -42,38 +64,42 @@ export async function main() {
42
64
  await runFabricTransferCommand(process.argv.slice(4));
43
65
  return;
44
66
  }
45
- const parsed = parseArgs(process.argv.slice(2));
46
- if (shouldAutoUpdateForCommand(parsed.command) && await autoUpdateAndRerunIfNeeded(process.argv.slice(2))) {
67
+ const parsed = applyCommandSurface(parseArgs(process.argv.slice(2)), new Date(), process.argv.slice(2));
68
+ if (!parsed.flags.version && printCommandDiscovery(parsed))
69
+ return;
70
+ if (parsed.command !== "update" && shouldAutoUpdateForCommand(parsed.command) && await autoUpdateAndRerunIfNeeded(process.argv.slice(2))) {
47
71
  return;
48
- }
49
- // Capability skills (e.g. Google Cloud) for every agent Rudder launches.
50
- await ensureAgentSkills();
51
- // One-time disclosure, before the dashboard takes over the screen. Printing it
52
- // here (rather than burying it in docs) is the deal: telemetry is on, and the
53
- // user is told what it is and how to stop it the first time they run anything.
54
- if (!parsed.command?.startsWith("__")) {
55
- const notice = await pendingTelemetryNotice();
56
- if (notice) {
57
- console.log(notice);
58
- }
59
72
  }
60
73
  if (parsed.flags.version || parsed.command === "version") {
61
74
  const current = await packageVersion();
62
75
  console.log(current);
63
76
  const update = await getUpdateAvailable().catch(() => null);
64
77
  if (update && update.latest !== current) {
65
- console.log(`update available: ${update.latest} (current ${current})`);
66
- console.log(" npm i -g @exla/rudder");
78
+ console.error(`update available: ${update.latest} (current ${current})`);
79
+ console.error(" npm i -g @exla/rudder");
67
80
  }
68
81
  return;
69
82
  }
83
+ // Informational and private callbacks need no agent setup. Their parent
84
+ // launcher already prepares the worker environment; repeating installation
85
+ // here turns every callback into a walk of the user's skills directory.
86
+ const internal = isInternalCommand(parsed.command);
87
+ const setup = !internal && !parsed.flags.help && parsed.command !== "help" && !RETIRED_CALLBACKS.has(parsed.command ?? "")
88
+ && Boolean(parsed.command || parsed.args.length > 0 || isTty());
89
+ if (setup) {
90
+ await ensureAgentSkills();
91
+ const notice = await pendingTelemetryNotice();
92
+ if (notice) {
93
+ process.stderr.write(`${notice}\n`);
94
+ }
95
+ }
70
96
  if (parsed.flags.cwd) {
71
97
  process.chdir(parsed.flags.cwd);
72
98
  }
73
99
  // jj comes with Rudder: a machine without it gets jj's own release fetched
74
100
  // into ~/.rudder/bin once (the npm postinstall usually did that already), and
75
101
  // everything started from here finds it on PATH.
76
- if (!parsed.flags.help && !JJ_FREE_COMMANDS.has(parsed.command ?? "") && (parsed.command || parsed.args.length > 0 || isTty())) {
102
+ if (!internal && !parsed.flags.help && !JJ_FREE_COMMANDS.has(parsed.command ?? "") && (parsed.command || parsed.args.length > 0 || isTty())) {
77
103
  await ensureJjAvailable({ onInstall: (message) => process.stderr.write(`${message}\n`) });
78
104
  }
79
105
  if (!parsed.command || parsed.flags.help) {
@@ -108,11 +134,14 @@ export async function main() {
108
134
  return;
109
135
  }
110
136
  switch (parsed.command) {
137
+ case "project-files": {
138
+ const { runProjectFilesCommand } = await import("./project-files/cli.js");
139
+ await runProjectFilesCommand(parsed.flags.repo ?? findRepoRoot(), parsed.args);
140
+ return;
141
+ }
111
142
  case "engine":
112
- await runEngineCommand(parsed.args[0], parsed.flags.repo ?? findRepoRoot(), parsed.flags.json);
143
+ await runEngineCommand(parsed.args[0], parsed.flags.repo ?? findRepoRoot(), parsed.flags.json, [...parsed.args.slice(1), ...(parsed.flags.run ? ["--run", parsed.flags.run] : [])]);
113
144
  return;
114
- case "tmux":
115
- throw new Error("The tmux dashboard has been removed. Run `rudder` or `rudder dashboard` to open the native dashboard.");
116
145
  case "attach": {
117
146
  await runNativeCommand(["attach", ...parsed.args]);
118
147
  return;
@@ -129,11 +158,6 @@ export async function main() {
129
158
  case "mouse-test":
130
159
  await runNativeCommand(["mouse-test", ...parsed.args]);
131
160
  return;
132
- case "tui":
133
- case "shell":
134
- case "interactive":
135
- case "legacy-shell":
136
- throw new Error("Legacy interactive shells have been removed. Run `rudder` or `rudder dashboard` to open the native dashboard.");
137
161
  case "__worker": {
138
162
  const repo = parsed.flags.repo;
139
163
  const run = parsed.flags.run;
@@ -222,8 +246,15 @@ export async function main() {
222
246
  case "doctor":
223
247
  await runDoctor({ json: parsed.flags.json });
224
248
  return;
249
+ case "update": {
250
+ const { runUpdate } = await import("./version-check.js");
251
+ await runUpdate();
252
+ return;
253
+ }
254
+ case "logout":
255
+ await runCloudCommand("cloud", ["logout"], { json: parsed.flags.json });
256
+ return;
225
257
  case "login":
226
- case "auth":
227
258
  await runCloudCommand("cloud", ["login", ...parsed.args], {
228
259
  json: parsed.flags.json,
229
260
  homePaths: parsed.flags.homePaths,
@@ -240,6 +271,9 @@ export async function main() {
240
271
  });
241
272
  return;
242
273
  case "run": {
274
+ if (parsed.flags.backend && !commandExists(parsed.flags.backend)) {
275
+ throw new MissingToolError(parsed.flags.backend);
276
+ }
243
277
  await maybeOnboard();
244
278
  const task = parsed.args.join(" ").trim();
245
279
  if (!task) {
@@ -257,50 +291,6 @@ export async function main() {
257
291
  });
258
292
  return;
259
293
  }
260
- case "claude":
261
- case "codex": {
262
- if (!commandExists(parsed.command)) {
263
- throw new MissingToolError(parsed.command);
264
- }
265
- await maybeOnboard();
266
- const task = parsed.args.join(" ").trim();
267
- if (!task) {
268
- throw new Error(`Missing task. Usage: rudder ${parsed.command} "fix the tests"`);
269
- }
270
- await startRun({
271
- task,
272
- backend: parsed.command,
273
- model: parsed.flags.model,
274
- detach: parsed.flags.detach,
275
- workspace: parsed.flags.workspace,
276
- queue: parsed.flags.queue,
277
- json: parsed.flags.json,
278
- view: "shell",
279
- });
280
- return;
281
- }
282
- case "acpx": {
283
- if (!commandExists("acpx")) {
284
- throw new MissingToolError("acpx");
285
- }
286
- await maybeOnboard();
287
- const args = parsed.args[0] === "codex" ? parsed.args.slice(1) : parsed.args;
288
- const task = args.join(" ").trim();
289
- if (!task) {
290
- throw new Error('Missing task. Usage: rudder acpx codex "fix the tests"');
291
- }
292
- await startRun({
293
- task,
294
- backend: "acpx",
295
- model: parsed.flags.model,
296
- detach: parsed.flags.detach,
297
- workspace: parsed.flags.workspace,
298
- queue: parsed.flags.queue,
299
- json: parsed.flags.json,
300
- view: "shell",
301
- });
302
- return;
303
- }
304
294
  case "watch":
305
295
  await watchRun({ runId: parsed.args[0], follow: true });
306
296
  return;
@@ -351,7 +341,9 @@ export async function main() {
351
341
  if (!run) {
352
342
  throw new Error("Missing run id.");
353
343
  }
354
- await mergeRun(run, Boolean(parsed.flags.allowDirty));
344
+ await mergeRun(run, Boolean(parsed.flags.allowDirty), {
345
+ abortOnConflict: Boolean(parsed.flags.abortOnConflict),
346
+ });
355
347
  return;
356
348
  }
357
349
  case "sync":
@@ -363,11 +355,6 @@ export async function main() {
363
355
  case "gc":
364
356
  await runGc({ dryRun: Boolean(parsed.flags.dryRun) });
365
357
  return;
366
- case "improve": {
367
- const { runImprove } = await import("./improve/index.js");
368
- await runImprove(parsed);
369
- return;
370
- }
371
358
  case "board":
372
359
  case "serve": {
373
360
  await runBoard(parsed);
@@ -377,45 +364,19 @@ export async function main() {
377
364
  await runUndo(parsed.args[0]);
378
365
  return;
379
366
  }
380
- case "remember": {
381
- const insight = parsed.args.join(" ").trim();
382
- if (!insight) {
383
- throw new Error('Missing insight. Usage: rudder remember "the parser owns token budget"');
384
- }
385
- await runRemember(insight);
386
- return;
387
- }
367
+ case "remember":
388
368
  case "share": {
389
- const text = parsed.args.join(" ").trim();
390
- if (!text) {
391
- throw new Error('Missing shared context. Usage: rudder share "APIFY_TOKEN=..."');
392
- }
393
- await runShare(text);
369
+ // Retired agent ceremony. Old sessions may still call these; accept them
370
+ // as no-ops so the words never fall through to starting a new agent.
371
+ console.log(`rudder ${parsed.command} is no longer needed; nothing was written.`);
394
372
  return;
395
373
  }
396
374
  case "done": {
397
- // Worker end-of-task report (summary + interfaces + recommended follow-ups).
375
+ // Old-run compatibility: Rudder now detects completion itself and reads the
376
+ // summary from the agent's last message. Only the sidecar is written.
398
377
  await runDone(parsed);
399
378
  return;
400
379
  }
401
- case "plan": {
402
- await maybeOnboard();
403
- const task = parsed.args.join(" ").trim();
404
- if (!task) {
405
- throw new Error('Missing task. Usage: rudder plan "split the parser work"');
406
- }
407
- await runPlan(task);
408
- return;
409
- }
410
- case "fanout": {
411
- await maybeOnboard();
412
- const task = parsed.args.join(" ").trim();
413
- if (!task) {
414
- throw new Error('Missing task. Usage: rudder fanout "implement the cache" [--n 3]');
415
- }
416
- await runFanout(task, parsed.flags.n, parsed.flags.backend);
417
- return;
418
- }
419
380
  case "context": {
420
381
  await runContextCommand(parsed);
421
382
  return;
@@ -468,8 +429,9 @@ export async function main() {
468
429
  export function isInternalCommand(command) {
469
430
  return Boolean(command?.startsWith("__"));
470
431
  }
471
- // Commands that never touch a repository, so they never wait on a jj download.
472
- const JJ_FREE_COMMANDS = new Set(["__event", "__route-task", "engine", "telemetry", "feedback", "login", "logout", "help"]);
432
+ // These commands need no jj installation. Completion only writes its evidence.
433
+ const JJ_FREE_COMMANDS = new Set(["__event", "__route-task", "engine", "telemetry", "feedback", "login", "logout", "update", "help", "done", "remember", "share"]);
434
+ const RETIRED_CALLBACKS = new Set(["done", "remember", "share"]);
473
435
  function shouldAutoUpdateForCommand(command) {
474
436
  if (command?.startsWith("__")) {
475
437
  return false;
@@ -477,7 +439,7 @@ function shouldAutoUpdateForCommand(command) {
477
439
  // `rudder done` is invoked by worker agents inside a live Rudder session; updating
478
440
  // the global package in that callback can desync the running dashboard from its
479
441
  // worker surface.
480
- return command !== "done";
442
+ return !RETIRED_CALLBACKS.has(command ?? "");
481
443
  }
482
444
  function parseArgs(argv) {
483
445
  const parsed = { args: [], flags: {} };
@@ -521,6 +483,18 @@ function parseArgs(argv) {
521
483
  parsed.flags.workspace = true;
522
484
  continue;
523
485
  }
486
+ if (arg === "--cloud") {
487
+ parsed.flags.cloud = true;
488
+ continue;
489
+ }
490
+ if (arg === "--continue") {
491
+ parsed.flags.continue = true;
492
+ continue;
493
+ }
494
+ if (arg === "--delete") {
495
+ parsed.flags.delete = true;
496
+ continue;
497
+ }
524
498
  if (arg === "--queue") {
525
499
  parsed.flags.queue = true;
526
500
  continue;
@@ -529,6 +503,10 @@ function parseArgs(argv) {
529
503
  parsed.flags.allowDirty = true;
530
504
  continue;
531
505
  }
506
+ if (arg === "--abort-on-conflict") {
507
+ parsed.flags.abortOnConflict = true;
508
+ continue;
509
+ }
532
510
  if (arg === "--force") {
533
511
  parsed.flags.force = true;
534
512
  continue;
@@ -806,6 +784,8 @@ async function runNativeDashboard() {
806
784
  const previousNativeTui = process.env.RUDDER_NATIVE_TUI;
807
785
  process.env.RUDDER_NATIVE_TUI = "1";
808
786
  env.RUDDER_NATIVE_TUI = "1";
787
+ // Native-launched agents get the same shared tool caches as CLI launches.
788
+ env.RUDDER_AGENT_TOOL_ENV = JSON.stringify(toolCacheEnv("agent"));
809
789
  if (update) {
810
790
  env.RUDDER_UPDATE_AVAILABLE = update.latest;
811
791
  env.RUDDER_UPDATE_CURRENT = update.current;
@@ -842,10 +822,8 @@ async function runNativeDashboard() {
842
822
  const repoRoot = findRepoRoot();
843
823
  if (repoRoot) {
844
824
  board = await ensureBoardRunning(repoRoot, { open: false, scheduler: false });
845
- // Hand the native child a deep link to THIS project's board so the `o` key /
846
- // `/web` opens straight into the current project (not the all-projects index).
847
- // The URL itself stays hidden in the TUI; the hotkey is the way in, and the
848
- // board's "all projects" link is the way back out to other projects.
825
+ // Credential-free discovery hints only. Native browser callbacks use the
826
+ // private board endpoint; tickets and bearer sessions never enter env.
849
827
  env.RUDDER_BOARD_URL = board.projectUrl;
850
828
  env.RUDDER_BOARD_PORT = String(board.port);
851
829
  }
@@ -1086,13 +1064,6 @@ async function runUndo(opId) {
1086
1064
  console.log(`Undid the last jj operation${before ? ` (was at ${before})` : ""}.`);
1087
1065
  console.log("Note: jj undo is global - it rewinds all workspaces and refs.");
1088
1066
  }
1089
- async function runRemember(insight) {
1090
- // The bd-remember equivalent: append a durable insight to DECISIONS.md, the
1091
- // tracked agent-authored knowledge surface the board's Memory view renders.
1092
- const repoRoot = findRepoRoot();
1093
- await appendDecision(repoRoot, insight, "cli");
1094
- console.log("Remembered. Appended to DECISIONS.md (shared, jj-tracked).");
1095
- }
1096
1067
  async function runTelemetryCommand(action) {
1097
1068
  const verb = (action ?? "status").trim().toLowerCase();
1098
1069
  if (verb === "on" || verb === "enable") {
@@ -1165,13 +1136,6 @@ async function runEventCommand(parsed) {
1165
1136
  properties.project ??= projectHash(dashboardRoot());
1166
1137
  await capture(event, properties);
1167
1138
  }
1168
- async function runShare(text) {
1169
- const repoRoot = findRepoRoot();
1170
- await appendSharedContext(repoRoot, text, "cli share");
1171
- const runs = await listRuns(repoRoot).catch(() => []);
1172
- await syncSharedContextToWorkspaces(repoRoot, runs.map((run) => run.workspace.path)).catch(() => undefined);
1173
- console.log(`Shared. Appended to ${SHARED_CONTEXT_FILE} (gitignored, mirrored to agents).`);
1174
- }
1175
1139
  /** Read all of stdin when it is piped (never when interactive), with a short
1176
1140
  * timeout so a worker that calls `rudder done` without piping never hangs. */
1177
1141
  async function readPipedStdin(timeoutMs = 3000) {
@@ -1206,18 +1170,11 @@ async function readPipedStdin(timeoutMs = 3000) {
1206
1170
  });
1207
1171
  });
1208
1172
  }
1209
- /** `rudder done [--node <id>] ['<json>']`: a worker's end-of-task report. Accepts
1210
- * a CompletionNote JSON via stdin (piped) or as the joined args; a non-JSON arg
1211
- * is treated as a freeform summary. The note travels back to the orchestrator over
1212
- * two durable channels so a real Claude/Codex worker's report is
1213
- * not lost to terminal rendering:
1214
- * 1. RUDDER_DONE_FILE (set by the launcher to <workspace>/.rudder/done/<node>.json):
1215
- * a machine-readable JSON drop the orchestrator reads straight off disk. This is
1216
- * the authoritative channel - it never passes through the agent's TUI.
1217
- * 2. DECISIONS.md: a human-legible bullet siblings re-read.
1218
- * Never manages jj - just records, like `rudder remember`. */
1173
+ /** `rudder done [--node <id>] ['<json>']`: compatibility callback for old runs.
1174
+ * Accepts a CompletionNote JSON via stdin (piped) or as the joined args; a non-JSON
1175
+ * arg is treated as a freeform summary. It only writes the sidecar file an old
1176
+ * scheduler reads (RUDDER_DONE_FILE when set, else .rudder/done/<node>.json). */
1219
1177
  async function runDone(parsed) {
1220
- const repoRoot = findRepoRoot();
1221
1178
  const node = parsed.flags.node;
1222
1179
  let raw = (await readPipedStdin()).trim();
1223
1180
  if (!raw && parsed.args.length) {
@@ -1235,48 +1192,6 @@ async function runDone(parsed) {
1235
1192
  if (doneFile) {
1236
1193
  await writeCompletionNoteFile(doneFile, note);
1237
1194
  }
1238
- // (2) Human-legible record for sibling agents and review history.
1239
- await appendCompletionNote(repoRoot, note, node || "worker");
1240
- }
1241
- async function runPlan(task) {
1242
- const repoRoot = findRepoRoot();
1243
- ensureJj();
1244
- await ensureColocated(repoRoot);
1245
- const branch = await currentBranch(repoRoot).catch(() => "");
1246
- const dag = await planTask(task, { root: repoRoot, branch });
1247
- const gate = gateDecision(dag);
1248
- if (gate.autoRun) {
1249
- console.log(`auto: ${gate.reason}`);
1250
- }
1251
- else {
1252
- console.log(`gate: ${gate.reason}`);
1253
- console.log(`Plan: ${dag.nodes.length} node(s), ${dag.edges.length} edge(s)`);
1254
- for (const node of dag.nodes) {
1255
- const deps = node.deps.length
1256
- ? ` deps=[${node.deps.map((dep) => `${dep.on}:${dep.type}`).join(", ")}]`
1257
- : "";
1258
- console.log(` - ${node.id} ${node.title}${deps}`);
1259
- }
1260
- }
1261
- await scaffoldPlan(repoRoot, dag);
1262
- console.log(`graph: ${graphPath(repoRoot)}`);
1263
- }
1264
- async function runFanout(task, n, backend) {
1265
- const repoRoot = findRepoRoot();
1266
- ensureJj();
1267
- await ensureColocated(repoRoot);
1268
- const requested = typeof n === "number" && Number.isFinite(n) ? n : 3;
1269
- const dag = buildFanoutDag(task, requested, backend ? { backend } : {});
1270
- const variants = dag.nodes.filter((node) => node.id !== "judge");
1271
- console.log(`fanout: ${variants.length} variant(s) + 1 judge`);
1272
- for (const node of dag.nodes) {
1273
- const judgeOf = node.deps.filter((dep) => dep.type === "judge").map((dep) => dep.on);
1274
- const suffix = judgeOf.length ? ` judges=[${judgeOf.join(", ")}]` : "";
1275
- console.log(` - ${node.id} ${node.title}${suffix}`);
1276
- }
1277
- await scaffoldPlan(repoRoot, dag);
1278
- console.log(`graph: ${graphPath(repoRoot)}`);
1279
- console.log("The judge launches once every variant reaches review; variants are not merged.");
1280
1195
  }
1281
1196
  async function runContextCommand(parsed) {
1282
1197
  const sub = parsed.args[0] ?? "audit";
@@ -1288,129 +1203,6 @@ async function runContextCommand(parsed) {
1288
1203
  throw new Error("Usage: rudder context [audit]");
1289
1204
  }
1290
1205
  function printHelp() {
1291
- console.log(`rudder
1292
-
1293
- Usage:
1294
- rudder Open native dashboard with real agent panes
1295
- rudder restart Clear local session and open dashboard
1296
- rudder attach [agent] Mirror one live agent pane of the running dashboard in this terminal
1297
- rudder engine [start|status|shutdown] Control the persistent project engine
1298
- rudder "task"
1299
- rudder run [options] "task"
1300
- rudder claude [options] "task"
1301
- rudder codex [options] "task"
1302
- rudder login
1303
- rudder cloud [name or task]
1304
- rudder cloud help
1305
- rudder cloud byoc <ssh-host>
1306
- rudder cloud runtime [fly|byoc]
1307
- rudder cloud vm <task>
1308
- rudder cloud list
1309
- rudder cloud attach <id>
1310
- rudder cloud talk <id> "message"
1311
- rudder cloud output <id>
1312
- rudder cloud onload [runId]
1313
- rudder cloud logs <id>
1314
- rudder cloud bootstrap <id>
1315
- rudder cloud quickstart
1316
- rudder sail [name or task]
1317
- Run management:
1318
- rudder watch [run] Attach to live output
1319
- rudder logs [run] [--follow] Print saved output
1320
- rudder status [--json] Show active runs for this repo
1321
- rudder runs [--json] List runs for this repo
1322
- rudder report [model] [options] Collect and report on runs with filtering, aggregation, and multiple formats
1323
- rudder stop <run> Cancel a run
1324
- rudder delete <run> Delete a run and its workspace
1325
- rudder merge <run> Merge a run into the current change
1326
- rudder sync [run] Rebase a run's jj change onto its base without merging
1327
- rudder cleanup [--force] Remove merged run workspaces
1328
- rudder gc [--dry-run] Prune bounded diagnostics, old binaries, and stale run records
1329
- rudder undo [opId] Rewind jj to an op id, or the last undo-stack entry (global)
1330
-
1331
- Improvement loop:
1332
- rudder improve run [--dry-run] [--budget-usd N] Mine telemetry, propose+judge fixes, ship a release
1333
- rudder improve status Last cycle, shipped versions, ledger tail
1334
- rudder improve report [date] Print a cycle report
1335
- rudder improve schedule install|uninstall|status Nightly launchd schedule (macOS)
1336
-
1337
- Planner:
1338
- rudder plan "task" Decompose a task into a DAG, scaffold empty jj changes, write graph.json
1339
- rudder fanout "task" [--n N] Fan out N variant agents on one task, then a judge picks/merges the best (default N=3)
1340
- rudder context audit Audit agent context files for size, duplication, secrets, and injection text
1341
-
1342
- Conversation handoff:
1343
- rudder handoff "<next step>" Hand THIS chat to Rudder: it forks the conversation into a worker that already knows everything
1344
- rudder handoff --here "..." Continue it in the main checkout instead of an isolated workspace
1345
- rudder handoff --opencode "..." Hand off an opencode chat (default is the claude one; --codex for codex)
1346
- rudder handoff --list List recent conversations in this repo with their session ids
1347
-
1348
- Telemetry and feedback:
1349
- rudder feedback "<what broke>" Send a report: message + version/model/recent notices (never prompts or code)
1350
- rudder telemetry [status|on|off] Anonymous usage events; on by default, off in one command
1351
-
1352
- Memory:
1353
- rudder remember "<insight>" Append a durable cross-cutting decision to DECISIONS.md (shared, jj-tracked)
1354
- rudder share "<token/context>" Append gitignored shared context to RUDDER_SHARED.md for all agents
1355
-
1356
- Board:
1357
- rudder board [--port N] [--open|--no-open] Serve the localhost board (opens browser by default)
1358
- rudder serve [--port N] [--open] Ensure the board server is up
1359
-
1360
- Setup:
1361
- rudder onboard
1362
- rudder doctor [--json]
1363
- rudder mouse-test [raw|parsed] Show whether your terminal sends wheel events
1364
-
1365
- Cloud:
1366
- rudder login Open browser login and store cloud token
1367
- rudder cloud [name or task] Start a cloud worker from this repo snapshot
1368
- rudder cloud list List cloud workers/runs
1369
- rudder cloud help Show cloud command help
1370
- rudder cloud byoc <ssh> Use your own SSH host for BYOC cloud launches
1371
- rudder cloud runtime [runtime] Show or set fly/byoc cloud runtime
1372
- rudder cloud vm <task> Prepare a BYOC worker command for a task
1373
- rudder cloud onload [runId] Move this Rudder workspace, or one run, to cloud
1374
- rudder cloud logs <id> Show cloud worker status while log streaming is pending
1375
- rudder cloud attach <id|name> Attach this terminal to a cloud worker, or a project on the home machine by name
1376
- rudder cloud bootstrap <id> Regenerate a BYOC worker command
1377
- rudder cloud pause <id> Pause an idle cloud worker
1378
- rudder cloud resume <id> Resume a cloud worker
1379
- rudder sail [name or task] Alias for starting a cloud worker
1380
-
1381
- Report options:
1382
- --format <format> Output format: table (default), json, markdown, csv
1383
- --status <status> Filter by status (comma-separated: completed,merged,failed,etc)
1384
- --backend <backend> Filter by backend: claude, codex, acpx, opencode
1385
- --after <date> Filter by creation date (ISO 8601)
1386
- --before <date> Filter by creation date (ISO 8601)
1387
- --summary / --no-summary Show statistics (on by default)
1388
- --limit <n> Limit results to N runs
1389
- --sort-by <column> Sort by: created (default), updated, duration, tokens, status
1390
- --reverse Reverse sort order
1391
- --detailed Show full task text and extra details
1392
-
1393
- General options:
1394
- -d, --detach Start in background
1395
- --workspace Always isolate the run in its own jj workspace
1396
- --queue Queue mode (reserved)
1397
- -m, --model <model> Backend model
1398
- -b, --backend <backend> claude, codex, or opencode
1399
- -C, --cwd <dir> Run from another directory
1400
- -p, --port <port> Board server port (default 4774)
1401
- --n <count> Number of fan-out variants for rudder fanout (default 3)
1402
- --open / --no-open Open (or do not open) the browser for the board
1403
- --home-path <path> Include extra HOME path in cloud snapshot
1404
- --ssh <host> BYOC SSH host from ~/.ssh/config
1405
- --json Machine-readable output
1406
- -v, --version Print version
1407
- --allow-dirty Allow merge into dirty target branch
1408
- --dry-run Report gc cleanup without deleting
1409
-
1410
- Rebase-first merge:
1411
- Set {"mergeStrategy":"rebase"} in ~/.rudder/config.json to rebase before
1412
- merging. If that rebase conflicts, Rudder leaves the workspace mid-rebase so
1413
- you can resolve it, run git rebase --continue, and retry sync or merge.
1414
- `);
1206
+ console.log(commandHelp());
1415
1207
  }
1416
1208
  //# sourceMappingURL=main.js.map