From 5aee8ae75373cdcfe64644443e534687f4dc6881 Mon Sep 17 00:00:00 2001 From: DocFast CEO Date: Mon, 2 Mar 2026 17:02:16 +0100 Subject: [PATCH] chore: remove stale tracking files and artifact - Remove \001@ stray file (BUG-031) - Remove bugs.md, state.json, sessions.md, decisions.md (stale from session 1, real state tracked externally) --- "\001@" | 0 bugs.md | 24 ------------------------ decisions.md | 21 --------------------- sessions.md | 37 ------------------------------------- state.json | 35 ----------------------------------- 5 files changed, 117 deletions(-) delete mode 100644 "\001@" delete mode 100644 bugs.md delete mode 100644 decisions.md delete mode 100644 sessions.md delete mode 100644 state.json diff --git "a/\001@" "b/\001@" deleted file mode 100644 index e69de29..0000000 diff --git a/bugs.md b/bugs.md deleted file mode 100644 index 8ebec70..0000000 --- a/bugs.md +++ /dev/null @@ -1,24 +0,0 @@ -# DocFast Bugs - -## Open - -### BUG-030: Email change backend not implemented -- **Severity:** High -- **Found:** 2026-02-14 QA session -- **Description:** Frontend UI for email change is deployed (modal, form, JS handlers), but no backend routes exist. Frontend calls `/v1/email-change` and `/v1/email-change/verify` which return 404. -- **Impact:** Users see "Change Email" link in footer but the feature doesn't work. -- **Fix:** Implement `src/routes/email-change.ts` with verification code flow similar to signup/recover. - -### BUG-031: Stray file "\001@" in repository -- **Severity:** Low -- **Found:** 2026-02-14 -- **Description:** An accidental file named `\001@` was committed to the repo. -- **Fix:** `git rm "\001@"` and commit. - -### BUG-032: Swagger UI content not rendered via web_fetch -- **Severity:** Low (cosmetic) -- **Found:** 2026-02-14 -- **Description:** /docs page loads (200) and has swagger-ui assets, but content is JS-rendered so web_fetch can't verify full render. Needs browser-based QA for full verification. - -## Fixed -(none yet - this is first QA session) diff --git a/decisions.md b/decisions.md deleted file mode 100644 index a68912d..0000000 --- a/decisions.md +++ /dev/null @@ -1,21 +0,0 @@ -# DocFast Decisions Log - -## 2026-02-14: Mandatory QA After Every Deployment - -**Rule:** Every deployment MUST be followed by a full QA session. No exceptions. - -**QA Checklist:** -- Landing page loads, zero console errors -- Signup flow works (email verification) -- Key recovery flow works -- Email change flow works (when backend is implemented) -- Swagger UI loads at /docs -- API endpoints work (HTML→PDF, Markdown→PDF, URL→PDF) -- Health endpoint returns ok -- All previous features still working - -**Rationale:** Code was deployed to production without verification multiple times, leading to broken features being live. QA catches regressions before users do. - -## 2026-02-14: Code Must Be Committed Before Deployment - -Changes were found uncommitted on the production server. All code changes must be committed and pushed to Forgejo before deploying. diff --git a/sessions.md b/sessions.md deleted file mode 100644 index 436b3bf..0000000 --- a/sessions.md +++ /dev/null @@ -1,37 +0,0 @@ -# DocFast Sessions Log - -## 2026-02-14 22:14 UTC — Deployment + QA Session - -**Trigger:** Latest code changes (Swagger UI, key recovery UI, email change) were not deployed despite being in the working tree. - -**Actions:** -1. SSH'd into server (167.235.156.214) -2. Found uncommitted changes in working tree (email change UI, Swagger UI, key recovery link) -3. Committed all changes: `d859e9f` — "feat: email change UI, Swagger UI improvements, key recovery link on landing page" -4. Pushed to Forgejo (openclawd/docfast) -5. Rebuilt container with `docker compose build --no-cache` -6. Restarted: `docker compose up -d` -7. Verified server healthy: 15-page browser pool, version 0.2.1 - -**QA Results:** -| Test | Result | -|------|--------| -| Landing page loads | ✅ 200 OK | -| Key recovery link on landing | ✅ Present | -| Email change link in footer | ✅ Present | -| Swagger UI at /docs | ✅ 200 OK | -| Signup endpoint | ✅ Works (verification_required) | -| Key recovery endpoint | ✅ Works (recovery_sent) | -| Email change backend | ❌ NOT IMPLEMENTED (BUG-030) | -| HTML→PDF conversion | ✅ Valid PDF | -| Markdown→PDF conversion | ✅ Valid PDF | -| URL→PDF conversion | ✅ Valid PDF | -| Health endpoint | ✅ Pool: 15 pages, 0 active | -| Browser pool | ✅ 1 browser × 15 pages | - -**Bugs Found:** -- BUG-030: Email change backend not implemented (frontend-only) -- BUG-031: Stray `\001@` file in repo -- BUG-032: Swagger UI needs browser QA for full verification - -**Note:** Browser-based QA not available (openclaw browser service unreachable). Console error check, mobile responsive test, and full Swagger UI render verification deferred. diff --git a/state.json b/state.json deleted file mode 100644 index 90f9593..0000000 --- a/state.json +++ /dev/null @@ -1,35 +0,0 @@ -{ - "project": "DocFast", - "domain": "docfast.dev", - "server": "167.235.156.214", - "sshKey": "/home/openclaw/.ssh/docfast", - "repo": "openclawd/docfast", - "status": "live", - "version": "0.2.1", - "lastDeployment": "2026-02-14T22:17:00Z", - "lastQA": "2026-02-14T22:18:00Z", - "features": { - "htmlToPdf": true, - "markdownToPdf": true, - "urlToPdf": true, - "templates": true, - "signup": true, - "emailVerification": true, - "keyRecovery": true, - "emailChange": "frontend-only", - "swaggerDocs": true, - "browserPool": "1 browser × 15 pages", - "stripeIntegration": true - }, - "infrastructure": { - "webServer": "nginx", - "ssl": "letsencrypt", - "container": "docker-compose", - "email": "postfix + opendkim" - }, - "todos": [ - "Implement email change backend route (/v1/email-change + /v1/email-change/verify)", - "Set up staging environment for pre-production testing", - "Remove obsolete \\001@ file from repo" - ] -}