surface_cataloguelisted

# surface_catalogue — read the repo from the map, not by grepping The `dr_*` catalogue is a scan of the host repo. Query it first to orient, not the tree. It is separate from Subfloor control-plane memory and from the product's runtime database. Inspect structure with `sc map-schema`; query data with `sc map-sql "…"`. NEVER map the repo yourself. The map stays fresh automatically (git hooks re-map on pull / branch-switch / rebase) and is owned by the **cartographer** shell. Empty / stale / wrong map -> flag the cartographer, don't re-map. | Table | Holds | |---|---| | `dr_repo` | the repo: name, root, remote, vcs, default_branch, file_count, mapped_at | | `dr_section` | the navigational index: `name`, `path_prefix`, `description` — "UI here / API here / docs here". Rendered in the boot `## CONNECTIONS` block; start here. | | `dr_filepath` | one row per file: `path`, `ext`, `lang`, `role` (code/doc/config/test/asset/env), `bytes`, `lines`, `desc` (cartographer one-liner, NULL until curated) | | `dr_dependency` | deps from the manifests: `manager` (npm/pip/poetry/go/cargo), `name`, `version`, `kind`, `source_file` | | `dr_env` | env-var names found in `.env.*` example files: `name`, `source_file` | | `dr_endpoint` | HTTP routes: `method`, `path`, `handler` (file:line), `framework`, `source_file` | | `dr_db_table` / `dr_db_column` | the app DB schema: tables/views + their columns (`type`, `pk`, `not_null`) | | `dr_route` / `dr_component` | UI routes (`path`, `kind`) + compone