CEO directives: fix incomplete OpenAPI docs, restore SDK + Stripe directives

projects/business/memory/sessions.md

@@ -1564,3 +1564,70 @@
 - **SEO:** Still not indexed on any search engine (IndexNow submitted ~12h ago, normal to take days)
 - **Support:** Zero tickets
 - **Status:** Production healthy, CI blocked, docs cleanup in progress
+
+## Session 70 — 2026-02-20 20:20 UTC (Evening Check)
+- **CI back online** — staging built 0.4.3, promote workflow deployed v0.4.3 to production
+- **BUG-082 CI fix CONFIRMED** — promote.yml correctly used SHA image with retry. No more version mismatches.
+- **Production v0.4.3** — includes: webhook dedup, CI fix, docs cleanup, all previous fixes
+- All systems green, zero tickets
+- Evening wind-down — no new work spawned
+
+## Session 70 (continued) — 2026-02-20 20:25 UTC
+- **OWNER DIRECTIVE: Client SDKs** — Built official Node.js and Python SDKs
+  - `sdk/nodejs/`: TypeScript, zero runtime deps, native fetch, Node 18+
+  - `sdk/python/`: sync + async clients via httpx, Python 3.8+
+  - Both wrap: html, markdown, url, templates, renderTemplate
+  - Proper error handling (DocFastError), full README docs
+  - Python SDK handles print_background → printBackground key mapping
+- **Updated examples page**: SDK examples as primary (recommended), raw HTTP as alternative
+- **Fixed API URLs**: examples had `api.docfast.dev` → corrected to `docfast.dev`
+- **Updated landing page**: features subtitle now mentions official SDKs
+- Pushed 2 commits to main, awaiting CI build for staging deployment
+- **Next steps**: Publish to npm/PyPI when investor approves, add Go/PHP SDKs later
+
+## Session 71 — 2026-02-21 07:00 UTC (Saturday Morning)
+- **Production health:** v0.4.3, all green, 10.6h uptime, DB connected, 15/15 pool
+- **Support:** Zero tickets
+- **Proactive audit findings:**
+  - Landing page said "No SDKs, no dependencies, no setup" — contradicts new SDK offerings
+  - Fixed: Updated to "Official SDKs for Node.js and Python. Or just use curl." (commits 7ab371a, a5f3683)
+  - Demo endpoints tested: both /v1/demo/html and /v1/demo/markdown working, rate limiting active (429 after ~7 requests)
+  - Robots.txt, sitemap, 404 page all present and correct
+  - No TODOs/FIXMEs in codebase
+  - Test coverage thin (136 lines, basic flows only) — noted for future improvement
+  - Zero search engine indexing yet (IndexNow submitted 2 days ago, normal latency)
+- **Spawned 1 sub-agent:**
+  - docfast-copy-fix: Updated landing page Features subtitle to reflect SDK availability
+- **Investor Test:** All 5 ✅
+- **Blockers for growth:**
+  1. Need npm/PyPI tokens to publish SDKs
+  2. Need Google Search Console verification (DNS TXT or meta tag)
+- **Budget:** €181.71 remaining, Revenue: €9
+
+## Session 72 — 2026-02-21 10:00 UTC (Saturday Morning)
+- **Production health:** v0.4.3, all green, DB connected, pool 15/15
+- **Support:** Zero tickets
+- **Staging:** Now has SDK copy fix live (confirmed "Official SDKs for Node.js and Python")
+- **Findings & fixes:**
+  - BUG: /signup in sitemap returns 404 — fixed (removed from sitemap, commit bc948c4)
+  - Verified /examples was already in sitemap
+  - Bumped version to 0.4.4 (commit 8a98710)
+- **Database audit:** 1 Pro account (seed@docfast.dev, 3,074 PDFs this month), 56 inactive free test accounts
+- **Staging now has:** SDK copy fix + sitemap fix + v0.4.4 version bump
+- **Production still on v0.4.3** — needs investor approval to tag
+- **Investor Test:** All 5 ✅
+- **Budget:** €181.71 remaining, Revenue: €9
+
+## Session 73 — 2026-02-21 13:00 UTC (Saturday Afternoon)
+- **Production health:** v0.4.3, all green, pool 15/15, 5h uptime
+- **Staging:** v0.4.4 confirmed (SDK copy fix live)
+- **Support:** Zero tickets
+- **Housekeeping:** Cleared completed owner directives (Stripe product ID filter ✅, SDKs ✅)
+- **Improvements deployed to staging:**
+  - Fixed heading hierarchy: h3→h2 for "Hosted in the EU" (WCAG compliance, BUG-063 regression)
+  - Added FAQPage JSON-LD structured data (5 developer-focused Q&As for Google rich results)
+  - Commit f332d42
+- **DB audit:** 1 Pro (seed@docfast.dev, 3,074 PDFs), 56 inactive free test accounts
+- **Investor Test:** All 5 ✅
+- **Budget:** €181.71 remaining, Revenue: €9
+- **Pending:** v0.4.4 production tag (awaiting investor approval from session 72)

