From 673b09df703daf437add932494a583ed50394f14 Mon Sep 17 00:00:00 2001 From: skal Date: Mon, 16 Feb 2026 08:41:51 +0100 Subject: docs: update for Sequence v2 phases 1-2 --- PROJECT_CONTEXT.md | 3 ++- doc/SEQUENCE_v2.md | 37 +++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md index f59eb8b..3a7995c 100644 --- a/PROJECT_CONTEXT.md +++ b/PROJECT_CONTEXT.md @@ -39,7 +39,8 @@ - **Effects:** CNN post-processing: CNNEffect (v1) and CNNv2Effect operational. CNN v2: sigmoid activation, storage buffer weights (~3.2 KB), 7D static features, dynamic layers. Training stable, convergence validated. - **Tools:** CNN test tool operational. Texture readback utility functional. Timeline editor (web-based, beat-aligned, audio playback). - **Build:** Asset dependency tracking. Size measurement. Hot-reload (debug-only). -- **Testing:** **36/36 passing (100%)** +- **Sequence v2 (In Progress):** DAG-based effect routing. Phase 1 (foundation) & Phase 2 (compiler) complete. Node system, topological sort, Python compiler operational. See `doc/SEQUENCE_v2.md`. +- **Testing:** **35/35 passing (100%)** --- diff --git a/doc/SEQUENCE_v2.md b/doc/SEQUENCE_v2.md index 74692a6..0e9d5a9 100644 --- a/doc/SEQUENCE_v2.md +++ b/doc/SEQUENCE_v2.md @@ -1,5 +1,42 @@ # Sequence v2 System Documentation +**Status:** Phase 1 & 2 complete (Foundation + Compiler operational) + +## Quick Start + +```bash +# Compile v2 timeline to C++ +python3 tools/seq_compiler_v2.py input.seq --output generated/timeline_v2.cc + +# Final mode (flattened, no vtables) +python3 tools/seq_compiler_v2.py input.seq --output timeline_v2.cc --flatten +``` + +## v2 Timeline Syntax + +``` +# BPM 120 + +SEQUENCE 0.0 0 "sequence_name" + # Node declarations (optional, auto-inferred as u8x4_norm) + NODE gbuf_normal f16x8 + NODE depth depth24 + + # Asset dependencies + ASSET shader_blur + + # Effect routing: inputs... -> outputs... + EFFECT + DeferredRender source depth -> gbuf_normal gbuf_pos 0.0 10.0 + EFFECT + Compose gbuf_normal gbuf_pos -> composed 0.0 10.0 + EFFECT + Blur composed -> sink 0.0 10.0 +``` + +**Node types:** `u8x4_norm`, `f32x4`, `f16x8`, `depth24`, `compute_f32` + +**Priority modifiers:** `+` (increment), `=` (same), `-` (decrement) + +--- + This document describes the high-level ideas for an improved Sequence + Effects system "version 2". ## Goal -- cgit v1.2.3