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/frameworks/recipes/astro.yaml ADDED Viewed

@@ -0,0 +1,206 @@
+# Astro SEO Recipe
+# Astro is SEO-first by design - zero JS by default, excellent for content sites
+framework: astro
+display_name: Astro
+category: static-first
+ssr_default: false  # Static by default, SSR optional
+seo_strengths:
+  - "Zero JavaScript by default"
+  - "Static HTML output"
+  - "Excellent performance (100 Lighthouse)"
+  - "Content Collections for organized content"
+  - "Built-in sitemap and RSS integrations"
+  - "Partial hydration (Islands Architecture)"
+checks:
+  - code: ASTRO_NO_SITEMAP
+    severity: warning
+    title: "Missing sitemap integration"
+    description: "Astro has a built-in sitemap integration."
+    howToFix: |
+      Add the sitemap integration:
+      ```bash
+      npx astro add sitemap
+      ```
+      Configure in astro.config.mjs:
+      ```js
+      import sitemap from '@astrojs/sitemap';
+      export default defineConfig({
+        site: 'https://yoursite.com',
+        integrations: [sitemap()],
+      });
+      ```
+  - code: ASTRO_NO_SITE_CONFIG
+    severity: error
+    title: "Missing site URL configuration"
+    description: "The site URL is required for sitemap and canonical URLs."
+    howToFix: |
+      Add site to astro.config.mjs:
+      ```js
+      export default defineConfig({
+        site: 'https://yoursite.com',
+      });
+      ```
+  - code: ASTRO_CLIENT_DIRECTIVE_OVERUSE
+    severity: warning
+    title: "Overusing client: directives"
+    description: "Too many client-side components reduce Astro's performance benefits."
+    howToFix: |
+      Only hydrate components that need interactivity:
+      ```astro
+      <!-- Bad - unnecessary JS -->
+      <StaticCard client:load />
+      <!-- Good - no JS for static content -->
+      <StaticCard />
+      <!-- Good - only hydrate when needed -->
+      <InteractiveWidget client:visible />
+      ```
+      Prefer client:visible over client:load for below-fold content.
+  - code: ASTRO_NO_BASE_LAYOUT
+    severity: notice
+    title: "Pages missing base layout"
+    description: "Using a shared layout ensures consistent SEO tags."
+    howToFix: |
+      Create a BaseLayout.astro:
+      ```astro
+      ---
+      // src/layouts/BaseLayout.astro
+      interface Props {
+        title: string;
+        description: string;
+      }
+      const { title, description } = Astro.props;
+      ---
+      <html lang="en">
+        <head>
+          <meta charset="UTF-8" />
+          <meta name="viewport" content="width=device-width" />
+          <title>{title}</title>
+          <meta name="description" content={description} />
+          <link rel="canonical" href={Astro.url} />
+        </head>
+        <body>
+          <slot />
+        </body>
+      </html>
+      ```
+  - code: ASTRO_NO_ASTRO_SEO
+    severity: notice
+    title: "Not using @astrolib/seo"
+    description: "The astro-seo package provides comprehensive SEO components."
+    howToFix: |
+      Install astro-seo:
+      ```bash
+      npm install astro-seo
+      ```
+      ```astro
+      ---
+      import { SEO } from 'astro-seo';
+      ---
+      <SEO
+        title="Page Title"
+        description="Description"
+        openGraph={{
+          basic: {
+            title: "OG Title",
+            type: "website",
+            image: "/og-image.jpg",
+          }
+        }}
+        twitter={{
+          creator: "@handle"
+        }}
+      />
+      ```
+  - code: ASTRO_IMAGE_NOT_OPTIMIZED
+    severity: warning
+    title: "Images not using Astro Image"
+    description: "Use Astro's built-in Image component for optimization."
+    howToFix: |
+      Use the Image component:
+      ```astro
+      ---
+      import { Image } from 'astro:assets';
+      import heroImage from '../assets/hero.jpg';
+      ---
+      <Image
+        src={heroImage}
+        alt="Hero"
+        width={1200}
+        height={630}
+        loading="eager"
+      />
+      ```
+  - code: ASTRO_NO_CONTENT_COLLECTIONS
+    severity: notice
+    title: "Not using Content Collections"
+    description: "Content Collections provide type-safe content with built-in frontmatter validation."
+    howToFix: |
+      Define a collection in src/content/config.ts:
+      ```ts
+      import { defineCollection, z } from 'astro:content';
+      const blog = defineCollection({
+        schema: z.object({
+          title: z.string(),
+          description: z.string(),
+          pubDate: z.date(),
+        }),
+      });
+      export const collections = { blog };
+      ```
+  - code: ASTRO_SSR_OVERUSE
+    severity: notice
+    title: "Using SSR when static would work"
+    description: "Static pages are faster and cheaper to host."
+    howToFix: |
+      Use prerender for pages that don't need SSR:
+      ```astro
+      ---
+      export const prerender = true; // Static generation
+      ---
+      ```
+      Or set default to static in config:
+      ```js
+      export default defineConfig({
+        output: 'hybrid', // Static by default, SSR opt-in
+      });
+      ```
+performance_tips:
+  - "Use client:visible instead of client:load for below-fold components"
+  - "Leverage Content Collections for type-safe content"
+  - "Use View Transitions for smooth navigation"
+  - "Optimize images with astro:assets"
+  - "Consider using Astro DB for dynamic content"
+integrations:
+  - "@astrojs/sitemap - Automatic sitemap generation"
+  - "@astrojs/rss - RSS feed for blogs"
+  - "astro-seo - Comprehensive SEO component"
+  - "@astrojs/partytown - Move third-party scripts to web worker"

