Skip to content

Tayhlow8/Caixa-D-gua-website-2026 / .agents/skills/gstack

gstack

Flagged

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

FileKindSize
AGENTS.mdmarkdown2.5 KB
ARCHITECTURE.mdmarkdown29.3 KB
BROWSER.mdmarkdown29.2 KB
CHANGELOG.mdmarkdown389.3 KB
CLAUDE.mdmarkdown40.4 KB
CONTRIBUTING.mdmarkdown21.4 KB
DESIGN.mdmarkdown4.4 KB
ETHOS.mdmarkdown7.3 KB
LICENSEother1.0 KB
README.mdmarkdown37.3 KB
SKILL.mdskill md40.7 KB
SKILL.md.tmplother10.9 KB
TODOS.mdmarkdown79.0 KB
USING_GBRAIN_WITH_GSTACK.mdmarkdown19.0 KB
VERSIONother9 B
actionlint.yamlconfig56 B
agents/openai.yamlconfig351 B
bin/chrome-cdpother2.2 KB
bin/dev-setupother2.4 KB
bin/dev-teardownother1.6 KB
bin/gstack-analyticsother6.3 KB
bin/gstack-brain-consumerother5.5 KB
bin/gstack-brain-enqueueother1.9 KB
bin/gstack-brain-initother13.8 KB
bin/gstack-brain-readerother21 B
bin/gstack-brain-restoreother7.5 KB
bin/gstack-brain-syncother14.6 KB
bin/gstack-brain-uninstallother5.2 KB
bin/gstack-builder-profileother616 B
bin/gstack-codex-probeother4.5 KB
bin/gstack-community-dashboardother4.5 KB
bin/gstack-configother10.4 KB
bin/gstack-developer-profileother15.9 KB
bin/gstack-diff-scopeother3.1 KB
bin/gstack-extensionother2.0 KB
bin/gstack-gbrain-detectother3.6 KB
bin/gstack-gbrain-installother6.6 KB
bin/gstack-gbrain-lib.shscript3.4 KB
bin/gstack-gbrain-repo-policyother7.0 KB
bin/gstack-gbrain-supabase-provisionother15.2 KB
bin/gstack-gbrain-supabase-verifyother4.0 KB
bin/gstack-global-discover.tsscript18.8 KB
bin/gstack-jsonl-mergeother2.7 KB
bin/gstack-learnings-logother3.3 KB
bin/gstack-learnings-searchother4.8 KB
bin/gstack-model-benchmarkother5.8 KB
bin/gstack-next-versionother16.3 KB
bin/gstack-open-urlother338 B
bin/gstack-patch-namesother1.2 KB
bin/gstack-platform-detectother1.0 KB
bin/gstack-question-logother6.4 KB
bin/gstack-question-preferenceother9.4 KB
bin/gstack-relinkother3.0 KB
bin/gstack-repo-modeother3.5 KB
bin/gstack-review-logother866 B
bin/gstack-review-readother528 B
bin/gstack-security-dashboardother4.9 KB
bin/gstack-session-updateother3.5 KB
bin/gstack-settings-hookother2.8 KB
bin/gstack-slugother1.9 KB
bin/gstack-specialist-statsother2.2 KB
bin/gstack-taste-updateother10.5 KB
bin/gstack-team-initother6.7 KB
bin/gstack-telemetry-logother10.0 KB
bin/gstack-telemetry-syncother5.3 KB
bin/gstack-timeline-logother1.6 KB
bin/gstack-timeline-readother2.6 KB
bin/gstack-uninstallother10.3 KB
bin/gstack-update-checkother7.7 KB
bun.lockother57.4 KB
claude/SKILL.md.tmplother8.7 KB
conductor.jsonconfig87 B
connect-chromeother19 B
contrib/add-host/SKILL.md.tmplother1.7 KB
design/prototype.tsscript5.4 KB
design/src/auth.tsscript1.7 KB
design/src/brief.tsscript1.9 KB
design/src/check.tsscript3.3 KB
design/src/cli.tsscript8.9 KB
design/src/commands.tsscript3.0 KB
design/src/compare.tsscript19.1 KB
design/src/design-to-code.tsscript3.0 KB
design/src/diff.tsscript3.3 KB
design/src/evolve.tsscript5.3 KB
design/src/gallery.tsscript7.0 KB
design/src/generate.tsscript4.4 KB
design/src/iterate.tsscript6.5 KB
design/src/memory.tsscript6.0 KB
design/src/serve.tsscript8.3 KB
design/src/session.tsscript1.8 KB
design/src/variants.tsscript8.7 KB
design/test/feedback-roundtrip.test.tsscript12.6 KB
design/test/gallery.test.tsscript5.0 KB
design/test/serve.test.tsscript16.0 KB
docs/ADDING_A_HOST.mdmarkdown6.1 KB
docs/ON_THE_LOC_CONTROVERSY.mdmarkdown13.2 KB
docs/OPENCLAW.mdmarkdown6.5 KB
docs/REMOTE_BROWSER_ACCESS.mdmarkdown9.6 KB
docs/designs/BUN_NATIVE_INFERENCE.mdmarkdown6.7 KB
docs/designs/CHROME_VS_CHROMIUM_EXPLORATION.mdmarkdown4.0 KB
docs/designs/CONDUCTOR_CHROME_SIDEBAR_INTEGRATION.mdmarkdown3.5 KB
docs/designs/CONDUCTOR_SESSION_API.mdmarkdown3.9 KB
docs/designs/DESIGN_SHOTGUN.mdmarkdown22.5 KB
docs/designs/DESIGN_TOOLS_V1.mdmarkdown36.0 KB
docs/designs/GCOMPACTION.mdmarkdown57.6 KB
docs/designs/GSTACK_BROWSER_V0.mdmarkdown17.3 KB
docs/designs/ML_PROMPT_INJECTION_KILLER.mdmarkdown20.7 KB
docs/designs/PACING_UPDATES_V0.mdmarkdown9.7 KB
docs/designs/PLAN_TUNING_V0.mdmarkdown31.2 KB
docs/designs/PLAN_TUNING_V1.mdmarkdown19.0 KB
docs/designs/SELF_LEARNING_V0.mdmarkdown15.4 KB
docs/designs/SESSION_INTELLIGENCE.mdmarkdown6.8 KB
docs/designs/SIDEBAR_MESSAGE_FLOW.mdmarkdown10.1 KB
docs/designs/SLATE_HOST.mdmarkdown12.6 KB
docs/designs/SLOP_SCAN_FOR_REVIEW_SHIP.mdmarkdown3.0 KB
docs/evals/security-bench-ensemble-v2.jsonconfig1.6 KB
docs/gbrain-sync-errors.mdmarkdown6.2 KB
docs/gbrain-sync.mdmarkdown6.5 KB
docs/images/github-2013.pngbinary61.9 KB
docs/images/github-2026.pngbinary59.1 KB
docs/skills.mdmarkdown59.5 KB
extension/background.jsscript20.6 KB
extension/content.cssother2.5 KB
extension/content.jsscript11.9 KB
extension/icons/icon-128.pngbinary2.8 KB
extension/icons/icon-16.pngbinary400 B
extension/icons/icon-48.pngbinary1.1 KB
extension/inspector.cssother798 B
extension/inspector.jsscript15.7 KB
extension/lib/xterm-addon-fit.jsscript1.5 KB
extension/lib/xterm.cssother5.3 KB
extension/lib/xterm.jsscript276.8 KB
extension/manifest.jsonconfig783 B
extension/popup.htmlother2.3 KB
extension/popup.jsscript1.7 KB
extension/sidepanel-terminal.jsscript15.2 KB
extension/sidepanel.cssother39.6 KB
extension/sidepanel.htmlother9.1 KB
extension/sidepanel.jsscript40.2 KB
hosts/claude.tsscript1.1 KB
hosts/codex.tsscript2.2 KB
hosts/cursor.tsscript1.1 KB
hosts/factory.tsscript1.8 KB
hosts/gbrain.tsscript2.2 KB
hosts/hermes.tsscript2.1 KB
hosts/index.tsscript2.2 KB
hosts/kiro.tsscript1.2 KB
hosts/openclaw.tsscript2.0 KB
hosts/opencode.tsscript1.3 KB
hosts/slate.tsscript1.1 KB
lib/worktree.tsscript9.6 KB
model-overlays/claude.mdmarkdown613 B
model-overlays/gemini.mdmarkdown551 B
model-overlays/gpt-5.4.mdmarkdown683 B
model-overlays/gpt.mdmarkdown1.9 KB
model-overlays/o-series.mdmarkdown660 B
model-overlays/opus-4-7.mdmarkdown1.5 KB
openclaw/agents-gstack-section.mdmarkdown2.5 KB
openclaw/gstack-full-CLAUDE.mdmarkdown538 B
openclaw/gstack-lite-CLAUDE.mdmarkdown688 B
openclaw/gstack-plan-CLAUDE.mdmarkdown1.0 KB
package.jsonmanifest4.7 KB
scripts/analytics.tsscript5.3 KB
scripts/app/gstack-browserother2.4 KB
scripts/app/icon.icnsother1.0 MB
scripts/archetypes.tsscript5.4 KB
scripts/build-app.shscript7.5 KB
scripts/compare-pr-version.tsscript3.0 KB
scripts/detect-bump.tsscript1.2 KB
scripts/dev-skill.tsscript2.4 KB
scripts/discover-skills.tsscript1.2 KB
scripts/eval-compare.tsscript3.0 KB
scripts/eval-list.tsscript3.5 KB
scripts/eval-select.tsscript3.1 KB
scripts/eval-summary.tsscript6.5 KB
scripts/eval-watch.tsscript5.4 KB
scripts/garry-output-comparison.tsscript17.0 KB
scripts/gen-skill-docs.tsscript28.3 KB
scripts/host-adapters/openclaw-adapter.tsscript1.7 KB
scripts/host-config-export.tsscript3.4 KB
scripts/host-config.tsscript7.3 KB
scripts/jargon-list.jsonconfig1.8 KB
scripts/models.tsscript2.5 KB
scripts/one-way-doors.tsscript5.6 KB
scripts/preflight-agent-sdk.tsscript4.4 KB
scripts/psychographic-signals.tsscript10.3 KB
scripts/question-registry.tsscript23.5 KB
scripts/resolvers/browse.tsscript6.2 KB
scripts/resolvers/codex-helpers.tsscript5.0 KB
scripts/resolvers/composition.tsscript1.8 KB
scripts/resolvers/confidence.tsscript1.6 KB
scripts/resolvers/constants.tsscript3.1 KB
scripts/resolvers/design.tsscript56.9 KB
scripts/resolvers/dx.tsscript5.4 KB
scripts/resolvers/gbrain.tsscript5.3 KB
scripts/resolvers/index.tsscript4.3 KB
scripts/resolvers/learnings.tsscript3.9 KB
scripts/resolvers/make-pdf.tsscript2.2 KB
scripts/resolvers/model-overlay.tsscript2.2 KB
scripts/resolvers/preamble.tsscript5.7 KB

