From eb3568016b7bf64442eb6fb532b98d7e3826ced4 Mon Sep 17 00:00:00 2001
From: iammukeshm <iammukeshm@gmail.com>
Date: Fri, 19 Jun 2026 19:27:18 +0530
Subject: [PATCH] chore(nuget): publish-readiness fixes for CLI + template
 packages

Validated the full publish pipeline end-to-end (pack -> install -> scaffold
full/no-aspire/no-frontend -> build backend+frontends -> run Aspire stack ->
auth + endpoints). Three fixes surfaced:

- pack: stop shipping a local AI-tool settings file. src/.claude/settings.local.json
  was tracked and leaked into both the template package and scaffolded output
  (root .gitignore only anchored /.claude/). Untrack it and ignore **/.claude/
  settings.local.json at any depth.
- template pkg: render a README on the nuget.org gallery page. The template pack
  lives outside src/ so it never inherited src/Directory.Build.props's
  PackageReadmeFile; add PackageReadmeFile + the root README at package root
  (same README the CLI ships). Clears the "missing a readme" pack warning.
- aspire: pin the dashboard to the documented port 15888. launchSettings used an
  auto-generated 17273 while the README, README-template, fsh CLI "Next Steps"
  (FshConstants.AspireDashboardPort) and `fsh doctor` all advertise 15888.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .gitignore                                               | 2 ++
 src/.claude/settings.local.json                          | 9 ---------
 .../FSH.Starter.AppHost/Properties/launchSettings.json   | 2 +-
 templates/FullStackHero.NET.StarterKit.csproj            | 4 ++++
 4 files changed, 7 insertions(+), 10 deletions(-)
 delete mode 100644 src/.claude/settings.local.json

diff --git a/.gitignore b/.gitignore
index 23798fd6b1..ab3334d6b2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -503,6 +503,8 @@ spec-os/
 /.claude/worktrees/
 /.claude/scheduled_tasks.lock
 /.claude/last30days.env
+# Local AI-tool state should never be tracked, at any depth.
+**/.claude/settings.local.json
 tmpclaude**
 
 # Auto Claude data directory
diff --git a/src/.claude/settings.local.json b/src/.claude/settings.local.json
deleted file mode 100644
index c352d199a1..0000000000
--- a/src/.claude/settings.local.json
+++ /dev/null
@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__cwm-roslyn-navigator__get_project_graph",
-      "Bash(python3 -c \"import sys,json; print\\(json.dumps\\(json.load\\(sys.stdin\\).get\\(''mcpServers'',{}\\), indent=2\\)\\)\")",
-      "Bash(cat:*)"
-    ]
-  }
-}
diff --git a/src/Host/FSH.Starter.AppHost/Properties/launchSettings.json b/src/Host/FSH.Starter.AppHost/Properties/launchSettings.json
index ee96e89c16..7402fed320 100644
--- a/src/Host/FSH.Starter.AppHost/Properties/launchSettings.json
+++ b/src/Host/FSH.Starter.AppHost/Properties/launchSettings.json
@@ -5,7 +5,7 @@
       "commandName": "Project",
       "dotnetRunMessages": true,
       "launchBrowser": true,
-      "applicationUrl": "https://localhost:17273;http://localhost:15036",
+      "applicationUrl": "https://localhost:15888;http://localhost:15036",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development",
         "DOTNET_ENVIRONMENT": "Development",
diff --git a/templates/FullStackHero.NET.StarterKit.csproj b/templates/FullStackHero.NET.StarterKit.csproj
index eeaf61b21a..1153ce443e 100644
--- a/templates/FullStackHero.NET.StarterKit.csproj
+++ b/templates/FullStackHero.NET.StarterKit.csproj
@@ -28,6 +28,8 @@
     <RepositoryType>git</RepositoryType>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageIcon>icon.png</PackageIcon>
+    <!-- Render the project README on the nuget.org gallery page (same README the CLI ships). -->
+    <PackageReadmeFile>README.md</PackageReadmeFile>
 
     <TargetFramework>net10.0</TargetFramework>
     <IncludeContentInPack>true</IncludeContentInPack>
@@ -46,6 +48,8 @@
     <Compile Remove="**\*" />
     <!-- Gallery icon at package root (separate from the .template.config content copy). -->
     <None Include="..\.template.config\icon.png" Pack="true" PackagePath="\" Visible="false" />
+    <!-- Gallery README at package root (separate from the content/README.md scaffold copy). -->
+    <None Include="..\README.md" Pack="true" PackagePath="\" Visible="false" />
   </ItemGroup>
 
   <!--