docs(milestone): complete v0.4-operator-tier — v0.1.9 tagged, milestone release, merged to main

v0.4 (Operator Tier — Cohort Dashboard + Auth + Postgres) milestone complete.

Phases:
  ✓ P0  pre-execution (planning)        → v0.1.6
  ✓ P1  operator foundation (Postgres+auth+VC migration) → v0.1.7
  ✓ P2  cohort dashboard + aggregation   → v0.1.8
  ✓ P3  final review + ship              → v0.1.9 (= v0.4 milestone release)

Requirements covered (8/8):
  REQ-MT-01 (Postgres store), REQ-MT-02 (aggregation pipeline),
  REQ-AUTH-01 (operator auth), REQ-DASH-01 (cohort dashboard),
  REQ-NFR-AUTH-01 (auth NFRs), REQ-NFR-MT-01 (Postgres-in-LXC),
  REQ-NFR-DASH-01 (k-anonymity ≥10), REQ-NFR-DASH-02 (freshness ≤24h)

Grill MUSTs honored (6/6): G-008, G-011, G-027, G-031, G-038, G-041

Tests: 317 pytest pass, 36 skip (Postgres-requiring), 0 fail; 17/17 vitest pass
Review: APPROVE_WITH_NOTES (6/6 personas, 0 P0, 8 P1+ carry-forward)
Audit: HEALTHY (reconstruction PASS, 8/8 REQ, 6/6 grill)

---ci---
project: praxis
phase: 3
milestone: v0.4
status: complete
phase_role: final
milestone_complete: true
milestone_merged_to_main: true
tag: v0.1.9
requirements:
  covered: [REQ-MT-01, REQ-MT-02, REQ-AUTH-01, REQ-DASH-01, REQ-NFR-AUTH-01, REQ-NFR-MT-01, REQ-NFR-DASH-01, REQ-NFR-DASH-02]
  partial: []
---/ci---
This commit is contained in:
Praxis CI
2026-08-04 11:58:44 +00:00
parent d0f37e151e
commit f2a12f9fed
76 changed files with 12504 additions and 578 deletions
+52 -2
View File
@@ -53,8 +53,58 @@ CARTESIA_VOICE_ID=a3536a36-1d18-4efb-a95a-7c44b7b5e384
# PROXMOX_TEMPLATE_VOLID=local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst
# PROXMOX_LXC_VMID=auto
# PROXMOX_TLS_SKIP_VERIFY=true
# PROXMOX_MEMORY_MB=4096
# v0.4: bumped to 6144 (Postgres ~400MB + praxis ~500MB + Docker ~200MB
# + build headroom ~1GB + margin — REQ-NFR-MT-01).
# PROXMOX_MEMORY_MB=6144
# ─── CI/Gitea (operational — not voice) ───────────────────────────────────────
# GITEA_TOKEN is provisioned in .ciagent/.env.secrets (not this file).
# PRAXIS_VERSION (git ref to deploy, default: main)
# PRAXIS_VERSION (git ref to deploy, default: main)
# ─── v0.4 Operator Tier (Postgres + Auth) ────────────────────────────────────
# These configure the operator surface (cohort dashboard, auth, VC migration).
# Real values are secrets — put them in .ciagent/.env.secrets, not here.
# This file is documentation-only (committed); .env.secrets is gitignored.
# Postgres password. Secret. Used in the DSN below + docker-compose postgres
# service (POSTGRES_PASSWORD). Generate with: openssl rand -base64 32
PRAXIS_PG_PASSWORD=
# Postgres DSN (D-050). host=postgres is the docker-compose service DNS name
# on the praxis-net bridge. Format:
# postgresql://praxis:${PRAXIS_PG_PASSWORD}@postgres:5432/praxis
# When unset/empty, the server starts in graceful no-pool mode (learner voice
# loop works; operator auth + cohort endpoints return 503).
PRAXIS_PG_DSN=
# Cookie signing secret (D-056, R-AUTH-01). >=32 random bytes, base64 or hex.
# Secret. Generate with: openssl rand -base64 48
# When unset, the server generates an ephemeral random secret (dev ONLY —
# sessions won't survive a restart; NOT for pilot/production).
PRAXIS_COOKIE_SECRET=
# Cookie Secure flag (D-041, R-AUTH-01, G-031). Default true (HTTPS).
# Set to false ONLY for the HTTP pilot (no TLS in the LXC pilot — D-030).
# NOTE (G-031): the PRIMARY mitigation for a sniffed cookie is the k-anon
# defense-in-depth (the cohort dashboard reads only k-anonymized aggregates,
# so a sniffed operator cookie leaks NO learner PII). This flag is the
# SECONDARY mitigation (operational convenience for when TLS arrives).
PRAXIS_COOKIE_SECURE=true
# Bootstrap operator credentials (D-052). Secret. Used by
# scripts/create-operator.py on first run to create the initial operator.
# If either is missing, the CLI exits 1 (R-BOOT-02).
PRAXIS_BOOTSTRAP_OPERATOR_USER=
PRAXIS_BOOTSTRAP_OPERATOR_PASS=
# VC issuer root key (v0.3 + v0.4). Secret. Used by nacl.SecretBox to encrypt
# Ed25519 private keys at rest (D-042). In v0.4 the migration script
# (server/vc/migrate_keys.py) uses this to encrypt the fresh v0.4 keypair;
# the v0.3 root key is kept for the v0.3 SQLite verification path (R-VC-MIG-02).
# Generate with: python3 -c "import nacl.utils; print(nacl.utils.random(32).hex())"
PRAXIS_VC_ISSUER_KEY=
# Issuer URL (D-042). The public base URL for VC issuer + key identifiers.
# v0.4 changes the default to /issuers/v0.4 (v0.3 VCs keep their v0.3 URLs
# embedded in their proofs — verification fetches keys by id, not by URL).
PRAXIS_ISSUER_URL=https://praxis.example/issuers/v0.4