archal 0.9.19 → 0.10.0

package/dist/vitest/index.js

@@ -8,12 +8,10 @@ import {
   readArchalVitestConfig,
   resetArchalClones,
   resolveRuntimeModule
-} from "./chunk-L36NXAU6.js";
+} from "./chunk-2PDHTPZC.js";
 import {
-  encodeConfig,
-  getCredentials,
-  getSessionIdFilePath
-} from "./chunk-WZ7SA4CK.js";
+  encodeConfig
+} from "./chunk-7L4BBB6M.js";
 
 // src/index.ts
 import { dirname, isAbsolute, resolve as resolve2 } from "path";
@@ -145,7 +143,7 @@ function installReporterLifecycleCheck(projectName) {
         return;
       }
       process.stderr.write(
-        '\n\x1B[33m\x1B[1mArchal Vitest could not upload test results\n\x1B[0m\x1B[33mThe Archal reporter started, but Vitest did not call its final upload\nstep. Test results will not appear in the dashboard.\n\nCommon causes:\n  - A Vitest upgrade changed per-project reporter lifecycle timing.\n  - A consumer config filtered out reporters (look for reporter overrides).\n  - The ArchalReporter threw before reaching collectAndReport.\n\nWhat to check:\n  1. Grep stderr for "[archal/reporter]". If any line appears, the\n     reporter did run and this warning is a false positive.\n  2. If no [archal/reporter] lines exist at all, the reporter was\n     installed but never called. Verify your vitest config wires it\n     at the level Vitest actually honors (workspace root vs project).\n'
+        '\n\x1B[33m\x1B[1mArchal Vitest reporter did not finish lifecycle diagnostics\n\x1B[0m\x1B[33mThe Archal reporter started, but Vitest did not call its final\nlifecycle step. Benchmark Results are submitted by the scenario runner.\n\nCommon causes:\n  - A Vitest upgrade changed per-project reporter lifecycle timing.\n  - A consumer config filtered out reporters (look for reporter overrides).\n  - The ArchalReporter threw before reaching collectAndReport.\n\nWhat to check:\n  1. Grep stderr for "[archal/reporter]". If any line appears, the\n     reporter did run and this warning is a false positive.\n  2. If no [archal/reporter] lines exist at all, the reporter was\n     installed but never called. Verify your vitest config wires it\n     at the level Vitest actually honors (workspace root vs project).\n'
       );
       process.stderr.write("\x1B[0m\n");
       for (const survivor of survivors) {
@@ -193,7 +191,7 @@ function installWorkspaceReporterCheck(projectNames) {
         return;
       }
       process.stderr.write(
-        "\n\x1B[33m\x1B[1mArchal Vitest did not upload workspace test results\n\x1B[0m\x1B[33marchalVitestWorkspace() configured hosted clone projects, but no\nroot Archal reporter was registered. Requests were routed to the\nhosted clones, but dashboard upload was skipped.\n\nFix: add a root vitest.config.ts alongside vitest.workspace.ts:\n\n    import { defineConfig } from 'vitest/config';\n    import { archalVitestRootConfig } from 'archal/vitest';\n\n    export default defineConfig(archalVitestRootConfig());\n\nIf you do not need workspace mode, use withArchal() instead.\n\x1B[0m\n"
+        "\n\x1B[33m\x1B[1mArchal Vitest did not run workspace reporter diagnostics\n\x1B[0m\x1B[33marchalVitestWorkspace() configured hosted clone projects, but no\nroot Archal reporter was registered. Requests were routed to the\nhosted clones, but reporter lifecycle diagnostics were skipped.\n\nFix: add a root vitest.config.ts alongside vitest.workspace.ts:\n\n    import { defineConfig } from 'vitest/config';\n    import { archalVitestRootConfig } from 'archal/vitest';\n\n    export default defineConfig(archalVitestRootConfig());\n\nIf you do not need workspace mode, use withArchal() instead.\n\x1B[0m\n"
       );
       for (const survivor of survivors) {
         try {
@@ -254,7 +252,7 @@ function installImportSentinel() {
     if (process.env[ARCHAL_VITEST_CONFIG_ENV2]) return;
     warningWritten = true;
     process.stderr.write(
-      "\n\x1B[33m\x1B[1mArchal Vitest was imported but not configured\n\x1B[0m\x1B[33mSomething in your test run imported `archal/vitest`, but no\nArchal Vitest helper was called (`withArchal`, `archalVitestProject`,\n`archalVitestRootConfig`). Test results will not appear in the dashboard.\n\nFix: in your vitest.config.ts, wrap your test block with withArchal():\n\n    import { defineConfig } from 'vitest/config';\n    import { withArchal } from 'archal/vitest';\n    export default defineConfig({\n      test: withArchal({}, { services: {} }),\n    });\n\nOr run `archal init` from your project root and we will wire it for you.\n\x1B[0m\n"
+      "\n\x1B[33m\x1B[1mArchal Vitest was imported but not configured\n\x1B[0m\x1B[33mSomething in your test run imported `archal/vitest`, but no\nArchal Vitest helper was called (`withArchal`, `archalVitestProject`,\n`archalVitestRootConfig`). Benchmark Results are submitted by the scenario runner.\n\nFix: in your vitest.config.ts, wrap your test block with withArchal():\n\n    import { defineConfig } from 'vitest/config';\n    import { withArchal } from 'archal/vitest';\n    export default defineConfig({\n      test: withArchal({}, { services: {} }),\n    });\n\nOr run `archal init` from your project root and we will wire it for you.\n\x1B[0m\n"
     );
   };
   const sigintHandler = () => {
@@ -274,14 +272,8 @@ function installImportSentinel() {
 }
 
 // src/reporter.ts
-import picomatch from "picomatch";
 var LOG_PREFIX = "[archal/reporter]";
 var STRICT_ENV = "ARCHAL_REPORTER_STRICT";
-var REPORTER_TOKEN_ENV = "ARCHAL_REPORTER_TOKEN";
-var REPORTER_AUTH_URL_ENV = "ARCHAL_REPORTER_AUTH_URL";
-var REPORTER_AUTH_BASE_URL_ENV = "ARCHAL_REPORTER_AUTH_BASE_URL";
-var REPORTER_BYPASS_SECRET_ENV = "ARCHAL_REPORTER_VERCEL_AUTOMATION_BYPASS_SECRET";
-var REPORTER_WORKSPACE_ENV = "ARCHAL_REPORTER_WORKSPACE_ID";
 var WORKSPACE_REPORTER_MARKER_ENV = "ARCHAL_VITEST_WORKSPACE_REPORTER_MARKER";
 function isStrict() {
   return process.env[STRICT_ENV] === "1";
@@ -294,112 +286,43 @@ function warn(message) {
   }
   process.stderr.write(line);
 }
-function info(message) {
+function diagnostic(message) {
   process.stderr.write(`${LOG_PREFIX} ${message}
 `);
 }
-async function resolveReporterToken() {
-  const explicitReporterToken = process.env[REPORTER_TOKEN_ENV]?.trim();
-  if (explicitReporterToken) {
-    return explicitReporterToken;
-  }
-  try {
-    const creds = getCredentials();
-    return creds?.token ?? process.env["ARCHAL_TOKEN"]?.trim();
-  } catch (authErr) {
-    warn(`auth resolution failed: ${authErr instanceof Error ? authErr.message : String(authErr)}`);
-    return void 0;
-  }
-}
-function resolveReporterBaseUrl() {
-  return (process.env[REPORTER_AUTH_URL_ENV]?.trim() || process.env[REPORTER_AUTH_BASE_URL_ENV]?.trim() || process.env["ARCHAL_AUTH_URL"]?.trim() || process.env["ARCHAL_AUTH_BASE_URL"]?.trim() || "https://www.archal.ai").replace(/\/+$/, "");
-}
-function buildReporterHeaders(token) {
-  const headers = new Headers({
-    "content-type": "application/json",
-    authorization: `Bearer ${token}`
-  });
-  const bypassSecret = process.env[REPORTER_BYPASS_SECRET_ENV]?.trim();
-  if (bypassSecret) {
-    headers.set("x-vercel-protection-bypass", bypassSecret);
-  }
-  const workspaceId = resolveReporterWorkspaceId();
-  if (workspaceId) {
-    headers.set("x-archal-workspace", workspaceId);
-  }
-  return headers;
-}
-function resolveReporterWorkspaceId() {
-  const reporterWorkspaceId = process.env[REPORTER_WORKSPACE_ENV]?.trim();
-  if (reporterWorkspaceId) {
-    return reporterWorkspaceId;
-  }
-  const cliWorkspaceId = process.env["ARCHAL_WORKSPACE_ID"]?.trim();
-  return cliWorkspaceId || void 0;
-}
-function normalizePathForMatch(path) {
-  return path.replaceAll("\\", "/");
-}
-function buildIncludeMatcher(pattern) {
-  const normalizedPattern = normalizePathForMatch(pattern).replace(/^\.?\//, "");
-  const patterns = normalizedPattern.startsWith("**/") ? [normalizedPattern] : [normalizedPattern, `**/${normalizedPattern}`];
-  const matchers = patterns.map((candidate) => picomatch(candidate, { dot: true }));
-  return (filePath) => {
-    const normalizedFile = normalizePathForMatch(filePath);
-    return matchers.some((matcher) => matcher(normalizedFile));
-  };
-}
 function readEncodedConfigFromTarget(target) {
   const env = target?.config?.env;
   return env?.[ARCHAL_VITEST_CONFIG_ENV];
 }
-function readProjectIncludePatterns(project) {
-  const config = project?.config;
-  const include = Array.isArray(config?.include) ? config.include : Array.isArray(config?.test?.include) ? config.test.include : [];
-  return include.filter(
-    (pattern) => typeof pattern === "string" && pattern.length > 0
-  );
-}
 var ArchalReporter = class {
-  startTime = 0;
   ctx = null;
   lifecycleMarkerPath = "";
-  workspaceReporterMarkerPath = "";
-  projects = [];
   /**
-   * In-flight upload promise for the current run. Vitest v3+ fires both
-   * `onFinished` and `onTestRunEnd` in parallel via `Promise.all` (see
-   * vitest@3.x packages/vitest/src/node/test-run.ts), so without this guard
-   * the reporter uploads results twice and the dashboard shows duplicate
-   * rows. Reset at the start of each run (onTestRunStart / onWatcherRerun)
-   * so watch-mode reruns still upload.
+   * In-flight lifecycle promise for the current run. Vitest v3+ fires both
+   * `onFinished` and `onTestRunEnd` in parallel via `Promise.all`, so without
+   * this guard the reporter emits duplicate diagnostics. Reset at the start
+   * of each run (onTestRunStart / onWatcherRerun) so watch-mode reruns still
+   * report.
    */
-  activeUpload = null;
+  activeLifecycle = null;
   onInit(ctx) {
-    this.startTime = Date.now();
     this.ctx = ctx;
-    this.projects = this.resolveProjects();
-    const projectName = this.projects[0]?.config.projectName ?? "vitest";
+    const projectName = this.resolveProjectName();
     this.lifecycleMarkerPath = installReporterLifecycleCheck(projectName);
-    this.workspaceReporterMarkerPath = process.env[WORKSPACE_REPORTER_MARKER_ENV] ?? "";
-    markWorkspaceReporterInstalled(this.workspaceReporterMarkerPath);
-    this.workspaceReporterMarkerPath = "";
+    const workspaceReporterMarkerPath = process.env[WORKSPACE_REPORTER_MARKER_ENV] ?? "";
+    markWorkspaceReporterInstalled(workspaceReporterMarkerPath);
   }
-  /**
-   * v3+ canonical start-of-run hook. Resetting the upload guard here lets
-   * watch-mode reruns upload their own results.
-   */
   onTestRunStart(_specifications) {
-    this.activeUpload = null;
-    this.startTime = Date.now();
+    this.activeLifecycle = null;
   }
-  /**
-   * v2 watch-mode start-of-rerun hook. Same purpose as onTestRunStart for
-   * v3+. Vitest v2 has no onTestRunStart, so we reset here instead.
-   */
   onWatcherRerun(_files, _trigger) {
-    this.activeUpload = null;
-    this.startTime = Date.now();
+    this.activeLifecycle = null;
+  }
+  async onFinished(files, _errors) {
+    await this.runLifecycleOnce(files?.length ?? 0, "files");
+  }
+  async onTestRunEnd(testModules, _unhandledErrors, _reason) {
+    await this.runLifecycleOnce(testModules?.length ?? 0, "test modules");
   }
   decodeConfig(encoded) {
     try {
@@ -408,320 +331,34 @@ var ArchalReporter = class {
       return null;
     }
   }
-  buildProjectContext(config, includePatterns) {
-    return {
-      config,
-      includePatterns,
-      includeMatchers: includePatterns.map(buildIncludeMatcher)
-    };
-  }
-  resolveProjects() {
-    const resolvedProjects = (this.ctx?.projects ?? []).map((project) => {
+  resolveProjectName() {
+    for (const project of this.ctx?.projects ?? []) {
       const config = this.decodeConfig(readEncodedConfigFromTarget(project));
-      return config ? this.buildProjectContext(config, readProjectIncludePatterns(project)) : null;
-    }).filter((project) => project !== null);
-    if (resolvedProjects.length > 0) {
-      return resolvedProjects;
+      if (config?.projectName) {
+        return config.projectName;
+      }
     }
     const rootConfig = this.decodeConfig(
       readEncodedConfigFromTarget(this.ctx) ?? process.env[ARCHAL_VITEST_CONFIG_ENV]
     );
-    return rootConfig ? [this.buildProjectContext(rootConfig, [])] : [];
-  }
-  /**
-   * vitest v2 calls onFinished with an array of File objects (from @vitest/runner).
-   * Each File extends Suite which has `tasks: Task[]`, and each Task has
-   * `.type` ('test' | 'suite'), `.name`, `.result?.state`, `.result?.duration`.
-   */
-  async onFinished(files, _errors) {
-    await this.runUploadOnce(() => this.collectAndReport(files ?? [], "v2"));
+    return rootConfig?.projectName ?? "vitest";
   }
-  /**
-   * vitest v3+ calls onTestRunEnd alongside onFinished (in parallel via
-   * Promise.all). v4 drops onFinished entirely. The argument is an array of
-   * test modules, each with nested children.
-   */
-  async onTestRunEnd(testModules) {
-    await this.runUploadOnce(() => this.collectAndReport(testModules ?? [], "v4"));
-  }
-  /**
-   * Dedupe upload work when Vitest fires multiple end-of-run hooks. In
-   * Vitest v3+ both `onFinished` and `onTestRunEnd` fire from the same
-   * `Promise.all` in TestRun.end(); the first hook to enter wins and the
-   * second awaits the same in-flight upload instead of POSTing a duplicate
-   * row to /api/test-results. The resolved promise is kept on the instance
-   * so any late hook still no-ops — the guard is only cleared at the start
-   * of a new run (onTestRunStart / onWatcherRerun).
-   */
-  async runUploadOnce(work) {
-    if (!this.activeUpload) {
-      this.activeUpload = work();
+  async runLifecycleOnce(itemCount, itemLabel) {
+    if (!this.activeLifecycle) {
+      this.activeLifecycle = this.reportLifecycleComplete(itemCount, itemLabel);
     }
-    await this.activeUpload;
+    await this.activeLifecycle;
   }
-  async collectAndReport(items, version) {
+  async reportLifecycleComplete(itemCount, itemLabel) {
     markReporterFired(this.lifecycleMarkerPath);
     this.lifecycleMarkerPath = "";
-    if (this.projects.length === 0) {
-      this.projects = this.resolveProjects();
-    }
-    if (this.projects.length === 0) {
-      warn(
-        "Archal Vitest config was unreadable. Using the default project name. If this persists, make sure withArchal() or archalVitestProject() wraps your test config."
-      );
-      this.projects = [
-        this.buildProjectContext(
-          {
-            projectName: "vitest",
-            services: {}
-          },
-          []
-        )
-      ];
-    }
-    if (items.length === 0) {
-      warn(`No ${version === "v2" ? "files" : "test modules"} received. Nothing to upload.`);
-      return;
-    }
-    const results = version === "v2" ? this.collectV2Files(items) : this.collectV4Modules(items);
-    if (results.length === 0) {
-      warn("Collected 0 tests after reading the test tree. Nothing to upload.");
-      return;
-    }
-    const buckets = this.partitionResults(results);
-    if (buckets.length === 0) {
-      warn("collected tests but could not map them to an Archal Vitest project.");
-      return;
-    }
-    try {
-      for (const bucket of buckets) {
-        await this.sendResults(bucket.project, bucket.results);
-      }
-    } catch (err) {
-      warn(`failed to upload test results: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-  /**
-   * vitest v2: File extends Suite { tasks: Task[] }.
-   * Task.type is 'test' | 'suite' | 'custom'. Suite tasks recurse.
-   */
-  collectV2Files(files) {
-    const results = [];
-    const collectTasks = (tasks, fileName) => {
-      for (const task of tasks) {
-        if (task.type === "test" || task.type === "custom") {
-          const state = task.result?.state;
-          results.push({
-            name: task.name ?? "unnamed",
-            file: fileName,
-            status: state === "pass" ? "passed" : state === "fail" ? "failed" : "skipped",
-            duration: task.result?.duration ?? 0,
-            error: state === "fail" && task.result?.errors?.[0] ? task.result.errors[0].message ?? String(task.result.errors[0]) : void 0
-          });
-        } else if (task.type === "suite" && Array.isArray(task.tasks)) {
-          collectTasks(task.tasks, fileName);
-        }
-      }
-    };
-    for (const file of files) {
-      const f = file;
-      const fileName = f.filepath ?? f.name ?? "unknown";
-      if (Array.isArray(f.tasks)) {
-        collectTasks(f.tasks, fileName);
-      }
-    }
-    return results;
-  }
-  /**
-   * vitest v4: TestModule.children() → TestSuite[].children() → TestCase[]
-   * All accessors are methods (not properties) in v4.
-   */
-  collectV4Modules(testModules) {
-    const results = [];
-    const collectTests = (node, fileName) => {
-      const children = typeof node.children === "function" ? node.children() : node.children ?? [];
-      for (const child of children) {
-        if (child.type === "test") {
-          const result = typeof child.result === "function" ? child.result() : child.result;
-          const diag = typeof child.diagnostic === "function" ? child.diagnostic() : child.diagnostic;
-          const state = result?.state;
-          results.push({
-            name: child.name ?? "unnamed",
-            file: fileName,
-            status: state === "passed" ? "passed" : state === "failed" ? "failed" : "skipped",
-            duration: diag?.duration ?? result?.duration ?? 0,
-            error: state === "failed" && result?.errors?.[0] ? result.errors[0].message ?? String(result.errors[0]) : void 0
-          });
-        } else {
-          collectTests(child, fileName);
-        }
-      }
-    };
-    for (const mod of testModules) {
-      const m = mod;
-      const fileName = m.moduleId ?? m.id ?? "unknown";
-      collectTests(m, fileName);
-    }
-    return results;
-  }
-  resolveProjectForFile(fileName) {
-    const normalizedFile = normalizePathForMatch(fileName);
-    const onlyProject = this.projects[0] ?? null;
-    if (this.projects.length === 1) {
-      if (!onlyProject) {
-        return null;
-      }
-      if (onlyProject.includeMatchers.length === 0) {
-        return onlyProject;
-      }
-      return onlyProject.includeMatchers.some((matcher) => matcher(normalizedFile)) ? onlyProject : null;
-    }
-    let bestMatch = null;
-    let bestSpecificity = -1;
-    for (const project of this.projects) {
-      for (const [index, matcher] of project.includeMatchers.entries()) {
-        if (!matcher(normalizedFile)) {
-          continue;
-        }
-        const specificity = project.includePatterns[index]?.length ?? 0;
-        if (specificity > bestSpecificity) {
-          bestMatch = project;
-          bestSpecificity = specificity;
-        }
-      }
-    }
-    return bestMatch;
-  }
-  partitionResults(results) {
-    const buckets = /* @__PURE__ */ new Map();
-    for (const result of results) {
-      const project = this.resolveProjectForFile(result.file);
-      if (!project) {
-        warn(
-          `Could not map ${result.file} to a Vitest project config. Skipping reporter upload for that file.`
-        );
-        continue;
-      }
-      const key = project.config.projectName;
-      const bucket = buckets.get(key);
-      if (bucket) {
-        bucket.results.push(result);
-        continue;
-      }
-      buckets.set(key, {
-        project,
-        results: [result]
-      });
-    }
-    return [...buckets.values()];
-  }
-  async sendResults(project, results) {
-    const summary = {
-      total: results.length,
-      passed: results.filter((result) => result.status === "passed").length,
-      failed: results.filter((result) => result.status === "failed").length,
-      skipped: results.filter((result) => result.status === "skipped").length,
-      duration: Date.now() - this.startTime
-    };
-    const token = await resolveReporterToken();
-    if (!token) {
-      warn(
-        `skipped upload (no auth token found). Set ${REPORTER_TOKEN_ENV} or ARCHAL_TOKEN, or run \`archal login\` to populate ~/.archal/credentials.json.`
-      );
+    if (itemCount === 0) {
+      warn(`No ${itemLabel} received. Nothing to upload.`);
       return;
     }
-    const baseUrl = resolveReporterBaseUrl();
-    const sessionId = await this.readSessionId(project.config.sessionKey);
-    const payload = {
-      sessionId,
-      projectName: project.config.projectName,
-      services: Object.keys(project.config.services),
-      results,
-      summary,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    const res = await fetch(`${baseUrl}/api/test-results`, {
-      method: "POST",
-      headers: buildReporterHeaders(token),
-      body: JSON.stringify(payload)
-    });
-    if (res.ok) {
-      info(`Uploaded ${summary.passed}/${summary.total} tests to Archal Tests.`);
-      if (sessionId) {
-        try {
-          const syncRes = await fetch(`${baseUrl}/api/sessions/sync`, {
-            method: "POST",
-            headers: buildReporterHeaders(token),
-            body: JSON.stringify({
-              sessionId,
-              twinIds: Object.keys(project.config.services),
-              status: summary.failed > 0 ? "failed" : "ended",
-              endedAt: (/* @__PURE__ */ new Date()).toISOString(),
-              runtimeStartedAt: new Date(Date.now() - summary.duration).toISOString(),
-              source: "test",
-              evidence: {
-                reportSummary: {
-                  scenarioTitle: project.config.projectName,
-                  satisfactionScore: summary.total > 0 ? Math.round(summary.passed / summary.total * 100) : null,
-                  runCount: 1
-                }
-              }
-            })
-          });
-          if (!syncRes.ok) {
-            const body = await syncRes.text().catch(() => "");
-            warn(`Session sync failed (${syncRes.status}): ${body.slice(0, 200)}`);
-          }
-        } catch (syncErr) {
-          warn(
-            `Session sync failed: ${syncErr instanceof Error ? syncErr.message : String(syncErr)}`
-          );
-        }
-      } else {
-        warn(
-          "Uploaded test results, but could not link them to a session. The run may not appear in Activity."
-        );
-      }
-    } else {
-      const body = await res.text().catch(() => "");
-      warn(`Upload failed (${res.status}): ${body.slice(0, 200)}`);
-    }
-  }
-  async readSessionId(sessionKey) {
-    const { readFileSync: readFileSync2, readdirSync, statSync } = await import("fs");
-    const { dirname: dirname2, join: join2 } = await import("path");
-    if (sessionKey?.trim()) {
-      try {
-        const keyed = readFileSync2(getSessionIdFilePath(sessionKey), "utf-8").trim();
-        if (keyed) return keyed;
-      } catch {
-      }
-    }
-    if (sessionKey?.trim()) {
-      return void 0;
-    }
-    try {
-      const sessionsDir = dirname2(getSessionIdFilePath("any"));
-      const entries = readdirSync(sessionsDir);
-      let newest;
-      for (const name of entries) {
-        if (!name.endsWith(".session-id")) continue;
-        const path = join2(sessionsDir, name);
-        try {
-          const st = statSync(path);
-          if (!newest || st.mtimeMs > newest.mtimeMs) {
-            newest = { path, mtimeMs: st.mtimeMs };
-          }
-        } catch {
-        }
-      }
-      if (newest) {
-        const content = readFileSync2(newest.path, "utf-8").trim();
-        if (content) return content;
-      }
-    } catch {
-    }
-    return void 0;
+    diagnostic(
+      "skipped legacy test-result upload. Benchmark Results ingestion requires a Benchmark Run payload and no longer writes /api/test-results."
+    );
   }
 };
 
@@ -735,16 +372,16 @@ function classifySeed(value) {
   if (trimmed.startsWith("./") || trimmed.startsWith("../") || trimmed.startsWith("/")) {
     const ext = extname(trimmed).toLowerCase();
     if (ext === ".json") return { type: "file", path: trimmed, format: "json" };
-    if (ext === ".md") return { type: "file", path: trimmed, format: "markdown" };
+    if (ext === ".sql") return { type: "file", path: trimmed, format: "sql" };
     throw new Error(
-      `Seed file must be .json or .md, got "${ext || "(no extension)"}": ${trimmed}
+      `Seed file must be .json or .sql, got "${ext || "(no extension)"}": ${trimmed}
   .json \u2192 exact clone state loaded directly
-  .md   \u2192 plain-English description, Archal generates the state`
+  .sql  \u2192 SQL state loaded through the clone state boundary`
     );
   }
-  if (trimmed.endsWith(".json") || trimmed.endsWith(".md")) {
+  if (trimmed.endsWith(".json") || trimmed.endsWith(".sql")) {
     const ext = extname(trimmed).toLowerCase();
-    const format = ext === ".json" ? "json" : "markdown";
+    const format = ext === ".json" ? "json" : "sql";
     return { type: "file", path: trimmed, format };
   }
   return { type: "named", name: trimmed };
@@ -926,11 +563,6 @@ function archalVitestProject(options, testOptions = {}) {
   const test = buildTestConfig(options, testOptions);
   return defineProject({ test });
 }
-function archalVitestConfig(options, testOptions = {}) {
-  const built = buildTestConfig(options, testOptions);
-  built.reporters = ["default", new ArchalReporter()];
-  return built;
-}
 function archalVitestRootConfig() {
   markHelperCalled();
   return {
@@ -991,7 +623,6 @@ function archalVitestWorkspace(projects) {
 }
 export {
   ArchalReporter,
-  archalVitestConfig,
   archalVitestProject,
   archalVitestRootConfig,
   archalVitestWorkspace,