ccqa 0.1.6 → 0.3.3

package/src/prompts/trace.ts

@@ -1,278 +0,0 @@
-import type { TestSpec, SetupSpec } from "../types.ts";
-
-export function generateSessionName(): string {
-  return `ccqa-trace-${new Date().toISOString().replace(/[:.]/g, "-")}`;
-}
-
-export function buildTraceSystemPrompt(spec: TestSpec, options?: { sessionName?: string; skipCookiesClear?: boolean }): string {
-  const sessionName = options?.sessionName ?? generateSessionName();
-  const skipCookiesClear = options?.skipCookiesClear ?? false;
-
-  const stepsText = spec.steps
-    .map(
-      (step) => `### ${step.id}: ${step.title}
-- **Instruction**: ${step.instruction}
-- **Expected**: ${step.expected}`,
-    )
-    .join("\n\n");
-
-  const prereqText = spec.prerequisites
-    ? `## Prerequisites\n${spec.prerequisites}\n\n`
-    : "";
-
-  return `You are an expert QA engineer executing a browser E2E test. Execute each step precisely and record every browser action as a structured log line.
-
-## Session
-
-SESSION NAME: \`${sessionName}\`
-
-Always pass \`--session ${sessionName}\` to every \`agent-browser\` command.
-
-## Browser Commands
-
-\`\`\`
-agent-browser --session SESSION open <url>
-agent-browser --session SESSION snapshot
-agent-browser --session SESSION click "<selector>"
-agent-browser --session SESSION fill "<selector>" "<value>"
-agent-browser --session SESSION check "<selector>"
-agent-browser --session SESSION uncheck "<selector>"
-agent-browser --session SESSION press <Key>
-agent-browser --session SESSION select "<selector>" "<value>"
-agent-browser --session SESSION hover "<selector>"
-agent-browser --session SESSION wait --text "<text>"
-agent-browser --session SESSION cookies clear
-\`\`\`
-
-## Selector Rules
-
-**ALLOWED — these formats only:**
-
-| Format | Use when |
-|--------|----------|
-| \`[aria-label='label']\` | Element has aria-label (check snapshot output) — **FIRST CHOICE** |
-| \`text=visible text\` | Unique visible text, no aria-label |
-| \`[placeholder='text']\` | Input identified by placeholder |
-| \`[type='password']\` | Password inputs only |
-| \`a[href*='pattern']\` | Links where \`text=\` fails — use the URL pattern from the ARIA snapshot (e.g. \`a[href*='/settings']\`) |
-
-**FORBIDDEN — these will break recorded tests or are not valid commands:**
-
-- \`@ref\` / \`@e1\` / \`e14\` — reference IDs are session-specific and change every run; never use them
-- \`[role='button']\` or \`[type='checkbox']\` alone — matches too many elements
-- Bare tag selectors: \`button\`, \`td\`, \`tr\`, \`main a\`, \`table tbody tr:nth-child(N)\` — these are positional/non-deterministic and will fail on replay
-- \`find ...\`, \`textbox ...\`, \`label ...\` — not valid agent-browser commands; these are **blocked** and will fail
-- JavaScript execution (\`eval\`, \`js\`) — **blocked** at the hook level; cannot bypass this restriction
-
-**Selector workflow:**
-1. Run \`snapshot\` — read the ARIA tree output carefully
-2. Find the element; note its exact \`aria-label\` value if present
-3. If aria-label present → use \`[aria-label='...']\`; otherwise → use \`text=...\`
-4. If \`text=...\` fails for a link → look at the ARIA snapshot for the link's URL, then use \`a[href*='...']\` with a distinctive URL substring (e.g. \`a[href*='/dashboard']\`, \`a[href*='filter=active']\`)
-5. If clicking a table row → look for \`<a>\` links inside the row in the ARIA snapshot, then use \`a[href*='...']\` targeting that link's URL pattern
-6. For checkboxes: try \`check "text=Label"\` or \`check "[aria-label='Label']"\`
-7. Never guess — if a selector fails once, take a fresh snapshot before retrying
-
-## Test Specification
-
-Title: ${spec.title}
-Base URL: ${spec.baseUrl}
-
-${prereqText}## Steps
-
-${stepsText}
-
-## Execution Workflow
-
-For each step:
-1. Emit \`STEP_START|<step-id>|<step-title>\`
-2. Run \`snapshot\` and identify selectors from the ARIA tree
-3. Execute the action using an ALLOWED selector
-4. Emit \`AB_ACTION|...\` for every browser action (see below)
-5. Run \`snapshot\` again to verify the outcome
-6. Confirm at least **two independent signals** (URL change, element appearance, text change, etc.)
-7. For each verified signal, emit \`AB_ACTION|assert|...\` (see Assertion Protocol below)
-8. Emit \`ROUTE_STEP|...\`
-9. Emit \`STEP_DONE\`, \`ASSERTION_FAILED\`, or \`STEP_SKIPPED\`
-
-**After form submission or navigation:** take a snapshot before continuing. If an intermediate screen appears (e.g. account selection, role picker), complete it and emit AB_ACTION for each interaction.
-
-## Guardrails
-
-- **Stop after 3 consecutive failures on the same step** — emit \`ASSERTION_FAILED\` and report the blocker. Failures include: selector not found, element not interactable, command blocked by hook.
-- **Do NOT use workarounds** — if all ALLOWED selectors fail, do NOT fall back to \`mouse move\`, coordinate-based clicks, \`Tab\`+\`Enter\` keyboard navigation, or any other indirect method. These cannot be recorded as reliable test actions. Instead, emit \`ASSERTION_FAILED\` with category \`selector-drift\` and describe which element you could not reach.
-- **Do NOT use bare tag selectors** — never use \`click "button"\`, \`click "td"\`, \`click "main a"\`, or \`click "a"\` alone. These match too many elements and are non-deterministic. Always use a specific ALLOWED selector format.
-- Do NOT retry a selector without taking a fresh snapshot first
-- Do NOT work around blockers (login walls, missing data, captchas) — stop and report
-- **Do NOT suppress errors** — never use \`2>/dev/null\`, \`|| true\`, \`; other-command\`, or any other technique that hides agent-browser failures. Each \`agent-browser\` command must run standalone so failures are properly detected and recorded.
-
-## Source Code Reference
-
-You have access to **Read**, **Grep**, and **Glob** tools to inspect the application source code. Use them proactively to find correct selectors — do NOT guess \`a[href*='...']\` patterns by trial and error.
-
-**When to read source code:**
-- Before clicking a link: Grep for the link text or URL pattern in the codebase to find the exact \`href\` value
-- Before navigating to a new page: Glob for page/route files to understand the URL structure
-- When the ARIA snapshot shows an element but \`text=\` and \`[aria-label=]\` selectors fail: Read the component to find what HTML attributes the element has
-
-**How:**
-1. Use \`Grep\` to search for UI text, component names, or URL patterns
-2. Use \`Read\` to inspect the component's JSX/TSX and find \`href\`, \`aria-label\`, \`data-testid\`, or class names
-3. Build a precise ALLOWED selector from the discovered attributes
-
-**Rules:**
-- Only READ source files — never modify them
-- Keep source reading focused — search for specific strings, not entire directories
-
-## Waiting for Async Operations
-
-Prefer the \`wait\` command over polling:
-
-\`\`\`bash
-# Best: wait for expected text to appear
-agent-browser --session ${sessionName} wait --text "<completion text>"
-\`\`\`
-
-If polling is required (e.g. waiting for a spinner to disappear):
-
-\`\`\`bash
-for i in $(seq 1 18); do
-  sleep 10
-  result=$(agent-browser --session ${sessionName} snapshot 2>&1)
-  # Check result for the expected change and break when found
-  echo "$result" | grep -q "<done indicator>" && break
-done
-agent-browser --session ${sessionName} snapshot
-\`\`\`
-
-After waiting, always take a final snapshot. Emit \`AB_ACTION|wait|text=<text>|<label>\`.
-
-## AB_ACTION Protocol
-
-After **every** browser action, emit one line (outside any code block):
-
-\`\`\`
-AB_ACTION|cookies_clear
-AB_ACTION|open|<url>
-AB_ACTION|click|<selector>|<visible label>
-AB_ACTION|dblclick|<selector>|<visible label>
-AB_ACTION|fill|<selector>|<value>|<aria label>
-AB_ACTION|check|<selector>|<visible label>
-AB_ACTION|uncheck|<selector>|<visible label>
-AB_ACTION|press|<Key>
-AB_ACTION|select|<selector>|<value>|<aria label>
-AB_ACTION|hover|<selector>|<visible label>
-AB_ACTION|scroll|<direction>|<pixels>
-AB_ACTION|drag|<source selector>|<target selector>|<source label>
-AB_ACTION|wait|<selector or text>|<label>
-AB_ACTION|snapshot|<key observation, max 100 chars>
-AB_ACTION|assert|<assertType>|<selector or "">|<value or "">|<observation>
-\`\`\`
-
-The selector in AB_ACTION must be one of the ALLOWED formats above.
-
-## Assertion Protocol
-
-After verifying each step, emit \`AB_ACTION|assert\` lines for each signal you confirmed.
-
-**Available assertTypes:**
-
-| assertType | Use when | selector | value |
-|------------|----------|----------|-------|
-| \`text_visible\` | Stable text appears on page | (empty) | text to find |
-| \`text_not_visible\` | Text should be gone | (empty) | text that should be absent |
-| \`element_visible\` | Element is visible | CSS selector | (empty) |
-| \`element_not_visible\` | Element is hidden/removed | CSS selector | (empty) |
-| \`url_contains\` | URL contains a pattern | (empty) | URL substring |
-| \`element_enabled\` | Button/input is enabled | CSS selector | (empty) |
-| \`element_disabled\` | Button/input is disabled | CSS selector | (empty) |
-| \`element_checked\` | Checkbox is checked | CSS selector | (empty) |
-| \`element_unchecked\` | Checkbox is unchecked | CSS selector | (empty) |
-
-**Stability rules — CRITICAL:**
-- **NEVER** assert on: timestamps (dates, times), session IDs, exact numeric counts that vary between runs
-- For dynamic counts (e.g. "42 results"): assert on the STABLE part only (e.g. "results"), not the number
-- **PREFER** asserting on: status text, button labels, URL patterns, element enabled/disabled state
-
-**Page context rules — CRITICAL:**
-- After a page navigation (\`open\` or \`click\` that navigates), take a **fresh snapshot** BEFORE emitting any assertions
-- Only assert on text/elements that are visible on the **current** page — never assert on text from the previous page
-- If you navigated away from a page, its text is gone — do not emit \`text_visible\` for it
-
-**Selector rules for assert actions — CRITICAL:**
-- Use the **same ALLOWED formats** as browser actions — never invent aria-label values
-- Only use \`[aria-label='...']\` if that **exact** aria-label string appears in the current ARIA snapshot output
-- When unsure, prefer \`text_visible\`/\`text_not_visible\` (no selector needed) over guessing a selector
-- For \`element_disabled\`/\`element_enabled\`: use a CSS class selector if no aria-label is confirmed in the snapshot
-
-**Examples:**
-\`\`\`
-AB_ACTION|assert|url_contains|||/dashboard|Navigated to dashboard
-AB_ACTION|assert|element_disabled|.btn-submit||Submit button disabled before form is valid
-AB_ACTION|assert|element_enabled|.btn-submit||Submit button enabled after form is filled
-AB_ACTION|assert|text_visible|||Loading|Operation started
-AB_ACTION|assert|text_visible|||Done|Operation completed
-AB_ACTION|assert|text_visible|||Success|Confirmation message appeared
-\`\`\`
-
-## Status Protocol
-
-Emit exactly one status line per step (outside any code block):
-
-\`\`\`
-STEP_START|<step-id>|<step-title>
-STEP_DONE|<step-id>|<what was verified>
-ASSERTION_FAILED|<step-id>|<category: app-bug|env-issue|auth-blocked|missing-test-data|selector-drift|agent-misread>: <reason>
-STEP_SKIPPED|<step-id>|<reason>
-RUN_COMPLETED|passed|<summary>
-RUN_COMPLETED|failed|<summary>
-\`\`\`
-
-## Route Recording
-
-After each step (outside any code block):
-
-\`\`\`
-ROUTE_STEP|<step-id>|<step-title>|ACTION:<what you did>|OBSERVATION:<what you verified>|STATUS:<PASSED|FAILED|SKIPPED>
-\`\`\`
-
-## Start
-
-${skipCookiesClear ? `A setup procedure has already been executed in this session. Do NOT clear cookies — keep the existing session state.
-
-\`\`\`bash
-agent-browser --session ${sessionName} open ${spec.baseUrl}
-\`\`\`
-
-Emit:
-\`\`\`
-AB_ACTION|open|${spec.baseUrl}
-\`\`\`` : `\`\`\`bash
-agent-browser --session ${sessionName} cookies clear
-agent-browser --session ${sessionName} open ${spec.baseUrl}
-\`\`\`
-
-Emit:
-\`\`\`
-AB_ACTION|cookies_clear
-AB_ACTION|open|${spec.baseUrl}
-\`\`\``}
-
-Then emit \`STEP_START|step-01|...\` and begin.`;
-}
-
-export function buildTracePrompt(spec: TestSpec): string {
-  return `Execute the test for "${spec.title}" at ${spec.baseUrl}.`;
-}
-
-export function buildSetupTraceSystemPrompt(spec: SetupSpec): string {
-  return buildTraceSystemPrompt({
-    title: spec.title,
-    baseUrl: "about:blank",
-    steps: spec.steps,
-  });
-}
-
-export function buildSetupTracePrompt(spec: SetupSpec): string {
-  return `Execute the setup procedure "${spec.title}". Follow each step precisely.`;
-}

