@arcadialdev/arcality 4.1.0 → 4.1.2

package/scripts/generate.mjs

@@ -1,236 +1,236 @@
-#!/usr/bin/env node
-import path from 'node:path';
-import { analyzeCodebase } from '../src/services/codebaseAnalyzer.mjs';
-import { loadProjectConfig, getYamlOutputDir } from '../src/configManager.mjs';
-import { generateMissionsForRoute } from '../src/services/missionGenerator.mjs';
-import { saveGeneratedMissions } from '../src/services/generatedMissionStore.mjs';
-import { loadGenerationContext, resolveRouteGuidance } from '../src/services/generationContext.mjs';
-
-function parseArgs(rawArgs) {
-    const options = {
-        count: null,
-        page: [],
-        prompt: '',
-        dryRun: false,
-        outputDir: null,
-        debug: false
-    };
-
-    for (let i = 0; i < rawArgs.length; i++) {
-        const token = rawArgs[i];
-        if (token === '--dry-run') {
-            options.dryRun = true;
-            continue;
-        }
-        if (token === '--debug') {
-            options.debug = true;
-            continue;
-        }
-        if (token.startsWith('--count=')) {
-            options.count = Number(token.split('=').slice(1).join('='));
-            continue;
-        }
-        if (token === '--count' && rawArgs[i + 1]) {
-            options.count = Number(rawArgs[i + 1]);
-            i += 1;
-            continue;
-        }
-        if (token.startsWith('--page=')) {
-            options.page = token.split('=').slice(1).join('=').split(',').map(v => v.trim()).filter(Boolean);
-            continue;
-        }
-        if (token === '--page' && rawArgs[i + 1]) {
-            options.page = rawArgs[i + 1].split(',').map(v => v.trim()).filter(Boolean);
-            i += 1;
-            continue;
-        }
-        if (token.startsWith('--prompt=')) {
-            options.prompt = token.split('=').slice(1).join('=').trim();
-            continue;
-        }
-        if (token === '--prompt' && rawArgs[i + 1]) {
-            options.prompt = rawArgs[i + 1].trim();
-            i += 1;
-            continue;
-        }
-        if (token.startsWith('--output-dir=')) {
-            options.outputDir = token.split('=').slice(1).join('=').trim();
-            continue;
-        }
-        if (token === '--output-dir' && rawArgs[i + 1]) {
-            options.outputDir = rawArgs[i + 1].trim();
-            i += 1;
-            continue;
-        }
-    }
-
-    return options;
-}
-
-function matchesPageFilters(routeEntry, filters) {
-    if (!filters || filters.length === 0) return true;
-    const haystacks = [
-        routeEntry.pagePath.toLowerCase(),
-        routeEntry.route.toLowerCase()
-    ];
-    return filters.some(filter => {
-        const normalized = filter.toLowerCase();
-        return haystacks.some(value => value === normalized || value.includes(normalized));
-    });
-}
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-
-function isLikelyUuidFilter(filter) {
-    return UUID_RE.test(String(filter || '').trim());
-}
-
-function formatRouteExamples(routes, maxItems = 3) {
-    return routes
-        .slice(0, maxItems)
-        .map(entry => `${entry.route} -> ${entry.pagePath}`)
-        .join('\n- ');
-}
-
-
-function limitEntries(entries, count) {
-    if (!Number.isFinite(count) || count <= 0) return entries;
-    return entries.slice(0, Math.floor(count));
-}
-
-function limitMissions(missions, count) {
-    if (!Number.isFinite(count) || count <= 0) return missions;
-    return missions.slice(0, Math.floor(count));
-}
-
-function printSummary(analysis, selectedRoutes, options, generationContext) {
-    console.log('\nArcality Generate - Discovery Summary');
-    console.log(`Project: ${analysis.projectName}`);
-    console.log(`Framework: ${analysis.framework}`);
-    console.log(`Routes detected: ${analysis.routeCount}`);
-    console.log(`Routes selected: ${selectedRoutes.length}`);
-    console.log(`Mission cap: ${Number.isFinite(options.count) && options.count > 0 ? Math.floor(options.count) : 'auto'}`);
-    console.log(`Output target: ${options.outputTarget}`);
-    console.log(`Mode: ${options.dryRun ? 'dry-run' : 'write-yaml'}`);
-    console.log(`QA context: ${generationContext.qaContext.exists ? generationContext.qaContext.status : 'missing'}`);
-    console.log(`Feasibility guidance: ${generationContext.feasibility.exists ? 'loaded' : 'missing'}`);
-
-    if (options.prompt) {
-        console.log(`Prompt focus: ${options.prompt}`);
-    }
-
-    if (analysis.warnings.length > 0) {
-        console.log('\nWarnings:');
-        for (const warning of analysis.warnings) {
-            console.log(`- ${warning}`);
-        }
-    }
-
-    if (selectedRoutes.length === 0) {
-        console.log('\nNo candidate routes matched the provided filters.');
-        const uuidFilters = (options.page || []).filter(isLikelyUuidFilter);
-        if (uuidFilters.length > 0) {
-            console.log('Tip: the current --page filter only matches route fragments or page file paths, not backend page IDs or UUIDs.');
-        }
-        if ((options.page || []).length > 0 && analysis.routes.length > 0) {
-            console.log('Try values such as a route (`/checkout`) or a page path fragment (`app/checkout/page.tsx`).');
-            console.log(`Examples:\n- ${formatRouteExamples(analysis.routes)}`);
-        }
-        return;
-    }
-
-    console.log('\nCandidate routes:');
-    selectedRoutes.forEach((entry, index) => {
-        const guidance = resolveRouteGuidance(entry, generationContext);
-        console.log(`${index + 1}. ${entry.route} -> ${entry.pagePath} [${entry.routerKind}]`);
-        if (options.debug) {
-            console.log(`   name: ${entry.name}`);
-            console.log(`   tags: ${entry.tags.join(', ')}`);
-            console.log(`   signals: ${Object.entries(entry.signals || {}).filter(([, value]) => value === true).map(([key]) => key).join(', ') || 'none'}`);
-            console.log(`   route_params: ${(entry.routeParams || []).map(param => `${param.name}:${param.kind}`).join(', ') || 'none'}`);
-            console.log(`   route_example: ${entry.routeExamplePath || entry.route}`);
-            console.log(`   matched_rules: ${guidance.matchedRules.map(rule => rule.text).join(' | ') || 'none'}`);
-            console.log(`   feasibility_hints: ${guidance.feasibilityHints.join(' | ') || 'none'}`);
-            console.log(`   expected_result: ${entry.expectedResult}`);
-        }
-    });
-}
-
-function printPhaseNotice(options) {
-    if (options.dryRun) {
-        console.log('\nNo files were written because --dry-run is active.');
-        return;
-    }
-}
-
-function printWriteSummary(summary, options) {
-    console.log('\nGeneration result:');
-    console.log(`- Requested missions: ${summary.total_requested}`);
-    console.log(`- Created: ${summary.created_count}`);
-    console.log(`- Skipped: ${summary.skipped_count}`);
-
-    if (summary.created.length > 0) {
-        console.log('\nCreated files:');
-        for (const item of summary.created) {
-            console.log(`- ${item.filePath}`);
-        }
-    }
-
-    if (summary.skipped.length > 0 && options.debug) {
-        console.log('\nSkipped entries:');
-        for (const item of summary.skipped) {
-            console.log(`- ${item.name} (${item.page_path}) -> ${item.reason}`);
-        }
-    }
-}
-
-function resolveOutputTarget(projectRoot, explicitOutputDir) {
-    if (explicitOutputDir) {
-        return path.resolve(projectRoot, explicitOutputDir);
-    }
-
-    const config = loadProjectConfig(projectRoot);
-    if (config) {
-        return path.join(getYamlOutputDir(config, projectRoot), 'generated');
-    }
-
-    return path.join(projectRoot, '.arcality', 'generated');
-}
-
-async function main() {
-    const args = process.argv.slice(2);
-    const options = parseArgs(args);
-    const projectRoot = process.cwd();
-    options.outputTarget = resolveOutputTarget(projectRoot, options.outputDir);
-    const projectConfig = loadProjectConfig(projectRoot);
-
-    const analysis = analyzeCodebase(projectRoot, {
-        baseUrl: projectConfig?.project?.baseUrl || ''
-    });
-    const generationContext = loadGenerationContext(projectRoot);
-    const filtered = analysis.routes.filter(route => matchesPageFilters(route, options.page));
-    const selectedRoutes = limitEntries(filtered, options.page.length > 0 ? null : Math.max(filtered.length, 1));
-
-    printSummary(analysis, selectedRoutes, options, generationContext);
-
-    const missions = limitMissions(
-        selectedRoutes.flatMap(route => generateMissionsForRoute(route, {
-            ...options,
-            routeGuidance: resolveRouteGuidance(route, generationContext)
-        })),
-        options.count
-    );
-    const summary = saveGeneratedMissions({
-        projectRoot,
-        targetDir: options.outputTarget,
-        missions,
-        dryRun: options.dryRun
-    });
-
-    printWriteSummary(summary, options);
-    printPhaseNotice(options);
-}
-
-main().catch(err => {
-    console.error(`\n[generate] ${err.message}`);
-    process.exit(1);
-});
+#!/usr/bin/env node
+import path from 'node:path';
+import { analyzeCodebase } from '../src/services/codebaseAnalyzer.mjs';
+import { loadProjectConfig, getYamlOutputDir } from '../src/configManager.mjs';
+import { generateMissionsForRoute } from '../src/services/missionGenerator.mjs';
+import { saveGeneratedMissions } from '../src/services/generatedMissionStore.mjs';
+import { loadGenerationContext, resolveRouteGuidance } from '../src/services/generationContext.mjs';
+
+function parseArgs(rawArgs) {
+    const options = {
+        count: null,
+        page: [],
+        prompt: '',
+        dryRun: false,
+        outputDir: null,
+        debug: false
+    };
+
+    for (let i = 0; i < rawArgs.length; i++) {
+        const token = rawArgs[i];
+        if (token === '--dry-run') {
+            options.dryRun = true;
+            continue;
+        }
+        if (token === '--debug') {
+            options.debug = true;
+            continue;
+        }
+        if (token.startsWith('--count=')) {
+            options.count = Number(token.split('=').slice(1).join('='));
+            continue;
+        }
+        if (token === '--count' && rawArgs[i + 1]) {
+            options.count = Number(rawArgs[i + 1]);
+            i += 1;
+            continue;
+        }
+        if (token.startsWith('--page=')) {
+            options.page = token.split('=').slice(1).join('=').split(',').map(v => v.trim()).filter(Boolean);
+            continue;
+        }
+        if (token === '--page' && rawArgs[i + 1]) {
+            options.page = rawArgs[i + 1].split(',').map(v => v.trim()).filter(Boolean);
+            i += 1;
+            continue;
+        }
+        if (token.startsWith('--prompt=')) {
+            options.prompt = token.split('=').slice(1).join('=').trim();
+            continue;
+        }
+        if (token === '--prompt' && rawArgs[i + 1]) {
+            options.prompt = rawArgs[i + 1].trim();
+            i += 1;
+            continue;
+        }
+        if (token.startsWith('--output-dir=')) {
+            options.outputDir = token.split('=').slice(1).join('=').trim();
+            continue;
+        }
+        if (token === '--output-dir' && rawArgs[i + 1]) {
+            options.outputDir = rawArgs[i + 1].trim();
+            i += 1;
+            continue;
+        }
+    }
+
+    return options;
+}
+
+function matchesPageFilters(routeEntry, filters) {
+    if (!filters || filters.length === 0) return true;
+    const haystacks = [
+        routeEntry.pagePath.toLowerCase(),
+        routeEntry.route.toLowerCase()
+    ];
+    return filters.some(filter => {
+        const normalized = filter.toLowerCase();
+        return haystacks.some(value => value === normalized || value.includes(normalized));
+    });
+}
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+function isLikelyUuidFilter(filter) {
+    return UUID_RE.test(String(filter || '').trim());
+}
+
+function formatRouteExamples(routes, maxItems = 3) {
+    return routes
+        .slice(0, maxItems)
+        .map(entry => `${entry.route} -> ${entry.pagePath}`)
+        .join('\n- ');
+}
+
+
+function limitEntries(entries, count) {
+    if (!Number.isFinite(count) || count <= 0) return entries;
+    return entries.slice(0, Math.floor(count));
+}
+
+function limitMissions(missions, count) {
+    if (!Number.isFinite(count) || count <= 0) return missions;
+    return missions.slice(0, Math.floor(count));
+}
+
+function printSummary(analysis, selectedRoutes, options, generationContext) {
+    console.log('\nArcality Generate - Discovery Summary');
+    console.log(`Project: ${analysis.projectName}`);
+    console.log(`Framework: ${analysis.framework}`);
+    console.log(`Routes detected: ${analysis.routeCount}`);
+    console.log(`Routes selected: ${selectedRoutes.length}`);
+    console.log(`Mission cap: ${Number.isFinite(options.count) && options.count > 0 ? Math.floor(options.count) : 'auto'}`);
+    console.log(`Output target: ${options.outputTarget}`);
+    console.log(`Mode: ${options.dryRun ? 'dry-run' : 'write-yaml'}`);
+    console.log(`QA context: ${generationContext.qaContext.exists ? generationContext.qaContext.status : 'missing'}`);
+    console.log(`Feasibility guidance: ${generationContext.feasibility.exists ? 'loaded' : 'missing'}`);
+
+    if (options.prompt) {
+        console.log(`Prompt focus: ${options.prompt}`);
+    }
+
+    if (analysis.warnings.length > 0) {
+        console.log('\nWarnings:');
+        for (const warning of analysis.warnings) {
+            console.log(`- ${warning}`);
+        }
+    }
+
+    if (selectedRoutes.length === 0) {
+        console.log('\nNo candidate routes matched the provided filters.');
+        const uuidFilters = (options.page || []).filter(isLikelyUuidFilter);
+        if (uuidFilters.length > 0) {
+            console.log('Tip: the current --page filter only matches route fragments or page file paths, not backend page IDs or UUIDs.');
+        }
+        if ((options.page || []).length > 0 && analysis.routes.length > 0) {
+            console.log('Try values such as a route (`/checkout`) or a page path fragment (`app/checkout/page.tsx`).');
+            console.log(`Examples:\n- ${formatRouteExamples(analysis.routes)}`);
+        }
+        return;
+    }
+
+    console.log('\nCandidate routes:');
+    selectedRoutes.forEach((entry, index) => {
+        const guidance = resolveRouteGuidance(entry, generationContext);
+        console.log(`${index + 1}. ${entry.route} -> ${entry.pagePath} [${entry.routerKind}]`);
+        if (options.debug) {
+            console.log(`   name: ${entry.name}`);
+            console.log(`   tags: ${entry.tags.join(', ')}`);
+            console.log(`   signals: ${Object.entries(entry.signals || {}).filter(([, value]) => value === true).map(([key]) => key).join(', ') || 'none'}`);
+            console.log(`   route_params: ${(entry.routeParams || []).map(param => `${param.name}:${param.kind}`).join(', ') || 'none'}`);
+            console.log(`   route_example: ${entry.routeExamplePath || entry.route}`);
+            console.log(`   matched_rules: ${guidance.matchedRules.map(rule => rule.text).join(' | ') || 'none'}`);
+            console.log(`   feasibility_hints: ${guidance.feasibilityHints.join(' | ') || 'none'}`);
+            console.log(`   expected_result: ${entry.expectedResult}`);
+        }
+    });
+}
+
+function printPhaseNotice(options) {
+    if (options.dryRun) {
+        console.log('\nNo files were written because --dry-run is active.');
+        return;
+    }
+}
+
+function printWriteSummary(summary, options) {
+    console.log('\nGeneration result:');
+    console.log(`- Requested missions: ${summary.total_requested}`);
+    console.log(`- Created: ${summary.created_count}`);
+    console.log(`- Skipped: ${summary.skipped_count}`);
+
+    if (summary.created.length > 0) {
+        console.log('\nCreated files:');
+        for (const item of summary.created) {
+            console.log(`- ${item.filePath}`);
+        }
+    }
+
+    if (summary.skipped.length > 0 && options.debug) {
+        console.log('\nSkipped entries:');
+        for (const item of summary.skipped) {
+            console.log(`- ${item.name} (${item.page_path}) -> ${item.reason}`);
+        }
+    }
+}
+
+function resolveOutputTarget(projectRoot, explicitOutputDir) {
+    if (explicitOutputDir) {
+        return path.resolve(projectRoot, explicitOutputDir);
+    }
+
+    const config = loadProjectConfig(projectRoot);
+    if (config) {
+        return path.join(getYamlOutputDir(config, projectRoot), 'generated');
+    }
+
+    return path.join(projectRoot, '.arcality', 'generated');
+}
+
+async function main() {
+    const args = process.argv.slice(2);
+    const options = parseArgs(args);
+    const projectRoot = process.cwd();
+    options.outputTarget = resolveOutputTarget(projectRoot, options.outputDir);
+    const projectConfig = loadProjectConfig(projectRoot);
+
+    const analysis = analyzeCodebase(projectRoot, {
+        baseUrl: projectConfig?.project?.baseUrl || ''
+    });
+    const generationContext = loadGenerationContext(projectRoot);
+    const filtered = analysis.routes.filter(route => matchesPageFilters(route, options.page));
+    const selectedRoutes = limitEntries(filtered, options.page.length > 0 ? null : Math.max(filtered.length, 1));
+
+    printSummary(analysis, selectedRoutes, options, generationContext);
+
+    const missions = limitMissions(
+        selectedRoutes.flatMap(route => generateMissionsForRoute(route, {
+            ...options,
+            routeGuidance: resolveRouteGuidance(route, generationContext)
+        })),
+        options.count
+    );
+    const summary = saveGeneratedMissions({
+        projectRoot,
+        targetDir: options.outputTarget,
+        missions,
+        dryRun: options.dryRun
+    });
+
+    printWriteSummary(summary, options);
+    printPhaseNotice(options);
+}
+
+main().catch(err => {
+    console.error(`\n[generate] ${err.message}`);
+    process.exit(1);
+});

