@exla/rudder 4.0.0-alpha.7 → 4.1.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 (238) hide show
  1. package/README.md +33 -69
  2. package/assets/skills/burst/SKILL.md +64 -0
  3. package/dist/agent-efficiency/backend-observer.d.ts +13 -0
  4. package/dist/agent-efficiency/backend-observer.js +77 -0
  5. package/dist/agent-efficiency/backend-observer.js.map +1 -0
  6. package/dist/agent-efficiency/handoff.d.ts +9 -0
  7. package/dist/agent-efficiency/handoff.js +42 -0
  8. package/dist/agent-efficiency/handoff.js.map +1 -0
  9. package/dist/agent-efficiency/index.d.ts +11 -0
  10. package/dist/agent-efficiency/index.js +7 -0
  11. package/dist/agent-efficiency/index.js.map +1 -0
  12. package/dist/agent-efficiency/lessons.d.ts +55 -0
  13. package/dist/agent-efficiency/lessons.js +107 -0
  14. package/dist/agent-efficiency/lessons.js.map +1 -0
  15. package/dist/agent-efficiency/privacy.d.ts +6 -0
  16. package/dist/agent-efficiency/privacy.js +28 -0
  17. package/dist/agent-efficiency/privacy.js.map +1 -0
  18. package/dist/agent-efficiency/production.d.ts +16 -0
  19. package/dist/agent-efficiency/production.js +120 -0
  20. package/dist/agent-efficiency/production.js.map +1 -0
  21. package/dist/agent-efficiency/storage.d.ts +3 -0
  22. package/dist/agent-efficiency/storage.js +28 -0
  23. package/dist/agent-efficiency/storage.js.map +1 -0
  24. package/dist/agent-efficiency/telemetry.d.ts +59 -0
  25. package/dist/agent-efficiency/telemetry.js +143 -0
  26. package/dist/agent-efficiency/telemetry.js.map +1 -0
  27. package/dist/agent-efficiency/trace-lessons.d.ts +21 -0
  28. package/dist/agent-efficiency/trace-lessons.js +36 -0
  29. package/dist/agent-efficiency/trace-lessons.js.map +1 -0
  30. package/dist/agent-efficiency/waits.d.ts +52 -0
  31. package/dist/agent-efficiency/waits.js +131 -0
  32. package/dist/agent-efficiency/waits.js.map +1 -0
  33. package/dist/backends.js +14 -8
  34. package/dist/backends.js.map +1 -1
  35. package/dist/board/authority.d.ts +48 -0
  36. package/dist/board/authority.js +125 -0
  37. package/dist/board/authority.js.map +1 -0
  38. package/dist/board/board.js +6 -2
  39. package/dist/board/daemon.d.ts +3 -6
  40. package/dist/board/daemon.js +242 -222
  41. package/dist/board/daemon.js.map +1 -1
  42. package/dist/board/host-access.d.ts +8 -0
  43. package/dist/board/host-access.js +222 -0
  44. package/dist/board/host-access.js.map +1 -0
  45. package/dist/board/project-files.d.ts +12 -0
  46. package/dist/board/project-files.js +78 -0
  47. package/dist/board/project-files.js.map +1 -0
  48. package/dist/brain.d.ts +2 -1
  49. package/dist/brain.js +15 -21
  50. package/dist/brain.js.map +1 -1
  51. package/dist/claude-sdk-protocol.js +10 -7
  52. package/dist/claude-sdk-protocol.js.map +1 -1
  53. package/dist/cloud-build-profile.d.ts +22 -0
  54. package/dist/cloud-build-profile.js +160 -0
  55. package/dist/cloud-build-profile.js.map +1 -0
  56. package/dist/cloud.js +23 -470
  57. package/dist/cloud.js.map +1 -1
  58. package/dist/codex-binary.d.ts +1 -0
  59. package/dist/codex-binary.js +8 -1
  60. package/dist/codex-binary.js.map +1 -1
  61. package/dist/daemon.d.ts +2 -0
  62. package/dist/daemon.js +14 -2
  63. package/dist/daemon.js.map +1 -1
  64. package/dist/effort.d.ts +8 -0
  65. package/dist/effort.js +15 -2
  66. package/dist/effort.js.map +1 -1
  67. package/dist/engine-authority.js +16 -0
  68. package/dist/engine-authority.js.map +1 -1
  69. package/dist/engine.d.ts +1 -1
  70. package/dist/engine.js +11 -2
  71. package/dist/engine.js.map +1 -1
  72. package/dist/fabric-fetch.d.ts +25 -0
  73. package/dist/fabric-fetch.js +402 -0
  74. package/dist/fabric-fetch.js.map +1 -0
  75. package/dist/fabric-local.d.ts +5 -2
  76. package/dist/fabric-local.js +36 -1
  77. package/dist/fabric-local.js.map +1 -1
  78. package/dist/fabric-remote.d.ts +76 -1
  79. package/dist/fabric-remote.js +333 -61
  80. package/dist/fabric-remote.js.map +1 -1
  81. package/dist/git.js +23 -0
  82. package/dist/git.js.map +1 -1
  83. package/dist/graph.js +9 -1
  84. package/dist/graph.js.map +1 -1
  85. package/dist/jj.d.ts +3 -1
  86. package/dist/jj.js +34 -2
  87. package/dist/jj.js.map +1 -1
  88. package/dist/main.js +115 -311
  89. package/dist/main.js.map +1 -1
  90. package/dist/migration.d.ts +2 -0
  91. package/dist/migration.js +3 -0
  92. package/dist/migration.js.map +1 -1
  93. package/dist/models.js +11 -6
  94. package/dist/models.js.map +1 -1
  95. package/dist/native/darwin-arm64/native-manifest.json +19 -0
  96. package/dist/native/darwin-arm64/rudder-jj +0 -0
  97. package/dist/native/darwin-arm64/rudder-native +0 -0
  98. package/dist/native/linux-x64/native-manifest.json +19 -0
  99. package/dist/native/linux-x64/rudder-jj +0 -0
  100. package/dist/native/linux-x64/rudder-native +0 -0
  101. package/dist/native-agents.js +3 -7
  102. package/dist/native-agents.js.map +1 -1
  103. package/dist/native-binary.js +11 -1
  104. package/dist/native-binary.js.map +1 -1
  105. package/dist/operations/cli.d.ts +23 -0
  106. package/dist/operations/cli.js +110 -0
  107. package/dist/operations/cli.js.map +1 -0
  108. package/dist/operations/registry.d.ts +1076 -0
  109. package/dist/operations/registry.js +69 -0
  110. package/dist/operations/registry.js.map +1 -0
  111. package/dist/operations/registry.json +124 -0
  112. package/dist/operations/requests.d.ts +167 -0
  113. package/dist/operations/requests.js +223 -0
  114. package/dist/operations/requests.js.map +1 -0
  115. package/dist/planning-ownership/index.d.ts +134 -0
  116. package/dist/planning-ownership/index.js +291 -0
  117. package/dist/planning-ownership/index.js.map +1 -0
  118. package/dist/planning-ownership/ingress.d.ts +30 -0
  119. package/dist/planning-ownership/ingress.js +41 -0
  120. package/dist/planning-ownership/ingress.js.map +1 -0
  121. package/dist/planning-ownership/store.d.ts +19 -0
  122. package/dist/planning-ownership/store.js +30 -0
  123. package/dist/planning-ownership/store.js.map +1 -0
  124. package/dist/private-access/cli.d.ts +22 -0
  125. package/dist/private-access/cli.js +76 -0
  126. package/dist/private-access/cli.js.map +1 -0
  127. package/dist/private-access/engine.d.ts +20 -0
  128. package/dist/private-access/engine.js +47 -0
  129. package/dist/private-access/engine.js.map +1 -0
  130. package/dist/private-access/home.d.ts +21 -0
  131. package/dist/private-access/home.js +80 -0
  132. package/dist/private-access/home.js.map +1 -0
  133. package/dist/private-access/previews.d.ts +101 -0
  134. package/dist/private-access/previews.js +447 -0
  135. package/dist/private-access/previews.js.map +1 -0
  136. package/dist/project-files/cli.d.ts +7 -0
  137. package/dist/project-files/cli.js +22 -0
  138. package/dist/project-files/cli.js.map +1 -0
  139. package/dist/project-files/engine.d.ts +14 -0
  140. package/dist/project-files/engine.js +52 -0
  141. package/dist/project-files/engine.js.map +1 -0
  142. package/dist/project-files/home.d.ts +13 -0
  143. package/dist/project-files/home.js +46 -0
  144. package/dist/project-files/home.js.map +1 -0
  145. package/dist/project-files/http.d.ts +9 -0
  146. package/dist/project-files/http.js +54 -0
  147. package/dist/project-files/http.js.map +1 -0
  148. package/dist/project-files/open.d.ts +10 -0
  149. package/dist/project-files/open.js +37 -0
  150. package/dist/project-files/open.js.map +1 -0
  151. package/dist/project-files/references.d.ts +9 -0
  152. package/dist/project-files/references.js +29 -0
  153. package/dist/project-files/references.js.map +1 -0
  154. package/dist/project-files/service.d.ts +32 -0
  155. package/dist/project-files/service.js +236 -0
  156. package/dist/project-files/service.js.map +1 -0
  157. package/dist/project-files/types.d.ts +40 -0
  158. package/dist/project-files/types.js +2 -0
  159. package/dist/project-files/types.js.map +1 -0
  160. package/dist/run-manager.d.ts +8 -0
  161. package/dist/run-manager.js +193 -13
  162. package/dist/run-manager.js.map +1 -1
  163. package/dist/run-timeline.d.ts +31 -0
  164. package/dist/run-timeline.js +116 -0
  165. package/dist/run-timeline.js.map +1 -0
  166. package/dist/scheduler.js +72 -13
  167. package/dist/scheduler.js.map +1 -1
  168. package/dist/surfaces.js +3 -8
  169. package/dist/surfaces.js.map +1 -1
  170. package/dist/tailscale-preview.d.ts +6 -2
  171. package/dist/tailscale-preview.js +58 -13
  172. package/dist/tailscale-preview.js.map +1 -1
  173. package/dist/task-routing.d.ts +2 -0
  174. package/dist/task-routing.js +42 -25
  175. package/dist/task-routing.js.map +1 -1
  176. package/dist/terminal-screen.d.ts +6 -0
  177. package/dist/terminal-screen.js +23 -0
  178. package/dist/terminal-screen.js.map +1 -0
  179. package/dist/tool-cache.d.ts +23 -0
  180. package/dist/tool-cache.js +144 -0
  181. package/dist/tool-cache.js.map +1 -0
  182. package/dist/types.d.ts +0 -17
  183. package/dist/types.js.map +1 -1
  184. package/dist/util.d.ts +8 -0
  185. package/dist/util.js +38 -2
  186. package/dist/util.js.map +1 -1
  187. package/dist/v4-migration/capture.d.ts +53 -0
  188. package/dist/v4-migration/capture.js +197 -0
  189. package/dist/v4-migration/capture.js.map +1 -0
  190. package/dist/v4-migration/cli.d.ts +4 -0
  191. package/dist/v4-migration/cli.js +38 -0
  192. package/dist/v4-migration/cli.js.map +1 -0
  193. package/dist/v4-migration/recovery.d.ts +43 -0
  194. package/dist/v4-migration/recovery.js +180 -0
  195. package/dist/v4-migration/recovery.js.map +1 -0
  196. package/dist/version-check.d.ts +2 -0
  197. package/dist/version-check.js +23 -0
  198. package/dist/version-check.js.map +1 -1
  199. package/dist/warm-snapshot.d.ts +55 -0
  200. package/dist/warm-snapshot.js +382 -0
  201. package/dist/warm-snapshot.js.map +1 -0
  202. package/package.json +4 -3
  203. package/scripts/copy-native.mjs +35 -48
  204. package/scripts/native-artifacts.mjs +248 -0
  205. package/dist/improve/advisor.d.ts +0 -10
  206. package/dist/improve/advisor.js +0 -115
  207. package/dist/improve/advisor.js.map +0 -1
  208. package/dist/improve/collect.d.ts +0 -49
  209. package/dist/improve/collect.js +0 -274
  210. package/dist/improve/collect.js.map +0 -1
  211. package/dist/improve/gate.d.ts +0 -17
  212. package/dist/improve/gate.js +0 -60
  213. package/dist/improve/gate.js.map +0 -1
  214. package/dist/improve/index.d.ts +0 -9
  215. package/dist/improve/index.js +0 -376
  216. package/dist/improve/index.js.map +0 -1
  217. package/dist/improve/judge.d.ts +0 -32
  218. package/dist/improve/judge.js +0 -114
  219. package/dist/improve/judge.js.map +0 -1
  220. package/dist/improve/mine.d.ts +0 -31
  221. package/dist/improve/mine.js +0 -192
  222. package/dist/improve/mine.js.map +0 -1
  223. package/dist/improve/propose.d.ts +0 -51
  224. package/dist/improve/propose.js +0 -150
  225. package/dist/improve/propose.js.map +0 -1
  226. package/dist/improve/rank.d.ts +0 -16
  227. package/dist/improve/rank.js +0 -49
  228. package/dist/improve/rank.js.map +0 -1
  229. package/dist/improve/schedule.d.ts +0 -1
  230. package/dist/improve/schedule.js +0 -95
  231. package/dist/improve/schedule.js.map +0 -1
  232. package/dist/improve/ship.d.ts +0 -25
  233. package/dist/improve/ship.js +0 -82
  234. package/dist/improve/ship.js.map +0 -1
  235. package/dist/improve/state.d.ts +0 -157
  236. package/dist/improve/state.js +0 -264
  237. package/dist/improve/state.js.map +0 -1
  238. package/dist/native/darwin-x64/rudder-native +0 -0
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, loadRunRecord, 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
- 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";
27
+ import { cleanupRuns, deleteRun, listProjectRuns, mergeRun, printLogs, runProjectCheck, startRun, statusRuns, stopRun, syncRun, watchRun, workerRun, } from "./run-manager.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,17 @@ 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
+ if (!parsed.flags.skipChecks) {
345
+ const repoRoot = findRepoRoot();
346
+ const record = await loadRunRecord(repoRoot, run);
347
+ const failed = record ? runProjectCheck(repoRoot, record) : undefined;
348
+ if (failed !== undefined) {
349
+ throw new Error(`checks failed, nothing was merged (rudder merge ${run} --skip-checks merges anyway)\n${failed}`);
350
+ }
351
+ }
352
+ await mergeRun(run, Boolean(parsed.flags.allowDirty), {
353
+ abortOnConflict: Boolean(parsed.flags.abortOnConflict),
354
+ });
355
355
  return;
