Menu
Pulp musical/media time primitives, editable tempo and meter maps, immutable compiled lookup, streaming cursors, exact sample anchors, and shared transport quantization arithmetic.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | timebase |
| description | Pulp musical/media time primitives, editable tempo and meter maps, immutable compiled lookup, streaming cursors, exact sample anchors, and shared transport quantization arithmetic. |
Use this skill when changing core/timebase, tempo conversion, or the transport
quantizer's beat/frame arithmetic.
kTicksPerQuarter is 705,600. Musical positions are stored and accumulated as
integer TickPosition; samples use integer SamplePosition. Tick-position,
duration, and MonotonicBeat arithmetic saturates at the signed 64-bit
endpoints; it must not invoke signed-overflow UB.TempoMap and MeterMap are editable document values built through
nonthrowing factories. Their first point is tick zero and points are strictly
ordered. Meter changes must compile on exact preceding bar boundaries.CompiledTempoMap is immutable and sample-rate-specific. Construct it only
through CompiledTempoMap::compile() and handle TempoMapError; public
throwing construction is forbidden. Its first tempo point
is tick zero, points are strictly ordered, and BPM is finite in [1, 1000].samples_to_ticks() returns
the first canonical tick mapping to that sample when one exists. Exact sample
-> tick -> sample requires a tick grid at least as dense as samples. On a
sparser grid, use resolve_sample() and inspect represented_sample,
absolute_error_samples, and exact; the nearest tick is returned.TempoCursor is the allocation-free playback path. Monotonic sample advances
consume segment transitions once (amortized O(1)); seeks and loop wraps reset
it explicitly. Differential tests must match cold-map canonical results.CompiledMeterMap uses zero-based bars and exact integer bar/tick conversion.
Tempo changes never affect bar conversion and meter changes never affect
tick/sample conversion. Conversion is total across INT64_MIN..INT64_MAX:
exact results are returned when representable and out-of-range results
saturate without signed-overflow UB.TransportQuantizer's public behavior stable. Generic beat/frame/grid
arithmetic belongs in <pulp/timebase/quantize.hpp> and the format wrapper
delegates to it.Build and run pulp-test-timebase and the existing
pulp-test-transport-quantizer oracle. Keep at least 1,000,000 deterministic
randomized constant/ramp cases, plus tempo-point boundary cases.
MonotonicBeat is the strong type for the transport's non-looping musical
clock; the transport owns how it advances while timeline positions seek or
wrap.
Build, edit, validate, explain, render, import, or integrate Pulp timeline projects through the CLI, MCP tools, or C++ SDK. Use for sequencers, arrangements, clips or notes, tempo and meter maps, automation, takes and comps, freeze, capture-to-timeline workflows, durable journals, project persistence, DAWproject import, Standard MIDI File import and export, and agent-driven timeline operations.
Pulp in the browser — the WAM v2 and WebCLAP adapters, the wasm runtime, the Skia/WebGL2 browser window host, and the WebGPU (emdawnwebgpu) GPU-audio lane. Covers what does and does not compile to wasm, the worklet-thread constraints (no std::thread, no fetch, no navigator.gpu), the non-realtime tick, memory growth, how to PROVE a GPU lane actually ran rather than silently falling back to CPU, and the silent-failure traps that make a wasm build "work" while producing no audio or no pixels.
Local and cloud CI for Pulp — validate branches, create PRs, merge on green. Handles "push to main", "ship this", "run CI", "check PR", and "list PRs".
Stand up a fast, cached, isolated, disposable macOS CI lane on Tart — layered golden VM images, ephemeral per-job GitHub Actions runners, host-mounted caches, and a reusable per-repo vm-image manifest. Use when setting up VM-based CI for Pulp or generalizing it to another repo, building/refreshing golden images, wiring ephemeral runners, or debugging the VM lane.
Pulp timeline transport, immutable compiled playback programs, bounded arrangement audio rendering, block-level publication latches, stable shells, and ProcessContext projection.
Load, run, and test VST3 / AU / CLAP / LV2 plugins from Pulp code. Use when working on `core/host/` (scanner, plugin_slot, signal_graph), when adding a new format backend, when wiring a plugin into a SignalGraph, or when writing an integration test that needs a real plug-in binary.