@phuc1403/musketeer 0.12.0 → 0.14.0

package/template/.claude/skills/logical-components/scripts/LogicalComponents/PlainText.cs

@@ -1,55 +0,0 @@
-using System.Globalization;
-using System.Text;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// The unicode rule shared by every short string an agent hands back that is stored verbatim or shown at a review
-/// gate: a classify verdict's <c>reason</c> (<see cref="ClassifyMergeCommand"/>) and a responsibility's <c>text</c>
-/// (<see cref="ResponsibilityValidation"/>). Neither may contain a character that could hide something from a
-/// reviewer or a renderer - a bidi override, a zero-width character, or one that fakes a line break.
-/// </summary>
-public static class PlainText
-{
-    /// <summary>
-    /// True for text containing a Unicode category that must never appear in plain text stored or shown verbatim:
-    /// control (Cc), format (Cf - includes bidi overrides like U+202E and zero-width characters), line/paragraph
-    /// separators (Zl/Zp - could fake a second line), private-use (Co), or a lone surrogate (Cs).
-    /// </summary>
-    public static bool HasDisallowedUnicode(string text)
-    {
-        for (var i = 0; i < text.Length; i++)
-        {
-            var c = text[i];
-            if (char.IsHighSurrogate(c))
-            {
-                if (i + 1 >= text.Length || !char.IsLowSurrogate(text[i + 1]))
-                {
-                    return true; // lone high surrogate
-                }
-
-                if (IsBannedCategory(Rune.GetUnicodeCategory(new Rune(c, text[i + 1]))))
-                {
-                    return true;
-                }
-
-                i++;
-                continue;
-            }
-
-            if (char.IsLowSurrogate(c) || IsDisallowed(c))
-            {
-                return true;
-            }
-        }
-
-        return false;
-    }
-
-    /// <summary>True for one UTF-16 code unit in a category <see cref="HasDisallowedUnicode"/> rejects.</summary>
-    public static bool IsDisallowed(char c) => IsBannedCategory(CharUnicodeInfo.GetUnicodeCategory(c));
-
-    private static bool IsBannedCategory(UnicodeCategory category) => category is UnicodeCategory.Control
-        or UnicodeCategory.Format or UnicodeCategory.LineSeparator or UnicodeCategory.ParagraphSeparator
-        or UnicodeCategory.PrivateUse or UnicodeCategory.Surrogate;
-}

package/template/.claude/skills/logical-components/scripts/LogicalComponents/PortResolution.cs

