npm - @ainyc/canonry - Versions diffs - 4.27.2 → 4.28.0 - Mend

@ainyc/canonry 4.27.2 → 4.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/assets/agent-workspace/skills/aero/SKILL.md +1 -0
package/assets/agent-workspace/skills/aero/references/aeo-discovery.md +49 -4
package/assets/agent-workspace/skills/canonry-setup/references/canonry-cli.md +4 -2
package/assets/assets/index--jYjUA0o.js +302 -0
package/assets/assets/{index-rPok6yk8.css → index-BnALDZI7.css} +1 -1
package/assets/index.html +2 -2
package/dist/{chunk-2FAEQ56I.js → chunk-GB3QJURO.js} +32 -3
package/dist/{chunk-ICWFH4JA.js → chunk-HONTKYY7.js} +152 -7
package/dist/{chunk-HVW665A4.js → chunk-RLLFB3M3.js} +37 -0
package/dist/{chunk-NXXD6TX7.js → chunk-UEV3HSRL.js} +1 -1
package/dist/cli.js +81 -6
package/dist/index.js +4 -4
package/dist/{intelligence-service-Z6QIELKP.js → intelligence-service-O6KB6YAM.js} +2 -2
package/dist/mcp.js +2 -2
package/package.json +9 -9
package/assets/assets/index-BWjq1HP1.js +0 -302

package/assets/index.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-BWjq1HP1.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-rPok6yk8.css">
+    <script type="module" crossorigin src="./assets/index--jYjUA0o.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BnALDZI7.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-2FAEQ56I.js → chunk-GB3QJURO.js} RENAMED Viewed

@@ -3,6 +3,8 @@ import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   DISCOVERY_MAX_PROBES_CAP,
   competitorBatchRequestSchema,
+  discoveryBucketSchema,
+  discoveryPromoteRequestSchema,
   discoveryRunRequestSchema,
   keywordBatchRequestSchema,
   keywordGenerateRequestSchema,
@@ -18,7 +20,7 @@ import {
   trafficConnectCloudRunRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-HVW665A4.js";
+} from "./chunk-RLLFB3M3.js";
 // src/config.ts
 import fs from "fs";
@@ -847,6 +849,13 @@ var ApiClient = class {
       `/projects/${encodeURIComponent(project)}/discover/sessions/${encodeURIComponent(sessionId)}/promote`
     );
   }