package/src/frameworks/recipes/django.yaml ADDED Viewed

@@ -0,0 +1,180 @@
+# Django SEO Recipe
+# Django is the most popular Python web framework
+framework: django
+display_name: Django
+category: server-rendered
+ssr_default: true
+seo_strengths:
+  - "Server-rendered HTML by default"
+  - "Built-in sitemap framework"
+  - "Admin interface for content management"
+  - "Mature ecosystem"
+checks:
+  - code: DJANGO_NO_SITEMAP
+    severity: warning
+    title: "Django sitemap framework not configured"
+    description: "Django has a built-in sitemap framework that should be used."
+    howToFix: |
+      Add sitemap to your project:
+      ```python
+      # settings.py
+      INSTALLED_APPS = [
+          'django.contrib.sitemaps',
+      ]
+      # sitemaps.py
+      from django.contrib.sitemaps import Sitemap
+      from .models import Post
+      class PostSitemap(Sitemap):
+          changefreq = "weekly"
+          priority = 0.8
+          def items(self):
+              return Post.objects.filter(published=True)
+          def lastmod(self, obj):
+              return obj.updated_at
+      # urls.py
+      from django.contrib.sitemaps.views import sitemap
+      from .sitemaps import PostSitemap
+      sitemaps = {'posts': PostSitemap}
+      urlpatterns = [
+          path('sitemap.xml', sitemap, {'sitemaps': sitemaps}),
+      ]
+      ```
+  - code: DJANGO_NO_META_FRAMEWORK
+    severity: warning
+    title: "No SEO meta framework detected"
+    description: "Use django-meta for consistent meta tag management."
+    howToFix: |
+      Install django-meta:
+      ```bash
+      pip install django-meta
+      ```
+      ```python
+      # settings.py
+      INSTALLED_APPS = ['meta']
+      META_SITE_PROTOCOL = 'https'
+      META_USE_OG_PROPERTIES = True
+      META_USE_TWITTER_PROPERTIES = True
+      ```
+      ```python
+      # In views or models
+      from meta.views import MetadataMixin
+      class PostDetailView(MetadataMixin, DetailView):
+          def get_meta_title(self):
+              return self.object.title
+          def get_meta_description(self):
+              return self.object.excerpt
+      ```
+  - code: DJANGO_DEBUG_TRUE
+    severity: error
+    title: "DEBUG mode appears enabled"
+    description: "DEBUG=True in production exposes sensitive information and hurts performance."
+    howToFix: |
+      Ensure DEBUG is False in production:
+      ```python
+      # settings.py
+      DEBUG = os.environ.get('DEBUG', 'False') == 'True'
+      ```
+      Or use django-environ:
+      ```python
+      import environ
+      env = environ.Env(DEBUG=(bool, False))
+      DEBUG = env('DEBUG')
+      ```
+  - code: DJANGO_NO_CACHE
+    severity: warning
+    title: "Caching not configured"
+    description: "Django without caching is slower than it should be."
+    howToFix: |
+      Configure caching in settings.py:
+      ```python
+      # Redis (recommended)
+      CACHES = {
+          'default': {
+              'BACKEND': 'django.core.cache.backends.redis.RedisCache',
+              'LOCATION': 'redis://127.0.0.1:6379',
+          }
+      }
+      # Use cache in views
+      from django.views.decorators.cache import cache_page
+      @cache_page(60 * 15)  # 15 minutes
+      def my_view(request):
+          ...
+      ```
+  - code: DJANGO_NO_GZIP
+    severity: notice
+    title: "GZip middleware not enabled"
+    description: "Enable GZip compression for faster page loads."
+    howToFix: |
+      Add GZip middleware:
+      ```python
+      # settings.py
+      MIDDLEWARE = [
+          'django.middleware.gzip.GZipMiddleware',
+          # ... other middleware
+      ]
+      ```
+  - code: DJANGO_NO_WHITENOISE
+    severity: notice
+    title: "Static files not optimized"
+    description: "Use WhiteNoise for efficient static file serving."
+    howToFix: |
+      Install and configure WhiteNoise:
+      ```bash
+      pip install whitenoise
+      ```
+      ```python
+      # settings.py
+      MIDDLEWARE = [
+          'django.middleware.security.SecurityMiddleware',
+          'whitenoise.middleware.WhiteNoiseMiddleware',
+          # ...
+      ]
+      STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
+      ```
+performance_tips:
+  - "Use select_related/prefetch_related for queries"
+  - "Enable template caching in production"
+  - "Use django-debug-toolbar in development"
+  - "Configure database connection pooling"
+  - "Use async views for I/O-bound operations (Django 4.1+)"
+recommended_packages:
+  seo:
+    - "django-meta - Meta tag management"
+    - "django-robots - robots.txt management"
+  performance:
+    - "django-redis - Redis caching"
+    - "whitenoise - Static file serving"
+    - "django-debug-toolbar - Development profiling"

