Release v0.1.4

- Fix fcdnx argument pass-through by allowing unmatched tokens as tool arguments
- Select tool TFM from the highest installed .NET runtime instead of hard-coded net10.0
- Validate cached versions against current VersionConstraint and prerelease settings
- Reuse the supplied NuGet.Config during package download, not only metadata resolution
- Add regression coverage for CLI args, runtime-aware extraction, and cache constraint fall-through
- Bump ToolHost and ToolHost.Cli package metadata to 0.1.4 and update release notes

Author: diluculo

RELEASENOTES.ToolHost.Cli.md

@@ -1,5 +1,12 @@
 # Release Notes — FieldCure.ToolHost.Cli (`fcdnx`)
 
+## v0.1.4 (2026-05-19)
+
+### Fixed
+
+- **Tool arguments are now accepted and forwarded.** `fcdnx dotnetsay hello` no longer fails argument parsing before ToolHost starts. Unmatched tokens after the package id are treated as tool arguments and passed through to the launched process.
+- **Library re-pinned to `FieldCure.ToolHost` 0.1.4.** This pulls in runtime-aware tool TFM selection, cache constraint validation, and `--configfile` reuse during package download.
+
 ## v0.1.3 (2026-05-19)
 
 ### Fixed (via embedded library)

RELEASENOTES.ToolHost.md

@@ -1,5 +1,13 @@
 # Release Notes — FieldCure.ToolHost
 
+## v0.1.4 (2026-05-19)
+
+### Fixed
+
+- **Runtime TFM selection now follows the installed host runtime.** `NuGetToolExtractor` no longer assumes `net10.0` when selecting `tools/{tfm}/{rid}`. It derives the host framework from the highest installed `Microsoft.NETCore.App` runtime reported by `DotnetEnvironment`, falling back to the current process runtime only if runtime detection data is unavailable.
+- **Cache hits honor the current version request.** `CachedOnly` and `CachedWithRefresh` no longer return a pinned prerelease when prerelease is disallowed, or a pinned version outside the requested `VersionConstraint`.
+- **Downloads reuse the supplied NuGet.Config.** When the CLI is invoked with `--configfile`, the extractor now loads the same config file for package download that the resolver used for metadata resolution.
+
 ## v0.1.3 (2026-05-19)
 
 ### Fixed

src/FieldCure.ToolHost.Cli/DnxCommand.cs

@@ -81,6 +81,7 @@ public static RootCommand Build()
             osOpt,
             policyOpt,
         };
