Timmy_Foundation/timmy-config
16
0
Fork 0
Code Issues 57 Pull Requests 1 Actions 1 Packages Projects Releases Wiki Activity

[ezra] #183: Canonical scaffold inventory and audit

Browse Source
This commit is contained in:
Ezra
2026-04-05 12:46:01 +00:00
parent 0029cf302b
commit 313049d1b8
1 changed files with 50 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
infra/matrix/SCAFFOLD_INVENTORY.md Normal file
View File

@@ -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