@canonry/canonry 7.99.0 → 7.100.0

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-Y47IEFKJ.js → query-WAFJKDHG.js}

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-AJD252SX.js";
-import "./chunk-3MFYM2IS.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-47X24IJG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/query.ts

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

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-AJD252SX.js";
-import "./chunk-3MFYM2IS.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-47X24IJG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/research.ts

package/dist/{results-export-KBHOBQAH.js → results-export-NIZV6R3K.js}

@@ -1,10 +1,10 @@
 import {
   createApiClient
-} from "./chunk-AJD252SX.js";
-import "./chunk-3MFYM2IS.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import "./chunk-AOJU5LKX.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-47X24IJG.js";
+import "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/results-export.ts

package/dist/{run-4CYHVIIU.js → run-ICLPZ7QT.js}

@@ -2,6 +2,7 @@ import {
   cancelRun,
   fillRun,
   listRuns,
+  previewRun,
   printRunDetail,
   providerAccountStreakLine,
   runAdmissionLines,
@@ -9,18 +10,20 @@ import {
   showRunCompleteness,
   triggerRun,
   triggerRunAll
-} from "./chunk-WXAF7AMC.js";
-import "./chunk-AJD252SX.js";
-import "./chunk-3MFYM2IS.js";
+} from "./chunk-NQYJHKML.js";
+import "./chunk-J6536OL6.js";
+import "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import "./chunk-Z7IUAJOF.js";
 import "./chunk-AOJU5LKX.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-47X24IJG.js";
+import "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 export {
   cancelRun,
   fillRun,
   listRuns,
+  previewRun,
   printRunDetail,
   providerAccountStreakLine,
   runAdmissionLines,

package/dist/{schedule-GY4P3RON.js → schedule-4C44LQ7R.js}

@@ -1,7 +1,7 @@
 import {
   createApiClient
-} from "./chunk-AJD252SX.js";
-import "./chunk-3MFYM2IS.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -10,10 +10,28 @@ import {
   isMachineFormat,
   usageError
 } from "./chunk-HGMYEDAQ.js";
