@miller-tech/uap 1.8.1 → 1.10.0

package/scripts/setup/setup.sh

@@ -0,0 +1,375 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+HOOKS_DIR="${PROJECT_ROOT}/.git/hooks"
+
+echo -e "${BLUE}🔧 Universal Agent Memory - Complete Setup${NC}"
+echo "================================================"
+echo ""
+
+# ============================================================================
+# DEPENDENCY CHECKS
+# ============================================================================
+
+echo -e "${BLUE}Checking dependencies...${NC}"
+echo ""
+
+MISSING_DEPS=()
+RECOMMENDED_DEPS=()
+
+# Required dependencies
+echo -e "${YELLOW}Required dependencies:${NC}"
+
+if ! command -v node &> /dev/null; then
+    echo -e "  ${RED}✗${NC} Node.js (>= 18.0.0)"
+    MISSING_DEPS+=("Node.js >= 18.0.0")
+else
+    NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+    if [ "$NODE_VERSION" -lt 18 ]; then
+        echo -e "  ${RED}✗${NC} Node.js (>= 18.0.0, found $(node -v))"
+        MISSING_DEPS+=("Node.js >= 18.0.0")
+    else
+        echo -e "  ${GREEN}✓${NC} Node.js $(node -v)"
+    fi
+fi
+
+if ! command -v npm &> /dev/null; then
+    echo -e "  ${RED}✗${NC} npm"
+    MISSING_DEPS+=("npm")
+else
+    echo -e "  ${GREEN}✓${NC} npm $(npm -v)"
+fi
+
+if ! command -v git &> /dev/null; then
+    echo -e "  ${RED}✗${NC} git"
+    MISSING_DEPS+=("git")
+else
+    echo -e "  ${GREEN}✓${NC} git $(git --version | cut -d' ' -f3)"
+fi
+
+if ! command -v npx &> /dev/null; then
+    echo -e "  ${RED}✗${NC} npx"
+    MISSING_DEPS+=("npx")
+else
+    echo -e "  ${GREEN}✓${NC} npx"
+fi
+
+echo ""
+echo -e "${YELLOW}Recommended dependencies (optional but useful):${NC}"
+
+if command -v docker &> /dev/null; then
+    echo -e "  ${GREEN}✓${NC} Docker (enables local Qdrant for semantic search)"
+else
+    echo -e "  ${YELLOW}⚠${NC} Docker (install for local Qdrant: `curl -fsSL https://get.docker.com | sh`)"
+    RECOMMENDED_DEPS+=("Docker")
+fi
+
+if command -v python3 &> /dev/null; then
+    PYTHON_VERSION=$(python3 --version | cut -d' ' -f2)
+    echo -e "  ${GREEN}✓${NC} Python 3 (${PYTHON_VERSION}) (enables Pattern RAG)"
+else
+    echo -e "  ${YELLOW}⚠${NC} Python 3 (install for Pattern RAG: `brew install python` or `apt install python3`)"
+    RECOMMENDED_DEPS+=("Python 3")
+fi
+
+if command -v pre-commit &> /dev/null; then
+    echo -e "  ${GREEN}✓${NC} pre-commit (enables advanced git hooks)"
+else
+    echo -e "  ${YELLOW}⚠${NC} pre-commit (install for advanced hooks: `pip install pre-commit`)"
+fi
+
+echo ""
+
+# ============================================================================
+# INSTALLATION
+# ============================================================================
+
+if [ ${#MISSING_DEPS[@]} -gt 0 ]; then
+    echo -e "${RED}❌ Missing required dependencies:${NC}"
+    for dep in "${MISSING_DEPS[@]}"; do
+        echo -e "  - ${dep}"
+    done
+    echo ""
+    echo "Please install the missing dependencies and run this script again."
+    echo ""
+    echo "Quick install commands:"
+    echo "  # macOS:"
+    echo "  brew install node git python docker"
+    echo ""
+    echo "  # Ubuntu/Debian:"
+    echo "  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -"
+    echo "  sudo apt-get install -y nodejs python3 docker.io"
+    echo ""
+    echo "  # Windows (using winget):"
+    echo "  winget install OpenJS.NodeJS.LTS"
+    echo "  winget install Git.Git"
+    echo "  winget install Python.Python.3.12"
+    echo "  winget install Docker.DockerDesktop"
+    echo ""
+    exit 1
+fi
+
+# Install npm dependencies
+echo -e "${BLUE}Installing npm dependencies...${NC}"
+cd "$PROJECT_ROOT"
+
+if [ ! -d "node_modules" ]; then
+    npm install
+    echo -e "${GREEN}✓${NC} npm dependencies installed"
+else
+    echo -e "${GREEN}✓${NC} npm dependencies already installed (skipping)"
+fi
+
+# Build TypeScript
+echo ""
+echo -e "${BLUE}Building TypeScript...${NC}"
+npm run build
+if [ $? -eq 0 ]; then
+    echo -e "${GREEN}✓${NC} TypeScript build completed"
+else
+    echo -e "${RED}✗${NC} TypeScript build failed"
+    exit 1
+fi
+
+# ============================================================================
+# GIT HOOKS SETUP
+# ============================================================================
+
+echo ""
+echo -e "${BLUE}Setting up git hooks...${NC}"
+
+# Create hooks directory if it doesn't exist
+if [ ! -d "$HOOKS_DIR" ]; then
+    echo -e "  ${YELLOW}⚠${NC} Not a git repository, skipping hooks setup"
+else
+    # Create hooks directory
+    mkdir -p "$HOOKS_DIR"
+    
+    # Pre-commit hook - enforces worktree usage and code quality
+    cat > "${HOOKS_DIR}/pre-commit" << 'HOOKEOF'
+#!/usr/bin/env bash
+# UAP Pre-Commit Hook — Enforces worktree usage and code quality
+set -euo pipefail
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[0;33m'; NC='\033[0m'
+fail() { echo -e "${RED}[PRE-COMMIT] BLOCKED: $1${NC}"; exit 1; }
+warn() { echo -e "${YELLOW}[PRE-COMMIT] WARNING: $1${NC}"; }
+ok()   { echo -e "${GREEN}[PRE-COMMIT] $1${NC}"; }
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+
+# Gate 1: Worktree Enforcement — NO EXCEPTIONS
+UAP_CONFIG="${PROJECT_ROOT}/.uap.json"
+WORKTREE_ENABLED="true"
+if [[ -f "$UAP_CONFIG" ]] && command -v python3 &>/dev/null; then
+  WORKTREE_ENABLED=$(python3 -c "
+import json
+try:
+    c = json.load(open('$UAP_CONFIG'))
+    print('true' if c.get('template',{}).get('sections',{}).get('worktreeWorkflow', True) else 'false')
+except: print('true')
+" 2>/dev/null || echo "true")
+fi
+
+if [[ "$WORKTREE_ENABLED" == "true" ]]; then
+  CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+  GIT_COMMON_DIR=$(git rev-parse --git-common-dir 2>/dev/null || echo "")
+  GIT_DIR=$(git rev-parse --git-dir 2>/dev/null || echo "")
+  IS_WORKTREE="false"
+  if [[ "$GIT_DIR" != "$GIT_COMMON_DIR" ]]; then IS_WORKTREE="true"; fi
+
+  if [[ "$IS_WORKTREE" == "false" && ("$CURRENT_BRANCH" == "main" || "$CURRENT_BRANCH" == "master") ]]; then
+    fail "Direct commits to '$CURRENT_BRANCH' are prohibited. No exceptions.
+  Use a worktree: uap worktree create <slug>
+  Then work in: .worktrees/<id>-<slug>/
+  Version bumps must be done on the feature branch before merging.
+  See: policies/worktree-enforcement.md"
+  fi
+  ok "Worktree check passed"
+fi
+
+# Gate 2: No secrets in staged files
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM 2>/dev/null || echo "")
+for file in $STAGED_FILES; do
+  case "$file" in
+    .env|.env.*|*.pem|*.key|credentials.json|*secret*|*.p12)
+      fail "Potential secret file staged: $file";;
+  esac
+done
+ok "Secret scan passed"
+
+# Gate 3: No debug code (warning only)
+TS_STAGED=$(echo "$STAGED_FILES" | grep '\.ts$' || true)
+if [[ -n "$TS_STAGED" ]]; then
+  for file in $TS_STAGED; do
+    if [[ -f "$file" ]]; then
+      MATCHES=$(git diff --cached -U0 -- "$file" 2>/dev/null | grep '^+' | grep -n 'console\.log\|debugger;' | head -3 || true)
+      if [[ -n "$MATCHES" ]]; then
+        warn "Debug code in ${file}: ${MATCHES}"
+      fi
+    fi
+  done
+fi
+
+ok "All pre-commit gates passed"
+HOOKEOF
+    chmod +x "${HOOKS_DIR}/pre-commit"
+    echo "  ✓ Created pre-commit hook"
+
+    # Commit-msg hook - validates commit messages
+    cat > "${HOOKS_DIR}/commit-msg" << 'EOF'
+#!/bin/bash
+#
+# UAP Commit-msg Hook
+#
+# Ensures commit messages follow conventional commits format:
+# - feat: New feature
+# - fix: Bug fix
+# - docs: Documentation
+# - style: Formatting
+# - refactor: Code refactoring
+# - test: Tests
+# - chore: Maintenance
+#
+
+COMMIT_MSG_FILE=$1
+COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")
+
+# Skip if commit is empty or merge commit
+if [[ -z "$COMMIT_MSG" ]] || [[ "$COMMIT_MSG" == "Merge"* ]]; then
+    exit 0
+fi
+
+# Check for conventional commit format
+if echo "$COMMIT_MSG" | grep -qE "^(feat|fix|docs|style|refactor|test|chore|perf|ci|build|revert)(\([a-z-]+\))?: .+"; then
+    echo "✓ Commit message format valid"
+    exit 0
+else
+    echo "Warning: Commit message doesn't follow conventional commits format."
+    echo "Recommended format: type(scope): description"
+    echo "Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build, revert"
+    echo ""
+    echo "Examples:"
+    echo "  feat: Add worktree creation command"
+    echo "  fix(api): Resolve memory database path issue"
+    echo "  docs: Update README with setup instructions"
+    echo ""
+    echo "Continue with commit? [y/N] "
+    read -r response
+    if [[ "$response" =~ ^(yes|y|Y)$ ]]; then
+        exit 0
+    else
+        echo "Commit aborted. Please edit your commit message."
+        exit 1
+    fi
+fi
+EOF
+    chmod +x "${HOOKS_DIR}/commit-msg"
+    echo "  ✓ Created commit-msg hook"
+
+    # Pre-push hook - runs tests before pushing
+    cat > "${HOOKS_DIR}/pre-push" << 'EOF'
+#!/bin/bash
+#
+# UAP Pre-push Hook
+#
+# Runs tests before pushing to remote
+#
+
+echo "Running tests before push..."
+if npm test 2>&1 | tail -5; then
+    if [ ${PIPESTATUS[0]} -eq 0 ]; then
+        echo "✓ All tests passed"
+        exit 0
+    fi
+fi
+
+echo "Error: Tests failed. Fix tests before pushing."
+exit 1
+EOF
+    chmod +x "${HOOKS_DIR}/pre-push"
+    echo "  ✓ Created pre-push hook"
+
+    echo ""
+    echo -e "${GREEN}✓${NC} Git hooks configured successfully"
+fi
+
+# ============================================================================
+# OPTIONAL: CREATE .GITCHRCL (for GitHub CLI)
+# ============================================================================
+
+if command -v gh &> /dev/null; then
+    echo ""
+    echo -e "${BLUE}GitHub CLI detected. Setting up default PR template...${NC}"
+    
+    if [ ! -f "${PROJECT_ROOT}/.github/pull_request_template.md" ]; then
+        mkdir -p "${PROJECT_ROOT}/.github"
+        cat > "${PROJECT_ROOT}/.github/pull_request_template.md" << 'EOF'
+<!-- UAP Worktree PR Template -->
+## Summary
+<!-- Describe what this PR does -->
+
+## Changes
+<!-- List key changes -->
+- 
+
+## Testing
+<!-- How did you test this? -->
+- [ ] Tests pass: `npm test`
+- [ ] Linting passes: `npm run lint`
+- [ ] Manually tested (if applicable)
+
+## Related Issue
+<!-- Link to related issue if any -->
+Closes #
+
+---
+<!-- UAP - Created via worktree: uap worktree pr -->
+EOF
+        echo "  ✓ Created PR template"
+    fi
+fi
+
+# ============================================================================
+# SETUP COMPLETE
+# ============================================================================
+
+echo ""
+echo -e "${GREEN}✅ Setup complete!${NC}"
+echo ""
+
+if [ ${#RECOMMENDED_DEPS[@]} -gt 0 ]; then
+    echo -e "${YELLOW}Recommended: Install missing optional dependencies${NC}"
+    for dep in "${RECOMMENDED_DEPS[@]}"; do
+        echo "  - ${dep}"
+    done
+    echo ""
+    echo "You can install these later. Core functionality will work without them."
+    echo ""
+fi
+
+echo -e "${BLUE}Next steps:${NC}"
+echo ""
+echo "1. Initialize UAP in your project:"
+echo "   npx universal-agent-protocol 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: https://github.com/DammianMiller/universal-agent-protocol"

package/scripts/validate-build.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# UAP Pre-Edit Build Gate
+# Run before and after editing TypeScript files to ensure build integrity.
+#
+# Usage:
+#   bash scripts/validate-build.sh          # Quick: tsc --noEmit only
+#   bash scripts/validate-build.sh --full   # Full: tsc build + lint check
+#
+# Exit codes:
+#   0 = build passes (safe to edit / edit was clean)
+#   1 = build fails (do NOT proceed with more edits; fix first)
+
+set -euo pipefail
+
+PROJECT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+MODE="${1:-quick}"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+NC='\033[0m'
+
+log_ok()   { echo -e "${GREEN}[BUILD-GATE] $1${NC}"; }
+log_fail() { echo -e "${RED}[BUILD-GATE] $1${NC}"; }
+log_warn() { echo -e "${YELLOW}[BUILD-GATE] $1${NC}"; }
+
+cd "$PROJECT_DIR"
+
+if [[ "$MODE" == "--full" ]]; then
+  echo -e "${YELLOW}[BUILD-GATE] Running full build validation...${NC}"
+
+  # Step 1: Full TypeScript compilation
+  if npm run build 2>&1; then
+    log_ok "TypeScript build passed"
+  else
+    log_fail "TypeScript build FAILED - fix errors before continuing"
+    exit 1
+  fi
+
+  # Step 2: Lint check (if available)
+  if command -v npx &>/dev/null && [[ -f ".eslintrc.json" || -f ".eslintrc.cjs" || -f ".eslintrc.js" || -f "eslint.config.js" || -f "eslint.config.mjs" ]]; then
+    if npx eslint src/ --quiet 2>&1; then
+      log_ok "Lint check passed"
+    else
+      log_warn "Lint warnings detected (non-blocking)"
+    fi
+  fi
+
+  log_ok "Full build validation passed"
+else
+  echo -e "${YELLOW}[BUILD-GATE] Running quick type check...${NC}"
+
+  # Quick mode: type-check only (no emit), faster than full build
+  if npx tsc --noEmit 2>&1; then
+    log_ok "Type check passed"
+  else
+    log_fail "Type check FAILED - fix errors before continuing"
+    exit 1
+  fi
+
+  log_ok "Quick validation passed"
+fi

package/scripts/version-bump.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+set -euo pipefail
+
+# version-bump.sh — Automated semver version bump with validation
+#
+# Usage:
+#   ./scripts/version-bump.sh patch   # fix, chore, refactor, etc.
+#   ./scripts/version-bump.sh minor   # feat (new functionality)
+#   ./scripts/version-bump.sh major   # breaking changes
+#
+# What it does:
+#   1. Validates working tree is clean
+#   2. Runs tests and build
+#   3. Bumps version in package.json
+#   4. Prepends dated entry to CHANGELOG.md
+#   5. Commits package.json + CHANGELOG.md
+#   6. Creates git tag vX.Y.Z
+
+LEVEL="${1:-}"
+
+if [[ -z "$LEVEL" ]]; then
+  echo "Usage: $0 <patch|minor|major>"
+  echo ""
+  echo "  patch  — bug fixes, chores, refactors (X.Y.Z+1)"
+  echo "  minor  — new features (X.Y+1.0)"
+  echo "  major  — breaking changes (X+1.0.0)"
+  exit 1
+fi
+
+if [[ "$LEVEL" != "patch" && "$LEVEL" != "minor" && "$LEVEL" != "major" ]]; then
+  echo "Error: level must be 'patch', 'minor', or 'major' (got '$LEVEL')"
+  exit 1
+fi
+
+# 1. Validate working tree is clean
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Error: working tree is not clean. Commit or stash changes first."
+  echo ""
+  git status --short
+  exit 1
+fi
+
+# Get current version before bump
+OLD_VERSION=$(node -p "require('./package.json').version")
+echo "Current version: $OLD_VERSION"
+
+# 2. Run tests and build to confirm project is healthy
+echo ""
+echo "Running tests..."
+npm test -- --run 2>&1 || {
+  echo "Error: tests failed. Fix tests before bumping version."
+  exit 1
+}
+
+echo ""
+echo "Running build..."
+npm run build 2>&1 || {
+  echo "Error: build failed. Fix build before bumping version."
+  exit 1
+}
+
+# 2b. Restore clean tree (tests may create temp files like test droids)
+git checkout -- . 2>/dev/null || true
+git clean -fd .factory/droids/test-droid-* 2>/dev/null || true
+
+# 3. Bump version in package.json (no git tag yet — we do it after changelog)
+npm version "$LEVEL" --no-git-tag-version > /dev/null 2>&1
+
+NEW_VERSION=$(node -p "require('./package.json').version")
+echo ""
+echo "Version bump: $OLD_VERSION -> $NEW_VERSION ($LEVEL)"
+
+# 4. Prepend dated entry to CHANGELOG.md
+DATE=$(date +%Y-%m-%d)
+CHANGELOG_ENTRY="## v${NEW_VERSION} (${DATE})"
+
+# Get commit messages since last tag for the changelog body
+LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+if [[ -n "$LAST_TAG" ]]; then
+  COMMITS=$(git log "${LAST_TAG}..HEAD" --pretty=format:"- %s" --no-merges 2>/dev/null || echo "")
+else
+  COMMITS=$(git log --pretty=format:"- %s" --no-merges -10 2>/dev/null || echo "")
+fi
+
+if [[ -z "$COMMITS" ]]; then
+  COMMITS="- Version bump"
+fi
+
+# Build the new changelog section
+CHANGELOG_SECTION="${CHANGELOG_ENTRY}
+
+${COMMITS}
+"
+
+# Prepend to CHANGELOG.md (after the # Changelog header)
+if [[ -f "CHANGELOG.md" ]]; then
+  # Insert after the first line (# Changelog header)
+  HEADER=$(head -1 CHANGELOG.md)
+  BODY=$(tail -n +2 CHANGELOG.md)
+  cat > CHANGELOG.md <<EOF
+${HEADER}
+
+${CHANGELOG_SECTION}
+${BODY}
+EOF
+else
+  cat > CHANGELOG.md <<EOF
+# Changelog
+
+${CHANGELOG_SECTION}
+EOF
+fi
+
+echo "Updated CHANGELOG.md with v${NEW_VERSION} entry"
+
+# 5. Stage and commit
+git add package.json package-lock.json CHANGELOG.md 2>/dev/null || git add package.json CHANGELOG.md
+git commit -m "chore: bump version to ${NEW_VERSION}"
+
+# 6. Create git tag
+git tag -a "v${NEW_VERSION}" -m "Release v${NEW_VERSION}"
+
+echo ""
+echo "Done: v${NEW_VERSION}"
+echo "  - package.json updated"
+echo "  - CHANGELOG.md updated"
+echo "  - Committed: chore: bump version to ${NEW_VERSION}"
+echo "  - Tagged: v${NEW_VERSION}"
+echo ""
+echo "To push: git push && git push --tags"

package/tools/agents/scripts/migrate_memory_to_qdrant.py

@@ -25,7 +25,7 @@ try:
 except ImportError as e:
     print(f"Error: Missing required packages: {e}")
     print("\nPlease install dependencies:")
-    print("  cd /home/cogtek/dev/miller-tech/universal-agent-memory")
+    print("  cd /home/cogtek/dev/miller-tech/universal-agent-protocol")
     print("  agents/.venv/bin/pip install sentence-transformers qdrant-client")
     print("\nThen run:")
     print("  agents/.venv/bin/python agents/scripts/migrate_memory_to_qdrant.py")