package/src/runtime/test-helpers.ts

@@ -1,133 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-
-// Use createRequire instead of import.meta.resolve so this module works under
-// Vite/Vitest's SSR transform (which replaces import.meta with a shim that
-// lacks .resolve). import.meta.url survives the transform, so createRequire
-// based on it can still locate peer-installed packages.
-const require = createRequire(import.meta.url);
-const AB = require.resolve("agent-browser/bin/agent-browser.js");
-
-type Result = { status: number | null; stdout: string; stderr: string };
-
-function spawnAB(args: string[]): Result {
-  const result = spawnSync(AB, args, { stdio: "pipe" });
-  return {
-    status: result.status,
-    stdout: result.stdout?.toString() ?? "",
-    stderr: result.stderr?.toString() ?? "",
-  };
-}
-
-function logStep(action: string, args: readonly unknown[]): void {
-  const pretty = args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join("  ");
-  process.stdout.write(`  ▶ ${action.padEnd(14)} ${pretty}\n`);
-}
-
-function fail(summary: string, result: Result): never {
-  process.stdout.write(`  ✗ ${summary}\n`);
-  const details = [result.stdout, result.stderr].map((s) => s.trim()).filter(Boolean).join("\n");
-  if (details) {
-    for (const line of details.split("\n")) {
-      process.stdout.write(`      ${line}\n`);
-    }
-  }
-  throw new Error(summary);
-}
-
-export function ab(...args: string[]): void {
-  const [command = "", ...rest] = args;
-  logStep(command, rest);
-  const result = spawnAB(args);
-  if (result.status !== 0) {
-    fail(`agent-browser ${command} failed (exit ${result.status})`, result);
-  }
-}
-
-/** Wait for element/text with an explicit timeout so long-running async ops don't hang. */
-export function abWait(selector: string, timeoutMs = 180_000): void {
-  logStep("wait", [selector]);
-  const args = selector.startsWith("text=")
-    ? ["wait", "--text", selector.slice(5), "--timeout", String(timeoutMs)]
-    : ["wait", selector, "--timeout", String(timeoutMs)];
-  const result = spawnAB(args);
-  if (result.status !== 0) {
-    fail(`wait failed: ${selector}`, result);
-  }
-}
-
-/** Assert stable text is visible on page (via wait --text). */
-export function abAssertTextVisible(text: string, timeoutMs = 30_000): void {
-  logStep("assert.text", [text]);
-  const result = spawnAB(["wait", "--text", text, "--timeout", String(timeoutMs)]);
-  if (result.status !== 0) {
-    fail(`Assertion failed: text ${JSON.stringify(text)} not found within ${timeoutMs}ms`, result);
-  }
-}
-
-/** Assert element is visible (via wait). */
-export function abAssertVisible(selector: string, timeoutMs = 30_000): void {
-  logStep("assert.visible", [selector]);
-  const result = spawnAB(["wait", selector, "--timeout", String(timeoutMs)]);
-  if (result.status !== 0) {
-    fail(`Assertion failed: ${JSON.stringify(selector)} not visible within ${timeoutMs}ms`, result);
-  }
-}
-
-/** Assert element is NOT visible (via wait --state hidden). */
-export function abAssertNotVisible(selector: string, timeoutMs = 30_000): void {
-  logStep("assert.hidden", [selector]);
-  const args = selector.startsWith("text=")
-    ? ["wait", "--text", selector.slice(5), "--state", "hidden", "--timeout", String(timeoutMs)]
-    : ["wait", selector, "--state", "hidden", "--timeout", String(timeoutMs)];
-  const result = spawnAB(args);
-  if (result.status !== 0) {
-    fail(`Assertion failed: ${JSON.stringify(selector)} still visible after ${timeoutMs}ms`, result);
-  }
-}
-
-/** Assert URL contains a pattern (via get url). */
-export function abAssertUrl(pattern: string): void {
-  logStep("assert.url", [pattern]);
-  const result = spawnAB(["get", "url"]);
-  const url = result.stdout.trim();
-  if (!url.includes(pattern)) {
-    fail(`Assertion failed: URL ${JSON.stringify(url)} does not contain ${JSON.stringify(pattern)}`, result);
-  }
-}
-
-/** Assert element is enabled (via is enabled). */
-export function abAssertEnabled(selector: string): void {
-  logStep("assert.enabled", [selector]);
-  const result = spawnAB(["is", "enabled", selector]);
-  if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
-  const value = result.stdout.trim();
-  if (value !== "true") fail(`Assertion failed: ${JSON.stringify(selector)} is not enabled (got: ${value})`, result);
-}
-
-/** Assert element is disabled (via is enabled). */
-export function abAssertDisabled(selector: string): void {
-  logStep("assert.disabled", [selector]);
-  const result = spawnAB(["is", "enabled", selector]);
-  if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
-  const value = result.stdout.trim();
-  if (value !== "false") fail(`Assertion failed: ${JSON.stringify(selector)} is not disabled (got: ${value})`, result);
-}
-
-/** Assert checkbox is checked (via is checked). */
-export function abAssertChecked(selector: string): void {
-  logStep("assert.checked", [selector]);
-  const result = spawnAB(["is", "checked", selector]);
-  if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
-  const value = result.stdout.trim();
-  if (value !== "true") fail(`Assertion failed: ${JSON.stringify(selector)} is not checked (got: ${value})`, result);
-}
-
-/** Assert checkbox is unchecked (via is checked). */
-export function abAssertUnchecked(selector: string): void {
-  logStep("assert.unchecked", [selector]);
-  const result = spawnAB(["is", "checked", selector]);
-  if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
-  const value = result.stdout.trim();
-  if (value !== "false") fail(`Assertion failed: ${JSON.stringify(selector)} is not unchecked (got: ${value})`, result);
-}

