@cnrai/pave 0.3.35 → 0.3.50

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CNRAI
+
+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/README.md

@@ -1,237 +1,40 @@
-# PAVE - Personal AI Virtual Environment
+# @cnrai/pave
 
-PAVE combines an OpenCode-Lite server with a terminal UI client in a single process, specifically optimized for resource-constrained environments like iSH on iOS.
+PAVE - Personal AI Virtual Environment. AI agent framework for the terminal.
 
-## Features
+## Installation
 
-- **Resource-Efficient**: Runs smoothly on iSH iOS with Node 16
-- **Configurable Memory Management**: CLI arguments for fine-tuning memory limits
-- **Auto-Detection**: Automatically detects iSH environment and applies appropriate settings
-- **Terminal UI**: Real-time chat interface with markdown rendering
-- **Embedded Server**: No separate server process required
-
-## Quick Start
-
-### Standard Usage
-```bash
-node index.js
-```
-
-### ISH/iOS Usage
-```bash
-# Using startup script (recommended)
-./start-pave.sh
-
-# Or manually with garbage collection
-node --expose-gc index.js
-```
-
-## CLI Options
-
-### Memory Configuration
-Perfect for ISH and other resource-constrained environments:
-
-```bash
-# Force ISH mode with custom memory limits
-node index.js --ish-mode --memory-limit 16 --memory-warning 12
-
-# Disable memory monitoring
-node index.js --memory-monitor off
-
-# Custom startup memory allowance (for large JS bundles)
-node index.js --memory-startup 64 --memory-limit 12
-```
-
-### Server Configuration
-```bash
-# Custom port and host
-node index.js --port 8080 --host 0.0.0.0
-
-# Custom working directory
-node index.js --opencode-dir /path/to/workspace
-```
-
-### Debug Options
-```bash
-# Debug mode with verbose logging
-node index.js --debug --verbose
-
-# Help and version
-node index.js --help
-node index.js --version
-```
-
-## Memory Management Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--ish-mode [on\|off]` | Force ISH mode detection | Auto-detected |
-| `--memory-limit <MB>` | Heap memory limit | 8MB (ISH), 100MB (standard) |
-| `--memory-warning <MB>` | Warning threshold | 80% of limit |
-| `--memory-critical <MB>` | Critical threshold | Same as limit |
-| `--memory-startup <MB>` | Startup limit | Higher to allow init |
-| `--memory-monitor [on\|off]` | Enable monitoring | Auto (ISH=on) |
-
-## Environment Variables
-
-CLI arguments override environment variables:
-
-| Variable | CLI Override | Description |
-|----------|--------------|-------------|
-| `PORT` | `--port` | Server port (default: 4096) |
-| `HOST` | `--host` | Server hostname (default: 127.0.0.1) |
-| `OPENCODE_DIR` | `--opencode-dir` | Working directory |
-| `FORCE_ISH_MODE` | `--ish-mode` | Force ISH mode |
-| `DEBUG` | `--debug` | Enable debug logging |
-
-## ISH/iOS Optimization
-
-PAVE is specifically designed to run efficiently on iSH:
-
-### Automatic Detection
-```bash
-# These indicators trigger ISH mode:
-# - platform === 'linux'
-# - TERM_PROGRAM === 'iSH' 
-# - /etc/alpine-release exists
-# - Node version contains 'alpine'
-```
-
-### Memory Protection
-```bash
-# ISH mode automatically enables:
-# - 8MB heap limit (vs 100MB standard)
-# - Memory monitoring every 5 seconds
-# - Aggressive garbage collection
-# - Emergency cleanup on memory pressure
-# - Process termination before system crash
-```
-
-### Recommended ISH Setup
 ```bash
-# Install with garbage collection support
-node --expose-gc index.js
-
-# Or use the startup script
-./start-pave.sh
-
-# For persistent use, create an alias
-echo 'alias pave="cd /path/to/pave && ./start-pave.sh"' >> ~/.profile
+npm install -g @cnrai/pave
 ```
 
-## Examples
+## Usage
 
-### Basic Usage
 ```bash
-# Auto-detected environment
-node index.js
-
-# With debug logging
-node index.js --debug
+pave                    # Launch TUI
+pave --help             # Show help
+pave --version          # Show version
+pave chat "question"    # Quick chat
 ```
 
-### ISH Customization
-```bash
-# Conservative memory settings
-node index.js --memory-limit 6 --memory-warning 4
-
-# Higher startup allowance for large projects
-node index.js --memory-startup 32 --memory-limit 8
+### iSH (iOS)
 
-# Force ISH mode for testing
-node index.js --ish-mode --debug
-```
-
-### Development Setup
 ```bash
-# Custom server for development
-node index.js --port 3000 --host 0.0.0.0 --debug --verbose
-
-# Disable memory monitoring for debugging
-node index.js --memory-monitor off --debug
+npm install -g @cnrai/pave
+pave                    # Auto-detects iSH and applies optimized Node flags
 ```
 
