@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
@@ -0,0 +1,248 @@
1
+ #!/usr/bin/env node
2
+ import { createHash, randomUUID } from "node:crypto";
3
+ import { execFileSync } from "node:child_process";
4
+ import fs from "node:fs/promises";
5
+ import { constants, realpathSync, openSync, closeSync, fstatSync, readSync } from "node:fs";
6
+ import path from "node:path";
7
+ import { fileURLToPath } from "node:url";
8
+ import { isDeepStrictEqual, parseArgs } from "node:util";
9
+
10
+ export const NATIVE_PLATFORMS = Object.freeze(["darwin-arm64", "linux-x64"]);
11
+ export const NATIVE_BINARIES = Object.freeze(["rudder-native", "rudder-jj"]);
12
+ export const MANIFEST_NAME = "native-manifest.json";
13
+ export const NATIVE_FEATURES = Object.freeze(["rudder-vcs-bridge/cli"]);
14
+ const NATIVE_INPUTS = ["Cargo.toml", "Cargo.lock", ".cargo/config", ".cargo/config.toml", "rust-toolchain", "rust-toolchain.toml", "native", "engine", "vcs-bridge", "assets"];
15
+ const MAX_BINARY_BYTES = 512 * 1024 * 1024;
16
+ const MAX_MANIFEST_BYTES = 16 * 1024;
17
+ const MAX_PACKAGE_BYTES = 256 * 1024;
18
+
19
+ function requireValue(condition, message) {
20
+ if (!condition) throw new Error(message);
21
+ }
22
+ function exact(value, keys, label) {
23
+ requireValue(value && typeof value === "object" && !Array.isArray(value)
24
+ && Object.keys(value).sort().join("\0") === [...keys].sort().join("\0"), `Invalid ${label} fields`);
25
+ }
26
+ function git(cwd, args) {
27
+ return execFileSync("git", ["--no-optional-locks", "-C", cwd, ...args], { encoding: "utf8", maxBuffer: 2 * 1024 * 1024, stdio: ["ignore", "pipe", "pipe"] }).trim();
28
+ }
29
+ function checkTrackedSourceBytes(cwd, revision) {
30
+ const entries = git(cwd, ["ls-tree", "-rz", revision, "--", ...NATIVE_INPUTS]).split("\0").filter(Boolean);
31
+ requireValue(entries.length > 0 && entries.length <= 10_000, "Native source file inventory exceeds its bound");
32
+ const buffer = Buffer.alloc(64 * 1024);
33
+ let total = 0;
34
+ for (const entry of entries) {
35
+ const separator = entry.indexOf("\t");
36
+ const [mode, kind, expected] = entry.slice(0, separator).split(" ");
37
+ const relative = entry.slice(separator + 1);
38
+ requireValue(separator > 0 && ["100644", "100755"].includes(mode) && kind === "blob" && /^[0-9a-f]{40}$/.test(expected), "Native inputs require regular tracked source files");
39
+ const fd = openSync(path.join(cwd, relative), constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
40
+ try {
41
+ const before = fstatSync(fd, { bigint: true });
42
+ total += Number(before.size);
43
+ requireValue(before.isFile() && before.size <= BigInt(MAX_BINARY_BYTES) && total <= 2 * 1024 ** 3, "Native source bytes exceed their bound");
44
+ // Match Git's blob identity directly, independent of index stat caches,
45
+ // assume-unchanged/skip-worktree flags or line-ending conversion settings.
46
+ const digest = createHash("sha1").update(`blob ${before.size}\0`);
47
+ let size = 0;
48
+ for (;;) {
49
+ const count = readSync(fd, buffer, 0, buffer.length, size);
50
+ if (!count) break;
51
+ size += count;
52
+ requireValue(size <= Number(before.size), "Native source changed during verification");
53
+ digest.update(buffer.subarray(0, count));
54
+ }
55
+ const after = fstatSync(fd, { bigint: true });
56
+ requireValue(size === Number(before.size) && before.size === after.size
57
+ && before.mtimeNs === after.mtimeNs && before.ctimeNs === after.ctimeNs
58
+ && digest.digest("hex") === expected, "Native source bytes do not match the source revision");
59
+ } finally { closeSync(fd); }
60
+ }
61
+ }
62
+ function checkPackageMetadata(cwd, revision) {
63
+ const fromGit = git(cwd, ["show", `${revision}:package.json`]);
64
+ requireValue(Buffer.byteLength(fromGit) <= MAX_PACKAGE_BYTES, "Native package metadata exceeds its bound");
65
+ const fd = openSync(path.join(cwd, "package.json"), constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
66
+ let current, expected;
67
+ try {
68
+ const stat = fstatSync(fd);
69
+ requireValue(stat.isFile() && stat.size <= MAX_PACKAGE_BYTES, "Native package metadata exceeds its bound");
70
+ const buffer = Buffer.alloc(MAX_PACKAGE_BYTES + 1);
71
+ let size = 0;
72
+ while (size < buffer.length) {
73
+ const count = readSync(fd, buffer, size, buffer.length - size, size);
74
+ if (!count) break;
75
+ size += count;
76
+ }
77
+ requireValue(size === stat.size && size <= MAX_PACKAGE_BYTES, "Native package metadata changed during read");
78
+ try { current = JSON.parse(buffer.subarray(0, size).toString("utf8")); expected = JSON.parse(fromGit); }
79
+ catch { throw new Error("Invalid native package metadata JSON"); }
80
+ } finally { closeSync(fd); }
81
+ requireValue(current && expected && !Array.isArray(current) && !Array.isArray(expected), "Invalid native package metadata");
82
+ const permittedName = current.name === expected.name || (expected.name === "@exla/rudder" && current.name === "@viraatdas/rudder");
83
+ requireValue(permittedName && isDeepStrictEqual({ ...current, name: expected.name }, expected), "Package metadata must match the source revision except for the approved npm name alias");
84
+ }
85
+
86
+ /** Release prebuilt provenance requires a real clean Git checkout. Ordinary
87
+ * local Cargo builds do not call this, including builds from source archives. */
88
+ export function checkedSourceRevision({ cwd = process.cwd(), expectedRevision } = {}) {
89
+ requireValue(realpathSync(git(cwd, ["rev-parse", "--show-toplevel"])) === realpathSync(cwd), "Release prebuilts require the Git checkout root");
90
+ const revision = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
91
+ requireValue(/^[0-9a-f]{40}$/.test(revision), "Invalid native source revision");
92
+ if (expectedRevision !== undefined) {
93
+ requireValue(/^[0-9a-f]{40}$/.test(expectedRevision) && expectedRevision === revision, "Native source revision does not match the expected revision");
94
+ }
95
+ const changed = git(cwd, ["status", "--porcelain=v1", "--untracked-files=all", "--", ...NATIVE_INPUTS]);
96
+ requireValue(!changed, "Native build inputs must match the source revision before using release prebuilts");
97
+ checkTrackedSourceBytes(cwd, revision);
98
+ checkPackageMetadata(cwd, revision);
99
+ return revision;
100
+ }
101
+
102
+ async function directory(file) {
103
+ const stat = await fs.lstat(file);
104
+ requireValue(stat.isDirectory() && !stat.isSymbolicLink(), "Native artifact directory must be a real directory");
105
+ }
106
+
107
+ /** Hash/copy at most 64 KiB at a time, check bounded size and reject changes
108
+ * during the read. Rechecking while staging prevents verify/copy substitution. */
109
+ export async function readNativeBinary(file, expected, destination) {
110
+ const source = await fs.open(file, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
111
+ let output;
112
+ try {
113
+ const before = await source.stat({ bigint: true });
114
+ requireValue(before.isFile() && before.size > 0n && before.size <= BigInt(MAX_BINARY_BYTES), "Invalid native executable size or type");
115
+ if (expected) requireValue(Number(before.size) === expected.size, "Native executable size mismatch");
116
+ if (destination) output = await fs.open(destination, "wx", 0o755);
117
+ const buffer = Buffer.alloc(64 * 1024);
118
+ const hash = createHash("sha256");
119
+ let size = 0;
120
+ for (;;) {
121
+ const { bytesRead } = await source.read(buffer, 0, buffer.length, size);
122
+ if (!bytesRead) break;
123
+ size += bytesRead;
124
+ requireValue(size <= MAX_BINARY_BYTES && size <= Number(before.size), "Native executable changed during read");
125
+ hash.update(buffer.subarray(0, bytesRead));
126
+ if (output) {
127
+ let written = 0;
128
+ while (written < bytesRead) {
129
+ const result = await output.write(buffer, written, bytesRead - written);
130
+ requireValue(result.bytesWritten > 0, "Native executable copy made no progress");
131
+ written += result.bytesWritten;
132
+ }
133
+ }
134
+ }
135
+ const after = await source.stat({ bigint: true });
136
+ requireValue(size === Number(before.size) && before.size === after.size
137
+ && before.mtimeNs === after.mtimeNs && before.ctimeNs === after.ctimeNs, "Native executable changed during read");
138
+ const result = { sha256: hash.digest("hex"), size };
139
+ if (expected) requireValue(result.sha256 === expected.sha256, "Native executable SHA256 mismatch");
140
+ if (output) await output.chmod(0o755);
141
+ return result;
142
+ } finally {
143
+ try { await output?.close(); }
144
+ finally { await source.close(); }
145
+ }
146
+ }
147
+
148
+ async function readManifest(file) {
149
+ const handle = await fs.open(file, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
150
+ try {
151
+ const stat = await handle.stat();
152
+ requireValue(stat.isFile() && stat.size > 0 && stat.size <= MAX_MANIFEST_BYTES, "Invalid native manifest size or type");
153
+ const buffer = Buffer.alloc(MAX_MANIFEST_BYTES + 1);
154
+ let size = 0;
155
+ while (size < buffer.length) {
156
+ const { bytesRead } = await handle.read(buffer, size, buffer.length - size, size);
157
+ if (!bytesRead) break;
158
+ size += bytesRead;
159
+ }
160
+ requireValue(size === stat.size && size <= MAX_MANIFEST_BYTES, "Native manifest changed during read");
161
+ try { return JSON.parse(buffer.subarray(0, size).toString("utf8")); }
162
+ catch { throw new Error("Invalid native manifest JSON"); }
163
+ } finally { await handle.close(); }
164
+ }
165
+
166
+ function validateManifest(manifest, platform, revision) {
167
+ exact(manifest, ["formatVersion", "sourceRevision", "platform", "buildProfile", "features", "files"], "native manifest");
168
+ requireValue(manifest.formatVersion === 1 && manifest.sourceRevision === revision && manifest.platform === platform
169
+ && manifest.buildProfile === "release" && JSON.stringify(manifest.features) === JSON.stringify(NATIVE_FEATURES), "Native manifest source, platform or build graph mismatch");
170
+ exact(manifest.files, NATIVE_BINARIES, "native manifest executable");
171
+ for (const name of NATIVE_BINARIES) {
172
+ const file = manifest.files[name];
173
+ exact(file, ["sha256", "size"], "native executable manifest");
174
+ requireValue(typeof file.sha256 === "string" && /^[0-9a-f]{64}$/.test(file.sha256)
175
+ && Number.isSafeInteger(file.size) && file.size > 0 && file.size <= MAX_BINARY_BYTES, "Invalid native executable manifest");
176
+ }
177
+ }
178
+
179
+ async function artifactDirectory(dir, allowMissingManifest = false) {
180
+ await directory(dir);
181
+ const entries = (await fs.readdir(dir)).sort();
182
+ const allowed = [...NATIVE_BINARIES, MANIFEST_NAME].sort();
183
+ requireValue(entries.includes("rudder-native"), "Native artifact is missing rudder-native");
184
+ requireValue(entries.includes("rudder-jj"), "Native artifact is missing its rudder-jj companion");
185
+ requireValue(JSON.stringify(entries) === JSON.stringify(allowed)
186
+ || (allowMissingManifest && JSON.stringify(entries) === JSON.stringify([...NATIVE_BINARIES].sort())), "Native artifact has missing or unexpected files");
187
+ for (const name of entries) requireValue((await fs.lstat(path.join(dir, name))).isFile(), "Native artifacts must be regular files, not symlinks");
188
+ }
189
+
190
+ export async function createNativeManifest({ directory: dir, platform, cwd = process.cwd(), expectedRevision } = {}) {
191
+ requireValue(NATIVE_PLATFORMS.includes(platform), "Unsupported native artifact platform");
192
+ const revision = checkedSourceRevision({ cwd, expectedRevision });
193
+ await artifactDirectory(dir, true);
194
+ const files = {};
195
+ for (const name of NATIVE_BINARIES) files[name] = await readNativeBinary(path.join(dir, name));
196
+ requireValue(checkedSourceRevision({ cwd, expectedRevision }) === revision, "Native source changed during manifest creation");
197
+ const manifest = { formatVersion: 1, sourceRevision: revision, platform, buildProfile: "release", features: [...NATIVE_FEATURES], files };
198
+ const temporary = path.join(dir, `.native-manifest-${randomUUID()}.tmp`);
199
+ try {
200
+ await fs.writeFile(temporary, JSON.stringify(manifest, null, 2) + "\n", { flag: "wx", mode: 0o644 });
201
+ await fs.rename(temporary, path.join(dir, MANIFEST_NAME));
202
+ } finally { await fs.rm(temporary, { force: true }); }
203
+ return manifest;
204
+ }
205
+
206
+ export async function verifyNativeArtifacts({ root, cwd = process.cwd(), expectedRevision } = {}) {
207
+ const revision = checkedSourceRevision({ cwd, expectedRevision });
208
+ await directory(root);
209
+ const names = NATIVE_PLATFORMS.map(key => `rudder-native-${key}`).sort();
210
+ requireValue(JSON.stringify((await fs.readdir(root)).sort()) === JSON.stringify(names), "Release prebuilts require exactly all three supported platform artifacts");
211
+ const artifacts = [];
212
+ for (const platform of NATIVE_PLATFORMS) {
213
+ const dir = path.join(root, `rudder-native-${platform}`);
214
+ await artifactDirectory(dir);
215
+ const manifest = await readManifest(path.join(dir, MANIFEST_NAME));
216
+ validateManifest(manifest, platform, revision);
217
+ const files = [];
218
+ for (const name of NATIVE_BINARIES) {
219
+ const file = path.join(dir, name);
220
+ await readNativeBinary(file, manifest.files[name]);
221
+ files.push({ name, path: file, ...manifest.files[name] });
222
+ }
223
+ artifacts.push({ platform, manifest, files });
224
+ }
225
+ requireValue(checkedSourceRevision({ cwd, expectedRevision }) === revision, "Native source changed during artifact verification");
226
+ return { sourceRevision: revision, artifacts };
227
+ }
228
+
229
+ if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
230
+ try {
231
+ const { values, positionals } = parseArgs({ allowPositionals: true, options: {
232
+ root: { type: "string" }, directory: { type: "string" }, platform: { type: "string" }, revision: { type: "string" },
233
+ } });
234
+ requireValue(positionals.length === 1 && values.revision, "Native artifact command requires an explicit revision");
235
+ if (positionals[0] === "create") {
236
+ requireValue(values.directory && values.platform === `${process.platform}-${process.arch}`, "Native artifact producer must match its build host platform");
237
+ const manifest = await createNativeManifest({ directory: values.directory, platform: values.platform, expectedRevision: values.revision });
238
+ console.log(`Created ${manifest.platform} native manifest for ${manifest.sourceRevision}`);
239
+ } else if (positionals[0] === "verify") {
240
+ requireValue(values.root, "Native artifact verification requires a root");
241
+ const verified = await verifyNativeArtifacts({ root: values.root, expectedRevision: values.revision });
242
+ console.log(`Verified ${verified.artifacts.length} native pairs for ${verified.sourceRevision}`);
243
+ } else throw new Error("Unknown native artifact command");
244
+ } catch (error) {
245
+ console.error(`Native artifacts: ${error.message}`);
246
+ process.exitCode = 1;
247
+ }
248
+ }
@@ -1,10 +0,0 @@
1
- import type { SpendMeter } from "./state.js";
2
- export declare function callAdvisedTextModel(params: {
3
- executorModel: string;
4
- advisorModel: string;
5
- system: string;
6
- user: string;
7
- maxTokens?: number;
8
- timeoutMs?: number;
9
- meter?: SpendMeter;
10
- }): Promise<string>;
@@ -1,115 +0,0 @@
1
- import { callTextModel, resolveAnthropicApiKey } from "../task-summary.js";
2
- /**
3
- * Advisor-pattern text call (Anthropic advisor tool, beta
4
- * advisor-tool-2026-03-01): a cheaper executor model generates the output and
5
- * consults a higher-intelligence advisor mid-generation for strategic
6
- * guidance. Most tokens bill at the executor rate; the loop gets near
7
- * advisor-grade judgment on its mining and judging calls at a fraction of the
8
- * cost of running the big model end to end.
9
- *
10
- * Degradation path: the deterministic test hook and the no-API-key case (CLI
11
- * auth) fall back to callTextModel, and any advisor-request failure falls
12
- * back to a plain executor-only call, so the loop never hard-depends on the
13
- * beta.
14
- */
15
- const ADVISOR_BETA = "advisor-tool-2026-03-01";
16
- const ADVISOR_MAX_TOKENS = 2048;
17
- const MAX_PAUSE_RESUMES = 3;
18
- const ADVISOR_SYSTEM_NUDGE = `
19
-
20
- You have access to an \`advisor\` tool backed by a stronger reviewer model. It takes NO parameters; your full context is forwarded automatically. Consult it once before committing to your answer, weigh its guidance seriously, then produce the final output yourself in the requested format.`;
21
- const ADVISOR_USER_SUFFIX = "\n\n(Advisor: please keep your guidance under 200 words; a focused verdict on the hard part beats a comprehensive plan.)";
22
- export async function callAdvisedTextModel(params) {
23
- const plainFallback = () => callTextModel({
24
- model: params.executorModel,
25
- system: params.system,
26
- user: params.user,
27
- maxTokens: params.maxTokens,
28
- timeoutMs: params.timeoutMs,
29
- });
30
- // Deterministic test hook and disabled-advisor path go straight through.
31
- if (process.env.RUDDER_FAKE_MODEL_OUTPUT || !params.advisorModel) {
32
- return await plainFallback();
33
- }
34
- const apiKey = await resolveAnthropicApiKey();
35
- if (!apiKey) {
36
- // CLI-auth users have no raw key to hit the API with; use the CLI path.
37
- return await plainFallback();
38
- }
39
- const tools = [
40
- {
41
- type: "advisor_20260301",
42
- name: "advisor",
43
- model: params.advisorModel,
44
- max_tokens: ADVISOR_MAX_TOKENS,
45
- },
46
- ];
47
- const messages = [
48
- { role: "user", content: params.user + ADVISOR_USER_SUFFIX },
49
- ];
50
- const timeoutMs = params.timeoutMs ?? 240000;
51
- const collected = [];
52
- for (let attempt = 0; attempt <= MAX_PAUSE_RESUMES; attempt += 1) {
53
- let data;
54
- try {
55
- const controller = new AbortController();
56
- const timer = setTimeout(() => controller.abort(), timeoutMs);
57
- const response = await fetch("https://api.anthropic.com/v1/messages", {
58
- method: "POST",
59
- headers: {
60
- "content-type": "application/json",
61
- "x-api-key": apiKey,
62
- "anthropic-version": "2023-06-01",
63
- "anthropic-beta": ADVISOR_BETA,
64
- },
65
- body: JSON.stringify({
66
- model: params.executorModel,
67
- max_tokens: params.maxTokens ?? 2048,
68
- system: params.system + ADVISOR_SYSTEM_NUDGE,
69
- tools,
70
- messages,
71
- }),
72
- signal: controller.signal,
73
- });
74
- clearTimeout(timer);
75
- if (!response.ok) {
76
- // Invalid pair / beta unavailable / overloaded: degrade to plain.
77
- return await plainFallback();
78
- }
79
- data = (await response.json());
80
- }
81
- catch {
82
- return await plainFallback();
83
- }
84
- meterIterations(params, data);
85
- for (const block of data.content ?? []) {
86
- if (block.type === "text" && typeof block.text === "string") {
87
- collected.push(block.text);
88
- }
89
- }
90
- if (data.stop_reason === "pause_turn" && attempt < MAX_PAUSE_RESUMES) {
91
- // Resume the paused turn: round-trip the assistant content verbatim.
92
- messages.push({ role: "assistant", content: data.content ?? [] });
93
- continue;
94
- }
95
- break;
96
- }
97
- const text = collected.join("").trim();
98
- return text || (await plainFallback());
99
- }
100
- function meterIterations(params, data) {
101
- if (!params.meter)
102
- return;
103
- const iterations = data.usage?.iterations;
104
- if (iterations && iterations.length > 0) {
105
- for (const iteration of iterations) {
106
- const model = iteration.type === "advisor_message"
107
- ? (iteration.model ?? params.advisorModel)
108
- : params.executorModel;
109
- params.meter.addModelTokens(model, iteration.input_tokens ?? 0, iteration.output_tokens ?? 0);
110
- }
111
- return;
112
- }
113
- params.meter.addModelTokens(params.executorModel, data.usage?.input_tokens ?? 0, data.usage?.output_tokens ?? 0);
114
- }
115
- //# sourceMappingURL=advisor.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"advisor.js","sourceRoot":"","sources":["../../src/improve/advisor.ts"],"names":[],"mappings":"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"}
@@ -1,49 +0,0 @@
1
- import type { RunRecord } from "../types.js";
2
- import type { ImproveSettings, MetricsSnapshot, SessionRecord, Watermark } from "./state.js";
3
- /**
4
- * Walk registered projects and build redacted session records for every run
5
- * newer than the watermark. Pure telemetry read; never writes into a project.
6
- */
7
- export declare function collectSessions(settings: ImproveSettings, watermark: Watermark): Promise<{
8
- sessions: SessionRecord[];
9
- nextWatermark: Watermark;
10
- }>;
11
- /**
12
- * Whether a run experienced an integration conflict at ANY point, not just one
13
- * still unresolved at collect time. `status`/`merge.status` are LIVE state:
14
- * once a resolver or re-merge succeeds they are rewritten to merged, which is
15
- * why counting them alone reported mergeConflictRate 0 while resolver-labeled
16
- * sessions were everywhere. Reads, in order of reliability: the durable
17
- * `hadMergeConflict` marker, the live conflict state, `resolverFor` (the
18
- * daemon's resolver runs), and finally the native resolver task labels, which
19
- * are the only trace on records written before `hadMergeConflict` existed
20
- * (formats set in native/src/main.rs start_conflict_resolution_agent).
21
- */
22
- export declare function runHadMergeConflict(run: Pick<RunRecord, "status" | "merge" | "sync" | "hadMergeConflict" | "resolverFor" | "task" | "taskSummary">): boolean;
23
- /**
24
- * Raw timestamp parse (millis string or ISO), with NO plausibility window.
25
- * Used for watermark ordering, where the job is a consistent total order over
26
- * whatever stamps actually exist on disk, not measurement quality. The
27
- * plausibility-checked parseRunTimestampMs below stays the right tool for
28
- * durations. This exists because run.json carries two formats (ISO from the
29
- * TS writers, epoch millis from the native TUI) and the previous LEXICOGRAPHIC
30
- * comparison ordered every ISO string ("2026-…") above every millis string
31
- * ("17834…"): one ISO-stamped run would push the watermark somewhere no
32
- * native-written run could ever exceed, permanently blinding collection to
33
- * that project's native runs.
34
- */
35
- export declare function rawTimestampMs(value: string | number | undefined): number | undefined;
36
- /** Read a watermark entry, tolerating the legacy string formats (ISO or millis). */
37
- export declare function watermarkValueMs(value: string | number | undefined): number;
38
- /**
39
- * Parse a run timestamp into epoch ms, rejecting implausible values. Run
40
- * records carry two formats: ISO strings (the TS writers, util.nowIso) and
41
- * epoch-millisecond strings (the native TUI's now_stamp in
42
- * native/src/gitio.rs), which Date.parse cannot read. Anything implausible is
43
- * rejected rather than letting Date.parse guess: native test fixtures once
44
- * leaked run.json records with the sentinel createdAt "1" into a real
45
- * .rudder/runs dir, Date.parse("1") is 2001-01-01, and the resulting 25-year
46
- * durations dominated medianDurationMs for the whole cycle.
47
- */
48
- export declare function parseRunTimestampMs(value: string | undefined): number | undefined;
49
- export declare function computeMetrics(cycleId: string, sessions: SessionRecord[]): MetricsSnapshot;