FreshVibe Studio (FVS)

Repo: avidtech6/freshvibestudio (canonical, no case-variant dup) Live: https://hc80d20quxvf.space.minimax.io (per memory; verify post-deploy) Status: active Last known HEAD: 8c093ef (2026-06-22 18:37)

What FVS is

The sovereign workspace container for the FVS ecosystem. Hosts 4 sovereign workspaces (Origin, VibeCoder, VibeScope, FreshCards) plus the chrome (frame, dock, topbar, vibe-panel, peek-panel) and shared modules.

FVS is not a workspace itself — it's the app container that hosts the workspaces. The name "Studio" is reserved for the container; it does not appear as a chip or dock item.

Stack

• Frontend: Vanilla TypeScript (post Phase 1 chrome port from Mantine)
• Build: Vite
• Tests: Vitest, 401/401 PASS as of last verify
• Backend: None (FVS is client-side); relies on substrates for persistence

Architecture

• studio/src/ — main app code
• studio/src/chrome/ — chrome modules (frame, dock, topbar, vibe-panel, peek-panel, support-act)
• studio/src/state/StudioContext.tsx — global state
• studio/src/workspaces/ — workspace mounts (FreshCardsWorkspace.tsx, etc.)
• studio/modules/freshcards/ — FreshCards substrate (D-056 dual identity)
• studio/.fvs/plans/ — FVS plans including the doctrine-cleanup plan-correction

Doctrine

• pact/ — the FVS Pact (FVS-specific doctrine)
• pact/freshvibe-way-v8/ — FWV v8 (app-agnostic)
• pact/governance/dna/ — constitutional index, fragment-registry

Substrates

• studio/modules/freshcards/ — D-056 dual-identity substrate (workspace + Card primitives)

Key decisions

• D-056 — FreshCards = 4th sovereign workspace AND substrate
• D-061 — FreshCards canonical location is studio/modules/freshcards/, not a standalone repo
• D-062 — Phase 4 (FWV v8 contamination cleanup) shipped at 8c093ef

Cross-references

• Lane: chrome (owns FVS chrome + FWV v8)
• Topic: freshvibe-design, freshvibe-pact, freshvibe-governance
• Reports: 2026-06-23-freshcards-state-check (recent state verification)