tiny.smg.context

1pub const Entry = struct {2    name: []const u8,3    type: []const u8,4    section: Section,5    relation: []const u8,6    level: []const u8,7    content: []const u8,8    tokens: usize,9    file: ?[]const u8 = null,10    line: ?i64 = null,11};

1pub const Result = struct {2    target: []const u8,3    entries: []const Entry,4    total_tokens: usize,5    budget: i64,6    truncated: bool,7};

1pub const Section = enum(u8) {2    about,3    owner,4    usages,5    impact,6    tests,7    dependencies,8};

1/// Inspects an existing graph without blocking on publication or changing its state.2pub fn run(3    allocator: std.mem.Allocator,4    root: []const u8,5    targets: []const []const u8,6    options: model.Options,7) !model.Inspection {8    try model.validate(root, targets, options);9    var result = model.Inspection{10        .arena = std.heap.ArenaAllocator.init(allocator),11        .result = undefined,12    };13    errdefer result.deinit();14    const owned = result.arena.allocator();15    const owned_root = try std.fs.path.resolve(owned, &.{root});16    var builder = model.Builder{17        .allocator = owned,18        .root = owned_root,19        .options = options,20        .deadline_ns = sys.time.nanoTimestamp() + @as(i128, options.deadline_ms) * 1_000_000,21        .report = .{ .limits = options.limits, .deadline_ms = options.deadline_ms, .expand = .{22            .cwd = owned_root,23            .argv = &.{ "smg", "context", targets[0], "--format", "json" },24        } },25    };26    std.debug.assert(options.limits.rows <= model.rows_max);27    try initialize(&builder, targets);28    collect(allocator, &builder) catch |err| {29        if (err == error.OutOfMemory) return err;30        builder.report.state = failureState(err);31        builder.report.coverage.traversal_complete = false;32        builder.report.problems = try owned.dupe([]const u8, &.{@errorName(err)});33    };34    result.result = try builder.finish();35    return result;36}

1pub fn build(allocator: std.mem.Allocator, graph: graph_mod.Graph, root: []const u8, name: []const u8, budget: i64, with_source: bool, limits: limits_mod.Context) !Result {2    return try buildSource(3        allocator,4        .{ .graph = graph },5        root,6        name,7        budget,8        with_source,9        limits,10    );11}

1pub fn buildFromReader(2    allocator: std.mem.Allocator,3    reader: *smg.storage.database.Reader,4    root: []const u8,5    name: []const u8,6    budget: i64,7    with_source: bool,8    limits: limits_mod.Context,9) !Result {10    return try buildSource(11        allocator,12        .{ .stored = reader },13        root,14        name,15        budget,16        with_source,17        limits,18    );19}

1pub fn toJson(allocator: std.mem.Allocator, result: Result) ![]const u8 {2    var out: std.Io.Writer.Allocating = .init(allocator);3    var writer = pretty_json.Writer.init(&out.writer, .minified);4    try writer.beginObject();5    try writer.objectField("target");6    try writer.write(result.target);7    try writer.objectField("total_tokens");8    try writer.write(result.total_tokens);9    try writer.objectField("budget");10    try writer.write(result.budget);11    try writer.objectField("truncated");12    try writer.write(result.truncated);13    try writer.objectField("sections");14    try writer.beginObject();15    inline for (std.meta.tags(Section)) |section| {16        try writer.objectField(@tagName(section));17        try writer.write(sectionEntryCount(result.entries, section));18    }19    try writer.endObject();20    try writer.objectField("entries");21    try writer.beginArray();22    for (result.entries) |entry| {23        try writer.beginObject();24        try writer.objectField("name");25        try writer.write(entry.name);26        try writer.objectField("type");27        try writer.write(entry.type);28        try writer.objectField("section");29        try writer.write(@tagName(entry.section));30        try writer.objectField("relation");31        try writer.write(entry.relation);32        try writer.objectField("level");33        try writer.write(entry.level);34        try writer.objectField("tokens");35        try writer.write(entry.tokens);36        try writer.objectField("content");37        try writer.write(entry.content);38        if (entry.file) |file| {39            try writer.objectField("file");40            try writer.write(file);41        }42        if (entry.line) |line| {43            try writer.objectField("line");44            try writer.write(line);45        }46        try writer.endObject();47    }48    try writer.endArray();49    try writer.endObject();50    try out.writer.writeByte('\n');51    return try out.toOwnedSlice();52}

1pub fn toText(allocator: std.mem.Allocator, result: Result) ![]const u8 {2    return try toTextWithOptions(allocator, result, .{ .width = 88 });3}

1//! Source context packing and bounded inspection of persisted syntactic relationships.23const pack = @import("pack.zig");4const inspection = @import("inspect.zig");56pub const model = @import("model.zig");7pub const query = @import("query.zig");8pub const source = @import("source.zig");9pub const render = @import("render.zig");1011pub const Section = pack.Section;12pub const Entry = pack.Entry;13pub const Result = pack.Result;14pub const build = pack.build;15pub const buildFromReader = pack.buildFromReader;16pub const toJson = pack.toJson;17pub const toText = pack.toText;1819pub const Inspection = model.Inspection;20pub const InspectOptions = model.Options;21pub const inspect = inspection.run;

1pub const context = @import("context/root.zig");