rust-faf-mcp 0.5.1 → 0.7.0

package/README.md

@@ -6,9 +6,9 @@
 
 **Persistent Project Context for Rust MCP clients. Native. Fast. cargo install**
 
-**The Mk4 Truth Edition (v0.5.1)** — `one.faf/rust-faf-mcp` · **rmcp 3.0.1** (MCP Tier 1 foundation) · **faf-rust-sdk 3.0** (the same always-33 kernel `faf-wasm-sdk` uses) · solid cargo-native Rust MCP for Rust devs
+**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
 
-**v0.5.1** — patch: cleared 8 GitHub-flagged security advisories (`openssl` transitive dep bump, no source changes) and neutralized defensive-toned README/CHANGELOG copy. The v0.5.0 truth-fix itself: the public score now comes straight from the real Mk4 kernel, `faf-rust-sdk` pin caught up from `1.3` to `3`. (`faf-cli`'s own convergence onto this kernel is separate, tracked FAF 6.0 work.) See [CHANGELOG](./CHANGELOG.md#051---2026-08-26).
+**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).
 
 **FAF defines. MD instructs. AI codes.**
 
@@ -16,7 +16,7 @@
 
 [![Crates.io](https://img.shields.io/crates/v/rust-faf-mcp?style=flat-square)](https://crates.io/crates/rust-faf-mcp)
 [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%E2%9C%AA%20100%25-000000?labelColor=FF6B35)](https://faf.one)
-[![Tests](https://img.shields.io/badge/tests-118%20passing-brightgreen?style=flat-square)](https://github.com/Wolfe-Jam/rust-faf-mcp)
+[![Tests](https://img.shields.io/badge/tests-171%20passing-brightgreen?style=flat-square)](https://github.com/Wolfe-Jam/rust-faf-mcp)
 [![IANA](https://img.shields.io/badge/IANA-registered-informational?style=flat-square)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
 [![License](https://img.shields.io/crates/l/rust-faf-mcp?style=flat-square)](LICENSE)
 
@@ -61,18 +61,23 @@ brew install Wolfe-Jam/faf/rust-faf-mcp
 
 ## One command, done forever
 
-`faf_auto` detects your project, creates a `.faf`, enhances it to max score, and syncs `CLAUDE.md` — in one shot:
+`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.
 
 ```
 faf_auto complete
 ━━━━━━━━━━━━━━━━━
-Score: 0% → 85% (+85) ◇ BRONZE
+Score: 0% → 42% (+42) ● GREEN
 Steps:
-  1. Created project.faf
-  2. Second enhancement pass
-  3. Created CLAUDE.md
+  1. Setup — created project.faf
+  2. Created CLAUDE.md
 
 Path: /home/user/my-project
+
+Confirm setup (sweeps)
+Walk these. Detection is already a fact. Not a second write-gate.
+  project.name           my-api
+  project.main_language  Rust
+  stack.backend          Rust
 ```
 
 What it produces:
@@ -109,8 +114,9 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
 
 | Tool | What it does |
 |------|-------------|
-| `faf_auto` | Zero to AI context in one command — init, enhance, sync, score, done |
-| `faf_init` | Create or enhance `project.faf` from `Cargo.toml`, `package.json`, `pyproject.toml`, or `go.mod` |
+| `faf_auto` | Setup if missing, sync `CLAUDE.md`, score — Confirm setup (sweeps); does not invent 6Ws |
+| `faf_init` | Setup: first write from the tree. Refuses if the file exists. Confirm setup (sweeps). 6Ws stay empty |
+| `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) |
 | `faf_git` | Generate `project.faf` from any GitHub repo URL — no clone needed |
 | `faf_discover` | Walk up the directory tree to find the nearest `project.faf` |
 
@@ -120,6 +126,7 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
 |------|-------------|
 | `faf_score` | Score AI-readiness 0-100% with field-level breakdown |
 | `faf_sync` | Sync `project.faf` → `CLAUDE.md` (preserves existing content) |
+| `faf_agents` | Generate `AGENTS.md` from `project.faf` (non-destructive, preserves hand-written content) |
 
 ### Optimize
 
@@ -129,7 +136,7 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
 | `faf_compress` | Compress `.faf` for token-limited contexts (`minimal` / `standard` / `full`) |
 | `faf_tokens` | Estimate token count at each compression level |
 
-`faf_init` is iterative — run it again and it fills in what's missing. Score goes up each time.
+`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`.
 
 ## Architecture
 
@@ -137,22 +144,22 @@ Every AI agent reads this once and knows exactly what you're building. No 20-min
 src/
 ├── main.rs      # ~20 lines — tokio entry, rmcp stdio transport
 ├── server.rs    # FafServer: #[tool_router], ServerHandler, resources
-└── tools.rs     # Business logic — all 9 tools, pure functions returning Value
+└── tools.rs     # Business logic — tools as pure functions returning Value
 ```
 
 - **Runtime**: `tokio` single-threaded (`current_thread`)
 - **HTTP**: `reqwest` async (only used by `faf_git` for GitHub API)
-- **SDK**: `faf-rust-sdk` **3.0** (Cargo pin — the facade over `faf-kernel`/`faf-fafb` in [faf-rust](https://github.com/Wolfe-Jam/faf-rust); `score()` for the real Mk4 number, `validate()` for structural checks only)
+- **SDK**: `faf-rust-sdk` **3.1** (Cargo pin — the facade over `faf-kernel`/`faf-fafb` in [faf-rust](https://github.com/Wolfe-Jam/faf-rust); `score()` for the real Mk4 number, `validate()` for structural checks only)
 - **Server**: **`rmcp` 3.0.1** with `#[tool_router]` / `#[tool_handler]` — JSON-RPC, schema generation, stdio transport (Tier-1 assessed SDK cut)
 
 Tools return `serde_json::Value`. The server adapts them to `Result<String, String>` for rmcp's `IntoCallToolResult`.
 
 ## Testing
 
-118 tests (114 integration + 4 unit):
+171 tests (136 integration + 35 unit):
 
 ```bash
-cargo test    # runs all 118
+cargo test    # runs all 171
 
 # Full ship bar (same gates as GitHub CI — run before push)
 bash scripts/ci.sh
@@ -163,12 +170,13 @@ bash scripts/install-hooks.sh
 | File | Tests | Coverage |
 |------|-------|----------|
 | `mcp_protocol.rs` | 9 | Init handshake, tools/list, resources, schema validation, ID preservation |
-| `tools_functional.rs` | 25 | All 9 tools — happy path, error paths, language detection |
+| `tools_functional.rs` | 31 | Tools — happy path, error paths, language detection, faf_go |
 | `tier1_security.rs` | 12 | Path traversal, null bytes, shell injection, oversized input, malformed JSON |
-| `tier2_engine.rs` | 35 | Corrupt YAML, sync replacement, pipelines, dual manifests, legacy filenames, direct paths |
+| `tier2_engine.rs` | 36 | Corrupt YAML, sync replacement, pipelines, dual manifests, legacy filenames, direct paths |
 | `tier3_edge_cases.rs` | 10 | Unicode, CJK, score boundaries, unknown fields, GitHub URL parsing |
 | `tier4_aero.rs` | 22 | Manifest structure, version sync, server.json, context block, manifest-server cross-validation |
-| `src` unit | 4 | Skills extension digest + scoring resource |
+| `wjttc_setup.rs` | 16 | Setup / Confirm setup (sweeps) — BRAKE · ENGINE · AERO · TYRE · PIT |
+| `src` unit | 35 | setup sweep, skills digest, `agents::`, `inject::`, intent, app-type |
 
 Tests spawn the compiled binary as a subprocess and communicate via stdin/stdout JSON-RPC — true integration tests against the real server.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-faf-mcp",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "mcpName": "one.faf/rust-faf-mcp",
   "description": "Persistent project context — Rust-native MCP server. IANA-registered .faf format. npm shim downloads the native binary from GitHub Releases.",
   "license": "MIT",