refactor(heartbeat): flip wire substrate value nemoclaw → ainfera_core

[hizrianraz]

Summary

Companion PR to ainfera-ai/ainfera-os sprint-v1.7-prep-founder-wip (Phase 2 substrate rename per [LOCK 11.1] · Decision A1a, forward-only flip).

Once ainfera-os deploys, the heartbeat shim will start sending "substrate": "ainfera_core" instead of "nemoclaw". This PR flips the api side to match:

• GET /v1/heartbeat/latest?substrate=... default → "ainfera_core" (was "nemoclaw"). Without this, the no-arg endpoint returns 404 once ainfera-os deploys.
• Docstrings + OpenAPI summaries updated to reference ainfera_core.
• Test fixtures (test_heartbeat, test_install_and_dashboard, test_signup_extended) flipped to "ainfera_core" / "ainfera_core+openclaw".
• Migration 20260515_0004 docstring updated.

Decision A1a (forward-only, no DB backfill)

• HeartbeatORM.substrate column type / index unchanged (no schema migration).
• Historical heartbeats.substrate='nemoclaw' rows preserved as point-in-time audit truth — that's what the substrate WAS named at that time; backfilling rewrites history.
• Avoids triggering [LOCK 6.4] Supabase DML gate (no UPDATE on heartbeats table).
• Queries spanning the rename boundary need to OR both values.

Preserved (out of scope)

• manwe-substrate literal in test_heartbeat.py:117 — Manwe's hermes-side substrate, was never ours.
• .claude/CLAUDE.md:18 NemoClaw + OpenClaw — NVIDIA stack per [LOCK 2.2] Varda framework.

Test plan

• All 6 .py files AST-parse clean
• Pre-commit gates (ruff, ruff format, mypy --strict, pytest -x) — all PASSED
• grep -rIn "nemoclaw\|NemoClaw" --exclude-dir=.claude . → 0 matches in api/
• CI: full pytest pass on PR (heartbeat + install_and_dashboard + signup_extended integration tests)
• Post-merge smoke: curl https://api.ainfera.ai/v1/heartbeat/latest (no arg) returns 200 once ainfera-os companion deploys, with substrate=ainfera_core

Cross-repo coupling

Pair with ainfera-ai/ainfera-os PR (Phase 2 rename). Either order works in steady state since substrate is opaque String(64); brief transitional 404 window for no-arg /v1/heartbeat/latest until both deploys land.

Not bundled

tests/integration/test_aamc_invariants.py has founder-in-flight changes locally and is intentionally NOT included in this PR (Memory #14 · no bundling with in-flight files).

🤖 Generated with Claude Code

---

Note

Low Risk
Low risk string/default flips, but it can change behavior of no-arg GET /v1/heartbeat/latest for deployments still sending/expecting substrate=nemoclaw. No schema or auth logic changes.

Overview
Updates the heartbeat API to treat ainfera_core as the primary substrate name: OpenAPI/docs now reference ainfera_core, and GET /v1/heartbeat/latest defaults to substrate=ainfera_core instead of nemoclaw.

Integration tests and fixtures are updated to post/assert substrate=ainfera_core (and framework=ainfera_core+openclaw where relevant), and the related Alembic revision docstring is adjusted accordingly.

^{Reviewed by Cursor Bugbot for commit 93543ea. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

You have used all Bugbot PR reviews included in your free trial for your GitHub account on this workspace.

To continue using Bugbot reviews, enable Bugbot for your team in the Cursor dashboard.