auramaxx 1.0.0-alpha.4

package/scripts/sandbox.sh

@@ -0,0 +1,175 @@
+#!/bin/bash
+
+# sandbox.sh — Launch AuraWallet in a fully isolated temp environment
+#
+# Usage: ./scripts/sandbox.sh [terminal|dashboard|mcp|agent] [init args...]
+#
+# Creates a temp data dir, runs on alternate ports (5242/5747/5748),
+# and cleans up on exit. Your real ~/.aurawallet/ is never touched.
+
+set -eo pipefail
+
+MODE="${1:-terminal}"
+if [[ "$#" -gt 0 ]]; then
+  shift
+fi
+INIT_ARGS=("$@")
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Sandbox ports (offset from defaults to avoid conflicts)
+SANDBOX_WALLET_PORT=5242
+SANDBOX_DASHBOARD_PORT=5747
+SANDBOX_WS_PORT=5748
+
+# Kill any leftover sandbox processes from a previous run
+echo ""
+echo "  Cleaning up stale sandbox processes..."
+for port in $SANDBOX_WALLET_PORT $SANDBOX_DASHBOARD_PORT $SANDBOX_WS_PORT; do
+  lsof -ti ":$port" 2>/dev/null | xargs kill 2>/dev/null || true
+done
+sleep 0.5
+
+# Create isolated temp directory
+SANDBOX_DIR="$(mktemp -d /tmp/aurawallet-sandbox-XXXXXX)"
+mkdir -p "$SANDBOX_DIR/hot" "$SANDBOX_DIR/pending"
+
+echo ""
+echo "  AuraWallet Sandbox"
+echo "  ──────────────────"
+echo ""
+echo "  Mode:      $MODE"
+if [[ ${#INIT_ARGS[@]} -gt 0 ]]; then
+  echo "  Init args: ${INIT_ARGS[*]}"
+fi
+echo "  Data dir:  $SANDBOX_DIR"
+echo "  Wallet:    http://127.0.0.1:$SANDBOX_WALLET_PORT"
+echo "  Dashboard: http://localhost:$SANDBOX_DASHBOARD_PORT"
+echo "  WebSocket: ws://127.0.0.1:$SANDBOX_WS_PORT"
+echo ""
+
+cleanup() {
+  echo ""
+  echo "  Cleaning up sandbox..."
+  # Kill sandbox port processes
+  for port in $SANDBOX_WALLET_PORT $SANDBOX_DASHBOARD_PORT $SANDBOX_WS_PORT; do
+    lsof -ti ":$port" 2>/dev/null | xargs kill 2>/dev/null || true
+  done
+  rm -rf "$SANDBOX_DIR"
+  echo "  Sandbox removed: $SANDBOX_DIR"
+  echo ""
+}
+trap cleanup EXIT
+
+# Common env vars for full isolation
+export WALLET_DATA_DIR="$SANDBOX_DIR"
+export DATABASE_URL="file:$SANDBOX_DIR/aurawallet.db"
+export WALLET_SERVER_PORT="$SANDBOX_WALLET_PORT"
+export WALLET_SERVER_URL="http://127.0.0.1:$SANDBOX_WALLET_PORT"
+export WS_PORT="$SANDBOX_WS_PORT"
+export DASHBOARD_PORT="$SANDBOX_DASHBOARD_PORT"
+export BYPASS_RATE_LIMIT="true"
+export SANDBOX_MODE="true"
+
+# Run Prisma migrations against the sandbox DB
+echo "  Running database migrations..."
+cd "$PROJECT_ROOT"
+npx prisma migrate deploy --schema=prisma/schema.prisma 2>/dev/null || \
+  npx prisma migrate dev --name sandbox --schema=prisma/schema.prisma 2>/dev/null
+echo "  Database ready"
+echo ""
+
+case "$MODE" in
+  terminal)
+    # Run the full init wizard — it starts its own server
+    echo "  Starting terminal setup wizard..."
+    echo ""
+    npx aurawallet init "${INIT_ARGS[@]}"
+    ;;
+
+  dashboard)
+    # Run the full init wizard — it starts server + dashboard
+    echo "  Starting dashboard setup wizard..."
+    echo ""
+    npx aurawallet init "${INIT_ARGS[@]}"
+    ;;
+
+  mcp)
+    # Start Express server directly (headless, no init wizard)
+    echo "  Starting wallet server..."
+    npx tsx server/index.ts &
+
+    # Wait for server to be ready
+    echo "  Waiting for server..."
+    for i in $(seq 1 30); do
+      if curl -sf "http://127.0.0.1:$SANDBOX_WALLET_PORT/health" >/dev/null 2>&1; then
+        echo "  Server ready"
+        echo ""
+        echo "  ── MCP Sandbox Instructions ──"
+        echo ""
+        echo "  To test MCP onboarding, run in another terminal:"
+        echo ""
+        echo "    WALLET_SERVER_URL=http://127.0.0.1:$SANDBOX_WALLET_PORT npx aurawallet mcp"
+        echo ""
+        echo "  Or test manually:"
+        echo ""
+        echo "    curl http://127.0.0.1:$SANDBOX_WALLET_PORT/health"
+        echo "    curl http://127.0.0.1:$SANDBOX_WALLET_PORT/setup"
+        echo ""
+        echo "  Press Ctrl+C to stop and clean up."
+        echo ""
+        wait
+        break
+      fi
+      sleep 1
+    done
+
+    if ! curl -sf "http://127.0.0.1:$SANDBOX_WALLET_PORT/health" >/dev/null 2>&1; then
+      echo "  Server failed to start within 30 seconds."
+      exit 1
+    fi
+    ;;
+
+  agent)
+    # Start Express server + dashboard for agent-assisted onboarding testing
+    echo "  Starting wallet server..."
+    npx tsx server/index.ts &
+
+    echo "  Waiting for server..."
+    for i in $(seq 1 30); do
+      if curl -sf "http://127.0.0.1:$SANDBOX_WALLET_PORT/health" >/dev/null 2>&1; then
+        break
+      fi
+      sleep 1
+    done
+
+    if ! curl -sf "http://127.0.0.1:$SANDBOX_WALLET_PORT/health" >/dev/null 2>&1; then
+      echo "  Server failed to start within 30 seconds."
+      exit 1
+    fi
+
+    echo "  Server ready"
+    echo ""
+    echo "  Starting dashboard..."
+    npx next dev -p $SANDBOX_DASHBOARD_PORT &
+
+    echo ""
+    echo "  ── Agent Sandbox Ready ──"
+    echo ""
+    echo "  Dashboard: http://localhost:$SANDBOX_DASHBOARD_PORT"
+    echo "  Server:    http://127.0.0.1:$SANDBOX_WALLET_PORT"
+    echo ""
+    echo "  Open the dashboard to create your vault."
+    echo "  Connect your agent — it will detect the unconfigured state."
+    echo ""
+    echo "  Press Ctrl+C to stop and clean up."
+    echo ""
+    wait
+    ;;
+
+  *)
+    echo "  Unknown mode: $MODE"
+    echo "  Usage: $0 [terminal|dashboard|mcp|agent]"
+    exit 1
+    ;;
+esac

