Found while auditing the CLI surface against action.yml (v0.9.0).
action.yml describes the mode input as:
plan (default) maps the change to context files, likely impact, test routes, and review risks.
verify compares a saved plan against the diff that followed it and needs report-path.
Explain and compare are intentionally CLI/MCP-only because Action comments operate on complete reports.
But the CLI has no explain or compare subcommands - they exist only in the MCP server:
$ fixmap explain --path src/auth/reset-password.ts --issue "x" --repo .
node : Unknown command: explain
$ fixmap compare --previous a.json --current b.json
node : Unknown command: compare
The full CLI command list is: plan, verify, doctor, benchmark, watch, mcp.
Suggested fix
Either reword the action.yml description to "MCP-only", or add the two subcommands to the CLI. As written, users following action.yml's wording will try fixmap explain / fixmap compare and hit "Unknown command".
Found while auditing the CLI surface against
action.yml(v0.9.0).action.ymldescribes themodeinput as:But the CLI has no
explainorcomparesubcommands - they exist only in the MCP server:The full CLI command list is: plan, verify, doctor, benchmark, watch, mcp.
Suggested fix
Either reword the action.yml description to "MCP-only", or add the two subcommands to the CLI. As written, users following action.yml's wording will try
fixmap explain/fixmap compareand hit "Unknown command".