-### Production ISH Setup
-```bash
-# Optimized for production use in iSH
-./start-pave.sh --memory-limit 12 --memory-warning 8
-```
-
-## Startup Script
-
-The `start-pave.sh` script provides additional convenience:
-
-```bash
-# Standard startup with auto-detection
-./start-pave.sh
-
-# Force ISH mode
-./start-pave.sh --ish-mode
-
-# Custom memory limit
-./start-pave.sh --memory-limit 32
-
-# Debug mode
-./start-pave.sh --debug --verbose
-
-# Disable garbage collection
-./start-pave.sh --no-gc
-```
-
-## Troubleshooting
-
-### Memory Issues
-```bash
-# Check current memory usage
-node index.js --debug --verbose
-
-# Lower memory limits
-node index.js --memory-limit 6 --memory-warning 4
-
-# Disable monitoring temporarily
-node index.js --memory-monitor off
-```
-
-### ISH Detection Issues
-```bash
-# Force ISH mode
-node index.js --ish-mode
-
-# Check detection
-FORCE_ISH_MODE=true node index.js --debug
-```
-
-### Performance Issues
-```bash
-# Enable garbage collection
-node --expose-gc index.js
-
-# Use startup script
-./start-pave.sh
-
-# Check memory configuration
-node index.js --debug | grep -i memory
-```
-
-## Architecture
+## Requirements
 
-PAVE runs OpenCode-Lite and the TUI client in the same Node.js process:
+- Node.js >= 16.0.0
+- A GitHub Copilot subscription (for the AI backend)
 
-1. **Server starts** with configurable memory limits
-2. **Console redirected** to log file to avoid TUI corruption  
-3. **TUI launches** and connects to embedded server
-4. **Memory monitoring** starts when first session is activated
-5. **Automatic cleanup** prevents memory exhaustion crashes
+## Links
 
-This architecture is specifically designed for environments where:
-- Memory is extremely limited (8MB heap in iSH)
-- Process spawning is expensive
-- Terminal UI corruption must be avoided
-- Reliability is critical (no crashes in mobile environment)
+- Source: https://github.com/cnrai/openpave
+- Issues: https://github.com/cnrai/openpave/issues
+- Homebrew (native binary): `brew tap cnrai/tap && brew install pave`
 
-## Requirements
+## License
 
-- Node.js 16+ (tested extensively on iSH iOS)
-- 12MB+ available memory (8MB for heap + overhead)
-- Terminal with basic ANSI support
-- Optional: `--expose-gc` for optimal memory management
+MIT - Copyright (c) 2025 CNRAI

package/package.json

@@ -1,36 +1,14 @@
 {
   "name": "@cnrai/pave",
-  "version": "0.3.35",
-  "description": "Personal AI Virtual Environment - Terminal UI + OpenCode-Lite Server",
-  "main": "index.js",
+  "version": "0.3.50",
+  "description": "PAVE - Personal AI Virtual Environment. AI agent framework for the terminal.",
+  "main": "pave.js",
   "bin": {
-    "pave": "./index.js"
+    "pave": "./pave.js"
   },
   "scripts": {
-    "start": "node index.js",
-    "start:ish": "node --expose-gc index.js",
-    "start:debug": "node --expose-gc index.js --debug --verbose",
-    "help": "node index.js --help",
-    "build": "node build.js",
-    "build:install": "node build.js --install",
-    "build:npm": "node build-npm.js",
-    "build:npm:publish": "node build-npm.js --publish",
-    "clean": "rm -rf dist",
-    "test": "node test/run-tests.js",
-    "test:verbose": "node test/run-tests.js --verbose",
-    "test:ish": "node test/ish-fetch.test.js",
-    "status": "node status.js"
+    "start": "node pave.js"
   },
-  "keywords": [
-    "ai",
-    "terminal",
-    "tui",
-    "opencode",
-    "ish",
-    "ios",
-    "memory-efficient",
-    "resource-constrained"
-  ],
   "engines": {
     "node": ">=16.0.0"
   },
@@ -40,15 +18,34 @@
     "win32"
   ],
   "dependencies": {
-    "abort-controller": "^3.0.0",
-    "figlet": "^1.10.0",
-    "js-yaml": "^4.1.0",
-    "ulid": "^2.3.0"
+    "blessed": "^0.1.81",
+    "js-yaml": "^4.1.0"
+  },
+  "files": [
+    "pave.js",
+    "sandbox/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai",
+    "terminal",
+    "tui",
+    "agent",
+    "cli",
+    "ish",
+    "ios",
+    "node16",
+    "memory-efficient"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cnrai/openpave.git"
   },
-  "devDependencies": {
-    "esbuild": "^0.27.3",
-    "javascript-obfuscator": "^5.3.0"
+  "homepage": "https://github.com/cnrai/openpave",
+  "bugs": {
+    "url": "https://github.com/cnrai/openpave/issues"
   },
-  "author": "PAVE Team",
+  "author": "CNRAI",
   "license": "MIT"
 }