Stuff

Author: MelbourneDeveloper

.gitignore

@@ -51,3 +51,5 @@ src/Nap.Zed/grammars/nap.wasm
 src/Nap.Zed/grammars/napenv.wasm
 
 *.wasm
+
+scripts/logs/

specs/CLI-PLAN.md

@@ -77,9 +77,10 @@ nap/
 
 ### Phase 4 — Polish & Distribution
 
-- Standalone native binary (NativeAOT or single-file publish)
-- NuGet package for `dotnet tool install`
+- **NuGet package for `dotnet tool install` (PRIMARY channel)** — set `<PackAsTool>true</PackAsTool>` and `<ToolCommandName>napper</ToolCommandName>` in `Nap.Cli.fsproj`, publish to nuget.org. This is the primary distribution method — no code signing needed, no SmartScreen warnings on Windows, immediate availability. The VSIX extension auto-installs via `dotnet tool install -g napper --version X.X.X`.
+- Standalone native binary (NativeAOT or single-file publish) — secondary channel for users without .NET SDK
 - Homebrew formula
+- Winget / Chocolatey / Scoop packages (future)
 - `nap new` scaffolding commands
 - Language-extensible script runner plugin model
 
@@ -119,8 +120,10 @@ nap/
 - [ ] `ctx.Set` for cross-step variable passing
 
 ### Phase 4 — Polish & Distribution
-- [ ] Standalone native binary (NativeAOT or single-file publish)
-- [ ] NuGet package for `dotnet tool install`
+- [ ] `dotnet tool install` — set `PackAsTool` in fsproj, publish to nuget.org (PRIMARY)
+- [ ] VSIX auto-installs CLI via `dotnet tool install -g napper --version X.X.X`
+- [ ] Standalone native binary (NativeAOT or single-file publish) — secondary
 - [ ] Homebrew formula
+- [ ] Winget / Chocolatey / Scoop packages
 - [ ] `nap new` scaffolding commands
 - [ ] Language-extensible script runner plugin model

specs/CLI-SPEC.md

@@ -20,6 +20,30 @@ Nap is a developer-first HTTP testing tool. It is as simple as curl for one-off
 
 ---
 
+## Installation
+
+The Napper CLI is distributed as a **dotnet tool** via NuGet. This is the primary distribution channel — it avoids code-signing requirements (no Windows SmartScreen warnings), works cross-platform, and integrates with existing .NET toolchains.
+
+```sh
+# Install globally
+dotnet tool install -g napper
+
+# Install a specific version
+dotnet tool install -g napper --version 0.6.0
+
+# Update to latest
+dotnet tool update -g napper
+```
+
+The VSIX extension installs the CLI automatically via `dotnet tool install` on activation, using the extension's own version to determine which CLI version to install. Users with the CLI already on PATH (or configured via `nap.cliPath`) skip the auto-install.
+
+**Future channels** (not yet implemented):
+- Homebrew formula (`brew install napper`)
+- Winget / Chocolatey / Scoop packages
+- Standalone native binary (NativeAOT single-file publish)
+
+---
+
 ## Usage
 
 ### `cli-run` — Run Command

specs/IDE-EXTENSION-PLAN.md

@@ -38,6 +38,7 @@ This phase **deletes duplicated TypeScript parsing code** and replaces it with L
 
 ### Phase 4 — Polish & Distribution
 
+- **CLI installation via `dotnet tool install`** — replace raw binary download with `dotnet tool install -g napper --version X.X.X`. Version is read from the extension's own `package.json`. Eliminates Windows SmartScreen warnings and custom HTTP download code.
 - Split editor layout (request panel webview)
 - New request guided flow
 - OpenAPI generation command
@@ -72,6 +73,8 @@ This phase **deletes duplicated TypeScript parsing code** and replaces it with L
 - [ ] Run ALL existing VSIX e2e tests — must pass
 
 ### Phase 4 — Polish & Distribution