-import "./chunk-47X24IJG.js";
+import {
+  formatZonedTimestamp,
+  schedulePreviewRequestSchema
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/schedule.ts
+async function previewSchedule(project, timing, format) {
+  const parsed = schedulePreviewRequestSchema.safeParse(timing);
+  if (!parsed.success) throw usageError("Invalid schedule timing", { message: parsed.error.issues.map((issue) => issue.message).join("; ") });
+  const preview = await getClient().previewSchedule(project, parsed.data);
+  if (format === "jsonl") {
+    emitJsonl([preview]);
+    return;
+  }
+  if (format === "json") {
+    console.log(JSON.stringify(preview, null, 2));
+    return;
+  }
+  console.log(`Next run: ${preview.nextRunAt ? formatZonedTimestamp(preview.nextRunAt, preview.timezone) : "No future occurrence"}`);
+  console.log("Preview only. No schedule was saved or enabled.");
+}
 async function listSchedules(project, format) {
   const schedules = await getClient().listSchedules(project);
   if (format === "jsonl") {
@@ -185,6 +203,7 @@ export {
   enableSchedule,
   formatNextRun,
   listSchedules,
+  previewSchedule,
   printSchedule,
   removeSchedule,
   setSchedule,

package/dist/{search-AGVNZMJQ.js → search-UJM7KII3.js}

@@ -1,15 +1,22 @@
 import {
   createApiClient
-} from "./chunk-AJD252SX.js";
-import "./chunk-3MFYM2IS.js";
+} from "./chunk-UGO2FO6V.js";
+import "./chunk-EE3QTCLS.js";
 import "./chunk-AOJU5LKX.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
-import "./chunk-47X24IJG.js";
+import {
+  CitationStates
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/search.ts
+var CITATION_STATE_LABEL = {
+  [CitationStates.cited]: "cited",
+  [CitationStates["not-cited"]]: "not-cited",
+  [CitationStates["not-measured"]]: "citation not measured"
+};
 async function searchProject(project, opts) {
   const client = createApiClient();
   const result = await client.searchProject(project, { q: opts.query, limit: opts.limit });
@@ -25,7 +32,7 @@ async function searchProject(project, opts) {
   }
   for (const hit of result.hits) {
     if (hit.kind === "snapshot") {
-      console.log(`  [snapshot] ${hit.query} (${hit.provider}, ${hit.citationState}) \u2014 ${hit.matchedField}`);
+      console.log(`  [snapshot] ${hit.query} (${hit.provider}, ${CITATION_STATE_LABEL[hit.citationState]}) \u2014 ${hit.matchedField}`);
       console.log(`    ${hit.snippet}`);
       console.log(`    run=${hit.runId}  at ${hit.createdAt}`);
     } else {

package/dist/{serve-5LFKIXNL.js → serve-A6UIO6WP.js}

@@ -1,7 +1,7 @@
 import {
   backfillAiReferralPaths,
   backfillNormalizedPaths
-} from "./chunk-74V5EPZH.js";
+} from "./chunk-BKDRT4VS.js";
 import {
   operatorHttpUrl
 } from "./chunk-6GO5VVAC.js";
@@ -9,24 +9,24 @@ import {
   allowsKeylessFirstRunSetup,
   createServer,
   waitForServerRuntimeStartup
-} from "./chunk-XPIMVXAI.js";
-import "./chunk-5ZOM5BJS.js";
-import "./chunk-3MKJ4LP6.js";
-import "./chunk-DMPSA7ZS.js";
+} from "./chunk-7J2RIIYU.js";
+import "./chunk-KVRX7YIH.js";
+import "./chunk-HL2LGRTI.js";
+import "./chunk-56VVRWJM.js";
 import "./chunk-ELCLGWUT.js";
 import "./chunk-XEBKF4N5.js";
-import "./chunk-PT5HNVCM.js";
-import "./chunk-RRXLJPBN.js";
+import "./chunk-VHULVUDL.js";
+import "./chunk-YIIRS7V7.js";
 import {
   trackFeatureCompleted
-} from "./chunk-VADVPARO.js";
+} from "./chunk-DHIB7EIA.js";
 import {
   isLoopbackBindHost,
   resolveServePort
 } from "./chunk-TSENU4GG.js";
 import {
   registeredProviderNames
-} from "./chunk-O6RXNSNW.js";
+} from "./chunk-COHSL6KW.js";
 import {
   cliRuntimeContext,
   getPrintedUpdateAvailable,
@@ -34,45 +34,45 @@ import {
   isTelemetryEnabled,
   setTelemetrySource,
   trackEvent
-} from "./chunk-C55P75G4.js";
-import "./chunk-WA6APXI6.js";
-import "./chunk-MTW37GXF.js";
-import "./chunk-AJD252SX.js";
+} from "./chunk-AMGM55CP.js";
+import "./chunk-G6QN4VFS.js";
+import "./chunk-2FWYWGIR.js";
+import "./chunk-UGO2FO6V.js";
 import {
   getConfigDir,
   getConfigPath,
   loadConfig,
   saveConfigPatch
-} from "./chunk-3MFYM2IS.js";
+} from "./chunk-EE3QTCLS.js";
 import {
   getMissingUserSkillsNudge,
   shouldPrintServeSkillsNudge
-} from "./chunk-P764TJKQ.js";
-import "./chunk-SY3CWJR4.js";
-import "./chunk-DLOWRO5R.js";
-import "./chunk-3WDQ5GPO.js";
-import "./chunk-YACKJGY4.js";
+} from "./chunk-FBO25TA3.js";
+import "./chunk-FZ3MUTU3.js";
+import "./chunk-F46TBLXK.js";
+import "./chunk-DGDLLRS4.js";
+import "./chunk-7BEGCVVB.js";
 import "./chunk-AOJU5LKX.js";
 import {
   CliError,
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
-import "./chunk-LM7HTNUO.js";
-import "./chunk-YBWATBX4.js";
-import "./chunk-UY6SKAKW.js";
+import "./chunk-SWZXHHAG.js";
+import "./chunk-HBHLYWKE.js";
+import "./chunk-7SNMIXEQ.js";
 import {
   refreshSnapshotMentionIdentity,
   snapshotsWithSentimentResults
-} from "./chunk-ZGBLNKFN.js";
-import "./chunk-YEUULP44.js";
-import "./chunk-3VPBRGPN.js";
+} from "./chunk-YGAQQSCL.js";
+import "./chunk-LNVFERI4.js";
+import "./chunk-LJO2BKWU.js";
 import {
   createClient,
   dataRepairCompletions,
   migrate,
   projects,
   runs
-} from "./chunk-L53ZSQN5.js";
+} from "./chunk-2DV7F6XA.js";
 import {
   OutcomeReasonCodes,
   OutcomeTriggers,
@@ -82,7 +82,7 @@ import {
   URL_PATH_NORMALIZATION_VERSION,
   classifyOutcomeError,
   describeError
-} from "./chunk-47X24IJG.js";
+} from "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/serve.ts
@@ -482,10 +482,11 @@ function readServeOpenState(db) {
 }
 function buildServeOpenLine(input) {
   if (input.projectCount === 0) {
-    return `Open ${input.url}/setup to map your site and run your first Page Health scan.`;
+    return `Open ${input.url}/setup to set up your first project: a free Agent Readiness audit scan, then AI Visibility.`;
   }
   if (!input.hasSiteAudit && input.firstProjectName) {
-    return `Open ${input.url}/setup?onboarding=site-health&setupProject=${encodeURIComponent(input.firstProjectName)} to run your first Page Health scan.`;
+    const firstRun = input.projectCount === 1 ? "&onboarding=first-run" : "";
+    return `Open ${input.url}/setup?project=${encodeURIComponent(input.firstProjectName)}${firstRun} to run its first Agent Readiness audit scan.`;
   }
   return `Open ${input.url}`;
 }

