@canonry/canonry 7.98.0 → 7.100.0

package/dist/mcp.js

@@ -1,25 +1,25 @@
 import {
   autoSyncSkills
-} from "./chunk-64KB6YTG.js";
+} from "./chunk-YU2WX7RD.js";
 import {
   createCanonryMcpServer
-} from "./chunk-64R66MWZ.js";
-import "./chunk-MTW37GXF.js";
+} from "./chunk-G6QN4VFS.js";
+import "./chunk-2FWYWGIR.js";
 import {
   createApiClient
-} from "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
-import "./chunk-RTH5JVC3.js";
-import "./chunk-3GMBHGQ5.js";
-import "./chunk-X3UXMHWC.js";
-import "./chunk-52M2JWCB.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
+import "./chunk-FBO25TA3.js";
+import "./chunk-F46TBLXK.js";
+import "./chunk-DGDLLRS4.js";
+import "./chunk-7BEGCVVB.js";
 import "./chunk-AOJU5LKX.js";
 import "./chunk-HGMYEDAQ.js";
 import {
   describeError,
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-ZBTUISPG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/mcp/cli.ts

package/dist/{measurement-plan-BLPAZEXS.js → measurement-plan-7FQKUOMR.js}

@@ -14,14 +14,14 @@ import {
   showMeasurementProperty,
   showMeasurementPropertyEvidence,
   showMeasurementReport
-} from "./chunk-MSI4BGFN.js";
-import "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
+} from "./chunk-AYKTVQF7.js";
+import "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import "./chunk-Z7IUAJOF.js";
-import "./chunk-52M2JWCB.js";
+import "./chunk-7BEGCVVB.js";
 import "./chunk-AOJU5LKX.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-ZBTUISPG.js";
+import "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 export {
   ADVANCED_MEASUREMENT_OPERATIONS,

package/dist/{notify-KAGE6UEN.js → notify-TC7ARC6W.js}

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -12,7 +12,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   notificationEventSchema
-} from "./chunk-ZBTUISPG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/notify.ts

package/dist/{organic-evidence-HTYRXRML.js → organic-evidence-M34MWJXE.js}

