@ainyc/canonry 4.157.0 → 4.159.0

package/dist/{chunk-KMTRO56O.js → chunk-ZEG43TY2.js}

@@ -81,7 +81,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-TRRVBTU5.js";
+} from "./chunk-ZL3VY435.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1160,6 +1160,18 @@ var postApiV1ProjectsByNameGoogleGscSitemapsSubmit = (options) => {
     }
   });
 };
+var getApiV1Projects = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects",
+    ...options
+  });
+};
 var deleteApiV1ProjectsByName = (options) => {
   return (options.client ?? client).delete({
     security: [
@@ -1992,18 +2004,6 @@ var postApiV1ProjectsByNameMeasurementQueryTemplatesByTemplateIdApply = (options
     }
   });
 };
-var getApiV1Projects = (options) => {
-  return (options?.client ?? client).get({
-    security: [
-      {
-        scheme: "bearer",
-        type: "http"
-      }
-    ],
-    url: "/api/v1/projects",
-    ...options
-  });
-};
 var getApiV1ProjectsByNameDeletePreview = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -5068,6 +5068,18 @@ var postApiV1ProjectsByNameTechnicalAeoRuns = (options) => {
     }
   });
 };
+var getApiV1ProjectsByNameTechnicalAeoRunsByRunIdProgress = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/technical-aeo/runs/{runId}/progress",
+    ...options
+  });
+};
 var deleteApiV1ProjectsByNameAgentTranscript = (options) => {
   return (options.client ?? client).delete({
     security: [
@@ -7195,6 +7207,15 @@ var ApiClient = class {
       })
     );
   }
+  /** Exact durable counters and lifecycle state for one non-probe site-audit run. */
+  async getTechnicalAeoProgress(project, runId) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameTechnicalAeoRunsByRunIdProgress({
+        client: this.heyClient,
+        path: { name: project, runId }
+      })
+    );
+  }
   /** Persisted full-crawl metadata. This never synthesizes a graph from legacy audit rows. */
   async getTechnicalAeoCrawl(project, opts) {
     return this.invoke(
@@ -7315,6 +7336,7 @@ var ApiClient = class {
           sourceUrl: opts?.sourceUrl,
           targetUrl: opts?.targetUrl,
           followable: opts?.followable,
+          linkKind: opts?.linkKind,
           cursor: opts?.cursor,
           limit: opts?.limit !== void 0 ? String(opts.limit) : void 0
         }
@@ -7331,6 +7353,7 @@ var ApiClient = class {
           runId: opts.runId,
           nodeKey: opts.nodeKey,
           url: opts.url,
+          linkKind: opts.linkKind,
           limit: opts.limit !== void 0 ? String(opts.limit) : void 0
         }
       })
@@ -8593,12 +8616,16 @@ var technicalAeoStructureInputSchema = z3.object({
   cursor: z3.string().min(1).optional().describe("Opaque cursor from the previous structure result."),
   limit: z3.number().int().positive().max(100).optional()
 });
+var linkKindSchema = z3.enum(["all", "content", "template"]).optional().describe(
+  "Restrict to content links (excludes nav, header, and footer links) or to template links only. Defaults to all. Check templateDetection before reading an empty content list as a real zero."
+);
 var technicalAeoInternalLinksInputSchema = z3.object({
   project: projectNameSchema,
   runId: runIdSchema.optional(),
   sourceUrl: z3.string().url().optional(),
   targetUrl: z3.string().url().optional(),
   followable: z3.boolean().optional(),
+  linkKind: linkKindSchema,
   cursor: z3.string().min(1).optional().describe("Opaque cursor from the previous internal-links result."),
   limit: z3.number().int().positive().max(200).optional()
 });
