@kirrosh/zond 0.22.0 → 0.23.0

package/src/cli/commands/probe-methods.ts

@@ -1,108 +0,0 @@
-import { join } from "path";
-import { mkdir } from "fs/promises";
-import {
-  readOpenApiSpec,
-  extractEndpoints,
-  extractSecuritySchemes,
-  serializeSuite,
-} from "../../core/generator/index.ts";
-import { filterByTag } from "../../core/generator/chunker.ts";
-import { generateMethodProbes } from "../../core/probe/method-probe.ts";
-import { printError, printSuccess } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-
-export interface ProbeMethodsOptions {
-  specPath: string;
-  output: string;
-  tag?: string;
-  json?: boolean;
-}
-
-export async function probeMethodsCommand(
-  options: ProbeMethodsOptions,
-): Promise<number> {
-  try {
-    const doc = await readOpenApiSpec(options.specPath);
-    let endpoints = extractEndpoints(doc);
-    const securitySchemes = extractSecuritySchemes(doc);
-
-    if (options.tag) endpoints = filterByTag(endpoints, options.tag);
-
-    if (endpoints.length === 0) {
-      const message = "No endpoints to probe.";
-      if (options.json) {
-        printJson(jsonOk("probe-methods", { files: [], message }));
-      } else {
-        console.log(message);
-      }
-      return 0;
-    }
-
-    const result = generateMethodProbes({
-      endpoints,
-      securitySchemes,
-    });
-
-    if (result.suites.length === 0) {
-      const message =
-        "Every path declares all of GET/POST/PUT/PATCH/DELETE — nothing to probe.";
-      if (options.json) {
-        printJson(
-          jsonOk("probe-methods", {
-            files: [],
-            probedPaths: 0,
-            skippedPaths: result.skippedPaths,
-            totalProbes: 0,
-            message,
-          }),
-        );
-      } else {
-        console.log(message);
-      }
-      return 0;
-    }
-
-    await mkdir(options.output, { recursive: true });
-
-    const created: Array<{ file: string; suite: string; tests: number }> = [];
-    for (const suite of result.suites) {
-      const fileName = `${suite.fileStem ?? suite.name}.yaml`;
-      const filePath = join(options.output, fileName);
-      await Bun.write(filePath, serializeSuite(suite));
-      created.push({ file: filePath, suite: suite.name, tests: suite.tests.length });
-    }
-
-    if (options.json) {
-      printJson(
-        jsonOk("probe-methods", {
-          files: created,
-          probedPaths: result.probedPaths,
-          skippedPaths: result.skippedPaths,
-          totalProbes: result.totalProbes,
-          outputDir: options.output,
-        }),
-      );
-    } else {
-      printSuccess(
-        `Generated ${result.suites.length} method-probe suite(s) with ${result.totalProbes} probe(s) in ${options.output}`,
-      );
-      console.log(
-        `  ${result.probedPaths} path(s) probed, ${result.skippedPaths} skipped (full method coverage)`,
-      );
-      console.log("");
-      console.log("Next steps:");
-      console.log(`  zond run ${options.output} --report json   # any 5xx or 2xx → bug candidate`);
-      console.log(`  zond db diagnose <run-id>                  # inspect failures`);
-    }
-
-    return 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("probe-methods", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}

package/src/cli/commands/probe-validation.ts

@@ -1,124 +0,0 @@
-import { join } from "path";
-import { mkdir } from "fs/promises";
-import {
-  readOpenApiSpec,
-  extractEndpoints,
-  extractSecuritySchemes,
-  serializeSuite,
-} from "../../core/generator/index.ts";
-import { filterByTag, collectTags } from "../../core/generator/chunker.ts";
-import { generateNegativeProbes } from "../../core/probe/negative-probe.ts";
-import { printError, printSuccess, printWarning } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-
-export interface ProbeValidationOptions {
-  specPath: string;
-  output: string;
-  tag?: string;
-  maxPerEndpoint?: number;
-  noCleanup?: boolean;
-  json?: boolean;
-  listTags?: boolean;
-}
-
-export async function probeValidationCommand(
-  options: ProbeValidationOptions,
-): Promise<number> {
-  try {
-    const doc = await readOpenApiSpec(options.specPath);
-    const allEndpoints = extractEndpoints(doc);
-    const securitySchemes = extractSecuritySchemes(doc);
-
-    if (options.listTags) {
-      const tags = collectTags(allEndpoints);
-      if (options.json) {
-        printJson(jsonOk("probe-validation", { tags }));
-      } else {
-        if (tags.length === 0) {
-          console.log("No tags found in spec.");
-        } else {
-          console.log("Available tags:");
-          for (const t of tags) console.log(`  - ${t}`);
-        }
-      }
-      return 0;
-    }
-
-    let endpoints = allEndpoints;
-    if (options.tag) {
-      endpoints = filterByTag(allEndpoints, options.tag);
-      if (endpoints.length === 0) {
-        const available = collectTags(allEndpoints);
-        const msg = `No endpoints tagged "${options.tag}". Available tags: ${available.length ? available.join(", ") : "(none)"}`;
-        if (options.json) {
-          printJson(jsonError("probe-validation", [msg]));
-        } else {
-          printWarning(msg);
-        }
-        return 2;
-      }
-    }
-
-    if (endpoints.length === 0) {
-      const message = "No endpoints to probe.";
-      if (options.json) {
-        printJson(jsonOk("probe-validation", { files: [], message }));
-      } else {
-        console.log(message);
-      }
-      return 0;
-    }
-
-    const result = generateNegativeProbes({
-      endpoints,
-      securitySchemes,
-      maxProbesPerEndpoint: options.maxPerEndpoint,
-      noCleanup: options.noCleanup,
-    });
-
-    await mkdir(options.output, { recursive: true });
-
-    const created: Array<{ file: string; suite: string; tests: number }> = [];
-    for (const suite of result.suites) {
-      const fileName = `${suite.fileStem ?? suite.name}.yaml`;
-      const filePath = join(options.output, fileName);
-      await Bun.write(filePath, serializeSuite(suite));
-      created.push({ file: filePath, suite: suite.name, tests: suite.tests.length });
-    }
-
-    if (options.json) {
-      printJson(
-        jsonOk("probe-validation", {
-          files: created,
-          probedEndpoints: result.probedEndpoints,
-          skippedEndpoints: result.skippedEndpoints,
-          totalProbes: result.totalProbes,
-          outputDir: options.output,
-          warnings: result.warnings,
-        }),
-      );
-    } else {
-      printSuccess(
-        `Generated ${result.suites.length} probe suite(s) with ${result.totalProbes} probe(s) in ${options.output}`,
-      );
-      console.log(
-        `  ${result.probedEndpoints} endpoint(s) probed, ${result.skippedEndpoints} skipped (no probable surface)`,
-      );
-      for (const w of result.warnings) printWarning(w);
-      console.log("");
-      console.log("Next steps:");
-      console.log(`  zond run ${options.output} --report json   # any 5xx → bug candidate`);
-      console.log(`  zond db diagnose <run-id>                  # inspect failures`);
-    }
-
-    return 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("probe-validation", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}

package/src/cli/commands/serve.ts

@@ -1,114 +0,0 @@
-import { startServer } from "../../web/server.ts";
-import { printError } from "../output.ts";
-
-export interface ServeOptions {
-  port?: number;
-  host?: string;
-  dbPath?: string;
-  watch?: boolean;
-  open?: boolean;
-  /** When true, kill any existing process holding `port` before binding (DANGEROUS). */
-  killExisting?: boolean;
-}
-
-/** Range scanned when auto-picking a free port (only when --port is not set). */
-const PORT_SCAN_LENGTH = 11; // 8080..8090 inclusive
-
-/** Kill any existing process listening on the given port (Windows + Unix). */
-async function killPortHolder(port: number): Promise<void> {
-  const isWin = process.platform === "win32";
-  try {
-    if (isWin) {
-      const find = Bun.spawn(["powershell", "-NoProfile", "-Command",
-        `(Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue).OwningProcess`], {
-        stdout: "pipe", stderr: "ignore",
-      });
-      const out = await new Response(find.stdout).text();
-      const pids = [...new Set(out.trim().split(/\s+/).filter(s => /^\d+$/.test(s) && s !== "0"))];
-      for (const pid of pids) {
-        Bun.spawn(["powershell", "-NoProfile", "-Command",
-          `Stop-Process -Id ${pid} -Force -ErrorAction SilentlyContinue`], {
-          stdout: "ignore", stderr: "ignore",
-        });
-      }
-      if (pids.length > 0) await Bun.sleep(500);
-    } else {
-      const find = Bun.spawn(["lsof", "-ti", `:${port}`], {
-        stdout: "pipe", stderr: "ignore",
-      });
-      const out = await new Response(find.stdout).text();
-      const pids = out.trim().split(/\s+/).filter(s => /^\d+$/.test(s));
-      for (const pid of pids) {
-        Bun.spawn(["kill", "-9", pid], { stdout: "ignore", stderr: "ignore" });
-      }
-      if (pids.length > 0) await Bun.sleep(300);
-    }
-  } catch {
-    // Best effort — if we can't kill, the bind below will fail with port-in-use
-  }
-}
-
-/** Returns true if `port` is free on `host` (best-effort: tries to bind & immediately stops). */
-async function isPortFree(port: number, host: string): Promise<boolean> {
-  try {
-    const srv = Bun.serve({ port, hostname: host, fetch: () => new Response() });
-    srv.stop(true);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/** Scans `[start, start+count)` and returns the first free port, or null. */
-async function pickAvailablePort(start: number, count: number, host: string): Promise<number | null> {
-  for (let p = start; p < start + count; p++) {
-    if (await isPortFree(p, host)) return p;
-  }
-  return null;
-}
-
-export async function serveCommand(options: ServeOptions): Promise<number> {
-  const requested = options.port ?? 8080;
-  const host = options.host ?? "0.0.0.0";
-
-  let port: number;
-  if (options.killExisting) {
-    await killPortHolder(requested);
-    port = requested;
-  } else {
-    const picked = await pickAvailablePort(requested, PORT_SCAN_LENGTH, host);
-    if (picked === null) {
-      printError(
-        `All ports ${requested}..${requested + PORT_SCAN_LENGTH - 1} are in use. ` +
-        `Use --port <n> to pick another, or --kill-existing to free :${requested}.`,
-      );
-      return 1;
-    }
-    if (picked !== requested) {
-      process.stderr.write(`[zond] port ${requested} busy, using ${picked}\n`);
-    }
-    port = picked;
-  }
-
-  await startServer({
-    port,
-    host: options.host,
-    dbPath: options.dbPath,
-    dev: options.watch,
-  });
-
-  if (options.open) {
-    const openHost = host === "0.0.0.0" ? "localhost" : host;
-    const url = `http://${openHost}:${port}`;
-    try {
-      const cmd = process.platform === "win32" ? ["cmd", "/c", "start", url]
-        : process.platform === "darwin" ? ["open", url]
-        : ["xdg-open", url];
-      Bun.spawn(cmd, { stdout: "ignore", stderr: "ignore" });
-    } catch {
-      // Best effort
-    }
-  }
-
-  return 0;
-}

package/src/cli/commands/sync.ts

@@ -1,268 +0,0 @@
-import { join } from "path";
-import { mkdir } from "fs/promises";
-import {
-  readOpenApiSpec,
-  extractEndpoints,
-  extractSecuritySchemes,
-  serializeSuite,
-  buildCatalog,
-  serializeCatalog,
-} from "../../core/generator/index.ts";
-import { generateSuites } from "../../core/generator/suite-generator.ts";
-import { filterByTag } from "../../core/generator/chunker.ts";
-import { readMeta, writeMeta, hashSpec, buildFileMeta } from "../../core/meta/meta-store.ts";
-import { diffEndpoints } from "../../core/sync/spec-differ.ts";
-import { decycleSchema } from "../../core/generator/schema-utils.ts";
-import { printError, printSuccess, printWarning } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-import { version as ZOND_VERSION } from "../../../package.json";
-import { getDb } from "../../db/schema.ts";
-import { findCollectionByTestPath, updateCollection } from "../../db/queries.ts";
-
-export interface SyncOptions {
-  specPath: string;
-  testsDir: string;
-  dryRun?: boolean;
-  tag?: string;
-  json?: boolean;
-}
-
-export async function syncCommand(options: SyncOptions): Promise<number> {
-  try {
-    // Load existing metadata
-    const meta = await readMeta(options.testsDir);
-    if (!meta) {
-      const msg =
-        "No .zond-meta.json found. Run `zond generate <spec> --output <dir>` first to initialize metadata.";
-      if (options.json) {
-        printJson(jsonError("sync", [msg]));
-      } else {
-        printError(msg);
-      }
-      return 2;
-    }
-
-    // Load current spec
-    const doc = await readOpenApiSpec(options.specPath);
-    const specContent = JSON.stringify(decycleSchema(doc));
-    const currentHash = hashSpec(specContent);
-
-    if (currentHash === meta.specHash) {
-      const msg = "Spec unchanged — nothing to sync.";
-      if (options.json) {
-        printJson(jsonOk("sync", { newEndpoints: [], generatedFiles: [], removedKeys: [], specChanged: false }, [msg]));
-      } else {
-        console.log(msg);
-      }
-      return 0;
-    }
-
-    // Extract current endpoints
-    let currentEndpoints = extractEndpoints(doc);
-    const securitySchemes = extractSecuritySchemes(doc);
-
-    if (options.tag) {
-      currentEndpoints = filterByTag(currentEndpoints, options.tag);
-    }
-
-    // Collect all previously known endpoint keys from meta
-    const prevKeys = Object.values(meta.files).flatMap((f) => f.endpoints);
-
-    // Compute diff
-    const { newEndpoints, removedKeys } = diffEndpoints(prevKeys, currentEndpoints);
-
-    const warnings: string[] = [];
-
-    if (removedKeys.length > 0) {
-      for (const key of removedKeys) {
-        warnings.push(`Removed endpoint not deleted from tests (review manually): ${key}`);
-      }
-    }
-
-    if (newEndpoints.length === 0) {
-      // Update catalog even when no new endpoints — spec schema may have changed
-      const allEndpoints = extractEndpoints(doc);
-      const catalog = buildCatalog({
-        endpoints: allEndpoints,
-        securitySchemes,
-        specSource: options.specPath,
-        specHash: currentHash,
-        apiName: (doc as any).info?.title,
-        apiVersion: (doc as any).info?.version,
-        baseUrl: (doc as any).servers?.[0]?.url,
-      });
-      await Bun.write(join(options.testsDir, ".api-catalog.yaml"), serializeCatalog(catalog));
-
-      const msg = "Spec changed (hash differs) but no new endpoints detected. Existing tests may need manual review.";
-      warnings.push(msg);
-      if (options.json) {
-        printJson(jsonOk("sync", {
-          newEndpoints: [],
-          removedKeys,
-          generatedFiles: [],
-          specChanged: true,
-        }, warnings));
-      } else {
-        console.log(msg);
-        for (const w of warnings) {
-          printWarning(w);
-        }
-      }
-      return 0;
-    }
-
-    // Generate suites for new endpoints only
-    const suites = generateSuites({ endpoints: newEndpoints, securitySchemes });
-
-    if (options.dryRun) {
-      const newEndpointKeys = newEndpoints.map((ep) => `${ep.method.toUpperCase()} ${ep.path}`);
-      const plannedFiles = suites.map((s) => ({
-        file: `${s.fileStem ?? s.name}.yaml`,
-        suite: s.name,
-        tests: s.tests.length,
-      }));
-
-      if (options.json) {
-        printJson(jsonOk("sync", {
-          dryRun: true,
-          newEndpoints: newEndpointKeys,
-          removedKeys,
-          plannedFiles,
-          specChanged: true,
-        }, warnings));
-      } else {
-        console.log(`[dry-run] Detected ${newEndpoints.length} new endpoint(s):`);
-        for (const ep of newEndpoints) {
-          console.log(`  + ${ep.method.toUpperCase()} ${ep.path}`);
-        }
-        console.log(`\nWould generate ${suites.length} new suite file(s):`);
-        for (const f of plannedFiles) {
-          console.log(`  ${f.file}  (${f.tests} tests)`);
-        }
-        if (removedKeys.length > 0) {
-          console.log("\nRemoved endpoints (not deleted — review tests):");
-          for (const key of removedKeys) {
-            console.log(`  - ${key}`);
-          }
-        }
-        console.log("\nNo files written (dry-run).");
-      }
-      return 0;
-    }
-
-    // Write new files (skip if file already exists)
-    await mkdir(options.testsDir, { recursive: true });
-
-    const generatedFiles: Array<{ file: string; suite: string; tests: number }> = [];
-    const skippedFiles: string[] = [];
-    const updatedMetaFiles: Record<string, import("../../core/meta/types.ts").FileMeta> = {};
-
-    for (const suite of suites) {
-      const fileName = `${suite.fileStem ?? suite.name}.yaml`;
-      const filePath = join(options.testsDir, fileName);
-      const existing = Bun.file(filePath);
-
-      if (await existing.exists()) {
-        skippedFiles.push(fileName);
-        warnings.push(`Skipped ${fileName} (already exists — add new endpoints manually)`);
-        continue;
-      }
-
-      const yaml = serializeSuite(suite);
-      await Bun.write(filePath, yaml);
-      generatedFiles.push({ file: filePath, suite: suite.name, tests: suite.tests.length });
-      updatedMetaFiles[fileName] = buildFileMeta(suite, ZOND_VERSION);
-    }
-
-    // Update metadata: merge new file entries, update hash and timestamp
-    await writeMeta(options.testsDir, {
-      zondVersion: ZOND_VERSION,
-      lastSyncedAt: new Date().toISOString(),
-      specHash: currentHash,
-      files: { ...meta.files, ...updatedMetaFiles },
-    });
-
-    // Update .api-catalog.yaml with current spec state
-    const allEndpoints = extractEndpoints(doc);
-    const catalog = buildCatalog({
-      endpoints: allEndpoints,
-      securitySchemes,
-      specSource: options.specPath,
-      specHash: currentHash,
-      apiName: (doc as any).info?.title,
-      apiVersion: (doc as any).info?.version,
-      baseUrl: (doc as any).servers?.[0]?.url,
-    });
-    await Bun.write(join(options.testsDir, ".api-catalog.yaml"), serializeCatalog(catalog));
-
-    // Sync DB collection if one is registered for this tests directory
-    try {
-      getDb();
-      const collection = findCollectionByTestPath(options.testsDir);
-      if (collection && collection.openapi_spec !== options.specPath) {
-        updateCollection(collection.id, { openapi_spec: options.specPath });
-        warnings.push(`Updated collection '${collection.name}' spec reference: ${collection.openapi_spec ?? "(none)"} → ${options.specPath}`);
-      }
-    } catch {
-      // DB unavailable (e.g. no zond.db yet) — not a fatal error for sync
-    }
-
-    const newEndpointKeys = newEndpoints.map((ep) => `${ep.method.toUpperCase()} ${ep.path}`);
-
-    if (options.json) {
-      printJson(jsonOk("sync", {
-        newEndpoints: newEndpointKeys,
-        removedKeys,
-        generatedFiles,
-        skippedFiles,
-        specChanged: true,
-      }, warnings));
-    } else {
-      console.log(`Spec changed. Detected ${newEndpoints.length} new endpoint(s):`);
-      for (const ep of newEndpoints) {
-        console.log(`  + ${ep.method.toUpperCase()} ${ep.path}`);
-      }
-
-      if (generatedFiles.length > 0) {
-        console.log(`\nGenerated ${generatedFiles.length} new suite file(s):`);
-        for (const f of generatedFiles) {
-          console.log(`  ${f.file}  (${f.tests} tests)`);
-        }
-      }
-
-      if (skippedFiles.length > 0) {
-        console.log("\nSkipped (file exists, review manually):");
-        for (const f of skippedFiles) {
-          console.log(`  ${f}`);
-        }
-      }
-
-      if (removedKeys.length > 0) {
-        console.log("\nRemoved endpoints (not deleted — review tests):");
-        for (const key of removedKeys) {
-          console.log(`  - ${key}`);
-        }
-      }
-
-      if (generatedFiles.length > 0) {
-        printSuccess(`\nSync complete. ${generatedFiles.length} file(s) written.`);
-      } else {
-        printWarning("No new files written — all target files already exist.");
-      }
-
-      for (const w of warnings) {
-        printWarning(w);
-      }
-    }
-
-    return 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("sync", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}