@ainyc/canonry 4.71.0 → 4.72.0

package/dist/{chunk-B32J3DSZ.js → chunk-ZISXWFQA.js}

@@ -9,7 +9,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-ZNWMVYYU.js";
+} from "./chunk-NYZSY5QJ.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -95,7 +95,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-XYBBC5CH.js";
+} from "./chunk-XYX447L2.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -129,6 +129,7 @@ import {
   classifySkillFile,
   coerceSkillManifest,
   contentActionLabel,
+  contentBriefDtoSchema,
   determineAnswerMentioned,
   effectiveBrandNames,
   effectiveDomains,
@@ -142,8 +143,9 @@ import {
   serializeRunError,
   skillsClientSchema,
   validationError,
+  winnabilityClassLabel,
   withRetry
-} from "./chunk-5FM7QRYD.js";
+} from "./chunk-SJI6JGPN.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -5618,7 +5620,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-GV57RTPO.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-YOZOOYUI.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -8455,6 +8457,89 @@ function createRecommendationExplainer(opts) {
     };
   };
 }
+var RECOMMENDATION_BRIEF_PROMPT_VERSION = "v1";
+var BRIEF_SYSTEM_PROMPT = `You are an AEO (Answer Engine Optimization) analyst writing a content brief for a single winnable query. Your audience is the site owner or their agency.
+
+Return ONLY a single JSON object \u2014 no prose, no markdown, no code fences \u2014 with EXACTLY these keys, each a non-empty string:
+- "angle": the differentiated content angle to take (what makes this piece win, not generic advice).
+- "whyWinnable": why this query is winnable for a first-party page, citing the cited-surface signal from the context (competitors vs aggregators, demand, absence).
+- "schemaHookup": the concrete schema.org type or markup to add or extend (e.g. "FAQPage", "Product + Review", "HowTo").
+- "controllableSurfaceRationale": why this cited surface is controllable rather than ceded to aggregators/editorial.
+
+Do not invent facts beyond the supplied context. Be specific and dense.`;
+function buildBriefPrompt(input) {
+  const base = buildRecommendationPrompt(input);
+  const r = input.recommendation;
+  const winnability = r.winnability === null ? "unknown (no classification coverage)" : r.winnability.toFixed(2);
+  return [
+    base,
+    `Surface class: ${winnabilityClassLabel(r.winnabilityClass).toLowerCase()} (the cited surface is ${r.winnabilityClass === "ceded" ? "dominated by aggregators/editorial" : "controllable"})`,
+    `Winnability: ${winnability}`
+  ].join("\n");
+}
+function parseBrief(text, recommendation) {
+  const stripped = text.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(stripped);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const p = parsed;
+  const candidate = {
+    // Deterministic — injected from the recommendation, not the model.
+    targetQuery: recommendation.query,
+    winnabilityClass: recommendation.winnabilityClass,
+    // Creative — taken from the model reply.
+    angle: p.angle,
+    whyWinnable: p.whyWinnable,
+    schemaHookup: p.schemaHookup,
+    controllableSurfaceRationale: p.controllableSurfaceRationale
+  };
+  const result = contentBriefDtoSchema.safeParse(candidate);
+  return result.success ? result.data : null;
+}
+function createRecommendationBriefSynthesizer(opts) {
+  return async (input) => {
+    const provider = pickExplainProvider(opts.config, input.providerOverride);
+    const model = resolveModelForCapability(provider, "analyze", input.modelOverride);
+    const apiKey = resolveApiKeyFor(provider, opts.config);
+    const prompt = buildBriefPrompt({
+      projectName: input.projectName,
+      canonicalDomain: input.canonicalDomain,
+      recommendation: input.recommendation
+    });
+    const MAX_ATTEMPTS = 2;
+    let totalCostDollars = 0;
+    for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+      const userContent = attempt === 0 ? prompt : `${prompt}
+
+Your previous reply was not valid JSON. Return ONLY a JSON object with exactly the keys: angle, whyWinnable, schemaHookup, controllableSurfaceRationale. No prose, no markdown fences.`;
+      const context = {
+        systemPrompt: BRIEF_SYSTEM_PROMPT,
+        messages: [{ role: "user", content: userContent, timestamp: Date.now() }]
+      };
+      const resp = await complete2(model, context, apiKey ? { apiKey } : {});
+      totalCostDollars += Number.isFinite(resp.usage.cost.total) ? resp.usage.cost.total : 0;
+      const parts = resp.content.filter((p) => p.type === "text");
+      const text = parts.map((p) => p.text).join("\n").trim();
+      const brief = parseBrief(text, input.recommendation);
+      if (brief) {
+        return {
+          promptVersion: RECOMMENDATION_BRIEF_PROMPT_VERSION,
+          provider,
+          model: model.id,
+          brief,
+          costMillicents: dollarsToMillicents(totalCostDollars)
+        };
+      }
+    }
+    throw providerError(
+      `Provider '${provider}' returned unparseable brief output after ${MAX_ATTEMPTS} attempts.`
+    );
+  };
+}
 
 // src/snapshot-service.ts
 import { runAeoAudit } from "@ainyc/aeo-audit";
@@ -9820,6 +9905,7 @@ async function createServer(opts) {
     return value;
   };
   const explainContentRecommendation = createRecommendationExplainer({ config: opts.config });
+  const briefContentRecommendation = createRecommendationBriefSynthesizer({ config: opts.config });
   await app.register(apiRoutes, {
     db: opts.db,
     routePrefix: apiPrefix,
@@ -9827,6 +9913,8 @@ async function createServer(opts) {
     sessionCookieName: SESSION_COOKIE_NAME,
     resolveSessionApiKeyId,
     explainContentRecommendation,
+    briefContentRecommendation,
+    briefPromptVersion: RECOMMENDATION_BRIEF_PROMPT_VERSION,
     // On-disk paths the daemon depends on. The api-routes plugin uses these
     // to fail loud (HTTP 503) when the operator wipes the DB or config out
     // from under a running serve — SQLite holds the inode open across