356
356
  }
357
357
  case "sync":
@@ -363,11 +363,6 @@ export async function main() {
363
363
  case "gc":
364
364
  await runGc({ dryRun: Boolean(parsed.flags.dryRun) });
365
365
  return;
366
- case "improve": {
367
- const { runImprove } = await import("./improve/index.js");
368
- await runImprove(parsed);
369
- return;
370
- }
371
366
  case "board":
372
367
  case "serve": {
373
368
  await runBoard(parsed);
@@ -377,45 +372,19 @@ export async function main() {
377
372
  await runUndo(parsed.args[0]);
378
373
  return;
379
374
  }
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
- }
375
+ case "remember":
388
376
  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);
377
+ // Retired agent ceremony. Old sessions may still call these; accept them
378
+ // as no-ops so the words never fall through to starting a new agent.
379
+ console.log(`rudder ${parsed.command} is no longer needed; nothing was written.`);
394
380
  return;
395
381
  }
396
382
  case "done": {
397
- // Worker end-of-task report (summary + interfaces + recommended follow-ups).
383
+ // Old-run compatibility: Rudder now detects completion itself and reads the
384
+ // summary from the agent's last message. Only the sidecar is written.
398
385
  await runDone(parsed);
399
386
  return;
400
387
  }
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
388
  case "context": {
420
389
  await runContextCommand(parsed);
421
390
  return;
@@ -468,8 +437,9 @@ export async function main() {
468
437
  export function isInternalCommand(command) {
469
438
  return Boolean(command?.startsWith("__"));
470
439
  }
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"]);
440
+ // These commands need no jj installation. Completion only writes its evidence.
441
+ const JJ_FREE_COMMANDS = new Set(["__event", "__route-task", "engine", "telemetry", "feedback", "login", "logout", "update", "help", "done", "remember", "share"]);
442
+ const RETIRED_CALLBACKS = new Set(["done", "remember", "share"]);
473
443
  function shouldAutoUpdateForCommand(command) {
474
444
  if (command?.startsWith("__")) {
475
445
  return false;
@@ -477,7 +447,7 @@ function shouldAutoUpdateForCommand(command) {
477
447
  // `rudder done` is invoked by worker agents inside a live Rudder session; updating
478
448
  // the global package in that callback can desync the running dashboard from its
479
449
  // worker surface.
480
- return command !== "done";
450
+ return !RETIRED_CALLBACKS.has(command ?? "");
481
451
  }
482
452
  function parseArgs(argv) {
483
453
  const parsed = { args: [], flags: {} };
@@ -521,6 +491,18 @@ function parseArgs(argv) {
521
491
  parsed.flags.workspace = true;
522
492
  continue;
523
493
  }
494
+ if (arg === "--cloud") {
495
+ parsed.flags.cloud = true;
496
+ continue;
497
+ }
498
+ if (arg === "--continue") {
499
+ parsed.flags.continue = true;
500
+ continue;
501
+ }
502
+ if (arg === "--delete") {
503
+ parsed.flags.delete = true;
504
+ continue;
505
+ }
524
506
  if (arg === "--queue") {
525
507
  parsed.flags.queue = true;
526
508
  continue;
@@ -529,6 +511,14 @@ function parseArgs(argv) {
529
511
  parsed.flags.allowDirty = true;
530
512
  continue;
531
513
  }
514
+ if (arg === "--skip-checks") {
515
+ parsed.flags.skipChecks = true;
516
+ continue;
517
+ }
518
+ if (arg === "--abort-on-conflict") {
519
+ parsed.flags.abortOnConflict = true;
520
+ continue;
521
+ }
532
522
  if (arg === "--force") {
533
523
  parsed.flags.force = true;
534
524
  continue;
@@ -806,6 +796,8 @@ async function runNativeDashboard() {
806
796
  const previousNativeTui = process.env.RUDDER_NATIVE_TUI;
807
797
  process.env.RUDDER_NATIVE_TUI = "1";
808
798
  env.RUDDER_NATIVE_TUI = "1";
799
+ // Native-launched agents get the same shared tool caches as CLI launches.
800
+ env.RUDDER_AGENT_TOOL_ENV = JSON.stringify(toolCacheEnv("agent"));
809
801
  if (update) {
810
802
  env.RUDDER_UPDATE_AVAILABLE = update.latest;
811
803
  env.RUDDER_UPDATE_CURRENT = update.current;
@@ -842,10 +834,8 @@ async function runNativeDashboard() {
842
834
  const repoRoot = findRepoRoot();
843
835
  if (repoRoot) {
844
836
  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.
837
+ // Credential-free discovery hints only. Native browser callbacks use the
838
+ // private board endpoint; tickets and bearer sessions never enter env.
849
839
  env.RUDDER_BOARD_URL = board.projectUrl;
850
840
  env.RUDDER_BOARD_PORT = String(board.port);
851
841
  }
@@ -1086,13 +1076,6 @@ async function runUndo(opId) {
1086
1076
  console.log(`Undid the last jj operation${before ? ` (was at ${before})` : ""}.`);
1087
1077
  console.log("Note: jj undo is global - it rewinds all workspaces and refs.");
1088
1078
  }
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
1079
  async function runTelemetryCommand(action) {
1097
1080
  const verb = (action ?? "status").trim().toLowerCase();
1098
1081
  if (verb === "on" || verb === "enable") {
@@ -1165,13 +1148,6 @@ async function runEventCommand(parsed) {
1165
1148
  properties.project ??= projectHash(dashboardRoot());
1166
1149
  await capture(event, properties);
1167
1150
  }
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
1151
  /** Read all of stdin when it is piped (never when interactive), with a short
1176
1152
  * timeout so a worker that calls `rudder done` without piping never hangs. */
1177
1153
  async function readPipedStdin(timeoutMs = 3000) {
@@ -1206,18 +1182,11 @@ async function readPipedStdin(timeoutMs = 3000) {
1206
1182
  });
1207
1183
  });
1208
1184
  }
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`. */
1185
+ /** `rudder done [--node <id>] ['<json>']`: compatibility callback for old runs.
1186
+ * Accepts a CompletionNote JSON via stdin (piped) or as the joined args; a non-JSON
1187
+ * arg is treated as a freeform summary. It only writes the sidecar file an old
1188
+ * scheduler reads (RUDDER_DONE_FILE when set, else .rudder/done/<node>.json). */
1219
1189
  async function runDone(parsed) {
1220
- const repoRoot = findRepoRoot();
1221
1190
  const node = parsed.flags.node;
1222
1191
  let raw = (await readPipedStdin()).trim();
1223
1192
  if (!raw && parsed.args.length) {
@@ -1235,48 +1204,6 @@ async function runDone(parsed) {
1235
1204
  if (doneFile) {
1236
1205
  await writeCompletionNoteFile(doneFile, note);
1237
1206
  }
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
1207
  }
1281
1208
  async function runContextCommand(parsed) {
1282
1209
  const sub = parsed.args[0] ?? "audit";
@@ -1288,129 +1215,6 @@ async function runContextCommand(parsed) {
1288
1215
  throw new Error("Usage: rudder context [audit]");
1289
1216
  }
1290
1217
  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
- `);
1218
+ console.log(commandHelp());
1415
1219
  }
1416
1220
  //# sourceMappingURL=main.js.map