thehood 0.1.0-preview.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 (274) hide show
  1. package/CODE_OF_CONDUCT.md +21 -0
  2. package/CONTRIBUTING.md +58 -0
  3. package/LICENSE +21 -0
  4. package/PRIVACY.md +49 -0
  5. package/README.md +264 -0
  6. package/SECURITY.md +31 -0
  7. package/dist/bridges/chatgptWebBridge.d.ts +2 -0
  8. package/dist/bridges/chatgptWebBridge.js +981 -0
  9. package/dist/bridges/chatgptWebBridge.js.map +1 -0
  10. package/dist/cli/args.d.ts +9 -0
  11. package/dist/cli/args.js +82 -0
  12. package/dist/cli/args.js.map +1 -0
  13. package/dist/cli/format.d.ts +56 -0
  14. package/dist/cli/format.js +752 -0
  15. package/dist/cli/format.js.map +1 -0
  16. package/dist/cli/main.d.ts +2 -0
  17. package/dist/cli/main.js +996 -0
  18. package/dist/cli/main.js.map +1 -0
  19. package/dist/cli/mcpConfig.d.ts +36 -0
  20. package/dist/cli/mcpConfig.js +98 -0
  21. package/dist/cli/mcpConfig.js.map +1 -0
  22. package/dist/index.d.ts +37 -0
  23. package/dist/index.js +38 -0
  24. package/dist/index.js.map +1 -0
  25. package/dist/mcp/protocol.d.ts +44 -0
  26. package/dist/mcp/protocol.js +33 -0
  27. package/dist/mcp/protocol.js.map +1 -0
  28. package/dist/mcp/server.d.ts +1 -0
  29. package/dist/mcp/server.js +106 -0
  30. package/dist/mcp/server.js.map +1 -0
  31. package/dist/mcp/tools.d.ts +10 -0
  32. package/dist/mcp/tools.js +2200 -0
  33. package/dist/mcp/tools.js.map +1 -0
  34. package/dist/mcp/validation.d.ts +8 -0
  35. package/dist/mcp/validation.js +67 -0
  36. package/dist/mcp/validation.js.map +1 -0
  37. package/dist/providers/chatgptWeb.d.ts +2 -0
  38. package/dist/providers/chatgptWeb.js +26 -0
  39. package/dist/providers/chatgptWeb.js.map +1 -0
  40. package/dist/providers/claudeCode.d.ts +4 -0
  41. package/dist/providers/claudeCode.js +32 -0
  42. package/dist/providers/claudeCode.js.map +1 -0
  43. package/dist/providers/codexCli.d.ts +6 -0
  44. package/dist/providers/codexCli.js +25 -0
  45. package/dist/providers/codexCli.js.map +1 -0
  46. package/dist/providers/codexCliModels.d.ts +23 -0
  47. package/dist/providers/codexCliModels.js +147 -0
  48. package/dist/providers/codexCliModels.js.map +1 -0
  49. package/dist/providers/localCommand.d.ts +26 -0
  50. package/dist/providers/localCommand.js +614 -0
  51. package/dist/providers/localCommand.js.map +1 -0
  52. package/dist/providers/markdownPayload.d.ts +7 -0
  53. package/dist/providers/markdownPayload.js +29 -0
  54. package/dist/providers/markdownPayload.js.map +1 -0
  55. package/dist/providers/responseSchema.d.ts +3 -0
  56. package/dist/providers/responseSchema.js +187 -0
  57. package/dist/providers/responseSchema.js.map +1 -0
  58. package/dist/providers/router.d.ts +3 -0
  59. package/dist/providers/router.js +21 -0
  60. package/dist/providers/router.js.map +1 -0
  61. package/dist/providers/stub.d.ts +2 -0
  62. package/dist/providers/stub.js +177 -0
  63. package/dist/providers/stub.js.map +1 -0
  64. package/dist/providers/types.d.ts +37 -0
  65. package/dist/providers/types.js +2 -0
  66. package/dist/providers/types.js.map +1 -0
  67. package/dist/runtime/agentBoard.d.ts +79 -0
  68. package/dist/runtime/agentBoard.js +166 -0
  69. package/dist/runtime/agentBoard.js.map +1 -0
  70. package/dist/runtime/agentBoardArtifact.d.ts +9 -0
  71. package/dist/runtime/agentBoardArtifact.js +171 -0
  72. package/dist/runtime/agentBoardArtifact.js.map +1 -0
  73. package/dist/runtime/agentRunner.d.ts +17 -0
  74. package/dist/runtime/agentRunner.js +92 -0
  75. package/dist/runtime/agentRunner.js.map +1 -0
  76. package/dist/runtime/approvalInbox.d.ts +54 -0
  77. package/dist/runtime/approvalInbox.js +143 -0
  78. package/dist/runtime/approvalInbox.js.map +1 -0
  79. package/dist/runtime/approvalPolicy.d.ts +11 -0
  80. package/dist/runtime/approvalPolicy.js +58 -0
  81. package/dist/runtime/approvalPolicy.js.map +1 -0
  82. package/dist/runtime/artifacts.d.ts +23 -0
  83. package/dist/runtime/artifacts.js +48 -0
  84. package/dist/runtime/artifacts.js.map +1 -0
  85. package/dist/runtime/browserManager.d.ts +37 -0
  86. package/dist/runtime/browserManager.js +356 -0
  87. package/dist/runtime/browserManager.js.map +1 -0
  88. package/dist/runtime/canonicalMemory.d.ts +23 -0
  89. package/dist/runtime/canonicalMemory.js +134 -0
  90. package/dist/runtime/canonicalMemory.js.map +1 -0
  91. package/dist/runtime/chatGptPageReadiness.d.ts +16 -0
  92. package/dist/runtime/chatGptPageReadiness.js +74 -0
  93. package/dist/runtime/chatGptPageReadiness.js.map +1 -0
  94. package/dist/runtime/commandRunner.d.ts +18 -0
  95. package/dist/runtime/commandRunner.js +115 -0
  96. package/dist/runtime/commandRunner.js.map +1 -0
  97. package/dist/runtime/commandSafety.d.ts +7 -0
  98. package/dist/runtime/commandSafety.js +61 -0
  99. package/dist/runtime/commandSafety.js.map +1 -0
  100. package/dist/runtime/config.d.ts +10 -0
  101. package/dist/runtime/config.js +107 -0
  102. package/dist/runtime/config.js.map +1 -0
  103. package/dist/runtime/crewLanes.d.ts +2 -0
  104. package/dist/runtime/crewLanes.js +123 -0
  105. package/dist/runtime/crewLanes.js.map +1 -0
  106. package/dist/runtime/criticPolicy.d.ts +17 -0
  107. package/dist/runtime/criticPolicy.js +50 -0
  108. package/dist/runtime/criticPolicy.js.map +1 -0
  109. package/dist/runtime/defaults.d.ts +5 -0
  110. package/dist/runtime/defaults.js +100 -0
  111. package/dist/runtime/defaults.js.map +1 -0
  112. package/dist/runtime/directives.d.ts +3 -0
  113. package/dist/runtime/directives.js +218 -0
  114. package/dist/runtime/directives.js.map +1 -0
  115. package/dist/runtime/doctor.d.ts +36 -0
  116. package/dist/runtime/doctor.js +185 -0
  117. package/dist/runtime/doctor.js.map +1 -0
  118. package/dist/runtime/errors.d.ts +20 -0
  119. package/dist/runtime/errors.js +41 -0
  120. package/dist/runtime/errors.js.map +1 -0
  121. package/dist/runtime/externalTransfer.d.ts +20 -0
  122. package/dist/runtime/externalTransfer.js +156 -0
  123. package/dist/runtime/externalTransfer.js.map +1 -0
  124. package/dist/runtime/fanout.d.ts +64 -0
  125. package/dist/runtime/fanout.js +263 -0
  126. package/dist/runtime/fanout.js.map +1 -0
  127. package/dist/runtime/gitEvidence.d.ts +10 -0
  128. package/dist/runtime/gitEvidence.js +80 -0
  129. package/dist/runtime/gitEvidence.js.map +1 -0
  130. package/dist/runtime/handoffs.d.ts +32 -0
  131. package/dist/runtime/handoffs.js +100 -0
  132. package/dist/runtime/handoffs.js.map +1 -0
  133. package/dist/runtime/ids.d.ts +2 -0
  134. package/dist/runtime/ids.js +4 -0
  135. package/dist/runtime/ids.js.map +1 -0
  136. package/dist/runtime/localStateIgnore.d.ts +9 -0
  137. package/dist/runtime/localStateIgnore.js +98 -0
  138. package/dist/runtime/localStateIgnore.js.map +1 -0
  139. package/dist/runtime/loop.d.ts +14 -0
  140. package/dist/runtime/loop.js +1863 -0
  141. package/dist/runtime/loop.js.map +1 -0
  142. package/dist/runtime/loopRecommendation.d.ts +109 -0
  143. package/dist/runtime/loopRecommendation.js +566 -0
  144. package/dist/runtime/loopRecommendation.js.map +1 -0
  145. package/dist/runtime/loopResponsibilities.d.ts +2 -0
  146. package/dist/runtime/loopResponsibilities.js +395 -0
  147. package/dist/runtime/loopResponsibilities.js.map +1 -0
  148. package/dist/runtime/loopRunner.d.ts +28 -0
  149. package/dist/runtime/loopRunner.js +81 -0
  150. package/dist/runtime/loopRunner.js.map +1 -0
  151. package/dist/runtime/operatorNextActions.d.ts +2 -0
  152. package/dist/runtime/operatorNextActions.js +344 -0
  153. package/dist/runtime/operatorNextActions.js.map +1 -0
  154. package/dist/runtime/paths.d.ts +9 -0
  155. package/dist/runtime/paths.js +14 -0
  156. package/dist/runtime/paths.js.map +1 -0
  157. package/dist/runtime/permissions.d.ts +9 -0
  158. package/dist/runtime/permissions.js +73 -0
  159. package/dist/runtime/permissions.js.map +1 -0
  160. package/dist/runtime/progressPacket.d.ts +12 -0
  161. package/dist/runtime/progressPacket.js +512 -0
  162. package/dist/runtime/progressPacket.js.map +1 -0
  163. package/dist/runtime/protectedPaths.d.ts +6 -0
  164. package/dist/runtime/protectedPaths.js +48 -0
  165. package/dist/runtime/protectedPaths.js.map +1 -0
  166. package/dist/runtime/providers.d.ts +13 -0
  167. package/dist/runtime/providers.js +60 -0
  168. package/dist/runtime/providers.js.map +1 -0
  169. package/dist/runtime/reconciliation.d.ts +17 -0
  170. package/dist/runtime/reconciliation.js +283 -0
  171. package/dist/runtime/reconciliation.js.map +1 -0
  172. package/dist/runtime/redaction.d.ts +1 -0
  173. package/dist/runtime/redaction.js +5 -0
  174. package/dist/runtime/redaction.js.map +1 -0
  175. package/dist/runtime/remoteRepoContext.d.ts +77 -0
  176. package/dist/runtime/remoteRepoContext.js +316 -0
  177. package/dist/runtime/remoteRepoContext.js.map +1 -0
  178. package/dist/runtime/repoContext.d.ts +50 -0
  179. package/dist/runtime/repoContext.js +399 -0
  180. package/dist/runtime/repoContext.js.map +1 -0
  181. package/dist/runtime/repoGateway.d.ts +64 -0
  182. package/dist/runtime/repoGateway.js +308 -0
  183. package/dist/runtime/repoGateway.js.map +1 -0
  184. package/dist/runtime/responseContracts.d.ts +3 -0
  185. package/dist/runtime/responseContracts.js +86 -0
  186. package/dist/runtime/responseContracts.js.map +1 -0
  187. package/dist/runtime/reviewLanes.d.ts +2 -0
  188. package/dist/runtime/reviewLanes.js +343 -0
  189. package/dist/runtime/reviewLanes.js.map +1 -0
  190. package/dist/runtime/reviewRouting.d.ts +51 -0
  191. package/dist/runtime/reviewRouting.js +152 -0
  192. package/dist/runtime/reviewRouting.js.map +1 -0
  193. package/dist/runtime/revisionPacket.d.ts +38 -0
  194. package/dist/runtime/revisionPacket.js +144 -0
  195. package/dist/runtime/revisionPacket.js.map +1 -0
  196. package/dist/runtime/revisionTrail.d.ts +2 -0
  197. package/dist/runtime/revisionTrail.js +162 -0
  198. package/dist/runtime/revisionTrail.js.map +1 -0
  199. package/dist/runtime/role-assignment.d.ts +4 -0
  200. package/dist/runtime/role-assignment.js +21 -0
  201. package/dist/runtime/role-assignment.js.map +1 -0
  202. package/dist/runtime/roleRoster.d.ts +28 -0
  203. package/dist/runtime/roleRoster.js +96 -0
  204. package/dist/runtime/roleRoster.js.map +1 -0
  205. package/dist/runtime/runInsights.d.ts +121 -0
  206. package/dist/runtime/runInsights.js +305 -0
  207. package/dist/runtime/runInsights.js.map +1 -0
  208. package/dist/runtime/runMonitor.d.ts +33 -0
  209. package/dist/runtime/runMonitor.js +143 -0
  210. package/dist/runtime/runMonitor.js.map +1 -0
  211. package/dist/runtime/runtime.d.ts +15 -0
  212. package/dist/runtime/runtime.js +199 -0
  213. package/dist/runtime/runtime.js.map +1 -0
  214. package/dist/runtime/runtimeInfo.d.ts +9 -0
  215. package/dist/runtime/runtimeInfo.js +76 -0
  216. package/dist/runtime/runtimeInfo.js.map +1 -0
  217. package/dist/runtime/store.d.ts +4 -0
  218. package/dist/runtime/store.js +48 -0
  219. package/dist/runtime/store.js.map +1 -0
  220. package/dist/runtime/summons.d.ts +25 -0
  221. package/dist/runtime/summons.js +403 -0
  222. package/dist/runtime/summons.js.map +1 -0
  223. package/dist/runtime/teamPresets.d.ts +14 -0
  224. package/dist/runtime/teamPresets.js +153 -0
  225. package/dist/runtime/teamPresets.js.map +1 -0
  226. package/dist/runtime/types.d.ts +505 -0
  227. package/dist/runtime/types.js +28 -0
  228. package/dist/runtime/types.js.map +1 -0
  229. package/dist/runtime/validationCommands.d.ts +18 -0
  230. package/dist/runtime/validationCommands.js +106 -0
  231. package/dist/runtime/validationCommands.js.map +1 -0
  232. package/dist/tui/dashboard.d.ts +41 -0
  233. package/dist/tui/dashboard.js +1115 -0
  234. package/dist/tui/dashboard.js.map +1 -0
  235. package/docs/ARCHITECTURE.md +277 -0
  236. package/docs/CLI_SPEC.md +396 -0
  237. package/docs/CODEX_SETUP.md +288 -0
  238. package/docs/COMPLETION_CONTRACT.md +52 -0
  239. package/docs/CONTRIBUTOR_GUIDE.md +70 -0
  240. package/docs/DEMO.md +62 -0
  241. package/docs/GLOSSARY.md +46 -0
  242. package/docs/GOAL_LOOP_SCHEDULE.md +50 -0
  243. package/docs/KNOWN_LIMITATIONS.md +29 -0
  244. package/docs/LICENSING.md +21 -0
  245. package/docs/LOOP_RECIPES.md +290 -0
  246. package/docs/LOOP_SELECTION_UX.md +118 -0
  247. package/docs/MCP_SPEC.md +689 -0
  248. package/docs/MEMORY_AND_RECONCILIATION.md +222 -0
  249. package/docs/NPM_PUBLISHING.md +51 -0
  250. package/docs/OPEN_DECISIONS.md +81 -0
  251. package/docs/PROMPT_SCHEMAS.md +411 -0
  252. package/docs/PROVIDER_ADAPTERS.md +323 -0
  253. package/docs/PROVIDER_MATRIX.md +21 -0
  254. package/docs/PUBLIC_REPO_READINESS.md +49 -0
  255. package/docs/RESEARCH_NOTES.md +92 -0
  256. package/docs/ROADMAP.md +94 -0
  257. package/docs/ROLE_CONTRACTS.md +252 -0
  258. package/docs/RUNTIME_LOOP.md +240 -0
  259. package/docs/SECURITY_AND_PRIVACY.md +161 -0
  260. package/docs/TESTING_AND_VERIFICATION.md +180 -0
  261. package/docs/TRUST_MODEL.md +65 -0
  262. package/docs/decisions/0001-runtime-first-cli-and-mcp.md +23 -0
  263. package/docs/decisions/0002-provider-neutral-role-mapping.md +43 -0
  264. package/docs/decisions/0003-separate-implementation-and-verification.md +27 -0
  265. package/docs/product/README.md +14 -0
  266. package/docs/product/model-selection.md +88 -0
  267. package/docs/product/positioning.md +37 -0
  268. package/docs/product/pro-usage-modes.md +70 -0
  269. package/docs/product/roadmap.md +57 -0
  270. package/docs/product/role-policy.md +89 -0
  271. package/docs/product/runtime-invariants.md +44 -0
  272. package/docs/release/v0.1.0-preview.0.md +48 -0
  273. package/examples/stub-demo/README.md +25 -0
  274. package/package.json +55 -0
