@ainyc/canonry 4.109.0 → 4.111.0

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-YEOLQT5S.js";
+} from "./chunk-4TQOZJPF.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-QZQLZL3C.js";
+} from "./chunk-Y26GYDS6.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-3HKBUYIY.js";
+} from "./chunk-CVXBE3ST.js";
 import {
   BacklinkSources,
   CcReleaseSyncStatuses,
@@ -80,7 +80,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-WXAHSQOX.js";
+} from "./chunk-ZT7GVLS3.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -126,9 +126,9 @@ import { parseArgs } from "util";
 function commandId(spec) {
   return spec.path.join(".");
 }
-function matchesPath(args, path9) {
-  if (args.length < path9.length) return false;
-  return path9.every((segment, index) => args[index] === segment);
+function matchesPath(args, path10) {
+  if (args.length < path10.length) return false;
+  return path10.every((segment, index) => args[index] === segment);
 }
 function withGlobalOptions(options) {
   const base = options ? { ...options } : {};
@@ -1656,6 +1656,7 @@ function buildRunBody(opts, icpDescription) {
   const body = {};
   if (icpDescription) body.icpDescription = icpDescription;
   if (opts.buyer !== void 0 && opts.buyer.trim() !== "") body.buyerDescription = opts.buyer;
+  if (opts.seedProviders && opts.seedProviders.length > 0) body.seedProviders = opts.seedProviders;
   if (opts.dedupThreshold !== void 0) body.dedupThreshold = opts.dedupThreshold;
   if (opts.maxProbes !== void 0) body.maxProbes = opts.maxProbes;
   if (opts.probeConcurrency !== void 0) body.probeConcurrency = opts.probeConcurrency;
@@ -1972,6 +1973,272 @@ async function pollSession(client, project, sessionId, quiet = false) {
   }
 }
 
+// src/commands/discover-eval.ts
+import fs2 from "fs";
+import path from "path";
+
+// src/discovery-eval.ts
+var DISCOVERY_EVAL_PANEL = [
+  {
+    slug: "eval-local-single-intent",
+    displayName: "Summit Roof Coatings",
+    domain: "summitroofcoatings.com",
+    icp: "commercial roof coating contractor in Phoenix, Arizona",
+    buyer: "commercial property managers responsible for flat-roof maintenance budgets",
+    locations: [{ label: "phoenix", city: "Phoenix", region: "Arizona", country: "US" }]
+  },
+  {
+    slug: "eval-local-multi-intent",
+    displayName: "Peak Comfort HVAC",
+    domain: "peakcomforthvac.com",
+    icp: "residential HVAC installation, repair, and maintenance company in Denver, Colorado",
+    buyer: "homeowners with aging furnaces or AC units comparing replacement and repair options",
+    locations: [{ label: "denver", city: "Denver", region: "Colorado", country: "US" }]
+  },
+  {
+    slug: "eval-b2b-saas",
+    displayName: "QuoteBeam",
+    domain: "quotebeam.io",
+    icp: "quoting and proposal software for residential solar installers",
+    buyer: "solar sales managers evaluating quoting tools for a 10-50 rep team",
+    locations: []
+  },
+  {
+    slug: "eval-national-ecommerce",
+    displayName: "Willow and Sprout",
+    domain: "willowandsprout.com",
+    icp: "organic cotton baby clothing brand sold online across the US",
+    buyer: "expecting parents researching non-toxic baby essentials",
+    locations: []
+  },
+  {
+    slug: "eval-problem-heavy-consumer",
+    displayName: "SwiftRemit",
+    domain: "swiftremit.app",
+    icp: "mobile app for sending money internationally with low fees",
+    buyer: "immigrants who send money home to family every month",
+    locations: []
+  }
+];
+var EVAL_CANONICAL_FLOOR = 8;
+var EVAL_BANDS = {
+  /** canonicalCount must be >= baseline * this factor (and >= the floor). */
+  canonicalCountFactor: 0.6,
+  /** retention may drop at most this many absolute points below baseline. */
+  retentionDrop: 0.2,
+  /** brandShare may exceed baseline by at most this (and never exceed 0.1). */
+  brandShareSlack: 0.05,
+  brandShareCeiling: 0.1,
+  /** duration must be <= baseline * factor + slack seconds. */
+  durationFactor: 2,
+  durationSlackSeconds: 30
+};
+function scoreSession(shape, session) {
+  const raw = session.seedCountRaw ?? 0;
+  const brandFiltered = session.seedBrandFilteredCount ?? 0;
+  const preFilterTotal = raw + brandFiltered;
+  const truncated = session.canonicalCount == null;
+  const canonicalCount = session.canonicalCount ?? session.seedCount ?? 0;
+  const started = session.startedAt ? Date.parse(session.startedAt) : NaN;
+  const finished = session.finishedAt ? Date.parse(session.finishedAt) : NaN;
+  return {
+    shape,
+    seedCountRaw: raw,
+    canonicalCount,
+    canonicalCountTruncated: truncated,
+    retention: raw > 0 ? canonicalCount / raw : 0,
+    brandShare: preFilterTotal > 0 ? brandFiltered / preFilterTotal : 0,
+    groundingShare: raw > 0 ? (session.seedFromGroundingCount ?? 0) / raw : 0,
+    bandPairFraction: session.dedupBandPairFraction ?? null,
+    probeCount: session.probeCount ?? 0,
+    warning: session.warning ?? null,
+    durationSeconds: Number.isFinite(started) && Number.isFinite(finished) ? Math.round((finished - started) / 1e3) : null
+  };
+}
+function compareToBaseline(scorecards, baseline) {
+  const regressions = [];
+  const notes = [];
+  const bySlug = new Map(scorecards.map((c) => [c.shape, c]));
+  for (const base of baseline.scorecards) {
+    const current = bySlug.get(base.shape);
+    if (!current) {
+      regressions.push(`${base.shape}: missing from this run (baseline shape not evaluated)`);
+      continue;
+    }
+    bySlug.delete(base.shape);
+    if (current.canonicalCount < EVAL_CANONICAL_FLOOR) {
+      regressions.push(
+        `${base.shape}: canonicalCount ${current.canonicalCount} is below the absolute platform floor (${EVAL_CANONICAL_FLOOR})`
+      );
+    }
+    if (current.canonicalCount < base.canonicalCount * EVAL_BANDS.canonicalCountFactor) {
+      regressions.push(
+        `${base.shape}: canonicalCount ${current.canonicalCount} vs baseline ${base.canonicalCount} (band: >= ${EVAL_BANDS.canonicalCountFactor}x)`
+      );
+    }
+    if (current.retention < base.retention - EVAL_BANDS.retentionDrop) {
+      regressions.push(
+        `${base.shape}: retention ${current.retention.toFixed(2)} vs baseline ${base.retention.toFixed(2)} (band: -${EVAL_BANDS.retentionDrop})`
+      );
+    }
+    const brandCeiling = Math.min(base.brandShare + EVAL_BANDS.brandShareSlack, EVAL_BANDS.brandShareCeiling);
+    if (current.brandShare > brandCeiling) {
+      regressions.push(
+        `${base.shape}: brandShare ${current.brandShare.toFixed(2)} exceeds ${brandCeiling.toFixed(2)} (no-brand rule regressed)`
+      );
+    }
+    if (current.warning) {
+      regressions.push(`${base.shape}: collapse warning fired: ${current.warning.slice(0, 80)}`);
+    }
+    if (current.durationSeconds != null && base.durationSeconds != null && current.durationSeconds > base.durationSeconds * EVAL_BANDS.durationFactor + EVAL_BANDS.durationSlackSeconds) {
+      regressions.push(
+        `${base.shape}: duration ${current.durationSeconds}s vs baseline ${base.durationSeconds}s (band: ${EVAL_BANDS.durationFactor}x + ${EVAL_BANDS.durationSlackSeconds}s)`
+      );
+    }
+    if (current.canonicalCountTruncated) {
+      notes.push(`${base.shape}: engine predates canonical_count; using truncated seedCount (understates quality)`);
+    }
+  }
+  for (const [slug] of bySlug) {
+    notes.push(`${slug}: new shape with no baseline entry (add it via --update-baseline)`);
+  }
+  return { pass: regressions.length === 0, regressions, notes };
+}
+
+// src/commands/discover-eval.ts
+var DEFAULT_BASELINE_PATH = "canonry-discovery-eval-baseline.json";
+var POLL_INTERVAL_MS2 = 5e3;
+var SHAPE_TIMEOUT_MS = 10 * 6e4;
+async function runDiscoveryEvalPanel(client, shapes, opts) {
+  const scorecards = [];
+  const pollInterval = opts.pollIntervalMs ?? POLL_INTERVAL_MS2;
+  const timeout = opts.shapeTimeoutMs ?? SHAPE_TIMEOUT_MS;
+  const now = opts.now ?? Date.now;
+  for (const shape of shapes) {
+    await client.putProject(shape.slug, {
+      displayName: shape.displayName,
+      canonicalDomain: shape.domain,
+      country: "US",
+      language: "en",
+      ...shape.locations.length > 0 ? { locations: shape.locations, defaultLocation: shape.locations[0].label } : {}
+    });
+    const started = await client.triggerDiscoveryRun(shape.slug, {
+      icpDescription: shape.icp,
+      buyerDescription: shape.buyer,
+      maxProbes: opts.maxProbes ?? 2,
+      probeConcurrency: opts.probeConcurrency ?? 2,
+      ...opts.seedProviders && opts.seedProviders.length > 0 ? { seedProviders: opts.seedProviders } : {}
+    });
+    const sessionId = typeof started.sessionId === "string" ? started.sessionId : "";
+    if (!sessionId) {
+      throw new CliError({
+        code: "EVAL_SESSION_START_FAILED",
+        message: `${shape.slug}: discover run returned no sessionId`,
+        exitCode: EXIT_USER_ERROR
+      });
+    }
+    const deadline = now() + timeout;
+    let session;
+    for (; ; ) {
+      const rows = await client.listDiscoverySessions(shape.slug, { limit: 10 });
+      session = rows.find((r) => r.id === sessionId);
+      if (session?.status === "completed") break;
+      if (session?.status === "failed") {
+        throw new CliError({
+          code: "EVAL_SESSION_FAILED",
+          message: `${shape.slug}: discovery session failed`,
+          exitCode: EXIT_USER_ERROR,
+          details: { sessionId }
+        });
+      }
+      if (now() > deadline) {
+        throw new CliError({
+          code: "EVAL_SESSION_TIMEOUT",
+          message: `${shape.slug}: session did not complete within ${Math.round(timeout / 6e4)} minutes`,
+          exitCode: EXIT_USER_ERROR,
+          details: { sessionId }
+        });
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    scorecards.push(scoreSession(shape.slug, session));
+  }
+  return scorecards;
+}
+function renderHuman(scorecards, verdict) {
+  console.log("SHAPE                          RAW  CANON  RETENTION  BRAND  GROUND  BAND   TIME");
+  for (const c of scorecards) {
+    console.log(
+      [
+        c.shape.padEnd(30),
+        String(c.seedCountRaw).padStart(4),
+        String(c.canonicalCount).padStart(6) + (c.canonicalCountTruncated ? "*" : " "),
+        c.retention.toFixed(2).padStart(9),
+        c.brandShare.toFixed(2).padStart(6),
+        c.groundingShare.toFixed(2).padStart(7),
+        (c.bandPairFraction ?? 0).toFixed(2).padStart(5),
+        c.durationSeconds == null ? "   ?" : `${String(c.durationSeconds).padStart(4)}s`
+      ].join(" ")
+    );
+    if (c.warning) console.log(`  warning: ${c.warning}`);
+  }
+  if (verdict) {
+    for (const note of verdict.notes) console.log(`note: ${note}`);
+    for (const regression of verdict.regressions) console.log(`REGRESSION: ${regression}`);
+    console.log(verdict.pass ? "PASS: no regressions against the baseline." : "FAIL: regressions detected.");
+  } else {
+    console.log("No baseline compared (wrote or missing baseline).");
+  }
+}
+async function discoverEvalWithClient(client, opts) {
+  const selected = opts.shapes && opts.shapes.length > 0 ? DISCOVERY_EVAL_PANEL.filter((s) => opts.shapes.includes(s.slug)) : DISCOVERY_EVAL_PANEL;
+  if (selected.length === 0) {
+    throw new CliError({
+      code: "EVAL_NO_SHAPES",
+      message: `no matching shapes; known: ${DISCOVERY_EVAL_PANEL.map((s) => s.slug).join(", ")}`,
+      exitCode: EXIT_USER_ERROR
+    });
+  }
+  const scorecards = await runDiscoveryEvalPanel(client, selected, opts);
+  const baselinePath = path.resolve(opts.baseline ?? DEFAULT_BASELINE_PATH);
+  if (opts.updateBaseline) {
+    const baseline2 = { capturedAt: (/* @__PURE__ */ new Date()).toISOString(), scorecards };
+    fs2.writeFileSync(baselinePath, JSON.stringify(baseline2, null, 2) + "\n");
+    if (opts.format === "json" || opts.format === "jsonl") {
+      console.log(JSON.stringify({ scorecards, baselineWritten: baselinePath }, null, 2));
+    } else {
+      renderHuman(scorecards, null);
+      console.log(`Baseline written: ${baselinePath}`);
+    }
+    return;
+  }
+  if (!fs2.existsSync(baselinePath)) {
+    throw new CliError({
+      code: "EVAL_NO_BASELINE",
+      message: `no baseline at ${baselinePath}; run with --update-baseline to capture one`,
+      exitCode: EXIT_USER_ERROR
+    });
+  }
+  const baseline = JSON.parse(fs2.readFileSync(baselinePath, "utf8"));
+  const verdict = compareToBaseline(scorecards, baseline);
+  if (opts.format === "json" || opts.format === "jsonl") {
+    console.log(JSON.stringify({ scorecards, verdict, baseline: { capturedAt: baseline.capturedAt } }, null, 2));
+  } else {
+    renderHuman(scorecards, verdict);
+  }
+  if (!verdict.pass) {
+    throw new CliError({
+      code: "EVAL_REGRESSION",
+      message: `${verdict.regressions.length} regression${verdict.regressions.length === 1 ? "" : "s"} against the baseline`,
+      exitCode: EXIT_USER_ERROR,
+      details: { regressions: verdict.regressions }
+    });
+  }
+}
+async function discoverEval(opts) {
+  await discoverEvalWithClient(createApiClient(), opts);
+}
+
 // src/cli-commands/discover.ts
 function parseFloatOption(values, key, usage) {
   const raw = values[key];
@@ -2058,10 +2325,11 @@ Usage: ${usage}`,
 var DISCOVER_CLI_COMMANDS = [
   {
     path: ["discover", "run"],
-    usage: 'canonry discover run <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
+    usage: 'canonry discover run <project> [--icp "..."] [--buyer "..."] [--seed-provider gemini --seed-provider openai] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
     options: {
       icp: stringOption(),
       buyer: stringOption(),
+      "seed-provider": multiStringOption(),
       "icp-angle": multiStringOption(),
       locations: multiStringOption(),
       "dedup-threshold": stringOption(),
@@ -2070,11 +2338,12 @@ var DISCOVER_CLI_COMMANDS = [
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = 'canonry discover run <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
+      const usage = 'canonry discover run <project> [--icp "..."] [--buyer "..."] [--seed-provider gemini --seed-provider openai] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
       const project = requireProject(input, "discover.run", usage);
       await discoverRun(project, {
         icp: getString(input.values, "icp"),
         buyer: getString(input.values, "buyer"),
+        seedProviders: getStringArray(input.values, "seed-provider"),
         icpAngles: getStringArray(input.values, "icp-angle"),
         locations: parseLocationsOption(input.values),
         dedupThreshold: parseFloatOption(input.values, "dedup-threshold", usage),
@@ -2093,12 +2362,45 @@ var DISCOVER_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["discover", "eval"],
+    usage: "canonry discover eval [--baseline <path>] [--update-baseline] [--shape eval-b2b-saas ...] [--seed-provider gemini --seed-provider openai] [--max-probes 2] [--probe-concurrency 2] [--format json]",
+    options: {
+      baseline: stringOption(),
+      "update-baseline": { type: "boolean", default: false },
+      shape: multiStringOption(),
+      "seed-provider": multiStringOption(),
+      "max-probes": stringOption(),
+      "probe-concurrency": stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry discover eval [--baseline <path>] [--update-baseline] [--shape eval-b2b-saas ...] [--seed-provider gemini --seed-provider openai] [--max-probes 2] [--probe-concurrency 2] [--format json]";
+      await discoverEval({
+        baseline: getString(input.values, "baseline"),
+        updateBaseline: getBoolean(input.values, "update-baseline"),
+        shapes: getStringArray(input.values, "shape"),
+        seedProviders: getStringArray(input.values, "seed-provider"),
+        maxProbes: parseIntegerOption(input, "max-probes", {
+          command: "discover.eval",
+          usage,
+          message: "--max-probes must be an integer"
+        }),
+        probeConcurrency: parseIntegerOption(input, "probe-concurrency", {
+          command: "discover.eval",
+          usage,
+          message: "--probe-concurrency must be an integer"
+        }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["discover", "seed"],
-    usage: 'canonry discover seed <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
+    usage: 'canonry discover seed <project> [--icp "..."] [--buyer "..."] [--seed-provider gemini --seed-provider openai] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
     options: {
       icp: stringOption(),
       buyer: stringOption(),
+      "seed-provider": multiStringOption(),
       "icp-angle": multiStringOption(),
       locations: multiStringOption(),
       "dedup-threshold": stringOption(),
@@ -2107,11 +2409,12 @@ var DISCOVER_CLI_COMMANDS = [
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = 'canonry discover seed <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
+      const usage = 'canonry discover seed <project> [--icp "..."] [--buyer "..."] [--seed-provider gemini --seed-provider openai] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
       const project = requireProject(input, "discover.seed", usage);
       await discoverSeed(project, {
         icp: getString(input.values, "icp"),
         buyer: getString(input.values, "buyer"),
+        seedProviders: getStringArray(input.values, "seed-provider"),
         icpAngles: getStringArray(input.values, "icp-angle"),
         locations: parseLocationsOption(input.values),
         dedupThreshold: parseFloatOption(input.values, "dedup-threshold", usage),
@@ -2645,9 +2948,9 @@ async function gaConnect(project, opts) {
     propertyId: opts.propertyId
   };
   if (opts.keyFile) {
-    const fs12 = await import("fs");
+    const fs13 = await import("fs");
     try {
-      const content = fs12.readFileSync(opts.keyFile, "utf-8");
+      const content = fs13.readFileSync(opts.keyFile, "utf-8");
       JSON.parse(content);
       body.keyJson = content;
     } catch (e) {
@@ -3855,9 +4158,9 @@ async function getCommand(opts) {
     console.log(JSON.stringify(leaf, null, 2));
   }
 }
-function walkPath(value, path9) {
-  if (!path9 || path9 === ".") return value;
-  const segments = path9.split(".").flatMap((part) => {
+function walkPath(value, path10) {
+  if (!path10 || path10 === ".") return value;
+  const segments = path10.split(".").flatMap((part) => {
     const tokens = [];
     let i = 0;
     const bracketStart = part.indexOf("[");
@@ -3905,13 +4208,13 @@ var GET_CLI_COMMANDS = [
     },
     run: async (input) => {
       const project = requireProject(input, "get", USAGE2);
-      const path9 = requirePositional(input, 1, {
+      const path10 = requirePositional(input, 1, {
         command: "get",
         usage: USAGE2,
         message: 'path is required (e.g. "scores.mentionShare.value")'
       });
       const from = getString(input.values, "from");
-      await getCommand({ project, path: path9, from, format: input.format });
+      await getCommand({ project, path: path10, from, format: input.format });
     }
   }
 ];
@@ -3950,9 +4253,9 @@ async function trafficConnectWordpress(project, opts) {
   }
   let applicationPassword = opts.appPassword?.trim() ?? "";
   if (!applicationPassword && opts.appPasswordFile) {
-    const fs12 = await import("fs");
+    const fs13 = await import("fs");
     try {
-      applicationPassword = fs12.readFileSync(opts.appPasswordFile, "utf-8").trim();
+      applicationPassword = fs13.readFileSync(opts.appPasswordFile, "utf-8").trim();
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       throw new CliError({
@@ -4008,10 +4311,10 @@ async function trafficConnectCloudRun(project, opts) {
       details: { project }
     });
   }
-  const fs12 = await import("fs");
+  const fs13 = await import("fs");
   let keyJson;
   try {
-    keyJson = fs12.readFileSync(opts.serviceAccountKey, "utf-8");
+    keyJson = fs13.readFileSync(opts.serviceAccountKey, "utf-8");
     JSON.parse(keyJson);
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
@@ -4071,9 +4374,9 @@ async function trafficConnectVercel(project, opts) {
   }
   let token = opts.token?.trim() ?? "";
   if (!token && opts.tokenFile) {
-    const fs12 = await import("fs");
+    const fs13 = await import("fs");
     try {
-      token = fs12.readFileSync(opts.tokenFile, "utf-8").trim();
+      token = fs13.readFileSync(opts.tokenFile, "utf-8").trim();
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       throw new CliError({
@@ -5887,7 +6190,7 @@ var KEYS_CLI_COMMANDS = [
 ];
 
 // src/commands/keyword.ts
-import fs2 from "fs";
+import fs3 from "fs";
 function getClient12() {
   return createApiClient();
 }
@@ -5955,7 +6258,7 @@ async function listKeywords(project, format) {
   }
 }
 async function importKeywords(project, filePath, format) {
-  if (!fs2.existsSync(filePath)) {
+  if (!fs3.existsSync(filePath)) {
     throw new CliError({
       code: "KEYWORD_IMPORT_FILE_NOT_FOUND",
       message: `File not found: ${filePath}`,
@@ -5966,7 +6269,7 @@ async function importKeywords(project, filePath, format) {
       }
     });
   }
-  const content = fs2.readFileSync(filePath, "utf-8");
+  const content = fs3.readFileSync(filePath, "utf-8");
   const keywords = content.split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
   if (keywords.length === 0) {
     if (isMachineFormat(format)) {
@@ -6167,7 +6470,7 @@ var KEYWORD_CLI_COMMANDS = [
 ];
 
 // src/commands/query.ts
-import fs3 from "fs";
+import fs4 from "fs";
 function getClient13() {
   return createApiClient();
 }
@@ -6258,7 +6561,7 @@ async function listQueries(project, format) {
   }
 }
 async function importQueries(project, filePath, format) {
-  if (!fs3.existsSync(filePath)) {
+  if (!fs4.existsSync(filePath)) {
     throw new CliError({
       code: "QUERY_IMPORT_FILE_NOT_FOUND",
       message: `File not found: ${filePath}`,
@@ -6269,7 +6572,7 @@ async function importQueries(project, filePath, format) {
       }
     });
   }
-  const content = fs3.readFileSync(filePath, "utf-8");
+  const content = fs4.readFileSync(filePath, "utf-8");
   const queries2 = content.split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
   if (queries2.length === 0) {
     if (isMachineFormat(format)) {
@@ -6471,16 +6774,16 @@ var QUERY_CLI_COMMANDS = [
 ];
 
 // src/commands/mcp.ts
-import fs4 from "fs";
-import path2 from "path";
+import fs5 from "fs";
+import path3 from "path";
 import { createRequire } from "module";
 
 // src/mcp-clients.ts
 import os from "os";
-import path from "path";
+import path2 from "path";
 var CLAUDE_DESKTOP_CONFIG_FILENAME = "claude_desktop_config.json";
 function homeRelative(...segments) {
-  return path.join(os.homedir(), ...segments);
+  return path2.join(os.homedir(), ...segments);
 }
 function claudeDesktopConfigPath() {
   switch (process.platform) {
@@ -6488,7 +6791,7 @@ function claudeDesktopConfigPath() {
       return homeRelative("Library", "Application Support", "Claude", CLAUDE_DESKTOP_CONFIG_FILENAME);
     case "win32": {
       const appData = process.env.APPDATA ?? homeRelative("AppData", "Roaming");
-      return path.join(appData, "Claude", CLAUDE_DESKTOP_CONFIG_FILENAME);
+      return path2.join(appData, "Claude", CLAUDE_DESKTOP_CONFIG_FILENAME);
     }
     default:
       return homeRelative(".config", "Claude", CLAUDE_DESKTOP_CONFIG_FILENAME);
@@ -6501,7 +6804,7 @@ function codexConfigPath() {
   return homeRelative(".codex", "config.toml");
 }
 function claudeCodeProjectConfigPath() {
-  return path.join(process.cwd(), ".mcp.json");
+  return path2.join(process.cwd(), ".mcp.json");
 }
 var SUPPORTED_MCP_CLIENTS = [
   {
@@ -6544,7 +6847,7 @@ function listMcpClientIds() {
 var _require = createRequire(import.meta.url);
 function resolveCanonryMcpBin() {
   const packageJsonPath = _require.resolve("../package.json");
-  const packageRoot = path2.dirname(packageJsonPath);
+  const packageRoot = path3.dirname(packageJsonPath);
   const pkg = _require("../package.json");
   const relativeBin = pkg.bin?.["canonry-mcp"];
   if (!relativeBin) {
@@ -6554,7 +6857,7 @@ function resolveCanonryMcpBin() {
       exitCode: 2
     });
   }
-  return path2.resolve(packageRoot, relativeBin);
+  return path3.resolve(packageRoot, relativeBin);
 }
 function buildEntry(opts) {
   const target = opts.binPath ?? resolveCanonryMcpBin();
@@ -6587,8 +6890,8 @@ function renderClientSnippet(client, serverName, entry) {
   return renderJsonSnippet(serverName, entry, client.format);
 }
 function readJsonConfig(configPath) {
-  if (!fs4.existsSync(configPath)) return {};
-  const raw = fs4.readFileSync(configPath, "utf-8").trim();
+  if (!fs5.existsSync(configPath)) return {};
+  const raw = fs5.readFileSync(configPath, "utf-8").trim();
   if (!raw) return {};
   try {
     const parsed = JSON.parse(raw);
@@ -6606,14 +6909,14 @@ function readJsonConfig(configPath) {
   }
 }
 function writeJsonConfig(configPath, value) {
-  fs4.mkdirSync(path2.dirname(configPath), { recursive: true });
-  fs4.writeFileSync(configPath, `${JSON.stringify(value, null, 2)}
+  fs5.mkdirSync(path3.dirname(configPath), { recursive: true });
+  fs5.writeFileSync(configPath, `${JSON.stringify(value, null, 2)}
 `, "utf-8");
 }
 function backupConfigIfPresent(configPath) {
-  if (!fs4.existsSync(configPath)) return void 0;
+  if (!fs5.existsSync(configPath)) return void 0;
   const backupPath = `${configPath}.canonry.bak`;
-  fs4.copyFileSync(configPath, backupPath);
+  fs5.copyFileSync(configPath, backupPath);
   return backupPath;
 }
 function findClientOrThrow(id) {
@@ -6967,13 +7270,13 @@ var NOTIFY_CLI_COMMANDS = [
 ];
 
 // src/commands/apply.ts
-import fs5 from "fs";
+import fs6 from "fs";
 import { parseAllDocuments } from "yaml";
 async function applyConfigFile(filePath) {
-  if (!fs5.existsSync(filePath)) {
+  if (!fs6.existsSync(filePath)) {
     throw new Error(`File not found: ${filePath}`);
   }
-  const content = fs5.readFileSync(filePath, "utf-8");
+  const content = fs6.readFileSync(filePath, "utf-8");
   const docs = parseAllDocuments(content);
   const client = createApiClient();
   const errors = [];
@@ -7888,11 +8191,11 @@ var PROJECT_CLI_COMMANDS = [
 ];
 
 // src/commands/report.ts
-import fs6 from "fs";
-import path3 from "path";
+import fs7 from "fs";
+import path4 from "path";
 function defaultOutputPath(project, audience) {
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  return path3.resolve(process.cwd(), `canonry-report-${project}-${audience}-${date}.html`);
+  return path4.resolve(process.cwd(), `canonry-report-${project}-${audience}-${date}.html`);
 }
 async function runReportCommand(project, opts = {}) {
   const client = createApiClient();
@@ -7903,12 +8206,12 @@ async function runReportCommand(project, opts = {}) {
     return;
   }
   const html = renderReportHtml(report, { audience });
-  const targetPath = opts.output ? path3.resolve(opts.output) : defaultOutputPath(project, audience);
-  const dir = path3.dirname(targetPath);
-  if (!fs6.existsSync(dir)) {
-    fs6.mkdirSync(dir, { recursive: true });
+  const targetPath = opts.output ? path4.resolve(opts.output) : defaultOutputPath(project, audience);
+  const dir = path4.dirname(targetPath);
+  if (!fs7.existsSync(dir)) {
+    fs7.mkdirSync(dir, { recursive: true });
   }
-  fs6.writeFileSync(targetPath, html, "utf-8");
+  fs7.writeFileSync(targetPath, html, "utf-8");
   console.log(`Report written to ${targetPath}`);
 }
 
@@ -8773,12 +9076,12 @@ var SKILLS_CLI_COMMANDS = [
 ];
 
 // src/commands/snapshot.ts
-import fs8 from "fs";
-import path5 from "path";
+import fs9 from "fs";
+import path6 from "path";
 
 // src/snapshot-pdf.ts
-import fs7 from "fs";
-import path4 from "path";
+import fs8 from "fs";
+import path5 from "path";
 import { PDFDocument, StandardFonts, rgb } from "pdf-lib";
 var PAGE_WIDTH = 612;
 var PAGE_HEIGHT = 792;
@@ -8990,9 +9293,9 @@ async function writeSnapshotPdf(report, outputPath) {
   renderCompetitors(pdf, report);
   renderQueries(pdf, report);
   const bytes = await doc.save();
-  const resolvedPath = path4.resolve(outputPath);
-  fs7.mkdirSync(path4.dirname(resolvedPath), { recursive: true });
-  fs7.writeFileSync(resolvedPath, bytes);
+  const resolvedPath = path5.resolve(outputPath);
+  fs8.mkdirSync(path5.dirname(resolvedPath), { recursive: true });
+  fs8.writeFileSync(resolvedPath, bytes);
   return resolvedPath;
 }
 function renderCover(pdf, report) {
@@ -9150,9 +9453,9 @@ Markdown saved: ${savedMdPath}`);
 PDF saved: ${savedPdfPath}`);
 }
 function writeSnapshotMarkdown(report, outputPath) {
-  const resolvedPath = path5.resolve(outputPath);
-  fs8.mkdirSync(path5.dirname(resolvedPath), { recursive: true });
-  fs8.writeFileSync(resolvedPath, formatSnapshotMarkdown(report), "utf-8");
+  const resolvedPath = path6.resolve(outputPath);
+  fs9.mkdirSync(path6.dirname(resolvedPath), { recursive: true });
+  fs9.writeFileSync(resolvedPath, formatSnapshotMarkdown(report), "utf-8");
   return resolvedPath;
 }
 function formatSnapshotMarkdown(report) {
@@ -9444,7 +9747,7 @@ async function showOverview(project, opts) {
     console.log(JSON.stringify(overview, null, 2));
     return;
   }
-  renderHuman(overview);
+  renderHuman2(overview);
 }
 async function showAllOverviews(opts) {
   const client = createApiClient();
@@ -9485,7 +9788,7 @@ function cell(value, width) {
   if (value.length >= width) return `${value.slice(0, width - 1)} `;
   return value.padEnd(width);
 }
-function renderHuman(overview) {
+function renderHuman2(overview) {
   const {
     project: meta,
     latestRun,
@@ -10135,7 +10438,7 @@ var CONTENT_CLI_COMMANDS = [
 
 // src/commands/bootstrap.ts
 import crypto from "crypto";
-import path6 from "path";
+import path7 from "path";
 import { eq } from "drizzle-orm";
 
 // ../config/src/index.ts
@@ -10292,7 +10595,7 @@ async function bootstrapCommand(_opts) {
     );
   }
   const configDir = getConfigDir();
-  const databasePath = env.databasePath || path6.join(configDir, "data.db");
+  const databasePath = env.databasePath || path7.join(configDir, "data.db");
   const existing = configExists();
   const existingConfig = existing ? loadConfig() : void 0;
   let rawApiKey;
@@ -10362,10 +10665,10 @@ async function bootstrapCommand(_opts) {
 
 // src/commands/daemon.ts
 import { spawn } from "child_process";
-import fs9 from "fs";
-import path7 from "path";
+import fs10 from "fs";
+import path8 from "path";
 function getPidPath() {
-  return path7.join(getConfigDir(), "canonry.pid");
+  return path8.join(getConfigDir(), "canonry.pid");
 }
 function isProcessAlive(pid) {
   try {
@@ -10405,8 +10708,8 @@ function buildServeForwardArgs(opts) {
 async function startDaemon(opts) {
   const pidPath = getPidPath();
   const format = opts.format ?? "text";
-  if (fs9.existsSync(pidPath)) {
-    const existingPid = parseInt(fs9.readFileSync(pidPath, "utf-8").trim(), 10);
+  if (fs10.existsSync(pidPath)) {
+    const existingPid = parseInt(fs10.readFileSync(pidPath, "utf-8").trim(), 10);
     if (!isNaN(existingPid) && isProcessAlive(existingPid)) {
       throw new CliError({
         code: "DAEMON_ALREADY_RUNNING",
@@ -10417,9 +10720,9 @@ async function startDaemon(opts) {
         }
       });
     }
-    fs9.unlinkSync(pidPath);
+    fs10.unlinkSync(pidPath);
   }
-  const cliPath = path7.resolve(new URL(import.meta.url).pathname);
+  const cliPath = path8.resolve(new URL(import.meta.url).pathname);
   const inSourceMode = new URL(import.meta.url).pathname.endsWith(".ts");
   const args = inSourceMode ? ["--import", "tsx", cliPath, "serve"] : [cliPath, "serve"];
   args.push(...buildServeForwardArgs(opts));
@@ -10436,10 +10739,10 @@ async function startDaemon(opts) {
     });
   }
   const configDir = getConfigDir();
-  if (!fs9.existsSync(configDir)) {
-    fs9.mkdirSync(configDir, { recursive: true });
+  if (!fs10.existsSync(configDir)) {
+    fs10.mkdirSync(configDir, { recursive: true });
   }
-  fs9.writeFileSync(pidPath, String(child.pid), "utf-8");
+  fs10.writeFileSync(pidPath, String(child.pid), "utf-8");
   const port = opts.port ?? "4100";
   const host = opts.host ?? "127.0.0.1";
   if (!isMachineFormat(format)) {
@@ -10448,7 +10751,7 @@ async function startDaemon(opts) {
   const ready = await waitForReady(host, port);
   if (!ready) {
     try {
-      fs9.unlinkSync(pidPath);
+      fs10.unlinkSync(pidPath);
     } catch {
     }
     throw new CliError({
@@ -10480,7 +10783,7 @@ async function startDaemon(opts) {
 }
 function stopDaemon(format = "text") {
   const pidPath = getPidPath();
-  if (!fs9.existsSync(pidPath)) {
+  if (!fs10.existsSync(pidPath)) {
     if (isMachineFormat(format)) {
       console.log(JSON.stringify({
         stopped: false,
@@ -10491,7 +10794,7 @@ function stopDaemon(format = "text") {
     console.log("Canonry is not running (no PID file found)");
     return;
   }
-  const pid = parseInt(fs9.readFileSync(pidPath, "utf-8").trim(), 10);
+  const pid = parseInt(fs10.readFileSync(pidPath, "utf-8").trim(), 10);
   if (isNaN(pid)) {
     if (isMachineFormat(format)) {
       console.log(JSON.stringify({
@@ -10502,7 +10805,7 @@ function stopDaemon(format = "text") {
     } else {
       console.error("Invalid PID file. Removing it.");
     }
-    fs9.unlinkSync(pidPath);
+    fs10.unlinkSync(pidPath);
     return;
   }
   if (!isProcessAlive(pid)) {
@@ -10516,12 +10819,12 @@ function stopDaemon(format = "text") {
     } else {
       console.log(`Canonry is not running (stale PID: ${pid}). Cleaning up.`);
     }
-    fs9.unlinkSync(pidPath);
+    fs10.unlinkSync(pidPath);
     return;
   }
   try {
     process.kill(pid, "SIGTERM");
-    fs9.unlinkSync(pidPath);
+    fs10.unlinkSync(pidPath);
     if (isMachineFormat(format)) {
       console.log(JSON.stringify({
         stopped: true,
@@ -10545,9 +10848,9 @@ function stopDaemon(format = "text") {
 
 // src/commands/init.ts
 import crypto2 from "crypto";
-import fs10 from "fs";
+import fs11 from "fs";
 import readline from "readline";
-import path8 from "path";
+import path9 from "path";
 function prompt(question) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -10568,8 +10871,8 @@ var DEFAULT_QUOTA = {
 var PROJECT_MARKERS = [".git", "canonry.yaml", "canonry.yml", "package.json"];
 function cwdLooksLikeProject(dir) {
   const home = process.env.HOME ?? "";
-  if (home && path8.resolve(dir) === path8.resolve(home)) return false;
-  return PROJECT_MARKERS.some((marker) => fs10.existsSync(path8.join(dir, marker)));
+  if (home && path9.resolve(dir) === path9.resolve(home)) return false;
+  return PROJECT_MARKERS.some((marker) => fs11.existsSync(path9.join(dir, marker)));
 }
 var DEFAULT_AGENT_MODELS = {
   anthropic: "anthropic/claude-sonnet-4-6",
@@ -10600,8 +10903,8 @@ async function initCommand(opts) {
     return void 0;
   }
   const configDir = getConfigDir();
-  if (!fs10.existsSync(configDir)) {
-    fs10.mkdirSync(configDir, { recursive: true });
+  if (!fs11.existsSync(configDir)) {
+    fs11.mkdirSync(configDir, { recursive: true });
   }
   const bootstrapEnv = getBootstrapEnv(process.env, {
     GEMINI_API_KEY: opts?.geminiKey,
@@ -10716,7 +11019,7 @@ async function initCommand(opts) {
   const rawApiKey = `cnry_${crypto2.randomBytes(16).toString("hex")}`;
   const keyHash = crypto2.createHash("sha256").update(rawApiKey).digest("hex");
   const keyPrefix = rawApiKey.slice(0, 9);
-  const databasePath = path8.join(configDir, "data.db");
+  const databasePath = path9.join(configDir, "data.db");
   const db = createClient(databasePath);
   migrate(db);
   db.insert(apiKeys).values({
@@ -11613,7 +11916,7 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
 ];
 
 // src/cli-commands/wordpress.ts
-import fs11 from "fs";
+import fs12 from "fs";
 
 // src/commands/wordpress.ts
 function getClient26() {
@@ -11852,12 +12155,12 @@ async function wordpressSetMeta(project, body) {
   printPageDetail(result);
 }
 async function wordpressBulkSetMeta(project, opts) {
-  const fs12 = await import("fs/promises");
-  const path9 = await import("path");
-  const filePath = path9.resolve(opts.from);
+  const fs13 = await import("fs/promises");
+  const path10 = await import("path");
+  const filePath = path10.resolve(opts.from);
   let raw;
   try {
-    raw = await fs12.readFile(filePath, "utf8");
+    raw = await fs13.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -11954,13 +12257,13 @@ async function wordpressSetSchema(project, body) {
   printManualAssist(`Schema update for "${body.slug}"`, result);
 }
 async function wordpressSchemaDeploy(project, opts) {
-  const fs12 = await import("fs/promises");
-  const path9 = await import("path");
+  const fs13 = await import("fs/promises");
+  const path10 = await import("path");
   const yaml = await loadYamlModule();
-  const filePath = path9.resolve(opts.profile);
+  const filePath = path10.resolve(opts.profile);
   let raw;
   try {
-    raw = await fs12.readFile(filePath, "utf8");
+    raw = await fs13.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -12065,13 +12368,13 @@ async function wordpressOnboard(project, opts) {
   }
   let profileData;
   if (opts.profile) {
-    const fs12 = await import("fs/promises");
-    const path9 = await import("path");
+    const fs13 = await import("fs/promises");
+    const path10 = await import("path");
     const yaml = await loadYamlModule();
-    const filePath = path9.resolve(opts.profile);
+    const filePath = path10.resolve(opts.profile);
     let raw;
     try {
-      raw = await fs12.readFile(filePath, "utf8");
+      raw = await fs13.readFile(filePath, "utf8");
     } catch {
       throw new CliError({
         code: "FILE_READ_ERROR",
@@ -12220,7 +12523,7 @@ function resolveContent(input, command, usage, options) {
   }
   if (contentFile) {
     try {
-      return fs11.readFileSync(contentFile, "utf-8");
+      return fs12.readFileSync(contentFile, "utf-8");
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       throw usageError(`Error: could not read --content-file "${contentFile}": ${message}`, {