@keelcode-ai/keelcode 0.1.9-win32-x64 → 0.1.9

package/bin/keel.cjs

@@ -0,0 +1,330 @@
+#!/usr/bin/env node
+'use strict'
+// Node shebang: npm/pnpm/yarn/bun all generate a working launcher shim from this line, on
+// every OS including Windows, because Node is present wherever those managers run. (A
+// POSIX-shell shebang would break on Windows, which has no shell to run it.) A machine with
+// Bun but no Node installs via the native curl / install.ps1 script instead, which needs no
+// runtime at all. The body is plain CommonJS and also runs unchanged under Bun.
+
+const { spawnSync } = require('node:child_process')
+const {
+  lstatSync,
+  readFileSync,
+  readdirSync,
+  realpathSync,
+  statSync,
+  symlinkSync,
+  unlinkSync,
+  writeFileSync,
+} = require('node:fs')
+const { createInterface } = require('node:readline')
+const path = require('node:path')
+
+const VERSION = "0.1.9"
+const TARGETS = {
+  "darwin-arm64": {
+    "packageName": "@keelcode-ai/keelcode-darwin-arm64",
+    "packageVersion": "0.1.9-darwin-arm64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "darwin-x64": {
+    "packageName": "@keelcode-ai/keelcode-darwin-x64",
+    "packageVersion": "0.1.9-darwin-x64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-arm64": {
+    "packageName": "@keelcode-ai/keelcode-linux-arm64",
+    "packageVersion": "0.1.9-linux-arm64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-arm64-musl": {
+    "packageName": "@keelcode-ai/keelcode-linux-arm64-musl",
+    "packageVersion": "0.1.9-linux-arm64-musl",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-x64": {
+    "packageName": "@keelcode-ai/keelcode-linux-x64",
+    "packageVersion": "0.1.9-linux-x64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-x64-musl": {
+    "packageName": "@keelcode-ai/keelcode-linux-x64-musl",
+    "packageVersion": "0.1.9-linux-x64-musl",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "win32-arm64": {
+    "packageName": "@keelcode-ai/keelcode-win32-arm64",
+    "packageVersion": "0.1.9-win32-arm64",
+    "executableName": "keelcode.exe",
+    "ripgrepExecutableName": "rg.exe"
+  },
+  "win32-x64": {
+    "packageName": "@keelcode-ai/keelcode-win32-x64",
+    "packageVersion": "0.1.9-win32-x64",
+    "executableName": "keelcode.exe",
+    "ripgrepExecutableName": "rg.exe"
+  }
+}
+const DEFAULT_ALIASES = ['keelcode', 'kc', 'kcode', 'keel']
+const ALIAS_PATTERN = /^[a-z][a-z0-9_-]{0,31}$/u
+const WINDOWS_ALIAS_MARKER = 'REM keelcode-managed-alias'
+
+function detectTargetId() {
+  const platform = process.platform
+  const arch = process.arch
+  if (platform === 'linux') {
+    let glibc = false
+    try {
+      glibc = Boolean(process.report && process.report.getReport().header.glibcVersionRuntime)
+    } catch {}
+    return 'linux-' + arch + (glibc ? '' : '-musl')
+  }
+  return platform + '-' + arch
+}
+
+function fail(message) {
+  process.stderr.write('keelcode: ' + message + '\n')
+  process.exit(1)
+}
+
+function pathEntryExists(filename) {
+  try {
+    lstatSync(filename)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function commandCandidates(directory, name) {
+  if (process.platform !== 'win32') return [path.join(directory, name)]
+  return ['.exe', '.cmd', '.ps1', ''].map((extension) => path.join(directory, name + extension))
+}
+
+function findLauncherBinDirectory() {
+  const launcher = realpathSync(__filename)
+  let windowsFallback
+  for (const directory of (process.env.PATH || '').split(path.delimiter).filter(Boolean)) {
+    for (const name of DEFAULT_ALIASES) {
+      for (const candidate of commandCandidates(directory, name)) {
+        if (!pathEntryExists(candidate)) continue
+        if (process.platform !== 'win32') {
+          try {
+            if (realpathSync(candidate) === launcher) return { directory, command: path.basename(candidate) }
+          } catch {}
+          continue
+        }
+
+        windowsFallback ||= { directory, command: path.basename(candidate) }
+        if (!/\.(?:cmd|ps1)$/iu.test(candidate)) continue
+        try {
+          const shim = readFileSync(candidate, 'utf8').replaceAll('\\', '/')
+          const expected = __filename.replaceAll('\\', '/')
+          if (shim.includes(expected) || shim.includes('node_modules/keelcode/bin/keelcode.cjs')) {
+            return { directory, command: path.basename(candidate) }
+          }
+        } catch {}
+      }
+    }
+  }
+  if (windowsFallback) return windowsFallback
+  fail('could not find the active package-manager bin directory on PATH')
+}
+
+function validateAliasName(name) {
+  if (DEFAULT_ALIASES.includes(name)) fail('"' + name + '" is a built-in alias and cannot be changed')
+  if (!ALIAS_PATTERN.test(name)) {
+    fail('alias "' + name + '" must start with a lowercase letter and contain only lowercase letters, digits, - or _ (32 characters max)')
+  }
+}
+
+function aliasConflicts(directory, name) {
+  return commandCandidates(directory, name).some(pathEntryExists)
+}
+
+function addAliases(names) {
+  const aliases = [...new Set(names)]
+  if (aliases.length === 0) fail('usage: keelcode alias add <name> [name...]')
+  for (const name of aliases) validateAliasName(name)
+
+  const location = findLauncherBinDirectory()
+  for (const name of aliases) {
+    if (aliasConflicts(location.directory, name)) {
+      fail('refusing to overwrite existing command "' + name + '" in ' + location.directory)
+    }
+  }
+
+  const created = []
+  try {
+    for (const name of aliases) {
+      if (process.platform === 'win32') {
+        const target = path.join(location.directory, location.command)
+        if (!/\.(?:exe|cmd)$/iu.test(target)) {
+          fail('the active Windows package-manager shim is not compatible with custom aliases')
+        }
+        const destination = path.join(location.directory, name + '.cmd')
+        const body = '@echo off\r\n' + WINDOWS_ALIAS_MARKER + '\r\n"%~dp0' + path.basename(target) + '" %*\r\n'
+        writeFileSync(destination, body, { flag: 'wx', mode: 0o755 })
+        created.push(destination)
+      } else {
+        const destination = path.join(location.directory, name)
+        symlinkSync(location.command, destination)
+        created.push(destination)
+      }
+    }
+  } catch (error) {
+    for (const filename of created.reverse()) {
+      try { unlinkSync(filename) } catch {}
+    }
+    fail(error instanceof Error ? error.message : String(error))
+  }
+
+  process.stdout.write('Added custom alias' + (aliases.length === 1 ? '' : 'es') + ': ' + aliases.join(', ') + '\n')
+}
+
+function managedAliases(location) {
+  const aliases = new Set()
+  for (const entry of readdirSync(location.directory)) {
+    if (process.platform === 'win32') {
+      if (!entry.toLowerCase().endsWith('.cmd')) continue
+      const name = entry.slice(0, -4)
+      if (DEFAULT_ALIASES.includes(name) || !ALIAS_PATTERN.test(name)) continue
+      try {
+        if (readFileSync(path.join(location.directory, entry), 'utf8').includes(WINDOWS_ALIAS_MARKER)) aliases.add(name)
+      } catch {}
+      continue
+    }
+
+    if (DEFAULT_ALIASES.includes(entry) || !ALIAS_PATTERN.test(entry)) continue
+    const filename = path.join(location.directory, entry)
+    try {
+      if (lstatSync(filename).isSymbolicLink() && realpathSync(filename) === realpathSync(__filename)) aliases.add(entry)
+    } catch {}
+  }
+  return [...aliases].sort()
+}
+
+function listAliases() {
+  const aliases = managedAliases(findLauncherBinDirectory())
+  process.stdout.write('Built-in aliases: ' + DEFAULT_ALIASES.join(', ') + '\n')
+  process.stdout.write('Custom aliases: ' + (aliases.length > 0 ? aliases.join(', ') : 'none') + '\n')
+}
+
+function removeAliases(names) {
+  const aliases = [...new Set(names)]
+  if (aliases.length === 0) fail('usage: keelcode alias remove <name> [name...]')
+  for (const name of aliases) validateAliasName(name)
+
+  const location = findLauncherBinDirectory()
+  const managed = new Set(managedAliases(location))
+  for (const name of aliases) {
+    if (!managed.has(name)) fail('"' + name + '" is not a Keelcode-managed custom alias')
+  }
+  for (const name of aliases) {
+    unlinkSync(path.join(location.directory, name + (process.platform === 'win32' ? '.cmd' : '')))
+  }
+  process.stdout.write('Removed custom alias' + (aliases.length === 1 ? '' : 'es') + ': ' + aliases.join(', ') + '\n')
+}
+
+function printAliasHelp() {
+  process.stdout.write([
+    'Manage Keelcode command aliases',
+    '',
+    '  keelcode alias setup',
+    '  keelcode alias list',
+    '  keelcode alias add <name> [name...]',
+    '  keelcode alias remove <name> [name...]',
+    '',
+    'Built in: ' + DEFAULT_ALIASES.join(', '),
+    'Names must start with a lowercase letter and use only a-z, 0-9, - or _.',
+    '',
+  ].join('\n'))
+}
+
+async function setupAliases() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    fail('alias setup needs an interactive terminal; use keelcode alias add <name> instead')
+  }
+  process.stdout.write('Built-in aliases are already active: ' + DEFAULT_ALIASES.join(', ') + '\n')
+  const readline = createInterface({ input: process.stdin, output: process.stdout })
+  const answer = await new Promise((resolve) => {
+    readline.question('Custom aliases (comma or space separated; blank to skip): ', resolve)
+  })
+  readline.close()
+  const aliases = String(answer).trim().split(/[\s,]+/u).filter(Boolean)
+  if (aliases.length === 0) {
+    process.stdout.write('No custom aliases added.\n')
+    return
+  }
+  addAliases(aliases)
+}
+
+async function handleAliasCommand(args) {
+  const action = args[0] || 'help'
+  if (action === 'help' || action === '--help' || action === '-h') return printAliasHelp()
+  if (action === 'setup') return setupAliases()
+  if (action === 'list') return listAliases()
+  if (action === 'add') return addAliases(args.slice(1))
+  if (action === 'remove') return removeAliases(args.slice(1))
+  fail('unknown alias action "' + action + '"; use keelcode alias --help')
+}
+
+function launchNative(args) {
+  const targetId = detectTargetId()
+  const target = TARGETS[targetId]
+  if (!target) fail('unsupported platform ' + targetId)
+
+  let manifestPath
+  try {
+    manifestPath = require.resolve(target.packageName + '/package.json')
+  } catch {
+    fail('native package ' + target.packageName + ' is missing; reinstall keelcode@' + VERSION + ' with optional dependencies enabled')
+  }
+
+  let nativeManifest
+  try {
+    nativeManifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+  } catch {
+    fail('could not read native package metadata for ' + target.packageName)
+  }
+  if (nativeManifest.name !== '@keelcode-ai/keelcode' || nativeManifest.version !== target.packageVersion) {
+    fail('native package version mismatch: expected @keelcode-ai/keelcode@' + target.packageVersion + ', found ' + (nativeManifest.name || 'unknown') + '@' + (nativeManifest.version || 'unknown'))
+  }
+
+  const packageRoot = path.dirname(manifestPath)
+  const executable = path.join(packageRoot, 'bin', target.executableName)
+  const ripgrep = path.join(packageRoot, 'bin', target.ripgrepExecutableName)
+  for (const [label, filename] of [['native executable', executable], ['ripgrep sidecar', ripgrep]]) {
+    try {
+      if (!statSync(filename).isFile()) throw new Error('not a file')
+    } catch {
+      fail(label + ' is missing from ' + target.packageName + '; reinstall keelcode')
+    }
+  }
+
+  const result = spawnSync(executable, args, {
+    stdio: 'inherit',
+    env: { ...process.env, KEELCODE_RG_PATH: ripgrep },
+    windowsHide: false,
+  })
+  if (result.error) fail(result.error.message)
+  if (result.signal && process.platform !== 'win32') process.kill(process.pid, result.signal)
+  process.exit(result.status === null ? 1 : result.status)
+}
+
+async function main() {
+  const args = process.argv.slice(2)
+  if (args[0] === 'alias') {
+    await handleAliasCommand(args.slice(1))
+    return
+  }
+  launchNative(args)
+}
+
+main().catch((error) => fail(error instanceof Error ? error.message : String(error)))

package/bin/keelcode.cjs

@@ -0,0 +1,330 @@
+#!/usr/bin/env node
+'use strict'
+// Node shebang: npm/pnpm/yarn/bun all generate a working launcher shim from this line, on
+// every OS including Windows, because Node is present wherever those managers run. (A
+// POSIX-shell shebang would break on Windows, which has no shell to run it.) A machine with
+// Bun but no Node installs via the native curl / install.ps1 script instead, which needs no
+// runtime at all. The body is plain CommonJS and also runs unchanged under Bun.
+
+const { spawnSync } = require('node:child_process')
+const {
+  lstatSync,
+  readFileSync,
+  readdirSync,
+  realpathSync,
+  statSync,
+  symlinkSync,
+  unlinkSync,
+  writeFileSync,
+} = require('node:fs')
+const { createInterface } = require('node:readline')
+const path = require('node:path')
+
+const VERSION = "0.1.9"
+const TARGETS = {
+  "darwin-arm64": {
+    "packageName": "@keelcode-ai/keelcode-darwin-arm64",
+    "packageVersion": "0.1.9-darwin-arm64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "darwin-x64": {
+    "packageName": "@keelcode-ai/keelcode-darwin-x64",
+    "packageVersion": "0.1.9-darwin-x64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-arm64": {
+    "packageName": "@keelcode-ai/keelcode-linux-arm64",
+    "packageVersion": "0.1.9-linux-arm64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-arm64-musl": {
+    "packageName": "@keelcode-ai/keelcode-linux-arm64-musl",
+    "packageVersion": "0.1.9-linux-arm64-musl",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-x64": {
+    "packageName": "@keelcode-ai/keelcode-linux-x64",
+    "packageVersion": "0.1.9-linux-x64",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "linux-x64-musl": {
+    "packageName": "@keelcode-ai/keelcode-linux-x64-musl",
+    "packageVersion": "0.1.9-linux-x64-musl",
+    "executableName": "keelcode",
+    "ripgrepExecutableName": "rg"
+  },
+  "win32-arm64": {
+    "packageName": "@keelcode-ai/keelcode-win32-arm64",
+    "packageVersion": "0.1.9-win32-arm64",
+    "executableName": "keelcode.exe",
+    "ripgrepExecutableName": "rg.exe"
+  },
+  "win32-x64": {
+    "packageName": "@keelcode-ai/keelcode-win32-x64",
+    "packageVersion": "0.1.9-win32-x64",
+    "executableName": "keelcode.exe",
+    "ripgrepExecutableName": "rg.exe"
+  }
+}
+const DEFAULT_ALIASES = ['keelcode', 'kc', 'kcode', 'keel']
+const ALIAS_PATTERN = /^[a-z][a-z0-9_-]{0,31}$/u
+const WINDOWS_ALIAS_MARKER = 'REM keelcode-managed-alias'
+
+function detectTargetId() {
+  const platform = process.platform
+  const arch = process.arch
+  if (platform === 'linux') {
+    let glibc = false
+    try {
+      glibc = Boolean(process.report && process.report.getReport().header.glibcVersionRuntime)
+    } catch {}
+    return 'linux-' + arch + (glibc ? '' : '-musl')
+  }
+  return platform + '-' + arch
+}
+
+function fail(message) {
+  process.stderr.write('keelcode: ' + message + '\n')
+  process.exit(1)
+}
+
+function pathEntryExists(filename) {
+  try {
+    lstatSync(filename)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function commandCandidates(directory, name) {
+  if (process.platform !== 'win32') return [path.join(directory, name)]
+  return ['.exe', '.cmd', '.ps1', ''].map((extension) => path.join(directory, name + extension))
+}
+
+function findLauncherBinDirectory() {
+  const launcher = realpathSync(__filename)
+  let windowsFallback
+  for (const directory of (process.env.PATH || '').split(path.delimiter).filter(Boolean)) {
+    for (const name of DEFAULT_ALIASES) {
+      for (const candidate of commandCandidates(directory, name)) {
+        if (!pathEntryExists(candidate)) continue
+        if (process.platform !== 'win32') {
+          try {
+            if (realpathSync(candidate) === launcher) return { directory, command: path.basename(candidate) }
+          } catch {}
+          continue
+        }
+
+        windowsFallback ||= { directory, command: path.basename(candidate) }
+        if (!/\.(?:cmd|ps1)$/iu.test(candidate)) continue
+        try {
+          const shim = readFileSync(candidate, 'utf8').replaceAll('\\', '/')
+          const expected = __filename.replaceAll('\\', '/')
+          if (shim.includes(expected) || shim.includes('node_modules/keelcode/bin/keelcode.cjs')) {
+            return { directory, command: path.basename(candidate) }
+          }
+        } catch {}
+      }
+    }
+  }
+  if (windowsFallback) return windowsFallback
+  fail('could not find the active package-manager bin directory on PATH')
+}
+
+function validateAliasName(name) {
+  if (DEFAULT_ALIASES.includes(name)) fail('"' + name + '" is a built-in alias and cannot be changed')
+  if (!ALIAS_PATTERN.test(name)) {
+    fail('alias "' + name + '" must start with a lowercase letter and contain only lowercase letters, digits, - or _ (32 characters max)')
+  }
+}
+
+function aliasConflicts(directory, name) {
+  return commandCandidates(directory, name).some(pathEntryExists)
+}
+
+function addAliases(names) {
+  const aliases = [...new Set(names)]
+  if (aliases.length === 0) fail('usage: keelcode alias add <name> [name...]')
+  for (const name of aliases) validateAliasName(name)
+
+  const location = findLauncherBinDirectory()
+  for (const name of aliases) {
+    if (aliasConflicts(location.directory, name)) {
+      fail('refusing to overwrite existing command "' + name + '" in ' + location.directory)
+    }
+  }
+
+  const created = []
+  try {
+    for (const name of aliases) {
+      if (process.platform === 'win32') {
+        const target = path.join(location.directory, location.command)
+        if (!/\.(?:exe|cmd)$/iu.test(target)) {
+          fail('the active Windows package-manager shim is not compatible with custom aliases')
+        }
+        const destination = path.join(location.directory, name + '.cmd')
+        const body = '@echo off\r\n' + WINDOWS_ALIAS_MARKER + '\r\n"%~dp0' + path.basename(target) + '" %*\r\n'
+        writeFileSync(destination, body, { flag: 'wx', mode: 0o755 })
+        created.push(destination)
+      } else {
+        const destination = path.join(location.directory, name)
+        symlinkSync(location.command, destination)
+        created.push(destination)
+      }
+    }
+  } catch (error) {
+    for (const filename of created.reverse()) {
+      try { unlinkSync(filename) } catch {}
+    }
+    fail(error instanceof Error ? error.message : String(error))
+  }
+
+  process.stdout.write('Added custom alias' + (aliases.length === 1 ? '' : 'es') + ': ' + aliases.join(', ') + '\n')
+}
+
+function managedAliases(location) {
+  const aliases = new Set()
+  for (const entry of readdirSync(location.directory)) {
+    if (process.platform === 'win32') {
+      if (!entry.toLowerCase().endsWith('.cmd')) continue
+      const name = entry.slice(0, -4)
+      if (DEFAULT_ALIASES.includes(name) || !ALIAS_PATTERN.test(name)) continue
+      try {
+        if (readFileSync(path.join(location.directory, entry), 'utf8').includes(WINDOWS_ALIAS_MARKER)) aliases.add(name)
+      } catch {}
+      continue
+    }
+
+    if (DEFAULT_ALIASES.includes(entry) || !ALIAS_PATTERN.test(entry)) continue
+    const filename = path.join(location.directory, entry)
+    try {
+      if (lstatSync(filename).isSymbolicLink() && realpathSync(filename) === realpathSync(__filename)) aliases.add(entry)
+    } catch {}
+  }
+  return [...aliases].sort()
+}
+
+function listAliases() {
+  const aliases = managedAliases(findLauncherBinDirectory())
+  process.stdout.write('Built-in aliases: ' + DEFAULT_ALIASES.join(', ') + '\n')
+  process.stdout.write('Custom aliases: ' + (aliases.length > 0 ? aliases.join(', ') : 'none') + '\n')
+}
+
+function removeAliases(names) {
+  const aliases = [...new Set(names)]
+  if (aliases.length === 0) fail('usage: keelcode alias remove <name> [name...]')
+  for (const name of aliases) validateAliasName(name)
+
+  const location = findLauncherBinDirectory()
+  const managed = new Set(managedAliases(location))
+  for (const name of aliases) {
+    if (!managed.has(name)) fail('"' + name + '" is not a Keelcode-managed custom alias')
+  }
+  for (const name of aliases) {
+    unlinkSync(path.join(location.directory, name + (process.platform === 'win32' ? '.cmd' : '')))
+  }
+  process.stdout.write('Removed custom alias' + (aliases.length === 1 ? '' : 'es') + ': ' + aliases.join(', ') + '\n')
+}
+
+function printAliasHelp() {
+  process.stdout.write([
+    'Manage Keelcode command aliases',
+    '',
+    '  keelcode alias setup',
+    '  keelcode alias list',
+    '  keelcode alias add <name> [name...]',
+    '  keelcode alias remove <name> [name...]',
+    '',
+    'Built in: ' + DEFAULT_ALIASES.join(', '),
+    'Names must start with a lowercase letter and use only a-z, 0-9, - or _.',
+    '',
+  ].join('\n'))
+}
+
+async function setupAliases() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    fail('alias setup needs an interactive terminal; use keelcode alias add <name> instead')
+  }
+  process.stdout.write('Built-in aliases are already active: ' + DEFAULT_ALIASES.join(', ') + '\n')
+  const readline = createInterface({ input: process.stdin, output: process.stdout })
+  const answer = await new Promise((resolve) => {
+    readline.question('Custom aliases (comma or space separated; blank to skip): ', resolve)
+  })
+  readline.close()
+  const aliases = String(answer).trim().split(/[\s,]+/u).filter(Boolean)
+  if (aliases.length === 0) {
+    process.stdout.write('No custom aliases added.\n')
+    return
+  }
+  addAliases(aliases)
+}
+
+async function handleAliasCommand(args) {
+  const action = args[0] || 'help'
+  if (action === 'help' || action === '--help' || action === '-h') return printAliasHelp()
+  if (action === 'setup') return setupAliases()
+  if (action === 'list') return listAliases()
+  if (action === 'add') return addAliases(args.slice(1))
+  if (action === 'remove') return removeAliases(args.slice(1))
+  fail('unknown alias action "' + action + '"; use keelcode alias --help')
+}
+
+function launchNative(args) {
+  const targetId = detectTargetId()
+  const target = TARGETS[targetId]
+  if (!target) fail('unsupported platform ' + targetId)
+
+  let manifestPath
+  try {
+    manifestPath = require.resolve(target.packageName + '/package.json')
+  } catch {
+    fail('native package ' + target.packageName + ' is missing; reinstall keelcode@' + VERSION + ' with optional dependencies enabled')
+  }
+
+  let nativeManifest
+  try {
+    nativeManifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+  } catch {
+    fail('could not read native package metadata for ' + target.packageName)
+  }
+  if (nativeManifest.name !== '@keelcode-ai/keelcode' || nativeManifest.version !== target.packageVersion) {
+    fail('native package version mismatch: expected @keelcode-ai/keelcode@' + target.packageVersion + ', found ' + (nativeManifest.name || 'unknown') + '@' + (nativeManifest.version || 'unknown'))
+  }
+
+  const packageRoot = path.dirname(manifestPath)
+  const executable = path.join(packageRoot, 'bin', target.executableName)
+  const ripgrep = path.join(packageRoot, 'bin', target.ripgrepExecutableName)
+  for (const [label, filename] of [['native executable', executable], ['ripgrep sidecar', ripgrep]]) {
+    try {
+      if (!statSync(filename).isFile()) throw new Error('not a file')
+    } catch {
+      fail(label + ' is missing from ' + target.packageName + '; reinstall keelcode')
+    }
+  }
+
+  const result = spawnSync(executable, args, {
+    stdio: 'inherit',
+    env: { ...process.env, KEELCODE_RG_PATH: ripgrep },
+    windowsHide: false,
+  })
+  if (result.error) fail(result.error.message)
+  if (result.signal && process.platform !== 'win32') process.kill(process.pid, result.signal)
+  process.exit(result.status === null ? 1 : result.status)
+}
+
+async function main() {
+  const args = process.argv.slice(2)
+  if (args[0] === 'alias') {
+    await handleAliasCommand(args.slice(1))
+    return
+  }
+  launchNative(args)
+}
+
+main().catch((error) => fail(error instanceof Error ? error.message : String(error)))