@robbiesrobotics/alice-agents 1.5.10 → 1.5.13

package/templates/workspaces/quinn/TOOLS.md

@@ -1,50 +1,32 @@
 # TOOLS.md - Quinn's Local Notes
 
-## Domain: QA Engineering & Test Automation
-
-## Primary Use Cases
-- Design and execute functional, regression, integration, and e2e test suites
-- Author and maintain automated test scripts and coverage reports
-- Triage defects, validate fixes, enforce quality gates
-- Review test infrastructure and CI integration
-
-## Tools You'll Use Most
-
-| Tool | When to use |
-|------|-------------|
-| `exec` | **Run the tests** — not just read them. Actual execution is your primary tool. |
-| `read` | Audit test files, coverage reports, CI config for test steps |
-| `web_search` | Testing framework docs, assertion library references, known flakiness patterns |
-
-## Exec Patterns
-
-**Run test suites:**
-```bash
-npm test
-npm run test:coverage
-pytest --tb=short
-go test ./...
-```
-
-**Check coverage reports:**
-```bash
-# After running coverage — inspect the output
-open coverage/index.html  # or cat coverage-summary.json
-```
-
-**Find skipped / pending tests (hidden tech debt):**
-```bash
-grep -r "\.skip\|xit\|xdescribe\|@pytest.mark.skip\|t.Skip" --include="*.{js,ts,py,go}"
-```
-
-## Quality Gate Checklist
-
-Before signing off on a fix:
-- [ ] Does a test exist that would have caught this bug?
-- [ ] Does the regression test cover the edge case, not just the happy path?
-- [ ] Does CI pass with the new test included?
-- [ ] Are there any skipped tests that should be unskipped?
-
----
-
-Add environment-specific notes here as you learn them.
+## Domain: QA, Testing, and Review
+
+## Primary A.L.I.C.E. | Code Tools
+
+- `claw.test` - test execution, regression coverage, and QA verification.
+- `claw.review` - structured review passes and release confidence checks.
+- `claw.inspect` - failure triage and coverage-gap investigation.
+- `claw.fix` - small QA-owned harness or test-data fixes only.
+- `claw.session.create` / `claw.session.resume` - longer bounded QA sessions.
+
+## A.L.I.C.E. | Computer
+
+Use Computer for browser QA evidence:
+
+- `agent-browser open <url>` - open the preview, deployed page, or repro URL.
+- `agent-browser snapshot` - capture an accessibility tree with refs.
+- `agent-browser screenshot [path]` - capture visual evidence.
+- `agent-browser console` / `agent-browser errors` - gather browser failure signals.
+- `agent-browser batch ...` - run reproducible multi-step checks.
+- `agent-browser stream status` - verify live inspection support when available.
+
+Use Playwright as the fallback for repeatable E2E assertions, viewport matrices, or when agent-browser is unavailable.
+
+## Fallback
+
+If A.L.I.C.E. | Code is unavailable, use the `coding-agent` skill for non-trivial test automation and local tools for focused commands, browser checks, and log inspection.
+
+## Reporting Expectations
+
+Return the exact checks run, whether each passed, failed, or was not run, and the remaining risk. Athena relies on your status for review handoff decisions.

package/templates/workspaces/sasha/AGENTS.md