package/scripts/validate-job-docs.mjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+
+const repoRoot = process.cwd();
+const docsRoot = path.join(repoRoot, 'docs');
+
+const guideFiles = [
+  'jobs/migrate-from-dotenv.md',
+  'jobs/connect-agent.md',
+  'jobs/secure-ci.md',
+  'jobs/recover-from-lockout.md',
+];
+
+const requiredSections = [
+  '## Preflight',
+  '## Runbook',
+  '## Success check',
+  '## Failure signatures + fixes',
+  '## Final verification (`aura doctor`)',
+];
+
+const allowedAurawalletCommands = new Set([
+  'init',
+  'start',
+  'stop',
+  'status',
+  'unlock',
+  'restore',
+  'mcp',
+  'vault',
+  'env',
+  'doctor',
+  'shell-hook',
+]);
+
+const failures = [];
+
+function read(file) {
+  return fs.readFileSync(path.join(docsRoot, file), 'utf8');
+}
+
+function extractBashBlocks(markdown) {
+  const blocks = [];
+  const regex = /```bash\n([\s\S]*?)```/g;
+  let match;
+  while ((match = regex.exec(markdown))) {
+    blocks.push(match[1].trim());
+  }
+  return blocks;
+}
+
+function checkGuide(file) {
+  const markdown = read(file);
+
+  for (const header of requiredSections) {
+    if (!markdown.includes(header)) {
+      failures.push(`${file}: missing required section "${header}"`);
+    }
+  }
+
+  if (!markdown.includes('npx aurawallet doctor')) {
+    failures.push(`${file}: missing final doctor command`);
+  }
+
+  const blocks = extractBashBlocks(markdown);
+  if (blocks.length === 0) {
+    failures.push(`${file}: missing bash command snippets`);
+    return;
+  }
+
+  for (const block of blocks) {
+    const lines = block
+      .split('\n')
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .filter((line) => !line.startsWith('#'));
+
+    for (const line of lines) {
+      if (line.startsWith('npx aurawallet ') || line === 'npx aurawallet') {
+        const [, , cmd = ''] = line.split(/\s+/);
+        if (cmd && !allowedAurawalletCommands.has(cmd)) {
+          failures.push(`${file}: unsupported command in snippet -> "${line}"`);
+        }
+      }
+    }
+  }
+}
+
+function checkIndex() {
+  const indexPath = path.join(docsRoot, 'JOBS.md');
+  if (!fs.existsSync(indexPath)) {
+    failures.push('docs/JOBS.md is missing');
+    return;
+  }
+
+  const markdown = fs.readFileSync(indexPath, 'utf8');
+  for (const file of guideFiles) {
+    const rel = `./${file}`;
+    if (!markdown.includes(rel)) {
+      failures.push(`docs/JOBS.md: missing link to ${rel}`);
+    }
+  }
+}
+
+for (const file of guideFiles) {
+  const absolute = path.join(docsRoot, file);
+  if (!fs.existsSync(absolute)) {
+    failures.push(`missing required job guide: docs/${file}`);
+    continue;
+  }
+  checkGuide(file);
+}
+
+checkIndex();
+
+if (failures.length > 0) {
+  console.error('Job docs validation failed:\n');
+  for (const failure of failures) {
+    console.error(`- ${failure}`);
+  }
+  process.exit(1);
+}
+
+console.log(`Job docs validation passed (${guideFiles.length} guides checked).`);