compass

# Compass Compass is the first navigation layer for codebase work. It builds and queries a local knowledge graph with native commands. Use the graph to find the smallest relevant source set, then verify important conclusions in the cited source. ## Invocation contract If the user invokes `/compass --help` or `/compass -h` without another request, run `compass --help`, return its current command summary, and stop. Otherwise: 1. Treat an explicit user command as authoritative. 2. If no path is supplied for a build or refresh, use `.`. 3. Run `compass <command> --help` before inventing options or relying on a remembered flag. 4. Use the installed native `compass` executable. Never substitute another product, a Python module, or an unsupported command. 5. Keep the user's requested graph, revision, output directory, and provider explicit throughout the workflow. Do not silently fall back to another one. 6. For editor or automation integrations, run `compass capabilities --format json` before assuming a machine contract. Reject an unknown contract major instead of guessing a compatible shape. If `compass` is unavailable, report that fact and provide the exact command that would have been run. Do not emulate a successful Compass result with broad source searches. ## Select the evidence before acting Resolve these inputs first: - Source root: the supplied path, otherwise `.`. - Current graph: explicit `--graph`, otherwise `compass-out/graph.json`. - Historical...