anvil-engineering-workbench 1.1.1 → 1.1.2
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 +27 -0
- package/README.md +50 -40
- package/dist/cli.js +16 -3
- package/dist/cli.js.map +1 -1
- package/dist/core/code-review.js +21 -25
- package/dist/core/code-review.js.map +1 -1
- package/dist/core/policy-engine.d.ts +5 -5
- package/dist/core/policy-engine.js +5 -5
- package/dist/core/policy-engine.js.map +1 -1
- package/dist/mcp/server.js +255 -39
- package/dist/mcp/server.js.map +1 -1
- package/package.json +2 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# ANVIL Changelog
|
|
2
2
|
|
|
3
|
+
## 1.1.2 — MCP Ecosystem Hardening, Compact Tool Telemetry, Empirical Token Benchmarking & Inline Suppression Union
|
|
4
|
+
|
|
5
|
+
ANVIL 1.1.2 delivers comprehensive MCP ecosystem readiness, compact tool responses saving 90%+ model context tokens, empirical token footprint measurement, cross-platform Windows ESM fixes, and inline suppression rule unioning:
|
|
6
|
+
|
|
7
|
+
### Features & MCP Improvements
|
|
8
|
+
- **Compact MCP Responses by Default (`detail: false`):**
|
|
9
|
+
- Core inspection tools (`anvil_inspect_project`, `anvil_map_architecture`, `anvil_change_risk`, `anvil_git_intelligence`, `anvil_quality_audit`, `anvil_security_audit`, `anvil_clean_preview`) return concise summaries by default, protecting AI agent context windows.
|
|
10
|
+
- Every tool response includes structured telemetry in `_meta: { characterCount, estimatedTokens, compact, hint }`.
|
|
11
|
+
- Passing `detail: true` returns the full AST graph, itemized findings, and file breakdowns on demand.
|
|
12
|
+
- **Model-Optimized Tool Descriptions:**
|
|
13
|
+
- Enriched tool schemas in `src/mcp/server.ts` with explicit model directives detailing when to call, what data is returned, and boundary guarantees (read-only, no code execution).
|
|
14
|
+
- **Empirical Token Footprint Benchmark (`npm run bench`):**
|
|
15
|
+
- Introduced reproducible benchmark script (`scripts/measure-token-footprint.ts`) measuring unassisted file loading (~220,000 tokens) vs ANVIL compact MCP output (~2,189 tokens), achieving 96–99% context token reduction across realistic engineering tasks.
|
|
16
|
+
- **Agent Ecosystem Assets:**
|
|
17
|
+
- Added root `AGENTS.md` (operating guide for Cursor, Claude Code, Copilot, Windsurf, Antigravity).
|
|
18
|
+
- Added standard `llms.txt` and `public/llms.txt` documentation for AI search indexing.
|
|
19
|
+
- Added official MCP registry manifests `server.json` and `.well-known/mcp/server.json`, plus `smithery.yaml`.
|
|
20
|
+
- **Dynamic MCP Server Versioning:**
|
|
21
|
+
- MCP server dynamically resolves its version from `package.json` (`resolveVersion()`), verified in CI.
|
|
22
|
+
- **Cross-Platform CLI & Safe Auto-Start:**
|
|
23
|
+
- Fixed Windows ESM path resolution in `src/cli.ts` by using `pathToFileURL(script).href`.
|
|
24
|
+
- Guarded `anvil mcp`: displays usage and setup commands safely without hanging stdin on non-TTY calls; server runs only on explicit `anvil mcp start`.
|
|
25
|
+
- **Inline Suppression Rule Unioning:**
|
|
26
|
+
- Fixed regression in `code-review.ts` so that when both `anvil-disable-next-line` and `anvil-disable-line` apply to the same line, their suppressed rule sets and justification reasons are unioned rather than overwriting.
|
|
27
|
+
- **Accurate Sandbox Advisory Warnings:**
|
|
28
|
+
- Made sandbox resource fields (`profile`, `maxMemory`, etc.) optional in policy schema so advisory warnings are emitted only when users explicitly define resource ceilings.
|
|
29
|
+
|
|
3
30
|
## 1.1.1 — Governance Hardening: Disallowed Tools Matcher, SARIF inSource Suppressions & Suppression Reason Enforcement
|
|
4
31
|
|
|
5
32
|
ANVIL 1.1.1 introduces strict governance hardening, accurate disallowed tool evaluation, full SARIF in-source suppression metadata, and release consistency checks:
|
package/README.md
CHANGED
|
@@ -49,7 +49,7 @@
|
|
|
49
49
|
---
|
|
50
50
|
|
|
51
51
|
> [!NOTE]
|
|
52
|
-
> **ANVIL v1.1.
|
|
52
|
+
> **ANVIL v1.1.2 — AI harness foundation.** The local CLI, local dashboard, agent orchestration, MCP server, provider adapters, GitHub Action, automated self-healing cleaner, byte-accurate rollback (`anvil undo`), pre-commit hooks (`anvil hook install`), AI harness wizard (`anvil mcp setup`), Architecture Decision Records (`anvil adr`), Security & Secret Scanner (`anvil security --fix`), deterministic CI quality & security gate (`anvil gate` with SARIF v2.1.0 and policy-as-code), and live interactive workflow DAG runner are available. See [Current capabilities and boundaries](#current-capabilities-and-boundaries).
|
|
53
53
|
|
|
54
54
|
## What is ANVIL?
|
|
55
55
|
|
|
@@ -104,7 +104,7 @@ npm install --global anvil-engineering-workbench
|
|
|
104
104
|
Or install directly from the GitHub repository:
|
|
105
105
|
|
|
106
106
|
```bash
|
|
107
|
-
npm install --global git+https://github.com/anvil-workbench/ANVIL.git#v1.1.
|
|
107
|
+
npm install --global git+https://github.com/anvil-workbench/ANVIL.git#v1.1.2
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
Verify the installation:
|
|
@@ -150,7 +150,7 @@ npm --version
|
|
|
150
150
|
git --version
|
|
151
151
|
|
|
152
152
|
# Install ANVIL
|
|
153
|
-
npm install --global git+https://github.com/anvil-workbench/ANVIL.git#v1.1.
|
|
153
|
+
npm install --global git+https://github.com/anvil-workbench/ANVIL.git#v1.1.2
|
|
154
154
|
|
|
155
155
|
# Move into your project
|
|
156
156
|
cd C:\Users\YourName\Projects\my-project
|
|
@@ -463,65 +463,75 @@ ANVIL includes a local Claude Code CLI provider adapter. It uses the CLI install
|
|
|
463
463
|
|
|
464
464
|
See [Claude Code integration](docs/integrations/claude-code.md).
|
|
465
465
|
|
|
466
|
-
###
|
|
466
|
+
### Model Context Protocol (MCP) Server
|
|
467
467
|
|
|
468
|
-
|
|
468
|
+
ANVIL includes a zero-cloud Model Context Protocol (MCP) server that exposes codebase intelligence, architecture graphs, change risk, and security audits to AI developer tools such as **Claude Code, Cursor, Windsurf, VS Code, and Google Antigravity**.
|
|
469
469
|
|
|
470
|
-
|
|
470
|
+
#### 1-Minute Quick Setup
|
|
471
471
|
|
|
472
|
+
**Claude Code (Single command):**
|
|
473
|
+
```bash
|
|
474
|
+
claude mcp add anvil -- npx -y anvil-engineering-workbench mcp start
|
|
475
|
+
```
|
|
476
|
+
|
|
477
|
+
**Cursor (`.cursor/mcp.json`):**
|
|
472
478
|
```json
|
|
473
479
|
{
|
|
474
480
|
"mcpServers": {
|
|
475
|
-
"
|
|
476
|
-
"command": "
|
|
477
|
-
"args": ["
|
|
481
|
+
"anvil": {
|
|
482
|
+
"command": "npx",
|
|
483
|
+
"args": ["-y", "anvil-engineering-workbench", "mcp", "start"],
|
|
478
484
|
"env": {
|
|
479
|
-
"ANVIL_WORKSPACE": "
|
|
485
|
+
"ANVIL_WORKSPACE": "${workspaceFolder}"
|
|
480
486
|
}
|
|
481
487
|
}
|
|
482
488
|
}
|
|
483
489
|
}
|
|
484
490
|
```
|
|
485
491
|
|
|
486
|
-
|
|
487
|
-
|
|
492
|
+
**Interactive Multi-Editor Setup Wizard:**
|
|
488
493
|
```bash
|
|
489
|
-
|
|
494
|
+
# Auto-configures Cursor, VS Code, Windsurf, and Claude Code
|
|
495
|
+
anvil mcp setup --client all
|
|
490
496
|
```
|
|
491
497
|
|
|
492
|
-
|
|
498
|
+
#### Token Efficiency & Context Protection
|
|
493
499
|
|
|
494
|
-
|
|
500
|
+
AI coding models have bounded context windows. Loading dozens of raw source files just to inspect architecture or evaluate change risk wastes thousands of tokens.
|
|
495
501
|
|
|
496
|
-
ANVIL
|
|
502
|
+
ANVIL executes analysis entirely locally on CPU without LLM calls. By default, tools return **compact summaries** (`detail: false`), saving up to **90%+ of tokens** compared to unassisted mass file loading. Every response includes `_meta` character and token estimation metrics. Pass `detail: true` to any inspection tool if complete line-by-line graphs are needed.
|
|
497
503
|
|
|
498
|
-
|
|
499
|
-
npm run build
|
|
500
|
-
ANVIL_WORKSPACE=/absolute/path/to/project npm run mcp
|
|
501
|
-
```
|
|
504
|
+
See [Token Benchmark Results](docs/token-benchmark-results.md) for reproducible measurements on this repository.
|
|
502
505
|
|
|
503
|
-
|
|
506
|
+
#### Available MCP Tools
|
|
504
507
|
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
|
508
|
-
|
|
509
|
-
| `
|
|
510
|
-
| `
|
|
511
|
-
| `
|
|
512
|
-
| `
|
|
513
|
-
| `
|
|
514
|
-
| `
|
|
515
|
-
| `
|
|
516
|
-
| `
|
|
517
|
-
| `
|
|
518
|
-
| `
|
|
519
|
-
| `
|
|
520
|
-
| `
|
|
508
|
+
All tools are read-only, bounded, and execute locally within your workspace boundaries:
|
|
509
|
+
|
|
510
|
+
| Tool | Function | Compact Default |
|
|
511
|
+
|---|---|:---:|
|
|
512
|
+
| `anvil_inspect_project` | Project inventory: languages, frameworks, scripts, dependencies | Yes (`detail: false`) |
|
|
513
|
+
| `anvil_map_architecture` | Multi-language AST import graph across TS, Python, Go, Rust, Java, C++ | Yes (`detail: false`) |
|
|
514
|
+
| `anvil_change_risk` | Blast radius, downstream affected modules, and candidate test targets | Yes (`detail: false`) |
|
|
515
|
+
| `anvil_git_intelligence` | Working-tree git diff, uncommitted changes, and heuristic commit risk | Yes (`detail: false`) |
|
|
516
|
+
| `anvil_quality_audit` | Fast static project-quality checks across manifests and tests | Yes (`detail: false`) |
|
|
517
|
+
| `anvil_security_audit` | Deep scan for hardcoded secrets, API keys, and sensitive tokens | Yes (`detail: false`) |
|
|
518
|
+
| `anvil_clean_preview` | Safe preview scan of OS junk, build caches, and orphan source files | Yes (`detail: false`) |
|
|
519
|
+
| `anvil_search_code` | Search supported project source excluding .env and dependencies | - |
|
|
520
|
+
| `anvil_list_files` | List supported workspace files (bounded to 200 entries) | - |
|
|
521
|
+
| `anvil_read_file` | Read bounded text/source file (max 128 KiB, traversal protected) | - |
|
|
522
|
+
| `anvil_project_health` | Unified 0–100 health score & letter grade (A–F) | - |
|
|
523
|
+
| `anvil_list_agents` | List built-in and workspace specialist-agent roles | - |
|
|
524
|
+
| `anvil_create_review_plan` | Create a draft multi-specialist engineering review plan | - |
|
|
525
|
+
| `anvil_agent_intelligence` | Score agent performance from historical benchmark matrices | - |
|
|
526
|
+
| `anvil_remediation_plan` | Advisory dependency remediation plan with approval guardrails | - |
|
|
527
|
+
| `anvil_project_memory` | Read saved project decisions and architecture constraints | - |
|
|
528
|
+
| `anvil_agent_security_audit` | Audit agent instructions and permissions for injection risks | - |
|
|
529
|
+
| `anvil_dependency_impact` | Dependency blast radius & undeclared import analysis | - |
|
|
530
|
+
| `anvil_doctor` | Diagnostic health checks on Node runtime, Git, Docker, and policy | - |
|
|
521
531
|
|
|
522
532
|
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.
|
|
523
533
|
|
|
524
|
-
Some workspace browsing/search operations require an explicit restricted-mode allowlist in `.anvil/permissions.json`; the default proposal-only policy denies them.
|
|
534
|
+
Some workspace browsing/search operations require an explicit restricted-mode allowlist in `.anvil/permissions.json`; the default proposal-only policy denies them. See [MCP Server Guide](docs/mcp-server.md).
|
|
525
535
|
|
|
526
536
|
### GitHub Action
|
|
527
537
|
|
|
@@ -540,9 +550,9 @@ jobs:
|
|
|
540
550
|
runs-on: ubuntu-latest
|
|
541
551
|
steps:
|
|
542
552
|
- uses: actions/checkout@v4
|
|
543
|
-
- uses: anvil-workbench/ANVIL@v1.1.
|
|
553
|
+
- uses: anvil-workbench/ANVIL@v1.1.2
|
|
544
554
|
with:
|
|
545
|
-
version: v1.1.
|
|
555
|
+
version: v1.1.2
|
|
546
556
|
project-path: .
|
|
547
557
|
operation: gate
|
|
548
558
|
```
|
package/dist/cli.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import path from "node:path";
|
|
3
|
+
import { readFileSync } from "node:fs";
|
|
3
4
|
import { spawn } from "node:child_process";
|
|
4
5
|
import os from "node:os";
|
|
5
6
|
import { mkdtemp, rm, mkdir, writeFile } from "node:fs/promises";
|
|
@@ -131,7 +132,18 @@ function readAgentDurationBudgets() {
|
|
|
131
132
|
}
|
|
132
133
|
return budgets;
|
|
133
134
|
}
|
|
134
|
-
|
|
135
|
+
function resolveVersion() {
|
|
136
|
+
try {
|
|
137
|
+
const pkgUrl = new URL("../package.json", import.meta.url);
|
|
138
|
+
const raw = readFileSync(pkgUrl, "utf-8");
|
|
139
|
+
const parsed = JSON.parse(raw);
|
|
140
|
+
if (typeof parsed.version === "string")
|
|
141
|
+
return parsed.version;
|
|
142
|
+
}
|
|
143
|
+
catch { }
|
|
144
|
+
return "1.1.1";
|
|
145
|
+
}
|
|
146
|
+
const VERSION = resolveVersion();
|
|
135
147
|
const HELP = `
|
|
136
148
|
ANVIL — The AI Engineering Workbench
|
|
137
149
|
|
|
@@ -1239,9 +1251,10 @@ async function main(args) {
|
|
|
1239
1251
|
}
|
|
1240
1252
|
process.stdout.write(`\nYour AI harness is ready to use ANVIL tools!\n`);
|
|
1241
1253
|
}
|
|
1242
|
-
else if (subcommand === "server" || subcommand === "start") {
|
|
1254
|
+
else if (subcommand === "server" || subcommand === "start" || subcommand === "run") {
|
|
1255
|
+
const { pathToFileURL } = await import("node:url");
|
|
1243
1256
|
const script = resolveMcpServerScript();
|
|
1244
|
-
await import(script);
|
|
1257
|
+
await import(pathToFileURL(script).href);
|
|
1245
1258
|
}
|
|
1246
1259
|
else {
|
|
1247
1260
|
const script = resolveMcpServerScript();
|