@lvnt/release-radar-cli 0.2.11 → 0.2.12

package/README.md

@@ -0,0 +1,124 @@
+# release-radar-cli
+
+Interactive CLI for downloading development tools through a Nexus proxy. Companion tool to [@lvnt/release-radar](https://www.npmjs.com/package/@lvnt/release-radar).
+
+## Why?
+
+In corporate/intranet environments with restricted internet access, downloading tools directly isn't possible. This CLI:
+
+- Downloads tools through your Nexus proxy server
+- Tracks which versions you've downloaded
+- Shows available updates at a glance
+- Supports both wget downloads and npm global packages
+
+## Installation
+
+```bash
+npm install -g @lvnt/release-radar-cli
+```
+
+## Quick Start
+
+```bash
+# Run interactive mode
+release-radar-cli
+
+# First run will prompt for configuration:
+# - Nexus proxy URL (e.g., https://nexus.company.com/repository/raw-proxy)
+# - Download directory (e.g., ~/downloads/tools)
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `release-radar-cli` | Interactive mode - select and download tools |
+| `release-radar-cli status` | Show all tool versions and download status |
+| `release-radar-cli config` | Configure or reconfigure settings |
+| `release-radar-cli version` | Show CLI version |
+| `release-radar-cli help` | Show help message |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-v, --version` | Show version number |
+| `-h, --help` | Show help |
+| `--skip-update` | Skip auto-update check on startup |
+
+## Interactive Mode
+
+When you run `release-radar-cli`, you'll see a table of available tools:
+
+```
+  Tool               Latest       Downloaded   Status   Type
+──────────────────────────────────────────────────────────────────────
+  Claude Code CLI    1.0.17       1.0.16       UPDATE   wget
+  Ninja              1.12.1       1.12.1       ✓        wget
+  CMake              4.0.1        -            NEW      wget
+  Ralphy             1.2.0        1.2.0        ✓        npm
+```
+
+Select tools with arrow keys and spacebar, then press Enter to download.
+
+## Status Display
+
+```bash
+release-radar-cli status
+```
+
+Shows versions without interactive prompts - useful for scripts or quick checks.
+
+## Configuration
+
+Config is stored at `~/.release-radar-cli/config.json`:
+
+```json
+{
+  "nexusUrl": "https://nexus.company.com/repository/raw-proxy",
+  "downloadDir": "/home/user/downloads/tools"
+}
+```
+
+To reconfigure:
+
+```bash
+release-radar-cli config
+```
+
+## Download Types
+
+### wget (Binary Downloads)
+
+Downloads files through Nexus proxy using wget:
+- Claude Code CLI
+- Ninja
+- CMake
+- Git
+- Clangd
+- Wezterm
+- VS Code Extensions
+
+### npm (Global Packages)
+
+Updates npm packages globally:
+- Ralphy
+
+## Auto-Update
+
+The CLI checks for updates on startup and automatically updates itself if a newer version is available. Skip this with `--skip-update`.
+
+## How It Works
+
+1. **ReleaseRadar service** monitors tool versions and publishes updates to this CLI
+2. **This CLI** reads the embedded `versions.json` containing latest versions and download URLs
+3. **You select** which tools to download
+4. **CLI downloads** through your configured Nexus proxy
+
+## Related
+
+- [@lvnt/release-radar](https://www.npmjs.com/package/@lvnt/release-radar) - The monitoring service that powers this CLI
+
+## License
+
+ISC

package/dist/index.js

@@ -1,40 +1,110 @@
 import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 import { ConfigManager } from './config.js';
 import { DownloadTracker } from './tracker.js';
 import { loadVersions } from './versions.js';
 import { checkAndUpdate } from './updater.js';
 import { downloadFile, updateNpmPackage } from './downloader.js';
-import { promptSetup, promptToolSelection } from './ui.js';
+import { promptSetup, promptToolSelection, renderTable } from './ui.js';
 import { isNpmTool } from './types.js';
+function getVersion() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+}
+function showHelp() {
+    const version = getVersion();
+    console.log(`
+${chalk.bold('release-radar-cli')} v${version}
+
+${chalk.bold('USAGE:')}
+  release-radar-cli [command] [options]
+
+${chalk.bold('COMMANDS:')}
+  ${chalk.cyan('(default)')}    Interactive mode - select and download tools
+  ${chalk.cyan('status')}       Show tool versions and download status
+  ${chalk.cyan('config')}       Configure or reconfigure settings (Nexus URL, download dir)
+  ${chalk.cyan('version')}      Show CLI version
+  ${chalk.cyan('help')}         Show this help message
+
+${chalk.bold('OPTIONS:')}
+  ${chalk.cyan('-v, --version')}    Show version number
+  ${chalk.cyan('-h, --help')}       Show help
+  ${chalk.cyan('--skip-update')}    Skip auto-update check on startup
+
+${chalk.bold('EXAMPLES:')}
+  release-radar-cli              # Interactive mode
+  release-radar-cli status       # Show all tool versions
+  release-radar-cli config       # Reconfigure settings
+  release-radar-cli --version    # Show version
+
+${chalk.bold('CONFIG LOCATION:')}
+  ~/.release-radar-cli/config.json
+
+${chalk.gray('For more info: https://github.com/lvntbkdmr/release-radar')}
+`);
+}
 async function showStatus() {
     const tracker = new DownloadTracker();
     const versions = loadVersions();
     const downloaded = tracker.getAll();
     console.log(chalk.bold('\nTool Status:\n'));
-    console.log(chalk.bold('  Tool               Latest       Downloaded   Status   Type'));
-    console.log(chalk.gray('─'.repeat(70)));
-    for (const tool of versions.tools) {
+    const rows = versions.tools.map(tool => {
         const record = downloaded[tool.name];
-        const downloadedVersion = record?.version ?? '-';
         let status;
         if (!record) {
-            status = chalk.blue('NEW');
+            status = 'new';
         }
         else if (record.version !== tool.version) {
-            status = chalk.yellow('UPDATE');
+            status = 'update';
         }
         else {
-            status = chalk.green('✓');
+            status = 'current';
         }
-        const typeStr = isNpmTool(tool) ? chalk.magenta('npm') : chalk.cyan('wget');
-        console.log(`  ${tool.displayName.padEnd(18)} ${tool.version.padEnd(12)} ${downloadedVersion.padEnd(12)} ${status.padEnd(12)} ${typeStr}`);
-    }
+        return {
+            displayName: tool.displayName,
+            version: tool.version,
+            downloadedVersion: record?.version ?? '-',
+            status,
+            type: isNpmTool(tool) ? 'npm' : 'download',
+        };
+    });
+    renderTable(rows);
     console.log('');
 }
 async function runConfig() {
     const configManager = new ConfigManager();
-    const config = await promptSetup();
-    configManager.save(config);
+    // Check if already configured and show current values
+    if (configManager.isConfigured()) {
+        const current = configManager.load();
+        console.log(chalk.bold('\nCurrent configuration:'));
+        console.log(`  Nexus URL:      ${chalk.cyan(current.nexusUrl)}`);
+        console.log(`  Download dir:   ${chalk.cyan(current.downloadDir)}`);
+        console.log('');
+        const { reconfigure } = await (await import('inquirer')).default.prompt([
+            {
+                type: 'confirm',
+                name: 'reconfigure',
+                message: 'Do you want to update these settings?',
+                default: false,
+            },
+        ]);
+        if (!reconfigure) {
+            console.log(chalk.gray('Configuration unchanged.'));
+            return;
+        }
+        // Prompt with current values as defaults
+        const { promptReconfigure } = await import('./ui.js');
+        const config = await promptReconfigure(current);
+        configManager.save(config);
+    }
+    else {
+        const config = await promptSetup();
+        configManager.save(config);
+    }
     console.log(chalk.green('\nConfiguration saved!'));
 }
 async function runInteractive() {
@@ -120,9 +190,25 @@ async function runInteractive() {
     }
 }
 async function main() {
-    const args = process.argv.slice(2).filter(arg => !arg.startsWith('--'));
+    const rawArgs = process.argv.slice(2);
+    // Handle flags first
+    if (rawArgs.includes('-v') || rawArgs.includes('--version')) {
+        console.log(getVersion());
+        return;
+    }
+    if (rawArgs.includes('-h') || rawArgs.includes('--help')) {
+        showHelp();
+        return;
+    }
+    const args = rawArgs.filter(arg => !arg.startsWith('--') && !arg.startsWith('-'));
     const command = args[0];
     switch (command) {
+        case 'version':
+            console.log(getVersion());
+            break;
+        case 'help':
+            showHelp();
+            break;
         case 'status':
             await showStatus();
             break;

package/dist/ui.d.ts

@@ -2,6 +2,7 @@ import type { VersionsJsonTool } from './types.js';
 import type { DownloadedState } from './tracker.js';
 import type { CliConfig } from './config.js';
 export declare function promptSetup(): Promise<CliConfig>;
+export declare function promptReconfigure(current: CliConfig): Promise<CliConfig>;
 interface ToolChoiceBase {
     name: string;
     displayName: string;
@@ -19,5 +20,13 @@ interface ToolChoiceNpm extends ToolChoiceBase {
     package: string;
 }
 export type ToolChoice = ToolChoiceDownload | ToolChoiceNpm;
+export interface TableRow {
+    displayName: string;
+    version: string;
+    downloadedVersion: string;
+    status: 'new' | 'update' | 'current';
+    type: 'npm' | 'download';
+}
+export declare function renderTable(rows: TableRow[]): void;
 export declare function promptToolSelection(tools: VersionsJsonTool[], downloaded: DownloadedState, generatedAt: string): Promise<ToolChoice[]>;
 export {};

package/dist/ui.js

@@ -30,6 +30,35 @@ export async function promptSetup() {
         downloadDir: answers.downloadDir.replace('~', process.env.HOME || ''),
     };
 }
+export async function promptReconfigure(current) {
+    console.log(chalk.bold('\nUpdate your settings:\n'));
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'nexusUrl',
+            message: 'Nexus proxy base URL:',
+            default: current.nexusUrl,
+            validate: (input) => {
+                if (!input.trim())
+                    return 'URL is required';
+                if (!input.startsWith('http'))
+                    return 'URL must start with http:// or https://';
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'downloadDir',
+            message: 'Download directory:',
+            default: current.downloadDir,
+            validate: (input) => input.trim() ? true : 'Directory is required',
+        },
+    ]);
+    return {
+        nexusUrl: answers.nexusUrl.replace(/\/$/, ''),
+        downloadDir: answers.downloadDir.replace('~', process.env.HOME || ''),
+    };
+}
 function getStatus(tool, downloaded) {
     const record = downloaded[tool.name];
     if (!record) {
@@ -65,17 +94,28 @@ function createToolChoice(tool, downloaded) {
         };
     }
 }
-export async function promptToolSelection(tools, downloaded, generatedAt) {
-    const choices = tools.map((tool) => createToolChoice(tool, downloaded));
-    console.log(chalk.bold(`\nrelease-radar-cli`));
-    console.log(chalk.gray(`Last updated: ${new Date(generatedAt).toLocaleString()}\n`));
-    // Display table
-    console.log(chalk.bold('  Tool               Latest       Downloaded   Status   Type'));
-    console.log(chalk.gray('─'.repeat(70)));
-    choices.forEach((choice) => {
-        const downloadedStr = choice.downloadedVersion ?? '-';
+export function renderTable(rows) {
+    // Calculate dynamic column widths
+    const colWidths = {
+        tool: Math.max(4, ...rows.map(r => r.displayName.length)) + 2,
+        latest: Math.max(6, ...rows.map(r => r.version.length)) + 2,
+        downloaded: Math.max(10, ...rows.map(r => r.downloadedVersion.length)) + 2,
+        status: 8,
+        type: 4,
+    };
+    const totalWidth = colWidths.tool + colWidths.latest + colWidths.downloaded + colWidths.status + colWidths.type + 2;
+    // Header
+    console.log(chalk.bold('  ' +
+        'Tool'.padEnd(colWidths.tool) +
+        'Latest'.padEnd(colWidths.latest) +
+        'Downloaded'.padEnd(colWidths.downloaded) +
+        'Status'.padEnd(colWidths.status) +
+        'Type'));
+    console.log(chalk.gray('─'.repeat(totalWidth)));
+    // Rows
+    for (const row of rows) {
         let statusStr;
-        switch (choice.status) {
+        switch (row.status) {
             case 'new':
                 statusStr = chalk.blue('NEW');
                 break;
@@ -86,9 +126,28 @@ export async function promptToolSelection(tools, downloaded, generatedAt) {
                 statusStr = chalk.green('✓');
                 break;
         }
-        const typeStr = choice.type === 'npm' ? chalk.magenta('npm') : chalk.cyan('wget');
-        console.log(`  ${choice.displayName.padEnd(18)} ${choice.version.padEnd(12)} ${downloadedStr.padEnd(12)} ${statusStr.padEnd(12)} ${typeStr}`);
-    });
+        const typeStr = row.type === 'npm' ? chalk.magenta('npm') : chalk.cyan('wget');
+        console.log('  ' +
+            row.displayName.padEnd(colWidths.tool) +
+            row.version.padEnd(colWidths.latest) +
+            row.downloadedVersion.padEnd(colWidths.downloaded) +
+            statusStr.padEnd(colWidths.status + 5) + // +5 for chalk color codes
+            typeStr);
+    }
+}
+export async function promptToolSelection(tools, downloaded, generatedAt) {
+    const choices = tools.map((tool) => createToolChoice(tool, downloaded));
+    console.log(chalk.bold(`\nrelease-radar-cli`));
+    console.log(chalk.gray(`Last updated: ${new Date(generatedAt).toLocaleString()}\n`));
+    // Convert to table rows and display
+    const rows = choices.map(choice => ({
+        displayName: choice.displayName,
+        version: choice.version,
+        downloadedVersion: choice.downloadedVersion ?? '-',
+        status: choice.status,
+        type: choice.type === 'npm' ? 'npm' : 'download',
+    }));
+    renderTable(rows);
     console.log('');
     const { selected } = await inquirer.prompt([
         {

package/dist/updater.js

@@ -1,4 +1,4 @@
-import { execSync, spawn } from 'child_process';
+import { execSync } from 'child_process';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -40,13 +40,7 @@ export async function checkAndUpdate() {
         });
         if (result)
             console.log(result);
-        console.log('Update complete. Restarting...\n');
-        // Restart self with a fresh terminal
-        const child = spawn(process.argv[0], process.argv.slice(1), {
-            detached: true,
-            stdio: 'inherit',
-        });
-        child.unref();
+        console.log('Update complete. Please run the command again.\n');
         process.exit(0);
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lvnt/release-radar-cli",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Interactive CLI for downloading tools through Nexus proxy",
   "main": "dist/index.js",
   "bin": {
@@ -16,7 +16,8 @@
   "files": [
     "dist",
     "bin",
-    "versions.json"
+    "versions.json",
+    "README.md"
   ],
   "keywords": [
     "release",
@@ -26,6 +27,12 @@
   ],
   "author": "lvnt",
   "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lvntbkdmr/release-radar.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/lvntbkdmr/release-radar#readme",
   "dependencies": {
     "chalk": "^5.3.0",
     "inquirer": "^9.2.12"
@@ -37,4 +44,4 @@
     "typescript": "^5.3.0",
     "vitest": "^1.1.0"
   }
-}
+}

package/versions.json

@@ -1,109 +1,21 @@
 {
-  "generatedAt": "2026-01-25T15:32:02.343Z",
+  "generatedAt": "2026-01-24T10:00:00Z",
   "tools": [
-    {
-      "name": "Claude Code CLI",
-      "displayName": "Claude Code CLI",
-      "version": "2.1.19",
-      "publishedAt": "2026-01-25T15:32:02.342Z",
-      "downloadUrl": "{{NEXUS_URL}}/storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/2.1.19/win32-x64/claude.exe",
-      "filename": "claude-2.1.19.exe"
-    },
     {
       "name": "Ninja",
       "displayName": "Ninja",
-      "version": "1.13.2",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/ninja-build/ninja/releases/download/v1.13.2/ninja-win.zip",
-      "filename": "ninja-1.13.2-win.zip"
+      "version": "1.12.0",
+      "publishedAt": "2026-01-20T00:00:00Z",
+      "downloadUrl": "{{NEXUS_URL}}/github.com/ninja-build/ninja/releases/download/v1.12.0/ninja-linux.zip",
+      "filename": "ninja-1.12.0-linux.zip"
     },
     {
       "name": "CMake",
       "displayName": "CMake",
-      "version": "4.2.2",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/Kitware/CMake/releases/download/v4.2.2/cmake-4.2.2-windows-x86_64.zip",
-      "filename": "cmake-4.2.2-windows-x86_64.zip"
-    },
-    {
-      "name": "Git",
-      "displayName": "Git for Windows",
-      "version": "2.52.0.windows.1",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/git-for-windows/git/releases/download/v2.52.0.windows.1/Git-2.52.0-64-bit.exe",
-      "filename": "Git-2.52.0-64-bit.exe"
-    },
-    {
-      "name": "Clangd",
-      "displayName": "Clangd",
-      "version": "21.1.8",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/clangd/clangd/releases/download/21.1.8/clangd-windows-21.1.8.zip",
-      "filename": "clangd-windows-21.1.8.zip"
-    },
-    {
-      "name": "Wezterm",
-      "displayName": "Wezterm",
-      "version": "20240203-110809-5046fc22",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/wezterm/wezterm/releases/download/20240203-110809-5046fc22/WezTerm-20240203-110809-5046fc22-setup.exe",
-      "filename": "WezTerm-20240203-110809-5046fc22-setup.exe"
-    },
-    {
-      "name": "Ralphy",
-      "displayName": "Ralphy CLI",
-      "version": "4.5.3",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "type": "npm",
-      "package": "ralphy-cli"
-    },
-    {
-      "name": "vscode-cpptools",
-      "displayName": "C/C++ Extension",
-      "version": "1.29.3",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/microsoft/vscode-cpptools/releases/download/v1.29.3/cpptools-windows-x64.vsix",
-      "filename": "cpptools-windows-x64-1.29.3.vsix"
-    },
-    {
-      "name": "vscode-clangd",
-      "displayName": "clangd Extension",
-      "version": "0.4.0",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/clangd/vscode-clangd/releases/download/0.4.0/vscode-clangd-0.4.0.vsix",
-      "filename": "vscode-clangd-0.4.0.vsix"
-    },
-    {
-      "name": "CMake Tools",
-      "displayName": "CMake Tools Extension",
-      "version": "1.21.36",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/microsoft/vscode-cmake-tools/releases/download/v1.21.36/cmake-tools.vsix",
-      "filename": "cmake-tools-1.21.36.vsix"
-    },
-    {
-      "name": "Roo Code",
-      "displayName": "Roo Code Extension",
-      "version": "3.43.0",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/RooCodeInc/Roo-Code/releases/download/v3.43.0/roo-cline-3.43.0.vsix",
-      "filename": "roo-cline-3.43.0.vsix"
-    },
-    {
-      "name": "Atlascode",
-      "displayName": "Atlassian Extension",
-      "version": "4.0.17",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/atlassian/atlascode/releases/download/v4.0.17/atlascode-4.0.17.vsix",
-      "filename": "atlascode-4.0.17.vsix"
-    },
-    {
-      "name": "Zed",
-      "displayName": "Zed",
-      "version": "0.220.6",
-      "publishedAt": "2026-01-25T15:32:02.343Z",
-      "downloadUrl": "{{NEXUS_URL}}/github.com/zed-industries/zed/releases/download/v0.220.6/Zed-x86_64.exe",
-      "filename": "Zed-0.220.6-x86_64.exe"
+      "version": "3.28.1",
+      "publishedAt": "2026-01-18T00:00:00Z",
+      "downloadUrl": "{{NEXUS_URL}}/github.com/Kitware/CMake/releases/download/v3.28.1/cmake-3.28.1-linux-x86_64.tar.gz",
+      "filename": "cmake-3.28.1-linux-x86_64.tar.gz"
     }
   ]
-}
+}