@theglitchking/hit-em-with-the-docs 2.0.0

package/dist/core/discover/standards.js

@@ -0,0 +1,359 @@
+import { readFile } from 'fs/promises';
+import { relative, basename } from 'path';
+import { glob } from '../../utils/glob.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Discover implicit standards from codebase
+ */
+export async function discoverStandards(options) {
+    const { rootPath, silent = false } = options;
+    if (!silent) {
+        logger.header('Standards Discovery');
+        logger.info(`Analyzing: ${rootPath}`);
+    }
+    // Find all source files
+    const tsFiles = await glob('**/*.{ts,tsx}', {
+        cwd: rootPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/dist/**'],
+    });
+    const jsFiles = await glob('**/*.{js,jsx,mjs}', {
+        cwd: rootPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/dist/**'],
+    });
+    const allFiles = [...new Set([...tsFiles, ...jsFiles])];
+    if (!silent) {
+        logger.info(`Analyzing ${allFiles.length} source files...`);
+    }
+    // Discover each category
+    const naming = await discoverNamingStandards(allFiles, rootPath);
+    const fileOrganization = await discoverFileOrganization(rootPath);
+    const codeStyle = await discoverCodeStyle(allFiles);
+    const documentation = await discoverDocumentationStandards(allFiles);
+    const testing = await discoverTestingStandards(rootPath);
+    const standards = {
+        naming,
+        fileOrganization,
+        codeStyle,
+        documentation,
+        testing,
+    };
+    if (!silent) {
+        logger.newline();
+        logger.success('Standards discovered:');
+        logger.info(`  Functions: ${naming.functions.convention} (${naming.functions.compliance.toFixed(0)}% compliance)`);
+        logger.info(`  Classes: ${naming.classes.convention} (${naming.classes.compliance.toFixed(0)}% compliance)`);
+        logger.info(`  Indentation: ${codeStyle.indentation}${codeStyle.indentSize ? ` (${codeStyle.indentSize} spaces)` : ''}`);
+        logger.info(`  Type hints: ${documentation.typeHintCoverage.toFixed(0)}% coverage`);
+    }
+    return standards;
+}
+/**
+ * Discover naming conventions
+ */
+async function discoverNamingStandards(files, rootPath) {
+    const functionNames = [];
+    const classNames = [];
+    const constantNames = [];
+    const variableNames = [];
+    for (const file of files.slice(0, 100)) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            const relPath = relative(rootPath, file);
+            // Extract function names
+            const funcMatches = content.matchAll(/(?:function\s+(\w+)|(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\([^)]*\)\s*=>)/g);
+            for (const match of funcMatches) {
+                const name = match[1] ?? match[2];
+                if (name)
+                    functionNames.push({ name, file: relPath });
+            }
+            // Extract class names
+            const classMatches = content.matchAll(/class\s+(\w+)/g);
+            for (const match of classMatches) {
+                if (match[1])
+                    classNames.push({ name: match[1], file: relPath });
+            }
+            // Extract constants (UPPER_SNAKE_CASE)
+            const constMatches = content.matchAll(/const\s+([A-Z][A-Z0-9_]+)\s*=/g);
+            for (const match of constMatches) {
+                if (match[1])
+                    constantNames.push({ name: match[1], file: relPath });
+            }
+            // Extract regular variables
+            const varMatches = content.matchAll(/(?:const|let|var)\s+([a-z][a-zA-Z0-9]*)\s*=/g);
+            for (const match of varMatches) {
+                if (match[1])
+                    variableNames.push({ name: match[1], file: relPath });
+            }
+        }
+        catch {
+            // Skip
+        }
+    }
+    // Analyze file naming
+    const fileNameExamples = files.slice(0, 20).map((f) => ({
+        name: basename(f),
+        file: relative(rootPath, f),
+    }));
+    return {
+        functions: analyzeNamingConvention(functionNames, 'camelCase'),
+        classes: analyzeNamingConvention(classNames, 'PascalCase'),
+        constants: analyzeNamingConvention(constantNames, 'UPPER_SNAKE_CASE'),
+        variables: analyzeNamingConvention(variableNames, 'camelCase'),
+        files: analyzeFileNaming(fileNameExamples),
+    };
+}
+/**
+ * Analyze naming convention compliance
+ */
+function analyzeNamingConvention(names, expectedConvention) {
+    const checks = {
+        camelCase: (n) => /^[a-z][a-zA-Z0-9]*$/.test(n),
+        PascalCase: (n) => /^[A-Z][a-zA-Z0-9]*$/.test(n),
+        UPPER_SNAKE_CASE: (n) => /^[A-Z][A-Z0-9_]*$/.test(n),
+        'kebab-case': (n) => /^[a-z][a-z0-9-]*$/.test(n),
+        snake_case: (n) => /^[a-z][a-z0-9_]*$/.test(n),
+    };
+    const check = checks[expectedConvention] ?? checks.camelCase;
+    const compliant = names.filter((n) => check(n.name));
+    const compliance = names.length > 0 ? (compliant.length / names.length) * 100 : 100;
+    // Detect actual convention used
+    let detectedConvention = expectedConvention;
+    let maxCompliance = compliance;
+    for (const [convention, checkFn] of Object.entries(checks)) {
+        const conventionCompliance = names.filter((n) => checkFn(n.name)).length / Math.max(names.length, 1) * 100;
+        if (conventionCompliance > maxCompliance) {
+            maxCompliance = conventionCompliance;
+            detectedConvention = convention;
+        }
+    }
+    return {
+        convention: detectedConvention,
+        compliance: maxCompliance,
+        examples: names.slice(0, 5).map((n) => ({
+            ...n,
+            compliant: check(n.name),
+        })),
+    };
+}
+/**
+ * Analyze file naming convention
+ */
+function analyzeFileNaming(files) {
+    const kebabCase = files.filter((f) => /^[a-z][a-z0-9-]*\./.test(f.name)).length;
+    const camelCase = files.filter((f) => /^[a-z][a-zA-Z0-9]*\./.test(f.name)).length;
+    const pascalCase = files.filter((f) => /^[A-Z][a-zA-Z0-9]*\./.test(f.name)).length;
+    const snakeCase = files.filter((f) => /^[a-z][a-z0-9_]*\./.test(f.name)).length;
+    const total = files.length || 1;
+    const conventions = [
+        { name: 'kebab-case', count: kebabCase },
+        { name: 'camelCase', count: camelCase },
+        { name: 'PascalCase', count: pascalCase },
+        { name: 'snake_case', count: snakeCase },
+    ];
+    const best = conventions.sort((a, b) => b.count - a.count)[0];
+    return {
+        convention: best.name,
+        compliance: (best.count / total) * 100,
+        examples: files.slice(0, 5).map((f) => ({
+            ...f,
+            compliant: best.name === 'kebab-case' ? /^[a-z][a-z0-9-]*\./.test(f.name) : true,
+        })),
+    };
+}
+/**
+ * Discover file organization patterns
+ */
+async function discoverFileOrganization(rootPath) {
+    const patterns = [];
+    // Common folder patterns to check
+    const folderPatterns = [
+        { pattern: 'src/', glob: 'src/**/*' },
+        { pattern: 'lib/', glob: 'lib/**/*' },
+        { pattern: 'components/', glob: '**/components/**/*' },
+        { pattern: 'services/', glob: '**/services/**/*' },
+        { pattern: 'models/', glob: '**/models/**/*' },
+        { pattern: 'utils/', glob: '**/utils/**/*' },
+        { pattern: 'hooks/', glob: '**/hooks/**/*' },
+        { pattern: 'api/', glob: '**/api/**/*' },
+        { pattern: 'routes/', glob: '**/routes/**/*' },
+        { pattern: 'routers/', glob: '**/routers/**/*' },
+        { pattern: 'tests/', glob: '**/tests/**/*' },
+        { pattern: '__tests__/', glob: '**/__tests__/**/*' },
+    ];
+    for (const { pattern: name, glob: globPattern } of folderPatterns) {
+        const files = await glob(globPattern, {
+            cwd: rootPath,
+            ignore: ['**/node_modules/**', '**/dist/**'],
+        });
+        if (files.length > 0) {
+            patterns.push({
+                pattern: name,
+                files: files.length,
+                examples: files.slice(0, 3),
+            });
+        }
+    }
+    // Get root folders
+    const rootEntries = await glob('*', { cwd: rootPath });
+    const rootFolders = rootEntries.filter((e) => !e.includes('.'));
+    return {
+        patterns: patterns.sort((a, b) => b.files - a.files),
+        rootFolders,
+    };
+}
+/**
+ * Discover code style preferences
+ */
+async function discoverCodeStyle(files) {
+    let tabCount = 0;
+    let spaceCount = 0;
+    let space2Count = 0;
+    let space4Count = 0;
+    let semiCount = 0;
+    let noSemiCount = 0;
+    let singleQuoteCount = 0;
+    let doubleQuoteCount = 0;
+    let trailingCommaCount = 0;
+    let noTrailingCommaCount = 0;
+    let maxLineLength = 0;
+    for (const file of files.slice(0, 50)) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            const lines = content.split('\n');
+            for (const line of lines) {
+                // Check indentation
+                if (line.startsWith('\t'))
+                    tabCount++;
+                if (line.startsWith('  ')) {
+                    spaceCount++;
+                    if (line.startsWith('    ') && !line.startsWith('      '))
+                        space4Count++;
+                    else if (line.startsWith('  ') && !line.startsWith('    '))
+                        space2Count++;
+                }
+                // Check max line length
+                if (line.length > maxLineLength)
+                    maxLineLength = line.length;
+                // Check semicolons (at end of statements)
+                if (/[a-zA-Z0-9)}\]'"`]\s*;$/.test(line.trim()))
+                    semiCount++;
+                if (/[a-zA-Z0-9)}\]'"`]$/.test(line.trim()) && !line.trim().endsWith('{'))
+                    noSemiCount++;
+                // Check quotes
+                if (line.includes("'") && !line.includes('"'))
+                    singleQuoteCount++;
+                if (line.includes('"') && !line.includes("'"))
+                    doubleQuoteCount++;
+                // Check trailing commas
+                if (/,\s*[}\]]/.test(line))
+                    trailingCommaCount++;
+                if (/[^,\s]\s*[}\]]/.test(line))
+                    noTrailingCommaCount++;
+            }
+        }
+        catch {
+            // Skip
+        }
+    }
+    // Determine preferences
+    const indentation = tabCount > spaceCount * 0.8 ? 'tabs' :
+        spaceCount > tabCount * 0.8 ? 'spaces' : 'mixed';
+    const indentSize = space4Count > space2Count ? 4 : 2;
+    const semicolons = semiCount > noSemiCount * 2 ? 'always' :
+        noSemiCount > semiCount * 2 ? 'never' : 'mixed';
+    const quotes = singleQuoteCount > doubleQuoteCount * 2 ? 'single' :
+        doubleQuoteCount > singleQuoteCount * 2 ? 'double' : 'mixed';
+    const trailingCommas = trailingCommaCount > noTrailingCommaCount * 2 ? 'always' :
+        noTrailingCommaCount > trailingCommaCount * 2 ? 'never' : 'mixed';
+    const result = {
+        maxLineLength,
+        indentation,
+        semicolons,
+        quotes,
+        trailingCommas,
+    };
+    if (indentation === 'spaces') {
+        result.indentSize = indentSize;
+    }
+    return result;
+}
+/**
+ * Discover documentation standards
+ */
+async function discoverDocumentationStandards(files) {
+    let totalFunctions = 0;
+    let documentedFunctions = 0;
+    let typedFunctions = 0;
+    let jsdocCount = 0;
+    let tsdocCount = 0;
+    for (const file of files.slice(0, 50)) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            // Count functions
+            const functions = content.match(/(?:function\s+\w+|(?:const|let|var)\s+\w+\s*=\s*(?:async\s*)?\([^)]*\)\s*=>)/g);
+            totalFunctions += functions?.length ?? 0;
+            // Count documented functions (JSDoc/TSDoc comments before functions)
+            const jsdocs = content.match(/\/\*\*[\s\S]*?\*\/\s*(?:export\s+)?(?:async\s+)?(?:function|const|let|var)/g);
+            documentedFunctions += jsdocs?.length ?? 0;
+            // Check docstring style
+            if (content.includes('@param'))
+                jsdocCount++;
+            if (content.includes('@returns'))
+                tsdocCount++;
+            // Count typed functions (TypeScript)
+            const typed = content.match(/\([^)]*:[^)]+\)\s*(?::\s*\w+)?\s*(?:=>|{)/g);
+            typedFunctions += typed?.length ?? 0;
+        }
+        catch {
+            // Skip
+        }
+    }
+    const docstringStyle = tsdocCount > jsdocCount ? 'TSDoc' : 'JSDoc';
+    const coverage = totalFunctions > 0 ? (documentedFunctions / totalFunctions) * 100 : 0;
+    const typeHintCoverage = totalFunctions > 0 ? (typedFunctions / totalFunctions) * 100 : 0;
+    return {
+        docstringStyle,
+        coverage,
+        typeHintCoverage,
+    };
+}
+/**
+ * Discover testing standards
+ */
+async function discoverTestingStandards(rootPath) {
+    // Check for test files in various patterns
+    const patterns = [
+        '**/*.test.ts',
+        '**/*.spec.ts',
+        '**/__tests__/*.ts',
+        '**/test/*.ts',
+        '**/tests/*.ts',
+    ];
+    let testPattern = '*.test.ts';
+    let maxFiles = 0;
+    for (const pattern of patterns) {
+        const files = await glob(pattern, {
+            cwd: rootPath,
+            ignore: ['**/node_modules/**'],
+        });
+        if (files.length > maxFiles) {
+            maxFiles = files.length;
+            testPattern = pattern.replace('**/', '').replace('/*.ts', '');
+        }
+    }
+    // Check for fixtures
+    const fixtures = await glob('**/fixtures/**/*', {
+        cwd: rootPath,
+        ignore: ['**/node_modules/**'],
+    });
+    const result = {
+        pattern: testPattern,
+    };
+    if (fixtures.length > 0) {
+        result.fixturePattern = 'fixtures/';
+    }
+    return result;
+}
+//# sourceMappingURL=standards.js.map

