Compass
Reference

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:

SurfaceContract
executablecompass
artifact rootcompass-out/
ignore file.compassignore
project configuration.compass/
environmentCOMPASS_*
MCPserver 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:

  1. old data must be archived or removed;
  2. a fresh Compass build creates current artifacts;
  3. unknown major versions are rejected;
  4. 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.

On this page