@@ -8607,6 +8634,7 @@ var technicalAeoLinkNeighborsInputSchema = z3.object({
   runId: runIdSchema.optional(),
   nodeKey: z3.string().min(1).optional(),
   url: z3.string().url().optional(),
+  linkKind: linkKindSchema,
   limit: z3.number().int().positive().max(100).optional()
 }).refine((value) => Boolean(value.nodeKey || value.url), {
   message: "Provide nodeKey or url.",
@@ -10603,7 +10631,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_technical_aeo_internal_links",
     title: "List Technical AEO internal links",
-    description: "Read a bounded, cursor-paged list of persisted internal crawl edges. Filter by source URL, target URL, or followability. Use the neighbors tool for one page rather than loading a graph.",
+    description: "Read a bounded, cursor-paged list of persisted internal crawl edges. Filter by source URL, target URL, followability, or link kind. Nav, header, and footer links are marked isTemplate; templateDetection reports whether that classification ran, so an empty content-only list is not evidence of no content links. Use the neighbors tool for one page rather than loading a graph.",
     access: "read",
     tier: "monitoring",
     inputSchema: technicalAeoInternalLinksInputSchema,
@@ -10614,6 +10642,7 @@ var canonryMcpTools = [
       sourceUrl: input.sourceUrl,
       targetUrl: input.targetUrl,
       followable: input.followable,
+      linkKind: input.linkKind,
       cursor: input.cursor,
       limit: input.limit
     })
@@ -10621,7 +10650,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_technical_aeo_link_neighbors",
     title: "Get Technical AEO page link neighbors",
-    description: "Read bounded inbound and outbound internal links for exactly one crawl node, selected by nodeKey or URL. It returns independent truncation flags for inbound and outbound edges, not a transitive traversal.",
+    description: "Read bounded inbound and outbound internal links for exactly one crawl node, selected by nodeKey or URL. Filter by link kind to separate editorial links from nav, header, and footer links. It returns independent truncation flags for inbound and outbound edges, not a transitive traversal.",
     access: "read",
     tier: "monitoring",
     inputSchema: technicalAeoLinkNeighborsInputSchema,
@@ -10631,6 +10660,7 @@ var canonryMcpTools = [
       runId: input.runId,
       nodeKey: input.nodeKey,
       url: input.url,
+      linkKind: input.linkKind,
       limit: input.limit
     })
   }),

package/dist/{chunk-TRRVBTU5.js → chunk-ZL3VY435.js}

@@ -3518,6 +3518,12 @@ var projectUpsertRequestSchema = z3.object({
   autoExtractBacklinks: z3.boolean().optional(),
   configSource: configSourceSchema.optional()
 });
