@ainyc/canonry 2.12.1 → 2.13.2

package/dist/{chunk-PLI7EOPM.js → chunk-XJS7NALL.js}

@@ -1367,6 +1367,22 @@ var GENERIC_TOKENS = /* @__PURE__ */ new Set([
   "systems",
   "tech"
 ]);
+var MIN_BRAND_KEY_LENGTH = 6;
+var BUSINESS_SUFFIXES = [
+  "incorporated",
+  "corporation",
+  "limited",
+  "company",
+  "gmbh",
+  "pllc",
+  "corp",
+  "group",
+  "llp",
+  "plc",
+  "llc",
+  "inc",
+  "ltd"
+];
 function extractAnswerMentions(answerText, displayName, domains) {
   if (!answerText) return { mentioned: false, matchedTerms: [] };
   const matchedTerms = [];
@@ -1378,8 +1394,15 @@ function extractAnswerMentions(answerText, displayName, domains) {
       matchedTerms.push(normalizedDomain);
     }
   }
-  const normalizedDisplayName = normalizeText(displayName);
-  if (normalizedDisplayName && normalizeText(answerText).includes(normalizedDisplayName)) {
+  const answerNormalized = normalizeText(answerText);
+  const answerBrandKey = brandKeyFromText(answerText);
+  const normalizedCandidates = brandNormalizedCandidates(displayName);
+  const brandKeyCandidates = brandKeyCandidatesForMatch(displayName);
+  const matchesNormalized = normalizedCandidates.some((c) => answerNormalized.includes(c));
+  const matchesBrandKey = brandKeyCandidates.some(
+    (c) => c.length >= MIN_BRAND_KEY_LENGTH && answerBrandKey.includes(c)
+  );
+  if (matchesNormalized || matchesBrandKey) {
     matchedTerms.push(displayName);
   }
   const tokens = collectDistinctiveTokens(displayName, domains);
@@ -1445,6 +1468,29 @@ function isDistinctiveToken(token) {
 function normalizeText(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
 }
+function brandNormalizedCandidates(displayName) {
+  const original = normalizeText(displayName);
+  if (!original) return [];
+  const stripped = stripBusinessSuffix(original, " ");
+  if (!stripped || stripped === original) return [original];
+  if (brandKeyFromText(stripped).length < MIN_BRAND_KEY_LENGTH) return [original];
+  return [original, stripped];
+}
+function brandKeyCandidatesForMatch(displayName) {
+  const original = brandKeyFromText(displayName);
+  if (!original) return [];
+  const stripped = stripBusinessSuffix(original, "");
+  return stripped && stripped !== original ? [original, stripped] : [original];
+}
+function stripBusinessSuffix(value, separator) {
+  for (const suffix of BUSINESS_SUFFIXES) {
+    const trailing = `${separator}${suffix}`;
+    if (value.endsWith(trailing) && value.length - trailing.length >= 3) {
+      return value.slice(0, -trailing.length);
+    }
+  }
+  return value;
+}
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -1682,6 +1728,68 @@ var contentGapsResponseDtoSchema = z16.object({
   latestRunId: z16.string()
 });
 
+// ../contracts/src/doctor.ts
+import { z as z17 } from "zod";
+var checkStatusSchema = z17.enum(["ok", "warn", "fail", "skipped"]);
+var CheckStatuses = checkStatusSchema.enum;
+var checkScopeSchema = z17.enum(["global", "project"]);
+var CheckScopes = checkScopeSchema.enum;
+var checkCategorySchema = z17.enum([
+  "auth",
+  "config",
+  "providers",
+  "integrations",
+  "database",
+  "schedules"
+]);
+var CheckCategories = checkCategorySchema.enum;
+var checkResultSchema = z17.object({
+  id: z17.string(),
+  category: checkCategorySchema,
+  scope: checkScopeSchema,
+  title: z17.string(),
+  status: checkStatusSchema,
+  code: z17.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
+  summary: z17.string(),
+  remediation: z17.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
+  details: z17.record(z17.string(), z17.unknown()).optional().describe("Structured context \u2014 principal email, redirect URI, missing scopes, etc. Stable per check id."),
+  durationMs: z17.number().int().nonnegative().describe("How long the check took to execute.")
+});
+var doctorReportSchema = z17.object({
+  scope: checkScopeSchema,
+  project: z17.string().nullable().describe('Project name when scope is "project", null otherwise.'),
+  generatedAt: z17.string().describe("ISO-8601 timestamp when this doctor run started."),
+  durationMs: z17.number().int().nonnegative(),
+  summary: z17.object({
+    total: z17.number().int().nonnegative(),
+    ok: z17.number().int().nonnegative(),
+    warn: z17.number().int().nonnegative(),
+    fail: z17.number().int().nonnegative(),
+    skipped: z17.number().int().nonnegative()
+  }),
+  checks: z17.array(checkResultSchema)
+});
+function summarizeCheckResults(results) {
+  const summary = { total: results.length, ok: 0, warn: 0, fail: 0, skipped: 0 };
+  for (const result of results) {
+    switch (result.status) {
+      case CheckStatuses.ok:
+        summary.ok += 1;
+        break;
+      case CheckStatuses.warn:
+        summary.warn += 1;
+        break;
+      case CheckStatuses.fail:
+        summary.fail += 1;
+        break;
+      case CheckStatuses.skipped:
+        summary.skipped += 1;
+        break;
+    }
+  }
+  return summary;
+}
+
 // src/client.ts
 function createApiClient() {
   const config = loadConfig();
@@ -2284,6 +2392,11 @@ var ApiClient = class {
       `/projects/${encodeURIComponent(project)}/search?${params.toString()}`
     );
   }
+  async runDoctor(opts = {}) {
+    const qs = opts.checkIds && opts.checkIds.length > 0 ? `?check=${encodeURIComponent(opts.checkIds.join(","))}` : "";
+    const path2 = opts.project ? `/projects/${encodeURIComponent(opts.project)}/doctor${qs}` : `/doctor${qs}`;
+    return this.request("GET", path2);
+  }
   async getHealthHistory(project, limit) {
     const qs = limit ? `?limit=${limit}` : "";
     return this.request("GET", `/projects/${encodeURIComponent(project)}/health/history${qs}`);
@@ -2337,6 +2450,7 @@ export {
   saveConfig,
   saveConfigPatch,
   configExists,
+  EXIT_USER_ERROR,
   EXIT_SYSTEM_ERROR,
   CliError,
   usageError,
@@ -2401,6 +2515,10 @@ export {
   agentMemoryUpsertRequestSchema,
   agentMemoryDeleteRequestSchema,
   CcReleaseSyncStatuses,
+  CheckStatuses,
+  CheckScopes,
+  CheckCategories,
+  summarizeCheckResults,
   createApiClient,
   ApiClient
 };

package/dist/cli.js

@@ -17,11 +17,14 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-FCYNFM4B.js";
+} from "./chunk-DHMCIJMQ.js";
 import {
   CcReleaseSyncStatuses,
+  CheckScopes,
+  CheckStatuses,
   CliError,
   EXIT_SYSTEM_ERROR,
+  EXIT_USER_ERROR,
   ProviderNames,
   RunKinds,
   RunStatuses,
@@ -41,7 +44,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-PLI7EOPM.js";
+} from "./chunk-XJS7NALL.js";
 import {
   apiKeys,
   competitors,
@@ -1553,6 +1556,92 @@ var CDP_CLI_COMMANDS = [
   }
 ];
 
+// src/commands/doctor.ts
+async function doctorCommand(opts) {
+  const client = createApiClient();
+  const report = await client.runDoctor({
+    project: opts.project,
+    checkIds: opts.checks
+  });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    printHumanReport(report);
+  }
+  if (report.summary.fail > 0) {
+    throw new CliError({
+      code: "DOCTOR_CHECKS_FAILED",
+      message: `${report.summary.fail} check${report.summary.fail === 1 ? "" : "s"} failed`,
+      exitCode: EXIT_USER_ERROR,
+      details: {
+        scope: report.scope,
+        project: report.project,
+        failed: report.checks.filter((c) => c.status === CheckStatuses.fail).map((c) => c.id)
+      }
+    });
+  }
+}
+function statusBadge(status) {
+  switch (status) {
+    case CheckStatuses.ok:
+      return "[ok]   ";
+    case CheckStatuses.warn:
+      return "[warn] ";
+    case CheckStatuses.fail:
+      return "[fail] ";
+    case CheckStatuses.skipped:
+      return "[skip] ";
+  }
+}
+function printHumanReport(report) {
+  const header = report.scope === CheckScopes.project && report.project ? `canonry doctor \u2014 project "${report.project}"` : "canonry doctor \u2014 global";
+  console.log(`
+${header}`);
+  console.log(`(${report.summary.ok} ok, ${report.summary.warn} warn, ${report.summary.fail} fail, ${report.summary.skipped} skipped \u2014 ${report.durationMs}ms)
+`);
+  if (report.checks.length === 0) {
+    console.log("No checks matched the requested filter.");
+    return;
+  }
+  const grouped = /* @__PURE__ */ new Map();
+  for (const check of report.checks) {
+    const bucket = grouped.get(check.category) ?? [];
+    bucket.push(check);
+    grouped.set(check.category, bucket);
+  }
+  for (const [category, checks] of grouped) {
+    console.log(`${category.toUpperCase()}`);
+    for (const check of checks) {
+      console.log(`  ${statusBadge(check.status)}${check.id} \u2014 ${check.summary}`);
+      if (check.remediation) {
+        console.log(`         \u2192 ${check.remediation}`);
+      }
+    }
+    console.log();
+  }
+}
+
+// src/cli-commands/doctor.ts
+var USAGE = "canonry doctor [--project <name>] [--check <id>...] [--format json]";
+var DOCTOR_CLI_COMMANDS = [
+  {
+    path: ["doctor"],
+    usage: USAGE,
+    options: {
+      project: stringOption(),
+      check: multiStringOption()
+    },
+    allowPositionals: false,
+    run: async (input) => {
+      await doctorCommand({
+        project: getString(input.values, "project"),
+        checks: getStringArray(input.values, "check"),
+        format: input.format
+      });
+    }
+  }
+];
+
 // src/commands/ga.ts
 function getClient4() {
   return createApiClient();
@@ -8806,12 +8895,13 @@ var REGISTERED_CLI_COMMANDS = [
   ...INTELLIGENCE_CLI_COMMANDS,
   ...CONTENT_CLI_COMMANDS,
   ...AGENT_CLI_COMMANDS,
+  ...DOCTOR_CLI_COMMANDS,
   ...MCP_CLI_COMMANDS
 ];
 
 // src/cli.ts
 import { createRequire as createRequire2 } from "module";
-var USAGE = `
+var USAGE2 = `
 canonry \u2014 AEO monitoring CLI
 
 Usage:  canonry <command> [options]
@@ -8871,7 +8961,7 @@ function extractFormat(cmdArgs) {
 }
 async function runCli(args = process.argv.slice(2)) {
   if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-    console.log(USAGE);
+    console.log(USAGE2);
     return 0;
   }
   if (args.includes("--version") || args.includes("-v")) {

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   createServer
-} from "./chunk-FCYNFM4B.js";
+} from "./chunk-DHMCIJMQ.js";
 import {
   loadConfig
-} from "./chunk-PLI7EOPM.js";
+} from "./chunk-XJS7NALL.js";
 import "./chunk-UM6RDSRJ.js";
 import "./chunk-MLKGABMK.js";
 export {

package/dist/mcp.js

@@ -10,7 +10,7 @@ import {
   projectUpsertRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-PLI7EOPM.js";
+} from "./chunk-XJS7NALL.js";
 import "./chunk-MLKGABMK.js";
 
 // src/mcp/cli.ts
@@ -173,6 +173,10 @@ var agentWebhookAttachInputSchema = z2.object({
   project: projectNameSchema,
   url: z2.string().url()
 });
+var doctorInputSchema = z2.object({
+  project: projectNameSchema.optional().describe("Project name to scope project-level checks. Omit to run global checks (provider keys, config, etc.)."),
+  checks: z2.array(z2.string().min(1)).optional().describe('Optional check IDs or wildcard prefixes (e.g. "google.auth.*", "config.providers"). Empty/omitted runs all matching checks for the chosen scope.')
+});
 var AGENT_WEBHOOK_EVENTS = [
   notificationEventSchema.enum["run.completed"],
   notificationEventSchema.enum["insight.critical"],
@@ -228,6 +232,17 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/search"],
     handler: (client, input) => client.searchProject(input.project, { q: input.q, limit: input.limit })
   }),
+  defineTool({
+    name: "canonry_doctor",
+    title: "Run health checks",
+    description: 'Run canonry health checks. With `project`, runs project-scoped checks (Google/GA auth, redirect URI, scopes, property access). Without `project`, runs global checks (provider keys, etc.). Use `checks` to filter by exact ID or wildcard prefix (e.g. ["google.auth.*"]). Returns a structured DoctorReport with per-check status, code, summary, remediation, and details \u2014 use this to diagnose Google auth failures (401/403/redirect-mismatch/principal-mismatch) without parsing logs.',
+    access: "read",
+    tier: "core",
+    inputSchema: doctorInputSchema,
+    annotations: readAnnotations(true),
+    openApiOperations: ["GET /api/v1/doctor", "GET /api/v1/projects/{name}/doctor"],
+    handler: (client, input) => client.runDoctor({ project: input.project, checkIds: input.checks })
+  }),
   defineTool({
     name: "canonry_project_export",
     title: "Export project config",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "2.12.1",
+  "version": "2.13.2",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -59,20 +59,20 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {