@miller-tech/uap 1.9.1 → 1.10.0

package/scripts/maintenance/update-uap-compliance.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# Update all UAP components for v2.3.0 compatibility
+# This script ensures CLAUDE.md, skills, and droids are aligned
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"
+
+echo "=== UAP Compliance Update Script ==="
+echo "Target: CLAUDE.md v2.3.0+"
+echo ""
+
+# Step 1: Verify CLAUDE.md version
+echo "Step 1/4: Checking CLAUDE.md version..."
+if grep -q "CLAUDE.md v2\.[2-9]" "$PROJECT_ROOT/CLAUDE.md" || \
+   grep -q "CLAUDE.md v3\." "$PROJECT_ROOT/CLAUDE.md"; then
+    echo "  ✓ CLAUDE.md version compatible"
+else
+    echo "  ✗ CLAUDE.md needs update to v2.3.0+"
+    exit 1
+fi
+
+# Step 2: Update skills
+echo ""
+echo "Step 2/4: Updating skills..."
+python3 "$SCRIPT_DIR/update-skills.py" || {
+    echo "  ⚠ Skills update failed, continuing anyway"
+}
+
+# Step 3: Update droids
+echo ""
+echo "Step 3/4: Updating droids..."
+python3 "$SCRIPT_DIR/update-droids.py" || {
+    echo "  ⚠ Droids update failed, continuing anyway"
+}
+
+# Step 4: Verify compliance
+echo ""
+echo "Step 4/4: Verifying UAP compliance..."
+bash "$SCRIPT_DIR/verify-compliance.sh"
+
+echo ""
+echo "=== Update Complete ==="
+echo "All components updated for CLAUDE.md v2.3.0+"

package/scripts/maintenance/validate-skills.py