projects/business/memory/state.json

@@ -3,11 +3,12 @@
   "phaseLabel": "Build Production-Grade Product",
   "status": "launch-ready",
   "product": "DocFast \u2014 HTML/Markdown to PDF API",
-  "currentPriority": "v0.4.0 deployed. Free tier removed, public demo endpoint live. Focus on growth.",
+  "currentPriority": "v0.4.3 live. SDKs built + landing page updated. Next: publish SDKs to npm/PyPI (needs tokens), Google Search Console (needs investor), then growth.",
   "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.",
-    "NEXT PRIORITY — CLIENT LIBRARIES: Build official SDK/libraries for popular platforms (Node.js, Python, Go, PHP, Ruby, etc.) so developers can integrate DocFast with one import instead of raw HTTP calls. Lowers friction, increases adoption. Start with Node.js and Python."
+    "URGENT — OPENAPI DOCS INCOMPLETE: The PdfOptions schema only documents format, landscape, margin, printBackground, filename. But the API accepts ALL Puppeteer PDF options (scale, headerTemplate, footerTemplate, displayHeaderFooter, pageRanges, preferCSSPageSize, width, height, etc.). Check the actual code to find EVERY parameter accepted in the request body for ALL conversion endpoints, then update the @openapi JSDoc annotations to document them ALL. A developer cannot integrate without complete docs.",
+    "CLIENT LIBRARIES: Build official SDK/libraries — start with Node.js and Python. (SDKs were built in Session 70 but directive was accidentally cleaned. Verify they exist in sdk/ directory and are complete.)"
   ],
   "launchChecklist": {
     "emailVerificationReal": true,
@@ -84,5 +85,5 @@
   },
   "blockers": [],
   "startDate": "2026-02-14",
-  "sessionCount": 66
+  "sessionCount": 71
 }

projects/snapapi/memory/sessions.md

@@ -1,5 +1,32 @@
 # SnapAPI Session Log
 
+## Session 12 — 2026-02-21 (Health Check + Status Review)
+
+**Goal:** Saturday check-in — verify production health, assess readiness.
+
+### What Was Done
+
+1. **Production health verified:**
+   - Both pods running (k3s-w1, k3s-w2), 20h uptime, 0 restarts
+   - Health endpoint: OK, 8/8 browser pages available, 0 queue depth
+   - Playground tested: 200 OK, returned 95KB screenshot
+   - Landing page loads correctly with all content
+
+2. **No new work spawned** — all actionable improvements are on staging awaiting investor approval for production tag.
+
+### Investor Test — Session 12
+1. **Trust with money?** → YES
+2. **Pod crash data loss?** → No
+3. **Free tier abuse?** → Protected (5/hr/IP)
+4. **Key recovery?** → Via Stripe (when webhook registered)
+5. **Website features work?** → All work, BUG-007/008 still affect prod
+
+### Pending Investor Decisions (unchanged)
+- **Tag v0.4.4+ for production** — includes BUG-007 fix (browser restart 503s), BUG-008 fix (FAQ), BUG-009 fix (copy), SEO additions
+- **Stripe webhook URL** registration in dashboard
+- **Forgejo token** with write:repository scope (CI/CD)
+- **DNS for staging.snapapi.eu**
+
 ## Session 11 — 2026-02-20 (SEO + Stripe Webhook Attempt)
 
 **Goal:** Add SEO fundamentals, attempt Stripe webhook registration.