design/test/serve.test.ts

View on GitHub
/**
 * Tests for the $D serve command — HTTP server for comparison board feedback.
 *
 * Tests the stateful server lifecycle:
 * - SERVING → POST submit → DONE (exit 0)
 * - SERVING → POST regenerate → REGENERATING → POST reload → SERVING
 * - Timeout → exit 1
 * - Error handling (missing HTML, malformed JSON, missing reload path)
 */

import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
import { generateCompareHtml } from '../src/compare';
import * as fs from 'fs';
import * as path from 'path';

let tmpDir: string;
let boardHtml: string;

// Create a minimal 1x1 pixel PNG for test variants
function createTestPng(filePath: string): void {
  const png = Buffer.from(
    'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/58BAwAI/AL+hc2rNAAAAABJRU5ErkJggg==',
    'base64'
  );
  fs.writeFileSync(filePath, png);
}

beforeAll(() => {
  tmpDir = '/tmp/serve-test-' + Date.now();
  fs.mkdirSync(tmpDir, { recursive: true });

  // Create test PNGs and generate comparison board
  createTestPng(path.join(tmpDir, 'variant-A.png'));
  createTestPng(path.join(tmpDir, 'variant-B.png'));
  createTestPng(path.join(tmpDir, 'variant-C.png'));

  const html = generateCompareHtml([
    path.join(tmpDir, 'variant-A.png'),
    path.join(tmpDir, 'variant-B.png'),
    path.join(tmpDir, 'variant-C.png'),
  ]);
  boardHtml = path.join(tmpDir, 'design-board.html');
  fs.writeFileSync(boardHtml, html);
});