@@ -0,0 +1,308 @@
1
+ import { spawn } from "node:child_process";
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { InputError } from "./errors.js";
5
+ import { resolveRepoPath } from "./paths.js";
6
+ const ignoredPathParts = new Set([
7
+ ".git",
8
+ ".thehood",
9
+ "node_modules",
10
+ "dist",
11
+ "build",
12
+ "coverage",
13
+ ".next",
14
+ ".turbo"
15
+ ]);
16
+ const secretPathPatterns = [
17
+ /^\.env(?:\.|$)/,
18
+ /(?:^|[/.-])secret(?:s)?(?:[/.-]|$)/i,
19
+ /(?:^|[/.-])token(?:s)?(?:[/.-]|$)/i,
20
+ /(?:^|[/.-])credential(?:s)?(?:[/.-]|$)/i,
21
+ /\.(?:pem|key|p12|pfx|crt|cer)$/i,
22
+ /id_rsa$/i,
23
+ /id_ed25519$/i
24
+ ];
25
+ const defaultMaxEntries = 200;
26
+ const defaultMaxDepth = 4;
27
+ const defaultMaxReadBytes = 20_000;
28
+ const maxSearchFileBytes = 200_000;
29
+ const toPosixPath = (value) => value.split(path.sep).join("/");
30
+ const isIgnoredPath = (relativePath) => {
31
+ const normalized = toPosixPath(relativePath).replace(/\/$/, "");
32
+ const parts = normalized.split("/").filter(Boolean);
33
+ return parts.some((part) => ignoredPathParts.has(part)) || secretPathPatterns.some((pattern) => pattern.test(normalized));
34
+ };
35
+ const isTextLike = (buffer) => !buffer.includes(0);
36
+ const clampPositiveInteger = (value, fallback, max) => {
37
+ if (value === undefined) {
38
+ return fallback;
39
+ }
40
+ if (!Number.isSafeInteger(value) || value < 1) {
41
+ throw new InputError("numeric limits must be positive integers.");
42
+ }
43
+ return Math.min(value, max);
44
+ };
45
+ const assertPathInside = (basePath, candidatePath) => {
46
+ const relativePath = toPosixPath(path.relative(basePath, candidatePath));
47
+ if (candidatePath !== basePath && (relativePath === ".." || relativePath.startsWith("../") || path.isAbsolute(relativePath))) {
48
+ throw new InputError("repo path escapes repo_path.");
49
+ }
50
+ };
51
+ const resolveSafeRepoPath = async (repoPathInput, requestedPath = ".") => {
52
+ const repoPath = resolveRepoPath(repoPathInput);
53
+ const normalizedRequest = requestedPath.trim().length > 0 ? requestedPath : ".";
54
+ if (path.isAbsolute(normalizedRequest)) {
55
+ throw new InputError("repo paths must be relative to repo_path.");
56
+ }
57
+ const absolutePath = path.resolve(repoPath, normalizedRequest);
58
+ const relativePath = toPosixPath(path.relative(repoPath, absolutePath));
59
+ assertPathInside(repoPath, absolutePath);
60
+ if (isIgnoredPath(relativePath)) {
61
+ throw new InputError(`repo path is not readable through the gateway: ${relativePath}`);
62
+ }
63
+ const repoRealPath = await fs.realpath(repoPath);
64
+ const absoluteRealPath = await fs.realpath(absolutePath);
65
+ assertPathInside(repoRealPath, absoluteRealPath);
66
+ return {
67
+ repoPath,
68
+ absolutePath,
69
+ relativePath: relativePath === "" ? "." : relativePath
70
+ };
71
+ };
72
+ const globToRegExp = (glob) => {
73
+ const normalized = toPosixPath(glob);
74
+ let pattern = "";
75
+ for (let index = 0; index < normalized.length; index += 1) {
76
+ const char = normalized[index] ?? "";
77
+ const next = normalized[index + 1];
78
+ const afterNext = normalized[index + 2];
79
+ if (char === "*" && next === "*") {
80
+ if (afterNext === "/") {
81
+ pattern += "(?:.*/)?";
82
+ index += 2;
83
+ }
84
+ else {
85
+ pattern += ".*";
86
+ index += 1;
87
+ }
88
+ continue;
89
+ }
90
+ if (char === "*") {
91
+ pattern += "[^/]*";
92
+ continue;
93
+ }
94
+ if (char === "?") {
95
+ pattern += "[^/]";
96
+ continue;
97
+ }
98
+ pattern += char.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
99
+ }
100
+ return new RegExp(`^${pattern}$`);
101
+ };
102
+ const matchesGlobs = (relativePath, globs) => {
103
+ if (globs.length === 0) {
104
+ return true;
105
+ }
106
+ return globs.some((glob) => globToRegExp(glob).test(relativePath));
107
+ };
108
+ const walkTree = async (repoPath, root, current, depth, maxDepth, entries, maxEntries) => {
109
+ if (depth > maxDepth) {
110
+ return 0;
111
+ }
112
+ const absoluteDir = path.join(repoPath, current);
113
+ const dirEntries = await fs.readdir(absoluteDir, { withFileTypes: true });
114
+ let omitted = 0;
115
+ for (const entry of dirEntries.sort((left, right) => left.name.localeCompare(right.name))) {
116
+ const relativePath = toPosixPath(path.join(current, entry.name));
117
+ if (isIgnoredPath(relativePath)) {
118
+ continue;
119
+ }
120
+ if (entries.length >= maxEntries) {
121
+ omitted += 1;
122
+ continue;
123
+ }
124
+ if (entry.isDirectory()) {
125
+ entries.push({
126
+ path: `${relativePath}/`,
127
+ type: "directory"
128
+ });
129
+ omitted += await walkTree(repoPath, root, relativePath, depth + 1, maxDepth, entries, maxEntries);
130
+ continue;
131
+ }
132
+ if (entry.isFile()) {
133
+ const stat = await fs.stat(path.join(repoPath, relativePath));
134
+ entries.push({
135
+ path: relativePath,
136
+ type: "file",
137
+ bytes: stat.size
138
+ });
139
+ }
140
+ }
141
+ return omitted;
142
+ };
143
+ const walkFiles = async (repoPath, current = ".") => {
144
+ const absoluteDir = current === "." ? repoPath : path.join(repoPath, current);
145
+ const entries = await fs.readdir(absoluteDir, { withFileTypes: true });
146
+ const files = [];
147
+ for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
148
+ const relativePath = toPosixPath(path.join(current, entry.name).replace(/^\.\//, ""));
149
+ if (isIgnoredPath(relativePath)) {
150
+ continue;
151
+ }
152
+ if (entry.isDirectory()) {
153
+ files.push(...await walkFiles(repoPath, relativePath));
154
+ continue;
155
+ }
156
+ if (entry.isFile()) {
157
+ files.push(relativePath);
158
+ }
159
+ }
160
+ return files;
161
+ };
162
+ const runGit = async (repoPath, args, maxBytes) => {
163
+ const command = "git";
164
+ const child = spawn(command, args, {
165
+ cwd: repoPath,
166
+ stdio: ["ignore", "pipe", "pipe"]
167
+ });
168
+ let stdout = Buffer.alloc(0);
169
+ let stderr = Buffer.alloc(0);
170
+ let truncated = false;
171
+ const appendBounded = (current, chunk) => {
172
+ const next = Buffer.concat([current, chunk]);
173
+ if (next.byteLength <= maxBytes) {
174
+ return next;
175
+ }
176
+ truncated = true;
177
+ return next.subarray(0, maxBytes);
178
+ };
179
+ child.stdout.on("data", (chunk) => {
180
+ stdout = appendBounded(stdout, chunk);
181
+ });
182
+ child.stderr.on("data", (chunk) => {
183
+ stderr = appendBounded(stderr, chunk);
184
+ });
185
+ const exitCode = await new Promise((resolve, reject) => {
186
+ child.on("error", (error) => {
187
+ reject(new InputError(`failed to run git: ${error.message}`));
188
+ });
189
+ child.on("close", (code) => resolve(code ?? 1));
190
+ });
191
+ return {
192
+ repoPath,
193
+ command,
194
+ args,
195
+ exitCode,
196
+ stdout: stdout.toString("utf8"),
197
+ stderr: stderr.toString("utf8"),
198
+ truncated
199
+ };
200
+ };
201
+ export const listRepoTree = async (input) => {
202
+ const maxDepth = clampPositiveInteger(input.maxDepth, defaultMaxDepth, 20);
203
+ const maxEntries = clampPositiveInteger(input.maxEntries, defaultMaxEntries, 1_000);
204
+ const resolved = await resolveSafeRepoPath(input.repoPath, input.path);
205
+ const stat = await fs.stat(resolved.absolutePath);
206
+ if (!stat.isDirectory()) {
207
+ throw new InputError("repo tree path must be a directory.");
208
+ }
209
+ const entries = [];
210
+ const root = resolved.relativePath;
211
+ const omittedEntryCount = await walkTree(resolved.repoPath, root, root === "." ? "." : root, 1, maxDepth, entries, maxEntries);
212
+ return {
213
+ repoPath: resolved.repoPath,
214
+ root,
215
+ entries,
216
+ omittedEntryCount
217
+ };
218
+ };
219
+ export const readRepoFile = async (input) => {
220
+ const maxBytes = clampPositiveInteger(input.maxBytes, defaultMaxReadBytes, 200_000);
221
+ const offset = input.offset ?? 0;
222
+ if (!Number.isSafeInteger(offset) || offset < 0) {
223
+ throw new InputError("offset must be a non-negative integer.");
224
+ }
225
+ const resolved = await resolveSafeRepoPath(input.repoPath, input.path);
226
+ const stat = await fs.stat(resolved.absolutePath);
227
+ if (!stat.isFile()) {
228
+ throw new InputError("repo read path must be a file.");
229
+ }
230
+ const buffer = await fs.readFile(resolved.absolutePath);
231
+ if (!isTextLike(buffer)) {
232
+ throw new InputError("repo read path is not a text file.");
233
+ }
234
+ const sliced = buffer.subarray(offset, offset + maxBytes);
235
+ return {
236
+ repoPath: resolved.repoPath,
237
+ path: resolved.relativePath,
238
+ offset,
239
+ byteLength: buffer.byteLength,
240
+ truncated: offset + sliced.byteLength < buffer.byteLength,
241
+ content: sliced.toString("utf8")
242
+ };
243
+ };
244
+ export const searchRepo = async (input) => {
245
+ const repoPath = resolveRepoPath(input.repoPath);
246
+ const query = input.caseSensitive === false ? input.query.toLowerCase() : input.query;
247
+ const maxResults = clampPositiveInteger(input.maxResults, 50, 500);
248
+ const globs = input.globs ?? [];
249
+ const matches = [];
250
+ let omittedMatchCount = 0;
251
+ if (input.query.trim().length === 0) {
252
+ throw new InputError("query must be a non-empty string.");
253
+ }
254
+ for (const relativePath of await walkFiles(repoPath)) {
255
+ if (!matchesGlobs(relativePath, globs)) {
256
+ continue;
257
+ }
258
+ const absolutePath = path.join(repoPath, relativePath);
259
+ const stat = await fs.stat(absolutePath);
260
+ if (stat.size > maxSearchFileBytes) {
261
+ continue;
262
+ }
263
+ const buffer = await fs.readFile(absolutePath);
264
+ if (!isTextLike(buffer)) {
265
+ continue;
266
+ }
267
+ const lines = buffer.toString("utf8").split("\n");
268
+ for (const [index, line] of lines.entries()) {
269
+ const haystack = input.caseSensitive === false ? line.toLowerCase() : line;
270
+ if (!haystack.includes(query)) {
271
+ continue;
272
+ }
273
+ if (matches.length >= maxResults) {
274
+ omittedMatchCount += 1;
275
+ continue;
276
+ }
277
+ matches.push({
278
+ path: relativePath,
279
+ line: index + 1,
280
+ text: line
281
+ });
282
+ }
283
+ }
284
+ return {
285
+ repoPath,
286
+ query: input.query,
287
+ matches,
288
+ omittedMatchCount
289
+ };
290
+ };
291
+ export const getRepoGitStatus = async (repoPathInput) => {
292
+ const repoPath = resolveRepoPath(repoPathInput);
293
+ return runGit(repoPath, ["status", "--short", "--untracked-files=all", "--", ".", ":(exclude).thehood"], defaultMaxReadBytes);
294
+ };
295
+ export const getRepoGitDiff = async (input) => {
296
+ const repoPath = resolveRepoPath(input.repoPath);
297
+ const maxBytes = clampPositiveInteger(input.maxBytes, defaultMaxReadBytes, 200_000);
298
+ const args = ["diff", "--no-ext-diff", "--"];
299
+ if (input.path) {
300
+ const resolved = await resolveSafeRepoPath(repoPath, input.path);
301
+ args.push(resolved.relativePath);
302
+ }
303
+ else {
304
+ args.push(".", ":(exclude).thehood");
305
+ }
306
+ return runGit(repoPath, args, maxBytes);
307
+ };
308
+ //# sourceMappingURL=repoGateway.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"repoGateway.js","sourceRoot":"","sources":["../../src/runtime/repoGateway.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { AgentDirective, AgentResponse } from "../providers/types.js";
2
+ import type { RuntimeRole } from "./types.js";
3
+ export declare const validateAgentResponse: (role: RuntimeRole, directive: AgentDirective, response: AgentResponse) => void;
@@ -0,0 +1,86 @@
1
+ import { SchemaValidationError } from "./errors.js";
2
+ const responseStatuses = new Set(["ok", "blocked", "failed"]);
3
+ const orchestratorActions = new Set([
4
+ "delegate",
5
+ "verify",
6
+ "critique",
7
+ "request_approval",
8
+ "revise_plan",
9
+ "complete",
10
+ "abort"
11
+ ]);
12
+ const implementationStatuses = new Set(["changed", "no_change", "blocked", "failed"]);
13
+ const qaVerdicts = new Set(["pass", "needs_revision", "needs_more_evidence", "blocked"]);
14
+ const verificationVerdicts = new Set(["approve", "revise", "abort", "ask_user"]);
15
+ const critiqueVerdicts = new Set(["acceptable", "needs_revision", "unsafe", "unclear"]);
16
+ const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
17
+ const requireStringField = (value, field, contract) => {
18
+ const candidate = value[field];
19
+ if (typeof candidate !== "string" || candidate.trim().length === 0) {
20
+ throw new SchemaValidationError(`${contract}.${field} must be a non-empty string.`);
21
+ }
22
+ return candidate;
23
+ };
24
+ const requireAllowedValue = (value, field, allowed, contract) => {
25
+ const candidate = requireStringField(value, field, contract);
26
+ if (!allowed.has(candidate)) {
27
+ throw new SchemaValidationError(`${contract}.${field} has unsupported value "${candidate}".`);
28
+ }
29
+ };
30
+ const validateRolePayload = (role, payload, contractName) => {
31
+ switch (role) {
32
+ case "orchestrator":
33
+ case "planner":
34
+ requireAllowedValue(payload, "action", orchestratorActions, contractName);
35
+ requireStringField(payload, "reason", contractName);
36
+ return;
37
+ case "implementer":
38
+ requireAllowedValue(payload, "status", implementationStatuses, contractName);
39
+ return;
40
+ case "qa":
41
+ requireAllowedValue(payload, "verdict", qaVerdicts, contractName);
42
+ requireStringField(payload, "summary", contractName);
43
+ return;
44
+ case "verifier":
45
+ requireAllowedValue(payload, "verdict", verificationVerdicts, contractName);
46
+ requireStringField(payload, "summary", contractName);
47
+ return;
48
+ case "critic":
49
+ requireAllowedValue(payload, "verdict", critiqueVerdicts, contractName);
50
+ return;
51
+ default:
52
+ return;
53
+ }
54
+ };
55
+ const validateDirectiveAck = (directive, payload, contractName) => {
56
+ const { responseField, runId, nonce } = directive.directiveAck;
57
+ const ack = payload[responseField];
58
+ if (ack === undefined) {
59
+ return;
60
+ }
61
+ if (!isObject(ack)) {
62
+ throw new SchemaValidationError(`${contractName}.${responseField} must be an object when present.`);
63
+ }
64
+ if (ack.runId !== runId || ack.nonce !== nonce) {
65
+ throw new SchemaValidationError(`${contractName}.${responseField} does not match the current directive.`);
66
+ }
67
+ };
68
+ export const validateAgentResponse = (role, directive, response) => {
69
+ if (!responseStatuses.has(response.status)) {
70
+ throw new SchemaValidationError(`Agent response status "${response.status}" is not supported.`);
71
+ }
72
+ if (typeof response.summary !== "string" || response.summary.trim().length === 0) {
73
+ throw new SchemaValidationError("Agent response summary must be a non-empty string.");
74
+ }
75
+ if (!isObject(response.data)) {
76
+ throw new SchemaValidationError("Agent response data must be an object.");
77
+ }
78
+ const { requiredDataKey, name } = directive.outputContract;
79
+ const payload = response.data[requiredDataKey];
80
+ if (!isObject(payload)) {
81
+ throw new SchemaValidationError(`${name} response must include object data.${requiredDataKey}.`);
82
+ }
83
+ validateRolePayload(role, payload, name);
84
+ validateDirectiveAck(directive, payload, name);
85
+ };
86
+ //# sourceMappingURL=responseContracts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"responseContracts.js","sourceRoot":"","sources":["../../src/runtime/responseContracts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { ReviewLane, RunRecord } from "./types.js";
2
+ export declare const deriveReviewLanes: (run: RunRecord) => ReviewLane[];