@@ -1,75 +0,0 @@
-using Microsoft.CodeAnalysis;
-using Microsoft.CodeAnalysis.FindSymbols;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// Maps a seam (an interface or abstract class) to the concrete classes behind it in the loaded solution. Test
-/// projects were removed at load time, so test doubles never appear. Asking the type system rather than parsing DI
-/// registrations covers every registration style (instance, factory, forwarding) at once.
-/// A constructed generic seam (<c>IHandler&lt;Order&gt;</c>) resolves only to classes implementing exactly that construction,
-/// or an open generic one (<c>LoggingHandler&lt;T&gt; : IHandler&lt;T&gt;</c>). Results are cached per construction and sorted.
-/// </summary>
-public sealed class PortResolution(Solution solution)
-{
-    private readonly Dictionary<string, IReadOnlyList<INamedTypeSymbol>> _cache = new(StringComparer.Ordinal);
-
-    public async Task<IReadOnlyList<INamedTypeSymbol>> ImplementationsAsync(
-        INamedTypeSymbol seam, CancellationToken cancellationToken)
-    {
-        var key = Display(seam);
-        if (_cache.TryGetValue(key, out var cached))
-        {
-            return cached;
-        }
-
-        var definition = seam.OriginalDefinition;
-        IEnumerable<INamedTypeSymbol> found = definition.TypeKind == TypeKind.Interface
-            ? (await SymbolFinder.FindImplementationsAsync(definition, solution, cancellationToken: cancellationToken))
-                .OfType<INamedTypeSymbol>()
-            : await SymbolFinder.FindDerivedClassesAsync(definition, solution, transitive: true, cancellationToken: cancellationToken);
-
-        var implementations = found
-            .Where(t => t.TypeKind == TypeKind.Class && !t.IsAbstract)
-            .Select(t => t.OriginalDefinition)
-            .Where(t => ImplementsConstruction(t, seam))
-            .DistinctBy(SymbolNames.FullName)
-            .OrderBy(SymbolNames.FullName, StringComparer.Ordinal)
-            .ToList();
-        _cache[key] = implementations;
-        return implementations;
-    }
-
-    private static bool ImplementsConstruction(INamedTypeSymbol implementation, INamedTypeSymbol seam)
-    {
-        if (!seam.IsGenericType || seam.TypeArguments.All(a => a is ITypeParameterSymbol))
-        {
-            return true;
-        }
-
-        var definition = SymbolNames.FullName(seam.OriginalDefinition);
-        var wanted = Display(seam);
-        return Supertypes(implementation, seam.TypeKind).Any(s =>
-            SymbolNames.FullName(s.OriginalDefinition) == definition
-            && (Display(s) == wanted || s.TypeArguments.Any(a => a is ITypeParameterSymbol)));
-    }
-
-    private static IEnumerable<INamedTypeSymbol> Supertypes(INamedTypeSymbol type, TypeKind seamKind)
-    {
-        if (seamKind == TypeKind.Interface)
-        {
-            return type.AllInterfaces;
-        }
-
-        var bases = new List<INamedTypeSymbol>();
-        for (var current = type.BaseType; current is not null; current = current.BaseType)
-        {
-            bases.Add(current);
-        }
-
-        return bases;
-    }
-
-    // Compared as text: symbols of the same type seen from two projects' compilations are not always the same instance.
-    private static string Display(ITypeSymbol type) => type.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat);
-}

package/template/.claude/skills/logical-components/scripts/LogicalComponents/Program.cs

@@ -1,27 +0,0 @@
-using LogicalComponents;
-
-// Entry point: dispatches to one command per pipeline step. Anything unknown prints usage and exits 1.
-// candidates, extract and render report on stderr (their artifact is a file); the others report on stdout.
-return args switch
-{
-    ["candidates", .. var rest] => await CandidatesCommand.RunAsync(rest, Console.Error),
-    ["classify-batches", .. var rest] => await ClassifyBatchesCommand.RunAsync(rest, Console.Out),
-    ["classify-merge", .. var rest] => await ClassifyMergeCommand.RunAsync(rest, Console.Out),
-    ["extract", .. var rest] => await ExtractCommand.RunAsync(rest, Console.Error),
-    ["batches", .. var rest] => await BatchesCommand.RunAsync(rest, Console.Out),
-    ["prune", .. var rest] => await PruneCommand.RunAsync(rest, Console.Out),
-    ["render", .. var rest] => await RenderCommand.RunAsync(rest, Console.Error),
-    _ => PrintUsage(),
-};
-
-static int PrintUsage()
-{
-    Console.Error.WriteLine(CandidatesCommand.Usage);
-    Console.Error.WriteLine(ClassifyBatchesCommand.Usage);
-    Console.Error.WriteLine(ClassifyMergeCommand.Usage);
-    Console.Error.WriteLine(ExtractCommand.Usage);
-    Console.Error.WriteLine(BatchesCommand.Usage);
-    Console.Error.WriteLine(PruneCommand.Usage);
-    Console.Error.WriteLine(RenderCommand.Usage);
-    return 1;
-}

package/template/.claude/skills/logical-components/scripts/LogicalComponents/ProjectFilters.cs

