@arcadialdev/arcality 4.1.0 → 4.1.2

package/src/services/generationContext.mjs

@@ -1,242 +1,242 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-function asTrimmedString(value) {
-    if (typeof value !== 'string') return null;
-    const trimmed = value.trim();
-    return trimmed || null;
-}
-
-function asStringList(value) {
-    if (!Array.isArray(value)) return [];
-    return value.map(asTrimmedString).filter(Boolean);
-}
-
-function normalizeRuleText(value) {
-    return String(value || '')
-        .replace(/^[-*+]\s+/, '')
-        .replace(/^\d+\.\s+/, '')
-        .trim();
-}
-
-function tokenize(value) {
-    return String(value || '')
-        .toLowerCase()
-        .split(/[^a-z0-9áéíóúñ]+/i)
-        .map(token => token.trim())
-        .filter(token => token.length >= 3);
-}
-
-function stripComments(content) {
-    return String(content || '').replace(/<!--[\s\S]*?-->/g, '');
-}
-
-function parseQaContext(projectRoot) {
-    const filePath = path.join(projectRoot, '.arcality', 'qa-context.md');
-    const metaPath = path.join(projectRoot, '.arcality', 'qa-context.meta.json');
-    const result = {
-        exists: false,
-        filePath,
-        status: 'missing',
-        warnings: [],
-        rules: [],
-        tags: [],
-        governance: {
-            exists: false,
-            version: null,
-            updatedBy: null,
-            ownerTeam: null,
-            changeSummary: null
-        }
-    };
-
-    if (fs.existsSync(metaPath)) {
-        try {
-            const parsed = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
-            result.governance = {
-                exists: true,
-                version: asTrimmedString(parsed?.version),
-                updatedBy: asTrimmedString(parsed?.updated_by ?? parsed?.updatedBy),
-                ownerTeam: asTrimmedString(parsed?.owner_team ?? parsed?.ownerTeam),
-                changeSummary: asTrimmedString(parsed?.change_summary ?? parsed?.changeSummary)
-            };
-            result.tags = asStringList(parsed?.tags);
-        } catch {
-            result.warnings.push('qa-context.meta.json no se pudo parsear para generation guidance.');
-        }
-    }
-
-    if (!fs.existsSync(filePath)) {
-        return result;
-    }
-
-    result.exists = true;
-    const raw = stripComments(fs.readFileSync(filePath, 'utf8'));
-    const lines = raw.split(/\r?\n/);
-    let currentSection = 'General';
-    const seen = new Set();
-
-    for (const rawLine of lines) {
-        const line = rawLine.trim();
-        if (!line) continue;
-        if (/^##\s+/.test(line)) {
-            currentSection = line.replace(/^##\s+/, '').trim() || 'General';
-            continue;
-        }
-        if (!/^[-*+]\s+/.test(line) && !/^\d+\.\s+/.test(line)) continue;
-        const rule = normalizeRuleText(line);
-        if (!rule) continue;
-        const dedupeKey = rule.toLowerCase();
-        if (seen.has(dedupeKey)) continue;
-        seen.add(dedupeKey);
-        result.rules.push({
-            section: currentSection,
-            text: rule,
-            tokens: tokenize(rule)
-        });
-    }
-
-    result.status = result.rules.length > 0 ? 'ready' : 'empty';
-    if (result.exists && !result.governance.exists) {
-        result.warnings.push('QA context existe pero no tiene metadata de gobernanza.');
-    }
-    if (result.exists && result.rules.length === 0) {
-        result.warnings.push('QA context sin reglas accionables.');
-    }
-
-    return result;
-}
-
-function parseFeasibilityDoc(projectRoot) {
-    const filePath = path.join(projectRoot, 'BUGSTER_FEATURE_FEASIBILITY.md');
-    const result = {
-        exists: false,
-        filePath,
-        warnings: [],
-        globalHints: [],
-        routeHints: {
-            dynamic: [],
-            checkout: [],
-            form: [],
-            auth: [],
-            list: []
-        }
-    };
-
-    if (!fs.existsSync(filePath)) {
-        return result;
-    }
-
-    result.exists = true;
-    const raw = fs.readFileSync(filePath, 'utf8');
-    const lower = raw.toLowerCase();
-
-    if (lower.includes('pocos escenarios observables y accionables')) {
-        result.globalHints.push('Prioriza escenarios observables y accionables sobre cobertura generica.');
-    }
-    if (lower.includes('rutas dinamicas necesitan ejemplos de parametros')) {
-        result.routeHints.dynamic.push('Si la ruta es dinamica, valida contexto del registro y considera necesidad de parametros de ejemplo.');
-    }
-    if (lower.includes('focus on validation and payment edge cases') || lower.includes('payment edge cases')) {
-        result.routeHints.checkout.push('Enfatiza validaciones y edge cases de pago sin ejecutar cobros reales.');
-    }
-    if (lower.includes('validaciones visibles') || lower.includes('formularios')) {
-        result.routeHints.form.push('Prioriza validaciones visibles, mensajes de error y reglas de captura observables.');
-    }
-    if (lower.includes('autenticacion') || lower.includes('auth')) {
-        result.routeHints.auth.push('Valida autenticacion con feedback observable y estados de acceso consistentes.');
-    }
-    if (lower.includes('filtros') || lower.includes('busqueda') || lower.includes('listado')) {
-        result.routeHints.list.push('Valida exploracion de datos mediante listados, filtros y busqueda cuando aplique.');
-    }
-
-    if (result.globalHints.length === 0) {
-        result.globalHints.push('Prioriza escenarios observables y accionables sobre cobertura generica.');
-    }
-
-    return result;
-}
-
-function buildRouteKeywords(routeEntry) {
-    return Array.from(new Set([
-        ...tokenize(routeEntry.route),
-        ...tokenize(routeEntry.pagePath),
-        ...(routeEntry.tags || []).flatMap(tokenize),
-        ...((routeEntry.signals?.keywords) || []).flatMap(tokenize)
-    ]));
-}
-
-function collectThemeKeywords(routeEntry) {
-    const signals = routeEntry.signals || {};
-    const routeKeywords = buildRouteKeywords(routeEntry);
-    const themes = new Set(routeKeywords);
-
-    if (signals.hasAuth) ['login', 'auth', 'password', 'session', 'acceso'].forEach(value => themes.add(value));
-    if (signals.hasCheckout) ['checkout', 'payment', 'billing', 'pago', 'card'].forEach(value => themes.add(value));
-    if (signals.hasForm || signals.isCrudLike) ['form', 'formulario', 'validacion', 'guardar', 'campo'].forEach(value => themes.add(value));
-    if (signals.isListLike) ['list', 'listado', 'tabla', 'busqueda', 'filtro'].forEach(value => themes.add(value));
-    if (signals.hasSettings) ['settings', 'configuracion', 'preferencias'].forEach(value => themes.add(value));
-    if (signals.hasUpload) ['upload', 'archivo', 'imagen'].forEach(value => themes.add(value));
-    if (signals.isDynamicRoute) ['detalle', 'detail', 'registro', 'contexto'].forEach(value => themes.add(value));
-
-    return Array.from(themes);
-}
-
-function scoreRule(rule, routeKeywords) {
-    const tokens = rule.tokens || [];
-    let score = 0;
-    for (const token of tokens) {
-        if (routeKeywords.includes(token)) score += 2;
-    }
-
-    const lower = rule.text.toLowerCase();
-    if (/(nunca|siempre|obligatorio|critic|must|required|bloque)/i.test(lower)) score += 1;
-    return score;
-}
-
-function inferContextPriority(matchedRules = []) {
-    for (const rule of matchedRules) {
-        if (/(critic|obligatorio|nunca|must|required|seguridad|pago|payment|auth)/i.test(rule.text)) {
-            return 'high';
-        }
-    }
-    return null;
-}
-
-export function loadGenerationContext(projectRoot = process.cwd()) {
-    return {
-        qaContext: parseQaContext(projectRoot),
-        feasibility: parseFeasibilityDoc(projectRoot)
-    };
-}
-
-export function resolveRouteGuidance(routeEntry, generationContext = {}) {
-    const qaContext = generationContext.qaContext || { exists: false, rules: [], tags: [], warnings: [] };
-    const feasibility = generationContext.feasibility || { exists: false, globalHints: [], routeHints: {} };
-    const routeKeywords = collectThemeKeywords(routeEntry);
-
-    const matchedRules = (qaContext.rules || [])
-        .map(rule => ({ ...rule, score: scoreRule(rule, routeKeywords) }))
-        .filter(rule => rule.score > 0)
-        .sort((a, b) => b.score - a.score)
-        .slice(0, 3);
-
-    const feasibilityHints = [...(feasibility.globalHints || [])];
-    const signals = routeEntry.signals || {};
-    if (signals.isDynamicRoute) feasibilityHints.push(...(feasibility.routeHints?.dynamic || []));
-    if (signals.hasCheckout) feasibilityHints.push(...(feasibility.routeHints?.checkout || []));
-    if (signals.hasForm || signals.isCrudLike) feasibilityHints.push(...(feasibility.routeHints?.form || []));
-    if (signals.hasAuth) feasibilityHints.push(...(feasibility.routeHints?.auth || []));
-    if (signals.isListLike) feasibilityHints.push(...(feasibility.routeHints?.list || []));
-
-    return {
-        matchedRules,
-        feasibilityHints: Array.from(new Set(feasibilityHints)).slice(0, 3),
-        priorityOverride: inferContextPriority(matchedRules),
-        extraTags: Array.from(new Set(qaContext.tags || [])).slice(0, 4),
-        contextStatus: {
-            qaContext: qaContext.exists ? qaContext.status : 'missing',
-            feasibility: feasibility.exists ? 'loaded' : 'missing'
-        }
-    };
-}
+import fs from 'node:fs';
+import path from 'node:path';
+
+function asTrimmedString(value) {
+    if (typeof value !== 'string') return null;
+    const trimmed = value.trim();
+    return trimmed || null;
+}
+
+function asStringList(value) {
+    if (!Array.isArray(value)) return [];
+    return value.map(asTrimmedString).filter(Boolean);
+}
+
+function normalizeRuleText(value) {
+    return String(value || '')
+        .replace(/^[-*+]\s+/, '')
+        .replace(/^\d+\.\s+/, '')
+        .trim();
+}
+
+function tokenize(value) {
+    return String(value || '')
+        .toLowerCase()
+        .split(/[^a-z0-9áéíóúñ]+/i)
+        .map(token => token.trim())
+        .filter(token => token.length >= 3);
+}
+
+function stripComments(content) {
+    return String(content || '').replace(/<!--[\s\S]*?-->/g, '');
+}
+
+function parseQaContext(projectRoot) {
+    const filePath = path.join(projectRoot, '.arcality', 'qa-context.md');
+    const metaPath = path.join(projectRoot, '.arcality', 'qa-context.meta.json');
+    const result = {
+        exists: false,
+        filePath,
+        status: 'missing',
+        warnings: [],
+        rules: [],
+        tags: [],
+        governance: {
+            exists: false,
+            version: null,
+            updatedBy: null,
+            ownerTeam: null,
+            changeSummary: null
+        }
+    };
+
+    if (fs.existsSync(metaPath)) {
+        try {
+            const parsed = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+            result.governance = {
+                exists: true,
+                version: asTrimmedString(parsed?.version),
+                updatedBy: asTrimmedString(parsed?.updated_by ?? parsed?.updatedBy),
+                ownerTeam: asTrimmedString(parsed?.owner_team ?? parsed?.ownerTeam),
+                changeSummary: asTrimmedString(parsed?.change_summary ?? parsed?.changeSummary)
+            };
+            result.tags = asStringList(parsed?.tags);
+        } catch {
+            result.warnings.push('qa-context.meta.json no se pudo parsear para generation guidance.');
+        }
+    }
+
+    if (!fs.existsSync(filePath)) {
+        return result;
+    }
+
+    result.exists = true;
+    const raw = stripComments(fs.readFileSync(filePath, 'utf8'));
+    const lines = raw.split(/\r?\n/);
+    let currentSection = 'General';
+    const seen = new Set();
+
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line) continue;
+        if (/^##\s+/.test(line)) {
+            currentSection = line.replace(/^##\s+/, '').trim() || 'General';
+            continue;
+        }
+        if (!/^[-*+]\s+/.test(line) && !/^\d+\.\s+/.test(line)) continue;
+        const rule = normalizeRuleText(line);
+        if (!rule) continue;
+        const dedupeKey = rule.toLowerCase();
+        if (seen.has(dedupeKey)) continue;
+        seen.add(dedupeKey);
+        result.rules.push({
+            section: currentSection,
+            text: rule,
+            tokens: tokenize(rule)
+        });
+    }
+
+    result.status = result.rules.length > 0 ? 'ready' : 'empty';
+    if (result.exists && !result.governance.exists) {
+        result.warnings.push('QA context existe pero no tiene metadata de gobernanza.');
+    }
+    if (result.exists && result.rules.length === 0) {
+        result.warnings.push('QA context sin reglas accionables.');
+    }
+
+    return result;
+}
+
+function parseFeasibilityDoc(projectRoot) {
+    const filePath = path.join(projectRoot, 'BUGSTER_FEATURE_FEASIBILITY.md');
+    const result = {
+        exists: false,
+        filePath,
+        warnings: [],
+        globalHints: [],
+        routeHints: {
+            dynamic: [],
+            checkout: [],
+            form: [],
+            auth: [],
+            list: []
+        }
+    };
+
+    if (!fs.existsSync(filePath)) {
+        return result;
+    }
+
+    result.exists = true;
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const lower = raw.toLowerCase();
+
+    if (lower.includes('pocos escenarios observables y accionables')) {
+        result.globalHints.push('Prioriza escenarios observables y accionables sobre cobertura generica.');
+    }
+    if (lower.includes('rutas dinamicas necesitan ejemplos de parametros')) {
+        result.routeHints.dynamic.push('Si la ruta es dinamica, valida contexto del registro y considera necesidad de parametros de ejemplo.');
+    }
+    if (lower.includes('focus on validation and payment edge cases') || lower.includes('payment edge cases')) {
+        result.routeHints.checkout.push('Enfatiza validaciones y edge cases de pago sin ejecutar cobros reales.');
+    }
+    if (lower.includes('validaciones visibles') || lower.includes('formularios')) {
+        result.routeHints.form.push('Prioriza validaciones visibles, mensajes de error y reglas de captura observables.');
+    }
+    if (lower.includes('autenticacion') || lower.includes('auth')) {
+        result.routeHints.auth.push('Valida autenticacion con feedback observable y estados de acceso consistentes.');
+    }
+    if (lower.includes('filtros') || lower.includes('busqueda') || lower.includes('listado')) {
+        result.routeHints.list.push('Valida exploracion de datos mediante listados, filtros y busqueda cuando aplique.');
+    }
+
+    if (result.globalHints.length === 0) {
+        result.globalHints.push('Prioriza escenarios observables y accionables sobre cobertura generica.');
+    }
+
+    return result;
+}
+
+function buildRouteKeywords(routeEntry) {
+    return Array.from(new Set([
+        ...tokenize(routeEntry.route),
+        ...tokenize(routeEntry.pagePath),
+        ...(routeEntry.tags || []).flatMap(tokenize),
+        ...((routeEntry.signals?.keywords) || []).flatMap(tokenize)
+    ]));
+}
+
+function collectThemeKeywords(routeEntry) {
+    const signals = routeEntry.signals || {};
+    const routeKeywords = buildRouteKeywords(routeEntry);
+    const themes = new Set(routeKeywords);
+
+    if (signals.hasAuth) ['login', 'auth', 'password', 'session', 'acceso'].forEach(value => themes.add(value));
+    if (signals.hasCheckout) ['checkout', 'payment', 'billing', 'pago', 'card'].forEach(value => themes.add(value));
+    if (signals.hasForm || signals.isCrudLike) ['form', 'formulario', 'validacion', 'guardar', 'campo'].forEach(value => themes.add(value));
+    if (signals.isListLike) ['list', 'listado', 'tabla', 'busqueda', 'filtro'].forEach(value => themes.add(value));
+    if (signals.hasSettings) ['settings', 'configuracion', 'preferencias'].forEach(value => themes.add(value));
+    if (signals.hasUpload) ['upload', 'archivo', 'imagen'].forEach(value => themes.add(value));
+    if (signals.isDynamicRoute) ['detalle', 'detail', 'registro', 'contexto'].forEach(value => themes.add(value));
+
+    return Array.from(themes);
+}
+
+function scoreRule(rule, routeKeywords) {
+    const tokens = rule.tokens || [];
+    let score = 0;
+    for (const token of tokens) {
+        if (routeKeywords.includes(token)) score += 2;
+    }
+
+    const lower = rule.text.toLowerCase();
+    if (/(nunca|siempre|obligatorio|critic|must|required|bloque)/i.test(lower)) score += 1;
+    return score;
+}
+
+function inferContextPriority(matchedRules = []) {
+    for (const rule of matchedRules) {
+        if (/(critic|obligatorio|nunca|must|required|seguridad|pago|payment|auth)/i.test(rule.text)) {
+            return 'high';
+        }
+    }
+    return null;
+}
+
+export function loadGenerationContext(projectRoot = process.cwd()) {
+    return {
+        qaContext: parseQaContext(projectRoot),
+        feasibility: parseFeasibilityDoc(projectRoot)
+    };
+}
+
+export function resolveRouteGuidance(routeEntry, generationContext = {}) {
+    const qaContext = generationContext.qaContext || { exists: false, rules: [], tags: [], warnings: [] };
+    const feasibility = generationContext.feasibility || { exists: false, globalHints: [], routeHints: {} };
+    const routeKeywords = collectThemeKeywords(routeEntry);
+
+    const matchedRules = (qaContext.rules || [])
+        .map(rule => ({ ...rule, score: scoreRule(rule, routeKeywords) }))
+        .filter(rule => rule.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3);
+
+    const feasibilityHints = [...(feasibility.globalHints || [])];
+    const signals = routeEntry.signals || {};
+    if (signals.isDynamicRoute) feasibilityHints.push(...(feasibility.routeHints?.dynamic || []));
+    if (signals.hasCheckout) feasibilityHints.push(...(feasibility.routeHints?.checkout || []));
+    if (signals.hasForm || signals.isCrudLike) feasibilityHints.push(...(feasibility.routeHints?.form || []));
+    if (signals.hasAuth) feasibilityHints.push(...(feasibility.routeHints?.auth || []));
+    if (signals.isListLike) feasibilityHints.push(...(feasibility.routeHints?.list || []));
+
+    return {
+        matchedRules,
+        feasibilityHints: Array.from(new Set(feasibilityHints)).slice(0, 3),
+        priorityOverride: inferContextPriority(matchedRules),
+        extraTags: Array.from(new Set(qaContext.tags || [])).slice(0, 4),
+        contextStatus: {
+            qaContext: qaContext.exists ? qaContext.status : 'missing',
+            feasibility: feasibility.exists ? 'loaded' : 'missing'
+        }
+    };
+}