changelog

Instruction file imported from gordo-v1su4/pindeck (.cursor/rules/changelog.mdc). Copyright stays with the author.

description: Session-by-session changelog for significant project updates globs: */ alwaysApply: true

Pindeck Changelog

Use this file as a concise running log of meaningful changes.

Entry format

## YYYY-MM-DD
- Area: short summary
- Area: short summary
- Follow-up: pending item or risk

Rules:

• Keep bullets short and concrete.
• Log shipped behavior, not intentions.
• Include follow-ups only when actionable.
• Prefer one section per day.

2026-09-19

• Upload-clutter purge (ops): internalPurgeUploadClutterForUser removes E2E-tagged pending/draft/processing rows only; full account wipe requires PURGE_MODE=entire-account + explicit confirm (scripts/purge-owner-library.sh).
• E2E smoke fixture: defaults to a PNG from ~/Downloads (unique temp URL per run); Wikimedia pool is fallback only.
• Orchestration → Upload UI sync: completeCallback and cached orchestration replays set images.aiStatus when Trigger finishes pindeck-image-refresh / pindeck-generate-variations; reconcileMyOrchestrationAiStatus backfills rows where orchestration is terminal but Upload still shows processing.
• Production black screen fix: Restored wire path images:list via root convex/images.ts barrel after V1S-84 split (nested modules only had images/library:list). check-pindeck-convex.sh now fails if images.js:list is missing from deploy.
• Platform docs: Single map docs/architecture/platform-topology.md; trimmed duplicates; removed stale docs/guides/redesign-deck-port-inventory.md.
• Convex ingest fix: ingestExternalHttp uses nested internal["images/ingest"].ingestExternal ref (shim path broke production /ingestExternal).
• E2E: scripts/e2e-production-smoke.sh, Playwright tests/e2e/ default base URL https://pindeck.dev; npm scripts e2e:smoke, e2e:ui. Smoke probes unauthenticated /orchestration/* callbacks (expect 401).
• Convex orchestration fix: All Trigger HTTP callbacks and media paths use internalApi.images.* from shared.ts (orchestration.ts, mediaStorage.ts, images/analysis.ts, images/lifecycle.ts) — fixes production Couldn't resolve api.images.internalGetMetadataRefreshPayload on external-ingest / image-refresh.
• Ops: Trigger 20260919.1 deployed on app-vm; /opt/pindeck reset to origin/main.
• Convex deploy (V1S-84 follow-up): internalApi.images shim in convex/images/shared.ts; production deploy to https://convex.serving.cloud restored.
• Arch-4 + Arch-5: Merged PR #39 — Trigger orchestration seam (orchestrationSeam / orchestrationCore / orchestrationState) + media adapter (lib/mediaAdapter.ts, mediaAdapter.ts); rebased on main including Convex shim.

2026-09-18

