@phuc1403/musketeer 0.12.1 → 0.15.0

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

@@ -1,87 +0,0 @@
-namespace LogicalComponents;
-
-/// <summary>
-/// <c>extract &lt;repoPath&gt; [--out &lt;components.json&gt;] [--solution &lt;file&gt;]</c>: loads the repo and writes the
-/// deterministic extraction, including a hash of every cited file's content (see <see cref="FileHashes"/>) so
-/// <c>render</c> can tell whether the repo changed since. <c>--solution</c> picks the solution file as in
-/// <c>candidates</c>. Progress and warnings go to <c>errors</c> (stderr); the artifact goes to the --out file.
-/// Exit codes: 0 written, 1 usage, 2 the target repo or its config could not be loaded, 4 candidates not classified
-/// in the repo config yet (one <c>unclassified &lt;type&gt;</c> line each; nothing is written).
-/// </summary>
-public static class ExtractCommand
-{
-    public const string Usage =
-        "usage: LogicalComponents extract <repoPath> [--out <components.json>] [--solution <file>]";
-
-    public static async Task<int> RunAsync(string[] args, TextWriter errors)
-    {
-        if (args is not [var repoPath, ..]
-            || !CandidatesCommand.TryParseOptions(args[1..], "components.json", out var outPath, out var solution))
-        {
-            await errors.WriteLineAsync(Usage);
-            return 1;
-        }
-
-        try
-        {
-            using var loaded = await WorkspaceLoader.LoadAsync(repoPath, solution: solution, log: errors);
-            await errors.WriteLineAsync($"Loaded {loaded.ProjectNames.Count} projects from {loaded.Source}.");
-
-            var extracted = await CouplingResolver.ExtractAsync(loaded, ExtractConfig.Load(loaded.RepoRoot));
-            var result = extracted with { FileHashes = FileHashes(loaded.RepoRoot, extracted) };
-            foreach (var warning in result.Warnings)
-            {
-                await errors.WriteLineAsync($"warning: {warning}");
-            }
-
-            Directory.CreateDirectory(Path.GetDirectoryName(Path.GetFullPath(outPath))!);
-            await File.WriteAllBytesAsync(outPath, ComponentsFile.Serialize(result));
-            await errors.WriteLineAsync(
-                $"{result.Components.Count} components, {result.ExternalNodes.Count} ports, {result.Edges.Count} edges, "
-                + $"{result.Warnings.Count} warnings -> {Path.GetFullPath(outPath)}");
-            return 0;
-        }
-        catch (UnclassifiedCandidatesException e)
-        {
-            foreach (var type in e.Types)
-            {
-                await errors.WriteLineAsync($"unclassified {type}");
-            }
-
-            await errors.WriteLineAsync($"{e.Message}: run the classify step, review it, then extract again.");
-            return 4;
-        }
-        catch (Exception e) when (e is DirectoryNotFoundException or WorkspaceLoadException or ExtractConfigException)
-        {
-            await errors.WriteLineAsync(e.Message);
-            return 2;
-        }
-        catch (Exception e)
-        {
-            // Anything else (I/O, access, build host) is still a load failure: report it, don't crash with a stack trace.
-            await errors.WriteLineAsync($"Unexpected error while extracting {repoPath}: {e.Message}");
-            return 2;
-        }
-    }
-
-    /// <summary>
-    /// A repo-relative-file → content-hash map (see <see cref="ComponentsFile.HashFile"/>) for every file any component's
-    /// spans, reaches or outgoing edge citations point into, so <c>render</c> can later tell whether the repo changed.
-    /// </summary>
-    private static IReadOnlyDictionary<string, string> FileHashes(string repoRoot, ExtractResult result)
-    {
-        var files = result.Components
-            .SelectMany(c => c.Spans.Concat(c.Reaches ?? []).Select(s => s.File))
-            .Concat(result.Edges.Select(e => Citation.Parse(e.At)?.File).OfType<string>())
-            .Distinct(StringComparer.Ordinal)
-            .Order(StringComparer.Ordinal);
-
-        var hashes = new SortedDictionary<string, string>(StringComparer.Ordinal);
-        foreach (var file in files)
-        {
-            hashes[file] = ComponentsFile.HashFile(Path.Combine(repoRoot, file));
-        }
-
-        return hashes;
-    }
-}

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