package/src/frameworks/recipes/laravel.yaml ADDED Viewed

@@ -0,0 +1,137 @@
+# Laravel SEO Recipe
+# Laravel is the most popular PHP framework
+framework: laravel
+display_name: Laravel
+category: server-rendered
+ssr_default: true
+seo_strengths:
+  - "Server-rendered HTML by default"
+  - "Blade templates for clean SEO markup"
+  - "Route caching for fast responses"
+  - "Built-in CSRF and security"
+checks:
+  - code: LARAVEL_NO_META_PACKAGE
+    severity: warning
+    title: "No SEO package detected"
+    description: "Laravel benefits from an SEO package like artesaos/seotools."
+    howToFix: |
+      Install artesaos/seotools:
+      ```bash
+      composer require artesaos/seotools
+      ```
+      ```php
+      // In controller
+      use Artesaos\SEOTools\Facades\SEOMeta;
+      SEOMeta::setTitle('Page Title');
+      SEOMeta::setDescription('Description');
+      // In Blade
+      {!! SEOMeta::generate() !!}
+      ```
+  - code: LARAVEL_NO_SITEMAP
+    severity: warning
+    title: "No sitemap package detected"
+    description: "Use spatie/laravel-sitemap for automatic sitemaps."
+    howToFix: |
+      ```bash
+      composer require spatie/laravel-sitemap
+      ```
+      ```php
+      // Generate sitemap
+      use Spatie\Sitemap\SitemapGenerator;
+      SitemapGenerator::create('https://yoursite.com')
+          ->writeToFile(public_path('sitemap.xml'));
+      // Or build manually
+      use Spatie\Sitemap\Sitemap;
+      use Spatie\Sitemap\Tags\Url;
+      Sitemap::create()
+          ->add(Url::create('/')->setPriority(1.0))
+          ->add(Url::create('/about'))
+          ->writeToFile(public_path('sitemap.xml'));
+      ```
+  - code: LARAVEL_INERTIA_NO_SSR
+    severity: error
+    title: "Inertia.js without SSR"
+    description: "Inertia apps are client-rendered by default, losing SEO benefits."
+    howToFix: |
+      Enable Inertia SSR:
+      ```bash
+      php artisan inertia:start-ssr
+      ```
+      Configure in config/inertia.php:
+      ```php
+      'ssr' => [
+          'enabled' => true,
+          'url' => 'http://127.0.0.1:13714',
+      ],
+      ```
+  - code: LARAVEL_NO_RESPONSE_CACHE
+    severity: notice
+    title: "Response caching not configured"
+    description: "Cache full responses for better performance."
+    howToFix: |
+      Install spatie/laravel-responsecache:
+      ```bash
+      composer require spatie/laravel-responsecache
+      ```
+      Add middleware:
+      ```php
+      // app/Http/Kernel.php
+      protected $middlewareGroups = [
+          'web' => [
+              \Spatie\ResponseCache\Middlewares\CacheResponse::class,
+          ],
+      ];
+      ```
+  - code: LARAVEL_LIVEWIRE_SEO
+    severity: warning
+    title: "Livewire components may affect SEO"
+    description: "Livewire content loads via JavaScript after initial page load."
+    howToFix: |
+      For SEO-critical content, use wire:init to load immediately:
+      ```blade
+      <div wire:init="loadData">
+          @if($data)
+              {{-- Content --}}
+          @else
+              {{-- Loading skeleton --}}
+          @endif
+      </div>
+      ```
+      Or use Alpine.js for client-only interactions.
+performance_tips:
+  - "Enable route caching: php artisan route:cache"
+  - "Enable config caching: php artisan config:cache"
+  - "Use query caching with remember()"
+  - "Optimize autoloader: composer dump-autoload -o"
+  - "Use Laravel Octane for high performance"
+recommended_packages:
+  seo:
+    - "artesaos/seotools - Meta tag management"
+    - "spatie/laravel-sitemap - Sitemap generation"
+    - "spatie/schema-org - Structured data"
+  performance:
+    - "spatie/laravel-responsecache - Full page caching"
+    - "barryvdh/laravel-debugbar - Development profiling"