@intent-systems/nexus 2026.1.5-3

package/skills/upstream-sync/scripts/auto-port.sh

@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Auto-port conflict-free commits from upstream to nexus
+# This script attempts to cherry-pick commits and rolls back on conflict
+
+usage() {
+  cat <<'USAGE'
+Usage: auto-port.sh [options]
+
+Automatically port conflict-free commits from upstream to nexus.
+
+Options:
+  --nexus-path PATH      Path to nexus repo (default: from env or current directory)
+  --since DATE           Only consider commits since date (default: "1 week ago")
+  --dry-run              Show what would be ported without making changes
+  --max-commits N        Maximum commits to port in one run (default: 10)
+  --skip-tests           Skip running tests after porting (faster but riskier)
+  --skip-docs            Skip documentation-only commits
+  --skip-tests-commits   Skip test-only commits
+  -h, --help             Show this help
+
+Environment:
+  NEXUS_PATH             Default nexus repository path
+
+Output:
+  Creates a log file at ~/.nexus/state/upstream-sync/port-log.jsonl
+  with records of successful and failed port attempts.
+USAGE
+}
+
+# Defaults
+nexus_path="${NEXUS_PATH:-}"
+since_date="1 week ago"
+dry_run=false
+max_commits=10
+skip_tests=false
+skip_docs=true
+skip_tests_commits=true
+log_dir="$HOME/.nexus/state/upstream-sync"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --nexus-path) nexus_path="$2"; shift 2 ;;
+    --since) since_date="$2"; shift 2 ;;
+    --dry-run) dry_run=true; shift ;;
+    --max-commits) max_commits="$2"; shift 2 ;;
+    --skip-tests) skip_tests=true; shift ;;
+    --skip-docs) skip_docs=true; shift ;;
+    --no-skip-docs) skip_docs=false; shift ;;
+    --skip-tests-commits) skip_tests_commits=true; shift ;;
+    --no-skip-tests-commits) skip_tests_commits=false; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+# Resolve nexus path
+if [[ -z "$nexus_path" ]]; then
+  if [[ -d ".git" ]] || [[ -f ".git" ]]; then
+    nexus_path="."
+  elif [[ -d "$HOME/nexus/home/projects/nexus/.git" ]] || [[ -f "$HOME/nexus/home/projects/nexus/.git" ]]; then
+    nexus_path="$HOME/nexus/home/projects/nexus"
+  else
+    echo "Error: Could not detect nexus repository. Use --nexus-path" >&2
+    exit 1
+  fi
+fi
+
+# Validate paths (handle both regular repos and submodules/worktrees)
+if [[ ! -d "$nexus_path/.git" ]] && [[ ! -f "$nexus_path/.git" ]]; then
+  echo "Error: Nexus repository not found at: $nexus_path" >&2
+  exit 1
+fi
+
+if [[ ! -d "$nexus_path/.git" ]] && [[ ! -f "$nexus_path/.git" ]]; then
+  echo "Error: Nexus repository not found at: $nexus_path" >&2
+  exit 1
+fi
+
+# Create log directory
+mkdir -p "$log_dir"
+log_file="$log_dir/port-log.jsonl"
+
+log_result() {
+  local hash="$1"
+  local subject="$2"
+  local status="$3"
+  local reason="${4:-}"
+  local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  echo "{\"ts\":\"$timestamp\",\"hash\":\"$hash\",\"subject\":\"$subject\",\"status\":\"$status\",\"reason\":\"$reason\"}" >> "$log_file"
+}
+
+# Fetch latest
+echo "🔄 Fetching latest from nexus..." >&2
+(cd "$nexus_path" && git fetch origin main --quiet)
+
+# Ensure upstream remote exists in nexus
+cd "$nexus_path"
+if ! git remote | grep -q "^upstream$"; then
+  echo "Adding upstream remote..." >&2
+  git remote add upstream https://github.com/nexus/nexus.git
+fi
+git fetch upstream main --quiet 2>/dev/null || true
+
+# Find fork point
+fork_point=""
+if git remote | grep -q "^upstream$"; then
+  fork_point=$(git merge-base HEAD upstream/main 2>/dev/null || echo "")
+fi
+if [[ -z "$fork_point" ]]; then
+  fork_point=$(git rev-list --max-parents=0 HEAD)
+fi
+
+echo "📍 Fork point: ${fork_point:0:8}" >&2
+
+# Get commits to consider
+cd "$nexus_path"
+
+# Build filter pattern
+filter_pattern=""
+if [[ "$skip_docs" == "true" ]]; then
+  filter_pattern="${filter_pattern}|^[a-f0-9]+ docs:"
+fi
+if [[ "$skip_tests_commits" == "true" ]]; then
+  filter_pattern="${filter_pattern}|^[a-f0-9]+ test:"
+fi
+# Also skip merge commits, chore, style, ci
+filter_pattern="${filter_pattern}|^[a-f0-9]+ (Merge|chore|style|ci):"
+filter_pattern="${filter_pattern#|}"  # Remove leading |
+
+# Get candidate commits (oldest first for proper ordering)
+commits=$(git log --oneline --reverse --since="$since_date" "${fork_point}..origin/main" 2>/dev/null | \
+  grep -vE "$filter_pattern" | \
+  head -n "$max_commits" || echo "")
+
+if [[ -z "$commits" ]]; then
+  echo "✅ No new commits to port since $since_date"
+  exit 0
+fi
+
+commit_count=$(echo "$commits" | wc -l | tr -d ' ')
+echo "📊 Found $commit_count candidate commits to port" >&2
+echo "" >&2
+
+# Track results
+ported=0
+skipped=0
+failed=0
+
+# Process each commit
+cd "$nexus_path"
+while IFS= read -r line; do
+  hash=$(echo "$line" | cut -d' ' -f1)
+  subject=$(echo "$line" | cut -d' ' -f2-)
+  
+  # Check if already ported (by checking if commit message exists)
+  if git log --oneline --grep="$hash" HEAD 2>/dev/null | grep -q .; then
+    echo "⏭️  Skip $hash: already ported"
+    ((skipped++)) || true
+    continue
+  fi
+  
+  # Check if commit exists in nexus repo
+  if ! (cd "$nexus_path" && git cat-file -e "$hash" 2>/dev/null); then
+    echo "⏭️  Skip $hash: commit not found"
+    ((skipped++)) || true
+    continue
+  fi
+  
+  if [[ "$dry_run" == "true" ]]; then
+    echo "🔍 Would try: $hash $subject"
+    continue
+  fi
+  
+  echo -n "🔄 Trying $hash: $subject... "
+  
+  # Attempt cherry-pick
+  if git cherry-pick "$hash" --no-commit 2>/dev/null; then
+    # Check for any changes
+    if git diff --cached --quiet; then
+      echo "⏭️  no changes"
+      git reset HEAD --hard >/dev/null 2>&1
+      log_result "$hash" "$subject" "skipped" "no changes"
+      ((skipped++)) || true
+      continue
+    fi
+    
+    # Build to verify
+    if [[ "$skip_tests" != "true" ]]; then
+      if ! npm run build >/dev/null 2>&1; then
+        echo "❌ build failed"
+        git reset HEAD --hard >/dev/null 2>&1
+        log_result "$hash" "$subject" "failed" "build failed"
+        ((failed++)) || true
+        continue
+      fi
+    fi
+    
+    # Commit the change
+    git commit -m "$(cat <<EOF
+$subject
+
+Ported from nexus: $hash
+EOF
+)" >/dev/null 2>&1
+    
+    echo "✅ ported"
+    log_result "$hash" "$subject" "ported" ""
+    ((ported++)) || true
+  else
+    echo "❌ conflict"
+    git reset HEAD --hard >/dev/null 2>&1
+    log_result "$hash" "$subject" "failed" "merge conflict"
+    ((failed++)) || true
+  fi
+done <<< "$commits"
+
+echo ""
+echo "📈 Results: $ported ported, $skipped skipped, $failed failed"
+
+if [[ "$ported" -gt 0 ]]; then
+  echo ""
+  echo "💡 Run 'git log --oneline -$ported' to see ported commits"
+  echo "   Run 'git push' when ready to publish"
+fi

