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.
- package/CHANGELOG.md +40 -0
- package/LICENSE +17 -0
- package/README.md +778 -3
- package/SECURITY.md +17 -0
- package/dist/ai/claude-code-provider.d.ts +31 -0
- package/dist/ai/claude-code-provider.js +81 -0
- package/dist/ai/claude-code-provider.js.map +1 -0
- package/dist/ai/provider.d.ts +47 -0
- package/dist/ai/provider.js +57 -0
- package/dist/ai/provider.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +1945 -0
- package/dist/cli.js.map +1 -0
- package/dist/core/agent-config-release.d.ts +22 -0
- package/dist/core/agent-config-release.js +109 -0
- package/dist/core/agent-config-release.js.map +1 -0
- package/dist/core/agent-config-versioning.d.ts +33 -0
- package/dist/core/agent-config-versioning.js +209 -0
- package/dist/core/agent-config-versioning.js.map +1 -0
- package/dist/core/agent-evaluation-intelligence.d.ts +46 -0
- package/dist/core/agent-evaluation-intelligence.js +191 -0
- package/dist/core/agent-evaluation-intelligence.js.map +1 -0
- package/dist/core/agent-evolution.d.ts +20 -0
- package/dist/core/agent-evolution.js +35 -0
- package/dist/core/agent-evolution.js.map +1 -0
- package/dist/core/agent-experiment-studio.d.ts +27 -0
- package/dist/core/agent-experiment-studio.js +65 -0
- package/dist/core/agent-experiment-studio.js.map +1 -0
- package/dist/core/agent-optimization.d.ts +27 -0
- package/dist/core/agent-optimization.js +63 -0
- package/dist/core/agent-optimization.js.map +1 -0
- package/dist/core/agent-registry.d.ts +9 -0
- package/dist/core/agent-registry.js +95 -0
- package/dist/core/agent-registry.js.map +1 -0
- package/dist/core/agent-security-audit.d.ts +28 -0
- package/dist/core/agent-security-audit.js +260 -0
- package/dist/core/agent-security-audit.js.map +1 -0
- package/dist/core/agent-workspace-context.d.ts +14 -0
- package/dist/core/agent-workspace-context.js +66 -0
- package/dist/core/agent-workspace-context.js.map +1 -0
- package/dist/core/ai-code-review.d.ts +20 -0
- package/dist/core/ai-code-review.js +70 -0
- package/dist/core/ai-code-review.js.map +1 -0
- package/dist/core/anthropic-provider.d.ts +16 -0
- package/dist/core/anthropic-provider.js +85 -0
- package/dist/core/anthropic-provider.js.map +1 -0
- package/dist/core/architecture-map.d.ts +26 -0
- package/dist/core/architecture-map.js +124 -0
- package/dist/core/architecture-map.js.map +1 -0
- package/dist/core/benchmark-engine.d.ts +52 -0
- package/dist/core/benchmark-engine.js +109 -0
- package/dist/core/benchmark-engine.js.map +1 -0
- package/dist/core/benchmark-matrix.d.ts +123 -0
- package/dist/core/benchmark-matrix.js +169 -0
- package/dist/core/benchmark-matrix.js.map +1 -0
- package/dist/core/benchmark-regression.d.ts +54 -0
- package/dist/core/benchmark-regression.js +96 -0
- package/dist/core/benchmark-regression.js.map +1 -0
- package/dist/core/change-intelligence.d.ts +40 -0
- package/dist/core/change-intelligence.js +114 -0
- package/dist/core/change-intelligence.js.map +1 -0
- package/dist/core/code-intelligence.d.ts +20 -0
- package/dist/core/code-intelligence.js +119 -0
- package/dist/core/code-intelligence.js.map +1 -0
- package/dist/core/code-review.d.ts +30 -0
- package/dist/core/code-review.js +93 -0
- package/dist/core/code-review.js.map +1 -0
- package/dist/core/code-search.d.ts +16 -0
- package/dist/core/code-search.js +93 -0
- package/dist/core/code-search.js.map +1 -0
- package/dist/core/container-sandbox.d.ts +20 -0
- package/dist/core/container-sandbox.js +220 -0
- package/dist/core/container-sandbox.js.map +1 -0
- package/dist/core/dashboard-server.d.ts +11 -0
- package/dist/core/dashboard-server.js +1068 -0
- package/dist/core/dashboard-server.js.map +1 -0
- package/dist/core/dependency-graph.d.ts +29 -0
- package/dist/core/dependency-graph.js +90 -0
- package/dist/core/dependency-graph.js.map +1 -0
- package/dist/core/dependency-impact.d.ts +51 -0
- package/dist/core/dependency-impact.js +201 -0
- package/dist/core/dependency-impact.js.map +1 -0
- package/dist/core/dependency-intelligence.d.ts +60 -0
- package/dist/core/dependency-intelligence.js +241 -0
- package/dist/core/dependency-intelligence.js.map +1 -0
- package/dist/core/doctor.d.ts +17 -0
- package/dist/core/doctor.js +239 -0
- package/dist/core/doctor.js.map +1 -0
- package/dist/core/engineering-risk.d.ts +40 -0
- package/dist/core/engineering-risk.js +125 -0
- package/dist/core/engineering-risk.js.map +1 -0
- package/dist/core/evaluation-engine.d.ts +110 -0
- package/dist/core/evaluation-engine.js +182 -0
- package/dist/core/evaluation-engine.js.map +1 -0
- package/dist/core/execution-trace.d.ts +27 -0
- package/dist/core/execution-trace.js +137 -0
- package/dist/core/execution-trace.js.map +1 -0
- package/dist/core/experiment-history.d.ts +31 -0
- package/dist/core/experiment-history.js +64 -0
- package/dist/core/experiment-history.js.map +1 -0
- package/dist/core/experiment-manifest.d.ts +67 -0
- package/dist/core/experiment-manifest.js +100 -0
- package/dist/core/experiment-manifest.js.map +1 -0
- package/dist/core/gemini-provider.d.ts +15 -0
- package/dist/core/gemini-provider.js +87 -0
- package/dist/core/gemini-provider.js.map +1 -0
- package/dist/core/git-intelligence.d.ts +26 -0
- package/dist/core/git-intelligence.js +84 -0
- package/dist/core/git-intelligence.js.map +1 -0
- package/dist/core/hook-engine.d.ts +23 -0
- package/dist/core/hook-engine.js +74 -0
- package/dist/core/hook-engine.js.map +1 -0
- package/dist/core/hosted-agent-provider.d.ts +19 -0
- package/dist/core/hosted-agent-provider.js +133 -0
- package/dist/core/hosted-agent-provider.js.map +1 -0
- package/dist/core/intelligence-timeline.d.ts +41 -0
- package/dist/core/intelligence-timeline.js +158 -0
- package/dist/core/intelligence-timeline.js.map +1 -0
- package/dist/core/model-router.d.ts +59 -0
- package/dist/core/model-router.js +291 -0
- package/dist/core/model-router.js.map +1 -0
- package/dist/core/openai-compatible-provider.d.ts +19 -0
- package/dist/core/openai-compatible-provider.js +151 -0
- package/dist/core/openai-compatible-provider.js.map +1 -0
- package/dist/core/orchestrator.d.ts +94 -0
- package/dist/core/orchestrator.js +263 -0
- package/dist/core/orchestrator.js.map +1 -0
- package/dist/core/patch-application.d.ts +54 -0
- package/dist/core/patch-application.js +504 -0
- package/dist/core/patch-application.js.map +1 -0
- package/dist/core/patch-approval.d.ts +23 -0
- package/dist/core/patch-approval.js +181 -0
- package/dist/core/patch-approval.js.map +1 -0
- package/dist/core/patch-validation.d.ts +12 -0
- package/dist/core/patch-validation.js +112 -0
- package/dist/core/patch-validation.js.map +1 -0
- package/dist/core/permission-policy.d.ts +13 -0
- package/dist/core/permission-policy.js +98 -0
- package/dist/core/permission-policy.js.map +1 -0
- package/dist/core/project-health.d.ts +72 -0
- package/dist/core/project-health.js +79 -0
- package/dist/core/project-health.js.map +1 -0
- package/dist/core/project-init.d.ts +9 -0
- package/dist/core/project-init.js +253 -0
- package/dist/core/project-init.js.map +1 -0
- package/dist/core/project-inspector.d.ts +24 -0
- package/dist/core/project-inspector.js +175 -0
- package/dist/core/project-inspector.js.map +1 -0
- package/dist/core/project-memory.d.ts +22 -0
- package/dist/core/project-memory.js +173 -0
- package/dist/core/project-memory.js.map +1 -0
- package/dist/core/provider-diagnostics.d.ts +12 -0
- package/dist/core/provider-diagnostics.js +73 -0
- package/dist/core/provider-diagnostics.js.map +1 -0
- package/dist/core/provider-response.d.ts +4 -0
- package/dist/core/provider-response.js +46 -0
- package/dist/core/provider-response.js.map +1 -0
- package/dist/core/quality-audit.d.ts +29 -0
- package/dist/core/quality-audit.js +101 -0
- package/dist/core/quality-audit.js.map +1 -0
- package/dist/core/regression-intelligence.d.ts +41 -0
- package/dist/core/regression-intelligence.js +56 -0
- package/dist/core/regression-intelligence.js.map +1 -0
- package/dist/core/remediation-planner.d.ts +43 -0
- package/dist/core/remediation-planner.js +124 -0
- package/dist/core/remediation-planner.js.map +1 -0
- package/dist/core/review-history.d.ts +18 -0
- package/dist/core/review-history.js +68 -0
- package/dist/core/review-history.js.map +1 -0
- package/dist/core/review-planner.d.ts +2 -0
- package/dist/core/review-planner.js +79 -0
- package/dist/core/review-planner.js.map +1 -0
- package/dist/core/run-history-output.d.ts +22 -0
- package/dist/core/run-history-output.js +51 -0
- package/dist/core/run-history-output.js.map +1 -0
- package/dist/core/run-replay.d.ts +9 -0
- package/dist/core/run-replay.js +64 -0
- package/dist/core/run-replay.js.map +1 -0
- package/dist/core/run-store.d.ts +13 -0
- package/dist/core/run-store.js +300 -0
- package/dist/core/run-store.js.map +1 -0
- package/dist/core/sandbox-cleanup-audit.d.ts +14 -0
- package/dist/core/sandbox-cleanup-audit.js +57 -0
- package/dist/core/sandbox-cleanup-audit.js.map +1 -0
- package/dist/core/sandbox-compliance.d.ts +19 -0
- package/dist/core/sandbox-compliance.js +34 -0
- package/dist/core/sandbox-compliance.js.map +1 -0
- package/dist/core/sandbox-lifecycle.d.ts +8 -0
- package/dist/core/sandbox-lifecycle.js +36 -0
- package/dist/core/sandbox-lifecycle.js.map +1 -0
- package/dist/core/sandbox-policy.d.ts +31 -0
- package/dist/core/sandbox-policy.js +80 -0
- package/dist/core/sandbox-policy.js.map +1 -0
- package/dist/core/sandbox-runtime.d.ts +10 -0
- package/dist/core/sandbox-runtime.js +44 -0
- package/dist/core/sandbox-runtime.js.map +1 -0
- package/dist/core/sandbox-security-profiles.d.ts +16 -0
- package/dist/core/sandbox-security-profiles.js +43 -0
- package/dist/core/sandbox-security-profiles.js.map +1 -0
- package/dist/core/skill-registry.d.ts +14 -0
- package/dist/core/skill-registry.js +186 -0
- package/dist/core/skill-registry.js.map +1 -0
- package/dist/core/staged-verification.d.ts +27 -0
- package/dist/core/staged-verification.js +108 -0
- package/dist/core/staged-verification.js.map +1 -0
- package/dist/core/verification-history.d.ts +10 -0
- package/dist/core/verification-history.js +71 -0
- package/dist/core/verification-history.js.map +1 -0
- package/dist/core/verification.d.ts +37 -0
- package/dist/core/verification.js +204 -0
- package/dist/core/verification.js.map +1 -0
- package/dist/core/workflow-store.d.ts +16 -0
- package/dist/core/workflow-store.js +113 -0
- package/dist/core/workflow-store.js.map +1 -0
- package/dist/core/workspace-browser.d.ts +22 -0
- package/dist/core/workspace-browser.js +115 -0
- package/dist/core/workspace-browser.js.map +1 -0
- package/dist/core/workspace-scan-policy.d.ts +2 -0
- package/dist/core/workspace-scan-policy.js +11 -0
- package/dist/core/workspace-scan-policy.js.map +1 -0
- package/dist/core/workspace-tool-broker.d.ts +28 -0
- package/dist/core/workspace-tool-broker.js +70 -0
- package/dist/core/workspace-tool-broker.js.map +1 -0
- package/dist/index.d.ts +75 -0
- package/dist/index.js +82 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/server.d.ts +2 -0
- package/dist/mcp/server.js +342 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/workspace-path.d.ts +2 -0
- package/dist/mcp/workspace-path.js +41 -0
- package/dist/mcp/workspace-path.js.map +1 -0
- package/package.json +67 -5
package/README.md
CHANGED
|
@@ -1,3 +1,778 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
<!-- ANVIL — AI Harness for software engineering -->
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="https://raw.githubusercontent.com/anvil-workbench/ANVIL/main/docs/anvil-dashboard.png" alt="ANVIL AI Harness dashboard" width="100%" />
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<h1 align="center">ANVIL — The AI Engineering Harness</h1>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<strong>An open-source AI engineering harness for orchestrating agents, understanding codebases, reviewing changes, and verifying results.</strong>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
<p align="center">
|
|
14
|
+
<a href="https://github.com/AdityaaaTiwari" style="display:inline-flex;align-items:center;gap:6px;text-decoration:none;vertical-align:middle"><img src="https://img.shields.io/badge/Author-Aditya%20Tiwari-c47b52?style=flat" alt="Aditya Tiwari" style="display:block;border:0" /></a>
|
|
15
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT license" /></a>
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
<p align="center">
|
|
19
|
+
<a href="https://github.com/anvil-workbench/ANVIL"><img src="https://img.shields.io/github/stars/anvil-workbench/ANVIL?style=flat" alt="GitHub stars" /></a>
|
|
20
|
+
<a href="https://github.com/anvil-workbench/ANVIL/forks"><img src="https://img.shields.io/github/forks/anvil-workbench/ANVIL?style=flat" alt="GitHub forks" /></a>
|
|
21
|
+
<a href="https://github.com/anvil-workbench/ANVIL/commits/main"><img src="https://img.shields.io/github/last-commit/anvil-workbench/ANVIL?style=flat" alt="Last commit" /></a>
|
|
22
|
+
<a href="https://github.com/anvil-workbench/ANVIL/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/anvil-workbench/ANVIL/ci.yml?branch=main&style=flat&label=build" alt="Build status" /></a>
|
|
23
|
+
</p>
|
|
24
|
+
|
|
25
|
+
<p align="center">
|
|
26
|
+
<img src="https://img.shields.io/badge/AI%20Harness-Agent%20Orchestration-7c3aed?logo=probot&logoColor=white" alt="AI harness and agent orchestration" />
|
|
27
|
+
<img src="https://img.shields.io/badge/Agent%20Workflows-Review%20%26%20Verify-2563eb?logo=githubactions&logoColor=white" alt="Agent workflows, review and verification" />
|
|
28
|
+
<img src="https://img.shields.io/badge/MCP-Read--only%20Tools-0f766e?logo=protocols&logoColor=white" alt="MCP read-only tools" />
|
|
29
|
+
<img src="https://img.shields.io/badge/Runtime-Node.js%2022%2B-339933?logo=nodedotjs&logoColor=white" alt="Node.js 22+" />
|
|
30
|
+
<img src="https://img.shields.io/badge/Language-TypeScript-3178C6?logo=typescript&logoColor=white" alt="TypeScript" />
|
|
31
|
+
<img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-64748b?logo=linux&logoColor=white" alt="Windows macOS Linux" />
|
|
32
|
+
<img src="https://img.shields.io/badge/Architecture-Local--first-0f766e?logo=shield&logoColor=white" alt="Local-first architecture" />
|
|
33
|
+
</p>
|
|
34
|
+
|
|
35
|
+
<p align="center">
|
|
36
|
+
<a href="https://www.star-history.com/anvil-workbench/ANVIL">
|
|
37
|
+
<img src="https://img.shields.io/badge/GitHub%20Trending-Not%20ranked%20yet-64748b?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Trending — not ranked yet" />
|
|
38
|
+
</a>
|
|
39
|
+
<a href="https://www.star-history.com/anvil-workbench/ANVIL">
|
|
40
|
+
<img src="https://img.shields.io/badge/Star%20History%20Global%20Rank-Pending-64748b?style=for-the-badge&logo=starship&logoColor=white" alt="Star History global rank — pending" />
|
|
41
|
+
</a>
|
|
42
|
+
</p>
|
|
43
|
+
|
|
44
|
+
<p align="center">
|
|
45
|
+
<sub>These are live-status placeholders until Star History publishes a trending record and global rank for ANVIL. They will be replaced with Star History's live badge images once those records are available.</sub>
|
|
46
|
+
</p>
|
|
47
|
+
|
|
48
|
+
<p align="center">
|
|
49
|
+
<strong>Built and maintained by <a href="https://github.com/AdityaaaTiwari">Aditya Tiwari</a></strong>
|
|
50
|
+
</p>
|
|
51
|
+
|
|
52
|
+
<p align="center">
|
|
53
|
+
<a href="#quick-start">Quick start</a> ·
|
|
54
|
+
<a href="#features">Features</a> ·
|
|
55
|
+
<a href="#dashboard">Dashboard</a> ·
|
|
56
|
+
<a href="#ai-providers">AI providers</a> ·
|
|
57
|
+
<a href="#integrations">Integrations</a> ·
|
|
58
|
+
<a href="#security-model">Security</a> ·
|
|
59
|
+
<a href="#roadmap">Roadmap</a>
|
|
60
|
+
</p>
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
> [!NOTE]
|
|
65
|
+
> **ANVIL v1.0.0 — AI harness foundation.** The local CLI, local dashboard, agent orchestration, MCP server, provider adapters, GitHub Action and GitHub App installation/authentication foundation are available. The GitHub App does not yet perform hosted repository scans or create pull requests. See [Current capabilities and boundaries](#current-capabilities-and-boundaries).
|
|
66
|
+
|
|
67
|
+
## What is ANVIL?
|
|
68
|
+
|
|
69
|
+
**ANVIL (ANVIL Engineering Workbench)** is a local-first AI engineering harness for developers who want more than a chat window pointed at a repository.
|
|
70
|
+
|
|
71
|
+
It brings codebase understanding, specialist-agent workflows, engineering review, human approval, verification, experiment tracking and a live local dashboard into one inspectable system.
|
|
72
|
+
|
|
73
|
+
ANVIL is built around a simple engineering loop:
|
|
74
|
+
|
|
75
|
+
```text
|
|
76
|
+
inspect → understand → plan → propose → review → approve → verify → learn
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
The goal is not to let an agent silently take over a project. The goal is to make AI-assisted engineering **observable, reviewable and evidence-driven**: proposals remain proposals until a person approves the next step.
|
|
80
|
+
|
|
81
|
+
### At a glance
|
|
82
|
+
|
|
83
|
+
| | ANVIL provides |
|
|
84
|
+
|---|---|
|
|
85
|
+
| **Codebase intelligence** | Project inventory, code search, architecture maps, dependency analysis and change impact |
|
|
86
|
+
| **Agent harness** | Specialist roles, skills, hooks, provider routing, task orchestration and run history |
|
|
87
|
+
| **Engineering control** | Review plans, patch validation, approval records, staged workflows and explicit verification |
|
|
88
|
+
| **Evaluation loop** | Evaluation suites, benchmark matrices, regression comparisons and experiment history |
|
|
89
|
+
| **Operator experience** | CLI, local dashboard, execution traces, configuration studio and workspace explorer |
|
|
90
|
+
| **Interoperability** | Read-only MCP server, Claude Code CLI adapter, Cursor MCP configuration and GitHub Action |
|
|
91
|
+
|
|
92
|
+
## Quick start
|
|
93
|
+
|
|
94
|
+
### Requirements
|
|
95
|
+
|
|
96
|
+
- **Node.js 22 or newer**
|
|
97
|
+
- npm (included with Node.js)
|
|
98
|
+
- Git (recommended for Git-aware features)
|
|
99
|
+
- Windows, macOS or Linux
|
|
100
|
+
|
|
101
|
+
Check your environment:
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
node --version
|
|
105
|
+
npm --version
|
|
106
|
+
git --version
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Install ANVIL
|
|
110
|
+
|
|
111
|
+
Install the released CLI directly from the GitHub repository:
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
npm install --global git+https://github.com/anvil-workbench/ANVIL.git#v1.0.0
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
Verify the installation:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
anvil --version
|
|
121
|
+
anvil --help
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Initialize and inspect a project
|
|
125
|
+
|
|
126
|
+
Open a terminal in the repository you want to work on:
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
cd /path/to/your-project
|
|
130
|
+
|
|
131
|
+
# Create the local ANVIL workspace
|
|
132
|
+
anvil init .
|
|
133
|
+
|
|
134
|
+
# Inspect the project
|
|
135
|
+
anvil inspect .
|
|
136
|
+
|
|
137
|
+
# Start the local dashboard
|
|
138
|
+
anvil dashboard .
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
ANVIL prints the dashboard's local URL. Open that address in your browser.
|
|
142
|
+
|
|
143
|
+
### Windows PowerShell
|
|
144
|
+
|
|
145
|
+
```powershell
|
|
146
|
+
# Check prerequisites
|
|
147
|
+
node --version
|
|
148
|
+
npm --version
|
|
149
|
+
git --version
|
|
150
|
+
|
|
151
|
+
# Install ANVIL
|
|
152
|
+
npm install --global git+https://github.com/anvil-workbench/ANVIL.git#v1.0.0
|
|
153
|
+
|
|
154
|
+
# Move into your project
|
|
155
|
+
cd C:\Users\YourName\Projects\my-project
|
|
156
|
+
|
|
157
|
+
# Initialize, inspect and launch
|
|
158
|
+
anvil init .
|
|
159
|
+
anvil inspect .
|
|
160
|
+
anvil dashboard .
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Replace the example directory with your actual project path.
|
|
164
|
+
|
|
165
|
+
### Build from source
|
|
166
|
+
|
|
167
|
+
For contributors or anyone who wants to work on ANVIL itself:
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
git clone https://github.com/anvil-workbench/ANVIL.git
|
|
171
|
+
cd ANVIL
|
|
172
|
+
npm ci
|
|
173
|
+
npm run typecheck
|
|
174
|
+
npm test
|
|
175
|
+
npm run build
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
## Features
|
|
179
|
+
|
|
180
|
+
ANVIL is composed of focused engineering systems that share local project context and persisted evidence.
|
|
181
|
+
|
|
182
|
+
### 1. Project and code intelligence
|
|
183
|
+
|
|
184
|
+
Understand a repository before asking an agent to change it.
|
|
185
|
+
|
|
186
|
+
- **Project inspection** — detect languages, frameworks, package managers, dependencies, scripts and project structure.
|
|
187
|
+
- **Code search** — search supported source files and inspect bounded matching context.
|
|
188
|
+
- **Architecture mapping** — map source modules, entry points and internal import relationships.
|
|
189
|
+
- **Dependency intelligence** — inspect npm dependency information, licenses and imported security reports.
|
|
190
|
+
- **Dependency impact** — identify downstream modules affected by a change.
|
|
191
|
+
- **Git intelligence** — analyze working-tree changes, changed files and suggested test targets.
|
|
192
|
+
- **Change intelligence** — combine changed-file context, dependency impact and engineering signals.
|
|
193
|
+
- **Engineering risk** — rank potential hotspots using dependency and quality evidence.
|
|
194
|
+
- **Project health** — produce a unified health snapshot with evidence coverage and quality signals.
|
|
195
|
+
- **Timeline snapshots** — capture and compare local engineering-intelligence snapshots.
|
|
196
|
+
|
|
197
|
+
### 2. Specialist agents and orchestration
|
|
198
|
+
|
|
199
|
+
Coordinate engineering tasks with explicit task state instead of relying on one long prompt.
|
|
200
|
+
|
|
201
|
+
- Built-in specialist-agent registry and workspace-defined agent roles.
|
|
202
|
+
- Workspace skill registry and skill selection.
|
|
203
|
+
- Project context assembly and local project memory.
|
|
204
|
+
- Declarative before-agent hooks and permission policies.
|
|
205
|
+
- Provider routing for configured AI backends.
|
|
206
|
+
- Dependency-aware review-plan generation.
|
|
207
|
+
- Saved runs, task-level status and approval checkpoints.
|
|
208
|
+
- Run replay for retryable failed tasks.
|
|
209
|
+
- Resume support for pending or approved work.
|
|
210
|
+
- Execution traces and per-agent telemetry.
|
|
211
|
+
- Configurable token and task-duration budgets.
|
|
212
|
+
|
|
213
|
+
Agent instructions and workspace files are treated as untrusted project content. A generated plan or response does not mean a project file has been changed.
|
|
214
|
+
|
|
215
|
+
### 3. Code review and patch lifecycle
|
|
216
|
+
|
|
217
|
+
Keep analysis, approval and file promotion as distinct operations.
|
|
218
|
+
|
|
219
|
+
- Static code review and evidence-backed findings.
|
|
220
|
+
- Optional provider-backed AI review suggestions.
|
|
221
|
+
- Saved review snapshots, review history and comparison.
|
|
222
|
+
- Patch validation as a dry run.
|
|
223
|
+
- Approval records tied to patch and source fingerprints.
|
|
224
|
+
- Staged patch review and staged verification workflows.
|
|
225
|
+
- Explicit operator-controlled promotion boundaries.
|
|
226
|
+
|
|
227
|
+
**A patch being suggested or validated is not the same as it being approved or applied.**
|
|
228
|
+
|
|
229
|
+
### 4. Verification and regression intelligence
|
|
230
|
+
|
|
231
|
+
Run checks deliberately and retain their outcomes.
|
|
232
|
+
|
|
233
|
+
- Discover available project checks without executing them.
|
|
234
|
+
- Run one explicitly selected verification script.
|
|
235
|
+
- Persist verification results and history.
|
|
236
|
+
- Compare verification history with current Git changes.
|
|
237
|
+
- Generate regression intelligence from verification and impact signals.
|
|
238
|
+
- Verify approved staged patches in a temporary workspace.
|
|
239
|
+
- Inspect Docker availability, security profiles and sandbox compliance.
|
|
240
|
+
- Review managed-container cleanup activity.
|
|
241
|
+
|
|
242
|
+
Local script verification runs project-controlled code on the host. Docker-backed verification is opt-in and depends on the host's Docker configuration.
|
|
243
|
+
|
|
244
|
+
### 5. Evaluation, benchmarking and improvement
|
|
245
|
+
|
|
246
|
+
Measure candidate configurations instead of silently changing agent behavior.
|
|
247
|
+
|
|
248
|
+
- Local evaluation suites and run scoring.
|
|
249
|
+
- Benchmark trials and benchmark matrices.
|
|
250
|
+
- Baseline-versus-candidate regression comparisons.
|
|
251
|
+
- Model and skill experiment scaffolding.
|
|
252
|
+
- Experiment manifests and experiment history.
|
|
253
|
+
- Agent effectiveness intelligence.
|
|
254
|
+
- Agent optimization recommendations.
|
|
255
|
+
- Controlled agent-evolution assessments.
|
|
256
|
+
- Agent/skill configuration snapshots and diffs.
|
|
257
|
+
- Benchmark-gated configuration release preparation and human approval.
|
|
258
|
+
|
|
259
|
+
Configuration promotion is reviewable. ANVIL does not silently rewrite its own agent or skill setup based on an evaluation result.
|
|
260
|
+
|
|
261
|
+
### 6. Security and policy
|
|
262
|
+
|
|
263
|
+
Security-related features focus on inspectable boundaries and bounded operations.
|
|
264
|
+
|
|
265
|
+
- Static agent-configuration audits for supported agent, skill, hook and permission files.
|
|
266
|
+
- Redaction of credential-like matches in audit output.
|
|
267
|
+
- Fail-closed permission-policy validation.
|
|
268
|
+
- Workspace path restrictions and symlink rejection in bounded readers.
|
|
269
|
+
- Patch/source fingerprint checks for approval records.
|
|
270
|
+
- Sandbox policy validation and compliance reporting.
|
|
271
|
+
- Explicit review of stopped ANVIL-managed containers before cleanup.
|
|
272
|
+
|
|
273
|
+
These controls reduce risk; they do not certify a repository or make arbitrary host execution safe.
|
|
274
|
+
|
|
275
|
+
## Dashboard
|
|
276
|
+
|
|
277
|
+
The **anvil dashboard** is a browser-based engineering control center served by the local CLI.
|
|
278
|
+
|
|
279
|
+
Start it from the project you want to inspect:
|
|
280
|
+
|
|
281
|
+
```bash
|
|
282
|
+
anvil dashboard .
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
The terminal prints a localhost URL. The dashboard reads the selected workspace and its local ANVIL records.
|
|
286
|
+
|
|
287
|
+
### Dashboard workspaces
|
|
288
|
+
|
|
289
|
+
| Area | What you can inspect or manage |
|
|
290
|
+
|---|---|
|
|
291
|
+
| **Overview** | Project summary, detected stack and workspace status |
|
|
292
|
+
| **Health** | Quality signals, health snapshots and engineering trends |
|
|
293
|
+
| **Architecture** | Project structure, module relationships and dependency views |
|
|
294
|
+
| **Agents** | Built-in and workspace specialist-agent registry |
|
|
295
|
+
| **Runs & tasks** | Saved orchestration runs, task states and execution details |
|
|
296
|
+
| **Approvals** | Human review and approval records |
|
|
297
|
+
| **Workflow editor** | Draft and save reusable specialist-agent workflows |
|
|
298
|
+
| **Configuration studio** | Workspace agent/skill Markdown, snapshots and configuration comparisons |
|
|
299
|
+
| **Workspace explorer** | Browse supported project files and inspect source |
|
|
300
|
+
| **Code search** | Search source and view bounded matching context |
|
|
301
|
+
| **Reviews** | Review findings, saved review snapshots and comparisons |
|
|
302
|
+
| **Verification** | Selected check results and verification history |
|
|
303
|
+
| **Traces** | Execution telemetry and per-agent activity |
|
|
304
|
+
| **Regression** | Compare verification outcomes and engineering signals |
|
|
305
|
+
| **Evaluations** | Evaluation suites, benchmark results and experiment comparisons |
|
|
306
|
+
| **Provider readiness** | Inspect provider configuration and run explicit connection diagnostics |
|
|
307
|
+
|
|
308
|
+
Some dashboard panels depend on local history, a configured provider or enabled workspace permissions.
|
|
309
|
+
|
|
310
|
+
### Public website vs local dashboard
|
|
311
|
+
|
|
312
|
+
These are two different experiences:
|
|
313
|
+
|
|
314
|
+
- **[ANVIL.vercel.app](https://ANVIL.vercel.app/)** is the public product website.
|
|
315
|
+
- **`anvil dashboard .`** starts the actual interactive dashboard on your machine and connects it to the selected local project.
|
|
316
|
+
|
|
317
|
+
The public website does not host your local project dashboard.
|
|
318
|
+
|
|
319
|
+
## CLI reference
|
|
320
|
+
|
|
321
|
+
Run `anvil --help` for the complete command list and `anvil <command> --help` for command-specific usage.
|
|
322
|
+
|
|
323
|
+
### Everyday project commands
|
|
324
|
+
|
|
325
|
+
| Command | Purpose |
|
|
326
|
+
|---|---|
|
|
327
|
+
| `anvil init [path]` | Create a local `.ANVIL` starter workspace |
|
|
328
|
+
| `anvil inspect [path]` | Inspect project languages, tooling, dependencies and scripts |
|
|
329
|
+
| `anvil map [path]` | Map source modules and import relationships |
|
|
330
|
+
| `anvil dashboard [path]` | Start the local dashboard |
|
|
331
|
+
| `anvil quality [path]` | Generate a static engineering-quality report |
|
|
332
|
+
| `anvil deps [path]` | Analyze npm dependencies, licenses and imported security reports |
|
|
333
|
+
| `anvil health [path]` | Generate a unified project-health snapshot |
|
|
334
|
+
| `anvil deep [path]` | Analyze AST symbols, circular imports and change impact |
|
|
335
|
+
| `anvil git [path]` | Analyze changed files, impact and suggested tests |
|
|
336
|
+
| `anvil risk [path]` | Rank engineering hotspots |
|
|
337
|
+
| `anvil change-risk [path]` | Analyze changed-file risk and downstream impact |
|
|
338
|
+
| `anvil snapshot [path]` | Capture an intelligence snapshot |
|
|
339
|
+
| `anvil timeline [path]` | Compare the latest intelligence snapshots |
|
|
340
|
+
|
|
341
|
+
### Agents and runs
|
|
342
|
+
|
|
343
|
+
| Command | Purpose |
|
|
344
|
+
|---|---|
|
|
345
|
+
| `anvil agents [path]` | List specialist-agent roles |
|
|
346
|
+
| `anvil skills [path]` | List built-in and workspace skills |
|
|
347
|
+
| `anvil hooks [path]` | List declarative lifecycle hooks |
|
|
348
|
+
| `anvil memory <action>` | Add, list, remove or inspect project memory |
|
|
349
|
+
| `anvil plan --goal TEXT` | Create and save a reviewable draft plan |
|
|
350
|
+
| `anvil run --goal TEXT` | Run a plan with the configured AI provider |
|
|
351
|
+
| `anvil runs [path]` | List saved local runs |
|
|
352
|
+
| `anvil show-run ID` | Display a saved run |
|
|
353
|
+
| `anvil approve RUN_ID TASK_ID` | Approve a task awaiting human review |
|
|
354
|
+
| `anvil resume RUN_ID` | Continue pending or approved tasks |
|
|
355
|
+
| `anvil replay RUN_ID` | Create a run from retryable failed tasks |
|
|
356
|
+
| `anvil trace RUN_ID` | Show per-agent execution telemetry |
|
|
357
|
+
|
|
358
|
+
### Review and verification
|
|
359
|
+
|
|
360
|
+
| Command | Purpose |
|
|
361
|
+
|---|---|
|
|
362
|
+
| `anvil review [path]` | Review changed source files |
|
|
363
|
+
| `anvil review [path] --ai` | Include provider-backed review suggestions |
|
|
364
|
+
| `anvil review-history [path]` | List saved review snapshots |
|
|
365
|
+
| `anvil review-show ID` | Display a saved review |
|
|
366
|
+
| `anvil review-compare A B` | Compare two saved reviews |
|
|
367
|
+
| `anvil patch-check ID N` | Dry-run validate a proposed patch |
|
|
368
|
+
| `anvil verify --list` | Discover available npm scripts without running them |
|
|
369
|
+
| `anvil verify SCRIPT` | Explicitly run one selected npm script |
|
|
370
|
+
| `anvil verify-history` | List saved verification runs |
|
|
371
|
+
| `anvil regression [path]` | Compare verification history with Git changes and impact |
|
|
372
|
+
| `anvil patch-verify ID SCRIPT` | Verify an approved staged patch in a temporary workspace |
|
|
373
|
+
|
|
374
|
+
### Evaluation and agent configuration
|
|
375
|
+
|
|
376
|
+
| Command | Purpose |
|
|
377
|
+
|---|---|
|
|
378
|
+
| `anvil evals [path]` | List local evaluation suites |
|
|
379
|
+
| `anvil evaluate RUN_ID` | Score a saved run against an evaluation suite |
|
|
380
|
+
| `anvil benchmark` | Record or view benchmark results |
|
|
381
|
+
| `anvil benchmark-matrix` | Run a configured model comparison matrix |
|
|
382
|
+
| `anvil benchmark-regression` | Compare a matrix with its baseline |
|
|
383
|
+
| `anvil optimize-agents` | Recommend evidence-based agent improvements |
|
|
384
|
+
| `anvil agent-intelligence` | Score agent effectiveness across benchmark history |
|
|
385
|
+
| `anvil agent-evolution` | Assess a controlled baseline/treatment experiment |
|
|
386
|
+
| `anvil experiment-studio` | Create or compare skill/model experiments |
|
|
387
|
+
| `anvil experiment-history` | Rank historical benchmark candidates |
|
|
388
|
+
| `anvil agent-config` | Snapshot, list, show and diff agent configuration |
|
|
389
|
+
| `anvil agent-release` | Prepare and review benchmark-gated configuration releases |
|
|
390
|
+
| `anvil experiment` | Capture, show and compare reproducible experiment manifests |
|
|
391
|
+
|
|
392
|
+
### Sandbox and diagnostics
|
|
393
|
+
|
|
394
|
+
| Command | Purpose |
|
|
395
|
+
|---|---|
|
|
396
|
+
| `anvil sandbox-status` | Inspect Docker availability and advertised security options |
|
|
397
|
+
| `anvil sandbox-compliance` | Generate a sandbox compliance report |
|
|
398
|
+
| `anvil sandbox-policy-check` | Validate a fail-closed sandbox policy |
|
|
399
|
+
| `anvil sandbox-profiles` | List or inspect built-in security profiles |
|
|
400
|
+
| `anvil sandbox-cleanup` | Review stopped ANVIL containers; `--apply` opts into removal |
|
|
401
|
+
| `anvil sandbox-cleanup-history` | Show recorded cleanup activity |
|
|
402
|
+
| `anvil agent-security [path]` | Audit supported agent instructions, skills, hooks and permissions |
|
|
403
|
+
|
|
404
|
+
Most project commands accept a project path. Use `--json` where supported for machine-readable output.
|
|
405
|
+
|
|
406
|
+
## AI providers
|
|
407
|
+
|
|
408
|
+
ANVIL supports provider adapters for local CLI and HTTP-based model services. Configure one provider using environment variables.
|
|
409
|
+
|
|
410
|
+
| Provider | Environment | Default model |
|
|
411
|
+
|---|---|---|
|
|
412
|
+
| Claude Code CLI | Authenticated Claude Code CLI on PATH | `sonnet` |
|
|
413
|
+
| OpenAI | `ANVIL_API_KEY` or `OPENAI_API_KEY` | `gpt-4.1-mini` |
|
|
414
|
+
| Anthropic API | `ANTHROPIC_API_KEY` | `claude-sonnet-4-5` |
|
|
415
|
+
| Google AI | `GOOGLE_API_KEY` | `gemini-2.5-flash` |
|
|
416
|
+
| Ollama | Local Ollama endpoint | `llama3.2` |
|
|
417
|
+
|
|
418
|
+
Set `ANVIL_AI_PROVIDER` to the provider name and optionally set `ANVIL_AI_MODEL` to override the model. `ANVIL_BASE_URL` selects a compatible gateway/custom endpoint. For Ollama, `OLLAMA_HOST` overrides the default local endpoint.
|
|
419
|
+
|
|
420
|
+
### Examples
|
|
421
|
+
|
|
422
|
+
```bash
|
|
423
|
+
# OpenAI
|
|
424
|
+
ANVIL_AI_PROVIDER=openai OPENAI_API_KEY=YOUR_KEY ANVIL run --goal "Review the authentication flow" --path .
|
|
425
|
+
|
|
426
|
+
# Anthropic
|
|
427
|
+
ANVIL_AI_PROVIDER=anthropic ANTHROPIC_API_KEY=YOUR_KEY ANVIL run --goal "Map the service boundaries" --path .
|
|
428
|
+
|
|
429
|
+
# Google Gemini
|
|
430
|
+
ANVIL_AI_PROVIDER=google GOOGLE_API_KEY=YOUR_KEY ANVIL run --goal "Identify reliability risks" --path .
|
|
431
|
+
|
|
432
|
+
# Local Ollama
|
|
433
|
+
ANVIL_AI_PROVIDER=ollama OLLAMA_HOST=http://localhost:11434 ANVIL_AI_MODEL=llama3.2 ANVIL run --goal "Explain the architecture" --path .
|
|
434
|
+
|
|
435
|
+
# Claude Code CLI
|
|
436
|
+
ANVIL_AI_PROVIDER=claude-code ANVIL_AI_MODEL=sonnet ANVIL run --goal "Plan a safe refactor" --path .
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
> [!IMPORTANT]
|
|
440
|
+
> Provider calls may send task prompts, dependency results and selected project context to the configured service. Hosted API use may incur charges. A consumer chat subscription does not automatically include API credits. Review [provider configuration and data-handling notes](docs/providers.md) before using private repositories.
|
|
441
|
+
|
|
442
|
+
### Provider connection diagnostics
|
|
443
|
+
|
|
444
|
+
The local dashboard includes explicit connection checks for OpenAI, Anthropic, Google and Ollama. These checks make a read-only model-list request; they do not submit a generation prompt. A successful connection check does not guarantee generation access to every model.
|
|
445
|
+
|
|
446
|
+
## Integrations
|
|
447
|
+
|
|
448
|
+
### Claude Code
|
|
449
|
+
|
|
450
|
+
ANVIL includes a local Claude Code CLI provider adapter. It uses the CLI installed and authenticated on the developer's machine; it is not the same as configuring an Anthropic API key.
|
|
451
|
+
|
|
452
|
+
See [Claude Code integration](docs/integrations/claude-code.md).
|
|
453
|
+
|
|
454
|
+
### Cursor and MCP
|
|
455
|
+
|
|
456
|
+
Cursor can connect to ANVIL through the local stdio MCP server using Cursor's MCP configuration. This is **MCP interoperability**, not a native Cursor extension.
|
|
457
|
+
|
|
458
|
+
Example project configuration:
|
|
459
|
+
|
|
460
|
+
```json
|
|
461
|
+
{
|
|
462
|
+
"mcpServers": {
|
|
463
|
+
"ANVIL": {
|
|
464
|
+
"command": "node",
|
|
465
|
+
"args": ["C:/path/to/ANVIL/dist/mcp/server.js"],
|
|
466
|
+
"env": {
|
|
467
|
+
"ANVIL_WORKSPACE": "C:/path/to/your-project"
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
}
|
|
472
|
+
```
|
|
473
|
+
|
|
474
|
+
Build ANVIL before using the compiled server:
|
|
475
|
+
|
|
476
|
+
```bash
|
|
477
|
+
npm run build
|
|
478
|
+
```
|
|
479
|
+
|
|
480
|
+
Adjust the paths for your machine. See [Cursor MCP documentation](https://docs.cursor.com/context/mcp).
|
|
481
|
+
|
|
482
|
+
### MCP server
|
|
483
|
+
|
|
484
|
+
ANVIL provides a Model Context Protocol server over stdio:
|
|
485
|
+
|
|
486
|
+
```bash
|
|
487
|
+
npm run build
|
|
488
|
+
ANVIL_WORKSPACE=/absolute/path/to/project npm run mcp
|
|
489
|
+
```
|
|
490
|
+
|
|
491
|
+
The current MCP server exposes nine bounded, read-only tools:
|
|
492
|
+
|
|
493
|
+
| Tool | Function |
|
|
494
|
+
|---|---|
|
|
495
|
+
| `ANVIL_inspect_project` | Inspect project structure and tooling |
|
|
496
|
+
| `ANVIL_map_architecture` | Map source files and imports |
|
|
497
|
+
| `ANVIL_search_code` | Search supported project source |
|
|
498
|
+
| `ANVIL_list_files` | List supported workspace files |
|
|
499
|
+
| `ANVIL_read_file` | Read a bounded text/source file |
|
|
500
|
+
| `ANVIL_quality_audit` | Run static project-quality checks |
|
|
501
|
+
| `ANVIL_git_intelligence` | Analyze Git changes and impact |
|
|
502
|
+
| `ANVIL_list_agents` | List built-in and workspace agent roles |
|
|
503
|
+
| `ANVIL_create_review_plan` | Create a draft engineering review plan |
|
|
504
|
+
|
|
505
|
+
MCP workspace paths are constrained to the configured workspace root. Hidden paths, generated/dependency directories, secret-like filenames and symlinks are excluded or rejected. Reads are bounded. The MCP server does not expose arbitrary shell execution, project-file writes, patch application or test execution.
|
|
506
|
+
|
|
507
|
+
Some workspace browsing/search operations require an explicit restricted-mode allowlist in `.ANVIL/permissions.json`; the default proposal-only policy denies them.
|
|
508
|
+
|
|
509
|
+
### GitHub Action
|
|
510
|
+
|
|
511
|
+
ANVIL ships a composite GitHub Action for selected CI operations.
|
|
512
|
+
|
|
513
|
+
```yaml
|
|
514
|
+
name: ANVIL checks
|
|
515
|
+
|
|
516
|
+
on:
|
|
517
|
+
pull_request:
|
|
518
|
+
push:
|
|
519
|
+
branches: [main]
|
|
520
|
+
|
|
521
|
+
jobs:
|
|
522
|
+
ANVIL:
|
|
523
|
+
runs-on: ubuntu-latest
|
|
524
|
+
steps:
|
|
525
|
+
- uses: actions/checkout@v4
|
|
526
|
+
- uses: anvil-workbench/ANVIL@v1.0.0
|
|
527
|
+
with:
|
|
528
|
+
version: v1.0.0
|
|
529
|
+
project-path: .
|
|
530
|
+
operation: inspect
|
|
531
|
+
```
|
|
532
|
+
|
|
533
|
+
Supported `operation` values:
|
|
534
|
+
|
|
535
|
+
| Operation | What it runs |
|
|
536
|
+
|---|---|
|
|
537
|
+
| `inspect` | Project inspection |
|
|
538
|
+
| `quality` | Static engineering-quality audit |
|
|
539
|
+
| `health` | Project-health report |
|
|
540
|
+
| `review` | Code review |
|
|
541
|
+
|
|
542
|
+
Inputs are `version`, `project-path` and `operation`. The default operation is `inspect`. Pin production workflows to a reviewed release tag or immutable commit SHA. See [action.yml](action.yml).
|
|
543
|
+
|
|
544
|
+
### GitHub App
|
|
545
|
+
|
|
546
|
+
[**Get the ANVIL GitHub App →**](https://ANVIL.vercel.app/api/github/install)
|
|
547
|
+
|
|
548
|
+
The GitHub App currently provides an installation entry point, signed installation webhooks, OAuth account authorization, verified installation association and server-side session handling.
|
|
549
|
+
|
|
550
|
+
**Not shipped yet:** hosted repository-content scanning, installation-token-based repository workflows, automatic pull-request creation and hosted autonomous coding agents. Installing the App does not upload or scan a local workspace. Use the local CLI/dashboard for repository analysis today.
|
|
551
|
+
|
|
552
|
+
See [GitHub App integration notes](docs/integrations/github-app.md) for endpoints, settings and security details.
|
|
553
|
+
|
|
554
|
+
## Architecture
|
|
555
|
+
|
|
556
|
+
ANVIL is a TypeScript/Node.js application with a CLI entry point and focused core modules.
|
|
557
|
+
|
|
558
|
+
```text
|
|
559
|
+
Developer / CI
|
|
560
|
+
|
|
|
561
|
+
+----------------+----------------+
|
|
562
|
+
| | |
|
|
563
|
+
ANVIL CLI GitHub Action MCP clients
|
|
564
|
+
src/cli.ts action.yml stdio transport
|
|
565
|
+
| | |
|
|
566
|
+
+----------------+----------------+
|
|
567
|
+
|
|
|
568
|
+
ANVIL Core Engine
|
|
569
|
+
|
|
|
570
|
+
+----------------+------+-------+----------------+
|
|
571
|
+
| | | |
|
|
572
|
+
Intelligence Agents & Review & Evaluation &
|
|
573
|
+
& Analysis Orchestration Verification Experimentation
|
|
574
|
+
| | | |
|
|
575
|
+
+----------------+------+-------+----------------+
|
|
576
|
+
|
|
|
577
|
+
Local workspace state
|
|
578
|
+
.ANVIL/
|
|
579
|
+
|
|
|
580
|
+
Local Dashboard UI
|
|
581
|
+
src/core/dashboard-server.ts
|
|
582
|
+
```
|
|
583
|
+
|
|
584
|
+
### Repository layout
|
|
585
|
+
|
|
586
|
+
```text
|
|
587
|
+
ANVIL/
|
|
588
|
+
├── .ANVIL/ # Built-in evaluation data
|
|
589
|
+
├── .github/workflows/ # CI, release and sandbox workflows
|
|
590
|
+
├── api/
|
|
591
|
+
│ ├── _lib/ # GitHub App, OAuth and storage helpers
|
|
592
|
+
│ └── github/ # Install, auth, setup and webhook endpoints
|
|
593
|
+
├── docs/
|
|
594
|
+
│ ├── integrations/ # Claude Code and GitHub App guides
|
|
595
|
+
│ ├── providers.md # Provider setup and diagnostics
|
|
596
|
+
│ └── ANVIL-CAPABILITY-ROADMAP.md
|
|
597
|
+
├── public/
|
|
598
|
+
│ ├── index.html # Public product website
|
|
599
|
+
│ └── *.svg # ANVIL brand artwork
|
|
600
|
+
├── src/
|
|
601
|
+
│ ├── ai/ # Provider adapters
|
|
602
|
+
│ ├── core/ # Engineering workbench modules
|
|
603
|
+
│ ├── mcp/ # MCP server and workspace path policy
|
|
604
|
+
│ └── cli.ts # CLI entry point
|
|
605
|
+
├── tests/ # Unit and integration tests
|
|
606
|
+
├── action.yml # Reusable GitHub composite Action
|
|
607
|
+
├── CHANGELOG.md
|
|
608
|
+
├── CONTRIBUTING.md
|
|
609
|
+
├── LICENSE
|
|
610
|
+
├── package.json
|
|
611
|
+
├── README.md
|
|
612
|
+
└── SECURITY.md
|
|
613
|
+
```
|
|
614
|
+
|
|
615
|
+
### Core module map
|
|
616
|
+
|
|
617
|
+
| Module group | Responsibilities |
|
|
618
|
+
|---|---|
|
|
619
|
+
| Project intelligence | Inspection, code search, architecture maps, dependency graphs and impact |
|
|
620
|
+
| Quality and risk | Quality audits, health snapshots, engineering risk and change intelligence |
|
|
621
|
+
| Agent system | Agent registry, workspace context, skills, hooks, model routing and orchestration |
|
|
622
|
+
| Run lifecycle | Run persistence, task settlement, approvals, replay, resume and traces |
|
|
623
|
+
| Review lifecycle | Static/AI review, review history, patch validation, approval and staging |
|
|
624
|
+
| Verification | Script discovery, explicit verification, staged verification and history |
|
|
625
|
+
| Sandbox | Container runtime, security profiles, policy, compliance and cleanup audit |
|
|
626
|
+
| Evaluation | Evaluation suites, benchmarks, matrices, regression and experiment history |
|
|
627
|
+
| Agent improvement | Optimization plans, config snapshots, evolution and release gates |
|
|
628
|
+
| Workspace interface | Local dashboard, workspace browser and bounded MCP tools |
|
|
629
|
+
|
|
630
|
+
## Security model
|
|
631
|
+
|
|
632
|
+
ANVIL is designed to keep consequential operations explicit and inspectable.
|
|
633
|
+
|
|
634
|
+
- **Local-first by default:** the dashboard runs on loopback and reads the workspace selected by the CLI.
|
|
635
|
+
- **Bounded workspace access:** path resolution rejects traversal and symlinks; readers exclude hidden, generated, dependency and secret-like paths.
|
|
636
|
+
- **Read-only MCP tools:** the MCP server does not expose arbitrary shell execution or workspace writes.
|
|
637
|
+
- **Fail-closed policies:** malformed or unsupported permission policies are not treated as permission grants.
|
|
638
|
+
- **Review before promotion:** patch validation is a dry run; approval records bind to patch and source fingerprints; staging is separate from promotion.
|
|
639
|
+
- **Explicit verification:** the operator chooses which named check to run.
|
|
640
|
+
- **Redacted audit output:** credential-like matches are redacted by the static agent-configuration audit.
|
|
641
|
+
- **Opt-in Docker workflows:** Docker-backed verification and cleanup operations are separate and require explicit operator action.
|
|
642
|
+
|
|
643
|
+
> [!WARNING]
|
|
644
|
+
> ANVIL is an early-stage engineering tool. Local script verification executes project-controlled code on the host; it is **not** an OS sandbox. Docker security depends on the host runtime and selected configuration. Static audits and heuristic risk scores are not security certifications. AI review may send selected source excerpts to the provider you configure.
|
|
645
|
+
|
|
646
|
+
Read [SECURITY.md](SECURITY.md) before using ANVIL with untrusted repositories, agent instructions or project scripts.
|
|
647
|
+
|
|
648
|
+
## Current capabilities and boundaries
|
|
649
|
+
|
|
650
|
+
The v1.0 release establishes the local engineering workbench foundation.
|
|
651
|
+
|
|
652
|
+
| Area | v1.0 status |
|
|
653
|
+
|---|---|
|
|
654
|
+
| CLI and local workspace | Available |
|
|
655
|
+
| Interactive local dashboard | Available |
|
|
656
|
+
| Project/code/dependency intelligence | Available |
|
|
657
|
+
| Agent registry, skills, hooks and orchestration | Available |
|
|
658
|
+
| Review, patch validation and approval records | Available |
|
|
659
|
+
| Verification, regression and history | Available |
|
|
660
|
+
| Evaluation, benchmark and experiment workflows | Available |
|
|
661
|
+
| MCP server with bounded read-only tools | Available |
|
|
662
|
+
| Claude Code CLI provider adapter | Available |
|
|
663
|
+
| OpenAI, Anthropic, Google and Ollama adapters | Available |
|
|
664
|
+
| GitHub composite Action | Available |
|
|
665
|
+
| GitHub App installation and OAuth foundation | Available |
|
|
666
|
+
| Hosted repository scanning through the GitHub App | Not implemented |
|
|
667
|
+
| Hosted automatic pull-request creation | Not implemented |
|
|
668
|
+
| Hosted autonomous coding agents | Not implemented |
|
|
669
|
+
| Native Cursor/VS Code IDE extension | Not shipped |
|
|
670
|
+
| Hosted multi-user dashboard | Not shipped |
|
|
671
|
+
|
|
672
|
+
This table is intentional: a roadmap item is not a shipped feature. The project tracks planned work in the [ANVIL Capability Roadmap](docs/ANVIL-CAPABILITY-ROADMAP.md).
|
|
673
|
+
|
|
674
|
+
## Roadmap
|
|
675
|
+
|
|
676
|
+
ANVIL's direction is to grow into a complete, local-first agent engineering harness while preserving clear permission boundaries.
|
|
677
|
+
|
|
678
|
+
- **Agent and skill ecosystem:** expand specialist roles, skill packs, compatibility metadata and lifecycle management.
|
|
679
|
+
- **Memory and context:** structured memory layers with provenance, retrieval and retention controls.
|
|
680
|
+
- **Hooks and policy:** more lifecycle events, deterministic policy evaluation and auditable presets.
|
|
681
|
+
- **Planning and execution:** reusable workflows, checkpoints, cancellation and durable recovery.
|
|
682
|
+
- **Quality and verification:** independent review passes, verification profiles and evidence-linked reports.
|
|
683
|
+
- **Security:** broader configuration scanning, supply-chain checks and posture reports.
|
|
684
|
+
- **Integrations:** stable adapter interfaces and a truthful harness compatibility matrix.
|
|
685
|
+
- **Learning loop:** evidence-based lessons and regression-gated, human-approved configuration releases.
|
|
686
|
+
- **Operator experience:** unified setup/doctor/status commands, export/import and migration tools.
|
|
687
|
+
|
|
688
|
+
See [docs/ANVIL-CAPABILITY-ROADMAP.md](docs/ANVIL-CAPABILITY-ROADMAP.md) for the detailed delivery sequence and non-negotiable product rules.
|
|
689
|
+
|
|
690
|
+
## Development
|
|
691
|
+
|
|
692
|
+
### Clone and install
|
|
693
|
+
|
|
694
|
+
```bash
|
|
695
|
+
git clone https://github.com/anvil-workbench/ANVIL.git
|
|
696
|
+
cd ANVIL
|
|
697
|
+
npm ci
|
|
698
|
+
```
|
|
699
|
+
|
|
700
|
+
### Quality checks
|
|
701
|
+
|
|
702
|
+
```bash
|
|
703
|
+
npm run typecheck
|
|
704
|
+
npm test
|
|
705
|
+
npm run build
|
|
706
|
+
```
|
|
707
|
+
|
|
708
|
+
### npm scripts
|
|
709
|
+
|
|
710
|
+
| Script | Purpose |
|
|
711
|
+
|---|---|
|
|
712
|
+
| `npm run dev` | Run the TypeScript CLI during development |
|
|
713
|
+
| `npm run build` | Compile TypeScript into `dist/` |
|
|
714
|
+
| `npm run typecheck` | Type-check without emitting files |
|
|
715
|
+
| `npm test` | Run the Vitest test suite |
|
|
716
|
+
| `npm run test:watch` | Run Vitest in watch mode |
|
|
717
|
+
| `npm run mcp` | Start the built MCP server |
|
|
718
|
+
|
|
719
|
+
### Contributing
|
|
720
|
+
|
|
721
|
+
1. Open an issue to discuss substantial changes.
|
|
722
|
+
2. Keep pull requests focused and explain the user problem.
|
|
723
|
+
3. Add or update tests for behavior changes.
|
|
724
|
+
4. Document permission and security implications.
|
|
725
|
+
5. Never commit credentials, tokens, private keys or local workspace data.
|
|
726
|
+
6. Run type checking, tests and the production build before submitting.
|
|
727
|
+
|
|
728
|
+
Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
|
|
729
|
+
|
|
730
|
+
## Project history
|
|
731
|
+
|
|
732
|
+
ANVIL's v1.0.0 release brings the local CLI, dashboard, engineering intelligence, agent workflows, MCP integration, GitHub Action and GitHub App installation foundation into one versioned product.
|
|
733
|
+
|
|
734
|
+
The project is maintained as an original ANVIL codebase. ECC is a capability and documentation reference; ANVIL maintains its own identity, implementation, data models and roadmap.
|
|
735
|
+
|
|
736
|
+
For release-by-release changes, see [CHANGELOG.md](CHANGELOG.md).
|
|
737
|
+
|
|
738
|
+
## Project links
|
|
739
|
+
|
|
740
|
+
| Resource | Link |
|
|
741
|
+
|---|---|
|
|
742
|
+
| Product website | [ANVIL.vercel.app](https://ANVIL.vercel.app/) |
|
|
743
|
+
| Get the GitHub App | [Install ANVIL](https://ANVIL.vercel.app/api/github/install) |
|
|
744
|
+
| Source repository | [anvil-workbench/ANVIL](https://github.com/anvil-workbench/ANVIL) |
|
|
745
|
+
| Organization | [ANVIL WORKBENCH](https://github.com/anvil-workbench) |
|
|
746
|
+
| Releases | [GitHub Releases](https://github.com/anvil-workbench/ANVIL/releases) |
|
|
747
|
+
| Issues and bugs | [GitHub Issues](https://github.com/anvil-workbench/ANVIL/issues) |
|
|
748
|
+
| CI and automation | [GitHub Actions](https://github.com/anvil-workbench/ANVIL/actions) |
|
|
749
|
+
| Roadmap | [Capability Roadmap](docs/ANVIL-CAPABILITY-ROADMAP.md) |
|
|
750
|
+
| Changelog | [CHANGELOG.md](CHANGELOG.md) |
|
|
751
|
+
| Provider guide | [docs/providers.md](docs/providers.md) |
|
|
752
|
+
| GitHub App guide | [GitHub App integration](docs/integrations/github-app.md) |
|
|
753
|
+
| Security policy | [SECURITY.md](SECURITY.md) |
|
|
754
|
+
| Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
|
|
755
|
+
|
|
756
|
+
## Support
|
|
757
|
+
|
|
758
|
+
For questions about ANVIL or help with the GitHub App, contact [THEGODOFEARTH3@gmail.com](mailto:THEGODOFEARTH3@gmail.com).
|
|
759
|
+
|
|
760
|
+
## Maintainer
|
|
761
|
+
|
|
762
|
+
**Ansh** · [@AdityaaaTiwari](https://github.com/AdityaaaTiwari)
|
|
763
|
+
|
|
764
|
+
## License
|
|
765
|
+
|
|
766
|
+
ANVIL is open source under the [MIT License](LICENSE).
|
|
767
|
+
|
|
768
|
+
## Star history
|
|
769
|
+
|
|
770
|
+
<p align="center">
|
|
771
|
+
<a href="https://www.star-history.com/anvil-workbench/ANVIL">
|
|
772
|
+
<picture>
|
|
773
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=anvil-workbench/ANVIL&type=Date&theme=dark" />
|
|
774
|
+
<img src="https://api.star-history.com/svg?repos=anvil-workbench/ANVIL&type=Date" alt="ANVIL GitHub star history" width="100%" />
|
|
775
|
+
</picture>
|
|
776
|
+
</a>
|
|
777
|
+
</p>
|
|
778
|
+
|