Framework Support

1export const CORE_SUPPORTED_FRAMEWORKS = ['next', 'sveltekit', 'nuxt'];
2export const LIMITED_FRAMEWORKS = ['astro'];
3
4const LABELS = {
5  next: 'Next.js',
6  sveltekit: 'SvelteKit',
7  nuxt: 'Nuxt',
8  astro: 'Astro',
9  hono: 'Hono',
10  remix: 'Remix',
11  unknown: 'unknown framework',
12};
13
14export function frameworkLabel(framework) {
15  return LABELS[normalizeFramework(framework)] ?? String(framework ?? 'unknown');
16}
17
18export function classifyFrameworkSupport(stack = {}) {
19  const framework = normalizeFramework(stack.framework);
20  const label = frameworkLabel(framework);
21  const supportedLabels = CORE_SUPPORTED_FRAMEWORKS.map(frameworkLabel);
22  const limitedLabels = LIMITED_FRAMEWORKS.map(frameworkLabel);
23
24  if (CORE_SUPPORTED_FRAMEWORKS.includes(framework)) {
25    return {
26      ok: true,
27      status: 'supported',
28      blocker: null,
29      framework,
30      label,
31      supportedFrameworks: supportedLabels,
32      limitedFrameworks: limitedLabels,
33      detail: `${label} is supported for metric-backed route-to-file investigations.`,
34    };
35  }
36
37  if (LIMITED_FRAMEWORKS.includes(framework)) {
38    return {
39      ok: true,
40      status: 'limited',
41      blocker: null,
42      framework,
43      label,
44      supportedFrameworks: supportedLabels,
45      limitedFrameworks: limitedLabels,
46      detail: `${label} support is limited. The skill can use Vercel metrics and generic platform checks, but framework-specific route-to-file recommendations may be sparse.`,
47    };
48  }
49
50  return {
51    ok: false,
52    status: 'unsupported',
53    blocker: 'unsupported_framework',
54    framework,
55    label,
56    supportedFrameworks: supportedLabels,
57    limitedFrameworks: limitedLabels,
58    detail: `${label} is not supported for metric-backed route-to-file investigations. Supported frameworks: ${supportedLabels.join(', ')}. Limited support: ${limitedLabels.join(', ')}.`,
59  };
60}
61
62function normalizeFramework(value) {
63  const raw = String(value ?? 'unknown').trim().toLowerCase();
64  if (raw === 'nextjs' || raw === 'next.js') return 'next';
65  if (raw === 'svelte' || raw === 'svelte-kit') return 'sveltekit';
66  return raw || 'unknown';
67}