vigthoria-cli 1.9.2 → 1.9.8

package/install.sh

@@ -0,0 +1,314 @@
+#!/bin/bash
+#
+# Vigthoria CLI Installer
+# Usage: curl -fsSL https://cli.vigthoria.io/install.sh | bash
+#
+# Supports: Linux, macOS (Intel and Apple Silicon)
+#
+
+set -e
+
+# Colors (with fallback for non-color terminals)
+if [ -t 1 ] && [ "$(tput colors 2>/dev/null || echo 0)" -ge 8 ]; then
+    RED='\033[0;31m'
+    GREEN='\033[0;32m'
+    YELLOW='\033[1;33m'
+    CYAN='\033[0;36m'
+    WHITE='\033[1;37m'
+    NC='\033[0m' # No Color
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    CYAN=''
+    WHITE=''
+    NC=''
+fi
+
+# Configuration
+CLI_VERSION="1.9.1"
+INSTALL_DIR="$HOME/.vigthoria"
+REPO_URL="https://market.vigthoria.io/vigthoria/vigthoria-cli"
+GIT_PACKAGE_URL="git+https://market.vigthoria.io/vigthoria/vigthoria-cli.git"
+HOSTED_TARBALL_URL="https://coder.vigthoria.io/releases/vigthoria-cli-${CLI_VERSION}.tgz"
+
+# Detect platform and set appropriate bin directory
+detect_platform() {
+    OS="$(uname -s)"
+    ARCH="$(uname -m)"
+    
+    case "$OS" in
+        Darwin)
+            PLATFORM="macos"
+            # macOS: Check if /usr/local/bin is writable, otherwise use ~/.local/bin
+            if [ -w "/usr/local/bin" ]; then
+                BIN_DIR="/usr/local/bin"
+            else
+                BIN_DIR="$HOME/.local/bin"
+                mkdir -p "$BIN_DIR"
+            fi
+            ;;
+        Linux)
+            PLATFORM="linux"
+            # Linux: Prefer ~/.local/bin for user installs
+            if [ -w "/usr/local/bin" ]; then
+                BIN_DIR="/usr/local/bin"
+            else
+                BIN_DIR="$HOME/.local/bin"
+                mkdir -p "$BIN_DIR"
+            fi
+            ;;
+        *)
+            echo -e "${RED}Unsupported operating system: $OS${NC}"
+            echo "Please use the npm install method: npm install -g vigthoria-cli"
+            exit 1
+            ;;
+    esac
+    
+    echo -e "${CYAN}Detected: $PLATFORM ($ARCH)${NC}"
+}
+
+echo -e "${CYAN}"
+echo "╔═══════════════════════════════════════════════════════════╗"
+echo "║                                                           ║"
+echo "║         VIGTHORIA CLI INSTALLER v${CLI_VERSION}                  ║"
+echo "║         AI-Powered Terminal Coding Assistant              ║"
+echo "║                                                           ║"
+echo "╚═══════════════════════════════════════════════════════════╝"
+echo -e "${NC}"
+
+# Check requirements
+check_requirements() {
+    echo -e "${CYAN}Checking requirements...${NC}"
+    
+    detect_platform
+    
+    # Check Node.js
+    if ! command -v node &> /dev/null; then
+        echo -e "${RED}✗ Node.js is not installed${NC}"
+        echo ""
+        echo "  Please install Node.js 18 or later:"
+        if [ "$PLATFORM" = "macos" ]; then
+            echo "    brew install node"
+            echo "    or download from: https://nodejs.org/"
+        else
+            echo "    # Ubuntu/Debian:"
+            echo "    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -"
+            echo "    sudo apt-get install -y nodejs"
+            echo ""
+            echo "    # Or download from: https://nodejs.org/"
+        fi
+        exit 1
+    fi
+    
+    NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+    if [ "$NODE_VERSION" -lt 18 ]; then
+        echo -e "${RED}✗ Node.js version must be 18 or higher (found: v$NODE_VERSION)${NC}"
+        exit 1
+    fi
+    echo -e "${GREEN}✓ Node.js v$(node -v | cut -d'v' -f2)${NC}"
+    
+    # Check npm
+    if ! command -v npm &> /dev/null; then
+        echo -e "${RED}✗ npm is not installed${NC}"
+        exit 1
+    fi
+    echo -e "${GREEN}✓ npm v$(npm -v)${NC}"
+    
+    # Check git (optional)
+    if command -v git &> /dev/null; then
+        echo -e "${GREEN}✓ git v$(git --version | cut -d' ' -f3)${NC}"
+    else
+        echo -e "${YELLOW}⚠ git not found (optional, for project context)${NC}"
+    fi
+    
+    echo ""
+}
+
+# Install CLI
+install_cli() {
+    echo -e "${CYAN}Installing Vigthoria CLI...${NC}"
+    
+    # Create install directory
+    mkdir -p "$INSTALL_DIR"
+    
+    # Option 1: Install the hosted release package.
+    if curl -fsI "$HOSTED_TARBALL_URL" > /dev/null 2>&1; then
+        echo "Installing hosted release package..."
+        npm install -g --force "$HOSTED_TARBALL_URL"
+    elif npm view vigthoria-cli version &> /dev/null; then
+        echo "Installing from npm registry..."
+        npm install -g --force vigthoria-cli
+    elif npm install -g --force "$GIT_PACKAGE_URL"; then
+        echo "Installed from git package fallback."
+    else
+        # Option 2: Install from local or git
+        echo "Installing from source..."
+        
+        # Check if we're in the CLI directory
+        if [ -f "package.json" ] && grep -q '"name": "vigthoria-cli"' package.json; then
+            echo "Installing from current directory..."
+            npm install
+            npm run build
+            npm link
+        else
+            # Clone from repo
+            echo "Cloning from repository..."
+            git clone "$REPO_URL" "$INSTALL_DIR/cli" 2>/dev/null || {
+                echo -e "${YELLOW}Repository not available, using local install${NC}"
+                # Copy local files for development
+                SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+                if [ -d "$SCRIPT_DIR/../src" ]; then
+                    cp -r "$SCRIPT_DIR/.." "$INSTALL_DIR/cli"
+                fi
+            }
+            
+            if [ -d "$INSTALL_DIR/cli" ]; then
+                cd "$INSTALL_DIR/cli"
+                npm install
+                npm run build
+                npm link
+            fi
+        fi
+    fi
+    
+    echo -e "${GREEN}✓ Installation complete${NC}"
+    echo ""
+}
+
+# Create symlinks
+create_symlinks() {
+    echo -e "${CYAN}Creating command shortcuts...${NC}"
+    
+    # Check if vigthoria command exists
+    if command -v vigthoria &> /dev/null; then
+        echo -e "${GREEN}✓ 'vigthoria' command available${NC}"
+    fi
+    
+    # Create 'vig' alias if not exists
+    if ! command -v vig &> /dev/null; then
+        if [ -w "$BIN_DIR" ]; then
+            ln -sf "$(which vigthoria)" "$BIN_DIR/vig" 2>/dev/null || true
+        fi
+    fi
+    
+    if command -v vig &> /dev/null; then
+        echo -e "${GREEN}✓ 'vig' shortcut available${NC}"
+    fi
+    
+    echo ""
+}
+
+# Setup shell completion
+setup_completion() {
+    echo -e "${CYAN}Setting up shell completion...${NC}"
+    
+    # Detect shell
+    SHELL_NAME=$(basename "$SHELL")
+    
+    case "$SHELL_NAME" in
+        bash)
+            COMPLETION_FILE="$HOME/.bash_completion.d/vigthoria"
+            mkdir -p "$HOME/.bash_completion.d"
+            cat > "$COMPLETION_FILE" << 'EOF'
+_vigthoria_completions() {
+    local cur="${COMP_WORDS[COMP_CWORD]}"
+    local commands="chat edit generate explain fix review login logout status config init"
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+}
+complete -F _vigthoria_completions vigthoria
+complete -F _vigthoria_completions vig
+EOF
+            echo -e "${GREEN}✓ Bash completion installed${NC}"
+            echo "  Run: source ~/.bash_completion.d/vigthoria"
+            ;;
+        zsh)
+            COMPLETION_FILE="$HOME/.zsh/completion/_vigthoria"
+            mkdir -p "$HOME/.zsh/completion"
+            cat > "$COMPLETION_FILE" << 'EOF'
+#compdef vigthoria vig
+
+_vigthoria() {
+    local -a commands
+    commands=(
+        'chat:Start interactive chat with AI'
+        'edit:Edit a file with AI assistance'
+        'generate:Generate code from description'
+        'explain:Explain code in a file'
+        'fix:Fix issues in a file'
+        'review:Review code quality'
+        'login:Login to Vigthoria'
+        'logout:Logout from Vigthoria'
+        'status:Show account status'
+        'config:Configure settings'
+        'init:Initialize project'
+    )
+    _describe 'command' commands
+}
+
+_vigthoria "$@"
+EOF
+            echo -e "${GREEN}✓ Zsh completion installed${NC}"
+            echo "  Add to ~/.zshrc: fpath=(~/.zsh/completion \$fpath)"
+            ;;
+        *)
+            echo -e "${YELLOW}⚠ Shell completion not available for $SHELL_NAME${NC}"
+            ;;
+    esac
+    
+    echo ""
+}
+
+# Print success message
+print_success() {
+    echo -e "${GREEN}"
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo "║         ✓ VIGTHORIA CLI INSTALLED SUCCESSFULLY!           ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    
+    echo -e "${CYAN}Quick Start:${NC}"
+    echo ""
+    echo "  1. Login to your account:"
+    echo -e "     ${WHITE}vigthoria login${NC}"
+    echo ""
+    echo "  2. Start coding with AI:"
+    echo -e "     ${WHITE}vigthoria chat${NC}"
+    echo ""
+    echo "  3. Edit a file:"
+    echo -e "     ${WHITE}vigthoria edit myfile.ts${NC}"
+    echo ""
+    echo "  4. Generate code:"
+    echo -e "     ${WHITE}vigthoria generate \"REST API endpoint\"${NC}"
+    echo ""
+    echo -e "${CYAN}Commands:${NC}"
+    echo "  vigthoria chat      - Interactive AI chat"
+    echo "  vigthoria edit      - Edit files with AI"
+    echo "  vigthoria generate  - Generate code"
+    echo "  vigthoria explain   - Explain code"
+    echo "  vigthoria fix       - Fix code issues"
+    echo "  vigthoria review    - Code review"
+    echo "  vigthoria --help    - Show all commands"
+    echo ""
+    echo -e "${CYAN}Shortcuts:${NC}"
+    echo "  vig c  = vigthoria chat"
+    echo "  vig e  = vigthoria edit"
+    echo "  vig g  = vigthoria generate"
+    echo ""
+    echo -e "Documentation: ${CYAN}https://docs.vigthoria.io/cli${NC}"
+    echo ""
+}
+
+# Main installation flow
+main() {
+    check_requirements
+    install_cli
+    create_symlinks
+    setup_completion
+    print_success
+}
+
+# Run main
+main "$@"

