rust-faf-mcp 0.6.0 → 0.7.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 (2) hide show
  1. package/README.md +23 -16
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -6,9 +6,9 @@
6
6
 
7
7
  **Persistent Project Context for Rust MCP clients. Native. Fast. cargo install**
8
8
 
9
- **The AGENTS.md Edition (v0.6.0)** — `one.faf/rust-faf-mcp` · **rmcp 3.0.1** (MCP Tier 1 foundation) · **faf-rust-sdk 3.1** (the same always-33 kernel `faf-wasm-sdk` uses) · solid cargo-native Rust MCP for Rust devs
9
+ **The Table-of-8 Edition (v0.7.0)** — `one.faf/rust-faf-mcp` · **rmcp 3.0.1** (MCP Tier 1 foundation) · **faf-rust-sdk 3.1** (the same always-33 kernel `faf-wasm-sdk` uses) · solid cargo-native Rust MCP for Rust devs
10
10
 
11
- **v0.6.0** — adds `faf_agents`, a 10th tool: generates `AGENTS.md` from `project.faf`, non-destructively (preserves any hand-written content outside the faf-managed block). Ported line-for-line from `faf-cli`'s `generateAgentsMd()` — byte-for-byte parity is deliberate, so this MCP stays backward-compatible with any `faf-cli` output as it evolves. See [CHANGELOG](./CHANGELOG.md#060---2026-08-26--the-agentsmd-edition).
11
+ **v0.7.0** — Setup and Sweep confirm AI's side of the bargain. The Table-of-8 is human approved. See [CHANGELOG](./CHANGELOG.md#070---2026-09-01--the-table-of-8-edition).
12
12
 
13
13
  **FAF defines. MD instructs. AI codes.**
14
14
 
@@ -16,7 +16,7 @@
16
16
 
