@superclawd-ai/fda 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,87 @@
 {
   "name": "@superclawd-ai/fda",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "private": false,
+  "description": "SuperClawd FDA \u2014 a forward deployed agent for your team: a Slack-driven AI developer that runs on its own machine with your SuperClawd workspace.",
+  "author": "SuperClawd <support@superclawd.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://superclawd.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/superclawd-ai/superclawd"
+  },
+  "keywords": [
+    "superclawd",
+    "fda",
+    "claude-code",
+    "slack",
+    "ai-agent",
+    "autonomous"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
+  "type": "module",
+  "main": "dist-server/index.mjs",
+  "bin": {
+    "superclawd-fda": "dist-server/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "dist-server",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "concurrently -k -n api,web -c blue,green \"pnpm dev:api\" \"pnpm dev:web\"",
+    "dev:api": "FDA_HOME=.fda-dev tsx watch server/index.ts",
+    "dev:web": "vite",
+    "build": "node build.mjs",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.app.json",
+    "test": "tsx test/run-all.ts",
+    "lint": "eslint 'server/**/*.ts' 'src/**/*.{ts,tsx}'",
+    "format": "prettier --check 'server/**/*.ts' 'test/**/*.ts' 'src/**/*.{ts,tsx}'",
+    "format:fix": "prettier --write 'server/**/*.ts' 'test/**/*.ts' 'src/**/*.{ts,tsx}'"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "@slack/socket-mode": "^3.1.0",
+    "@slack/web-api": "^8.2.0",
+    "express": "^4.21.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@tanstack/react-query": "^5.90.11",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.44.1",
+    "@typescript-eslint/parser": "^8.44.1",
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.22",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "concurrently": "^9.1.0",
+    "esbuild": "^0.24.0",
+    "eslint": "^9.36.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "eslint-plugin-react-refresh": "^0.4.16",
+    "lucide-react": "^0.555.0",
+    "postcss": "^8.5.6",
+    "prettier": "^3.6.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^7.9.6",
+    "tailwind-merge": "^3.4.0",
+    "tailwindcss": "3",
+    "tailwindcss-animate": "^1.0.7",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.2",
+    "vite": "^6.0.5"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# SuperClawd FDA machine installer (Ubuntu 24.04+). Run as the operator user, NOT root:
+#   curl -fsSLO https://superclawd.com/fda/install.sh && bash install.sh [--with-browser]
+# It uses sudo only for system packages and the systemd unit. Safe to re-run (idempotent).
+set -euo pipefail
+
+main() {
+  # Pinned versions (bumped together with the setup guide's dependency table).
+  local NODE_MAJOR=22
+  local SUPERCLAWD_VERSION="${SUPERCLAWD_VERSION:-latest}"
+  local FDA_VERSION="${FDA_VERSION:-latest}"
+  local PLAYWRIGHT_MCP_VERSION="0.0.83"
+  local WITH_BROWSER=0
+  local FROM_DIR=""
+
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --with-browser) WITH_BROWSER=1 ;;
+      --from-dir) FROM_DIR="$2"; shift ;; # dev: install packed tarballs (superclawd-*.tgz, superclawd-ai-fda-*.tgz)
+      -h|--help) echo "Usage: bash install.sh [--with-browser] [--from-dir <dir-with-tgz>]"; return 0 ;;
+      *) echo "Unknown option: $1" >&2; return 64 ;;
+    esac
+    shift
+  done
+
+  if [ "$(id -u)" -eq 0 ]; then
+    echo "✗ Run this as your regular user (not root). It uses sudo only where needed." >&2
+    return 1
+  fi
+  . /etc/os-release 2>/dev/null || true
+  if [ "${ID:-}" != "ubuntu" ]; then
+    echo "! This installer is tested on Ubuntu 24.04+; continuing on ${PRETTY_NAME:-an unknown system}." >&2
+  fi
+
+  echo "→ System packages"
+  sudo apt-get update -qq
+  sudo apt-get install -y -qq git curl ca-certificates jq gnupg bubblewrap >/dev/null
+
+  if ! command -v node >/dev/null || [ "$(node -p 'process.versions.node.split(".")[0]')" -lt "$NODE_MAJOR" ] \
+     || ! node -e 'const [a,b]=process.versions.node.split(".").map(Number); process.exit(a>22||(a===22&&b>=13)?0:1)'; then
+    echo "→ Node.js $NODE_MAJOR (NodeSource)"
+    curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | sudo -E bash - >/dev/null
+    sudo apt-get install -y -qq nodejs >/dev/null
+  fi
+
+  if ! command -v gh >/dev/null; then
+    echo "→ GitHub CLI"
+    sudo mkdir -p -m 755 /etc/apt/keyrings
+    curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg >/dev/null
+    sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg
+    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \
+      | sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null
+    sudo apt-get update -qq && sudo apt-get install -y -qq gh >/dev/null
+  fi
+
+  echo "→ SuperClawd CLI + FDA"
+  if [ -n "$FROM_DIR" ]; then
+    sudo npm i -g --no-fund --no-audit "$FROM_DIR"/superclawd-[0-9]*.tgz "$FROM_DIR"/superclawd-ai-fda-*.tgz >/dev/null
+  else
+    sudo npm i -g --no-fund --no-audit "superclawd@${SUPERCLAWD_VERSION}" "@superclawd-ai/fda@${FDA_VERSION}" >/dev/null
+  fi
+
+  if ! command -v claude >/dev/null && [ ! -x "$HOME/.local/bin/claude" ]; then
+    echo "→ Claude Code"
+    curl -fsSL https://claude.ai/install.sh | bash >/dev/null
+  fi
+
+  mkdir -p -m 700 "$HOME/.superclawd/fda"
+  local envfile="$HOME/.superclawd/fda/env"
+  if [ ! -f "$envfile" ]; then
+    printf 'DISABLE_AUTOUPDATER=1\n' > "$envfile"
+    chmod 600 "$envfile"
+  fi
+
+  if [ "$WITH_BROWSER" = 1 ]; then
+    echo "→ Browser (Playwright MCP $PLAYWRIGHT_MCP_VERSION + Chromium)"
+    local bdir="$HOME/.superclawd/fda/browser"
+    mkdir -p "$bdir"
+    (cd "$bdir" && npm init -y >/dev/null && npm i --no-fund --no-audit "@playwright/mcp@${PLAYWRIGHT_MCP_VERSION}" >/dev/null)
+    local pwv
+    pwv="$(node -p "require('$bdir/node_modules/playwright/package.json').version")"
+    sudo npx -y "playwright@${pwv}" install-deps chromium >/dev/null
+    npx -y "playwright@${pwv}" install chromium >/dev/null
+  fi
+
+  echo "→ Service"
+  local node cli tmpl
+  node="$(command -v node)"
+  cli="$(npm root -g)/@superclawd-ai/fda/dist-server/cli.mjs"
+  tmpl="$(npm root -g)/@superclawd-ai/fda/scripts/superclawd-fda.service.tmpl"
+  [ -f "$cli" ] || { echo "✗ FDA package not found at $cli" >&2; return 1; }
+  sed -e "s|__USER__|$(id -un)|g" -e "s|__HOME__|$HOME|g" -e "s|__NODE__|$node|g" -e "s|__CLI__|$cli|g" "$tmpl" \
+    | sudo tee /etc/systemd/system/superclawd-fda.service >/dev/null
+  sudo systemctl daemon-reload
+  sudo systemctl enable superclawd-fda >/dev/null
+
+  cat <<NEXT
+
+✓ Installed. Next steps (see the setup guide):
+  1. superclawd login
+  2. superclawd fda setup --workspace <your-workspace-slug>
+  3. printf '%s' "\$ANTHROPIC_API_KEY" | superclawd fda config set-key
+  4. superclawd fda start && superclawd fda doctor
+  5. Open the admin panel (tailscale serve --bg --https=443 http://127.0.0.1:63220), sign in with
+     the password from: superclawd fda credentials
+NEXT
+}
+
+main "$@"

package/scripts/superclawd-fda.service.tmpl

@@ -0,0 +1,28 @@
+# SuperClawd FDA daemon. Installed by install.sh; placeholders are filled in at install time.
+[Unit]
+Description=SuperClawd FDA (Slack-driven AI engineer)
+Wants=network-online.target
+After=network-online.target tailscaled.service
+StartLimitIntervalSec=300
+StartLimitBurst=5
+
+[Service]
+Type=simple
+User=__USER__
+WorkingDirectory=__HOME__
+Environment=HOME=__HOME__
+Environment=PATH=__HOME__/.local/bin:/usr/local/bin:/usr/bin:/bin
+Environment=NODE_ENV=production
+EnvironmentFile=-__HOME__/.superclawd/fda/env
+ExecStart=__NODE__ __CLI__ run
+Restart=on-failure
+RestartSec=5
+# 78 = configuration problem a human must fix (don't restart-loop on it).
+RestartPreventExitStatus=78
+# SIGTERM to the daemon (it stops the running turn gracefully), then SIGKILL for the rest of the cgroup.
+KillMode=mixed
+TimeoutStopSec=45
+NoNewPrivileges=true
+
+[Install]
+WantedBy=multi-user.target