package/dist/{session-YAYEDM3P.js → session-RTE22GQT.js}

@@ -9,28 +9,28 @@ import {
   resolveAeroModel,
   resolveConfiguredAgentProvider,
   resolveSessionProviderAndModel
-} from "./chunk-3MKJ4LP6.js";
-import "./chunk-DMPSA7ZS.js";
+} from "./chunk-KVRX7YIH.js";
+import "./chunk-56VVRWJM.js";
 import {
   resolveAeroSkillDir
-} from "./chunk-MTW37GXF.js";
-import "./chunk-AJD252SX.js";
+} from "./chunk-2FWYWGIR.js";
+import "./chunk-UGO2FO6V.js";
 import {
   AgentProviders,
   coerceAgentProvider,
   listAgentProviders
-} from "./chunk-3MFYM2IS.js";
-import "./chunk-DLOWRO5R.js";
-import "./chunk-3WDQ5GPO.js";
-import "./chunk-YACKJGY4.js";
+} from "./chunk-EE3QTCLS.js";
+import "./chunk-F46TBLXK.js";
+import "./chunk-DGDLLRS4.js";
+import "./chunk-7BEGCVVB.js";
 import "./chunk-AOJU5LKX.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-UY6SKAKW.js";
-import "./chunk-ZGBLNKFN.js";
-import "./chunk-YEUULP44.js";
-import "./chunk-3VPBRGPN.js";
-import "./chunk-L53ZSQN5.js";
-import "./chunk-47X24IJG.js";
+import "./chunk-7SNMIXEQ.js";
+import "./chunk-YGAQQSCL.js";
+import "./chunk-LNVFERI4.js";
+import "./chunk-LJO2BKWU.js";
+import "./chunk-2DV7F6XA.js";
+import "./chunk-O7S7OHLE.js";
 import "./chunk-MLKGABMK.js";
 export {
   AgentProviders,