@@ -0,0 +1,83 @@
+#!/usr/bin/env python3
+"""Validate all skills include required v2.3.0 markers."""
+
+import os
+import sys
+from pathlib import Path
+
+SKILLS_DIR = os.path.join(
+    os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
+    ".factory",
+    "skills",
+)
+
+required_markers = [
+    "compatibility: CLAUDE.md v2.3.0+",
+    "@hooks-session-start.md",
+    "DECISION LOOP",
+    "MANDATORY",
+]
+
+print("=== Validating Skills for UAM v2.3.0 Compliance ===\n")
+
+errors = []
+warnings = []
+
+for skill_dir in os.listdir(SKILLS_DIR):
+    skill_path = os.path.join(SKILLS_DIR, skill_dir)
+
+    if not os.path.isdir(skill_path):
+        continue
+
+    skill_file = os.path.join(skill_path, "SKILL.md")
+
+    if not os.path.exists(skill_file):
+        errors.append(f"{skill_dir}/SKILL.md: File not found")
+        continue
+
+    with open(skill_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    skill_name = skill_dir
+
+    # Check required markers
+    for marker in required_markers:
+        if marker not in content:
+            errors.append(f"{skill_name}: Missing '{marker}'")
+
+    # Warn about optional but recommended markers
+    optional_markers = [
+        "Completion Gates Checklist",
+        "Verifier-First",
+        "Memory Integration",
+    ]
+
+    for marker in optional_markers:
+        if marker not in content:
+            warnings.append(f"{skill_name}: Missing optional '{marker}' (recommended)")
+
+# Report results
+if errors:
+    print("❌ ERRORS - Skills missing required markers:")
+    for error in errors:
+        print(f"  ✗ {error}")
+    print()
+
+if warnings:
+    print("⚠️  WARNINGS - Skills missing optional markers:")
+    for warning in warnings[:5]:  # Show first 5 warnings
+        print(f"  ⚠ {warning}")
+    if len(warnings) > 5:
+        print(f"  ... and {len(warnings) - 5} more")
+    print()
+
+if not errors and not warnings:
+    print("✓ All skills are compliant with UAM v2.3.0!")
+    sys.exit(0)
+elif not errors:
+    print("✓ Skills pass all required checks (warnings shown above)")
+    sys.exit(0)
+else:
+    print("\n❌ Validation FAILED")
+    print("Run 'npm run update-skills' to fix issues")
+    sys.exit(1)

package/scripts/maintenance/verify-compliance.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+# Verify UAP compliance for CLAUDE.md v2.3.0+
+
+echo "=== UAP Compliance Verification ==="
+echo ""
+
+score=0
+total=12
+
+# 1. CLAUDE.md version check
+if grep -q "CLAUDE.md v2\.[2-9]\|CLAUDE.md v3\." CLAUDE.md; then
+    ((score++))
+    echo "✓ CLAUDE.md version (v2.x+/v3.x)"
+else
+    echo "✗ CLAUDE.md version not found"
+fi
+
+# 2. SESSION START block
+if grep -q "## SESSION START" CLAUDE.md && grep -q "uap task ready" CLAUDE.md; then
+    ((score++))
+    echo "✓ SESSION START block with uap task ready"
+else
+    echo "✗ SESSION START block MISSING"
+fi
+
+# 3. DECISION LOOP with skills reference
+if grep -q "@Skill:name.md" CLAUDE.md; then
+    ((score++))
+    echo "✓ DECISION LOOP with @Skill:name.md reference"
+else
+    echo "✗ DECISION LOOP skills reference MISSING"
+fi
+
+# 4. MANDATORY worktree enforcement
+if grep -q "WORKTREE WORKFLOW — MANDATORY\|## WORKTREE WORKFLOW.*MANDATORY" CLAUDE.md; then
+    ((score++))
+    echo "✓ MANDATORY worktree enforcement present"
+else
+    echo "✗ MANDATORY worktree enforcement MISSING"
+fi
+
+# 5. PARALLEL REVIEW PROTOCOL
+if grep -q "## PARALLEL REVIEW PROTOCOL" CLAUDE.md; then
+    ((score++))
+    echo "✓ PARALLEL REVIEW PROTOCOL present"
+else
+    echo "✗ PARALLEL REVIEW PROTOCOL MISSING"
+fi
+
+# 6. Schema diff gate ordering
+if grep -q "BLOCKING PREREQUISITES.*Schema Diff Gate\|1\. \*\*Schema Diff Gate" CLAUDE.md; then
+    ((score++))
+    echo "✓ Schema diff gate in BLOCKING PREREQUISITES"
+else
+    echo "✗ Schema diff gate NOT in blocking prerequisites"
+fi
+
+# 7. VERIFIER-FIRST section
+if grep -q "## VERIFIER-FIRST" CLAUDE.md; then
+    ((score++))
+    echo "✓ VERIFIER-FIRST section present"
+else
+    echo "✗ VERIFIER-FIRST MISSING"
+fi
+
+# 8. COMPLETION GATES - MANDATORY
+if grep -q "COMPLETION GATES.*-.*MANDATORY\|## COMPLETION GATES - MANDATORY" CLAUDE.md; then
+    ((score++))
+    echo "✓ COMPLETION GATES - MANDATORY present"
+else
+    echo "✗ COMPLETION GATES - MANDATORY MISSING"
+fi
+
+# 9. Pattern Router requirement
+if grep -q "Pattern.*Router\|pattern router" CLAUDE.md; then
+    ((score++))
+    echo "✓ Pattern Router documented"
+else
+    echo "✗ Pattern Router MISSING"
+fi
+
+# 10. RTK includes
+if grep -q "@hooks-session-start.md\|@PreCompact.md" CLAUDE.md; then
+    ((score++))
+    echo "✓ RTK includes (@hooks-session-start, @PreCompact)"
+else
+    echo "✗ RTK includes MISSING"
+fi
+
+# 11. Verifier loop enforcement (min 3 runs)
+if grep -q "MANDATORY.*minimum 3 times\|MANDATORY.*3 times" CLAUDE.md; then
+    ((score++))
+    echo "✓ Verifier loop enforced (min 3 runs)"
+else
+    echo "✗ Verifier loop enforcement MISSING"
+fi
+
+# 12. Skills directory structure
+if [ -d ".factory/skills" ] && [ "$(ls -A .factory/skills 2>/dev/null)" ]; then
+    ((score++))
+    echo "✓ Skills directory populated"
+else
+    echo "✗ Skills directory MISSING or empty"
+fi
+
+echo ""
+echo "=== UAP COMPLIANCE SCORE: $score/$total ($(( score * 100 / total ))%) ==="
+echo ""
+
+if [ "$score" -eq "$total" ]; then
+    echo "✓ All compliance checks passed!"
+    exit 0
+else
+    echo "✗ Compliance check failed! Score: $score/$total"
+    echo "Run 'npm run update-uap' to fix issues"
+    exit 1
+fi

package/scripts/setup/install-cloakbrowser.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+
+try {
+  console.log('Installing CloakBrowser dependencies...');
+  execSync('npm install cloakbrowser playwright-core', { stdio: 'inherit' });
+  console.log('\nInstalling Playwright browsers...');
+  execSync('npx playwright install chromium', { stdio: 'inherit' });
+  console.log('\n✅ CloakBrowser ready!');
+  console.log('\nTo use: import { createWebBrowser } from "universal-agent-protocol/browser";');
+} catch (error) {
+  console.error('❌ Installation failed:', error.message);
+  process.exit(1);
+}

package/scripts/setup/install-desktop.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+REPO_URL="https://github.com/DammianMiller/universal-agent-protocol"
+
+echo -e "${GREEN}Universal Agent Memory - Desktop Installation${NC}"
+echo "============================================"
+echo ""
+
+# Check for Node.js
+if ! command -v node &> /dev/null; then
+    echo -e "${RED}Error: Node.js is not installed${NC}"
+    echo "Please install Node.js 18+ from https://nodejs.org/"
+    exit 1
+fi
+
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo -e "${RED}Error: Node.js 18+ required (you have $(node -v))${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓${NC} Node.js $(node -v) detected"
+
+# Check for npm
+if ! command -v npm &> /dev/null; then
+    echo -e "${RED}Error: npm is not installed${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓${NC} npm $(npm -v) detected"
+
+# Check for Docker (optional)
+if command -v docker &> /dev/null; then
+    echo -e "${GREEN}✓${NC} Docker detected - local Qdrant available"
+    DOCKER_AVAILABLE=true
+else
+    echo -e "${YELLOW}⚠${NC} Docker not found - will use cloud backends only"
+    DOCKER_AVAILABLE=false
+fi
+
+# Install the CLI globally
+echo ""
+echo "Installing universal-agent-protocol..."
+
+# Try npm install first, fall back to git clone if package not published yet
+if npm install -g universal-agent-protocol 2>/dev/null; then
+    echo -e "${GREEN}✓${NC} Installed from npm registry"
+else
+    echo -e "${YELLOW}Package not yet on npm, installing from GitHub...${NC}"
+    
+    # Install to user's local directory
+    INSTALL_DIR="${HOME}/.universal-agent-protocol"
+    
+    # Remove old installation if exists
+    if [ -d "$INSTALL_DIR" ]; then
+        echo "Removing previous installation..."
+        rm -rf "$INSTALL_DIR"
+    fi
+    
+    # Clone and install
+    git clone --depth 1 "$REPO_URL.git" "$INSTALL_DIR"
+    cd "$INSTALL_DIR"
+    npm install --production=false
+    npm run build
+    npm link
+    
+    echo -e "${GREEN}✓${NC} Installed from GitHub to $INSTALL_DIR"
+fi
+
+echo ""
+echo -e "${GREEN}Installation complete!${NC}"
+echo ""
+echo "Next steps:"
+echo "  1. Initialize UAP in your project:"
+echo "     $ cd /path/to/your/project"
+echo "     $ uap init"
+echo ""
+echo "  2. Review the generated CLAUDE.md"
+echo ""
+echo "  3. Start working - your AI assistant will follow the workflows!"
+echo ""
+
+if [ "$DOCKER_AVAILABLE" = true ]; then
+    echo "  2. Start local memory services (optional):"
+    echo "     $ uap memory start"
+    echo ""
+    echo "     Or use cloud backends:"
+else
+    echo "  2. Configure cloud memory backends:"
+fi
+
+echo "     - GitHub: export GITHUB_TOKEN=your_token"
+echo "     - Qdrant Cloud: export QDRANT_API_KEY=your_key && export QDRANT_URL=your_url"
+echo ""
+echo "  3. Generate CLAUDE.md for your project:"
+echo "     $ uap generate"
+echo ""
+echo "Documentation: ${REPO_URL}#readme"

package/scripts/setup/install-rtk.sh

@@ -0,0 +1,184 @@
+#!/usr/bin/env bash
+# RTK (Rust Token Killer) Installation Script for UAP
+# Auto-detects OS and installs RTK via appropriate method
+
+set -euo pipefail
+
+echo "🔧 Installing RTK (Rust Token Killer)..."
+echo "   Reduces LLM token consumption by 60-90% on CLI commands"
+echo ""
+
+# Detect OS and architecture
+detect_os() {
+    if [[ "$(uname -s)" == "Darwin" ]]; then
+        echo "macOS"
+    elif [[ "$(uname -s)" == "Linux" ]]; then
+        echo "Linux"
+    elif [[ "$(uname -s)" =~ MINGW.* || "$(uname -s)" =~ MSYS* ]]; then
+        echo "Windows"
+    else
+        echo "Unknown"
+    fi
+}
+
+detect_arch() {
+    local arch=$(uname -m)
+    case $arch in
+        x86_64) echo "x86_64" ;;
+        arm64|aarch64) echo "arm64" ;;
+        *) echo "$arch" ;;
+    esac
+}
+
+OS=$(detect_os)
+ARCH=$(detect_arch)
+
+echo "Detected: $OS ($ARCH)"
+echo ""
+
+# Check if Homebrew is available (macOS/Linux)
+check_brew() {
+    command -v brew &> /dev/null && echo "yes" || echo "no"
+}
+
+# Check if cargo is installed
+check_cargo() {
+    command -v cargo &> /dev/null && echo "yes" || echo "no"
+}
+
+# Check if RTK is already installed
+check_rtk_installed() {
+    command -v rtk &> /dev/null && echo "yes" || echo "no"
+}
+
+RTK_INSTALLED=$(check_rtk_installed)
+
+if [[ "$RTK_INSTALLED" == "yes" ]]; then
+    CURRENT_VERSION=$(rtk --version 2>&1 | head -1)
+    echo "ℹ RTK is already installed: $CURRENT_VERSION"
+    echo ""
+    read -p "Do you want to upgrade to the latest version? [y/N] " -n 1 -r
+    echo ""
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        echo "Skipping installation."
+        exit 0
+    fi
+fi
+
+# Installation methods (in order of preference)
+install_methods=(
+    "homebrew"
+    "cargo"
+    "curl_install"
+)
+
+INSTALL_SUCCESS=false
+
+for method in "${install_methods[@]}"; do
+    echo "📦 Trying installation method: $method"
+    
+    case $method in
+        homebrew)
+            if [[ "$OS" == "macOS" ]] || (check_brew == "yes"); then
+                echo "   Installing via Homebrew..."
+                if brew install rtk &> /dev/null; then
+                    INSTALL_SUCCESS=true
+                    break
+                fi
+            fi
+            ;;
+            
+        cargo)
+            if check_cargo == "yes"; then
+                echo "   Installing via Cargo..."
+                if cargo install --git https://github.com/rtk-ai/rtk --quiet 2>&1; then
+                    INSTALL_SUCCESS=true
+                    break
+                fi
+            fi
+            ;;
+            
+        curl_install)
+            if [[ "$OS" == "macOS" ]] || [[ "$OS" == "Linux" ]]; then
+                echo "   Installing via curl..."
+                TEMP_DIR=$(mktemp -d)
+                cd "$TEMP_DIR"
+                
+                # Download appropriate binary based on OS/arch
+                if [[ "$ARCH" == "arm64" ]]; then
+                    BINARY="rtk-aarch64-apple-darwin.tar.gz"
+                else
+                    BINARY="rtk-x86_64-apple-darwin.tar.gz"
+                fi
+                
+                if [[ "$OS" == "Linux" ]]; then
+                    if [[ "$ARCH" == "arm64" ]]; then
+                        BINARY="rtk-aarch64-unknown-linux-gnu.tar.gz"
+                    else
+                        BINARY="rtk-x86_64-unknown-linux-musl.tar.gz"
+                    fi
+                fi
+                
+                echo "   Downloading: $BINARY"
+                
+                if curl -fsSL "https://github.com/rtk-ai/rtk/releases/latest/download/$BINARY" -o rtk.tar.gz 2>&1; then
+                    tar -xzf rtk.tar.gz
+                    chmod +x rtk
+                    
+                    # Move to local bin or PATH
+                    if [[ -d "$HOME/.local/bin" ]] || echo "$PATH" | grep -q "$HOME/.local/bin"; then
+                        mkdir -p "$HOME/.local/bin"
+                        mv rtk "$HOME/.local/bin/"
+                        echo "   Installed to: $HOME/.local/bin/rtk"
+                    else
+                        sudo mkdir -p /usr/local/bin
+                        sudo mv rtk /usr/local/bin/
+                        echo "   Installed to: /usr/local/bin/rtk"
+                    fi
+                    
+                    INSTALL_SUCCESS=true
+                    cd ..
+                    rm -rf "$TEMP_DIR"
+                    break
+                fi
+            fi
+            ;;
+    esac
+    
+    echo "   ✗ Failed: $method"
+done
+
+# Verify installation
+if [[ "$INSTALL_SUCCESS" == "true" ]]; then
+    if command -v rtk &> /dev/null; then
+        VERSION=$(rtk --version 2>&1 | head -1)
+        echo ""
+        echo "✅ RTK installed successfully!"
+        echo "   Version: $VERSION"
+        echo ""
+        echo "📚 Next steps:"
+        echo "   1. Initialize hook for Claude Code:"
+        echo "      rtk init --global"
+        echo ""
+        echo "   2. Verify installation:"
+        echo "      rtk gain"
+        echo ""
+        echo "   3. View token savings:"
+        echo "      rtk gain --graph"
+        echo ""
+    else
+        echo "❌ Installation completed but RTK binary not found in PATH"
+        echo "   Please ensure $HOME/.local/bin is in your PATH:"
+        echo '   echo '\''export PATH="$HOME/.local/bin:$PATH"'\'' >> ~/.bashrc'
+        exit 1
+    fi
+else
+    echo ""
+    echo "❌ All installation methods failed"
+    echo ""
+    echo "Manual installation options:"
+    echo "  1. Homebrew (macOS/Linux): brew install rtk"
+    echo "  2. Cargo: cargo install --git https://github.com/rtk-ai/rtk"
+    echo "  3. Pre-built binaries: https://github.com/rtk-ai/rtk/releases"
+    exit 1
+fi

