Tidy up code and docs for publish

.gitignore

@@ -361,4 +361,8 @@ MigrationBackup/
 # Fody - auto-generated XML schema
 FodyWeavers.xsd
 
-.idea/
+.idea/
+
+# Generated clean scripts (personal artifacts)
+clean.cmd
+clean.sh

README.md

@@ -10,6 +10,8 @@
 
 Some of this can be handy when working with agentic coding tools which at this stage may have an unconventional approach to tfms, central package management, nuget package references and versions.
 
+> 💡 **Fun fact**: `bld` was born from the frustration of watching gigabytes of build artifacts pile up faster than dependencies in a JavaScript project. Because sometimes you need a tool that speaks fluent MSBuild and knows when to take out the trash. 🗑️
+
 ## Quick Start
 
 ```powershell

bld/Commands/StatsCommand.cs

@@ -26,7 +26,7 @@ protected override async Task<int> ExecuteAsync(ParseResult parseResult, Cancell
         var errors = new List<string>();
 
         var options = new CleaningOptions {
-            Delete = false, //TODO parseResult.GetValue(_deleteOption),
+            Delete = false,
             CleanOnlyNonCurrentTfms = parseResult.GetValue(_nonCurrentOption),
             CleanObjDirectory = parseResult.GetValue(_objOption),
             CleanNupkgFiles = parseResult.GetValue(_nupkgOption),

bld/bld.csproj

@@ -18,13 +18,10 @@
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
     <EmbedUntrackedSources>true</EmbedUntrackedSources>
     <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
-    <!--<IncludeSymbols>false</IncludeSymbols>-->
-    <!--<SymbolPackageFormat>snupkg</SymbolPackageFormat>-->
   </PropertyGroup>
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Build" ExcludeAssets="runtime" />
-    <!--<PackageReference Include="Microsoft.Build" Version="17.14.8" ExcludeAssets="runtime"/>-->
     <PackageReference Include="Microsoft.Build.Locator" />
     <PackageReference Include="Spectre.Console" />
     <PackageReference Include="System.CommandLine" />
@@ -40,16 +37,12 @@
     <PackAsTool>true</PackAsTool>
     <ToolCommandName>bld</ToolCommandName>
     <AssemblyName>bld</AssemblyName>
-    <!--<PackageOutputPath></PackageOutputPath>-->
-    <!--<RuntimeIdentifier>win-x64</RuntimeIdentifier>-->
-    <!--<PackageId></PackageId>-->
     <PackageId>Cloudsiders.bld</PackageId>
     <PackageVersion>0.1.1</PackageVersion>
     <Authors>dlosch</Authors>
     <Description>Tool to clean build output folders for msbuild</Description>
     <PackageTags>msbuild</PackageTags>
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
-    <!--<PackageLicenseFile>LICENSE</PackageLicenseFile>-->
     <GenerateDocumentationFile>false</GenerateDocumentationFile>
     <SatelliteResourceLanguages>en</SatelliteResourceLanguages>
   </PropertyGroup>