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/audit/checks/tracking-verification.test.ts ADDED Viewed

@@ -0,0 +1,371 @@
+import { describe, it, expect } from 'vitest';
+import { analyzeTrackingVerification } from './tracking-verification.js';
+describe('analyzeTrackingVerification', () => {
+  const testUrl = 'https://example.com';
+  describe('Google Analytics 4 detection', () => {
+    it('detects GA4 gtag.js tracking code', () => {
+      const html = `
+        <html>
+          <head>
+            <script async src="https://www.googletagmanager.com/gtag/js?id=G-ABC123XYZ"></script>
+            <script>
+              window.dataLayer = window.dataLayer || [];
+              function gtag(){dataLayer.push(arguments);}
+              gtag('js', new Date());
+              gtag('config', 'G-ABC123XYZ');
+            </script>
+          </head>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.ga4.detected).toBe(true);
+      expect(data.ga4.measurementId).toBe('G-ABC123XYZ');
+      const ga4Issue = issues.find((i) => i.code === 'GA4_MISSING');
+      expect(ga4Issue).toBeUndefined();
+    });
+    it('detects GA4 from script src only', () => {
+      const html = `
+        <html>
+          <head>
+            <script async src="https://www.googletagmanager.com/gtag/js?id=G-TESTID123"></script>
+          </head>
+        </html>
+      `;
+      const { data } = analyzeTrackingVerification(html, testUrl);
+      expect(data.ga4.detected).toBe(true);
+      expect(data.ga4.measurementId).toBe('G-TESTID123');
+    });
+    it('reports missing GA4 when not present', () => {
+      const html = `<html><head></head></html>`;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.ga4.detected).toBe(false);
+      expect(data.ga4.measurementId).toBeUndefined();
+      const ga4Issue = issues.find((i) => i.code === 'GA4_MISSING');
+      expect(ga4Issue).toBeDefined();
+      expect(ga4Issue?.severity).toBe('warning');
+      expect(ga4Issue?.affectedUrls).toContain(testUrl);
+    });
+    it('does not report missing GA4 if GTM is present', () => {
+      const html = `
+        <html>
+          <head>
+            <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
+            'https://www.googletagmanager.com/gtm.js?id=GTM-ABC123';f.parentNode.insertBefore(j,f);
+            })(window,document,'script','dataLayer','GTM-ABC123');</script>
+          </head>
+        </html>
+      `;
+      const { issues } = analyzeTrackingVerification(html, testUrl);
+      const ga4Issue = issues.find((i) => i.code === 'GA4_MISSING');
+      expect(ga4Issue).toBeUndefined();
+    });
+  });
+  describe('Google Tag Manager detection', () => {
+    it('detects GTM with noscript fallback', () => {
+      const html = `
+        <html>
+          <head>
+            <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
+            'https://www.googletagmanager.com/gtm.js?id=GTM-TESTID';f.parentNode.insertBefore(j,f);
+            })(window,document,'script','dataLayer','GTM-TESTID');</script>
+          </head>
+          <body>
+            <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-TESTID"
+            height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
+          </body>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.gtm.detected).toBe(true);
+      expect(data.gtm.containerId).toBe('GTM-TESTID');
+      expect(data.gtm.hasNoscript).toBe(true);
+      const gtmIssue = issues.find((i) => i.code === 'GTM_MISSING');
+      expect(gtmIssue).toBeUndefined();
+      const noscriptIssue = issues.find((i) => i.code === 'GTM_NOSCRIPT_MISSING');
+      expect(noscriptIssue).toBeUndefined();
+    });
+    it('reports missing noscript when GTM present without it', () => {
+      const html = `
+        <html>
+          <head>
+            <script src="https://www.googletagmanager.com/gtm.js?id=GTM-ABC123"></script>
+          </head>
+          <body></body>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.gtm.detected).toBe(true);
+      expect(data.gtm.hasNoscript).toBe(false);
+      const noscriptIssue = issues.find((i) => i.code === 'GTM_NOSCRIPT_MISSING');
+      expect(noscriptIssue).toBeDefined();
+      expect(noscriptIssue?.severity).toBe('notice');
+    });
+    it('reports missing GTM as informational', () => {
+      const html = `<html><head></head></html>`;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.gtm.detected).toBe(false);
+      const gtmIssue = issues.find((i) => i.code === 'GTM_MISSING');
+      expect(gtmIssue).toBeDefined();
+      expect(gtmIssue?.severity).toBe('notice');
+    });
+  });
+  describe('Google Search Console verification', () => {
+    it('detects GSC verification meta tag', () => {
+      const html = `
+        <html>
+          <head>
+            <meta name="google-site-verification" content="abc123xyz789verificationcode" />
+          </head>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.gsc.verified).toBe(true);
+      expect(data.gsc.verificationCode).toBe('abc123xyz789verificationcode');
+      const gscIssue = issues.find((i) => i.code === 'GSC_VERIFICATION_MISSING');
+      expect(gscIssue).toBeUndefined();
+    });
+    it('reports missing GSC verification', () => {
+      const html = `<html><head></head></html>`;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.gsc.verified).toBe(false);
+      const gscIssue = issues.find((i) => i.code === 'GSC_VERIFICATION_MISSING');
+      expect(gscIssue).toBeDefined();
+      expect(gscIssue?.severity).toBe('warning');
+    });
+    it('rejects short verification codes as invalid', () => {
+      const html = `
+        <html>
+          <head>
+            <meta name="google-site-verification" content="short" />
+          </head>
+        </html>
+      `;
+      const { data } = analyzeTrackingVerification(html, testUrl);
+      expect(data.gsc.verified).toBe(false);
+    });
+  });
+  describe('Bing Webmaster Tools verification', () => {
+    it('detects Bing verification meta tag', () => {
+      const html = `
+        <html>
+          <head>
+            <meta name="msvalidate.01" content="BING12345678901234567890" />
+          </head>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.bing.verified).toBe(true);
+      expect(data.bing.verificationCode).toBe('BING12345678901234567890');
+      const bingIssue = issues.find((i) => i.code === 'BING_VERIFICATION_MISSING');
+      expect(bingIssue).toBeUndefined();
+    });
+    it('reports missing Bing verification as notice', () => {
+      const html = `<html><head></head></html>`;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.bing.verified).toBe(false);
+      const bingIssue = issues.find((i) => i.code === 'BING_VERIFICATION_MISSING');
+      expect(bingIssue).toBeDefined();
+      expect(bingIssue?.severity).toBe('notice');
+    });
+  });
+  describe('Schema.org structured data detection', () => {
+    it('detects JSON-LD structured data', () => {
+      const html = `
+        <html>
+          <head>
+            <script type="application/ld+json">
+              {
+                "@context": "https://schema.org",
+                "@type": "Organization",
+                "name": "Test Company",
+                "url": "https://example.com"
+              }
+            </script>
+          </head>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.schemaOrg.detected).toBe(true);
+      expect(data.schemaOrg.types).toContain('Organization');
+      expect(data.schemaOrg.hasValidJson).toBe(true);
+      const schemaIssue = issues.find((i) => i.code === 'SCHEMA_ORG_MISSING');
+      expect(schemaIssue).toBeUndefined();
+    });
+    it('detects microdata structured data', () => {
+      const html = `
+        <html>
+          <body>
+            <div itemscope itemtype="https://schema.org/Product">
+              <span itemprop="name">Test Product</span>
+            </div>
+          </body>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.schemaOrg.detected).toBe(true);
+      const schemaIssue = issues.find((i) => i.code === 'SCHEMA_ORG_MISSING');
+      expect(schemaIssue).toBeUndefined();
+    });
+    it('reports missing structured data', () => {
+      const html = `<html><head></head><body></body></html>`;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.schemaOrg.detected).toBe(false);
+      const schemaIssue = issues.find((i) => i.code === 'SCHEMA_ORG_MISSING');
+      expect(schemaIssue).toBeDefined();
+      expect(schemaIssue?.severity).toBe('warning');
+    });
+    it('reports invalid JSON-LD', () => {
+      const html = `
+        <html>
+          <head>
+            <script type="application/ld+json">
+              { invalid json here }
+            </script>
+          </head>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.schemaOrg.detected).toBe(true);
+      expect(data.schemaOrg.hasValidJson).toBe(false);
+      const invalidIssue = issues.find((i) => i.code === 'SCHEMA_ORG_INVALID');
+      expect(invalidIssue).toBeDefined();
+      expect(invalidIssue?.severity).toBe('error');
+    });
+    it('extracts multiple schema types', () => {
+      const html = `
+        <html>
+          <head>
+            <script type="application/ld+json">
+              { "@context": "https://schema.org", "@type": "Organization", "name": "Test" }
+            </script>
+            <script type="application/ld+json">
+              { "@context": "https://schema.org", "@type": "WebSite", "url": "https://example.com" }
+            </script>
+          </head>
+        </html>
+      `;
+      const { data } = analyzeTrackingVerification(html, testUrl);
+      expect(data.schemaOrg.types).toContain('Organization');
+      expect(data.schemaOrg.types).toContain('WebSite');
+    });
+  });
+  describe('Complete tracking analysis', () => {
+    it('analyzes fully configured page with all tracking', () => {
+      const html = `
+        <!DOCTYPE html>
+        <html lang="en">
+          <head>
+            <meta name="google-site-verification" content="googleverification123456" />
+            <meta name="msvalidate.01" content="bingverification123456789" />
+            <script async src="https://www.googletagmanager.com/gtag/js?id=G-MEASUREMENT1"></script>
+            <script>
+              window.dataLayer = window.dataLayer || [];
+              function gtag(){dataLayer.push(arguments);}
+              gtag('js', new Date());
+              gtag('config', 'G-MEASUREMENT1');
+            </script>
+            <script type="application/ld+json">
+              { "@context": "https://schema.org", "@type": "Organization", "name": "Test" }
+            </script>
+          </head>
+          <body></body>
+        </html>
+      `;
+      const { data, issues } = analyzeTrackingVerification(html, testUrl);
+      expect(data.ga4.detected).toBe(true);
+      expect(data.gsc.verified).toBe(true);
+      expect(data.bing.verified).toBe(true);
+      expect(data.schemaOrg.detected).toBe(true);
+      // Should only have GTM missing (which is informational)
+      const criticalIssues = issues.filter((i) => i.severity === 'error' || i.severity === 'warning');
+      expect(criticalIssues).toHaveLength(0);
+    });
+    it('analyzes page with no tracking configured', () => {
+      const html = `<html><head></head><body></body></html>`;
+      const { issues } = analyzeTrackingVerification(html, testUrl);
+      const issueCodes = issues.map((i) => i.code);
+      expect(issueCodes).toContain('GA4_MISSING');
+      expect(issueCodes).toContain('GSC_VERIFICATION_MISSING');
+      expect(issueCodes).toContain('BING_VERIFICATION_MISSING');
+      expect(issueCodes).toContain('GTM_MISSING');
+      expect(issueCodes).toContain('SCHEMA_ORG_MISSING');
+    });
+  });
+});