npm - @rankcli/agent-runtime - Versions diffs - 0.0.1 - Mend

@rankcli/agent-runtime 0.0.1

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 (178) hide show

package/README.md +242 -0
package/dist/analyzer-2CSWIQGD.mjs +6 -0
package/dist/chunk-YNZYHEYM.mjs +774 -0
package/dist/index.d.mts +4012 -0
package/dist/index.d.ts +4012 -0
package/dist/index.js +29672 -0
package/dist/index.mjs +28602 -0
package/package.json +53 -0
package/scripts/build-deno.ts +134 -0
package/src/audit/ai/analyzer.ts +347 -0
package/src/audit/ai/index.ts +29 -0
package/src/audit/ai/prompts/content-analysis.ts +271 -0
package/src/audit/ai/types.ts +179 -0
package/src/audit/checks/additional-checks.ts +439 -0
package/src/audit/checks/ai-citation-worthiness.ts +399 -0
package/src/audit/checks/ai-content-structure.ts +325 -0
package/src/audit/checks/ai-readiness.ts +339 -0
package/src/audit/checks/anchor-text.ts +179 -0
package/src/audit/checks/answer-conciseness.ts +322 -0
package/src/audit/checks/asset-minification.ts +270 -0
package/src/audit/checks/bing-optimization.ts +206 -0
package/src/audit/checks/brand-mention-optimization.ts +349 -0
package/src/audit/checks/caching-headers.ts +305 -0
package/src/audit/checks/canonical-advanced.ts +150 -0
package/src/audit/checks/canonical-domain.ts +196 -0
package/src/audit/checks/citation-quality.ts +358 -0
package/src/audit/checks/client-rendering.ts +542 -0
package/src/audit/checks/color-contrast.ts +342 -0
package/src/audit/checks/content-freshness.ts +170 -0
package/src/audit/checks/content-science.ts +589 -0
package/src/audit/checks/conversion-elements.ts +526 -0
package/src/audit/checks/crawlability.ts +220 -0
package/src/audit/checks/directory-listing.ts +172 -0
package/src/audit/checks/dom-analysis.ts +191 -0
package/src/audit/checks/dom-size.ts +246 -0
package/src/audit/checks/duplicate-content.ts +194 -0
package/src/audit/checks/eeat-signals.ts +990 -0
package/src/audit/checks/entity-seo.ts +396 -0
package/src/audit/checks/featured-snippet.ts +473 -0
package/src/audit/checks/freshness-signals.ts +443 -0
package/src/audit/checks/funnel-intent.ts +463 -0
package/src/audit/checks/hreflang.ts +174 -0
package/src/audit/checks/html-compliance.ts +302 -0
package/src/audit/checks/image-dimensions.ts +167 -0
package/src/audit/checks/images.ts +160 -0
package/src/audit/checks/indexnow.ts +275 -0
package/src/audit/checks/interactive-tools.ts +475 -0
package/src/audit/checks/internal-link-graph.ts +436 -0
package/src/audit/checks/keyword-analysis.ts +239 -0
package/src/audit/checks/keyword-cannibalization.ts +385 -0
package/src/audit/checks/keyword-placement.ts +471 -0
package/src/audit/checks/links.ts +203 -0
package/src/audit/checks/llms-txt.ts +224 -0
package/src/audit/checks/local-seo.ts +296 -0
package/src/audit/checks/mobile.ts +167 -0
package/src/audit/checks/modern-images.ts +226 -0
package/src/audit/checks/navboost-signals.ts +395 -0
package/src/audit/checks/on-page.ts +209 -0
package/src/audit/checks/page-resources.ts +285 -0
package/src/audit/checks/pagination.ts +180 -0
package/src/audit/checks/performance.ts +153 -0
package/src/audit/checks/platform-presence.ts +580 -0
package/src/audit/checks/redirect-analysis.ts +153 -0
package/src/audit/checks/redirect-chain.ts +389 -0
package/src/audit/checks/resource-hints.ts +420 -0
package/src/audit/checks/responsive-css.ts +247 -0
package/src/audit/checks/responsive-images.ts +396 -0
package/src/audit/checks/review-ecosystem.ts +415 -0
package/src/audit/checks/robots-validation.ts +373 -0
package/src/audit/checks/security-headers.ts +172 -0
package/src/audit/checks/security.ts +144 -0
package/src/audit/checks/serp-preview.ts +251 -0
package/src/audit/checks/site-maturity.ts +444 -0
package/src/audit/checks/social-meta.test.ts +275 -0
package/src/audit/checks/social-meta.ts +134 -0
package/src/audit/checks/soft-404.ts +151 -0
package/src/audit/checks/structured-data.ts +238 -0
package/src/audit/checks/tech-detection.ts +496 -0
package/src/audit/checks/topical-clusters.ts +435 -0
package/src/audit/checks/tracker-bloat.ts +462 -0
package/src/audit/checks/tracking-verification.test.ts +371 -0
package/src/audit/checks/tracking-verification.ts +636 -0
package/src/audit/checks/url-safety.ts +682 -0
package/src/audit/deno-entry.ts +66 -0
package/src/audit/discovery/index.ts +15 -0
package/src/audit/discovery/link-crawler.ts +232 -0
package/src/audit/discovery/repo-routes.ts +347 -0
package/src/audit/engine.ts +620 -0
package/src/audit/fixes/index.ts +209 -0
package/src/audit/fixes/social-meta-fixes.test.ts +329 -0
package/src/audit/fixes/social-meta-fixes.ts +463 -0
package/src/audit/index.ts +74 -0
package/src/audit/runner.test.ts +299 -0
package/src/audit/runner.ts +130 -0
package/src/audit/types.ts +1953 -0
package/src/content/featured-snippet.ts +367 -0
package/src/content/generator.test.ts +534 -0
package/src/content/generator.ts +501 -0
package/src/content/headline.ts +317 -0
package/src/content/index.ts +62 -0
package/src/content/intent.ts +258 -0
package/src/content/keyword-density.ts +349 -0
package/src/content/readability.ts +262 -0
package/src/executor.ts +336 -0
package/src/fixer.ts +416 -0
package/src/frameworks/detector.test.ts +248 -0
package/src/frameworks/detector.ts +371 -0
package/src/frameworks/index.ts +68 -0
package/src/frameworks/recipes/angular.yaml +171 -0
package/src/frameworks/recipes/astro.yaml +206 -0
package/src/frameworks/recipes/django.yaml +180 -0
package/src/frameworks/recipes/laravel.yaml +137 -0
package/src/frameworks/recipes/nextjs.yaml +268 -0
package/src/frameworks/recipes/nuxt.yaml +175 -0
package/src/frameworks/recipes/rails.yaml +188 -0
package/src/frameworks/recipes/react.yaml +202 -0
package/src/frameworks/recipes/sveltekit.yaml +154 -0
package/src/frameworks/recipes/vue.yaml +137 -0
package/src/frameworks/recipes/wordpress.yaml +209 -0
package/src/frameworks/suggestion-engine.ts +320 -0
package/src/geo/geo-content.test.ts +305 -0
package/src/geo/geo-content.ts +266 -0
package/src/geo/geo-history.test.ts +473 -0
package/src/geo/geo-history.ts +433 -0
package/src/geo/geo-tracker.test.ts +359 -0
package/src/geo/geo-tracker.ts +411 -0
package/src/geo/index.ts +10 -0
package/src/git/commit-helper.test.ts +261 -0
package/src/git/commit-helper.ts +329 -0
package/src/git/index.ts +12 -0
package/src/git/pr-helper.test.ts +284 -0
package/src/git/pr-helper.ts +307 -0
package/src/index.ts +66 -0
package/src/keywords/ai-keyword-engine.ts +1062 -0
package/src/keywords/ai-summarizer.ts +387 -0
package/src/keywords/ci-mode.ts +555 -0
package/src/keywords/engine.ts +359 -0
package/src/keywords/index.ts +151 -0
package/src/keywords/llm-judge.ts +357 -0
package/src/keywords/nlp-analysis.ts +706 -0
package/src/keywords/prioritizer.ts +295 -0
package/src/keywords/site-crawler.ts +342 -0
package/src/keywords/sources/autocomplete.ts +139 -0
package/src/keywords/sources/competitive-search.ts +450 -0
package/src/keywords/sources/competitor-analysis.ts +374 -0
package/src/keywords/sources/dataforseo.ts +206 -0
package/src/keywords/sources/free-sources.ts +294 -0
package/src/keywords/sources/gsc.ts +123 -0
package/src/keywords/topic-grouping.ts +327 -0
package/src/keywords/types.ts +144 -0
package/src/keywords/wizard.ts +457 -0
package/src/loader.ts +40 -0
package/src/reports/index.ts +7 -0
package/src/reports/report-generator.test.ts +293 -0
package/src/reports/report-generator.ts +713 -0
package/src/scheduler/alerts.test.ts +458 -0
package/src/scheduler/alerts.ts +328 -0
package/src/scheduler/index.ts +8 -0
package/src/scheduler/scheduled-audit.test.ts +377 -0
package/src/scheduler/scheduled-audit.ts +149 -0
package/src/test/integration-test.ts +325 -0
package/src/tools/analyzer.ts +373 -0
package/src/tools/crawl.ts +293 -0
package/src/tools/files.ts +301 -0
package/src/tools/h1-fixer.ts +249 -0
package/src/tools/index.ts +67 -0
package/src/tracking/github-action.ts +326 -0
package/src/tracking/google-analytics.ts +265 -0
package/src/tracking/index.ts +45 -0
package/src/tracking/report-generator.ts +386 -0
package/src/tracking/search-console.ts +335 -0
package/src/types.ts +134 -0
package/src/utils/http.ts +302 -0
package/src/wasm-adapter.ts +297 -0
package/src/wasm-entry.ts +14 -0
package/tsconfig.json +17 -0
package/tsup.wasm.config.ts +26 -0
package/vitest.config.ts +15 -0