@@ -1,12 +1,12 @@
 import {
   createApiClient
-} from "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import "./chunk-AOJU5LKX.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
-import "./chunk-ZBTUISPG.js";
+import "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/organic-evidence.ts
@@ -37,7 +37,10 @@ function printOrganicEvidence(project, data) {
   }
   if (data.visibility) {
     const v = data.visibility;
-    console.log(`Latest AI visibility: ${v.mentionedPairs}/${v.answerPairs} mentioned, ${v.citedPairs}/${v.answerPairs} cited (${Math.floor(v.ageDays)}d old)`);
+    const notMeasured = v.citationNotMeasuredPairs ?? 0;
+    const citedBase = v.answerPairs - notMeasured;
+    const cited = citedBase === 0 && notMeasured > 0 ? "citations not measured (no answer carries sources)" : `${v.citedPairs}/${citedBase} cited${notMeasured > 0 ? ` (${notMeasured} not measured, no sources)` : ""}`;
+    console.log(`Latest AI visibility: ${v.mentionedPairs}/${v.answerPairs} mentioned, ${cited} (${Math.floor(v.ageDays)}d old)`);
   }
   if (data.findings.length > 0) {
     console.log("\nFindings:");

package/dist/overview-P6BRMXJN.js

@@ -0,0 +1,314 @@
+import {
+  runAdmissionLines
+} from "./chunk-NQYJHKML.js";
+import {
+  citedBase
+} from "./chunk-J6536OL6.js";
+import {
+  createApiClient
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
+import "./chunk-Z7IUAJOF.js";
+import "./chunk-AOJU5LKX.js";
+import {
+  CliError,
+  EXIT_SYSTEM_ERROR,
+  EXIT_USER_ERROR,
+  isMachineFormat
+} from "./chunk-HGMYEDAQ.js";
+import {
+  RatioUnits,
+  WHAT_CHANGED_ALL_CLEAR_DETAIL,
+  describeError,
+  formatPercent,
+  portfolioWhatChangedItems
+} from "./chunk-O7S7OHLE.js";
+import "./chunk-MLKGABMK.js";
+
+// src/commands/overview.ts
+async function showOverview(project, opts) {
+  const client = createApiClient();
+  const overview = await client.getProjectOverview(project, {
+    location: opts.location,
+    since: opts.since
+  });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(overview, null, 2));
+    return;
+  }
+  renderHuman(overview);
+}
+function readFailure(err) {
+  return err instanceof CliError ? { code: err.code, message: err.message, system: err.exitCode === EXIT_SYSTEM_ERROR } : { code: "CLI_ERROR", message: describeError(err), system: true };
+}
+async function showAllOverviews(opts) {
+  const client = createApiClient();
+  const projects = await client.listProjects();
+  if (projects.length === 0) {
+    if (isMachineFormat(opts.format)) {
+      console.log("[]");
+      return;
+    }
+    console.log("No projects configured. Add one with `canonry project create`.");
+    return;
+  }
+  const settled = await Promise.allSettled(
+    projects.map(
+      (p) => client.getProjectOverview(p.name, { location: opts.location, since: opts.since })
+    )
+  );
+  const reads = projects.map((project, index) => {
+    const outcome = settled[index];
+    return outcome.status === "fulfilled" ? { project, overview: outcome.value } : { project, failure: readFailure(outcome.reason) };
+  });
+  if (isMachineFormat(opts.format)) {
+    const entries = reads.map((read) => "overview" in read ? read.overview : { project: read.project, error: { code: read.failure.code, message: read.failure.message } });
+    console.log(JSON.stringify(entries, null, 2));
+  } else {
+    renderPortfolio(reads);
+  }
+  throwIfAnyUnread(reads);
+}
+function renderPortfolio(reads) {
+  console.log(`
+Overviews (${reads.length} project${reads.length === 1 ? "" : "s"}):
+`);
+  const cols = { project: 20, mention: 30, branded: 30, cited: 22, share: 42, queries: 22 };
+  console.log(`  ${cell("Project", cols.project)}${cell("Mention \xB7 non-brand", cols.mention)}${cell("Mention \xB7 branded", cols.branded)}${cell("Cited \xB7 all queries", cols.cited)}${cell("Mention share \xB7 scope", cols.share)}${cell("Queries cited \xB7 all", cols.queries)}Latest run`);
+  for (const read of reads) {
+    const project = read.project.displayName || read.project.name;
+    if (!("overview" in read)) {
+      console.log(`  ${cell(project, cols.project)}Couldn't be loaded: ${read.failure.message}`);
+      continue;
+    }
+    const ov = read.overview;
+    const queries = `${ov.queryCounts.citedQueries}/${citedBase(ov.queryCounts.totalQueries, ov.queryCounts.citationNotMeasuredQueries)}`;
+    const latest = ov.latestRun.run?.finishedAt ?? ov.latestRun.run?.createdAt ?? "\u2014";
+    console.log(
+      `  ${cell(project, cols.project)}${cell(mentionCoverageText(ov.mentionCoverage?.populations.find((population) => population.queryClass === "non-brand")?.mentionCoverage), cols.mention)}${cell(mentionCoverageText(ov.mentionCoverage?.populations.find((population) => population.queryClass === "branded")?.mentionCoverage), cols.branded)}${cell(ov.scores.visibility.value, cols.cited)}${cell(`${ov.scores.mentionShare.value} \xB7 ${ov.scores.mentionShare.scope} queries`, cols.share)}${cell(queries, cols.queries)}${latest}`
+    );
+  }
+  const overviews = reads.flatMap((read) => "overview" in read ? [read.overview] : []);
+  if (overviews.length === 0 || overviews.some((ov) => ov.whatChanged !== void 0)) {
+    console.log("\nWhat changed:");
+    const entries = reads.map((read) => ({
+      project: read.project,
+      whatChanged: "overview" in read ? read.overview.whatChanged ?? null : null
+    }));
+    for (const item of portfolioWhatChangedItems(entries)) {
+      console.log(`  ${item.title}: ${item.detail}`);
+    }
+  }
+  console.log();
+}
+function throwIfAnyUnread(reads) {
+  const unread = reads.flatMap((read) => "failure" in read ? [read] : []);
+  if (unread.length === 0) return;
+  const names = unread.map((read) => read.project.name);
+  throw new CliError({
+    code: "OVERVIEW_INCOMPLETE",
+    message: `${unread.length} of ${reads.length} project overviews couldn't be loaded: ${names.join(", ")}`,
+    details: { projects: names },
+    exitCode: unread.some((read) => read.failure.system) ? EXIT_SYSTEM_ERROR : EXIT_USER_ERROR
+  });
+}
+var COMPARISON_UNAVAILABLE_TEXT = {
+  "not-measured": "not measured yet.",
+  "no-previous-check": "nothing earlier to compare the latest check with.",
+  "definition-changed": "not compared: the previous sweep measured another plan definition.",
+  "model-changed": "not compared: the previous sweep asked other engines or models.",
+  "partial-run": "not compared: the latest or previous sweep is partial.",
+  "legacy-plan": "not compared: a schema v1 plan freezes no Property definition. Republish setup.",
+  "unreadable": "not compared: the previous sweep could not be read."
+};
+function lostQueryLine(row) {
+  const where = [row.providers.join(", ")];
+  const locations = row.locations.filter((location) => location !== null);
+  if (locations.length > 0) where.push(`at ${locations.join(", ")}`);
+  if (row.properties.length > 0) where.push(`Properties: ${row.properties.map((property) => property.label).join(", ")}`);
+  if (row.markets.length > 0) where.push(`markets: ${row.markets.map((market) => market.label).join(", ")}`);
+  const queryClass = row.queryClass === null ? "" : ` (${row.queryClass})`;
+  return `      - ${row.query}${queryClass} \u2014 ${where.join(" \xB7 ")}`;
+}
+function printLostQueries(label, signal) {
+  if (signal.queryCount === 0) return;
+  console.log(`    ${label}:`);
+  for (const row of signal.queries) console.log(lostQueryLine(row));
+  if (signal.truncated) console.log(`      \u2026 ${signal.queryCount - signal.queries.length} more not listed`);
+}
+function printWhatChanged(whatChanged) {
+  const { comparison, items } = whatChanged;
+  const status = comparison.state === "unavailable" ? COMPARISON_UNAVAILABLE_TEXT[comparison.reason] : items.length === 0 ? WHAT_CHANGED_ALL_CLEAR_DETAIL : null;
+  console.log(status === null ? "\n  What changed:" : `
+  What changed: ${status}`);
+  for (const item of items) console.log(`    ${item.title}: ${item.detail}`);
+  printLostQueries("Lost mentions", whatChanged.lostMentions);
+  printLostQueries("Lost citations", whatChanged.lostCitations);
+}
+function cell(value, width) {
+  if (value.length >= width) return `${value.slice(0, width - 1)} `;
+  return value.padEnd(width);
+}
+function mentionCoverageText(value) {
+  if (value?.rate === void 0 || value.rate === null) return "Not measured";
+  return `${formatPercent(value.rate, RatioUnits.fraction)} (${value.numerator}/${value.denominator} answers)`;
+}
+function renderHuman(overview) {
+  const {
+    project: meta,
+    latestRun,
+    health,
+    topInsights,
+    queryCounts,
+    providers,
+    transitions,
+    scores,
+    citationMovement,
+    mentionMovement,
+    movementComparison,
+    competitors,
+    providerScores,
+    attentionItems,
+    runHistory,
+    suggestedQueries,
+    dateRangeLabel,
+    contextLabel
+  } = overview;
+  console.log(`Overview: ${meta.displayName ?? meta.name} (${meta.name})`);
+  console.log(`  Domain:   ${meta.canonicalDomain}`);
+  console.log(`  Context:  ${contextLabel} \xB7 ${dateRangeLabel}`);
+  if (latestRun.run) {
+    const finished = latestRun.run.finishedAt ?? "\u2014";
+    console.log(`
+  Latest run: ${latestRun.run.id} (${latestRun.run.status}, ${finished})`);
+    console.log(`  Total runs: ${latestRun.totalRuns}`);
+  } else {
+    console.log("\n  No runs yet.");
+  }
+  const admission = runAdmissionLines(meta.name, latestRun.admission, latestRun.manualAdmission);
+  if (admission.length > 0) console.log(`
+${admission.map((line) => `  ${line}`).join("\n")}`);
+  if (overview.whatChanged) printWhatChanged(overview.whatChanged);
+  console.log("\nScores:");
+  const coverage = overview.mentionCoverage;
+  const nonBrand = coverage?.populations.find((population) => population.queryClass === "non-brand");
+  console.log(`  Mention \xB7 non-brand queries: ${mentionCoverageText(nonBrand?.mentionCoverage)}`);
+  for (const population of coverage?.populations ?? []) {
+    if (population.queryClass === "non-brand" || population.queryCount === 0) continue;
+    console.log(`  Mention \xB7 ${population.queryClass === "unknown" ? "unclassified" : population.queryClass} queries: ${mentionCoverageText(population.mentionCoverage)}`);
+  }
+  if (coverage?.selection.measurement.state === "partial") console.log("    Incomplete sweep; missing answers are not negative results.");
+  printScore("Cited \xB7 all queries", scores.visibility);
+  printScore("Mention share    ", scores.mentionShare);
+  printMentionShareBreakdown(scores.mentionShare);
+  printScore("Mention gaps     ", scores.mentionGaps);
+  printScore("Gap queries      ", scores.gapQueries);
+  printScore("Index coverage   ", scores.indexCoverage);
+  printScore("Competitor press.", scores.competitorPressure);
+  printScore("Run status       ", scores.runStatus);
+  const brandedSentiment = overview.sentiment?.branded;
+  if (overview.sentiment?.configured && brandedSentiment && brandedSentiment.coverage.judged > 0 && brandedSentiment.score.favorableRate !== null) {
+    console.log(`
+  Sentiment: ${brandedSentiment.score.favorableDisplay} favorable \xB7 branded queries`);
+    console.log(`    ${brandedSentiment.coverage.counts.favorable} favorable / ${brandedSentiment.coverage.judged} judged${brandedSentiment.provisional ? " \xB7 provisional" : ""}`);
+  }
+  const notMeasuredQueries = queryCounts.citationNotMeasuredQueries;
+  const notMeasuredNote = notMeasuredQueries > 0 ? `, ${notMeasuredQueries} not measured (no sources)` : "";
+  console.log(queryCounts.citedRate === null ? `
+  Queries cited:     not measured (${notMeasuredQueries} queries, no answer carries sources)` : `
+  Queries cited:     ${queryCounts.citedQueries}/${citedBase(queryCounts.totalQueries, notMeasuredQueries)} (${formatPercent(queryCounts.citedRate)})${notMeasuredNote}`);
+  console.log(`  Queries mentioned: ${queryCounts.mentionedQueries}/${queryCounts.totalQueries} (${formatPercent(queryCounts.mentionRate)})`);
+  if (movementComparison.hasPreviousRun) {
+    const comparisonLabel = movementComparison.querySetChanged ? `changed (+${movementComparison.addedQueryCount} added, -${movementComparison.removedQueryCount} removed); movement compares ${movementComparison.comparableQueryCount} shared` : `unchanged; ${movementComparison.comparableQueryCount} comparable`;
+    console.log(`  Query basket:       ${comparisonLabel}`);
+    console.log(`  Citation movement: +${citationMovement.gained} gained, -${citationMovement.lost} lost (${citationMovement.tone})`);
+    console.log(`  Mention movement:  +${mentionMovement.gained} gained, -${mentionMovement.lost} lost (${mentionMovement.tone})`);
+  } else {
+    console.log("  Movement: first sweep; no comparison yet");
+  }
+  if (providers.length > 0) {
+    console.log("\n  Providers:");
+    for (const p of providers) {
+      console.log(p.citedRate === null ? `    ${p.provider.padEnd(12)} not measured (${p.total} answers without sources)` : `    ${p.provider.padEnd(12)} ${p.cited}/${citedBase(p.total, p.citationNotMeasured)} (${formatPercent(p.citedRate)})`);
+    }
+  }
+  if (providerScores.length > 0) {
+    console.log("\n  Models:");
+    for (const m of providerScores) {
+      const label = `${m.provider}/${m.model ?? "unknown"}`.padEnd(28);
+      console.log(m.score === null ? `    ${label} not measured (${m.total} answers without sources)` : `    ${label} ${m.cited}/${citedBase(m.total, m.citationNotMeasured)} (${formatPercent(m.score, "percent")})`);
+    }
+  }
+  if (transitions.since) {
+    console.log(`
+  Transitions since ${transitions.since}: +${transitions.gained} gained, -${transitions.lost} lost, ${transitions.emerging} emerging`);
+  }
+  if (competitors.length > 0) {
+    console.log("\n  Competitors:");
+    for (const c of competitors) {
+      console.log(`    ${c.domain.padEnd(28)} ${c.citationCount}/${c.totalQueries} ${c.pressureLabel}`);
+    }
+  }
+  if (attentionItems.length > 0) {
+    console.log("\n  Attention:");
+    for (const item of attentionItems) {
+      console.log(`    [${item.actionLabel}] ${item.title}`);
+      if (item.detail) console.log(`        ${item.detail}`);
+    }
+  }
+  if (health) {
+    console.log(health.overallCitedRate === null ? "\n  Health: citations not measured (no answer carries sources)" : `
+  Health: ${formatPercent(health.overallCitedRate)} cited (${health.citedPairs}/${citedBase(health.totalPairs, health.citationNotMeasuredPairs)} pairs)`);
+  }
+  if (topInsights.length > 0) {
+    console.log("\n  Top insights:");
+    for (const insight of topInsights) {
+      console.log(`    [${insight.severity.toUpperCase()}] ${insight.type} \u2014 ${insight.title}`);
+    }
+  }
+  if (runHistory.length > 0) {
+    console.log(`
+  Run history (last ${runHistory.length}):`);
+    for (const point of runHistory) {
+      if (point.citationRate === null) {
+        console.log(`    ${point.createdAt.slice(0, 10)} citations not measured (no answer carries sources)`);
+        continue;
+      }
+      const bar = "\u2588".repeat(Math.round(point.citationRate / 10));
+      console.log(`    ${point.createdAt.slice(0, 10)} ${formatPercent(point.citationRate, "percent").padStart(6)} ${bar}`);
+    }
+  }
+  if (suggestedQueries.rows.length > 0) {
+    const moreLabel = suggestedQueries.totalCandidates > suggestedQueries.rows.length ? ` (showing ${suggestedQueries.rows.length} of ${suggestedQueries.totalCandidates})` : "";
+    console.log(`
+  Suggested queries to track${moreLabel}:`);
+    for (const s of suggestedQueries.rows) {
+      console.log(`    + ${s.query}`);
+      console.log(`        ${s.reason}`);
+    }
+    console.log(`    (add via: canonry query add ${meta.name} "<query>")`);
+  }
+}
+function printScore(prefix, score) {
+  const tone = `[${score.tone}]`.padEnd(11);
+  const value = score.value.padEnd(8);
+  console.log(`  ${prefix} ${tone} ${value} ${score.delta}`);
+}
+function printMentionShareBreakdown(mentionShare) {
+  const legacyCompatible = mentionShare.breakdown;
+  const ranking = legacyCompatible.ranking ?? [];
+  const project = ranking.find((row) => row.kind === "project");
+  if (!project) return;
+  const competitors = ranking.filter((row) => row.kind === "competitor");
+  console.log(`      you${" ".repeat(28)} ${project.mentionSnapshots} mentions (${formatPercent(project.share)} of combined)`);
+  for (const row of competitors.slice(0, 3)) {
+    console.log(`      ${(row.domain ?? "").padEnd(30)} ${row.mentionSnapshots} mentions (${formatPercent(row.share)} of combined)`);
+  }
+  if (competitors.length > 3) {
+    console.log(`      + ${competitors.length - 3} more competitor${competitors.length - 3 === 1 ? "" : "s"} (--format json for full breakdown)`);
+  }
+}
+export {
+  showAllOverviews,
+  showOverview
+};