@@ -0,0 +1,68 @@
+# AGENTS.md - Sasha's Operating Instructions
+
+## Session Startup
+
+1. Read `SOUL.md` to re-anchor your frontend role.
+2. Read `PLAYBOOK.md`, recent `LEARNINGS.md`, and relevant files under `memory/`.
+3. Inspect existing UI conventions, design system usage, responsive patterns, and repo workflow instructions.
+4. Confirm the target viewport behavior and preview path before editing when visual work is involved.
+
+## Your Role
+
+You are **Sasha**, the frontend implementation specialist for the A.L.I.C.E. team. Athena may assign you UI, app shell, component, styling, interaction, accessibility, responsive implementation, and Canvas preview-readiness slices.
+
+## A.L.I.C.E. | Code Execution
+
+When A.L.I.C.E. | Code is available, use it as your coding execution layer. The current implementation may expose this through internal `claw.*` tools:
+
+- `claw.fix` for bounded frontend implementation and UI bug fixes.
+- `claw.inspect` for repo/design-system investigation.
+- `claw.review` for frontend diff review.
+- `claw.test` for browser, unit, or accessibility verification tasks.
+- `claw.session.create` / `claw.session.resume` for longer UI implementation sessions.
+
+If Code/Claw tools are not listed, use the installed `coding-agent` skill for non-trivial implementation and local tools for quick reads, checks, screenshots, and small patches.
+
+## A.L.I.C.E. | Computer
+
+Use A.L.I.C.E. | Computer for browser-side evidence on UI work: inspect the preview, capture screenshots, read accessibility snapshots, check console/errors, verify responsive behavior, and reproduce interaction bugs. Prefer `agent-browser` for sessioned browser work (`open`, `snapshot`, `screenshot`, `console`, `errors`, `batch`, `stream status`) and use Playwright as the fallback for scripted assertions or when agent-browser is unavailable.
+
+Computer does not edit code, own Canvas, or track durable task state. Return Computer findings as evidence for Athena, Morgan, Control comments, or Canvas updates.
+
+## Ownership
+
+Own frontend components, CSS, responsive behavior, stateful UI, accessibility, and preview readiness. Coordinate with Nadia for design direction, Dylan for API/data contracts, Morgan for QA, Priya for preview/build issues, Clara or Sloane for copy and launch language, and Daphne for component docs.
+
+## Acceptance Criteria
+
+Every frontend result should return:
+
+1. Summary of the visual or behavioral change.
+2. Changed files.
+3. Tests, builds, browser checks, or screenshots run.
+4. Preview metadata when available, especially URL previews for Canvas.
+5. Remaining responsive, accessibility, or copy follow-ups.
+
+For A.L.I.C.E. | Code handoff, classify the result as:
+
+- `completed` only when the UI works in the target desktop and mobile shape and the preview is usable.
+- `needs_review` when visual judgement, accessibility, copy, or product approval is still required.
+- `blocked` when a missing asset, API contract, credential, or build/preview issue prevents verification.
+- `failed` when the assigned UI change cannot be made coherent or safe in the current scope.
+
+Frontend done means the Canvas preview metadata is returned when available, the changed surface fits its container, and any unverified viewport or accessibility risk is explicit.
+
+## Red Lines
+
+- Do not invent a new visual system when the repo has existing conventions.
+- Do not ship layout changes without mobile and desktop consideration.
+- Do not mark visual work complete if the preview is broken or unverified.
+
+## Working in a Project (Symphony fan-out)
+
+When Athena (or another orchestrator) delegates work to you with a `projectId` in dispatch metadata, you'll see two extra tools:
+
+- **`project_workspace`** — read/write the shared project dir at `~/.alice/projects/<projectId>/`. Operations: `list_slices`, `read_slice`, `read_slice_file`, `write_file`, `create_slice`, `set_status`. Use this to drop your output files (code, docs, tests) into your slice's `files/` dir, and to update slice status (`active → review → done`, or `blocked`).
+- **`clone_self`** (only if your `subagents.cloneSelf.max > 0`) — spawn a parallel copy of yourself on an independent sub-task. Use this when your slice splits into independent pieces (e.g. "test 5 routes" → 5 parallel clones). Clones are isolated; their output is NOT auto-merged. The parent must read each clone's reply explicitly.
+
+When you finish a slice, write outputs into `files/`, set status to `review` or `done`, and report briefly. Athena reads the workspace to synthesize.

package/templates/workspaces/sasha/TOOLS.md

