npm - @ainyc/canonry - Versions diffs - 2.6.0 → 2.9.0 - Mend

@ainyc/canonry 2.6.0 → 2.9.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 (9) hide show

package/README.md +23 -2
package/assets/assets/{index-BsNi8T7D.js → index-U1lA1GKP.js} +29 -29
package/assets/index.html +1 -1
package/dist/{chunk-3DUTT6H2.js → chunk-FPZUQADO.js} +11 -3
package/dist/{chunk-LF4O276A.js → chunk-MGBXRWLX.js} +159 -27
package/dist/cli.js +484 -73
package/dist/index.js +2 -2
package/dist/mcp.js +282 -14
package/package.json +4 -4

package/assets/index.html CHANGED Viewed

@@ -12,7 +12,7 @@
     <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-BsNi8T7D.js"></script>
+    <script type="module" crossorigin src="./assets/index-U1lA1GKP.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-CAewPdsZ.css">
   </head>
   <body>

package/dist/{chunk-3DUTT6H2.js → chunk-FPZUQADO.js} RENAMED Viewed

@@ -546,6 +546,10 @@ var keywordDtoSchema = z4.object({
 var keywordBatchRequestSchema = z4.object({
   keywords: z4.array(z4.string().trim().min(1)).min(1)
 });
+var keywordGenerateRequestSchema = z4.object({
+  provider: providerNameSchema,
+  count: z4.number().int().min(1).max(20).optional()
+});
 var competitorDtoSchema = z4.object({
   id: z4.string(),
   domain: z4.string(),
@@ -1677,12 +1681,15 @@ var ApiClient = class {
   async appendKeywords(project, keywords) {
     await this.request("POST", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
   }
-  async putCompetitors(project, competitors) {
-    await this.request("PUT", `/projects/${encodeURIComponent(project)}/competitors`, { competitors });
-  }
   async listCompetitors(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/competitors`);
   }
+  async appendCompetitors(project, competitors) {
+    return this.request("POST", `/projects/${encodeURIComponent(project)}/competitors`, { competitors });
+  }
+  async deleteCompetitors(project, competitors) {
+    return this.request("DELETE", `/projects/${encodeURIComponent(project)}/competitors`, { competitors });
+  }
   async triggerRun(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/runs`, body ?? {});
   }
@@ -2097,6 +2104,7 @@ export {
   hasLocationLabel,
   projectUpsertRequestSchema,
   keywordBatchRequestSchema,
+  keywordGenerateRequestSchema,
   competitorBatchRequestSchema,
   normalizeProjectDomain,
   effectiveDomains,

package/dist/{chunk-LF4O276A.js → chunk-MGBXRWLX.js} RENAMED Viewed

@@ -18,6 +18,7 @@ import {
   brandKeyFromText,
   categorizeSource,
   categoryLabel,
+  competitorBatchRequestSchema,
   configExists,
   deliveryFailed,
   determineAnswerMentioned,
@@ -28,6 +29,7 @@ import {
   internalError,
   isAgentProviderId,
   isBrowserProvider,
+  keywordGenerateRequestSchema,
   loadConfig,
   locationContextSchema,
   missingDependency,
@@ -49,7 +51,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-3DUTT6H2.js";
+} from "./chunk-FPZUQADO.js";
 import {
   IntelligenceService,
   agentMemory,
@@ -660,10 +662,16 @@ async function keywordRoutes(app, opts) {
   });
   app.post("/projects/:name/keywords/generate", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
-    const body = request.body;
-    if (!body?.provider || typeof body.provider !== "string") {
-      throw validationError('Body must contain a "provider" string');
+    const parsed = keywordGenerateRequestSchema.safeParse(request.body);
+    if (!parsed.success) {
+      throw validationError("Invalid keyword generation request", {
+        issues: parsed.error.issues.map((issue) => ({
+          path: issue.path.join("."),
+          message: issue.message
+        }))
+      });
     }
+    const body = parsed.data;
     const provider = body.provider.trim().toLowerCase();
     const validNames = opts.validProviderNames ?? [];
     if (validNames.length && !validNames.includes(provider)) {
@@ -672,10 +680,7 @@ async function keywordRoutes(app, opts) {
         validProviders: validNames
       });
     }
-    if (body.count !== void 0 && (typeof body.count !== "number" || !Number.isFinite(body.count) || !Number.isInteger(body.count))) {
-      throw validationError('"count" must be an integer');
-    }
-    const count = Math.min(Math.max(body.count ?? 5, 1), 20);
+    const count = body.count ?? 5;
     if (!opts.onGenerateKeywords) {
       throw notImplemented("Key phrase generation is not supported in this deployment");
     }
@@ -734,6 +739,79 @@ async function competitorRoutes(app) {
     const rows = app.db.select().from(competitors).where(eq5(competitors.projectId, project.id)).all();
     return reply.send(rows.map((r) => ({ id: r.id, domain: r.domain, createdAt: r.createdAt })));
   });
+  app.post("/projects/:name/competitors", async (request, reply) => {
+    const project = resolveProject(app.db, request.params.name);
+    const body = parseCompetitorBatch(request.body);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const requested = uniqueStrings(body.competitors);
+    app.db.transaction((tx) => {
+      const existing = tx.select().from(competitors).where(eq5(competitors.projectId, project.id)).all();
+      const existingSet = new Set(existing.map((c) => c.domain));
+      const added = requested.filter((domain) => !existingSet.has(domain));
+      if (added.length === 0) return;
+      for (const domain of added) {
+        tx.insert(competitors).values({
+          id: crypto6.randomUUID(),
+          projectId: project.id,
+          domain,
+          createdAt: now
+        }).onConflictDoNothing({
+          target: [competitors.projectId, competitors.domain]
+        }).run();
+      }
+      writeAuditLog(tx, {
+        projectId: project.id,
+        actor: "api",
+        action: "competitors.appended",
+        entityType: "competitor",
+        diff: { added }
+      });
+    });
+    const rows = app.db.select().from(competitors).where(eq5(competitors.projectId, project.id)).all();
+    return reply.send(rows.map((r) => ({ id: r.id, domain: r.domain, createdAt: r.createdAt })));
+  });
+  app.delete("/projects/:name/competitors", async (request, reply) => {
+    const project = resolveProject(app.db, request.params.name);
+    const body = parseCompetitorBatch(request.body);
+    const requested = new Set(uniqueStrings(body.competitors));
+    app.db.transaction((tx) => {
+      const existing = tx.select().from(competitors).where(eq5(competitors.projectId, project.id)).all();
+      const rowsToDelete = existing.filter((c) => requested.has(c.domain));
+      if (rowsToDelete.length === 0) return;
+      for (const row of rowsToDelete) {
+        tx.delete(competitors).where(eq5(competitors.id, row.id)).run();
+      }
+      writeAuditLog(tx, {
+        projectId: project.id,
+        actor: "api",
+        action: "competitors.deleted",
+        entityType: "competitor",
+        diff: { deleted: rowsToDelete.map((row) => row.domain) }
+      });
+    });
+    const rows = app.db.select().from(competitors).where(eq5(competitors.projectId, project.id)).all();
+    return reply.send(rows.map((r) => ({ id: r.id, domain: r.domain, createdAt: r.createdAt })));
+  });
+}
+function parseCompetitorBatch(value) {
+  const result = competitorBatchRequestSchema.safeParse(value);
+  if (result.success) return result.data;
+  throw validationError("Invalid competitor batch request", {
+    issues: result.error.issues.map((issue) => ({
+      path: issue.path.join("."),
+      message: issue.message
+    }))
+  });
+}
+function uniqueStrings(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const value of values) {
+    if (seen.has(value)) continue;
+    seen.add(value);
+    result.push(value);
+  }
+  return result;
 }
 // ../api-routes/src/runs.ts
@@ -985,7 +1063,12 @@ async function runRoutes(app, opts) {
 function parseRunTriggerRequest(value) {
   const result = runTriggerRequestSchema.safeParse(value);
   if (result.success) return result.data;
-  throw validationError("Invalid run trigger request", { issues: result.error.issues });
+  throw validationError("Invalid run trigger request", {
+    issues: result.error.issues.map((issue) => ({
+      path: issue.path.join("."),
+      message: issue.message
+    }))
+  });
 }
 function formatRun(row) {
   return {
@@ -2658,6 +2741,56 @@ var routeCatalog = [
       200: { description: "Competitors replaced." }
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/competitors",
+    summary: "Append competitors",
+    tags: ["competitors"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["competitors"],
+            properties: {
+              competitors: stringArraySchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Competitors appended." },
+      400: { description: "Invalid competitor append request." }
+    }
+  },
+  {
+    method: "delete",
+    path: "/api/v1/projects/{name}/competitors",
+    summary: "Delete specific competitors",
+    tags: ["competitors"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["competitors"],
+            properties: {
+              competitors: stringArraySchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Remaining competitors returned." },
+      400: { description: "Invalid competitor delete request." }
+    }
+  },
   {
     method: "post",
     path: "/api/v1/projects/{name}/runs",
@@ -15395,7 +15528,7 @@ function buildAddCompetitorsTool(ctx) {
   return {
     name: "add_competitors",
     label: "Add competitors",
-    description: "Append competitor domains to the project. Fetches the current set, merges with the requested domains (dedup on exact domain match), and persists the combined list.",
+    description: "Append competitor domains to the project. Existing competitors are skipped by the API.",
     parameters: AddCompetitorsSchema,
     execute: async (_toolCallId, params) => {
       const existing = await ctx.client.listCompetitors(ctx.projectName);
@@ -15404,8 +15537,7 @@ function buildAddCompetitorsTool(ctx) {
       if (newDomains.length === 0) {
         return textResult2({ added: [], alreadyTracked: params.domains });
       }
-      const merged = [...existing.map((c) => c.domain), ...newDomains];
-      await ctx.client.putCompetitors(ctx.projectName, merged);
+      await ctx.client.appendCompetitors(ctx.projectName, newDomains);
       return textResult2({ added: newDomains, alreadyTracked: params.domains.filter((d) => existingDomains.has(d)) });
     }
   };
@@ -16581,7 +16713,7 @@ var SnapshotService = class {
     });
     const enrichedResults = applyBatchAssessment(queryResults, batchAssessment);
     const summary = buildSnapshotSummary(companyName, profile.phrases, providers, enrichedResults, audit, batchAssessment);
-    const reportCompetitors = uniqueStrings([
+    const reportCompetitors = uniqueStrings2([
       ...manualCompetitors,
       ...summary.topCompetitors.map((entry) => entry.name)
     ]);
@@ -16634,8 +16766,8 @@ var SnapshotService = class {
         return {
           industry: parsed.industry?.trim() || "Unknown",
           summary: parsed.summary?.trim() || ctx.audit.summary,
-          services: uniqueStrings(parsed.services ?? []).slice(0, 6),
-          categoryTerms: uniqueStrings(parsed.categoryTerms ?? []).slice(0, 8),
+          services: uniqueStrings2(parsed.services ?? []).slice(0, 6),
+          categoryTerms: uniqueStrings2(parsed.categoryTerms ?? []).slice(0, 8),
           phrases: parsedPhrases
         };
       } catch (err) {
@@ -16703,9 +16835,9 @@ var SnapshotService = class {
               accuracyNotes: null,
               incorrectClaims: [],
               recommendedCompetitors: preliminaryCompetitors,
-              citedDomains: uniqueStrings(normalized.citedDomains),
+              citedDomains: uniqueStrings2(normalized.citedDomains),
               groundingSources: normalized.groundingSources,
-              searchQueries: uniqueStrings(normalized.searchQueries),
+              searchQueries: uniqueStrings2(normalized.searchQueries),
               answerText: normalized.answerText,
               error: null
             };
@@ -16771,14 +16903,14 @@ var SnapshotService = class {
             mentioned: assessment.mentioned,
             describedAccurately: assessment.describedAccurately,
             accuracyNotes: assessment.accuracyNotes ?? null,
-            incorrectClaims: uniqueStrings(assessment.incorrectClaims ?? []).slice(0, 5),
+            incorrectClaims: uniqueStrings2(assessment.incorrectClaims ?? []).slice(0, 5),
             ...hasReviewedCompetitors ? {
-              recommendedCompetitors: uniqueStrings(assessment.recommendedCompetitors ?? []).slice(0, 10)
+              recommendedCompetitors: uniqueStrings2(assessment.recommendedCompetitors ?? []).slice(0, 10)
             } : {}
           };
         }),
-        whatThisMeans: uniqueStrings(parsed.whatThisMeans ?? []).slice(0, 4),
-        recommendedActions: uniqueStrings(parsed.recommendedActions ?? []).slice(0, 4)
+        whatThisMeans: uniqueStrings2(parsed.whatThisMeans ?? []).slice(0, 4),
+        recommendedActions: uniqueStrings2(parsed.recommendedActions ?? []).slice(0, 4)
       };
     } catch (err) {
       log12.warn("response.analysis-failed", {
@@ -16873,13 +17005,13 @@ function applyBatchAssessment(queryResults, batchAssessment) {
         };
       }
       const reviewedCompetitors = assessment.recommendedCompetitors;
-      const recommendedCompetitors = reviewedCompetitors !== void 0 ? uniqueStrings(reviewedCompetitors) : result.recommendedCompetitors;
+      const recommendedCompetitors = reviewedCompetitors !== void 0 ? uniqueStrings2(reviewedCompetitors) : result.recommendedCompetitors;
       return {
         ...result,
         mentioned: result.mentioned || assessment.mentioned === true,
         describedAccurately: assessment.describedAccurately ?? (result.mentioned ? "unknown" : "not-mentioned"),
         accuracyNotes: assessment.accuracyNotes ?? result.accuracyNotes ?? null,
-        incorrectClaims: uniqueStrings([
+        incorrectClaims: uniqueStrings2([
           ...result.incorrectClaims,
           ...assessment.incorrectClaims ?? []
         ]),
@@ -16909,7 +17041,7 @@ function buildSnapshotSummary(companyName, phrases, providers, queryResults, aud
   const whatThisMeans = batchAssessment.whatThisMeans.length > 0 ? batchAssessment.whatThisMeans : [
     defaultMeaning
   ];
-  const combinedWhatThisMeans = uniqueStrings([...whatThisMeans, ...failureNote]).slice(0, 5);
+  const combinedWhatThisMeans = uniqueStrings2([...whatThisMeans, ...failureNote]).slice(0, 5);
   const recommendedActions = batchAssessment.recommendedActions.length > 0 ? batchAssessment.recommendedActions : buildFallbackRecommendedActions(audit);
   return {
     totalQueries: phrases.length,
@@ -16952,7 +17084,7 @@ function buildFallbackRecommendedActions(audit) {
     "Add machine-readable trust signals such as schema, FAQs, and llms.txt support.",
     "Build comparison and proof content that makes the category fit unmistakable."
   ];
-  return uniqueStrings([...weakestFactors, ...defaults]).slice(0, 4);
+  return uniqueStrings2([...weakestFactors, ...defaults]).slice(0, 4);
 }
 function citesTargetDomain(citedDomains, groundingSources, targetDomain) {
   const normalizedTarget = extractHostname2(targetDomain);
@@ -17026,11 +17158,11 @@ function parseJsonObject(input) {
 }
 function normalizeStringList(values) {
   const items = values.flatMap((value) => value.split(","));
-  return uniqueStrings(
+  return uniqueStrings2(
     items.map((value) => value.trim()).filter(Boolean)
   );
 }
-function uniqueStrings(values) {
+function uniqueStrings2(values) {
   if (!Array.isArray(values)) return [];
   return [...new Set(
     values.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean)