DocFast session 82: found BUG-085/086, examples URL fix in progress

This commit is contained in:
Hoid 2026-02-23 10:03:50 +00:00
parent d4a1f48585
commit 10482eb8c9
5 changed files with 78 additions and 5 deletions

View file

@ -900,3 +900,18 @@ Container restart appears to have been clean. All services came back online prop
- **Fix needed (immediate):** Apply fixes to `public/src/index.html` and `public/partials/` instead
- **Fix needed (long-term):** Consolidate to ONE build system. Either remove `templates/` or remove `public/src/`.
- **Status:** ✅ FIXED (FULLY) — commit b476b0b (immediate fix) + commit ca72f04 (long-term: deleted templates/pages/ and build-pages.js, consolidated to single build-html.cjs system).
## BUG-085: Examples page uses non-existent api.docfast.dev subdomain
- **Date:** 2026-02-23
- **Severity:** HIGH
- **Issue:** Node.js, Python, Go, PHP examples on /examples page reference `https://api.docfast.dev/v1/convert/html` and `https://api.docfast.dev/v1/convert/markdown`. The `api.docfast.dev` subdomain does not exist — correct URL is `https://docfast.dev/v1/...`. Developers following examples will get DNS errors.
- **Affected:** staging.docfast.dev/examples (and production once deployed)
- **Fix:** Replace all `api.docfast.dev` with `docfast.dev` in `public/src/examples.html`
- **Status:** 🔧 IN PROGRESS
## BUG-086: Examples page references non-existent SDK packages
- **Date:** 2026-02-23
- **Severity:** MEDIUM
- **Issue:** Go example says `go get github.com/docfast/docfast-go` (404 on GitHub). PHP example says `composer require docfast/docfast-php` (doesn't exist on Packagist). SDKs haven't been published yet — blocked on npm/PyPI/Go/Packagist tokens.
- **Fix:** Either publish SDKs or change examples to use plain HTTP (curl/fetch) without SDK install instructions until packages are published.
- **Status:** OPEN — blocked on SDK publishing tokens from investor

View file

@ -1794,3 +1794,23 @@
- Production tag approval (currently v0.4.3, staging will be v0.4.5+)
- npm/PyPI tokens for SDK publishing
- Google Search Console verification
## Session 82 — 2026-02-23 10:00 UTC (Monday Morning)
- **Production:** v0.4.3 ✅ healthy (97k+ seconds uptime)
- **Staging:** v0.4.5 (commit 9e288eb) — all session 81 changes deployed and verified ✅
- **Support:** Zero tickets
- **Session 81 verification:** Rate limit headers working (X-RateLimit-Limit/Remaining/Reset), DB cleanup ran on startup successfully
- **Findings:**
1. **BUG-085 (HIGH):** Examples page uses `api.docfast.dev` which doesn't exist — correct is `docfast.dev`. All SDK code examples have wrong API URLs. Developers following them will get DNS errors.
2. **BUG-086 (MEDIUM):** Go/PHP SDK install instructions reference packages that don't exist on GitHub/Packagist. Blocked on SDK publishing.
3. **Accessibility (LOW):** Zero `<label>` elements on landing page — form inputs in modals (recover, email change) lack proper labels. WCAG violation.
- **Spawned 1 sub-agent:**
- docfast-examples-urls: Fix api.docfast.dev → docfast.dev in all examples, replace non-existent SDK install commands with "coming soon" notes
- **Investor Test:**
1. Would a stranger trust this? ✅ (except broken example URLs)
2. Pod crash data loss? ✅ No
3. Free tier abuse? ✅ Free tier removed, demo rate-limited
4. Key recovery? ✅ Works
5. Website features work? ⚠️ Examples page has wrong URLs
- **Budget:** €181.71 remaining, Revenue: €9
- **Pending:** BUG-085 fix in progress, prod tag approval, SDK tokens, GSC verification

View file

@ -3,7 +3,7 @@
"phaseLabel": "Build Production-Grade Product",
"status": "launch-ready",
"product": "DocFast \u2014 HTML/Markdown to PDF API",
"currentPriority": "3 new commits pending CI deploy (db cleanup, rate limit headers, cleanup fix). Staging still on f17b483 (v0.4.5). CI runner needs to come online to build latest. Then get investor approval for prod tag. Still need npm/PyPI tokens to publish SDKs.",
"currentPriority": "Staging on 9e288eb with db cleanup + rate limit headers. All verified. Prod still v0.4.3. Need investor approval for prod tag. Still need npm/PyPI tokens to publish SDKs.",
"ownerDirectives_PRIORITY": "Process these IN ORDER. Do not skip. Remove items marked ✅ DONE/FIXED during housekeeping.",
"ownerDirectives": [
"Stripe Product ID for DocFast: prod_TygeG8tQPtEAdE — webhook handler must filter by this product_id to ignore events from other projects on the same Stripe account."
@ -76,12 +76,12 @@
},
"openBugs": {
"CRITICAL": [],
"HIGH": [],
"MEDIUM": [],
"HIGH": ["BUG-085: Examples page uses non-existent api.docfast.dev — IN PROGRESS"],
"MEDIUM": ["BUG-086: SDK install instructions reference non-existent packages — blocked on SDK tokens"],
"LOW": [],
"note": "All clear. SMTP is mail.cloonar.com:587 \u2014 tested and verified working."
},
"blockers": [],
"startDate": "2026-02-14",
"sessionCount": 81
"sessionCount": 82
}

View file

@ -1,5 +1,43 @@
# SnapAPI Session Log
## Session 14 — 2026-02-23 (Monday Health Check)
**Goal:** Monday check-in — verify production health, look for actionable improvements.
### What Was Done
1. **Production health verified:**
- Both pods running (k3s-w1, k3s-w2), 2d20h uptime, 0 restarts
- Health endpoint: OK, 8/8 browser pages available, 0 queue depth
- Playground tested: 200 OK
- All 10 pages return 200 (/, /docs, /health, /impressum.html, /privacy.html, /terms.html, /status.html, /openapi.json, /robots.txt, /sitemap.xml)
2. **Investigated empty OpenAPI paths on production:**
- Root cause confirmed: prod image (v0.4.3) has `apis: ["./src/routes/*.ts"]` but `./src/` doesn't exist in Docker container
- Already fixed on staging (commit `d20fbbf` added `./dist/routes/*.js` glob)
- Staging OpenAPI spec correctly returns all 8 endpoint paths
3. **Confirmed BUG-010 still affects production:**
- `/privacy`, `/terms`, `/impressum` return 404 (extensionless URLs)
- Already fixed on staging (commit `db1fa8d`)
4. **No new work spawned** — all actionable items remain blocked on investor decisions.
### Investor Test — Session 14
1. **Trust with money?** → YES (product works, playground demos well)
2. **Pod crash data loss?** → No (PostgreSQL, no in-memory state)
3. **Free tier abuse?** → Protected (5/hr/IP playground limit)
4. **Key recovery?** → Via Stripe (when webhook registered)
5. **Website features work?** → Core works; legal page URLs without .html extension 404 on prod (fixed on staging)
### Pending Investor Decisions (unchanged)
- **Tag v0.4.4+ for production** — fixes: browser restart 503s (BUG-007), FAQ accordion (BUG-008), copy improvement (BUG-009), privacy 404 (BUG-010), OpenAPI paths, SEO fundamentals
- **Stripe webhook URL** registration in dashboard
- **Forgejo token** with write:repository scope (CI/CD)
- **DNS for staging.snapapi.eu**
---
## Session 13 — 2026-02-22 (Sunday Health Check)
**Goal:** Sunday check-in — verify production health.

View file

@ -71,6 +71,6 @@
"priceId": "price_1T2XHpRtlDv9c8GoThHfd8kS"
}
},
"lastSession": "2026-02-20T14:00:00Z",
"lastSession": "2026-02-23T08:00:00Z",
"codeLocation": "Forgejo repo openclawd/SnapAPI. Clone: git clone forgejo-snapapi:openclawd/SnapAPI.git"
}