package/scripts/setup/install-web.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+set -e
+
+REPO_URL="https://github.com/DammianMiller/universal-agent-protocol"
+
+echo "🚀 Universal Agent Memory - Web Platform Setup"
+echo ""
+
+# Check for required tools
+if ! command -v node &> /dev/null; then
+    echo "❌ Node.js is required. Install from https://nodejs.org"
+    exit 1
+fi
+
+if ! command -v npm &> /dev/null; then
+    echo "❌ npm is required. Install from https://nodejs.org"
+    exit 1
+fi
+
+echo "✅ Node.js $(node -v) detected"
+echo "✅ npm $(npm -v) detected"
+
+# Install CLI globally
+echo ""
+echo "📦 Installing universal-agent-protocol CLI..."
+
+# Try npm install first, fall back to git clone if package not published yet
+if npm install -g universal-agent-protocol 2>/dev/null; then
+    echo "✅ Installed from npm registry"
+else
+    echo "⚠️  Package not yet on npm, installing from GitHub..."
+    
+    # Install to user's local directory
+    INSTALL_DIR="${HOME}/.universal-agent-protocol"
+    
+    # Remove old installation if exists
+    if [ -d "$INSTALL_DIR" ]; then
+        echo "Removing previous installation..."
+        rm -rf "$INSTALL_DIR"
+    fi
+    
+    # Clone and install
+    git clone --depth 1 "$REPO_URL.git" "$INSTALL_DIR"
+    cd "$INSTALL_DIR"
+    npm install --production=false
+    npm run build
+    npm link
+    
+    echo "✅ Installed from GitHub to $INSTALL_DIR"
+fi
+
+# Initialize in current directory
+echo ""
+echo "⚙️  Initializing project..."
+uap init --web --interactive
+
+echo ""
+echo "✅ Setup complete!"
+echo ""
+echo "Next steps:"
+echo "  1. Initialize UAP in your project:"
+echo "     uap init"
+echo ""
+echo "  2. Review the generated CLAUDE.md"
+echo ""
+echo "  3. Start working - your AI assistant will follow the workflows!"
+echo ""
+echo "Optional: Set up cloud memory backends"
+echo "   export GITHUB_TOKEN=your_token"
+echo "   export QDRANT_API_KEY=your_key"
+echo "   export QDRANT_URL=your_url"
+echo ""
+echo "Documentation: ${REPO_URL}#readme"