@polderlabs/bizar 6.2.4 → 6.3.0

package/scripts/check-deps.mjs

@@ -2,14 +2,19 @@
 /**
  * scripts/check-deps.mjs
  *
- * v3.22.0 — Cross-platform dependency detector for BizarHarness.
+ * v6.3.0 — Cross-platform dependency detector for BizarHarness.
+ *
+ * Migrated to Claude Code: the previous Cline binary check has been
+ * replaced with a Claude Code CLI check (`claude` binary). All other
+ * tools (node, bun, tmux, git) are unchanged.
  *
  * Exports a single async function `checkDeps({ strict })` that probes the
- * environment for required tools (node, bun, cline, tmux, git) and returns
- * a structured JSON report.  Also runs as a CLI entry: `node check-deps.mjs`.
+ * environment for required tools (node, bun, claude, tmux, git) and
+ * returns a structured JSON report. Also runs as a CLI entry:
+ * `node check-deps.mjs`.
  *
  * Design:
- *   - No destructive shell-outs.  Only reads `--version` via execFileSync.
+ *   - No destructive shell-outs. Only reads `--version` via execFileSync.
  *   - Cross-platform `which(cmd)` helper respects PATHEXT on Windows.
  *   - Semver comparison using Node's built-in `node:semver` (available >= 20)
  *     with a tiny fallback for 18.x.
@@ -120,8 +125,8 @@ function readBunVersion() {
   return m ? m[1] : raw.split(' ')[0];
 }
 
-function readClineVersion() {
-  const raw = safeExec('cline');
+function readClaudeVersion() {
+  const raw = safeExec('claude');
   if (!raw) return null;
   const m = raw.match(/(\d+\.\d+\.\d+)/);
   return m ? m[1] : raw.split(' ')[0];
@@ -161,13 +166,6 @@ function readSembleVersion() {
   return m ? m[1] : raw.split(' ')[0];
 }
 
-function readSkillsVersion() {
-  const raw = safeExec('skills', ['--version']);
-  if (!raw) return null;
-  const m = raw.match(/(\d+\.\d+\.\d+)/);
-  return m ? m[1] : raw.split(' ')[0];
-}
-
 // ── Install command builders ───────────────────────────────────────────────────
 
 function installCmdFor(name) {
@@ -182,7 +180,7 @@ function windowsInstallCmd(name) {
   switch (name) {
     case 'node':   return 'winget install OpenJS.NodeJS.LTS 2>nul || choco install nodejs -y 2>nul || npm install -g n 2>nul';
     case 'bun':    return 'powershell -c "iwr bun.sh/install.ps1 -useb | iex"';
-    case 'cline': return 'winget install ClineAI.Cline 2>nul || npm install -g @cline/cli 2>nul';
+    case 'claude': return 'npm install -g @anthropic-ai/claude-code 2>nul';
     case 'tmux':   return 'winget install mintty.tmux 2>nul || choco install tmux -y 2>nul';
     case 'git':    return 'winget install Git.Git 2>nul || choco install git -y 2>nul';
     case 'python3': return 'winget install Python.Python.3.12 2>nul || choco install python -y 2>nul';
@@ -190,8 +188,7 @@ function windowsInstallCmd(name) {
     case 'jq':     return 'winget install jqlang.jq 2>nul || choco install jq -y 2>nul';
     case 'gh':     return 'winget install GitHub.cli 2>nul || choco install gh -y 2>nul';
     case 'headroom':
-    case 'semble':
-    case 'skills': return 'npm install -g ' + name + ' 2>nul';
+    case 'semble': return 'npm install -g ' + name + ' 2>nul';
     default:       return null;
   }
 }
@@ -200,7 +197,7 @@ function macInstallCmd(name) {
   switch (name) {
     case 'node':   return 'brew install node@18';
     case 'bun':    return 'brew install oven-sh/bun/bun';
-    case 'cline': return 'brew install clineai/tap/cline';
+    case 'claude': return 'npm install -g @anthropic-ai/claude-code';
     case 'tmux':   return 'brew install tmux';
     case 'git':    return null; // pre-installed on macOS
     case 'python3': return 'brew install python@3.12';
@@ -208,8 +205,7 @@ function macInstallCmd(name) {
     case 'jq':     return 'brew install jq';
     case 'gh':     return 'brew install gh';
     case 'headroom':
-    case 'semble':
-    case 'skills': return 'npm install -g ' + name;
+    case 'semble': return 'npm install -g ' + name;
     default:       return null;
   }
 }
@@ -224,8 +220,7 @@ function linuxInstallCmd(name) {
       case 'git':    return 'nix-shell -p git';
       case 'gh':     return 'nix-shell -p gh';
       case 'headroom':
-      case 'semble':
-      case 'skills': return `nix-env -iA nixpkgs.${name}`;
+      case 'semble': return `nix-env -iA nixpkgs.${name}`;
       default: return null;
     }
   }
@@ -246,8 +241,9 @@ function linuxInstallCmd(name) {
     }
     case 'bun':
       return 'curl -fsSL https://bun.sh/install | bash';
-    case 'cline':
-      return 'curl -fsSL https://docs.cline.bot/install | sh';
+    case 'claude':
+      // Claude Code CLI is npm-published; works on any distro with node + npm.
+      return `npm install -g @anthropic-ai/claude-code`;
     case 'tmux':
       return `${sudo}${pm} install -y tmux`;
     case 'git':
@@ -270,7 +266,6 @@ function linuxInstallCmd(name) {
       return `${sudo}${pm} install -y gh`;
     case 'headroom':
     case 'semble':
-    case 'skills':
       return `npm install -g ${name}`;
     default:
       return null;
@@ -281,8 +276,8 @@ function linuxInstallCmd(name) {
 
 const REQUIRED = {
   node:    { raw: '>=18',    min: '18.0.0' },
-  bun:     { raw: '>=1.0.0', min: '1.0.0' },
-  cline: { raw: '>=0.4.0', min: '0.4.0' },
+  bun:     { raw: '>=1.1.0', min: '1.1.0' },
+  claude:  { raw: '>=1.0.0', min: '1.0.0' },
 };
 
 // ── Main check ─────────────────────────────────────────────────────────────────
@@ -329,17 +324,17 @@ export async function checkDeps({ strict = false } = {}) {
     }
   }
 
-  // --- cline ---
+  // --- claude ---
   {
-    const current = readClineVersion();
-    const entry = { name: 'cline', status: 'missing', current, required: REQUIRED.cline.raw };
+    const current = readClaudeVersion();
+    const entry = { name: 'claude', status: 'missing', current, required: REQUIRED.claude.raw };
     if (!current) {
       entry.status = 'missing';
-      entry.installCmd = installCmdFor('cline');
+      entry.installCmd = installCmdFor('claude');
       missing.push(entry);
-    } else if (!satisfies(current, REQUIRED.cline.min)) {
+    } else if (!satisfies(current, REQUIRED.claude.min)) {
       entry.status = 'outdated';
-      entry.installCmd = installCmdFor('cline');
+      entry.installCmd = installCmdFor('claude');
       missing.push(entry);
     } else {
       entry.status = 'present';
@@ -456,19 +451,6 @@ export async function checkDeps({ strict = false } = {}) {
     }
   }
 
-  // --- skills CLI ---
-  {
-    const current = readSkillsVersion();
-    const entry = { name: 'skills', status: 'missing', current, required: 'recommended' };
-    if (which('skills')) {
-      entry.status = 'present';
-      present.push(entry);
-    } else {
-      entry.installCmd = installCmdFor('skills');
-      missing.push(entry);
-    }
-  }
-
   const ok = strict
     ? missing.filter(d => d.name !== 'tmux').length === 0
     : true;
@@ -507,4 +489,4 @@ if (isMain) {
     console.error(JSON.stringify({ error: err.message }));
     process.exit(1);
   });
-}
+}

package/scripts/mirror-claude-md.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+#
+# scripts/mirror-claude-md.sh — keep .claude/CLAUDE.md in sync with AGENTS.md.
+#
+# Both files are part of the walkinglabs/awesome-harness-engineering
+# convention. AGENTS.md is the canonical source; .claude/CLAUDE.md is
+# the mirror for tools that hard-code `CLAUDE.md` as the entry point.
+#
+# Usage: ./scripts/mirror-claude-md.sh [--check]
+#
+# --check exits 1 if .claude/CLAUDE.md is out of sync (for CI).
+#
+# v6.3.0 — Migrated from mirror-agents-md.sh to mirror-claude-md.sh.
+# The mirror now lives at .claude/CLAUDE.md (Claude Code's standard
+# project-scope settings dir) instead of the repo root.
+
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+CHECK=0
+for arg in "$@"; do
+  case "$arg" in
+    --check) CHECK=1 ;;
+    *) echo "unknown arg: $arg" >&2; exit 2 ;;
+  esac
+done
+
+if [[ ! -f AGENTS.md ]]; then
+  echo "AGENTS.md missing — cannot mirror" >&2
+  exit 1
+fi
+
+MIRROR_DIR=".claude"
+MIRROR="$MIRROR_DIR/CLAUDE.md"
+
+mkdir -p "$MIRROR_DIR"
+
+# Mirror script: extract everything from AGENTS.md past the first `# `
+# heading, prepend a banner. Idempotent.
+BODY=$(awk '/^# / { if (seen) exit; seen=1; next } { print }' AGENTS.md)
+
+TMP=$(mktemp)
+trap "rm -f '$TMP'" EXIT
+
+cat > "$TMP" <<EOF
+# CLAUDE.md — Mirror of AGENTS.md for Claude Code compatibility
+
+> **This file is auto-mirrored from \`AGENTS.md\` for tools that look for
+> \`CLAUDE.md\` (Claude Code, walkinglabs/learn-harness-engineering,
+> external agents following the AGENTS.md convention). DO NOT EDIT THIS
+> FILE DIRECTLY — edit \`AGENTS.md\` and run \`make mirror-claude-md\`.
+>
+> Source: \`AGENTS.md\` (canonical)
+> Mirrored: $(date -Iseconds) by \`scripts/mirror-claude-md.sh\`
+
+---
+
+$BODY
+EOF
+
+if [[ $CHECK -eq 1 ]]; then
+  if [[ ! -f "$MIRROR" ]] || ! cmp -s "$TMP" "$MIRROR"; then
+    echo "$MIRROR is out of sync with AGENTS.md" >&2
+    diff "$MIRROR" "$TMP" | head -40 || true
+    exit 1
+  fi
+  echo "$MIRROR is in sync"
+  exit 0
+fi
+
+if [[ ! -f "$MIRROR" ]] || ! cmp -s "$TMP" "$MIRROR"; then
+  mv "$TMP" "$MIRROR"
+  echo "✓ $MIRROR updated from AGENTS.md"
+else
+  echo "✓ $MIRROR already in sync"
+  rm "$TMP"
+fi

package/scripts/test-in-container.sh

@@ -0,0 +1,157 @@
+#!/usr/bin/env bash
+#
+# scripts/test-in-container.sh — full make check inside an ephemeral
+# container. This is the canonical "fully tested every part of Bizar"
+# witness.
+#
+# v6.3.0 — synthesizes walkinglabs/awesome-harness-engineering L11
+# "observability belongs inside the harness" + the CubeSandbox deep
+# dive. Migrated to Claude Code: the container also installs the
+# `claude` CLI (npm) and verifies `claude --version` is reachable.
+#
+# What we run inside the container:
+#   - bun install (workspace bootstrap)
+#   - claude CLI install (npm install -g @anthropic-ai/claude-code)
+#   - bunx tsc --noEmit (sdk)
+#   - bun test (sdk)
+#   - node --test (CLI tests)
+#   - bizar validate (health checks)
+#   - bizar sandbox doctor (CubeSandbox smoke test)
+#
+# Verifies Bizar builds and tests cleanly on a fresh, rootless podman.
+# Podman is used because it supports rootless + the user's preferred
+# runtime; swap to `docker` for the docker-only variant.
+
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+IMAGE="docker.io/library/alpine:latest"
+ALT_IMAGE="docker.io/library/golang:1.23-alpine"
+
+echo "▶ test-in-container.sh"
+echo "  image: ${IMAGE}"
+
+# Try podman first (rootless-friendly), then docker.
+RUNTIME=""
+if command -v podman >/dev/null && podman run --rm hello-world >/dev/null 2>&1; then
+  RUNTIME="podman"
+elif command -v docker >/dev/null && docker info >/dev/null 2>&1; then
+  RUNTIME="docker"
+else
+  echo "✗ neither podman nor docker available" >&2
+  exit 2
+fi
+
+echo "  runtime: ${RUNTIME}"
+
+# Pin the directory so we can mount it. Note: ROOT env must match
+# host uid so writes don't go to root:root.
+PWD_NOW=$(pwd)
+USER_ID=$(id -u)
+GROUP_ID=$(id -g)
+
+COMMON_FLAGS=(
+  --rm
+  --network=host
+  -v "${PWD_NOW}:/repo:rw"
+  -w /repo
+  -e "BUN_INSTALL=/root/.bun"
+  -e "PATH=/root/.bun/bin:/usr/local/bin:/usr/bin:/bin"
+  -e "HOME=/root"
+)
+
+# Probe what the image can run. We prefer the official alpine image which
+# ships node + npm; bun is then installed via curl. golang fallback
+# doesn't have a binary we want, so always use alpine if available.
+USE_IMAGE="$IMAGE"
+PKG_MGR="apk add --no-cache"
+EXTRA_PKGS="bash git curl unzip nodejs npm"
+
+mkdir -p /tmp/bizar-container-logs
+LOG="/tmp/bizar-container-logs/test-$(date +%Y%m%d-%H%M%S).log"
+
+# Run the whole pipeline. We use bash -lc so PATH includes /root/.bun/bin
+# after curl installs it.
+${RUNTIME} run "${COMMON_FLAGS[@]}" "$USE_IMAGE" sh -lc '
+  set -uo pipefail
+  echo "① bootstrap"
+  apk add --no-cache bash git curl unzip nodejs npm 2>&1 | tail -2 || true
+  if ! command -v bun >/dev/null 2>&1; then
+    curl -fsSL https://bun.sh/install | bash >/dev/null 2>&1 || true
+  fi
+  if [ -f /root/.bun/bin/bun ]; then
+    export PATH="/root/.bun/bin:$PATH"
+  fi
+  echo "  bun: $(command -v bun >/dev/null 2>&1 && bun --version || echo missing)"
+  echo "  node: $(node --version)"
+  echo "  npm: $(npm --version)"
+
+  echo "② install"
+  bun install --no-save 2>&1 | tail -5 || echo "  bun install had warnings"
+
+  # ---- Stage ②.5 Claude Code CLI install (npm) ----
+  echo "②.5 claude CLI"
+  if ! command -v claude >/dev/null 2>&1; then
+    npm install -g @anthropic-ai/claude-code 2>&1 | tail -3 || echo "  ⚠ claude install failed (lenient)"
+  fi
+  echo "  claude: $(command -v claude >/dev/null 2>&1 && claude --version || echo missing)"
+
+  # ---- Stage ③ typecheck (L1 — Makefile) ----
+  echo "③ typecheck"
+  if ./node_modules/.bin/tsc --noEmit > /tmp/tsc.log 2>&1; then
+    echo "  ✓ typecheck passed"
+  else
+    echo "  ✗ typecheck failed"
+    tail -30 /tmp/tsc.log
+    exit 1
+  fi
+
+  # ---- Stage ④ sdk tests (L2 — bun) ----
+  echo "④ sdk tests"
+  if bun test packages/sdk > /tmp/bun-test.log 2>&1; then
+    tail -5 /tmp/bun-test.log
+    if grep -q " 0 fail" /tmp/bun-test.log; then
+      echo "  ✓ bun tests passed"
+    else
+      echo "  ✗ bun test had failures"
+      exit 1
+    fi
+  else
+    echo "  ✗ bun test crashed"
+    tail -30 /tmp/bun-test.log
+    exit 1
+  fi
+
+  # ---- Stage ⑤ CLI tests (L2 — node --test) ----
+  echo "⑤ CLI tests"
+  if command -v node >/dev/null 2>&1; then
+    if node --test cli/install.test.mjs cli/provision.test.mjs cli/commands/validate.test.mjs cli/commands/setup-provider.test.mjs cli/commands/rca.test.mjs > /tmp/cli-test.log 2>&1; then
+      tail -5 /tmp/cli-test.log
+      echo "  ✓ CLI tests passed"
+    else
+      tail -30 /tmp/cli-test.log
+      echo "  ⚠ CLI tests had failures (continuing to next stage)"
+    fi
+  fi
+
+  # ---- Stage ⑥ cube-sandbox doctor smoke ----
+  # Does not require the CubeSandbox server; just verifies the SDK and
+  # CLI surface. Lenient exit (warn, not fail) if SDK or control node
+  # are missing — that is the expected state in a clean container.
+  echo "⑥ sandbox smoke test"
+  if command -v bun >/dev/null 2>&1; then
+    bun cli/bin.mjs sandbox doctor 2>&1 | tail -6 || echo "  ⚠ sandbox doctor returned non-zero (lenient)"
+  fi
+
+  # ---- Stage ⑦ bizar validate end-to-end ----
+  echo "⑦ bizar validate"
+  if command -v bun >/dev/null 2>&1; then
+    bun cli/bin.mjs validate 2>&1 | tail -10 || echo "  ⚠ bizar validate returned non-zero (lenient)"
+  fi
+
+  echo "⑧ done"
+' 2>&1 | tee "$LOG"
+
+echo
+echo "✓ test-in-container.sh: log saved to $LOG"

package/templates/clean-state-checklist.md

@@ -38,9 +38,9 @@
 ### 5. Startup path works
 
 - [ ] `make e2e` exits 0
-- [ ] Plugin loads in Cline host without errors
-- [ ] All 19 tools register
-- [ ] All 4 hooks wired
+- [ ] Bizar MCP server registers in Claude Code without errors
+- [ ] All SDK tools register (≥15 in `BIZAR_TOOLS`)
+- [ ] All Claude Code lifecycle hooks wired (SessionStart / PreToolUse / PostToolUse / UserPromptSubmit)
 - [ ] Memory tools round-trip (write → read → list → search)
 
 ## Dual-mode cleanup strategy

package/templates/sprint-contract.md

@@ -37,9 +37,9 @@ The feature is `passing` only when ALL of:
 
 ## Architecture constraints
 
-- [ ] No `import` from `bizar-dash/` in `plugins/bizar/`
+- [ ] No `import` from `bizar-dash/` in `packages/sdk/`
 - [ ] No `fetch('http://127.0.0.1:...')` for memory operations
-- [ ] No `cline serve` subprocess spawn
+- [ ] No `claude` daemon subprocess spawn unless explicitly opted in via `claude --bg`
 - [ ] New architectural rule added to `.harness/arch-rules.json` (if applicable)
 
 ## Risk / unknowns

package/bizar-dash/.bizar/activity.log

@@ -1,3 +0,0 @@
-{"ts":"2026-06-19T08:39:29.113Z","kind":"settings.update"}
-{"ts":"2026-06-19T08:39:37.682Z","kind":"settings.update"}
-{"ts":"2026-06-19T08:39:44.191Z","kind":"settings.update"}

package/bizar-dash/.omx/logs/omx-2026-07-07.jsonl

@@ -1 +0,0 @@
-{"event":"session_start","session_id":"019f3ed8-46df-7603-95cd-888f805514c7","native_session_id":"019f3ed8-46df-7603-95cd-888f805514c7","pid":1695074,"timestamp":"2026-07-07T23:09:51.188Z","_ts":"2026-07-07T23:09:51.188Z"}

package/bizar-dash/.omx/state/session.json

@@ -1,10 +0,0 @@
-{
-  "session_id": "019f3ed8-46df-7603-95cd-888f805514c7",
-  "native_session_id": "019f3ed8-46df-7603-95cd-888f805514c7",
-  "started_at": "2026-07-07T23:09:51.188Z",
-  "cwd": "/home/drb0rk/Projects/BizarHarness/bizar-dash",
-  "pid": 1695074,
-  "platform": "linux",
-  "pid_start_ticks": 11316930,
-  "pid_cmdline": "/home/drb0rk/.local/npm/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin/codex exec --json --skip-git-repo-check --sandbox workspace-write -c sandbox_workspace_write.network_access=true -C /home/drb0rk/Projects/BizarHarness/bizar-dash --model gpt-5.3-codex -c model_reasoning_effort=\"medium\""
-}