afterAll(() => {
  fs.rmSync(tmpDir, { recursive: true, force: true });
});

// ─── Serve as HTTP module (not subprocess) ────────────────────────

describe('Serve HTTP endpoints', () => {
  let server: ReturnType<typeof Bun.serve>;
  let baseUrl: string;
  let htmlContent: string;
  let state: string;

  beforeAll(() => {
    htmlContent = fs.readFileSync(boardHtml, 'utf-8');
    state = 'serving';

    server = Bun.serve({
      port: 0,
      fetch(req) {
        const url = new URL(req.url);

        if (req.method === 'GET' && url.pathname === '/') {
          const injected = htmlContent.replace(
            '</head>',
            `<script>window.__GSTACK_SERVER_URL = '${url.origin}';</script>\n</head>`
          );
          return new Response(injected, {
            headers: { 'Content-Type': 'text/html; charset=utf-8' },
          });
        }

        if (req.method === 'GET' && url.pathname === '/api/progress') {
          return Response.json({ status: state });
        }

        if (req.method === 'POST' && url.pathname === '/api/feedback') {
          return (async () => {
            let body: any;
            try { body = await req.json(); } catch { return Response.json({ error: 'Invalid JSON' }, { status: 400 }); }
            if (typeof body !== 'object' || body === null) return Response.json({ error: 'Expected JSON object' }, { status: 400 });
            const isSubmit = body.regenerated === false;
            const feedbackFile = isSubmit ? 'feedback.json' : 'feedback-pending.json';
            fs.writeFileSync(path.join(tmpDir, feedbackFile), JSON.stringify(body, null, 2));
            if (isSubmit) {
              state = 'done';
              return Response.json({ received: true, action: 'submitted' });
            }
            state = 'regenerating';
            return Response.json({ received: true, action: 'regenerate' });
          })();
        }

        if (req.method === 'POST' && url.pathname === '/api/reload') {
          return (async () => {
            let body: any;
            try { body = await req.json(); } catch { return Response.json({ error: 'Invalid JSON' }, { status: 400 }); }
            if (!body.html || !fs.existsSync(body.html)) {
              return Response.json({ error: `HTML file not found: ${body.html}` }, { status: 400 });
            }
            htmlContent = fs.readFileSync(body.html, 'utf-8');
            state = 'serving';
            return Response.json({ reloaded: true });
          })();
        }

        return new Response('Not found', { status: 404 });
      },
    });
    baseUrl = `http://localhost:${server.port}`;
  });

  afterAll(() => {
    server.stop();
  });

  test('GET / serves HTML with injected __GSTACK_SERVER_URL', async () => {
    const res = await fetch(baseUrl);
    expect(res.status).toBe(200);
    const html = await res.text();
    expect(html).toContain('__GSTACK_SERVER_URL');
    expect(html).toContain(baseUrl);
    expect(html).toContain('Design Exploration');
  });

  test('GET /api/progress returns current state', async () => {
    state = 'serving';
    const res = await fetch(`${baseUrl}/api/progress`);
    const data = await res.json();
    expect(data.status).toBe('serving');
  });

  test('POST /api/feedback with submit sets state to done', async () => {
    state = 'serving';
    const feedback = {
      preferred: 'A',
      ratings: { A: 4, B: 3, C: 2 },
      comments: { A: 'Good spacing' },
      overall: 'Go with A',
      regenerated: false,
    };

    const res = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(feedback),
    });
    const data = await res.json();
    expect(data.received).toBe(true);
    expect(data.action).toBe('submitted');
    expect(state).toBe('done');

    // Verify feedback.json was written
    const written = JSON.parse(fs.readFileSync(path.join(tmpDir, 'feedback.json'), 'utf-8'));
    expect(written.preferred).toBe('A');
    expect(written.ratings.A).toBe(4);
  });

  test('POST /api/feedback with regenerate sets state and writes feedback-pending.json', async () => {
    state = 'serving';
    // Clean up any prior pending file
    const pendingPath = path.join(tmpDir, 'feedback-pending.json');
    if (fs.existsSync(pendingPath)) fs.unlinkSync(pendingPath);

    const feedback = {
      preferred: 'B',
      ratings: { A: 3, B: 5, C: 2 },
      comments: {},
      overall: null,
      regenerated: true,
      regenerateAction: 'different',
    };

    const res = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(feedback),
    });
    const data = await res.json();
    expect(data.received).toBe(true);
    expect(data.action).toBe('regenerate');
    expect(state).toBe('regenerating');

    // Progress should reflect regenerating state
    const progress = await fetch(`${baseUrl}/api/progress`);
    const pd = await progress.json();
    expect(pd.status).toBe('regenerating');

    // Agent can poll for feedback-pending.json
    expect(fs.existsSync(pendingPath)).toBe(true);
    const pending = JSON.parse(fs.readFileSync(pendingPath, 'utf-8'));
    expect(pending.regenerated).toBe(true);
    expect(pending.regenerateAction).toBe('different');
  });

  test('POST /api/feedback with remix contains remixSpec', async () => {
    state = 'serving';
    const feedback = {
      preferred: null,
      ratings: { A: 4, B: 3, C: 3 },
      comments: {},
      overall: null,
      regenerated: true,
      regenerateAction: 'remix',
      remixSpec: { layout: 'A', colors: 'B', typography: 'C' },
    };

    const res = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(feedback),
    });
    const data = await res.json();
    expect(data.received).toBe(true);
    expect(state).toBe('regenerating');
  });

  test('POST /api/feedback with malformed JSON returns 400', async () => {
    const res = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: 'not json',
    });
    expect(res.status).toBe(400);
  });

  test('POST /api/feedback with non-object returns 400', async () => {
    const res = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: '"just a string"',
    });
    expect(res.status).toBe(400);
  });

  test('POST /api/reload swaps HTML and resets state to serving', async () => {
    state = 'regenerating';

    // Create a new board HTML
    const newBoard = path.join(tmpDir, 'new-board.html');
    fs.writeFileSync(newBoard, '<html><body>New board content</body></html>');

    const res = await fetch(`${baseUrl}/api/reload`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ html: newBoard }),
    });
    const data = await res.json();
    expect(data.reloaded).toBe(true);
    expect(state).toBe('serving');

    // Verify the new HTML is served
    const pageRes = await fetch(baseUrl);
    const pageHtml = await pageRes.text();
    expect(pageHtml).toContain('New board content');
  });

  test('POST /api/reload with missing file returns 400', async () => {
    const res = await fetch(`${baseUrl}/api/reload`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ html: '/nonexistent/file.html' }),
    });
    expect(res.status).toBe(400);
  });

  test('GET /unknown returns 404', async () => {
    const res = await fetch(`${baseUrl}/random-path`);
    expect(res.status).toBe(404);
  });
});

