# vediograph-wuzhijing/videograph-validation architecture

> Architecture diagram of the GitHub repository vediograph-wuzhijing/videograph-validation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vediograph-wuzhijing/videograph-validation
- Repository: https://github.com/vediograph-wuzhijing/videograph-validation

## Overview

VideoGraph is a local AI video-production workbench for music videos and product promotion. Its main workflow runs from audio import and analysis, through beat-aware shot planning and scene-code authoring, to transitions, rendering, and export. LLMs operate through MCP; people use the review room to inspect results, leave anchored feedback, compare revisions, and accept changes. The README documents these capabilities, while several implementation links below rely on its workflow description or the SOURCE INDEX; unsampled details are not inferred.

Main entry points: [`src/server/render-worker.mjs`](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/render-worker.mjs) (Render worker), [`src/server/index.mjs`](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/index.mjs) (Local project service), [`src/project/ProjectStudio.tsx`](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/ProjectStudio.tsx) (Project Studio), [`src/server/project-store.mjs`](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/project-store.mjs) (Project store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_song["Song preparation"]
  node_song_analysis["Song analysis<br/>[song-project.mjs]"]
  node_rhythm["Rhythm tools<br/>[rhythm.mjs]"]
  node_analysis_correction["Analysis correction"]
end

subgraph group_authoring["AI authoring"]
  node_service["Local project service<br/>[index.mjs]"]
  node_project_store[("Project store<br/>[project-store.mjs]")]
  node_director["AI director<br/>[director.mjs]"]
  node_scene_authoring["Scene authoring<br/>[project-store.mjs]"]
  node_transitions["Transition editing<br/>[transitions.mjs]"]
  node_fx["FX runtime<br/>[runtime.mjs]"]
end

subgraph group_review["Review room"]
  node_feedback["Feedback workflow<br/>[feedback.mjs]"]
  node_review_compare["Revision comparison<br/>[ReviewCompare.tsx]"]
end

subgraph group_render["Render pipeline"]
  node_render_worker["Render worker<br/>[render-worker.mjs]"]
  node_reference_engine["Reference engine"]
  node_render_cache[("Render cache<br/>[render-cache.mjs]")]
  node_browser["Browser renderer<br/>[browser.mjs]"]
end

subgraph group_access["User interfaces"]
  node_mcp["MCP server<br/>[mcp-server.ts]"]
  node_mcp_tools["MCP tools<br/>[mcp-tools.ts]"]
  node_studio["Project Studio<br/>[ProjectStudio.tsx]"]
  node_project_api["Project API client<br/>[api.ts]"]
end

node_llm(("MCP-connected LLM"))
node_human(("Human reviewer"))

node_llm -->|"connects via MCP"| node_mcp
node_mcp -->|"dispatches tools"| node_mcp_tools
node_human -->|"reviews work"| node_studio
node_studio -->|"requests project data"| node_project_api
node_project_api -->|"calls local service"| node_service
node_mcp_tools -.->|"invokes workflow"| node_service
node_service -->|"reads and writes"| node_project_store
node_service -->|"starts analysis"| node_song_analysis
node_song_analysis -.->|"uses rhythm analysis"| node_rhythm
node_human -->|"corrects analysis"| node_analysis_correction
node_analysis_correction -.->|"confirms analysis"| node_studio
node_llm -->|"plans and revises"| node_director
node_director -->|"updates project"| node_project_store
node_llm -->|"submits scene code"| node_scene_authoring
node_scene_authoring -->|"stores scene source"| node_project_store
node_studio -.->|"edits transitions"| node_transitions
node_transitions -->|"prepares effects"| node_fx
node_human -->|"leaves anchored feedback"| node_feedback
node_feedback -.->|"persists feedback"| node_project_store
node_studio -->|"opens comparison"| node_review_compare
node_review_compare -->|"requests stills and previews"| node_project_api
node_human -->|"accepts or rejects"| node_review_compare
node_service -->|"queues render jobs"| node_render_worker
node_render_worker -->|"loads jobs and projects"| node_project_store
node_render_worker -->|"renders project scenes"| node_reference_engine
node_render_worker -->|"reuses cached segments"| node_render_cache
node_render_worker -->|"renders in browser"| node_browser
node_fx -.->|"previews effects"| node_browser

click node_mcp "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/pdoom/mcp-server.ts"
click node_mcp_tools "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/mcp-tools.ts"
click node_studio "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/ProjectStudio.tsx"
click node_project_api "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/api.ts"
click node_service "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/index.mjs"
click node_project_store "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/project-store.mjs"
click node_song_analysis "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/song-project.mjs"
click node_rhythm "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/rhythm.mjs"
click node_analysis_correction "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/song/ui/AnalysisCorrector.tsx"
click node_director "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/director.mjs"
click node_scene_authoring "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/project-store.mjs"
click node_transitions "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/transitions.mjs"
click node_fx "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/fx/runtime.mjs"
click node_feedback "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/feedback.mjs"
click node_review_compare "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/ReviewCompare.tsx"
click node_render_worker "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/render-worker.mjs"
click node_reference_engine "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/reference-server.mjs"
click node_render_cache "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/render-cache.mjs"
click node_browser "https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/browser.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_song_analysis,node_rhythm,node_analysis_correction,node_human toneBlue
class node_service,node_project_store,node_director,node_scene_authoring,node_transitions,node_fx toneAmber
class node_feedback,node_review_compare toneMint
class node_render_worker,node_reference_engine,node_render_cache,node_browser toneRose
class node_mcp,node_mcp_tools,node_studio,node_project_api,node_llm toneIndigo
```

## Components

### Song preparation

- [Song analysis](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/song-project.mjs): `src/server/song-project.mjs`
- [Rhythm tools](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/rhythm.mjs): `src/server/rhythm.mjs`
- [Analysis correction](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/song/ui/AnalysisCorrector.tsx): `src/song/ui/AnalysisCorrector.tsx`

### AI authoring

- [Local project service](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/index.mjs): `src/server/index.mjs`
- [Project store](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/project-store.mjs): `src/server/project-store.mjs`
- [AI director](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/director.mjs): `src/server/director.mjs`
- [Scene authoring](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/project-store.mjs): `src/server/project-store.mjs`
- [Transition editing](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/transitions.mjs): `src/server/transitions.mjs`
- [FX runtime](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/fx/runtime.mjs): `src/fx/runtime.mjs`

### Review room

- [Feedback workflow](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/feedback.mjs): `src/server/feedback.mjs`
- [Revision comparison](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/ReviewCompare.tsx): `src/project/ReviewCompare.tsx`

### Render pipeline

- [Render worker](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/render-worker.mjs): `src/server/render-worker.mjs`
- [Reference engine](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/reference-server.mjs): `src/server/reference-server.mjs`
- [Render cache](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/render-cache.mjs): `src/server/render-cache.mjs`
- [Browser renderer](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/browser.mjs): `src/server/browser.mjs`

### User interfaces

- [MCP server](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/pdoom/mcp-server.ts): `src/pdoom/mcp-server.ts`
- [MCP tools](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/server/mcp-tools.ts): `src/server/mcp-tools.ts`
- [Project Studio](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/ProjectStudio.tsx): `src/project/ProjectStudio.tsx`
- [Project API client](https://github.com/vediograph-wuzhijing/videograph-validation/blob/main/src/project/api.ts): `src/project/api.ts`

### Other components

- **MCP-connected LLM**
- **Human reviewer**

## Connections

- MCP-connected LLM → MCP server: connects via MCP (evidence: `README.md`)
- MCP server → MCP tools: dispatches tools (evidence: `src/pdoom/mcp-server.ts`)
- Human reviewer → Project Studio: reviews work (evidence: `README.md`)
- Project Studio → Project API client: requests project data (evidence: `src/project/ProjectStudio.tsx`)
- Project API client → Local project service: calls local service (evidence: `src/project/api.ts`)
- MCP tools → Local project service: invokes workflow
- Local project service → Project store: reads and writes (evidence: `src/server/index.mjs`)
- Local project service → Song analysis: starts analysis (evidence: `src/server/index.mjs`)
- Song analysis → Rhythm tools: uses rhythm analysis
- Human reviewer → Analysis correction: corrects analysis (evidence: `README.md`)
- Analysis correction → Project Studio: confirms analysis
- MCP-connected LLM → AI director: plans and revises (evidence: `README.md`)
- AI director → Project store: updates project (evidence: `src/server/director.mjs`)
- MCP-connected LLM → Scene authoring: submits scene code (evidence: `README.md`)
- Scene authoring → Project store: stores scene source (evidence: `src/server/project-store.mjs`)
- Project Studio → Transition editing: edits transitions
- Transition editing → FX runtime: prepares effects (evidence: `src/server/transitions.mjs`)
- Human reviewer → Feedback workflow: leaves anchored feedback (evidence: `README.md`)
- Feedback workflow → Project store: persists feedback (evidence: `src/server/project-store.mjs`)
- Project Studio → Revision comparison: opens comparison (evidence: `src/project/ProjectStudio.tsx`)
- Revision comparison → Project API client: requests stills and previews (evidence: `src/project/ReviewCompare.tsx`)
- Human reviewer → Revision comparison: accepts or rejects (evidence: `README.md`)
- Local project service → Render worker: queues render jobs (evidence: `src/server/index.mjs`)
- Render worker → Project store: loads jobs and projects (evidence: `src/server/render-worker.mjs`)
- Render worker → Reference engine: renders project scenes (evidence: `src/server/render-worker.mjs`)
- Render worker → Render cache: reuses cached segments (evidence: `src/server/render-worker.mjs`)
- Render worker → Browser renderer: renders in browser (evidence: `src/server/render-worker.mjs`)
- FX runtime → Browser renderer: previews effects