package/scripts/init.mjs

@@ -339,12 +339,12 @@ async function main() {
     }
 
     // ── Step 7: Custom QA Context ──
-    note(
-        chalk.white('El archivo ') + chalk.cyan('.arcality/qa-context.md') + chalk.white(' se inyecta al prompt del agente antes de cada misión.') + '\n' +
-        chalk.white('Úsalo para reglas del negocio, navegación especial y anti-patrones que Arcality deba respetar siempre.') + '\n' +
-        chalk.white('Complementa el archivo con ') + chalk.cyan('.arcality/qa-context.meta.json') + chalk.white(' para versionar responsables y cambios.'),
-        'QA Context Local'
-    );
+    note(
+        chalk.white('El archivo ') + chalk.cyan('.arcality/qa-context.md') + chalk.white(' se inyecta al prompt del agente antes de cada misión.') + '\n' +
+        chalk.white('Úsalo para reglas del negocio, navegación especial y anti-patrones que Arcality deba respetar siempre.') + '\n' +
+        chalk.white('Complementa el archivo con ') + chalk.cyan('.arcality/qa-context.meta.json') + chalk.white(' para versionar responsables y cambios.'),
+        'QA Context Local'
+    );
 
     const wantsContext = await confirm({
         message: chalk.cyan('📄 ¿Deseas generar un archivo local QA Context (.arcality/qa-context.md) para enseñarle al agente reglas del negocio?'),
@@ -356,12 +356,12 @@ async function main() {
             fs.mkdirSync(arcalityDir, { recursive: true });
         }
         
-        const qaContextPath = path.join(arcalityDir, 'qa-context.md');
-        const qaContextMetaPath = path.join(arcalityDir, 'qa-context.meta.json');
-        const qaTemplate = `# Arcality QA Context
-<!--
-Este archivo se inyecta antes de cada mision.
-Escribe reglas cortas, especificas y accionables.
+        const qaContextPath = path.join(arcalityDir, 'qa-context.md');
+        const qaContextMetaPath = path.join(arcalityDir, 'qa-context.meta.json');
+        const qaTemplate = `# Arcality QA Context
+<!--
+Este archivo se inyecta antes de cada mision.
+Escribe reglas cortas, especificas y accionables.
 Usa un bullet por regla real.
 Los bullets que empiecen con "Ejemplo:" se ignoran hasta que los reemplaces.
 -->
@@ -386,41 +386,41 @@ Los bullets que empiecen con "Ejemplo:" se ignoran hasta que los reemplaces.
 - Ejemplo: Usa el usuario QA_TIMESHEET_01 para pruebas de captura diaria.
 - Ejemplo: No reutilices folios ya aprobados.
 
-## Resultado Esperado y Validaciones Clave
-<!-- Como saber que la mision realmente termino bien -->
-- Ejemplo: La prueba termina cuando el registro aparece en la tabla "Timesheet - Hoy" de /welcome.
-- Ejemplo: Si aparece la leyenda "Expirado" en el proyecto, la prueba sigue siendo valida.
-`;
-        const qaMetaTemplate = {
-            version: '1.0.0',
-            updated_by: username.trim() || 'qa.owner@empresa.com',
-            approved_by: '',
-            owner_team: 'QA',
-            effective_from: new Date().toISOString().slice(0, 10),
-            change_summary: 'Creacion inicial del QA Context para este proyecto.',
-            tags: ['business-rules', 'ui-navigation']
-        };
-        if (!fs.existsSync(qaContextPath)) {
-            fs.writeFileSync(qaContextPath, qaTemplate);
-            note(chalk.green(`✅ QA Context creado en: ${qaContextPath}`), 'Contexto Guardado');
-        } else {
-            note(chalk.cyan(`ℹ️ QA Context ya existente: ${qaContextPath}`), 'Contexto Detectado');
-        }
-        if (!fs.existsSync(qaContextMetaPath)) {
-            fs.writeFileSync(qaContextMetaPath, JSON.stringify(qaMetaTemplate, null, 2), 'utf8');
-            note(chalk.green(`✅ QA Context metadata creada en: ${qaContextMetaPath}`), 'Metadata Guardada');
-        } else {
-            note(chalk.cyan(`ℹ️ QA Context metadata ya existente: ${qaContextMetaPath}`), 'Metadata Detectada');
-        }
-
-        note(
-            chalk.white('Si ejecutas Arcality en CI, la gobernanza del contexto se aplica en modo ') +
-            chalk.cyan('strict') + chalk.white(' por defecto.') + '\n' +
-            chalk.white('Puedes controlarlo con la variable ') + chalk.cyan('ARCALITY_QA_CONTEXT_GOVERNANCE') +
-            chalk.white(' usando ') + chalk.cyan('off') + chalk.white(', ') + chalk.cyan('warn') + chalk.white(' o ') + chalk.cyan('strict') + chalk.white('.'),
-            'Gobernanza del Contexto'
-        );
-    }
+## Resultado Esperado y Validaciones Clave
+<!-- Como saber que la mision realmente termino bien -->
+- Ejemplo: La prueba termina cuando el registro aparece en la tabla "Timesheet - Hoy" de /welcome.
+- Ejemplo: Si aparece la leyenda "Expirado" en el proyecto, la prueba sigue siendo valida.
+`;
+        const qaMetaTemplate = {
+            version: '1.0.0',
+            updated_by: username.trim() || 'qa.owner@empresa.com',
+            approved_by: '',
+            owner_team: 'QA',
+            effective_from: new Date().toISOString().slice(0, 10),
+            change_summary: 'Creacion inicial del QA Context para este proyecto.',
+            tags: ['business-rules', 'ui-navigation']
+        };
+        if (!fs.existsSync(qaContextPath)) {
+            fs.writeFileSync(qaContextPath, qaTemplate);
+            note(chalk.green(`✅ QA Context creado en: ${qaContextPath}`), 'Contexto Guardado');
+        } else {
+            note(chalk.cyan(`ℹ️ QA Context ya existente: ${qaContextPath}`), 'Contexto Detectado');
+        }
+        if (!fs.existsSync(qaContextMetaPath)) {
+            fs.writeFileSync(qaContextMetaPath, JSON.stringify(qaMetaTemplate, null, 2), 'utf8');
+            note(chalk.green(`✅ QA Context metadata creada en: ${qaContextMetaPath}`), 'Metadata Guardada');
+        } else {
+            note(chalk.cyan(`ℹ️ QA Context metadata ya existente: ${qaContextMetaPath}`), 'Metadata Detectada');
+        }
+
+        note(
+            chalk.white('Si ejecutas Arcality en CI, la gobernanza del contexto se aplica en modo ') +
+            chalk.cyan('strict') + chalk.white(' por defecto.') + '\n' +
+            chalk.white('Puedes controlarlo con la variable ') + chalk.cyan('ARCALITY_QA_CONTEXT_GOVERNANCE') +
+            chalk.white(' usando ') + chalk.cyan('off') + chalk.white(', ') + chalk.cyan('warn') + chalk.white(' o ') + chalk.cyan('strict') + chalk.white('.'),
+            'Gobernanza del Contexto'
+        );
+    }
 
     // ── Summary ──
     note(

package/src/configManager.mjs

@@ -5,9 +5,9 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-const CONFIG_FILENAME = 'arcality.config';
-const LEGACY_OUTPUT_DIRS = new Set(['arcality', './arcality', '.\\arcality']);
-const DEFAULT_YAML_OUTPUT_DIR = './.arcality';
+const CONFIG_FILENAME = 'arcality.config';
+const LEGACY_OUTPUT_DIRS = new Set(['arcality', './arcality', '.\\arcality']);
+const DEFAULT_YAML_OUTPUT_DIR = './.arcality';
 
 export function isRealProjectId(projectId) {
     const id = String(projectId || '').trim();
@@ -91,7 +91,7 @@ export function validateConfig(config) {
  * @param {object} params
  * @returns {ArcalityConfig}
  */
-export function createConfig({
+export function createConfig({
     apiKey,
     organizationId,
     projectId,
@@ -101,8 +101,8 @@ export function createConfig({
     username,
     password,
     arcalityVersion,
-    yamlOutputDir = DEFAULT_YAML_OUTPUT_DIR,
-}) {
+    yamlOutputDir = DEFAULT_YAML_OUTPUT_DIR,
+}) {
     return {
         version: '1',
         apiKey,
@@ -152,13 +152,13 @@ export function injectConfigToEnv(config) {
  * @param {string} [projectRoot]
  * @returns {string} absolute path
  */
-export function getYamlOutputDir(config, projectRoot) {
-    const configuredDir = String(config?.runtime?.yamlOutputDir || '').trim();
-    const dir = LEGACY_OUTPUT_DIRS.has(configuredDir) || !configuredDir
-        ? DEFAULT_YAML_OUTPUT_DIR
-        : configuredDir;
-    return path.resolve(projectRoot || process.cwd(), dir);
-}
+export function getYamlOutputDir(config, projectRoot) {
+    const configuredDir = String(config?.runtime?.yamlOutputDir || '').trim();
+    const dir = LEGACY_OUTPUT_DIRS.has(configuredDir) || !configuredDir
+        ? DEFAULT_YAML_OUTPUT_DIR
+        : configuredDir;
+    return path.resolve(projectRoot || process.cwd(), dir);
+}
 
 /**
  * Ensures the YAML output directory exists.