+var projectCreateRequestSchema = projectUpsertRequestSchema.extend({
+  name: z3.string().trim().min(1).max(120)
+});
+function normalizeProjectName(input) {
+  return input.trim().normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
 var projectDtoSchema = z3.object({
   id: z3.string(),
   name: z3.string(),
@@ -5428,6 +5434,7 @@ var auditLogEntrySchema = z8.object({
 // ../contracts/src/scopes.ts
 var READ_ONLY_SCOPE = "read";
 var WILDCARD_SCOPE = "*";
+var PROJECTS_WRITE_SCOPE = "projects.write";
 var ADS_WRITE_SCOPE = "ads.write";
 var ADS_APPROVE_SCOPE = "ads.approve";
 var ADS_ACTIVATE_SCOPE = "ads.activate";
@@ -8486,7 +8493,7 @@ var siteAuditScoreSchema = z24.object({
   pagesErrored: z24.number().int().nonnegative(),
   /** `aggregateScore - previousScore`, or `null` when there is no prior run. */
   deltaScore: z24.number().nullable(),
-  trend: siteAuditTrendDirectionSchema.nullable(),
+  trend: z24.union([siteAuditTrendDirectionSchema, z24.null()]),
   previousScore: z24.number().nullable(),
   previousAuditedAt: z24.string().nullable(),
   factors: z24.array(siteAuditFactorSummarySchema).default([]),
@@ -8561,7 +8568,37 @@ var siteCrawlSummarySchema = z24.object({
   counts: siteCrawlCountsSchema,
   deadLinks: siteCrawlDeadLinksSummarySchema
 });
-var siteHealthStateSchema = z24.enum(["eligible", "hidden", "failed", "unchecked"]);
+var siteCrawlTerminationSchema = z24.enum([
+  "complete",
+  "unknown",
+  "max-pages",
+  "max-edges",
+  "max-fetches",
+  "max-duration",
+  "max-bytes",
+  "max-page-bytes",
+  "max-depth",
+  "max-links-per-page",
+  "max-query-variants",
+  "max-sitemap-fanout",
+  "max-sitemap-urls",
+  "root-host-redirect"
+]);
+function isSelfLink(sourceUrl, targetUrl) {
+  return sourceUrl === targetUrl;
+}
+var siteHealthStateSchema = z24.enum([
+  "eligible",
+  "hidden",
+  /** Fetched, but not an HTML page: a text file, a PDF, an image. Not a fault. */
+  "resource",
+  /** Fetched and redirected elsewhere. Moved, not hidden. */
+  "redirect",
+  "failed",
+  "unchecked"
+]);
+var SiteHealthStates = siteHealthStateSchema.enum;
+var SITE_GRAPH_LEGEND_STATES = siteHealthStateSchema.options;
 var SiteCrawlFetchStates = {
   discovered: "discovered",
   robotsBlocked: "robots-blocked",
@@ -8599,9 +8636,16 @@ function deriveSiteHealthState(input) {
       return "failed";
     case SiteCrawlFetchStates.discovered:
       return "unchecked";
+    // A non-HTML resource was fetched successfully. It is simply not a page,
+    // which is a fact about its type, not a problem with the site.
+    case SiteCrawlFetchStates.nonHtml:
+      return "resource";
+    // A redirect moved; nothing about it says "do not index me".
     case SiteCrawlFetchStates.redirect:
+      return "redirect";
+    // robots.txt IS the site telling engines not to fetch this, so it is the
+    // one fetch state that genuinely belongs with the hidden pages.
     case SiteCrawlFetchStates.robotsBlocked:
-    case SiteCrawlFetchStates.nonHtml:
       return "hidden";
     case SiteCrawlFetchStates.html:
       break;
@@ -8620,6 +8664,56 @@ function deriveSiteHealthState(input) {
       return "unchecked";
   }
 }
+var TEMPLATE_LINK_RATIO_THRESHOLD = 0.7;
+var TEMPLATE_LINK_MIN_FETCHED_PAGES = 15;
+var siteHealthTemplateDetectionSchema = z24.enum([
+  "applied",
+  "unavailable-too-few-pages",
+  "unavailable-legacy-scan"
+]);
+var SiteHealthTemplateDetections = siteHealthTemplateDetectionSchema.enum;
+var siteHealthLinkKindSchema = z24.enum(["all", "content", "template"]);
+var SiteHealthLinkKinds = siteHealthLinkKindSchema.enum;
+function normalizeTemplateAnchorText(anchor) {
+  return anchor.trim().replace(/\s+/gu, " ").toLowerCase();
+}
+function createTemplateLinkPairIndex() {
+  return { sourcePagesByPair: /* @__PURE__ */ new Map() };
+}
+function templateLinkPairKey(targetNodeKey, normalizedAnchor) {
+  return `${targetNodeKey}${normalizedAnchor}`;
+}
+function observeTemplateLinkEdges(index, edges) {
+  for (const edge of edges) {
+    if (edge.targetNodeKey == null) continue;
+    for (const anchor of edge.anchors) {
+      const key = templateLinkPairKey(edge.targetNodeKey, normalizeTemplateAnchorText(anchor));
+      const sources = index.sourcePagesByPair.get(key);
+      if (sources) sources.add(edge.sourceNodeKey);
+      else index.sourcePagesByPair.set(key, /* @__PURE__ */ new Set([edge.sourceNodeKey]));
+    }
+  }
+}
+function templateLinkRatio(index, pagesFetched, edge) {
+  if (edge.targetNodeKey == null || edge.anchors.length === 0) return null;
+  if (!Number.isFinite(pagesFetched) || pagesFetched <= 0) return null;
+  let least = null;
+  for (const anchor of edge.anchors) {
+    const sources = index.sourcePagesByPair.get(
+      templateLinkPairKey(edge.targetNodeKey, normalizeTemplateAnchorText(anchor))
+    );
+    if (!sources) continue;
+    const ratio = Math.min(1, sources.size / pagesFetched);
+    if (least == null || ratio < least) least = ratio;
+  }
+  return least == null ? null : Math.round(least * 1e6) / 1e6;
+}
+function isTemplateLinkRatio(ratio) {
+  return ratio != null && ratio >= TEMPLATE_LINK_RATIO_THRESHOLD;
+}
+function templateLinkDetection(pagesFetched) {
+  return Number.isFinite(pagesFetched) && pagesFetched >= TEMPLATE_LINK_MIN_FETCHED_PAGES ? SiteHealthTemplateDetections.applied : SiteHealthTemplateDetections["unavailable-too-few-pages"];
+}
 var siteCrawlPageSchema = z24.object({
   nodeKey: z24.string(),
   url: z24.string(),
@@ -8697,12 +8791,15 @@ var siteCrawlPageAuditSchema = z24.discriminatedUnion("state", [
     criticalDefects: z24.array(siteCrawlCriticalDefectSchema).default([])
   })
 ]);
+var siteCrawlPagesFilterStateSchema = z24.enum(["applied", "unavailable-legacy-scan"]);
 var siteCrawlPagesResponseSchema = z24.object({
   project: z24.string(),
   hasCrawlData: z24.boolean(),
   runId: z24.string().nullable(),
   total: z24.number().int().nonnegative(),
   nextCursor: z24.string().nullable(),
+  /** Null when no `healthState` filter was requested. */
+  healthStateFilter: z24.union([siteCrawlPagesFilterStateSchema, z24.null()]).default(null),
   pages: z24.array(siteCrawlPageSchema).default([])
 });
 var siteCrawlStructureChildSchema = z24.object({
@@ -8734,7 +8831,19 @@ var siteCrawlEdgeSchema = z24.object({
   occurrences: z24.number().int().positive(),
   followableOccurrences: z24.number().int().nonnegative(),
   nofollowOccurrences: z24.number().int().nonnegative(),
-  anchors: z24.array(z24.string()).default([])
+  anchors: z24.array(z24.string()).default([]),
+  /**
+   * True when this link repeats across the scan as nav, header, or footer
+   * chrome. Null means the scan never classified its links, which the
+   * response's `templateDetection` explains; it never means "not a nav link".
+   */
+  isTemplate: z24.union([z24.boolean(), z24.null()]),
+  /**
+   * Share of fetched pages carrying this link's LEAST ubiquitous anchor: the
+   * most editorial thing anyone says when linking these two pages. At or above
+   * the threshold means every anchor on the link is chrome.
+   */
+  templateRatio: z24.union([z24.number(), z24.null()])
 });
 var siteCrawlGraphNodeSchema = z24.object({
   nodeKey: z24.string(),
@@ -8760,29 +8869,69 @@ var siteCrawlGraphEdgeSchema = z24.object({
   sourceNodeKey: z24.string(),
   targetNodeKey: z24.string(),
   followable: z24.boolean(),
-  occurrences: z24.number().int().positive()
-});
+  occurrences: z24.number().int().positive(),
+  /**
+   * True for a nav, header, or footer link. Template links are published in
+   * the sample so a viewer can switch them on without a refetch, but they were
+   * excluded from the layout, so switching them on must never move a node.
+   */
+  isTemplate: z24.boolean()
+});
+var siteCrawlGraphLayoutUnavailableReasonSchema = z24.enum([
+  "no-crawl",
+  "legacy-snapshot",
+  "details-unavailable",
+  "layout-failed",
+  "empty-crawl"
+]);
 var siteCrawlGraphLayoutSchema = z24.discriminatedUnion("state", [
   z24.object({
     state: z24.literal("ready"),
     version: z24.string().min(1),
-    computedAt: z24.string().min(1)
+    computedAt: z24.string().min(1),
+    /**
+     * True when nav, header, and footer links were kept out of the physics, so
+     * positions describe content structure. False for a scan published before
+     * template detection: its links are classified by the migration backfill
+     * and can still be filtered, but its node positions were computed with the
+     * nav mesh included. Re-running the scan is what updates them.
+     */
+    templateLinksExcluded: z24.boolean()
   }),
   z24.object({
     state: z24.literal("unavailable"),
     version: z24.null(),
-    reason: z24.enum(["no-crawl", "legacy-snapshot", "details-unavailable", "layout-failed", "empty-crawl"])
+    reason: siteCrawlGraphLayoutUnavailableReasonSchema
   })
 ]);
 var siteCrawlGraphResponseSchema = z24.object({
   project: z24.string(),
   hasCrawlData: z24.boolean(),
   runId: z24.string().nullable(),
+  /**
+   * Server-owned identity of the crawl root, resolved from the snapshot root
+   * URL (or the depth-0 page). Consumers must not infer the home page from a
+   * path or a link score. It is null when the crawl persisted no page detail,
+   * and it can name a page that graph sampling left out of `nodes`.
+   */
+  rootNodeKey: z24.string().nullable(),
   layout: siteCrawlGraphLayoutSchema,
+  /** Whether nav and footer links could be told apart for this scan. */
+  templateDetection: siteHealthTemplateDetectionSchema,
+  /** Echo of the requested `linkKind`, so a caller knows what `edges` holds. */
+  linkKind: siteHealthLinkKindSchema,
   /** Total canonical pages in the persisted crawl before graph sampling. */
   totalNodes: z24.number().int().nonnegative(),
-  /** Total graph-compatible internal anchor edges before graph sampling. */
+  /**
+   * Total graph-compatible internal anchor edges before graph sampling. This
+   * keeps counting EVERY link, whatever `linkKind` was requested, so the
+   * content and template counts below split a number that never moved.
+   */
   totalEdges: z24.number().int().nonnegative(),
+  /** Share of `totalEdges` classified as nav, header, or footer links. */
+  totalTemplateEdges: z24.number().int().nonnegative(),
+  /** `totalEdges - totalTemplateEdges`. Equals `totalEdges` when detection is unavailable. */
+  totalContentEdges: z24.number().int().nonnegative(),
   nodes: z24.array(siteCrawlGraphNodeSchema).default([]),
   edges: z24.array(siteCrawlGraphEdgeSchema).default([]),
   omittedNodes: z24.number().int().nonnegative(),
@@ -8928,8 +9077,13 @@ var siteCrawlInternalLinksResponseSchema = z24.object({
   project: z24.string(),
   hasCrawlData: z24.boolean(),
   runId: z24.string().nullable(),
+  /** Total links matching every requested filter, `linkKind` included. */
   total: z24.number().int().nonnegative(),
   nextCursor: z24.string().nullable(),
+  /** Whether nav and footer links could be told apart for this scan. */
+  templateDetection: siteHealthTemplateDetectionSchema,
+  /** Echo of the requested `linkKind`, so a caller knows what `total` counts. */
+  linkKind: siteHealthLinkKindSchema,
   edges: z24.array(siteCrawlEdgeSchema).default([])
 });
 var siteCrawlNeighborsResponseSchema = z24.object({
@@ -8938,6 +9092,10 @@ var siteCrawlNeighborsResponseSchema = z24.object({
   runId: z24.string().nullable(),
   nodeKey: z24.string().nullable(),
   url: z24.string().nullable(),
+  /** Whether nav and footer links could be told apart for this scan. */
+  templateDetection: siteHealthTemplateDetectionSchema,
+  /** Echo of the requested `linkKind`, so a caller knows what the lists hold. */
+  linkKind: siteHealthLinkKindSchema,
   inbound: z24.array(siteCrawlEdgeSchema).default([]),
   outbound: z24.array(siteCrawlEdgeSchema).default([]),
   inboundTruncated: z24.boolean(),
@@ -9020,6 +9178,75 @@ var siteAuditRunResponseSchema = z24.object({
   runId: z24.string(),
   status: runStatusSchema
 });
+var siteHealthScanSchema = z24.object({
+  runId: z24.string(),
+  status: runStatusSchema,
+  createdAt: z24.string(),
+  startedAt: z24.string().nullable(),
+  finishedAt: z24.string().nullable(),
+  hasCrawlData: z24.boolean()
+});
+var siteHealthScansResponseSchema = z24.object({
+  project: z24.string(),
+  scans: z24.array(siteHealthScanSchema).default([])
+});
+var SITE_HEALTH_SCANS_DEFAULT_LIMIT = 20;
+var SITE_HEALTH_SCANS_MAX_LIMIT = 100;
+var siteAuditRunPhaseSchema = z24.enum([
+  "queued",
+  "discovering",
+  "checking",
+  "arranging-map",
+  "completed",
+  "partial",
+  "failed",
+  "cancelled"
+]);
+var siteAuditRunLayoutSchema = z24.object({
+  state: z24.enum(["pending", "ready", "unavailable"]),
+  layoutVersion: z24.string().nullable(),
+  failureCode: z24.string().nullable(),
+  updatedAt: z24.string().nullable()
+});
+var siteAuditRunAttemptProgressSchema = z24.object({
+  id: z24.string(),
+  state: z24.string(),
+  pagesDiscovered: z24.number().int().nonnegative(),
+  pagesFetched: z24.number().int().nonnegative(),
+  pagesEligible: z24.number().int().nonnegative(),
+  pagesErrored: z24.number().int().nonnegative(),
+  edgesDiscovered: z24.number().int().nonnegative(),
+  lastUpdatedAt: z24.string(),
+  startedAt: z24.string().nullable(),
+  finishedAt: z24.string().nullable(),
+  error: z24.string().nullable()
+});
+var siteAuditRunProgressSchema = z24.object({
+  project: z24.string(),
+  runId: z24.string(),
+  status: runStatusSchema,
+  phase: siteAuditRunPhaseSchema,
+  attempt: siteAuditRunAttemptProgressSchema.nullable(),
+  layout: siteAuditRunLayoutSchema,
+  error: z24.string().nullable()
+});
+var siteAuditLivePageHealthStateSchema = z24.enum(["waiting", "collecting", "terminal"]);
+var siteAuditLivePageHealthExampleSchema = z24.object({
+  nodeKey: z24.string(),
+  url: z24.string(),
+  auditScore: z24.number(),
+  checksNeedingAttention: z24.number().int().nonnegative()
+});
+var siteAuditLivePageHealthSchema = z24.object({
+  project: z24.string(),
+  runId: z24.string(),
+  status: runStatusSchema,
+  state: siteAuditLivePageHealthStateSchema,
+  attemptId: z24.string().nullable(),
+  pagesAudited: z24.number().int().nonnegative(),
+  updatedAt: z24.string().nullable(),
+  examples: z24.array(siteAuditLivePageHealthExampleSchema).max(12).default([])
+});
 
 // ../contracts/src/schedule.ts
 import { z as z25 } from "zod";
@@ -14235,9 +14462,15 @@ function buildEmbedClientConfig(resolved) {
   const client = { enabled: true };
   if (resolved.views && resolved.views.length > 0) client.views = resolved.views;
   if (resolved.projectTabs && resolved.projectTabs.length > 0) client.projectTabs = resolved.projectTabs;
-  if (resolved.theme && Object.keys(resolved.theme).length > 0) client.theme = resolved.theme;
+  const theme = withoutFontOverride(resolved.theme);
+  if (theme) client.theme = theme;
   return client;
 }
+function withoutFontOverride(theme) {
+  if (!theme) return void 0;
+  const entries = Object.entries(theme).filter(([key]) => key.toLowerCase() !== "font");
+  return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+}
 function normalizeIdTokens(raw) {
   if (raw.length === 0) return void 0;
   const seen = /* @__PURE__ */ new Set();
@@ -14264,6 +14497,7 @@ function parseThemeOverride(raw) {
   for (const [k, v] of Object.entries(parsed)) {
     if (Object.keys(out).length >= 12) break;
     if (typeof k !== "string" || k.length === 0 || k.length > 32) continue;
+    if (k.toLowerCase() === "font") continue;
     if (typeof v !== "string" || v.length > 256) continue;
     out[k] = v;
   }
@@ -14452,6 +14686,8 @@ export {
   orderLocationsDefaultFirst,
   resolveLocations,
   projectUpsertRequestSchema,
+  projectCreateRequestSchema,
+  normalizeProjectName,
   projectDtoSchema,
   queryDtoSchema,
   keywordDtoSchema,
@@ -14699,8 +14935,20 @@ export {
   siteAuditPagesResponseSchema,
   siteAuditTrendResponseSchema,
   siteCrawlSummarySchema,
+  isSelfLink,
+  siteHealthStateSchema,
   SiteCrawlFetchedStates,
   deriveSiteHealthState,
+  TEMPLATE_LINK_RATIO_THRESHOLD,
+  siteHealthTemplateDetectionSchema,
+  SiteHealthTemplateDetections,
+  siteHealthLinkKindSchema,
+  SiteHealthLinkKinds,
+  createTemplateLinkPairIndex,
+  observeTemplateLinkEdges,
+  templateLinkRatio,
+  isTemplateLinkRatio,
+  templateLinkDetection,
   siteCrawlAuditFactorSchema,
   siteCrawlCriticalDefectSchema,
   siteCrawlPageAuditSchema,
@@ -14734,6 +14982,11 @@ export {
   normalizeSiteAuditRunRequest,
   siteAuditRequestIdentity,
   siteAuditRunResponseSchema,
+  siteHealthScansResponseSchema,
+  SITE_HEALTH_SCANS_DEFAULT_LIMIT,
+  SITE_HEALTH_SCANS_MAX_LIMIT,
+  siteAuditRunProgressSchema,
+  siteAuditLivePageHealthSchema,
   schedulableRunKindSchema,
   SchedulableRunKinds,
   scheduleDtoSchema,
@@ -14973,6 +15226,7 @@ export {
   escapeLikePattern,
   READ_ONLY_SCOPE,
   WILDCARD_SCOPE,
+  PROJECTS_WRITE_SCOPE,
   ADS_WRITE_SCOPE,
   ADS_APPROVE_SCOPE,
   ADS_ACTIVATE_SCOPE,

package/dist/cli.js

@@ -31,7 +31,7 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-AEIKAWOW.js";
+} from "./chunk-BZPBVOAM.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -51,7 +51,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-KMTRO56O.js";
+} from "./chunk-ZEG43TY2.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -65,7 +65,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-MEBL4EJO.js";
+} from "./chunk-5AFWHKKI.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -129,7 +129,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-TRRVBTU5.js";
+} from "./chunk-ZL3VY435.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -14354,6 +14354,29 @@ async function technicalAeoTrend(project, opts) {
   }
   console.log(lines.join("\n"));
 }
+async function technicalAeoProgress(project, opts) {
+  const progress = await getClient27().getTechnicalAeoProgress(project, opts.runId);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(progress, null, 2));
+    return;
+  }
+  const lines = [
+    `Site Health progress: ${progress.phase} (${progress.status})`,
+    `Run: ${progress.runId}`
+  ];
+  if (progress.attempt) {
+    lines.push(
+      `Pages: ${progress.attempt.pagesDiscovered} found \xB7 ${progress.attempt.pagesFetched} checked \xB7 ${progress.attempt.pagesErrored} failed`,
+      `Eligible: ${progress.attempt.pagesEligible} \xB7 Links found: ${progress.attempt.edgesDiscovered}`,
+      `Updated: ${progress.attempt.lastUpdatedAt}`
+    );
+  } else {
+    lines.push("Pages: waiting for the crawl to start");
+  }
+  lines.push(`Layout: ${progress.layout.state}`);
+  if (progress.error) lines.push(`Error: ${progress.error}`);
+  console.log(lines.join("\n"));
+}
 async function technicalAeoCrawl(project, opts) {
   const crawl = await getClient27().getTechnicalAeoCrawl(project, { runId: opts.runId });
   if (isMachineFormat(opts.format)) {
@@ -14848,6 +14871,21 @@ var TECHNICAL_AEO_CLI_COMMANDS_BASE = [
       await technicalAeoCrawl(project, { runId: getString(input.values, "run-id"), format: input.format });
     }
   },
+  {
+    path: ["technical-aeo", "progress"],
+    usage: "canonry technical-aeo progress <project> --run-id <id> [--format json]",
+    options: { "run-id": stringOption() },
+    run: async (input) => {
+      const usage = "canonry technical-aeo progress <project> --run-id <id> [--format json]";
+      const project = requireProject(input, "technical-aeo.progress", usage);
+      const runId = requireStringOption(input, "run-id", {
+        command: "technical-aeo.progress",
+        usage,
+        message: "--run-id is required"
+      });
+      await technicalAeoProgress(project, { runId, format: input.format });
+    }
+  },
   {
     path: ["technical-aeo", "subgraph"],
     usage: "canonry technical-aeo subgraph <project> [--run-id <id>] [--node-key <key>|--url <url>] [--hops <n>] [--max-nodes <n>] [--max-edges <n>] [--format json]",

package/dist/index.d.ts

@@ -215,6 +215,15 @@ interface AgentConfigEntry {
     mode?: 'disabled';
 }
 interface DashboardConfigEntry {
+    /**
+     * First-open dashboard experience. `legacy` preserves the existing setup
+     * wizard, `platform` enables the domain-first Site Health launchpad, and
+     * `auto` enables the launchpad only when the authoritative project list is
+     * empty. Omitted defaults to `auto`: fresh installs use the launchpad after
+     * an authoritative empty project-list response, while existing installs
+     * retain the legacy wizard.
+     */
+    onboardingMode?: 'legacy' | 'platform' | 'auto';
     /**
      * Whether the browser dashboard requires Canonry's built-in password/session
      * gate. Defaults to true. Set false only when an upstream layer enforces auth