✓
Passing This code compiles and runs correctly.
Code
// Test: `koruc explain` on a packed store — std/store's explainer folds
// the sites (new's capacity and member block, insert/query/watch counts)
// and reports the composition alongside the facet-honesty row: `Limb`
// carries a refine facet on `health`, both members declare it, and
// `std/store:insert` enforces it — the catalog says so plainly.
// post.sh drives the text rows and the typed json catalog.
import std/io
import std/proto
import std/refine
import std/store
import std/explain
std/proto:i64(Health)
std/proto(Limb) {
health: Health
}
std/refine(Limb) {
health: Health & >0 & <=100
}
std/store:new(body, capacity: 8) { left: Limb, right: Limb }
std/store:insert(body) { left.health: 10, right.health: 20 }
std/store:query(body)
! query e |> std/io:print.ln("left {{ e.left.health:d }}")
Actual
left 10
Expected output
✓ Zig✓ C#left 10
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 {
// proto-terminal Health: i64
const Health = i64;
// proto Limb: health: Health
// refine input:Limb: health: Health & >0 & <=100
// std/store: plural store 'body' created (SoA cell + insert/query/write/take/stripe units); fields left.health: Health, right.health: Health
// >>> FLOW: tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:26 ~input:__store_insert_body()
pub fn flow0() void {
const result_0 = main_module.__store_insert_body_event.handler(.{ .@"left.health" = 10, .@"right.health" = 20, .__site_line = 26 });
switch (result_0) {
// >>> BRANCH: tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:26 | ok _auto_6 |>
.ok => {
},
// >>> BRANCH: tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:26 | violated v |>
.violated => |v| {
if (comptime @import("builtin").os.tag != .freestanding) @import("std").debug.print("__store_insert_body: panic branch 'violated' fired — payload: {s}\n", .{v});
@panic("__store_insert_body: unhandled panic branch 'violated' fired at runtime");
},
}
}
// >>> FLOW: tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:28 ~input:__store_sweeprun_body_L29_690_319_explain_reports_store_composition_input_4119a1()
pub fn flow1() void {
_ = main_module.__store_sweeprun_body_L29_690_319_explain_reports_store_composition_input_4119a1_event.handler(.{ });
}
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;
}
const __KoruStoreT_body = struct {
@"left.health": [8]Health = undefined,
@"right.health": [8]Health = undefined,
len: usize = 0,
};
var __koru_store_body: __KoruStoreT_body = .{};
const __KoruStoreRow_body = struct { @"left.health": Health, @"right.health": Health };
pub const __store_insert_body_event = struct {
pub const Input = struct {
@"left.health": Health,
@"right.health": Health,
__site_line: i64,
};
pub const Output = union(enum(u8)) {
ok: struct {
},
violated: []const u8,
};
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> PROC: __store_insert_body [tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:24]
const @"left.health" = __koru_event_input.@"left.health";
const @"right.health" = __koru_event_input.@"right.health";
const __site_line = __koru_event_input.__site_line;
_ = &@"left.health";
_ = &@"right.health";
_ = &__site_line;
_ = &__koru_event_input;
if (!(@"left.health" > 0 and @"left.health" <= 100)) return .{ .violated = "left.health" };
if (!(@"right.health" > 0 and @"right.health" <= 100)) return .{ .violated = "right.health" };
if (__koru_store_body.len >= 8) @panic("std/store: store 'body' is full (capacity 8) - declared capacity and the `| full` branch are pinned at 690_011");
const __koru_new_row = __koru_store_body.len;
__koru_store_body.@"left.health"[__koru_new_row] = @"left.health";
__koru_store_body.@"right.health"[__koru_new_row] = @"right.health";
__koru_store_body.len += 1;
return .{ .ok = .{} };
}
};
pub const __store_apply_body_event = struct {
pub const Input = struct {
row: usize,
field: i64,
value_0: Health,
value_1: Health,
};
pub const Output = union(enum(u8)) {
@"left.health": Health,
@"right.health": Health,
};
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> PROC: __store_apply_body [tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:24]
const row = __koru_event_input.row;
const field = __koru_event_input.field;
const value_0 = __koru_event_input.value_0;
const value_1 = __koru_event_input.value_1;
_ = &row;
_ = &field;
_ = &value_0;
_ = &value_1;
_ = &__koru_event_input;
const __koru_r: usize = row;
return switch (field) {
0 => blk: { __koru_store_body.@"left.health"[__koru_r] = value_0; break :blk .{ .@"left.health" = value_0 }; },
1 => blk: { __koru_store_body.@"right.health"[__koru_r] = value_1; break :blk .{ .@"right.health" = value_1 }; },
else => unreachable,
};
}
};
pub const __store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event = struct {
pub const Input = struct {
__koru_srf_e_L29_left_health: Health,
__koru_sdix_e_L29: usize,
};
pub const Output = void;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> SUBFLOW: tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:28
const __koru_srf_e_L29_left_health = __koru_event_input.__koru_srf_e_L29_left_health;
const __koru_sdix_e_L29 = __koru_event_input.__koru_sdix_e_L29;
_ = &__koru_srf_e_L29_left_health;
_ = &__koru_sdix_e_L29;
_ = &__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("left {d}\n", .{__koru_srf_e_L29_left_health});
}
};
pub const __store_sweeprun_body_L29_690_319_explain_reports_store_composition_input_4119a1_event = struct {
pub const Input = struct {
};
pub const Output = void;
pub fn handler(__koru_event_input: @This().Input) @This().Output {
// >>> PROC: __store_sweeprun_body_L29_690_319_explain_reports_store_composition_input_4119a1 [tests/regression/600_STDLIB/690_STORE/690_319_explain_reports_store_composition/input.k:28]
_ = &__koru_event_input;
{
for (0..main_module.__koru_store_body.len) |__koru_si| {
const __koru_srf_e_L29_left_health = main_module.__koru_store_body.@"left.health"[__koru_si];
_ = &__koru_srf_e_L29_left_health;
main_module.__store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event.handler(.{ .__koru_srf_e_L29_left_health = __koru_srf_e_L29_left_health, .__koru_sdix_e_L29 = __koru_si });
}
}
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.flow1();
main_module.koru_end_flow();
if (comptime @import("builtin").mode == .Debug) koru_leak_check();
}
test {
@import("std").testing.refAllDeclsRecursive(@This());
}
Emitted C# source
static class main_module {
public static void __koru_stdout_write(dynamic s) => global::System.Console.Out.Write(s);
public static void __koru_stderr_write(dynamic s) => global::System.Console.Error.Write(s);
// The mutable handle carrier — `*String`-style resources are
// `new __KoruBox { data = … }` because C# anonymous types are
// read-only: `s.data = …` (std/string append/clear, handle
// mutation generally) needs a settable member.
public class __KoruBox { public dynamic data; }
// Textification for `{{ … }}` operands: C# bool ToStrings as
// `True` where Koru prints `true`, and the operand's static type
// is unknown at this boundary — a `(x) is bool` inline test would
// be a compile error on statically-typed operands instead. Generic
// on purpose: `dynamic` boxed every value-type operand — measured
// ~1s/10M elements on 012_threat_scanner — while T specializes to
// the operand's own ToString() with no box.
public static string __koru_str<T>(T v) => v is bool b ? (b ? "true" : "false") : v?.ToString();
// proto-terminal Health: i64
// proto Limb: health: Health
// std/store: plural store 'body' created (SoA cell + insert/query/write/take/stripe units); fields left.health: Health, right.health: Health
static class __koru_store_body {
public static dynamic[] left_health = new dynamic[8];
public static dynamic[] right_health = new dynamic[8];
public static long len = 0;
public static long __koru_brand = -1;
}
public static class __store_insert_body_event {
public struct Input {
public dynamic left_health;
public dynamic right_health;
public long __site_line;
}
public struct Output {
public string tag;
public dynamic ok;
public string violated;
}
public static Output handler(Input __koru_input) {
var left_health = __koru_input.left_health;
var right_health = __koru_input.right_health;
var __site_line = __koru_input.__site_line;
if (!(left_health > 0 && left_health <= 100)) return new Output { tag = "violated", violated = "left.health" };
if (!(right_health > 0 && right_health <= 100)) return new Output { tag = "violated", violated = "right.health" };
if (__koru_store_body.len >= 8) throw new global::System.Exception("std/store: store 'body' is full (capacity 8) - declared capacity and the `| full` branch are pinned at 690_011");
long __koru_new_row = __koru_store_body.len;
__koru_store_body.left_health[__koru_new_row] = left_health;
__koru_store_body.right_health[__koru_new_row] = right_health;
__koru_store_body.len += 1;
return new Output { tag = "ok", ok = new { } };
return default;
}
}
public static class __store_apply_body_event {
public struct Input {
public long row;
public long field;
public dynamic value_0;
public dynamic value_1;
}
public struct Output {
public string tag;
public dynamic left_health;
public dynamic right_health;
}
public static Output handler(Input __koru_input) {
var row = __koru_input.row;
var field = __koru_input.field;
var value_0 = __koru_input.value_0;
var value_1 = __koru_input.value_1;
var __koru_r = row;
switch (field) {
case 0: { __koru_store_body.left_health[__koru_r] = value_0; return new Output { tag = "left.health", left_health = value_0 }; }
case 1: { __koru_store_body.right_health[__koru_r] = value_1; return new Output { tag = "right.health", right_health = value_1 }; }
}
throw new global::System.Exception("__store_apply_body: field index " + field + " is not a column of store 'body'");
return default;
}
}
public static class __store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event {
public struct Input {
public dynamic __koru_srf_e_L29_left_health;
public long __koru_sdix_e_L29;
}
public static dynamic handler(Input __koru_input) {
var __koru_srf_e_L29_left_health = __koru_input.__koru_srf_e_L29_left_health;
var __koru_sdix_e_L29 = __koru_input.__koru_sdix_e_L29;
__koru_stdout_write("left " + __koru_str(__koru_srf_e_L29_left_health) + "\n");
return default;
}
}
public static class __store_sweeprun_body_L29_690_319_explain_reports_store_composition_input_4119a1_event {
public struct Input {
}
public static dynamic handler(Input __koru_input) {
{
for (var __koru_si = 0; __koru_si < __koru_store_body.len; __koru_si++) {
var __koru_srf_e_L29_left_health = __koru_store_body.left_health[__koru_si];
main_module.__store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event.handler(new main_module.__store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event.Input { __koru_srf_e_L29_left_health = __koru_srf_e_L29_left_health, __koru_sdix_e_L29 = __koru_si });
}
}
return default;
}
}
public static class koru_start_event {
public struct Input {
}
public struct Output {
public string tag;
public dynamic done;
}
public static Output handler(Input __koru_input) => new Output { tag = "done" };
}
public static class koru_end_event {
public struct Input {
}
public struct Output {
public string tag;
public dynamic done;
}
public static Output handler(Input __koru_input) => new Output { tag = "done" };
}
public static void flow0() {
var result_0 = main_module.__store_insert_body_event.handler(new __store_insert_body_event.Input { left_health = 10, right_health = 20, __site_line = (long)(26)});
if (result_0.tag == "ok") {
var _auto_6 = result_0.ok;
}
if (result_0.tag == "violated") {
var v = result_0.violated;
__koru_stderr_write("__store_insert_body: panic branch 'violated' fired — payload: " + v + "\n");
throw new global::System.Exception("__store_insert_body: unhandled panic branch 'violated' fired at runtime");
}
}
public static void flow1() {
{
{
for (var __koru_si = 0; __koru_si < __koru_store_body.len; __koru_si++) {
var __koru_srf_e_L29_left_health = __koru_store_body.left_health[__koru_si];
main_module.__store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event.handler(new main_module.__store_sweepbody_body_L29_690_319_explain_reports_store_composition_input_4119a1_event.Input { __koru_srf_e_L29_left_health = __koru_srf_e_L29_left_health, __koru_sdix_e_L29 = __koru_si });
}
}
}
}
public static void flow2() {
main_module.koru_start_event.handler(new koru_start_event.Input { });
}
public static void flow3() {
main_module.koru_end_event.handler(new koru_end_event.Input { });
}
}
static class Program {
static void Main() {
main_module.flow2();
main_module.flow0();
main_module.flow1();
main_module.flow3();
}
}
Flows
flow ~i64 click a branch to expand · @labels scroll to their anchor
i64 (expr: Health)
flow ~std/proto click a branch to expand · @labels scroll to their anchor
std/proto (Limb, source: health: Health)
flow ~std/refine click a branch to expand · @labels scroll to their anchor
std/refine (Limb, source: health: Health & >0 & <=100)
flow ~new click a branch to expand · @labels scroll to their anchor
new (body, capacity: 8, source: left: Limb, right: Limb)
flow ~insert click a branch to expand · @labels scroll to their anchor
insert (body, source: left.health: 10, right.health: 20)
flow ~query click a branch to expand · @labels scroll to their anchor
query (body)
Test Configuration
MUST_RUN LANGUAGES: zig cs
Post-validation Script:
#!/bin/bash
# `koruc explain` gathers [explainer] reports: std/store reports the folded
# composition (capacity, members, interceptor arms, site counts) and the
# facet-honesty row — declared on the member proto, enforced at insert.
set -e
echo "=== koruc explain (text) ==="
TEXT=$(koruc "$KORU_INPUT" explain 2>&1)
echo "$TEXT"
echo "$TEXT" | grep -q "📖 std/store" || { echo "FAIL: store report missing"; exit 1; }
echo "$TEXT" | grep -q "capacity = 8" || { echo "FAIL: capacity missing"; exit 1; }
echo "$TEXT" | grep -q "columns = 2" || { echo "FAIL: member count missing"; exit 1; }
echo "$TEXT" | grep -q "left: Limb" || { echo "FAIL: member spelling missing"; exit 1; }
echo "$TEXT" | grep -q "inserts = 1" || { echo "FAIL: insert count missing"; exit 1; }
echo "$TEXT" | grep -q "queries = 1" || { echo "FAIL: query count missing"; exit 1; }
echo "$TEXT" | grep -q "facets_declared = 2" || { echo "FAIL: facet count missing"; exit 1; }
echo "$TEXT" | grep -q "insert enforces them" || { echo "FAIL: facet honesty missing"; exit 1; }
echo "=== witness hashes + at resolution ==="
echo "$TEXT" | grep -qE "inserts = 1 \[[0-9a-z]+\]" || { echo "FAIL: insert witness missing"; exit 1; }
HASH=$(echo "$TEXT" | grep -oE "inserts = 1 \[[0-9a-z]+\]" | grep -oE "\[[0-9a-z]+\]" | tr -d '[]')
AT=$(koruc "$KORU_INPUT" at "$HASH" 2>&1)
echo "$AT"
echo "$AT" | grep -q "std.store:insert" || { echo "FAIL: at missed the insert site"; exit 1; }
echo "$AT" | grep -q "input.k" || { echo "FAIL: at lost the file"; exit 1; }
koruc "$KORU_INPUT" at "${HASH}zz" 2>&1 | grep -q "tail drifted" || { echo "FAIL: drifted tail not absorbed"; exit 1; }
echo "=== koruc explain json (typed) ==="
JSON=$(koruc "$KORU_INPUT" explain json 2>&1)
echo "$JSON"
echo "$JSON" | grep -q '"capacity":8' || { echo "FAIL: capacity not typed"; exit 1; }
echo "$JSON" | grep -q '"columns":2' || { echo "FAIL: columns not typed"; exit 1; }
echo "$JSON" | grep -q '"inserts":1' || { echo "FAIL: inserts not typed"; exit 1; }
echo "$JSON" | grep -q '"facets_declared":2' || { echo "FAIL: facets not typed"; exit 1; }
echo "=== PASS: explain reports the store composition ==="