@cnrai/pave 0.3.33 → 0.3.35

package/lib/soul.js

@@ -0,0 +1,31 @@
+/**
+ * SOUL file validation helper.
+ * This module has NO side effects when required - safe to import in tests.
+ *
+ * @module lib/soul
+ */
+
+const fs = require('fs');
+
+/**
+ * Validate that a SOUL file path points to an existing, readable, regular file.
+ * Returns { valid: true } on success, or { valid: false, error: string } on failure.
+ * @param {string} resolvedPath - Absolute path to the SOUL file
+ * @returns {{ valid: boolean, error?: string }}
+ */
+function validateSoulFile(resolvedPath) {
+  try {
+    const stat = fs.statSync(resolvedPath);
+    if (!stat.isFile()) {
+      return { valid: false, error: `SOUL path is not a regular file: ${resolvedPath}` };
+    }
+    fs.accessSync(resolvedPath, fs.constants.R_OK);
+    return { valid: true };
+  } catch (err) {
+    const code = err && err.code ? ` (${err.code})` : '';
+    const message = err && err.message ? err.message : 'Unknown error';
+    return { valid: false, error: `Error validating SOUL file${code}: ${message} (path: ${resolvedPath})` };
+  }
+}
+
+module.exports = { validateSoulFile };

package/lib/tool-output-formatter.js

