@lka09/wisp 0.1.0

package/bin/wisp.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const platform = process.platform;
+const arch = process.arch;
+
+// Map platform/arch to the release asset name used in GitHub Releases.
+const ASSET_NAMES = {
+  win32: { x64: 'wisp-windows-x86_64.exe', arm64: 'wisp-windows-aarch64.exe' },
+  linux: { x64: 'wisp-linux-x86_64',       arm64: 'wisp-linux-aarch64' },
+  darwin: { x64: 'wisp-darwin-x86_64',     arm64: 'wisp-darwin-aarch64' },
+};
+
+const binaryName = platform === 'win32' ? 'wisp.exe' : 'wisp';
+const binaryPath = path.join(__dirname, '..', 'dist', binaryName);
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+if (result.error) {
+  if (result.error.code === 'ENOENT') {
+    const assetName = (ASSET_NAMES[platform] || {})[arch] || '<asset-name>';
+    const pkg = require('../package.json');
+    const version = pkg.version;
+
+    console.error('Error: Wisp binary not found.');
+    console.error('');
+    console.error('  Expected path: ' + binaryPath);
+    console.error('');
+    console.error('The GitHub Release asset for v' + version + ' may be missing for this platform.');
+    console.error('Expected release asset: ' + assetName);
+    console.error('');
+    console.error('Build from source (Windows PowerShell):');
+    console.error('  cd wisp');
+    console.error('  cargo build --release');
+    console.error('  New-Item -ItemType Directory -Force -Path ..\\npm\\dist | Out-Null');
+    console.error('  Copy-Item target\\release\\wisp.exe ..\\npm\\dist\\wisp.exe');
+    console.error('');
+    console.error('Build from source (Linux / macOS):');
+    console.error('  cd wisp && cargo build --release');
+    console.error('  mkdir -p ../npm/dist');
+    console.error('  cp target/release/wisp ../npm/dist/wisp');
+    console.error('');
+    console.error('Expected release asset names:');
+    console.error('  wisp-windows-x86_64.exe   wisp-windows-aarch64.exe');
+    console.error('  wisp-linux-x86_64         wisp-linux-aarch64');
+    console.error('  wisp-darwin-x86_64        wisp-darwin-aarch64');
+    process.exit(1);
+  }
+  console.error('Error: ' + result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status !== null ? result.status : 0);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@lka09/wisp",
+  "version": "0.1.0",
+  "description": "A local personal coding agent for Claude and Codex CLI.",
+  "bin": {
+    "wisp": "./bin/wisp.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "build": "node scripts/build.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "scripts",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LKA09/Wisp"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "claude",
+    "codex",
+    "coding-agent",
+    "orchestrator"
+  ]
+}

package/scripts/build.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Build helper — compiles the Rust binary and copies it into npm/dist/.
+ * Run from the repo root: node npm/scripts/build.js
+ * Or via: npm run build
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const repoRoot = path.join(__dirname, '..', '..');
+const crateDir = path.join(repoRoot, 'wisp');
+const distDir = path.join(__dirname, '..', 'dist');
+
+const isWin = process.platform === 'win32';
+const binaryName = isWin ? 'wisp.exe' : 'wisp';
+const releaseBin = path.join(crateDir, 'target', 'release', binaryName);
+
+// 1. Build
+console.log('[wisp] Building Rust binary (cargo build --release)...');
+try {
+  execSync('cargo build --release', { cwd: crateDir, stdio: 'inherit' });
+} catch (e) {
+  console.error('[wisp] cargo build failed. Is Rust installed? https://rustup.rs/');
+  process.exit(1);
+}
+
+// 2. Copy (retry on Windows EBUSY — antivirus/linker may briefly lock the file)
+fs.mkdirSync(distDir, { recursive: true });
+const dest = path.join(distDir, binaryName);
+
+function copyWithRetry(src, dst, attempts = 5, delayMs = 500) {
+  for (let i = 0; i < attempts; i++) {
+    try {
+      fs.copyFileSync(src, dst);
+      return;
+    } catch (e) {
+      if (e.code === 'EBUSY' && i < attempts - 1) {
+        const wait = delayMs * (i + 1);
+        console.log(`[wisp] File busy, retrying in ${wait}ms... (${i + 1}/${attempts - 1})`);
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, wait);
+      } else {
+        throw e;
+      }
+    }
+  }
+}
+
+copyWithRetry(releaseBin, dest);
+
+if (!isWin) {
+  fs.chmodSync(dest, 0o755);
+}
+
+console.log(`[wisp] Binary copied to ${path.relative(repoRoot, dest)}`);
+console.log('[wisp] Done. Run `wisp` or `cd npm && npm link` to install globally.');

package/scripts/postinstall.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Wisp postinstall — downloads the platform-appropriate binary from GitHub Releases.
+ * Skips silently if the binary already exists (local development / manual build).
+ * Never hard-fails npm install; only warns on download errors.
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const pkg = require('../package.json');
+const version = pkg.version;
+const distDir = path.join(__dirname, '..', 'dist');
+const binaryName = process.platform === 'win32' ? 'wisp.exe' : 'wisp';
+const binaryPath = path.join(distDir, binaryName);
+
+// Already installed (local dev or previous run) — skip.
+if (fs.existsSync(binaryPath)) {
+  console.log('[wisp] Binary already present, skipping download.');
+  process.exit(0);
+}
+
+// Map Node platform/arch to Rust target triples used in release asset names.
+const PLATFORM_MAP = {
+  darwin:  'darwin',
+  linux:   'linux',
+  win32:   'windows',
+};
+const ARCH_MAP = {
+  x64:   'x86_64',
+  arm64: 'aarch64',
+};
+
+const plat = PLATFORM_MAP[process.platform];
+const arch = ARCH_MAP[process.arch];
+
+if (!plat || !arch) {
+  warn(`Unsupported platform: ${process.platform}-${process.arch}`);
+  process.exit(0);
+}
+
+const ext = process.platform === 'win32' ? '.exe' : '';
+const assetName = `wisp-${plat}-${arch}${ext}`;
+const repoOwner = 'LKA09';
+const repoName = 'Wisp';
+const downloadUrl =
+  `https://github.com/${repoOwner}/${repoName}/releases/download/v${version}/${assetName}`;
+
+console.log(`[wisp] Downloading v${version} for ${process.platform}-${process.arch}...`);
+console.log(`[wisp] ${downloadUrl}`);
+
+fs.mkdirSync(distDir, { recursive: true });
+
+get(downloadUrl, (err, data) => {
+  if (err) {
+    warn(`Download failed: ${err.message}`);
+    warn('');
+    warn(`Expected release asset: ${assetName}`);
+    warn(`Release URL checked: ${downloadUrl}`);
+    warn('');
+    warn('The GitHub Release asset may be missing for this version/platform.');
+    warn('');
+    warn('Build from source (Windows PowerShell):');
+    warn('  cd wisp');
+    warn('  cargo build --release');
+    warn('  New-Item -ItemType Directory -Force -Path ..\\npm\\dist | Out-Null');
+    warn('  Copy-Item target\\release\\wisp.exe ..\\npm\\dist\\wisp.exe');
+    warn('');
+    warn('Build from source (Linux / macOS):');
+    warn('  cd wisp && cargo build --release');
+    warn('  mkdir -p ../npm/dist && cp target/release/wisp ../npm/dist/wisp');
+    warn('');
+    warn('Expected release asset names:');
+    warn('  wisp-windows-x86_64.exe   wisp-windows-aarch64.exe');
+    warn('  wisp-linux-x86_64         wisp-linux-aarch64');
+    warn('  wisp-darwin-x86_64        wisp-darwin-aarch64');
+    process.exit(0);
+  }
+
+  fs.writeFileSync(binaryPath, data);
+
+  if (process.platform !== 'win32') {
+    fs.chmodSync(binaryPath, 0o755);
+  }
+
+  console.log('[wisp] Installed successfully.');
+});
+
+// ─── helpers ──────────────────────────────────────────────────────────────────
+
+function warn(msg) {
+  console.warn('[wisp] ' + msg);
+}
+
+/** HTTP GET with redirect following (GitHub releases redirect to S3). */
+function get(url, callback, redirects = 0) {
+  if (redirects > 5) {
+    callback(new Error('Too many redirects'));
+    return;
+  }
+
+  https.get(url, { headers: { 'User-Agent': 'wisp-postinstall' } }, (res) => {
+    if (res.statusCode === 301 || res.statusCode === 302) {
+      get(res.headers.location, callback, redirects + 1);
+      return;
+    }
+    if (res.statusCode !== 200) {
+      callback(new Error(`HTTP ${res.statusCode} from ${url}`));
+      return;
+    }
+
+    const chunks = [];
+    res.on('data', (c) => chunks.push(c));
+    res.on('end', () => callback(null, Buffer.concat(chunks)));
+    res.on('error', callback);
+  }).on('error', callback);
+}