free-coding-models 0.1.87 → 0.2.0

package/src/updater.js

@@ -44,6 +44,7 @@
 
 import chalk from 'chalk'
 import { createRequire } from 'module'
+import { accessSync, constants } from 'fs'
 
 const require = createRequire(import.meta.url)
 const readline = require('readline')
@@ -77,6 +78,106 @@ export async function checkForUpdate() {
   return latestVersion
 }
 
+/**
+ * 📖 detectGlobalInstallPermission: check whether npm global install paths are writable.
+ * 📖 On sudo-based systems (Arch, many Linux/macOS setups), `npm i -g` will fail with EACCES
+ * 📖 if the current user cannot write to the resolved global root/prefix.
+ * 📖 We probe those paths ahead of time so the updater can go straight to an interactive
+ * 📖 `sudo npm i -g ...` instead of printing a wall of permission errors first.
+ * @returns {{ needsSudo: boolean, checkedPath: string|null }}
+ */
+function detectGlobalInstallPermission() {
+  const { execFileSync } = require('child_process')
+  const candidates = []
+
+  try {
+    const npmRoot = execFileSync('npm', ['root', '-g'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
+    if (npmRoot) candidates.push(npmRoot)
+  } catch {}
+
+  try {
+    const npmPrefix = execFileSync('npm', ['prefix', '-g'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
+    if (npmPrefix) candidates.push(npmPrefix)
+  } catch {}
+
+  for (const candidate of candidates) {
+    try {
+      accessSync(candidate, constants.W_OK)
+    } catch {
+      return { needsSudo: true, checkedPath: candidate }
+    }
+  }
+
+  return { needsSudo: false, checkedPath: candidates[0] || null }
+}
+
+/**
+ * 📖 hasSudoCommand: lightweight guard so we don't suggest sudo on systems where it does not exist.
+ * @returns {boolean}
+ */
+function hasSudoCommand() {
+  const { spawnSync } = require('child_process')
+  const result = spawnSync('sudo', ['-n', 'true'], { stdio: 'ignore', shell: false })
+  return result.status === 0 || result.status === 1
+}
+
+/**
+ * 📖 isPermissionError: normalize npm permission failures across platforms and child-process APIs.
+ * @param {unknown} err
+ * @returns {boolean}
+ */
+function isPermissionError(err) {
+  const message = err instanceof Error ? err.message : String(err || '')
+  const stderr = typeof err?.stderr === 'string' ? err.stderr : ''
+  const combined = `${message}\n${stderr}`.toLowerCase()
+  return (
+    err?.code === 'EACCES' ||
+    err?.code === 'EPERM' ||
+    combined.includes('eacces') ||
+    combined.includes('eperm') ||
+    combined.includes('permission denied') ||
+    combined.includes('operation not permitted')
+  )
+}
+
+/**
+ * 📖 relaunchCurrentProcess: restart free-coding-models with the same user arguments.
+ * 📖 Uses spawn with inherited stdio so the new process is interactive and does not require shell escaping.
+ */
+function relaunchCurrentProcess() {
+  const { spawn } = require('child_process')
+  console.log(chalk.dim('  🔄 Restarting with new version...'))
+  console.log()
+
+  const args = process.argv.slice(1)
+  const child = spawn(process.execPath, args, {
+    stdio: 'inherit',
+    detached: false,
+    shell: false,
+    env: process.env,
+  })
+
+  child.on('exit', (code) => process.exit(code ?? 0))
+  child.on('error', () => process.exit(0))
+}
+
+/**
+ * 📖 installUpdateCommand: run npm global install, optionally prefixed with sudo.
+ * @param {string} latestVersion
+ * @param {boolean} useSudo
+ */
+function installUpdateCommand(latestVersion, useSudo) {
+  const { execFileSync } = require('child_process')
+  const npmArgs = ['i', '-g', `free-coding-models@${latestVersion}`, '--prefer-online']
+
+  if (useSudo) {
+    execFileSync('sudo', ['npm', ...npmArgs], { stdio: 'inherit', shell: false })
+    return
+  }
+
+  execFileSync('npm', npmArgs, { stdio: 'inherit', shell: false })
+}
+
 /**
  * 📖 runUpdate: Run npm global install to update to latestVersion.
  * 📖 Retries with sudo on permission errors.
@@ -84,54 +185,51 @@ export async function checkForUpdate() {
  * @param {string} latestVersion
  */
 export function runUpdate(latestVersion) {
-  const { execSync } = require('child_process')
   console.log()
   console.log(chalk.bold.cyan('  ⬆ Updating free-coding-models to v' + latestVersion + '...'))
   console.log()
 
-  try {
-    // 📖 Force install from npm registry (ignore local cache)
-    // 📖 Use --prefer-online to ensure we get the latest published version
-    execSync(`npm i -g free-coding-models@${latestVersion} --prefer-online`, { stdio: 'inherit' })
+  const { needsSudo, checkedPath } = detectGlobalInstallPermission()
+  const sudoAvailable = process.platform !== 'win32' && hasSudoCommand()
+
+  if (needsSudo && checkedPath && sudoAvailable) {
+    console.log(chalk.yellow(`  ⚠ Global npm path is not writable: ${checkedPath}`))
+    console.log(chalk.dim('  Re-running update with sudo so you can enter your password once.'))
     console.log()
-    console.log(chalk.green('  ✅ Update complete! Version ' + latestVersion + ' installed.'))
+  }
+
+  try {
+    // 📖 Force install from npm registry (ignore local cache).
+    // 📖 If the global install path is not writable, go straight to sudo instead of
+    // 📖 letting npm print a long EACCES stack first.
+    installUpdateCommand(latestVersion, needsSudo && sudoAvailable)
     console.log()
-    console.log(chalk.dim('  🔄 Restarting with new version...'))
+    console.log(chalk.green(`  ✅ Update complete! Version ${latestVersion} installed.`))
     console.log()
-
-    // 📖 Relaunch automatically with the same arguments
-    const args = process.argv.slice(2)
-    execSync(`node ${process.argv[1]} ${args.join(' ')}`, { stdio: 'inherit' })
-    process.exit(0)
+    relaunchCurrentProcess()
+    return
   } catch (err) {
     console.log()
-    // 📖 Check if error is permission-related (EACCES or EPERM)
-    const isPermissionError = err.code === 'EACCES' || err.code === 'EPERM' ||
-                             (err.stderr && (err.stderr.includes('EACCES') || err.stderr.includes('permission') ||
-                                              err.stderr.includes('EACCES'))) ||
-                             (err.message && (err.message.includes('EACCES') || err.message.includes('permission')))
-
-    if (isPermissionError) {
-      console.log(chalk.yellow('  ⚠️ Permission denied. Retrying with sudo...'))
+    if (isPermissionError(err) && !needsSudo && sudoAvailable) {
+      console.log(chalk.yellow('  ⚠ Permission denied during npm global install. Retrying with sudo...'))
       console.log()
       try {
-        execSync(`sudo npm i -g free-coding-models@${latestVersion} --prefer-online`, { stdio: 'inherit' })
-        console.log()
-        console.log(chalk.green('  ✅ Update complete with sudo! Version ' + latestVersion + ' installed.'))
+        installUpdateCommand(latestVersion, true)
         console.log()
-        console.log(chalk.dim('  🔄 Restarting with new version...'))
+        console.log(chalk.green(`  ✅ Update complete with sudo! Version ${latestVersion} installed.`))
         console.log()
-
-        // 📖 Relaunch automatically with the same arguments
-        const args = process.argv.slice(2)
-        execSync(`node ${process.argv[1]} ${args.join(' ')}`, { stdio: 'inherit' })
-        process.exit(0)
-      } catch (sudoErr) {
+        relaunchCurrentProcess()
+        return
+      } catch {
         console.log()
         console.log(chalk.red('  ✖ Update failed even with sudo. Try manually:'))
         console.log(chalk.dim('    sudo npm i -g free-coding-models@' + latestVersion))
         console.log()
       }
+    } else if (isPermissionError(err) && !sudoAvailable && process.platform !== 'win32') {
+      console.log(chalk.red('  ✖ Update failed due to permissions and `sudo` is not available in PATH.'))
+      console.log(chalk.dim(`    Try manually with your system's privilege escalation tool for free-coding-models@${latestVersion}.`))
+      console.log()
     } else {
       console.log(chalk.red('  ✖ Update failed. Try manually: npm i -g free-coding-models@' + latestVersion))
       console.log()

package/src/utils.js

@@ -385,11 +385,15 @@ export function findBestModel(results) {
 //
 // 📖 Argument types:
 //   - API key: first positional arg that doesn't start with "--" (e.g., "nvapi-xxx")
-//   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --openclaw, --no-telemetry (case-insensitive)
+//   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --openclaw,
+//     --aider, --crush, --goose, --claude-code, --codex, --gemini, --qwen,
+//     --openhands, --amp, --pi, --no-telemetry (case-insensitive)
 //   - Value flag: --tier <letter> (the next non-flag arg is the tier value)
 //
 // 📖 Returns:
-//   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode, noTelemetry, tierFilter }
+//   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode,
+//     aiderMode, crushMode, gooseMode, claudeCodeMode, codexMode, geminiMode,
+//     qwenMode, openHandsMode, ampMode, piMode, noTelemetry, tierFilter }
 //
 // 📖 Note: apiKey may be null here — the main CLI falls back to env vars and saved config.
 export function parseArgs(argv) {
@@ -428,7 +432,18 @@ export function parseArgs(argv) {
   const openCodeMode = flags.includes('--opencode')
   const openCodeDesktopMode = flags.includes('--opencode-desktop')
   const openClawMode = flags.includes('--openclaw')
+  const aiderMode = flags.includes('--aider')
+  const crushMode = flags.includes('--crush')
+  const gooseMode = flags.includes('--goose')
+  const claudeCodeMode = flags.includes('--claude-code')
+  const codexMode = flags.includes('--codex')
+  const geminiMode = flags.includes('--gemini')
+  const qwenMode = flags.includes('--qwen')
+  const openHandsMode = flags.includes('--openhands')
+  const ampMode = flags.includes('--amp')
+  const piMode = flags.includes('--pi')
   const noTelemetry = flags.includes('--no-telemetry')
+  const cleanProxyMode = flags.includes('--clean-proxy') || flags.includes('--proxy-clean')
 
   let tierFilter = tierValueIdx !== -1 ? args[tierValueIdx].toUpperCase() : null
 
@@ -437,7 +452,29 @@ export function parseArgs(argv) {
   // 📖 --recommend — launch directly into Smart Recommend mode (Q key equivalent)
   const recommendMode = flags.includes('--recommend')
 
-  return { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode, noTelemetry, tierFilter, profileName, recommendMode }
+  return {
+    apiKey,
+    bestMode,
+    fiableMode,
+    openCodeMode,
+    openCodeDesktopMode,
+    openClawMode,
+    aiderMode,
+    crushMode,
+    gooseMode,
+    claudeCodeMode,
+    codexMode,
+    geminiMode,
+    qwenMode,
+    openHandsMode,
+    ampMode,
+    piMode,
+    noTelemetry,
+    cleanProxyMode,
+    tierFilter,
+    profileName,
+    recommendMode
+  }
 }
 
 // ─── Smart Recommend — Scoring Engine ─────────────────────────────────────────