Resource Infra Ops

Service page for diagnostics and ingestion monitoring. User-facing map controls remain minimal in Map.

Dedicated Screens /topos/resource_infra_public_status_page.php /topos/resource_infra_external_imports_page.php /topos/telemetry_ops_page.php /topos/EXTERNAL_SOURCE_UNAVAILABLE_REPORT.md /topos/RESOURCE_INFRA_EXTERNAL_SOURCES_COMPLETION.md /topos/RESOURCE_INFRA_LAYER_STATUS.md /topos/data/processed/resource_infra/latest_coverage_backlog_machine.json /topos/data/processed/resource_infra/latest_coverage_backlog_machine.csv /topos/data/processed/resource_infra/latest_coverage_backlog_machine_meta.json /topos/data/processed/resource_infra/external_sources_completion_latest.json /topos/data/processed/resource_infra/layer_status_snapshot_latest.json /topos/api/v1/layers/resource_infra/backlog_machine_meta /topos/api/v1/layers/resource_infra/external_sources_completion_meta /topos/api/v1/layers/resource_infra/layer_status_snapshot_meta /topos/api/v1/layers/resource_infra/reports_freshness_meta?max_age_seconds=172800 /topos/api/v1/layers/resource_infra/ops_health_rollup?hours=24&max_age_seconds=172800
Why this page exists

Advanced controls (coverage diagnostics, source health, ingest backlog, QA exports) were moved out of the public map control to keep the map UI simple: only category checkboxes and basic show/hide actions.

Ops APIs
/topos/api/layers/resource_infra/status /topos/api/layers/resource_infra/coverage /topos/api/layers/resource_infra/freshness /topos/api/layers/resource_infra/progress /topos/api/layers/resource_infra/external_coverage /topos/api/layers/resource_infra/internal_only_roadmap
/topos/api/layers/resource_infra/source_health /topos/api/layers/resource_infra/growth_timeline /topos/api/layers/resource_infra/source_blockers /topos/api/layers/resource_infra/source_health_detail /topos/api/layers/resource_infra/ingest_runs /topos/api/layers/resource_infra/ingest_failures /topos/api/layers/resource_infra/external_import_summary
/topos/api/layers/resource_infra/coverage_backlog /topos/api/layers/resource_infra/coverage_candidates /topos/api/layers/resource_infra/coverage_plan /topos/api/layers/resource_infra/geometry_quality /topos/api/layers/resource_infra/qa_duplicates

v1 diagnostics parity shortcuts:

/topos/api/v1/layers/resource_infra/growth_timeline /topos/api/v1/layers/resource_infra/source_blockers
/topos/api/v1/layers/resource_infra/qa_duplicates /topos/api/v1/layers/resource_infra/geometry_quality
Feature Flags Registry

Visible registry of enabled/hidden behaviors and removal criteria.

/topos/api/v1/feature_flags /topos/api/v1/layers/resource_infra/map_ui_contract_status
Loading...
Map Layer Profiling (Auto)

p95 latency, 422/500 rate and payload size for map layer requests.

/topos/api/v1/layers/resource_infra/map_profile?hours=24
Loading...
Map Layer Alerts (Trend Guard)

Threshold guard for p95 latency and 422/500 rates.

/topos/api/v1/layers/resource_infra/map_profile_alerts?hours=24
Loading...
Unified Telemetry Summary

Shared summary for agent-layer + map-layer events.

/topos/api/v1/telemetry/summary?hours=24&top=20
Loading...
Public Resource Layer Status

Single public report: coverage + sources + backlog + import diagnostics.

/topos/api/v1/layers/resource_infra/public_status
Loading...
Stability Gate

Operational gate: PASS/WARN/ALERT before enabling additional feature load.

/topos/api/v1/layers/resource_infra/stability_gate?hours=24
Loading...
Import Diagnostics (External Objects)

Clear reasons why external imports did not load, with top corrective actions.

/topos/api/v1/layers/resource_infra/import_diagnostics?hours=168&limit=20
Loading...
Growth Timeline Preview

Quick live snapshot from /layers/resource_infra/growth_timeline.

Loading...
Shows summary, top sources/categories and latest overall buckets.
Source Blockers Preview

Live blocker counters and API-defined fix order from /layers/resource_infra/source_blockers.

Loading...
Displays counts + fix_order + top blocker rows.
Source Health Preview

Live risk/SLA snapshot from /layers/resource_infra/source_health.

Loading...
Shows summary counters + top source rows with quick detail links.
Coverage Backlog Preview

Live triage list from /layers/resource_infra/coverage_backlog.

Loading...
Shows category priority, gaps, next step and action hints.
Coverage Candidates Preview

External expansion candidates from /layers/resource_infra/coverage_candidates.

Loading...
Shows candidate categories, gaps, penalties and suggested next actions.
Coverage Plan Preview

Action plan synthesis from /layers/resource_infra/coverage_plan.

Loading...
Shows grouped plan steps, command set and forum/exchange draft previews.
Ops Snapshot Preview

Current readiness/alerts/recommendations from /layers/resource_infra/ops_snapshot.

Loading...
Shows readiness score, health counters, alerts and recommended actions.
Freshness Preview

Staleness and missing-last-ok diagnostics from /layers/resource_infra/freshness.

Loading...
Shows freshness summary and top stale categories by source.
Geometry QA Preview

Geometry quality diagnostics from /layers/resource_infra/geometry_quality.

Loading...
Shows flagged routes and issue breakdown (long segments / low detail / mixed).
Ingest Runs Preview

Recent ingest execution quality from /layers/resource_infra/ingest_runs.

Loading...
Shows run counters, error share and top recent runs with inserted/updated/skipped rows.
Ingest Failures Preview

Recent ingestion failures from /layers/resource_infra/ingest_failures.

Loading...
Shows top failure sources/categories and compact error excerpts.
QA Duplicates Preview

Duplicate-group diagnostics from /layers/resource_infra/qa_duplicates.

Loading...
Shows duplicate groups by normalized name/type/country and top duplicate density rows.
Legacy vs v1 Parity Check

Quick parity verification for key diagnostics endpoints across /layers and /v1/layers.

Loading...
Compares HTTP status and top-level data shape for diagnostics endpoints; includes auto-refresh and last-run timestamp.