@@ -0,0 +1,180 @@
+/**
+ * Tool Output Formatting Utilities for PAVE CLI
+ * Provides shell-box style formatting matching the TUI output format
+ */
+
+// ANSI color codes for tool output
+const TOOL_COLORS = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+// Box drawing characters (matching TUI)
+const BOX = {
+  topLeft: '╭',
+  topRight: '╮',
+  bottomLeft: '╰',
+  bottomRight: '╯',
+  horizontal: '─',
+  vertical: '│',
+};
+
+/**
+ * Extract command string from tool input for display
+ * Creates pseudo-commands for non-bash tools (matching TUI behavior)
+ * @param {string} tool - Tool name
+ * @param {object|string} input - Tool input data
+ * @returns {string} Command string for display
+ */
+function extractToolCommand(tool, input) {
+  if (!input) return tool;
+
+  try {
+    const inputData = typeof input === 'string' ? JSON.parse(input) : input;
+
+    // bash tool - use actual command
+    if (inputData.command) {
+      return inputData.command;
+    }
+
+    // read tool - show as "read <filepath>"
+    if (inputData.filePath && tool === 'read') {
+      return `read ${inputData.filePath}`;
+    }
+
+    // grep tool - show as 'grep "pattern" path'
+    if (inputData.pattern && tool === 'grep') {
+      const path = inputData.path || inputData.include || '.';
+      return `grep "${inputData.pattern}" ${path}`;
+    }
+
+    // glob tool - show as 'glob "pattern"'
+    if (inputData.pattern && tool === 'glob') {
+      return `glob "${inputData.pattern}"`;
+    }
+
+    // edit tool - show as 'edit <filepath>'
+    if (inputData.filePath && tool === 'edit') {
+      return `edit ${inputData.filePath}`;
+    }
+
+    // write tool - show as 'write <filepath>'
+    if (inputData.filePath && tool === 'write') {
+      return `write ${inputData.filePath}`;
+    }
+
+    // task tool - show as 'task "<description>"'
+    if (inputData.description && tool === 'task') {
+      return `task "${inputData.description}"`;
+    }
+
+    // webfetch tool - show as 'fetch <url>'
+    if (inputData.url && tool === 'webfetch') {
+      return `fetch ${inputData.url}`;
+    }
+
+    // Default: just return tool name
+    return tool;
+  } catch (e) {
+    return tool;
+  }
+}
+
+/**
+ * Format tool output as a shell-style box (matching TUI format)
+ * @param {string} toolName - Name of the tool (e.g., 'bash', 'read')
+ * @param {string} status - Tool status ('running', 'completed', 'error')
+ * @param {object|string} input - Tool input parameters
+ * @param {string} output - Tool output/result
+ * @param {number} duration - Execution duration in milliseconds
+ * @param {object} options - Formatting options
+ * @param {boolean} options.verbose - Show input details (not used in box format)
+ * @param {boolean} options.noColor - Disable colors
+ * @param {number} options.width - Box width (default 60, matching TUI)
+ * @returns {string} Formatted shell box string
+ */
+function formatToolOutput(toolName, status, input, output, duration, options = {}) {
+  const { noColor = false, width = 60 } = options;
+
+  // Use colors or empty strings based on noColor option
+  const C = noColor ? {
+    reset: '', bold: '', dim: '', red: '', green: '', yellow: '', cyan: '', gray: '',
+  } : TOOL_COLORS;
+
+  const b = BOX;
+  const boxWidth = width;
+
+  // Extract command for display
+  const command = extractToolCommand(toolName, input);
+
+  // Status indicator and header color
+  let statusIcon = '';
+  let headerColor = C.cyan;
+  if (status === 'completed') {
+    statusIcon = ` ${C.green}✓${C.reset}`;
+    headerColor = C.cyan;
+  } else if (status === 'error') {
+    statusIcon = ` ${C.red}✗${C.reset}`;
+    headerColor = C.red;
+  } else if (status === 'running') {
+    statusIcon = ` ${C.yellow}⟳${C.reset}`;
+    headerColor = C.yellow;
+  }
+
+  // Duration string
+  const durationStr = duration !== undefined ? ` ${C.gray}(${duration}ms)${C.reset}` : '';
+
+  // Build header: ╭─ bash ✓ (17ms) ────────╮
+  const headerLabel = ` ${toolName}${statusIcon}${durationStr} `;
+  // Calculate actual display length (strip ANSI codes)
+  const labelDisplayLen = headerLabel.replace(/\x1b\[[0-9;]*m/g, '').length;
+  // Account for: topLeft(1) + leading horizontal(1) + label + trailing fill + topRight(1) = boxWidth
+  const headerFill = Math.max(0, boxWidth - labelDisplayLen - 3);
+  const topBorder = `${C.gray}${b.topLeft}${b.horizontal}${C.reset}${headerColor}${headerLabel}${C.reset}${C.gray}${b.horizontal.repeat(headerFill)}${b.topRight}${C.reset}`;
+
+  // Build content lines
+  const lines = [];
+
+  // Command line with $ prompt and optional cursor for running state
+  const cursor = status === 'running' ? '█' : '';
+  const cmdLine = `${C.green}$${C.reset} ${command}${cursor}`;
+  lines.push(cmdLine);
+
+  // Output lines (show everything)
+  if (output) {
+    // Stringify object output if needed
+    const outputStr = typeof output === 'object' ? JSON.stringify(output, null, 2) : output;
+    const outputLines = outputStr.split('\n');
+    for (const line of outputLines) {
+      // Apply error coloring for error status
+      const lineContent = status === 'error' ? `${C.red}${line}${C.reset}` : line;
+      lines.push(lineContent);
+    }
+  }
+
+  // Remove trailing empty/whitespace-only lines to avoid extra blank lines at the bottom of the box
+  // Strip ANSI escape codes before checking emptiness so colored empty lines (e.g., error output) are caught
+  while (lines.length > 0 && lines[lines.length - 1].replace(/\x1b\[[0-9;]*m/g, '').trim() === '') {
+    lines.pop();
+  }
+
+  // Bottom border - account for: bottomLeft(1) + fill + bottomRight(1) = boxWidth
+  const bottomBorder = `${C.gray}${b.bottomLeft}${b.horizontal.repeat(Math.max(0, boxWidth - 2))}${b.bottomRight}${C.reset}`;
+
+  // Combine all parts, adding a leading and trailing newline around the box
+  const result = '\n' + [topBorder, ...lines, bottomBorder].join('\n') + '\n';
+  return result;
+}
+
+module.exports = {
+  formatToolOutput,
+  extractToolCommand,
+  TOOL_COLORS,
+  BOX,
+};

package/package.json

@@ -1,14 +1,36 @@
 {
   "name": "@cnrai/pave",
-  "version": "0.3.33",
-  "description": "PAVE - Personal AI Virtual Environment. AI agent framework for the terminal.",
-  "main": "pave.js",
+  "version": "0.3.35",
+  "description": "Personal AI Virtual Environment - Terminal UI + OpenCode-Lite Server",
+  "main": "index.js",
   "bin": {
-    "pave": "./pave.js"
+    "pave": "./index.js"
   },
   "scripts": {
-    "start": "node pave.js"
+    "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"
   },
+  "keywords": [
+    "ai",
+    "terminal",
+    "tui",
+    "opencode",
+    "ish",
+    "ios",
+    "memory-efficient",
+    "resource-constrained"
+  ],
   "engines": {
     "node": ">=16.0.0"
   },
@@ -18,34 +40,15 @@
     "win32"
   ],
   "dependencies": {
-    "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"
+    "abort-controller": "^3.0.0",
+    "figlet": "^1.10.0",
+    "js-yaml": "^4.1.0",
+    "ulid": "^2.3.0"
   },
-  "homepage": "https://github.com/cnrai/openpave",
-  "bugs": {
-    "url": "https://github.com/cnrai/openpave/issues"
+  "devDependencies": {
+    "esbuild": "^0.27.3",
+    "javascript-obfuscator": "^5.3.0"
   },
-  "author": "CNRAI",
+  "author": "PAVE Team",
   "license": "MIT"
 }

package/start-pave.sh

@@ -0,0 +1,149 @@
+#!/bin/bash
+# PAVE Startup Script
+# Automatically detects environment and applies optimal settings
+
+set -e
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PAVE_DIR="$SCRIPT_DIR"
+
+# Default options
+NODE_ARGS="--expose-gc"
+PAVE_ARGS=""
+
+# Parse arguments
+HELP_REQUESTED=false
+ISH_MODE=""
+MEMORY_LIMIT=""
+DEBUG_MODE=false
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --help|-h)
+      HELP_REQUESTED=true
+      shift
+      ;;
+    --ish-mode)
+      ISH_MODE="--ish-mode"
+      if [[ $2 =~ ^(true|false|on|off|1|0)$ ]]; then
+        ISH_MODE="--ish-mode $2"
+        shift
+      fi
+      shift
+      ;;
+    --memory-limit)
+      if [[ $2 =~ ^[0-9]+$ ]]; then
+        MEMORY_LIMIT="--memory-limit $2"
+        shift
+      fi
+      shift
+      ;;
+    --debug)
+      DEBUG_MODE=true
+      PAVE_ARGS="$PAVE_ARGS --debug"
+      shift
+      ;;
+    --verbose)
+      PAVE_ARGS="$PAVE_ARGS --verbose"
+      shift
+      ;;
+    --no-gc)
+      NODE_ARGS=""
+      shift
+      ;;
+    *)
+      # Pass through other arguments to PAVE
+      PAVE_ARGS="$PAVE_ARGS $1"
+      shift
+      ;;
+  esac
+done
+
+# Show help if requested
+if [ "$HELP_REQUESTED" = true ]; then
+  cat << EOF
+PAVE Startup Script
+
+USAGE:
+  $0 [options] [pave-options]
+
+STARTUP OPTIONS:
+  --help, -h              Show this help
+  --ish-mode [on|off]     Force ISH mode on/off (auto-detected by default)
+  --memory-limit <MB>     Set memory limit in MB
+  --debug                 Enable debug mode
+  --verbose               Enable verbose output
+  --no-gc                 Disable --expose-gc Node.js flag
+
+EXAMPLES:
+  $0                      # Standard startup with auto-detection
+  $0 --ish-mode           # Force ISH mode
+  $0 --memory-limit 32    # Custom memory limit
+  $0 --debug --verbose    # Debug mode with verbose output
+
+All other arguments are passed to PAVE directly.
+For full PAVE options, run: $0 -- --help
+
+ENVIRONMENT DETECTION:
+  - ISH mode is auto-detected based on platform and environment
+  - Garbage collection is enabled by default for memory protection
+  - Memory limits are automatically set based on detected environment
+
+EOF
+  exit 0
+fi
+
+# Build final command arguments
+FINAL_PAVE_ARGS="$ISH_MODE $MEMORY_LIMIT $PAVE_ARGS"
+
+# Environment detection
+detect_environment() {
+  local is_ish=false
+  
+  # Check for iSH indicators
+  if [[ "$OSTYPE" == "linux"* ]]; then
+    if [[ "$TERM_PROGRAM" == "iSH" ]] || [[ -f "/etc/alpine-release" ]] || [[ "$(uname -a)" == *"alpine"* ]]; then
+      is_ish=true
+    fi
+  fi
+  
+  echo $is_ish
+}
+
+IS_ISH=$(detect_environment)
+
+# Print startup banner
+echo "=============================================="
+echo "PAVE Startup Script"
+echo "=============================================="
+echo "Environment: $(if [ "$IS_ISH" = true ]; then echo "iSH (iOS)"; else echo "Standard"; fi)"
+echo "Node args: $NODE_ARGS"
+echo "PAVE args: $FINAL_PAVE_ARGS"
+echo "Working directory: $PAVE_DIR"
+
+# ISH-specific recommendations
+if [ "$IS_ISH" = true ]; then
+  echo ""
+  echo "ISH DETECTED:"
+  echo "  - Memory protection enabled"
+  echo "  - Garbage collection enabled"
+  echo "  - Conservative memory limits applied"
+  
+  if [ "$DEBUG_MODE" = true ]; then
+    echo "  - Debug logging enabled (logs to ~/.pave/pave.log)"
+  fi
+fi
+
+echo "=============================================="
+echo ""
+
+# Change to PAVE directory
+cd "$PAVE_DIR"
+
+# Execute PAVE with appropriate arguments
+if [ -n "$NODE_ARGS" ]; then
+  exec node $NODE_ARGS index.js $FINAL_PAVE_ARGS
+else
+  exec node index.js $FINAL_PAVE_ARGS
+fi