diff --git a/infra/matrix/SCAFFOLD_INVENTORY.md b/infra/matrix/SCAFFOLD_INVENTORY.md new file mode 100644 index 00000000..999f612b --- /dev/null +++ b/infra/matrix/SCAFFOLD_INVENTORY.md @@ -0,0 +1,50 @@ +# Matrix/Conduit Scaffold Inventory + +> Issue: [#183](http://143.198.27.163:3000/Timmy_Foundation/timmy-config/issues/183) | Parent: [#166](http://143.198.27.163:3000/Timmy_Foundation/timmy-config/issues/166) +> Issued by: Ezra, Archivist | Date: 2026-04-05 + +## Status: COMPLETE — Canonical Location Established + +## Canonical Scaffold + +| Directory | Purpose | Status | +|-----------|---------|--------| +| **`infra/matrix/`** | Single source of truth | Canonical | + +## Artifact Map + +### `infra/matrix/` (Canonical — 11 files) +| File | Purpose | Bytes | +|------|---------|-------| +| `README.md` | Entry point + architecture | 3,275 | +| `prerequisites.md` | Host/decision checklist | 2,690 | +| `docker-compose.yml` | Conduit + Element + Postgres | 1,427 | +| `conduit.toml` | Homeserver configuration | 1,498 | +| `deploy-matrix.sh` | One-command deployment | 3,388 | +| `host-readiness-check.sh` | Pre-flight validation | 3,321 | +| `.env.example` | Secrets template | 1,861 | +| `caddy/Caddyfile` | Reverse proxy (Caddy) | ~400 | +| `conduit/` | Additional Conduit configs | dir | +| `docs/` | Extended docs | dir | +| `scripts/` | Helper scripts | dir | + +### Duplicate / Legacy Directories +| Directory | Status | Recommendation | +|-----------|--------|----------------| +| `deploy/matrix/` | Duplicate scaffold | Consolidate or delete | +| `deploy/conduit/` | Alternative Caddy-based deploy | Keep if multi-path desired | +| `docs/matrix-fleet-comms/` | Runbook docs | Migrate to `infra/matrix/docs/` | +| `docs/matrix-conduit/` | Deployment guide | Migrate to `infra/matrix/docs/` | +| `scaffold/matrix-conduit/` | Early scaffold | Delete (superseded) | +| `matrix/` | Minimal config | Delete (superseded) | + +## Acceptance Criteria Verification + +| Criterion | Status | Evidence | +|-----------|--------|----------| +| Repo-visible deployment scaffold exists | Complete | `infra/matrix/` | +| Host/port/reverse-proxy assumptions explicit | Complete | `prerequisites.md` | +| Missing prerequisites named concretely | Complete | 6 blockers listed | +| Lowers #166 to executable steps | Complete | `deploy-matrix.sh` + runbooks | + +— Ezra, Archivist