{"report":{"v":1,"package":"grok-faf-mcp","version":"2.2.4","ranAt":"2026-11-16T11:42:20.135Z","install":{"ok":true,"integrity":"sha512-wMDctNRJa6QzyCDGhkRPanXUhuCz9e94mZTRqawPGMpb/yKSJgBGIUQ5yKFzLVrYM3dPlv9osvT0zHgxMIx6MA==","deps":114,"scripts":["grok-faf-mcp"],"bins":["grok-faf-mcp"],"license":"MIT","engines":"node >=22.0.0","repository":"git+https://github.com/Wolfe-Jam/grok-faf-mcp.git","bin":"grok-faf-mcp"},"start":{"ok":true,"ms":169,"serverName":"grok-faf-mcp","serverVersion":"2.2.4","protocol":"2025-06-18","stderr":"ℹ️  No global `faf` on PATH — not needed: grok-faf-mcp runs its bundled faf-cli for scoring.\n"},"tools":[{"name":"faf_score","description":"Score a project's AI-readiness 0–100% against the fixed 33-slot context model — how much project DNA an agent has before it has to guess. Deterministic: the same .faf always scores the same. Returns the score, tier, and per-slot breakdown.","params":["details"]},{"name":"refresh_faf","description":"Re-ground on the live .faf — re-read + re-score the current project DNA, report drift vs your last-known score, and return the fresh context. The explicit re-grounding primitive for long sessions: drift → refresh → re-grounded. Built for Grok, by request.","params":["baseline","path"]},{"name":"refresh_fafm","description":"Reload the latest structured memory (`.fafm`) for one or more souls into the current session. Returns a stamped delta by default (added/updated facts since last refresh or a given timestamp). Use `verbatim: true` to receive the full current `.fafm` content instead. Reads your files and writes a refresh receipt (.fafm-refresh-receipts.json) to the project folder. Always returns a content hash + timestamp stamp. Complements `recall`, `load_soul`, and `etch` — does not replace them.","params":["soul","verbatim","since"]},{"name":"faf_orchestrate_recommendation","description":"Heavy orchestrator — given current substrate state, returns a structured recommendation about drift: which refresh to call (or `no_action`), why, how severe, and the underlying signals. ADVISORY ONLY — never auto-fires. Composes the full 1.5 substrate (drift detection · contradiction check · repeat-offender · take-a-hint · refresh history). Writes a recommendation receipt on every call (auditable trail, no silent decisions). Read-only WRT substrate state.","params":[]},{"name":"faf_get_orchestration_policy","description":"Introspect the effective orchestration policy WITHOUT running the orchestrator. Returns `{ tier, thresholds, source, overrides_applied }` — what aggressiveness tier the next `faf_orchestrate_recommendation` call would use, and whether it came from defaults or a `.faf:orchestration:` override. No drift detection, no signals, no receipt — pure introspection. Read-only.","params":["path"]},{"name":"refresh_blend","description":"Baked-in two-intensity refresh (Cmd+R / Cmd+Shift+R analog). Fires BOTH `refresh_faf` + `refresh_fafm` in one call. `mode: \"blend\"` (default) = light `.faf` + delta `.fafm` — the everyday re-ground. `mode: \"nuke\"` = light `.faf` + verbatim `.fafm` — the hard reload for polluted session memory. Intensity matches drift rate per layer.","params":["mode","baseline","path","soul","since"]},{"name":"faf_init","description":"Create a project.faf — the IANA-registered context file (application/vnd.faf+yaml) that gives Grok persistent project DNA (stack, structure, intent) in one portable file, so an agent reads the whole project cold each session instead of re-discovering it. Writes project.faf to the target directory (created if missing) and refuses to overwrite an existing context file unless `force` is set. Run once at project start, or with `force` to regenerate, then call faf_score to check readiness. Returns a text confirmation with the written file path and the detected project type.","params":["force","directory","path","projectName"]},{"name":"faf_trust","description":"Validate a project.faf with faf-cli — confirm the context file is well-formed and parses cleanly before an agent grounds on it, and report its always-33 score. The pre-flight trust check: never build on a broken context layer.","params":["path"]},{"name":"faf_sync","description":"Sync project.faf into your AI context files: the ones that exist (CLAUDE.md, .cursorrules, .windsurfrules, .clinerules), or CLAUDE.md when there are none (target: all writes every one). Non-destructive: puts a structured .faf block at the top and keeps your own text; a file faf cannot safely write (not UTF-8, a link out of the project) is left unchanged and named in the reply. One way: never writes project.faf.","params":["target"]},{"name":"rag_query","description":"Ask a question with RAG-enhanced context from xAI Collections. Uses LAZY-RAG cache for 100,000x speedup on repeated queries.","params":["question"]},{"name":"rag_cache_stats","description":"Get LAZY-RAG cache statistics - hits, misses, hit rate, cache size","params":[]},{"name":"rag_cache_clear","description":"Clear the LAZY-RAG cache — drop all cached retrievals so the next rag_query rebuilds from source. Use when the underlying context has changed and you want fresh results instead of cached ones.","params":[]}],"toolsHash":"d633bb869e260d5d33df92fa91a6a99f94b8452878ee4c18011c666293d60bc9","wrote":[],"callsAt":"2026-11-16T11:42:26.098Z","calls":[{"tool":"faf_get_orchestration_policy","ok":true,"ms":4,"bytes":473},{"tool":"rag_cache_stats","ok":true,"ms":0,"bytes":168}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":12,"wrote":0,"callsTried":2,"callsAnswered":2,"callContacts":[]},"history":[{"package":"grok-faf-mcp","version":"2.2.4","ranAt":"2026-11-16T11:42:20.135Z","outcome":"started","tools":12,"contacts":0,"flags":0,"serious":0,"toolsHash":"d633bb869e260d5d33df92fa91a6a99f94b8452878ee4c18011c666293d60bc9"}],"page":"https://bragproof.smaverk.com/r/grok-faf-mcp"}