package/src/runtime/vitest.config.ts

@@ -1,15 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-// Default vitest config used by `ccqa run`. Passed via `--config` so the host
-// project's vitest.config.ts is not picked up. ccqa specs are Node-side E2E
-// tests driving agent-browser; host configs (setupFiles, jsdom/happy-dom
-// environment, @ aliases, etc.) don't apply and often break the run.
-//
-// Consumers can override by placing .ccqa/vitest.config.ts in their project;
-// `ccqa run` prefers that file when present.
-export default defineConfig({
-  test: {
-    environment: "node",
-    globals: false,
-  },
-});

package/src/spec/parser.test.ts

@@ -1,135 +0,0 @@
-import { describe, test, expect } from "bun:test";
-import { parseTestSpec } from "./parser.ts";
-
-const BASIC_SPEC = `---
-title: My Test
-baseUrl: http://localhost:3000
----
-
-### Step 1: Login
-**Instruction**: Navigate to the login page
-**Expected**: Login form is visible
-`;
-
-describe("parseTestSpec", () => {
-  test("parses title and baseUrl from frontmatter", () => {
-    const result = parseTestSpec(BASIC_SPEC);
-    expect(result.title).toBe("My Test");
-    expect(result.baseUrl).toBe("http://localhost:3000");
-  });
-
-  test("defaults title to Untitled when missing", () => {
-    const result = parseTestSpec("---\nbaseUrl: http://localhost:3000\n---\n");
-    expect(result.title).toBe("Untitled");
-  });
-
-  test("defaults baseUrl to http://localhost:3000 when missing", () => {
-    const result = parseTestSpec("---\ntitle: My Test\n---\n");
-    expect(result.baseUrl).toBe("http://localhost:3000");
-  });
-
-  test("parses a single step correctly", () => {
-    const result = parseTestSpec(BASIC_SPEC);
-    expect(result.steps).toHaveLength(1);
-    expect(result.steps[0]).toEqual({
-      id: "step-01",
-      title: "Login",
-      instruction: "Navigate to the login page",
-      expected: "Login form is visible",
-    });
-  });
-
-  test("parses multiple steps with correct id generation", () => {
-    const spec = `---
-title: Multi
-baseUrl: http://localhost
----
-
-### Step 1: First
-**Instruction**: Do first
-**Expected**: First done
-
-### Step 2: Second
-**Instruction**: Do second
-**Expected**: Second done
-`;
-    const result = parseTestSpec(spec);
-    expect(result.steps).toHaveLength(2);
-    expect(result.steps[0]?.id).toBe("step-01");
-    expect(result.steps[1]?.id).toBe("step-02");
-  });
-
-  test("returns empty steps array when no steps defined", () => {
-    const result = parseTestSpec("---\ntitle: No Steps\nbaseUrl: http://localhost\n---\n");
-    expect(result.steps).toHaveLength(0);
-  });
-
-  test("skips steps missing Instruction or Expected", () => {
-    const spec = `---
-title: Missing Fields
-baseUrl: http://localhost
----
-
-### Step 1: Complete
-**Instruction**: Do something
-**Expected**: See something
-
-### Step 2: Missing Expected
-**Instruction**: Do something
-
-### Step 3: Missing Instruction
-**Expected**: See something
-`;
-    const result = parseTestSpec(spec);
-    expect(result.steps).toHaveLength(1);
-    expect(result.steps[0]?.id).toBe("step-01");
-  });
-
-  test("parses prerequisites when present", () => {
-    const spec = `---
-title: With Prereqs
-baseUrl: http://localhost
----
-
-## Prerequisites
-User must be logged in as admin.
-
-### Step 1: Check
-**Instruction**: Do check
-**Expected**: Check done
-`;
-    const result = parseTestSpec(spec);
-    expect(result.prerequisites).toBe("User must be logged in as admin.");
-  });
-
-  test("returns undefined for prerequisites when section is absent", () => {
-    const result = parseTestSpec(BASIC_SPEC);
-    expect(result.prerequisites).toBeUndefined();
-  });
-
-  test("parses setups from frontmatter", () => {
-    const spec = `---
-title: Setup Test
-baseUrl: http://localhost:3000
-setups:
-  - name: login
-    params:
-      email: user@example.com
-      password: secret
----
-
-### Step 1: Check
-**Instruction**: Do check
-**Expected**: Check done
-`;
-    const result = parseTestSpec(spec);
-    expect(result.setups).toHaveLength(1);
-    expect(result.setups![0]!.name).toBe("login");
-    expect(result.setups![0]!.params).toEqual({ email: "user@example.com", password: "secret" });
-  });
-
-  test("returns undefined for setups when not specified", () => {
-    const result = parseTestSpec(BASIC_SPEC);
-    expect(result.setups).toBeUndefined();
-  });
-});