@@ -1,77 +0,0 @@
-using System.Text.RegularExpressions;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// Pure rules for which loaded projects the extractor keeps: no test projects, and one project per
-/// multi-targeted csproj. Kept free of Roslyn types so they are unit-testable from plain strings.
-/// </summary>
-public static partial class ProjectFilters
-{
-    /// <summary>
-    /// A test project lives under a <c>tests</c>/<c>test</c> folder, is named like one
-    /// (<c>.Tests</c>, <c>.UnitTests</c>, <c>.IntegrationTests</c>, <c>.Test</c>, <c>.Specs</c>), or its project
-    /// file carries a test marker (test SDK, <c>IsTestProject</c>, or a test-framework package).
-    /// Test-support libraries such as <c>Foo.Testing</c> are deliberately kept: nothing here can tell them apart
-    /// from source, and their types can be excluded through config.
-    /// </summary>
-    public static bool IsTestProject(string relativePath, string projectFileText)
-    {
-        var segments = relativePath.Split('/', '\\');
-        if (segments.Any(s => s.Equals("tests", StringComparison.OrdinalIgnoreCase)
-                || s.Equals("test", StringComparison.OrdinalIgnoreCase)))
-        {
-            return true;
-        }
-
-        return TestProjectName().IsMatch(Path.GetFileNameWithoutExtension(relativePath))
-            || TestProjectMarker().IsMatch(projectFileText);
-    }
-
-    /// <summary>
-    /// Orders the target framework in a loaded multi-target project name such as <c>Foo(net10.0)</c>.
-    /// Families rank .NET Framework &lt; netstandard &lt; netcoreapp &lt; net5+; versions order within a family.
-    /// </summary>
-    public static (int Family, Version Version) TargetFrameworkRank(string loadedProjectName)
-    {
-        var match = TargetFrameworkSuffix().Match(loadedProjectName);
-        if (!match.Success)
-        {
-            return (0, new Version(0, 0));
-        }
-
-        // Drop an OS suffix: net9.0-windows ranks as net9.0.
-        var tfm = match.Groups["tfm"].Value.ToLowerInvariant().Split('-')[0];
-        return tfm switch
-        {
-            _ when tfm.StartsWith("netstandard") => (1, ParseVersion(tfm["netstandard".Length..])),
-            _ when tfm.StartsWith("netcoreapp") => (2, ParseVersion(tfm["netcoreapp".Length..])),
-            _ when tfm.Contains('.') => (3, ParseVersion(tfm["net".Length..])),
-            // .NET Framework monikers pack the version into digits: net472 is 4.7.2.
-            _ => (0, ParseVersion(string.Join('.', tfm["net".Length..].ToCharArray()))),
-        };
-    }
-
-    /// <summary><c>Foo(net10.0)</c> becomes <c>Foo</c>; a name without a framework suffix is returned as-is.</summary>
-    public static string StripTargetFramework(string loadedProjectName)
-    {
-        var match = TargetFrameworkSuffix().Match(loadedProjectName);
-        return match.Success ? match.Groups["name"].Value : loadedProjectName;
-    }
-
-    private static Version ParseVersion(string text) =>
-        Version.TryParse(text.Contains('.') ? text : text + ".0", out var version) ? version : new Version(0, 0);
-
-    // Segment-based and case-sensitive on purpose: "Foo.Contest", "Latest.Feeds", "Net.SpeedTest" and
-    // "Experiments.ABTest" must not look like test projects; only these exact last-segment suffixes do.
-    [GeneratedRegex(@"\.(Test|Tests|UnitTests|IntegrationTests|FunctionalTests|Spec|Specs)$")]
-    private static partial Regex TestProjectName();
-
-    [GeneratedRegex(
-        @"<IsTestProject>\s*true\s*</IsTestProject>|Sdk=""MSTest\.Sdk|Include=""(Microsoft\.NET\.Test\.Sdk|xunit|xunit\.v3|xunit\.core|xunit\.v3\.core|NUnit|MSTest|MSTest\.TestFramework|Microsoft\.Testing\.Platform)""",
-        RegexOptions.IgnoreCase)]
-    private static partial Regex TestProjectMarker();
-
-    [GeneratedRegex(@"^(?<name>.+)\((?<tfm>net[^)]*)\)$")]
-    private static partial Regex TargetFrameworkSuffix();
-}

package/template/.claude/skills/logical-components/scripts/LogicalComponents/PruneCommand.cs