package/dist/{project-NYUWICVC.js → project-WZ2YXFPJ.js}

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -24,7 +24,7 @@ import {
   normalizeProjectDomain,
   resolveNegativeReviewMaxStars,
   resolveProjectQualifiedAliases
-} from "./chunk-ZBTUISPG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/project.ts
@@ -131,7 +131,7 @@ async function showProject(name, format) {
   console.log(`  Dispatch modes:   ${dispatchModes.length > 0 ? `${dispatchModes.map(([provider, mode]) => `${provider}=${mode}`).join(", ")} (scheduled sweeps; others sync)` : "(none; every provider runs sync)"}`);
   console.log(`  Negative reviews: ${resolveNegativeReviewMaxStars(project.negativeReviewMaxStars)} stars or fewer${project.negativeReviewMaxStars == null ? " (default)" : ""}`);
   if (project.siteAuditMaxPages !== void 0) {
-    console.log(`  Site Health page budget: ${formatSiteAuditPageBudget(project.siteAuditMaxPages)}`);
+    console.log(`  Agent Readiness page budget: ${formatSiteAuditPageBudget(project.siteAuditMaxPages)}`);
   }
   if (project.competitorAutoAliases !== void 0) {
     console.log(`  Competitor auto aliases: ${formatCompetitorAutoAliasMode(project.competitorAutoAliases)}`);

package/dist/project-setup-WV6SPGIV.js

@@ -0,0 +1,176 @@
+import {
+  createApiClient
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
+import "./chunk-AOJU5LKX.js";
+import {
+  isMachineFormat
+} from "./chunk-HGMYEDAQ.js";
+import {
+  AiVisibilitySetupBlockers,
+  ProjectSetupNextActions,
+  SITE_AUDIT_ONBOARDING_PAGE_LIMIT,
+  SetupTrackStates,
+  defaultProviderDisplayName,
+  providerConnectionName,
+  providerFailureRemedy,
+  shellQuote,
+  siteAuditRunPhaseSchema
+} from "./chunk-O7S7OHLE.js";
+import "./chunk-MLKGABMK.js";
+
+// src/commands/project-setup.ts
+var TRACK_STATE_LABELS = {
+  [SetupTrackStates.not_started]: "Not started",
+  [SetupTrackStates.queued]: "Queued",
+  [SetupTrackStates.running]: "Running",
+  [SetupTrackStates.completed]: "Complete",
+  [SetupTrackStates.partial]: "Partial results",
+  [SetupTrackStates.failed]: "Failed",
+  [SetupTrackStates.cancelled]: "Cancelled"
+};
+var TRACK_NAME_WIDTH = "Agent Readiness".length + 3;
+async function showProjectSetup(name, format) {
+  const setup = await createApiClient().getProjectSetup(name);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(setup, null, 2));
+    return;
+  }
+  for (const line of projectSetupLines(setup)) console.log(line);
+}
+function projectSetupLines(setup) {
+  const { agentReadiness, aiVisibility } = setup.tracks;
+  const brand = setup.project.displayName ?? setup.project.name;
+  const rows = [
+    { name: "Agent Readiness", state: agentReadiness.state, lines: agentReadinessLines(agentReadiness) },
+    { name: "AI Visibility", state: aiVisibility.state, lines: aiVisibilityLines(aiVisibility) }
+  ];
+  const badgeWidth = Math.max(...rows.map((row) => TRACK_STATE_LABELS[row.state].length)) + 3;
+  const continuation = " ".repeat(2 + TRACK_NAME_WIDTH + badgeWidth);
+  return [
+    `${brand} (${setup.project.canonicalDomain})${setup.complete ? " \xB7 setup complete" : ""}`,
+    ...rows.flatMap((row) => row.lines.map((line, index) => index === 0 ? `  ${row.name.padEnd(TRACK_NAME_WIDTH)}${TRACK_STATE_LABELS[row.state].padEnd(badgeWidth)}${line}` : `${continuation}${line}`)),
+    `Next: ${nextStep(setup)}`
+  ];
+}
+function agentReadinessLines(track) {
+  switch (track.state) {
+    case SetupTrackStates.not_started:
+      return [`Reads up to ${SITE_AUDIT_ONBOARDING_PAGE_LIMIT} public pages. No AI engine needed.`];
+    case SetupTrackStates.queued:
+      return ["Waiting to start"];
+    case SetupTrackStates.running: {
+      const progress = track.progress;
+      if (progress?.phase === siteAuditRunPhaseSchema.enum.checking) {
+        return [`Checking pages \xB7 ${progress.pagesChecked}${progress.pageLimit === null ? "" : ` of up to ${progress.pageLimit}`}`];
+      }
+      return [`Finding pages${progress?.pagesFound == null ? "" : ` \xB7 ${progress.pagesFound} found`}`];
+    }
+    case SetupTrackStates.completed:
+    case SetupTrackStates.partial:
+      return [track.result?.score == null ? "No page was scored." : `Score ${track.result.score}/100 \xB7 ${track.result.pagesScored} ${track.result.pagesScored === 1 ? "page" : "pages"} scored`];
+    case SetupTrackStates.failed:
+      return [`The scan did not finish.${track.error ? ` ${track.error}` : ""}`];
+    case SetupTrackStates.cancelled:
+      return ["The scan was cancelled."];
+  }
+}
+function blockerLine(blocker) {
+  switch (blocker) {
+    case AiVisibilitySetupBlockers.no_engine:
+      return "Needs an AI engine.";
+    case AiVisibilitySetupBlockers.no_queries:
+      return "Add queries to check.";
+    case AiVisibilitySetupBlockers.plan_unpublished:
+      return "Publish the Advanced Measurement plan before the first check.";
+    case AiVisibilitySetupBlockers.engines_failing:
+      return "Every AI engine it would ask keeps failing on its account.";
+  }
+}
+function trackedQueriesLine(queries) {
+  const classes = [`${queries.nonBrand} non-brand`, `${queries.branded} branded`];
+  if (queries.unclassified > 0) classes.push(`${queries.unclassified} without a class`);
+  return `${queries.total} ${queries.total === 1 ? "query" : "queries"} tracked: ${classes.join(", ")}`;
+}
+function signalCounts(counts) {
+  if (counts.totalQueries === 0) return "none in this check";
+  const citedTotal = counts.totalQueries - (counts.citationNotMeasuredQueries ?? 0);
+  const cited = citedTotal === 0 ? "citations not measured" : `cited in ${counts.citedQueries} of ${citedTotal}`;
+  return `mentioned in ${counts.mentionedQueries} of ${counts.totalQueries}, ${cited}`;
+}
+function resultLines(result, isBaseline) {
+  const lines = [`${isBaseline ? "Baseline" : "Latest check"} \xB7 ${result.answers} ${result.answers === 1 ? "answer" : "answers"} from ${result.engines} ${result.engines === 1 ? "engine" : "engines"}`];
+  if (result.queryCountsByClass) {
+    lines.push(`Non-brand queries: ${signalCounts(result.queryCountsByClass.nonBrand)}`);
+    lines.push(`Branded queries: ${signalCounts(result.queryCountsByClass.branded)}`);
+    if (result.queryCountsByClass.unclassifiedQueries > 0) {
+      const unclassified = result.queryCountsByClass.unclassifiedQueries;
+      lines.push(`${unclassified} ${unclassified === 1 ? "query" : "queries"} without a class, counted in neither`);
+    }
+  } else if (result.queryCounts) {
+    lines.push(`All queries, pooled (no query has a class): ${signalCounts(result.queryCounts)}`);
+  }
+  return lines;
+}
+function failureLines(track) {
+  return Object.entries(track.providerFailures ?? {}).map(([engine, failure]) => `${engine}: ${failure.failedQueries} ${failure.failedQueries === 1 ? "query" : "queries"} failed${failure.stopped ? ", so this check stopped asking it" : ""}. ${failure.message}`);
+}
+function aiVisibilityLines(track) {
+  switch (track.state) {
+    case SetupTrackStates.not_started:
+      if (track.blockedBy) return [blockerLine(track.blockedBy)];
+      return [track.engines.length > 0 ? `Ready to ask ${track.engines.join(", ")}` : "Ready to check", trackedQueriesLine(track.queries)];
+    case SetupTrackStates.queued:
+      return ["Waiting to start", ...failureLines(track)];
+    case SetupTrackStates.running: {
+      const saved = track.progress?.answersSaved ?? 0;
+      const planned = track.progress?.answersPlanned ?? null;
+      const engines = track.engines.length > 0 ? `Asking ${track.engines.join(", ")}` : "Asking engines";
+      return [
+        planned === null ? `${engines} \xB7 ${saved} ${saved === 1 ? "answer" : "answers"} saved` : `${engines} \xB7 ${saved} of ${planned} ${planned === 1 ? "answer" : "answers"} saved`,
+        ...failureLines(track)
+      ];
+    }
+    case SetupTrackStates.completed:
+    case SetupTrackStates.partial:
+      return track.result ? resultLines(track.result, track.runId !== null && track.runId === track.baselineRunId) : ["Result unavailable"];
+    case SetupTrackStates.failed: {
+      const engines = track.failedEngines ?? [];
+      if (engines.length === 0) return [`The check did not finish.${track.error ? ` ${track.error}` : ""}`];
+      return ["The check did not finish.", ...engines.flatMap((engine) => {
+        const remedy = providerFailureRemedy(engine.code, defaultProviderDisplayName(providerConnectionName(engine.provider)));
+        return [`${engine.provider}: ${engine.message}`, ...remedy ? [remedy] : []];
+      })];
+    }
+    case SetupTrackStates.cancelled:
+      return ["The check was cancelled.", ...track.blockedBy ? [blockerLine(track.blockedBy)] : []];
+  }
+}
+function nextStep(setup) {
+  const project = shellQuote(setup.project.name);
+  const scan = `cnry agent-readiness run ${project} --max-pages ${SITE_AUDIT_ONBOARDING_PAGE_LIMIT}`;
+  const aiVisibility = setup.tracks.aiVisibility;
+  switch (setup.nextAction) {
+    case ProjectSetupNextActions.run_agent_readiness:
+      return `run the Agent Readiness audit scan: ${scan}`;
+    case ProjectSetupNextActions.retry_agent_readiness:
+      return `run the audit scan again: ${scan}`;
+    case ProjectSetupNextActions.connect_engine:
+      return "connect an AI engine: cnry settings provider <name> --api-key <key>";
+    case ProjectSetupNextActions.add_queries:
+      return `add queries: cnry query add ${project} "<query>"`;
+    case ProjectSetupNextActions.publish_plan:
+      return `publish the Advanced Measurement draft: cnry measurement-plan advanced ${project} draft-action <json>, with action "publish"`;
+    case ProjectSetupNextActions.run_ai_visibility:
+      return `run the AI Visibility check (cnry run preview ${project} shows what it will ask): cnry run ${project}`;
+    case ProjectSetupNextActions.repair_ai_visibility:
+      return aiVisibility.state === SetupTrackStates.failed && aiVisibility.runId ? `see why the check failed, then fix the engine: cnry run show ${shellQuote(aiVisibility.runId)}` : "fix the failing engine's key, access or billing, then save it: cnry settings provider <name> --api-key <key>";
+    case ProjectSetupNextActions.wait:
+      return `wait for the work in progress, then check again: cnry project setup ${project}`;
+    case ProjectSetupNextActions.open_project:
+      return `read the results: cnry overview ${project}`;
+  }
+}
+export {
+  showProjectSetup
+};

package/dist/{query-3CRRDOHD.js → query-WAFJKDHG.js}

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -12,7 +12,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   reportedQueryClasses
-} from "./chunk-ZBTUISPG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/query.ts

package/dist/{research-ZULVD3TW.js → research-B5ZPQX7R.js}

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-OL2L5ANJ.js";
-import "./chunk-BLW327AU.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -18,7 +18,7 @@ import {
   answerCompletionLabel,
   answerCostBasisLabel,
   researchBatchCreateSchema
-} from "./chunk-ZBTUISPG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/research.ts