package/package.json

@@ -1,14 +1,29 @@
 {
   "name": "vigthoria-cli",
-  "version": "1.9.2",
+  "version": "1.9.8",
   "description": "Vigthoria Coder CLI - AI-powered terminal coding assistant",
   "main": "dist/index.js",
   "files": [
     "dist",
+    "scripts/release",
     "README.md",
     "SECURITY_HARDENING.md",
-    "CLI_DIRECT_API_ARCHITECTURE.md"
+    "CLI_DIRECT_API_ARCHITECTURE.md",
+    "install.sh",
+    "install.ps1"
   ],
+  "publishConfig": {
+    "files": [
+      "dist/",
+      "scripts/release/",
+      "README.md",
+      "SECURITY_HARDENING.md",
+      "CLI_DIRECT_API_ARCHITECTURE.md",
+      "install.sh",
+      "install.ps1",
+      "package.json"
+    ]
+  },
   "bin": {
     "vigthoria": "dist/index.js",
     "vig": "dist/index.js",
@@ -44,7 +59,7 @@
     "test:game:live": "npm run build && node scripts/test-live-game-push.js",
     "proof:agent": "npm run build && node scripts/proof-agent-mode.js",
     "test:fresh-install": "node scripts/test-fresh-install.js",
-    "prepublishOnly": "npm run build && node scripts/verify-package-hygiene.js && node scripts/test-fresh-install.js",
+    "prepublishOnly": "npm run build && npm run validate:no-go && node scripts/verify-package-hygiene.js && node scripts/test-fresh-install.js",
     "precheck:services": "node scripts/precheck-local-services.js",
     "test:model:governance": "npm run build && node scripts/test-model-governance-no-agent.js",
     "validate:no-go": "bash scripts/release/validate-no-go-gates.sh",

package/scripts/release/LOCAL_MACHINE_USER_VERIFICATION.md

@@ -0,0 +1,159 @@
+# Vigthoria CLI Local Machine Verification Checklist
+
+Use this checklist on real user machines before and after rollout. The goal is to verify install, auth, routing, update, and core command reliability in the same environment users run.
+
+## 1. Preflight
+
+- [ ] Node.js `>=18` available
+- [ ] `npm` available
+- [ ] No stale shell aliases shadowing `vigthoria`
+- [ ] Network access to:
+  - `https://coder.vigthoria.io`
+  - `https://api.vigthoria.io`
+- [ ] If running browser runtime proofs: Chrome available for Puppeteer
+
+Commands:
+
+```bash
+node -v
+npm -v
+which vigthoria || where.exe vigthoria
+```
+
+## 2. Install and Version Integrity
+
+- [ ] Install succeeds
+- [ ] Reported version matches release target
+- [ ] Binary resolves to expected package
+
+Commands:
+
+```bash
+npm install -g vigthoria-cli@latest
+vigthoria --version
+vigthoria doctor
+```
+
+Expected:
+- `vigthoria --version` shows current release version
+- `doctor` returns diagnostics without crash
+
+## 3. Auth Reliability
+
+- [ ] Login works
+- [ ] Status shows account, plan, health lines
+- [ ] Invalid token is rejected with gateway-auth message
+
+Commands:
+
+```bash
+vigthoria login
+vigthoria status
+VIGTHORIA_AUTH_TOKEN=invalid-token-for-preflight vigthoria chat --no-agent --model balanced-4b --prompt "ok" --json
+```
+
+Expected:
+- `status` includes `Account Status`, `Plan`, `Overall`, `Coder API`, `Models API`
+- Invalid-token command returns JSON with `success: false` and gateway-auth failure message
+
+## 4. Model and Routing Checks
+
+- [ ] Balanced path resolves to balanced model
+- [ ] Governance fallback maps blocked no-agent models to `vigthoria-v3-code-35b`
+- [ ] Agent direct mode prints command/tool flow (non-JSON mode)
+
+Commands:
+
+```bash
+vigthoria chat --no-agent --model balanced-4b --prompt "reply exactly: ok" --json
+vigthoria chat --no-agent --model creative --prompt "say ok" --json
+vigthoria agent --prompt "Read one file and summarize it" --auto-approve
+```
+
+Expected:
+- balanced output model: `vigthoria-balanced-4b`
+- creative output model: `vigthoria-v3-code-35b`
+- agent run shows direct prompt execution and tool activity
+
+## 5. Command Surface Smoke Tests
+
+- [ ] Aliases work
+- [ ] Bridge status prints valid section and hidden internal endpoints
+- [ ] Operator JSON command succeeds
+
+Commands:
+
+```bash
+vigthoria hyper-loop status
+vigthoria devtools connect
+vigthoria bridge status
+vigthoria operator --prompt "status check" --json
+```
+
+Expected:
+- No crashes
+- `bridge status` shows `DevTools Bridge` and either `Reachable` or `Not running`
+- Operator JSON has `success: true`
+
+## 6. Update Path
+
+- [ ] Update check works
+- [ ] Upgrade path works from npm/manifest
+
+Commands:
+
+```bash
+vigthoria update --check
+vigthoria update
+```
+
+Expected:
+- No script errors
+- Clear success/fallback guidance if update source fails
+
+## 7. Release Gate (Local Build Validation)
+
+Run this on release candidate machines when validating local package changes.
+
+```bash
+npm run build
+npm run validate:no-go
+```
+
+Expected:
+- `ALL NO-GO GATES PASSED`
+
+## 8. Environment-Specific Prerequisites
+
+These are external dependencies, not CLI code regressions:
+
+- Workflow E2E requires reachable VigFlow backend
+- Live repo/game/platform E2E requires:
+  - `VIGTHORIA_COMMUNITY_EMAIL`
+  - `VIGTHORIA_COMMUNITY_PASSWORD`
+- Browser proof requires Chrome installed for Puppeteer runtime
+
+## 9. Rollback Readiness
+
+- [ ] Previous known-good CLI version pinned
+- [ ] One-command rollback documented
+- [ ] Support note prepared for users
+
+Example rollback:
+
+```bash
+npm install -g vigthoria-cli@<known-good-version>
+```
+
+## 10. Signoff Template
+
+- Machine/OS:
+- Node/NPM versions:
+- CLI version validated:
+- Auth check: PASS/FAIL
+- Model routing check: PASS/FAIL
+- Command smoke check: PASS/FAIL
+- Update check: PASS/FAIL
+- No-go gate: PASS/FAIL
+- Approved by:
+- Timestamp:

package/scripts/release/publish-cli-release.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Publish Vigthoria CLI release artifact + manifest entry.
+# Usage:
+#   HOST_DOWNLOADS_DIR=/path/to/downloads \
+#   HOST_MANIFEST_FILE=/path/to/releases/manifest.json \
+#   ./scripts/release/publish-cli-release.sh 1.9.0
+
+VERSION="${1:-}"
+if [[ -z "$VERSION" ]]; then
+  echo "Usage: $0 <version>"
+  exit 1
+fi
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+PKG_FILE="$REPO_ROOT/vigthoria-cli-${VERSION}.tgz"
+HOST_DOWNLOADS_DIR="${HOST_DOWNLOADS_DIR:-}"
+HOST_MANIFEST_FILE="${HOST_MANIFEST_FILE:-}"
+PUBLIC_BASE_URL="${PUBLIC_BASE_URL:-https://cli.vigthoria.io/downloads}"
+CHANNEL="${CHANNEL:-stable}"
+
+if [[ ! -f "$PKG_FILE" ]]; then
+  echo "Artifact not found: $PKG_FILE"
+  echo "Run: npm pack"
+  exit 1
+fi
+
+if [[ -z "$HOST_DOWNLOADS_DIR" || -z "$HOST_MANIFEST_FILE" ]]; then
+  echo "Set HOST_DOWNLOADS_DIR and HOST_MANIFEST_FILE before running."
+  exit 1
+fi
+
+SHA256="$(sha256sum "$PKG_FILE" | awk '{print $1}')"
+URL="$PUBLIC_BASE_URL/vigthoria-cli-${VERSION}.tgz"
+
+echo "Publishing vigthoria-cli v${VERSION}"
+echo "Artifact: $PKG_FILE"
+echo "SHA256:   $SHA256"
+echo "URL:      $URL"
+
+install -d "$HOST_DOWNLOADS_DIR"
+cp -f "$PKG_FILE" "$HOST_DOWNLOADS_DIR/"
+
+echo "Copied artifact to $HOST_DOWNLOADS_DIR"
+
+if [[ ! -f "$HOST_MANIFEST_FILE" ]]; then
+  echo "Manifest does not exist at: $HOST_MANIFEST_FILE"
+  echo "Create it first with {\"channels\":{\"stable\":{}}}"
+  exit 1
+fi
+
+python3 - << PYEOF
+import json, pathlib
+manifest_path = pathlib.Path(r"$HOST_MANIFEST_FILE")
+data = json.loads(manifest_path.read_text())
+data.setdefault("channels", {})
+data["channels"].setdefault("$CHANNEL", {})
+data["channels"]["$CHANNEL"].update({
+  "version": "$VERSION",
+  "url": "$URL",
+  "sha256": "$SHA256",
+  "notes": "Automated publish via scripts/release/publish-cli-release.sh"
+})
+manifest_path.write_text(json.dumps(data, indent=2) + "\n")
+print("Manifest updated:", manifest_path)
+PYEOF
+
+echo "Publish complete."
+echo "Verification commands:"
+echo "  curl -I $URL"
+echo "  curl -fsSL https://coder.vigthoria.io/releases/manifest.json | head -40"
+echo "  node dist/index.js update --check --manifest https://coder.vigthoria.io/releases/manifest.json --channel $CHANNEL"