Render a Red-then-Green Vox fn stub paired with an @test block. The output is intentionally non-runnable: the test references undefined placeholders (_expected, _ per param) so the user is forced to fill in the expected behavior before the function compiles. This is the friction reducer for AGENTS.md §Test-First Policy. name: validated Vox identifier (alphanumeric + underscore, not starting with a digit). params: optional, e.g. "a: int, b: int". Empty means no parameters. returns: optional return type, e.g. "int". None means Unit.
append_fn_stub
Append a rendered fn-stub to a target file (creating it if missing). Returns the bytes written. Refuses to clobber a fn of the same name unless force is true.
Render a Red-then-Green Vox fn stub paired with an @test block. The output is intentionally non-runnable: the test references undefined placeholders (_expected, _ per param) so the user is forced to fill in the expected behavior before the function compiles. This is the friction reducer for AGENTS.md §Test-First Policy. name: validated Vox identifier (alphanumeric + underscore, not starting with a digit). params: optional, e.g. "a: int, b: int". Empty means no parameters. returns: optional return type, e.g. "int". None means Unit.
Append a rendered fn-stub to a target file (creating it if missing). Returns the bytes written. Refuses to clobber a fn of the same name unless force is true.