@@ -0,0 +1,32 @@
+# TOOLS.md - Sasha's Local Notes
+
+## Domain: Frontend Engineering
+
+## Primary A.L.I.C.E. | Code Tools
+
+- `claw.fix` - frontend implementation and UI bug fixes.
+- `claw.inspect` - component, style, and routing investigation.
+- `claw.review` - visual implementation review.
+- `claw.test` - browser, accessibility, unit, and regression checks.
+- `claw.session.create` / `claw.session.resume` - longer bounded UI sessions.
+
+## A.L.I.C.E. | Computer
+
+Use Computer for preview inspection and UI evidence:
+
+- `agent-browser open <url>` - open a preview or deployed page.
+- `agent-browser snapshot` - capture accessibility-tree refs for reliable interaction.
+- `agent-browser screenshot [path]` - capture visual evidence for Athena, Morgan, or Canvas.
+- `agent-browser console` / `agent-browser errors` - check runtime browser failures.
+- `agent-browser batch ...` - run multi-step preview checks with less process overhead.
+- `agent-browser stream status` - confirm whether live browser streaming is available.
+
+Use Playwright as the fallback when agent-browser is unavailable or when a scripted assertion is the better fit.
+
+## Fallback
+
+If A.L.I.C.E. | Code is unavailable, use the `coding-agent` skill for non-trivial frontend changes. Use local tools for reading files, running dev/build/test commands, and focused patch edits.
+
+## Preview Expectations
+
+When a result includes a local dev server, deployed URL, static HTML, or screenshot, return preview metadata so Athena can update Canvas. Always mention what viewport or browser checks were actually run.

package/bin/alice-cloud.cjs

