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,65 @@
1
+ import { validateBenchmarkMatrix } from "./benchmark-matrix.js";
2
+ export function createSkillExperimentMatrix(input) {
3
+ const matrix = {
4
+ id: input.id,
5
+ name: input.name,
6
+ repeats: input.repeats,
7
+ candidates: [
8
+ { id: input.baselineCandidateId, provider: input.provider, model: input.model, skillIds: [] },
9
+ { id: input.treatmentCandidateId, provider: input.provider, model: input.model, skillIds: [...input.skillIds] }
10
+ ],
11
+ skillExperiment: {
12
+ baselineCandidateId: input.baselineCandidateId,
13
+ treatmentCandidateId: input.treatmentCandidateId,
14
+ skillIds: [...input.skillIds]
15
+ }
16
+ };
17
+ return validateBenchmarkMatrix(matrix);
18
+ }
19
+ export function formatSkillExperimentMatrix(matrix) {
20
+ const experiment = matrix.skillExperiment;
21
+ return [
22
+ "FORGE Experiment Studio · " + matrix.name,
23
+ "Matrix ID: " + matrix.id,
24
+ "Provider/model: " + matrix.candidates[0].provider + "/" + matrix.candidates[0].model,
25
+ "Repeats per candidate: " + matrix.repeats,
26
+ "",
27
+ "Baseline: " + experiment.baselineCandidateId,
28
+ " Skills: none (explicit empty skill set)",
29
+ "Treatment: " + experiment.treatmentCandidateId,
30
+ " Skills: " + experiment.skillIds.join(", "),
31
+ "",
32
+ "Next: forge benchmark-matrix <CONFIG_FILE> --suite <SUITE_ID> --goal \"<task>\"",
33
+ "",
34
+ "This scaffold isolates the selected skill set. Agent configuration snapshots are not hydrated by this scaffold; use the active workspace agent files consistently across both candidates."
35
+ ].join("\n");
36
+ }
37
+ export function createModelComparisonMatrix(input) {
38
+ return validateBenchmarkMatrix({
39
+ id: input.id,
40
+ name: input.name,
41
+ repeats: input.repeats,
42
+ candidates: input.candidates.map(candidate => ({
43
+ id: candidate.id,
44
+ provider: candidate.provider,
45
+ model: candidate.model,
46
+ ...(candidate.configVersionId ? { configVersionId: candidate.configVersionId } : {})
47
+ }))
48
+ });
49
+ }
50
+ export function formatModelComparisonMatrix(matrix) {
51
+ return [
52
+ "FORGE Model Comparison Studio · " + matrix.name,
53
+ "Matrix ID: " + matrix.id,
54
+ "Candidates: " + matrix.candidates.length,
55
+ "Repeats per candidate: " + matrix.repeats,
56
+ "",
57
+ ...matrix.candidates.map((candidate, index) => (index + 1) + ". " + candidate.id + " — " + candidate.provider + "/" + candidate.model + (candidate.configVersionId ? " · config " + candidate.configVersionId : " · active workspace configuration")),
58
+ "",
59
+ "Total planned trials: " + matrix.candidates.length * matrix.repeats,
60
+ "Next: forge benchmark-matrix <CONFIG_FILE> --suite <SUITE_ID> --goal \"<task>\"",
61
+ "",
62
+ "Candidates run sequentially against the same suite and goal. For a fair comparison, keep the evaluation suite, workspace, permissions and environment unchanged."
63
+ ].join("\n");
64
+ }
65
+ //# sourceMappingURL=agent-experiment-studio.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-experiment-studio.js","sourceRoot":"","sources":["../../src/core/agent-experiment-studio.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import type { BenchmarkMatrixReport } from "./benchmark-matrix.js";
2
+ export interface AgentOptimizationSuggestion {
3
+ agent: string;
4
+ candidateId: string;
5
+ baselineScore: number | null;
6
+ currentScore: number;
7
+ scoreDelta: number | null;
8
+ repeatedFailures: Array<{
9
+ criterionId: string;
10
+ count: number;
11
+ examples: string[];
12
+ }>;
13
+ recommendedActions: string[];
14
+ skillIdsObserved: string[];
15
+ confidence: "low" | "medium";
16
+ }
17
+ export interface AgentOptimizationPlan {
18
+ status: "recommendations" | "insufficient-history";
19
+ suiteId: string;
20
+ goal: string;
21
+ baselineAt: string;
22
+ currentAt: string;
23
+ suggestions: AgentOptimizationSuggestion[];
24
+ guardrails: string[];
25
+ }
26
+ export declare function buildAgentOptimizationPlan(history: BenchmarkMatrixReport[]): AgentOptimizationPlan;
27
+ export declare function formatAgentOptimizationPlan(plan: AgentOptimizationPlan): string;
@@ -0,0 +1,63 @@
1
+ export function buildAgentOptimizationPlan(history) {
2
+ const eligible = history.filter(item => item.summary.length > 0).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
3
+ const current = eligible.at(-1);
4
+ const baseline = current ? [...eligible.slice(0, -1)].reverse().find(item => item.suiteId === current.suiteId && item.goal === current.goal) : undefined;
5
+ const guardrails = [
6
+ "Recommendations are advisory; FORGE does not rewrite prompts, skills or agent configuration automatically.",
7
+ "Validate every proposed change with a fresh controlled benchmark using the same suite, goal, provider and model.",
8
+ "Rubric failures are diagnostic signals, not proof of root cause. Inspect the underlying agent outputs before changing configuration."
9
+ ];
10
+ if (!current || !baseline)
11
+ return { status: "insufficient-history", suiteId: current?.suiteId ?? "", goal: current?.goal ?? "", baselineAt: baseline?.createdAt ?? "", currentAt: current?.createdAt ?? "", suggestions: [], guardrails };
12
+ const suggestions = [];
13
+ for (const now of current.agentSummary ?? []) {
14
+ const previous = (baseline.agentSummary ?? []).find(item => item.candidateId === now.candidateId && item.agent === now.agent && item.provider === now.provider && item.model === now.model);
15
+ const results = current.results.filter(result => result.candidateId === now.candidateId && result.status === "completed");
16
+ const failures = new Map();
17
+ for (const result of results)
18
+ for (const score of result.agentScores ?? []) {
19
+ if (score.agent !== now.agent)
20
+ continue;
21
+ for (const failed of score.failedCriteria ?? []) {
22
+ const item = failures.get(failed.id) ?? { count: 0, examples: [] };
23
+ item.count += 1;
24
+ for (const example of failed.failedChecks.slice(0, 2))
25
+ if (item.examples.length < 4 && !item.examples.includes(example))
26
+ item.examples.push(example);
27
+ failures.set(failed.id, item);
28
+ }
29
+ }
30
+ const repeatedFailures = [...failures.entries()].filter(([, item]) => item.count >= 2).map(([criterionId, item]) => ({ criterionId, ...item })).sort((a, b) => b.count - a.count || a.criterionId.localeCompare(b.criterionId));
31
+ const delta = previous ? Math.round((now.averageScore - previous.averageScore) * 10) / 10 : null;
32
+ const actions = [];
33
+ if (repeatedFailures.length) {
34
+ actions.push("Inspect the task outputs for repeated failures in: " + repeatedFailures.map(item => item.criterionId).join(", ") + ".");
35
+ actions.push("Add explicit, evidence-based instructions and a verification checklist for these criteria to this agent's task prompt or a dedicated skill.");
36
+ }
37
+ if (delta !== null && delta <= -5)
38
+ actions.push("Compare this agent's current outputs with the prior baseline and isolate recent prompt, skill or model-context changes before editing.");
39
+ if (now.passRate < 80)
40
+ actions.push("Add a targeted evaluation case for the weakest behavior and require a passing rerun before accepting a configuration change.");
41
+ if (!actions.length)
42
+ continue;
43
+ suggestions.push({ agent: now.agent, candidateId: now.candidateId, baselineScore: previous?.averageScore ?? null, currentScore: now.averageScore, scoreDelta: delta, repeatedFailures, recommendedActions: actions, skillIdsObserved: now.skillsObserved ?? [], confidence: repeatedFailures.length >= 2 && previous ? "medium" : "low" });
44
+ }
45
+ return { status: "recommendations", suiteId: current.suiteId, goal: current.goal, baselineAt: baseline.createdAt, currentAt: current.createdAt, suggestions, guardrails };
46
+ }
47
+ export function formatAgentOptimizationPlan(plan) {
48
+ const lines = ["FORGE Adaptive Agent Optimization", "Status: " + plan.status.toUpperCase(), "Suite: " + (plan.suiteId || "not available"), "Goal: " + (plan.goal || "not available"), ""];
49
+ if (!plan.suggestions.length)
50
+ lines.push(plan.status === "insufficient-history" ? "Run the same evaluation suite and goal twice to establish comparable history." : "No repeated agent failure patterns were found in the latest comparable run.");
51
+ for (const item of plan.suggestions) {
52
+ lines.push(item.agent + " · " + item.candidateId + " · score " + (item.baselineScore === null ? "no baseline" : item.baselineScore + " → " + item.currentScore + " (" + item.scoreDelta + ")"));
53
+ lines.push(" Repeated rubric failures: " + (item.repeatedFailures.map(failure => failure.criterionId + " (" + failure.count + ")").join(", ") || "none"));
54
+ lines.push(" Skills observed: " + (item.skillIdsObserved.join(", ") || "none"));
55
+ for (const action of item.recommendedActions)
56
+ lines.push(" RECOMMEND: " + action);
57
+ }
58
+ lines.push("", "Guardrails:");
59
+ for (const guardrail of plan.guardrails)
60
+ lines.push(" - " + guardrail);
61
+ return lines.join("\n");
62
+ }
63
+ //# sourceMappingURL=agent-optimization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-optimization.js","sourceRoot":"","sources":["../../src/core/agent-optimization.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ export interface AgentDefinition {
2
+ id: string;
3
+ name: string;
4
+ description: string;
5
+ source: "builtin" | "workspace";
6
+ filePath?: string;
7
+ instructions: string;
8
+ }
9
+ export declare function loadAgentRegistry(projectPath: string): Promise<AgentDefinition[]>;
@@ -0,0 +1,95 @@
1
+ import { lstat, readdir, readFile, realpath } from "node:fs/promises";
2
+ import path from "node:path";
3
+ const BUILT_INS = [
4
+ { id: "planner", name: "Planner", description: "Break goals into reviewable tasks.", source: "builtin", instructions: "Create a sequenced plan with scope, assumptions, risks, and acceptance criteria." },
5
+ { id: "architect", name: "Architect", description: "Evaluate boundaries, interfaces, and trade-offs.", source: "builtin", instructions: "Inspect the current design, then propose the smallest maintainable architecture." },
6
+ { id: "code-reviewer", name: "Code Reviewer", description: "Find defects and regressions in proposed changes.", source: "builtin", instructions: "Review correctness, security, data integrity, performance, and test quality." },
7
+ { id: "test-engineer", name: "Test Engineer", description: "Design verification strategies and test cases.", source: "builtin", instructions: "Identify normal, boundary, and failure cases; report only checks actually run." },
8
+ { id: "security-reviewer", name: "Security Reviewer", description: "Review trust boundaries and unsafe defaults.", source: "builtin", instructions: "Review input validation, permissions, secrets, filesystem, process, and network boundaries." },
9
+ { id: "debugger", name: "Debugger", description: "Trace defects from symptoms to likely root causes.", source: "builtin", instructions: "Build a hypothesis-led diagnosis. Cite relevant evidence, distinguish facts from hypotheses, and propose minimal fixes. Never claim to have run a reproducer unless it was actually run." },
10
+ { id: "performance-engineer", name: "Performance Engineer", description: "Identify performance bottlenecks and measurement strategies.", source: "builtin", instructions: "Review algorithmic complexity, I/O, caching, concurrency, memory and bundle/runtime costs. Prefer measurable hypotheses and benchmarks over guesses." },
11
+ { id: "documentation-writer", name: "Documentation Writer", description: "Improve developer-facing documentation and examples.", source: "builtin", instructions: "Identify missing, stale or confusing documentation. Propose concise docs, examples and migration notes that match verified behavior." },
12
+ { id: "devops-engineer", name: "DevOps Engineer", description: "Review build, CI, release and deployment reliability.", source: "builtin", instructions: "Review scripts, CI workflows, reproducibility, release process and deployment assumptions. Do not claim a workflow passed without run evidence." },
13
+ { id: "database-reviewer", name: "Database Reviewer", description: "Review data models, queries and migration safety.", source: "builtin", instructions: "When data persistence exists, review schema design, query patterns, indexing, consistency, migrations, rollback and data-loss risks. State when no database is present." },
14
+ { id: "accessibility-reviewer", name: "Accessibility Reviewer", description: "Review UI accessibility and inclusive interaction.", source: "builtin", instructions: "When a user interface exists, review semantics, keyboard access, focus, labels, contrast and reduced-motion support. State when the project has no UI." },
15
+ { id: "release-manager", name: "Release Manager", description: "Prepare release readiness and change summaries.", source: "builtin", instructions: "Synthesize completed review evidence into release notes, compatibility risks, rollout checks and a go/no-go recommendation. Separate verified facts from open questions." },
16
+ ];
17
+ function titleFromMarkdown(content, fallback) {
18
+ const heading = content.match(/^#\s+(.+)$/m)?.[1]?.trim();
19
+ return heading || fallback;
20
+ }
21
+ function descriptionFromMarkdown(content, title) {
22
+ const paragraph = content
23
+ .split(/\r?\n/)
24
+ .map(line => line.trim())
25
+ .find(line => line.length > 0 && !line.startsWith("#") && !line.startsWith("-") && !line.startsWith("1."));
26
+ return paragraph || `Workspace instructions for ${title}.`;
27
+ }
28
+ function isInside(root, candidate) {
29
+ const relative = path.relative(root, candidate);
30
+ return relative === "" || (!relative.startsWith(".." + path.sep) && relative !== ".." && !path.isAbsolute(relative));
31
+ }
32
+ function isMissing(error) {
33
+ return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
34
+ }
35
+ export async function loadAgentRegistry(projectPath) {
36
+ const root = await realpath(path.resolve(projectPath));
37
+ const forgeDirectory = path.join(root, ".forge");
38
+ const agentDirectory = path.join(forgeDirectory, "agents");
39
+ const definitions = new Map(BUILT_INS.map(agent => [agent.id, agent]));
40
+ let forgeInfo;
41
+ try {
42
+ forgeInfo = await lstat(forgeDirectory);
43
+ }
44
+ catch (error) {
45
+ if (isMissing(error))
46
+ return [...definitions.values()].sort((a, b) => a.id.localeCompare(b.id));
47
+ throw error;
48
+ }
49
+ if (forgeInfo.isSymbolicLink() || !forgeInfo.isDirectory()) {
50
+ throw new Error("Workspace .forge directory must be a real directory inside the project.");
51
+ }
52
+ let agentInfo;
53
+ try {
54
+ agentInfo = await lstat(agentDirectory);
55
+ }
56
+ catch (error) {
57
+ if (isMissing(error))
58
+ return [...definitions.values()].sort((a, b) => a.id.localeCompare(b.id));
59
+ throw error;
60
+ }
61
+ if (agentInfo.isSymbolicLink() || !agentInfo.isDirectory()) {
62
+ throw new Error("Workspace agent directory must be a real directory inside the project.");
63
+ }
64
+ const actualAgentDirectory = await realpath(agentDirectory);
65
+ if (!isInside(root, actualAgentDirectory)) {
66
+ throw new Error("Workspace agent directory must stay inside the project.");
67
+ }
68
+ const entries = await readdir(actualAgentDirectory, { withFileTypes: true });
69
+ for (const entry of entries) {
70
+ if (!entry.isFile() || !entry.name.endsWith(".md"))
71
+ continue;
72
+ const id = path.basename(entry.name, ".md");
73
+ if (!/^[a-z0-9][a-z0-9-]{0,63}$/.test(id))
74
+ continue;
75
+ const filePath = path.join(actualAgentDirectory, entry.name);
76
+ const info = await lstat(filePath);
77
+ if (info.isSymbolicLink() || !info.isFile())
78
+ continue;
79
+ const actualFilePath = await realpath(filePath);
80
+ if (!isInside(root, actualFilePath))
81
+ continue;
82
+ const instructions = await readFile(actualFilePath, "utf8");
83
+ const name = titleFromMarkdown(instructions, id);
84
+ definitions.set(id, {
85
+ id,
86
+ name,
87
+ description: descriptionFromMarkdown(instructions, name),
88
+ source: "workspace",
89
+ filePath: actualFilePath,
90
+ instructions,
91
+ });
92
+ }
93
+ return [...definitions.values()].sort((a, b) => a.id.localeCompare(b.id));
94
+ }
95
+ //# sourceMappingURL=agent-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../src/core/agent-registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ export type AgentSecuritySeverity = "critical" | "high" | "medium";
2
+ export interface AgentSecurityFinding {
3
+ id: string;
4
+ severity: AgentSecuritySeverity;
5
+ file: string;
6
+ line: number;
7
+ title: string;
8
+ detail: string;
9
+ recommendation: string;
10
+ }
11
+ export interface AgentSecurityReport {
12
+ status: "clean" | "findings" | "no-configs";
13
+ generatedAt: string;
14
+ filesScanned: number;
15
+ findings: AgentSecurityFinding[];
16
+ summary: {
17
+ critical: number;
18
+ high: number;
19
+ medium: number;
20
+ };
21
+ caveats: string[];
22
+ }
23
+ /**
24
+ * Read-only, rule-based review of common AI-agent instruction and tool-policy files.
25
+ * Reports locations and remediation guidance only; it never includes matched source text.
26
+ */
27
+ export declare function auditAgentConfiguration(projectPath: string): Promise<AgentSecurityReport>;
28
+ export declare function formatAgentSecurityReport(report: AgentSecurityReport): string;
@@ -0,0 +1,260 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, open, readdir, realpath } from "node:fs/promises";
3
+ import path from "node:path";
4
+ const MAX_FILES = 200;
5
+ const MAX_ENTRIES = 5_000;
6
+ const MAX_FILE_BYTES = 128 * 1024;
7
+ const MAX_DEPTH = 6;
8
+ const RULES = [
9
+ {
10
+ id: "FORGE-AGENT-001",
11
+ severity: "critical",
12
+ title: "Credential value embedded in agent configuration",
13
+ pattern: /\b(?:api[_-]?key|access[_-]?token|secret|password|client[_-]?secret)\b\s*[:=]\s*["']?(?:sk-[A-Za-z0-9_-]{12,}|gh[pousr]_[A-Za-z0-9]{20,}|github_pat_[A-Za-z0-9_]{20,}|xox[baprs]-[A-Za-z0-9-]{12,}|AIza[0-9A-Za-z_-]{30,})/i,
14
+ detail: "A value resembling a live credential is present. FORGE redacts the matching line from this report.",
15
+ recommendation: "Remove the credential from the file, rotate it with its provider, and use an environment-backed secret store.",
16
+ },
17
+ {
18
+ id: "FORGE-AGENT-002",
19
+ severity: "high",
20
+ title: "Arbitrary command execution is explicitly permitted",
21
+ pattern: /\b(?:run|execute|invoke|allow)\s+(?:any|arbitrary|unrestricted)\s+(?:shell\s+)?(?:command|commands|script|scripts|terminal)\b/i,
22
+ detail: "The instruction appears to grant broad command execution without a task-specific boundary.",
23
+ recommendation: "Replace broad command permission with a short allowlist and require human approval for actions that change project state.",
24
+ },
25
+ {
26
+ id: "FORGE-AGENT-003",
27
+ severity: "high",
28
+ title: "Destructive actions can bypass review",
29
+ pattern: /\b(?:without|skip|bypass|disable|no)\s+(?:human\s+)?(?:approval|confirmation|review)\b.{0,100}\b(?:delete|remove|overwrite|write|modify|deploy|publish|execute|run)\b|\b(?:delete|remove|overwrite|deploy|publish)\b.{0,100}\b(?:without|skip|bypass|no)\b.{0,40}\b(?:human\s+)?(?:approval|confirmation|review)\b/i,
30
+ detail: "A destructive or externally visible action is described as not requiring a review step.",
31
+ recommendation: "Require explicit human approval before deletion, overwrites, deployments, publication, or other irreversible actions.",
32
+ },
33
+ {
34
+ id: "FORGE-AGENT-004",
35
+ severity: "high",
36
+ title: "Untrusted repository or tool content is treated as instructions",
37
+ pattern: /\b(?:follow|obey|execute|run|trust)\b.{0,80}\b(?:all\s+)?(?:instructions|commands|directives)\b.{0,80}\b(?:repository|repo\s+files?|tool\s+output|web\s+pages?|external\s+content)\b|\btreat\b.{0,80}\b(?:instructions|commands|directives)\b.{0,80}\b(?:repository|repo\s+files?|tool\s+output|web\s+pages?|external\s+content)\b.{0,40}\b(?:as\s+trusted|as\s+instructions)\b/i,
38
+ detail: "The wording may allow untrusted project files or tool output to override the agent's trusted instructions.",
39
+ recommendation: "Treat repository files, tool output, and external content as data. Never let them override system, developer, or user instructions.",
40
+ },
41
+ {
42
+ id: "FORGE-AGENT-005",
43
+ severity: "medium",
44
+ title: "Unrestricted filesystem access is described",
45
+ pattern: /\b(?:unrestricted|unlimited|full)\s+(?:read\s+and\s+write\s+)?(?:access|permissions?)\s+to\s+(?:the\s+)?(?:entire\s+)?(?:filesystem|file\s+system|all\s+files)\b/i,
46
+ detail: "The configuration appears to grant broad filesystem access rather than limiting work to the project workspace.",
47
+ recommendation: "Scope file access to the current workspace, block secrets and private key material, and keep writes behind an approval boundary.",
48
+ },
49
+ {
50
+ id: "FORGE-AGENT-006",
51
+ severity: "medium",
52
+ title: "Unrestricted network access is described",
53
+ pattern: /\b(?:unrestricted|unlimited|any|all)\s+(?:outbound\s+)?(?:internet|network)\s+access\b|\ballow\s+all\s+(?:outbound\s+)?network\s+traffic\b/i,
54
+ detail: "The configuration appears to permit unrestricted network access for an agent or tool.",
55
+ recommendation: "Use deny-by-default network access and explicitly allow only the endpoints required for the task.",
56
+ },
57
+ ];
58
+ const ROOT_FILES = new Set([
59
+ "AGENTS.md",
60
+ "CLAUDE.md",
61
+ ".cursorrules",
62
+ ".mcp.json",
63
+ "mcp.json",
64
+ ]);
65
+ const SCANNED_DIRECTORIES = [
66
+ ".forge/skills",
67
+ ".forge/hooks",
68
+ ".claude/commands",
69
+ ".cursor/rules",
70
+ ];
71
+ const SCANNED_FILES = new Set([
72
+ ".forge/permissions.json",
73
+ ".forge/policy.json",
74
+ ".claude/settings.json",
75
+ ".claude/settings.local.json",
76
+ ".cursor/mcp.json",
77
+ ".vscode/mcp.json",
78
+ ".github/copilot-instructions.md",
79
+ ]);
80
+ function isInside(root, candidate) {
81
+ const relative = path.relative(root, candidate);
82
+ return relative === "" || (!relative.startsWith(".." + path.sep) && relative !== ".." && !path.isAbsolute(relative));
83
+ }
84
+ async function collectFiles(root, directory, depth, output, visited) {
85
+ if (depth > MAX_DEPTH)
86
+ return;
87
+ try {
88
+ const directoryInfo = await lstat(directory);
89
+ if (directoryInfo.isSymbolicLink() || !directoryInfo.isDirectory())
90
+ return;
91
+ }
92
+ catch (error) {
93
+ if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
94
+ return;
95
+ throw error;
96
+ }
97
+ let entries;
98
+ try {
99
+ entries = await readdir(directory, { withFileTypes: true });
100
+ }
101
+ catch (error) {
102
+ if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
103
+ return;
104
+ throw error;
105
+ }
106
+ entries.sort((a, b) => a.name.localeCompare(b.name));
107
+ for (const entry of entries) {
108
+ visited.count += 1;
109
+ if (visited.count > MAX_ENTRIES)
110
+ throw new Error(`Agent security scan exceeded the ${MAX_ENTRIES} directory-entry limit.`);
111
+ if (entry.name === "node_modules" || entry.name === ".git")
112
+ continue;
113
+ const candidate = path.join(directory, entry.name);
114
+ const info = await lstat(candidate);
115
+ if (info.isSymbolicLink())
116
+ continue;
117
+ if (info.isDirectory()) {
118
+ await collectFiles(root, candidate, depth + 1, output, visited);
119
+ continue;
120
+ }
121
+ if (!info.isFile())
122
+ continue;
123
+ const extension = path.extname(entry.name).toLowerCase();
124
+ if (![".md", ".mdc", ".json", ".yaml", ".yml", ".toml"].includes(extension) && entry.name !== ".cursorrules")
125
+ continue;
126
+ if (info.size > MAX_FILE_BYTES)
127
+ throw new Error(`Agent configuration exceeds the ${MAX_FILE_BYTES}-byte scan limit: ${path.relative(root, candidate)}`);
128
+ const actual = await realpath(candidate);
129
+ if (!isInside(root, actual))
130
+ continue;
131
+ if (output.length >= MAX_FILES)
132
+ throw new Error(`Agent security scan exceeded the ${MAX_FILES}-file limit.`);
133
+ output.push(actual);
134
+ }
135
+ }
136
+ async function readText(filePath) {
137
+ const handle = await open(filePath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
138
+ try {
139
+ const info = await handle.stat();
140
+ if (!info.isFile() || info.size > MAX_FILE_BYTES)
141
+ throw new Error("Agent configuration is not a regular file or exceeds the scan limit.");
142
+ const buffer = Buffer.alloc(MAX_FILE_BYTES + 1);
143
+ const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
144
+ if (bytesRead > MAX_FILE_BYTES)
145
+ throw new Error("Agent configuration exceeds the scan limit.");
146
+ return buffer.subarray(0, bytesRead).toString("utf8");
147
+ }
148
+ finally {
149
+ await handle.close();
150
+ }
151
+ }
152
+ function scanText(relativePath, content) {
153
+ const findings = [];
154
+ const lines = content.split(/\r?\n/);
155
+ for (let index = 0; index < lines.length; index += 1) {
156
+ const line = lines[index] ?? "";
157
+ for (const rule of RULES) {
158
+ rule.pattern.lastIndex = 0;
159
+ if (!rule.pattern.test(line))
160
+ continue;
161
+ findings.push({
162
+ id: rule.id,
163
+ severity: rule.severity,
164
+ file: relativePath,
165
+ line: index + 1,
166
+ title: rule.title,
167
+ detail: rule.detail,
168
+ recommendation: rule.recommendation,
169
+ });
170
+ }
171
+ }
172
+ return findings;
173
+ }
174
+ /**
175
+ * Read-only, rule-based review of common AI-agent instruction and tool-policy files.
176
+ * Reports locations and remediation guidance only; it never includes matched source text.
177
+ */
178
+ export async function auditAgentConfiguration(projectPath) {
179
+ const root = await realpath(path.resolve(projectPath));
180
+ const files = new Set();
181
+ for (const name of ROOT_FILES) {
182
+ const candidate = path.join(root, name);
183
+ try {
184
+ const info = await lstat(candidate);
185
+ if (info.isFile() && !info.isSymbolicLink() && info.size <= MAX_FILE_BYTES)
186
+ files.add(await realpath(candidate));
187
+ }
188
+ catch (error) {
189
+ if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT"))
190
+ throw error;
191
+ }
192
+ }
193
+ for (const relative of SCANNED_FILES) {
194
+ const candidate = path.join(root, relative);
195
+ try {
196
+ const info = await lstat(candidate);
197
+ if (info.isFile() && !info.isSymbolicLink() && info.size <= MAX_FILE_BYTES)
198
+ files.add(await realpath(candidate));
199
+ }
200
+ catch (error) {
201
+ if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT"))
202
+ throw error;
203
+ }
204
+ }
205
+ const visited = { count: 0 };
206
+ for (const relative of SCANNED_DIRECTORIES) {
207
+ const found = [];
208
+ await collectFiles(root, path.join(root, relative), 0, found, visited);
209
+ for (const file of found)
210
+ files.add(file);
211
+ }
212
+ const sortedFiles = [...files].filter(file => isInside(root, file)).sort();
213
+ if (sortedFiles.length > MAX_FILES)
214
+ throw new Error(`Agent security scan exceeded the ${MAX_FILES}-file limit.`);
215
+ const findings = [];
216
+ for (const file of sortedFiles) {
217
+ const relative = path.relative(root, file).split(path.sep).join("/");
218
+ findings.push(...scanText(relative, await readText(file)));
219
+ }
220
+ const severityRank = { critical: 0, high: 1, medium: 2 };
221
+ findings.sort((a, b) => severityRank[a.severity] - severityRank[b.severity] || a.file.localeCompare(b.file) || a.line - b.line || a.id.localeCompare(b.id));
222
+ const summary = {
223
+ critical: findings.filter(item => item.severity === "critical").length,
224
+ high: findings.filter(item => item.severity === "high").length,
225
+ medium: findings.filter(item => item.severity === "medium").length,
226
+ };
227
+ return {
228
+ status: sortedFiles.length === 0 ? "no-configs" : findings.length ? "findings" : "clean",
229
+ generatedAt: new Date().toISOString(),
230
+ filesScanned: sortedFiles.length,
231
+ findings,
232
+ summary,
233
+ caveats: [
234
+ "This is a static, rule-based review of discovered configuration files, not a proof of agent safety.",
235
+ "Only known file locations and high-signal patterns are checked; custom formats and runtime behavior may not be covered.",
236
+ "Matched source lines and credential values are never included in the report.",
237
+ "The scan is read-only and does not edit configurations or change permissions.",
238
+ ],
239
+ };
240
+ }
241
+ export function formatAgentSecurityReport(report) {
242
+ const lines = [
243
+ "FORGE Agent Configuration Security Audit",
244
+ "Status: " + report.status.toUpperCase(),
245
+ "Files scanned: " + report.filesScanned,
246
+ "Findings: " + report.summary.critical + " critical · " + report.summary.high + " high · " + report.summary.medium + " medium",
247
+ "",
248
+ ];
249
+ if (!report.findings.length)
250
+ lines.push(report.status === "no-configs" ? "No supported agent configuration files were found." : "No findings matched the current static rules.");
251
+ for (const finding of report.findings) {
252
+ lines.push(`[${finding.severity.toUpperCase()}] ${finding.id} · ${finding.title}`);
253
+ lines.push(` ${finding.file}:${finding.line}`);
254
+ lines.push(" " + finding.detail);
255
+ lines.push(" RECOMMEND: " + finding.recommendation);
256
+ }
257
+ lines.push("", "Caveats:", ...report.caveats.map(item => " - " + item));
258
+ return lines.join("\n");
259
+ }
260
+ //# sourceMappingURL=agent-security-audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-security-audit.js","sourceRoot":"","sources":["../../src/core/agent-security-audit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export interface AgentWorkspaceTask {
2
+ agent: string;
3
+ title: string;
4
+ prompt: string;
5
+ }
6
+ export interface AgentWorkspaceContextOptions {
7
+ maxResults?: number;
8
+ maxCharacters?: number;
9
+ }
10
+ /**
11
+ * Supplies bounded, read-only code-search evidence to a single agent task.
12
+ * Repository snippets are untrusted context, never executable instructions.
13
+ */
14
+ export declare function buildAgentWorkspaceContext(projectPath: string, task: AgentWorkspaceTask, options?: AgentWorkspaceContextOptions): Promise<string>;