package/skills/upstream-sync/scripts/check-all.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: check-all.sh [options]
+
+Check both nexus and pi-ai upstreams for changes.
+
+Options:
+  --nexus-path PATH      Path to nexus repo (default: $NEXUS_PATH or current directory)
+  --since DATE           Show nexus commits since date
+  -h, --help             Show this help
+
+Examples:
+  # Check all upstreams
+  ./check-all.sh
+
+  # Check with custom path
+  ./check-all.sh --nexus-path ~/code/nexus
+USAGE
+}
+
+# Get script directory
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Parse arguments
+nexus_args=()
+pi_ai_args=()
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help) usage; exit 0 ;;
+    --nexus-path)
+      nexus_args+=("$1" "$2")
+      pi_ai_args+=("$1" "$2")
+      shift 2
+      ;;
+    --since|--author|--grep|--limit)
+      # Nexus-only args
+      nexus_args+=("$1" "$2")
+      shift 2
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔄 NEXUS UPSTREAM SYNC CHECK"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Check Nexus
+echo "📦 Checking nexus repository..."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+if [[ ${#nexus_args[@]} -gt 0 ]]; then
+  if ! "$script_dir/check-nexus.sh" "${nexus_args[@]}"; then
+    echo "⚠️  Nexus check failed" >&2
+  fi
+else
+  if ! "$script_dir/check-nexus.sh"; then
+    echo "⚠️  Nexus check failed" >&2
+  fi
+fi
+
+echo ""
+echo ""
+
+# Check Pi-AI
+echo "📦 Checking Pi-AI packages..."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+if [[ ${#pi_ai_args[@]} -gt 0 ]]; then
+  if ! "$script_dir/check-pi-ai.sh" "${pi_ai_args[@]}"; then
+    echo "⚠️  Pi-AI check failed" >&2
+  fi
+else
+  if ! "$script_dir/check-pi-ai.sh"; then
+    echo "⚠️  Pi-AI check failed" >&2
+  fi
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ Upstream sync check complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/skills/upstream-sync/scripts/check-nexus.sh

@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: check-nexus.sh [options]
+
+Check nexus repository for new commits since nexus fork point.
+
+Options:
+  --nexus-path PATH      Path to nexus repo (default: $NEXUS_PATH or current directory)
+  --since DATE           Show commits since date (e.g., "2 weeks ago", "2026-01-01")
+  --author PATTERN       Filter by author name/email (case insensitive)
+  --grep PATTERN         Filter by commit message (case insensitive)
+  --limit N              Limit output to N commits (default: 50)
+  -h, --help             Show this help
+
+Environment:
+  NEXUS_PATH             Default nexus repository path
+
+Examples:
+  # Check for all new commits
+  ./check-nexus.sh
+
+  # Check commits in last 2 weeks
+  ./check-nexus.sh --since "2 weeks ago"
+
+  # Check auth-related commits
+  ./check-nexus.sh --grep "auth"
+
+  # Check commits by specific author
+  ./check-nexus.sh --author "peter"
+USAGE
+}
+
+# Defaults
+nexus_path="${NEXUS_PATH:-}"
+since_date=""
+author_filter=""
+grep_filter=""
+limit=50
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --nexus-path) nexus_path="$2"; shift 2 ;;
+    --since) since_date="$2"; shift 2 ;;
+    --author) author_filter="$2"; shift 2 ;;
+    --grep) grep_filter="$2"; shift 2 ;;
+    --limit) limit="$2"; shift 2 ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+# Validate paths (handle both regular repos and submodules/worktrees)
+if [[ ! -d "$nexus_path/.git" ]] && [[ ! -f "$nexus_path/.git" ]]; then
+  echo "Error: Nexus repository not found at: $nexus_path" >&2
+  exit 1
+fi
+
+if [[ -z "$nexus_path" ]]; then
+  if [[ -d ".git" ]]; then
+    nexus_path="."
+  elif [[ -d "/Users/tyler/Desktop/projects/nexus/.git" ]]; then
+    nexus_path="/Users/tyler/Desktop/projects/nexus"
+  else
+    echo "Error: Could not detect nexus repository. Use --nexus-path" >&2
+    exit 1
+  fi
+fi
+
+if [[ ! -d "$nexus_path/.git" ]]; then
+  echo "Error: Nexus repository not found at: $nexus_path" >&2
+  exit 1
+fi
+
+# Fetch latest from nexus
+echo "Fetching latest from nexus..." >&2
+(cd "$nexus_path" && git fetch origin main --quiet)
+
+# Get the nexus commit that nexus was forked from
+echo "Finding nexus fork point..." >&2
+cd "$nexus_path"
+
+# Try to find the fork point by checking git log for nexus references
+# or by finding the merge-base if nexus remote is configured
+fork_point=""
+if git remote | grep -q "^nexus$"; then
+  # If nexus remote exists, use merge-base
+  fork_point=$(git merge-base HEAD nexus/main 2>/dev/null || echo "")
+fi
+
+if [[ -z "$fork_point" ]]; then
+  # Fallback: look for the earliest commit in nexus
+  # This assumes nexus was forked relatively recently
+  fork_point=$(git rev-list --max-parents=0 HEAD)
+  echo "Warning: Could not determine exact fork point, using first commit: $fork_point" >&2
+fi
+
+echo "Fork point: $fork_point" >&2
+echo "" >&2
+
+# Build git log command
+cd "$nexus_path"
+log_cmd=(git log --oneline --date=short --pretty=format:"%h|%ad|%an|%s")
+
+# Add range
+log_cmd+=("${fork_point}..origin/main")
+
+# Add filters
+if [[ -n "$since_date" ]]; then
+  log_cmd+=(--since="$since_date")
+fi
+
+if [[ -n "$author_filter" ]]; then
+  log_cmd+=(--author="$author_filter")
+fi
+
+if [[ -n "$grep_filter" ]]; then
+  log_cmd+=(--grep="$grep_filter" -i)
+fi
+
+# Execute and format output
+commits=$("${log_cmd[@]}" | head -n "$limit" || echo "")
+
+if [[ -z "$commits" ]]; then
+  echo "✅ No new commits found in nexus since fork point"
+  exit 0
+fi
+
+commit_count=$(echo "$commits" | wc -l | tr -d ' ')
+echo "📊 Found $commit_count new commits in nexus:"
+echo ""
+echo "Hash   | Date       | Author              | Subject"
+echo "-------|------------|---------------------|--------"
+echo "$commits" | while IFS='|' read -r hash date author subject; do
+  printf "%-7s| %-10s | %-19s | %s\n" "$hash" "$date" "$author" "$subject"
+done
+
+echo ""
+echo "💡 Review these commits to see if any changes should be ported to nexus."
+echo "   Focus on: authentication, sessions, gateway, agent runtime, ODU patterns"
+echo ""
+echo "To see details of a specific commit:"
+echo "  cd $nexus_path && git show <hash>"

