core-hub/STATE.md
tegwick f6758b91ce
Some checks failed
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / pytest-smoke (push) Failing after 2s
Build and Publish Container Image / build-and-push (push) Successful in 19s
feat: add migration export and write fencing
2026-08-21 17:07:53 +02:00

80 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# STATE — core-hub
**Updated:** 2026-08-21
**Domain:** infotech · **Repo:** core-hub · **Owner:** codex
## One-line posture
**Core Hub remains the verified production `/api/v2` authority on railiance01.
Hub-core S0S5 implementation is published at `8ab1d0c` with immutable image
digest `sha256:2a8b396c5295476d5ce865927b8309a6e054e50eac4e92175ef32cdeaba962fb`;
the next gate is the private production candidate and data import.**
## Production truth
| Surface | Current state |
| --- | --- |
| Public endpoint | `https://hub.coulomb.social``92.205.62.239` |
| Runtime | railiance01, Helm revision 4, chart `0.3.2` |
| Package | `rapp-core-hub`, verified and bound to `reef-railiance` |
| Image | Forgejo digest `sha256:0db6f7c646c6d4c1fbc844dc266fcf883584637e1c1f47802efe1c6a98558d3c` |
| Database | railiance01 `platform-pg`, database `core_hub`, schema `core_hub` |
| TLS | Let's Encrypt certificate Ready through 2026-11-18 |
| Consumers | ops-hub gate and activity-core resolver/evidence sink verified |
| Source fallback | CoulombCore production and staging Deployments at zero replicas; source DB read-only |
The relocation and retirement evidence is in
[`docs/evidence/core-hub-railiance01-stabilization-2026-08-21.md`](docs/evidence/core-hub-railiance01-stabilization-2026-08-21.md).
Deployment packaging and rollout truth lives in the `rapp-core-hub` repository.
## Workplans
| Workplan | Status | Result / next gate |
| --- | --- | --- |
| `CORE-WP-0001``CORE-WP-0009` | finished / archived | Gen3 runtime, contracts, persistence, consumer gates, and hardening delivered |
| `CORE-WP-0011` | finished | Production relocated to railiance01 and active CoulombCore runtime retired |
| `CORE-WP-0010` | active | S0S5 code done; private candidate/data gates next |
### Open work
| Task | Status | Dependency |
| --- | --- | --- |
| `CORE-WP-0010-T01` inventory | done | Inventory recorded in `docs/specs/runtime-absorption-inventory.md` |
| `CORE-WP-0010-T02` dual-run design | done | Route-group plan recorded in `docs/specs/runtime-absorption-plan.md` |
| `CORE-WP-0010-T03` absorption slices | progress | Deploy private candidate, import/compare data, run consumers |
| `CORE-WP-0010-T04` production cutover | wait | Absorption evidence and operator approval |
| `CORE-WP-0010-T05` archive | wait | Cutover complete and residual ownership recorded |
## Intent position
The operational reset promised by `INTENT.md` is real: the service is small,
containerized, contract-tested, credential-safe, observable, and deployed on
ordinary Kubernetes/PostgreSQL infrastructure. The larger Gen3 product intent
is only partly realized. Core Hub does not yet own the fleet's messaging,
progress/work projections, durable decision/deployment/outcome resources, or a
single extension runtime. Those gaps are not a reason to disturb the healthy
production runtime; they are inputs to the hub-core consolidation decision.
## Verify
```bash
make test
make lint
curl -fsS https://hub.coulomb.social/healthz
curl -fsS https://hub.coulomb.social/readyz
```
## Known conditions
- `CORE-WP-0011` is finished but has no State Hub UUID; the registrar warning is
retained rather than inventing an identifier.
- `.custodian-brief.md` is generated and may lag file-backed workplan truth.
- Hub-core runtime/compatibility/migration implementation is published at
`8ab1d0c`; its candidate image digest is recorded above. Public authority
stays here until the private data, conformance, consumer, and rollback gates
pass.
- `make lint` has baseline style findings in unchanged Python files; the full
suite passes all 26 tests after adding migration export and write fencing.
- The stopped CoulombCore workloads and read-only source database are retained
only as controlled fallback evidence.
- Do not archive this repository before `CORE-WP-0010` completes.