Merge branch 'main' into renovate-major-external-major

Author: solaris007

CHANGELOG.md

@@ -1,3 +1,24 @@
+# [1.212.0](https://github.com/adobe/spacecat-api-service/compare/v1.211.0...v1.212.0) (2025-10-22)
+
+
+### Features
+
+* add slack command to retrieve stats for llmo config ([#1385](https://github.com/adobe/spacecat-api-service/issues/1385)) ([3c994a8](https://github.com/adobe/spacecat-api-service/commit/3c994a82c40d3de143a6e8c343dee8e0670047be))
+
+# [1.211.0](https://github.com/adobe/spacecat-api-service/compare/v1.210.2...v1.211.0) (2025-10-22)
+
+
+### Features
+
+* add FAQs audit ([#1382](https://github.com/adobe/spacecat-api-service/issues/1382)) ([9492b4b](https://github.com/adobe/spacecat-api-service/commit/9492b4b21855974f402a73bfc6bcab7465ce54c0))
+
+## [1.210.2](https://github.com/adobe/spacecat-api-service/compare/v1.210.1...v1.210.2) (2025-10-21)
+
+
+### Bug Fixes
+
+* **deps:** update dependency @adobe/spacecat-shared-utils to v1.60.0 ([#1381](https://github.com/adobe/spacecat-api-service/issues/1381)) ([4099777](https://github.com/adobe/spacecat-api-service/commit/409977769ab0000de0cd28b8ecba045d2e69fa12))
+
 ## [1.210.1](https://github.com/adobe/spacecat-api-service/compare/v1.210.0...v1.210.1) (2025-10-20)
 
 

docs/openapi/schemas.yaml

@@ -61,6 +61,7 @@ AuditType:
     - 'llm-error-pages'
     - 'prerender'
     - 'summarization'
+    - 'faqs'
   example: 'cwv'
 URL:
   type: string
@@ -993,6 +994,29 @@ AuditResult:
           description: A list of top pages
           items:
             type: string
+    - type: object
+      description: The result of FAQs audit
+      properties:
+        success:
+          type: boolean
+          description: Whether the audit was successful
+        promptsByUrl:
+          type: array
+          description: A list of prompts grouped by URL and topic
+          items:
+            type: object
+            properties:
+              url:
+                type: string
+                description: The URL of the page
+              topic:
+                type: string
+                description: The topic of the prompts
+              prompts:
+                type: array
+                description: A list of prompts for this URL and topic
+                items:
+                  type: string
 AuditList:
   type: array
   items:

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-api-service",
-  "version": "1.210.1",
+  "version": "1.212.0",
   "description": "SpaceCat API Service",
   "main": "src/index.js",
   "type": "module",
@@ -74,7 +74,7 @@
     "@adobe/spacecat-helix-content-sdk": "1.4.24",
     "@adobe/spacecat-shared-athena-client": "1.3.5",
     "@adobe/spacecat-shared-brand-client": "1.1.24",
-    "@adobe/spacecat-shared-data-access": "2.73.1",
+    "@adobe/spacecat-shared-data-access": "2.74.0",
     "@adobe/spacecat-shared-gpt-client": "1.6.5",
     "@adobe/spacecat-shared-http-utils": "1.17.7",
     "@adobe/spacecat-shared-ims-client": "1.8.13",

package.json

@@ -22,6 +22,16 @@ const LLMO_PRODUCT_CODE = EntitlementModel.PRODUCT_CODES.LLMO;
 const LLMO_TIER = EntitlementModel.TIERS.FREE_TRIAL;
 const SHAREPOINT_URL = 'https://adobe.sharepoint.com/:x:/r/sites/HelixProjects/Shared%20Documents/sites/elmo-ui-data';
 
+// These audits don't depend on any additonal data being configured
+export const BASIC_AUDITS = [
+  'headings',
+  'llm-blocked',
+  'canonical',
+  'hreflang',
+  'summarization',
+  'prerender',
+];
+
 export const ASO_DEMO_ORG = '66331367-70e6-4a49-8445-4f6d9c265af9';
 
 export const ASO_CRITICAL_SITES = [
@@ -682,6 +692,37 @@ export async function enableAudits(site, context, audits = []) {
   await configuration.save();
 }
 
+export async function enableImports(siteConfig, imports = []) {
+  const existingImports = siteConfig.getImports();
+
+  imports.forEach(({ type, options }) => {
+    // Check if import is already enabled
+    const isEnabled = existingImports?.find(
+      (imp) => imp.type === type && imp.enabled,
+    );
+
+    if (!isEnabled) {
+      siteConfig.enableImport(type, options);
+    }
+  });
+}
+
+export async function triggerAudits(audits, context, site) {
+  const { sqs, dataAccess, log } = context;
+  const { Configuration } = dataAccess;
+  const configuration = await Configuration.findLatest();
+
+  await Promise.allSettled(
+    audits.map(async (audit) => {
+      log.info(`Triggering ${audit} audit for site: ${site.getId()}`);
+      await sqs.sendMessage(configuration.getQueues().audits, {
+        type: audit,
+        siteId: site.getId(),
+      });
+    }),
+  );
+}
+
 /**
  * Complete LLMO onboarding process.
  * @param {object} params - Onboarding parameters
@@ -722,15 +763,16 @@ export async function performLlmoOnboarding(params, context) {
     await updateIndexConfig(dataFolder, context);
 
     // Enable audits
-    await enableAudits(site, context, [
-      'headings',
-      'llm-blocked',
-      'llmo-customer-analysis',
-    ]);
+    await enableAudits(site, context, [...BASIC_AUDITS, 'llm-error-pages', 'llmo-customer-analysis']);
 
     // Get current site config
     const siteConfig = site.getConfig();
 
+    // Enable imports
+    await enableImports(siteConfig, [
+      { type: 'top-pages' },
+    ]);
+
     // Update brand and data directory
     siteConfig.updateLlmoBrand(brandName.trim());
     siteConfig.updateLlmoDataFolder(dataFolder.trim());
@@ -739,6 +781,9 @@ export async function performLlmoOnboarding(params, context) {
     site.setConfig(Config.toDynamoItem(siteConfig));
     await site.save();
 
+    // Trigger audits
+    await triggerAudits([...BASIC_AUDITS], context, site);
+
     return {
       siteId: site.getId(),
       organizationId: organization.getId(),

src/controllers/llmo/llmo-onboarding.js

@@ -19,6 +19,8 @@ import {
   copyFilesToSharepoint,
   updateIndexConfig,
   enableAudits,
+  BASIC_AUDITS,
+  triggerAudits,
 } from '../../../controllers/llmo/llmo-onboarding.js';
 
 const REFERRAL_TRAFFIC_AUDIT = 'llmo-referral-traffic';
@@ -494,6 +496,9 @@ export async function onboardSite(input, lambdaCtx, slackCtx) {
     // enable the llmo-prompts-ahrefs import
     siteConfig.enableImport('llmo-prompts-ahrefs', { limit: 25 });
 
+    // enable top 200 pages import
+    siteConfig.enableImport('top-pages');
+
     // update the site config object
     site.setConfig(Config.toDynamoItem(siteConfig));
 
@@ -531,12 +536,12 @@ export async function onboardSite(input, lambdaCtx, slackCtx) {
       await configuration.save();
 
       await enableAudits(site, lambdaCtx, [
+        ...BASIC_AUDITS,
         AGENTIC_TRAFFIC_REPORT_AUDIT, // enable the cdn-logs-report audits for agentic traffic
         'llmo-customer-analysis', // this generates LLMO excel sheets and triggers audits
         REFERRAL_TRAFFIC_AUDIT,
         'geo-brand-presence',
-        'headings',
-        'llm-blocked',
+        'llm-error-pages',
       ]);
 
       await site.save();
@@ -553,6 +558,8 @@ export async function onboardSite(input, lambdaCtx, slackCtx) {
       };
       await sqs.sendMessage(configuration.getQueues().audits, sqsTriggerMessage);
 
+      await triggerAudits(BASIC_AUDITS, lambdaCtx, site);
+
       const message = `:white_check_mark: *LLMO onboarding completed successfully!*
         
 :link: *Site:* ${baseURL}

src/support/slack/actions/onboard-llmo-modal.js

@@ -33,6 +33,7 @@ import toggleSiteImport from './commands/toggle-site-import.js';
 import runTrafficAnalysisBackfill from './commands/run-traffic-analysis-backfill.js';
 import backfillLlmo from './commands/backfill-llmo.js';
 import getPromptUsage from './commands/get-prompt-usage.js';
+import getLlmoConfigSummary from './commands/get-llmo-config-summary.js';
 
 /**
  * Returns all commands.
@@ -64,4 +65,5 @@ export default (context) => [
   toggleSiteImport(context),
   backfillLlmo(context),
   getPromptUsage(context),
+  getLlmoConfigSummary(context),
 ];