@spenceriam/impulse 0.15.0 → 0.15.3

package/bin/impulse

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+import { spawn } from "child_process";
+import { existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+import os from "os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+function detectPlatformAndArch() {
+  let platform;
+  switch (os.platform()) {
+    case "darwin":
+      platform = "darwin";
+      break;
+    case "linux":
+      platform = "linux";
+      break;
+    case "win32":
+      platform = "windows";
+      break;
+    default:
+      platform = os.platform();
+      break;
+  }
+
+  let arch;
+  switch (os.arch()) {
+    case "x64":
+      arch = "x64";
+      break;
+    case "arm64":
+      arch = "arm64";
+      break;
+    default:
+      arch = os.arch();
+      break;
+  }
+
+  return { platform, arch };
+}
+
+function findBinary() {
+  const { platform, arch } = detectPlatformAndArch();
+  const packageName = `@spenceriam/impulse-${platform}-${arch}`;
+  const binaryName = platform === "windows" ? "impulse.exe" : "impulse";
+
+  try {
+    const packageJsonPath = require.resolve(`${packageName}/package.json`);
+    const packageDir = dirname(packageJsonPath);
+    const binaryPath = join(packageDir, "bin", binaryName);
+
+    if (!existsSync(binaryPath)) {
+      throw new Error(`Binary not found at ${binaryPath}`);
+    }
+
+    return binaryPath;
+  } catch (error) {
+    // Check if symlinked binary exists in same directory
+    const localBinary = join(__dirname, binaryName);
+    if (existsSync(localBinary)) {
+      return localBinary;
+    }
+    
+    throw new Error(
+      `Could not find IMPULSE binary for ${platform}-${arch}.\n` +
+      `Package ${packageName} may not be installed.\n` +
+      `Try reinstalling: npm install -g @spenceriam/impulse`
+    );
+  }
+}
+
+try {
+  const binaryPath = findBinary();
+  
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  child.on("error", (err) => {
+    console.error("Failed to start IMPULSE:", err.message);
+    process.exit(1);
+  });
+
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}

package/package.json

@@ -1,64 +1,30 @@
 {
   "name": "@spenceriam/impulse",
-  "version": "0.15.0",
-  "private": false,
-  "description": "Terminal-based AI coding agent powered by Z.ai's Coding Plan - the best cost/engineering ratio for builders",
-  "type": "module",
-  "scripts": {
-    "dev": "bun run --watch src/index.tsx",
-    "build": "bun run scripts/build.ts",
-    "start": "bun run dist/index.js",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@opentui/core": "^0.1.74",
-    "@opentui/solid": "^0.1.74",
-    "diff": "^8.0.3",
-    "openai": "^4.73.0",
-    "semver": "^7.7.3",
-    "solid-js": "^1.9.0",
-    "zod": "^3.24.0",
-    "zod-to-json-schema": "^3.25.1"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.6",
-    "@types/diff": "^8.0.0",
-    "@types/node": "^22.10.0",
-    "@types/semver": "^7.7.1",
-    "typescript": "^5.7.0"
-  },
+  "version": "0.15.3",
+  "description": "Terminal-based AI coding agent powered by Z.ai's Coding Plan",
+  "license": "MIT",
   "bin": {
-    "impulse": "dist/index.js"
+    "impulse": "./bin/impulse"
   },
-  "files": [
-    "dist/**/*"
-  ],
-  "publishConfig": {
-    "access": "public"
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs"
   },
-  "keywords": [
-    "ai",
-    "cli",
-    "impulse",
-    "terminal",
-    "coding",
-    "agent",
-    "glm",
-    "z-ai",
-    "coding-plan"
-  ],
-  "author": "Spencer Francisco",
-  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/spenceriam/impulse.git"
   },
   "homepage": "https://github.com/spenceriam/impulse#readme",
-  "bugs": {
-    "url": "https://github.com/spenceriam/impulse/issues"
+  "keywords": ["ai", "cli", "impulse", "terminal", "coding", "agent"],
+  "author": "Spencer Francisco",
+  "files": ["bin/*", "postinstall.mjs"],
+  "publishConfig": {
+    "access": "public"
   },
-  "engines": {
-    "node": ">=18.0.0"
+  "optionalDependencies": {
+    "@spenceriam/impulse-linux-x64": "0.15.3",
+    "@spenceriam/impulse-linux-arm64": "0.15.3",
+    "@spenceriam/impulse-darwin-x64": "0.15.3",
+    "@spenceriam/impulse-darwin-arm64": "0.15.3",
+    "@spenceriam/impulse-windows-x64": "0.15.3"
   }
 }

package/postinstall.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+function detectPlatformAndArch() {
+  let platform;
+  switch (os.platform()) {
+    case "darwin":
+      platform = "darwin";
+      break;
+    case "linux":
+      platform = "linux";
+      break;
+    case "win32":
+      platform = "windows";
+      break;
+    default:
+      platform = os.platform();
+      break;
+  }
+
+  let arch;
+  switch (os.arch()) {
+    case "x64":
+      arch = "x64";
+      break;
+    case "arm64":
+      arch = "arm64";
+      break;
+    default:
+      arch = os.arch();
+      break;
+  }
+
+  return { platform, arch };
+}
+
+function findBinary() {
+  const { platform, arch } = detectPlatformAndArch();
+  const packageName = `@spenceriam/impulse-${platform}-${arch}`;
+  const binaryName = platform === "windows" ? "impulse.exe" : "impulse";
+
+  try {
+    const packageJsonPath = require.resolve(`${packageName}/package.json`);
+    const packageDir = path.dirname(packageJsonPath);
+    const binaryPath = path.join(packageDir, "bin", binaryName);
+
+    if (!fs.existsSync(binaryPath)) {
+      throw new Error(`Binary not found at ${binaryPath}`);
+    }
+
+    return { binaryPath, binaryName };
+  } catch (error) {
+    throw new Error(`Could not find package ${packageName}: ${error.message}`);
+  }
+}
+
+function prepareBinDirectory(binaryName) {
+  const binDir = path.join(__dirname, "bin");
+  const targetPath = path.join(binDir, binaryName);
+
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  if (fs.existsSync(targetPath)) {
+    fs.unlinkSync(targetPath);
+  }
+
+  return { binDir, targetPath };
+}
+
+function symlinkBinary(sourcePath, targetPath) {
+  fs.symlinkSync(sourcePath, targetPath);
+  console.log(`IMPULSE binary symlinked: ${targetPath} -> ${sourcePath}`);
+
+  if (!fs.existsSync(targetPath)) {
+    throw new Error(`Failed to symlink binary to ${targetPath}`);
+  }
+}
+
+async function main() {
+  try {
+    if (os.platform() === "win32") {
+      console.log("Windows detected: using packaged executable");
+      return;
+    }
+
+    const { binaryPath, binaryName } = findBinary();
+    const { targetPath } = prepareBinDirectory(binaryName);
+    
+    // Create symlink to the platform-specific binary
+    symlinkBinary(binaryPath, targetPath);
+    
+    console.log(`IMPULSE installed successfully!`);
+  } catch (error) {
+    console.error("Failed to setup IMPULSE binary:", error.message);
+    console.error("You may need to install Bun and run IMPULSE directly:");
+    console.error("  curl -fsSL https://bun.sh/install | bash");
+    console.error("  bun x @spenceriam/impulse");
+    process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error("Postinstall script error:", error.message);
+  process.exit(0);
+});

package/README.md

@@ -1,194 +0,0 @@
-# IMPULSE
-
-> Terminal-based AI coding agent powered by Z.ai's Coding Plan
-
-A brutally minimal terminal interface for AI-assisted software development. Built with OpenTUI + SolidJS for flicker-free 60fps rendering. Powered by Z.ai's Coding Plan and their GLM-4.x models - the best cost/engineering ratio for builders.
-
-## Features
-
-- **GLM-4.x Models** - Z.ai's flagship models with thinking mode
-- **5 Modes** - AUTO, AGENT, PLANNER, PLAN-PRD, DEBUG
-- **MCP Integration** - Vision, Web Search, Web Reader, Zread, Context7
-- **Git Checkpoints** - Per-message undo/redo
-- **Auto-Compact** - AI summarization at 85% context
-- **Auto-Save** - Sessions persist automatically
-- **Express Mode** - Skip permission prompts in trusted environments
-- **Interactive Overlays** - Model picker, session loader, question prompts
-
-## Visual Preview
-
-**Welcome Screen:**
-```
-┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
-┃                                                                          ┃
-┃  ██╗███╗   ███╗██████╗ ██╗   ██╗██╗     ███████╗███████╗                  ┃
-┃  ██║████╗ ████║██╔══██╗██║   ██║██║     ██╔════╝██╔════╝                  ┃
-┃  ██║██╔████╔██║██████╔╝██║   ██║██║     ███████╗█████╗                    ┃
-┃  ██║██║╚██╔╝██║██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝                    ┃
-┃  ██║██║ ╚═╝ ██║██║     ╚██████╔╝███████╗███████║███████╗                  ┃
-┃  ╚═╝╚═╝     ╚═╝╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝                  ┃
-┃                                                                          ┃
-┃    v0.14.0                                                     GLM-4.7   ┃
-┃    built 01-23-2026                                          ~/project   ┃
-┃                                                                          ┃
-┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
-
-┌─ AUTO ─────────────────────────────────────────────────────────────────────┐
-│  > _                                                                       │
-└────────────────────────────────────────────────────────────────────────────┘
-GLM-4.7 | ~/project | main | MCP: ● | 01-23-2026
-```
-
-**Session View:**
-```
-[IMPULSE] | Implementing API client
-────────────────────────────────────────────────────────────────────────────────
-
-  You                                                            12:34 PM
-  Can you help me implement the API client?
-
-  GLM-4.7 [AGENT]                                                12:34 PM
-  I'll help you implement the API client.
-
-  ▶ file_write src/api/types.ts                                      [OK]
-  ▶ file_write src/api/client.ts                                     [OK]
-
-┌─ AGENT ────────────────────────────────────────────────────────────────────┐
-│  > _                                                                       │
-└────────────────────────────────────────────────────────────────────────────┘
-GLM-4.7 | AGENT | [██████░░░░] 62% | ~/project | main | MCP: ● | 01-23-2026
-```
-
-## Quick Start
-
-```bash
-# Install
-bun install -g impulse
-
-# Set API key
-export GLM_API_KEY=your_key_here
-
-# Run
-impulse
-
-# Run with Express mode (skip permission prompts)
-impulse --express
-# or
-impulse -e
-```
-
-## Modes
-
-| Mode | Key | Purpose |
-|------|-----|---------|
-| AUTO | - | AI decides based on prompt |
-| AGENT | Tab | Full execution with all tools |
-| PLANNER | Tab | Generate project documentation |
-| PLAN-PRD | Tab | Quick PRD via Q&A |
-| DEBUG | Tab | 7-step systematic debugging |
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `/new` | New session (clears current) |
-| `/clear` | Clear session (alias for /new) |
-| `/save` | Save session |
-| `/load` | Interactive session picker |
-| `/undo` | Revert last change |
-| `/redo` | Restore undone |
-| `/compact` | Manually compact context |
-| `/model` | Interactive model picker |
-| `/mode` | Switch mode |
-| `/think` | Toggle thinking mode |
-| `/express` | Toggle Express mode (skip permissions) |
-| `/init` | Analyze project, create AGENTS.md |
-| `/stats` | Session statistics |
-| `/help` | Show help |
-| `/quit` | Exit with summary |
-
-## Keyboard
-
-| Key | Action |
-|-----|--------|
-| `Tab` | Cycle modes |
-| `Shift+Tab` | Cycle reverse |
-| `Enter` | Submit |
-| `Shift+Enter` | New line |
-| `Up/Down` | Message history |
-| `@` | File autocomplete |
-| `Esc` (2x) | Cancel operation |
-| `Ctrl+C` (2x) | Exit with summary |
-| `Ctrl+P` | Command palette |
-| `Ctrl+M` | MCP status |
-
-## Models
-
-| Model | Type | Best For |
-|-------|------|----------|
-| `glm-4.7` | Text | Complex coding (default) |
-| `glm-4.7-flash` | Text | Fast coding |
-| `glm-4.6` | Text | Previous flagship |
-| `glm-4.6v` | Vision | Image understanding |
-| `glm-4.5` | Text | General tasks |
-| `glm-4.5-air` | Text | Lightweight |
-| `glm-4.5-flash` | Text | Ultra-fast |
-| `glm-4.5v` | Vision | Quick image tasks |
-
-## MCP Servers
-
-IMPULSE integrates with 5 MCP servers out of the box:
-
-| Server | Type | Tools |
-|--------|------|-------|
-| **Vision** | Local (stdio) | Image analysis, UI screenshots, diagrams |
-| **Web Search** | Remote (HTTP) | Web search |
-| **Web Reader** | Remote (HTTP) | Fetch and parse web pages |
-| **Zread** | Remote (HTTP) | Search docs, read GitHub repos |
-| **Context7** | Remote (HTTP) | Library/framework documentation |
-
-The agent discovers MCP tools on-demand to keep context lean.
-
-## Configuration
-
-Config file: `~/.config/impulse/config.json`
-
-```json
-{
-  "apiKey": "your_key_here",
-  "defaultModel": "glm-4.7",
-  "defaultMode": "AUTO",
-  "thinking": true,
-  "express": false
-}
-```
-
-Or use environment variable:
-
-```bash
-export GLM_API_KEY=your_key_here
-```
-
-## Project Instructions
-
-IMPULSE loads project-specific instructions from these files (first found wins):
-
-1. `.impulse/instructions.md`
-2. `AGENTS.md`
-3. `CLAUDE.md`
-4. `GEMINI.md`
-5. `QWEN.md`
-6. `KIMI.md`
-7. `COPILOT.md`
-8. `.cursorrules`
-9. `.windsurfrules`
-
-## Requirements
-
-- Bun 1.0+ or Node.js 20+
-- Git (for undo/redo)
-- Terminal with 256 colors
-
-## License
-
-MIT

package/dist/api/client.d.ts

@@ -1,53 +0,0 @@
-import type { ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, GLMModel, ChatMessage, ToolDefinition } from "./types";
-export declare class GLMClientError extends Error {
-    readonly code?: string | undefined;
-    readonly statusCode?: number | undefined;
-    constructor(message: string, code?: string | undefined, statusCode?: number | undefined);
-}
-export declare class GLMAuthError extends GLMClientError {
-    constructor(message: string);
-}
-export declare class GLMRateLimitError extends GLMClientError {
-    readonly retryAfter?: number | undefined;
-    constructor(message: string, retryAfter?: number | undefined);
-}
-interface CompletionOptions {
-    model?: GLMModel;
-    messages: ChatMessage[];
-    temperature?: number;
-    top_p?: number;
-    max_tokens?: number;
-    stop?: string | string[];
-    tools?: ToolDefinition[];
-    tool_choice?: ChatCompletionRequest["tool_choice"];
-    stream?: false;
-    signal?: AbortSignal;
-}
-interface StreamCompletionOptions extends Omit<CompletionOptions, "stream"> {
-    stream: true;
-}
-declare class GLMClientImpl {
-    private client;
-    private apiKey;
-    private getClient;
-    private sleep;
-    private calculateBackoff;
-    private isRetryableError;
-    private executeWithRetry;
-    /**
-     * Create a chat completion (non-streaming)
-     */
-    complete(options: CompletionOptions): Promise<ChatCompletionResponse>;
-    /**
-     * Create a streaming chat completion
-     * Returns an async iterable of chunks
-     */
-    stream(options: Omit<StreamCompletionOptions, "stream">): AsyncGenerator<ChatCompletionChunk, void, unknown>;
-    /**
-     * Reset the client (useful when API key changes)
-     */
-    reset(): void;
-}
-export declare const GLMClient: GLMClientImpl;
-export {};
-//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,QAAQ,EACR,WAAW,EACX,cAAc,EACf,MAAM,SAAS,CAAC;AAkBjB,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,CAAC,EAAE,MAAM;aACb,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,cAAc;aACN,UAAU,CAAC,EAAE,MAAM;gBAApD,OAAO,EAAE,MAAM,EAAkB,UAAU,CAAC,EAAE,MAAM,YAAA;CAIjE;AAED,UAAU,iBAAiB;IACzB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,UAAU,uBAAwB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;IACzE,MAAM,EAAE,IAAI,CAAC;CACd;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAuB;YAEvB,SAAS;YAqBT,KAAK;IAInB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,gBAAgB;YAWV,gBAAgB;IA0D9B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAqE3E;;;OAGG;IACI,MAAM,CACX,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,GAC/C,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC;IA6ErD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAGD,eAAO,MAAM,SAAS,eAAsB,CAAC"}