peaks-loop 4.0.53 → 4.1.0

package/dist/services/scan/archetype-service.js

@@ -1,107 +1,7 @@
-import { readdir, stat } from 'node:fs/promises';
+import { readdir } from 'node:fs/promises';
 import { join } from 'node:path';
-import { isDirectory, pathExists, readText } from 'peaks-loop-shared/fs';
-const BACKEND_DEP_NAMES = [
-    'express',
-    'koa',
-    'fastify',
-    '@nestjs/core',
-    '@nestjs/common',
-    'hapi',
-    '@hapi/hapi',
-    'restify',
-    'next' // treated separately for API routes
-];
-const BACKEND_DIR_CANDIDATES = ['server', 'backend', 'api', 'apps/server', 'apps/api', 'packages/server', 'packages/api'];
-const MONOREPO_CONFIG_FILES = ['pnpm-workspace.yaml', 'lerna.json', 'turbo.json', 'nx.json', 'rush.json'];
-/**
- * PRD-002b slice 2 — extract archetype-detection thresholds. Names
- * describe the meaning; values are bytewise-identical to the original
- * literals (signaled in commit message).
- */
-// eslint-disable-next-line no-magic-numbers -- canonical ms-per-day math (1000 * 60s * 60min * 24h)
-const MS_PER_DAY = 1000 * 60 * 60 * 24;
-const GREENFIELD_MAX_SRC_FILES = 20;
-const LEGACY_MIN_SRC_FILES = 20;
-const LOCKFILE_STALE_DAYS = 180;
-const GREENFIELD_MAX_LOCKFILE_DAYS = 30;
-const HIGH_CONFIDENCE_SIGNAL_COUNT = 3;
-const SWAGGER_CANDIDATE_PATHS = [
-    'swagger.json',
-    'swagger.yaml',
-    'openapi.json',
-    'openapi.yaml',
-    'openapi.yml',
-    'docs/swagger.json',
-    'docs/openapi.json',
-    'docs/openapi.yaml'
-];
-async function readPackageJsonDeps(projectRoot) {
-    const pkgPath = join(projectRoot, 'package.json');
-    if (!(await pathExists(pkgPath))) {
-        return { exists: false, deps: {} };
-    }
-    try {
-        const raw = await readText(pkgPath);
-        const parsed = JSON.parse(raw);
-        const deps = {
-            ...(parsed.dependencies ?? {}),
-            ...(parsed.devDependencies ?? {}),
-            ...(parsed.peerDependencies ?? {}),
-            ...(parsed.optionalDependencies ?? {})
-        };
-        return { exists: true, deps };
-    }
-    catch {
-        return { exists: true, deps: {} };
-    }
-}
-async function detectBackendFrameworks(deps) {
-    return BACKEND_DEP_NAMES.filter((name) => name !== 'next' && Object.prototype.hasOwnProperty.call(deps, name));
-}
-async function detectNextApiRoutes(projectRoot, hasNext) {
-    if (!hasNext) {
-        return false;
-    }
-    const candidates = ['pages/api', 'src/pages/api', 'app/api', 'src/app/api'];
-    for (const candidate of candidates) {
-        if (await isDirectory(join(projectRoot, candidate))) {
-            return true;
-        }
-    }
-    return false;
-}
-async function detectBackendDirs(projectRoot) {
-    const found = [];
-    for (const candidate of BACKEND_DIR_CANDIDATES) {
-        if (await isDirectory(join(projectRoot, candidate))) {
-            found.push(candidate);
-        }
-    }
-    return found;
-}
-async function detectSwagger(projectRoot) {
-    const found = [];
-    for (const candidate of SWAGGER_CANDIDATE_PATHS) {
-        if (await pathExists(join(projectRoot, candidate))) {
-            found.push(candidate);
-        }
-    }
-    const protoDir = join(projectRoot, 'proto');
-    if (await isDirectory(protoDir)) {
-        found.push('proto/');
-    }
-    return found;
-}
-async function detectMonorepoConfigs(projectRoot) {
-    const found = [];
-    for (const file of MONOREPO_CONFIG_FILES) {
-        if (await pathExists(join(projectRoot, file))) {
-            found.push(file);
-        }
-    }
-    return found;
-}
+import { isDirectory } from 'peaks-loop-shared/fs';
+import { detectBackendDirs, detectBackendFrameworks, detectMonorepoConfigs, detectNextApiRoutes, detectSwagger, GREENFIELD_MAX_SRC_FILES, GREENFIELD_MAX_LOCKFILE_DAYS, HIGH_CONFIDENCE_SIGNAL_COUNT, LEGACY_MIN_SRC_FILES, lockfileAgeDays, LOCKFILE_STALE_DAYS, readPackageJsonDeps } from './archetype-detection.js';
 async function countSrcFiles(projectRoot, max = 500) {
     const srcDir = join(projectRoot, 'src');
     if (!(await isDirectory(srcDir))) {
@@ -130,29 +30,23 @@ async function countSrcFiles(projectRoot, max = 500) {
     }
     return count;
 }
-async function lockfileAgeDays(projectRoot) {
-    const candidates = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock', 'bun.lockb'];
-    for (const candidate of candidates) {
-        const full = join(projectRoot, candidate);
-        if (await pathExists(full)) {
-            const stats = await stat(full);
-            const ageMs = Date.now() - stats.mtimeMs;
-            return Math.floor(ageMs / MS_PER_DAY);
-        }
-    }
-    return null;
-}
 function decideArchetype(detected) {
     const signals = [];
-    const hasBackend = detected.hasBackendFramework || detected.hasNextApiRoutes || detected.backendDirsPresent.length > 0;
+    const hasBackend = detected.hasBackendFramework ||
+        detected.hasNextApiRoutes ||
+        detected.backendDirsPresent.length > 0;
     signals.push({
         name: 'backend-presence',
         matched: hasBackend,
         detail: hasBackend
             ? [
-                detected.backendFrameworks.length > 0 ? `framework: ${detected.backendFrameworks.join(', ')}` : null,
+                detected.backendFrameworks.length > 0
+                    ? `framework: ${detected.backendFrameworks.join(', ')}`
+                    : null,
                 detected.hasNextApiRoutes ? 'next-api-routes' : null,
-                detected.backendDirsPresent.length > 0 ? `dirs: ${detected.backendDirsPresent.join(', ')}` : null
+                detected.backendDirsPresent.length > 0
+                    ? `dirs: ${detected.backendDirsPresent.join(', ')}`
+                    : null
             ]
                 .filter(Boolean)
                 .join('; ')
@@ -161,7 +55,9 @@ function decideArchetype(detected) {
     signals.push({
         name: 'swagger-or-proto',
         matched: detected.hasSwaggerOrProto,
-        detail: detected.hasSwaggerOrProto ? detected.swaggerPaths.join(', ') : 'no swagger/openapi/proto'
+        detail: detected.hasSwaggerOrProto
+            ? detected.swaggerPaths.join(', ')
+            : 'no swagger/openapi/proto'
     });
     signals.push({
         name: 'monorepo-config',
@@ -207,15 +103,24 @@ function decideArchetype(detected) {
     const greenfieldSignalCount = greenfieldSignals.filter(Boolean).length;
     // Greenfield must show both a small src AND a fresh/missing lockfile — otherwise an empty-src legacy stub still looks like greenfield.
     if (!hasBackend && greenfieldSignals[0] === true && greenfieldSignals[1] === true) {
-        return { archetype: 'greenfield', confidence: greenfieldSignalCount === HIGH_CONFIDENCE_SIGNAL_COUNT ? 'high' : 'medium', signals };
+        return {
+            archetype: 'greenfield',
+            confidence: greenfieldSignalCount === HIGH_CONFIDENCE_SIGNAL_COUNT ? 'high' : 'medium',
+            signals
+        };
     }
     const legacySignalCount = [
         !hasBackend,
         !detected.hasSwaggerOrProto,
-        (detected.lockfileAgeDays !== null && detected.lockfileAgeDays > LOCKFILE_STALE_DAYS) || detected.srcFileCount >= LEGACY_MIN_SRC_FILES
+        (detected.lockfileAgeDays !== null && detected.lockfileAgeDays > LOCKFILE_STALE_DAYS) ||
+            detected.srcFileCount >= LEGACY_MIN_SRC_FILES
     ].filter(Boolean).length;
     if (!hasBackend && legacySignalCount >= 2) {
-        return { archetype: 'legacy-frontend', confidence: legacySignalCount === HIGH_CONFIDENCE_SIGNAL_COUNT ? 'high' : 'medium', signals };
+        return {
+            archetype: 'legacy-frontend',
+            confidence: legacySignalCount === HIGH_CONFIDENCE_SIGNAL_COUNT ? 'high' : 'medium',
+            signals
+        };
     }
     if (hasBackend) {
         return { archetype: 'legacy-fullstack', confidence: 'medium', signals };
@@ -226,11 +131,15 @@ function decideFrontendOnly(report) {
     if (report.archetype === 'legacy-frontend' || report.archetype === 'frontend-monorepo') {
         return { frontendOnly: true, reason: `archetype=${report.archetype}` };
     }
-    const noBackend = !report.detected.hasBackendFramework && !report.detected.hasNextApiRoutes && report.detected.backendDirsPresent.length === 0;
+    const noBackend = !report.detected.hasBackendFramework &&
+        !report.detected.hasNextApiRoutes &&
+        report.detected.backendDirsPresent.length === 0;
     if (noBackend && !report.detected.hasSwaggerOrProto) {
         return { frontendOnly: true, reason: 'no-backend-no-swagger' };
     }
-    if (report.detected.hasBackendFramework || report.detected.hasNextApiRoutes || report.detected.backendDirsPresent.length > 0) {
+    if (report.detected.hasBackendFramework ||
+        report.detected.hasNextApiRoutes ||
+        report.detected.backendDirsPresent.length > 0) {
         return { frontendOnly: false, reason: 'backend-detected' };
     }
     return { frontendOnly: false, reason: 'swagger-or-proto-present' };
@@ -245,7 +154,9 @@ function decideFrontendOnly(report) {
  * `prd-only` here — one report cannot contradict itself.
  */
 function decideIntegrationMode(report) {
-    const hasBackend = report.detected.hasBackendFramework || report.detected.hasNextApiRoutes || report.detected.backendDirsPresent.length > 0;
+    const hasBackend = report.detected.hasBackendFramework ||
+        report.detected.hasNextApiRoutes ||
+        report.detected.backendDirsPresent.length > 0;
     if (hasBackend) {
         return { integrationMode: 'full-stack', reason: 'backend-detected' };
     }

package/dist/services/scan/diff-scope-service.js

@@ -9,11 +9,7 @@ const PLACEHOLDER_PATTERNS = [
     /^\.{2,}$/, // ...
     /^(?:in-scope|out-of-scope)\s+(?:files|surfaces)/i // bullet that is the template label, not a real path
 ];
-const AUTO_ALLOWED_PATHS = [
-    /^\.peaks\//,
-    /^\.peaks-artifacts\//,
-    /^\.git\//
-];
+const AUTO_ALLOWED_PATHS = [/^\.peaks\//, /^\.peaks-artifacts\//, /^\.git\//];
 const AUTO_ALLOWED_TEST_FILE = /\.(?:test|spec)\.[a-z]+$/i;
 const AUTO_ALLOWED_TEST_DIR = /(?:^|\/)(?:tests?|__tests__|__mocks__|test|spec)\//;
 function isPlaceholder(text) {
@@ -57,14 +53,18 @@ export function globToRegex(pattern) {
     }
     // If the pattern ends with no trailing slash and no extension wildcard, also allow it to match files under the path (treat as dir prefix)
     // E.g. `src/services/login` should match `src/services/login/handler.ts`.
-    body = (!trimmed.includes("*") && !trimmed.includes("?") && !trimmed.includes("."))
-        ? `${body}(?:/.*)?`
-        : body;
+    body =
+        !trimmed.includes('*') && !trimmed.includes('?') && !trimmed.includes('.')
+            ? `${body}(?:/.*)?`
+            : body;
     return new RegExp(`^${body}$`);
 }
 function classifyPatternLine(raw) {
     // Strip leading "- ", "* ", numbered list, or trailing comments.
-    const cleaned = raw.replace(/^\s*[-*+]\s*/, '').replace(/^\s*\d+\.\s*/, '').trim();
+    const cleaned = raw
+        .replace(/^\s*[-*+]\s*/, '')
+        .replace(/^\s*\d+\.\s*/, '')
+        .trim();
     if (cleaned.length === 0)
         return { pattern: null };
     if (isPlaceholder(cleaned))
@@ -119,10 +119,19 @@ function parseRedLineScope(rdBody) {
 }
 function tryGitChangedFiles(projectRoot, baseRef) {
     try {
-        const trackedRaw = execFileSync('git', ['-C', projectRoot, 'diff', '--name-only', baseRef], { encoding: 'utf8', windowsHide: true });
-        const tracked = trackedRaw.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+        const trackedRaw = execFileSync('git', ['-C', projectRoot, 'diff', '--name-only', baseRef], {
+            encoding: 'utf8',
+            windowsHide: true
+        });
+        const tracked = trackedRaw
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
         const untrackedRaw = execFileSync('git', ['-C', projectRoot, 'ls-files', '--others', '--exclude-standard'], { encoding: 'utf8', windowsHide: true });
-        const untracked = untrackedRaw.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+        const untracked = untrackedRaw
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
         return { ok: true, files: Array.from(new Set([...tracked, ...untracked])) };
     }
     catch {
@@ -140,15 +149,26 @@ function isAutoAllowed(path) {
 }
 function classifyFile(path, inScope, outOfScope) {
     if (isAutoAllowed(path)) {
-        return { classification: 'auto-allowed', reason: 'Auto-allowed (test, mock, or Peaks artifact path)' };
+        return {
+            classification: 'auto-allowed',
+            reason: 'Auto-allowed (test, mock, or Peaks artifact path)'
+        };
     }
     const outMatch = outOfScope.find((pattern) => pattern.regex.test(path));
     if (outMatch !== undefined) {
-        return { classification: 'out-of-scope-violation', matchedPattern: outMatch.raw, reason: `Matches explicit out-of-scope pattern "${outMatch.raw}"` };
+        return {
+            classification: 'out-of-scope-violation',
+            matchedPattern: outMatch.raw,
+            reason: `Matches explicit out-of-scope pattern "${outMatch.raw}"`
+        };
     }
     const inMatch = inScope.find((pattern) => pattern.regex.test(path));
     if (inMatch !== undefined) {
-        return { classification: 'in-scope', matchedPattern: inMatch.raw, reason: `Matches in-scope pattern "${inMatch.raw}"` };
+        return {
+            classification: 'in-scope',
+            matchedPattern: inMatch.raw,
+            reason: `Matches in-scope pattern "${inMatch.raw}"`
+        };
     }
     return { classification: 'unclassified', reason: 'Does not match any declared scope pattern' };
 }

package/dist/services/scan/existing-system-service.js

@@ -1,55 +1,15 @@
 import { readdir, stat } from 'node:fs/promises';
 import { basename, join, relative } from 'node:path';
-import { isDirectory, pathExists, readText } from 'peaks-loop-shared/fs';
+import { isDirectory, readText } from 'peaks-loop-shared/fs';
 import { scanArchetype } from './archetype-service.js';
 import { scanHookConvention } from './hook-convention-service.js';
+import { classifyToken, dedupeTokens, extractTailwindTokens, findInconsistencies, parseCssVars, parseLessOrSassVars } from './existing-system-visual-tokens.js';
 const DEFAULT_MAX_TOKENS = 40;
 const DEFAULT_SAMPLES = 5;
-const COLOR_KEYWORDS = ['color', 'primary', 'success', 'warning', 'error', 'danger', 'info', 'bg', 'background', 'border', 'text'];
-const SPACING_KEYWORDS = ['spacing', 'gap', 'padding', 'margin', 'size'];
-const TYPO_KEYWORDS = ['font', 'text-size', 'line-height', 'letter-spacing', 'heading'];
-const RADIUS_KEYWORDS = ['radius', 'rounded'];
 const STYLE_DIRS = ['src/styles', 'src/style', 'styles', 'src/assets/styles', 'src/theme', 'theme'];
 const COMPONENT_DIRS = ['src/components', 'src/Components', 'components'];
 const SERVICE_DIRS = ['src/services', 'src/service', 'src/api', 'src/apis'];
 const HOOK_DIRS = ['src/hooks', 'src/hook', 'src/composables'];
-function classifyToken(name) {
-    const lower = name.toLowerCase();
-    if (RADIUS_KEYWORDS.some((kw) => lower.includes(kw)))
-        return 'radius';
-    if (TYPO_KEYWORDS.some((kw) => lower.includes(kw)))
-        return 'typography';
-    if (SPACING_KEYWORDS.some((kw) => lower.includes(kw)))
-        return 'spacing';
-    if (COLOR_KEYWORDS.some((kw) => lower.includes(kw)))
-        return 'color';
-    return null;
-}
-function parseLessOrSassVars(content, sourceRel) {
-    const tokens = [];
-    // Match `@var: value;` (Less) or `$var: value;` (Sass)
-    const regex = /^\s*[@$]([a-zA-Z][\w-]*)\s*:\s*([^;]+);/gm;
-    let match;
-    while ((match = regex.exec(content)) !== null) {
-        const [, rawName, rawValue] = match;
-        if (rawName === undefined || rawValue === undefined)
-            continue;
-        tokens.push({ name: rawName, value: rawValue.trim(), source: sourceRel });
-    }
-    return tokens;
-}
-function parseCssVars(content, sourceRel) {
-    const tokens = [];
-    const regex = /--([a-zA-Z][\w-]*)\s*:\s*([^;]+);/g;
-    let match;
-    while ((match = regex.exec(content)) !== null) {
-        const [, rawName, rawValue] = match;
-        if (rawName === undefined || rawValue === undefined)
-            continue;
-        tokens.push({ name: `--${rawName}`, value: rawValue.trim(), source: sourceRel });
-    }
-    return tokens;
-}
 async function walkStyleFiles(projectRoot) {
     const found = [];
     for (const candidate of STYLE_DIRS) {
@@ -83,30 +43,6 @@ async function walkStyleFiles(projectRoot) {
     }
     return found;
 }
-async function extractTailwindTokens(projectRoot) {
-    const candidates = ['tailwind.config.js', 'tailwind.config.ts', 'tailwind.config.cjs', 'tailwind.config.mjs'];
-    for (const candidate of candidates) {
-        const full = join(projectRoot, candidate);
-        if (await pathExists(full)) {
-            const content = await readText(full);
-            const tokens = [];
-            // Heuristic: extract keys under theme.extend.* via simple regex.
-            const colorBlock = /colors\s*:\s*\{([\s\S]*?)\}/.exec(content);
-            if (colorBlock?.[1] !== undefined) {
-                const colorRegex = /([a-zA-Z_][\w-]*)\s*:\s*['"`]([^'"`]+)['"`]/g;
-                let match;
-                while ((match = colorRegex.exec(colorBlock[1])) !== null) {
-                    const [, name, value] = match;
-                    if (name !== undefined && value !== undefined) {
-                        tokens.push({ name, value, source: candidate });
-                    }
-                }
-            }
-            return { tokens, source: { path: candidate, kind: 'tailwind-config' } };
-        }
-    }
-    return { tokens: [], source: null };
-}
 async function listFilesByMtime(dir, exts, max) {
     if (!(await isDirectory(dir)))
         return [];
@@ -135,7 +71,8 @@ async function listFilesByMtime(dir, exts, max) {
                     const stats = await stat(full);
                     collected.push({ path: full, mtimeMs: stats.mtimeMs });
                 }
-                catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+                catch {
+                    // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
                     // skip unreadable
                 }
             }
@@ -172,35 +109,6 @@ async function firstExistingDir(projectRoot, candidates) {
     }
     return null;
 }
-function dedupeTokens(tokens, max) {
-    const seen = new Set();
-    const out = [];
-    for (const token of tokens) {
-        const key = `${token.name}=${token.value}`;
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        out.push(token);
-        if (out.length >= max)
-            break;
-    }
-    return out;
-}
-function findInconsistencies(tokens) {
-    const issues = [];
-    const byName = new Map();
-    for (const token of tokens) {
-        const set = byName.get(token.name) ?? new Set();
-        set.add(token.value);
-        byName.set(token.name, set);
-    }
-    for (const [name, values] of byName.entries()) {
-        if (values.size > 1) {
-            issues.push(`token "${name}" has ${values.size} different values across sources: ${[...values].join(' | ')}`);
-        }
-    }
-    return issues;
-}
 export async function scanExistingSystem(options) {
     const { projectRoot } = options;
     const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
@@ -286,9 +194,18 @@ export async function scanExistingSystem(options) {
         ? await listFilesByMtime(join(projectRoot, hookDir), /\.(ts|js)$/i, maxSamples)
         : [];
     const samples = [
-        ...componentSamples.map((sample) => ({ path: relative(projectRoot, sample.path).split(/[\\/]/).join('/'), kind: 'component' })),
-        ...serviceSamples.map((sample) => ({ path: relative(projectRoot, sample.path).split(/[\\/]/).join('/'), kind: 'service' })),
-        ...hookSamples.map((sample) => ({ path: relative(projectRoot, sample.path).split(/[\\/]/).join('/'), kind: 'hook' }))
+        ...componentSamples.map((sample) => ({
+            path: relative(projectRoot, sample.path).split(/[\\/]/).join('/'),
+            kind: 'component'
+        })),
+        ...serviceSamples.map((sample) => ({
+            path: relative(projectRoot, sample.path).split(/[\\/]/).join('/'),
+            kind: 'service'
+        })),
+        ...hookSamples.map((sample) => ({
+            path: relative(projectRoot, sample.path).split(/[\\/]/).join('/'),
+            kind: 'hook'
+        }))
     ];
     return {
         archetype: archetypeReport.archetype,

package/dist/services/scan/existing-system-visual-tokens.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Existing-system visual-token extraction (B wave-3 file-size split).
+ *
+ * Extracted verbatim from `existing-system-service.ts`: the visual
+ * token keyword lists, the Less/Sass/CSS/Tailwind parsers, the token
+ * classifier, the dedupe cap, and the cross-source inconsistency
+ * finder. Function bodies and literals are unchanged (verbatim move);
+ * the file walkers and the public `scanExistingSystem` entry stay in
+ * the sibling module.
+ */
+import type { VisualToken, VisualTokenSource } from './scan-types.js';
+export declare function classifyToken(name: string): 'color' | 'spacing' | 'typography' | 'radius' | null;
+export declare function parseLessOrSassVars(content: string, sourceRel: string): VisualToken[];
+export declare function parseCssVars(content: string, sourceRel: string): VisualToken[];
+export declare function extractTailwindTokens(projectRoot: string): Promise<{
+    tokens: VisualToken[];
+    source: VisualTokenSource | null;
+}>;
+export declare function dedupeTokens(tokens: VisualToken[], max: number): VisualToken[];
+export declare function findInconsistencies(tokens: VisualToken[]): string[];

package/dist/services/scan/existing-system-visual-tokens.js

@@ -0,0 +1,123 @@
+/**
+ * Existing-system visual-token extraction (B wave-3 file-size split).
+ *
+ * Extracted verbatim from `existing-system-service.ts`: the visual
+ * token keyword lists, the Less/Sass/CSS/Tailwind parsers, the token
+ * classifier, the dedupe cap, and the cross-source inconsistency
+ * finder. Function bodies and literals are unchanged (verbatim move);
+ * the file walkers and the public `scanExistingSystem` entry stay in
+ * the sibling module.
+ */
+import { join } from 'node:path';
+import { pathExists, readText } from 'peaks-loop-shared/fs';
+const COLOR_KEYWORDS = [
+    'color',
+    'primary',
+    'success',
+    'warning',
+    'error',
+    'danger',
+    'info',
+    'bg',
+    'background',
+    'border',
+    'text'
+];
+const SPACING_KEYWORDS = ['spacing', 'gap', 'padding', 'margin', 'size'];
+const TYPO_KEYWORDS = ['font', 'text-size', 'line-height', 'letter-spacing', 'heading'];
+const RADIUS_KEYWORDS = ['radius', 'rounded'];
+export function classifyToken(name) {
+    const lower = name.toLowerCase();
+    if (RADIUS_KEYWORDS.some((kw) => lower.includes(kw)))
+        return 'radius';
+    if (TYPO_KEYWORDS.some((kw) => lower.includes(kw)))
+        return 'typography';
+    if (SPACING_KEYWORDS.some((kw) => lower.includes(kw)))
+        return 'spacing';
+    if (COLOR_KEYWORDS.some((kw) => lower.includes(kw)))
+        return 'color';
+    return null;
+}
+export function parseLessOrSassVars(content, sourceRel) {
+    const tokens = [];
+    // Match `@var: value;` (Less) or `$var: value;` (Sass)
+    const regex = /^\s*[@$]([a-zA-Z][\w-]*)\s*:\s*([^;]+);/gm;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        const [, rawName, rawValue] = match;
+        if (rawName === undefined || rawValue === undefined)
+            continue;
+        tokens.push({ name: rawName, value: rawValue.trim(), source: sourceRel });
+    }
+    return tokens;
+}
+export function parseCssVars(content, sourceRel) {
+    const tokens = [];
+    const regex = /--([a-zA-Z][\w-]*)\s*:\s*([^;]+);/g;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        const [, rawName, rawValue] = match;
+        if (rawName === undefined || rawValue === undefined)
+            continue;
+        tokens.push({ name: `--${rawName}`, value: rawValue.trim(), source: sourceRel });
+    }
+    return tokens;
+}
+export async function extractTailwindTokens(projectRoot) {
+    const candidates = [
+        'tailwind.config.js',
+        'tailwind.config.ts',
+        'tailwind.config.cjs',
+        'tailwind.config.mjs'
+    ];
+    for (const candidate of candidates) {
+        const full = join(projectRoot, candidate);
+        if (await pathExists(full)) {
+            const content = await readText(full);
+            const tokens = [];
+            // Heuristic: extract keys under theme.extend.* via simple regex.
+            const colorBlock = /colors\s*:\s*\{([\s\S]*?)\}/.exec(content);
+            if (colorBlock?.[1] !== undefined) {
+                const colorRegex = /([a-zA-Z_][\w-]*)\s*:\s*['"`]([^'"`]+)['"`]/g;
+                let match;
+                while ((match = colorRegex.exec(colorBlock[1])) !== null) {
+                    const [, name, value] = match;
+                    if (name !== undefined && value !== undefined) {
+                        tokens.push({ name, value, source: candidate });
+                    }
+                }
+            }
+            return { tokens, source: { path: candidate, kind: 'tailwind-config' } };
+        }
+    }
+    return { tokens: [], source: null };
+}
+export function dedupeTokens(tokens, max) {
+    const seen = new Set();
+    const out = [];
+    for (const token of tokens) {
+        const key = `${token.name}=${token.value}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(token);
+        if (out.length >= max)
+            break;
+    }
+    return out;
+}
+export function findInconsistencies(tokens) {
+    const issues = [];
+    const byName = new Map();
+    for (const token of tokens) {
+        const set = byName.get(token.name) ?? new Set();
+        set.add(token.value);
+        byName.set(token.name, set);
+    }
+    for (const [name, values] of byName.entries()) {
+        if (values.size > 1) {
+            issues.push(`token "${name}" has ${values.size} different values across sources: ${[...values].join(' | ')}`);
+        }
+    }
+    return issues;
+}