Add dynamic tab completions for command arguments via System.CommandLine CompletionSources

[andyalm]

Summary

• Add dynamic CompletionSources to command arguments so dotnet-suggest provides tab completions from the xrepo registry:
  • ref: registered repo names, package IDs, and file path completions for .csproj files
  • which / where: registered package IDs
  • repo unregister: registered repo names
  • unref: registered repo names and package IDs
• Change --solution option type from string to FileInfo so System.CommandLine provides built-in file path tab completion
• Add tab completion setup instructions to README, including a fixed zsh completion script that addresses bugs in the upstream dotnet-suggest script zsh output
• Fix bug in unref command: The name argument was documented but being ignored — xrepo unref always removed all references regardless of whether a name was specified. Now xrepo unref <name> selectively removes only the project references associated with the given repo or package, while xrepo unref (with no argument) continues to remove everything.

How it works

System.CommandLine 2.0's RootCommand already includes the [suggest] directive, so xrepo supports the dotnet-suggest completion protocol out of the box. The CompletionSources.Add() calls provide dynamic values from the xrepo registry, and Option<FileInfo?> triggers native file path completion in the shell.

Selective unref

UnrefCommand now reads the optional name argument and dispatches to either:

• UnrefAll (no argument): removes all XRepoReference ItemGroups from every consuming project, removes the xrepo solution folder, and runs dotnet restore.
• UnrefByName (repo name or package ID): resolves the name to specific project paths, removes only those project references, and only removes the xrepo solution folder if no xrepo references remain anywhere.

New methods added to ConsumingProject:

• RemoveXRepoProjectReference(string projectPath) — removes a specific reference, cleans up empty ItemGroups
• HasXRepoProjectReferences() — checks if any XRepoReference ItemGroups remain

Test plan

• All 61 tests pass (dotnet test) — 60 unit tests + 1 scenario test
• Verified [suggest] directive returns subcommands
• Verified [suggest] returns options for specific commands
• Verified zsh tab completion works for repo names, package IDs, and file paths
• New unit tests for RemoveXRepoProjectReference and HasXRepoProjectReferences
• New integration-style tests verifying the ref/unref flow only links packages actually consumed by the solution

🤖 Generated with Claude Code

[andyalm]

Code review

Found 1 issue:

1. UnrefCommand.nameArg has a CompletionSource wired to the repo registry, but parseResult.GetValue(nameArg) is never called in the action handler. The argument description says "The name of the repo to unref (omit to unref all)", implying selective removal, but the command always removes all xrepo references regardless. The pre-existing unused argument is now actively misleading because tab completion suggests repo names for a parameter that is silently ignored. Either the completion source should be removed, or the action handler should be updated to honor the name argument.

xrepo/src/CommandLine/Commands/Unref.cs

Lines 15 to 51 in efcdadc

	{
	var nameArg = new Argument<string?>("name")
	{
	Description = "The name of the repo to unref (omit to unref all)",
	Arity = ArgumentArity.ZeroOrOne
	};
	nameArg.CompletionSources.Add(ctx =>
	environment.RepoRegistry.GetRepos().Select(r => new CompletionItem(r.Name))
	);
	var solutionOption = new Option<FileInfo?>("--solution", "-s")
	{
	Description = "The path to the solution file. Auto-detected if not specified."
	};
	solutionOption.CompletionSources.Add(ctx =>
	FileCompletions.Get(ctx.WordToComplete, ".sln", ".slnx")
	);
	Arguments.Add(nameArg);
	Options.Add(solutionOption);
	this.SetAction(parseResult =>
	{
	var solutionPath = SolutionHelper.ResolveSolutionPath(parseResult.GetValue(solutionOption)?.FullName);
	var solutionFile = SolutionFile.Read(solutionPath);
	var allConsumingProjects = solutionFile.ConsumingProjects().ToArray();
	foreach (var project in allConsumingProjects)
	{
	if (project.RemoveXRepoProjectReferences())
	project.Save();
	}
	solutionFile.RemoveSolutionFolder("xrepo");
	solutionFile.Write();
	Console.WriteLine("All xrepo project references have been removed. Running dotnet restore...");
	SolutionHelper.DotnetRestore(solutionPath);
	});

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}