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/tracking/search-console.ts ADDED Viewed

@@ -0,0 +1,335 @@
+// Google Search Console Integration
+// Verification injection + API data fetching
+import * as fs from 'fs';
+import * as path from 'path';
+export interface GSCConfig {
+  verificationCode?: string; // For meta tag verification
+  siteUrl: string; // https://example.com or sc-domain:example.com
+  credentials?: GSCCredentials;
+}
+export interface GSCCredentials {
+  type: 'service_account' | 'oauth';
+  // Service account JSON or OAuth tokens
+  clientEmail?: string;
+  privateKey?: string;
+  accessToken?: string;
+  refreshToken?: string;
+}
+export interface GSCQueryResult {
+  query: string;
+  clicks: number;
+  impressions: number;
+  ctr: number;
+  position: number;
+  page?: string;
+}
+export interface GSCPerformanceData {
+  startDate: string;
+  endDate: string;
+  queries: GSCQueryResult[];
+  totalClicks: number;
+  totalImpressions: number;
+  avgCtr: number;
+  avgPosition: number;
+}
+export interface QuickWin {
+  query: string;
+  currentPosition: number;
+  impressions: number;
+  clicks: number;
+  ctr: number;
+  opportunity: 'page-1-close' | 'low-ctr' | 'high-impression';
+  suggestedAction: string;
+  potentialGain: number; // Estimated additional clicks
+}
+/**
+ * Generate Search Console verification meta tag
+ */
+export function generateGSCVerificationTag(verificationCode: string): string {
+  return `<meta name="google-site-verification" content="${verificationCode}" />`;
+}
+/**
+ * Inject GSC verification into project
+ */
+export async function injectGSCVerification(
+  projectPath: string,
+  verificationCode: string
+): Promise<{ success: boolean; file?: string; message: string }> {
+  // Find index.html or equivalent
+  const indexPaths = [
+    path.join(projectPath, 'index.html'),
+    path.join(projectPath, 'public', 'index.html'),
+    path.join(projectPath, 'app', 'layout.tsx'),
+    path.join(projectPath, 'src', 'app', 'layout.tsx'),
+  ];
+  for (const indexPath of indexPaths) {
+    if (fs.existsSync(indexPath)) {
+      let content = fs.readFileSync(indexPath, 'utf-8');
+      // Check if already verified
+      if (content.includes('google-site-verification')) {
+        return { success: true, file: indexPath, message: 'GSC verification already present' };
+      }
+      const verificationTag = generateGSCVerificationTag(verificationCode);
+      // For HTML files
+      if (indexPath.endsWith('.html')) {
+        content = content.replace('<head>', `<head>\n    ${verificationTag}`);
+        fs.writeFileSync(indexPath, content);
+        return { success: true, file: indexPath, message: 'GSC verification tag added' };
+      }
+      // For React/Next.js layout files
+      if (indexPath.endsWith('.tsx') || indexPath.endsWith('.jsx')) {
+        // Add to <head> section
+        if (content.includes('<head>')) {
+          content = content.replace(
+            '<head>',
+            `<head>\n        <meta name="google-site-verification" content="${verificationCode}" />`
+          );
+          fs.writeFileSync(indexPath, content);
+          return { success: true, file: indexPath, message: 'GSC verification tag added to layout' };
+        }
+      }
+    }
+  }
+  return {
+    success: false,
+    message: 'Could not find index.html or layout file. Add manually: ' + generateGSCVerificationTag(verificationCode),
+  };
+}
+/**
+ * Build GSC API request (for use with Google APIs client)
+ * User needs to set up OAuth or service account credentials
+ */
+export function buildGSCApiRequest(
+  siteUrl: string,
+  startDate: string,
+  endDate: string,
+  options: {
+    dimensions?: ('query' | 'page' | 'country' | 'device' | 'date')[];
+    rowLimit?: number;
+    startRow?: number;
+  } = {}
+): object {
+  return {
+    siteUrl,
+    requestBody: {
+      startDate,
+      endDate,
+      dimensions: options.dimensions || ['query'],
+      rowLimit: options.rowLimit || 1000,
+      startRow: options.startRow || 0,
+    },
+  };
+}
+/**
+ * Parse GSC API response into our format
+ */
+export function parseGSCResponse(response: any): GSCPerformanceData {
+  const rows = response.rows || [];
+  const queries: GSCQueryResult[] = rows.map((row: any) => ({
+    query: row.keys?.[0] || '',
+    page: row.keys?.[1],
+    clicks: row.clicks || 0,
+    impressions: row.impressions || 0,
+    ctr: row.ctr || 0,
+    position: row.position || 0,
+  }));
+  const totalClicks = queries.reduce((sum, q) => sum + q.clicks, 0);
+  const totalImpressions = queries.reduce((sum, q) => sum + q.impressions, 0);
+  const avgCtr = totalImpressions > 0 ? totalClicks / totalImpressions : 0;
+  const avgPosition = queries.length > 0
+    ? queries.reduce((sum, q) => sum + q.position, 0) / queries.length
+    : 0;
+  return {
+    startDate: response.startDate || '',
+    endDate: response.endDate || '',
+    queries,
+    totalClicks,
+    totalImpressions,
+    avgCtr,
+    avgPosition,
+  };
+}
+/**
+ * Identify quick wins from GSC data
+ */
+export function identifyQuickWins(data: GSCPerformanceData): QuickWin[] {
+  const quickWins: QuickWin[] = [];
+  for (const query of data.queries) {
+    // Skip very low impression queries
+    if (query.impressions < 10) continue;
+    // Quick Win 1: Position 11-20 (almost page 1)
+    if (query.position >= 11 && query.position <= 20) {
+      const potentialGain = Math.round(query.impressions * 0.1); // ~10% CTR if on page 1
+      quickWins.push({
+        ...query,
+        currentPosition: query.position,
+        opportunity: 'page-1-close',
+        suggestedAction: `Improve content for "${query.query}" - you're at position ${Math.round(query.position)}, just off page 1!`,
+        potentialGain,
+      });
+    }
+    // Quick Win 2: High impressions but low CTR (position 1-10)
+    if (query.position <= 10 && query.impressions > 100 && query.ctr < 0.02) {
+      const expectedCtr = getExpectedCtr(query.position);
+      const potentialGain = Math.round(query.impressions * (expectedCtr - query.ctr));
+      if (potentialGain > 5) {
+        quickWins.push({
+          ...query,
+          currentPosition: query.position,
+          opportunity: 'low-ctr',
+          suggestedAction: `Improve title/description for "${query.query}" - CTR is ${(query.ctr * 100).toFixed(1)}% vs expected ${(expectedCtr * 100).toFixed(1)}%`,
+          potentialGain,
+        });
+      }
+    }
+    // Quick Win 3: High impressions, position 4-10 (could be #1)
+    if (query.position >= 4 && query.position <= 10 && query.impressions > 500) {
+      const potentialGain = Math.round(query.impressions * 0.15); // Gain from reaching #1
+      quickWins.push({
+        ...query,
+        currentPosition: query.position,
+        opportunity: 'high-impression',
+        suggestedAction: `Push "${query.query}" to top 3 - high traffic potential at ${query.impressions} impressions/month`,
+        potentialGain,
+      });
+    }
+  }
+  // Sort by potential gain
+  quickWins.sort((a, b) => b.potentialGain - a.potentialGain);
+  return quickWins.slice(0, 20); // Top 20 quick wins
+}
+/**
+ * Expected CTR by position (industry average)
+ */
+function getExpectedCtr(position: number): number {
+  const ctrByPosition: Record<number, number> = {
+    1: 0.28,
+    2: 0.15,
+    3: 0.11,
+    4: 0.08,
+    5: 0.06,
+    6: 0.05,
+    7: 0.04,
+    8: 0.03,
+    9: 0.03,
+    10: 0.02,
+  };
+  return ctrByPosition[Math.round(position)] || 0.01;
+}
+/**
+ * Compare two periods to identify trends
+ */
+export function comparePeriods(
+  current: GSCPerformanceData,
+  previous: GSCPerformanceData
+): {
+  improved: GSCQueryResult[];
+  declined: GSCQueryResult[];
+  newKeywords: GSCQueryResult[];
+  lostKeywords: GSCQueryResult[];
+  summary: {
+    clicksChange: number;
+    impressionsChange: number;
+    avgPositionChange: number;
+  };
+} {
+  const previousMap = new Map(previous.queries.map(q => [q.query, q]));
+  const currentMap = new Map(current.queries.map(q => [q.query, q]));
+  const improved: GSCQueryResult[] = [];
+  const declined: GSCQueryResult[] = [];
+  const newKeywords: GSCQueryResult[] = [];
+  const lostKeywords: GSCQueryResult[] = [];
+  // Check current queries
+  for (const query of current.queries) {
+    const prev = previousMap.get(query.query);
+    if (!prev) {
+      newKeywords.push(query);
+    } else if (query.position < prev.position - 2) {
+      improved.push(query);
+    } else if (query.position > prev.position + 2) {
+      declined.push(query);
+    }
+  }
+  // Check for lost keywords
+  for (const query of previous.queries) {
+    if (!currentMap.has(query.query) && query.impressions > 50) {
+      lostKeywords.push(query);
+    }
+  }
+  return {
+    improved: improved.slice(0, 10),
+    declined: declined.slice(0, 10),
+    newKeywords: newKeywords.slice(0, 10),
+    lostKeywords: lostKeywords.slice(0, 10),
+    summary: {
+      clicksChange: current.totalClicks - previous.totalClicks,
+      impressionsChange: current.totalImpressions - previous.totalImpressions,
+      avgPositionChange: current.avgPosition - previous.avgPosition,
+    },
+  };
+}
+/**
+ * Generate credentials setup instructions
+ */
+export function getGSCSetupInstructions(): string {
+  return `
+# Google Search Console API Setup
+## Option 1: Service Account (Recommended for GitHub Actions)
+1. Go to Google Cloud Console: https://console.cloud.google.com
+2. Create a new project or select existing
+3. Enable "Search Console API"
+4. Go to "IAM & Admin" > "Service Accounts"
+5. Create a service account
+6. Create a JSON key and download it
+7. In Search Console, add the service account email as a user
+Add to GitHub Secrets:
+  - GSC_SERVICE_ACCOUNT_EMAIL: your-service-account@project.iam.gserviceaccount.com
+  - GSC_PRIVATE_KEY: (the private_key from JSON, including -----BEGIN/END-----)
+## Option 2: OAuth (For user-specific access)
+1. Go to Google Cloud Console
+2. Enable "Search Console API"
+3. Create OAuth 2.0 credentials
+4. Download client_secret.json
+5. Run: seo auth --google
+This will open a browser for OAuth consent and save tokens locally.
+`;
+}