package/src/spec/parser.ts

@@ -1,96 +0,0 @@
-import matter from "gray-matter";
-import type { TestSpec, TestStep, SetupSpec, SetupRef } from "../types.ts";
-
-export function parseTestSpec(content: string): TestSpec {
-  const { data, content: body } = matter(content);
-
-  const steps = parseSteps(body);
-
-  const prerequisites = parsePrerequisites(body);
-
-  return {
-    title: String(data["title"] ?? "Untitled"),
-    baseUrl: String(data["baseUrl"] ?? "http://localhost:3000"),
-    prerequisites: prerequisites || undefined,
-    setups: parseSetupRefs(data["setups"]),
-    steps,
-  };
-}
-
-export function parseSetupSpec(content: string): SetupSpec {
-  const { data, content: body } = matter(content);
-
-  const steps = parseSteps(body);
-  const placeholders = parsePlaceholders(data["placeholders"]);
-
-  return {
-    title: String(data["title"] ?? "Untitled"),
-    placeholders: Object.keys(placeholders).length > 0 ? placeholders : undefined,
-    steps,
-  };
-}
-
-function parsePlaceholders(raw: unknown): Record<string, { dummy: string; description?: string }> {
-  if (!raw || typeof raw !== "object") return {};
-  const result: Record<string, { dummy: string; description?: string }> = {};
-  for (const [key, val] of Object.entries(raw as Record<string, unknown>)) {
-    if (val && typeof val === "object" && "dummy" in val) {
-      const v = val as Record<string, unknown>;
-      result[key] = {
-        dummy: String(v["dummy"]),
-        description: v["description"] ? String(v["description"]) : undefined,
-      };
-    }
-  }
-  return result;
-}
-
-function parseSetupRefs(raw: unknown): SetupRef[] | undefined {
-  if (!Array.isArray(raw)) return undefined;
-  const refs: SetupRef[] = [];
-  for (const item of raw) {
-    if (typeof item === "object" && item !== null && "name" in item) {
-      const i = item as Record<string, unknown>;
-      refs.push({
-        name: String(i["name"]),
-        params: i["params"] && typeof i["params"] === "object"
-          ? Object.fromEntries(
-              Object.entries(i["params"] as Record<string, unknown>).map(([k, v]) => [k, String(v)])
-            )
-          : undefined,
-      });
-    }
-  }
-  return refs.length > 0 ? refs : undefined;
-}
-
-function parsePrerequisites(body: string): string | null {
-  const match = body.match(/##\s+Prerequisites\s+([\s\S]*?)(?=##|$)/);
-  if (!match || !match[1]) return null;
-  return match[1].trim();
-}
-
-function parseSteps(body: string): TestStep[] {
-  const stepBlocks = body.split(/###\s+Step\s+\d+:/);
-  const steps: TestStep[] = [];
-
-  for (let i = 1; i < stepBlocks.length; i++) {
-    const block = stepBlocks[i];
-    if (!block) continue;
-
-    const titleMatch = block.match(/^(.+)/);
-    const instructionMatch = block.match(/\*\*Instruction\*\*:\s*(.+)/);
-    const expectedMatch = block.match(/\*\*Expected\*\*:\s*(.+)/);
-
-    if (!titleMatch || !instructionMatch || !expectedMatch) continue;
-
-    steps.push({
-      id: `step-${String(i).padStart(2, "0")}`,
-      title: titleMatch[1]?.trim() ?? "",
-      instruction: instructionMatch[1]?.trim() ?? "",
-      expected: expectedMatch[1]?.trim() ?? "",
-    });
-  }
-
-  return steps;
-}