167 lines
7.1 KiB
Markdown
167 lines
7.1 KiB
Markdown
# Metacircular Platform Status
|
||
|
||
Last updated: 2026-03-28
|
||
|
||
## Platform Overview
|
||
|
||
One node operational (**rift**), running core infrastructure services as
|
||
containers fronted by MC-Proxy. MCIAS runs separately (not on rift).
|
||
Bootstrap phases 0–4 complete (MCIAS, Metacrypt, MC-Proxy, MCR all
|
||
operational). MCP is deployed and managing all platform containers. MCNS is
|
||
deployed on rift, serving authoritative DNS. Platform evolution Phases A–D
|
||
complete (automated port assignment, route registration, TLS cert
|
||
provisioning, and DNS registration). Multi-node deployment is being planned
|
||
(Phase E).
|
||
|
||
## Service Status
|
||
|
||
| Service | Version | SDLC Phase | Deployed | Node |
|
||
|---------|---------|------------|----------|------|
|
||
| MCIAS | v1.9.0 | Maintenance | Yes | (separate) |
|
||
| Metacrypt | v1.3.1 | Production | Yes | rift |
|
||
| MC-Proxy | v1.2.1 | Maintenance | Yes | rift |
|
||
| MCR | v1.2.1 | Production | Yes | rift |
|
||
| MCAT | v1.1.1 | Complete | Unknown | — |
|
||
| MCDSL | v1.4.0 | Stable | N/A (library) | — |
|
||
| MCNS | v1.1.1 | Production | Yes | rift |
|
||
| MCDoc | v0.1.0 | Production | Yes | rift |
|
||
| MCQ | v0.2.0 | Production | Yes | rift |
|
||
| MCP | v0.7.6 | Production | Yes | rift |
|
||
|
||
## Service Details
|
||
|
||
### MCIAS — Identity and Access Service
|
||
|
||
- **Version:** v1.9.0 (client library: clients/go/v0.2.0)
|
||
- **Phase:** Maintenance. Phases 0-14 complete. Feature-complete with active
|
||
refinement.
|
||
- **Deployment:** Running in production. All other services authenticate
|
||
against it.
|
||
- **Recent work:** WebAuthn/FIDO2 passkeys, TOTP 2FA, service-context login
|
||
policies, Nix flake for CLI tools.
|
||
- **Artifacts:** systemd units (service + backup timer), install script,
|
||
Dockerfile, example configs.
|
||
|
||
### Metacrypt — Cryptographic Service Engine
|
||
|
||
- **Version:** v1.3.1.
|
||
- **Phase:** Production. All four engine types implemented (CA, SSH CA, transit,
|
||
user-to-user). Active work on integration test coverage.
|
||
- **Deployment:** Running on rift as a container, fronted by MC-Proxy on
|
||
ports 443 (web, L7), 8443 (API, L4), and 9443 (gRPC, L4).
|
||
- **Recent work:** ACME integration tests (60+ tests), mcdsl migration,
|
||
security audit fixes.
|
||
- **Artifacts:** systemd units (service + web + backup timer), Docker Compose
|
||
(standard + rift), install script, example configs.
|
||
|
||
### MC-Proxy — TLS Proxy and Router
|
||
|
||
- **Version:** v1.2.1.
|
||
- **Phase:** Maintenance. Stable and actively routing traffic on rift.
|
||
- **Deployment:** Running on rift. Fronts Metacrypt, MCR, and sgard on ports
|
||
443, 8443, and 9443. Prometheus metrics on 127.0.0.1:9091. Routes persisted
|
||
in SQLite and managed via gRPC API.
|
||
- **Recent work:** Route persistence (SQLite), idempotent AddRoute (upsert),
|
||
golangci-lint v2 compliance, module path migration to mc/ org.
|
||
- **Artifacts:** systemd units (service + backup timer), Docker Compose
|
||
(standard + rift), install and backup scripts, rift config.
|
||
|
||
### MCR — Container Registry
|
||
|
||
- **Version:** v1.2.1. All implementation phases complete.
|
||
- **Phase:** Production. Deployed on rift, serving container images.
|
||
- **Deployment:** Running on rift as two containers (mcr API + mcr-web),
|
||
fronted by MC-Proxy on ports 443 (web, L7), 8443 (API, L4), and
|
||
9443 (gRPC, L4). Metacrypt is already pulling images from MCR.
|
||
- **Recent work:** Manifest push bug fix (LastInsertId unreliable after
|
||
upsert), structured slog error logging in OCI handlers, first production
|
||
deploy, Dockerfile fixes, server wiring, OCI route mounting.
|
||
- **Artifacts:** systemd units (service + web + backup timer), Dockerfiles
|
||
(API + web), Docker Compose (rift), install script, rift config.
|
||
|
||
### MCAT — Login Policy Tester
|
||
|
||
- **Version:** v1.1.1.
|
||
- **Phase:** Complete. Diagnostic tool, not core infrastructure.
|
||
- **Deployment:** Available for ad-hoc use. Lightweight tool for testing
|
||
MCIAS login policy rules.
|
||
- **Recent work:** Migrated to mcdsl for auth, config, CSRF, and web.
|
||
- **Artifacts:** systemd unit, install script, example config.
|
||
|
||
### MCDSL — Standard Library
|
||
|
||
- **Version:** v1.4.0.
|
||
- **Phase:** Stable. All 9 packages implemented and tested. Being adopted
|
||
across the platform.
|
||
- **Deployment:** N/A (Go library, imported by other services).
|
||
- **Packages:** auth, db, config, httpserver, grpcserver, csrf, web, health,
|
||
archive.
|
||
- **Adoption:** All services except mcias on v1.4.0. mcias pending.
|
||
|
||
### MCNS — Networking Service
|
||
|
||
- **Version:** v1.1.1.
|
||
- **Phase:** Production. Custom Go DNS server replacing CoreDNS precursor.
|
||
- **Deployment:** Running on rift as a container managed by MCP. Serves two
|
||
authoritative zones plus upstream forwarding. REST + gRPC APIs with MCIAS
|
||
auth and name-scoped system account authorization.
|
||
- **Recent work:** v1.0.0 implementation (custom Go DNS server), engineering
|
||
review, deployed to rift replacing CoreDNS.
|
||
- **Artifacts:** Dockerfile, Docker Compose (rift), MCP service definition,
|
||
systemd units, install script, example config.
|
||
|
||
### MCDoc — Documentation Server
|
||
|
||
- **Version:** v0.1.0.
|
||
- **Phase:** Production. Fetches and renders markdown documentation from Gitea.
|
||
- **Deployment:** Running on rift as a container, fronted by MC-Proxy on
|
||
port 443 (L7).
|
||
- **Recent work:** Initial implementation, Gitea content fetching, goldmark
|
||
rendering with syntax highlighting, webhook-driven refresh.
|
||
- **Artifacts:** Dockerfile, MCP service definition.
|
||
|
||
### MCP — Control Plane
|
||
|
||
- **Version:** v0.7.6.
|
||
- **Phase:** Production. Phases A–D complete. Deployed to rift, managing all
|
||
platform containers.
|
||
- **Deployment:** Running on rift. Agent as systemd service under `mcp` user
|
||
with rootless podman. Manages metacrypt, mc-proxy, mcr, mcns, and mcdoc
|
||
containers.
|
||
- **Architecture:** Two components — `mcp` CLI (thin client on vade) and
|
||
`mcp-agent` (per-node daemon with SQLite registry, podman management,
|
||
monitoring with drift/flap detection, route registration with mc-proxy,
|
||
automated TLS cert provisioning for L7 routes via Metacrypt CA, automated
|
||
DNS registration in MCNS). gRPC-only (no REST). 15 RPCs, 17+ CLI commands.
|
||
- **Recent work:** Phase C (automated TLS cert provisioning), Phase D
|
||
(automated DNS registration via MCNS), undeploy command, logs command,
|
||
edit command, auto-login to MCR, system account auth model, module path
|
||
migration.
|
||
- **Artifacts:** systemd service (NixOS), TLS cert from Metacrypt, service
|
||
definition files, design docs.
|
||
|
||
## Node Inventory
|
||
|
||
| Node | Address (LAN) | Address (Tailscale) | Role |
|
||
|------|---------------|---------------------|------|
|
||
| rift | 192.168.88.181 | 100.95.252.120 | Infrastructure services |
|
||
|
||
## Rift Port Map
|
||
|
||
Note: Services deployed via MCP receive dynamically assigned host ports
|
||
(10000–60000). The ports below are for infrastructure services with static
|
||
assignments or well-known ports.
|
||
|
||
| Port | Protocol | Services |
|
||
|------|----------|----------|
|
||
| 53 | DNS (LAN + Tailscale) | mcns |
|
||
| 443 | L7 (TLS termination) | metacrypt-web, mcr-web, mcdoc |
|
||
| 8080 | HTTP (all interfaces) | exod |
|
||
| 8443 | L4 (SNI passthrough) | metacrypt API, mcr API |
|
||
| 9090 | HTTP (all interfaces) | exod |
|
||
| 9443 | L4 (SNI passthrough) | metacrypt gRPC, mcr gRPC, sgard |
|
||
| 9091 | HTTP (loopback) | MC-Proxy Prometheus metrics |
|
||
|
||
Non-platform services also running on rift: **exod** (ports 8080/9090),
|
||
**sgardd** (port 19473, fronted by MC-Proxy on 9443).
|