@@ -1,79 +0,0 @@
-using System.Text.Json;
-using System.Text.Json.Serialization;
-
-namespace LogicalComponents;
-
-/// <summary>A config file in the target repo that could not be read, or contradicts itself.</summary>
-public sealed class ExtractConfigException(string message) : Exception(message);
-
-/// <summary>Candidates the repo config does not classify yet: extract refuses to guess.</summary>
-public sealed class UnclassifiedCandidatesException(IReadOnlyList<string> types)
-    : Exception($"{types.Count} candidate(s) not classified in {ExtractConfig.FileName}")
-{
-    public IReadOnlyList<string> Types { get; } = types;
-}
-
-/// <summary>
-/// The frozen classification in <c>logical-components.json</c> at the repo root: every candidate class is listed, by
-/// full metadata name, either as a component or as a helper (with the reason it is not a component). An LLM proposes
-/// the entries once and a person reviews them; extract only ever reads this file, so the same code and the same file
-/// always give the same components.
-/// </summary>
-public sealed record ExtractConfig(IReadOnlyList<string> Components, IReadOnlyDictionary<string, string> Helpers)
-{
-    public const string FileName = "logical-components.json";
-
-    public static ExtractConfig Empty { get; } = new([], new Dictionary<string, string>());
-
-    private static readonly JsonSerializerOptions Options = new()
-    {
-        PropertyNameCaseInsensitive = true,
-        ReadCommentHandling = JsonCommentHandling.Skip,
-        AllowTrailingCommas = true,
-        // A misspelt key ("helper") must fail rather than silently classify nothing.
-        UnmappedMemberHandling = JsonUnmappedMemberHandling.Disallow,
-    };
-
-    public bool IsClassified(string fullName) => Helpers.ContainsKey(fullName) || Components.Contains(fullName);
-
-    public static ExtractConfig Load(string repoRoot)
-    {
-        var path = Path.Combine(repoRoot, FileName);
-        if (!File.Exists(path))
-        {
-            return Empty;
-        }
-
-        ConfigFile? file;
-        try
-        {
-            file = JsonSerializer.Deserialize<ConfigFile>(File.ReadAllText(path), Options);
-        }
-        catch (JsonException e)
-        {
-            throw new ExtractConfigException($"Invalid {FileName}: {e.Message}");
-        }
-
-        if (file?.Exclude is not null || file?.Include is not null)
-        {
-            throw new ExtractConfigException(
-                $"Invalid {FileName}: 'exclude'/'include' were replaced by 'components' and 'helpers' "
-                + "(full type names); re-run the classify step to regenerate it.");
-        }
-
-        var components = file?.Components ?? [];
-        var helpers = file?.Helpers ?? [];
-        var both = components.Where(helpers.ContainsKey).Distinct().Order(StringComparer.Ordinal).ToList();
-        if (both.Count > 0)
-        {
-            throw new ExtractConfigException(
-                $"Invalid {FileName}: {string.Join(", ", both.Select(n => $"'{n}'"))} is in both components and helpers.");
-        }
-
-        return new ExtractConfig(components, helpers);
-    }
-
-    // Exclude and Include are read only to reject a file written for the old format with a useful message.
-    private sealed record ConfigFile(
-        string[]? Components, Dictionary<string, string>? Helpers, string[]? Exclude, string[]? Include);
-}

package/template/.claude/skills/logical-components/scripts/LogicalComponents/LogicalComponents.csproj

@@ -1,15 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <TargetFramework>net10.0</TargetFramework>
-    <OutputType>Exe</OutputType>
-    <Nullable>enable</Nullable>
-    <ImplicitUsings>enable</ImplicitUsings>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="5.9.0" />
-    <PackageReference Include="Microsoft.CodeAnalysis.Workspaces.MSBuild" Version="5.9.0" />
-  </ItemGroup>
-
-</Project>

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

