@iowarp/clio-coder 0.3.1 → 0.3.3

package/dist/verify-375KUB3Y.js

@@ -0,0 +1,716 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  BROWSER_MODES,
+  maxOutputArg,
+  prepareVerifyArguments,
+  runVectorTool,
+  timeoutArg,
+  verifyToolSurface
+} from "./chunk-TZK7PACC.js";
+import {
+  VERIFICATION_SCRIPT_FAMILY_HINT,
+  declaredVerificationScripts,
+  isVerificationScriptName
+} from "./chunk-7MNJORFF.js";
+import {
+  escapeRegExp
+} from "./chunk-VG7TBQIY.js";
+import {
+  resolveReadPath
+} from "./chunk-OQE5J4C6.js";
+import "./chunk-ECH6PKUQ.js";
+import {
+  truncateUtf8
+} from "./chunk-6XLNIQDB.js";
+import "./chunk-5B2AEOW5.js";
+import "./chunk-CGKSTWHD.js";
+import {
+  combineSafeOutput,
+  resolveSafeCwd,
+  runCommandVector
+} from "./chunk-VPAYEGVX.js";
+import "./chunk-COU2UHX6.js";
+import "./chunk-FQ4SKYE4.js";
+import "./chunk-FCSXB6T2.js";
+import "./chunk-YXLYO42X.js";
+import "./chunk-BNAZZHFG.js";
+import "./chunk-6EJMN2Y3.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/tools/verify/index.ts
+init_esm_shims();
+
+// src/tools/verify/frontend.ts
+init_esm_shims();
+import { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { Script } from "node:vm";
+var VOID_HTML_TAGS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+var RAW_TEXT_TAGS = /* @__PURE__ */ new Set(["script", "style", "textarea", "title"]);
+var OPTIONAL_END_TAGS = /* @__PURE__ */ new Set([
+  "li",
+  "dt",
+  "dd",
+  "p",
+  "td",
+  "th",
+  "tr",
+  "thead",
+  "tbody",
+  "tfoot",
+  "option",
+  "optgroup",
+  "caption",
+  "colgroup",
+  "rp",
+  "rt"
+]);
+var JAVASCRIPT_TYPES = /* @__PURE__ */ new Set([
+  "",
+  "module",
+  "text/javascript",
+  "application/javascript",
+  "application/ecmascript",
+  "text/ecmascript"
+]);
+async function runFrontendCheck(args, options) {
+  const pathArg = typeof args.path === "string" ? args.path.trim() : "";
+  if (pathArg.length === 0) return { kind: "error", message: "verify: check=frontend requires a path argument" };
+  let artifactPath;
+  try {
+    artifactPath = resolveReadPath(pathArg);
+  } catch (err) {
+    return { kind: "error", message: `verify: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  if (!isInsideWorkspace(artifactPath)) {
+    return { kind: "error", message: `verify: path escapes workspace root: ${artifactPath}` };
+  }
+  if (!existsSync(artifactPath)) return { kind: "error", message: `verify: file not found: ${artifactPath}` };
+  if (!statSync(artifactPath).isFile()) return { kind: "error", message: `verify: not a file: ${artifactPath}` };
+  const browserMode = browserModeArg(args.browser);
+  const validateOptions = {
+    timeoutMs: timeoutArg(args),
+    maxOutputBytes: maxOutputArg(args)
+  };
+  if (options?.signal !== void 0) validateOptions.signal = options.signal;
+  const checks = [];
+  try {
+    await validateArtifact(artifactPath, checks, browserMode, validateOptions);
+  } catch (err) {
+    checks.push({
+      name: "validation",
+      status: "fail",
+      message: err instanceof Error ? err.message : String(err),
+      path: artifactPath
+    });
+  }
+  const failed = checks.filter((check) => check.status === "fail");
+  const details = resultDetails(artifactPath, browserMode, checks);
+  const output = renderChecks(artifactPath, checks);
+  if (failed.length > 0) {
+    return {
+      kind: "error",
+      message: `verify: ${failed.length} frontend check${failed.length === 1 ? "" : "s"} failed
+${output}`,
+      details
+    };
+  }
+  return { kind: "ok", output, details };
+}
+async function validateArtifact(artifactPath, checks, browserMode, options) {
+  const ext = path.extname(artifactPath).toLowerCase();
+  const content = readFileSync(artifactPath, "utf8");
+  if (ext === ".html" || ext === ".htm") {
+    await validateHtml(artifactPath, content, checks, browserMode, options);
+    return;
+  }
+  if (ext === ".css") {
+    validateCss(content, `${artifactPath}`, checks, artifactPath);
+    return;
+  }
+  if (isJavaScriptPath(artifactPath)) {
+    await validateJavaScriptFile(artifactPath, content, checks, options);
+    return;
+  }
+  checks.push({
+    name: "artifact type",
+    status: "fail",
+    message: "expected an .html, .htm, .css, .js, .mjs, or .cjs artifact",
+    path: artifactPath
+  });
+}
+async function validateHtml(artifactPath, content, checks, browserMode, options) {
+  validateHtmlStructure(content, checks, artifactPath);
+  await validateHtmlScripts(artifactPath, content, checks, options);
+  validateHtmlStyles(artifactPath, content, checks);
+  await validateBrowserLoad(artifactPath, browserMode, checks, options);
+}
+function validateHtmlStructure(content, checks, artifactPath) {
+  const scan = content.replace(/<!--[\s\S]*?-->/g, (m) => m.replace(/[^\n]/g, " "));
+  const tagRe = /<\/?\s*([a-zA-Z][\w:-]*)(?:\s[^<>]*)?>/g;
+  const stack = [];
+  for (let match = tagRe.exec(scan); match !== null; match = tagRe.exec(scan)) {
+    const raw = match[0];
+    if (/^<!|^<\?/u.test(raw)) continue;
+    const tag = (match[1] ?? "").toLowerCase();
+    const isClosing = /^<\//u.test(raw);
+    const selfClosing = /\/\s*>$/u.test(raw) || VOID_HTML_TAGS.has(tag);
+    if (isClosing) {
+      while (stack.length > 0 && stack[stack.length - 1]?.tag !== tag && OPTIONAL_END_TAGS.has(stack[stack.length - 1]?.tag ?? "")) {
+        stack.pop();
+      }
+      const last = stack[stack.length - 1];
+      if (last && last.tag === tag) {
+        stack.pop();
+        continue;
+      }
+      if (OPTIONAL_END_TAGS.has(tag)) continue;
+      const expected = last ? ` expected </${last.tag}> from line ${last.line}` : "";
+      checks.push({
+        name: "html structure",
+        status: "fail",
+        message: `unexpected </${tag}> on line ${lineAt(scan, match.index)}${expected}`,
+        path: artifactPath
+      });
+      return;
+    }
+    if (selfClosing) continue;
+    if (RAW_TEXT_TAGS.has(tag)) {
+      const closeRe = new RegExp(`</\\s*${escapeRegExp(tag)}\\s*>`, "giu");
+      closeRe.lastIndex = tagRe.lastIndex;
+      const close = closeRe.exec(scan);
+      if (!close) {
+        checks.push({
+          name: "html structure",
+          status: "fail",
+          message: `missing </${tag}> for opening tag on line ${lineAt(scan, match.index)}`,
+          path: artifactPath
+        });
+        return;
+      }
+      tagRe.lastIndex = close.index + close[0].length;
+      continue;
+    }
+    stack.push({ tag, line: lineAt(scan, match.index) });
+  }
+  while (stack.length > 0 && OPTIONAL_END_TAGS.has(stack[stack.length - 1]?.tag ?? "")) {
+    stack.pop();
+  }
+  const unclosed = stack.pop();
+  if (unclosed) {
+    checks.push({
+      name: "html structure",
+      status: "fail",
+      message: `missing </${unclosed.tag}> for opening tag on line ${unclosed.line}`,
+      path: artifactPath
+    });
+    return;
+  }
+  checks.push({ name: "html structure", status: "pass", message: "tag structure is balanced", path: artifactPath });
+}
+async function validateHtmlScripts(artifactPath, content, checks, options) {
+  const scriptRe = /<script\b([^>]*)>([\s\S]*?)<\/script\s*>/giu;
+  let count = 0;
+  for (let match = scriptRe.exec(content); match !== null; match = scriptRe.exec(content)) {
+    count += 1;
+    const attrs = parseAttributes(match[1] ?? "");
+    const type = normalizeScriptType(attrs.type);
+    const src = attrs.src;
+    if (src !== void 0) {
+      if (!JAVASCRIPT_TYPES.has(type)) {
+        checks.push({ name: "script reference", status: "skip", message: `non-JavaScript script type skipped: ${type}` });
+        continue;
+      }
+      const local = resolveLocalReference(artifactPath, src);
+      if (local === null) {
+        checks.push({
+          name: "script reference",
+          status: "skip",
+          message: `external or root-relative script skipped: ${src}`
+        });
+        continue;
+      }
+      if (!isInsideWorkspace(local)) {
+        checks.push({
+          name: "script reference",
+          status: "fail",
+          message: `script escapes workspace root: ${src}`,
+          path: local
+        });
+        continue;
+      }
+      if (!existsSync(local)) {
+        checks.push({ name: "script reference", status: "fail", message: `script not found: ${src}`, path: local });
+        continue;
+      }
+      await validateJavaScriptFile(local, readFileSync(local, "utf8"), checks, options);
+      continue;
+    }
+    if (!JAVASCRIPT_TYPES.has(type)) {
+      checks.push({ name: "inline script", status: "skip", message: `non-JavaScript script type skipped: ${type}` });
+      continue;
+    }
+    const source = (match[2] ?? "").trim();
+    if (source.length === 0) {
+      checks.push({ name: "inline script", status: "skip", message: `inline script ${count} is empty` });
+      continue;
+    }
+    await validateJavaScript(
+      source,
+      type === "module" ? "module" : "script",
+      `${artifactPath} inline script ${count}`,
+      checks,
+      options,
+      artifactPath
+    );
+  }
+  if (count === 0)
+    checks.push({ name: "script validation", status: "skip", message: "no script tags found", path: artifactPath });
+}
+function validateHtmlStyles(artifactPath, content, checks) {
+  const styleRe = /<style\b[^>]*>([\s\S]*?)<\/style\s*>/giu;
+  let styleCount = 0;
+  for (let styleMatch = styleRe.exec(content); styleMatch !== null; styleMatch = styleRe.exec(content)) {
+    styleCount += 1;
+    validateCss(styleMatch[1] ?? "", `${artifactPath} inline style ${styleCount}`, checks, artifactPath);
+  }
+  const linkRe = /<link\b([^>]*)>/giu;
+  let stylesheetCount = 0;
+  for (let linkMatch = linkRe.exec(content); linkMatch !== null; linkMatch = linkRe.exec(content)) {
+    const attrs = parseAttributes(linkMatch[1] ?? "");
+    if (!isStylesheetLink(attrs)) continue;
+    stylesheetCount += 1;
+    const href = attrs.href;
+    if (href === void 0) {
+      checks.push({
+        name: "stylesheet reference",
+        status: "fail",
+        message: "stylesheet link is missing href",
+        path: artifactPath
+      });
+      continue;
+    }
+    const local = resolveLocalReference(artifactPath, href);
+    if (local === null) {
+      checks.push({
+        name: "stylesheet reference",
+        status: "skip",
+        message: `external or root-relative stylesheet skipped: ${href}`
+      });
+      continue;
+    }
+    if (!isInsideWorkspace(local)) {
+      checks.push({
+        name: "stylesheet reference",
+        status: "fail",
+        message: `stylesheet escapes workspace root: ${href}`,
+        path: local
+      });
+      continue;
+    }
+    if (!existsSync(local)) {
+      checks.push({ name: "stylesheet reference", status: "fail", message: `stylesheet not found: ${href}`, path: local });
+      continue;
+    }
+    validateCss(readFileSync(local, "utf8"), `${local}`, checks, local);
+  }
+  if (styleCount === 0 && stylesheetCount === 0) {
+    checks.push({
+      name: "style validation",
+      status: "skip",
+      message: "no style tags or stylesheet links found",
+      path: artifactPath
+    });
+  }
+}
+async function validateJavaScriptFile(filePath, content, checks, options) {
+  const ext = path.extname(filePath).toLowerCase();
+  if (ext === ".mjs") {
+    await validateJavaScript(content, "module", filePath, checks, options, filePath);
+    return;
+  }
+  if (ext === ".cjs") {
+    await validateJavaScript(content, "script", filePath, checks, options, filePath);
+    return;
+  }
+  const scriptCheck = checkClassicJavaScript(content, filePath);
+  if (scriptCheck === null) {
+    checks.push({ name: "javascript syntax", status: "pass", message: "classic script syntax is valid", path: filePath });
+    return;
+  }
+  const moduleCheck = await checkModuleJavaScript(content, filePath, options);
+  if (moduleCheck === null) {
+    checks.push({ name: "javascript syntax", status: "pass", message: "module syntax is valid", path: filePath });
+    return;
+  }
+  checks.push({
+    name: "javascript syntax",
+    status: "fail",
+    message: `script parse failed: ${scriptCheck}; module parse failed: ${moduleCheck}`,
+    path: filePath
+  });
+}
+async function validateJavaScript(source, mode, label, checks, options, filePath) {
+  const error = mode === "module" ? await checkModuleJavaScript(source, label, options) : checkClassicJavaScript(source, label);
+  if (error === null) {
+    checks.push({
+      name: "javascript syntax",
+      status: "pass",
+      message: `${mode} syntax is valid: ${label}`,
+      ...filePath !== void 0 ? { path: filePath } : {}
+    });
+    return;
+  }
+  checks.push({
+    name: "javascript syntax",
+    status: "fail",
+    message: `${mode} syntax error in ${label}: ${error}`,
+    ...filePath !== void 0 ? { path: filePath } : {}
+  });
+}
+function checkClassicJavaScript(source, label) {
+  try {
+    new Script(source, { filename: label });
+    return null;
+  } catch (err) {
+    return err instanceof Error ? err.message : String(err);
+  }
+}
+async function checkModuleJavaScript(source, label, options) {
+  const dir = mkdtempSync(path.join(tmpdir(), "clio-frontend-check-"));
+  const file = path.join(dir, "module.mjs");
+  try {
+    writeFileSync(file, source, "utf8");
+    const result = await runCommandVector(process.execPath, ["--check", file], {
+      timeoutMs: options.timeoutMs,
+      maxOutputBytes: options.maxOutputBytes,
+      ...options.signal !== void 0 ? { signal: options.signal } : {}
+    });
+    if (result.exitCode === 0 && !result.timedOut && !result.aborted && !result.outputCapped) return null;
+    return `${label}: ${truncateUtf8(combineSafeOutput(result).trim(), 600, " [truncated]") || "node --check failed"}`;
+  } catch (err) {
+    return err instanceof Error ? err.message : String(err);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+function validateCss(source, label, checks, filePath) {
+  let depth = 0;
+  let quote = null;
+  let escaped = false;
+  let inComment = false;
+  for (let index = 0; index < source.length; index += 1) {
+    const char = source[index];
+    const next = source[index + 1];
+    if (inComment) {
+      if (char === "*" && next === "/") {
+        inComment = false;
+        index += 1;
+      }
+      continue;
+    }
+    if (quote !== null) {
+      if (escaped) {
+        escaped = false;
+        continue;
+      }
+      if (char === "\\") {
+        escaped = true;
+        continue;
+      }
+      if (char === quote) quote = null;
+      continue;
+    }
+    if (char === "/" && next === "*") {
+      inComment = true;
+      index += 1;
+      continue;
+    }
+    if (char === "'" || char === '"') {
+      quote = char;
+      continue;
+    }
+    if (char === "{") depth += 1;
+    if (char === "}") {
+      if (depth === 0) {
+        checks.push({
+          name: "css syntax",
+          status: "fail",
+          message: `unexpected } in ${label} on line ${lineAt(source, index)}`,
+          path: filePath
+        });
+        return;
+      }
+      depth -= 1;
+    }
+  }
+  if (inComment) {
+    checks.push({ name: "css syntax", status: "fail", message: `unterminated comment in ${label}`, path: filePath });
+    return;
+  }
+  if (quote !== null) {
+    checks.push({ name: "css syntax", status: "fail", message: `unterminated string in ${label}`, path: filePath });
+    return;
+  }
+  if (depth !== 0) {
+    checks.push({ name: "css syntax", status: "fail", message: `unclosed { block in ${label}`, path: filePath });
+    return;
+  }
+  checks.push({ name: "css syntax", status: "pass", message: `balanced CSS syntax: ${label}`, path: filePath });
+}
+async function validateBrowserLoad(artifactPath, browserMode, checks, options) {
+  if (browserMode === "off") {
+    checks.push({ name: "browser load", status: "skip", message: "browser check disabled", path: artifactPath });
+    return;
+  }
+  const browser = findBrowserExecutable();
+  if (browser === null) {
+    checks.push({
+      name: "browser load",
+      status: browserMode === "required" ? "fail" : "warn",
+      message: "no supported headless browser executable found on PATH",
+      path: artifactPath
+    });
+    return;
+  }
+  const result = await runCommandVector(
+    browser,
+    [
+      "--headless=new",
+      "--disable-gpu",
+      "--no-sandbox",
+      "--disable-dev-shm-usage",
+      "--dump-dom",
+      pathToFileURL(artifactPath).href
+    ],
+    {
+      timeoutMs: options.timeoutMs,
+      maxOutputBytes: options.maxOutputBytes,
+      ...options.signal !== void 0 ? { signal: options.signal } : {}
+    }
+  );
+  if (result.exitCode === 0 && !result.timedOut && !result.aborted && !result.outputCapped) {
+    checks.push({
+      name: "browser load",
+      status: "pass",
+      message: `loaded with ${path.basename(browser)}`,
+      path: artifactPath
+    });
+    return;
+  }
+  const output = truncateUtf8(combineSafeOutput(result).trim(), 800, " [truncated]");
+  checks.push({
+    name: "browser load",
+    status: "fail",
+    message: `headless browser exited with ${result.exitCode ?? result.signal ?? "unknown"}${output ? `: ${output}` : ""}`,
+    path: artifactPath
+  });
+}
+function parseAttributes(source) {
+  const attrs = {};
+  const attrRe = /([^\s"'<>/=]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/g;
+  for (let match = attrRe.exec(source); match !== null; match = attrRe.exec(source)) {
+    const name = (match[1] ?? "").toLowerCase();
+    if (name.length === 0) continue;
+    attrs[name] = match[2] ?? match[3] ?? match[4] ?? "";
+  }
+  return attrs;
+}
+function normalizeScriptType(value) {
+  if (value === void 0) return "";
+  return value.split(";")[0]?.trim().toLowerCase() ?? "";
+}
+function isStylesheetLink(attrs) {
+  const rel = attrs.rel?.toLowerCase().split(/\s+/u) ?? [];
+  return rel.includes("stylesheet");
+}
+function resolveLocalReference(baseFile, raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0 || trimmed.startsWith("#")) return null;
+  if (/^(?:[a-z][a-z0-9+.-]*:)?\/\//iu.test(trimmed)) return null;
+  if (/^(?:data|mailto|tel|javascript):/iu.test(trimmed)) return null;
+  if (trimmed.startsWith("/")) return null;
+  const withoutFragment = trimmed.split("#")[0] ?? "";
+  const withoutQuery = withoutFragment.split("?")[0] ?? "";
+  if (withoutQuery.length === 0) return null;
+  try {
+    return path.resolve(path.dirname(baseFile), decodeURIComponent(withoutQuery));
+  } catch {
+    return path.resolve(path.dirname(baseFile), withoutQuery);
+  }
+}
+function isJavaScriptPath(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return ext === ".js" || ext === ".mjs" || ext === ".cjs";
+}
+function isInsideWorkspace(filePath) {
+  const rel = path.relative(process.cwd(), filePath);
+  return rel === "" || !rel.startsWith("..") && !path.isAbsolute(rel);
+}
+function browserModeArg(value) {
+  return typeof value === "string" && BROWSER_MODES.includes(value) ? value : "auto";
+}
+function resultDetails(artifactPath, browserMode, checks) {
+  return {
+    action: "verify",
+    check: "frontend",
+    path: artifactPath,
+    browserMode,
+    status: checks.some((check) => check.status === "fail") ? "failed" : "passed",
+    checks: checks.map((check) => ({ ...check }))
+  };
+}
+function renderChecks(artifactPath, checks) {
+  const lines = [
+    `frontend validation: ${checks.some((check) => check.status === "fail") ? "failed" : "ok"}`,
+    `artifact: ${artifactPath}`,
+    "checks:"
+  ];
+  for (const check of checks) {
+    const location = check.path ? ` (${check.path})` : "";
+    lines.push(`- ${check.status} ${check.name}${location}: ${check.message}`);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function findBrowserExecutable() {
+  const candidates = ["chromium", "chromium-browser", "google-chrome", "google-chrome-stable", "microsoft-edge"];
+  const pathEnv = process.env.PATH ?? "";
+  for (const dir of pathEnv.split(path.delimiter)) {
+    if (dir.length === 0) continue;
+    for (const candidate of candidates) {
+      const full = path.join(dir, candidate);
+      if (existsSync(full)) return full;
+    }
+  }
+  return null;
+}
+function lineAt(text, index) {
+  let line = 1;
+  for (let i = 0; i < index; i += 1) {
+    if (text.charCodeAt(i) === 10) line += 1;
+  }
+  return line;
+}
+
+// src/tools/verify/scripts.ts
+init_esm_shims();
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import path2 from "node:path";
+function declaredCheckSources(cwd) {
+  const pkgPath = path2.join(cwd, "package.json");
+  if (!existsSync2(pkgPath)) return [];
+  const pkg = parsePackageJson(pkgPath);
+  if (!pkg.ok) return [];
+  return [{ kind: "package.json", path: pkgPath, checks: declaredVerificationScripts(pkg.scripts) }];
+}
+function listChecks(cwdArg) {
+  let cwd;
+  try {
+    cwd = resolveSafeCwd(cwdArg, process.cwd());
+  } catch (err) {
+    return { kind: "error", message: `verify: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  const sources = declaredCheckSources(cwd);
+  const lines = [];
+  if (sources.length === 0 || sources.every((source) => source.checks.length === 0)) {
+    lines.push("No declared verification checks found (no package.json verification scripts).");
+  } else {
+    lines.push("Declared verification checks:");
+    for (const source of sources) {
+      lines.push(`${source.kind}:`);
+      for (const check of source.checks) lines.push(`- ${check}`);
+    }
+  }
+  lines.push(
+    "",
+    'Run one with verify(check="<name>"). verify(check="frontend", path=<file>) validates an HTML/CSS/JS artifact.'
+  );
+  return {
+    kind: "ok",
+    output: lines.join("\n"),
+    details: { sources: sources.map((source) => ({ ...source })) }
+  };
+}
+async function runScriptCheck(check, args, options) {
+  let cwd;
+  try {
+    cwd = resolveSafeCwd(typeof args.cwd === "string" && args.cwd.length > 0 ? args.cwd : void 0, process.cwd());
+  } catch (err) {
+    return { kind: "error", message: `verify: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  const pkgPath = path2.join(cwd, "package.json");
+  if (!existsSync2(pkgPath)) return { kind: "error", message: `verify: package.json not found in ${cwd}` };
+  const pkg = parsePackageJson(pkgPath);
+  if (!pkg.ok) return { kind: "error", message: `verify: ${pkg.reason}` };
+  if (!Object.hasOwn(pkg.scripts, check)) {
+    const declared = declaredVerificationScripts(pkg.scripts);
+    const list = declared.length > 0 ? declared.join(", ") : "(none)";
+    return {
+      kind: "error",
+      message: `verify: package.json has no '${check}' script. Declared verification checks: ${list}.`
+    };
+  }
+  const extraArgs = Array.isArray(args.args) ? args.args.filter((entry) => typeof entry === "string") : [];
+  const vector = ["run", check];
+  if (extraArgs.length > 0) vector.push("--", ...extraArgs);
+  return runVectorTool("verify", "npm", vector, { ...args, cwd }, options);
+}
+function parsePackageJson(pkgPath) {
+  try {
+    const parsed = JSON.parse(readFileSync2(pkgPath, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { ok: false, reason: "package.json root must be an object" };
+    }
+    const scripts = parsed.scripts;
+    if (!scripts || typeof scripts !== "object" || Array.isArray(scripts)) {
+      return { ok: false, reason: "package.json has no scripts object" };
+    }
+    return { ok: true, scripts };
+  } catch (err) {
+    return { ok: false, reason: err instanceof Error ? err.message : String(err) };
+  }
+}
+
+// src/tools/verify/index.ts
+var verifyTool = {
+  ...verifyToolSurface,
+  async run(rawArgs, options) {
+    const args = prepareVerifyArguments(rawArgs);
+    const check = typeof args.check === "string" ? args.check.trim() : "";
+    if (check.length === 0) {
+      return listChecks(typeof args.cwd === "string" && args.cwd.length > 0 ? args.cwd : void 0);
+    }
+    if (check === "frontend") return runFrontendCheck(args, options);
+    if (!isVerificationScriptName(check)) {
+      return {
+        kind: "error",
+        message: `verify: '${check}' is not a verification check (${VERIFICATION_SCRIPT_FAMILY_HINT} or "frontend"); run it through bash.`
+      };
+    }
+    return runScriptCheck(check, args, options);
+  }
+};
+export {
+  verifyTool
+};
+//# sourceMappingURL=verify-375KUB3Y.js.map