anvil-engineering-workbench 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/LICENSE +17 -0
  3. package/README.md +778 -3
  4. package/SECURITY.md +17 -0
  5. package/dist/ai/claude-code-provider.d.ts +31 -0
  6. package/dist/ai/claude-code-provider.js +81 -0
  7. package/dist/ai/claude-code-provider.js.map +1 -0
  8. package/dist/ai/provider.d.ts +47 -0
  9. package/dist/ai/provider.js +57 -0
  10. package/dist/ai/provider.js.map +1 -0
  11. package/dist/cli.d.ts +2 -0
  12. package/dist/cli.js +1945 -0
  13. package/dist/cli.js.map +1 -0
  14. package/dist/core/agent-config-release.d.ts +22 -0
  15. package/dist/core/agent-config-release.js +109 -0
  16. package/dist/core/agent-config-release.js.map +1 -0
  17. package/dist/core/agent-config-versioning.d.ts +33 -0
  18. package/dist/core/agent-config-versioning.js +209 -0
  19. package/dist/core/agent-config-versioning.js.map +1 -0
  20. package/dist/core/agent-evaluation-intelligence.d.ts +46 -0
  21. package/dist/core/agent-evaluation-intelligence.js +191 -0
  22. package/dist/core/agent-evaluation-intelligence.js.map +1 -0
  23. package/dist/core/agent-evolution.d.ts +20 -0
  24. package/dist/core/agent-evolution.js +35 -0
  25. package/dist/core/agent-evolution.js.map +1 -0
  26. package/dist/core/agent-experiment-studio.d.ts +27 -0
  27. package/dist/core/agent-experiment-studio.js +65 -0
  28. package/dist/core/agent-experiment-studio.js.map +1 -0
  29. package/dist/core/agent-optimization.d.ts +27 -0
  30. package/dist/core/agent-optimization.js +63 -0
  31. package/dist/core/agent-optimization.js.map +1 -0
  32. package/dist/core/agent-registry.d.ts +9 -0
  33. package/dist/core/agent-registry.js +95 -0
  34. package/dist/core/agent-registry.js.map +1 -0
  35. package/dist/core/agent-security-audit.d.ts +28 -0
  36. package/dist/core/agent-security-audit.js +260 -0
  37. package/dist/core/agent-security-audit.js.map +1 -0
  38. package/dist/core/agent-workspace-context.d.ts +14 -0
  39. package/dist/core/agent-workspace-context.js +66 -0
  40. package/dist/core/agent-workspace-context.js.map +1 -0
  41. package/dist/core/ai-code-review.d.ts +20 -0
  42. package/dist/core/ai-code-review.js +70 -0
  43. package/dist/core/ai-code-review.js.map +1 -0
  44. package/dist/core/anthropic-provider.d.ts +16 -0
  45. package/dist/core/anthropic-provider.js +85 -0
  46. package/dist/core/anthropic-provider.js.map +1 -0
  47. package/dist/core/architecture-map.d.ts +26 -0
  48. package/dist/core/architecture-map.js +124 -0
  49. package/dist/core/architecture-map.js.map +1 -0
  50. package/dist/core/benchmark-engine.d.ts +52 -0
  51. package/dist/core/benchmark-engine.js +109 -0
  52. package/dist/core/benchmark-engine.js.map +1 -0
  53. package/dist/core/benchmark-matrix.d.ts +123 -0
  54. package/dist/core/benchmark-matrix.js +169 -0
  55. package/dist/core/benchmark-matrix.js.map +1 -0
  56. package/dist/core/benchmark-regression.d.ts +54 -0
  57. package/dist/core/benchmark-regression.js +96 -0
  58. package/dist/core/benchmark-regression.js.map +1 -0
  59. package/dist/core/change-intelligence.d.ts +40 -0
  60. package/dist/core/change-intelligence.js +114 -0
  61. package/dist/core/change-intelligence.js.map +1 -0
  62. package/dist/core/code-intelligence.d.ts +20 -0
  63. package/dist/core/code-intelligence.js +119 -0
  64. package/dist/core/code-intelligence.js.map +1 -0
  65. package/dist/core/code-review.d.ts +30 -0
  66. package/dist/core/code-review.js +93 -0
  67. package/dist/core/code-review.js.map +1 -0
  68. package/dist/core/code-search.d.ts +16 -0
  69. package/dist/core/code-search.js +93 -0
  70. package/dist/core/code-search.js.map +1 -0
  71. package/dist/core/container-sandbox.d.ts +20 -0
  72. package/dist/core/container-sandbox.js +220 -0
  73. package/dist/core/container-sandbox.js.map +1 -0
  74. package/dist/core/dashboard-server.d.ts +11 -0
  75. package/dist/core/dashboard-server.js +1068 -0
  76. package/dist/core/dashboard-server.js.map +1 -0
  77. package/dist/core/dependency-graph.d.ts +29 -0
  78. package/dist/core/dependency-graph.js +90 -0
  79. package/dist/core/dependency-graph.js.map +1 -0
  80. package/dist/core/dependency-impact.d.ts +51 -0
  81. package/dist/core/dependency-impact.js +201 -0
  82. package/dist/core/dependency-impact.js.map +1 -0
  83. package/dist/core/dependency-intelligence.d.ts +60 -0
  84. package/dist/core/dependency-intelligence.js +241 -0
  85. package/dist/core/dependency-intelligence.js.map +1 -0
  86. package/dist/core/doctor.d.ts +17 -0
  87. package/dist/core/doctor.js +239 -0
  88. package/dist/core/doctor.js.map +1 -0
  89. package/dist/core/engineering-risk.d.ts +40 -0
  90. package/dist/core/engineering-risk.js +125 -0
  91. package/dist/core/engineering-risk.js.map +1 -0
  92. package/dist/core/evaluation-engine.d.ts +110 -0
  93. package/dist/core/evaluation-engine.js +182 -0
  94. package/dist/core/evaluation-engine.js.map +1 -0
  95. package/dist/core/execution-trace.d.ts +27 -0
  96. package/dist/core/execution-trace.js +137 -0
  97. package/dist/core/execution-trace.js.map +1 -0
  98. package/dist/core/experiment-history.d.ts +31 -0
  99. package/dist/core/experiment-history.js +64 -0
  100. package/dist/core/experiment-history.js.map +1 -0
  101. package/dist/core/experiment-manifest.d.ts +67 -0
  102. package/dist/core/experiment-manifest.js +100 -0
  103. package/dist/core/experiment-manifest.js.map +1 -0
  104. package/dist/core/gemini-provider.d.ts +15 -0
  105. package/dist/core/gemini-provider.js +87 -0
  106. package/dist/core/gemini-provider.js.map +1 -0
  107. package/dist/core/git-intelligence.d.ts +26 -0
  108. package/dist/core/git-intelligence.js +84 -0
  109. package/dist/core/git-intelligence.js.map +1 -0
  110. package/dist/core/hook-engine.d.ts +23 -0
  111. package/dist/core/hook-engine.js +74 -0
  112. package/dist/core/hook-engine.js.map +1 -0
  113. package/dist/core/hosted-agent-provider.d.ts +19 -0
  114. package/dist/core/hosted-agent-provider.js +133 -0
  115. package/dist/core/hosted-agent-provider.js.map +1 -0
  116. package/dist/core/intelligence-timeline.d.ts +41 -0
  117. package/dist/core/intelligence-timeline.js +158 -0
  118. package/dist/core/intelligence-timeline.js.map +1 -0
  119. package/dist/core/model-router.d.ts +59 -0
  120. package/dist/core/model-router.js +291 -0
  121. package/dist/core/model-router.js.map +1 -0
  122. package/dist/core/openai-compatible-provider.d.ts +19 -0
  123. package/dist/core/openai-compatible-provider.js +151 -0
  124. package/dist/core/openai-compatible-provider.js.map +1 -0
  125. package/dist/core/orchestrator.d.ts +94 -0
  126. package/dist/core/orchestrator.js +263 -0
  127. package/dist/core/orchestrator.js.map +1 -0
  128. package/dist/core/patch-application.d.ts +54 -0
  129. package/dist/core/patch-application.js +504 -0
  130. package/dist/core/patch-application.js.map +1 -0
  131. package/dist/core/patch-approval.d.ts +23 -0
  132. package/dist/core/patch-approval.js +181 -0
  133. package/dist/core/patch-approval.js.map +1 -0
  134. package/dist/core/patch-validation.d.ts +12 -0
  135. package/dist/core/patch-validation.js +112 -0
  136. package/dist/core/patch-validation.js.map +1 -0
  137. package/dist/core/permission-policy.d.ts +13 -0
  138. package/dist/core/permission-policy.js +98 -0
  139. package/dist/core/permission-policy.js.map +1 -0
  140. package/dist/core/project-health.d.ts +72 -0
  141. package/dist/core/project-health.js +79 -0
  142. package/dist/core/project-health.js.map +1 -0
  143. package/dist/core/project-init.d.ts +9 -0
  144. package/dist/core/project-init.js +253 -0
  145. package/dist/core/project-init.js.map +1 -0
  146. package/dist/core/project-inspector.d.ts +24 -0
  147. package/dist/core/project-inspector.js +175 -0
  148. package/dist/core/project-inspector.js.map +1 -0
  149. package/dist/core/project-memory.d.ts +22 -0
  150. package/dist/core/project-memory.js +173 -0
  151. package/dist/core/project-memory.js.map +1 -0
  152. package/dist/core/provider-diagnostics.d.ts +12 -0
  153. package/dist/core/provider-diagnostics.js +73 -0
  154. package/dist/core/provider-diagnostics.js.map +1 -0
  155. package/dist/core/provider-response.d.ts +4 -0
  156. package/dist/core/provider-response.js +46 -0
  157. package/dist/core/provider-response.js.map +1 -0
  158. package/dist/core/quality-audit.d.ts +29 -0
  159. package/dist/core/quality-audit.js +101 -0
  160. package/dist/core/quality-audit.js.map +1 -0
  161. package/dist/core/regression-intelligence.d.ts +41 -0
  162. package/dist/core/regression-intelligence.js +56 -0
  163. package/dist/core/regression-intelligence.js.map +1 -0
  164. package/dist/core/remediation-planner.d.ts +43 -0
  165. package/dist/core/remediation-planner.js +124 -0
  166. package/dist/core/remediation-planner.js.map +1 -0
  167. package/dist/core/review-history.d.ts +18 -0
  168. package/dist/core/review-history.js +68 -0
  169. package/dist/core/review-history.js.map +1 -0
  170. package/dist/core/review-planner.d.ts +2 -0
  171. package/dist/core/review-planner.js +79 -0
  172. package/dist/core/review-planner.js.map +1 -0
  173. package/dist/core/run-history-output.d.ts +22 -0
  174. package/dist/core/run-history-output.js +51 -0
  175. package/dist/core/run-history-output.js.map +1 -0
  176. package/dist/core/run-replay.d.ts +9 -0
  177. package/dist/core/run-replay.js +64 -0
  178. package/dist/core/run-replay.js.map +1 -0
  179. package/dist/core/run-store.d.ts +13 -0
  180. package/dist/core/run-store.js +300 -0
  181. package/dist/core/run-store.js.map +1 -0
  182. package/dist/core/sandbox-cleanup-audit.d.ts +14 -0
  183. package/dist/core/sandbox-cleanup-audit.js +57 -0
  184. package/dist/core/sandbox-cleanup-audit.js.map +1 -0
  185. package/dist/core/sandbox-compliance.d.ts +19 -0
  186. package/dist/core/sandbox-compliance.js +34 -0
  187. package/dist/core/sandbox-compliance.js.map +1 -0
  188. package/dist/core/sandbox-lifecycle.d.ts +8 -0
  189. package/dist/core/sandbox-lifecycle.js +36 -0
  190. package/dist/core/sandbox-lifecycle.js.map +1 -0
  191. package/dist/core/sandbox-policy.d.ts +31 -0
  192. package/dist/core/sandbox-policy.js +80 -0
  193. package/dist/core/sandbox-policy.js.map +1 -0
  194. package/dist/core/sandbox-runtime.d.ts +10 -0
  195. package/dist/core/sandbox-runtime.js +44 -0
  196. package/dist/core/sandbox-runtime.js.map +1 -0
  197. package/dist/core/sandbox-security-profiles.d.ts +16 -0
  198. package/dist/core/sandbox-security-profiles.js +43 -0
  199. package/dist/core/sandbox-security-profiles.js.map +1 -0
  200. package/dist/core/skill-registry.d.ts +14 -0
  201. package/dist/core/skill-registry.js +186 -0
  202. package/dist/core/skill-registry.js.map +1 -0
  203. package/dist/core/staged-verification.d.ts +27 -0
  204. package/dist/core/staged-verification.js +108 -0
  205. package/dist/core/staged-verification.js.map +1 -0
  206. package/dist/core/verification-history.d.ts +10 -0
  207. package/dist/core/verification-history.js +71 -0
  208. package/dist/core/verification-history.js.map +1 -0
  209. package/dist/core/verification.d.ts +37 -0
  210. package/dist/core/verification.js +204 -0
  211. package/dist/core/verification.js.map +1 -0
  212. package/dist/core/workflow-store.d.ts +16 -0
  213. package/dist/core/workflow-store.js +113 -0
  214. package/dist/core/workflow-store.js.map +1 -0
  215. package/dist/core/workspace-browser.d.ts +22 -0
  216. package/dist/core/workspace-browser.js +115 -0
  217. package/dist/core/workspace-browser.js.map +1 -0
  218. package/dist/core/workspace-scan-policy.d.ts +2 -0
  219. package/dist/core/workspace-scan-policy.js +11 -0
  220. package/dist/core/workspace-scan-policy.js.map +1 -0
  221. package/dist/core/workspace-tool-broker.d.ts +28 -0
  222. package/dist/core/workspace-tool-broker.js +70 -0
  223. package/dist/core/workspace-tool-broker.js.map +1 -0
  224. package/dist/index.d.ts +75 -0
  225. package/dist/index.js +82 -0
  226. package/dist/index.js.map +1 -0
  227. package/dist/mcp/server.d.ts +2 -0
  228. package/dist/mcp/server.js +342 -0
  229. package/dist/mcp/server.js.map +1 -0
  230. package/dist/mcp/workspace-path.d.ts +2 -0
  231. package/dist/mcp/workspace-path.js +41 -0
  232. package/dist/mcp/workspace-path.js.map +1 -0
  233. package/package.json +67 -5