@@ -1,385 +0,0 @@
-#!/usr/bin/env node
-/**
- * alice-cloud - Zero-touch client onboarding CLI for A.L.I.C.E. | Control
- * Usage: alice-cloud <command>
- *   --non-interactive  Skip interactive prompts (use env vars)
- *   ALICE_SUPABASE_TOKEN  Supabase access token (non-interactive mode)
- */
-
-const path = require('path');
-const os = require('os');
-const fs = require('fs');
-const { spawn } = require('child_process');
-
-const CONFIG_DIR = path.join(os.homedir(), '.openclaw');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'alice-cloud.json');
-const API_BASE = 'https://alice.av3.ai/api/cloud';
-
-const NON_INTERACTIVE = process.argv.includes('--non-interactive') || process.env.ALICE_NON_INTERACTIVE === '1';
-const SUPABASE_TOKEN = process.env.ALICE_SUPABASE_TOKEN;
-
-function loadConfig() {
-  try {
-    if (fs.existsSync(CONFIG_FILE)) {
-      return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
-    }
-  } catch (_) {}
-  return {};
-}
-
-function saveConfig(config) {
-  fs.mkdirSync(CONFIG_DIR, { recursive: true });
-  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-}
-
-async function sleep(ms) {
-  return new Promise((r) => setTimeout(r, ms));
-}
-
-function runCommand(cmd, args) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, { shell: true });
-    let stdout = '', stderr = '';
-    child.stdout.on('data', (d) => { stdout += d; });
-    child.stderr.on('data', (d) => { stderr += d; });
-    child.on('close', (code) => {
-      if (code === 0) resolve(stdout);
-      else reject(new Error(stderr || `exit ${code}`));
-    });
-    child.on('error', reject);
-  });
-}
-
-/** Fetch JSON helper — replaces `got` with native fetch (Node 18+) */
-async function fetchJson(url, options = {}) {
-  const { method = 'GET', json, headers = {}, timeoutMs = 15000 } = options;
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const fetchOpts = {
-      method,
-      headers: { ...headers },
-      signal: controller.signal,
-    };
-    if (json !== undefined) {
-      fetchOpts.headers['Content-Type'] = 'application/json';
-      fetchOpts.body = JSON.stringify(json);
-    }
-    const res = await fetch(url, fetchOpts);
-    const text = await res.text();
-    let data;
-    try { data = JSON.parse(text); } catch (_) { data = text; }
-    return { ok: res.ok, status: res.status, data };
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-// ── Login ──────────────────────────────────────────────────────────────────────
-async function login(args) {
-  const open = (await import('open')).default;
-
-  // Non-interactive mode: use token from env
-  if (NON_INTERACTIVE) {
-    const token = SUPABASE_TOKEN;
-    if (!token) {
-      console.error('❌  ALICE_SUPABASE_TOKEN env var required for non-interactive login.');
-      process.exit(1);
-    }
-    try {
-      const supabaseUrl = process.env.ALICE_SUPABASE_URL || 'https://xxxgvtwnlbtdgmlgccee.supabase.co';
-      const { ok, data } = await fetchJson(`${supabaseUrl}/auth/v1/user`, {
-        headers: { Authorization: `Bearer ${token}`, apikey: token },
-      });
-      const config = loadConfig();
-      config.supabaseToken = token;
-      config.user = data;
-      saveConfig(config);
-      console.log('✅  Logged in as', data.email || data.user_metadata?.user_name || 'unknown');
-      return;
-    } catch (err) {
-      console.error('❌  Token validation failed:', err.message);
-      process.exit(1);
-    }
-  }
-
-  console.log('🔐  A.L.I.C.E. Cloud login');
-  console.log('   Opening browser for login…');
-
-  const loginUrl = `${API_BASE.replace('/api/cloud', '')}/login?cli=1`;
-  try { await open(loginUrl); } catch (_) {
-    console.log(`   Could not open browser. Visit: ${loginUrl}`);
-  }
-  console.log('   After login, copy the access token and paste it here:');
-  process.stdout.write('   > ');
-
-  return new Promise((resolve, reject) => {
-    let token = '';
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', (d) => { token += d; });
-    process.stdin.on('end', async () => {
-      token = token.trim();
-      if (!token) { reject(new Error('No token provided')); return; }
-      try {
-        const supabaseUrl = process.env.ALICE_SUPABASE_URL || 'https://xxxgvtwnlbtdgmlgccee.supabase.co';
-        const { ok, data } = await fetchJson(`${supabaseUrl}/auth/v1/user`, {
-          headers: { Authorization: `Bearer ${token}`, apikey: token },
-        });
-        const config = loadConfig();
-        config.supabaseToken = token;
-        config.user = data;
-        saveConfig(config);
-        console.log('   ✅ Logged in as', data.email || data.user_metadata?.user_name || 'unknown');
-        resolve();
-      } catch (err) {
-        reject(new Error('Token validation failed: ' + err.message));
-      }
-    });
-  });
-}
-
-// ── Register ───────────────────────────────────────────────────────────────────
-async function detectGatewayUrl() {
-  const candidates = ['https://localhost:18789', 'http://localhost:18789'];
-  for (const url of candidates) {
-    try {
-      const { ok } = await fetchJson(url, { timeoutMs: 2000 });
-      return url;
-    } catch (_) {}
-  }
-  return 'https://localhost:18789';
-}
-
-async function readGatewayToken() {
-  const cfg = path.join(os.homedir(), '.openclaw', 'openclaw.json');
-  try {
-    const data = JSON.parse(fs.readFileSync(cfg, 'utf8'));
-    return data.gateway?.auth?.token || '';
-  } catch (_) {}
-  return '';
-}
-
-async function getOpenClawVersion() {
-  try { return (await runCommand('openclaw', ['--version'])).trim(); } catch (_) {}
-  return 'unknown';
-}
-
-async function register(args) {
-  const config = loadConfig();
-
-  if (!config.supabaseToken) {
-    console.error('❌  Not logged in. Run `alice-cloud login` first.');
-    process.exit(1);
-  }
-
-  const gatewayUrl = await detectGatewayUrl();
-  const gatewayToken = await readGatewayToken();
-  const hostname = os.hostname();
-  const version = await getOpenClawVersion();
-
-  console.log('🔗  Registering gateway with A.L.I.C.E. Cloud…');
-  console.log(`   Gateway URL : ${gatewayUrl}`);
-  console.log(`   Hostname    : ${hostname}`);
-  console.log(`   Version     : ${version}`);
-
-  let lastError;
-  for (let attempt = 1; attempt <= 3; attempt++) {
-    try {
-      const { ok, status, data } = await fetchJson(`${API_BASE}/register`, {
-        method: 'POST',
-        json: { gatewayUrl, gatewayToken, hostname, version },
-        headers: { Authorization: `Bearer ${config.supabaseToken}` },
-      });
-      if (!ok) throw new Error(`HTTP ${status}: ${typeof data === 'string' ? data : JSON.stringify(data)}`);
-      config.registration = { gatewayUrl, hostname, version, registeredAt: new Date().toISOString() };
-      saveConfig(config);
-      console.log('   ✅ Gateway registered!');
-      return;
-    } catch (err) {
-      lastError = err;
-      const delay = attempt * 2000;
-      console.log(`   ⚠️  Attempt ${attempt} failed: ${err.message}. Retrying in ${delay}ms…`);
-      await sleep(delay);
-    }
-  }
-  console.error('❌  Registration failed after 3 attempts:', lastError.message);
-  process.exit(1);
-}
-
-// ── Status ─────────────────────────────────────────────────────────────────────
-async function status(args) {
-  const config = loadConfig();
-
-  if (!config.supabaseToken) {
-    console.error('❌  Not logged in. Run `alice-cloud login` first.');
-    process.exit(1);
-  }
-
-  try {
-    const { ok, status: httpStatus, data } = await fetchJson(`${API_BASE}/status`, {
-      headers: { Authorization: `Bearer ${config.supabaseToken}` },
-    });
-
-    if (httpStatus === 401) {
-      console.error('❌  Session expired. Run `alice-cloud login` again.');
-      process.exit(1);
-    }
-
-    if (!ok || !data.registered) {
-      console.log('⚪  No gateway registered.');
-      console.log('   Run `alice-cloud register` to connect your gateway.');
-      return;
-    }
-
-    console.log('🟢  A.L.I.C.E. Cloud Status');
-    console.log(`   Gateway URL   : ${data.gatewayUrl}`);
-    console.log(`   Hostname      : ${data.hostname}`);
-    console.log(`   Status        : ${data.connected ? '🟢 Connected' : '🔴 Disconnected'}`);
-    console.log(`   Last heartbeat: ${data.lastHeartbeat ? new Date(data.lastHeartbeat).toLocaleString() : 'Never'}`);
-    console.log(`   Version      : ${data.version}`);
-  } catch (err) {
-    console.error('❌  Status check failed:', err.message);
-    process.exit(1);
-  }
-}
-
-// ── Unregister ─────────────────────────────────────────────────────────────────
-async function unregister(args) {
-  const config = loadConfig();
-
-  if (!config.supabaseToken) {
-    console.error('❌  Not logged in. Run `alice-cloud login` first.');
-    process.exit(1);
-  }
-
-  console.log('🗑️  Unregistering gateway…');
-  try {
-    const { ok, status } = await fetchJson(`${API_BASE}/status`, {
-      method: 'DELETE',
-      headers: { Authorization: `Bearer ${config.supabaseToken}` },
-    });
-    if (status === 404) {
-      console.log('   ℹ️  No gateway was registered.');
-    } else {
-      delete config.registration;
-      saveConfig(config);
-      console.log('   ✅ Gateway unregistered.');
-    }
-  } catch (err) {
-    console.error('❌  Unregister failed:', err.message);
-    process.exit(1);
-  }
-}
-
-// ── Watch (daemon) ─────────────────────────────────────────────────────────────
-async function checkGatewayUp(gatewayUrl) {
-  try {
-    const { ok } = await fetchJson(gatewayUrl, { timeoutMs: 3000 });
-    return true;
-  } catch (_) {}
-  return false;
-}
-
-async function startHeartbeatLoop(config) {
-  const gatewayUrl = config.registration?.gatewayUrl || 'https://localhost:18789';
-
-  async function heartbeat() {
-    try {
-      const isUp = await checkGatewayUp(gatewayUrl);
-      if (!isUp) {
-        console.log('[watch] Gateway down, attempting restart…');
-        try { await runCommand('openclaw', ['gateway', 'start']); await sleep(3000); } catch (_) {}
-      }
-      await fetchJson(`${API_BASE}/heartbeat`, {
-        method: 'POST',
-        json: { hostname: os.hostname(), connected: await checkGatewayUp(gatewayUrl), timestamp: new Date().toISOString() },
-        headers: { Authorization: `Bearer ${config.supabaseToken}` },
-        timeoutMs: 10000,
-      });
-      console.log(`[${new Date().toLocaleTimeString()}] heartbeat sent (gateway: ${isUp ? 'up' : 'down'})`);
-    } catch (err) {
-      console.error('[watch] heartbeat error:', err.message);
-    }
-  }
-
-  await heartbeat();
-  const interval = setInterval(heartbeat, 30_000);
-  process.on('SIGINT', () => { clearInterval(interval); process.exit(0); });
-  process.on('SIGTERM', () => { clearInterval(interval); process.exit(0); });
-}
-
-async function watch(args) {
-  const config = loadConfig();
-  if (!config.supabaseToken) {
-    console.error('❌  Not logged in. Run `alice-cloud login` first.');
-    process.exit(1);
-  }
-
-  if (args.daemon || process.argv.includes('--daemon')) {
-    const child = spawn(process.execPath, [__filename, 'watch', '--running'], {
-      detached: true, stdio: 'ignore', env: { ...process.env, ALICE_NON_INTERACTIVE: '1' },
-    });
-    child.unref();
-    console.log('🚀  alice-cloud watch started in background (PID:', child.pid, ')');
-    return;
-  }
-
-  console.log('👁️  A.L.I.C.E. Cloud watch daemon started');
-  console.log('   Press Ctrl+C to stop.');
-  await startHeartbeatLoop(config);
-}
-
-// ── Programmatic API exports ───────────────────────────────────────────────────
-module.exports = {
-  login,
-  register,
-  status,
-  unregister,
-  watch,
-  loadConfig,
-  saveConfig,
-  detectGatewayUrl,
-  readGatewayToken,
-  API_BASE,
-  CONFIG_FILE,
-};
-
-// ── CLI dispatcher ─────────────────────────────────────────────────────────────
-if (require.main === module) {
-  const commands = { login, register, status, unregister, watch };
-  const cmd = process.argv[2];
-
-  if (!cmd) {
-    console.log(`alice-cloud v1.1.0 — A.L.I.C.E. | Control Cloud CLI
-
-Usage: alice-cloud <command> [options]
-
-Commands:
-  login        Authenticate with Supabase
-  register     Register this gateway with A.L.I.C.E. Cloud
-  status       Show gateway connection status
-  unregister   Remove gateway registration
-  watch        Start background heartbeat daemon
-
-Options:
-  --non-interactive  Use env vars (ALICE_SUPABASE_TOKEN) instead of prompts
-
-Environment:
-  ALICE_SUPABASE_TOKEN   Supabase access token (for non-interactive mode)
-  ALICE_SUPABASE_URL     Supabase project URL (default: xxx project)
-
-Run 'alice-cloud <command> --help' for more options.`);
-    process.exit(0);
-  }
-
-  const handler = commands[cmd];
-  if (!handler) {
-    console.error(`Unknown command: ${cmd}`);
-    process.exit(1);
-  }
-
-  handler(process.argv.slice(3)).catch((err) => {
-    console.error('Error:', err.message);
-    process.exit(1);
-  });
-}