package/src/reports/report-generator.test.ts ADDED Viewed

@@ -0,0 +1,293 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import {
+  generateHTMLReport,
+  generatePDFReport,
+  ReportConfig,
+  ReportBranding,
+  AuditReportData,
+} from './report-generator.js';
+describe('report-generator', () => {
+  const mockAuditData: AuditReportData = {
+    url: 'https://example.com',
+    domain: 'example.com',
+    timestamp: '2024-01-15T10:00:00Z',
+    score: 72,
+    healthScores: {
+      overall: 72,
+      crawlability: 80,
+      indexability: 75,
+      onPage: 65,
+      content: 70,
+      links: 75,
+      performance: 70,
+      security: 85,
+      aiReadiness: 70,
+      social: 65,
+      localSeo: 60,
+    },
+    summary: {
+      errors: 3,
+      warnings: 8,
+      notices: 5,
+      passed: 84,
+    },
+    issues: [
+      { code: 'TITLE_MISSING', severity: 'error', category: 'on-page', title: 'Missing title', affectedUrls: ['https://example.com/about'] },
+      { code: 'META_DESC_MISSING', severity: 'error', category: 'on-page', title: 'Missing meta description', affectedUrls: ['https://example.com/about'] },
+      { code: 'OG_IMAGE_MISSING', severity: 'warning', category: 'social', title: 'Missing OG image', affectedUrls: ['https://example.com'] },
+    ],
+    pages: [
+      { url: 'https://example.com', score: 75, issues: 2 },
+      { url: 'https://example.com/about', score: 60, issues: 4 },
+    ],
+  };
+  describe('generateHTMLReport', () => {
+    it('generates valid HTML document', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('<!DOCTYPE html>');
+      expect(html).toContain('<html');
+      expect(html).toContain('</html>');
+    });
+    it('includes audit score prominently', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('72');
+      expect(html).toContain('/100');
+    });
+    it('includes domain and timestamp', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('example.com');
+      expect(html).toContain('2024');
+    });
+    it('includes summary statistics', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('3'); // errors
+      expect(html).toContain('8'); // warnings
+      expect(html).toContain('84'); // passed
+    });
+    it('includes category scores', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('Crawlability');
+      expect(html).toContain('80');
+      expect(html).toContain('On-Page');
+      expect(html).toContain('65');
+    });
+    it('lists issues with severity badges', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('TITLE_MISSING');
+      expect(html).toContain('Missing title');
+      expect(html).toContain('error');
+    });
+    it('includes page-level details', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('example.com/about');
+      expect(html).toContain('60');
+    });
+    it('applies default branding when none provided', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('SEO Autopilot');
+    });
+    it('applies custom branding when provided', () => {
+      const branding: ReportBranding = {
+        companyName: 'ACME Agency',
+        logoUrl: 'https://acme.com/logo.png',
+        primaryColor: '#FF5733',
+        accentColor: '#33FF57',
+      };
+      const html = generateHTMLReport(mockAuditData, { branding });
+      expect(html).toContain('ACME Agency');
+      expect(html).toContain('https://acme.com/logo.png');
+      expect(html).toContain('#FF5733');
+    });
+    it('removes SEO Autopilot branding in white-label mode', () => {
+      const branding: ReportBranding = {
+        companyName: 'ACME Agency',
+        whiteLabel: true,
+      };
+      const html = generateHTMLReport(mockAuditData, { branding });
+      expect(html).not.toContain('SEO Autopilot');
+      expect(html).toContain('ACME Agency');
+    });
+    it('includes CSS styling inline', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('<style>');
+      expect(html).toContain('</style>');
+    });
+    it('generates responsive layout', () => {
+      const html = generateHTMLReport(mockAuditData);
+      expect(html).toContain('viewport');
+      expect(html).toContain('@media');
+    });
+  });
+  describe('generatePDFReport', () => {
+    it('returns a Buffer', async () => {
+      const pdf = await generatePDFReport(mockAuditData);
+      expect(pdf).toBeInstanceOf(Buffer);
+    });
+    it('generates non-empty PDF', async () => {
+      const pdf = await generatePDFReport(mockAuditData);
+      expect(pdf.length).toBeGreaterThan(0);
+    });
+    it('applies custom branding', async () => {
+      const branding: ReportBranding = {
+        companyName: 'ACME Agency',
+        whiteLabel: true,
+      };
+      // PDF generation should not throw with custom branding
+      const pdf = await generatePDFReport(mockAuditData, { branding });
+      expect(pdf).toBeInstanceOf(Buffer);
+    });
+  });
+  describe('ReportConfig options', () => {
+    it('includes executive summary when enabled', () => {
+      const config: ReportConfig = {
+        includeExecutiveSummary: true,
+      };
+      const html = generateHTMLReport(mockAuditData, config);
+      expect(html).toContain('Executive Summary');
+    });
+    it('excludes page details when disabled', () => {
+      const config: ReportConfig = {
+        includePageDetails: false,
+      };
+      const html = generateHTMLReport(mockAuditData, config);
+      expect(html).not.toContain('Page Details');
+      // The issues section may still contain URLs, but the page details table should be excluded
+      expect(html).not.toContain('<table class="pages-table">');
+    });
+    it('includes recommendations when enabled', () => {
+      const config: ReportConfig = {
+        includeRecommendations: true,
+      };
+      const html = generateHTMLReport(mockAuditData, config);
+      expect(html).toContain('Recommendations');
+      expect(html).toContain('How to Fix');
+    });
+    it('limits issues shown when maxIssues set', () => {
+      const dataWithManyIssues: AuditReportData = {
+        ...mockAuditData,
+        issues: Array.from({ length: 20 }, (_, i) => ({
+          code: `ISSUE_${i}`,
+          severity: 'warning' as const,
+          category: 'on-page',
+          title: `Issue ${i}`,
+          affectedUrls: [],
+        })),
+      };
+      const config: ReportConfig = {
+        maxIssues: 5,
+      };
+      const html = generateHTMLReport(dataWithManyIssues, config);
+      // Should show "and X more" indicator
+      expect(html).toContain('more');
+    });
+  });
+  describe('score visualization', () => {
+    it('shows green score badge for high scores', () => {
+      const highScoreData = { ...mockAuditData, score: 90 };
+      const html = generateHTMLReport(highScoreData);
+      expect(html).toMatch(/green|success|good/i);
+    });
+    it('shows yellow score badge for medium scores', () => {
+      const mediumScoreData = { ...mockAuditData, score: 60 };
+      const html = generateHTMLReport(mediumScoreData);
+      expect(html).toMatch(/yellow|warning|orange/i);
+    });
+    it('shows red score badge for low scores', () => {
+      const lowScoreData = { ...mockAuditData, score: 30 };
+      const html = generateHTMLReport(lowScoreData);
+      expect(html).toMatch(/red|error|danger/i);
+    });
+  });
+  describe('integration scenarios', () => {
+    it('generates complete agency report', () => {
+      const config: ReportConfig = {
+        branding: {
+          companyName: 'Digital Marketing Pro',
+          logoUrl: 'https://dmp.com/logo.svg',
+          primaryColor: '#1a73e8',
+          accentColor: '#34a853',
+          whiteLabel: true,
+          contactEmail: 'reports@dmp.com',
+          websiteUrl: 'https://dmp.com',
+        },
+        includeExecutiveSummary: true,
+        includeRecommendations: true,
+        includePageDetails: true,
+      };
+      const html = generateHTMLReport(mockAuditData, config);
+      expect(html).toContain('Digital Marketing Pro');
+      expect(html).toContain('Executive Summary');
+      expect(html).toContain('Recommendations');
+      expect(html).not.toContain('SEO Autopilot');
+    });
+    it('generates minimal free report', () => {
+      const config: ReportConfig = {
+        includeExecutiveSummary: false,
+        includeRecommendations: false,
+        includePageDetails: false,
+        maxIssues: 5,
+      };
+      const html = generateHTMLReport(mockAuditData, config);
+      expect(html).toContain('SEO Autopilot');
+      expect(html).not.toContain('Executive Summary');
+    });
+  });
+});