package/dist/core/discover/standards.js.map

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

package/dist/core/domains/classifier.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Document tier classification system.
+ * Classifies documents into 5 tiers based on content structure.
+ */
+export declare const TIERS: readonly ["guide", "standard", "example", "reference", "admin"];
+export type Tier = (typeof TIERS)[number];
+export interface TierDefinition {
+    id: Tier;
+    name: string;
+    description: string;
+    sizeRange: {
+        min: number;
+        max: number;
+    };
+    indicators: string[];
+    headingPatterns: RegExp[];
+}
+export declare const TIER_DEFINITIONS: Record<Tier, TierDefinition>;
+export interface TierClassificationResult {
+    tier: Tier;
+    confidence: number;
+    scores: Record<Tier, number>;
+    reasoning: string[];
+}
+/**
+ * Classify document content into a tier
+ */
+export declare function classifyTier(content: string): TierClassificationResult;
+/**
+ * Get tier definition by ID
+ */
+export declare function getTierDefinition(tier: Tier): TierDefinition;
+/**
+ * Check if a string is a valid tier
+ */
+export declare function isValidTier(value: string): value is Tier;
+/**
+ * Get tier display name
+ */
+export declare function getTierDisplayName(tier: Tier): string;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/core/domains/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/core/domains/classifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,KAAK,iEAAkE,CAAC;AACrF,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,CAgFzD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CA+GtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAErD"}