+- [ ] Replace raw binary download with `dotnet tool install -g napper --version X.X.X`
+- [ ] Delete custom HTTP download code (`cliInstaller.ts` download/redirect logic)
 - [ ] Split editor layout (request panel webview)
 - [ ] New request guided flow
 - [ ] OpenAPI generation command

specs/IDE-EXTENSION-SPEC.md

@@ -354,6 +354,7 @@ These settings apply across all IDEs where the extension supports configuration.
 - Built in **TypeScript** using the VSCode Extension API.
 - The response panel webview uses a minimal framework (Lit or vanilla TS + CSS) — no heavy UI library.
 - The extension shells out to the **Nap CLI** (`nap run --output json`) for all HTTP execution.
+- **CLI acquisition:** The VSIX installs the CLI via `dotnet tool install -g napper --version X.X.X` on activation, where `X.X.X` is the extension's own `package.json` version. This avoids raw binary downloads (which trigger Windows SmartScreen warnings on unsigned binaries) and leverages NuGet as a trusted distribution channel. If the CLI is already on PATH at the correct version, installation is skipped.
 - File watching via `vscode.workspace.createFileSystemWatcher` keeps the panel tree up to date without polling.
 - The `.nap` language grammar (TextMate `.tmLanguage.json`) is generated from the ANTLR grammar to avoid drift.
 - Published to the **VS Code Marketplace** and the **Open VSX Registry** (for VSCodium / Cursor / Windsurf users).

src/Nap.VsCode/package.json

@@ -2,7 +2,7 @@
   "name": "napper",
   "displayName": "Napper",
   "description": "CLI-first, test-oriented HTTP API testing tool. Send requests, run assertions, manage environments.",
