Software Updates

guest room control-bar parity with host

• Port host's transparent auto-hide control overlay to the guest room (gradient fade, reveals on pointer-move in bottom zone / touch)
• Replace the opaque docked control strip with a floating pointer-events overlay so video uses full height
• Add dedicated 'Hide controls' button (ChevronDown) — tap/move to reveal; handy on mobile for an unobstructed view

subtitle overlay mode, PiP aspect fix, self screen-share view, Yen listening controls

• Subtitle overlay mode (host + guest): floats semi-transparently over video, freely resizable width+height via corner drag handle; toggle in settings
• Self-view PiP: landscape 16:9 on desktop (was portrait -> black bars on Mac), portrait retained on mobile
• Screen share: sharer now sees their own shared screen in the grid
• Guest subtitles now default to TOP (parity with host)
• Yen voice assistant:
• silence window 3s -> 4s, hold-phrase extension 1.5s -> 2s
• 'Ask now' + 'Cancel' buttons on the listening pill
• empty-query guard (no more blank prompts -> empty responses)
• wake word accepts pt-BR-friendly mishearings (iene, jean, gian, young) and new alias 'Hey Nova' (easy Brazilian Portuguese phonetics)
• fix stray sm:bottom-auto/sm:bottom-20 conflict in share picker
• add scripts/run-backfill.mjs (reusable pg SQL runner)

add transcript backfill generator for fn1t2c9q

• Reads the two exported MeetingTranscript CSV pages (1388 rows), dedupes
• by id, and emits an idempotent SQL file. Rebuilds the startMs timeline
• from createdAt because the host's per-session startMs resets to 0 on
• every mid-meeting STT restart, which had jumbled ordering and left all
• 438 guest (Portuguese) lines stuck at 0:00.

batch UX fixes from 2026-08-03 meeting feedback

• 1. Guest room i18n: settings panel, language picker, control-bar
• tooltips and Leave button now localised (en/pt/es/fr), following
• the guest's spoken language selection.
• 2. Host control bar no longer pops up over the Yen chat input:
• bottom-zone auto-show is suppressed while the Yen panel is open,
• and controls hide immediately when Yen opens.
• 3. Transcript timestamps: remote captions were persisted with
• startMs=0 (host has no session clock for guests), so every guest
• line showed 0:00. The transcript route now computes the offset
• server-side from Meeting.startedAt when startMs<=0.
• 4. Minutes page: new TranscriptExport component — copy whole
• transcript, download .txt, or print-friendly PDF.
• 5. Meetings list: Link wrapper now display:block so the entire
• meeting card is reliably clickable (not just the Open button).

guests can position subtitle panel at top or bottom

• New Position (Top/Bottom) toggle in the guest subtitle settings panel
• Subtitle panel renders above or below the video grid accordingly
• Drag-resize handle moves to the video-facing edge and the drag direction flips so 'grow' is always toward the video

host now sees translations of remote speech in subtitle panel

• The host's receive path appended remote caption.final lines to the
• transcript with translated: undefined, and the translation fetch only
• wrote to the transient live-caption overlay (pushSubtitle) — which is
• cleared within ~1s by the live-clear timer. Result: the host saw
• Stella's original Portuguese line in the subtitle panel but the English
• translation never appeared anywhere persistent.
• Fix: append the transcript line first with a known id, then have the
• translate response update that line's 'translated' field by id (same
• pattern the guest client already used). The subtitle panel now renders
• original + translation side-by-side for the host.

resolve translation broadcast & participant dedup issues

• Fix #1: Remove translationLang broadcast override translationLang is a per-viewer preference, not a room-wide setting. Removed the subtitles_broadcast packet that carried 'lang', which was causing one participant's language pick to clobber everyone else's translation target. This is why the host lost translations when Stella/guests selected their own language mid-meeting.
• Fix #2: Use translationLangRef in broadcast callback broadcastCaption was reading stale sttLang from React state dependency, causing captions sent after a language switch to be tagged with the old source language. Now reads sttLangRef so receivers always see the current spoken language and can translate correctly.
• Fix #3: Deduplicate participants in minutes view Guests get fresh random LiveKit identities on every rejoin (security rule B.7), creating multiple MeetingParticipant rows per person. The minutes query now groups by (userId, email, displayName) and aggregates sessions, fixing the '7 participants for 3 people' bug. Also surfaced reconnect count: '(3 sessions — reconnected 2×)'.

