@rankcli/agent-runtime 0.0.15 → 0.0.17

package/src/frameworks/index.ts

@@ -1,68 +0,0 @@
-/**
- * Framework Detection and SEO Recipes
- *
- * Provides framework-specific SEO suggestions for:
- * - React, Next.js, Gatsby, Remix
- * - Vue, Nuxt
- * - Angular
- * - Svelte, SvelteKit
- * - Astro
- * - Ruby on Rails
- * - Laravel, Django
- * - WordPress
- *
- * Usage:
- *
- * ```typescript
- * import { detectFramework, getFrameworkIssues } from './frameworks';
- *
- * // Detect framework from HTML
- * const frameworkInfo = detectFramework({ html });
- *
- * // Get framework-specific issues
- * const issues = await getFrameworkIssues(frameworkInfo, html, url);
- * ```
- */
-
-export {
-  type Framework,
-  type FrameworkInfo,
-  detectFramework,
-  detectFromHtml,
-  detectFromPackageJson,
-  detectFromHeaders,
-  getFrameworkDisplayName,
-} from './detector.js';
-
-export {
-  type FrameworkCheck,
-  type FrameworkRecipe,
-  loadRecipe,
-  getFrameworkIssues,
-  getFrameworkSuggestions,
-  getFrameworkChecks,
-  getPerformanceTips,
-  getSeoChallenges,
-  getMigrationPaths,
-  getTotalFrameworkChecks,
-  getFrameworkSummary,
-  embedRecipe,
-} from './suggestion-engine.js';
-
-// Convenience function to get all available frameworks
-export const SUPPORTED_FRAMEWORKS = [
-  'react',
-  'nextjs',
-  'vue',
-  'nuxt',
-  'angular',
-  'svelte',
-  'sveltekit',
-  'astro',
-  'remix',
-  'gatsby',
-  'rails',
-  'laravel',
-  'django',
-  'wordpress',
-] as const;

package/src/frameworks/recipes/angular.yaml

@@ -1,171 +0,0 @@
-# Angular SEO Recipe
-# Angular has SSR support via Angular Universal
-
-framework: angular
-display_name: Angular
-category: spa
-ssr_default: false
-
-seo_challenges:
-  - "Client-side rendering by default"
-  - "Heavy initial bundle size"
-  - "Complex SSR setup (Angular Universal)"
-  - "Zone.js can cause performance issues"
-
-checks:
-  - code: ANGULAR_NO_UNIVERSAL
-    severity: error
-    title: "Angular app without Universal (SSR)"
-    description: "Client-side Angular apps send empty HTML to crawlers."
-    impact: "Your content may not be indexed by search engines"
-    howToFix: |
-      Add Angular Universal for SSR:
-
-      ```bash
-      ng add @angular/ssr
-      ```
-
-      This adds server-side rendering to your Angular app.
-
-  - code: ANGULAR_NO_TITLE_SERVICE
-    severity: error
-    title: "Not using Title/Meta services"
-    description: "Angular has built-in services for managing title and meta tags."
-    howToFix: |
-      Use Title and Meta services:
-
-      ```ts
-      import { Title, Meta } from '@angular/platform-browser';
-
-      @Component({...})
-      export class ProductComponent {
-        constructor(
-          private title: Title,
-          private meta: Meta
-        ) {}
-
-        ngOnInit() {
-          this.title.setTitle('Product Name | Your Site');
-          this.meta.updateTag({ name: 'description', content: 'Product description' });
-          this.meta.updateTag({ property: 'og:title', content: 'Product Name' });
-        }
-      }
-      ```
-
-  - code: ANGULAR_LAZY_LOAD_MISSING
-    severity: warning
-    title: "Routes not lazy loaded"
-    description: "Loading all modules upfront increases initial bundle size."
-    howToFix: |
-      Use lazy loading for routes:
-
-      ```ts
-      const routes: Routes = [
-        {
-          path: 'products',
-          loadChildren: () => import('./products/products.module')
-            .then(m => m.ProductsModule)
-        },
-        // Or with standalone components
-        {
-          path: 'about',
-          loadComponent: () => import('./about/about.component')
-            .then(m => m.AboutComponent)
-        }
-      ];
-      ```
-
-  - code: ANGULAR_PRERENDER_MISSING
-    severity: warning
-    title: "Static routes not prerendered"
-    description: "Static pages should be prerendered at build time."
-    howToFix: |
-      Configure prerendering in angular.json:
-
-      ```json
-      {
-        "projects": {
-          "your-app": {
-            "architect": {
-              "prerender": {
-                "options": {
-                  "routes": ["/", "/about", "/contact"]
-                }
-              }
-            }
-          }
-        }
-      }
-      ```
-
-      Run: `ng run your-app:prerender`
-
-  - code: ANGULAR_CHANGE_DETECTION
-    severity: notice
-    title: "Using default change detection"
-    description: "OnPush change detection improves performance significantly."
-    howToFix: |
-      Use OnPush for components:
-
-      ```ts
-      @Component({
-        selector: 'app-product',
-        changeDetection: ChangeDetectionStrategy.OnPush,
-        template: `...`
-      })
-      export class ProductComponent {}
-      ```
-
-  - code: ANGULAR_LARGE_BUNDLE
-    severity: warning
-    title: "Large initial bundle detected"
-    description: "Bundle over 500KB significantly hurts performance."
-    howToFix: |
-      1. Enable build optimizer:
-      ```json
-      // angular.json
-      "optimization": true,
-      "buildOptimizer": true
-      ```
-
-      2. Analyze bundle:
-      ```bash
-      ng build --stats-json
-      npx webpack-bundle-analyzer dist/your-app/stats.json
-      ```
-
-      3. Remove unused dependencies
-
-  - code: ANGULAR_NO_IMAGE_DIRECTIVE
-    severity: notice
-    title: "Not using NgOptimizedImage"
-    description: "Angular 15+ has built-in image optimization."
-    howToFix: |
-      Use NgOptimizedImage directive:
-
-      ```ts
-      import { NgOptimizedImage } from '@angular/common';
-
-      @Component({
-        imports: [NgOptimizedImage],
-        template: `
-          <img ngSrc="/hero.jpg" width="1200" height="630" priority />
-        `
-      })
-      ```
-
-performance_tips:
-  - "Use standalone components to reduce bundle"
-  - "Enable OnPush change detection"
-  - "Lazy load routes"
-  - "Use trackBy with ngFor"
-  - "Prerender static pages"
-
-migration_paths:
-  analog:
-    effort: medium
-    benefits:
-      - "File-based routing"
-      - "Full SSR support"
-      - "Vite-powered builds"
-    guide: "https://analogjs.org/docs/introduction"

package/src/frameworks/recipes/astro.yaml

@@ -1,206 +0,0 @@
-# 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

@@ -1,180 +0,0 @@
-# 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"