package/dist/core/domains/classifier.js

@@ -0,0 +1,208 @@
+/**
+ * Document tier classification system.
+ * Classifies documents into 5 tiers based on content structure.
+ */
+export const TIERS = ['guide', 'standard', 'example', 'reference', 'admin'];
+export const TIER_DEFINITIONS = {
+    guide: {
+        id: 'guide',
+        name: 'Guide',
+        description: 'Step-by-step how-to guides',
+        sizeRange: { min: 15, max: 30 },
+        indicators: [
+            'how to', 'step by step', 'tutorial', 'guide', 'walkthrough',
+            'getting started', 'learn', 'implement', 'build', 'create',
+        ],
+        headingPatterns: [
+            /^#+\s*(prerequisites?|requirements?)/i,
+            /^#+\s*(step\s*\d+|first|next|then|finally)/i,
+            /^#+\s*(overview|introduction|getting started)/i,
+            /^#+\s*(example|demo|try it)/i,
+        ],
+    },
+    standard: {
+        id: 'standard',
+        name: 'Standard',
+        description: 'Coding standards and conventions',
+        sizeRange: { min: 5, max: 15 },
+        indicators: [
+            'standard', 'convention', 'rule', 'must', 'should', 'must not',
+            'should not', 'required', 'recommended', 'best practice', 'guideline',
+        ],
+        headingPatterns: [
+            /^#+\s*(rules?|guidelines?|conventions?)/i,
+            /^#+\s*(do|don'?t|avoid|prefer)/i,
+            /^#+\s*(naming|formatting|style)/i,
+            /^#+\s*(required|recommended|optional)/i,
+        ],
+    },
+    example: {
+        id: 'example',
+        name: 'Example',
+        description: 'Code examples and templates',
+        sizeRange: { min: 3, max: 10 },
+        indicators: [
+            'example', 'sample', 'template', 'snippet', 'code', 'demo',
+            'showcase', 'pattern example', 'usage example',
+        ],
+        headingPatterns: [
+            /^#+\s*(example|sample|template)/i,
+            /^#+\s*(code|snippet|usage)/i,
+            /^#+\s*(input|output|result)/i,
+        ],
+    },
+    reference: {
+        id: 'reference',
+        name: 'Reference',
+        description: 'Comprehensive references',
+        sizeRange: { min: 30, max: 100 },
+        indicators: [
+            'reference', 'specification', 'api', 'complete', 'comprehensive',
+            'all', 'full list', 'documentation', 'schema', 'interface',
+        ],
+        headingPatterns: [
+            /^#+\s*(api|schema|interface|type)/i,
+            /^#+\s*(parameters?|arguments?|options?)/i,
+            /^#+\s*(methods?|functions?|endpoints?)/i,
+            /^#+\s*(properties|fields|attributes)/i,
+        ],
+    },
+    admin: {
+        id: 'admin',
+        name: 'Admin',
+        description: 'Administrative/operational docs',
+        sizeRange: { min: 10, max: 20 },
+        indicators: [
+            'admin', 'administrative', 'operational', 'maintenance', 'ops',
+            'manage', 'configure', 'setup', 'deployment', 'monitoring',
+        ],
+        headingPatterns: [
+            /^#+\s*(configuration|setup|installation)/i,
+            /^#+\s*(maintenance|monitoring|logging)/i,
+            /^#+\s*(backup|restore|recovery)/i,
+            /^#+\s*(troubleshooting|debugging)/i,
+        ],
+    },
+};
+/**
+ * Classify document content into a tier
+ */
+export function classifyTier(content) {
+    const scores = {
+        guide: 0,
+        standard: 0,
+        example: 0,
+        reference: 0,
+        admin: 0,
+    };
+    const reasoning = [];
+    const lowerContent = content.toLowerCase();
+    // Calculate content size in KB
+    const sizeKB = Buffer.byteLength(content, 'utf8') / 1024;
+    // Score based on indicators
+    for (const tier of TIERS) {
+        const def = TIER_DEFINITIONS[tier];
+        // Check indicators
+        for (const indicator of def.indicators) {
+            const regex = new RegExp(`\\b${escapeRegExp(indicator)}\\b`, 'gi');
+            const matches = lowerContent.match(regex);
+            if (matches) {
+                scores[tier] += matches.length * 2;
+                if (matches.length >= 3) {
+                    reasoning.push(`Found indicator "${indicator}" ${matches.length} times (${tier})`);
+                }
+            }
+        }
+        // Check heading patterns
+        for (const pattern of def.headingPatterns) {
+            const matches = content.match(new RegExp(pattern.source, 'gim'));
+            if (matches) {
+                scores[tier] += matches.length * 5;
+                reasoning.push(`Matched heading pattern for ${tier}: ${matches.length} matches`);
+            }
+        }
+        // Size-based scoring
+        if (sizeKB >= def.sizeRange.min && sizeKB <= def.sizeRange.max) {
+            scores[tier] += 10;
+            reasoning.push(`Size ${sizeKB.toFixed(1)}KB matches ${tier} range`);
+        }
+    }
+    // Additional heuristics
+    // Code block ratio indicates example or reference
+    const codeBlockCount = (content.match(/```/g) ?? []).length / 2;
+    const lines = content.split('\n').length;
+    const codeRatio = codeBlockCount / (lines / 50);
+    if (codeRatio > 0.5) {
+        scores.example += 15;
+        reasoning.push('High code block ratio suggests example');
+    }
+    // Bullet/numbered list ratio indicates guide or standard
+    const listItems = (content.match(/^[\s]*[-*\d.]+\s/gm) ?? []).length;
+    const listRatio = listItems / lines;
+    if (listRatio > 0.3) {
+        scores.guide += 10;
+        scores.standard += 8;
+        reasoning.push('High list ratio suggests guide or standard');
+    }
+    // Table presence indicates reference
+    const tables = (content.match(/^\|.*\|$/gm) ?? []).length;
+    if (tables > 5) {
+        scores.reference += 15;
+        reasoning.push('Multiple tables suggest reference');
+    }
+    // Warning/Note boxes indicate admin or troubleshooting
+    const warnings = (content.match(/>\s*\*\*(warning|note|caution|important)/gi) ?? []).length;
+    if (warnings > 2) {
+        scores.admin += 10;
+        reasoning.push('Warning boxes suggest admin documentation');
+    }
+    // Find the winning tier
+    let maxScore = 0;
+    let winningTier = 'guide';
+    for (const tier of TIERS) {
+        if (scores[tier] > maxScore) {
+            maxScore = scores[tier];
+            winningTier = tier;
+        }
+    }
+    // Calculate confidence based on score difference
+    const sortedScores = Object.values(scores).sort((a, b) => b - a);
+    const topScore = sortedScores[0] ?? 0;
+    const secondScore = sortedScores[1] ?? 0;
+    const scoreDiff = topScore - secondScore;
+    let confidence = 0.5;
+    if (topScore > 0) {
+        confidence = Math.min(0.5 + (scoreDiff / topScore) * 0.3 + (topScore / 100) * 0.2, 0.95);
+    }
+    return {
+        tier: winningTier,
+        confidence,
+        scores,
+        reasoning,
+    };
+}
+/**
+ * Get tier definition by ID
+ */
+export function getTierDefinition(tier) {
+    return TIER_DEFINITIONS[tier];
+}
+/**
+ * Check if a string is a valid tier
+ */
+export function isValidTier(value) {
+    return TIERS.includes(value);
+}
+/**
+ * Get tier display name
+ */
+export function getTierDisplayName(tier) {
+    return TIER_DEFINITIONS[tier].name;
+}
+/**
+ * Escape special regex characters
+ */
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=classifier.js.map

package/dist/core/domains/classifier.js.map

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