@bigfishnpm/matrixcode 0.2.5 → 0.4.18

package/README.md

@@ -1,59 +1,138 @@
-# MatrixCode npm Package
-
-这个 npm 包是 [MatrixCode](https://github.com/bigfish1913/matrixcode) 的安装包装器。
-
-## 安装
-
-```bash
-npm install -g matrixcode
-```
-
-安装脚本会自动：
-1. 检查是否已安装 `matrixcode`
-2. 如果有 Rust/Cargo，使用 `cargo install matrixcode`
-3. 否则从 GitHub Releases 下载预编译二进制
-
-## 手动安装
-
-如果自动安装失败，你可以：
-
-```bash
-# 使用 Cargo
-cargo install matrixcode
-
-# 或从 GitHub Releases 下载
-# https://github.com/bigfish1913/matrixcode/releases
-```
-
-## 发布说明
-
-发布新版本时：
-
-1. 更新版本号：
-   - `Cargo.toml` 中的 `version`
-   - `npm/package.json` 中的 `version`
-
-2. 发布到 crates.io：
-   ```bash
-   cargo login
-   cargo publish
-   ```
-
-3. 发布到 npm：
-   ```bash
-   cd npm
-   npm login
-   npm publish
-   ```
-
-4. 创建 Git tag 并推送（触发 GitHub Release）：
-   ```bash
-   git tag v0.1.0
-   git push origin v0.1.0
-   ```
-
-## 支持的平台
-
-- macOS (x64, Apple Silicon)
-- Linux (x64, arm64)
-- Windows (x64)
+# @bigfishnpm/matrixcode
+
+AI coding assistant CLI with multi-model support, intelligent context compression, and cross-session memory.
+
+## Installation
+
+```bash
+npm install -g @bigfishnpm/matrixcode
+```
+
+The package automatically downloads the pre-built binary for your platform:
+- Windows (x64)
+- macOS (x64, arm64)
+- Linux (x64, arm64)
+
+## Usage
+
+### Interactive Terminal Mode
+
+```bash
+matrixcode
+```
+
+Start an interactive terminal UI with:
+- Streaming response rendering
+- Markdown formatting
+- Code syntax highlighting
+- Tool call visualization
+
+### One-shot Query
+
+```bash
+matrixcode "Analyze this project structure"
+
+# JSON output mode (for scripting)
+matrixcode --mode service "Explain this function"
+```
+
+### Daemon Mode
+
+For VS Code extension integration:
+
+```bash
+matrixcode --mode daemon
+```
+
+Send JSON requests via stdin:
+```bash
+echo '{"type":"chat","content":"test"}' | matrixcode --mode daemon
+```
+
+### Session Management
+
+```bash
+# List previous sessions
+matrixcode --list-sessions
+
+# Resume a session
+matrixcode --resume
+```
+
+## Configuration
+
+Create `~/.matrix/config.json`:
+
+```json
+{
+  "provider": "anthropic",
+  "apiKey": "your-api-key",
+  "model": "claude-sonnet-4-20250514",
+  "maxTokens": 16384,
+  "think": true
+}
+```
+
+Or use environment variables:
+
+```bash
+export PROVIDER=anthropic
+export API_KEY=your-key
+export MODEL=claude-sonnet-4-20250514
+```
+
+## Features
+
+### 🤖 Multi-Model Support
+- Anthropic Claude (Sonnet, Opus, Haiku)
+- OpenAI GPT (GPT-4, GPT-3.5)
+- Flexible model configuration for different tasks
+
+### 🧠 Cross-Session Memory
+- SQLite persistent storage
+- Automatic memory extraction from conversations
+- Keyword-triggered retrieval
+- User preferences, project context, learning records
+
+### 🗜️ Intelligent Context Compression
+- Multi-phase compression strategy
+- Dependency analysis and importance scoring
+- Tool call result compression
+- Session summarization
+
+### 🔧 Rich Tool System
+- File operations: read, write, edit, glob, grep
+- Code execution: bash (sandboxed)
+- Code intelligence: codegraph (tree-sitter based)
+- Web capabilities: webfetch, websearch
+- Task management: todo_write, task
+
+### 📋 Workflow Engine
+- YAML-defined workflows
+- Multiple node types: AI, tool, condition, validate
+- Failure strategies: retry, skip, fail, fallback
+
+## CLI Options
+
+```
+matrixcode [OPTIONS] [MESSAGE]
+
+Options:
+  --mode <MODE>           Run mode: terminal, tui, service, json, daemon
+  --resume, -r            Interactively select session to resume
+  --session <ID>          Resume from specific session
+  --list-sessions         List previous sessions
+  --config <PATH>         Configuration file path
+  --help                  Show help
+  --version               Show version
+```
+
+## Links
+
+- [GitHub](https://github.com/bigfish1913/matrixcode)
+- [Documentation](https://github.com/bigfish1913/matrixcode#readme)
+- [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=bigfish1913.matrixcode)
+
+## License
+
+MIT

package/bin/matrixcode

@@ -1,42 +1,6 @@
-#!/usr/bin/env node
-
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-
-// Find the matrixcode binary
-const ext = os.platform() === 'win32' ? '.exe' : '';
-const localBin = path.join(__dirname, 'bin', `matrixcode${ext}`);
-
-let binPath = 'matrixcode'; // Default: use system-installed
-
-// If local binary exists, use it
-if (fs.existsSync(localBin)) {
-  binPath = localBin;
-}
-
-// Spawn the actual binary with all arguments
-const child = spawn(binPath, process.argv.slice(2), {
-  stdio: 'inherit',
-  shell: os.platform() === 'win32',
-});
-
-child.on('error', (err) => {
-  if (err.code === 'ENOENT') {
-    console.error('[matrixcode] Error: matrixcode binary not found');
-    console.error('');
-    console.error('Please install matrixcode:');
-    console.error('  npm install -g matrixcode');
-    console.error('  or');
-    console.error('  cargo install matrixcode');
-    process.exit(1);
-  } else {
-    console.error('[matrixcode] Error:', err.message);
-    process.exit(1);
-  }
-});
-
-child.on('exit', (code) => {
-  process.exitCode = code || 0;
-});
+#!/usr/bin/env node
+
+console.error('MatrixCode binary not found.');
+console.error('Please install via cargo: cargo install matrixcode');
+console.error('Or reinstall this package to download the binary.');
+process.exit(1);

package/package.json

@@ -1,43 +1,48 @@
 {
   "name": "@bigfishnpm/matrixcode",
-  "version": "0.2.5",
-  "description": "A smart code agent CLI with multi-model support, context compression, and task planning",
-  "author": "bigfish1913",
+  "version": "0.4.18",
+  "description": "AI coding assistant CLI with multi-model support, context compression, and cross-session memory",
   "license": "MIT",
+  "author": "bigfish1913",
+  "homepage": "https://github.com/bigfish1913/matrixcode#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bigfish1913/matrixcode.git"
+    "url": "git+https://github.com/bigfish1913/matrixcode.git"
   },
-  "homepage": "https://github.com/bigfish1913/matrixcode#readme",
   "bugs": {
     "url": "https://github.com/bigfish1913/matrixcode/issues"
   },
   "keywords": [
     "ai",
-    "llm",
-    "code-agent",
     "cli",
-    "anthropic",
+    "code-assistant",
+    "llm",
     "claude",
-    "gpt",
-    "assistant"
+    "anthropic",
+    "openai",
+    "gpt"
   ],
   "bin": {
     "matrixcode": "./bin/matrixcode"
   },
   "scripts": {
-    "postinstall": "node install.js"
+    "postinstall": "node scripts/download.js"
   },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md"
+  ],
   "engines": {
-    "node": ">=16"
+    "node": ">=14"
   },
-  "files": [
-    "bin/",
-    "install.js",
-    "README.md",
-    "LICENSE"
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
   ],
-  "publishConfig": {
-    "access": "public"
-  }
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
 }

package/scripts/download.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const VERSION = require('./package.json').version;
+const BIN_DIR = path.join(__dirname, 'bin');
+const BIN_PATH = path.join(BIN_DIR, 'matrixcode');
+
+// Determine platform and arch
+const platform = process.platform;
+const arch = process.arch;
+
+// Map to release binary names
+const binaryName = {
+  win32: { x64: 'matrixcode-windows-x64.exe', arm64: 'matrixcode-windows-arm64.exe' },
+  darwin: { x64: 'matrixcode-macos-x64', arm64: 'matrixcode-macos-arm64' },
+  linux: { x64: 'matrixcode-linux-x64', arm64: 'matrixcode-linux-arm64' }
+};
+
+const binary = binaryName[platform]?.[arch];
+if (!binary) {
+  console.error(`Unsupported platform: ${platform}-${arch}`);
+  process.exit(1);
+}
+
+// GitHub release URL
+const downloadUrl = `https://github.com/bigfish1913/matrixcode/releases/download/v${VERSION}/${binary}`;
+
+console.log(`Downloading matrixcode v${VERSION} for ${platform}-${arch}...`);
+
+// Download function
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    https.get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        // Follow redirect
+        download(response.headers.location, dest).then(resolve).catch(reject);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        reject(new Error(`Download failed: ${response.statusCode}`));
+        return;
+      }
+
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', (err) => {
+      fs.unlink(dest, () => {});
+      reject(err);
+    });
+  });
+}
+
+// Main
+async function main() {
+  try {
+    // Ensure bin directory exists
+    if (!fs.existsSync(BIN_DIR)) {
+      fs.mkdirSync(BIN_DIR, { recursive: true });
+    }
+
+    // Download binary
+    await download(downloadUrl, BIN_PATH);
+
+    // Make executable (Unix)
+    if (platform !== 'win32') {
+      fs.chmodSync(BIN_PATH, 0o755);
+    }
+
+    // On Windows, rename to .exe if needed
+    if (platform === 'win32' && !BIN_PATH.endsWith('.exe')) {
+      fs.renameSync(BIN_PATH, BIN_PATH + '.exe');
+    }
+
+    console.log('matrixcode installed successfully!');
+    console.log('Run: matrixcode --help');
+  } catch (err) {
+    console.error('Installation failed:', err.message);
+    console.error('\nYou can also install via cargo:');
+    console.error('  cargo install matrixcode');
+    process.exit(1);
+  }
+}
+
+main();

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 MatrixCode Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/install.js