+  async promoteDiscovery(project, sessionId, body) {
+    return this.request(
+      "POST",
+      `/projects/${encodeURIComponent(project)}/discover/sessions/${encodeURIComponent(sessionId)}/promote`,
+      body ?? {}
+    );
+  }
   async wordpressConnect(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/connect`, body);
   }
@@ -1272,6 +1281,15 @@ var discoverySessionIdInputSchema = z2.object({
   project: projectNameSchema,
   sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start.")
 });
+var discoveryPromoteInputSchema = z2.object({
+  project: projectNameSchema,
+  sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start."),
+  request: discoveryPromoteRequestSchema.extend({
+    // Stronger descriptions for the LLM. The base Zod schema enforces the shape.
+    buckets: z2.array(discoveryBucketSchema).min(1).optional().describe("Which probe buckets to adopt into the tracked basket. Omitted promotes cited + aspirational; include wasted-surface explicitly for off-ICP competitor gaps."),
+    includeCompetitors: z2.boolean().optional().describe("Whether to also merge recurring discovered competitor domains into the project. Defaults to true.")
+  }).optional()
+});
 var AGENT_WEBHOOK_EVENTS = [
   notificationEventSchema.enum["run.completed"],
   notificationEventSchema.enum["insight.critical"],
@@ -2202,7 +2220,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_discover_session_get",
     title: "Get discovery session",
-    description: 'Get one discovery session with the full probe list (per-query bucket + cited domains). Use after canonry_discover_run_start to inspect what the discovery pipeline produced; this is the canonical read for "what did discovery find" before PR 2 lands `canonry discover promote`.',
+    description: 'Get one discovery session with the full probe list (per-query bucket + cited domains). Use after canonry_discover_run_start to inspect what the discovery pipeline produced; this is the canonical read for "what did discovery find" before calling canonry_discover_promote.',
     access: "read",
     tier: "discovery",
     inputSchema: discoverySessionIdInputSchema,
@@ -2213,13 +2231,24 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_discover_promote_preview",
     title: "Preview discovery promotion",
-    description: "Read-only preview of what `canonry discover promote` (PR 2) would persist for a session: bucketed query lists and suggested new competitor domains (those not already in the project's tracked competitor list). v1 returns the preview only; use it to confirm a basket before PR 2 ships the merge step.",
+    description: "Read-only preview of available promotion candidates for a session: bucketed query lists and recurring suggested competitor domains not already in the project's tracked competitor list. Use it to confirm a basket before calling canonry_discover_promote.",
     access: "read",
     tier: "discovery",
     inputSchema: discoverySessionIdInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/discover/sessions/{id}/promote"],
     handler: (client, input) => client.previewDiscoveryPromote(input.project, input.sessionId)
+  }),
+  defineTool({
+    name: "canonry_discover_promote",
+    title: "Promote discovery session",
+    description: 'Adopt a completed discovery session\'s bucketed queries into the project\'s tracked basket, tagged with provenance "discovery:<sessionId>". By default, only cited + aspirational queries are promoted; include wasted-surface explicitly when off-ICP competitor gaps should also be tracked. Recurring discovered competitor domains are also merged by default. Add-only and idempotent: queries/domains already tracked are returned under `skipped`, never inserted twice. Only sessions with status "completed" can be promoted. Call canonry_discover_promote_preview first to inspect candidates.',
+    access: "write",
+    tier: "discovery",
+    inputSchema: discoveryPromoteInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/discover/sessions/{id}/promote"],
+    handler: (client, input) => client.promoteDiscovery(input.project, input.sessionId, input.request)
   })
 ];
 var CANONRY_MCP_TOOL_COUNT = canonryMcpTools.length;

package/dist/{chunk-ICWFH4JA.js → chunk-HONTKYY7.js} RENAMED Viewed

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-2FAEQ56I.js";
+} from "./chunk-GB3QJURO.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -70,7 +70,7 @@ import {
   schedules,
   trafficSources,
   usageCounters
-} from "./chunk-NXXD6TX7.js";
+} from "./chunk-UEV3HSRL.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -81,6 +81,9 @@ import {
   CheckScopes,
   CheckStatuses,
   CitationStates,
+  DEFAULT_DISCOVERY_PROMOTE_BUCKETS,
+  DISCOVERY_PROMOTE_COMPETITOR_CAP,
+  DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS,
   DiscoveryBuckets,
   DiscoverySessionStatuses,
   MemorySources,
@@ -119,6 +122,7 @@ import {
   deltaTone,
   determineAnswerMentioned,
   discoveryBucketSchema,
+  discoveryPromoteRequestSchema,
   discoveryRunRequestSchema,
   effectiveDomains,
   emptyCitationVisibility,
@@ -171,7 +175,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-HVW665A4.js";
+} from "./chunk-RLLFB3M3.js";
 // src/telemetry.ts
 import crypto from "crypto";
@@ -10406,7 +10410,7 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/discover/sessions/{id}/promote",
     summary: "Preview a discovery promotion plan (read-only)",
-    description: "Returns the payload `canonry discover promote` (PR 2) will persist: queries grouped by bucket, plus suggested new competitor domains. v1 is preview-only; the actual merge ships in PR 2.",
+    description: "Returns available promotion candidates: queries grouped by bucket, plus recurring suggested competitor domains not already tracked. Read-only \u2014 use the POST to actually adopt the default subset or an explicit bucket subset.",
     tags: ["discovery"],
     parameters: [
       nameParameter,
@@ -10416,6 +10420,43 @@ var routeCatalog = [
       200: { description: "Promote preview returned." },
       404: { description: "Project or session not found." }
     }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/discover/sessions/{id}/promote",
+    summary: "Promote a discovery session into the tracked basket",
+    description: 'Adopts a completed session\'s bucketed queries into the project\'s tracked basket, tagged with `provenance="discovery:<sessionId>"`. By default, only `cited` and `aspirational` queries are promoted; include `wasted-surface` explicitly when off-ICP competitor gaps should also be tracked. Recurring discovered competitor domains are also merged by default. Add-only and idempotent: queries/domains already tracked are returned under `skipped` rather than inserted twice. Only sessions with `status: "completed"` can be promoted.',
+    tags: ["discovery"],
+    parameters: [
+      nameParameter,
+      { name: "id", in: "path", required: true, description: "Discovery session ID.", schema: stringSchema }
+    ],
+    requestBody: {
+      required: false,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            properties: {
+              buckets: {
+                type: "array",
+                items: { type: "string", enum: ["cited", "aspirational", "wasted-surface"] },
+                description: "Which probe buckets to promote. Omitted means cited + aspirational."
+              },
+              includeCompetitors: {
+                type: "boolean",
+                description: "Whether to also merge recurring discovered competitor domains. Defaults to true."
+              }
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Promotion applied; returns promoted + skipped query/competitor lists." },
+      400: { description: "Session is not completed, or invalid request body." },
+      404: { description: "Project or session not found." }
+    }
   }
 ];
 var canonryLocalRouteCatalog = [
@@ -19685,7 +19726,7 @@ async function discoveryRoutes(app, opts) {
         else if (bucket === DiscoveryBuckets["wasted-surface"]) wasted.add(probe.query);
       }
       const competitorMap = parseJsonColumn(session.competitorMap, []);
-      const newCompetitors = competitorMap.filter((entry) => !seenCompetitors.has(entry.domain.toLowerCase())).slice(0, 20);
+      const newCompetitors = selectEligibleCompetitors(competitorMap).filter((entry) => !seenCompetitors.has(entry.domain.toLowerCase()));
       return reply.send({
         sessionId: session.id,
         projectId: project.id,
@@ -19699,6 +19740,107 @@ async function discoveryRoutes(app, opts) {
       });
     }
   );
+  app.post("/projects/:name/discover/sessions/:id/promote", async (request, reply) => {
+    const project = resolveProject(app.db, request.params.name);
+    const session = app.db.select().from(discoverySessions).where(eq25(discoverySessions.id, request.params.id)).get();
+    if (!session || session.projectId !== project.id) {
+      throw notFound("Discovery session", request.params.id);
+    }
+    const parsed = discoveryPromoteRequestSchema.safeParse(request.body ?? {});
+    if (!parsed.success) {
+      throw validationError("Invalid discovery promote request", {
+        issues: parsed.error.issues.map((issue) => ({
+          path: issue.path.join("."),
+          message: issue.message
+        }))
+      });
+    }
+    if (session.status !== DiscoverySessionStatuses.completed) {
+      throw validationError(
+        `Discovery session is "${session.status}" \u2014 only completed sessions can be promoted.`,
+        { status: session.status }
+      );
+    }
+    const buckets = parsed.data.buckets ?? DEFAULT_DISCOVERY_PROMOTE_BUCKETS;
+    const bucketSet = new Set(buckets);
+    const includeCompetitors = parsed.data.includeCompetitors ?? true;
+    const probeRows = app.db.select().from(discoveryProbes).where(eq25(discoveryProbes.sessionId, session.id)).all();
+    const candidateQueries = /* @__PURE__ */ new Set();
+    for (const probe of probeRows) {
+      if (!probe.bucket) continue;
+      const bucket = discoveryBucketSchema.safeParse(probe.bucket);
+      if (bucket.success && bucketSet.has(bucket.data)) candidateQueries.add(probe.query);
+    }
+    const existingQueries = new Set(
+      app.db.select({ query: queries.query }).from(queries).where(eq25(queries.projectId, project.id)).all().map((r) => r.query.toLowerCase())
+    );
+    const promotedQueries = [];
+    const skippedQueries = [];
+    for (const query of Array.from(candidateQueries).sort()) {
+      if (existingQueries.has(query.toLowerCase())) {
+        skippedQueries.push(query);
+      } else {
+        promotedQueries.push(query);
+        existingQueries.add(query.toLowerCase());
+      }
+    }
+    const promotedCompetitors = [];
+    const skippedCompetitors = [];
+    if (includeCompetitors) {
+      const existingCompetitors = new Set(
+        app.db.select({ domain: competitors.domain }).from(competitors).where(eq25(competitors.projectId, project.id)).all().map((r) => r.domain.toLowerCase())
+      );
+      const competitorMap = parseJsonColumn(session.competitorMap, []);
+      for (const entry of selectEligibleCompetitors(competitorMap)) {
+        const key = entry.domain.toLowerCase();
+        if (existingCompetitors.has(key)) {
+          skippedCompetitors.push(entry.domain);
+        } else {
+          promotedCompetitors.push(entry.domain);
+          existingCompetitors.add(key);
+        }
+      }
+    }
+    const provenance = `discovery:${session.id}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    if (promotedQueries.length > 0 || promotedCompetitors.length > 0) {
+      app.db.transaction((tx) => {
+        for (const query of promotedQueries) {
+          tx.insert(queries).values({
+            id: crypto21.randomUUID(),
+            projectId: project.id,
+            query,
+            provenance,
+            createdAt: now
+          }).run();
+        }
+        for (const domain of promotedCompetitors) {
+          tx.insert(competitors).values({
+            id: crypto21.randomUUID(),
+            projectId: project.id,
+            domain,
+            provenance,
+            createdAt: now
+          }).run();
+        }
+        writeAuditLog(tx, {
+          projectId: project.id,
+          actor: "api",
+          action: "discovery.promoted",
+          entityType: "discovery_session",
+          entityId: session.id,
+          diff: { queries: promotedQueries, competitors: promotedCompetitors }
+        });
+      });
+    }
+    const result = {
+      sessionId: session.id,
+      projectId: project.id,
+      promoted: { queries: promotedQueries, competitors: promotedCompetitors },
+      skipped: { queries: skippedQueries, competitors: skippedCompetitors }
+    };
+    return reply.send(result);
+  });
 }
 function serializeSession(row) {
   return {
@@ -19735,6 +19877,9 @@ function serializeProbe(row) {
     createdAt: row.createdAt
   };
 }
+function selectEligibleCompetitors(competitorMap) {
+  return competitorMap.filter((entry) => entry.hits >= DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS).sort((a, b) => b.hits - a.hits || a.domain.localeCompare(b.domain)).slice(0, DISCOVERY_PROMOTE_COMPETITOR_CAP);
+}
 // ../api-routes/src/discovery/orchestrate.ts
 import crypto22 from "crypto";
@@ -24482,7 +24627,7 @@ function writeDiscoveryInsight(db, input) {
     provider: input.seedProvider,
     recommendation: JSON.stringify({
       action: "review-discovered-basket",
-      summary: `Run \`canonry discover show ${input.sessionId} --format json\` to inspect the per-query breakdown. PR 2 will add \`canonry discover promote\` to merge the basket into the project.`,
+      summary: `Run \`canonry discover show ${input.sessionId} --format json\` to inspect the per-query breakdown, then \`canonry discover promote <project> ${input.sessionId}\` to merge cited + aspirational findings into the project.`,
       bucketCounts: buckets,
       topCompetitors
     }),
@@ -27136,7 +27281,7 @@ async function createServer(opts) {
           content = `[system] Discovery run ${ctx.runId} failed for project ${project.name}: ${ctx.error ?? "unknown error"}. Surface a one-line diagnosis and a suggested next step.`;
         } else {
           const top = ctx.topCompetitors.map((c) => `${c.domain}(${c.hits})`).join(", ") || "none";
-          content = `[system] Discovery run ${ctx.runId} completed for project ${project.name} (session ${ctx.sessionId}). Buckets \u2014 cited:${ctx.buckets.cited}, wasted-surface:${ctx.buckets["wasted-surface"]}, aspirational:${ctx.buckets.aspirational} (${ctx.probeCount} probes; seed provider: ${ctx.seedProvider ?? "unknown"}). Top recurring competitor domains: ${top}. Use canonry_discover_session_get to pull per-query buckets and call out anything worth promoting to the tracked basket. Keep it tight.`;
+          content = `[system] Discovery run ${ctx.runId} completed for project ${project.name} (session ${ctx.sessionId}). Buckets \u2014 cited:${ctx.buckets.cited}, wasted-surface:${ctx.buckets["wasted-surface"]}, aspirational:${ctx.buckets.aspirational} (${ctx.probeCount} probes; seed provider: ${ctx.seedProvider ?? "unknown"}). Top recurring competitor domains: ${top}. Use canonry_discover_session_get to pull per-query buckets and call out cited + aspirational findings worth promoting. Keep it tight.`;
         }
       } else {
         content = `[system] Run ${ctx.runId} completed for project ${project.name}. ${ctx.insightCount} insights generated (${ctx.criticalOrHigh} critical/high). Use canonry_run_get to inspect the run and canonry_insights_list to review new findings. Surface anything notable briefly \u2014 skip chit-chat.`;

package/dist/{chunk-HVW665A4.js → chunk-RLLFB3M3.js} RENAMED Viewed

@@ -2356,6 +2356,12 @@ var trafficEventsResponseSchema = z20.object({
 import { z as z21 } from "zod";
 var discoveryBucketSchema = z21.enum(["cited", "aspirational", "wasted-surface"]);
 var DiscoveryBuckets = discoveryBucketSchema.enum;
+var DEFAULT_DISCOVERY_PROMOTE_BUCKETS = [
+  DiscoveryBuckets.cited,
+  DiscoveryBuckets.aspirational
+];
+var DISCOVERY_PROMOTE_COMPETITOR_CAP = 20;
+var DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS = 2;
 var discoverySessionStatusSchema = z21.enum(["queued", "seeding", "probing", "completed", "failed"]);
 var DiscoverySessionStatuses = discoverySessionStatusSchema.enum;
 var discoveryCompetitorMapEntrySchema = z21.object({
@@ -2400,6 +2406,33 @@ var discoveryRunRequestSchema = z21.object({
   dedupThreshold: z21.number().min(0).max(1).optional(),
   maxProbes: z21.number().int().positive().max(DISCOVERY_MAX_PROBES_CAP).optional()
 });
+var discoveryPromoteRequestSchema = z21.object({
+  buckets: z21.array(discoveryBucketSchema).min(1).optional(),
+  includeCompetitors: z21.boolean().optional()
+});
+var discoveryPromotePreviewSchema = z21.object({
+  sessionId: z21.string(),
+  projectId: z21.string(),
+  status: discoverySessionStatusSchema,
+  queriesByBucket: z21.object({
+    cited: z21.array(z21.string()),
+    aspirational: z21.array(z21.string()),
+    "wasted-surface": z21.array(z21.string())
+  }),
+  suggestedCompetitors: z21.array(discoveryCompetitorMapEntrySchema)
+});
+var discoveryPromoteResultSchema = z21.object({
+  sessionId: z21.string(),
+  projectId: z21.string(),
+  promoted: z21.object({
+    queries: z21.array(z21.string()),
+    competitors: z21.array(z21.string())
+  }),
+  skipped: z21.object({
+    queries: z21.array(z21.string()),
+    competitors: z21.array(z21.string())
+  })
+});
 var queryProvenanceSchema = z21.union([
   z21.literal("cli"),
   z21.string().regex(/^discovery:.+$/)
@@ -2637,9 +2670,13 @@ export {
   TrafficEventKinds,
   discoveryBucketSchema,
   DiscoveryBuckets,
+  DEFAULT_DISCOVERY_PROMOTE_BUCKETS,
+  DISCOVERY_PROMOTE_COMPETITOR_CAP,
+  DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS,
   DiscoverySessionStatuses,
   DISCOVERY_MAX_PROBES_CAP,
   discoveryRunRequestSchema,
+  discoveryPromoteRequestSchema,
   clusterByCosine,
   pickClusterRepresentative,
   formatRatio,

package/dist/{chunk-NXXD6TX7.js → chunk-UEV3HSRL.js} RENAMED Viewed

@@ -8,7 +8,7 @@ import {
   categoryLabel,
   determineAnswerMentioned,
   normalizeProjectDomain
-} from "./chunk-HVW665A4.js";
+} from "./chunk-RLLFB3M3.js";
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";

package/dist/cli.js CHANGED Viewed

@@ -20,7 +20,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-ICWFH4JA.js";
+} from "./chunk-HONTKYY7.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,7 +36,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-2FAEQ56I.js";
+} from "./chunk-GB3QJURO.js";
 import {
   apiKeys,
   competitors,
@@ -49,7 +49,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-NXXD6TX7.js";
+} from "./chunk-UEV3HSRL.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -62,6 +62,7 @@ import {
   SkillsClients,
   TrafficEventKinds,
   determineAnswerMentioned,
+  discoveryBucketSchema,
   effectiveDomains,
   formatRunErrorOneLine,
   normalizeUrlPath,
@@ -69,7 +70,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-HVW665A4.js";
+} from "./chunk-RLLFB3M3.js";
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -621,7 +622,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-Z6QIELKP.js");
+  const { IntelligenceService } = await import("./intelligence-service-O6KB6YAM.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -2054,7 +2055,28 @@ async function discoverPromotePreview(project, sessionId, opts) {
     for (const c of preview.suggestedCompetitors) console.log(`    - ${c.domain} (${c.hits} hits)`);
   }
   console.log(`
-  (PR 2 will add \`canonry discover promote\` to actually merge these into the project.)`);
+  Run \`canonry discover promote ${project} ${sessionId}\` to merge cited + aspirational queries.`);
+  console.log("  Add `--bucket wasted-surface` only when off-ICP competitor gaps should be tracked.");
+}
+async function discoverPromote(project, sessionId, opts) {
+  const client = getClient4();
+  const body = {};
+  if (opts.buckets && opts.buckets.length > 0) body.buckets = opts.buckets;
+  if (opts.includeCompetitors === false) body.includeCompetitors = false;
+  const result = await client.promoteDiscovery(project, sessionId, body);
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const { promoted, skipped } = result;
+  console.log(`Promoted discovery session ${sessionId} into "${project}":`);
+  console.log(`  Queries:     ${promoted.queries.length} added, ${skipped.queries.length} already tracked`);
+  for (const q of promoted.queries) console.log(`    + ${q}`);
+  console.log(`  Competitors: ${promoted.competitors.length} added, ${skipped.competitors.length} already tracked`);
+  for (const c of promoted.competitors) console.log(`    + ${c}`);
+  if (promoted.queries.length === 0 && promoted.competitors.length === 0) {
+    console.log(`  Nothing new \u2014 the project's basket already covers this session.`);
+  }
 }
 function printSessionDetail(session) {
   console.log(`Discovery session: ${session.id}`);
@@ -2122,6 +2144,37 @@ Usage: ${usage}`, {
   }
   return parsed;
 }
+function parseBucketsOption(values, usage) {
+  const raw = getStringArray(values, "bucket");
+  if (!raw || raw.length === 0) return void 0;
+  const expanded = raw.flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+  if (expanded.length === 0) {
+    throw usageError(
+      `Error: --bucket must include at least one value (valid: cited, aspirational, wasted-surface)
+Usage: ${usage}`,
+      {
+        message: "--bucket must include at least one value",
+        details: { command: "discover.promote", usage, option: "bucket", value: raw }
+      }
+    );
+  }
+  const buckets = [];
+  for (const value of expanded) {
+    const parsed = discoveryBucketSchema.safeParse(value);
+    if (!parsed.success) {
+      throw usageError(
+        `Error: invalid --bucket value "${value}" (valid: cited, aspirational, wasted-surface)
+Usage: ${usage}`,
+        {
+          message: `invalid --bucket value "${value}"`,
+          details: { command: "discover.promote", usage, option: "bucket", value }
+        }
+      );
+    }
+    buckets.push(parsed.data);
+  }
+  return buckets;
+}
 var DISCOVER_CLI_COMMANDS = [
   {
     path: ["discover", "run"],
@@ -2237,6 +2290,28 @@ var DISCOVER_CLI_COMMANDS = [
       await discoverShow(project, sessionId, { format: input.format });
     }
   },
+  {
+    path: ["discover", "promote"],
+    usage: "canonry discover promote <project> <session-id> [--bucket cited,aspirational,wasted-surface] [--no-competitors] [--format json]",
+    options: {
+      bucket: multiStringOption(),
+      "no-competitors": { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const usage = "canonry discover promote <project> <session-id> [--bucket cited,aspirational,wasted-surface] [--no-competitors] [--format json]";
+      const project = requireProject(input, "discover.promote", usage);
+      const sessionId = requirePositional(input, 1, {
+        command: "discover.promote",
+        usage,
+        message: "session ID is required"
+      });
+      await discoverPromote(project, sessionId, {
+        buckets: parseBucketsOption(input.values, usage),
+        includeCompetitors: !getBoolean(input.values, "no-competitors"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["discover", "promote", "preview"],
     usage: "canonry discover promote preview <project> <session-id> [--format json]",

package/dist/index.js CHANGED Viewed

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-ICWFH4JA.js";
+} from "./chunk-HONTKYY7.js";
 import {
   loadConfig
-} from "./chunk-2FAEQ56I.js";
-import "./chunk-NXXD6TX7.js";
-import "./chunk-HVW665A4.js";
+} from "./chunk-GB3QJURO.js";
+import "./chunk-UEV3HSRL.js";
+import "./chunk-RLLFB3M3.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-Z6QIELKP.js → intelligence-service-O6KB6YAM.js} RENAMED Viewed

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-NXXD6TX7.js";
-import "./chunk-HVW665A4.js";
+} from "./chunk-UEV3HSRL.js";
+import "./chunk-RLLFB3M3.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js CHANGED Viewed

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-2FAEQ56I.js";
-import "./chunk-HVW665A4.js";
+} from "./chunk-GB3QJURO.js";
+import "./chunk-RLLFB3M3.js";
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.27.2",
+  "version": "4.28.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -60,22 +60,22 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",