Compatibility and evolution
Compass is an independent native product. Its public behavior is defined by Compass documentation, native tests, and versioned Compass formats. It has no…
Compatibility and evolution
Compass is an independent native product. Its public behavior is defined by Compass documentation, native tests, and versioned Compass formats. It has no Graphify runtime or test dependency.
Product contract
The supported identity is:
| Surface | Contract |
|---|---|
| executable | compass |
| artifact root | compass-out/ |
| ignore file | .compassignore |
| project configuration | .compass/ |
| environment | COMPASS_* |
| MCP | server compass, resources compass://... |
There is no alternate legacy frontend or alias. Legacy names and stores are not read as fallback inputs.
Native evidence
Changes are checked by native unit, integration, CLI, protocol, format,
cross-platform, fuzz, sanitizer, and mutation tests. The root
COMPATIBILITY.md lists the standard verification
commands.
Intentional hard cutovers
Compass is early in its lifecycle and currently prefers a clean contract over backward-compatibility branches. When a format or schema is cut over:
- old data must be archived or removed;
- a fresh Compass build creates current artifacts;
- unknown major versions are rejected;
- migration documentation states the exact operator action.
See MIGRATION.md for the current cutovers.
Project lineage
Compass was inspired by Graphify. The projects now evolve independently; that attribution does not make Graphify part of Compass.
Command reference
This reference groups the public compass command surface by responsibility. Run compass <command --help for the exact options in the installed version; this…
Configuration reference
Compass configuration comes from explicit command options, environment variables, provider registries, repository history configuration, and generated…