@@ -1,221 +0,0 @@
-#!/usr/bin/env node
-
-const { execSync, spawnSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const https = require('https');
-
-const BIN_DIR = path.join(__dirname, 'bin');
-const PACKAGE_VERSION = require('./package.json').version;
-
-// Platform mapping for GitHub releases (matches release.yml targets)
-const PLATFORM_MAP = {
-  'darwin-x64': { target: 'x86_64-apple-darwin', archive: 'tar.gz' },
-  'darwin-arm64': { target: 'aarch64-apple-darwin', archive: 'tar.gz' },
-  'linux-x64': { target: 'x86_64-unknown-linux-gnu', archive: 'tar.gz' },
-  'linux-arm64': { target: 'aarch64-unknown-linux-gnu', archive: 'tar.gz' },
-  'win32-x64': { target: 'x86_64-pc-windows-msvc', archive: 'zip' },
-  'win32-arm64': { target: 'aarch64-pc-windows-msvc', archive: 'zip' },
-};
-
-function getPlatform() {
-  const platform = os.platform();
-  const arch = os.arch();
-  const key = `${platform}-${arch}`;
-  return PLATFORM_MAP[key] || null;
-}
-
-function checkCommand(cmd) {
-  try {
-    execSync(`${cmd} --version`, { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function isMatrixcodeInstalled() {
-  try {
-    const result = spawnSync('matrixcode', ['--version'], { stdio: 'ignore' });
-    return result.status === 0;
-  } catch {
-    return false;
-  }
-}
-
-function installViaCargo() {
-  console.log('[matrixcode] Installing via cargo install matrixcode...');
-  try {
-    execSync('cargo install matrixcode', { stdio: 'inherit' });
-    console.log('[matrixcode] ✓ Installed successfully via cargo');
-    return true;
-  } catch (error) {
-    console.error('[matrixcode] ✗ Failed to install via cargo:', error.message);
-    return false;
-  }
-}
-
-function downloadFile(url, dest) {
-  return new Promise((resolve, reject) => {
-    const file = fs.createWriteStream(dest);
-    const request = (urlString) => {
-      https.get(urlString, (response) => {
-        if (response.statusCode === 302 || response.statusCode === 301) {
-          // Follow redirect
-          request(response.headers.location);
-          return;
-        }
-        if (response.statusCode !== 200) {
-          reject(new Error(`HTTP ${response.statusCode}`));
-          return;
-        }
-        response.pipe(file);
-        file.on('finish', () => {
-          file.close();
-          resolve();
-        });
-      }).on('error', (err) => {
-        fs.unlink(dest, () => {});
-        reject(err);
-      });
-    };
-    request(url);
-  });
-}
-
-async function downloadBinary() {
-  const platformInfo = getPlatform();
-  if (!platformInfo) {
-    console.error(`[matrixcode] Unsupported platform: ${os.platform()}-${os.arch()}`);
-    console.log('[matrixcode] Falling back to cargo install...');
-    return installViaCargo();
-  }
-
-  const { target, archive } = platformInfo;
-  const archiveName = `matrixcode-${target}.${archive}`;
-  const downloadUrl = `https://github.com/bigfish1913/matrixcode/releases/download/v${PACKAGE_VERSION}/${archiveName}`;
-  
-  console.log(`[matrixcode] Downloading binary for ${target}...`);
-  console.log(`[matrixcode] URL: ${downloadUrl}`);
-
-  // Create bin directory
-  if (!fs.existsSync(BIN_DIR)) {
-    fs.mkdirSync(BIN_DIR, { recursive: true });
-  }
-
-  const archivePath = path.join(BIN_DIR, archiveName);
-  const binaryName = os.platform() === 'win32' ? 'matrixcode.exe' : 'matrixcode';
-  const targetPath = path.join(BIN_DIR, binaryName);
-
-  try {
-    await downloadFile(downloadUrl, archivePath);
-    console.log('[matrixcode] ✓ Download complete, extracting...');
-  } catch (error) {
-    console.error(`[matrixcode] ✗ Failed to download: ${error.message}`);
-    console.log('[matrixcode] Falling back to cargo install...');
-    return installViaCargo();
-  }
-
-  // Extract archive
-  try {
-    if (archive === 'tar.gz') {
-      // Use tar to extract (available on macOS and Linux)
-      execSync(`tar -xzf "${archivePath}" -C "${BIN_DIR}"`, { stdio: 'inherit' });
-    } else if (archive === 'zip') {
-      // On Windows, use PowerShell
-      execSync(`powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${BIN_DIR}' -Force"`, { stdio: 'inherit' });
-    }
-    
-    // Make binary executable (Unix)
-    if (os.platform() !== 'win32') {
-      fs.chmodSync(targetPath, 0o755);
-    }
-    
-    // Clean up archive
-    fs.unlinkSync(archivePath);
-    
-    console.log('[matrixcode] ✓ Binary installed successfully');
-    return true;
-  } catch (error) {
-    console.error(`[matrixcode] ✗ Failed to extract: ${error.message}`);
-    // Clean up
-    try { fs.unlinkSync(archivePath); } catch {}
-    console.log('[matrixcode] Falling back to cargo install...');
-    return installViaCargo();
-  }
-}
-
-function createWrapperScript() {
-  const ext = os.platform() === 'win32' ? '.cmd' : '';
-  const wrapperPath = path.join(BIN_DIR, `matrixcode${ext}`);
-  
-  // Make sure bin directory exists
-  if (!fs.existsSync(BIN_DIR)) {
-    fs.mkdirSync(BIN_DIR, { recursive: true });
-  }
-
-  if (os.platform() === 'win32') {
-    // Windows batch script
-    const content = `@echo off
-matrixcode %*
-`;
-    fs.writeFileSync(wrapperPath, content);
-  } else {
-    // Unix shell script - just call the system-installed matrixcode
-    const content = `#!/bin/sh
-exec matrixcode "$@"
-`;
-    fs.writeFileSync(wrapperPath, content, { mode: 0o755 });
-  }
-  
-  console.log('[matrixcode] ✓ Wrapper script created');
-}
-
-async function main() {
-  console.log(`[matrixcode] v${PACKAGE_VERSION}`);
-  console.log('');
-
-  // Check if matrixcode is already installed
-  if (isMatrixcodeInstalled()) {
-    console.log('[matrixcode] ✓ matrixcode is already installed');
-    createWrapperScript();
-    return;
-  }
-
-  console.log('[matrixcode] matrixcode not found, installing...');
-  console.log('');
-
-  // Prefer cargo if available (more reliable)
-  if (checkCommand('cargo')) {
-    console.log('[matrixcode] Found cargo, installing via cargo...');
-    if (installViaCargo()) {
-      createWrapperScript();
-      return;
-    }
-  }
-
-  // Try downloading pre-built binary
-  if (await downloadBinary()) {
-    return;
-  }
-
-  // Final fallback: show manual instructions
-  console.error('');
-  console.error('[matrixcode] ✗ Automatic installation failed');
-  console.error('');
-  console.error('Please install manually using one of these methods:');
-  console.error('');
-  console.error('  # Option 1: Using cargo (recommended)');
-  console.error('  cargo install matrixcode');
-  console.error('');
-  console.error('  # Option 2: Download from GitHub Releases');
-  console.error('  https://github.com/bigfish1913/matrixcode/releases');
-  console.error('');
-  process.exit(1);
-}
-
-main().catch(err => {
-  console.error('[matrixcode] Installation error:', err.message);
-  process.exit(1);
-});