Files

Axel Meyer ed3418781c docs: add API section documenting run_tests entrypoint

Test-lib README now declares its public surface (M.run_tests) so the
doc-convention lint passes structural validation. Brings parity with
maps-test which already has this section.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-16 18:01:46 +02:00

3.8 KiB

Raw Blame History

lib-core.command-test

Test-lib for lib-core.command (Tests-as-Libs per ADR-0037).

Version: 0.1.0
Lib-ID: lib-core.command-test
Requires: lib-core.command v>=0.1.0, lib-core.input v>=0.4.0, lib-core.camera v>=0.3.0
Tags: test, command

Topology

graph LR
  this["lib-core.command-test"]
  lib_core_command["lib-core.command"]
  this --> lib_core_command
  lib_core_input["lib-core.input"]
  this --> lib_core_input
  lib_core_camera["lib-core.camera"]
  this --> lib_core_camera

API

`run_tests(ctx)`

Syntax: M.run_tests(ctx) -> void

Description: Test-runner entrypoint. Executes 25 assertions against lib-core.command. Called automatically by the engine's --test-libs= orchestrator. Exits via engine.exit(engine.test.failures()).

Coverage Statement

Per Fault-Injection-Audit-Convention (2026-05-16):

Section	Assertion-Count	Coverage
Register / Unregister	3	`register` handle, `count_registered` after register/unregister
Move-Issue + State-Query	3	`move_to`, `current` returns move-data, `is_moving` true after issue, false for idle
State-Query (idle)	2	`current` returns nil for idle, `is_moving` false for unknown handle
Update-step	2	`update` moves 10px in 0.1s @ 100 px/s, y unchanged for horizontal move
Arrival-snap	2	Snap to target.x when step >= dist, `current` cleared after arrival
Cancel + cancel_all	5	`cancel(h2)` clears h2 only, `cancel_all` clears remaining; cancel_all clears 2-unit batch
Speed-Setter	2	`speed` from register, `set_speed` updates
Arrive-Threshold + Enabled	3	Default threshold = 2, `set_arrive_threshold` writes, `enabled` toggle
Error-Handling	2	`register` with non-function errors, `move_to` with unknown handle errors
TOTAL	24

Tested-Surface

command.register, command.unregister, command.count_registered
command.move_to, command.current, command.is_moving
command.cancel, command.cancel_all
command.speed, command.set_speed
command.arrive_threshold, command.set_arrive_threshold
command.enabled, command.set_enabled
command.update (step + arrival-snap)

Fault-Injection Audit (2026-05-16)

Verified via deliberate-mutation in fixture-mirror; mutations reverted after observation.

Caught Mutations

#	Mutation	Caught by
M1	`M.move_to` prefixed with `do return end` (complete no-op)	6 assertions fail: `current returns move-command data`, `is_moving true after move_to`, `update moves 10px`, `arrival snap to target.x`, `cancel doesn't affect h3`, `move_to with unknown handle errors`
M2	`M.is_moving` prefixed with `do return false end` (always false)	`is_moving true after move_to` fails

Uncaught Mutations (Gaps) — Cheap-Fill Applied

#	Original Gap	Fill	Re-Inject Verifies
M3	`M.cancel_all` rewritten to break after first entry	Added 2-unit batch scenario; asserts h2 + h3 both nil after `cancel_all`	✓

Structurally Untestable

None identified at headless level — entire surface exercisable via mocked-unit closure-state helper.

Deferred

Multi-frame integration with lib-core.player_control consumer flow (covered indirectly by player_control-test).

Running

Via --test-libs=lib-core.command-test (Smoke P0-S-batch Stage):

Sporel.exe --libs-dir=<libs-path> --test-libs=lib-core.command-test

Output is TAP version 13 on stdout; exit-code = failure-count (0 = all pass).

References

ADR-0037 (Tests-as-Libs Convention)
ADR-0038 (API-Doc-Convention)
Production-Lib: ~/Projects/Sporel/sporel-libs/lib-core/command/README.md
Spec: meta/docs/superpowers/specs/2026-05-14-p3-7-lib-command-design.md

3.8 KiB Raw Blame History