graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
Python
//! Browser-tab counts for managed preview ports (#941).
//! Absent or unreadable file = unknown, never "no consumers".
const std = @import("std");
const Io = std.Io;
const Allocator = std.mem.Allocator;
pub const Kind = enum { unknown, none, some };
pub const grace_ms: i64 = 30 * std.time.ms_per_s;
pub const rel_path = ".codegraff/preview-consumers.json";
pub fn path(arena: Allocator, home: []const u8) ?[]const u8 {
if (home.len == 0) return null;
return std.fmt.allocPrint(arena, "{s}/{s}", .{ home, rel_path }) catch null;
}
pub fn kindOf(counts: std.json.ObjectMap, port: u16) Kind {
var buf: [8]u8 = undefined;
const key = std.fmt.bufPrint(&buf, "{d}", .{port}) catch return .unknown;
const value = counts.get(key) orelse return .unknown;
const n: i64 = switch (value) {
.integer => |i| i,
.float => |f| @intFromFloat(f),
else => return .unknown,
};
if (n < 0) return .unknown;
return if (n == 0) .none else .some;
}
pub fn load(io: Io, arena: Allocator, file: []const u8) ?std.json.ObjectMap {
const text = Io.Dir.cwd().readFileAlloc(io, file, arena, .limited(64 * 1024)) catch return null;
const parsed = std.json.parseFromSliceLeaky(std.json.Value, arena, text, .{ .allocate = .alloc_always }) catch return null;
return if (parsed == .object) parsed.object else null;
}
pub fn firstPort(text: []const u8) ?u16 {
var it = std.mem.splitScalar(u8, text, ',');
while (it.next()) |raw| {
const item = std.mem.trim(u8, raw, " ");
const colon = std.mem.lastIndexOfScalar(u8, item, ':') orelse continue;
const n = std.fmt.parseInt(u16, item[colon + 1 ..], 10) catch continue;
if (n != 0) return n;
}
return null;
}
test "unknown unless the port is explicitly zero" {
var arena_state = std.heap.ArenaAllocator.init(std.testing.allocator);
defer arena_state.deinit();
const parsed = try std.json.parseFromSlice(std.json.Value, arena_state.allocator(), "{\"5173\":0,\"3000\":2}", .{});
defer parsed.deinit();
try std.testing.expectEqual(Kind.none, kindOf(parsed.value.object, 5173));
try std.testing.expectEqual(Kind.some, kindOf(parsed.value.object, 3000));
try std.testing.expectEqual(Kind.unknown, kindOf(parsed.value.object, 8080));
}
test "firstPort reads lsof-style listen lists" {
try std.testing.expectEqual(@as(?u16, 3002), firstPort("127.0.0.1:3002, *:3003"));
try std.testing.expectEqual(@as(?u16, null), firstPort(""));
}