rust-faf-mcp 0.4.1 → 0.4.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.
Files changed (2) hide show
  1. package/README.md +20 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -6,15 +6,17 @@
6
6
 
7
7
  **Persistent Project Context for Rust MCP clients. Native. Fast. cargo install**
8
8
 
9
- **The one.faf Edition (v0.4.0)** — `one.faf/rust-faf-mcp` · **rmcp 3.0.1** (MCP Tier 1 foundation) · solid cargo-native Rust MCP for Rust devs
9
+ **The one.faf Edition (v0.4.2)** — `one.faf/rust-faf-mcp` · **rmcp 3.0.1** (MCP Tier 1 foundation) · solid cargo-native Rust MCP for Rust devs
10
+
11
+ **v0.4.2** — Registry card now emits the same context block as the JS fleet.
10
12
 
11
13
  **FAF defines. MD instructs. AI codes.**
12
14
 
13
15
  > Stop re-explaining your project to every AI session. One `.faf` file holds your persistent project context. Every AI reads it once and knows what you're building.
14
16
 
15
17
  [![Crates.io](https://img.shields.io/crates/v/rust-faf-mcp?style=flat-square)](https://crates.io/crates/rust-faf-mcp)
16
- [![FAF](https://mcpaas.live/badge/Wolfe-Jam/rust-faf-mcp.svg)](https://builder.faf.one)
17
- [![Tests](https://img.shields.io/badge/tests-112%20passing-brightgreen?style=flat-square)](https://github.com/Wolfe-Jam/rust-faf-mcp)
18
+ [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%F0%9F%8F%86%20100%25-000000?labelColor=FF6B35)](https://faf.one)
19
+ [![Tests](https://img.shields.io/badge/tests-117%20passing-brightgreen?style=flat-square)](https://github.com/Wolfe-Jam/rust-faf-mcp)
18
20
  [![IANA](https://img.shields.io/badge/IANA-registered-informational?style=flat-square)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
19
21
  [![License](https://img.shields.io/crates/l/rust-faf-mcp?style=flat-square)](LICENSE)
20
22
 
@@ -147,10 +149,10 @@ Tools return `serde_json::Value`. The server adapts them to `Result<String, Stri
147
149
 
148
150
  ## Testing
149
151
 
150
- 112 tests across 6 files:
152
+ 117 tests (113 integration + 4 unit):
151
153
 
152
154
  ```bash
153
- cargo test # runs all 112
155
+ cargo test # runs all 117
154
156
 
155
157
  # Full ship bar (same gates as GitHub CI — run before push)
156
158
  bash scripts/ci.sh
@@ -165,7 +167,8 @@ bash scripts/install-hooks.sh
165
167
  | `tier1_security.rs` | 12 | Path traversal, null bytes, shell injection, oversized input, malformed JSON |
166
168
  | `tier2_engine.rs` | 35 | Corrupt YAML, sync replacement, pipelines, dual manifests, legacy filenames, direct paths |
167
169
  | `tier3_edge_cases.rs` | 10 | Unicode, CJK, score boundaries, unknown fields, GitHub URL parsing |
168
- | `tier4_aero.rs` | 21 | Manifest structure, version sync, server.json, manifest-server cross-validation |
170
+ | `tier4_aero.rs` | 22 | Manifest structure, version sync, server.json, context block, manifest-server cross-validation |
171
+ | `src` unit | 4 | Skills extension digest + scoring resource |
169
172
 
170
173
  Tests spawn the compiled binary as a subprocess and communicate via stdin/stdout JSON-RPC — true integration tests against the real server.
171
174
 
@@ -198,12 +201,23 @@ If `rust-faf-mcp` has been useful, consider starring the repo — it helps other
198
201
 
199
202
  - [crates.io/crates/rust-faf-mcp](https://crates.io/crates/rust-faf-mcp)
200
203
  - [npmjs.com/package/rust-faf-mcp](https://www.npmjs.com/package/rust-faf-mcp) — `npx rust-faf-mcp` (no Rust toolchain; downloads GH Release binary)
204
+ - [Dual-package publish guide](https://github.com/Wolfe-Jam/mcp-better/blob/main/docs/DUAL-PACKAGE-RUST-MCP.md) — cargo + npm (this server is the product example)
205
+ - [docs/DUAL-PACKAGE.md](./docs/DUAL-PACKAGE.md) — pointer + OIDC docs for this repo
206
+ - [docs/SKILLS-OVER-MCP.md](./docs/SKILLS-OVER-MCP.md) — J1 Agent Skill `faf-context` (skills/list · digests)
201
207
  - [faf-rust-sdk](https://crates.io/crates/faf-rust-sdk) — the parser this depends on
202
208
  - [faf.one](https://faf.one) — FAF home
203
209
  - [IANA registration](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml) — `application/vnd.faf+yaml`
204
210
  - MCP Registry name: `mcp-name: one.faf/rust-faf-mcp`
205
211
  - [CHANGELOG](CHANGELOG.md)
206
212
 
213
+ ## Citation
214
+
215
+ If you use `rust-faf-mcp` or the `.faf` / `.fafa` formats in research or production, please cite the format papers:
216
+
217
+ > Wolfe, J. (2025). *Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding*. Zenodo. https://doi.org/10.5281/zenodo.18251362
218
+
219
+ > Wolfe, J. (2026). *Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era*. Zenodo. https://doi.org/10.5281/zenodo.21951641
220
+
207
221
  ## License
208
222
 
209
223
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rust-faf-mcp",
3
- "version": "0.4.1",
3
+ "version": "0.4.2",
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",