specforge-mcp 0.1.0

package/dist/i18n/index.js

@@ -0,0 +1,283 @@
+// i18n/index.ts — Internationalization system for SpecForge
+// Loads message bundles from JSON files at runtime and provides
+// a t() translation function with dot-notation key lookup.
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Internal state
+// ---------------------------------------------------------------------------
+const SUPPORTED_LOCALES = ['en', 'es', 'pt'];
+let currentLocale = 'en';
+/** Locale -> flattened key->value map */
+const messageCache = new Map();
+// ---------------------------------------------------------------------------
+// Message loading
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the absolute path to the messages directory.
+ * Works regardless of whether we are running from `src/` (ts-node / dev)
+ * or from `dist/` (compiled).  The JSON files always live under
+ * `src/i18n/messages/` and are NOT copied by tsc — so we resolve
+ * relative to the *source* location via import.meta.url.
+ */
+function messagesDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    const thisDir = dirname(thisFile);
+    // When compiled, thisDir = <root>/dist/i18n — messages live in src/i18n/messages.
+    // When running from source, thisDir = <root>/src/i18n — messages live in ./messages.
+    // We try both locations.
+    const srcPath = join(thisDir, 'messages');
+    const distFallback = join(thisDir, '..', '..', 'src', 'i18n', 'messages');
+    try {
+        // Quick existence check
+        readFileSync(join(srcPath, 'en.json'), 'utf-8');
+        return srcPath;
+    }
+    catch {
+        return distFallback;
+    }
+}
+/**
+ * Flatten a nested object into dot-notation keys.
+ * { a: { b: "x" } } => { "a.b": "x" }
+ */
+function flatten(obj, prefix = '') {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            Object.assign(result, flatten(value, fullKey));
+        }
+        else {
+            result[fullKey] = String(value);
+        }
+    }
+    return result;
+}
+/**
+ * Load and cache messages for a locale. Returns the flattened map.
+ */
+function loadMessages(locale) {
+    const cached = messageCache.get(locale);
+    if (cached) {
+        return cached;
+    }
+    const dir = messagesDir();
+    try {
+        const raw = readFileSync(join(dir, `${locale}.json`), 'utf-8');
+        const parsed = JSON.parse(raw);
+        const flattened = flatten(parsed);
+        messageCache.set(locale, flattened);
+        return flattened;
+    }
+    catch {
+        // If the locale file is missing, return an empty map.
+        // The t() function will fall back to "en".
+        const empty = {};
+        messageCache.set(locale, empty);
+        return empty;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Get the currently active locale.
+ */
+export function getLocale() {
+    return currentLocale;
+}
+/**
+ * Set the active locale. If the locale is not supported, it stays unchanged.
+ */
+export function setLocale(locale) {
+    if (SUPPORTED_LOCALES.includes(locale)) {
+        currentLocale = locale;
+    }
+}
+/**
+ * Check whether a locale string is a valid SupportedLocale.
+ */
+export function isSupportedLocale(value) {
+    return SUPPORTED_LOCALES.includes(value);
+}
+/**
+ * Return the list of supported locale codes.
+ */
+export function getSupportedLocales() {
+    return [...SUPPORTED_LOCALES];
+}
+/**
+ * Translate a dot-notation key to a localized string.
+ *
+ * @param key    Dot-notation key, e.g. "tools.create_spec.success"
+ * @param locale Optional locale override (defaults to the current global locale)
+ * @returns      The translated string, or the key itself if not found in any locale.
+ *
+ * Interpolation: use `{placeholder}` in message strings. Pass values via
+ * the `t()` return and then call `.replace()` — or use the `ti()` helper.
+ */
+export function t(key, locale) {
+    const targetLocale = locale ?? currentLocale;
+    const messages = loadMessages(targetLocale);
+    if (messages[key] !== undefined) {
+        return messages[key];
+    }
+    // Fallback to English
+    if (targetLocale !== 'en') {
+        const enMessages = loadMessages('en');
+        if (enMessages[key] !== undefined) {
+            return enMessages[key];
+        }
+    }
+    // Key not found — return the key itself as a last resort
+    return key;
+}
+// ---------------------------------------------------------------------------
+// Language detection
+// ---------------------------------------------------------------------------
+/** High-frequency function words per language for heuristic detection. */
+const LANG_SIGNATURES = {
+    es: [
+        'el',
+        'la',
+        'los',
+        'las',
+        'de',
+        'del',
+        'que',
+        'en',
+        'con',
+        'por',
+        'una',
+        'más',
+        'pero',
+        'como',
+        'crear',
+        'nueva',
+        'muestra',
+        'lista',
+        'actualiza',
+    ],
+    en: [
+        'the',
+        'a',
+        'an',
+        'of',
+        'in',
+        'to',
+        'is',
+        'are',
+        'for',
+        'that',
+        'this',
+        'with',
+        'create',
+        'make',
+        'show',
+        'list',
+        'update',
+        'run',
+        'get',
+    ],
+    pt: [
+        'o',
+        'os',
+        'do',
+        'da',
+        'das',
+        'dos',
+        'para',
+        'com',
+        'no',
+        'na',
+        'uma',
+        'mais',
+        'não',
+        'mas',
+        'criar',
+        'mostrar',
+        'listar',
+    ],
+    de: [
+        'der',
+        'die',
+        'das',
+        'ein',
+        'eine',
+        'und',
+        'von',
+        'zu',
+        'ist',
+        'für',
+        'mit',
+        'auf',
+        'nicht',
+        'erstelle',
+        'zeige',
+    ],
+    fr: [
+        'le',
+        'la',
+        'les',
+        'de',
+        'un',
+        'une',
+        'est',
+        'pas',
+        'pour',
+        'dans',
+        'qui',
+        'des',
+        'du',
+        'créer',
+        'afficher',
+    ],
+};
+/**
+ * Detect the language of a text string using heuristic word-frequency scoring.
+ * Returns a BCP-47-style language code ('es', 'en', 'pt', 'de', 'fr', ...) or 'en' as default.
+ * This is intentionally conservative: when confidence is low, falls back to 'en'.
+ */
+export function detectLanguage(input) {
+    const tokens = input
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((tok) => tok.length > 1);
+    if (tokens.length === 0) {
+        return 'en';
+    }
+    const scores = {};
+    for (const [lang, keywords] of Object.entries(LANG_SIGNATURES)) {
+        const keywordSet = new Set(keywords);
+        const hits = tokens.filter((tok) => keywordSet.has(tok)).length;
+        scores[lang] = hits / tokens.length;
+    }
+    // Find best-scoring language
+    let bestLang = 'en';
+    let bestScore = 0;
+    for (const [lang, score] of Object.entries(scores)) {
+        if (score > bestScore) {
+            bestScore = score;
+            bestLang = lang;
+        }
+    }
+    // Minimum confidence threshold to avoid spurious detection
+    return bestScore >= 0.05 ? bestLang : 'en';
+}
+/**
+ * Translate with interpolation.
+ *
+ * @param key    Dot-notation key
+ * @param params Key-value pairs to replace `{placeholder}` tokens
+ * @param locale Optional locale override
+ */
+export function ti(key, params, locale) {
+    let message = t(key, locale);
+    for (const [param, value] of Object.entries(params)) {
+        message = message.replaceAll(`{${param}}`, String(value));
+    }
+    return message;
+}
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

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

package/dist/i18n/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/i18n/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/i18n/index.test.ts"],"names":[],"mappings":""}

package/dist/i18n/index.test.js

@@ -0,0 +1,375 @@
+// i18n/index.test.ts — Unit tests for the internationalization module
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+// Mock readFileSync to control message loading
+vi.mock('node:fs', () => ({
+    readFileSync: vi.fn(),
+}));
+import { readFileSync } from 'node:fs';
+const mockedReadFileSync = vi.mocked(readFileSync);
+// Sample message files
+const EN_MESSAGES = {
+    spec: {
+        created: 'Spec {id} created successfully',
+        notFound: 'Spec {id} not found',
+    },
+    project: {
+        initialized: 'Project initialized: {language} / {framework} detected',
+        notFound: 'Project not found. Run init_project first',
+    },
+    locale: {
+        changed: 'Locale changed to {locale}',
+    },
+    nested: {
+        deep: {
+            value: 'Deep nested value',
+        },
+    },
+    arrayValue: [1, 2, 3],
+};
+const ES_MESSAGES = {
+    spec: {
+        created: 'Spec {id} creada exitosamente',
+        notFound: 'Spec {id} no encontrada',
+    },
+    project: {
+        initialized: 'Proyecto inicializado: {language} / {framework} detectado',
+    },
+    locale: {
+        changed: 'Idioma cambiado a {locale}',
+    },
+};
+const PT_MESSAGES = {
+    spec: {
+        created: 'Spec {id} criada com sucesso',
+    },
+};
+let getLocale;
+let setLocale;
+let isSupportedLocale;
+let getSupportedLocales;
+let t;
+let ti;
+beforeEach(async () => {
+    vi.resetModules();
+    vi.resetAllMocks();
+    // Mock readFileSync to return messages based on file path
+    mockedReadFileSync.mockImplementation((pathArg) => {
+        const path = String(pathArg);
+        if (path.includes('en.json')) {
+            return JSON.stringify(EN_MESSAGES);
+        }
+        if (path.includes('es.json')) {
+            return JSON.stringify(ES_MESSAGES);
+        }
+        if (path.includes('pt.json')) {
+            return JSON.stringify(PT_MESSAGES);
+        }
+        throw new Error('File not found');
+    });
+    // Re-import to reset module state (currentLocale, messageCache)
+    const mod = await import('./index.js');
+    getLocale = mod.getLocale;
+    setLocale = mod.setLocale;
+    isSupportedLocale = mod.isSupportedLocale;
+    getSupportedLocales = mod.getSupportedLocales;
+    t = mod.t;
+    ti = mod.ti;
+});
+// =============================================================================
+// getLocale
+// =============================================================================
+describe('getLocale', () => {
+    it('should return "en" as the default locale', () => {
+        expect(getLocale()).toBe('en');
+    });
+    it('should return current locale after setLocale', () => {
+        setLocale('es');
+        expect(getLocale()).toBe('es');
+    });
+});
+// =============================================================================
+// setLocale
+// =============================================================================
+describe('setLocale', () => {
+    it('should change the locale to a supported value', () => {
+        setLocale('es');
+        expect(getLocale()).toBe('es');
+    });
+    it('should change locale to pt', () => {
+        setLocale('pt');
+        expect(getLocale()).toBe('pt');
+    });
+    it('should ignore invalid locale and keep current', () => {
+        setLocale('es');
+        setLocale('invalid');
+        expect(getLocale()).toBe('es');
+    });
+    it('should allow setting back to en', () => {
+        setLocale('es');
+        setLocale('en');
+        expect(getLocale()).toBe('en');
+    });
+});
+// =============================================================================
+// isSupportedLocale
+// =============================================================================
+describe('isSupportedLocale', () => {
+    it('should return true for "en"', () => {
+        expect(isSupportedLocale('en')).toBe(true);
+    });
+    it('should return true for "es"', () => {
+        expect(isSupportedLocale('es')).toBe(true);
+    });
+    it('should return true for "pt"', () => {
+        expect(isSupportedLocale('pt')).toBe(true);
+    });
+    it('should return false for unsupported locale "fr"', () => {
+        expect(isSupportedLocale('fr')).toBe(false);
+    });
+    it('should return false for empty string', () => {
+        expect(isSupportedLocale('')).toBe(false);
+    });
+    it('should return false for "EN" (case-sensitive)', () => {
+        expect(isSupportedLocale('EN')).toBe(false);
+    });
+    it('should return false for random strings', () => {
+        expect(isSupportedLocale('xyz')).toBe(false);
+        expect(isSupportedLocale('de')).toBe(false);
+        expect(isSupportedLocale('ja')).toBe(false);
+    });
+});
+// =============================================================================
+// getSupportedLocales
+// =============================================================================
+describe('getSupportedLocales', () => {
+    it('should return all 3 supported locales', () => {
+        const locales = getSupportedLocales();
+        expect(locales).toHaveLength(3);
+        expect(locales).toContain('en');
+        expect(locales).toContain('es');
+        expect(locales).toContain('pt');
+    });
+    it('should return a copy (not the internal array)', () => {
+        const locales1 = getSupportedLocales();
+        const locales2 = getSupportedLocales();
+        expect(locales1).not.toBe(locales2);
+        expect(locales1).toEqual(locales2);
+    });
+});
+// =============================================================================
+// t (translate)
+// =============================================================================
+describe('t', () => {
+    it('should return English translation for known key', () => {
+        const result = t('spec.created');
+        expect(result).toBe('Spec {id} created successfully');
+    });
+    it('should return Spanish translation when locale is es', () => {
+        setLocale('es');
+        const result = t('spec.created');
+        expect(result).toBe('Spec {id} creada exitosamente');
+    });
+    it('should return Portuguese translation when locale is pt', () => {
+        setLocale('pt');
+        const result = t('spec.created');
+        expect(result).toBe('Spec {id} criada com sucesso');
+    });
+    it('should fallback to English when key not found in current locale', () => {
+        setLocale('pt');
+        // pt does not have project.notFound
+        const result = t('project.notFound');
+        expect(result).toBe('Project not found. Run init_project first');
+    });
+    it('should fallback to English when es does not have the key', () => {
+        setLocale('es');
+        // es does not have nested.deep.value
+        const result = t('nested.deep.value');
+        expect(result).toBe('Deep nested value');
+    });
+    it('should return the key itself when not found in any locale', () => {
+        const result = t('nonexistent.key.path');
+        expect(result).toBe('nonexistent.key.path');
+    });
+    it('should return the key when not found in any locale even for non-en', () => {
+        setLocale('es');
+        const result = t('totally.unknown.key');
+        expect(result).toBe('totally.unknown.key');
+    });
+    it('should accept locale override parameter', () => {
+        // Current locale is en, but override to es
+        const result = t('spec.created', 'es');
+        expect(result).toBe('Spec {id} creada exitosamente');
+    });
+    it('should use override locale even when current is different', () => {
+        setLocale('es');
+        const result = t('spec.created', 'en');
+        expect(result).toBe('Spec {id} created successfully');
+    });
+    it('should fallback to en when override locale does not have key', () => {
+        const result = t('project.notFound', 'pt');
+        expect(result).toBe('Project not found. Run init_project first');
+    });
+    it('should not fallback when current locale is en and key is missing', () => {
+        const result = t('missing.key');
+        // en is already the fallback, so returns the key
+        expect(result).toBe('missing.key');
+    });
+    it('should handle deeply nested keys', () => {
+        const result = t('nested.deep.value');
+        expect(result).toBe('Deep nested value');
+    });
+    it('should stringify array values', () => {
+        const result = t('arrayValue');
+        expect(result).toBe('1,2,3');
+    });
+    it('should cache messages after first load', () => {
+        t('spec.created');
+        t('spec.notFound');
+        // readFileSync should be called for en.json only once (messages dir check + locale load)
+        // The exact count depends on the messagesDir detection but caching should prevent re-reads
+        const enCalls = mockedReadFileSync.mock.calls.filter((call) => String(call[0]).includes('en.json'));
+        // At most 2: one for messagesDir() check and one for loadMessages()
+        expect(enCalls.length).toBeLessThanOrEqual(2);
+    });
+});
+// =============================================================================
+// ti (translate with interpolation)
+// =============================================================================
+describe('ti', () => {
+    it('should replace single placeholder', () => {
+        const result = ti('spec.created', { id: 'SPEC-001' });
+        expect(result).toBe('Spec SPEC-001 created successfully');
+    });
+    it('should replace multiple placeholders', () => {
+        const result = ti('project.initialized', {
+            language: 'TypeScript',
+            framework: 'Next.js',
+        });
+        expect(result).toBe('Project initialized: TypeScript / Next.js detected');
+    });
+    it('should handle numeric values', () => {
+        const result = ti('locale.changed', { locale: 'es' });
+        expect(result).toBe('Locale changed to es');
+    });
+    it('should handle number type params', () => {
+        // Use a key that has a placeholder and pass a number
+        const result = ti('spec.created', { id: 42 });
+        expect(result).toBe('Spec 42 created successfully');
+    });
+    it('should work with locale override', () => {
+        const result = ti('spec.created', { id: 'SPEC-002' }, 'es');
+        expect(result).toBe('Spec SPEC-002 creada exitosamente');
+    });
+    it('should fallback to en when interpolating missing locale key', () => {
+        setLocale('pt');
+        const result = ti('project.initialized', {
+            language: 'Python',
+            framework: 'Django',
+        });
+        // pt does not have project.initialized, falls back to en
+        expect(result).toBe('Project initialized: Python / Django detected');
+    });
+    it('should return key with unreplaced placeholders for unknown keys', () => {
+        const result = ti('unknown.key', { foo: 'bar' });
+        expect(result).toBe('unknown.key');
+    });
+    it('should leave unreferenced placeholders unchanged', () => {
+        const result = ti('spec.created', {});
+        // No id param provided, so {id} stays
+        expect(result).toBe('Spec {id} created successfully');
+    });
+    it('should replace all occurrences of a placeholder', () => {
+        // spec.notFound only has {id} once, but let's test with a message that could have duplicates
+        const result = ti('spec.notFound', { id: 'SPEC-X' });
+        expect(result).toBe('Spec SPEC-X not found');
+    });
+});
+// =============================================================================
+// Edge cases: file loading failures
+// =============================================================================
+describe('message loading failures', () => {
+    it('should return empty messages when locale file fails to load', async () => {
+        vi.resetModules();
+        vi.resetAllMocks();
+        mockedReadFileSync.mockImplementation(() => {
+            throw new Error('File not found');
+        });
+        const mod = await import('./index.js');
+        // All locales fail to load - should return the key itself
+        const result = mod.t('spec.created');
+        expect(result).toBe('spec.created');
+    });
+    it('should use distFallback path when srcPath fails', async () => {
+        vi.resetModules();
+        vi.resetAllMocks();
+        let callCount = 0;
+        mockedReadFileSync.mockImplementation((pathArg) => {
+            const path = String(pathArg);
+            callCount++;
+            // First call is the messagesDir existence check - make it fail
+            if (callCount === 1 && path.includes('messages')) {
+                throw new Error('Not found in src');
+            }
+            // Subsequent calls (from dist fallback) should work
+            if (path.includes('en.json')) {
+                return JSON.stringify(EN_MESSAGES);
+            }
+            if (path.includes('es.json')) {
+                return JSON.stringify(ES_MESSAGES);
+            }
+            throw new Error('File not found');
+        });
+        const mod = await import('./index.js');
+        // This should still work because it falls back to the dist path
+        const result = mod.t('spec.created');
+        // Either the key (if fallback also failed) or the translation
+        expect(typeof result).toBe('string');
+    });
+    it('should cache empty messages for failed locale', async () => {
+        vi.resetModules();
+        vi.resetAllMocks();
+        mockedReadFileSync.mockImplementation((pathArg) => {
+            const path = String(pathArg);
+            if (path.includes('en.json')) {
+                return JSON.stringify(EN_MESSAGES);
+            }
+            throw new Error('File not found');
+        });
+        const mod = await import('./index.js');
+        mod.setLocale('es');
+        // First call: loads (and fails), caches empty
+        const r1 = mod.t('spec.created');
+        // Should fall back to en
+        expect(r1).toBe('Spec {id} created successfully');
+        // Second call: uses cache
+        const r2 = mod.t('spec.notFound');
+        expect(r2).toBe('Spec {id} not found');
+    });
+});
+// =============================================================================
+// Module state isolation
+// =============================================================================
+describe('module state', () => {
+    it('should reset to en default when module re-imported', async () => {
+        setLocale('es');
+        expect(getLocale()).toBe('es');
+        // Re-import resets the module
+        vi.resetModules();
+        mockedReadFileSync.mockImplementation((pathArg) => {
+            const path = String(pathArg);
+            if (path.includes('en.json')) {
+                return JSON.stringify(EN_MESSAGES);
+            }
+            if (path.includes('es.json')) {
+                return JSON.stringify(ES_MESSAGES);
+            }
+            if (path.includes('pt.json')) {
+                return JSON.stringify(PT_MESSAGES);
+            }
+            throw new Error('File not found');
+        });
+        const freshMod = await import('./index.js');
+        expect(freshMod.getLocale()).toBe('en');
+    });
+});
+//# sourceMappingURL=index.test.js.map