Files
zelda-1-prometeu-port/tools/generate_combat_fixture.py

167 lines
11 KiB
Python

#!/usr/bin/env python3
"""Create isolated PBS checks from native 6502 cases; never install automatically."""
import json
from extract_graphics import ROOT
def generate():
out=ROOT/'.tmp/combat-fixture';out.mkdir(exist_ok=True,parents=True)
for name in ('link','enemy'):(out/f'{name}-fixture.pbs').write_text((ROOT/f'tools/fixtures/combat/{name}.pbs').read_text())
oracle=json.loads((ROOT/'extracted/combat/oracle-cases.json').read_text());calls=[];assertions=0
for flags,count,present,expected,newflags in oracle['history']:
if flags>=32:continue
calls.append(f' CombatFixture.history_case({flags},{count},{str(present).lower()},{expected},{newflags%8});');assertions+=3
for flags,spawned,killed,expected in oracle['saves']:
if flags>=32:continue
calls.append(f' CombatFixture.save_case({flags},{spawned},{killed},{expected%8});');assertions+=2
for cycle,r,kills,help_count,bomb,expected,newhelp,newbomb in oracle['drops']:
calls.append(f' CombatFixture.drop_case({cycle},{r},{kills},{help_count},{bomb},{expected},{newhelp},{newbomb});');assertions+=3
source='''import { Loot } from @zelda1:loot;
import { WorldFlags } from @zelda1:world;
import { Inventory } from @zelda1:inventory;
import { Link, LinkCombatChecks } from @zelda1:link;
import { EnemyCombatChecks } from @zelda1:enemies/octorok;
import { Scene } from @zelda1:scene;
import { CombatGraphics } from @zelda1:combat_graphics;
import { Gfx } from @sdk:gfx;
import { Color } from @core:color;
declare global fixture_rules: DropRules = new DropRules(new DropData(),0,0,0,0,0);
declare global fixture_drop: DroppedItem = new DroppedItem(new FairyFlight(0,127,0,0,0,0),-1,0,0,0);
declare global checks: array<int> = new array<int>(8192);
declare global check_count: int = 0;
declare global failed: int = 0;
declare global view: int = 0;
declare global view_clock: int = 0;
declare global batch_index: int = 0;
declare service CombatFixture {
fn check(passed: bool) -> void { checks[check_count]=if passed { 1 } else { 0 }; check_count+=1; if !passed { failed+=1; } }
fn history_case(flags: int, count: int, present: bool, expected: int, low: int) -> void {
WorldFlags.reset();
if present { let entered=WorldFlags.enter_room(103,4); }
if flags>=16 { WorldFlags.mark_room_item_taken(103); }
WorldFlags.leave_room(103,99,flags%8);
let actual=WorldFlags.enter_room(103,count); CombatFixture.check(actual==expected);
let kills=WorldFlags.kill_count(103); CombatFixture.check(kills==low);
let taken=WorldFlags.room_item_taken(103); CombatFixture.check(taken==(flags>=16));
}
fn save_case(flags: int, spawned: int, killed: int, low: int) -> void {
WorldFlags.reset(); if flags>=16 { WorldFlags.mark_room_item_taken(103); }
WorldFlags.leave_room(103,99,flags%8); WorldFlags.leave_room(103,spawned,killed);
let kills=WorldFlags.kill_count(103); CombatFixture.check(kills==low);
let taken=WorldFlags.room_item_taken(103); CombatFixture.check(taken==(flags>=16));
}
fn drop_case(cycle: int, r: int, kills: int, help: int, bomb: int, expected: int, newhelp: int, newbomb: int) -> void {
fixture_rules.cycle=(cycle+9)%10; fixture_rules.unharmed=kills; fixture_rules.help=help; fixture_rules.help_bomb=bomb;
let value=fixture_rules.choose(7,r); CombatFixture.check(value==expected);
CombatFixture.check(fixture_rules.help==newhelp); CombatFixture.check(fixture_rules.help_bomb==newbomb);
}
fn run() -> void {
'''+ '\n'.join(calls)+'''
// Six unique rooms evict; revisiting an existing room does not refresh it.
WorldFlags.reset(); let entered=WorldFlags.enter_room(103,4); WorldFlags.leave_room(103,4,4);
for room: int from 104 until 109 { entered=WorldFlags.enter_room(room,0); }
entered=WorldFlags.enter_room(103,4); CombatFixture.check(entered==0);
entered=WorldFlags.enter_room(109,0); entered=WorldFlags.enter_room(103,4); CombatFixture.check(entered==4);
WorldFlags.leave_room(103,4,2);
for room: int from 110 until 116 { entered=WorldFlags.enter_room(room,0); }
entered=WorldFlags.enter_room(103,4); CombatFixture.check(entered==2);
WorldFlags.leave_room(103,2,2); WorldFlags.clear_history(); entered=WorldFlags.enter_room(103,4); CombatFixture.check(entered==4);
// Currency uses pending-add byte and advances one rupee every other tick.
Inventory.reset(); let taken=Inventory.take_drop(15); CombatFixture.check(taken);
let value=Inventory.read_slot(22); CombatFixture.check(value==0);
value=Inventory.read_slot(38); CombatFixture.check(value==5);
Inventory.tick_money(1); value=Inventory.read_slot(22); CombatFixture.check(value==0);
Inventory.tick_money(2); value=Inventory.read_slot(22); CombatFixture.check(value==1);
for tick: int from 0 until 260 { taken=Inventory.take_drop(24); Inventory.tick_money(2); }
value=Inventory.read_slot(22); CombatFixture.check(value==255);
taken=Inventory.take_drop(0); value=Inventory.read_slot(1); CombatFixture.check(value==4);
taken=Inventory.take_drop(0); taken=Inventory.take_drop(0); value=Inventory.read_slot(1); CombatFixture.check(value==8);
// Item lifetime, flashing grace period, contact offset and off-room cleanup.
Inventory.reset(); Loot.reset(); fixture_drop.appear(24,120,144);
let collected=fixture_drop.update(120,141,true,false,0); CombatFixture.check(!collected);
for tick: int from 0 until 29 { Loot.tick(); collected=fixture_drop.update(120,141,true,false,0); }
CombatFixture.check(!collected && fixture_drop.lifetime==240);
Loot.tick(); Loot.tick(); collected=fixture_drop.update(120,141,true,false,0);
CombatFixture.check(collected && fixture_drop.id<0);
value=Inventory.read_slot(38); CombatFixture.check(value==1);
fixture_drop.appear(34,120,144);
for tick: int from 0 until 510 { Loot.tick(); collected=fixture_drop.update(0,0,false,false,0); }
CombatFixture.check(fixture_drop.id<0);
// Damage resets guaranteed-help counters, not the 10-step cycle.
Inventory.reset(); Link.start_game(); Loot.reset();
for kill: int from 0 until 9 { Loot.monster_killed(1); let item=Loot.complete_kill(7,255); }
value=Loot.help_count(); CombatFixture.check(value==9);
let hurt=Link.hurt(128,120,125); CombatFixture.check(hurt);
value=Loot.help_count(); CombatFixture.check(value==0);
value=Loot.unharmed_kills(); CombatFixture.check(value==0);
value=Loot.cycle(); CombatFixture.check(value==9);
let link_failed=LinkCombatChecks.run(); CombatFixture.check(link_failed==0);
let enemy_failed=EnemyCombatChecks.run(); CombatFixture.check(enemy_failed==0);
Inventory.reset(); Loot.reset();
}
fn frame(select_pressed: bool) -> void {
if select_pressed { view=(view+1)%3; view_clock=0; }
view_clock+=1;
if view==0 {
Gfx.clear(Color.rgb(0,0,0));
for i: int from 0 until check_count {
let value=checks[i] else 0; let color=if value==1 { Color.rgb(0,255,0) } else { Color.rgb(255,0,0) };
Gfx.fill_rect((i%160)*3,(i/160)*3,2,2,color);
}
let red_channel: int=check_count/256; let green_channel: int=check_count%256;
Gfx.fill_rect(474,267,3,3,Color.rgb(red_channel as long,green_channel as long,0));
let verdict=if failed==0 { Color.rgb(0,255,0) } else { Color.rgb(255,0,0) };
Gfx.fill_rect(477,267,3,3,verdict); return;
}
if !Scene.bind_ui(13) { return; }
if view==1 {
CombatGraphics.drop(0,0,24,96); CombatGraphics.drop(15,0,64,96);
CombatGraphics.drop(24,0,104,96); CombatGraphics.drop(24,8,144,96);
CombatGraphics.drop(34,0,184,96); CombatGraphics.drop(34,8,24,144);
CombatGraphics.drop(35,0,64,144); CombatGraphics.drop(35,4,104,144);
CombatGraphics.counter(0,24,24); CombatGraphics.counter(9,64,24);
CombatGraphics.counter(23,104,24); CombatGraphics.counter(123,144,24); CombatGraphics.counter(255,184,24);
} else {
CombatGraphics.beam(8,0,24,96); CombatGraphics.beam(4,1,72,96);
CombatGraphics.beam(2,2,120,96); CombatGraphics.beam(1,3,168,96);
CombatGraphics.spread(80,160,6,0); CombatGraphics.spread(168,160,12,2);
EnemyCombatChecks.draw_bounces(view_clock);
}
Scene.draw_frame();
}
}
'''
# Spread the oracle cases over video frames so the test itself respects the
# headless watchdog; no production timing/budget changes are required.
import re
run_start=source.index(' fn run() -> void {')
frame_start=source.index(' fn frame(select_pressed: bool)')
run_body=source[run_start:frame_start]
tail_body=run_body[run_body.index(' // Six unique rooms'):].rsplit(' }',1)[0]
batches=['\n'.join(calls[i:i+10]) for i in range(0,len(calls),10)]
batches += [part for part in re.split(r'(?= //)',tail_body) if part.strip()]
methods=[' fn begin() -> void {}',' fn run() -> void {']
for i in range(len(batches)):methods.append(f' if batch_index=={i} {{ CombatFixture.batch_{i}(); batch_index+=1; return; }}')
methods.append(' }')
for i,batch in enumerate(batches):
if 'value=' in batch and 'let value=' not in batch:batch=' let value: int=0;\n'+batch
methods += [f' fn batch_{i}() -> void {{',batch,' }']
source=source[:run_start]+'\n'.join(methods)+'\n'+source[frame_start:]
source=source.replace(' if select_pressed { view=',f' if batch_index<{len(batches)} {{ CombatFixture.run(); }}\n if select_pressed && batch_index=={len(batches)} {{ view=')
source=source.replace('let verdict=if failed==0 { Color.rgb(0,255,0) } else { Color.rgb(255,0,0) };',f'let verdict=if batch_index<{len(batches)} {{ Color.rgb(0,0,255) }} else if failed==0 {{ Color.rgb(0,255,0) }} else {{ Color.rgb(255,0,0) }};')
(out/'loot-fixture.pbs').write_text(source)
(out/'main.pbs').write_text('''import { CombatFixture } from @zelda1:loot;
import { Pad, Button } from @sdk:input;
[Init]
fn init() -> void { CombatFixture.begin(); }
[Frame]
fn frame() -> void { CombatFixture.frame(Pad.pressed(Button.Select)); }
''')
# Record generated call count; extra checks in fixture plus two subsystem verdicts.
total=source.count('CombatFixture.check(')-9 # helper bodies contain 3+2+3 calls; declaration is not a call
# Oracle calls expand to multiple checks; explicit calls outside helpers are counted below.
tail=tail_body
total=assertions+tail.count('CombatFixture.check(')
(out/'metadata.json').write_text(json.dumps({'oracle_assertions':assertions,'top_level_assertions':total,'batches':len(batches)},indent=2)+'\n')
print('Generated combat fixture:',total,'top-level assertions; not installed')
if __name__=='__main__':generate()