package/src/types.ts ADDED Viewed

@@ -0,0 +1,134 @@
+export interface AgentDefinition {
+  name: string;
+  description: string;
+  model: string;
+  temperature: number;
+  max_tokens: number;
+  tools: AgentTool[];
+  system: string;
+  prompt: string;
+}
+export interface AgentTool {
+  name: string;
+  description: string;
+}
+export interface SEOIssue {
+  severity: 'critical' | 'warning' | 'info';
+  category: 'meta' | 'schema' | 'content' | 'technical' | 'performance' | 'social' | 'accessibility';
+  code: string;
+  message: string;
+  impact: string;
+  element?: string;
+  fix?: {
+    file: string;
+    before: string | null;
+    after: string;
+  };
+}
+export interface SEOAnalysisResult {
+  url: string;
+  score: number;
+  core_web_vitals?: {
+    lcp?: { value: string; status: 'good' | 'needs-improvement' | 'poor' };
+    fid?: { value: string; status: 'good' | 'needs-improvement' | 'poor' };
+    cls?: { value: string; status: 'good' | 'needs-improvement' | 'poor' };
+  };
+  issues: SEOIssue[];
+  recommendations: SEORecommendation[];
+}
+export interface SEORecommendation {
+  priority: 'high' | 'medium' | 'low';
+  category: string;
+  message: string;
+  impact: string;
+}
+export interface CrawlResult {
+  url: string;
+  html: string;
+  statusCode: number;
+  headers: Record<string, string>;
+  loadTime: number;
+}
+export interface MetaData {
+  title?: string;
+  description?: string;
+  canonical?: string;
+  robots?: string;
+  viewport?: string;
+  charset?: string;
+  openGraph: {
+    title?: string;
+    description?: string;
+    image?: string;
+    url?: string;
+    type?: string;
+    siteName?: string;
+  };
+  twitter: {
+    card?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+    site?: string;
+  };
+  other: Record<string, string>;
+}
+export interface HeadingStructure {
+  tag: string;
+  text: string;
+  level: number;
+}
+export interface ImageInfo {
+  src: string;
+  alt: string | null;
+  width?: string;
+  height?: string;
+  loading?: string;
+}
+export interface LinkInfo {
+  href: string;
+  text: string;
+  isInternal: boolean;
+  isNofollow: boolean;
+}
+export interface SchemaData {
+  type: string;
+  data: Record<string, unknown>;
+}
+export interface FrameworkInfo {
+  name: string;
+  version?: string;
+  router?: 'app' | 'pages' | 'file-based' | 'custom';
+  metaPattern: 'metadata-export' | 'head-component' | 'frontmatter' | 'meta-function' | 'html-head';
+}
+export interface Fix {
+  issue: {
+    code: string;
+    message: string;
+    severity: string;
+  };
+  file: string;
+  before: string | null;
+  after: string;
+  explanation: string;
+}
+export interface ToolResult {
+  success: boolean;
+  data?: unknown;
+  error?: string;
+}
+export type ToolFunction = (params: Record<string, unknown>) => Promise<ToolResult>;