Tracium

время чтения ~1 мин.

AGENTS.md — discovery

Назначение уровня

Сервисная граница discovery — обнаружение «доступной поверхности» каждого supplier credential: warehouse scope, store list, available endpoints, supplier-specific quirks. Pre-condition для ingestion bulk strategy.

Содержание

discovery/
├── AGENTS.md     # ← вы здесь
└── README.md     # назначение, контракты, зависимости

Ключевые концепции уровня

  • Warehouse scope — supplier-side credential property (например ETM region 14). Auto-probe + persist.
  • Capability flags — feature detection (batch sizes, supported filters, rate limits).
  • Re-discovery cadence — periodic refresh, поскольку supplier-side state дрейфует.

Когда смотреть сюда

  • Новый supplier credential добавлен, ingestion возвращает 0 items — discovery не запустился.
  • ETM 403 throttle при auto-probe → seed warehouse_scope руками.
  • Capability flag отсутствует → разные стратегии bulk_snapshot.

Когда НЕ смотреть сюда

  • Сами ingestion ticks → ../ingestion/.
  • Authentication / token flows → ../credentials/.

Связано

  • ../credentials/ — discovery читает scope, пишет warehouse_scope.
  • ../ingestion/ — discovery предшествует bulk_snapshot, capability flags направляют router.

Вид графа