@@ -1,72 +0,0 @@
-using System.Text;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// CommonMark code-span parsing for <see cref="ResponsibilityValidation"/>'s plain-text check: a backtick run of
-/// length n opens a code span, which closes at the next run of exactly length n (a run of a different length inside is
-/// literal content; a run with no matching close is an unclosed delimiter, not a span). A naive `` `[^`]*` `` match
-/// gets this wrong for an escaped or mismatched backtick, which could let HTML or a link hide inside what looks like,
-/// but is not, a real code span.
-/// </summary>
-public static class MarkdownCodeSpans
-{
-    /// <summary>The text with every real code span removed, and whether any backtick run was left unmatched.</summary>
-    public static (string Outside, bool Unclosed) Strip(string text)
-    {
-        var outside = new StringBuilder();
-        var unclosed = false;
-        var i = 0;
-        while (i < text.Length)
-        {
-            if (text[i] != '`')
-            {
-                outside.Append(text[i]);
-                i++;
-                continue;
-            }
-
-            var openStart = i;
-            while (i < text.Length && text[i] == '`')
-            {
-                i++;
-            }
-
-            var openLength = i - openStart;
-            var closeStart = -1;
-            var j = i;
-            while (j < text.Length)
-            {
-                if (text[j] != '`')
-                {
-                    j++;
-                    continue;
-                }
-
-                var runStart = j;
-                while (j < text.Length && text[j] == '`')
-                {
-                    j++;
-                }
-
-                if (j - runStart == openLength)
-                {
-                    closeStart = runStart;
-                    break;
-                }
-            }
-
-            if (closeStart >= 0)
-            {
-                i = closeStart + openLength;
-            }
-            else
-            {
-                unclosed = true;
-                outside.Append('`', openLength);
-            }
-        }
-
-        return (outside.ToString(), unclosed);
-    }
-}

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

@@ -1,78 +0,0 @@
-using System.Text;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// Writes the final document: <c># Logical Components</c> (one section per component, sorted by display name, each
-/// responsibility with its citation) and <c># Coupling</c> (a legend, then a Mermaid flowchart of the extracted edges).
-/// Everything but the responsibility text comes from the deterministic extraction; the output has LF line endings and no
-/// timestamp.
-/// Call only with responsibilities that passed <see cref="ResponsibilityValidation"/>.
-/// </summary>
-public static class MarkdownRenderer
-{
-    /// <summary>
-    /// How to read the diagram, so incoming and outgoing arrows are not read backwards, and what it leaves out, so an
-    /// entry point with no incoming arrow is not mistaken for dead code.
-    /// </summary>
-    private const string Legend =
-        "`A --> B` means A depends on B: it calls, creates, holds or inherits from B. A component's incoming arrows are its "
-        + "afferent coupling, its outgoing arrows its efferent coupling. Only components in `*.Application` and "
-        + "`*.Infrastructure` projects are drawn; callers in other projects, such as the host, are not shown.";
-
-    public static string Render(
-        ExtractResult extraction, IReadOnlyDictionary<string, IReadOnlyList<Responsibility>> responsibilities)
-    {
-        var md = new StringBuilder();
-        md.Append("# Logical Components\n\n");
-        foreach (var component in extraction.Components
-                     .OrderBy(c => c.Name, StringComparer.Ordinal)
-                     .ThenBy(c => c.Id, StringComparer.Ordinal))
-        {
-            md.Append($"## {component.Name}\n\n");
-            md.Append($"`{SymbolNames.ReadableFullName(component.Type)}`\n\n");
-            foreach (var responsibility in responsibilities[component.Id])
-            {
-                md.Append($"- {responsibility.Text.Trim()} (`{Citation.Parse(responsibility.Cite)}`)\n");
-            }
-
-            md.Append('\n');
-        }
-
-        // ELK lays out a large flowchart far more readably than Mermaid's default dagre.
-        md.Append("# Coupling\n\n").Append(Legend).Append("\n\n```mermaid\n%%{init: {\"layout\": \"elk\"}}%%\nflowchart LR\n");
-        var nodes = extraction.Components
-            .Select(c => (c.Id, c.Name))
-            .Concat(extraction.ExternalNodes.Select(n => (n.Id, n.Name)))
-            .OrderBy(n => n.Id, StringComparer.Ordinal);
-        foreach (var (id, name) in nodes)
-        {
-            md.Append($"    {NodeId(id)}[\"{Escape(name)}\"]\n");
-        }
-
-        // A --> B: A depends on B (efferent for A, afferent for B). How A reaches B (di, new, static, inherits) is not
-        // drawn; it stays in components.json.
-        foreach (var edge in extraction.Edges)
-        {
-            md.Append($"    {NodeId(edge.From)} --> {NodeId(edge.To)}\n");
-        }
-
-        md.Append("```\n");
-        return md.ToString();
-    }
-
-    // Mermaid node labels are double-quoted; a literal quote is written as an entity. Angle brackets are escaped the
-    // same way: some renderers treat a label as HTML, and an unescaped `<` in a type or module name could otherwise
-    // inject markup into the diagram.
-    private static string Escape(string label) => label.Replace("\"", "#quot;").Replace("<", "#lt;").Replace(">", "#gt;");
-
-    /// <summary>
-    /// A Mermaid-safe node id: prefixed so a component called <c>end</c>, <c>graph</c> or <c>class</c> is never read as
-    /// a keyword, and every character that is not an ASCII letter or digit - including a literal underscore, so the
-    /// escape below cannot collide with one already in the id - is replaced by <c>_x{hex}_</c>. That makes the mapping
-    /// injective (two different ids always get two different node ids), unlike collapsing every such character to a
-    /// single <c>_</c>, which let ids as different as "My Module_Queue" and "My-Module.Queue" collide.
-    /// </summary>
-    private static string NodeId(string id) => "n_" + string.Concat(
-        id.Select(c => char.IsAsciiLetterOrDigit(c) ? c.ToString() : $"_x{(int)c:x}_"));
-}

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