@@ -1,164 +0,0 @@
-using System.Text.Json;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// <c>prune --resp &lt;dir&gt; --verify &lt;dir&gt; --out &lt;dir&gt;</c>: applies the verifier agents' verdicts. For every
-/// <c>resp/batch-NN.json</c> it reads <c>verify/batch-NN.json</c> — <c>{ "&lt;id&gt;": [ { "item": 1, "supported": true,
-/// "reason": "..." } ] }</c> — and writes the batch without its unsupported items to <c>--out</c>. The agents' files are
-/// never edited, so pruning is repeatable. Every item needs exactly one verdict: an unjudged claim is not verified, a
-/// null verdict entry or one missing <c>supported</c> is malformed (never silently "not supported"), so any gap or
-/// malformed entry fails the step (exit 3) before anything is written. Exit codes: 0 written, 1 usage, 3 verdicts
-/// incomplete or malformed.
-/// </summary>
-public static class PruneCommand
-{
-    public const string Usage = "usage: LogicalComponents prune --resp <dir> --verify <dir> --out <dir>";
-
-    public sealed record Verdict(int Item, bool Supported, string? Reason);
-
-    // Supported is nullable only for reading: a verifier file missing it, or a null array entry, is malformed input
-    // (exit 3) rather than a silent "not supported". Verdict above keeps Supported non-nullable for every other use,
-    // once ReadVerdicts has confirmed it is actually there.
-    private sealed record RawVerdict(int Item, bool? Supported, string? Reason);
-
-    private static readonly JsonSerializerOptions ReadOptions = new()
-    {
-        PropertyNameCaseInsensitive = true,
-        ReadCommentHandling = JsonCommentHandling.Skip,
-        AllowTrailingCommas = true,
-        AllowDuplicateProperties = false,
-    };
-
-    public static async Task<int> RunAsync(string[] args, TextWriter output)
-    {
-        if (args is not ["--resp", var respDir, "--verify", var verifyDir, "--out", var outDir]
-            || !Directory.Exists(respDir) || !Directory.Exists(verifyDir))
-        {
-            await output.WriteLineAsync(Usage);
-            return 1;
-        }
-
-        var problems = new List<string>();
-        var pruned = new List<(string File, SortedDictionary<string, List<Responsibility>> Kept)>();
-        var removed = new List<string>();
-        var emptied = new List<string>();
-
-        foreach (var respFile in Directory.EnumerateFiles(respDir, "batch-*.json").Order(StringComparer.Ordinal))
-        {
-            var name = Path.GetFileName(respFile);
-            var batch = ResponsibilityBatches.Load([respFile], ReadOptions);
-            problems.AddRange(batch.Problems);
-            var verdicts = ReadVerdicts(Path.Combine(verifyDir, name), name, problems);
-            if (verdicts is null)
-            {
-                continue;
-            }
-
-            var kept = new SortedDictionary<string, List<Responsibility>>(StringComparer.Ordinal);
-            foreach (var (id, items) in batch.Responsibilities.OrderBy(r => r.Key, StringComparer.Ordinal))
-            {
-                var judged = verdicts.GetValueOrDefault(id) ?? [];
-                problems.AddRange(judged.Where(v => v.Item < 1 || v.Item > items.Count)
-                    .Select(v => $"{id}[{v.Item}]: verdict for an item that does not exist ({name})"));
-
-                kept[id] = [];
-                for (var item = 1; item <= items.Count; item++)
-                {
-                    var forItem = judged.Where(v => v.Item == item).ToList();
-                    if (forItem.Count != 1)
-                    {
-                        problems.Add($"{id}[{item}]: {(forItem.Count == 0 ? "no verdict" : "more than one verdict")} ({name})");
-                    }
-                    else if (forItem[0].Supported)
-                    {
-                        kept[id].Add(items[item - 1]);
-                    }
-                    else
-                    {
-                        removed.Add($"removed {id}[{item}]: {forItem[0].Reason ?? "(no reason given)"}");
-                    }
-                }
-
-                if (items.Count > 0 && kept[id].Count == 0)
-                {
-                    emptied.Add($"empty {id}: every responsibility was unsupported");
-                }
-            }
-
-            problems.AddRange(verdicts.Keys.Where(id => !batch.Responsibilities.ContainsKey(id))
-                .Order(StringComparer.Ordinal)
-                .Select(id => $"{id}: verdicts for a component the batch does not answer ({name})"));
-            pruned.Add((name, kept));
-        }
-
-        if (problems.Count > 0)
-        {
-            foreach (var problem in problems)
-            {
-                await output.WriteLineAsync(problem);
-            }
-
-            return 3;
-        }
-
-        Directory.CreateDirectory(outDir);
-        foreach (var (file, kept) in pruned)
-        {
-            await File.WriteAllBytesAsync(Path.Combine(outDir, file), ComponentsFile.ToJson(kept));
-        }
-
-        foreach (var line in removed.Concat(emptied))
-        {
-            await output.WriteLineAsync(line);
-        }
-
-        await output.WriteLineAsync($"{removed.Count} removed, {emptied.Count} empty");
-        return 0;
-    }
-
-    private static Dictionary<string, List<Verdict>>? ReadVerdicts(string path, string name, List<string> problems)
-    {
-        if (!File.Exists(path))
-        {
-            problems.Add($"{name}: no verdict file");
-            return null;
-        }
-
-        Dictionary<string, List<RawVerdict?>?>? raw;
-        try
-        {
-            raw = JsonSerializer.Deserialize<Dictionary<string, List<RawVerdict?>?>>(File.ReadAllText(path), ReadOptions);
-        }
-        catch (Exception e) when (e is IOException or UnauthorizedAccessException or JsonException)
-        {
-            problems.Add($"{name}: not a valid verdict file ({e.Message})");
-            return null;
-        }
-
-        var clean = new Dictionary<string, List<Verdict>>(StringComparer.Ordinal);
-        foreach (var (id, items) in raw ?? [])
-        {
-            var kept = new List<Verdict>();
-            foreach (var verdict in items ?? [])
-            {
-                if (verdict is null)
-                {
-                    problems.Add($"{id}: a null verdict entry ({name})");
-                }
-                else if (verdict.Supported is not { } supported)
-                {
-                    problems.Add($"{id}[{verdict.Item}]: verdict is missing 'supported' ({name})");
-                }
-                else
-                {
-                    kept.Add(new Verdict(verdict.Item, supported, verdict.Reason));
-                }
-            }
-
-            clean[id] = kept;
-        }
-
-        return clean;
-    }
-}

