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,37 @@
1
+ export type VerificationStatus = "passed" | "failed" | "timed_out" | "spawn_error";
2
+ export interface AvailableCheck {
3
+ name: string;
4
+ command: string;
5
+ packageManager: "npm";
6
+ }
7
+ export interface VerificationResult {
8
+ id: string;
9
+ projectPath: string;
10
+ script: string;
11
+ command: string;
12
+ status: VerificationStatus;
13
+ exitCode: number | null;
14
+ signal: string | null;
15
+ durationMs: number;
16
+ startedAt: string;
17
+ finishedAt: string;
18
+ output: string;
19
+ outputTruncated: boolean;
20
+ }
21
+ export declare function discoverChecks(inputPath: string): Promise<AvailableCheck[]>;
22
+ export declare function runVerification(inputPath: string, script: string, options?: {
23
+ timeoutMs?: number;
24
+ }): Promise<VerificationResult>;
25
+ export declare function formatVerificationResult(result: VerificationResult): string;
26
+ export interface DependencyInstallResult {
27
+ status: "passed" | "failed" | "timed_out" | "spawn_error";
28
+ exitCode: number | null;
29
+ durationMs: number;
30
+ output: string;
31
+ outputTruncated: boolean;
32
+ command: string;
33
+ }
34
+ /** Installs lockfile dependencies without lifecycle scripts. This operation can access the network. */
35
+ export declare function installVerificationDependencies(inputPath: string, options?: {
36
+ timeoutMs?: number;
37
+ }): Promise<DependencyInstallResult>;
@@ -0,0 +1,204 @@
1
+ import { spawn } from "node:child_process";
2
+ import { lstat, readFile, realpath, writeFile } from "node:fs/promises";
3
+ import path from "node:path";
4
+ const MAX_OUTPUT = 64 * 1024;
5
+ const DEFAULT_TIMEOUT = 120_000;
6
+ const MAX_TIMEOUT = 10 * 60_000;
7
+ const SCRIPT_NAME = /^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,79}$/;
8
+ async function verifiedProjectRoot(inputPath) {
9
+ const root = await realpath(path.resolve(inputPath));
10
+ const rootInfo = await lstat(root);
11
+ if (!rootInfo.isDirectory())
12
+ throw new Error("Verification target must be a real directory.");
13
+ const manifest = path.join(root, "package.json");
14
+ const manifestInfo = await lstat(manifest);
15
+ if (manifestInfo.isSymbolicLink() || !manifestInfo.isFile())
16
+ throw new Error("package.json must be a regular, non-symlink file.");
17
+ return root;
18
+ }
19
+ async function packageScripts(root) {
20
+ const parsed = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
21
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
22
+ throw new Error("package.json must contain a JSON object.");
23
+ const scripts = parsed.scripts;
24
+ if (!scripts || typeof scripts !== "object" || Array.isArray(scripts))
25
+ return {};
26
+ return Object.fromEntries(Object.entries(scripts).filter((entry) => typeof entry[1] === "string"));
27
+ }
28
+ export async function discoverChecks(inputPath) {
29
+ const root = await verifiedProjectRoot(inputPath);
30
+ const scripts = await packageScripts(root);
31
+ return Object.entries(scripts)
32
+ .filter(([name]) => SCRIPT_NAME.test(name) && !/^pre|^post/.test(name))
33
+ .map(([name, command]) => ({ name, command, packageManager: "npm" }))
34
+ .sort((a, b) => a.name.localeCompare(b.name));
35
+ }
36
+ export async function runVerification(inputPath, script, options = {}) {
37
+ const root = await verifiedProjectRoot(inputPath);
38
+ if (!SCRIPT_NAME.test(script) || /^pre|^post/.test(script))
39
+ throw new Error("Choose a valid, explicit package script name (pre/post lifecycle scripts are not selectable).");
40
+ const scripts = await packageScripts(root);
41
+ if (!(script in scripts))
42
+ throw new Error(`Script "${script}" is not defined in package.json.`);
43
+ const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT;
44
+ if (!Number.isInteger(timeoutMs) || timeoutMs < 1000 || timeoutMs > MAX_TIMEOUT)
45
+ throw new Error("Timeout must be between 1,000 and 600,000 milliseconds.");
46
+ const startedAt = new Date();
47
+ const chunks = [];
48
+ let outputSize = 0;
49
+ let outputTruncated = false;
50
+ const append = (chunk) => {
51
+ const value = chunk.toString();
52
+ const remaining = MAX_OUTPUT - outputSize;
53
+ if (remaining > 0) {
54
+ const kept = value.slice(0, remaining);
55
+ chunks.push(kept);
56
+ outputSize += kept.length;
57
+ }
58
+ if (value.length > remaining)
59
+ outputTruncated = true;
60
+ };
61
+ const windows = process.platform === "win32";
62
+ // Do not forward provider/API credentials or arbitrary parent-process variables to project scripts.
63
+ const env = {
64
+ PATH: process.env.PATH ?? "",
65
+ CI: "1",
66
+ NODE_ENV: "test",
67
+ FORGE_VERIFICATION: "1",
68
+ ...(process.env.SystemRoot ? { SystemRoot: process.env.SystemRoot } : {}),
69
+ ...(process.env.WINDIR ? { WINDIR: process.env.WINDIR } : {}),
70
+ ...(process.env.TEMP ? { TEMP: process.env.TEMP } : {}),
71
+ ...(process.env.TMP ? { TMP: process.env.TMP } : {}),
72
+ ...(process.env.HOME ? { HOME: process.env.HOME } : {}),
73
+ };
74
+ const child = spawn(windows ? "cmd.exe" : "npm", windows ? ["/d", "/s", "/c", `npm run-script --ignore-scripts ${script}`] : ["run-script", "--ignore-scripts", script], {
75
+ cwd: root, shell: false, windowsHide: true, env, stdio: ["ignore", "pipe", "pipe"], detached: !windows,
76
+ });
77
+ child.stdout.on("data", append);
78
+ child.stderr.on("data", append);
79
+ let timedOut = false;
80
+ const timer = setTimeout(() => {
81
+ timedOut = true;
82
+ if (!windows && child.pid) {
83
+ try {
84
+ process.kill(-child.pid, "SIGTERM");
85
+ }
86
+ catch {
87
+ child.kill("SIGTERM");
88
+ }
89
+ }
90
+ else
91
+ child.kill("SIGTERM");
92
+ }, timeoutMs);
93
+ const outcome = await new Promise(resolve => {
94
+ child.once("error", error => resolve({ exitCode: null, signal: null, error: error.message }));
95
+ child.once("close", (code, signal) => resolve({ exitCode: code, signal }));
96
+ });
97
+ clearTimeout(timer);
98
+ if (outcome.error)
99
+ append(`\nFORGE could not start npm: ${outcome.error}\n`);
100
+ const finishedAt = new Date();
101
+ return {
102
+ id: `verify-${startedAt.getTime().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
103
+ projectPath: root, script, command: `npm run-script --ignore-scripts ${script}`,
104
+ status: outcome.error ? "spawn_error" : timedOut ? "timed_out" : outcome.exitCode === 0 ? "passed" : "failed",
105
+ exitCode: outcome.exitCode, signal: outcome.signal, durationMs: finishedAt.getTime() - startedAt.getTime(),
106
+ startedAt: startedAt.toISOString(), finishedAt: finishedAt.toISOString(), output: chunks.join(""), outputTruncated,
107
+ };
108
+ }
109
+ export function formatVerificationResult(result) {
110
+ return [
111
+ "# FORGE Verification Result", "",
112
+ `- **Script:** \`${result.script}\``,
113
+ `- **Status:** \`${result.status.toUpperCase()}\``,
114
+ `- **Exit code:** \`${result.exitCode === null ? "not available" : result.exitCode}\``,
115
+ `- **Duration:** \`${result.durationMs} ms\``,
116
+ `- **Started:** \`${result.startedAt}\``, "",
117
+ "## Command output", "",
118
+ result.output || "(No output captured.)",
119
+ result.outputTruncated ? "\n[Output truncated at 64 KiB.]" : "",
120
+ "", "_The selected package script was explicitly executed. Review its output; a passing exit code is not a security or correctness certification._"
121
+ ].join("\n");
122
+ }
123
+ /** Installs lockfile dependencies without lifecycle scripts. This operation can access the network. */
124
+ export async function installVerificationDependencies(inputPath, options = {}) {
125
+ const root = await verifiedProjectRoot(inputPath);
126
+ const lockInfo = await lstat(path.join(root, "package-lock.json")).catch(() => null);
127
+ if (!lockInfo || lockInfo.isSymbolicLink() || !lockInfo.isFile()) {
128
+ throw new Error("Dependency preparation requires a regular package-lock.json; no installation was attempted.");
129
+ }
130
+ const timeoutMs = options.timeoutMs ?? MAX_TIMEOUT;
131
+ if (!Number.isInteger(timeoutMs) || timeoutMs < 1000 || timeoutMs > MAX_TIMEOUT) {
132
+ throw new Error("Dependency installation timeout must be between 1,000 and 600,000 milliseconds.");
133
+ }
134
+ const startedAt = Date.now();
135
+ const chunks = [];
136
+ let outputSize = 0;
137
+ let outputTruncated = false;
138
+ const append = (chunk) => {
139
+ const value = chunk.toString();
140
+ const remaining = MAX_OUTPUT - outputSize;
141
+ if (remaining > 0) {
142
+ const kept = value.slice(0, remaining);
143
+ chunks.push(kept);
144
+ outputSize += kept.length;
145
+ }
146
+ if (value.length > remaining)
147
+ outputTruncated = true;
148
+ };
149
+ const windows = process.platform === "win32";
150
+ const userConfig = path.join(root, ".forge-npm-user-config");
151
+ const globalConfig = path.join(root, ".forge-npm-global-config");
152
+ await Promise.all([
153
+ writeFile(userConfig, "", { flag: "wx", mode: 0o600 }),
154
+ writeFile(globalConfig, "", { flag: "wx", mode: 0o600 }),
155
+ ]);
156
+ const env = {
157
+ PATH: process.env.PATH ?? "", CI: "1", NODE_ENV: "test", FORGE_VERIFICATION: "1",
158
+ HOME: root, USERPROFILE: root,
159
+ ...(process.env.SystemRoot ? { SystemRoot: process.env.SystemRoot } : {}),
160
+ ...(process.env.WINDIR ? { WINDIR: process.env.WINDIR } : {}),
161
+ ...(process.env.TEMP ? { TEMP: process.env.TEMP } : {}),
162
+ ...(process.env.TMP ? { TMP: process.env.TMP } : {}),
163
+ };
164
+ const command = "npm ci --ignore-scripts --no-audit --no-fund --userconfig <temporary-empty-config> --globalconfig <temporary-empty-config>";
165
+ const child = spawn(windows ? "npm.cmd" : "npm", ["ci", "--ignore-scripts", "--no-audit", "--no-fund", "--userconfig", userConfig, "--globalconfig", globalConfig], {
166
+ cwd: root, shell: windows, windowsHide: true, env, stdio: ["ignore", "pipe", "pipe"], detached: !windows,
167
+ });
168
+ child.stdout.on("data", append);
169
+ child.stderr.on("data", append);
170
+ let timedOut = false;
171
+ const outcome = await new Promise(resolve => {
172
+ let settled = false;
173
+ const finish = (value) => {
174
+ if (settled)
175
+ return;
176
+ settled = true;
177
+ clearTimeout(timer);
178
+ resolve(value);
179
+ };
180
+ const timer = setTimeout(() => {
181
+ timedOut = true;
182
+ if (!windows && child.pid) {
183
+ try {
184
+ process.kill(-child.pid, "SIGTERM");
185
+ }
186
+ catch {
187
+ child.kill("SIGTERM");
188
+ }
189
+ }
190
+ else
191
+ child.kill("SIGTERM");
192
+ }, timeoutMs);
193
+ child.once("error", error => finish({ exitCode: null, error: error.message }));
194
+ child.once("close", code => finish({ exitCode: code }));
195
+ });
196
+ if (outcome.error)
197
+ append("\nFORGE could not start npm: " + outcome.error + "\n");
198
+ return {
199
+ status: outcome.error ? "spawn_error" : timedOut ? "timed_out" : outcome.exitCode === 0 ? "passed" : "failed",
200
+ exitCode: outcome.exitCode, durationMs: Date.now() - startedAt,
201
+ output: chunks.join(""), outputTruncated, command,
202
+ };
203
+ }
204
+ //# sourceMappingURL=verification.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verification.js","sourceRoot":"","sources":["../../src/core/verification.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { type AgentTask, type RunRecord } from "./orchestrator.js";
2
+ export interface WorkflowDefinition {
3
+ id: string;
4
+ name: string;
5
+ description: string;
6
+ tasks: AgentTask[];
7
+ positions?: Record<string, {
8
+ x: number;
9
+ y: number;
10
+ }>;
11
+ updatedAt: string;
12
+ }
13
+ export declare function saveWorkflow(projectPath: string, input: unknown): Promise<WorkflowDefinition>;
14
+ export declare function loadWorkflow(projectPath: string, id: string): Promise<WorkflowDefinition>;
15
+ export declare function listWorkflows(projectPath: string): Promise<WorkflowDefinition[]>;
16
+ export declare function createRunFromWorkflow(workflow: WorkflowDefinition): RunRecord;
@@ -0,0 +1,113 @@
1
+ import { mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
2
+ import { randomUUID } from "node:crypto";
3
+ import path from "node:path";
4
+ import { createRun } from "./orchestrator.js";
5
+ const ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,47}$/;
6
+ function validateWorkflow(input) {
7
+ if (!input || typeof input !== "object")
8
+ throw new Error("Workflow must be an object.");
9
+ const value = input;
10
+ if (typeof value.id !== "string" || !ID_PATTERN.test(value.id))
11
+ throw new Error("Workflow id must be a 2–48 character lowercase slug.");
12
+ if (typeof value.name !== "string" || !value.name.trim() || value.name.length > 100)
13
+ throw new Error("Workflow name is required and must be at most 100 characters.");
14
+ if (typeof value.description !== "string" || value.description.length > 500)
15
+ throw new Error("Workflow description must be at most 500 characters.");
16
+ if (!Array.isArray(value.tasks) || value.tasks.length < 1 || value.tasks.length > 30)
17
+ throw new Error("A workflow must contain between 1 and 30 tasks.");
18
+ const tasks = value.tasks;
19
+ const ids = new Set();
20
+ for (const task of tasks) {
21
+ if (!task || typeof task !== "object" || typeof task.id !== "string" || !/^[a-z0-9][a-z0-9-]{0,39}$/.test(task.id))
22
+ throw new Error("Each task needs a valid lowercase id.");
23
+ if (ids.has(task.id))
24
+ throw new Error("Task ids must be unique.");
25
+ ids.add(task.id);
26
+ if (typeof task.agent !== "string" || !/^[a-z0-9][a-z0-9-]{0,39}$/.test(task.agent))
27
+ throw new Error("Each task needs a valid agent id.");
28
+ if (typeof task.title !== "string" || !task.title.trim() || task.title.length > 120)
29
+ throw new Error("Task titles are required and limited to 120 characters.");
30
+ if (typeof task.prompt !== "string" || !task.prompt.trim() || task.prompt.length > 4000)
31
+ throw new Error("Task prompts are required and limited to 4,000 characters.");
32
+ if (task.requiresApproval !== undefined && typeof task.requiresApproval !== "boolean")
33
+ throw new Error("requiresApproval must be boolean.");
34
+ if (task.dependsOn !== undefined && (!Array.isArray(task.dependsOn) || task.dependsOn.some(id => typeof id !== "string")))
35
+ throw new Error("dependsOn must be a list of task ids.");
36
+ }
37
+ for (const task of tasks) {
38
+ for (const dependency of task.dependsOn ?? []) {
39
+ if (!ids.has(dependency) || dependency === task.id)
40
+ throw new Error("Task dependencies must reference another task in this workflow.");
41
+ }
42
+ }
43
+ if (value.positions !== undefined) {
44
+ if (!value.positions || typeof value.positions !== "object" || Array.isArray(value.positions))
45
+ throw new Error("Workflow positions must be a map.");
46
+ for (const [taskId, point] of Object.entries(value.positions)) {
47
+ if (!ids.has(taskId) || !point || typeof point !== "object")
48
+ throw new Error("Workflow positions must reference existing tasks.");
49
+ const position = point;
50
+ if (!Number.isFinite(position.x) || !Number.isFinite(position.y) || position.x < 0 || position.x > 4000 || position.y < 0 || position.y > 3000)
51
+ throw new Error("Workflow position is outside the supported canvas.");
52
+ }
53
+ }
54
+ // Reuse the run planner's cycle and dependency validation.
55
+ createRun(value.name, tasks);
56
+ }
57
+ function directory(projectPath) {
58
+ return path.join(path.resolve(projectPath), ".forge", "workflows");
59
+ }
60
+ export async function saveWorkflow(projectPath, input) {
61
+ validateWorkflow(input);
62
+ const workflow = { ...input, tasks: input.tasks.map(task => ({ ...task, dependsOn: [...(task.dependsOn ?? [])] })), updatedAt: new Date().toISOString() };
63
+ const folder = directory(projectPath);
64
+ await mkdir(folder, { recursive: true });
65
+ const destination = path.join(folder, workflow.id + ".json");
66
+ const temporary = path.join(folder, "." + workflow.id + "." + randomUUID() + ".tmp");
67
+ try {
68
+ await writeFile(temporary, JSON.stringify(workflow, null, 2) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
69
+ await rename(temporary, destination);
70
+ }
71
+ catch (error) {
72
+ await rm(temporary, { force: true }).catch(() => undefined);
73
+ throw error;
74
+ }
75
+ return workflow;
76
+ }
77
+ export async function loadWorkflow(projectPath, id) {
78
+ if (!ID_PATTERN.test(id))
79
+ throw new Error("Invalid workflow identifier.");
80
+ const value = JSON.parse(await readFile(path.join(directory(projectPath), id + ".json"), "utf8"));
81
+ validateWorkflow(value);
82
+ if (value.id !== id)
83
+ throw new Error("Stored workflow identifier does not match its filename.");
84
+ return value;
85
+ }
86
+ export async function listWorkflows(projectPath) {
87
+ let entries;
88
+ try {
89
+ entries = await readdir(directory(projectPath), { withFileTypes: true });
90
+ }
91
+ catch (error) {
92
+ if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
93
+ return [];
94
+ throw error;
95
+ }
96
+ const workflows = [];
97
+ for (const entry of entries) {
98
+ if (!entry.isFile() || !entry.name.endsWith(".json"))
99
+ continue;
100
+ const id = entry.name.slice(0, -5);
101
+ if (!ID_PATTERN.test(id))
102
+ continue;
103
+ try {
104
+ workflows.push(await loadWorkflow(projectPath, id));
105
+ }
106
+ catch { /* Ignore malformed local definitions. */ }
107
+ }
108
+ return workflows.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
109
+ }
110
+ export function createRunFromWorkflow(workflow) {
111
+ return createRun(workflow.name, workflow.tasks);
112
+ }
113
+ //# sourceMappingURL=workflow-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow-store.js","sourceRoot":"","sources":["../../src/core/workflow-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ export interface WorkspaceEntry {
2
+ name: string;
3
+ path: string;
4
+ kind: "directory" | "file";
5
+ size?: number;
6
+ extension?: string;
7
+ }
8
+ export interface WorkspaceDirectory {
9
+ path: string;
10
+ parent: string | null;
11
+ entries: WorkspaceEntry[];
12
+ truncated: boolean;
13
+ }
14
+ export declare function assertWorkspacePathAllowed(relativePath: string): void;
15
+ export declare function listWorkspaceDirectory(projectPath: string, relativePath?: string): Promise<WorkspaceDirectory>;
16
+ export declare function readWorkspaceFile(projectPath: string, relativePath: string): Promise<{
17
+ path: string;
18
+ name: string;
19
+ extension: string;
20
+ size: number;
21
+ content: string;
22
+ }>;
@@ -0,0 +1,115 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, open, readdir, realpath } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { isExcludedScanDirectory } from "./workspace-scan-policy.js";
5
+ const MAX_ENTRIES = 200;
6
+ const MAX_PREVIEW_BYTES = 128 * 1024;
7
+ const BLOCKED_NAME = /(^|[. _-])(env|secret|secrets|credential|credentials|private|token|password)([. _-]|$)/i;
8
+ const PREVIEW_EXTENSIONS = new Set([
9
+ ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".json", ".md", ".mdx", ".txt",
10
+ ".html", ".css", ".scss", ".sass", ".less", ".yml", ".yaml", ".toml", ".xml",
11
+ ".svg", ".sql", ".py", ".go", ".rs", ".java", ".kt", ".cs", ".php", ".rb",
12
+ ".sh", ".ps1", ".bat", ".c", ".h", ".cpp", ".hpp", ".swift", ".vue", ".svelte"
13
+ ]);
14
+ function isInside(root, candidate) {
15
+ const relative = path.relative(root, candidate);
16
+ return relative === "" || (!relative.startsWith(".." + path.sep) && relative !== ".." && !path.isAbsolute(relative));
17
+ }
18
+ async function resolveWorkspacePath(rootPath, relativePath) {
19
+ const root = await realpath(path.resolve(rootPath));
20
+ const normalized = relativePath.replace(/\\/g, "/");
21
+ if (normalized.startsWith("/") || /^[a-zA-Z]:/.test(normalized) || normalized.split("/").some(part => part === "..")) {
22
+ throw new Error("Workspace path must stay inside the project.");
23
+ }
24
+ const segments = normalized.split("/").filter(part => part && part !== ".");
25
+ assertWorkspacePathAllowed(segments.join("/"));
26
+ let cursor = root;
27
+ for (const segment of segments) {
28
+ cursor = path.join(cursor, segment);
29
+ const segmentInfo = await lstat(cursor);
30
+ if (segmentInfo.isSymbolicLink())
31
+ throw new Error("Symbolic links are not browsable.");
32
+ }
33
+ const target = path.resolve(root, ...segments);
34
+ if (!isInside(root, target))
35
+ throw new Error("Workspace path must stay inside the project.");
36
+ const info = await lstat(target);
37
+ if (info.isSymbolicLink())
38
+ throw new Error("Symbolic links are not browsable.");
39
+ const actual = await realpath(target);
40
+ if (!isInside(root, actual))
41
+ throw new Error("Workspace path must stay inside the project.");
42
+ return { root, target: actual, relative: segments.join("/") };
43
+ }
44
+ function isBlocked(name) {
45
+ return BLOCKED_NAME.test(name) || /\.(pem|key|p12|pfx|keystore)$/i.test(name);
46
+ }
47
+ export function assertWorkspacePathAllowed(relativePath) {
48
+ const segments = relativePath.replace(/\\/g, "/").split("/").filter(Boolean);
49
+ if (segments.some(isBlocked))
50
+ throw new Error("Sensitive workspace paths are not browsable.");
51
+ if (segments.some(segment => segment.startsWith(".") || isExcludedScanDirectory(segment))) {
52
+ throw new Error("Hidden or excluded workspace paths are not browsable.");
53
+ }
54
+ }
55
+ export async function listWorkspaceDirectory(projectPath, relativePath = "") {
56
+ const resolved = await resolveWorkspacePath(projectPath, relativePath);
57
+ const info = await lstat(resolved.target);
58
+ if (!info.isDirectory())
59
+ throw new Error("Workspace path is not a directory.");
60
+ const dirents = await readdir(resolved.target, { withFileTypes: true });
61
+ const entries = [];
62
+ for (const dirent of dirents) {
63
+ if (dirent.name.startsWith(".") || isBlocked(dirent.name))
64
+ continue;
65
+ if (dirent.isSymbolicLink())
66
+ continue;
67
+ const childPath = path.join(resolved.target, dirent.name);
68
+ let childInfo;
69
+ try {
70
+ childInfo = await lstat(childPath);
71
+ }
72
+ catch {
73
+ continue;
74
+ }
75
+ const relative = [resolved.relative, dirent.name].filter(Boolean).join("/");
76
+ if (childInfo.isDirectory()) {
77
+ if (!isExcludedScanDirectory(dirent.name))
78
+ entries.push({ name: dirent.name, path: relative, kind: "directory" });
79
+ }
80
+ else if (childInfo.isFile() && PREVIEW_EXTENSIONS.has(path.extname(dirent.name).toLowerCase())) {
81
+ entries.push({ name: dirent.name, path: relative, kind: "file", size: childInfo.size, extension: path.extname(dirent.name).slice(1) });
82
+ }
83
+ }
84
+ entries.sort((a, b) => Number(b.kind === "directory") - Number(a.kind === "directory") || a.name.localeCompare(b.name));
85
+ return {
86
+ path: resolved.relative,
87
+ parent: resolved.relative ? path.posix.dirname(resolved.relative) === "." ? "" : path.posix.dirname(resolved.relative) : null,
88
+ entries: entries.slice(0, MAX_ENTRIES),
89
+ truncated: entries.length > MAX_ENTRIES
90
+ };
91
+ }
92
+ export async function readWorkspaceFile(projectPath, relativePath) {
93
+ const resolved = await resolveWorkspacePath(projectPath, relativePath);
94
+ const name = path.basename(resolved.target);
95
+ const extension = path.extname(name).toLowerCase();
96
+ if (isBlocked(name) || !PREVIEW_EXTENSIONS.has(extension))
97
+ throw new Error("This file type is not available in the workspace preview.");
98
+ // O_NOFOLLOW closes the final-component symlink swap between lstat and read.
99
+ const handle = await open(resolved.target, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
100
+ try {
101
+ const info = await handle.stat();
102
+ if (!info.isFile())
103
+ throw new Error("Workspace item is not a regular file.");
104
+ if (info.size > MAX_PREVIEW_BYTES)
105
+ throw new Error("File is too large to preview (128 KiB maximum).");
106
+ const content = await handle.readFile({ encoding: "utf8" });
107
+ if (content.includes("\u0000"))
108
+ throw new Error("Binary files cannot be previewed.");
109
+ return { path: resolved.relative, name, extension: extension.slice(1), size: info.size, content };
110
+ }
111
+ finally {
112
+ await handle.close();
113
+ }
114
+ }
115
+ //# sourceMappingURL=workspace-browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-browser.js","sourceRoot":"","sources":["../../src/core/workspace-browser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ /** Shared directory policy for read-only project scanners. */
2
+ export declare function isExcludedScanDirectory(name: string): boolean;
@@ -0,0 +1,11 @@
1
+ const EXCLUDED_SCAN_DIRECTORIES = new Set([
2
+ ".git", ".forge", ".ssh", ".aws", ".azure", ".kube", ".docker", ".gnupg",
3
+ ".npm", ".config", ".next", ".nuxt", ".output", ".turbo", ".vercel",
4
+ ".venv", "venv", "__pycache__", ".idea", ".vscode",
5
+ "node_modules", "dist", "build", "out", "coverage", "vendor"
6
+ ]);
7
+ /** Shared directory policy for read-only project scanners. */
8
+ export function isExcludedScanDirectory(name) {
9
+ return EXCLUDED_SCAN_DIRECTORIES.has(name);
10
+ }
11
+ //# sourceMappingURL=workspace-scan-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-scan-policy.js","sourceRoot":"","sources":["../../src/core/workspace-scan-policy.ts"],"names":[],"mappings":"AAAA,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ;IACxE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS;IACnE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS;IAClD,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ;CAC7D,CAAC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}
@@ -0,0 +1,28 @@
1
+ import type { ForgePermissionPolicy } from "./permission-policy.js";
2
+ export declare const WORKSPACE_AGENT_TOOLS: readonly [{
3
+ readonly name: "list-files";
4
+ readonly description: "List safe project files and directories under the workspace.";
5
+ }, {
6
+ readonly name: "read-file";
7
+ readonly description: "Read a supported text/source file inside the workspace.";
8
+ }, {
9
+ readonly name: "search-code";
10
+ readonly description: "Search TypeScript and JavaScript source for a symbol or text query.";
11
+ }];
12
+ export type WorkspaceAgentToolName = typeof WORKSPACE_AGENT_TOOLS[number]["name"];
13
+ export interface WorkspaceToolAuditEvent {
14
+ tool: WorkspaceAgentToolName;
15
+ allowed: boolean;
16
+ outcome: "success" | "denied" | "error";
17
+ at: string;
18
+ durationMs: number;
19
+ summary: string;
20
+ }
21
+ export interface WorkspaceToolBrokerOptions {
22
+ onAudit?: (event: WorkspaceToolAuditEvent) => void | Promise<void>;
23
+ }
24
+ /**
25
+ * Executes only explicitly allowlisted, read-only workspace tools.
26
+ * It has no shell, network, process, write, patch or arbitrary filesystem capability.
27
+ */
28
+ export declare function executeWorkspaceAgentTool(projectPath: string, policy: ForgePermissionPolicy, toolName: string, rawInput: unknown, options?: WorkspaceToolBrokerOptions): Promise<unknown>;