@@ -1,272 +0,0 @@
-using System.Collections.Immutable;
-using Microsoft.CodeAnalysis;
-using Microsoft.CodeAnalysis.CSharp.Syntax;
-
-namespace LogicalComponents;
-
-/// <summary>
-/// Follows what a component's code uses until it lands on another component. A use of a member of:
-/// <list type="bullet">
-/// <item>a component is an edge to it;</item>
-/// <item>an interface or abstract class (a seam) goes on to the member that runs in each implementation of the
-/// construction used (see <see cref="SeamDispatch"/>);</item>
-/// <item>any other type of the repo (a helper, a record, a non-candidate) is seen through: the code that runs for that
-/// use is walked the same way, with the helper's type parameters bound to the use's type arguments (see
-/// <see cref="TypeMap"/>). It is walked per member and per accessor, so reading one property never couples to what
-/// another member or the setter calls, and compiler-written record members run nothing.</item>
-/// </list>
-/// Framework and library members end the walk. The kind of an edge is the kind of the last use; its citation is the
-/// line in the component where the chain starts; <c>via</c> names the seams and seen-through types on the first path
-/// found (members already walked for a component are not walked again). The helper code walked is the component's
-/// <c>reaches</c>.
-/// </summary>
-public sealed class MemberUseResolution(LoadedWorkspace loaded, IReadOnlySet<string> components, PortResolution ports)
-{
-    // How many seen-through hops one chain may follow before it is cut off with a warning: real helper chains never
-    // run this deep, but a generic helper that instantiates itself one level deeper at every hop (Nest<T> calling
-    // Nest<List<T>>) never revisits the same (member, bindings) pair, so the cycle guard below never catches it and the
-    // walk would otherwise recurse until the process stack overflows.
-    private const int MaxWalkDepth = 200;
-
-    public sealed record RawEdge(string From, string To, string Kind, IReadOnlyList<string> Via, string File, int Line);
-
-    /// <summary>
-    /// The edges a component's code leads to, the helper code it runs on the way (sorted, distinct), and warnings about
-    /// coupling the walk could not fully resolve.
-    /// </summary>
-    public sealed record Resolution(List<RawEdge> Edges, List<SourceSpan> Reaches, List<string> Warnings);
-
-    // Shared by every component's walk: what a piece of syntax uses never changes within one loaded solution.
-    private readonly Dictionary<SyntaxNode, List<MemberUses.MemberUse>> _uses = [];
-    private readonly Dictionary<INamedTypeSymbol, bool> _repoSource = new(SymbolEqualityComparer.Default);
-
-    /// <summary>
-    /// The edges from <paramref name="from"/> reached by <paramref name="uses"/>. <paramref name="self"/> holds the
-    /// component and the base classes whose code counts as its own: uses of those are not coupling. <paramref name="map"/>
-    /// binds the type parameters of any base class among <paramref name="uses"/>' declaring types to what the component
-    /// supplies as its base class construction, so a generic base's own seam calls resolve to the right construction.
-    /// </summary>
-    public async Task<Resolution> ResolveAsync(
-        string from, IReadOnlySet<string> self, IEnumerable<MemberUses.MemberUse> uses, TypeMap map,
-        CancellationToken cancellationToken)
-    {
-        var walk = new Walk(from, self);
-        foreach (var use in uses)
-        {
-            await ResolveUseAsync(use.Member, use.Kind, [], use.File, use.Line, map, walk, cancellationToken);
-        }
-
-        return new Resolution(
-            walk.Edges,
-            walk.Reaches.OrderBy(s => s.File, StringComparer.Ordinal).ThenBy(s => s.Start).ThenBy(s => s.End).ToList(),
-            walk.Warnings.Order(StringComparer.Ordinal).ToList());
-    }
-
-    // One component's walk: members already seen through (for the same type bindings) are not walked again, which also
-    // ends cycles. Depth guards the chains a cycle can't catch (see MaxWalkDepth).
-    private sealed class Walk(string from, IReadOnlySet<string> self)
-    {
-        public string From { get; } = from;
-        public IReadOnlySet<string> Self { get; } = self;
-        public HashSet<string> Visited { get; } = new(StringComparer.Ordinal);
-        public List<RawEdge> Edges { get; } = [];
-        public HashSet<SourceSpan> Reaches { get; } = [];
-        public HashSet<string> Warnings { get; } = new(StringComparer.Ordinal);
-        public int Depth { get; set; }
-
-        public void Warn(string message) => Warnings.Add(message);
-    }
-
-    private async Task ResolveUseAsync(
-        ISymbol member,
-        string kind,
-        ImmutableList<string> via,
-        string file,
-        int line,
-        TypeMap map,
-        Walk walk,
-        CancellationToken cancellationToken)
-    {
-        // A C# 14 extension member belongs to the static class around its extension block.
-        var declaring = member.ContainingType is { IsExtension: true } block ? block.ContainingType : member.ContainingType;
-        if (declaring is null)
-        {
-            return;
-        }
-
-        if (map.Substitute(declaring) is INamedTypeSymbol bound)
-        {
-            declaring = bound;
-        }
-
-        var owner = EdgeExtraction.Normalize(declaring.OriginalDefinition);
-        if (!IsRepo(owner) || walk.Self.Contains(SymbolNames.FullName(owner)))
-        {
-            return;
-        }
-
-        if (components.Contains(SymbolNames.FullName(owner)))
-        {
-            walk.Edges.Add(new RawEdge(walk.From, SymbolNames.FullName(owner), kind, via, file, line));
-            return;
-        }
-
-        if (EdgeExtraction.IsSeam(declaring) && !member.IsStatic && kind != EdgeExtraction.New)
-        {
-            // A concrete, non-virtual member of an abstract class cannot be overridden: it runs as written for every
-            // subclass (or none), so it is this walk's own behaviour rather than a per-implementation dispatch.
-            if (declaring.TypeKind == TypeKind.Class && !IsOverridable(member))
-            {
-                await SeeThroughAsync(member, kind, via.Add(SymbolNames.FullName(declaring)), file, line, map, walk, cancellationToken);
-                return;
-            }
-
-            var implementations = await ports.ImplementationsAsync(declaring, cancellationToken);
-            if (implementations.Count == 0 && declaring.TypeKind == TypeKind.Class)
-            {
-                walk.Warn($"{SymbolNames.FullName(declaring.OriginalDefinition)}.{member.Name} has no concrete subclass in the repo");
-            }
-
-            foreach (var implementation in implementations)
-            {
-                if (SeamDispatch.ImplementationOf(implementation, declaring, member) is not { } runs)
-                {
-                    continue;
-                }
-
-                // An inherited default body lives on the seam itself: walk it rather than resolve the seam again.
-                if (runs.ContainingType is { } runsIn && EdgeExtraction.IsSeam(runsIn))
-                {
-                    await SeeThroughAsync(runs, kind, via.Add(SymbolNames.FullName(declaring)), file, line, map, walk, cancellationToken);
-                }
-                else
-                {
-                    // Bind the implementation's own type parameters (an open-generic decorator) and the resolved
-                    // method's own type parameters (a generic method declared on the seam) to what this use actually
-                    // supplies, so a seam the implementation calls in turn resolves to the right construction too.
-                    var binding = SeamDispatch.BindingFor(implementation, declaring, member, runs, map);
-                    await ResolveUseAsync(runs, kind, via.Add(SymbolNames.FullName(declaring)), file, line, binding, walk, cancellationToken);
-                }
-            }
-
-            return;
-        }
-
-        await SeeThroughAsync(member, kind, via.Add(SymbolNames.FullName(owner)), file, line, map, walk, cancellationToken);
-    }
-
-    private async Task SeeThroughAsync(
-        ISymbol member,
-        string kind,
-        ImmutableList<string> via,
-        string file,
-        int line,
-        TypeMap map,
-        Walk walk,
-        CancellationToken cancellationToken)
-    {
-        // Compiler-written members (a record's ToString/Equals/Deconstruct, an auto-property accessor) run nothing of the
-        // type's own code; their declaring syntax is the whole type, which must not be walked. Constructors still run
-        // initializers. Using an instance field runs no code: its initializer ran when the object was constructed.
-        if ((member.IsImplicitlyDeclared && kind != EdgeExtraction.New) || member is IFieldSymbol { IsStatic: false })
-        {
-            return;
-        }
-
-        var inner = map.For(member);
-        var key = (kind == EdgeExtraction.New ? "new " : "") + SymbolNames.MemberId(member) + "|" + inner.Key;
-        if (!walk.Visited.Add(key))
-        {
-            return;
-        }
-
-        // A cycle that never repeats a (member, bindings) pair (a generic helper instantiating itself one level
-        // deeper at every hop) would otherwise recurse until the process stack overflows: cut it off instead.
-        if (walk.Depth >= MaxWalkDepth)
-        {
-            walk.Warn($"{walk.From}: coupling walk stopped at depth {MaxWalkDepth} following {member.Name}, possible unbounded generic recursion");
-            return;
-        }
-
-        walk.Depth++;
-        try
-        {
-            var (roots, runsImplicitBase) = kind == EdgeExtraction.New && member is IMethodSymbol constructor
-                ? WalkRoots.Construction(constructor)
-                : (WalkRoots.Body(member), false);
-            Record(roots, walk);
-
-            foreach (var root in roots)
-            {
-                foreach (var use in await UsesAsync(root, cancellationToken))
-                {
-                    await ResolveUseAsync(use.Member, use.Kind, via, file, line, inner, walk, cancellationToken);
-                }
-            }
-
-            if (runsImplicitBase
-                && member.ContainingType.BaseType?.InstanceConstructors.FirstOrDefault(c => c.Parameters.Length == 0) is { } baseConstructor)
-            {
-                await ResolveUseAsync(baseConstructor, EdgeExtraction.New, via, file, line, inner, walk, cancellationToken);
-            }
-
-            // The static constructor runs once, lazily, before the type's first static member use or instantiation:
-            // consistent with a static field's own initializer, which is already walked wherever that field is read.
-            if ((kind == EdgeExtraction.Static || kind == EdgeExtraction.New)
-                && member.ContainingType?.OriginalDefinition.StaticConstructors.FirstOrDefault(c => !c.IsImplicitlyDeclared)
-                    is { } staticConstructor)
-            {
-                await ResolveUseAsync(staticConstructor, EdgeExtraction.Call, via, file, line, inner, walk, cancellationToken);
-            }
-        }
-        finally
-        {
-            walk.Depth--;
-        }
-    }
-
-    /// <summary>A method, property or event that a subclass could give a different body: dispatch, not fixed code.</summary>
-    private static bool IsOverridable(ISymbol member) => member switch
-    {
-        IMethodSymbol method => method.IsVirtual || method.IsAbstract || method.IsOverride,
-        IPropertySymbol property => property.IsVirtual || property.IsAbstract || property.IsOverride,
-        IEventSymbol @event => @event.IsVirtual || @event.IsAbstract || @event.IsOverride,
-        _ => false,
-    };
-
-    // The walked helper code becomes citable for the component; a parameter declares a value and runs nothing.
-    private void Record(IEnumerable<SyntaxNode> roots, Walk walk)
-    {
-        foreach (var root in roots.Where(r => r is not (ParameterSyntax or ParameterListSyntax)))
-        {
-            var (sourceKind, relative) = CitableSource.Classify(loaded, root.SyntaxTree);
-            if (sourceKind == CitableSource.Kind.InRepo)
-            {
-                var lines = root.GetLocation().GetLineSpan();
-                walk.Reaches.Add(new SourceSpan(relative, lines.StartLinePosition.Line + 1, lines.EndLinePosition.Line + 1));
-            }
-        }
-    }
-
-    private async Task<List<MemberUses.MemberUse>> UsesAsync(SyntaxNode root, CancellationToken cancellationToken)
-    {
-        if (!_uses.TryGetValue(root, out var uses))
-        {
-            uses = await MemberUses.ReadAsync([root], loaded, cancellationToken);
-            _uses[root] = uses;
-        }
-
-        return uses;
-    }
-
-    private bool IsRepo(INamedTypeSymbol type)
-    {
-        if (!_repoSource.TryGetValue(type, out var isRepo))
-        {
-            isRepo = CitableSource.IsRepoSource(type, loaded);
-            _repoSource[type] = isRepo;
-        }
-
-        return isRepo;
-    }
-}