attack-system-generalization-3.md
attack-system-generalization-2.md
attack-system-generalization-1.md
edition-system-generalization.md
emoji-aimer-8.md
invoker-spellcasting-tree-structure.md
emoji-aimer-7.md
anchor-app-phase-2-part-2.md
anchor-app-phase-2-part-1.md
invoker-hp-and-mana-orbs.md
emoji-aimer-6.md
emoji-aimer-5.md
orblike-to-invoker.md
emoji-aimer-4.md
anchor-app-phase-1-part-3.md
emoji-aimer-3.md
anchor-app-phase-1-part-2.md
emoji-aimer-2.md
codex-tests.md
emoji-aimer-1.md
---

File content (387.8KB) exceeds maximum allowed size (256KB). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whole file.

1    Title: Attack System Generalization 3
2   Date: 2026-05-20 17:35:17
3   
4   # Attack System Generalization 3
5   
6   ## Summary
7   
8   Third session on `E:/a327ex/attack-template/` — the self-contained Anchor 2 project that ports every Orblike v1 attack carrier as a reusable visual-only module. Picked up after sessions 1-2 (scaffold + projectile carrier + instant area carrier) and shipped: persistent (DoT) area mode, the full beam carrier (instant + persistent), the flicker-strike carrier, a five-layer render stack, an engine-backed hit-stop system, and an `fx_effect` primitive. By session end the template has four carriers done (projectile, area, beam, flicker); only polygonal/big-rock and the bespoke carriers remain.
9   
10  **Persistent (DoT) areas:**
11  - Extended `area.lua` with a persistent mode selected by passing `duration` (+ optional `tick_rate`, default 0.5s). Instant mode unchanged.
12  - Persistent lifecycle: 0.25s tween-up (vs 0.05s instant), `timer_every(tick_rate, 'tick', ...)` damage loop with a per-area `hit_cooldowns[entity_id]` table gating re-hits, blink+kill after `duration`. Ticks continue through the blink phase (matches v1).
13  - Per-tick: `e:hit(damage, 0)` with `hit_vol=0` to silence the per-enemy headshot sound (the single `dot_tick` plays once per tick instead — v1 line 8685 parity). Lighter particles than instant (1-2, vel 30-80, w=4, no hit_effect sprite). On any hit: `dot_tick` sound, spring pull 0.1, 0.1s flash, arc-speed spike +1.25π capped at 3π.
14  - `dot_tick` sound ported (`Click sound 37 + Body Fall 18.ogg`, vol 0.49, v1 line 14). `N` key toggles instant↔persistent in the demo.
15  
16  **Persistent-area visual iteration (arc decay + breathing):**
17  - User asked the circle's arc-spin to decay when no hits land recently. Added exponential decay of `arc_speed` toward a stored `arc_baseline` (rate k=3, ~95% decay/sec). Tick spikes raise it; decay drags it back.
18  - For non-smooth-circle persistent shapes, added a slow scale "breathing" (`1 + 0.05*sin(phase)`, ~0.5 Hz, random start phase) since they have no arcs as a life signal. Applied as a multiplier on the spring scale `s` at draw time, gated to skip the smooth circle.
19  
20  **Beam carrier — instant (`beam.lua` new):**
21  - Scoped via AskUserQuestion: visual = v1 `railgun_flash` (clump-retract), no charge phase, `mouse:3` trigger.
22  - Beam is internally a polyline (`self.path`). Non-homing = 2 points; the shared pipeline (wall clip, damage, dash draw) walks the path.
23  - Damage: rotated-box query (`query_entities_box`) covering the beam, hit window `width*6` (±width*3 perp, v1 line 3982).
24  - Visual: `railgun_flash` — dashes built once, grouped into clumps of 2-4 whose `visible_start/visible_end` tween toward each clump's midpoint with staggered delays over `duration` (0.25s). Wall raycast clips the path per-segment.
25  - `spawn_beam(caster, opts)` mirrors `spawn_projectile`.
26  
27  **Beam tip FX iteration:**
28  - Added a tip impact hit_circle + particles at the path endpoint.
29  - User: drop the beam_cast sound entirely → removed sound, asset, volume entry.
30  - User: particles should be radial not coned toward the caster → changed to `random_float(0, 2*math.pi)`.
... [90 more lines]

total 4422
drwxr-xr-x 1 adn 197121       0 May 20 17:15 ./
drwxr-xr-x 1 adn 197121       0 May 17 07:23 ../
drwxr-xr-x 1 adn 197121       0 May 20 17:34 .claude/
drwxr-xr-x 1 adn 197121       0 May 20 17:39 .git/
drwxr-xr-x 1 adn 197121       0 May 17 22:24 anchor/
-rwxr-xr-x 1 adn 197121 4185088 May 17 22:07 anchor.exe*
-rw-r--r-- 1 adn 197121   19223 May 18 08:43 area.lua
drwxr-xr-x 1 adn 197121       0 May 20 16:57 assets/
-rw-r--r-- 1 adn 197121   21375 May 20 16:04 beam.lua
-rw-r--r-- 1 adn 197121   20164 May 17 07:34 edition.lua
-rw-r--r-- 1 adn 197121   43373 May 17 13:57 findings.md
-rw-r--r-- 1 adn 197121   14512 May 20 17:15 flicker.lua
-rw-r--r-- 1 adn 197121    9235 May 20 16:58 fx.lua
-rw-r--r-- 1 adn 197121   19233 May 17 07:34 geometry.lua
-rw-r--r-- 1 adn 197121   30812 May 17 07:34 gradient.lua
-rw-r--r-- 1 adn 197121   26864 May 20 16:59 main.lua
-rw-r--r-- 1 adn 197121   11602 May 17 07:34 palette.lua
-rw-r--r-- 1 adn 197121    7824 May 17 12:46 player.lua
-rw-r--r-- 1 adn 197121   10661 May 17 20:26 projectile.lua
-rw-r--r-- 1 adn 197121     206 May 17 07:36 run.bat
-rw-r--r-- 1 adn 197121   15495 May 18 11:51 seeker.lua
-rw-r--r-- 1 adn 197121    5576 May 17 20:41 sound_tuner.lua
-rw-r--r-- 1 adn 197121     691 May 18 08:46 sound_tuning.lua
-rw-r--r-- 1 adn 197121   12728 May 17 08:06 stats.lua
-rw-r--r-- 1 adn 197121   14481 May 17 07:34 symbols.lua
-rw-r--r-- 1 adn 197121    3649 May 17 08:27 wall.lua
---SRC---

1    # attack-template — orientation for new instances
2   
3   ## ⛔ HARD RULE — ALWAYS SHOW CODE BEFORE WRITING IT ⛔
4   
5   **This rule has no exceptions and is valid for every single edit, every
6   session, every file in this project.**
7   
8   Before calling `Write` or `Edit` on ANY file in `attack-template/`,
9   post the full code (or the exact diff for `Edit`) in a normal chat
10  message and explicitly ask "does this look right?" / "should I commit
11  this?" / equivalent. Wait for the user's go-ahead. Then write.
12  
13  This applies to:
14  - New files (show the entire file contents).
15  - Edits to existing files (show old → new with enough context to read).
16  - Even one-line edits. Even "obvious" fixes. Even when the user has
17    already approved the broader design — each individual file
18    operation is its own checkpoint.
19  
20  Tiny exceptions, narrowly scoped:
21  - Pure typo / docstring fixes the user explicitly asks you to make
22    inline.
23  - Edits to this CLAUDE.md or `findings.md` (docs about the project,
24    not project code) when the user has already specified the change in
25    prose.
26  
27  If you are unsure whether something counts, treat it as "show first,
28  then write."
29  
30  Why this rule exists: the user wants to review every code change
... [520 more lines]

1:# attack-template — findings from Orblike v1
21:## 1. The carrier taxonomy
55:## 2. The ability roster
110:## 3. Projectile system (deep dive)
209:## 4. Area system (deep dive)
236:### Shapes (with visuals, line 8954+)
281:## 5. Beam system (deep dive)
349:## 6. Polygonal projectile (Big Rock)
379:## 7. Movement abilities
392:### `dash_strike` (line 2320)
403:### `asal` (line 3160)
418:### `flicker_strike` (line 4450, also `dash_clone` `mode='flicker'`)
429:## 8. Effect primitive library
459:## 9. Modifier vocabulary
500:## 10. Sound bank (the elemental flavor knob)
533:## 11. Cast log / damage system
552:## 12. Recommended scope for attack-template/
626:## 13. Open questions for the user

349  ## 6. Polygonal projectile (Big Rock)
350 
351 **Class location:** `big_rock_effect` lines 11390–11692. Supported by `rock_fragment` (11696) and `rock_debris` (11780).
352 
353 ### Flight
354 
355 - 8-12 vertex jagged polygon generated at spawn (same algo as jagged_circle area).
356 - Real physics parabola: `gravity=2`, `v0=0.5*g*flight_duration`, max height at `t=0.5`. Visual scale `1 + 2*(h/h_max)` so the rock reads bigger at apex.
357 - Position: linear interp from origin to target. X marker at target blinks with accelerating rate (`math.lerp(t, 0.3, 0.04)`).
358 - Optional homing: target steers toward closest enemy at `base_steer = 40 units/s` (modifier-adjustable).
359 - `cast_on_apex` fires at t=0.5 (but skips `self_area` carrier since the rock is in the air).
360 - `magnetic_area` mod: during last 30% of flight, pulls enemies toward target every 0.3s + shockwave.
361 
362 ### Landing
363 
364 1. Spawn a `polygon` shape `area` with `polygon_verts` (the same jagged verts), `outer_radius = area_radius*2`. Full damage inside polygon, falloff (`0.75 → 0.1` mult by distance ratio) in outer ring with push proportional to remap.
365 2. Shatter into 3-4 polygon fragments (`rock_fragment`) via a wedge-partitioning algorithm:
366    - Pre-generate "radial jag points" along each outer-vertex-to-center line (1-3 jag points per radial with random offsets in `±35%, ±18%, or ±8%` budget).
367    - Build wedges by walking edges, going center → radial-jag → outer-vertex → … → outer-vertex → reverse-radial-jag → center.
368    - Each fragment becomes a Box2D polygon collider (max 8 vertices, simplified if needed), launched in its centroid direction at random 80–200 speed plus inherited throw velocity (×0.3).
369    - Random angular velocity ±10. Blinks at `(0.4–0.8) × duration`, kills after `0.5–1.0s`.
370 3. 8-14 rocky `hit_particle` blasts in random angles (size 3-6 × 2-4).
371 4. `add_shockwave(target, light=false, scale=area_radius/25)`.
372 5. Camera shake (push by throw direction + 8 magnitude + shake(5, 0.2)).
373 6. `area_sound` (fissure_cast_2) + random `explosion_flesh_1/3/4`.
374 
375 The shatter algorithm is bespoke and pretty pretty — worth preserving as-is.
376 
377 ---
378 
... [15 more lines]