package/skills/upstream-sync/scripts/check-pi-ai.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: check-pi-ai.sh [options]
+
+Check pi-ai npm packages for new versions.
+
+Options:
+  --nexus-path PATH      Path to nexus repo (default: $NEXUS_PATH or current directory)
+  -h, --help             Show this help
+
+Environment:
+  NEXUS_PATH             Default nexus repository path
+
+Packages checked:
+  - @mariozechner/pi-agent-core
+  - @mariozechner/pi-coding-agent
+
+Examples:
+  # Check for new pi-ai versions
+  ./check-pi-ai.sh
+
+  # Specify nexus path
+  ./check-pi-ai.sh --nexus-path /path/to/nexus
+USAGE
+}
+
+# Defaults
+nexus_path="${NEXUS_PATH:-}"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --nexus-path) nexus_path="$2"; shift 2 ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+# Detect nexus path
+if [[ -z "$nexus_path" ]]; then
+  if [[ -f "package.json" && -d ".git" ]]; then
+    nexus_path="."
+  elif [[ -f "/Users/tyler/Desktop/projects/nexus/package.json" ]]; then
+    nexus_path="/Users/tyler/Desktop/projects/nexus"
+  else
+    echo "Error: Could not detect nexus repository. Use --nexus-path" >&2
+    exit 1
+  fi
+fi
+
+if [[ ! -f "$nexus_path/package.json" ]]; then
+  echo "Error: package.json not found at: $nexus_path" >&2
+  exit 1
+fi
+
+# Check if npm is available
+if ! command -v npm >/dev/null 2>&1; then
+  echo "Error: npm not found in PATH" >&2
+  exit 1
+fi
+
+# Pi-AI packages to check
+packages=(
+  "@mariozechner/pi-agent-core"
+  "@mariozechner/pi-coding-agent"
+)
+
+echo "Checking pi-ai package versions..." >&2
+echo "" >&2
+
+any_updates=false
+
+for package in "${packages[@]}"; do
+  # Get current version from package.json using grep
+  # Format: "  \"@mariozechner/pi-agent-core\": \"^0.37.2\","
+  current_version=$(grep -E "\"${package//\//\\/}\":" "$nexus_path/package.json" | \
+    head -1 | \
+    sed -E 's/.*"([0-9^~][^"]+)".*/\1/' || echo "not installed")
+
+  # Strip ^ or ~ prefix for comparison
+  current_version_clean="${current_version#^}"
+  current_version_clean="${current_version_clean#~}"
+
+  if [[ "$current_version" == "not installed" || -z "$current_version" ]]; then
+    echo "⚠️  $package: NOT INSTALLED"
+    continue
+  fi
+
+  # Get latest version from npm
+  latest_version=$(npm view "$package" version 2>/dev/null || echo "unknown")
+
+  if [[ "$latest_version" == "unknown" ]]; then
+    echo "❓ $package: $current_version (could not check npm)"
+    continue
+  fi
+
+  # Compare versions (ignoring ^ or ~)
+  if [[ "$current_version_clean" == "$latest_version" ]]; then
+    echo "✅ $package: $current_version (up to date)"
+  else
+    echo "🔄 $package: $current_version → $latest_version (update available)"
+    any_updates=true
+  fi
+done
+
+echo ""
+
+if [[ "$any_updates" == true ]]; then
+  echo "💡 Updates available! To update:"
+  echo "   cd $nexus_path"
+  echo "   pnpm update @mariozechner/pi-agent-core @mariozechner/pi-coding-agent"
+  echo ""
+  echo "⚠️  Review changelog before updating (auth/OAuth changes may affect nexus):"
+  for package in "${packages[@]}"; do
+    echo "   npm view $package versions --json  # See all versions"
+    echo "   npm view $package@latest             # See latest version details"
+  done
+else
+  echo "✅ All pi-ai packages are up to date"
+fi
+
+echo ""
+echo "📚 Pi-AI repositories:"
+echo "   https://github.com/mariozechner/pi-agent"
+echo "   https://www.npmjs.com/package/@mariozechner/pi-agent-core"
+echo "   https://www.npmjs.com/package/@mariozechner/pi-coding-agent"

