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

@ainyc/canonry 4.27.1 → 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-QNXGCQEM.js → chunk-HONTKYY7.js} +226 -27
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 +7 -7
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-QNXGCQEM.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";
@@ -2612,7 +2616,7 @@ function buildCategoryCounts(counts) {
 }
 // ../api-routes/src/intelligence.ts
-import { eq as eq11, desc as desc4, and as and3 } from "drizzle-orm";
+import { eq as eq11, desc as desc4, and as and3, inArray as inArray3 } from "drizzle-orm";
 function emptyHealthSnapshot(projectId) {
   return {
     id: `no-data:${projectId}`,
@@ -2656,6 +2660,44 @@ function mapHealthRow(r) {
     status: "ready"
   };
 }
+function aggregateHealthSnapshots(projectId, rows) {
+  if (rows.length === 1) return mapHealthRow(rows[0]);
+  let totalPairs = 0;
+  let citedPairs = 0;
+  const mergedProviders = {};
+  let newestCreatedAt = "";
+  const runIds = [];
+  for (const row of rows) {
+    totalPairs += row.totalPairs;
+    citedPairs += row.citedPairs;
+    if (row.createdAt > newestCreatedAt) newestCreatedAt = row.createdAt;
+    if (row.runId) runIds.push(row.runId);
+    const providerBreakdown = parseJsonColumn(row.providerBreakdown, {});
+    for (const [provider, entry] of Object.entries(providerBreakdown)) {
+      const existing = mergedProviders[provider] ?? { total: 0, cited: 0, citedRate: 0 };
+      existing.total += entry.total;
+      existing.cited += entry.cited;
+      mergedProviders[provider] = existing;
+    }
+  }
+  for (const entry of Object.values(mergedProviders)) {
+    entry.citedRate = entry.total > 0 ? entry.cited / entry.total : 0;
+  }
+  const overallCitedRate = totalPairs > 0 ? citedPairs / totalPairs : 0;
+  return {
+    // Synthetic id so consumers can tell this is an aggregate; concatenate
+    // source runIds for traceability without inventing a new schema column.
+    id: `group:${runIds.join(",")}`,
+    projectId,
+    runId: runIds[0] ?? null,
+    overallCitedRate,
+    totalPairs,
+    citedPairs,
+    providerBreakdown: mergedProviders,
+    createdAt: newestCreatedAt,
+    status: "ready"
+  };
+}
 async function intelligenceRoutes(app) {
   app.get("/projects/:name/insights", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -2687,11 +2729,27 @@ async function intelligenceRoutes(app) {
   });
   app.get("/projects/:name/health/latest", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
-    const row = app.db.select().from(healthSnapshots).where(eq11(healthSnapshots.projectId, project.id)).orderBy(desc4(healthSnapshots.createdAt)).limit(1).get();
-    if (!row) {
+    const projectVisRuns = app.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(and3(
+      eq11(runs.projectId, project.id),
+      eq11(runs.kind, RunKinds["answer-visibility"]),
+      inArray3(runs.status, [RunStatuses.completed, RunStatuses.partial])
+    )).orderBy(desc4(runs.createdAt), desc4(runs.id)).all();
+    const latestGroup = groupRunsByCreatedAt(projectVisRuns)[0] ?? [];
+    const latestGroupRunIds = latestGroup.map((r) => r.id);
+    if (latestGroupRunIds.length > 0) {
+      const groupRows = app.db.select().from(healthSnapshots).where(and3(
+        eq11(healthSnapshots.projectId, project.id),
+        inArray3(healthSnapshots.runId, latestGroupRunIds)
+      )).all();
+      if (groupRows.length > 0) {
+        return reply.send(aggregateHealthSnapshots(project.id, groupRows));
+      }
+    }
+    const fallback = app.db.select().from(healthSnapshots).where(eq11(healthSnapshots.projectId, project.id)).orderBy(desc4(healthSnapshots.createdAt)).limit(1).get();
+    if (!fallback) {
       return reply.send(emptyHealthSnapshot(project.id));
     }
-    return reply.send(mapHealthRow(row));
+    return reply.send(mapHealthRow(fallback));
   });
   app.get("/projects/:name/health/history", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -2703,7 +2761,7 @@ async function intelligenceRoutes(app) {
 }
 // ../api-routes/src/report.ts
-import { and as and5, desc as desc6, eq as eq13, gte, inArray as inArray4, lt, lte, ne, or as or2, sql as sql3 } from "drizzle-orm";
+import { and as and5, desc as desc6, eq as eq13, gte, inArray as inArray5, lt, lte, ne, or as or2, sql as sql3 } from "drizzle-orm";
 // ../api-routes/src/report-renderer.ts
 var COLORS = {
@@ -4939,7 +4997,7 @@ function renderReportHtml(report, opts = {}) {
 }
 // ../api-routes/src/content-data.ts
-import { and as and4, eq as eq12, desc as desc5, inArray as inArray3 } from "drizzle-orm";
+import { and as and4, eq as eq12, desc as desc5, inArray as inArray4 } from "drizzle-orm";
 var RECENT_RUNS_WINDOW = 5;
 function loadOrchestratorInput(db, project, locationFilter = void 0) {
   const projectId = project.id;
@@ -5069,7 +5127,7 @@ function listRecentAnswerVisibilityRunIds(db, projectId, limit, locationFilter)
       // Queued/running/failed/cancelled runs may have partial or no
       // snapshots; including them risks pointing latestRunId at a run with
       // no usable evidence.
-      inArray3(runs.status, [RunStatuses.completed, RunStatuses.partial])
+      inArray4(runs.status, [RunStatuses.completed, RunStatuses.partial])
     )
   ).orderBy(desc5(runs.createdAt)).all();
   const filtered = locationFilter === void 0 ? rows : rows.filter((r) => (r.location ?? null) === locationFilter);
@@ -5111,7 +5169,7 @@ function buildCandidateQueries(opts) {
   const queryRows = opts.db.select({ id: queries.id, text: queries.query }).from(queries).where(eq12(queries.projectId, opts.projectId)).all();
   const queryIdByText = new Map(queryRows.map((r) => [r.text, r.id]));
   const candidateQueryIds = opts.candidateQueryStrings.map((q) => queryIdByText.get(q)).filter((id) => Boolean(id));
-  const snapshotRows = opts.db.select().from(querySnapshots).where(inArray3(querySnapshots.runId, opts.recentRunIds)).all().filter((r) => candidateQueryIds.includes(r.queryId));
+  const snapshotRows = opts.db.select().from(querySnapshots).where(inArray4(querySnapshots.runId, opts.recentRunIds)).all().filter((r) => candidateQueryIds.includes(r.queryId));
   const snapshotsByQuery = /* @__PURE__ */ new Map();
   for (const row of snapshotRows) {
     const list = snapshotsByQuery.get(row.queryId) ?? [];
@@ -5329,7 +5387,7 @@ function loadSnapshotsForRun(db, runId) {
 }
 function loadSnapshotsForRunIds(db, runIds) {
   if (runIds.length === 0) return [];
-  const rows = db.select().from(querySnapshots).where(inArray4(querySnapshots.runId, [...runIds])).all();
+  const rows = db.select().from(querySnapshots).where(inArray5(querySnapshots.runId, [...runIds])).all();
   return rows.map((r) => ({
     id: r.id,
     runId: r.runId,
@@ -5909,7 +5967,7 @@ function buildInsightList(db, projectId, locationFilter) {
     )
   ).orderBy(desc6(runs.createdAt)).all().filter((r) => locationFilter === void 0 || (r.location ?? null) === locationFilter).slice(0, INSIGHT_LOOKBACK_RUNS).map((r) => r.id);
   if (recentRunIds.length === 0) return [];
-  const rows = db.select().from(insights).where(and5(eq13(insights.projectId, projectId), inArray4(insights.runId, recentRunIds))).orderBy(desc6(insights.createdAt)).all();
+  const rows = db.select().from(insights).where(and5(eq13(insights.projectId, projectId), inArray5(insights.runId, recentRunIds))).orderBy(desc6(insights.createdAt)).all();
   const severityRank = { critical: 0, high: 1, medium: 2, low: 3 };
   const flat = rows.filter((r) => !r.dismissed).map((r) => {
     const recommendation = parseJsonColumn(r.recommendation, null);
@@ -6671,7 +6729,7 @@ async function reportRoutes(app) {
 }
 // ../api-routes/src/citations.ts
-import { eq as eq14, inArray as inArray5 } from "drizzle-orm";
+import { eq as eq14, inArray as inArray6 } from "drizzle-orm";
 async function citationRoutes(app) {
   app.get("/projects/:name/citations/visibility", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -6695,7 +6753,7 @@ async function citationRoutes(app) {
       competitorOverlap: querySnapshots.competitorOverlap,
       answerMentioned: querySnapshots.answerMentioned,
       createdAt: querySnapshots.createdAt
-    }).from(querySnapshots).where(inArray5(querySnapshots.runId, projectRuns.map((r) => r.id))).all();
+    }).from(querySnapshots).where(inArray6(querySnapshots.runId, projectRuns.map((r) => r.id))).all();
     if (rawSnapshots.length === 0) {
       return reply.send(emptyCitationVisibility("no-runs-yet"));
     }
@@ -6835,7 +6893,7 @@ function normalizeDomain2(domain) {
 }
 // ../api-routes/src/composites.ts
-import { eq as eq15, and as and6, desc as desc7, sql as sql4, like, or as or3, inArray as inArray6 } from "drizzle-orm";
+import { eq as eq15, and as and6, desc as desc7, sql as sql4, like, or as or3, inArray as inArray7 } from "drizzle-orm";
 var TOP_INSIGHT_LIMIT = 5;
 var SEARCH_HIT_HARD_LIMIT = 50;
 var SEARCH_SNIPPET_RADIUS = 80;
@@ -7040,7 +7098,7 @@ function loadSnapshotsByRunIds(app, runIds) {
     citationState: querySnapshots.citationState,
     competitorOverlap: querySnapshots.competitorOverlap,
     citedDomains: querySnapshots.citedDomains
-  }).from(querySnapshots).where(inArray6(querySnapshots.runId, [...runIds])).all();
+  }).from(querySnapshots).where(inArray7(querySnapshots.runId, [...runIds])).all();
   for (const row of rows) {
     const list = result.get(row.runId) ?? [];
     list.push({
@@ -10352,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,
@@ -10362,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 = [
@@ -19631,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,
@@ -19645,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 {
@@ -19681,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";
@@ -22614,7 +22813,7 @@ import crypto24 from "crypto";
 import fs7 from "fs";
 import path9 from "path";
 import os5 from "os";
-import { and as and16, eq as eq27, inArray as inArray7, sql as sql10 } from "drizzle-orm";
+import { and as and16, eq as eq27, inArray as inArray8, sql as sql10 } from "drizzle-orm";
 // src/run-telemetry.ts
 import crypto23 from "crypto";
@@ -22955,7 +23154,7 @@ var JobRunner = class {
     this.registry = registry;
   }
   recoverStaleRuns() {
-    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray7(runs.status, ["running", "queued"])).all();
+    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray8(runs.status, ["running", "queued"])).all();
     if (stale.length === 0) return;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const run of stale) {
@@ -23018,7 +23217,7 @@ var JobRunner = class {
       }
       log.info("run.dispatch", { runId, providerCount: activeProviders.length, providers: activeProviders.map((p) => p.adapter.name) });
       const scopedQueryNames = parseJsonColumn(existingRun.queries, null);
-      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and16(eq27(queries.projectId, projectId), inArray7(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
+      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and16(eq27(queries.projectId, projectId), inArray8(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
       const projectCompetitors = this.db.select().from(competitors).where(eq27(competitors.projectId, projectId)).all();
       const competitorDomains = projectCompetitors.map((c) => c.domain);
       const allDomains = effectiveDomains({
@@ -24428,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
     }),
@@ -24672,7 +24871,7 @@ var Scheduler = class {
 };
 // src/notifier.ts
-import { eq as eq35, desc as desc16, and as and22, inArray as inArray8, or as or4 } from "drizzle-orm";
+import { eq as eq35, desc as desc16, and as and22, inArray as inArray9, or as or4 } from "drizzle-orm";
 import crypto31 from "crypto";
 var log10 = createLogger("Notifier");
 var Notifier = class {
@@ -24825,13 +25024,13 @@ var Notifier = class {
       provider: querySnapshots.provider,
       location: querySnapshots.location,
       citationState: querySnapshots.citationState
-    }).from(querySnapshots).leftJoin(queries, eq35(querySnapshots.queryId, queries.id)).where(inArray8(querySnapshots.runId, currentRunIds)).all();
+    }).from(querySnapshots).leftJoin(queries, eq35(querySnapshots.queryId, queries.id)).where(inArray9(querySnapshots.runId, currentRunIds)).all();
     const previousSnapshots = this.db.select({
       queryId: querySnapshots.queryId,
       provider: querySnapshots.provider,
       location: querySnapshots.location,
       citationState: querySnapshots.citationState
-    }).from(querySnapshots).where(inArray8(querySnapshots.runId, previousRunIds)).all();
+    }).from(querySnapshots).where(inArray9(querySnapshots.runId, previousRunIds)).all();
     const prevMap = /* @__PURE__ */ new Map();
     for (const s of previousSnapshots) {
       prevMap.set(`${s.queryId}:${s.provider}:${s.location ?? ""}`, s.citationState);
@@ -27082,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";