System reality.
The source-of-truth map for what is real, what is canonical, what is peripheral, and how architecture claims stay verified.
Casset is a realtime audiovisual music identity platform, not a loose pile of routes. This page keeps the docs honest by tying product language to source files, route families, release infrastructure, and verification commands.
Source-of-truth map
The docs ecosystem has several audiences. These files decide which story wins when public copy, roadmap language, architecture notes, or code comments disagree.
Route reality
The platform exposes canonical surfaces plus experiments. Public docs should make the canonical lanes obvious and keep experiments out of the primary product narrative until they replace a current lane.
Core vs. peripheral systems
A system is core when it strengthens a Profile World, Hook Object, Release Ritual, Listening Room, or the canonical release layer that preserves provenance and permissions underneath them. Otherwise it is support, internal, experimental, or archived.
Lead with identity, atmosphere, provenance, and social context.
Lead with audiovisual timing, shareability, lyrics/captions, and social travel.
Lead with anticipation, room energy, fan traces, and return moments.
Use Listening Room strategically; use Side B only when naming implemented UI.
Frame as atmosphere/world authoring, not shader tooling.
Frame as release context, manifests, provenance, permissions, lineage, and dossier state under the cinematic product.
Expose machine-readable release intent without making the product feel like rights SaaS or an AI dashboard.
Use for manifest hash proofs and receipts; never lead with wallets, tokens, markets, or protocol UI.
Accurate and real, but secondary to identity and participation.
Consumer language should be release quests or fan missions.
Keep out of primary IA and investor lead language; anchoring release proofs is separate from market mechanics.
Treat canonical routes as current; avoid promoting route variants.
Claim verification
Runtime and architecture docs should point to code. If a statement has no source file or verification command, it should be framed as strategy or intent rather than implementation reality.
lib/hook-constants.tsrg -n "HOOK_DURATION_SEC|AUDIO_PROXY_WINDOW_SEC" lib app componentslib/audio-access.ts, app/api/audio/[trackId]/route.tsrg -n "AUDIO_PROXY_WINDOW_SEC|X-Preview-Duration|previewStartSec" lib/audio-access.ts app/api/audiolib/playback-clock.ts, lib/hook-playback-timeline.tsrg -n "readPlaybackClockFrame|resolveHookPlaybackFrame" lib components applib/visual-runtime/render-scheduler.tsrg -n "visualRenderScheduler" lib components applib/visual-runtime/shader-config-diff.tsrg -n "isTextLayerOnlyShaderConfigChange|shader-config-diff" lib componentslib/casset-profile-patterns.tsrg -n "CASSET_PROFILE_TEXTURES|profilePatternId" lib app components docsapp/api/casset/[slug]/*, lib/sideb-redis.tsrg -n "text/event-stream|EventSource|sideb|publishSideBEvent" app lib hooks componentsapp/api/webhooks/stripe/route.tsrg -n "payment_intent.succeeded|checkout.session|webhook|PaymentIntent" app/api libprisma/schema.prisma, lib/releases/*, app/api/agents/releases/*rg -n "model Release|ReleaseManifest|AgentAccessPolicy|DerivativeLink|ProvenanceEvent" prisma/schema.prisma lib/releases app/api/agentslib/base/release-anchor.ts, lib/releases/publish-runtime.tsrg -n "ReleaseAnchor|queueReleaseManifestAnchor|recordReleaseAnchorSuccess|submitReleaseAnchorToBase" lib/base lib/releases app/api/cron/releasesMaintenance rules
- Lead public docs with audiovisual identity, not campaign or commerce breadth.
- Use Listening Room strategically and Side B only for implemented UI references.
- Frame Visual Studio as atmosphere/world authoring before naming shader internals.
- Frame agent APIs as release permission infrastructure, not as an AI dashboard.
- Frame Base as quiet proof infrastructure, not as a crypto product.
- Keep creator-coin, market, and protocol-edition work parked unless the product direction changes.
- When code and docs disagree, update the docs or open an implementation task immediately.
Drift checks
Use these commands before major docs edits or investor-facing updates. Hits are acceptable in avoid lists, archive policy, or implementation notes that explicitly name legacy terms.
rg -n "social sound identity|AI-powered|shader editor|VFX tool|tokenized|growth platform|campaign dashboard|pre-save optimization|fan monetization" README.md docs app/docs
rg -n "Profile World|Hook Object|Release Ritual|Listening Room|profile texture|profilePatternId" README.md docs app/docs
rg -n "ReleaseManifest|AgentAccessPolicy|PermissionPolicy|ProvenanceEvent|DerivativeLink" prisma lib app docs
rg -n "Base|protocol|campaign|drop|Side B|creator coin|market" README.md docs app/docs