@@ -0,0 +1,300 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, mkdir, open, readFile, readdir, realpath, rename, rm, writeFile } from "node:fs/promises";
3
+ import { randomUUID } from "node:crypto";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+ const RUN_ID_PATTERN = /^forge-[a-z0-9-]{1,80}$/;
7
+ const MAX_RUN_FILE_BYTES = 5 * 1024 * 1024;
8
+ function validateRunId(id) {
9
+ if (!RUN_ID_PATTERN.test(id) || id.includes("..")) {
10
+ throw new Error("Invalid FORGE run identifier.");
11
+ }
12
+ }
13
+ async function safeRunsDirectory(projectPath) {
14
+ const project = await realpath(path.resolve(projectPath));
15
+ let current = project;
16
+ for (const part of [".forge", "runs"]) {
17
+ current = path.join(current, part);
18
+ try {
19
+ await mkdir(current, { mode: 0o700 });
20
+ }
21
+ catch (error) {
22
+ if (!error || typeof error !== "object" || !("code" in error) || error.code !== "EEXIST")
23
+ throw error;
24
+ }
25
+ const info = await lstat(current);
26
+ if (info.isSymbolicLink() || !info.isDirectory()) {
27
+ throw new Error("Run history storage must not contain symbolic links or non-directory components.");
28
+ }
29
+ }
30
+ return current;
31
+ }
32
+ async function writeRunUnlocked(projectPath, run) {
33
+ validateRunId(run.id);
34
+ const directory = await safeRunsDirectory(projectPath);
35
+ const destination = path.join(directory, `${run.id}.json`);
36
+ const temporary = path.join(directory, `.${run.id}.${randomUUID()}.tmp`);
37
+ const serialized = JSON.stringify(run, null, 2) + "\n";
38
+ if (Buffer.byteLength(serialized, "utf8") > MAX_RUN_FILE_BYTES) {
39
+ throw new Error("Run history record exceeds the maximum file size.");
40
+ }
41
+ try {
42
+ await writeFile(temporary, serialized, { encoding: "utf8", flag: "wx", mode: 0o600 });
43
+ await rename(temporary, destination);
44
+ }
45
+ catch (error) {
46
+ await rm(temporary, { force: true }).catch(() => undefined);
47
+ throw error;
48
+ }
49
+ return destination;
50
+ }
51
+ async function withRunLock(projectPath, runId, action, lockSuffix = ".lock") {
52
+ validateRunId(runId);
53
+ const directory = await safeRunsDirectory(projectPath);
54
+ const lock = path.join(directory, `${runId}${lockSuffix}`);
55
+ const ownerFile = path.join(lock, "owner.json");
56
+ const token = randomUUID();
57
+ try {
58
+ await mkdir(lock, { mode: 0o700 });
59
+ }
60
+ catch (error) {
61
+ if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
62
+ throw new Error(`Run ${runId} is locked by another or interrupted FORGE process. Inspect ${lock}/owner.json; do not remove the lock until you have confirmed its owner is no longer active.`);
63
+ }
64
+ throw error;
65
+ }
66
+ try {
67
+ await writeFile(ownerFile, JSON.stringify({
68
+ token,
69
+ pid: process.pid,
70
+ host: os.hostname(),
71
+ startedAt: new Date().toISOString(),
72
+ }) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
73
+ return await action();
74
+ }
75
+ finally {
76
+ try {
77
+ const owner = JSON.parse(await readFile(ownerFile, "utf8"));
78
+ if (owner && typeof owner === "object" && "token" in owner && owner.token === token) {
79
+ await rm(lock, { recursive: true, force: true });
80
+ }
81
+ }
82
+ catch {
83
+ // If ownership cannot be verified, leave the lock in place rather than
84
+ // risk deleting a lock that may have been replaced by another process.
85
+ }
86
+ }
87
+ }
88
+ /** Holds an exclusive execution lease across a complete resume operation. */
89
+ export async function withRunExecutionLock(projectPath, runId, action) {
90
+ return withRunLock(projectPath, runId, action, ".execution.lock");
91
+ }
92
+ export async function saveRun(projectPath, run) {
93
+ return withRunLock(projectPath, run.id, () => writeRunUnlocked(projectPath, run));
94
+ }
95
+ export async function loadRun(projectPath, runId) {
96
+ validateRunId(runId);
97
+ const filePath = path.join(await safeRunsDirectory(projectPath), `${runId}.json`);
98
+ const linkInfo = await lstat(filePath);
99
+ if (linkInfo.isSymbolicLink() || !linkInfo.isFile()) {
100
+ throw new Error("Stored run file must be a regular file and not a symbolic link.");
101
+ }
102
+ const handle = await open(filePath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
103
+ let serialized;
104
+ try {
105
+ const info = await handle.stat();
106
+ if (!info.isFile() || info.size > MAX_RUN_FILE_BYTES) {
107
+ throw new Error("Stored run file is not a regular file or exceeds the size limit.");
108
+ }
109
+ const chunks = [];
110
+ let totalBytes = 0;
111
+ while (totalBytes <= MAX_RUN_FILE_BYTES) {
112
+ const chunk = Buffer.alloc(Math.min(64 * 1024, MAX_RUN_FILE_BYTES + 1 - totalBytes));
113
+ const { bytesRead } = await handle.read(chunk, 0, chunk.length, null);
114
+ if (bytesRead === 0)
115
+ break;
116
+ chunks.push(chunk.subarray(0, bytesRead));
117
+ totalBytes += bytesRead;
118
+ }
119
+ if (totalBytes > MAX_RUN_FILE_BYTES) {
120
+ throw new Error("Stored run file exceeds the size limit.");
121
+ }
122
+ serialized = Buffer.concat(chunks).toString("utf8");
123
+ }
124
+ finally {
125
+ await handle.close();
126
+ }
127
+ const parsed = JSON.parse(serialized);
128
+ const isObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
129
+ const isTimestamp = (value) => typeof value === "string" && Number.isFinite(Date.parse(value));
130
+ const runStatuses = ["pending", "awaiting_approval", "running", "completed", "failed", "cancelled"];
131
+ const taskStatuses = ["pending", "awaiting_approval", "running", "completed", "failed", "blocked"];
132
+ const eventTypes = ["approval_required", "approved", "rejected", "started", "completed", "failed", "blocked", "budget_exceeded"];
133
+ if (!isObject(parsed) ||
134
+ parsed.id !== runId ||
135
+ typeof parsed.goal !== "string" || !parsed.goal.trim() ||
136
+ !runStatuses.includes(String(parsed.status)) ||
137
+ !isTimestamp(parsed.createdAt) || !isTimestamp(parsed.updatedAt) ||
138
+ !Array.isArray(parsed.tasks) || parsed.tasks.length > 1000 ||
139
+ !Array.isArray(parsed.events) || parsed.events.length > 10000) {
140
+ throw new Error("Stored run file has an invalid format.");
141
+ }
142
+ if ("tokenUsage" in parsed) {
143
+ const usage = parsed.tokenUsage;
144
+ if (!isObject(usage) ||
145
+ !Number.isSafeInteger(usage.estimatedTokensUsed) || usage.estimatedTokensUsed < 0 ||
146
+ !isObject(usage.estimatedTokensByAgent) ||
147
+ Object.entries(usage.estimatedTokensByAgent).some(([agent, value]) => !agent.trim() || !Number.isSafeInteger(value) || value < 0)) {
148
+ throw new Error("Stored run file contains invalid token usage.");
149
+ }
150
+ }
151
+ const taskIds = new Set();
152
+ for (const record of parsed.tasks) {
153
+ if (!isObject(record) || !isObject(record.task) ||
154
+ typeof record.task.id !== "string" || !record.task.id.trim() ||
155
+ typeof record.task.agent !== "string" || !record.task.agent.trim() ||
156
+ typeof record.task.title !== "string" || !record.task.title.trim() ||
157
+ typeof record.task.prompt !== "string" || !record.task.prompt.trim() ||
158
+ !taskStatuses.includes(String(record.status))) {
159
+ throw new Error("Stored run file contains an invalid task record.");
160
+ }
161
+ if (taskIds.has(record.task.id))
162
+ throw new Error("Stored run file contains duplicate task identifiers.");
163
+ taskIds.add(record.task.id);
164
+ if ("dependsOn" in record.task &&
165
+ (!Array.isArray(record.task.dependsOn) ||
166
+ record.task.dependsOn.some((id) => typeof id !== "string" || !id.trim()) ||
167
+ new Set(record.task.dependsOn).size !== record.task.dependsOn.length)) {
168
+ throw new Error("Stored run file contains invalid task dependencies.");
169
+ }
170
+ if ("requiresApproval" in record.task && typeof record.task.requiresApproval !== "boolean") {
171
+ throw new Error("Stored run file contains invalid approval requirements.");
172
+ }
173
+ if ("result" in record &&
174
+ (!isObject(record.result) || typeof record.result.content !== "string" ||
175
+ typeof record.result.provider !== "string" || !record.result.provider.trim() ||
176
+ ("model" in record.result && typeof record.result.model !== "string"))) {
177
+ throw new Error("Stored run file contains an invalid task result.");
178
+ }
179
+ if ("error" in record && typeof record.error !== "string") {
180
+ throw new Error("Stored run file contains an invalid task error.");
181
+ }
182
+ if ("approval" in record) {
183
+ const approval = record.approval;
184
+ if (!isObject(approval) || !["approved", "rejected"].includes(String(approval.decision)) ||
185
+ typeof approval.reviewer !== "string" || !approval.reviewer.trim() ||
186
+ !isTimestamp(approval.at) ||
187
+ ("reason" in approval && typeof approval.reason !== "string")) {
188
+ throw new Error("Stored run file contains an invalid approval record.");
189
+ }
190
+ }
191
+ }
192
+ for (const record of parsed.tasks) {
193
+ const dependencies = record.task.dependsOn;
194
+ if (dependencies?.some(id => !taskIds.has(id) || id === record.task.id)) {
195
+ throw new Error("Stored run file contains an unknown or self-referencing task dependency.");
196
+ }
197
+ }
198
+ for (const event of parsed.events) {
199
+ if (!isObject(event) || !isTimestamp(event.at) ||
200
+ typeof event.taskId !== "string" ||
201
+ !eventTypes.includes(String(event.type)) ||
202
+ typeof event.message !== "string") {
203
+ throw new Error("Stored run file contains an invalid event record.");
204
+ }
205
+ if (event.taskId && event.taskId !== "*" && !taskIds.has(event.taskId)) {
206
+ throw new Error("Stored run file contains an event for an unknown task.");
207
+ }
208
+ }
209
+ return parsed;
210
+ }
211
+ export async function listRuns(projectPath) {
212
+ const directory = await safeRunsDirectory(projectPath);
213
+ let entries;
214
+ try {
215
+ entries = await readdir(directory, { withFileTypes: true });
216
+ }
217
+ catch (error) {
218
+ if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
219
+ return [];
220
+ throw error;
221
+ }
222
+ const runs = [];
223
+ for (const entry of entries) {
224
+ if (!entry.isFile() || !entry.name.endsWith(".json"))
225
+ continue;
226
+ const id = entry.name.slice(0, -5);
227
+ if (!RUN_ID_PATTERN.test(id) || id.includes(".."))
228
+ continue;
229
+ try {
230
+ runs.push(await loadRun(projectPath, id));
231
+ }
232
+ catch {
233
+ // Ignore malformed records; callers can inspect the .forge/runs directory.
234
+ }
235
+ }
236
+ return runs.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
237
+ }
238
+ export async function decideTaskApproval(projectPath, runId, taskId, decision, reviewer, reason) {
239
+ return withRunExecutionLock(projectPath, runId, () => withRunLock(projectPath, runId, async () => {
240
+ const run = await loadRun(projectPath, runId);
241
+ const record = run.tasks.find(item => item.task.id === taskId);
242
+ if (!record)
243
+ throw new Error("Task not found in this run.");
244
+ if (record.approval)
245
+ throw new Error("This task already has an approval decision.");
246
+ if (record.status !== "awaiting_approval")
247
+ throw new Error("Only tasks awaiting approval can receive a decision.");
248
+ const at = new Date().toISOString();
249
+ const safeReviewer = reviewer.trim().slice(0, 80) || "local-user";
250
+ const safeReason = reason?.trim().slice(0, 1000);
251
+ record.approval = { decision, reviewer: safeReviewer, ...(safeReason ? { reason: safeReason } : {}), at };
252
+ if (decision === "approved") {
253
+ record.status = "pending";
254
+ run.status = "pending";
255
+ }
256
+ else {
257
+ record.status = "failed";
258
+ record.error = safeReason || "Task rejected during human review.";
259
+ run.status = "failed";
260
+ }
261
+ run.updatedAt = at;
262
+ run.events.push({
263
+ at, taskId, type: decision,
264
+ message: decision === "approved"
265
+ ? `Approved by ${safeReviewer}. Task is ready for an explicit subsequent run.`
266
+ : `Rejected by ${safeReviewer}.${safeReason ? ` Reason: ${safeReason}` : ""}`,
267
+ });
268
+ await writeRunUnlocked(projectPath, run);
269
+ return run;
270
+ }));
271
+ }
272
+ /**
273
+ * Marks work interrupted by a process restart as failed and ambiguous.
274
+ * Provider calls are never replayed automatically: a remote provider may have
275
+ * completed the request before the local process stopped persisting its result.
276
+ */
277
+ export async function recoverInterruptedRun(projectPath, runId) {
278
+ return withRunLock(projectPath, runId, async () => {
279
+ const run = await loadRun(projectPath, runId);
280
+ const interrupted = run.tasks.filter(record => record.status === "running");
281
+ if (interrupted.length === 0)
282
+ return run;
283
+ const at = new Date().toISOString();
284
+ for (const record of interrupted) {
285
+ record.status = "failed";
286
+ record.error = "Execution was interrupted. Provider outcome is unknown; FORGE did not automatically retry this task.";
287
+ run.events.push({
288
+ at,
289
+ taskId: record.task.id,
290
+ type: "failed",
291
+ message: "Process interruption detected. Provider outcome may be unknown; explicit review is required before any retry.",
292
+ });
293
+ }
294
+ run.status = "failed";
295
+ run.updatedAt = at;
296
+ await writeRunUnlocked(projectPath, run);
297
+ return run;
298
+ });
299
+ }
300
+ //# sourceMappingURL=run-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/core/run-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export interface SandboxCleanupAuditEntry {
2
+ id: string;
3
+ timestamp: string;
4
+ mode: "dry-run" | "apply";
5
+ candidates: Array<{
6
+ id: string;
7
+ name: string;
8
+ status: string;
9
+ }>;
10
+ removed: string[];
11
+ }
12
+ export declare function appendSandboxCleanupAudit(projectRoot: string, entry: SandboxCleanupAuditEntry): Promise<void>;
13
+ export declare function readSandboxCleanupAudit(projectRoot: string): Promise<SandboxCleanupAuditEntry[]>;
14
+ export declare function formatSandboxCleanupHistory(entries: SandboxCleanupAuditEntry[]): string;
@@ -0,0 +1,57 @@
1
+ import path from "node:path";
2
+ import { mkdir, readFile, writeFile } from "node:fs/promises";
3
+ const MAX_ENTRIES = 200;
4
+ const FILE_NAME = "sandbox-cleanup-history.json";
5
+ export async function appendSandboxCleanupAudit(projectRoot, entry) {
6
+ const directory = path.join(projectRoot, ".forge");
7
+ const file = path.join(directory, FILE_NAME);
8
+ await mkdir(directory, { recursive: true, mode: 0o700 });
9
+ let entries = [];
10
+ try {
11
+ const raw = await readFile(file, "utf8");
12
+ const parsed = JSON.parse(raw);
13
+ if (!Array.isArray(parsed))
14
+ throw new Error("Invalid sandbox cleanup audit history.");
15
+ entries = parsed;
16
+ }
17
+ catch (error) {
18
+ if (error.code !== "ENOENT")
19
+ throw error;
20
+ }
21
+ entries.push(entry);
22
+ await writeFile(file, JSON.stringify(entries.slice(-MAX_ENTRIES), null, 2) + "\n", {
23
+ encoding: "utf8",
24
+ mode: 0o600,
25
+ });
26
+ }
27
+ export async function readSandboxCleanupAudit(projectRoot) {
28
+ const file = path.join(projectRoot, ".forge", FILE_NAME);
29
+ try {
30
+ const raw = await readFile(file, "utf8");
31
+ const parsed = JSON.parse(raw);
32
+ if (!Array.isArray(parsed))
33
+ throw new Error("Invalid sandbox cleanup audit history.");
34
+ return parsed.slice(-MAX_ENTRIES);
35
+ }
36
+ catch (error) {
37
+ if (error.code === "ENOENT")
38
+ return [];
39
+ throw error;
40
+ }
41
+ }
42
+ export function formatSandboxCleanupHistory(entries) {
43
+ if (!entries.length)
44
+ return "# FORGE Sandbox Cleanup History\n\nNo cleanup runs recorded yet.";
45
+ return [
46
+ "# FORGE Sandbox Cleanup History",
47
+ "",
48
+ ...entries.map(entry => [
49
+ "## " + entry.timestamp + " — " + entry.mode.toUpperCase(),
50
+ "- Run: " + entry.id,
51
+ "- Candidates: " + entry.candidates.length,
52
+ "- Removed: " + entry.removed.length,
53
+ ...(entry.removed.length ? ["- Removed IDs: " + entry.removed.join(", ")] : []),
54
+ ].join("\n")),
55
+ ].join("\n\n");
56
+ }
57
+ //# sourceMappingURL=sandbox-cleanup-audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-cleanup-audit.js","sourceRoot":"","sources":["../../src/core/sandbox-cleanup-audit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { SandboxSecurityProfile } from "./sandbox-security-profiles.js";
2
+ export interface SandboxComplianceCheck {
3
+ id: string;
4
+ label: string;
5
+ status: "pass" | "warning" | "fail";
6
+ evidence: string;
7
+ }
8
+ export interface SandboxComplianceReport {
9
+ profile: string;
10
+ status: "compliant" | "partial" | "non-compliant";
11
+ checks: SandboxComplianceCheck[];
12
+ generatedAt: string;
13
+ }
14
+ export declare function createSandboxComplianceReport(profile: SandboxSecurityProfile, runtime: {
15
+ available: boolean;
16
+ rootless: boolean | null;
17
+ imageDigestPinned: boolean;
18
+ }): SandboxComplianceReport;
19
+ export declare function formatSandboxComplianceReport(report: SandboxComplianceReport): string;
@@ -0,0 +1,34 @@
1
+ export function createSandboxComplianceReport(profile, runtime) {
2
+ const checks = [
3
+ { id: "image-digest", label: "Immutable image reference", status: runtime.imageDigestPinned ? "pass" : "fail", evidence: runtime.imageDigestPinned ? "Image reference includes a SHA-256 digest." : "Image reference is not digest-pinned." },
4
+ { id: "network", label: "Network isolation", status: "pass", evidence: "FORGE configures --network=none." },
5
+ { id: "read-only-root", label: "Read-only container root", status: "pass", evidence: "FORGE configures --read-only." },
6
+ { id: "capabilities", label: "Linux capabilities", status: "pass", evidence: "FORGE configures --cap-drop=ALL." },
7
+ { id: "no-new-privileges", label: "Privilege escalation", status: "pass", evidence: "FORGE configures no-new-privileges." },
8
+ { id: "resource-limits", label: "Resource limits", status: "pass", evidence: "FORGE configures memory, CPU and PID limits." },
9
+ { id: "runtime", label: "Container runtime available", status: runtime.available ? "pass" : "fail", evidence: runtime.available ? "Container runtime probes succeeded." : "Container runtime availability was not confirmed." },
10
+ { id: "rootless", label: "Rootless runtime", status: runtime.rootless === true ? "pass" : profile.requireRootless ? "fail" : runtime.rootless === false ? "warning" : "warning", evidence: runtime.rootless === true ? "Docker reports rootless mode." : runtime.rootless === false ? "Docker reports a rootful daemon." : "Rootless status is unknown." },
11
+ ];
12
+ const failed = checks.some(check => check.status === "fail");
13
+ const warnings = checks.some(check => check.status === "warning");
14
+ return {
15
+ profile: profile.name,
16
+ status: failed ? "non-compliant" : warnings ? "partial" : "compliant",
17
+ checks,
18
+ generatedAt: new Date().toISOString(),
19
+ };
20
+ }
21
+ export function formatSandboxComplianceReport(report) {
22
+ return [
23
+ "# FORGE Sandbox Compliance",
24
+ "",
25
+ "- Profile: " + report.profile,
26
+ "- Result: " + report.status.toUpperCase(),
27
+ "- Generated: " + report.generatedAt,
28
+ "",
29
+ ...report.checks.map(check => "- [" + check.status.toUpperCase() + "] " + check.label + ": " + check.evidence),
30
+ "",
31
+ "This report describes FORGE-configured controls and observed runtime facts; it is not an independent security audit or guarantee.",
32
+ ].join("\n");
33
+ }
34
+ //# sourceMappingURL=sandbox-compliance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-compliance.js","sourceRoot":"","sources":["../../src/core/sandbox-compliance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ export interface ManagedContainer {
2
+ id: string;
3
+ status: string;
4
+ name: string;
5
+ }
6
+ export declare function parseManagedContainers(output: string): ManagedContainer[];
7
+ export declare function selectStoppedManagedContainers(containers: ManagedContainer[]): ManagedContainer[];
8
+ export declare function formatSandboxCleanupReport(candidates: ManagedContainer[], removed?: string[], apply?: boolean): string;
@@ -0,0 +1,36 @@
1
+ export function parseManagedContainers(output) {
2
+ const result = [];
3
+ for (const line of output.split(/\r?\n/)) {
4
+ if (!line.trim())
5
+ continue;
6
+ const [id, status, name, ...extra] = line.split("\t");
7
+ if (extra.length || !id || !/^[a-f0-9]{12,64}$/i.test(id) || !status?.trim() || !name?.trim()) {
8
+ throw new Error("Container runtime returned an invalid managed-container record.");
9
+ }
10
+ result.push({ id, status: status.trim(), name: name.trim() });
11
+ }
12
+ return result;
13
+ }
14
+ export function selectStoppedManagedContainers(containers) {
15
+ return containers.filter(container => /^(exited|created|dead)(?:\s|$)/i.test(container.status));
16
+ }
17
+ export function formatSandboxCleanupReport(candidates, removed = [], apply = false) {
18
+ const lines = [
19
+ "# FORGE Sandbox Cleanup",
20
+ "",
21
+ "- Mode: " + (apply ? "APPLY" : "DRY RUN"),
22
+ "- Stopped managed containers found: " + candidates.length,
23
+ "- Removed: " + removed.length,
24
+ "",
25
+ ];
26
+ if (!candidates.length)
27
+ lines.push("No stopped FORGE-managed containers found.");
28
+ else {
29
+ lines.push("## Candidates");
30
+ for (const item of candidates)
31
+ lines.push("- " + item.id + " — " + item.name + " (" + item.status + ")" + (removed.includes(item.id) ? " — removed" : ""));
32
+ }
33
+ lines.push("", "Only containers returned by the FORGE management label filter and in a stopped state are eligible. Active containers are never selected.");
34
+ return lines.join("\n");
35
+ }
36
+ //# sourceMappingURL=sandbox-lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-lifecycle.js","sourceRoot":"","sources":["../../src/core/sandbox-lifecycle.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,UAA8B;IAC3E,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,iCAAiC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAA8B,EAC9B,UAAoB,EAAE,EACtB,KAAK,GAAG,KAAK;IAEb,MAAM,KAAK,GAAG;QACZ,yBAAyB;QACzB,EAAE;QACF,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1C,sCAAsC,GAAG,UAAU,CAAC,MAAM;QAC1D,aAAa,GAAG,OAAO,CAAC,MAAM;QAC9B,EAAE;KACH,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;SAC5E,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7J,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,0IAA0I,CAAC,CAAC;IAC3J,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,31 @@
1
+ import type { SandboxSecurityProfileName } from "./sandbox-security-profiles.js";
2
+ export interface SandboxPolicy {
3
+ version: 1;
4
+ profile: SandboxSecurityProfileName;
5
+ network: "none";
6
+ readOnlyRoot: true;
7
+ dropAllCapabilities: true;
8
+ noNewPrivileges: true;
9
+ maxMemory: string;
10
+ maxCpus: number;
11
+ maxProcesses: number;
12
+ requireRootless: boolean;
13
+ requireImageDigest: true;
14
+ }
15
+ export declare function validateSandboxPolicy(value: unknown): {
16
+ valid: true;
17
+ policy: SandboxPolicy;
18
+ } | {
19
+ valid: false;
20
+ errors: string[];
21
+ };
22
+ export declare function loadSandboxPolicy(filePath: string): Promise<{
23
+ valid: true;
24
+ policy: SandboxPolicy;
25
+ path: string;
26
+ } | {
27
+ valid: false;
28
+ errors: string[];
29
+ path: string;
30
+ }>;
31
+ export declare function formatSandboxPolicyValidation(result: Awaited<ReturnType<typeof loadSandboxPolicy>>): string;
@@ -0,0 +1,80 @@
1
+ import { lstat, readFile } from "node:fs/promises";
2
+ import path from "node:path";
3
+ const ALLOWED_PROFILES = ["balanced", "hardened", "rootless-required"];
4
+ const MEMORY = /^([1-9][0-9]{0,3})(m|g)$/;
5
+ const MAX_POLICY_BYTES = 16 * 1024;
6
+ export function validateSandboxPolicy(value) {
7
+ const errors = [];
8
+ if (!value || typeof value !== "object" || Array.isArray(value))
9
+ return { valid: false, errors: ["Policy must be a JSON object."] };
10
+ const input = value;
11
+ const allowed = new Set(["version", "profile", "network", "readOnlyRoot", "dropAllCapabilities", "noNewPrivileges", "maxMemory", "maxCpus", "maxProcesses", "requireRootless", "requireImageDigest"]);
12
+ for (const key of Object.keys(input))
13
+ if (!allowed.has(key))
14
+ errors.push("Unknown policy field: " + key);
15
+ if (input.version !== 1)
16
+ errors.push("version must be 1.");
17
+ if (typeof input.profile !== "string" || !ALLOWED_PROFILES.includes(input.profile))
18
+ errors.push("profile must be balanced, hardened, or rootless-required.");
19
+ if (input.network !== "none")
20
+ errors.push("network must remain none; network access cannot be enabled.");
21
+ if (input.readOnlyRoot !== true)
22
+ errors.push("readOnlyRoot must remain true.");
23
+ if (input.dropAllCapabilities !== true)
24
+ errors.push("dropAllCapabilities must remain true.");
25
+ if (input.noNewPrivileges !== true)
26
+ errors.push("noNewPrivileges must remain true.");
27
+ if (typeof input.maxMemory !== "string" || !MEMORY.test(input.maxMemory))
28
+ errors.push("maxMemory must be a positive integer followed by m or g.");
29
+ else {
30
+ const m = input.maxMemory.match(MEMORY);
31
+ const amount = Number(m[1]) * (m[2] === "g" ? 1024 : 1);
32
+ if (amount > 1024)
33
+ errors.push("maxMemory cannot exceed 1g.");
34
+ }
35
+ if (typeof input.maxCpus !== "number" || !Number.isFinite(input.maxCpus) || input.maxCpus <= 0 || input.maxCpus > 2)
36
+ errors.push("maxCpus must be greater than 0 and at most 2.");
37
+ if (typeof input.maxProcesses !== "number" || !Number.isInteger(input.maxProcesses) || input.maxProcesses < 1 || input.maxProcesses > 128)
38
+ errors.push("maxProcesses must be an integer from 1 to 128.");
39
+ if (typeof input.requireRootless !== "boolean")
40
+ errors.push("requireRootless must be a boolean.");
41
+ if (input.requireImageDigest !== true)
42
+ errors.push("requireImageDigest must remain true.");
43
+ if ((input.profile === "hardened" || input.profile === "rootless-required") && input.requireRootless !== true)
44
+ errors.push("Selected profile requires rootless mode.");
45
+ if (errors.length)
46
+ return { valid: false, errors };
47
+ return { valid: true, policy: input };
48
+ }
49
+ export async function loadSandboxPolicy(filePath) {
50
+ const resolved = path.resolve(filePath);
51
+ try {
52
+ const metadata = await lstat(resolved);
53
+ if (metadata.isSymbolicLink() || !metadata.isFile()) {
54
+ return { valid: false, errors: ["Policy path must be a regular, non-symlink file."], path: resolved };
55
+ }
56
+ if (metadata.size > MAX_POLICY_BYTES) {
57
+ return { valid: false, errors: ["Policy file exceeds the 16 KiB size limit."], path: resolved };
58
+ }
59
+ const raw = await readFile(resolved, "utf8");
60
+ if (Buffer.byteLength(raw, "utf8") > MAX_POLICY_BYTES) {
61
+ return { valid: false, errors: ["Policy file exceeds the 16 KiB size limit."], path: resolved };
62
+ }
63
+ let parsed;
64
+ try {
65
+ parsed = JSON.parse(raw);
66
+ }
67
+ catch {
68
+ return { valid: false, errors: ["Policy file is not valid JSON."], path: resolved };
69
+ }
70
+ const result = validateSandboxPolicy(parsed);
71
+ return result.valid ? { ...result, path: resolved } : { ...result, path: resolved };
72
+ }
73
+ catch (error) {
74
+ return { valid: false, errors: [error instanceof Error ? error.message : String(error)], path: resolved };
75
+ }
76
+ }
77
+ export function formatSandboxPolicyValidation(result) {
78
+ return ["# FORGE Sandbox Policy Validation", "", "- File: " + result.path, "- Result: " + (result.valid ? "VALID" : "INVALID"), "", ...(result.valid ? ["Policy may be considered by the runtime enforcement layer; validation itself does not apply it."] : result.errors.map(error => "- " + error))].join("\n");
79
+ }
80
+ //# sourceMappingURL=sandbox-policy.js.map