-  "version": "0.1.0",
+  "version": "0.6.0",
   "publisher": "nimblesite",
   "license": "MIT",
   "repository": {

src/Nap.VsCode/src/cliInstaller.ts

@@ -16,7 +16,6 @@ import {
   CLI_BIN_DIR,
   CLI_DOWNLOAD_ERROR_PREFIX,
   CLI_DOWNLOAD_HOST,
-  CLI_DOWNLOAD_PATH_PREFIX,
   CLI_FILE_MODE_EXECUTABLE,
   CLI_MAX_REDIRECTS,
   CLI_PLATFORM_DARWIN,
@@ -36,6 +35,7 @@ import {
   HTTP_STATUS_CLIENT_ERROR_MIN,
   HTTP_STATUS_OK,
   HTTP_STATUS_REDIRECT_MIN,
+  cliDownloadPath,
 } from './constants';
 
 const PLATFORM_RID_MAP: ReadonlyMap<string, string> = new Map([
@@ -167,9 +167,10 @@ async function followRedirect(
 export const downloadBinary = async (
   rid: string,
   destPath: string,
+  version: string,
 ): Promise<Result<void, string>> => {
   const asset = assetName(rid),
-    url = `https://${CLI_DOWNLOAD_HOST}${CLI_DOWNLOAD_PATH_PREFIX}${asset}`,
+    url = `https://${CLI_DOWNLOAD_HOST}${cliDownloadPath(version)}${asset}`,
     dir = path.dirname(destPath);
 
   if (!fs.existsSync(dir)) {
@@ -189,22 +190,27 @@ export interface InstallResult {
   readonly cliPath: string;
 }
 
+export interface InstallCliParams {
+  readonly storageDir: string;
+  readonly platform: string;
+  readonly arch: string;
+  readonly version: string;
+}
+
 export const installCli = async (
-  storageDir: string,
-  platform: string,
-  arch: string,
+  params: InstallCliParams,
 ): Promise<Result<InstallResult, string>> => {
-  const ridResult = platformToRid(platform, arch);
+  const ridResult = platformToRid(params.platform, params.arch);
   if (!ridResult.ok) {
     return err(ridResult.error);
   }
 
-  const destPath = installedCliPath(storageDir, platform),
-    downloadResult = await downloadBinary(ridResult.value, destPath);
+  const destPath = installedCliPath(params.storageDir, params.platform),
+    downloadResult = await downloadBinary(ridResult.value, destPath, params.version);
   if (!downloadResult.ok) {
     return err(downloadResult.error);
   }
 
-  makeExecutable(destPath, platform);
+  makeExecutable(destPath, params.platform);
   return ok({ cliPath: destPath });
 };

src/Nap.VsCode/src/cliRunner.ts

@@ -158,25 +158,31 @@ const attachDataListeners = (ctx: StreamListenerContext): void => {
       ctx.state.stderrOutput += chunk.toString();
     });
   },
+  handleClose = (ctx: StreamListenerContext): void => {
+    if (ctx.state.finished) {
+      return;
+    }
+    ctx.state.finished = true;
+    flushAndFinish({
+      buffer: ctx.state.buffer,
+      onResult: ctx.options.onResult,
+      stderrOutput: ctx.state.stderrOutput,
+      onDone: ctx.options.onDone,
+    });
+  },
+  handleError = (ctx: StreamListenerContext, error: Error): void => {
+    if (ctx.state.finished) {
+      return;
+    }
+    ctx.state.finished = true;
+    ctx.options.onDone(`${CLI_SPAWN_FAILED_PREFIX}${ctx.cliPath} — ${error.message}`);
+  },
   attachLifecycleListeners = (ctx: StreamListenerContext): void => {
     ctx.child.on('close', () => {
-      if (ctx.state.finished) {
-        return;
-      }
-      ctx.state.finished = true;
-      flushAndFinish({
-        buffer: ctx.state.buffer,
-        onResult: ctx.options.onResult,
-        stderrOutput: ctx.state.stderrOutput,
-        onDone: ctx.options.onDone,
-      });
+      handleClose(ctx);
     });
     ctx.child.on('error', (error) => {
-      if (ctx.state.finished) {
-        return;
-      }
-      ctx.state.finished = true;
-      ctx.options.onDone(`${CLI_SPAWN_FAILED_PREFIX}${ctx.cliPath} — ${error.message}`);
+      handleError(ctx, error);
     });
   };
 

src/Nap.VsCode/src/constants.ts

@@ -144,8 +144,9 @@ export const CLI_REPO_NAME = 'napper';
 export const CLI_BINARY_NAME = 'napper';
 export const CLI_BIN_DIR = 'bin';
 export const CLI_DOWNLOAD_HOST = 'github.com';
-export const CLI_REQUIRED_VERSION = '0.1.0';
-export const CLI_DOWNLOAD_PATH_PREFIX = `/MelbourneDeveloper/napper/releases/download/v${CLI_REQUIRED_VERSION}/`;
+export const CLI_DOWNLOAD_PATH_BASE = '/MelbourneDeveloper/napper/releases/download/v';
+export const cliDownloadPath = (version: string): string =>
+  `${CLI_DOWNLOAD_PATH_BASE}${version}/`;
 export const CLI_ASSET_PREFIX = 'napper-';
 export const CLI_WIN_EXE_SUFFIX = '.exe';
 export const CLI_MAX_REDIRECTS = 5;

src/Nap.VsCode/src/extension.ts

@@ -36,7 +36,6 @@ import {
   CLI_INSTALL_COMPLETE_MSG,
   CLI_INSTALL_FAILED_MSG,
   CLI_INSTALL_MSG,
-  CLI_REQUIRED_VERSION,
   CLI_VERSION_MISMATCH_MSG,
   CMD_COPY_CURL,
   CMD_ENRICH_AI,
@@ -83,6 +82,7 @@ import {
 
 let bundledCliPath: string | undefined,
   envStatusBar: EnvironmentStatusBar,
+  extensionVersion: string,
   explorerProvider: ExplorerAdapter,
   installedPath: string | undefined,
   lastPlaylistReport: (() => void) | undefined,
@@ -117,34 +117,42 @@ const getCliPath = (): string => {
   },
   isVersionMatch = async (candidate: string): Promise<boolean> => {
     const versionResult = await getCliVersion(candidate);
-    if (versionResult.ok && versionResult.value === CLI_REQUIRED_VERSION) {
+    if (versionResult.ok && versionResult.value === extensionVersion) {
       installedPath = candidate;
       return true;
     }
     logger.info(CLI_VERSION_MISMATCH_MSG);
     return false;
   },
-  ensureCliInstalled = async (storageUri: vscode.Uri | undefined): Promise<void> => {
-    if (storageUri === undefined) {
-      return;
-    }
-    const storagePath = storageUri.fsPath,
-      candidate = installedCliPath(storagePath, process.platform);
-    if (isCliInstalled(candidate) && (await isVersionMatch(candidate))) {
-      return;
-    }
+  performInstall = async (storagePath: string): Promise<void> => {
     await vscode.window.withProgress(
       {
         location: vscode.ProgressLocation.Notification,
         title: CLI_INSTALL_MSG,
         cancellable: false,
       },
       async () => {
-        const result = await installCli(storagePath, process.platform, process.arch);
+        const result = await installCli({
+          storageDir: storagePath,
+          platform: process.platform,
+          arch: process.arch,
+          version: extensionVersion,
+        });
         handleInstallResult(result);
       },
     );
   },
+  ensureCliInstalled = async (storageUri: vscode.Uri | undefined): Promise<void> => {
+    if (storageUri === undefined) {
+      return;
+    }
+    const storagePath = storageUri.fsPath,
+      candidate = installedCliPath(storagePath, process.platform);
+    if (isCliInstalled(candidate) && (await isVersionMatch(candidate))) {
+      return;
+    }
+    await performInstall(storagePath);
+  },
   getWorkspacePath = (): string | undefined => vscode.workspace.workspaceFolders?.[0]?.uri.fsPath,
   getResponseColumn = (): vscode.ViewColumn => {
     const config = vscode.workspace.getConfiguration(CONFIG_SECTION),
@@ -345,6 +353,14 @@ const collectResult = (state: StreamState, result: RunResult): void => {
       }),
     );
   },
+  handleEnrichAi = async (arg?: { readonly filePath?: string }): Promise<void> => {
+    const fp = arg?.filePath;
+    if (fp === undefined) {
+      return;
+    }
+    await runAiEnrichment(path.dirname(fp), logger);
+    explorerProvider.refresh();
+  },
   registerOpenApiCommands = (context: vscode.ExtensionContext): void => {
     context.subscriptions.push(
       vscode.commands.registerCommand(CMD_IMPORT_OPENAPI_URL, async () => {
@@ -353,17 +369,7 @@ const collectResult = (state: StreamState, result: RunResult): void => {
       vscode.commands.registerCommand(CMD_IMPORT_OPENAPI_FILE, async () => {
         await importOpenApiFromFile(explorerProvider, logger);
       }),
-      vscode.commands.registerCommand(
-        CMD_ENRICH_AI,
-        async (arg?: { readonly filePath?: string }) => {
-          const fp = arg?.filePath;
-          if (fp === undefined) {
-            return;
-          }
-          await runAiEnrichment(path.dirname(fp), logger);
-          explorerProvider.refresh();
-        },
-      ),
+      vscode.commands.registerCommand(CMD_ENRICH_AI, handleEnrichAi),
     );
   },
   initProviders = (): void => {
@@ -393,6 +399,8 @@ const collectResult = (state: StreamState, result: RunResult): void => {
       outputChannel.appendLine(msg);
     });
     logger.info(LOG_MSG_ACTIVATED);
+    extensionVersion = (context.extension.packageJSON as { version: string }).version;
+    logger.info(`Extension version: ${extensionVersion}`);
     bundledCliPath = path.join(
       context.extensionPath,
       CLI_BIN_DIR,