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,181 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { lstat, mkdir, readFile, realpath, rename, rm, writeFile } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { loadReview } from "./review-history.js";
5
+ import { validateReviewPatch } from "./patch-validation.js";
6
+ const ID = /^patch-approval-[a-f0-9-]{20,40}$/;
7
+ const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
8
+ async function safeApprovalDirectory(root) {
9
+ const project = await realpath(path.resolve(root));
10
+ let current = project;
11
+ for (const part of [".forge", "patch-approvals"]) {
12
+ current = path.join(current, part);
13
+ try {
14
+ await mkdir(current, { mode: 0o700 });
15
+ }
16
+ catch (error) {
17
+ if (!error || typeof error !== "object" || !("code" in error) || error.code !== "EEXIST")
18
+ throw error;
19
+ }
20
+ const info = await lstat(current);
21
+ if (info.isSymbolicLink() || !info.isDirectory())
22
+ throw new Error("Patch approval storage must not contain symbolic links or non-directory components.");
23
+ }
24
+ return current;
25
+ }
26
+ function validateId(id) { if (!ID.test(id) || id.includes(".."))
27
+ throw new Error("Invalid patch approval identifier."); }
28
+ function digest(value) { return createHash("sha256").update(value).digest("hex"); }
29
+ export async function approveReviewPatch(root, reviewId, suggestionNumber, reviewer, reason, ttlMs = DEFAULT_TTL_MS) {
30
+ const name = reviewer.trim().slice(0, 80);
31
+ if (!name)
32
+ throw new Error("A non-empty reviewer identity is required.");
33
+ if (!Number.isSafeInteger(ttlMs) || ttlMs < 60_000 || ttlMs > 7 * 24 * 60 * 60 * 1000)
34
+ throw new Error("Approval expiry must be between one minute and seven days.");
35
+ const review = await loadReview(root, reviewId);
36
+ const validation = await validateReviewPatch(root, review, suggestionNumber);
37
+ if (validation.status !== "applicable")
38
+ throw new Error("Patch cannot be approved: " + validation.reason);
39
+ const suggestion = review.ai?.suggestions[suggestionNumber - 1];
40
+ if (!suggestion?.patch)
41
+ throw new Error("The selected review suggestion has no patch.");
42
+ const target = path.resolve(root, suggestion.file);
43
+ const source = await readFile(target, "utf8");
44
+ const approvedAt = new Date();
45
+ const record = {
46
+ id: "patch-approval-" + randomUUID(),
47
+ reviewId,
48
+ suggestionNumber,
49
+ file: suggestion.file,
50
+ reviewer: name,
51
+ ...(reason?.trim() ? { reason: reason.trim().slice(0, 1000) } : {}),
52
+ approvedAt: approvedAt.toISOString(),
53
+ expiresAt: new Date(approvedAt.getTime() + ttlMs).toISOString(),
54
+ patchSha256: digest(suggestion.patch),
55
+ sourceSha256: digest(source),
56
+ };
57
+ const dir = await safeApprovalDirectory(root);
58
+ const destination = path.join(dir, record.id + ".json");
59
+ const temporary = path.join(dir, "." + record.id + "." + randomUUID() + ".tmp");
60
+ try {
61
+ await writeFile(temporary, JSON.stringify(record, null, 2) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
62
+ await rename(temporary, destination);
63
+ }
64
+ catch (error) {
65
+ await rm(temporary, { force: true }).catch(() => undefined);
66
+ throw error;
67
+ }
68
+ return record;
69
+ }
70
+ export async function loadPatchApproval(root, id) {
71
+ validateId(id);
72
+ const dir = await safeApprovalDirectory(root);
73
+ const approvalPath = path.join(dir, id + ".json");
74
+ const info = await lstat(approvalPath);
75
+ if (info.isSymbolicLink() || !info.isFile())
76
+ throw new Error("Stored patch approval must be a regular file.");
77
+ const parsed = JSON.parse(await readFile(approvalPath, "utf8"));
78
+ if (!parsed || typeof parsed !== "object" || !("id" in parsed) || parsed.id !== id ||
79
+ !("reviewId" in parsed) || typeof parsed.reviewId !== "string" ||
80
+ !("patchSha256" in parsed) || typeof parsed.patchSha256 !== "string" ||
81
+ !("sourceSha256" in parsed) || typeof parsed.sourceSha256 !== "string" ||
82
+ !("file" in parsed) || typeof parsed.file !== "string" || !parsed.file.trim() ||
83
+ !("suggestionNumber" in parsed) || typeof parsed.suggestionNumber !== "number" || !Number.isSafeInteger(parsed.suggestionNumber) || parsed.suggestionNumber < 1 ||
84
+ !("reviewer" in parsed) || typeof parsed.reviewer !== "string" || !parsed.reviewer.trim() ||
85
+ !("approvedAt" in parsed) || typeof parsed.approvedAt !== "string" || !Number.isFinite(Date.parse(parsed.approvedAt)) ||
86
+ !("expiresAt" in parsed) || typeof parsed.expiresAt !== "string" || !Number.isFinite(Date.parse(parsed.expiresAt)) ||
87
+ !/^[a-f0-9]{64}$/.test(parsed.patchSha256) || !/^[a-f0-9]{64}$/.test(parsed.sourceSha256)) {
88
+ throw new Error("Stored patch approval has an invalid format.");
89
+ }
90
+ return parsed;
91
+ }
92
+ export async function revokePatchApproval(root, id) {
93
+ const dir = await safeApprovalDirectory(root);
94
+ const marker = path.join(dir, id + ".used");
95
+ try {
96
+ await mkdir(marker, { mode: 0o700 });
97
+ }
98
+ catch (error) {
99
+ if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
100
+ const existing = await loadPatchApproval(root, id);
101
+ if (existing.revokedAt)
102
+ return existing;
103
+ throw new Error("Patch approval is already used or being consumed; it cannot be revoked.");
104
+ }
105
+ throw error;
106
+ }
107
+ const approval = await loadPatchApproval(root, id);
108
+ const revoked = { ...approval, revokedAt: new Date().toISOString() };
109
+ const destination = path.join(dir, id + ".json");
110
+ const temporary = path.join(dir, "." + id + "." + randomUUID() + ".tmp");
111
+ try {
112
+ await writeFile(temporary, JSON.stringify(revoked, null, 2) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
113
+ await rename(temporary, destination);
114
+ }
115
+ catch (error) {
116
+ await rm(temporary, { force: true }).catch(() => undefined);
117
+ // Keep the marker: a failed revocation fails closed rather than reopening approval.
118
+ throw error;
119
+ }
120
+ return revoked;
121
+ }
122
+ /** Atomically consumes an approval. The exclusive marker makes concurrent consumers fail closed. */
123
+ export async function consumePatchApproval(root, id) {
124
+ const verified = await verifyPatchApproval(root, id);
125
+ if (!verified.valid)
126
+ throw new Error("Patch approval cannot be consumed: " + verified.reason);
127
+ const approval = await loadPatchApproval(root, id);
128
+ const dir = await safeApprovalDirectory(root);
129
+ const marker = path.join(dir, id + ".used");
130
+ try {
131
+ await mkdir(marker, { mode: 0o700 });
132
+ }
133
+ catch (error) {
134
+ if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
135
+ throw new Error("Patch approval has already been used or claimed by another operation.");
136
+ }
137
+ throw error;
138
+ }
139
+ const consumed = { ...approval, usedAt: new Date().toISOString() };
140
+ const destination = path.join(dir, id + ".json");
141
+ const temporary = path.join(dir, "." + id + "." + randomUUID() + ".tmp");
142
+ try {
143
+ await writeFile(temporary, JSON.stringify(consumed, null, 2) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
144
+ await rename(temporary, destination);
145
+ }
146
+ catch (error) {
147
+ await rm(temporary, { force: true }).catch(() => undefined);
148
+ // Keep the marker: a partially completed consume must fail closed.
149
+ throw error;
150
+ }
151
+ return consumed;
152
+ }
153
+ export async function verifyPatchApproval(root, id) {
154
+ const approval = await loadPatchApproval(root, id);
155
+ if (approval.revokedAt)
156
+ return { valid: false, reason: "Approval has been revoked; request a new approval." };
157
+ if (approval.usedAt)
158
+ return { valid: false, reason: "Approval has already been used; request a new approval." };
159
+ try {
160
+ await lstat(path.join(await safeApprovalDirectory(root), id + ".used"));
161
+ return { valid: false, reason: "Approval is already claimed or its state transition did not complete; request a new approval." };
162
+ }
163
+ catch (error) {
164
+ if (!error || typeof error !== "object" || !("code" in error) || error.code !== "ENOENT")
165
+ throw error;
166
+ }
167
+ if (Date.now() >= Date.parse(approval.expiresAt))
168
+ return { valid: false, reason: "Approval has expired; request a new review." };
169
+ const review = await loadReview(root, approval.reviewId);
170
+ const suggestion = review.ai?.suggestions[approval.suggestionNumber - 1];
171
+ if (!suggestion?.patch || suggestion.file !== approval.file || digest(suggestion.patch) !== approval.patchSha256)
172
+ return { valid: false, reason: "The saved patch or target file differs from the approved patch." };
173
+ const validation = await validateReviewPatch(root, review, approval.suggestionNumber);
174
+ if (validation.status !== "applicable")
175
+ return { valid: false, reason: "Patch is no longer applicable: " + validation.reason };
176
+ const source = await readFile(path.resolve(root, approval.file), "utf8");
177
+ if (digest(source) !== approval.sourceSha256)
178
+ return { valid: false, reason: "The target file changed after approval; request a fresh review and approval." };
179
+ return { valid: true, reason: "Approval is current and bound to the exact patch and source-file contents. No files were modified." };
180
+ }
181
+ //# sourceMappingURL=patch-approval.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"patch-approval.js","sourceRoot":"","sources":["../../src/core/patch-approval.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { ReviewRecord } from "./review-history.js";
2
+ export type PatchValidationStatus = "applicable" | "stale" | "invalid";
3
+ export interface PatchValidationReport {
4
+ reviewId: string;
5
+ suggestionNumber: number;
6
+ file: string;
7
+ status: PatchValidationStatus;
8
+ hunks: number;
9
+ reason: string;
10
+ }
11
+ export declare function validateReviewPatch(root: string, record: ReviewRecord, suggestionNumber: number): Promise<PatchValidationReport>;
12
+ export declare function formatPatchValidation(report: PatchValidationReport): string;
@@ -0,0 +1,112 @@
1
+ import { lstat, readFile, realpath } from "node:fs/promises";
2
+ import path from "node:path";
3
+ function parsePatch(patch, file) {
4
+ const normalized = file.replace(/\\/g, "/");
5
+ const lines = patch.replace(/\r\n/g, "\n").split("\n");
6
+ if (lines[0] !== `--- a/${normalized}` || lines[1] !== `+++ b/${normalized}`)
7
+ return { hunks: [], reason: "Patch must target exactly the reviewed file using matching a/ and b/ headers." };
8
+ if (lines.some((line, index) => index > 1 && (line.startsWith("--- ") || line.startsWith("+++ "))))
9
+ return { hunks: [], reason: "Multi-file patches are not supported." };
10
+ const hunks = [];
11
+ let current;
12
+ for (const line of lines.slice(2)) {
13
+ if (!line) {
14
+ if (current)
15
+ continue;
16
+ continue;
17
+ }
18
+ const match = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@(?:.*)$/.exec(line);
19
+ if (match) {
20
+ current = { oldStart: Number(match[1]), oldCount: match[2] === undefined ? 1 : Number(match[2]), newCount: match[4] === undefined ? 1 : Number(match[4]), lines: [] };
21
+ hunks.push(current);
22
+ continue;
23
+ }
24
+ if (!current)
25
+ return { hunks: [], reason: "Unexpected content outside a unified-diff hunk." };
26
+ if (line.startsWith("\"))
27
+ continue;
28
+ if (![" ", "+", "-"].includes(line[0] ?? ""))
29
+ return { hunks: [], reason: "Unsupported unified-diff line; expected context, addition, or deletion." };
30
+ current.lines.push(line);
31
+ }
32
+ if (!hunks.length)
33
+ return { hunks: [], reason: "No unified-diff hunks were supplied." };
34
+ for (const hunk of hunks) {
35
+ const old = hunk.lines.filter(x => x[0] !== "+").length;
36
+ const added = hunk.lines.filter(x => x[0] !== "-").length;
37
+ if (old !== hunk.oldCount || added !== hunk.newCount)
38
+ return { hunks, reason: "A hunk's declared line counts do not match its contents." };
39
+ }
40
+ return { hunks };
41
+ }
42
+ export async function validateReviewPatch(root, record, suggestionNumber) {
43
+ const base = { reviewId: record.id, suggestionNumber, file: "", status: "invalid", hunks: 0 };
44
+ if (!Number.isInteger(suggestionNumber) || suggestionNumber < 1)
45
+ return { ...base, reason: "Suggestion number must be a positive, one-based integer." };
46
+ const suggestion = record.ai?.suggestions[suggestionNumber - 1];
47
+ if (!suggestion)
48
+ return { ...base, reason: "That AI suggestion does not exist in this saved review." };
49
+ const file = suggestion.file;
50
+ const project = path.resolve(root);
51
+ const resolved = path.resolve(project, file);
52
+ if (!resolved.startsWith(project + path.sep))
53
+ return { ...base, file, reason: "Target path escapes the project directory." };
54
+ if (!suggestion.patch)
55
+ return { ...base, file, reason: "This suggestion has no validated patch proposal." };
56
+ const parsed = parsePatch(suggestion.patch, file);
57
+ if (parsed.reason)
58
+ return { ...base, file, hunks: parsed.hunks.length, reason: parsed.reason };
59
+ let source;
60
+ try {
61
+ const realProject = await realpath(project);
62
+ const relative = path.relative(project, resolved);
63
+ const segments = relative.split(path.sep);
64
+ let cursor = project;
65
+ for (let index = 0; index < segments.length; index++) {
66
+ cursor = path.join(cursor, segments[index]);
67
+ const segmentInfo = await lstat(cursor);
68
+ if (segmentInfo.isSymbolicLink())
69
+ return { ...base, file, hunks: parsed.hunks.length, reason: "Patch target path contains a symbolic link; symlinked files and parent directories are not allowed." };
70
+ if (index < segments.length - 1 && !segmentInfo.isDirectory())
71
+ return { ...base, file, hunks: parsed.hunks.length, status: "stale", reason: "A parent directory in the patch path is missing or is not a directory." };
72
+ if (index === segments.length - 1 && !segmentInfo.isFile())
73
+ return { ...base, file, hunks: parsed.hunks.length, reason: "Patch target must be a regular file, not a special file." };
74
+ }
75
+ const info = await lstat(resolved);
76
+ if (info.isSymbolicLink() || !info.isFile())
77
+ return { ...base, file, hunks: parsed.hunks.length, reason: "Patch target must be a regular file, not a symbolic link or special file." };
78
+ const realTarget = await realpath(resolved);
79
+ if (!realTarget.startsWith(realProject + path.sep))
80
+ return { ...base, file, hunks: parsed.hunks.length, reason: "Resolved patch target escapes the real project directory." };
81
+ source = await readFile(realTarget, "utf8");
82
+ }
83
+ catch (error) {
84
+ const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
85
+ if (code === "ENOENT" || code === "ENOTDIR")
86
+ return { ...base, file, hunks: parsed.hunks.length, status: "stale", reason: "Target file or one of its parent directories is missing; regenerate the review against the current workspace." };
87
+ return { ...base, file, hunks: parsed.hunks.length, reason: "Target file could not be safely inspected; no patch may be applied." };
88
+ }
89
+ const sourceLines = source.split(/\r?\n/);
90
+ let previousEnd = 0;
91
+ for (const hunk of parsed.hunks) {
92
+ const start = hunk.oldStart === 0 ? 0 : hunk.oldStart - 1;
93
+ if (start < previousEnd || start > sourceLines.length)
94
+ return { ...base, file, hunks: parsed.hunks.length, status: "stale", reason: "Hunk positions overlap or fall outside the current file." };
95
+ let cursor = start;
96
+ for (const line of hunk.lines) {
97
+ const marker = line[0];
98
+ const text = line.slice(1);
99
+ if (marker === " " || marker === "-") {
100
+ if (sourceLines[cursor] !== text)
101
+ return { ...base, file, hunks: parsed.hunks.length, status: "stale", reason: `Source context no longer matches near line ${cursor + 1}; regenerate the review against the current workspace.` };
102
+ cursor++;
103
+ }
104
+ }
105
+ previousEnd = cursor;
106
+ }
107
+ return { ...base, file, status: "applicable", hunks: parsed.hunks.length, reason: "All patch hunks match the current file. This is a dry-run validation only; no files were changed." };
108
+ }
109
+ export function formatPatchValidation(report) {
110
+ return ["# FORGE Patch Validation", "- Review: " + report.reviewId, "- Suggestion: " + report.suggestionNumber, "- File: " + (report.file || "(unknown)"), "- Status: " + report.status.toUpperCase(), "- Hunks: " + report.hunks, "", "## Result", report.reason, "", "No source files were modified."].join("\n");
111
+ }
112
+ //# sourceMappingURL=patch-validation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"patch-validation.js","sourceRoot":"","sources":["../../src/core/patch-validation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ export interface ForgePermissionPolicy {
2
+ version: 1;
3
+ mode: "proposal-only" | "restricted";
4
+ allowedTools: string[];
5
+ }
6
+ export declare const DEFAULT_PERMISSION_POLICY: ForgePermissionPolicy;
7
+ export declare function validatePermissionPolicy(value: unknown): ForgePermissionPolicy;
8
+ /** Loads declarative policy. Missing files resolve to the safe proposal-only default. */
9
+ export declare function loadPermissionPolicy(projectPath: string): Promise<ForgePermissionPolicy>;
10
+ /** Fail closed until a concrete, audited tool executor is registered. */
11
+ export declare function assertProposalOnlyPolicy(policy: ForgePermissionPolicy, context?: string): void;
12
+ /** Allows only the audited read-only workspace tools for native OpenAI tool calling. */
13
+ export declare function assertSupportedAgentPolicy(policy: ForgePermissionPolicy, provider: string, context?: string): void;
@@ -0,0 +1,98 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, open, realpath } from "node:fs/promises";
3
+ import path from "node:path";
4
+ export const DEFAULT_PERMISSION_POLICY = {
5
+ version: 1,
6
+ mode: "proposal-only",
7
+ allowedTools: [],
8
+ };
9
+ export function validatePermissionPolicy(value) {
10
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
11
+ throw new Error("Permission policy must be a JSON object.");
12
+ }
13
+ const item = value;
14
+ if (item.version !== 1)
15
+ throw new Error("Permission policy version must be 1.");
16
+ if (item.mode !== "proposal-only" && item.mode !== "restricted") {
17
+ throw new Error("Permission policy mode must be proposal-only or restricted.");
18
+ }
19
+ if (!Array.isArray(item.allowedTools) || item.allowedTools.length > 32 ||
20
+ item.allowedTools.some(tool => typeof tool !== "string" || !/^[a-z][a-z0-9-]{0,63}$/.test(tool))) {
21
+ throw new Error("Permission policy allowedTools must be an array of at most 32 valid tool IDs.");
22
+ }
23
+ const keys = Object.keys(item);
24
+ if (keys.some(key => !["version", "mode", "allowedTools"].includes(key))) {
25
+ throw new Error("Permission policy contains unsupported fields.");
26
+ }
27
+ return { version: 1, mode: item.mode, allowedTools: [...new Set(item.allowedTools)] };
28
+ }
29
+ function isMissing(error) {
30
+ return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
31
+ }
32
+ /** Loads declarative policy. Missing files resolve to the safe proposal-only default. */
33
+ export async function loadPermissionPolicy(projectPath) {
34
+ const root = await realpath(path.resolve(projectPath));
35
+ const directory = path.join(root, ".forge");
36
+ const file = path.join(directory, "permissions.json");
37
+ try {
38
+ const directoryInfo = await lstat(directory);
39
+ if (directoryInfo.isSymbolicLink() || !directoryInfo.isDirectory()) {
40
+ throw new Error("The .forge policy directory must be a real directory inside the project.");
41
+ }
42
+ const fileInfo = await lstat(file).catch(() => null);
43
+ if (fileInfo && (fileInfo.isSymbolicLink() || !fileInfo.isFile())) {
44
+ throw new Error("The .forge/permissions.json policy file must be a regular file, not a symbolic link.");
45
+ }
46
+ // Bound policy parsing and reject a final-component symlink swap at open time.
47
+ let handle;
48
+ try {
49
+ handle = await open(file, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
50
+ }
51
+ catch (error) {
52
+ if (error && typeof error === "object" && "code" in error && error.code === "ELOOP") {
53
+ throw new Error("The .forge/permissions.json policy file must be a regular file, not a symbolic link.");
54
+ }
55
+ throw error;
56
+ }
57
+ try {
58
+ const info = await handle.stat();
59
+ if (!info.isFile()) {
60
+ throw new Error("The .forge/permissions.json policy file must be a regular file, not a symbolic link.");
61
+ }
62
+ if (info.size > 16 * 1024) {
63
+ throw new Error("The .forge/permissions.json policy file exceeds the 16 KiB limit.");
64
+ }
65
+ const actualFile = await realpath(file);
66
+ const relative = path.relative(root, actualFile);
67
+ if (relative.startsWith(".." + path.sep) || relative === ".." || path.isAbsolute(relative)) {
68
+ throw new Error("The permission policy file must stay inside the project.");
69
+ }
70
+ return validatePermissionPolicy(JSON.parse(await handle.readFile({ encoding: "utf8" })));
71
+ }
72
+ finally {
73
+ await handle.close();
74
+ }
75
+ }
76
+ catch (error) {
77
+ if (isMissing(error))
78
+ return { ...DEFAULT_PERMISSION_POLICY, allowedTools: [] };
79
+ throw error;
80
+ }
81
+ }
82
+ /** Fail closed until a concrete, audited tool executor is registered. */
83
+ export function assertProposalOnlyPolicy(policy, context = "FORGE run") {
84
+ if (policy.mode !== "proposal-only" || policy.allowedTools.length !== 0) {
85
+ throw new Error(`${context} cannot execute with the configured permission policy. This FORGE build supports proposal-only agents and has no registered tool executor; set mode to "proposal-only" and allowedTools to [].`);
86
+ }
87
+ }
88
+ /** Allows only the audited read-only workspace tools for native OpenAI tool calling. */
89
+ export function assertSupportedAgentPolicy(policy, provider, context = "FORGE run") {
90
+ if (policy.mode === "proposal-only" && policy.allowedTools.length === 0)
91
+ return;
92
+ const supported = new Set(["list-files", "read-file", "search-code"]);
93
+ if (policy.mode !== "restricted" || provider !== "openai" || policy.allowedTools.length === 0 ||
94
+ policy.allowedTools.some(tool => !supported.has(tool))) {
95
+ throw new Error(`${context} cannot execute with this permission policy. Restricted tool execution currently supports only OpenAI with the audited read-only tools: list-files, read-file, search-code.`);
96
+ }
97
+ }
98
+ //# sourceMappingURL=permission-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permission-policy.js","sourceRoot":"","sources":["../../src/core/permission-policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ import { type FindingSeverity } from "./quality-audit.js";
2
+ export interface HealthSnapshot {
3
+ id: string;
4
+ generatedAt: string;
5
+ engineeringScore: {
6
+ score: number;
7
+ grade: "A" | "B" | "C" | "D" | "F";
8
+ confidencePercent: number;
9
+ dimensions: Array<{
10
+ id: string;
11
+ label: string;
12
+ weight: number;
13
+ score: number | null;
14
+ available: boolean;
15
+ reason: string;
16
+ }>;
17
+ };
18
+ dependencySecurity: {
19
+ assessed: boolean;
20
+ vulnerabilities: number;
21
+ critical: number;
22
+ high: number;
23
+ moderate: number;
24
+ low: number;
25
+ vulnerablePackages: number;
26
+ unknownLicenses: number;
27
+ copyleftLicenses: number;
28
+ };
29
+ quality: {
30
+ score: number;
31
+ grade: string;
32
+ findings: number;
33
+ bySeverity: Record<FindingSeverity, number>;
34
+ };
35
+ verification: {
36
+ total: number;
37
+ passed: number;
38
+ failed: number;
39
+ timedOut: number;
40
+ spawnErrors: number;
41
+ successRate: number | null;
42
+ recent: Array<{
43
+ script: string;
44
+ status: string;
45
+ durationMs: number;
46
+ startedAt: string;
47
+ }>;
48
+ };
49
+ project: {
50
+ files: number;
51
+ directories: number;
52
+ languages: Array<{
53
+ name: string;
54
+ files: number;
55
+ }>;
56
+ };
57
+ architecture: {
58
+ nodes: number;
59
+ edges: number;
60
+ entryPoints: number;
61
+ externalPackages: number;
62
+ };
63
+ }
64
+ export interface ProjectHealthReport {
65
+ root: string;
66
+ generatedAt: string;
67
+ current: HealthSnapshot;
68
+ history: HealthSnapshot[];
69
+ notes: string[];
70
+ }
71
+ export declare function generateProjectHealth(inputPath: string): Promise<ProjectHealthReport>;
72
+ export declare function formatProjectHealthMarkdown(report: ProjectHealthReport): string;
@@ -0,0 +1,79 @@
1
+ import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { inspectProject } from "./project-inspector.js";
4
+ import { mapArchitecture } from "./architecture-map.js";
5
+ import { auditProject } from "./quality-audit.js";
6
+ import { listVerifications } from "./verification-history.js";
7
+ import { analyzeDependencies } from "./dependency-intelligence.js";
8
+ const HISTORY_DIR = path.join(".forge", "health");
9
+ const MAX_SNAPSHOTS = 100;
10
+ async function loadSnapshots(root) {
11
+ const dir = path.join(path.resolve(root), HISTORY_DIR);
12
+ let names;
13
+ try {
14
+ names = await readdir(dir);
15
+ }
16
+ catch (error) {
17
+ if (error.code === "ENOENT")
18
+ return [];
19
+ throw error;
20
+ }
21
+ const records = [];
22
+ for (const name of names.filter(n => /^health-[a-z0-9-]+\.json$/.test(n))) {
23
+ try {
24
+ const item = JSON.parse(await readFile(path.join(dir, name), "utf8"));
25
+ if (isSnapshot(item))
26
+ records.push(item);
27
+ }
28
+ catch { /* Ignore malformed local history. */ }
29
+ }
30
+ return records.sort((a, b) => a.generatedAt.localeCompare(b.generatedAt)).slice(-MAX_SNAPSHOTS);
31
+ }
32
+ function isSnapshot(value) {
33
+ if (!value || typeof value !== "object")
34
+ return false;
35
+ const v = value;
36
+ return typeof v.id === "string" && typeof v.generatedAt === "string" && typeof v.quality?.score === "number" && typeof v.verification?.total === "number" && typeof v.project?.files === "number" && typeof v.architecture?.nodes === "number";
37
+ }
38
+ export async function generateProjectHealth(inputPath) {
39
+ const root = path.resolve(inputPath);
40
+ const [project, audit, verification, architecture, dependencies] = await Promise.all([inspectProject(root), auditProject(root), listVerifications(root, 500), mapArchitecture(root), analyzeDependencies(root)]);
41
+ const bySeverity = { critical: 0, high: 0, medium: 0, low: 0, info: 0 };
42
+ for (const finding of audit.findings)
43
+ bySeverity[finding.severity]++;
44
+ const passed = verification.filter(v => v.status === "passed").length;
45
+ const completed = verification.filter(v => v.status === "passed" || v.status === "failed").length;
46
+ const verificationScore = verification.length ? Math.max(0, Math.round((completed ? passed / completed * 100 : 0) - Math.min(40, verification.filter(v => v.status === "timed_out").length * 10 + verification.filter(v => v.status === "spawn_error").length * 15))) : null;
47
+ const securityAssessed = dependencies.sources.vulnerabilityReport !== null;
48
+ const securityPenalty = dependencies.summary.critical * 35 + dependencies.summary.high * 20 + dependencies.summary.moderate * 8 + dependencies.summary.low * 2;
49
+ const securityScore = securityAssessed ? Math.max(0, 100 - securityPenalty) : null;
50
+ const dimensions = [
51
+ { id: "quality", label: "Static quality", weight: 50, score: audit.score, available: true, reason: "Evidence-based static project audit." },
52
+ { id: "verification", label: "Verification reliability", weight: 25, score: verificationScore, available: verificationScore !== null, reason: verificationScore === null ? "No verification history is recorded." : "Based on saved verification outcomes; timeouts and spawn errors reduce the score." },
53
+ { id: "dependency-security", label: "Dependency security", weight: 25, score: securityScore, available: securityScore !== null, reason: securityScore === null ? "Not assessed: provide npm-audit.json or run npm audit --json > npm-audit.json." : "Based on imported npm audit JSON findings; no live registry scan is performed." }
54
+ ];
55
+ const availableWeight = dimensions.filter(item => item.available).reduce((sum, item) => sum + item.weight, 0);
56
+ const score = availableWeight ? Math.round(dimensions.reduce((sum, item) => sum + (item.available ? (item.score ?? 0) * item.weight : 0), 0) / availableWeight) : 0;
57
+ const grade = score >= 90 ? "A" : score >= 80 ? "B" : score >= 70 ? "C" : score >= 60 ? "D" : "F";
58
+ const now = new Date();
59
+ const current = {
60
+ id: "health-" + now.getTime().toString(36) + "-" + Math.random().toString(36).slice(2, 7), generatedAt: now.toISOString(),
61
+ engineeringScore: { score, grade, confidencePercent: availableWeight, dimensions },
62
+ dependencySecurity: { assessed: securityAssessed, vulnerabilities: dependencies.summary.vulnerabilities, critical: dependencies.summary.critical, high: dependencies.summary.high, moderate: dependencies.summary.moderate, low: dependencies.summary.low, vulnerablePackages: dependencies.summary.vulnerablePackages, unknownLicenses: dependencies.summary.unknownLicenses, copyleftLicenses: dependencies.summary.copyleftLicenses },
63
+ quality: { score: audit.score, grade: audit.grade, findings: audit.findings.length, bySeverity },
64
+ verification: { total: verification.length, passed, failed: verification.filter(v => v.status === "failed").length, timedOut: verification.filter(v => v.status === "timed_out").length, spawnErrors: verification.filter(v => v.status === "spawn_error").length, successRate: completed ? Math.round(passed / completed * 100) : null, recent: verification.slice(0, 12).map(v => ({ script: v.script, status: v.status, durationMs: v.durationMs, startedAt: v.startedAt })) },
65
+ project: { files: project.summary.filesScanned, directories: project.summary.directoriesScanned, languages: project.summary.languages.slice(0, 12) },
66
+ architecture: { nodes: architecture.nodes.length, edges: architecture.edges.length, entryPoints: architecture.entryPoints.length, externalPackages: architecture.externalPackages.length }
67
+ };
68
+ const dir = path.join(root, HISTORY_DIR);
69
+ await mkdir(dir, { recursive: true });
70
+ await writeFile(path.join(dir, current.id + ".json"), JSON.stringify(current, null, 2) + "\n", { flag: "wx", mode: 0o600 });
71
+ const history = await loadSnapshots(root);
72
+ return { root, generatedAt: current.generatedAt, current, history, notes: ["Quality snapshots are recorded when this health report is requested; they are not continuous background monitoring.", "Verification success rate counts passed and failed runs only; timed-out and spawn-error runs are excluded from the denominator.", "The unified engineering score is a weighted, partial-coverage heuristic, not a certification. Its confidence percentage is the total weight of dimensions with available evidence.", "Dependency security is assessed only when a local npm audit JSON report is present; no registry scan is performed. Architecture metrics are informational and are not used as a proxy for code quality."] };
73
+ }
74
+ export function formatProjectHealthMarkdown(report) {
75
+ const c = report.current;
76
+ const lines = ["# FORGE Project Health Report", "", "- Project: `" + report.root + "`", "- Generated: " + report.generatedAt, "", "## Current health", "", "- Unified engineering score: **" + c.engineeringScore.score + "/100 (" + c.engineeringScore.grade + ")** — evidence coverage " + c.engineeringScore.confidencePercent + "%", "- Quality score: **" + c.quality.score + "/100 (" + c.quality.grade + ")**", "- Findings: " + c.quality.findings, "- Verification runs: " + c.verification.total, "- Verification success rate: " + (c.verification.successRate === null ? "Not available" : c.verification.successRate + "%"), "- Source files: " + c.project.files, "- Directories: " + c.project.directories, "- Architecture: " + c.architecture.nodes + " modules, " + c.architecture.edges + " detected imports", "", "## Score dimensions", ...c.engineeringScore.dimensions.map(item => "- " + item.label + ": " + (item.score === null ? "Not assessed" : item.score + "/100") + " (weight " + item.weight + "%, " + (item.available ? "included" : "excluded") + ") — " + item.reason), "", "## Dependency security", "- Assessment: " + (c.dependencySecurity.assessed ? "imported npm audit report" : "NOT ASSESSED"), "- Findings: " + c.dependencySecurity.vulnerabilities + " total; critical " + c.dependencySecurity.critical + ", high " + c.dependencySecurity.high + ", moderate " + c.dependencySecurity.moderate + ", low " + c.dependencySecurity.low, "", "## Quality findings by severity", ...Object.entries(c.quality.bySeverity).map(([key, value]) => "- " + key + ": " + value), "", "## Language composition", ...(c.project.languages.length ? c.project.languages.map(item => "- " + item.name + ": " + item.files) : ["- No languages detected."]), "", "## Recent verification runs", ...(c.verification.recent.length ? c.verification.recent.map(item => "- " + item.startedAt + " — " + item.script + " — " + item.status + " — " + item.durationMs + " ms") : ["- No verification runs recorded."]), "", "## Quality score history", ...(report.history.length ? report.history.map(item => "- " + item.generatedAt + " — " + item.quality.score + "/100 (" + item.quality.grade + ")") : ["- No previous snapshots."]), "", "## Interpretation and limitations", ...report.notes.map(note => "- " + note), ""];
77
+ return lines.join("\n");
78
+ }
79
+ //# sourceMappingURL=project-health.js.map