• Convex ops: Document two Hostinger stacks (pindeck-convex vs review-room-convex / Unfold). Pindeck deploy + scripts/check-pindeck-convex.sh target convex.serving.cloud only; enforce-production-convex.sh rejects unfold.serving.cloud URLs.
• Arch-5 (V1S-87): convex/lib/mediaAdapter.ts owns canonical paths + public URL formulas; convex/mediaAdapter.ts re-exports. Tests in convex/lib/mediaAdapter.test.ts.
• Arch-4 (V1S-86): Trigger orchestration interface — orchestrationSeam.ts HTTP paths, orchestrationCore.ts keys/status, orchestrationState.ts lease mutations. triggerDispatch stays the SDK layer. Payloads unchanged; redeploy Trigger workers after merging seam imports (bun run trigger:deploy).
• Greptile #38: bot withdrew .filter / .collect as merge blockers (legacy status: undefined + full-library aggregations). Typed shared.ts ctx in 27bb6e4. Follow-up: by_status index + status backfill (schema deploy; not V1S-86).
• Images shared types (V1S-84): convex/images/shared.ts cleanup/lineage helpers take MutationCtx / QueryCtx instead of any.
• Arch-3 (V1S-85): removed unused Radix ImageGrid + TableView and exclusive siblings (ImageModal, EditImageModal, GenerateVariationsModal, CategoryFilter). App.tsx still wires pd/GalleryView + pd/TableView. Palette re-sample / parent lineage already live there and in ImageDetailDrawer; dropped unused @dnd-kit/* + @tanstack/react-table.
• Images backend (V1S-84): split convex/images.ts into convex/images/ (library, ingest, moderation, lifecycle, plus uploads/analysis/generation/shared). index.ts re-exports so api.images.* and HTTP imports from ./images stay the same.
• App shell (V1S-83 slice 1): moved Topbar + Sidebar (filters, aggregations, color picker) to src/components/shell/ with no behavior change; App.tsx still wires auth, library query, and routes.
• App shell (V1S-88): view, library filters, and table column visibility live in src/components/shell/ hooks (useAppView, useLibraryFilterState, useTableColumnVisibility); App.tsx remains the auth + route shell.
• Agents docs: Committed docs/agents/* + .agents/skills/implement/SKILL.md + matt-pocock-workflow.md so implement threads find ticket workflow without plugin-only skill paths.
• Linear: Pindeck project + arch epic V1S-82 (children V1S-83–87); repo index docs/agents/architecture-linear-backlog.md. V1S-83 in progress (App shell).
• Agents: Pindeck uses Matt Pocock skills + Graft only; pstack not used in this repo (uninstall via Cursor Customize → Plugins if enabled for this workspace).
• Matt Pocock agent setup: docs/agents/issue-tracker.md (GitHub/gh), docs/agents/domain.md (single-context); ## Agent skills in AGENTS.md. No triage labels until triage skill is installed.
• Graft: Per-repo Hermes setup — @nanonets/graft@0.18.0 devDependency, trustedDependencies for tree-sitter, bun run graft:build / graft:map, Cursor MCP via bunx graft mcp; commit .cursor/rules/graft.mdc, hooks, and mcp.json (not graft/).

2026-07-05

• Auth UI: Removed Google/GitHub sign-in buttons from SignInForm; OAuth env vars are not configured. Email/password and guest sign-in remain. Backend OAuth providers stay in convex/auth.ts for future enablement.
• Deck composer persistence: decks.update saves composer state (blocks, palette, scroll FX, overlay, typography, slides) to Convex with debounced autosave + Saving… / Saved indicator in DeckComposer; legacy localStorage is a UI-only cache for selection index.
• Image delete/edit auth: images.remove / removeMany / updateImageMetadata require uploadedBy === userId or admin (ADMIN_USER_IDS / ADMIN_EMAILS env); shared active library images are no longer deletable by any signed-in user.
• HTTP security: /smartAnalyzeImage requires INGEST_API_KEY Bearer auth and verifies image ownership before scheduling analysis.
• Lineage: getLineage returns parent/children for active library images, not owner-only.
• Library query: Gallery + Table share one images.list limit 1000 subscription from App.tsx.
• App shell: top-level AppErrorBoundary; ⌘K focuses search; removed dead Topbar Filters/Sort buttons.

2026-04-28

• Auth UI: Login brand DECK + .auth-* accents use var(--pd-accent*) (aligned with sidebar / Tweaks #3a7bff default); removed legacy #1f8fe5 on .site-brand-word-accent and auth helpers in index.css.
• Build / Vercel: VERCEL / CI checks default prod VITE_* URLs when unset; vite.config.ts production VITE_CONVEX_URL fallback matches enforce-production-convex.sh.
• Convex decks.list bugfix: ctx.db.get("images", imageId) (was get(imageId)) so stripImageUrls / previews populate — library strips were blank.
• Deck palette: Composer prefers hero images.colors via paletteFromDominantHexes (utils/colorExtractor.ts); otherwise client extractColors. colors no longer persisted in localStorage. getById slide images include colors on the DeckSlide type.
• Decks library strip: convex/decks.list returns stripPalettes (parallel images.colors slices per stripImageUrls row — table parity); DeckView: aspect-video hero preview + PinSwatches per slide; previewSlideTitles + board line. + BLANK column matches deck card width/row structure.
• App deck route wraps min-h-0 so DeckComposer sidebar + workspace main scroll.
• Deck composer: Five palette swatches prioritize client extractColors(hero URL) first; Convex heroDominantHexes / images.colors only when extraction fails (avoids stale greens from DB). Typography / GSAP Select dropdowns use deck-composer-select-content + --pd-accent-soft highlight (ported CSS).
• Deck composer UI: Tweaks accent (--pd-accent*) drives sidebar / Present / FX / layout chips. BlockFrame has no outline in the deck preview (selection is in the block list only). Left swatches derive from the active strip image URL (heroSampleUrl); Convex fallback matches imageUrl, not always slide 0 (activeHeroDominantHexes). EditableText focus rings use colors.accent. CORS / taint: extractColorsFromImage retries via fetch → blob URL when cross-origin canvas yields too few dominants.
• Decks: Restored claude/redesign implementation — DeckView.tsx (horizontal strip gallery + blank column + lazy deck/DeckComposer), convex/decks.ts list enrichment (stripImageUrls), shared .creative-* field/button styles in index.css + actionStyles.ts. Removed obsolete src/components/pd/deck/ gallery/composer. Wired in App.tsx.
• Create New Board modal (CreateBoardModal.tsx): rebuilt on pd tokens + drawer-matching fields/footer; boards.create unchanged (name, description, isPublic). Drawer Variations: selected chips use --pd-accent-soft instead of hardcoded blue (ImageDetailDrawer.tsx).
• Gallery (pd): less chrome on tiles — no aspect/style pill, no color swatches, no footer strip; VAR badge kept (slightly softer fill/border + 0.88 opacity). Heart + bookmark top-right only, hover/focus to show ( 22px buttons, 12px icons); stay visible while Save to board menu open; filled heart ~78% opacity + optimistic like; bookmark filled blue when on any board; board rows that already contain the image use muted accent background (color-mix on --pd-accent). No wand on tiles (GalleryView.tsx).
• Auth: Guest + Sign out live in the top header (Topbar → accountActions), not the sidebar footer; sidebar footer stays convex · live only (src/App.tsx).
• Image detail drawer: Variations tab shows Type/Genre/Shot/Style + tags (same fields as table/gallery); Edit metadata block adds Genre/Shot/Style; hero subtitle + chips reflect backfill metadata; variation mode labels Title Case (TMP-aligned) ImageDetailDrawer.tsx.
• Auth UI: guest/email sign-in could show a blank black main area while Convex isLoading was true because Authenticated / Unauthenticated both render nothing during load; added AuthLoading (“Loading session…”) and showAppChrome = isAuthenticated && !authLoading (src/App.tsx). Sanitized invalid pindeck_view from localStorage.
• Library: shot on images; VLM analysis fills group / genre / shot / style (convex/vision.ts) and internalUpdateAnalysis persists them. Backfill metadata in Table schedules enqueueCinematicMetadataBackfill (your uploads only, staggered jobs).
• Sidebar: Type counts, Genre + Style/medium chips, Filters (originals / sref) with shared state in src/lib/libraryFilters.ts; wired on Gallery + Table (src/App.tsx).
• Table (pd): Palette column right-aligned + Re-sample palettes on src/components/pd/TableView.tsx (this is the table wired in App.tsx); visual checkpoints in docs/browser-snapshots/ vs pindeck.dev.
• Colors: palette extraction is dominance-first (pixel share) with Lab separation (src/lib/colorPaletteCore.ts, convex/colorExtraction.ts); sampling URL prefers imageUrl (convex/colorExtractionUrls.ts); reExtractAll requires auth.
• UI fix: accent Tweaks were ignored because .pd-theme re-declared --pd-accent* and shadowed document.documentElement; moved dynamic tokens to :root-only defaults + JS overrides (src/index.css).
• Env: restored production Convex URLs in .env.local (tremendous-jaguar-953) so gallery/data load against real backend (was dev deployment from convex dev --once).
• UI: dynamic accent inks (src/lib/pdTheme.ts), global Tweaks CSS on documentElement, sign-in uses --pd-accent* (parity with cloud redesign).
• Drawer: TMP letterbox overlay + flex stretch fixes for ImageDetailDrawer.
• Decks gallery: accent dot meta row, TMP-style hover shadow, subtitles from Convex deck fields (legacy pd deck gallery removed; see DeckView).

2026-02-12

• Discord ingest: strengthened media URL filtering/deduping and limited imports per trigger to reduce junk/icon ingestion.
• Discord queue workflow: imports queue as pending; approve/deny required before full pipeline.
• Discord moderation: added queue review + approve/reject/generate flows via commands/buttons.
• Discord status feedback: webhook events expanded (queued/approved/rejected/generation started/generated), with image/context metadata.
• Approved message UX: bot posts variation-mode buttons after approved status messages and routes clicks to generation.
• Image lineage metadata: generated children preserve parentImageId; table parent resolution/parent labeling improved.
• sref propagation: generated children inherit sref from parent/root lineage.
• Gallery/Table filters: added Sref-only toggles (Sref Tag in gallery view controls; Show Sref Only in table).
• Prompt consistency: unified variation prompt planning between preview/runtime and added image-specific prompt preview query.
• Docs/rules refresh: updated .cursor/rules files to reflect current architecture, deployment, and stack behavior.