package/template/.claude/skills/logical-components/scripts/LogicalComponents/RenderCommand.cs

@@ -1,234 +0,0 @@
-using System.Text;
-using System.Text.Json;
-using Microsoft.CodeAnalysis.Text;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// <c>render --components &lt;components.json&gt; --resp &lt;dir|file&gt;... --repo &lt;repoPath&gt; --out &lt;md&gt;</c>.
-/// Merges the agents' batch files (a directory means every <c>batch-*.json</c> in it, read in name order), validates them
-/// against the extraction and the repo's files, and writes the markdown only when everything is valid. The markdown is
-/// written to a temp file beside --out and renamed over it, so a failed or rejected run never deletes or corrupts
-/// whatever --out already held.
-/// Exit codes: 0 written; 1 usage; 2 inputs unusable (unreadable components.json, a missing path, components.json has
-/// no file-hash map from an old extract, a file the extraction cites changed or went missing since extract, an
-/// unwritable --out); 3 responsibilities rejected, every problem on stderr, --out left exactly as it was.
-/// </summary>
-public static class RenderCommand
-{
-    public const string Usage =
-        "usage: LogicalComponents render --components <components.json> --resp <dir|file>... --repo <repoPath> --out <md>";
-
-    private static readonly JsonSerializerOptions ReadOptions = new()
-    {
-        PropertyNameCaseInsensitive = true,
-        ReadCommentHandling = JsonCommentHandling.Skip,
-        AllowTrailingCommas = true,
-        // The same component twice in one file must not silently keep the last list.
-        AllowDuplicateProperties = false,
-    };
-
-    private sealed record Arguments(string Components, IReadOnlyList<string> Resp, string Repo, string Out);
-
-    public static async Task<int> RunAsync(string[] args, TextWriter errors)
-    {
-        var arguments = ParseArgs(args);
-        if (arguments is null)
-        {
-            await errors.WriteLineAsync(Usage);
-            return 1;
-        }
-
-        var extraction = await ReadExtractionAsync(arguments.Components, errors);
-        if (extraction is null)
-        {
-            return 2;
-        }
-
-        var missing = arguments.Resp.Where(p => !Directory.Exists(p) && !File.Exists(p))
-            .Concat(Directory.Exists(arguments.Repo) ? [] : [arguments.Repo])
-            .ToList();
-        if (missing.Count > 0)
-        {
-            await errors.WriteLineAsync($"Not found: {string.Join(", ", missing)}");
-            return 2;
-        }
-
-        // Checked before any citation: a repo that no longer matches components.json is not the agents' fault.
-        if (extraction.FileHashes is null)
-        {
-            await errors.WriteLineAsync($"{arguments.Components} has no file hashes (from an old extract); re-run extract");
-            return 2;
-        }
-
-        var changed = ChangedFiles(extraction.FileHashes, arguments.Repo);
-        if (changed.Count > 0)
-        {
-            foreach (var file in changed)
-            {
-                await errors.WriteLineAsync($"{file}: changed since extract");
-            }
-
-            return 2;
-        }
-
-        var sourceLines = ReadSourceLines(extraction, arguments.Repo, out var missingSources);
-        if (missingSources.Count > 0)
-        {
-            // Defensive only: every span/reaches file is already covered by the file-hash check above.
-            await errors.WriteLineAsync(
-                $"The repo does not match components.json (re-run extract); missing: {string.Join(", ", missingSources)}");
-            return 2;
-        }
-
-        var batches = ResponsibilityBatches.Load(arguments.Resp, ReadOptions);
-        var problems = batches.Problems
-            .Concat(ResponsibilityValidation.Validate(extraction, batches.Responsibilities, sourceLines, batches.FileOf))
-            .ToList();
-        if (problems.Count > 0)
-        {
-            foreach (var problem in problems)
-            {
-                await errors.WriteLineAsync(problem);
-            }
-
-            // A rejected run is the agents' problem, not the user's: an --out from an earlier successful run is left
-            // exactly as it was, so a failed retry can never look like data loss.
-            return 3;
-        }
-
-        return await WriteAsync(arguments.Out, extraction, batches.Responsibilities, errors);
-    }
-
-    /// <summary>
-    /// Writes the markdown to a temp file beside <paramref name="outPath"/> and renames it over the target only once
-    /// the write succeeds, so a failure (disk full, an unwritable path) never leaves a partial or truncated --out, and
-    /// never touches whatever was already there.
-    /// </summary>
-    private static async Task<int> WriteAsync(
-        string outPath, ExtractResult extraction, IReadOnlyDictionary<string, IReadOnlyList<Responsibility>> responsibilities,
-        TextWriter errors)
-    {
-        var fullPath = Path.GetFullPath(outPath);
-        var directory = Path.GetDirectoryName(fullPath)!;
-        var temp = Path.Combine(directory, $".{Path.GetFileName(fullPath)}.{Guid.NewGuid():N}.tmp");
-        try
-        {
-            Directory.CreateDirectory(directory);
-            var markdown = MarkdownRenderer.Render(extraction, responsibilities);
-            await File.WriteAllBytesAsync(temp, new UTF8Encoding(encoderShouldEmitUTF8Identifier: false).GetBytes(markdown));
-            File.Move(temp, outPath, overwrite: true);
-            return 0;
-        }
-        catch (Exception e) when (e is IOException or UnauthorizedAccessException)
-        {
-            await errors.WriteLineAsync($"Cannot write {outPath}: {e.Message}");
-            return 2;
-        }
-        finally
-        {
-            if (File.Exists(temp))
-            {
-                File.Delete(temp);
-            }
-        }
-    }
-
-    /// <summary>Every file in <paramref name="hashes"/> whose current content hash differs, in file order, or that is missing.</summary>
-    private static List<string> ChangedFiles(IReadOnlyDictionary<string, string> hashes, string repo) =>
-        hashes.OrderBy(h => h.Key, StringComparer.Ordinal)
-            .Where(h => IsChanged(Path.Combine(repo, h.Key), h.Value))
-            .Select(h => h.Key)
-            .ToList();
-
-    private static bool IsChanged(string path, string expectedHash)
-    {
-        try
-        {
-            return !File.Exists(path) || ComponentsFile.HashFile(path) != expectedHash;
-        }
-        catch (Exception e) when (e is IOException or UnauthorizedAccessException)
-        {
-            // Became unreadable between the existence check and the hash read: treat it the same as changed, since
-            // render cannot trust an uncheckable citation either.
-            return true;
-        }
-    }
-
-    private static async Task<ExtractResult?> ReadExtractionAsync(string path, TextWriter errors)
-    {
-        try
-        {
-            var extraction = ComponentsFile.Deserialize(await File.ReadAllBytesAsync(path));
-            // Deserialization leaves absent lists null despite the non-nullable types: `{}` is not a components.json.
-            if (extraction.Components is not null && extraction.ExternalNodes is not null
-                && extraction.Edges is not null && extraction.Warnings is not null)
-            {
-                return extraction;
-            }
-
-            await errors.WriteLineAsync($"{path} is not a components.json written by extract");
-        }
-        catch (Exception e) when (e is IOException or UnauthorizedAccessException or JsonException)
-        {
-            await errors.WriteLineAsync($"Cannot read {path}: {e.Message}");
-        }
-
-        return null;
-    }
-
-    /// <summary>
-    /// The lines of every file a component is declared in, split the way Roslyn splits them (so U+2028 and friends count
-    /// exactly as they did when extract measured the spans). Files missing from the repo are reported, not read.
-    /// </summary>
-    private static Dictionary<string, IReadOnlyList<string>> ReadSourceLines(
-        ExtractResult extraction, string repo, out List<string> missing)
-    {
-        var lines = new Dictionary<string, IReadOnlyList<string>>(StringComparer.Ordinal);
-        missing = [];
-        var files = extraction.Components.SelectMany(c => c.Spans.Concat(c.Reaches ?? []).Select(s => s.File));
-        foreach (var file in files.Distinct().Order(StringComparer.Ordinal))
-        {
-            var path = Path.Combine(repo, file);
-            if (!File.Exists(path))
-            {
-                missing.Add(file);
-                continue;
-            }
-
-            var text = SourceText.From(File.ReadAllText(path));
-            lines[file] = text.Lines.Select(l => text.ToString(l.Span)).ToList();
-        }
-
-        return lines;
-    }
-
-    /// <summary>Each flag exactly once; <c>--resp</c> takes every following value up to the next flag.</summary>
-    private static Arguments? ParseArgs(string[] args)
-    {
-        var values = new Dictionary<string, List<string>>(StringComparer.Ordinal);
-        for (var i = 0; i < args.Length; i++)
-        {
-            var flag = args[i];
-            if (flag is not ("--components" or "--resp" or "--repo" or "--out") || values.ContainsKey(flag))
-            {
-                return null;
-            }
-
-            var taken = new List<string>();
-            while (i + 1 < args.Length && !args[i + 1].StartsWith("--", StringComparison.Ordinal))
-            {
-                taken.Add(args[++i]);
-            }
-
-            values[flag] = taken;
-        }
-
-        string? Single(string flag) => values.TryGetValue(flag, out var v) && v.Count == 1 ? v[0] : null;
-        var resp = values.GetValueOrDefault("--resp") ?? [];
-        return Single("--components") is { } components && Single("--repo") is { } repo && Single("--out") is { } output
-               && resp.Count > 0
-            ? new Arguments(components, resp, repo, output)
-            : null;
-    }
-}