// ─── Path traversal protection in /api/reload ─────────────────────

describe('Serve /api/reload — path traversal protection', () => {
  let server: ReturnType<typeof Bun.serve>;
  let baseUrl: string;
  let htmlContent: string;
  let allowedDir: string;

  beforeAll(() => {
    // Production-equivalent allowedDir anchored to tmpDir
    allowedDir = fs.realpathSync(tmpDir);
    htmlContent = fs.readFileSync(boardHtml, 'utf-8');

    // This server mirrors the production serve() with the path validation fix
    server = Bun.serve({
      port: 0,
      fetch(req) {
        const url = new URL(req.url);

        if (req.method === 'GET' && url.pathname === '/') {
          return new Response(htmlContent, {
            headers: { 'Content-Type': 'text/html; charset=utf-8' },
          });
        }

        if (req.method === 'POST' && url.pathname === '/api/reload') {
          return (async () => {
            let body: any;
            try { body = await req.json(); } catch { return Response.json({ error: 'Invalid JSON' }, { status: 400 }); }
            if (!body.html || !fs.existsSync(body.html)) {
              return Response.json({ error: `HTML file not found: ${body.html}` }, { status: 400 });
            }
            // Production path validation — same as design/src/serve.ts
            const resolvedReload = fs.realpathSync(path.resolve(body.html));
            if (!resolvedReload.startsWith(allowedDir + path.sep) && resolvedReload !== allowedDir) {
              return Response.json({ error: `Path must be within: ${allowedDir}` }, { status: 403 });
            }
            htmlContent = fs.readFileSync(resolvedReload, 'utf-8');
            return Response.json({ reloaded: true });
          })();
        }

        return new Response('Not found', { status: 404 });
      },
    });
    baseUrl = `http://localhost:${server.port}`;
  });

  afterAll(() => {
    server.stop();
  });

  test('blocks reload with path outside allowed directory', async () => {
    const res = await fetch(`${baseUrl}/api/reload`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ html: '/etc/passwd' }),
    });
    expect(res.status).toBe(403);
    const data = await res.json();
    expect(data.error).toContain('Path must be within');
  });

  test('blocks reload with symlink pointing outside allowed directory', async () => {
    const linkPath = path.join(tmpDir, 'evil-link.html');
    try {
      fs.symlinkSync('/etc/passwd', linkPath);
      const res = await fetch(`${baseUrl}/api/reload`, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ html: linkPath }),
      });
      expect(res.status).toBe(403);
    } finally {
      try { fs.unlinkSync(linkPath); } catch {}
    }
  });

  test('allows reload with file inside allowed directory', async () => {
    const goodPath = path.join(tmpDir, 'safe-board.html');
    fs.writeFileSync(goodPath, '<html><body>Safe reload</body></html>');

    const res = await fetch(`${baseUrl}/api/reload`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ html: goodPath }),
    });
    expect(res.status).toBe(200);
    const data = await res.json();
    expect(data.reloaded).toBe(true);

    // Verify the new content is served
    const page = await fetch(baseUrl);
    expect(await page.text()).toContain('Safe reload');
  });
});