marketing site: Phase 6 — SEO surfaces (robots, sitemap, 404, JSON-LD)

• /marketing-site/robots.txt + /marketing-site/sitemap.xml route handlers matching the proxy rewrites (thank-you pages excluded/disallowed; hreflang alternates for / and /pt in the sitemap).
• Branded not-found page with EN/PT recovery links.
• JSON-LD in the marketing layout: Organization (Katura Marketing, child of Katura), ProfessionalService (30-Day Paid Growth Pilot, en + pt-BR, US/BR), Person (Stella Barbosa). Facts only — no invented ratings or reviews.

marketing site: Phase 3+4 — lead API, thank-you pages, CAPI Lead helper

• POST /api/marketing/lead: Zod validation, honeypot, 5/hr IP rate limit, dedupe by eventId (idempotent retry) + same-email 10-min window, transaction (SaasFormSubmission + CrmContact upsert + CrmActivity + high-priority follow-up CrmTask), response { success, processed, leadId, eventId, duplicate }. Side effects run in after(): server-side Meta Lead (CAPI, deduped by the shared event ID), internal notification to MARKETING_LEAD_NOTIFICATION_EMAIL (default marketing@katura1999.com), bilingual acknowledgement email to the lead.
• meta-capi.ts: META_GRAPH_API_VERSION now configurable via env; new trackCapiLead helper (not gated on Meta traffic — fires for every processed lead; browser/server dedup via event_id; honors META_TEST_EVENT_CODE).
• /thank-you and /pt/obrigado: noindex confirmation pages with env-gated scheduler + WhatsApp CTAs (NEXT_PUBLIC_MARKETING_SCHEDULER_URL / NEXT_PUBLIC_MARKETING_WHATSAPP_NUMBER, hidden when unset).

marketing site: Phase 2 — server-rendered EN/PT landing pages

• content.ts / content-pt.ts: typed bilingual content model, copy verbatim from the brief; KPI figures derived from the case-study module only.
• layout.tsx: dedicated marketing layout (navy/ivory/gold direction), metadataBase on the marketing subdomain so /marketing-site never leaks.
• paid-growth-landing.tsx: all 11 sections server-rendered (hero, verified result + mandatory qualifier, conversion problem, 4-week pilot, fit cards, Stella work gallery [scroll-snap, no carousel], case study incl. 'what it did not prove', Stella bio [no unverified portrait], risk reversal, server-rendered FAQ, lead form section).
• lead-form.tsx: exactly four fields + honeypot; event ID generated pre-POST; browser Lead fires only on confirmed processed non-duplicate response with the server-confirmed event ID; inputs preserved on failure.
• page.tsx / pt/page.tsx: EN root + /pt with canonical + hreflang alternates.

marketing site: Phase 1 routing + data foundation

• proxy.ts: 'marketing' reserved; first-class marketing.katura1999.com block (clean-URL rewrites to /marketing-site, prefix-strip 301s, admin API block, static asset passthrough, robots/sitemap mapping, no geo-redirect); main-domain /marketing-site 301 → marketing subdomain.
• lib/marketing-site: verified case-study data module (single source of truth + required qualifier), shared types, first/current-touch attribution helper (90-day window, storage-safe), Zod lead schema + name splitter.

K99: subdomain-specific favicon + add marketing site implementation brief

• Added /brand/k99-icon.png and wired it as the K99 marketing layout's icon/apple-touch icon, overriding the Katura store favicon on k99.katura1999.com pages.
• Checked in docs/marketing/marketing-katura1999-fable5-implementation-brief.md (the marketing.katura1999.com paid-growth funnel brief) for reference.

K99: fix broken Playfair font class + complete logo rollout

• Admin sidebar + mobile header logo
• Developers portal header/footer + OG image
• K99 marketing OG image All now point at /brand/k99-logo-header.png.

K99: fix false-positive compat banner, correct service statuses, new header logo, rose-gold headline treatment

• Disabled the unsupported-browser compat banner entirely in development and raised its production timeout from 4s to 12s. It was firing on localhost (fully modern browsers) whenever dev compile/HMR took longer than 4s, showing a false 'update your iPad' message.
• Corrected /services capability statuses: CAD & Jewelry Engineering and Casting & Production are both live services and are now 'available' (not pilot/rolling_out). K99 Business Platform itself is under active development and is now 'rolling_out' (was incorrectly 'available').
• Replaced the K99 header/footer mark with the new provided logo (public/brand/k99-logo-header.png).
• Added a RoseGold metallic gradient text treatment (Playfair Display, matching the katura1999.com 'TIMELESS ELEGANCE' hero and the /investors pitch deck) and applied it to 'first sketch to first sale' in the K99 homepage H1.

Katura Deck quality overhaul — editorial design system, language separation, full-bleed charts, editor v2

Katura Deck session 2 — PDF→deck generation via Claude vision (pdfjs client processing, no-hallucination contract, verbatim chart embedding, cue-point notes)

Katura Deck session 1 — model, APIs, editor (sorter/canvas/notes), present mode, share, nav

Yen searchDocs/readDoc/createDoc tools + unify messenger @yen onto main runtime (tools, guardrails, failover, budget)

paragraph-by-paragraph doc translation, Yen daily briefing (9AM ET cron + dashboard card + 11labs listen), voice env wiring, Yen deep-dive doc

page-break indicators, persisted translation view, ElevenLabs read-aloud

make split-view language bars exactly symmetrical (fixed h-8 headers)

Katura Sheets — Univer-powered spreadsheets

• Full Excel-grade engine via @univerjs/presets (Apache-2.0): ~400 formula functions, toolbar, context menus, number formats
• /admin/sheets list page (search, create, delete) mirroring Docs
• /admin/sheets/[id] full-screen editor, client-only (next/dynamic)
• Autosave: Univer workbook snapshot persisted 2s after last command
• Sharing: viewer/editor roles per teammate email (owner-managed)
• Viewers get a read-only workbook (setEditable(false))
• New models KaturaSheet + KaturaSheetShare with hand-written migration
• Nav entry under Content with en/pt/es labels

side-by-side translation view + 24 languages; chore: clean root

• Translation mode is now a full-screen split view (admin sidebar hidden): original doc stays editable on the left, AI translation renders on the right — no more content swapping
• Language list expanded from 8 to all 24 storefront locales, with RTL support (Arabic, Hebrew) on the translation pane
• Refresh button re-translates after edits (saves first, then re-runs)
• Back arrow exits split view; exports still follow the viewed language
• Root cleanup: moved 11 loose files into docs/ (sessions, audits, marketing, reference/copilot); gitignored tsconfig.tsbuildinfo

anchor .vercelignore patterns to repo root

• CRITICAL BUG: 'docs/' (unanchored) was matching ANY directory named
• 'docs' at any depth, not just the root markdown docs/ folder. This
• silently stripped src/app/admin/docs/ and src/app/api/admin/docs/
• (the entire Katura Docs feature) out of every Vercel build — hence
• the 404s, even though the code was committed and 'Compiled successfully'.
• Anchored all patterns with a leading slash (/docs/, /logs/, /tmp/,
• /e2e/, /coverage/, /scripts/...) so they only match at the repo root.

Word import/export, page sizes, print & PDF

• Import .docx/.doc → mammoth converts to HTML (images inlined as base64), creates a new doc — 'Import Word' button on /admin/docs
• Export menu: Word (.docx via html-to-docx with real page dimensions), PDF (browser print engine, pixel-perfect @page CSS), raw HTML
• Exports respect the currently-viewed translation language
• Page size selector (A4 / Letter / Legal): editor canvas resizes to true page dimensions, persisted per doc, drives print + docx output
• Print button with proper @page margins and typography

trim NEXT_PUBLIC_APP_URL to remove trailing newline in reset URLs

• /api/auth/forgot-password/route.ts
• /api/auth/register/route.ts
• /api/admin/team/reset-password/route.ts
• /api/admin/wholesale/leads/[id]/convert/route.ts