repospace / RESULT.md
2Btainment's picture
docs: RESULT.md β€” RUNNING + E2E verification
25b2b69 verified
|
Raw History Blame Contribute Delete
2.22 kB
# RepoSpace β€” RESULT
**Date:** 2026-10-02 (Europe/Berlin)
**Space:** https://huggingface.co/spaces/2Btainment/repospace (private)
**App host:** https://2btainment-repospace.hf.space
**Owner:** 2Btainment (Rob Boss)
**SDK / hardware:** Docker Β· `cpu-basic`
**Runtime:** RUNNING (verified)
## Delivered
| Item | Status |
|------|--------|
| `/workspace/repospace/` full code | βœ… |
| Dockerfile + README (YAML) + SPEC.md | βœ… |
| FastAPI control plane | βœ… |
| SQLite sessions + 15 min inactivity teardown | βœ… |
| Constrained subprocess sandbox (no DinD / Firecracker) | βœ… |
| Reverse proxy `/s/{id}/` | βœ… |
| React UI (EN): RepoInputBar, StatusBadge, BuildTerminalBox, PreviewFrame | βœ… |
| Tests (URL validation, lifecycle, paths, rate limit, redact, API) | βœ… 20 passed |
| HF Space `2Btainment/repospace` private | βœ… |
| Live E2E smoke | βœ… |
## Live E2E (Space)
1. `GET /api/health` β†’ 200 `service=repospace`
2. `POST /api/sessions` with `https://github.com/mdn/beginner-html-site-styled`
3. Status `pending` β†’ `building` β†’ `running` (~3s)
4. Logs show tarball clone + `http.server` on port 9100
5. `GET /s/{id}/` β†’ 200 HTML preview (β€œMy test page”)
6. `DELETE /api/sessions/{id}` β†’ terminated
7. Landing UI `/` β†’ 200
Local E2E on box also succeeded before push.
## Honest HF deltas (vs META-BLUEPRINT)
- No EKS / Firecracker / MicroVMs β€” subprocess sandbox only
- FastAPI instead of Go control plane
- No Docker-in-Docker; Dockerfile-only repos get clear unsupported error
- Next.js full servers rejected with diagnosis hints
- Soft `resource` limits + timeouts + port pool; shared network namespace
## Security checks exercised
- Non-GitHub hosts rejected (400)
- Path traversal in owner/repo rejected
- Unknown session proxy β†’ 404
- Tokens/redaction via `[ERSATZ_KEY]` in docs/health
- Rate limiter unit-tested
## How to use
1. Open the private Space (logged in as 2Btainment)
2. Paste a public GitHub URL (static / simple Node build / simple Python preferred)
3. Watch build logs; when `running`, use the iframe or `/s/{id}/`
4. Idle sessions auto-stop after **15 minutes** (hard cap 60 min)
## Paths
- Source: `/workspace/repospace/`
- Spec: `SPEC.md`