Files
timmy-config/infra/matrix/SCAFFOLD_INVENTORY.md

2.1 KiB

Matrix/Conduit Scaffold Inventory

Issue: #183 | Parent: #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