✓
Passing This code compiles and runs correctly.
Code
// Test: `koruc explain` on a pump — std/pump's explainer folds the
// create/join/run sites in document order and reports the composition:
// participants in join order, the verbs each answers, drain policy
// (every `live` answered → the pump retires), the idle policy (no `!
// idle` arm + a `wait` verb → the union wait), and the `| drained` arm.
// The fold reuses the transforms' own checks — PH.calleeDecl and the
// verb contract — so the report cannot drift from what run emits.
// post.sh drives both the text rows and the typed json catalog; the
// program itself drains in 3 steps (MUST_RUN proves the report true).
import std/io
import std/pump
import std/explain
std/pump:create(main)
| drained |> std/io:print.ln("pump drained")
std/pump(main)
! step |> step()
! live |> live()
! wait i |> wait(i)
std/pump:run(main)
Supporting Files
using static KoruHost;
static class KoruHost {
public static long ticked = 0;
}
~proc step|cs {
ticked += 1;
return if (ticked < 3) 1 else 0;
}
~proc live|cs {
return @intFromBool(ticked < 3);
}
~proc wait|cs {
_ = i;
return 1_000_000;
}Actual · Zig
✓ passpump drained
Actual · C#
✗ cs-compileExpected output
✓ Zig✗ C#pump drained
Emitted Zig source
// Access compiler flags via the per-user compiler_env module
const CompilerEnv = @import("compiler_env").CompilerEnv;
pub const panic = if (@import("builtin").mode == .Debug)
@import("std").debug.FullPanic(@import("std").debug.defaultPanic)
else
@import("std").debug.simple_panic;
const __koru_bare = struct {
extern fn posix_memalign(memptr: *?*anyopaque, alignment: usize, size: usize) c_int;
extern fn free(ptr: ?*anyopaque) void;
fn bareAlloc(_: *anyopaque, len: usize, alignment: @import("std").mem.Alignment, _: usize) ?[*]u8 {
var p: ?*anyopaque = null;
const a = @max(alignment.toByteUnits(), @sizeOf(usize));
if (posix_memalign(&p, a, len) != 0) return null;
return @ptrCast(p);
}
fn bareResize(_: *anyopaque, _: []u8, _: @import("std").mem.Alignment, _: usize, _: usize) bool { return false; }
fn bareRemap(_: *anyopaque, _: []u8, _: @import("std").mem.Alignment, _: usize, _: usize) ?[*]u8 { return null; }
fn bareFree(_: *anyopaque, memory: []u8, _: @import("std").mem.Alignment, _: usize) void { free(@ptrCast(memory.ptr)); }
const vtable = @import("std").mem.Allocator.VTable{ .alloc = bareAlloc, .resize = bareResize, .remap = bareRemap, .free = bareFree };
const allocator = @import("std").mem.Allocator{ .ptr = undefined, .vtable = &vtable };
};
const __koru_backing = if (@import("builtin").link_libc) @import("std").heap.c_allocator else if (@import("builtin").os.tag == .freestanding) __koru_bare.allocator else @import("std").heap.page_allocator;
var __koru_leak_count: @import("std").atomic.Value(usize) = .init(0);
fn __koru_alloc(ctx: *anyopaque, len: usize, alignment: @import("std").mem.Alignment, ret_addr: usize) ?[*]u8 {
_ = ctx;
const r = __koru_backing.rawAlloc(len, alignment, ret_addr);
if (comptime @import("builtin").mode == .Debug) {
if (r != null) _ = __koru_leak_count.fetchAdd(1, .monotonic);
}
return r;
}
fn __koru_resize(ctx: *anyopaque, memory: []u8, alignment: @import("std").mem.Alignment, new_len: usize, ret_addr: usize) bool {
_ = ctx;
return __koru_backing.rawResize(memory, alignment, new_len, ret_addr);
}
fn __koru_remap(ctx: *anyopaque, memory: []u8, alignment: @import("std").mem.Alignment, new_len: usize, ret_addr: usize) ?[*]u8 {
_ = ctx;
return __koru_backing.rawRemap(memory, alignment, new_len, ret_addr);
}
fn __koru_free(ctx: *anyopaque, memory: []u8, alignment: @import("std").mem.Alignment, ret_addr: usize) void {
_ = ctx;
__koru_backing.rawFree(memory, alignment, ret_addr);
if (comptime @import("builtin").mode == .Debug) {
_ = __koru_leak_count.fetchSub(1, .monotonic);
}
}
const __koru_vtable = @import("std").mem.Allocator.VTable{ .alloc = __koru_alloc, .resize = __koru_resize, .remap = __koru_remap, .free = __koru_free };
pub fn koru_allocator() @import("std").mem.Allocator {
return .{ .ptr = undefined, .vtable = &__koru_vtable };
}
pub inline fn __koru_intcast(comptime T: type, x: anytype) T {
if (comptime (@import("builtin").mode == .Debug or @import("builtin").mode == .ReleaseSafe))
return @as(T, @intCast(x));
const dst = @typeInfo(T);
const src = @typeInfo(@TypeOf(x));
if (comptime (dst == .int and src == .int and dst.int.bits == src.int.bits and dst.int.signedness != src.int.signedness))
return @as(T, @bitCast(x));
return @as(T, @intCast(x));
}
pub fn koru_leak_check() void {
if (comptime @import("builtin").mode != .Debug) return;
if (__koru_leak_count.load(.acquire) == 0) return;
if (comptime @import("builtin").target.os.tag == .freestanding) {
if (comptime @import("builtin").cpu.arch == .wasm32 or @import("builtin").cpu.arch == .wasm64) {
@panic("KORU LEAK CHECK FAILED: the produced program leaked");
} else {
const __klc = struct { extern var stdout: ?*anyopaque; extern fn fputs(__s: [*:0]const u8, __st: ?*anyopaque) c_int; };
var __lb: [128]u8 = undefined;
const __lm = "KORU LEAK CHECK FAILED: allocations still outstanding at end of run: ";
@memcpy(__lb[0..__lm.len], __lm);
var __ln: usize = __lm.len;
var __lv = __koru_leak_count.load(.acquire);
var __ld: [20]u8 = undefined;
var __lk: usize = 0;
while (__lv > 0) : (__lk += 1) { __ld[__lk] = @intCast('0' + __lv % 10); __lv /= 10; }
for (0..__lk) |__li| { __lb[__ln] = __ld[__lk - 1 - __li]; __ln += 1; }
__lb[__ln] = '\n'; __ln += 1; __lb[__ln] = 0;
_ = __klc.fputs(@as([*:0]const u8, @ptrCast(&__lb)), __klc.stdout);
@trap();
}
} else {
@import("std").debug.print("KORU LEAK CHECK FAILED: the produced program leaked (trace above)\n", .{});
@import("std").process.exit(1);
}
}
pub const main_module = struct {
var ticked: i64 = 0;
pub const step_event = struct {
pub const Input = struct {
};
pub const Output = i32;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> PROC: step [tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.kz:6]
_ = &__koru_event_input;
ticked += 1;
return if (ticked < 3) 1 else 0;
}
};
pub const live_event = struct {
pub const Input = struct {
};
pub const Output = i64;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> PROC: live [tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.kz:13]
_ = &__koru_event_input;
return @intFromBool(ticked < 3);
}
};
pub const wait_event = struct {
pub const Input = struct {
i: i64,
};
pub const Output = i128;
pub inline fn handler(__koru_event_input: @This().Input) @This().Output {
return __koru_handler_impl(__koru_event_input.i);
}
fn __koru_handler_impl(__koru_p_0: i64) @This().Output {
const __koru_event_input: @This().Input = .{ .i = __koru_p_0 };
// >>> PROC: wait [tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.kz:19]
const i = __koru_event_input.i;
_ = &i;
_ = &__koru_event_input;
_ = &i;
return 1_000_000;
}
};
// >>> FLOW: tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.k:22 ~input:__pump_run_main()
pub fn flow0() void {
const __koru_eff_disc_0: main_module.__pump_run_main_event.Output = __koru_proc_0: {
while (true) {
var __koru_live: i64 = 0;
__koru_live += main_module.__pump_main_live_0_event.handler(.{});
if (__koru_live == 0) break;
var __koru_worked: i64 = 0;
__koru_worked += main_module.__pump_main_step_0_event.handler(.{});
if (__koru_worked == 0) { if (false) { _ = {}; } else {
var __koru_wait_ns: i128 = @import("std").math.maxInt(i128);
const __koru_pfds = @import("std").heap.page_allocator.alloc(@import("std").posix.pollfd, @as(usize, @intCast(@max(__koru_live + 0, 1)))) catch unreachable;
defer @import("std").heap.page_allocator.free(__koru_pfds);
var __koru_nfd: usize = 0;
for (0..@as(usize, @intCast(main_module.__pump_main_live_0_event.handler(.{})))) |__koru_wi| {
const __koru_w = main_module.__pump_main_wait_0_event.handler(.{ .i = @intCast(__koru_wi) });
if (__koru_w.fd >= 0) { __koru_pfds[__koru_nfd] = .{ .fd = __koru_w.fd, .events = @import("std").posix.POLL.IN, .revents = 0 }; __koru_nfd += 1; }
if (__koru_w.wait_ns < __koru_wait_ns) __koru_wait_ns = __koru_w.wait_ns;
}
if (__koru_nfd == 0 and __koru_wait_ns == @import("std").math.maxInt(i128)) {
@import("std").Thread.sleep(1_000_000);
} else {
var __koru_ms: i32 = -1;
if (__koru_wait_ns != @import("std").math.maxInt(i128)) __koru_ms = @intCast(@min(@as(i128, @import("std").math.maxInt(i32)) * 1_000_000, @max(@as(i128, 0), __koru_wait_ns)) / 1_000_000);
if (__koru_nfd > 0) {
_ = @import("std").posix.poll(__koru_pfds[0..__koru_nfd], __koru_ms) catch 0;
} else if (__koru_ms >= 0) {
@import("std").Thread.sleep(@as(u64, @intCast(__koru_ms)) * 1_000_000);
}
}
} }
}
main_module.__pump_drained_main_event.handler(.{});
break :__koru_proc_0;
};
_ = __koru_eff_disc_0;
}
pub fn koru_start_flow() void {
const result_0 = koru_koru.start_event.handler(.{ });
const result_0_done = result_0.done;
_ = &result_0_done;
}
pub fn koru_end_flow() void {
const result_0 = koru_koru.end_event.handler(.{ });
const result_0_done = result_0.done;
_ = &result_0_done;
}
pub const __pump_drained_main_event = struct {
pub const Input = struct {
};
pub const Output = void;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> SUBFLOW: tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.k:14
_ = &__koru_event_input;
(struct { fn __kout(__fd: i32, __b: []const u8) void { if (@import("builtin").os.tag == .freestanding) { const __kc = struct { extern var stdout: ?*anyopaque; extern var stderr: ?*anyopaque; extern fn fputs(__s: [*:0]const u8, __st: ?*anyopaque) c_int; }; var __kt: [4096]u8 = undefined; for (0..(__b.len + __kt.len - 2) / (__kt.len - 1)) |__ki| { const __kn = @min(__kt.len - 1, __b.len - __ki * (__kt.len - 1)); @memcpy(__kt[0..__kn], __b[__ki * (__kt.len - 1)..][0..__kn]); __kt[__kn] = 0; @import("std").mem.doNotOptimizeAway(__kc.fputs(@as([*:0]const u8, @ptrCast(&__kt)), if (__fd == 2) __kc.stderr else __kc.stdout)); } } else { @import("std").mem.doNotOptimizeAway(@import("std").posix.write(__fd, __b) catch @as(usize, 0)); } } fn __kw(comptime __f: []const u8, __a: anytype) void { var __kb: [65536]u8 = undefined; const __ks = @import("std").fmt.bufPrint(&__kb, __f, __a) catch __kb[0..0]; __kout(1, __ks); } }).__kw("pump drained\n", .{});
}
};
pub const __pump_main_step_0_event = struct {
pub const Input = struct {
};
pub const Output = i32;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> SUBFLOW: tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.k:17
_ = &__koru_event_input;
const result = main_module.step_event.handler(.{ });
const __koru_r = result;
_ = &result;
return __koru_r;
}
};
pub const __pump_main_live_0_event = struct {
pub const Input = struct {
};
pub const Output = i64;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> SUBFLOW: tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.k:17
_ = &__koru_event_input;
const result = main_module.live_event.handler(.{ });
const __koru_r = result;
_ = &result;
return __koru_r;
}
};
pub const __pump_main_wait_0_event = struct {
pub const Input = struct {
i: i64,
};
pub const Output = struct { fd: i32, wait_ns: i128 };
pub inline fn handler(__koru_event_input: @This().Input) @This().Output {
return __koru_handler_impl(__koru_event_input.i);
}
fn __koru_handler_impl(__koru_p_0: i64) @This().Output {
const __koru_event_input: @This().Input = .{ .i = __koru_p_0 };
// >>> SUBFLOW: tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.k:17
const i = __koru_event_input.i;
_ = &i;
_ = &__koru_event_input;
const result = main_module.wait_event.handler(.{ .i = i });
const __koru_w = result;
_ = &result;
return .{ .fd = -1, .wait_ns = __koru_w };
}
};
pub const __pump_run_main_event = struct {
pub const Input = struct {
};
pub const Output = void;
pub fn handler(__koru_event_input: @This().Input, comptime __H: type) @This().Output {
const idle = if (@hasDecl(__H, "idle")) __H.idle else struct { fn __koru_noop() void {} }.__koru_noop;
_ = &idle;
// >>> PROC: __pump_run_main [tests/regression/600_STDLIB/690_STORE/690_317_explain_reports_pump_composition/input.k:22]
_ = &__koru_event_input;
while (true) {
var __koru_live: i64 = 0;
__koru_live += main_module.__pump_main_live_0_event.handler(.{});
if (__koru_live == 0) break;
var __koru_worked: i64 = 0;
__koru_worked += main_module.__pump_main_step_0_event.handler(.{});
if (__koru_worked == 0) { if (@hasDecl(__H, "idle")) { idle(); } else {
var __koru_wait_ns: i128 = @import("std").math.maxInt(i128);
const __koru_pfds = @import("std").heap.page_allocator.alloc(@import("std").posix.pollfd, @as(usize, @intCast(@max(__koru_live + 0, 1)))) catch unreachable;
defer @import("std").heap.page_allocator.free(__koru_pfds);
var __koru_nfd: usize = 0;
for (0..@as(usize, @intCast(main_module.__pump_main_live_0_event.handler(.{})))) |__koru_wi| {
const __koru_w = main_module.__pump_main_wait_0_event.handler(.{ .i = @intCast(__koru_wi) });
if (__koru_w.fd >= 0) { __koru_pfds[__koru_nfd] = .{ .fd = __koru_w.fd, .events = @import("std").posix.POLL.IN, .revents = 0 }; __koru_nfd += 1; }
if (__koru_w.wait_ns < __koru_wait_ns) __koru_wait_ns = __koru_w.wait_ns;
}
if (__koru_nfd == 0 and __koru_wait_ns == @import("std").math.maxInt(i128)) {
@import("std").Thread.sleep(1_000_000);
} else {
var __koru_ms: i32 = -1;
if (__koru_wait_ns != @import("std").math.maxInt(i128)) __koru_ms = @intCast(@min(@as(i128, @import("std").math.maxInt(i32)) * 1_000_000, @max(@as(i128, 0), __koru_wait_ns)) / 1_000_000);
if (__koru_nfd > 0) {
_ = @import("std").posix.poll(__koru_pfds[0..__koru_nfd], __koru_ms) catch 0;
} else if (__koru_ms >= 0) {
@import("std").Thread.sleep(@as(u64, @intCast(__koru_ms)) * 1_000_000);
}
}
} }
}
main_module.__pump_drained_main_event.handler(.{});
return;
}
};
};
pub const koru_koru = struct {
pub const start_event = struct {
pub const Input = struct {
};
pub const Output = union(enum(u8)) {
done: struct {
},
};
pub fn handler(__koru_event_input: @This().Input) @This().Output {
_ = &__koru_event_input;
return .{ .done = .{} };
}
};
pub const end_event = struct {
pub const Input = struct {
};
pub const Output = union(enum(u8)) {
done: struct {
},
};
pub fn handler(__koru_event_input: @This().Input) @This().Output {
_ = &__koru_event_input;
return .{ .done = .{} };
}
};
};
pub fn main() void {
main_module.koru_start_flow();
main_module.flow0();
main_module.koru_end_flow();
if (comptime @import("builtin").mode == .Debug) koru_leak_check();
}
test {
@import("std").testing.refAllDeclsRecursive(@This());
}
Test Configuration
MUST_RUN
Post-validation Script:
#!/bin/bash
# `koruc explain` gathers [explainer] reports: std/pump reports the folded
# composition — participants in join order, verbs per join, drain and idle
# policy. Asserted in text rows and the typed json catalog.
set -e
echo "=== koruc explain (text) ==="
TEXT=$(koruc "$KORU_INPUT" explain 2>&1)
echo "$TEXT"
echo "$TEXT" | grep -q "📖 std/pump" || { echo "FAIL: pump report missing"; exit 1; }
echo "$TEXT" | grep -q "participants = 1" || { echo "FAIL: participant count missing"; exit 1; }
echo "$TEXT" | grep -q "drained_arm = true" || { echo "FAIL: drained arm missing"; exit 1; }
echo "$TEXT" | grep -q "run = true" || { echo "FAIL: run state missing"; exit 1; }
echo "$TEXT" | grep -q "drains = true" || { echo "FAIL: drain policy missing"; exit 1; }
echo "$TEXT" | grep -q "idle = union wait over 1 interest" || { echo "FAIL: idle policy missing"; exit 1; }
echo "$TEXT" | grep -q "j0.step = input:step" || { echo "FAIL: step callee missing"; exit 1; }
echo "$TEXT" | grep -q "j0.live = input:live" || { echo "FAIL: live callee missing"; exit 1; }
echo "$TEXT" | grep -q "j0.wait = input:wait" || { echo "FAIL: wait callee missing"; exit 1; }
echo "$TEXT" | grep -q "join #0: step + live + wait(i)" || { echo "FAIL: join summary missing"; exit 1; }
echo "=== koruc explain json (typed) ==="
JSON=$(koruc "$KORU_INPUT" explain json 2>&1)
echo "$JSON"
echo "$JSON" | grep -q '"participants":1' || { echo "FAIL: count not typed"; exit 1; }
echo "$JSON" | grep -q '"drained_arm":true' || { echo "FAIL: drained not typed"; exit 1; }
echo "$JSON" | grep -q '"drains":true' || { echo "FAIL: drain policy not typed"; exit 1; }
echo "$JSON" | grep -q '"j0.step":"input:step"' || { echo "FAIL: callee spelling missing"; exit 1; }
echo "=== PASS: explain reports the pump composition ==="