+        root.TreatUnmatchedTokensAsErrors = false;
 
         root.SetAction((parseResult, ct) => RunAsync(
             parseResult,
@@ -117,9 +118,9 @@ private static async Task<int> RunAsync(
         CancellationToken ct)
     {
         var verbosity = parseResult.GetValue(verbosityOpt) ?? VerbosityMapper.DefaultLevel;
-        LogLevel minLevel = VerbosityMapper.Map(verbosity);
+        var minLevel = VerbosityMapper.Map(verbosity);
 
-        using ILoggerFactory loggerFactory = LoggerFactory.Create(b =>
+        using var loggerFactory = LoggerFactory.Create(b =>
         {
             _ = b.SetMinimumLevel(minLevel);
             _ = b.AddSimpleConsole(o =>
@@ -130,8 +131,8 @@ private static async Task<int> RunAsync(
             });
         });
 
-        ILogger<DnxLiteRunner> runnerLogger = loggerFactory.CreateLogger<DnxLiteRunner>();
-        ILogger cliLogger = loggerFactory.CreateLogger("fcdnx");
+        var runnerLogger = loggerFactory.CreateLogger<DnxLiteRunner>();
+        var cliLogger = loggerFactory.CreateLogger("fcdnx");
 
         try
         {
@@ -179,7 +180,10 @@ private static async Task<int> RunAsync(
                 IgnoreFailedSources = parseResult.GetValue(ignoreFailedSourcesOpt),
             };
             NuGetPackageResolver resolver = new(resolverOptions, indexStore, loggerFactory.CreateLogger<NuGetPackageResolver>());
-            NuGetToolExtractor extractor = new(environment, loggerFactory.CreateLogger<NuGetToolExtractor>());
+            NuGetToolExtractor extractor = new(
+                environment,
+                parseResult.GetValue(configFileOpt),
+                loggerFactory.CreateLogger<NuGetToolExtractor>());
             FieldCure.ToolHost.Execution.ToolLauncher launcher = new(loggerFactory.CreateLogger<FieldCure.ToolHost.Execution.ToolLauncher>());
 
             DnxLiteRunner runner = new(environment, resolver, extractor, launcher, runnerLogger);
@@ -194,7 +198,7 @@ private static async Task<int> RunAsync(
                 AllowRollForward = parseResult.GetValue(allowRollForwardOpt),
             };
 
-            using Process process = await runner.StartAsync(invocation, ct).ConfigureAwait(false);
+            using var process = await runner.StartAsync(invocation, ct).ConfigureAwait(false);
             return await ForwardStdioAsync(process, ct).ConfigureAwait(false);
         }
         catch (PackageNotFoundException ex)

src/FieldCure.ToolHost.Cli/FieldCure.ToolHost.Cli.csproj

@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
-    <Version>0.1.3</Version>
+    <Version>0.1.4</Version>
     <AssemblyName>FieldCure.ToolHost.Cli</AssemblyName>
     <RootNamespace>FieldCure.ToolHost.Cli</RootNamespace>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
@@ -28,7 +28,7 @@
     <PackageTags>dnx;dotnet-tool;nuget;fcdnx;tool-runner;sdk-less;cli</PackageTags>
     <PackageReadmeFile>README.md</PackageReadmeFile>
     <PackageIcon>icon.png</PackageIcon>
-    <PackageReleaseNotes>v0.1.3 — Library re-pinned to FieldCure.ToolHost 0.1.3 (hotfix: PackageSource ctor argument order; --source / --add-source were silently broken in 0.1.0–0.1.2). CLI surface unchanged. See RELEASENOTES.ToolHost.Cli.md on GitHub for the full notes.</PackageReleaseNotes>
+    <PackageReleaseNotes>v0.1.4 — CLI now accepts and forwards tool arguments, and repins to FieldCure.ToolHost 0.1.4 for runtime TFM selection, cache constraint, and NuGet.Config download fixes. See RELEASENOTES.ToolHost.Cli.md on GitHub for the full notes.</PackageReleaseNotes>
   </PropertyGroup>
 
   <ItemGroup>

src/FieldCure.ToolHost.Cli/Program.cs

@@ -1,6 +1,4 @@
-using System.CommandLine;
-
-namespace FieldCure.ToolHost.Cli;
+namespace FieldCure.ToolHost.Cli;
 
 /// <summary>Entry point for the <c>fcdnx</c> CLI.</summary>
 public static class Program
@@ -9,8 +7,8 @@ public static class Program
     /// <param name="args">Raw command-line arguments.</param>
     public static Task<int> Main(string[] args)
     {
-        RootCommand root = DnxCommand.Build();
-        ParseResult parseResult = root.Parse(args);
+        var root = DnxCommand.Build();
+        var parseResult = root.Parse(args);
         return parseResult.InvokeAsync();
     }
 }

src/FieldCure.ToolHost/Authentication/CredentialProviderSetup.cs

@@ -1,4 +1,4 @@
-using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging;
 
 using NuGet.Credentials;
 
@@ -35,7 +35,7 @@ public static void Register(bool interactive, ILogger? logger = null)
             return;
         }
 
-        INuGetLogger nugetLogger = logger is null
+        var nugetLogger = logger is null
             ? NuGet.Common.NullLogger.Instance
             : new ForwardingLogger(logger);
 
@@ -54,7 +54,7 @@ private sealed class ForwardingLogger : NuGetLoggerBase
         /// <summary>Translates a NuGet log level and forwards the message synchronously.</summary>
         public override void Log(NuGetLogMessage message)
         {
-            LogLevel level = message.Level switch
+            var level = message.Level switch
             {
                 NuGetLogLevel.Debug => LogLevel.Debug,
                 NuGetLogLevel.Verbose => LogLevel.Debug,

src/FieldCure.ToolHost/DnxLiteRunner.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 
 using FieldCure.ToolHost.Execution;
 using FieldCure.ToolHost.Extraction;
@@ -86,13 +86,13 @@ public async Task<Process> StartAsync(ToolInvocationRequest request, Cancellatio
             AllowPrerelease: request.AllowPrerelease,
             ExplicitVersion: request.ExplicitVersion);
 
-        PackageResolution resolution = await _resolver.ResolveAsync(resolutionRequest, ct).ConfigureAwait(false);
+        var resolution = await _resolver.ResolveAsync(resolutionRequest, ct).ConfigureAwait(false);
 
         _logger.LogInformation(
             "Resolved {PackageId} -> {Version} (source={Source}, cacheHit={CacheHit})",
             resolution.PackageId, resolution.Version.ToNormalizedString(), resolution.SourceUrl, resolution.WasCacheHit);
 
-        ExtractedToolLayout layout = await _extractor.EnsureExtractedAsync(resolution, ct).ConfigureAwait(false);
+        var layout = await _extractor.EnsureExtractedAsync(resolution, ct).ConfigureAwait(false);
 
         LaunchRequest launchRequest = new()
         {

src/FieldCure.ToolHost/DotnetEnvironment.cs

@@ -49,10 +49,10 @@ public static async Task<DotnetEnvironment> DetectAsync(CancellationToken ct = d
                 "The 'dotnet' muxer was not found on PATH and DOTNET_ROOT is not set. " +
                 "Install the .NET runtime or set DOTNET_ROOT to its installation folder.");
 
-        IReadOnlyList<string> sdks = ParseSdkLines(await RunDotnetAsync(muxer, "--list-sdks", ct).ConfigureAwait(false));
-        IReadOnlyList<string> runtimes = ParseRuntimeLines(await RunDotnetAsync(muxer, "--list-runtimes", ct).ConfigureAwait(false));
+        var sdks = ParseSdkLines(await RunDotnetAsync(muxer, "--list-sdks", ct).ConfigureAwait(false));
+        var runtimes = ParseRuntimeLines(await RunDotnetAsync(muxer, "--list-runtimes", ct).ConfigureAwait(false));
 
-        ISettings settings = Settings.LoadDefaultSettings(root: null);
+        var settings = Settings.LoadDefaultSettings(root: null);
         var globalPackages = SettingsUtility.GetGlobalPackagesFolder(settings);
 
         return new DotnetEnvironment
@@ -99,7 +99,7 @@ public static async Task<DotnetEnvironment> DetectAsync(CancellationToken ct = d
     internal static IReadOnlyList<string> ParseSdkLines(string output)
     {
         // Each line: "<version> [<install-path>]"
-        List<string> versions = new();
+        List<string> versions = [];
         foreach (var line in output.Split('\n'))
         {
             var trimmed = line.Trim();
@@ -121,7 +121,7 @@ internal static IReadOnlyList<string> ParseRuntimeLines(string output)
     {
         // Each line: "<framework> <version> [<install-path>]"
         // We only retain Microsoft.NETCore.App runtimes.
-        List<string> versions = new();
+        List<string> versions = [];
         foreach (var line in output.Split('\n'))
         {
             var trimmed = line.Trim();
@@ -157,11 +157,11 @@ private static async Task<string> RunDotnetAsync(string muxer, string arg, Cance
         };
         psi.ArgumentList.Add(arg);
 
-        using Process process = Process.Start(psi)
+        using var process = Process.Start(psi)
             ?? throw new InvalidOperationException($"Failed to start '{muxer} {arg}'.");
 
-        Task<string> stdoutTask = process.StandardOutput.ReadToEndAsync(ct);
-        Task<string> stderrTask = process.StandardError.ReadToEndAsync(ct);
+        var stdoutTask = process.StandardOutput.ReadToEndAsync(ct);
+        var stderrTask = process.StandardError.ReadToEndAsync(ct);
         await process.WaitForExitAsync(ct).ConfigureAwait(false);
         var stdout = await stdoutTask.ConfigureAwait(false);
         var stderr = await stderrTask.ConfigureAwait(false);

src/FieldCure.ToolHost/Execution/DotnetToolSettings.cs

@@ -43,7 +43,7 @@ public static DotnetToolSettings Parse(string xml)
             throw new InvalidDataException("DotnetToolSettings.xml is not well-formed XML.", ex);
         }
 
-        XElement root = doc.Root
+        var root = doc.Root
             ?? throw new InvalidDataException("DotnetToolSettings.xml has no root element.");
 
         if (!string.Equals(root.Name.LocalName, "DotNetCliTool", StringComparison.Ordinal))
@@ -52,16 +52,16 @@ public static DotnetToolSettings Parse(string xml)
                 $"DotnetToolSettings.xml root must be <DotNetCliTool>, found <{root.Name.LocalName}>.");
         }
 
-        XElement? commandsElement = root.Elements()
+        var commandsElement = root.Elements()
             .FirstOrDefault(e => string.Equals(e.Name.LocalName, "Commands", StringComparison.Ordinal));
 
         if (commandsElement is null)
         {
             throw new InvalidDataException("DotnetToolSettings.xml is missing the <Commands> element.");
         }
 
-        List<DotnetToolCommand> commands = new();
-        foreach (XElement commandElement in commandsElement.Elements()
+        List<DotnetToolCommand> commands = [];
+        foreach (var commandElement in commandsElement.Elements()
             .Where(e => string.Equals(e.Name.LocalName, "Command", StringComparison.Ordinal)))
         {
             var name = RequireAttribute(commandElement, "Name");

src/FieldCure.ToolHost/Execution/ToolLauncher.cs

@@ -33,7 +33,7 @@ public Process Start(LaunchRequest request)
                 $"Package has no commands declared in DotnetToolSettings.xml at '{request.Layout.ToolsFolder}'.");
         }
 
-        DotnetToolCommand command = request.Layout.ToolSettings.Commands[0];
+        var command = request.Layout.ToolSettings.Commands[0];
         var entryPoint = Path.Combine(request.Layout.ToolsFolder, command.EntryPoint);
 
         if (!File.Exists(entryPoint))
@@ -75,7 +75,7 @@ public Process Start(LaunchRequest request)
 
         if (request.AdditionalEnvironment is { Count: > 0 } extras)
         {
-            foreach (KeyValuePair<string, string?> kv in extras)
+            foreach (var kv in extras)
             {
                 if (kv.Value is null)
                 {
@@ -92,7 +92,7 @@ public Process Start(LaunchRequest request)
 
         try
         {
-            Process? process = Process.Start(psi);
+            var process = Process.Start(psi);
             if (process is null)
             {
                 throw new ToolLaunchFailedException(