Tower DevOps Monitoring

The Tower dashboard surfaces project health telemetry directly in the admin UI, providing a single pane of glass for platform operations. Three widgets give platform admins real-time visibility into development progress, commit activity, and test coverage.

Widgets

TODO Aggregation

The Project Status widget parses BACKEND_TODO.md and FRONTEND_TODO.md to display:

• Overall progress bar — Aggregate completion percentage across all TODO files
• Per-file breakdown — Expandable sections showing open/completed counts per ### section
• Checkbox states: - [ ] (open), - [x] (completed), - [/] (in-progress, counted as open)

GraphQL Query:

query {
  projectStatus {
    totalOpen
    totalCompleted
    overallCompletionPct
    reports {
      file
      total
      open
      completed
      completionPct
      sections { name total open completed }
    }
  }
}

Git Activity Feed

Recent commits across all 4 Ngwenya repositories, merged and sorted by timestamp (newest first):

Each commit displays: short hash, author name, first line of message, relative timestamp, and a color-coded repo badge.

GraphQL Query:

query {
  gitActivity(limit: 15) {
    reposScanned
    reposAvailable
    commits { hash author message timestamp repo }
  }
}

Test Coverage Heatmap

Visual heatmap parsed from COVERAGE_REPORT.md:

• Aggregate metrics — Statement, branch, function, and line coverage percentages
• Per-service rows — Color-coded cells: 🟢 >70%, 🟡 40-70%, 🔴 <40%
• Sortable columns — Click any metric header to sort ascending/descending
• Tier badges — Excellent, Good, Moderate, Low classifications

GraphQL Query:

query {
  coverageOverview {
    aggregateStatements
    aggregateBranches
    aggregateFunctions
    aggregateLines
    lastAudited
    totalTests
    services { name statements branches functions lines suites tier }
  }
}

Architecture

Backend Module

The devops module in the Tower Rust subgraph consists of 3 file-system parsers:

apps/tower/src/devops/
├── mod.rs              # Module root + DevOpsConfig struct
├── todo_parser.rs      # Markdown checkbox regex parser
├── git_feed.rs         # git2-based commit log reader
└── coverage_parser.rs  # Coverage report table parser

All parsers are synchronous and file-system bound — no network I/O. They read from paths configured via environment variables and return parsed structs that are converted to GraphQL types via From implementations.

Configuration

Paths are relative to the Tower binary's working directory. For Docker environments, use absolute paths with volume mounts.

Security

All 3 queries are gated by require_auth() — the same authentication guard used by all existing Tower queries. Only users with the user header (set by the Gateway's propagateHeaders) can access these endpoints.

Graceful Degradation

Each parser handles missing files/repos gracefully:

• TODO parser: Returns empty reports if files don't exist
• Git feed: Skips repos that can't be opened, reports reposScanned vs reposAvailable
• Coverage parser: Returns zeroed overview if COVERAGE_REPORT.md is missing

Frontend Components

Both widgets are mounted on the Tower Overview tab, positioned between the Error Tracking and Quick Actions sections.

Related

• Tower Health Observability — Dual-layer health probing and PlatformHealthWidget
• Error Tracking (GlitchTip) — Error overview and crash-free rate
• Seed Infrastructure — Full platform seeding workflow
• Local Development Environment — Service startup and configuration