anvil-engineering-workbench 0.0.0-stage → 1.0.1

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,173 @@
1
+ import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
2
+ import { randomUUID } from "node:crypto";
3
+ import path from "node:path";
4
+ const MAX_ENTRIES = 500;
5
+ const MAX_FILE_BYTES = 2 * 1024 * 1024;
6
+ const MEMORY_KINDS = new Set(["decision", "architecture", "constraint", "preference", "fact"]);
7
+ const MAX_CONTENT_LENGTH = 4000;
8
+ const SECRET_PATTERN = /(?:api[_-]?key|secret|password|access[_-]?token)\s*[:=]\s*\S+/i;
9
+ function memoryPath(projectPath) {
10
+ return path.join(path.resolve(projectPath), ".forge", "memory.json");
11
+ }
12
+ async function readDocument(projectPath) {
13
+ try {
14
+ const raw = await readFile(memoryPath(projectPath));
15
+ if (raw.byteLength > MAX_FILE_BYTES)
16
+ throw new Error("Project memory file exceeds the 2 MiB safety limit.");
17
+ const parsed = JSON.parse(raw.toString("utf8"));
18
+ if (!parsed || typeof parsed !== "object" || !("version" in parsed) || parsed.version !== 1 || !("entries" in parsed) || !Array.isArray(parsed.entries)) {
19
+ throw new Error("Project memory file has an unsupported format.");
20
+ }
21
+ if (parsed.entries.length > MAX_ENTRIES)
22
+ throw new Error("Project memory file exceeds the entry limit.");
23
+ const ids = new Set();
24
+ for (const value of parsed.entries) {
25
+ if (!value || typeof value !== "object")
26
+ throw new Error("Project memory contains an invalid entry.");
27
+ const entry = value;
28
+ if (typeof entry.id !== "string" || !/^mem-[a-z0-9-]{1,80}$/.test(entry.id) || ids.has(entry.id) ||
29
+ typeof entry.kind !== "string" || !MEMORY_KINDS.has(entry.kind) ||
30
+ typeof entry.content !== "string" || !entry.content.trim() || entry.content.length > MAX_CONTENT_LENGTH ||
31
+ !Array.isArray(entry.tags) || entry.tags.length > 12 ||
32
+ !entry.tags.every(tag => typeof tag === "string" && tag.length > 0 && tag.length <= 64) ||
33
+ typeof entry.createdAt !== "string" || !Number.isFinite(Date.parse(entry.createdAt)) ||
34
+ typeof entry.updatedAt !== "string" || !Number.isFinite(Date.parse(entry.updatedAt))) {
35
+ throw new Error("Project memory contains an invalid entry.");
36
+ }
37
+ ids.add(entry.id);
38
+ }
39
+ return parsed;
40
+ }
41
+ catch (error) {
42
+ if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
43
+ return { version: 1, entries: [] };
44
+ }
45
+ throw error;
46
+ }
47
+ }
48
+ async function withMemoryWriteLock(projectPath, action) {
49
+ const directory = path.dirname(memoryPath(projectPath));
50
+ await mkdir(directory, { recursive: true });
51
+ const lock = path.join(directory, ".memory-write.lock");
52
+ const token = randomUUID();
53
+ try {
54
+ await mkdir(lock, { mode: 0o700 });
55
+ }
56
+ catch (error) {
57
+ if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
58
+ throw new Error("Project memory is being changed by another or interrupted FORGE process. Inspect .forge/.memory-write.lock before manual recovery.");
59
+ }
60
+ throw error;
61
+ }
62
+ try {
63
+ await writeFile(path.join(lock, "owner.json"), JSON.stringify({
64
+ token, pid: process.pid, startedAt: new Date().toISOString(),
65
+ }) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
66
+ return await action();
67
+ }
68
+ finally {
69
+ try {
70
+ const owner = JSON.parse(await readFile(path.join(lock, "owner.json"), "utf8"));
71
+ if (owner && typeof owner === "object" && "token" in owner && owner.token === token) {
72
+ await rm(lock, { recursive: true, force: true });
73
+ }
74
+ }
75
+ catch {
76
+ // Leave an unverifiable lock in place; manual inspection is safer than deleting another owner's lock.
77
+ }
78
+ }
79
+ }
80
+ async function writeDocument(projectPath, document) {
81
+ const destination = memoryPath(projectPath);
82
+ const directory = path.dirname(destination);
83
+ await mkdir(directory, { recursive: true });
84
+ const temporary = path.join(directory, ".memory-" + randomUUID() + ".tmp");
85
+ try {
86
+ await writeFile(temporary, JSON.stringify(document, null, 2) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
87
+ await rename(temporary, destination);
88
+ }
89
+ catch (error) {
90
+ await rm(temporary, { force: true }).catch(() => undefined);
91
+ throw error;
92
+ }
93
+ }
94
+ function validateContent(content) {
95
+ const value = content.trim();
96
+ if (!value)
97
+ throw new Error("Memory content cannot be empty.");
98
+ if (value.length > MAX_CONTENT_LENGTH)
99
+ throw new Error(`Memory content must be at most ${MAX_CONTENT_LENGTH} characters.`);
100
+ if (SECRET_PATTERN.test(value))
101
+ throw new Error("Memory appears to contain a credential. Store a reference to a secret name, never the secret value.");
102
+ return value;
103
+ }
104
+ export async function addProjectMemory(projectPath, input) {
105
+ if (!input || !MEMORY_KINDS.has(input.kind))
106
+ throw new Error("Memory kind is not supported.");
107
+ if (input.tags !== undefined && (!Array.isArray(input.tags) || input.tags.some(tag => typeof tag !== "string" || tag.trim().length > 64))) {
108
+ throw new Error("Memory tags must be strings of at most 64 characters.");
109
+ }
110
+ const content = validateContent(input.content);
111
+ return withMemoryWriteLock(projectPath, async () => {
112
+ const document = await readDocument(projectPath);
113
+ if (document.entries.length >= MAX_ENTRIES)
114
+ throw new Error(`Project memory is limited to ${MAX_ENTRIES} entries. Remove old entries first.`);
115
+ const now = new Date().toISOString();
116
+ const entry = {
117
+ id: "mem-" + randomUUID(),
118
+ kind: input.kind,
119
+ content,
120
+ tags: [...new Set((input.tags ?? []).map(tag => tag.trim().toLowerCase()).filter(Boolean))].slice(0, 12),
121
+ createdAt: now,
122
+ updatedAt: now,
123
+ };
124
+ document.entries.push(entry);
125
+ await writeDocument(projectPath, document);
126
+ return entry;
127
+ });
128
+ }
129
+ export async function listProjectMemory(projectPath) {
130
+ const document = await readDocument(projectPath);
131
+ return [...document.entries].sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
132
+ }
133
+ export async function removeProjectMemory(projectPath, id) {
134
+ return withMemoryWriteLock(projectPath, async () => {
135
+ const document = await readDocument(projectPath);
136
+ const remaining = document.entries.filter(entry => entry.id !== id);
137
+ if (remaining.length === document.entries.length)
138
+ return false;
139
+ document.entries = remaining;
140
+ await writeDocument(projectPath, document);
141
+ return true;
142
+ });
143
+ }
144
+ /** Select relevant notes with a conservative character budget (~4 chars/token). */
145
+ export async function buildProjectMemoryContext(projectPath, query, maxTokens = 1800) {
146
+ const safeBudget = Math.max(100, Math.min(8000, Math.floor(maxTokens)));
147
+ const terms = new Set(query.toLowerCase().split(/[^a-z0-9_-]+/).filter(term => term.length > 2));
148
+ const entries = await listProjectMemory(projectPath);
149
+ const ranked = entries.map(entry => {
150
+ const haystack = (entry.content + " " + entry.tags.join(" ")).toLowerCase();
151
+ const score = entry.tags.reduce((sum, tag) => sum + (terms.has(tag) ? 4 : 0), 0)
152
+ + [...terms].reduce((sum, term) => sum + (haystack.includes(term) ? 1 : 0), 0);
153
+ return { entry, score };
154
+ }).sort((a, b) => b.score - a.score || b.entry.updatedAt.localeCompare(a.entry.updatedAt));
155
+ const lines = [];
156
+ const includedIds = [];
157
+ let chars = 0;
158
+ for (const { entry } of ranked) {
159
+ const line = `[${entry.kind}] ${entry.content}`;
160
+ const next = chars + line.length + 1;
161
+ if (next > safeBudget * 4)
162
+ continue;
163
+ lines.push(line);
164
+ includedIds.push(entry.id);
165
+ chars = next;
166
+ }
167
+ return {
168
+ text: lines.length ? "Relevant project memory (local notes; verify against current code):\n" + lines.join("\n") : "",
169
+ includedIds,
170
+ estimatedTokens: Math.ceil(chars / 4),
171
+ };
172
+ }
173
+ //# sourceMappingURL=project-memory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-memory.js","sourceRoot":"","sources":["../../src/core/project-memory.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ export type DiagnosableProvider = "openai" | "anthropic" | "google" | "ollama";
2
+ export interface ProviderDiagnostic {
3
+ provider: DiagnosableProvider;
4
+ status: "connected" | "needs-credentials" | "unauthorized" | "unavailable" | "error";
5
+ checkedAt: string;
6
+ durationMs: number;
7
+ model: string;
8
+ modelAvailable: boolean | null;
9
+ modelCount: number | null;
10
+ message: string;
11
+ }
12
+ export declare function diagnoseProvider(provider: DiagnosableProvider, env?: NodeJS.ProcessEnv, fetcher?: typeof fetch): Promise<ProviderDiagnostic>;
@@ -0,0 +1,73 @@
1
+ const defaults = {
2
+ openai: "https://api.openai.com/v1",
3
+ anthropic: "https://api.anthropic.com",
4
+ google: "https://generativelanguage.googleapis.com",
5
+ ollama: "http://localhost:11434",
6
+ };
7
+ function endpointOrigin(value, provider) {
8
+ const url = new URL(value);
9
+ const local = url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1";
10
+ if (url.username || url.password || url.search || url.hash || (url.protocol !== "https:" && !(provider === "ollama" && url.protocol === "http:" && local))) {
11
+ throw new Error("Provider endpoint must use HTTPS (localhost HTTP is allowed for Ollama) and must not contain credentials, query parameters or fragments.");
12
+ }
13
+ return url;
14
+ }
15
+ function modelNames(payload, provider) {
16
+ if (!payload || typeof payload !== "object")
17
+ return [];
18
+ const data = payload;
19
+ if (provider === "ollama") {
20
+ return Array.isArray(data.models) ? data.models.flatMap(item => item && typeof item === "object" && typeof item.name === "string" ? [item.name] : []) : [];
21
+ }
22
+ if (provider === "google") {
23
+ return Array.isArray(data.models) ? data.models.flatMap(item => item && typeof item === "object" && typeof item.name === "string" ? [item.name.replace(/^models\//, "")] : []) : [];
24
+ }
25
+ return Array.isArray(data.data) ? data.data.flatMap(item => item && typeof item === "object" && typeof item.id === "string" ? [item.id] : []) : [];
26
+ }
27
+ export async function diagnoseProvider(provider, env = process.env, fetcher = fetch) {
28
+ const started = Date.now();
29
+ const model = env.FORGE_AI_MODEL || env.FORGE_MODEL || (provider === "openai" ? "gpt-4.1-mini" : provider === "anthropic" ? "claude-sonnet-4-5" : provider === "google" ? "gemini-2.5-flash" : "llama3.2");
30
+ const checkedAt = new Date().toISOString();
31
+ const key = provider === "openai" ? env.FORGE_API_KEY || env.OPENAI_API_KEY : provider === "anthropic" ? env.ANTHROPIC_API_KEY : provider === "google" ? env.GOOGLE_API_KEY : undefined;
32
+ const finish = (status, message, modelAvailable = null, modelCount = null) => ({
33
+ provider, status, checkedAt, durationMs: Date.now() - started, model, modelAvailable, modelCount, message,
34
+ });
35
+ if (provider !== "ollama" && !key?.trim())
36
+ return finish("needs-credentials", "Required API credential is not configured.");
37
+ try {
38
+ const configured = env.FORGE_BASE_URL || (provider === "ollama" ? env.OLLAMA_HOST : undefined) || defaults[provider];
39
+ const base = endpointOrigin(configured, provider).toString().replace(/\/+$/, "");
40
+ let url;
41
+ const headers = {};
42
+ if (provider === "openai") {
43
+ url = base + "/models";
44
+ headers.authorization = "Bearer " + key;
45
+ }
46
+ else if (provider === "anthropic") {
47
+ url = base + "/v1/models";
48
+ headers["x-api-key"] = key;
49
+ headers["anthropic-version"] = "2023-06-01";
50
+ }
51
+ else if (provider === "google") {
52
+ url = base + "/v1beta/models";
53
+ headers["x-goog-api-key"] = key;
54
+ }
55
+ else {
56
+ url = base + "/api/tags";
57
+ }
58
+ const response = await fetcher(url, { method: "GET", headers, signal: AbortSignal.timeout(8000), redirect: "error" });
59
+ if (response.status === 401 || response.status === 403)
60
+ return finish("unauthorized", "Provider rejected the configured credentials.");
61
+ if (!response.ok)
62
+ return finish("unavailable", "Provider returned HTTP " + response.status + ".");
63
+ const payload = await response.json();
64
+ const names = modelNames(payload, provider);
65
+ const available = names.length ? names.some(name => name === model || name.endsWith("/" + model)) : null;
66
+ return finish("connected", available === false ? "Connection succeeded, but the configured model was not found in the model list." : "Provider API responded successfully.", available, names.length);
67
+ }
68
+ catch (error) {
69
+ const timedOut = error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError");
70
+ return finish("error", timedOut ? "Provider check timed out after 8 seconds." : error instanceof Error && error.message.startsWith("Provider endpoint") ? error.message : "Could not reach provider. Check endpoint and network access.");
71
+ }
72
+ }
73
+ //# sourceMappingURL=provider-diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-diagnostics.js","sourceRoot":"","sources":["../../src/core/provider-diagnostics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare const MAX_PROVIDER_RESPONSE_BYTES = 1048576;
2
+ export declare function readProviderJson(response: Response, maxBytes?: number): Promise<unknown>;
3
+ /** Release an unused upstream error body without exposing its contents. */
4
+ export declare function discardProviderResponse(response: Response): Promise<void>;
@@ -0,0 +1,46 @@
1
+ export const MAX_PROVIDER_RESPONSE_BYTES = 1_048_576;
2
+ export async function readProviderJson(response, maxBytes = MAX_PROVIDER_RESPONSE_BYTES) {
3
+ const declaredLength = response.headers.get("content-length");
4
+ if (declaredLength && /^\d+$/.test(declaredLength) && Number(declaredLength) > maxBytes) {
5
+ await response.body?.cancel().catch(() => undefined);
6
+ throw new Error("AI provider response exceeded the 1 MiB size limit.");
7
+ }
8
+ if (!response.body)
9
+ throw new Error("AI provider returned an empty response body.");
10
+ const reader = response.body.getReader();
11
+ const chunks = [];
12
+ let total = 0;
13
+ try {
14
+ while (true) {
15
+ const { done, value } = await reader.read();
16
+ if (done)
17
+ break;
18
+ total += value.byteLength;
19
+ if (total > maxBytes) {
20
+ await reader.cancel().catch(() => undefined);
21
+ throw new Error("AI provider response exceeded the 1 MiB size limit.");
22
+ }
23
+ chunks.push(value);
24
+ }
25
+ }
26
+ finally {
27
+ reader.releaseLock();
28
+ }
29
+ const bytes = new Uint8Array(total);
30
+ let offset = 0;
31
+ for (const chunk of chunks) {
32
+ bytes.set(chunk, offset);
33
+ offset += chunk.byteLength;
34
+ }
35
+ try {
36
+ return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
37
+ }
38
+ catch {
39
+ throw new Error("AI provider returned malformed JSON.");
40
+ }
41
+ }
42
+ /** Release an unused upstream error body without exposing its contents. */
43
+ export async function discardProviderResponse(response) {
44
+ await response.body?.cancel().catch(() => undefined);
45
+ }
46
+ //# sourceMappingURL=provider-response.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-response.js","sourceRoot":"","sources":["../../src/core/provider-response.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAkB,EAAE,QAAQ,GAAG,2BAA2B;IAC/F,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,QAAQ,EAAE,CAAC;QACxF,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1B,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACrB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAY,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,QAAkB;IAC9D,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACvD,CAAC"}
@@ -0,0 +1,29 @@
1
+ export type FindingSeverity = "critical" | "high" | "medium" | "low" | "info";
2
+ export interface QualityFinding {
3
+ id: string;
4
+ severity: FindingSeverity;
5
+ title: string;
6
+ detail: string;
7
+ evidence: string[];
8
+ recommendation: string;
9
+ }
10
+ export interface QualityAudit {
11
+ root: string;
12
+ generatedAt: string;
13
+ score: number;
14
+ grade: "A" | "B" | "C" | "D" | "F";
15
+ coverage: {
16
+ checksPerformed: number;
17
+ checksAvailable: number;
18
+ };
19
+ metrics: {
20
+ manifests: number;
21
+ sourceFiles: number;
22
+ testFiles: number;
23
+ workflowFiles: number;
24
+ };
25
+ findings: QualityFinding[];
26
+ limitations: string[];
27
+ }
28
+ export declare function auditProject(inputPath: string): Promise<QualityAudit>;
29
+ export declare function formatQualityAudit(report: QualityAudit): string;
@@ -0,0 +1,101 @@
1
+ import { readFile, readdir } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { isExcludedScanDirectory } from "./workspace-scan-policy.js";
4
+ const IGNORED = { has: isExcludedScanDirectory };
5
+ const SOURCE = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".rs", ".java", ".cs", ".rb", ".php"]);
6
+ async function collect(root, rel = "", files = []) {
7
+ if (files.length >= 5000)
8
+ return files;
9
+ let entries;
10
+ try {
11
+ entries = await readdir(path.join(root, rel), { withFileTypes: true });
12
+ }
13
+ catch {
14
+ return files;
15
+ }
16
+ for (const entry of entries) {
17
+ if (files.length >= 5000)
18
+ break;
19
+ const child = path.posix.join(rel.split(path.sep).join("/"), entry.name);
20
+ if (entry.isDirectory() && !IGNORED.has(entry.name))
21
+ await collect(root, path.join(rel, entry.name), files);
22
+ else if (entry.isFile())
23
+ files.push(child);
24
+ }
25
+ return files;
26
+ }
27
+ const has = (files, names) => names.some(name => files.has(name));
28
+ export async function auditProject(inputPath) {
29
+ const root = path.resolve(inputPath);
30
+ const paths = await collect(root);
31
+ const files = new Set(paths);
32
+ const findings = [];
33
+ const add = (finding) => findings.push(finding);
34
+ const manifests = ["package.json", "pyproject.toml", "Cargo.toml", "go.mod", "pom.xml", "build.gradle"].filter(name => files.has(name));
35
+ const sourceFiles = paths.filter(file => SOURCE.has(path.extname(file).toLowerCase()));
36
+ const testFiles = paths.filter(file => /(^|\/)(tests?|__tests__|spec)(\/|$)|\.(test|spec)\.[^/]+$/i.test(file));
37
+ const workflowFiles = paths.filter(file => file.startsWith(".github/workflows/") && /\.(yml|yaml)$/.test(file));
38
+ const packageJson = await readJson(path.join(root, "package.json"));
39
+ const scripts = (packageJson?.scripts && typeof packageJson.scripts === "object" ? packageJson.scripts : {});
40
+ const tsconfig = await readJson(path.join(root, "tsconfig.json"));
41
+ const tsStrict = tsconfig?.compilerOptions && typeof tsconfig.compilerOptions === "object"
42
+ ? tsconfig.compilerOptions.strict === true : false;
43
+ if (!has(files, ["README.md", "readme.md"]))
44
+ add({ id: "docs.readme", severity: "medium", title: "README is missing", detail: "No root README was detected.", evidence: ["README.md not found"], recommendation: "Add setup instructions, project purpose, usage examples, and known limitations." });
45
+ if (!has(files, ["LICENSE", "LICENSE.md", "LICENSE.txt"]))
46
+ add({ id: "legal.license", severity: "low", title: "License file is missing", detail: "No common root license file was detected.", evidence: ["LICENSE variants not found"], recommendation: "Choose and include a license that matches the project's distribution goals." });
47
+ if (!has(files, [".gitignore"]))
48
+ add({ id: "repo.gitignore", severity: "low", title: "Git ignore rules are missing", detail: "No root .gitignore was detected.", evidence: [".gitignore not found"], recommendation: "Ignore generated output, local environment files, dependencies, and editor state." });
49
+ if (!workflowFiles.length)
50
+ add({ id: "ci.workflow", severity: "medium", title: "Continuous integration workflow not detected", detail: "No GitHub Actions workflow YAML was found under .github/workflows.", evidence: ["No workflow YAML detected"], recommendation: "Add CI that runs the project's type checks, tests, and build." });
51
+ if (!testFiles.length)
52
+ add({ id: "tests.files", severity: "medium", title: "Test files not detected", detail: "No files or directories matching common test naming conventions were found.", evidence: ["No common test paths detected"], recommendation: "Add focused automated tests for core behavior and important failure cases." });
53
+ if (packageJson) {
54
+ if (!Object.keys(scripts).length)
55
+ add({ id: "node.scripts", severity: "low", title: "Package scripts are missing", detail: "package.json has no scripts object entries.", evidence: ["package.json scripts is empty or absent"], recommendation: "Define documented scripts for development, tests, and production build." });
56
+ if (!packageJson.engines || typeof packageJson.engines !== "object" || !("node" in packageJson.engines))
57
+ add({ id: "node.engine", severity: "low", title: "Node.js engine range is unspecified", detail: "The package does not declare a Node.js compatibility range.", evidence: ["package.json engines.node not found"], recommendation: "Declare and test a supported Node.js version range." });
58
+ if (packageJson.private === true)
59
+ add({ id: "node.private", severity: "info", title: "Package publishing is disabled", detail: "package.json sets private=true.", evidence: ["package.json private=true"], recommendation: "If publishing is intended, review the private setting; otherwise this is informational." });
60
+ }
61
+ if (files.has(".env"))
62
+ add({ id: "secrets.env", severity: "high", title: "Root .env file is present", detail: "A root environment file exists. Its contents were not read.", evidence: [".env file path detected; contents intentionally not inspected"], recommendation: "Ensure local secrets are ignored and never committed. Rotate any credentials accidentally exposed." });
63
+ if (files.has(".env.example"))
64
+ add({ id: "config.env-example", severity: "info", title: "Environment template detected", detail: "A root .env.example file was found.", evidence: [".env.example"], recommendation: "Keep the template limited to placeholder names and non-secret examples." });
65
+ if (files.has("package-lock.json") && files.has("pnpm-lock.yaml") || files.has("package-lock.json") && files.has("yarn.lock") || files.has("pnpm-lock.yaml") && files.has("yarn.lock"))
66
+ add({ id: "deps.lockfiles", severity: "low", title: "Multiple JavaScript lockfiles detected", detail: "More than one npm, pnpm, or Yarn lockfile exists at the root.", evidence: ["Multiple root lockfiles found"], recommendation: "Choose one package manager and keep its lockfile authoritative." });
67
+ if (files.has("tsconfig.json") && !tsStrict)
68
+ add({ id: "typescript.strict", severity: "low", title: "TypeScript strict mode is not confirmed", detail: "tsconfig.json does not explicitly set compilerOptions.strict=true.", evidence: ["compilerOptions.strict is absent or false"], recommendation: "Consider enabling strict type checking and addressing resulting errors." });
69
+ if (!manifests.length)
70
+ add({ id: "project.manifest", severity: "info", title: "Project manifest not detected", detail: "No common root manifest was found.", evidence: ["Common manifest names not found"], recommendation: "Add ecosystem-appropriate metadata if this project uses a supported ecosystem." });
71
+ const weights = { critical: 30, high: 18, medium: 10, low: 4, info: 0 };
72
+ const penalty = findings.reduce((sum, item) => sum + weights[item.severity], 0);
73
+ const score = Math.max(0, 100 - penalty);
74
+ const grade = score >= 90 ? "A" : score >= 80 ? "B" : score >= 65 ? "C" : score >= 50 ? "D" : "F";
75
+ return {
76
+ root, generatedAt: new Date().toISOString(), score, grade,
77
+ coverage: { checksPerformed: 13, checksAvailable: 13 },
78
+ metrics: { manifests: manifests.length, sourceFiles: sourceFiles.length, testFiles: testFiles.length, workflowFiles: workflowFiles.length },
79
+ findings: findings.sort((a, b) => weights[b.severity] - weights[a.severity] || a.id.localeCompare(b.id)),
80
+ limitations: ["Static heuristic checks only; no source code was executed.", "Dependency vulnerabilities, code correctness, runtime behavior, and secret contents were not tested.", "The score is a transparent rule-based indicator, not a certification or security rating.", "Scanning is limited to 5,000 files and common root-level conventions."]
81
+ };
82
+ }
83
+ async function readJson(file) {
84
+ try {
85
+ const value = JSON.parse(await readFile(file, "utf8"));
86
+ return value && typeof value === "object" && !Array.isArray(value) ? value : null;
87
+ }
88
+ catch {
89
+ return null;
90
+ }
91
+ }
92
+ export function formatQualityAudit(report) {
93
+ const lines = [
94
+ "# FORGE Quality Report", "", `- **Project:** \`${report.root}\``, `- **Rule-based score:** \`${report.score}/100 (${report.grade})\``, `- **Checks:** \`${report.coverage.checksPerformed}/${report.coverage.checksAvailable}\``, `- **Generated:** \`${report.generatedAt}\``, "",
95
+ "## Project metrics", `- Manifests: \`${report.metrics.manifests}\``, `- Source files: \`${report.metrics.sourceFiles}\``, `- Test files: \`${report.metrics.testFiles}\``, `- CI workflows: \`${report.metrics.workflowFiles}\``, "",
96
+ "## Findings", ...(report.findings.length ? report.findings.map(item => `### [${item.severity.toUpperCase()}] ${item.title}\n- ${item.detail}\n- Evidence: ${item.evidence.join("; ")}\n- Recommendation: ${item.recommendation}`) : ["No findings from the available static checks."]), "",
97
+ "## Limitations", ...report.limitations.map(item => `- ${item}`), "", "_Generated by FORGE. This is not a security audit or certification._"
98
+ ];
99
+ return lines.join("\n");
100
+ }
101
+ //# sourceMappingURL=quality-audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quality-audit.js","sourceRoot":"","sources":["../../src/core/quality-audit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import type { VerificationResult } from "./verification.js";
2
+ export type RegressionState = "baseline" | "regression" | "recovered" | "persistent_failure" | "stable";
3
+ export interface CheckRegression {
4
+ script: string;
5
+ state: RegressionState;
6
+ latest: VerificationResult;
7
+ previous: VerificationResult | null;
8
+ durationChangeMs: number | null;
9
+ newFailureSignature: boolean | null;
10
+ failureSignature: string | null;
11
+ }
12
+ export interface RegressionReport {
13
+ root: string;
14
+ generatedAt: string;
15
+ base: string;
16
+ checks: CheckRegression[];
17
+ changedFiles: Array<{
18
+ status: string;
19
+ file: string;
20
+ }>;
21
+ affectedModules: Array<{
22
+ file: string;
23
+ affected: string[];
24
+ }>;
25
+ suggestedTests: Array<{
26
+ file: string;
27
+ reason: string;
28
+ }>;
29
+ warnings: string[];
30
+ summary: {
31
+ regressions: number;
32
+ recovered: number;
33
+ persistentFailures: number;
34
+ stable: number;
35
+ baselines: number;
36
+ checksReviewed: number;
37
+ };
38
+ }
39
+ export declare function compareCheckRuns(history: VerificationResult[]): CheckRegression[];
40
+ export declare function generateRegressionReport(inputPath: string, base?: string): Promise<RegressionReport>;
41
+ export declare function formatRegressionReport(report: RegressionReport): string;
@@ -0,0 +1,56 @@
1
+ import path from "node:path";
2
+ import { listVerifications } from "./verification-history.js";
3
+ import { analyzeGitChanges } from "./git-intelligence.js";
4
+ function failureSignature(output) {
5
+ const line = output.split(/\r?\n/).map(x => x.trim()).find(x => /(error|failed|failure|exception|not found|cannot find)/i.test(x));
6
+ return line ? line.replace(/\s+/g, " ").slice(0, 180).toLowerCase() : null;
7
+ }
8
+ export function compareCheckRuns(history) {
9
+ const groups = new Map();
10
+ for (const item of [...history].sort((a, b) => b.startedAt.localeCompare(a.startedAt))) {
11
+ const group = groups.get(item.script) ?? [];
12
+ group.push(item);
13
+ groups.set(item.script, group);
14
+ }
15
+ return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([script, runs]) => {
16
+ const latest = runs[0];
17
+ const previous = runs[1] ?? null;
18
+ let state = "baseline";
19
+ if (previous) {
20
+ const latestPass = latest.status === "passed";
21
+ const previousPass = previous.status === "passed";
22
+ state = latestPass ? (previousPass ? "stable" : "recovered") : (previousPass ? "regression" : "persistent_failure");
23
+ }
24
+ const latestSignature = failureSignature(latest.output);
25
+ const previousSignature = previous ? failureSignature(previous.output) : null;
26
+ return { script, state, latest, previous, durationChangeMs: previous ? latest.durationMs - previous.durationMs : null, newFailureSignature: previous ? Boolean(latestSignature && latestSignature !== previousSignature) : null, failureSignature: latestSignature };
27
+ });
28
+ }
29
+ export async function generateRegressionReport(inputPath, base = "HEAD") {
30
+ const root = path.resolve(inputPath);
31
+ const warnings = [];
32
+ const history = await listVerifications(root, 500);
33
+ const checks = compareCheckRuns(history);
34
+ let git;
35
+ try {
36
+ git = await analyzeGitChanges(root, base);
37
+ warnings.push(...git.warnings);
38
+ }
39
+ catch {
40
+ warnings.push("Git change context unavailable. Run this command inside a Git repository with the requested base revision available.");
41
+ }
42
+ const changedFiles = git?.changes ?? [];
43
+ const affectedModules = git?.impact ?? [];
44
+ const suggestedTests = git?.suggestedTests ?? [];
45
+ if (!history.length)
46
+ warnings.push("No saved verification runs exist yet. Run selected checks with 'forge verify SCRIPT' to establish a baseline.");
47
+ if (history.length === 500)
48
+ warnings.push("Only the latest 500 verification records were considered.");
49
+ const summary = { regressions: checks.filter(x => x.state === "regression").length, recovered: checks.filter(x => x.state === "recovered").length, persistentFailures: checks.filter(x => x.state === "persistent_failure").length, stable: checks.filter(x => x.state === "stable").length, baselines: checks.filter(x => x.state === "baseline").length, checksReviewed: checks.length };
50
+ return { root, generatedAt: new Date().toISOString(), base, checks, changedFiles, affectedModules, suggestedTests, warnings, summary };
51
+ }
52
+ export function formatRegressionReport(report) {
53
+ const checkLine = (item) => "- **" + item.script + "**: " + item.state.toUpperCase() + (item.previous ? " (" + item.previous.status + " → " + item.latest.status + ")" : " (baseline)") + (item.durationChangeMs === null ? "" : "; duration " + (item.durationChangeMs >= 0 ? "+" : "") + item.durationChangeMs + " ms") + (item.newFailureSignature ? " [new failure signature]" : "");
54
+ return ["# FORGE Regression Intelligence", "", "- Project: `" + report.root + "`", "- Compared against Git base: `" + report.base + "`", "- Verification records: " + report.summary.checksReviewed, "", "## Summary", "- Regressions: " + report.summary.regressions, "- Recovered: " + report.summary.recovered, "- Persistent failures: " + report.summary.persistentFailures, "- Stable: " + report.summary.stable, "- Baselines: " + report.summary.baselines, "", "## Check comparisons", ...(report.checks.length ? report.checks.map(checkLine) : ["- No verification history available."]), "", "## Changed files", ...(report.changedFiles.length ? report.changedFiles.map(x => "- [" + x.status + "] `" + x.file + "`") : ["- No Git changes detected or Git context unavailable."]), "", "## Potentially affected modules", ...(report.affectedModules.length ? report.affectedModules.map(x => "- `" + x.file + "` may affect: " + x.affected.map(f => "`" + f + "`").join(", ")) : ["- No downstream impact paths detected."]), "", "## Suggested test targets", ...(report.suggestedTests.length ? report.suggestedTests.map(x => "- `" + x.file + "` — " + x.reason) : ["- No test targets inferred from changed files."]), "", "## Warnings", ...(report.warnings.length ? report.warnings.map(x => "- " + x) : ["- None."]), "", "_Regression signals compare saved command outcomes; they do not prove causation. Suggested tests are heuristic and are not executed by this command._"].join("\n");
55
+ }
56
+ //# sourceMappingURL=regression-intelligence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"regression-intelligence.js","sourceRoot":"","sources":["../../src/core/regression-intelligence.ts"],"names":[],"mappings":"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"}