Stage 1 of #338. Game sync needs named places in a song: an event when
the playhead passes one, and a switch that jumps to one. This stage
adds the markers themselves. Games do nothing with them yet.
- A song has markers, each with id, name and tick. A song without
markers stores nothing for them. Two markers may share tick and
name, since nodes will name them by id.
- Markers change neither the sound nor the bake fingerprint.
- The song tab draws a strip under the ruler. A marker has a green
flag with its name and a faint line through the tracks. Tracks and
lanes sit 18 px lower. The ruler of the pattern tab is unchanged.
- Double click on an empty place adds a marker on the grid, with Alt
or Shift on the exact tick. Dragging moves it in one undo step.
- A click on a marker sets the start of playback there. A double click
renames it in the name dialog of the hierarchy groups.
- The context menu offers Play from here, Rename and Delete marker,
on an empty place Add marker. A tooltip shows the full name. The
wheel over the strip zooms time like the ruler.
- New agent commands add_song_marker, change_song_marker and
remove_song_marker. get_asset lists them under markers.
Tests:
- song-markers in core 6 and editor 4, 1 agent test, with the touched
song, agent and MCP tests 175/175
- 9 counter-probes, all compile, all red
- e2e 65 on atx: ALL PASSED, 70 checks, 3 new in 65g3. Counter-probe
where a dragged marker is not taken over: 65g3 red
- gate on atx: CHECK EXIT 0, 332 files, 5093 tests
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Stage 4 of #337. Lanes could only be drawn in the song tab. Now the
agent can set them in one step and sees which parameters a lane of a
track can move.
- New command set_song_lane. The target is named as it is stored:
volume, pan or param:<name>. All points come at once, each with
tick, value and ease, from the same eases as animation keys,
curve assets included.
- Points on one tick keep the order they come in, which makes a jump.
points [] removes a volume or pan lane, remove a parameter lane.
- It refuses with a clear message: a value outside the range, an
unknown ease, a missing curve asset, a range for volume or pan, and
a new lane for a parameter nothing on the track has. The message
then names the parameters there are.
- Without min and max a new parameter lane gets the range the dialog
in the song tab offers.
- get_asset names under params of each song track the parameters a
lane can move, with their default. The lanes were already in it.
Live in the user's project: get_asset named both parameters of their
two lanes (frequency, env) with defaults 20000 and 0.5. Playing to
3 s and 4.2 s, both tracks were heard, the audio clock running.
Tests:
- agent-music 13/13 (2 new), agent and MCP tests 129/129
- 6 counter-probes, all compile, all red
- gate on atx: CHECK EXIT 0, 330 files, 5082 tests
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A live test of the music areas built a pattern, a song and a
composition that stayed silent: no instrument at first, and later
notes outside the C4 to B4 range of a new Notes node. The agent got
no hint of either. The same test showed that new nodes left groups
behind, that a comment could end up under other nodes, and that an
end node like Output stayed left of the devices put in front of it.
- get_asset lists under silent what of a pattern, song or
composition is not heard. That is a missing instrument, an
instrument that sounds no note, or notes outside what its Notes
nodes take in, in a song after the transpose.
- soundingNotes moves from the pattern tab to
src/core/instrument/compile.ts. The tab and the agent use the
same rule.
- When new nodes go between two that have no room, everything from
the fed node on moves right together. This holds for Arrange with
a selection too, so no link runs backwards.
- A new node linked to a node in a group joins that group, and the
group grows in the same undo step. A group that would take in a
foreign node stays as it is.
- Arrange takes groups and comments along: a group whose nodes all
moved the same keeps its size, otherwise it is fitted anew. The
rules live in the new src/editor/graph/annotationFollow.ts.
- add_comment and fit_group put a comment below its nodes when a
node or a group title is in the way above. lint_graph counts
covered comments as coveredNotes.
- add_notes, get_asset, lint_graph and the relay instructions name
the default range and how to mend a covered comment.
Tests:
- graph-follow (new, 12), agent-edit, agent-music (11) and the
other agent, graph, pattern and relay tests green
- 10 deliberate breakages, each one red in its own test
- e2e 71: 25/25
- Gate: CHECK EXIT 0, 324 files, 5002 tests
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The agent could already draw, animate and wire graphs, but songs,
patterns, sound clips and compositions were out of its reach. This
last step of #429 adds the two missing catalog areas, so the agent
can now use 168 of the editor's commands.
- Area music (15 commands): notes, pattern and song loops, song
tracks and items, sends, and clips of sounds and videos.
- Area composition (9 commands): tracks, items for objects, images
and audio, changes with fades, volume and bus, removal, and
animation clips.
- A pitch is a MIDI number or a name like C4 or F#3. A note past the
end of its pattern is refused.
- Song and master routing stay graphs. The agent links them with
connect, and set_send sets level and tap. get_graph now shows the
send of every link.
- Lengths follow the same rules as dragging in the tab. A sound has
a length only after the editor loaded it. get_asset reports it as
seconds, and without it the agent has to give a length.
- Moving a composition item takes its clips along, as dragging does.
A clip that would then overlap another one is refused. Fades are
only allowed on items with sound.
- get_asset reads notes back with their names and gives the length
of a pattern in ticks.
Found while testing live: two song tracks in the same column made
lint_graph report a backwards link. arrange_graph cleared it, as the
agent instructions ask.
Tests:
- agent-music (new, 9 tests) and the other agent and relay tests:
109/109.
- 9 mutations of the new code, each one red in its own test.
- e2e 71 on melektaus-atx: 25/25. New check: notes are read back by
name, and a composition with a pattern and a sprite opens in its
tab.
- Gate on melektaus-atx: CHECK EXIT 0, 323 files, 4987 tests.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
adminandClaude Opus 5.5