#!/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 = new array(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()