krasavacode 0.1.0 → 0.2.1

package/README.md

@@ -4,23 +4,56 @@
 
 ## Установка и запуск
 
-**Один способ:**
+### Вариант А — у меня есть Node.js
 
 ```bash
 npx krasavacode
 ```
 
-Всё. Pollinations работает без логина и без карты, лимитов хватит на 2–5 учебных MVP.
+Всё. Pollinations работает без логина и без карты. Если у тебя Node старее 20 — наш CLI сам подтянет нужную версию.
 
-При первой команде ставится локальный gateway и Claude Code (один раз, ~30 сек). Потом запуск моментальный.
+### Вариант Б — у меня нет ничего
 
-## Если хочешь больше моделей
+Скачай готовый бинарник из последнего релиза:
+**https://github.com/alexrexby/krasavacode/releases/latest**
+
+| Твоя ОС | Файл |
+|---|---|
+| Windows | `krasavacode.exe` |
+| macOS Apple Silicon (M1/M2/M3/M4) | `krasavacode-mac-arm64` |
+| macOS Intel | `krasavacode-mac-x64` |
+| Linux x64 | `krasavacode-linux-x64` |
+
+После скачивания — открой терминал в папке со скачанным файлом и запусти:
+
+**Windows:**
+```
+krasavacode.exe
+```
+Если выскочит «Windows protected your PC» → жми **More info** → **Run anyway**.
+
+**macOS:**
+```bash
+chmod +x krasavacode-mac-arm64
+xattr -d com.apple.quarantine krasavacode-mac-arm64   # снимает блок Gatekeeper
+./krasavacode-mac-arm64
+```
+
+**Linux:**
+```bash
+chmod +x krasavacode-linux-x64
+./krasavacode-linux-x64
+```
+
+При первом запуске бинарник скачает Node.js и Claude Code в `~/.krasavacode/` (≈100 МБ, один раз). Дальше — мгновенно.
+
+## Если хочется моделей помощнее
 
 ```bash
 npx krasavacode upgrade
 ```
 
-Откроется дашборд в браузере. Там одним кликом подключишь:
+Откроется дашборд OmniRoute в браузере. Подключи одним кликом:
 - **Kiro AI** — Claude Sonnet/Haiku через AWS Builder ID
 - **Qoder** — Kimi K2 / Qwen3-Coder / DeepSeek-R1
 - **Qwen Code** — 4 модели Alibaba
@@ -34,31 +67,19 @@ npx krasavacode upgrade
 npx krasavacode doctor
 ```
 
-Покажет, что сломано. Самые частые проблемы:
-- **Старый Node.js** → обнови до 20+ с https://nodejs.org
-- **Порт занят** → перезапусти терминал
-- **Корпоративный прокси/Россия/Китай** → запусти upgrade и в дашборде включи SOCKS5
+Покажет что сломано. Самые частые проблемы:
+- **Корпоративный прокси / Россия / Китай** → запусти upgrade и в дашборде включи SOCKS5
+- **Порт 3456 занят** → перезапусти терминал
 
 ## Что под капотом
 
 ```
-krasavacode  →  локальный OmniRoute  →  Pollinations / Kiro / Qoder / …
-                (free gateway, MIT)     (free providers без карты)
+krasavacode  →  claude-code-router (порт 3456)  →  Pollinations
+                (Anthropic ↔ OpenAI bridge)        (free, no API key)
 ```
 
-CLI = `@anthropic-ai/claude-code` с подменённым backend. Все обновления Claude Code от Anthropic прилетают автоматом.
-
-## Бинарники без Node.js
-
-Для уроков с непрофильными студентами — скачай готовый бинарник со страницы релиза:
-- `krasavacode.exe` (Windows)
-- `krasavacode-mac-arm64`, `krasavacode-mac-x64` (macOS)
-- `krasavacode-linux-x64` (Linux)
-
-Дабл-клик → откроется терминал с Claude Code. Node.js не нужен.
-
-> Замечание: бинарники тащат portable Node при первом запуске (~30 МБ, один раз). После — работают офлайн.
+CLI = `@anthropic-ai/claude-code` с подменённым `ANTHROPIC_BASE_URL`. Все обновления Claude Code от Anthropic прилетают автоматом.
 
 ## Лицензия
 
-MIT. Pollinations / Kiro AI / Qoder / другие провайдеры имеют свои ToS — читай их условия. На свой риск.
+MIT. Pollinations / Kiro AI / Qoder / другие провайдеры имеют свои ToS — читай их условия.

package/bin/krasavacode.js

@@ -6,18 +6,16 @@ import { launchClaude } from '../src/launch.js';
 import { runUpgrade } from '../src/upgrade.js';
 import { runDoctor } from '../src/doctor.js';
 
+// Hardcoded so it works inside Bun --compile (no FS access to package.json)
+const VERSION = '0.2.1';
+
 const cmd = process.argv[2];
 
 async function main() {
   if (cmd === 'doctor') return runDoctor();
   if (cmd === 'upgrade') return runUpgrade();
   if (cmd === '--version' || cmd === '-v') {
-    const { readFile } = await import('node:fs/promises');
-    const { fileURLToPath } = await import('node:url');
-    const { dirname, join } = await import('node:path');
-    const here = dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(await readFile(join(here, '..', 'package.json'), 'utf8'));
-    console.log(`KRASAVACODE v${pkg.version}`);
+    console.log(`KRASAVACODE v${VERSION}`);
     return;
   }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "krasavacode",
-  "version": "0.1.0",
-  "description": "KRASAVACODE — однокнопочный бесплатный вайбкодинг для учеников. Claude Code на бесплатных провайдерах через локальный gateway.",
+  "version": "0.2.1",
+  "description": "KRASAVACODE — однокнопочный бесплатный вайбкодинг для учеников. Claude Code на бесплатных провайдерах через локальный gateway. Сам ставит Node при необходимости.",
   "type": "module",
   "bin": {
     "krasavacode": "bin/krasavacode.js"
@@ -27,5 +27,13 @@
     "free",
     "education"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alexrexby/krasavacode.git"
+  },
+  "homepage": "https://github.com/alexrexby/krasavacode#readme",
+  "bugs": {
+    "url": "https://github.com/alexrexby/krasavacode/issues"
+  }
 }

package/src/hub.js

@@ -41,6 +41,7 @@ export async function startHub(paths) {
   const child = spawn(paths.ccrBin, ['start'], {
     stdio: process.env.KRASAVACODE_DEBUG ? 'inherit' : 'pipe',
     detached: false,
+    env: paths.env,
   });
 
   let stderrTail = '';

package/src/launch.js

@@ -26,9 +26,12 @@ export async function launchClaude(paths, hub /*, detection */) {
   console.log('━'.repeat(58));
   console.log('');
 
+  // Merge env from runtime (PATH with bundled Node when applicable) with our overrides
+  const finalEnv = { ...(paths.env || process.env), ...env };
+
   return new Promise((resolve, reject) => {
     const child = spawn(paths.claudeBin, passthroughArgs, {
-      env,
+      env: finalEnv,
       stdio: 'inherit',
     });
 

package/src/node-installer.js

@@ -0,0 +1,159 @@
+import { spawn } from 'node:child_process';
+import { mkdir, writeFile, access, chmod } from 'node:fs/promises';
+import { homedir, platform, arch, tmpdir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { createWriteStream } from 'node:fs';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+
+const NODE_VERSION = '22.11.0'; // pinned LTS — bumped only when we test it
+const ROOT = join(homedir(), '.krasavacode');
+const NODE_DIR = join(ROOT, 'runtime', 'node');
+
+function exists(p) { return access(p).then(() => true).catch(() => false); }
+
+function spawnP(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const c = spawn(cmd, args, { stdio: 'pipe', ...opts });
+    let stderr = '';
+    c.stderr?.on('data', d => stderr += d);
+    c.on('error', reject);
+    c.on('exit', code => code === 0 ? resolve() : reject(new Error(`${cmd} exited ${code}: ${stderr}`)));
+  });
+}
+
+/**
+ * Returns descriptors for the Node distribution we should fetch.
+ *   { url, archive, binDir, ext }
+ */
+function pickDistribution() {
+  const p = platform();
+  const a = arch();
+
+  let nodePlatform, nodeArch, ext;
+  if (p === 'darwin') {
+    nodePlatform = 'darwin';
+    nodeArch = a === 'arm64' ? 'arm64' : 'x64';
+    ext = 'tar.gz';
+  } else if (p === 'linux') {
+    nodePlatform = 'linux';
+    nodeArch = a === 'arm64' ? 'arm64' : 'x64';
+    ext = 'tar.xz';
+  } else if (p === 'win32') {
+    nodePlatform = 'win';
+    nodeArch = 'x64';
+    ext = 'zip';
+  } else {
+    throw new Error(`Неподдерживаемая платформа: ${p}/${a}`);
+  }
+
+  const archive = `node-v${NODE_VERSION}-${nodePlatform}-${nodeArch}`;
+  const url = `https://nodejs.org/dist/v${NODE_VERSION}/${archive}.${ext}`;
+  return { url, archive, ext };
+}
+
+function bundledPaths() {
+  const p = platform();
+  if (p === 'win32') {
+    return {
+      node: join(NODE_DIR, 'node.exe'),
+      npm: join(NODE_DIR, 'npm.cmd'),
+      binDir: NODE_DIR,
+    };
+  }
+  return {
+    node: join(NODE_DIR, 'bin', 'node'),
+    npm: join(NODE_DIR, 'bin', 'npm'),
+    binDir: join(NODE_DIR, 'bin'),
+  };
+}
+
+async function downloadFile(url, dest) {
+  process.stdout.write(`📥 Тяну Node.js v${NODE_VERSION} (≈30 МБ, один раз)… `);
+  const t0 = Date.now();
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`HTTP ${res.status} от ${url}`);
+  await mkdir(dirname(dest), { recursive: true });
+  await pipeline(Readable.fromWeb(res.body), createWriteStream(dest));
+  console.log(`OK (${((Date.now() - t0) / 1000).toFixed(1)}s)`);
+}
+
+async function extractArchive(archivePath, ext, destDir) {
+  process.stdout.write('📂 Распаковываю… ');
+  await mkdir(destDir, { recursive: true });
+
+  if (ext === 'zip') {
+    // Windows 10+ has tar.exe with zip support; fall back to PowerShell.
+    try {
+      await spawnP('tar', ['-xf', archivePath, '-C', destDir]);
+    } catch {
+      await spawnP('powershell', ['-NoProfile', '-Command',
+        `Expand-Archive -Force -Path '${archivePath}' -DestinationPath '${destDir}'`]);
+    }
+  } else if (ext === 'tar.gz') {
+    await spawnP('tar', ['-xzf', archivePath, '-C', destDir]);
+  } else if (ext === 'tar.xz') {
+    // System tar usually has xz support; if not, this throws and we surface it.
+    await spawnP('tar', ['-xJf', archivePath, '-C', destDir]);
+  }
+  console.log('OK');
+}
+
+/**
+ * The archive extracts to a directory like `node-v22.11.0-darwin-arm64/`.
+ * We want everything in NODE_DIR directly. Move contents up.
+ */
+async function flatten(parentDir, archiveName) {
+  const { rename, readdir, rm } = await import('node:fs/promises');
+  const inner = join(parentDir, archiveName);
+  if (!(await exists(inner))) return; // already flat
+  const entries = await readdir(inner);
+  for (const e of entries) {
+    await rename(join(inner, e), join(parentDir, e));
+  }
+  await rm(inner, { recursive: true, force: true });
+}
+
+/**
+ * Install bundled Node into ~/.krasavacode/runtime/node/ if not already.
+ * Returns absolute paths to node and npm binaries.
+ */
+export async function ensureBundledNode() {
+  const paths = bundledPaths();
+
+  if (await exists(paths.node)) return paths;
+
+  const { url, archive, ext } = pickDistribution();
+  const archivePath = join(tmpdir(), `${archive}.${ext}`);
+
+  await downloadFile(url, archivePath);
+  await extractArchive(archivePath, ext, NODE_DIR);
+  await flatten(NODE_DIR, archive);
+
+  // Make sure binaries are executable on POSIX
+  if (platform() !== 'win32') {
+    try {
+      await chmod(paths.node, 0o755);
+      await chmod(paths.npm, 0o755);
+    } catch {}
+  }
+
+  return paths;
+}
+
+/**
+ * Ask system Node for its version. Returns major version (number) or null.
+ */
+export async function systemNodeMajor() {
+  return new Promise(resolve => {
+    const c = spawn('node', ['--version'], { stdio: 'pipe' });
+    let out = '';
+    c.stdout.on('data', d => out += d);
+    c.on('error', () => resolve(null));
+    c.on('exit', code => {
+      if (code !== 0) return resolve(null);
+      const m = out.trim().match(/^v(\d+)/);
+      resolve(m ? Number(m[1]) : null);
+    });
+  });
+}

package/src/runtime.js

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process';
 import { mkdir, access, readFile, writeFile } from 'node:fs/promises';
 import { homedir, platform } from 'node:os';
 import { join } from 'node:path';
+import { ensureBundledNode, systemNodeMajor } from './node-installer.js';
 
 const ROOT = join(homedir(), '.krasavacode');
 const RUNTIME = join(ROOT, 'runtime');
@@ -17,11 +18,8 @@ function exists(path) {
 }
 
 async function readState() {
-  try {
-    return JSON.parse(await readFile(STATE_FILE, 'utf8'));
-  } catch {
-    return {};
-  }
+  try { return JSON.parse(await readFile(STATE_FILE, 'utf8')); }
+  catch { return {}; }
 }
 
 async function writeState(state) {
@@ -44,17 +42,21 @@ function spawnCmd(cmd, args, opts = {}) {
   });
 }
 
-async function ensureNpm() {
-  try {
-    await spawnCmd('npm', ['--version'], { silent: true });
-  } catch {
-    throw new Error(
-      'npm не найден в PATH. Установи Node.js (≥20) с https://nodejs.org и перезапусти терминал.'
-    );
+/**
+ * Decide which Node/npm to use:
+ *   1. System Node ≥ 20 — use system npm (no download).
+ *   2. Otherwise — install bundled Node into ~/.krasavacode/runtime/node/ and use it.
+ */
+async function pickNode() {
+  const major = await systemNodeMajor();
+  if (major !== null && major >= 20) {
+    return { source: 'system', node: 'node', npm: 'npm', binDir: null };
   }
+  const bundled = await ensureBundledNode();
+  return { source: 'bundled', node: bundled.node, npm: bundled.npm, binDir: bundled.binDir };
 }
 
-async function installPackages() {
+async function installPackages(npmCmd, env) {
   console.log('📦 Устанавливаю компоненты (один раз)…');
   await mkdir(RUNTIME, { recursive: true });
 
@@ -68,14 +70,14 @@ async function installPackages() {
     }, null, 2));
   }
 
-  await spawnCmd('npm', [
+  await spawnCmd(npmCmd, [
     'install',
     '--prefix', RUNTIME,
     '--no-audit',
     '--no-fund',
     '--loglevel=error',
     ...REQUIRED_PACKAGES,
-  ]);
+  ], { env });
 }
 
 function binPath(name) {
@@ -84,9 +86,19 @@ function binPath(name) {
 }
 
 export async function ensureRuntime() {
-  await ensureNpm();
   await mkdir(ROOT, { recursive: true });
 
+  const node = await pickNode();
+
+  // Build env that all child processes (npm install, ccr, claude) inherit.
+  // For bundled mode, bundled Node must come first in PATH so that
+  // shebangs `#!/usr/bin/env node` resolve to our Node.
+  const env = { ...process.env };
+  if (node.source === 'bundled' && node.binDir) {
+    const sep = platform() === 'win32' ? ';' : ':';
+    env.PATH = `${node.binDir}${sep}${process.env.PATH || ''}`;
+  }
+
   const state = await readState();
   const ccrBin = binPath('ccr');
   const claudeBin = binPath('claude');
@@ -95,8 +107,9 @@ export async function ensureRuntime() {
   const haveClaude = await exists(claudeBin);
 
   if (!haveCcr || !haveClaude || !state.installedAt) {
-    await installPackages();
+    await installPackages(node.npm, env);
     state.installedAt = new Date().toISOString();
+    state.nodeSource = node.source;
     await writeState(state);
     console.log('✅ Готово.\n');
   }
@@ -106,6 +119,10 @@ export async function ensureRuntime() {
     runtime: RUNTIME,
     ccrBin,
     claudeBin,
+    nodeBin: node.node,
+    nodeSource: node.source,
+    pathPrefix: node.binDir,
+    env,
     state,
     saveState: writeState,
   };