Skip to content

Add heartbeat resource telemetry to gg build stages#55

Merged
mark-e-deyoung merged 1 commit intomainfrom
feat/heartbeat-resource-telemetry
Feb 21, 2026
Merged

Add heartbeat resource telemetry to gg build stages#55
mark-e-deyoung merged 1 commit intomainfrom
feat/heartbeat-resource-telemetry

Conversation

@mark-e-deyoung
Copy link
Contributor

Summary

Adds heartbeat resource telemetry for long-running gg stages so humans/agents can observe progress, liveness, and bounded resource usage during builds.

Changes

  • scripts/gg
    • new env toggle: SUPRAGOFLOW_HEARTBEAT_RESOURCE=1|0 (default 1)
    • heartbeat now logs:
      • child process CPU%, memory%, RSS/VSZ, elapsed, state
      • host memory usage
      • host load averages (1m/5m/15m)
      • disk used/available/percent at repo root
  • README.md
    • documents heartbeat resource telemetry and toggle
  • POLICY.md
    • codifies heartbeat resource telemetry expectation
  • scripts/check-policy-conformance.sh
    • enforces telemetry policy statement presence

Validation

  • bash -n scripts/gg
  • ./scripts/check-policy-conformance.sh
  • ./scripts/gg self-test
  • heartbeat output verified via SUPRAGOFLOW_HEARTBEAT_SEC=1 SUPRAGOFLOW_HEARTBEAT_RESOURCE=1 ./scripts/gg lint

@mark-e-deyoung mark-e-deyoung merged commit b03fef0 into main Feb 21, 2026
3 checks passed
@mark-e-deyoung mark-e-deyoung deleted the feat/heartbeat-resource-telemetry branch February 21, 2026 11:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant