IR v1

@executor/ir is the greenfield semantic center for imported sources.

Boundary

• CatalogSnapshotV1 is the canonical persisted import artifact.
• CatalogV1 is the normalized semantic graph.
• CatalogFragmentV1 is the adapter/importer output contract.
• ToolDescriptor, search docs, and inspect views are projections.

Direction

Importers should move toward:

source -> CatalogFragmentV1 -> merge -> CatalogV1 -> projectors

The existing runtime-specific compiled payload blobs are no longer the target semantic center.

Package Surface

Use either:

• @executor/ir

Guarantees

• provenance is required on entities
• synthetic entities are marked explicitly
• lossy normalization is represented by diagnostics
• inheritance is preserved in scopes and resolved at projection/planning time