anchor/
assets/
main.lua
profiler.lua
profiler_log.txt
recordings/
run.bat
---
13268 v1/main.lua

929:  big_rock = {
932:    carrier = 'big_rock',
1091:  'big_rock', 'railgun', 'psylance', 'wind_slash', 'righteous_fire',
1798:    elseif def.carrier == 'big_rock' then
1851:            an:add(big_rock_effect(fx, fy, {
4947:an:physics_tag('rock_fragment')
4949:an:physics_collision('rock_fragment', 'rock_fragment')
4953:an:physics_collision('rock_fragment', 'wall')
11388:-- Effect: big_rock_effect
11390:big_rock_effect = object:extend()
11391:function big_rock_effect:new(x, y, args)
11404:  self.ability = args.ability or 'big_rock'
11430:function big_rock_effect:update(dt)
11660:      an:add(rock_fragment(self.target_x + centroid_x + nudge_x, self.target_y + centroid_y + nudge_y, {
11694:-- Effect: rock_fragment
11696:rock_fragment = object:extend()
11697:function rock_fragment:new(x, y, args)
11726:  self:add(collider('rock_fragment', 'dynamic', 'polygon', flat_verts, {}))
11752:function rock_fragment:update(dt)
11778:-- Effect: rock_debris
11780:rock_debris = object:extend()
11781:function rock_debris:new(x, y, args)
11804:function rock_debris:update(dt)
12485:  orbs[3]:add_ability('big_rock')

11388    -- Effect: big_rock_effect
11389   -- Rock thrown in arc to target. X marker blinks at target, rock scales up at apex then down, AoE on landing.
11390   big_rock_effect = object:extend()
11391   function big_rock_effect:new(x, y, args)
11392     object.new(self)
11393     self.origin_x, self.origin_y = x, y
11394     self.target_x = args.target_x or x
11395     self.target_y = args.target_y or y
11396     self.flight_duration = args.flight_duration or 3
11397     self.area_radius = args.area_radius or 30
11398     self.damage = args.damage or 0
11399     self.element = args.element
11400     self.cast_log = args.cast_log
11401     if self.cast_log then self.cast_log:add_pending() end
11402     self.color = args.color or yellow
11403     self.mods = args.mods or {}
11404     self.ability = args.ability or 'big_rock'
11405     self.source_orb = args.source_orb
11406     self.area_sound = args.area_sound
11407     self.elapsed = 0
11408     self.landed = false
11409     self.apex_fired = false
11410     -- Generate jagged vertices once (like earthquake)
11411     local n = an.random:int(8, 12)
11412     self.jagged_verts = {}
11413     for i = 1, n do
11414       local base_a = (i - 1)*2*math.pi/n
11415       local a = base_a + an.random:float(-0.15, 0.15)
11416       local d = an.random:float(0.85, 1.1)
11417       table.insert(self.jagged_verts, {a = a, d = d})
... [420 more lines]

36:      polygon_verts,   -- polygon only; list of {a, d} (angle in rad, distance as
96:local function build_polygon_verts(input, radius, poly_r, jagged)
156:  self.hidden   = false
179:  if self.shape == 'polygon' then
180:    self.verts = build_polygon_verts(args.polygon_verts, self.radius, args.polygon_r or 0, self.jagged)
181:  elseif self.shape == 'circle' and self.jagged then
183:  elseif self.shape == 'rect' and self.jagged then
245:      timer_every(self.timer, 0.05, 'blink', function() self.hidden = not self.hidden end, 7, function()
259:        timer_every(self.timer, 0.05, 'blink', function() self.hidden = not self.hidden end, 7, function()
269:  if self.shape == 'rect' then
272:  elseif self.shape == 'polygon' then
362:  if self.hidden then return end
368:  if self.duration and not (self.shape == 'circle' and not self.jagged) then
374:  if self.shape == 'circle' and not self.jagged then
396:  elseif self.shape == 'rect' and not self.jagged then
421:    local push_r = (self.shape == 'rect') and self.r or 0
424:    if self.shape == 'rect' then
470:function spawn_area(x, y, opts)

470  function spawn_area(x, y, opts)
471   opts = opts or {}
472   -- Auto-derive aim angle from caster → area direction so rect / polygon
473   -- shapes orient along the cast. Only applied when caster is present
474   -- and the caller hasn't passed an explicit rotation. Self-casts
475   -- (distance ≤ 4 px) skip — the direction is degenerate. Circle is
476   -- radially symmetric so rotation is unused.
477   if opts.caster then
478     local dx, dy = x - opts.caster.x, y - opts.caster.y
479     if math.length(dx, dy) > 4 then
480       local aim_r = math.atan(dy, dx)
481       if opts.r         == nil then opts.r         = aim_r end
482       if opts.polygon_r == nil then opts.polygon_r = aim_r end
483     end
484   end
485   local a = area(x, y, opts)
486   areas[#areas + 1] = a
487   return a
488 end
489 

User has answered your questions: "The summary flagged wanting a generalizable 'airborne' abstraction for parabola/arc flight. How should I handle that for this carrier?"="Build airborne.lua now", "How should the rock's landing damage be applied?"="Reuse spawn_area polygon", "Which mods-adjacent behaviors should be dropped vs kept? (Design decision #1 says no modifier system.)"="Drop all (homing, magnetic, cast_on_apex)", "Demo trigger key for the big-rock throw? (Mouse 1/2/3 + F are taken.)"="R". You can now continue with the user's answers in mind.

1    --[[
2     projectile.lua — straight-line attack carrier (minimal v1 port).
3   
4     Scope of this first pass (per session 2 decisions):
5       • Default rounded-rect shape (w=10, h=4). No shape variants yet
6         (ball_lightning circle, wind_slash blades, arc crescent come later).
7       • Straight-line travel only. No homing / linear-return / arc-return.
8       • Sensor box collider — projectiles pass through enemies/walls
9         visually. Enemy hits are surfaced via sensor_entities_begin in
10        main.lua. Walls are caught by a per-frame forward raycast (sensors
11        don't physically collide).
12      • Spawn juice: spring pull on 'main' + 0.2s white flash.
13      • Wall hit:  6r/0.15s hit_circle + 2 particles, then die.
14      • Enemy hit: full damage + hit_effect sprite burst, then die. No
15        pierce/chain in this first pass — that's gameplay-side anyway.
16      • Death:     8r/0.2s hit_circle + 2 particles, particle color =
17                   edition_base_color(self.edition) or self.color.
18  
19    Caller API (per session 2 decision — "everything in spawn_projectile,
20    caster passed in, everything else derived"):
21      spawn_projectile(caster, {
22        aim_r,             -- optional, default: caster -> main_camera.mouse
23        spawn_offset,      -- default 8 (v1's hardcoded muzzle offset)
24        color,             -- default red
25        edition,           -- default caster.edition
26        max_range,         -- default nil = unlimited
27        damage,            -- default 1
28        speed,             -- default 190
29        w, h,              -- default 10, 4
30      })
... [255 more lines]

1    --[[
2     flicker.lua — flicker-strike line/trail carrier (v1 flicker_strike).
3   
4     A self-contained moving entity. NOT the player — the caster only
5     supplies a spawn position, an aim direction, and an edition tint;
6     after that the flicker is autonomous. It hops between enemies along
7     cubic-bezier curves, leaving a fading dashed trail and spawning the
8     full v1 flicker-strike hit FX at each enemy it reaches. Port of v1's
9     flicker_strike (line 4450) — visuals + sounds, no player movement,
10    no modifiers (multistrike / melee_splash / echo are gameplay-side).
11  
12    Lifecycle:
13      1. Find an initial target: closest enemy to the click position
14         (target_x/target_y) within `range` of it — v1 flicker_strike's
15         first jump (closest enemy to the cursor). No target → fizzle.
16      2. Hop to it via a cubic bezier (control points 80% along the
17         entry/exit angles; exit angle pre-bends toward the next target),
18         lerped over `hop_delay`. Departure puff + 2 particles + shake.
19      3. On arrival: per-enemy hit FX (fx_energy_122 burst, hit_circle,
20         4 zag particles) + arrival juice (slash sounds, shake, body
21         flash + spring pulse).
22      4. After `hits` enemies are struck (or targets run out), stop with
23         the final burst (hit_stop, slash_final, AoE knockback, big FX).
24         The trail fades; the entity self-destructs once it's empty.
25  
26    Caller API:
27      spawn_flicker(caster, {
28        target_x,        -- click position; first hop targets the enemy
29        target_y,        --   closest to it. default: main_camera.mouse
30        aim_r,           -- optional, default: caster → click position
... [364 more lines]

1    --[[
2     attack-template/main.lua
3   
4     Smoke test for the attack-template scaffold. Drops a player (WASD-driven,
5     ported from Invoker/player.lua) in the middle of a small arena with a
6     static interior wall (Invoker/v1/main.lua wall_object) and 5 seekers
7     (Invoker/seeker.lua) chasing the player. Edition shimmer on every entity
8     via the same draw shader the edition-template uses.
9   
10    KEY BINDINGS
11      W A S D / arrows   move player
12      0  / F1            cycle player edition forward / backward
13                         — prints the new mode's name to console
14  ]]
15  
16  require('anchor')({
17    width  = 480,
18    height = 270,
19    title  = 'attack-template — smoke test',
20    scale  = 3,
21    filter = 'rough',
22  })
23  
24  require('palette')
25  require('edition')
26  
27  edition_setup({ draw_shader = 'assets/draw_shader.frag' })
28  
29  require('geometry')
30  require('stats')
... [633 more lines]

1    --[[
2     fx.lua — one-shot visual effects.
3   
4     Two entity types ported from v1's hit_circle / hit_particle. They
5     exist for a brief duration, draw something, and auto-kill. Spawned
6     by gameplay code (projectile spawn, wall hit, area damage in the
7     future) via spawn_hit_circle / spawn_particle. Both live in the
8     global fxs[] array, updated and drawn from main.lua.
9   
10    fx_hit_circle — filled circle that SHRINKS from initial radius to
11      0 over `duration` (cubic_in_out). Starts white (the `text`
12      palette token); the optional :change_color(fraction, target)
13      chainable swaps it to the spell color at the given fraction of
14      duration, giving the v1 "flash white, then bleed into element
15      color" feel.
16  
17    fx_particle — rotated rounded rectangle that flies outward at
18      self.angle, with w/h/velocity tweening down to {2, 2, 0} over
19      `duration` (sine_in_out). Same white-then-color flash via
20      :change_color. Used for cast bursts, wall impact debris, and
21      (future) on-hit particles.
22  
23    Both kinds match v1 visuals byte-for-byte where possible —
24    ability_layer is replaced with the game_layer caller, the object
25    tree is replaced with explicit fxs[] iteration, an.random calls
26    become random_float / random_choice. Otherwise the math, easings,
27    defaults, and feel are unchanged.
28  ]]
29  
30  
... [262 more lines]

15:  shockwave = 0.5,
12511:shockwaves = {}
12512:function add_shockwave(wx, wy, light, scale)
===
675:  add_shockwave(x, y, true, base_radius/25)
7416:                      add_shockwave(closest_orb.x, closest_orb.y, true, 0.5)
8705:          add_shockwave(self.x, self.y, true, self.radius/25)

12511    shockwaves = {}
12512   function add_shockwave(wx, wy, light, scale)
12513     scale = scale or 1
12514     if light then
12515       table.insert(shockwaves, {wx = wx, wy = wy, radius = 32*scale, max_radius = 32*scale, speed = -400, strength = -0.05, thickness = 0.08})
12516     else
12517       table.insert(shockwaves, {wx = wx, wy = wy, radius = 64*scale, max_radius = 64*scale, speed = -350, strength = -0.06, thickness = 0.12})
12518       sfx('shockwave', volumes.shockwave)
12519     end
12520   end
12521   
12522   -- Cache enemy list once per frame (avoids O(N) tree traversal per enemy)
12523   cached_enemies = {}
12524   enemy_spatial_hash = nil
12525   function build_enemy_spatial_hash(enemies, cell_size)
12526     local cells = {}
12527     for i = 1, #enemies do
12528       local e = enemies[i]
12529       local cx = math.floor(e.x/cell_size)
12530       local cy = math.floor(e.y/cell_size)
12531       local key = cx*73856093 + cy*19349663
12532       if not cells[key] then cells[key] = {} end
12533       cells[key][#cells[key] + 1] = e
12534     end
12535     return {cells = cells, cell_size = cell_size}
12536   end
12537   an:early_action(function()
12538     cached_enemies = an:all('enemy')
12539     enemy_spatial_hash = build_enemy_spatial_hash(cached_enemies, 32)
12540     packs_update()
... [25 more lines]

927      hit_delay_per = 0.02,
928   },
929   big_rock = {
930     activation = 'manual',
931     tags = {'area', 'physical', 'earth'},
932     carrier = 'big_rock',
933     color = yellow,
934     cooldown = 5,
935     area_radius = 30,
936     damage = 12,
937     element = 'earth',
938     flight_duration = 3,
939     fire_sound = 'fissure_cast_1',
940     area_sound = 'fissure_cast_2',
941   },
942   railgun = {
943     activation = 'manual',
944     tags = {'beam', 'physical'},
945     carrier = 'railgun',
946     color = fg_color,

1798     elseif def.carrier == 'big_rock' then
1799          local mx, my = an.camera.mouse.x, an.camera.mouse.y
1800          local dist = math.distance(fire_x, fire_y, mx, my)
1801          local aim_r = math.angle_to_point(fire_x, fire_y, mx, my)
1802    
1803          -- Build direction angles
1804          local br_angles = {}
1805          local s_nova = mods.nova or mods.area_nova
1806          local s_spread = mods.spread or mods.area_spread
1807          local s_back = mods.back or mods.area_back
1808          local s_sides = mods.sides or mods.area_sides
1809          if s_nova then
1810            for i = 0, 7 do table.insert(br_angles, aim_r + i*math.pi/4) end
1811          else
1812            if s_spread and s_spread >= 2 then
1813              local n = s_spread
1814              local fan = math.pi/6 + (n - 2)*math.pi/12
1815              for i = 1, n do
1816                local t = (i - 1)/(n - 1)
1817                table.insert(br_angles, aim_r + fan*(t - 0.5))
1818              end
1819            else
1820              table.insert(br_angles, aim_r)
1821            end
1822            if s_back then table.insert(br_angles, aim_r + math.pi) end
1823            if s_sides then
1824              table.insert(br_angles, aim_r + math.pi/2)
1825              table.insert(br_angles, aim_r - math.pi/2)
1826            end
1827          end
... [40 more lines]

Explosion Flesh 1.ogg
Explosion Flesh 1.wav
Explosion Flesh 1_lightmed.ogg
Explosion Flesh 3.ogg
Explosion Flesh 3.wav
Explosion Flesh 3_lightmed.ogg
Explosion Flesh 4.ogg
Explosion Flesh 4.wav
Explosion Flesh 4_lightmed.ogg
RPG3_FireMagic_Explosion01.ogg
RPG3_FireMagic_Explosion01.wav
RPG3_FireMagic_Explosion01_lightmed.ogg
===ATTACK-TEMPLATE ASSETS===
ARROW_Hit_Wood_Shield_stereo.ogg
Bloody punches 10.ogg
Bloody punches 3.ogg
Bloody punches 7.ogg
Body Fall 2.ogg
Body Head (Headshot) 1.ogg
Click sound 37 + Body Fall 18.ogg
PM_GENERIC_Slash02.ogg
PM_GENERIC_Slash04_P2.ogg
RPG3_GenericArrow_Shoot01.ogg
Sword_Slash_1_v1.ogg
Sword_Slash_1_v2.ogg
Sword_Slash_1_v3.ogg
Sword_Slash_1_v4.ogg
draw_shader.frag
fx_energy_122.png
hit1.png
... [1 more lines]

16:  fissure_cast_1 = 0.5,
17:  fissure_cast_2 = 0.55,
146:an:sound('fissure_cast_1', 'assets/Spell_Earth_02.ogg')
147:an:sound('fissure_cast_2', 'assets/Spell_Earth_04.ogg')
508:  {'fissure_cast_1', 'assets/Spell_Earth_02'},
509:  {'fissure_cast_2', 'assets/Spell_Earth_04'},
739:    cast_sounds = {'fissure_cast_1'},
801:    cast_sound = 'fissure_cast_1',
802:    area_sound = 'fissure_cast_2',
804:    aftershock_sound = 'fissure_cast_1',
===vols===
16:  fissure_cast_1 = 0.5,
17:  fissure_cast_2 = 0.55,
41:  explosion_flesh_1 = 0.52,

Spell_Earth_02 (2).wav
Spell_Earth_02.ogg
Spell_Earth_02.wav
Spell_Earth_02_lightmed.ogg
Spell_Earth_04.ogg
Spell_Earth_04.wav
Spell_Earth_04_lightmed.ogg
Spell_Earth_Impact_Critical.wav

33:collider = class()
35:function collider:new(owner, tag, body_type, shape_type, ...)
63:    elseif shape_type == 'polygon' then
73:function collider:destroy()
85:function collider:sync()
92:function collider:get_position() return physics_get_position(self.body) end
93:function collider:set_position(x, y) physics_set_position(self.body, x, y) end
94:function collider:get_angle() return physics_get_angle(self.body) end
95:function collider:set_angle(angle) physics_set_angle(self.body, angle) end
98:function collider:get_velocity() return physics_get_velocity(self.body) end
99:function collider:set_velocity(vx, vy) physics_set_velocity(self.body, vx, vy) end
100:function collider:get_angular_velocity() return physics_get_angular_velocity(self.body) end
101:function collider:set_angular_velocity(av) physics_set_angular_velocity(self.body, av) end
104:function collider:apply_force(fx, fy) physics_apply_force(self.body, fx, fy) end
105:function collider:apply_force_at(fx, fy, px, py) physics_apply_force_at(self.body, fx, fy, px, py) end
106:function collider:apply_impulse(ix, iy) physics_apply_impulse(self.body, ix, iy) end
107:function collider:apply_impulse_at(ix, iy, px, py) physics_apply_impulse_at(self.body, ix, iy, px, py) end
108:function collider:apply_torque(torque) physics_apply_torque(self.body, torque) end
109:function collider:apply_angular_impulse(impulse) physics_apply_angular_impulse(self.body, impulse) end
112:function collider:set_linear_damping(damping) physics_set_linear_damping(self.body, damping) end
113:function collider:set_angular_damping(damping) physics_set_angular_damping(self.body, damping) end
114:function collider:set_gravity_scale(scale) physics_set_gravity_scale(self.body, scale) end
115:function collider:set_fixed_rotation(fixed) physics_set_fixed_rotation(self.body, fixed) end
116:function collider:set_bullet(bullet) physics_set_bullet(self.body, bullet) end
119:function collider:set_friction(friction, shape) physics_shape_set_friction(shape or self.shape, friction) end
120:function collider:get_friction(shape) return physics_shape_get_friction(shape or self.shape) end
121:function collider:set_restitution(restitution, shape) physics_shape_set_restitution(shape or self.shape, restitution) end
122:function collider:get_restitution(shape) return physics_shape_get_restitution(shape or self.shape) end
123:function collider:set_density(density, shape) physics_shape_set_density(shape or self.shape, density) end
124:function collider:get_density(shape) return physics_shape_get_density(shape or self.shape) end
... [10 more lines]

35   function collider:new(owner, tag, body_type, shape_type, ...)
36    self.owner = owner
37    self.tag = tag
38    self.body_type = body_type
39    self.shape_type = shape_type
40    self.body = physics_create_body(body_type, 0, 0)
41  
42    -- Set user_data to the owner's ID so physics queries resolve via entities[id]
43    if owner and owner.id then
44      physics_set_user_data(self.body, owner.id)
45    end
46  
47    -- Add initial shape based on shape_type
48    -- Last arg can be an opts table (e.g. {sensor = true})
49    local shape_args = {...}
50    if shape_type == 'chain' then
51      self.chain = physics_add_chain(self.body, tag, shape_args[1], shape_args[2] or true)
52    else
53      local opts = {}
54      if type(shape_args[#shape_args]) == 'table' then
55        opts = table.remove(shape_args)
56      end
57      if shape_type == 'circle' then
58        self.shape = physics_add_circle(self.body, tag, shape_args[1], opts)
59      elseif shape_type == 'box' then
60        self.shape = physics_add_box(self.body, tag, shape_args[1], shape_args[2], opts)
61      elseif shape_type == 'capsule' then
62        self.shape = physics_add_capsule(self.body, tag, shape_args[1], shape_args[2], opts)
63      elseif shape_type == 'polygon' then
64        self.shape = physics_add_polygon(self.body, tag, shape_args[1], opts)
... [8 more lines]

anchor/math.lua:55:function math.lerp(t, source, destination)
anchor/math.lua:79:function math.lerp_dt(p, t, dt, source, destination)
anchor/math.lua:142:function math.lerp_angle(t, source, destination)
anchor/math.lua:167:function math.lerp_angle_dt(p, t, dt, source, destination)
anchor/math.lua:222:function math.clamp(value, min, max)
anchor/physics.lua:63:  query_entities_polygon(x, y, verts_flat, tags)
anchor/physics.lua:68:function query_entities_polygon(x, y, verts_flat, tags)

(Bash completed with no output)

anchor/array.lua:421:      local i = random_int(1, #t, rng)
anchor/array.lua:559:    local j = random_int(1, i, rng)
anchor/collider.lua:228:  self.wander_r = self.wander_r + random_float(-jitter*dt, jitter*dt)
anchor/shake.lua:263:        inst.current_x = decay*inst.amplitude*random_float(-1, 1)
anchor/shake.lua:264:        inst.current_y = decay*inst.amplitude*random_float(-1, 1)

<tool_use_error>Path does not exist: E:/a327ex/attack-template/anchor/random.lua. Note: your current working directory is E:\a327ex\attack-template.</tool_use_error>

(Bash completed with no output)

anchor/collider.lua
anchor/shake.lua
===

animation.lua
array.lua
camera.lua
class.lua
collider.lua
color.lua
font.lua
helpers.lua
image.lua
init.lua
input.lua
layer.lua
math.lua
memory.lua
object.lua
physics.lua
shake.lua
spring.lua
spritesheet.lua
timer.lua
===
area.lua
beam.lua
flicker.lua
fx.lua
geometry.lua
main.lua
player.lua
projectile.lua
seeker.lua

(Bash completed with no output)

==search all==
==maybe global in math==

anchor/init.lua:159:  -- Set up default random number generator (global_rng is provided by the C engine,
anchor/init.lua:160:  -- accessible by passing nil or omitting the rng argument to random_* functions).
anchor/init.lua:161:  -- If you want a seeded rng for determinism, create one with random_create(seed).

155    frame_num = 0
156   step_num = 0
157   time_scale = 1.0
158 
159   -- Set up default random number generator (global_rng is provided by the C engine,
160   -- accessible by passing nil or omitting the rng argument to random_* functions).
161   -- If you want a seeded rng for determinism, create one with random_create(seed).
162 
163   -- Physics is not initialized automatically. Games that need physics should call
164   -- physics_init() themselves, then register tags and collision pairs:
165   --   physics_init()
166   --   physics_register_tag('player')
167   --   physics_register_tag('enemy')
168   --   physics_enable_collision('player', 'enemy')
169 end
170 

218:random_float_01(rng?) -> number
219:random_float(min, max, rng?) -> number
220:random_int(min, max, rng?) -> int
221:random_angle(rng?) -> number
222:random_sign(chance?, rng?) -> -1 | 1
223:random_bool(chance?, rng?) -> bool
225:random_choice(array, rng?) -> element
226:random_choices(array, n, rng?) -> [element, ...]

1653:### random_bool
1654-
1655:`random_bool(chance?, rng?) -> bool`
1656-
1657-Returns true or false. Chance (0-100) is probability of true (default 50).
1658-
--
1660:if random_bool(10) then
1661-    -- 10% chance
1662-end
1663-```

79   
80  --[[
81    collider:sync()
82    Copies the body's position to owner.x/y. Convenience for entities that
83    want their logical position to track the physics position each frame.
84  ]]
85  function collider:sync()
86    if self.owner and self.body then
87      self.owner.x, self.owner.y = physics_get_position(self.body)
88    end
89  end
90  

96   local function build_polygon_verts(input, radius, poly_r, jagged)
97    poly_r = poly_r or 0
98    if not input or #input == 0 then
99      input = {}
100     for i = 1, 6 do
101       input[#input + 1] = {a = (i - 1)*2*math.pi/6, d = 1.0}
102     end
103   end
104   local verts = {}
105   local n = math.min(#input, POLYGON_MAX_VERTS)
106   for i = 1, n do
107     local v = input[i]
108     local a = v.a + poly_r
109     local d = v.d
110     if jagged then
111       a = a + random_float(-0.15, 0.15)
112       d = d*random_float(0.75, 1.1)
113     end
114     verts[#verts + 1] = {wx = radius*d*math.cos(a), wy = radius*d*math.sin(a)}
115   end
116   return verts
117 end
118 
119 
120 -- Convert {wx,wy} verts to a flat {x1,y1,x2,y2,...} array for the
121 -- engine query (and for layer_polygon_line if we used it).
122 local function verts_to_flat(verts)
123   local flat = {}
124   for _, v in ipairs(verts) do
125     flat[#flat + 1] = v.wx
... [30 more lines]

User has answered your questions: "The two new files (airborne.lua, polygonal.lua) above look right? Next I'll show the main.lua wiring edits, then write all files + copy the 5 sound assets."="[No preference]". You can now continue with the user's answers in mind.

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

23:    for _, ev in ipairs(sensor_entities_begin('bullet', 'enemy')) do
199:  sensor_entities_begin(tag_a, tag_b)
200:  Returns a table of sensor-begin events with normalized ordering so `a`
201:  corresponds to the first tag argument (typically the sensor) and `b`
204:function sensor_entities_begin(tag_a, tag_b)
205:  local events = physics_get_sensor_begin(tag_a, tag_b)
209:    local body_a, body_b = ev.sensor_body, ev.visitor_body
210:    -- Normalize: if sensor_tag is actually the second query tag, swap
211:    if ev.sensor_tag == tag_b and ev.visitor_tag == tag_a then
224:  sensor_entities_end(tag_a, tag_b)
226:function sensor_entities_end(tag_a, tag_b)
227:  local events = physics_get_sensor_end(tag_a, tag_b)
231:    local body_a, body_b = ev.sensor_body, ev.visitor_body
232:    if ev.sensor_tag == tag_b and ev.visitor_tag == tag_a then

93:set_filter_mode(mode)
94:get_filter_mode() -> string
120:physics_set_enabled(enabled)
122:physics_enable_collision(tag_a, tag_b)
123:physics_disable_collision(tag_a, tag_b)
124:physics_enable_sensor(tag_a, tag_b)
125:physics_enable_hit(tag_a, tag_b)
175:physics_shape_set_filter_group(shape, group) -- shapes with same non-zero group don't collide

E:/a327ex/Anchor2/docs/ENGINE_API_QUICK.md:167:physics_shape_set_friction(shape, friction)
E:/a327ex/Anchor2/docs/ENGINE_API_QUICK.md:169:physics_shape_set_restitution(shape, restitution)
E:/a327ex/Anchor2/docs/ENGINE_API_QUICK.md:173:physics_shape_set_density(shape, density)
E:/a327ex/Anchor2/docs/ENGINE_API_QUICK.md:175:physics_shape_set_filter_group(shape, group) -- shapes with same non-zero group don't collide
E:/a327ex/Anchor2/docs/ENGINE_API.md:1252:### physics_shape_set_friction
E:/a327ex/Anchor2/docs/ENGINE_API.md:1254:`physics_shape_set_friction(shape, friction)`
E:/a327ex/Anchor2/docs/ENGINE_API.md:1259:physics_shape_set_friction(ground_shape, 0.8)
E:/a327ex/Anchor2/docs/ENGINE_API.md:1272:### physics_shape_set_restitution
E:/a327ex/Anchor2/docs/ENGINE_API.md:1274:`physics_shape_set_restitution(shape, restitution)`
E:/a327ex/Anchor2/docs/ENGINE_API.md:1279:physics_shape_set_restitution(ball_shape, 0.9)
E:/a327ex/Anchor2/docs/ENGINE_API.md:1314:### physics_shape_set_density
E:/a327ex/Anchor2/docs/ENGINE_API.md:1316:`physics_shape_set_density(shape, density)`
E:/a327ex/Anchor2/docs/ENGINE_API.md:1321:physics_shape_set_density(shape, 2.0)
E:/a327ex/Anchor2/docs/ENGINE_API.md:2637:### physics_shape_set_filter_group
E:/a327ex/Anchor2/docs/ENGINE_API.md:2639:`physics_shape_set_filter_group(shape, group)`
E:/a327ex/Anchor2/docs/ENGINE_API.md:2645:physics_shape_set_filter_group(shape, player_id)

38   
39  - Work incrementally — complete one piece, let them test, get feedback
40  - After completing a task, give the user a turn before starting the next
41  - Don't chain tasks or build large systems autonomously
42  
43  ### Communication
44  
45  - Present options, not conclusions
46  - Surface tradeoffs explicitly
47  - Don't assume specs are final — they're starting points for conversation
48  
49  ### Code Changes
50  
51  - **⛔ ALWAYS show code before writing it.** Before calling `Write` or
52    `Edit` on any code file, post the full code (or exact old → new diff
53    for `Edit`) in chat. This applies to every file operation — new
54    files, existing files, even one-line edits.
55  
56    **Non-trivial changes**: ask "does this look right?" / "should I
57    commit this?" and wait for the user's go-ahead before writing.
58  
59    **Trivial changes**: show the diff and apply it in the same turn —
60    no ask. Trivial means:
61    - Single-line value tweaks (number, string, flag, font size, color hex)
62    - Variable renames within one file
63    - Single-line typo fixes
64    - User-specified imperatives ("change X to Y", "rename foo to bar")
65  
66    If unsure whether something counts as trivial, treat it as
67    non-trivial and ask.
... [22 more lines]

The file E:/a327ex/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

295:    math.distance(0, 0, 3, 4)      -> 5
296:    math.distance(self.x, self.y, target.x, target.y)
304:function math.distance(x1, y1, x2, y2)
exit:0

File created successfully at: E:/a327ex/attack-template/airborne.lua (file state is current in your context — no need to Read it back)

File created successfully at: E:/a327ex/attack-template/prop.lua (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

Explosion Flesh 1.ogg
Explosion Flesh 3.ogg
Explosion Flesh 4.ogg
Spell_Earth_02.ogg
Spell_Earth_04.ogg

syntax OK

97:5. **`anchor/collider.lua`** — has the steering toolkit (`steering_seek`,
149:### Carriers
178:- **`flicker.lua`** — flicker-strike carrier (v1 `flicker_strike`,
187:### Sounds
212:### Physics
214:physics_register_tag('player' | 'wall' | 'enemy' | 'projectile')
308:### Keybindings (current)
422:5. **Element-flavored variants** (wind / fire / earth / etc.) are
428:6. **Wall avoidance steering exists in `collider.lua` but is unused.**
465:4. ✅ **`flicker.lua`** — DONE (session 3). v1 `flicker_strike` port:
469:5. **`polygonal.lua`** — `big_rock_effect` + `rock_fragment` shatter:
473:6. **`railgun.lua`, `psylance.lua`, `construct.lua`** — bespoke
520:├── flicker.lua                 # carrier — flicker-strike bezier-hop chain (session 3)
521:├── sound_tuning.lua            # per-sound DSP tuning table (path → {bits, sr_div})

178  - **`flicker.lua`** — flicker-strike carrier (v1 `flicker_strike`,
179   line 4450). An autonomous moving entity: finds the enemy nearest the
180   click position, bezier-hops between enemies leaving a fading dashed
181   trail, strikes each with the full v1 hit FX (fx_energy_122 burst,
182   hit_circle, 4 zag particles, slash sounds, shake, body flash/spring),
183   and ends on a final burst (hit_stop, slash_final, AoE knockback, big
184   FX). `hits` opt = number of enemies struck. Player is uninvolved —
185   caster supplies only spawn pos + click target + edition.
186 
187 ### Sounds
188 Loaded as originals (NOT `_lightmed`). Runtime DSP via `sound_tuner`
189 applies bitcrush + SR-reduction per sound (see Runtime DSP section
190 below). Volumes match Invoker's normalized values.
191 ```lua
192 sounds.player_hit          = 'Body Fall 2.ogg'
193 sounds.enemy_hit           = 'Body Head (Headshot) 1.ogg'
194 sounds.enemy_die_variants  = {Bloody punches 3/7/10.ogg}
195 sounds.arrow_hit_wood      = 'ARROW_Hit_Wood_Shield_stereo.ogg'  -- projectile fire
196 sounds.arrow_shoot         = 'RPG3_GenericArrow_Shoot01.ogg'      -- projectile fire
197 sounds.dot_tick            = 'Click sound 37 + Body Fall 18.ogg'  -- persistent-area tick
198 sounds.slash_hit           = 'PM_GENERIC_Slash02.ogg'             -- flicker per-hit
199 sounds.slash_final         = 'PM_GENERIC_Slash04_P2.ogg'          -- flicker final hit
200 sounds.sword_slash_variants= {Sword_Slash_1_v1..v4.ogg}           -- flicker per-hit (random)
201 ```
202 The arrow stack is the standard "physical projectile shot" — v1
203 layers these two on every arrow-type ability; default audio for
204 `spawn_projectile`'s `fire_sounds` opt. Each carrier brings its own
205 sounds as it's ported (per-carrier, originals not `_lightmed`). The
206 beam carries no sound — v1's beam_cast was ported then removed at the
207 user's request; persistent/instant beams are silent.
... [22 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

240  physics_enable_collision(debris↔debris, debris↔wall)   -- shatter shards
241 physics_enable_sensor(projectile↔enemy)   -- sensor mask is SEPARATE from collision mask
242 ```
243 - Player has a rotatable box collider (set_fixed_rotation(false) +
244   `set_angle(self.r)` each frame to lock to mouse-aim only — juice
245   rotation `visual_r` stays draw-only).
246 - Seeker has a rotatable box collider (same pattern, locked to its
247   velocity-derived `self.r`).
248 - Wall has a static chain collider (closed polygon outline).
249 - Projectile has a sensor box collider (passes through everything
250   visually; events fire via `sensor_entities_begin('projectile','enemy')`).
251   Walls are caught by the projectile's per-frame forward raycast.
252 - Areas / beams / flickers are NOT physics objects — they query
253   existing colliders by tag at damage time (circle / box / polygon
254   queries; beams also raycast walls per path segment).
255 - `set_angular_velocity(0)` is paired with each `set_angle` to cancel
256   contact-imparted spin — without it, dynamic bodies drift between
257   physics steps.
258 
259 ### Hit-stop / time scale

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

336    S (save). Auto-replays the selected sound every 0.5s for live
337   feedback. Press F3 to enter/exit; game pauses while tuning.
338 
339 Replaces the v1 `_lightmed` baked-asset pipeline. Originals load
340 clean; tuning dials in lo-fi character per sound. New projects copy
341 this same flow (sound_tuning.lua + sound_tuner.lua + the sfx wrapper).
342 
343 ### Keybindings (current)
344 | Key | Action |
345 |-----|--------|
346 | W / A / S / D / arrows | Move player |
347 | Mouse position | Player aim direction |
348 | Mouse 1 (left) | Fire projectile at cursor |
349 | Mouse 2 (right) | Fire area at cursor (shape × jagged × brackets × persistent) |
350 | Mouse 3 (middle) | Fire beam — instant click, or hold to channel (persistent mode) |
351 | F | Fire flicker toward the cursor |
352 | 0 / F1 | Cycle player edition forward / backward |
353 | 9 / 8 | Cycle wall edition forward / backward |
354 | T | Cycle area shape (circle → rect → polygon) |
355 | G | Toggle area `jagged` flag |
356 | B | Toggle area `corner_brackets` flag |
357 | N | Toggle area instant ↔ persistent (DoT) |
358 | O | Toggle beam instant ↔ persistent (channeled) |
359 | J | Toggle beam homing on / off |
360 | 1 / 2 | Beam homing turn-rate down / up |
361 | 3 / 4 | Beam homing proximity down / up |

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

497     path, homing (`build_homing_path`), per-segment wall clip, AABB +
498    perp damage, railgun_flash retract (instant) / per-tick flash lines
499    (persistent). Deferred: returning-arc path, chain extension, sweep,
500    parallel, leading-edge white-flash dash style.
501 4. ✅ **`flicker.lua`** — DONE (session 3). v1 `flicker_strike` port:
502    bezier-hop chain, fading trail, full hit FX + sounds, final burst
503    (hit_stop, AoE knockback). Deferred: the other `dash_clone` modes
504    (`dash_strike`, `asal`) — separate carriers if ever wanted.
505 5. **`polygonal.lua`** — `big_rock_effect` + `rock_fragment` shatter:
506    parabolic-flight rock-throw that shatters into Box2D fragments on
507    landing. NEXT — also wants a generalizable "airborne" system (the
508    parabola/arc-flight abstraction). See `findings.md` section 6.
509 6. **`railgun.lua`, `psylance.lua`, `construct.lua`** — bespoke
510    single-purpose carriers. Last because they're less foundational.
511 
512 For each carrier, the workflow is roughly:
513 1. Read the corresponding `findings.md` section.
514 2. Read the original v1 source (line refs in findings.md).
515 3. AskUserQuestion for scope (minimal first cut vs wider first pass;
516    demo trigger key; sound bundling) before writing — mirrors how
517    projectile and area were scoped in sessions 1-2.
518 4. Write the carrier class in attack-template, adapting `object:extend()`
519    / `self:add(collider)` / `self:action(draw)` v1 patterns to Anchor 2's
520    `class()` / plain-field / explicit-method style.
521 5. Drop sound assets (originals, not `_lightmed`) into `assets/`,
522    register them in `main.lua`'s `sounds`/`volumes` tables. Tune via
523    F3 after launch.
524 6. Wire a debug spawn key + (if needed) cycle key into `main.lua`.
525 
526 ---
... [36 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

555  ├── stats.lua                   # procedural stats / buff machinery
556 ├── projectile.lua              # carrier — straight-line sensor projectile (session 2)
557 ├── area.lua                    # carrier — area-of-effect, instant + persistent/DoT (sessions 2-3)
558 ├── beam.lua                    # carrier — line, instant + persistent, homing (session 3)
559 ├── flicker.lua                 # carrier — flicker-strike bezier-hop chain (session 3)
560 ├── sound_tuning.lua            # per-sound DSP tuning table (path → {bits, sr_div})
561 ├── sound_tuner.lua             # F3 tuning UI module (session 2)
562 ├── edition.lua                 # from edition-template
563 ├── palette.lua                 # from edition-template
564 ├── gradient.lua                # from edition-template
565 ├── geometry.lua                # from edition-template
566 ├── symbols.lua                 # from edition-template
567 ├── assets/
568 │   ├── draw_shader.frag        # from edition-template (single unified shader)
569 │   ├── monogram.ttf            # tuning UI font (session 2)
570 │   ├── hit1.png                # fx_hit_effect spritesheet (5×96×48)
571 │   ├── fx_energy_122.png       # fx_effect spritesheet (7×96×96) — flicker hit burst (session 3)
572 │   ├── Body Fall 2.ogg                       # player_hit
573 │   ├── Body Head (Headshot) 1.ogg            # enemy_hit
574 │   ├── Bloody punches 3/7/10.ogg             # enemy_die_variants
575 │   ├── ARROW_Hit_Wood_Shield_stereo.ogg      # arrow_hit_wood — projectile fire (session 2)
576 │   ├── RPG3_GenericArrow_Shoot01.ogg         # arrow_shoot    — projectile fire (session 2)
577 │   ├── Click sound 37 + Body Fall 18.ogg     # dot_tick       — persistent-area tick (session 3)
578 │   ├── PM_GENERIC_Slash02.ogg                # slash_hit      — flicker per-hit (session 3)
579 │   ├── PM_GENERIC_Slash04_P2.ogg             # slash_final    — flicker final hit (session 3)
580 │   └── Sword_Slash_1_v1..v4.ogg              # sword_slash    — flicker per-hit random (session 3)
581 ├── anchor/                     # Anchor 2 framework copy
582 │   ├── collider.lua            # has +steering_wall_avoidance vs upstream
583 │   └── physics.lua             # has +query_entities_polygon vs upstream (session 2)
584 ├── anchor.exe                  # built from Anchor2/engine/src/anchor.c — includes
... [5 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

150    self.hit_cooldowns = {}                      -- entity_id → cooldown expire time
151 
152   self.visual_radius = 0
153   self.fill_color = color_clone(self.color)
154   self.fill_color.a = 20
155   self.flashing = false
156   self.hidden   = false
157   self.arc_r    = 0
158   if self.duration then
159     -- Persistent: slow constant base, bumped by tick spikes (v1 line 8530).
160     -- We add an exponential decay back toward this baseline in :update so
161     -- the arc speed doesn't stay at peak forever after a few hits.
162     self.arc_sign     = random_choice({-1, 1})
163     self.arc_baseline = self.arc_sign*random_float(0.5, 1)*math.pi

358  function area:destroy() end
359 
360 
361 function area:draw(layer)
362   if self.hidden then return end
363   set_edition(layer, self.edition)
364 
365   local s = self.spring.main.x
366   -- Persistent non-smooth-circle shapes breathe their scale gently. Smooth
367   -- circle's life is the orbiting arcs, so it skips breathing.

The file E:/a327ex/attack-template/area.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/area.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/prop.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/prop.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

syntax OK

User has answered your questions: "Does the anchor/ engine framework directory move into snkrx/ too, or stay at the project root?"="Keep anchor/ at root (Recommended)", "The default main.lua currently carries demo tuning scaffolding (area-shape cycle T/G/B/N, beam-homing tuning keys 1-6 + HUD, F2 collider overlay, F3 sound tuner). How much should the clean default main.lua keep?"="Preserve the old file as main_old.lua, write a new one that is a clean scene. The clean scene file should have documentation/comments on how to use the various calls, but not actually use them, except for a moving player. F2/F3 should also remain. The current settings for all sounds should also remain.", "player.lua / seeker.lua / wall.lua are the test entities the carriers fire at/against. Where do they belong?"="Keep those in snkrx/ and instruct instances to either edit them directly and treat them as the actual files for those features, or create new ones at the same level as main.lua instead of using the ones in snkrx/", "main.lua's update/draw must iterate all 6 carrier lists (update+prune, draw). How explicit should that be?"="Fully explicit per-list loops". You can now continue with the user's answers in mind.

attack-template\anchor\spritesheet.lua:5:    spritesheets.hit = spritesheet_register('hit', 'assets/hit1.png', 96, 48)
attack-template\anchor\image.lua:5:    images.player = image_load('player', 'assets/player.png')
attack-template\edition.lua:6:    shader (assets/draw_shader.frag). When u_edition is non-zero, every
attack-template\edition.lua:150:  uniform writes. Call ONCE at boot, after require('anchor')({...}).
attack-template\edition.lua:153:                     (default 'assets/draw_shader.frag').
attack-template\edition.lua:161:  local path = opts.draw_shader or 'assets/draw_shader.frag'
attack-template\edition.lua:219:-- EDITION NAMING + CYCLE — keep these in sync with assets/draw_shader.frag.
attack-template\edition.lua:417:-- the apply_dither() switch in assets/draw_shader.frag. Keep in lockstep.
attack-template\anchor\layer.lua:28:  After require('anchor.layer'), direct engine-style calls like
attack-template\anchor\font.lua:5:    fonts.main = font_register('main', 'assets/monogram.ttf', 11)
attack-template\anchor\init.lua:10:    require('anchor')({
attack-template\anchor\init.lua:57:require('anchor.class')
attack-template\anchor\init.lua:58:require('anchor.math')
attack-template\anchor\init.lua:59:require('anchor.array')
attack-template\anchor\init.lua:60:require('anchor.color')
attack-template\anchor\init.lua:61:require('anchor.object')
attack-template\anchor\init.lua:62:require('anchor.helpers')
attack-template\anchor\init.lua:63:require('anchor.input')
attack-template\anchor\init.lua:64:require('anchor.timer')
attack-template\anchor\init.lua:65:require('anchor.spring')
attack-template\anchor\init.lua:66:require('anchor.animation')
attack-template\anchor\init.lua:67:require('anchor.font')
attack-template\anchor\init.lua:68:require('anchor.image')
attack-template\anchor\init.lua:69:require('anchor.spritesheet')
attack-template\anchor\init.lua:70:require('anchor.layer')
attack-template\anchor\init.lua:71:require('anchor.shake')
attack-template\anchor\init.lua:72:require('anchor.camera')
attack-template\anchor\init.lua:73:require('anchor.collider')
attack-template\anchor\init.lua:74:require('anchor.physics')
attack-template\anchor\init.lua:75:require('anchor.memory')
... [61 more lines]

2:  sound_tuner.lua — F3 tuning overlay for per-sound DSP values.
16:    sound_tuning   (data table from sound_tuning.lua)
17:    sound_list, sound_play_handle, sound_handle_set_dsp, file_write_string
26:    s        save sound_tuning.lua
60:  for path, e in pairs(sound_tuning) do
65:    local e = sound_tuning[path]
99:  local entry = sound_tuning[cur.path]
112:      sound_tuning[cur.path] = entry
129:    local ok = file_write_string('sound_tuning.lua', serialize())
130:    print(ok and 'saved sound_tuning.lua' or 'FAILED to save sound_tuning.lua')
141:    local entry = sound_tuning[cur.path]
159:    layer_text(tune_layer, 's: save sound_tuning.lua',     fonts.tune, x, y, text())

--- root ---
anchor/
anchor.exe*
main_old.lua
run.bat
snkrx/
--- snkrx ---
airborne.lua
area.lua
assets/
beam.lua
edition.lua
findings.md
flicker.lua
fx.lua
geometry.lua
gradient.lua
palette.lua
player.lua
projectile.lua
prop.lua
seeker.lua
sound_tuner.lua
sound_tuning.lua
stats.lua
symbols.lua
wall.lua

38   
39  if not fonts then fonts = {} end
40  fonts.tune = font_register('monogram', 'assets/monogram.ttf', 12)
41  

127  
128   if is_pressed('tune_save') then
129     local ok = file_write_string('sound_tuning.lua', serialize())
130     print(ok and 'saved sound_tuning.lua' or 'FAILED to save sound_tuning.lua')
131   end

The file E:/a327ex/attack-template/snkrx/sound_tuner.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/snkrx/sound_tuner.lua has been updated successfully. (file state is current in your context — no need to Read it back)

<tool_use_error>File has not been read yet. Read it first before writing to it.</tool_use_error>

1    --[[
2     Per-sound DSP tuning. Auto-generated by F3 tuning UI; safe to edit by hand.
3     Keys are file paths; entries are {bits, sr_div}. Default bits=16, sr_div=1.
4   ]]
5   return {
6     ["assets/ARROW_Hit_Wood_Shield_stereo.ogg"] = {bits = 8, sr_div = 4},
7     ["assets/Bloody punches 10.ogg"] = {bits = 8, sr_div = 3},
8     ["assets/Bloody punches 3.ogg"] = {bits = 8, sr_div = 3},
9     ["assets/Bloody punches 7.ogg"] = {bits = 8, sr_div = 3},
10    ["assets/Body Fall 2.ogg"] = {bits = 8, sr_div = 4},
11    ["assets/Body Head (Headshot) 1.ogg"] = {bits = 6, sr_div = 4},
12    ["assets/Click sound 37 + Body Fall 18.ogg"] = {bits = 8, sr_div = 3},
13    ["assets/Explosion Flesh 1.ogg"] = {bits = 8, sr_div = 4},
14    ["assets/Explosion Flesh 3.ogg"] = {bits = 8, sr_div = 4},
15    ["assets/Explosion Flesh 4.ogg"] = {bits = 8, sr_div = 4},
16    ["assets/PM_GENERIC_Slash02.ogg"] = {bits = 8, sr_div = 3},
17    ["assets/PM_GENERIC_Slash04_P2.ogg"] = {bits = 8, sr_div = 3},
18    ["assets/RPG3_GenericArrow_Shoot01.ogg"] = {bits = 8, sr_div = 3},
19    ["assets/Spell_Earth_02.ogg"] = {bits = 6, sr_div = 3},
20    ["assets/Spell_Earth_04.ogg"] = {bits = 6, sr_div = 2},
21    ["assets/Sword_Slash_1_v1.ogg"] = {bits = 8, sr_div = 2},
22    ["assets/Sword_Slash_1_v2.ogg"] = {bits = 7, sr_div = 2},
23    ["assets/Sword_Slash_1_v3.ogg"] = {bits = 6, sr_div = 3},
24    ["assets/Sword_Slash_1_v4.ogg"] = {bits = 8, sr_div = 3},
25  }
26  

158  ]]
159 function edition_setup(opts)
160   opts = opts or {}
161   local path = opts.draw_shader or 'assets/draw_shader.frag'
162   set_draw_shader(path)
163   edition_draw_shader = get_draw_shader()

The file E:/a327ex/attack-template/snkrx/sound_tuning.lua has been updated. All occurrences were successfully replaced. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/snkrx/edition.lua has been updated successfully. (file state is current in your context — no need to Read it back)

File created successfully at: E:/a327ex/attack-template/snkrx/init.lua (file state is current in your context — no need to Read it back)

File created successfully at: E:/a327ex/attack-template/main.lua (file state is current in your context — no need to Read it back)

ok: main.lua
ok: snkrx/init.lua
ok: snkrx/sound_tuner.lua
ok: snkrx/sound_tuning.lua
ok: snkrx/edition.lua
ok: snkrx/prop.lua
ok: snkrx/area.lua
ok: snkrx/airborne.lua

56   line-editing.
57  
58  ---
59  
60  ## What this is
61  
62  A starter Anchor 2 project for building **attacks** (projectiles, areas,
63  beams, polygonal projectiles, movement abilities, etc.) in the SNKRX /
64  Orblike / Invoker visual style. This is a sibling of `edition-template/`
65  — it bundles the same edition + gradient + palette + draw-shader stack,
66  plus the entities needed to test attacks against (player, seeker enemies,
67  wall obstacles), all glued together as a single self-contained directory
68  that a new project can fork.
69  
70  The eventual goal is the same shape as edition-template: copy this
71  directory, write `main.lua`, and start prototyping. By the end of the
72  work it should ship every attack carrier from Orblike v1 as a focused
73  reusable module (projectile, area, beam, dash, polygonal, railgun,
74  psylance, construct, etc.), each with the SNKRX-style juice (springs,
75  hit flashes, edition-tinted particles) and shape-correct hitboxes.
76  
77  **Read [findings.md](../findings.md) first.** It catalogs every attack
78  behavior in Orblike v1 with file/line references and is the canonical
79  inventory of what we plan to port.
80  
81  ---
82  
83  ## Read order
84  
85  1. **[findings.md](../findings.md)** — the v1 attack inventory: every
... [60 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

288  - Projectile has a sensor box collider (passes through everything
289   visually; events fire via `sensor_entities_begin('projectile','enemy')`).
290   Walls are caught by the projectile's per-frame forward raycast.
291 - Areas / beams / flickers / props are NOT physics objects — they
292   query existing colliders by tag at damage time (circle / box /
293   polygon queries; beams also raycast walls per path segment). The
294   thrown rock prop has no collider; only the `debris` shards do.
295 - Debris has a dynamic polygon collider (one per shatter shard;
296   bounces off other debris + walls, passes through entities).
297 - `set_angular_velocity(0)` is paired with each `set_angle` to cancel
298   contact-imparted spin — without it, dynamic bodies drift between
299   physics steps.
300 - **Airborne collision rule:** an entity carrying a live
301   `self.airborne` is "in the air." Every collision handler in main.lua

309  `hit_stop(duration)` (in `main.lua`) zeroes the engine time scale for
310 `duration` seconds. The countdown in `update()` runs on **unscaled**
311 dt; every game entity is updated with **scaled** dt (`sdt = dt *
312 time_scale`), so a time_scale of 0 freezes the world while input + the
313 sound tuner keep running. The flicker's final burst calls it (0.08s).
314 Any carrier can use it.
315 
316 ### Collisions handled (in main.lua's `update`)
317 - **Player ↔ enemy contact**: push the seeker away (force 6, default
318   0.5s), forward `pl:hit(damage, x, y, enemy)` so the player flashes,
319   HP drops, and the contact-point spawns edition-mixed particles.
320 - **Enemy ↔ wall contact**: `e:wall_bump(r)` — see below.
321 - **Projectile ↔ enemy sensor**: forward `pr:on_hit(e)` so the
322   projectile damages the enemy + spawns hit FX + dies. Uses
323   `sensor_entities_begin` (NOT `collision_entities_begin`) because
324   projectile fixtures are sensors.
325 
326 ### `seeker:wall_bump` — streak-based wall response
327 Each contact within `WALL_BUMP_WINDOW` (0.5s) of the previous one
328 increments `self.wall_hit_count`; both push force and duration scale

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

344    `set_edition` for its own silhouette; particle bursts use
345   `edition_base_color(edition) or fallback_color` for tinting.
346 - **Particles inherit editions**:
347   - **Seeker spawn / die particles** target `edition_base_color(self.edition) or red` — a ruby seeker spawns + dies in red-ish particles, an emerald one in green-ish.
348   - **Player-hit particles** (`player:hit` with a `source` argument) target `color_mix(edition_base_color(player.edition), edition_base_color(source.edition), 0.5)` — a warm/cool mix. Edition `nil`/`0`/`23`/`24` fall back gracefully via `or text` chain.
349   - **White-flash fractions**: death particles flash at `0.6` of duration (long, dramatic), hit particles at `0.3` (briefer but visible). Clear "small hit vs. fatal hit" hierarchy.
350 
351 ### Debug
352 - **F2** toggles a collider debug overlay. Iterates `p` / `seekers[]` /
353   `walls[]` / `projectiles[]`, calls `collider:get_shapes_geometry()`,
354   draws each shape outline on a dedicated `debug_layer` (no edition
355   shader). Solid shapes in lime; sensor shapes (projectiles) in yellow.
356 - **F3** enters the per-sound DSP tuning overlay (see Runtime DSP below).
357 - **H** deals 2 damage to a random live seeker (reveals HP bar +
358   triggers white-flash + `enemy_hit` sfx).
359 - **K** kills a random live seeker (full death FX + variant
360   death sound).
361 
362 ### Runtime DSP + sound tuning
363 The engine (`Anchor2/engine/src/anchor.c`) has a per-voice DSP wrapper
364 that applies bitcrush + sample-rate reduction inline. Two engine
365 globals matter: `sound_handle_set_dsp(handle, bits, sr_div)` retunes
366 a playing voice live; `sound_get_path(sound)` returns the asset path
367 used as the tuning key.
368 
369 - **`sound_tuning.lua`** is the project-owned table mapping file
370   paths to `{bits, sr_div}`. Sounds without an entry play clean
371   (bits=16, sr_div=1).
372 - **`sfx()` in main.lua** consults the table on every play.
373 - **`sound_tuner.lua`** is a self-contained F3 overlay module: T
... [2 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

376  - **`sound_tuner.lua`** is a self-contained F3 overlay module: T
377   conceptually unrelated (used for area shape cycle), the tuner uses
378   Up/Down (switch sound), [/] (bits), -/= (sr_div), Space (replay),
379   S (save). Auto-replays the selected sound every 0.5s for live
380   feedback. Press F3 to enter/exit; game pauses while tuning.
381 
382 Replaces the v1 `_lightmed` baked-asset pipeline. Originals load
383 clean; tuning dials in lo-fi character per sound. New projects copy
384 this same flow (sound_tuning.lua + sound_tuner.lua + the sfx wrapper).
385 
386 ### Keybindings (current)
387 | Key | Action |
388 |-----|--------|
389 | W / A / S / D / arrows | Move player |
390 | Mouse position | Player aim direction |
391 | Mouse 1 (left) | Fire projectile at cursor |
392 | Mouse 2 (right) | Fire area at cursor (shape × jagged × brackets × persistent) |
393 | Mouse 3 (middle) | Fire beam — instant click, or hold to channel (persistent mode) |
394 | F | Fire flicker toward the cursor |
395 | R | Throw a polygonal rock at the cursor (parabola → shatter) |
396 | 0 / F1 | Cycle player edition forward / backward |
397 | 9 / 8 | Cycle wall edition forward / backward |
398 | T | Cycle area shape (circle → rect → polygon) |
399 | G | Toggle area `jagged` flag |
400 | B | Toggle area `corner_brackets` flag |
401 | N | Toggle area instant ↔ persistent (DoT) |
402 | O | Toggle beam instant ↔ persistent (channeled) |
403 | J | Toggle beam homing on / off |
404 | 1 / 2 | Beam homing turn-rate down / up |
405 | 3 / 4 | Beam homing proximity down / up |
... [18 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

395  `main_old.lua` keeps the full pre-refactor demo keymap (mouse 1/2/3 +
396 F + R for the five carriers, plus the area-shape / beam-homing tuning
397 keys and H/K debug-damage) — frozen reference, not runnable as-is.
398 
399 ---
400 
401 ## Critical conventions (read these or it'll bite you)
402 
403 ### Edition shader integration
404 Every entity that draws has a `.edition` field and brackets its draws
405 with `set_edition(layer, self.edition)` / `set_edition(layer, 0)`. The
406 shim in main.lua forwards to `edition_set(layer, mode, default_field_scale, default_dither)`.
407 
408 **Particles / FX get edition through their BASE COLOR, not through the shader bracket** — they're drawn as part of the `fxs` loop without per-entity edition state. To make a particle reflect an entity's edition, use `edition_base_color(ed) or fallback_color` as the late-stage color in `:change_color`.
409 
410 ### Camera mouse coords
411 `main_camera.mouse.x, .y` are **only refreshed by `camera_update(c, dt)`**. You must call `camera_update(main_camera, dt)` in your update loop before any code reads those fields — the player's mouse-aim depends on it. We had a bug here.
412 
413 ### Rotatable collider bodies
414 `fixed_rotation = false` lets the collider geometry rotate with the entity's `self.r`, but you MUST call BOTH:
415 ```lua
416 self.collider:set_angle(self.r)
417 self.collider:set_angular_velocity(0)
418 ```
419 each frame. The zero-out cancels contact-imparted spin that Box2D otherwise preserves between physics steps. Skip it and you get jitter at high contact density.
420 
421 ### Player rotation: r vs visual_r
422 - `self.r` — the "physical" facing, locked to mouse-aim. Used for the collider angle.
423 - `self.visual_r` — juice rotation from left/right key presses. **Draw-only**, never feeds into physics. Draw uses `self.r + self.visual_r`.
424 
... [32 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

456  - Cross-entity references use IDs (`self.target_id = other.id` → `entities[self.target_id]`), not direct pointers.
457 - `entity:kill()` queues, `process_destroy_queue()` finalizes at frame end.
458 
459 ---
460 
461 ## Foundational design decisions
462 
463 These resolve the "open questions" from `findings.md` section 13.
464 **Read these before adding new code.**
465 
466 1. **Visual generalization only — NO modifier system.** Carriers should
467    NOT have a `mods` system, no `pierce+1` modifier vocabulary, no
468    `homing` / `cascade` / `area+` knobs threading through every carrier.
469    That's a gameplay system for the host game to add on top. The
470    template's job is to ship the *visuals* of each carrier (movement,
471    shape, hit/wall/death effects, edition tinting, sound) generically.
472 
473 2. **Light logic generalization is OK** — projectiles all share
474    movement + collider + max-range + wall-raycast; areas all share
475    tween + damage pass + blink-out; beams all share path-walk + dashed
476    draw + tip circle. Port that boilerplate into each carrier class
477    with all knobs as plain fields on `self` the host can override. No
478    event bus, no plugin system. Just procedural classes with overridable
479    methods.
480 
481 3. **Sounds added per-carrier as we port.** v1's full bank is ~30 MB.
482    Each new carrier brings its own sound asset(s) into `assets/` and
483    adds `sounds.X` + `volumes.X` entries. Load **originals**, not
484    `_lightmed` — runtime DSP via `sound_tuner` (F3) applies bitcrush
485    + SR-reduce per sound, configured in `sound_tuning.lua`.
... [80 more lines]

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

525     breathing.
526 3. ✅ **`beam.lua`** — instant + persistent. Polyline path, homing
527    (`build_homing_path`), per-segment wall clip, AABB + perp damage,
528    railgun_flash retract / per-tick flash lines.
529 4. ✅ **`flicker.lua`** — v1 `flicker_strike`: bezier-hop chain, fading
530    trail, full hit FX + sounds, final burst (hit_stop, AoE knockback).
531 5. ✅ **`prop.lua`** — v1 `big_rock_effect`. A breakable `prop` (static
532    or thrown) + `debris` shards; the rock-attack damage is layered on
533    as separate `polygonal_*` functions. The arc is the shared
534    `airborne.lua` component (z + draw scale only).
535 
536 Deferred / per-game: a static `prop` instance (vase/box) — the generic
537 shatter + `debris` pieces are ready for it; airborne behaviors beyond
538 throw-up-and-down; element-flavored carrier variants (decision 5 below).
539 
540 ---
541 
542 ## Common gotchas
543 
544 - **`triangulate` returns 6-number arrays in attack-template** (`{t1[1..6], t2[1..6], ...}`), NOT the v1 index-triple format (`{tri[1], tri[2], tri[3]}`). Adjust draw loops when porting v1 entity code that uses the v1 format.
545 - **`physics_raycast(x1, y1, x2, y2, tags)`** takes a tags TABLE (list of tag strings). Single-element list is `{'wall'}`, not `'wall'`.
546 - **`set_edition(layer, 0)` after every bracketed draw** — the shader uniform persists across subsequent draws on the same layer if you don't reset it.
547 - **Sensor fixtures need `physics_enable_sensor`, not `physics_enable_collision`.** The engine has separate masks for blocking collisions vs sensor events. Projectile (sensor) ↔ enemy uses the sensor enable; player/seeker (solid) ↔ wall uses collision enable. Cost us a debug cycle when projectiles wouldn't fire enemy events.
548 - **Mouse buttons follow LÖVE2D convention** — `mouse:2` = right, `mouse:3` = middle. The engine swaps SDL's native 2↔3 at the event boundary (`sdl_to_anchor_mouse_button` in anchor.c). All downstream code sees the Anchor convention. No mental remap needed.
549 - **`engine_get_typed_text()` must be drained** each frame even if nothing consumes typed input — otherwise SDL's text-input queue fills up after ~32 keypresses and warns per-press forever. main.lua calls it at the top of `update()`.
550 - **Sounds load as originals** (NOT `_lightmed`). Bitcrush + SR-reduce applied at runtime via `sound_tuner` (F3) per the `sound_tuning.lua` table.
551 - **Don't run `./run.bat` yourself** — the user runs and tests. After framework changes, `lua54.exe -e "loadfile('main.lua')"` is the syntax-check (path: `E:/a327ex/Anchor/reference/love-compare/tools/lua54.exe`).
552 
553 ---
554 
... [45 more lines]

599  │   └── physics.lua             # has +query_entities_polygon vs upstream (session 2)
600 ├── anchor.exe                  # built from Anchor2/engine/src/anchor.c — includes
601 │                               # DSP wrapper + mouse-button swap (session 2)
602 ├── run.bat
603 └── .claude/CLAUDE.md
604 ```
605 
606 ---
607 
608 ## Working style
609 
610 Same conventions as Anchor 2 / edition-template / Invoker:
611 
612 - **⛔ DESIGN BRIEF before code.** See the workflow rule at the top of
613   this file. No `Write` / `Edit` on project code without first posting
614   a conceptual design brief (approach + interfaces + per-function
615   notes), iterating it with the user, and reaching a conclusion.
616   Trivial changes skip the brief.
617 - **One change at a time.** The user tests between each step.
618 - **Don't run `./run.bat`** — user runs.

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

119  ### Building and Running
120 
121 **Game projects (emoji-ball-battles, Invoker, etc.):** Don't build or run after making code changes — the user will compile and test themselves.
122 
123 **Engine/framework (Anchor2/):** Build after making code changes to verify compilation. **Never run the executable** — the user will run and test themselves. Don't execute `run-web.bat`, `run.bat`, or similar. (`Anchor/` is the v1 directory, kept for historical reference — active development is on Anchor 2 in `Anchor2/`.)
124 
125 ---
126 
127 ## Projects
128 
129 - **Anchor2/** — C/Lua game engine (active; Anchor 2 framework rewrite). `Anchor/` is the v1 predecessor, kept for historical reference. The plan is to eventually move `Anchor2/` contents into `Anchor/`.
130 - **emoji-ball-battles/** — Game built with Anchor (still on v1 framework).
131 - **Invoker/** — Chord-cast spell roguelike (Invoker/Magicka-inspired) with a Minesweeper meta-dungeon, SNKRX visual style. Built on Anchor 2. Working name — was "Orblike" before the redesign.
132 - **anchor.blot.im/** — Blog/documentation site
133 
134 ---

The file E:/a327ex/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

all 19 snkrx files + main.lua: syntax OK

--- root ---
anchor/
anchor.exe*
assets/
main.lua
main_old.lua
run.bat
snkrx/
--- assets ---
ARROW_Hit_Wood_Shield_stereo.ogg
Bloody punches 10.ogg
Bloody punches 3.ogg
Bloody punches 7.ogg
Body Fall 2.ogg

The file E:/a327ex/attack-template/snkrx/init.lua has been updated. All occurrences were successfully replaced. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/snkrx/sound_tuning.lua has been updated. All occurrences were successfully replaced. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/snkrx/sound_tuner.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/snkrx/edition.lua has been updated successfully. (file state is current in your context — no need to Read it back)

108:   `assets/draw_shader.frag`) — same files as edition-template.
146:- `snkrx/assets/draw_shader.frag` replaces the engine's default

104     `_wander`, `_separate`, `_align`, `_cohesion`, `_pursuit`, `_evade`,
105    `_arrive`, `_follow_path`, `_flow_field`, `_wall_avoidance`).
106 7. Anything else under `snkrx/` (`edition.lua`, `palette.lua`,
107    `gradient.lua`, `geometry.lua`, `symbols.lua`,
108    `assets/draw_shader.frag`) — same files as edition-template.
109 

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/attack-template/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

exit:1

ok: snkrx/init.lua
ok: snkrx/sound_tuning.lua
ok: snkrx/sound_tuner.lua
ok: snkrx/edition.lua

Launching skill: end-session

2026-05-21T01:40:09.252Z cfd6fec4-b6d6-4322-8ce2-075547aa4a2c [claude] <-- MOST RECENT
   C:\Users\adn\.claude\projects\E--a327ex\cfd6fec4-b6d6-4322-8ce2-075547aa4a2c.jsonl

2026-05-21T00:16:34.726Z 1606f701-db00-4cd0-8ed2-21eb96355c4d [claude]
   C:\Users\adn\.claude\projects\E--a327ex\1606f701-db00-4cd0-8ed2-21eb96355c4d.jsonl

2026-05-20T20:39:50.264Z dd3ecde1-3cb1-4313-83d4-c4a70e472cbe [claude]
   C:\Users\adn\.claude\projects\E--a327ex\dd3ecde1-3cb1-4313-83d4-c4a70e472cbe.jsonl

2026-05-20T16:31:14.672Z 928a6664-ad51-4697-a25f-b60224a1210a [claude]
   C:\Users\adn\.claude\projects\E--a327ex\928a6664-ad51-4697-a25f-b60224a1210a.jsonl

2026-05-20T15:09:08.721Z 13e244ef-3ffd-4276-ad90-5f800435a664 [claude]
   C:\Users\adn\.claude\projects\E--a327ex\13e244ef-3ffd-4276-ad90-5f800435a664.jsonl

===DATE===
2026-05-20 22:40:46