17
17
  [![Crates.io](https://img.shields.io/crates/v/rust-faf-mcp?style=flat-square)](https://crates.io/crates/rust-faf-mcp)
18
18
  [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%E2%9C%AA%20100%25-000000?labelColor=FF6B35)](https://faf.one)
19
- [![Tests](https://img.shields.io/badge/tests-133%20passing-brightgreen?style=flat-square)](https://github.com/Wolfe-Jam/rust-faf-mcp)
19
+ [![Tests](https://img.shields.io/badge/tests-171%20passing-brightgreen?style=flat-square)](https://github.com/Wolfe-Jam/rust-faf-mcp)
20
20
  [![IANA](https://img.shields.io/badge/IANA-registered-informational?style=flat-square)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
21
21
  [![License](https://img.shields.io/crates/l/rust-faf-mcp?style=flat-square)](LICENSE)
22
22
 
@@ -61,18 +61,23 @@ brew install Wolfe-Jam/faf/rust-faf-mcp
61
61
 
62
62
  ## One command, done forever
63
63
 
64
- `faf_auto` detects your project, creates a `.faf`, enhances it to max score, and syncs `CLAUDE.md` — in one shot:
64
+ `faf_auto` runs **setup** if `project.faf` is missing (tree detection writes mechanical facts), then syncs `CLAUDE.md`. It does not rewrite an existing file. **Confirm setup (sweeps)** lists what setup occupied — walk it; not a second write-gate. Empty human slots stay empty until you state them.
65
65
 
66
66
  ```
67
67
  faf_auto complete
68
68
  ━━━━━━━━━━━━━━━━━
69
- Score: 0% → 85% (+85) ◇ BRONZE
69
+ Score: 0% → 42% (+42) ● GREEN
70
70
  Steps:
71
- 1. Created project.faf
72
- 2. Second enhancement pass
73
- 3. Created CLAUDE.md
71
+ 1. Setup — created project.faf
72
+ 2. Created CLAUDE.md
74
73
 
75
74
  Path: /home/user/my-project
75
+
76
+ Confirm setup (sweeps)
77
+ Walk these. Detection is already a fact. Not a second write-gate.
78
+ project.name my-api
79
+ project.main_language Rust
80
+ stack.backend Rust
76
81
  ```
77
82
 
78
83
  What it produces:
@@ -109,8 +114,9 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
109
114
 
110
115
  | Tool | What it does |
111
116
  |------|-------------|
112
- | `faf_auto` | Zero to AI context in one command — init, enhance, sync, score, done |
113
- | `faf_init` | Create or enhance `project.faf` from `Cargo.toml`, `package.json`, `pyproject.toml`, or `go.mod` |
117
+ | `faf_auto` | Setup if missing, sync `CLAUDE.md`, score — Confirm setup (sweeps); does not invent 6Ws |
118
+ | `faf_init` | Setup: first write from the tree. Refuses if the file exists. Confirm setup (sweeps). 6Ws stay empty |
119
+ | `faf_go` | Table-of-8 + Confirm setup (sweeps). 6Ws score after ☑. Below 100: add Human Context. After 100: courtesy check every 30 days (90 max) |
114
120
  | `faf_git` | Generate `project.faf` from any GitHub repo URL — no clone needed |
115
121
  | `faf_discover` | Walk up the directory tree to find the nearest `project.faf` |
116
122
 
@@ -130,7 +136,7 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
130
136
  | `faf_compress` | Compress `.faf` for token-limited contexts (`minimal` / `standard` / `full`) |
131
137
  | `faf_tokens` | Estimate token count at each compression level |
132
138
 
133
- `faf_init` is iterative — run it again and it fills in what's missing. Score goes up each time.
139
+ `faf_init` will not overwrite an existing file. Setup occupies mechanical facts; Confirm setup (sweeps) is the walk. Empty human slots stay empty until `faf_go`.
134
140
 
135
141
  ## Architecture
136
142
 
@@ -138,7 +144,7 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
138
144
  src/
139
145
  ├── main.rs # ~20 lines — tokio entry, rmcp stdio transport
140
146
  ├── server.rs # FafServer: #[tool_router], ServerHandler, resources
141
- └── tools.rs # Business logic — all 10 tools, pure functions returning Value
147
+ └── tools.rs # Business logic — tools as pure functions returning Value
142
148
  ```
143
149
 
144
150
  - **Runtime**: `tokio` single-threaded (`current_thread`)
@@ -150,10 +156,10 @@ Tools return `serde_json::Value`. The server adapts them to `Result<String, Stri
150
156
 
151
157
  ## Testing
152
158
 
153
- 133 tests (117 integration + 16 unit):
159
+ 171 tests (136 integration + 35 unit):
154
160
 
155
161
  ```bash
156
- cargo test # runs all 133
162
+ cargo test # runs all 171
157
163
 
158
164
  # Full ship bar (same gates as GitHub CI — run before push)
159
165
  bash scripts/ci.sh
@@ -164,12 +170,13 @@ bash scripts/install-hooks.sh
164
170
  | File | Tests | Coverage |
165
171
  |------|-------|----------|
166
172
  | `mcp_protocol.rs` | 9 | Init handshake, tools/list, resources, schema validation, ID preservation |
167
- | `tools_functional.rs` | 28 | All 10 tools — happy path, error paths, language detection |
173
+ | `tools_functional.rs` | 31 | Tools — happy path, error paths, language detection, faf_go |
168
174
  | `tier1_security.rs` | 12 | Path traversal, null bytes, shell injection, oversized input, malformed JSON |
169
175
  | `tier2_engine.rs` | 36 | Corrupt YAML, sync replacement, pipelines, dual manifests, legacy filenames, direct paths |
170
176
  | `tier3_edge_cases.rs` | 10 | Unicode, CJK, score boundaries, unknown fields, GitHub URL parsing |
171
177
  | `tier4_aero.rs` | 22 | Manifest structure, version sync, server.json, context block, manifest-server cross-validation |
172
- | `src` unit | 16 | Skills extension digest + scoring resource, `agents::` generator (7), `inject::` non-destructive write (5) |
178
+ | `wjttc_setup.rs` | 16 | Setup / Confirm setup (sweeps) — BRAKE · ENGINE · AERO · TYRE · PIT |
179
+ | `src` unit | 35 | setup sweep, skills digest, `agents::`, `inject::`, intent, app-type |
173
180
 
174
181
  Tests spawn the compiled binary as a subprocess and communicate via stdin/stdout JSON-RPC — true integration tests against the real server.
175
182
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rust-faf-mcp",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "mcpName": "one.faf/rust-faf-mcp",
5
5
  "description": "Persistent project context — Rust-native MCP server. IANA-registered .faf format. npm shim downloads the native binary from GitHub Releases.",
6
6
  "license": "MIT",