tiny.smg.command.scan.text

1pub const text = @import("text.zig");

1const std = @import("std");23const smg = @import("../../root.zig");4const counts = smg.command.scan.counts;5const hints = smg.command.scan.hints;6const model = smg.model;7const output = smg.cli.output;8const scan = smg.scan;910pub fn render(allocator: std.mem.Allocator, stats: scan.Stats, full: bool) ![]const u8 {11    var rows: std.ArrayList(ScanTextRow) = .empty;12    const languages = try counts.parts(allocator, stats.lang_counts.items);13    const types = try counts.parts(allocator, stats.type_counts.items);14    const node_value = if (stats.nodes_removed != 0)15        try std.fmt.allocPrint(allocator, "+{d} -{d}", .{ stats.nodes_added, stats.nodes_removed })16    else17        types;18    try rows.append(allocator, .{ .label = "Nodes", .value = node_value });19    const edge_value = if (stats.edges_removed != 0)20        try std.fmt.allocPrint(allocator, "+{d} -{d}", .{ stats.edges_added, stats.edges_removed })21    else22        try std.fmt.allocPrint(allocator, "{d}", .{stats.edges_added});23    try rows.append(allocator, .{ .label = "Edges", .value = edge_value });24    if (stats.skipped_edges != 0) {25        try rows.append(allocator, .{ .label = "Skipped", .value = try std.fmt.allocPrint(allocator, "{d} unresolved", .{stats.skipped_edges}) });26        try rows.append(allocator, .{ .label = "Skipped by kind", .value = try counts.parts(allocator, stats.skipped_edge_categories.items) });27        const advice = try counts.sorted(allocator, stats.skipped_edge_categories.items);28        const cap = @min(advice.len, @as(usize, 3));29        for (advice[0..cap]) |item| {30            try rows.append(allocator, .{31                .label = try std.fmt.allocPrint(allocator, "Hint: {s}", .{item.name}),32                .value = hints.text(item.name),33            });34        }35    }36    var out: std.Io.Writer.Allocating = .init(allocator);37    try out.writer.print("Scanned {d} files ({s})\n", .{ stats.files, languages });38    try writeRows(allocator, &out.writer, rows.items);39    const total_edges = stats.edges_added + stats.skipped_edges;40    if (stats.skipped_edges > 0 and total_edges > 0 and stats.skipped_edges * 2 > total_edges) {41        try out.writer.print("\nHint: {d}/{d} edges were skipped (targets outside the scanned scope). Try scanning a wider directory to resolve cross-module edges.\n", .{ stats.skipped_edges, total_edges });42    }43    if (full and stats.skipped_edge_samples.items.len != 0) {44        try out.writer.writeAll("Skipped edge examples:\n");45        const cap = @min(stats.skipped_edge_samples.items.len, @as(usize, 5));46        for (stats.skipped_edge_samples.items[0..cap]) |sample| {47            try out.writer.print("  {s} --{s}--> {s} ({s}: {s})\n", .{ sample.source, sample.rel, sample.target, sample.category, sample.reason });48        }49    } else if (stats.skipped_edge_samples.items.len != 0) {50        try out.writer.writeAll("Skipped edge examples hidden; use --full to show samples.\n");51    }52    if (full and stats.orphaned_manual_edges.items.len != 0) {53        try out.writer.print("\nWarning: {d} manual edge(s) orphaned:\n", .{stats.orphaned_manual_edges.items.len});54        for (stats.orphaned_manual_edges.items) |edge| {55            try out.writer.print("  {s} --{s}--> {s} ({s})\n", .{ edge.source, edge.rel, edge.target, edge.reason });56        }57    }58    return try out.toOwnedSlice();59}6061const ScanTextRow = struct {62    label: []const u8,63    value: []const u8,64};6566fn writeRows(allocator: std.mem.Allocator, writer: *std.Io.Writer, rows: []const ScanTextRow) !void {67    var label_width: usize = 0;68    for (rows) |row| label_width = @max(label_width, row.label.len);69    const value_width = if (label_width + 2 >= 80) @as(usize, 1) else 80 - label_width - 2;70    for (rows) |row| try writeRow(allocator, writer, row, label_width, value_width);71}7273fn writeRow(allocator: std.mem.Allocator, writer: *std.Io.Writer, row: ScanTextRow, label_width: usize, value_width: usize) !void {74    var rest = row.value;75    var first = true;76    while (first or rest.len != 0) {77        const chunk_len = wrapLength(rest, value_width);78        var line: std.Io.Writer.Allocating = .init(allocator);79        if (first) {80            try output.writeDocText(&line.writer, row.label);81            try output.writeSpacesDoc(&line.writer, label_width -| row.label.len);82        } else {83            try output.writeSpacesDoc(&line.writer, label_width);84        }85        try output.writeDocText(&line.writer, "  ");86        try output.writeDocText(&line.writer, rest[0..chunk_len]);87        try output.writeSpacesDoc(&line.writer, 80 -| line.written().len);88        try writeTrimmedLine(writer, line.written());89        rest = rest[chunk_len..];90        while (rest.len != 0 and rest[0] == ' ') rest = rest[1..];91        first = false;92    }93}9495fn wrapLength(value: []const u8, width: usize) usize {96    if (value.len <= width) return value.len;97    var index = width;98    while (index > 0) : (index -= 1) {99        if (value[index] == ' ') return index;100    }101    return width;102}103104fn writeTrimmedLine(writer: *std.Io.Writer, line: []const u8) !void {105    var end = line.len;106    while (end > 0 and line[end - 1] == ' ') end -= 1;107    try output.writeDocText(writer, line[0..end]);108    try output.writeDocHardline(writer);109}110111test "scan text renders rich table oracle shape" {112    var arena = std.heap.ArenaAllocator.init(std.testing.allocator);113    defer arena.deinit();114    const allocator = arena.allocator();115    var stats = scan.Stats{116        .files = 1,117        .nodes_added = 4,118        .nodes_removed = 4,119        .edges_added = 4,120        .skipped_edges = 1,121    };122    try stats.lang_counts.append(allocator, .{ .name = "Python", .count = 1 });123    try stats.skipped_edge_categories.append(allocator, .{ .name = "external_or_generated", .count = 1 });124    try stats.skipped_edge_samples.append(allocator, .{125        .source = "app",126        .rel = model.RelType.imports,127        .target = "os",128        .reason = "unresolved target",129        .category = "external_or_generated",130    });131    const rendered = try render(allocator, stats, false);132    try std.testing.expectEqualStrings(133        \\Scanned 1 files (1 Python)134        \\Nodes                        +4 -4135        \\Edges                        4136        \\Skipped                      1 unresolved137        \\Skipped by kind              1 external_or_generated138        \\Hint: external_or_generated  External or generated dependency; widen scan scope139        \\                             only if this target is first-party code.140        \\Skipped edge examples hidden; use --full to show samples.141        \\142    , rendered);143}