// ─── Full lifecycle: regeneration round-trip ──────────────────────

describe('Full regeneration lifecycle', () => {
  let server: ReturnType<typeof Bun.serve>;
  let baseUrl: string;
  let htmlContent: string;
  let state: string;

  beforeAll(() => {
    htmlContent = fs.readFileSync(boardHtml, 'utf-8');
    state = 'serving';

    server = Bun.serve({
      port: 0,
      fetch(req) {
        const url = new URL(req.url);
        if (req.method === 'GET' && url.pathname === '/') {
          return new Response(htmlContent, { headers: { 'Content-Type': 'text/html' } });
        }
        if (req.method === 'GET' && url.pathname === '/api/progress') {
          return Response.json({ status: state });
        }
        if (req.method === 'POST' && url.pathname === '/api/feedback') {
          return (async () => {
            const body = await req.json();
            if (body.regenerated) { state = 'regenerating'; return Response.json({ received: true, action: 'regenerate' }); }
            state = 'done'; return Response.json({ received: true, action: 'submitted' });
          })();
        }
        if (req.method === 'POST' && url.pathname === '/api/reload') {
          return (async () => {
            const body = await req.json();
            if (body.html && fs.existsSync(body.html)) {
              htmlContent = fs.readFileSync(body.html, 'utf-8');
              state = 'serving';
              return Response.json({ reloaded: true });
            }
            return Response.json({ error: 'Not found' }, { status: 400 });
          })();
        }
        return new Response('Not found', { status: 404 });
      },
    });
    baseUrl = `http://localhost:${server.port}`;
  });

  afterAll(() => { server.stop(); });

  test('regenerate → reload → submit round-trip', async () => {
    // Step 1: User clicks regenerate
    expect(state).toBe('serving');
    const regen = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ regenerated: true, regenerateAction: 'different', preferred: null, ratings: {}, comments: {} }),
    });
    expect((await regen.json()).action).toBe('regenerate');
    expect(state).toBe('regenerating');

    // Step 2: Progress shows regenerating
    const prog1 = await (await fetch(`${baseUrl}/api/progress`)).json();
    expect(prog1.status).toBe('regenerating');

    // Step 3: Agent generates new variants and reloads
    const newBoard = path.join(tmpDir, 'round2-board.html');
    fs.writeFileSync(newBoard, '<html><body>Round 2 variants</body></html>');
    const reload = await fetch(`${baseUrl}/api/reload`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ html: newBoard }),
    });
    expect((await reload.json()).reloaded).toBe(true);
    expect(state).toBe('serving');

    // Step 4: Progress shows serving (board would auto-refresh)
    const prog2 = await (await fetch(`${baseUrl}/api/progress`)).json();
    expect(prog2.status).toBe('serving');

    // Step 5: User submits on round 2
    const submit = await fetch(`${baseUrl}/api/feedback`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ regenerated: false, preferred: 'B', ratings: { A: 3, B: 5 }, comments: {}, overall: 'B is great' }),
    });
    expect((await submit.json()).action).toBe('submitted');
    expect(state).toBe('done');
  });
});
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall