{"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\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmJiNGFmOTRiMmY0ZmNmNmZjY2M0ZDNhYmQ3YzY0NGE2NzczYWJkMzM1NjFhNjQ4Y2Y0ZTVjY2ZkNzIwYzM2YWMiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTYwNyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTY1MCwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4MjkzNTAsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiNDk4ZWJhN2EtNjBmYS00NTFiLWFmNDUtNjVkM2ZjMGIxMjMyIiwibmJmIjoxNzk0ODI5MDUwLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.gxP6OEaVgtR3G4CsdAr-sNs_3cUtv8oewcjR40phfbFuw4C1eCxCpVKoLXI8Wn4XeyUatrrW0WzGDYjrLx68l-KbYLeRDGnS379FYb4aGxUSKqaYK6brd_nKtG1gmV-NV-jVfWyUmNgAbYbdQEuNr-KCIbMeCvUy-xuptFEC4g-cdsC8EL3CXX3LCF42hvfC3BeQ8HwWJbt8xUBvgE6Z96veNIR9iNZS_b1ykk4FmFlnsDnd5Xxs2q_S6m8f-xdoT8TURRg0EI0MGNNlklW5sa9vbqWyZKahzHDZsDCEG-59Pg-lsiew3f6XbB25K77V_MFRhQ0xAzgX6LB38R4DHg"}