Declaration: If the folder I belong to changes, please update me, especially core domain concepts. Add examples or example file paths for abstract concepts when needed.

v2/debug-data Architecture Notes

Responsibilities

• Provide read-only debug access to base/table/field metadata.
• Build field relationship reports using dependency graph data.
• Expose a DI registration helper and a Node client factory (container-backed).

Files

• ARCHITECTURE.md - Role: folder architecture note; Purpose: describe the debug package scope.
• src/types.ts - Role: DTOs; Purpose: describe debug data payloads and report shapes.
• src/ports/DebugMetaStore.ts - Role: port; Purpose: abstract metadata read access.
• src/ports/FieldRelationGraph.ts - Role: port; Purpose: abstract dependency graph access.
• src/adapters/postgres/PostgresDebugMetaStore.ts - Role: adapter; Purpose: read metadata from Postgres (Kysely).
• src/adapters/postgres/PostgresFieldRelationGraph.ts - Role: adapter; Purpose: read dependency graph via Postgres adapter.
• src/service/DebugDataService.ts - Role: service; Purpose: provide debug queries and relation reports.
• src/di/register.ts - Role: DI wiring; Purpose: register debug services and adapters.
• src/index.ts - Role: package entry; Purpose: export public types and APIs.

Examples

• packages/v2/debug-data/src/service/DebugDataService.ts - Debug reads and relation report logic.
• packages/v2/debug-data/src/adapters/postgres/PostgresDebugMetaStore.ts - Metadata queries for table_meta/field.