From ef924c3333a8f1f584ffcdaadb53a3e1d15f508f Mon Sep 17 00:00:00 2001 From: Conal <33135619+Conalh@users.noreply.github.com> Date: Fri, 29 May 2026 08:38:13 -0700 Subject: [PATCH] docs(fix): clarify that fix/fix pin only accept the JSON MCP surfaces The CLI table listed a single `` placeholder backed by all nine audited surfaces, but `` is only ever the `--canonical` argument to `fix` / `fix pin`, which reject everything except the five JSON MCP surfaces (root_mcp, cursor_mcp, vscode_mcp, codeium_mcp, windsurf_mcp). Split the docs into the audit surface set vs. the (narrower) set fix can align, so the README matches the code instead of implying `fix --canonical claude` works. Co-Authored-By: Claude Opus 4.8 --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c3f2bcd..5cf1299 100644 --- a/README.md +++ b/README.md @@ -170,7 +170,9 @@ Effective capability union: | `policymesh fix pin --canonical [--write]` | Align MCP `command` / `args` to a canonical surface. | | `policymesh render --input --format ` | Re-render a saved audit in another format. | -`` is one of: `root_mcp`, `cursor_mcp`, `vscode_mcp`, `codeium_mcp`, `windsurf_mcp`, `claude`, `codex`, `aider`, `instructions`. +PolicyMesh **audits** nine surfaces: `root_mcp`, `cursor_mcp`, `vscode_mcp`, `codeium_mcp`, `windsurf_mcp`, `claude`, `codex`, `aider`, and `instructions`. + +For `fix --canonical ` and `fix pin --canonical `, `` must currently be one of the five JSON MCP surfaces: `root_mcp`, `cursor_mcp`, `vscode_mcp`, `codeium_mcp`, or `windsurf_mcp`. The line-targeted JSON editor preserves comments and indentation on exactly these formats; aligning the Codex TOML, Claude, Aider, or instruction surfaces is not yet supported, and `fix` rejects them with an error rather than risk a lossy rewrite. ### GitHub Action inputs