aeoptimize 0.1.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "name": "aeo-cli",
+  "owner": {
+    "name": "Te-Shu Wang"
+  },
+  "metadata": {
+    "description": "AI search optimization: scan, generate, and transform website content for AI readability",
+    "version": "0.1.0"
+  },
+  "plugins": [
+    {
+      "name": "aeo-cli",
+      "source": "./",
+      "description": "CLI toolkit + Claude Code skills for transforming SEO-optimized websites into AI-search-ready content",
+      "category": "seo",
+      "tags": ["aeo", "seo", "ai-search", "llms-txt", "structured-data"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "aeo-cli",
+  "description": "AI search optimization toolkit: scan, generate, and transform website content for AI readability",
+  "version": "0.1.0",
+  "author": {
+    "name": "Te-Shu Wang"
+  },
+  "homepage": "https://github.com/dexuwang627-cloud/aeoptimize",
+  "repository": "https://github.com/dexuwang627-cloud/aeoptimize",
+  "license": "MIT",
+  "keywords": ["aeo", "seo", "ai-search", "llms-txt", "structured-data", "claude-code-skill"]
+}

package/README.md

@@ -0,0 +1,106 @@
+# aeo-cli
+
+CLI toolkit + Claude Code skills that transform SEO-optimized websites into AI-search-ready content.
+
+AI search engines (ChatGPT, Perplexity, Google AI Overview) don't rank pages — they cite content. `aeo-cli` helps you make your content citable.
+
+## Quick Start
+
+```bash
+# Scan any website
+npx aeoptimize scan https://your-site.com
+
+# Scan local build output
+npx aeoptimize scan ./dist
+
+# Generate AI infrastructure files
+npx aeoptimize generate ./dist
+```
+
+## What It Does
+
+### `aeo scan` — AI Readability Audit
+
+Analyzes your content across 5 dimensions and gives a 0-100 score:
+
+| Dimension | Max | What it measures |
+|-----------|-----|------------------|
+| **Structure** | 25 | Heading hierarchy, paragraph length, FAQ presence |
+| **Citability** | 25 | Self-contained statements, data/stats, definitions |
+| **Schema** | 20 | JSON-LD presence, completeness, AI-relevant types |
+| **AI Metadata** | 15 | llms.txt, robots.txt AI config, meta description |
+| **Content Density** | 15 | Content vs boilerplate, keyword stuffing detection |
+
+```bash
+npx aeoptimize scan https://example.com        # Remote URL
+npx aeoptimize scan ./dist                      # Local directory
+npx aeoptimize scan ./dist --json               # Machine-readable output
+```
+
+### `aeo generate` — AI Infrastructure Files
+
+Generates everything AI crawlers need to understand your site:
+
+- **llms.txt** — Machine-readable site summary ([llmstxt.org](https://llmstxt.org) standard)
+- **llms-full.txt** — Full content for deep AI consumption
+- **JSON-LD schemas** — Article, FAQPage, BreadcrumbList
+- **robots.txt suggestions** — AI crawler allow/deny rules
+
+```bash
+npx aeoptimize generate ./dist --dry-run        # Preview first
+npx aeoptimize generate ./dist                  # Write files
+npx aeoptimize generate ./dist --json           # Machine-readable
+```
+
+### `aeo transform` — AI Content Restructuring (Skill Only)
+
+Available as a Claude Code skill — uses your existing subscription, no extra cost:
+
+- Split long paragraphs into citable statements
+- Extract implicit Q&A into FAQ schema
+- Remove keyword stuffing
+- Fix dangling references ("This...", "It...", "They...")
+- Inject structured data
+
+## Claude Code Skills
+
+Install as a Claude Code plugin for interactive, AI-powered optimization:
+
+```bash
+claude plugin marketplace add dexuwang627-cloud/aeoptimize
+```
+
+Then use in any conversation:
+
+- `/aeo-scan` — Interactive audit with discussion
+- `/aeo-generate` — Guided file generation with preview
+- `/aeo-transform` — AI-powered content restructuring
+
+## Why AEO?
+
+Traditional SEO optimizes for ranking algorithms. AEO optimizes for AI comprehension.
+
+| | SEO | AEO |
+|---|---|---|
+| **Goal** | Rank higher | Get cited |
+| **Audience** | Search crawler | Language model |
+| **Key metric** | Position | Citation accuracy |
+| **Content style** | Keyword-rich | Self-contained, structured |
+| **Structured data** | Nice to have | Essential |
+
+67% of users now get their first answer from AI — if your content can't be extracted and cited, it's invisible.
+
+## Scoring Methodology
+
+Each rule produces a score based on heuristic analysis (no LLM required):
+
+- **17 rules** across 5 dimensions
+- **Zero cost** — pure static analysis
+- **Offline capable** — works without internet for local files
+- **Deterministic** — same input always produces same score
+
+The scoring weights (25/25/20/15/15) prioritize structure and citability because these factors most strongly correlate with AI citation rates.
+
+## License
+
+MIT

package/agents/aeo-analyzer.md

@@ -0,0 +1,63 @@
+---
+name: aeo-analyzer
+description: Use when deep-analyzing a specific page for AI optimization opportunities, dispatched by aeo-scan for detailed per-page analysis
+model: inherit
+---
+
+You are an AEO (Answer Engine Optimization) specialist. Your job is to analyze a single web page and produce a detailed, actionable report on how to improve its AI search readability.
+
+## Your Analysis Should Cover
+
+1. **Issue-by-Issue Breakdown**
+   - For each issue found by the scanner, explain WHY it matters for AI citation
+   - Reference specific content in the page (quote the problematic text)
+   - Rate fix difficulty: easy (5 min), medium (30 min), hard (1+ hour)
+
+2. **Prioritized Fix Recommendations**
+   - Order by: (impact on score) × (ease of implementation)
+   - Group related fixes together
+   - Estimate score improvement per fix
+
+3. **Before/After Examples**
+   - For the top 3 improvements, show exactly how the content should change
+   - Use diff format: what to remove vs what to add
+   - Explain why the "after" version is more AI-friendly
+
+4. **Content Strategy Notes**
+   - What type of AI queries would this page answer?
+   - What's missing that would make it the definitive source?
+   - Are there FAQ opportunities hidden in the content?
+
+## Output Format
+
+Structure your analysis as:
+
+```
+## Page: [title]
+Current Score: [X]/100
+
+### Priority Fixes
+
+#### 1. [Fix Name] — Expected improvement: +N points
+**Issue:** [what's wrong]
+**Why it matters:** [AI search impact]
+**Fix:**
+- Before: [quoted original]
+- After: [suggested replacement]
+
+[repeat for each fix]
+
+### Quick Wins (under 5 minutes each)
+- [list of easy fixes]
+
+### Summary
+- Current: X/100 → Estimated after fixes: Y/100
+- Most impactful change: [one sentence]
+```
+
+## Guidelines
+
+- Be specific — quote actual content, don't speak in generalities
+- Focus on what AI engines actually care about, not traditional SEO metrics
+- If the page is already well-optimized (>80), say so and suggest only minor refinements
+- Never suggest adding false claims or misleading structured data

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { writeFile, mkdir, stat } from 'node:fs/promises';
+import { scan, scanDirectory } from '../core/scanner.js';
+import { generate } from '../core/generator.js';
+const program = new Command();
+program
+    .name('aeo')
+    .description('CLI toolkit that transforms SEO-optimized websites into AI-search-ready content')
+    .version('0.1.0');
+// ── scan command ───────────────────────────────────────────────────
+program
+    .command('scan <target>')
+    .description('Scan a URL or directory for AI readability')
+    .option('--json', 'Output raw JSON report')
+    .action(async (target, options) => {
+    try {
+        const scanTarget = resolveTarget(target);
+        const report = await scan(scanTarget);
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+            printSkillCta();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+// ── generate command ───────────────────────────────────────────────
+program
+    .command('generate <dir>')
+    .description('Generate AI infrastructure files (llms.txt, JSON-LD, robots.txt suggestions)')
+    .option('--out <dir>', 'Output directory (defaults to input directory)')
+    .option('--json', 'Output raw JSON')
+    .option('--dry-run', 'Preview without writing files')
+    .action(async (dir, options) => {
+    try {
+        const stats = await stat(dir);
+        if (!stats.isDirectory()) {
+            console.error(chalk.red('Error: Target must be a directory'));
+            process.exit(1);
+        }
+        const report = await scanDirectory(dir);
+        if (report.pages.length === 0) {
+            console.error(chalk.yellow('No HTML or Markdown files found in directory.'));
+            process.exit(1);
+        }
+        // Re-parse pages to get full ParsedDocument
+        const { parseHtml, parseMarkdown } = await import('../core/scanner.js');
+        const { readFile: rf, readdir } = await import('node:fs/promises');
+        const { join: j, extname } = await import('node:path');
+        const pages = [];
+        for (const page of report.pages) {
+            try {
+                const content = await rf(page.url, 'utf-8');
+                const ext = extname(page.url).toLowerCase();
+                if (ext === '.html' || ext === '.htm') {
+                    pages.push(parseHtml(content, page.url));
+                }
+                else {
+                    pages.push(parseMarkdown(content, page.url));
+                }
+            }
+            catch {
+                // Skip
+            }
+        }
+        const siteInfo = {
+            name: detectSiteName(dir, report),
+            description: report.pages[0]?.title || 'Website',
+            baseUrl: dir,
+        };
+        // Try to read existing robots.txt
+        let existingRobots = null;
+        try {
+            existingRobots = await rf(j(dir, 'robots.txt'), 'utf-8');
+        }
+        catch { /* none */ }
+        const output = generate(report, pages, siteInfo, existingRobots);
+        if (options.json) {
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        const outDir = options.out || dir;
+        if (options.dryRun) {
+            console.log(chalk.cyan.bold('\n📋 Dry Run — Files that would be generated:\n'));
+            console.log(chalk.white.bold('llms.txt:'));
+            console.log(output.llmsTxt);
+            console.log(chalk.white.bold('\nllms-full.txt:'));
+            console.log(output.llmsFullTxt.slice(0, 500) + (output.llmsFullTxt.length > 500 ? '\n...' : ''));
+            if (output.jsonLd.length > 0) {
+                console.log(chalk.white.bold(`\nJSON-LD (${output.jsonLd.length} schemas):`));
+                console.log(JSON.stringify(output.jsonLd[0], null, 2).slice(0, 300) + '...');
+            }
+            console.log(chalk.white.bold('\nrobots.txt suggestions:'));
+            console.log(output.robotsTxtSuggestions.join('\n'));
+            return;
+        }
+        // Write files
+        await writeFile(j(outDir, 'llms.txt'), output.llmsTxt, 'utf-8');
+        await writeFile(j(outDir, 'llms-full.txt'), output.llmsFullTxt, 'utf-8');
+        if (output.jsonLd.length > 0) {
+            const jsonLdDir = j(outDir, '_aeo');
+            await mkdir(jsonLdDir, { recursive: true });
+            await writeFile(j(jsonLdDir, 'generated-schemas.json'), JSON.stringify(output.jsonLd, null, 2), 'utf-8');
+        }
+        console.log(chalk.green.bold('\n✅ Generated AI infrastructure files:\n'));
+        console.log(`  ${chalk.white('llms.txt')}         — AI-readable site summary`);
+        console.log(`  ${chalk.white('llms-full.txt')}    — Full content for AI consumption`);
+        if (output.jsonLd.length > 0) {
+            console.log(`  ${chalk.white('_aeo/generated-schemas.json')} — ${output.jsonLd.length} JSON-LD schemas`);
+        }
+        console.log(chalk.dim('\nrobots.txt suggestions (not auto-applied):'));
+        for (const line of output.robotsTxtSuggestions.filter((l) => l.startsWith('User-agent:'))) {
+            console.log(chalk.dim(`  ${line}`));
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+program.parse();
+// ── Helpers ────────────────────────────────────────────────────────
+function resolveTarget(target) {
+    if (target.startsWith('http://') || target.startsWith('https://')) {
+        return { type: 'url', path: target };
+    }
+    // Could be file or directory — stat will determine
+    return { type: 'directory', path: target };
+}
+function detectSiteName(dir, report) {
+    // Use the first page title or directory name
+    if (report.pages.length > 0) {
+        return report.pages[0].title.split('|')[0].split('-')[0].trim();
+    }
+    return dir.split('/').pop() || 'Website';
+}
+function printReport(report) {
+    const { overall } = report;
+    console.log('');
+    console.log(chalk.bold('  AEO Readability Report'));
+    console.log(chalk.dim(`  ${report.timestamp}`));
+    console.log(chalk.dim(`  ${report.pages.length} page${report.pages.length > 1 ? 's' : ''} scanned`));
+    console.log('');
+    // Overall score
+    const scoreColor = overall.total >= 70 ? chalk.green : overall.total >= 40 ? chalk.yellow : chalk.red;
+    console.log(`  ${chalk.bold('Score:')} ${scoreColor.bold(String(overall.total))}${chalk.dim('/100')}  ${report.summary}`);
+    console.log('');
+    // Dimension breakdown
+    printDimensionBar('Structure', overall.structure, 25);
+    printDimensionBar('Citability', overall.citability, 25);
+    printDimensionBar('Schema', overall.schema, 20);
+    printDimensionBar('AI Metadata', overall.aiMetadata, 15);
+    printDimensionBar('Content Density', overall.contentDensity, 15);
+    console.log('');
+    // Top issues
+    const allIssues = report.pages.flatMap((p) => p.issues);
+    const criticalIssues = allIssues.filter((i) => i.severity === 'critical');
+    const warningIssues = allIssues.filter((i) => i.severity === 'warning');
+    if (criticalIssues.length > 0) {
+        console.log(chalk.red.bold('  Critical Issues:'));
+        for (const issue of criticalIssues.slice(0, 5)) {
+            console.log(`  ${chalk.red('✗')} ${issue.message}`);
+        }
+        console.log('');
+    }
+    if (warningIssues.length > 0) {
+        console.log(chalk.yellow.bold('  Warnings:'));
+        for (const issue of warningIssues.slice(0, 5)) {
+            console.log(`  ${chalk.yellow('!')} ${issue.message}`);
+        }
+        console.log('');
+    }
+    // Top suggestions
+    const allSuggestions = report.pages.flatMap((p) => p.suggestions);
+    const highImpact = allSuggestions.filter((s) => s.impact === 'high');
+    if (highImpact.length > 0) {
+        console.log(chalk.cyan.bold('  Top Suggestions:'));
+        // Deduplicate by action
+        const seen = new Set();
+        for (const sug of highImpact) {
+            if (seen.has(sug.action))
+                continue;
+            seen.add(sug.action);
+            console.log(`  ${chalk.cyan('→')} ${sug.action}`);
+            console.log(`    ${chalk.dim(sug.detail)}`);
+        }
+        console.log('');
+    }
+    // Per-page breakdown if multiple pages
+    if (report.pages.length > 1) {
+        console.log(chalk.bold('  Per-Page Scores:'));
+        for (const page of report.pages.sort((a, b) => a.scores.total - b.scores.total)) {
+            const color = page.scores.total >= 70 ? chalk.green : page.scores.total >= 40 ? chalk.yellow : chalk.red;
+            const name = page.title.length > 40 ? page.title.slice(0, 37) + '...' : page.title;
+            console.log(`  ${color(String(page.scores.total).padStart(3))} ${name}`);
+        }
+        console.log('');
+    }
+}
+function printDimensionBar(label, score, max) {
+    const pct = score / max;
+    const barWidth = 20;
+    const filled = Math.round(pct * barWidth);
+    const empty = barWidth - filled;
+    const color = pct >= 0.7 ? chalk.green : pct >= 0.4 ? chalk.yellow : chalk.red;
+    const bar = color('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+    const labelPad = label.padEnd(16);
+    console.log(`  ${labelPad} ${bar} ${color(String(score))}${chalk.dim('/' + max)}`);
+}
+function printSkillCta() {
+    console.log(chalk.dim('  ─────────────────────────────────────────'));
+    console.log(chalk.dim('  Want AI-powered fixes? Install as Claude Code skill:'));
+    console.log(chalk.white('    claude plugin marketplace add dexuwang627-cloud/aeoptimize'));
+    console.log(chalk.dim('  Then use: /aeo-scan, /aeo-generate, /aeo-transform'));
+    console.log('');
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/core/generator.d.ts

@@ -0,0 +1,6 @@
+import type { ScanReport, ParsedDocument, SiteInfo, GenerateOutput } from './types.js';
+export declare function generateLlmsTxt(report: ScanReport, siteInfo: SiteInfo): string;
+export declare function generateLlmsFullTxt(report: ScanReport, pages: ParsedDocument[]): string;
+export declare function generateJsonLd(doc: ParsedDocument): object[];
+export declare function generateRobotsTxtSuggestions(existingRobots: string | null): string[];
+export declare function generate(report: ScanReport, pages: ParsedDocument[], siteInfo: SiteInfo, existingRobots?: string | null): GenerateOutput;

package/dist/core/generator.js

@@ -0,0 +1,126 @@
+const AI_CRAWLERS = [
+    { name: 'GPTBot', description: 'OpenAI ChatGPT crawler' },
+    { name: 'ChatGPT-User', description: 'ChatGPT browsing feature' },
+    { name: 'ClaudeBot', description: 'Anthropic Claude crawler' },
+    { name: 'PerplexityBot', description: 'Perplexity AI crawler' },
+    { name: 'Google-Extended', description: 'Google AI/Gemini training data' },
+    { name: 'Applebot-Extended', description: 'Apple Intelligence features' },
+    { name: 'CCBot', description: 'Common Crawl (used by many AI models)' },
+];
+export function generateLlmsTxt(report, siteInfo) {
+    const lines = [];
+    lines.push(`# ${siteInfo.name}`);
+    lines.push('');
+    lines.push(`> ${siteInfo.description}`);
+    lines.push('');
+    if (report.pages.length > 0) {
+        lines.push('## Pages');
+        lines.push('');
+        for (const page of report.pages) {
+            const url = page.url.startsWith('http') ? page.url : page.url;
+            lines.push(`- [${page.title}](${url}): AI readability score ${page.scores.total}/100`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function generateLlmsFullTxt(report, pages) {
+    const lines = [];
+    for (const page of pages) {
+        lines.push(`## ${page.title}`);
+        lines.push('');
+        lines.push(page.rawText.slice(0, 5000)); // Cap per page
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function generateJsonLd(doc) {
+    const existing = new Set(doc.jsonLd.map((ld) => ld['@type']));
+    const generated = [];
+    // Add Article if not present and looks like an article
+    if (!existing.has('Article') && !existing.has('TechArticle') && !existing.has('BlogPosting')) {
+        if (doc.headings.length >= 2 && doc.paragraphs.length >= 3) {
+            generated.push({
+                '@context': 'https://schema.org',
+                '@type': 'Article',
+                name: doc.title,
+                description: doc.metaTags['description'] || doc.paragraphs[0]?.slice(0, 160) || '',
+                author: doc.metaTags['author'] ? { '@type': 'Person', name: doc.metaTags['author'] } : undefined,
+                datePublished: doc.metaTags['article:published_time'] || undefined,
+            });
+        }
+    }
+    // Add FAQPage if question-style headings exist but no FAQ schema
+    if (!existing.has('FAQPage')) {
+        const questionHeadings = doc.headings.filter((h) => h.text.endsWith('?'));
+        if (questionHeadings.length >= 2) {
+            const mainEntity = questionHeadings.map((q) => {
+                // Find the paragraph after this heading
+                const idx = doc.headings.indexOf(q);
+                const nextHeadingIdx = idx + 1 < doc.headings.length ? doc.headings.indexOf(doc.headings[idx + 1]) : doc.headings.length;
+                // Simple heuristic: use the next paragraph
+                const answerParagraph = doc.paragraphs[idx] || 'Answer not extracted.';
+                return {
+                    '@type': 'Question',
+                    name: q.text,
+                    acceptedAnswer: { '@type': 'Answer', text: answerParagraph },
+                };
+            });
+            generated.push({
+                '@context': 'https://schema.org',
+                '@type': 'FAQPage',
+                name: `${doc.title} FAQ`,
+                mainEntity,
+            });
+        }
+    }
+    // Add BreadcrumbList from nav links if not present
+    if (!existing.has('BreadcrumbList')) {
+        const navLinks = doc.links.filter((l) => l.href.startsWith('/') && l.text.length > 0).slice(0, 5);
+        if (navLinks.length >= 2) {
+            generated.push({
+                '@context': 'https://schema.org',
+                '@type': 'BreadcrumbList',
+                itemListElement: navLinks.map((link, i) => ({
+                    '@type': 'ListItem',
+                    position: i + 1,
+                    name: link.text,
+                    item: link.href,
+                })),
+            });
+        }
+    }
+    return generated;
+}
+export function generateRobotsTxtSuggestions(existingRobots) {
+    const suggestions = [];
+    const existing = existingRobots || '';
+    suggestions.push('# AI Crawler Configuration');
+    suggestions.push('# Generated by aeo-cli');
+    suggestions.push('');
+    for (const crawler of AI_CRAWLERS) {
+        const isConfigured = new RegExp(`User-agent:\\s*${crawler.name}`, 'i').test(existing);
+        if (!isConfigured) {
+            suggestions.push(`# ${crawler.description}`);
+            suggestions.push(`User-agent: ${crawler.name}`);
+            suggestions.push('Allow: /');
+            suggestions.push('');
+        }
+    }
+    if (!existing.includes('llms.txt') && !existing.includes('llms-full.txt')) {
+        suggestions.push('# Point AI crawlers to your llms.txt');
+        suggestions.push('# Add to your site: <link rel="llms-txt" href="/llms.txt">');
+    }
+    return suggestions;
+}
+export function generate(report, pages, siteInfo, existingRobots) {
+    return {
+        llmsTxt: generateLlmsTxt(report, siteInfo),
+        llmsFullTxt: generateLlmsFullTxt(report, pages),
+        jsonLd: pages.flatMap((p) => generateJsonLd(p)),
+        robotsTxtSuggestions: generateRobotsTxtSuggestions(existingRobots ?? null),
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/core/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './scanner.js';
+export * from './rules.js';
+export * from './generator.js';

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './scanner.js';
+export * from './rules.js';
+export * from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/core/rules.d.ts

@@ -0,0 +1,3 @@
+import type { ScoringRule } from './types.js';
+export declare const allRules: ScoringRule[];
+export declare function getRulesByDimension(dimension: string): ScoringRule[];