---
title: Matrx AI Provider Catalog Sync
description: Tracks the stable provider-sync code while keeping generated model catalogs local.
status: active
last_updated: 2026-08-15
---

# Matrx AI Provider Catalog Sync

Provider sync utilities write generated model catalogs under
`matrx_ai/local_data/`. The package seam is deliberately split:

- `local_data/__init__.py` and `local_data/paths.py` are source code and MUST be
  tracked so a clean checkout can import every provider sync module.
- `*_data.py`, `*_data.ts`, and `data_history.json` are generated machine-local
  payloads and MUST remain ignored by `local_data/.gitignore`.
- The repository-root `local_data/` scratch directory is ignored with an
  anchored `/local_data/` rule. Never use an unanchored `local_data/` rule; it
  silently removes this package from clean checkouts while dirty worktrees keep
  importing successfully.

## Verification

Run the import-surface checker from a clean checkout. Local imports are not
proof because ignored files can mask missing tracked package modules.

## Changelog

- 2026-08-15: Restored the tracked package seam after the root ignore rule
  masked 21 unresolved imports in clean checkouts.
