tap.808.seq~ + tap.303.seq~: the sequencers (plan, objects, vertical slices)

[tap]

The package half of the coordinated phase 3 both family plans deferred to. Contains the design of record (plans/tap.seq.md, drafted, §6-approved, and implemented 2026-07-18), the two new objects with full vertical slices, and the doc/patcher updates.

The plan — plans/tap.seq.md

Answers the coordination question both plans/tap.808.md §6 and plans/tap.303.md §6 left open: the sequencers share at the kernel level, not the object level — one engine (step_seq.h in tap/taptools) with two thin per-family emitters. Blocking decisions approved: the two-object shape (808-plan option (b) unified with the 303 emitter), phase-driven clocking from phasor~ with no clock object in v1, and pattern slots with boundary-quantized recall as the A/B-half / fill mechanism. Both family plans' §6 sections marked resolved.

The objects

• tap.808.seq~ — one drum row: phase ramp in, amplitude-as-accent impulses out (the tap.808.* trigger contract; plain 0.01 = the 4 V base, accented 0.5 = accent knob at noon). hits/accents/velocities surfaces, @pulse widening, @swing, polymeter via @length, 16 slots with quantized recall, todict/fromdict, and a 1-based step-index UI outlet (coalescing audio→scheduler handoff, the tap.sift~ idiom).
• tap.303.seq~ — the acid line: emits the tap.303~ pitch + gate pair (1.0/2.0 accent amplitudes, gate duty 0.5), slide as gate-hold across the boundary, per-step pitch/gate/accent/slide, live @transpose, same slots/dict/step-outlet surface.

Vertical slices

• min-api unittests for both (also compiled and run against the mock kernel during development — which caught an attribute construction-order hazard and two min-api dict API gaps, worked around via dictionary_appendatoms).
• maxrefs, help patchers, and maxtest starters for both objects.
• help/tap.808.maxhelp rebuilt on real rows — one phasor~, nine rows (the hat gets closed + open), the metro/counter/sel pattern retired. help/tap.303.seq~.maxhelp supersedes the tap.303~-pattern.maxpat dry run, which stays as the event-domain alternative.
• RELATED cross-links added to tap.303~ and tap.808.kick~; REVIVAL.md §7 entries.

Submodule

Pins tap/taptools at the head of the same branch (the engine, the step_seq.ipynb verification notebook, and the book's rhythm-section chapters). Merge tap/TapTools#16 first, then this.

CI

build (macOS universal + Windows + ctest) and Tap House Style (clang-format + clang-tidy + drift) are green on the code head. Runtime validation in Max on a licensed install remains open, as for every object in the package — the maxtest starters and help patchers are the material for it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JZivyxyBdHYd8sVf8AdUbN

---

Generated by Claude Code