package/skills/video-frames/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: video-frames
+description: Extract frames or short clips from videos using ffmpeg.
+homepage: https://ffmpeg.org
+metadata: {"nexus":{"emoji":"🎞️","requires":{"bins":["ffmpeg"]},"install":[{"id":"brew","kind":"brew","formula":"ffmpeg","bins":["ffmpeg"],"label":"Install ffmpeg (brew)"}]}}
+---
+
+# Video Frames (ffmpeg)
+
+Extract a single frame from a video, or create quick thumbnails for inspection.
+
+## Quick start
+
+First frame:
+
+```bash
+{baseDir}/scripts/frame.sh /path/to/video.mp4 --out /tmp/frame.jpg
+```
+
+At a timestamp:
+
+```bash
+{baseDir}/scripts/frame.sh /path/to/video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
+```
+
+## Notes
+
+- Prefer `--time` for “what is happening around here?”.
+- Use a `.jpg` for quick share; use `.png` for crisp UI frames.

package/skills/video-frames/scripts/frame.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat >&2 <<'EOF'
+Usage:
+  frame.sh <video-file> [--time HH:MM:SS] [--index N] --out /path/to/frame.jpg
+
+Examples:
+  frame.sh video.mp4 --out /tmp/frame.jpg
+  frame.sh video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
+  frame.sh video.mp4 --index 0 --out /tmp/frame0.png
+EOF
+  exit 2
+}
+
+if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+fi
+
+in="${1:-}"
+shift || true
+
+time=""
+index=""
+out=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --time)
+      time="${2:-}"
+      shift 2
+      ;;
+    --index)
+      index="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out="${2:-}"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1" >&2
+      usage
+      ;;
+  esac
+done
+
+if [[ ! -f "$in" ]]; then
+  echo "File not found: $in" >&2
+  exit 1
+fi
+
+if [[ "$out" == "" ]]; then
+  echo "Missing --out" >&2
+  usage
+fi
+
+mkdir -p "$(dirname "$out")"
+
+if [[ "$index" != "" ]]; then
+  ffmpeg -hide_banner -loglevel error -y \
+    -i "$in" \
+    -vf "select=eq(n\\,${index})" \
+    -vframes 1 \
+    "$out"
+elif [[ "$time" != "" ]]; then
+  ffmpeg -hide_banner -loglevel error -y \
+    -ss "$time" \
+    -i "$in" \
+    -frames:v 1 \
+    "$out"
+else
+  ffmpeg -hide_banner -loglevel error -y \
+    -i "$in" \
+    -vf "select=eq(n\\,0)" \
+    -vframes 1 \
+    "$out"
+fi
+
+echo "$out"