@arcadialdev/arcality 3.0.1 → 3.0.3

package/scripts/init.mjs

@@ -2,10 +2,10 @@
 // scripts/init.mjs — Command: arcality init
 // Single-configuration setup flow:
 //   1. Prompt API key → validate with backend
-//   2. Prompt project name, baseUrl, username, password
+//   2. Prompt project name, baseUrl, username, password
 //   3. Detect framework (package.json only, NO .git)
 //   4. Create project via POST /api/v1/projects
-//   5. Write arcality.config
+//   5. Write arcality.config
 
 import 'dotenv/config';
 import fs from 'node:fs';
@@ -18,8 +18,10 @@ import {
     loadProjectConfig,
     saveProjectConfig,
     createConfig,
-} from '../src/configManager.mjs';
-import { getApiUrl } from '../src/configLoader.mjs';
+    isRealProjectId,
+} from '../src/configManager.mjs';
+import { getApiUrl } from '../src/configLoader.mjs';
+import { installPlaywrightAssets, getPlaywrightInstallCommand } from '../src/playwrightAssets.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -271,21 +273,37 @@ async function main() {
             // If response is HTML (e.g. Cloudflare 521), show a clean message
             const isHtml = errText.trim().startsWith('<');
             const displayError = isHtml
-                ? `El servidor backend de Arcality no está disponible temporalmente (HTTP ${res.status}). El proyecto se guardará solo de forma local.`
+                ? `El servidor backend de Arcality no esta disponible temporalmente (HTTP ${res.status}).`
                 : `HTTP ${res.status}: ${errText.slice(0, 200)}`;
 
-            sCreate.stop(chalk.yellow(`⚠️  ${displayError}`));
+            sCreate.stop(chalk.red(`No se pudo crear el proyecto en Arcality: ${displayError.replace(/El proyecto.*$/i, '').trim()}`));
             // Don't exit — write the config with a local-only project ID so user can still run
-            projectId = projectId || `local_${Date.now()}`;
+            note(
+                chalk.white('No se guardo arcality.config porque Arcality requiere un proyecto real conectado al backend.'),
+                'Configuracion detenida'
+            );
+            process.exit(1);
         } else {
             const created = await res.json();
-            projectId = created.id || created.Id;
+            projectId = created.id || created.Id;
+            if (!isRealProjectId(projectId)) {
+                sCreate.stop(chalk.red('El backend no devolvio un Project ID valido.'));
+                note(
+                    chalk.white('No se guardo arcality.config. Toda instancia de Arcality debe estar ligada a un proyecto real.'),
+                    'Configuracion detenida'
+                );
+                process.exit(1);
+            }
             organizationId = organizationId || created.organizationId || created.organization_id || null;
             sCreate.stop(chalk.green(`✅ Proyecto creado: "${projectName.trim()}" (${projectId})`));
         }
     } catch (err) {
-        sCreate.stop(chalk.yellow(`⚠️  No se pudo conectar con el servidor de Arcality: ${err.message}. Se continuará en modo local.`));
-        projectId = projectId || `local_${Date.now()}`;
+        sCreate.stop(chalk.red(`No se pudo conectar con el servidor de Arcality: ${err.message}`));
+        note(
+            chalk.white('No se guardo arcality.config porque la herramienta no funciona en modo offline/local.'),
+            'Configuracion detenida'
+        );
+        process.exit(1);
     }
 
     // ── Step 6: Write arcality.config ──
@@ -293,15 +311,32 @@ async function main() {
         apiKey: apiKey.trim(),
         organizationId,
         projectId,
-        projectName: projectName.trim(),
-        baseUrl: baseUrl.trim(),
-        frameworkDetected,
-        username: username.trim(),
-        password,
-        arcalityVersion: version,
-    });
+        projectName: projectName.trim(),
+        baseUrl: baseUrl.trim(),
+        frameworkDetected,
+        username: username.trim(),
+        password,
+        arcalityVersion: version,
+    });
 
-    saveProjectConfig(config, projectRoot);
+    saveProjectConfig(config, projectRoot);
+
+    const sPlaywright = spinner();
+    sPlaywright.start('Preparando navegador de pruebas (Chromium + ffmpeg)...');
+    let playwrightReady = true;
+
+    try {
+        await installPlaywrightAssets({ cwd: PACKAGE_ROOT });
+        sPlaywright.stop(chalk.green('Playwright listo para ejecutar misiones'));
+    } catch (err) {
+        playwrightReady = false;
+        sPlaywright.stop(chalk.yellow(`No se pudieron instalar los assets de Playwright: ${err.message}`));
+        note(
+            chalk.white('La configuracion del proyecto ya fue guardada, pero antes de la primera mision ejecuta:') + '\n\n' +
+            chalk.cyan(getPlaywrightInstallCommand()),
+            'Accion Manual Requerida'
+        );
+    }
 
     // ── Step 7: Custom QA Context ──
     note(
@@ -369,7 +404,8 @@ Los bullets que empiecen con "Ejemplo:" se ignoran hasta que los reemplaces.
         chalk.bold.white('  URL Base: ') + chalk.cyan(config.project.baseUrl) + '\n' +
         chalk.bold.white('  Framework: ') + chalk.magenta(config.project.frameworkDetected || 'N/A') + '\n' +
         chalk.bold.white('  ID del Proyecto: ') + chalk.gray(config.projectId) + '\n' +
-        chalk.bold.white('  Carpeta de Misiones: ') + chalk.yellow(config.runtime.yamlOutputDir),
+        chalk.bold.white('  Carpeta de Misiones: ') + chalk.yellow(config.runtime.yamlOutputDir) + '\n' +
+        chalk.bold.white('  Playwright: ') + (playwrightReady ? chalk.green('listo') : chalk.yellow('pendiente de instalacion manual')),
         'Configuración Guardada'
     );
 

package/scripts/rebrand-report.mjs

@@ -52,8 +52,22 @@ function processDirectory(reportDir, logoBase64) {
             html = html.replace(/at\s+.*?node_modules.*?(\n|\r)/g, '');
             html = html.replace(/at\s+.*?agentic-runner\.spec\.ts:\d+/g, '');
 
-            // 3. Inyección de Estilos y Scripts (MODO AGRESIVO)
-            const customStyles = `
+            // 3. Preserve custom Arcality reports before native Playwright styling.
+            // The custom Arcality report owns its visual system. Keep the
+            // aggressive Playwright rebrand injection for native reports only.
+            const isArcalityMissionConsole = html.includes('class="mission-brief"') || html.includes('Arcality QA Engine');
+            if (isArcalityMissionConsole) {
+                if (logoBase64) {
+                    html = html.replace(/rel="shortcut icon" href=".*?"/g, `rel="shortcut icon" href="${logoBase64}"`);
+                    html = html.replace(/rel="icon" href=".*?"/g, `rel="icon" href="${logoBase64}"`);
+                }
+                fs.writeFileSync(indexPath, html, 'utf8');
+                processTraceViewer(reportDir, logoBase64);
+                return;
+            }
+
+            // 4. Inyección de Estilos y Scripts (MODO AGRESIVO)
+            const customStyles = `
                 <script id="arcality-branding-script">
                     /* ARCALITY_BRANDING_SCRIPT */
                     // 1. Limpieza de Caché y Service Worker

package/scripts/setup.mjs

@@ -1,166 +1,120 @@
-#!/usr/bin/env node
-// scripts/setup.mjs — Comando: arcality setup
-// Configura API Key + instala navegador Playwright (Chromium)
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { spawn } from 'node:child_process';
-import { createInterface } from 'node:readline';
-
-const CONFIG_DIR = path.join(os.homedir(), '.arcality');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
-const PACKAGE_ROOT = process.env.ARCALITY_ROOT || path.resolve(path.dirname(new URL(import.meta.url).pathname), '..');
-
-function question(prompt) {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    return new Promise(resolve => {
-        rl.question(prompt, answer => { rl.close(); resolve(answer.trim()); });
-    });
-}
-
-function loadConfig() {
-    try {
-        if (fs.existsSync(CONFIG_FILE)) {
-            let raw = fs.readFileSync(CONFIG_FILE, 'utf8');
-            if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
-            return JSON.parse(raw);
-        }
-    } catch { }
-    return {};
-}
-
-function saveConfig(config) {
-    if (!fs.existsSync(CONFIG_DIR)) {
-        fs.mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
-}
-
-async function main() {
-    // Leer versión
-    let version = 'unknown';
-    try {
-        const pkg = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
-        version = pkg.version || 'unknown';
-    } catch { }
-
-    console.log('');
-    console.log('  ╔══════════════════════════════════════════╗');
-    console.log(`  ║   ARCALITY — Setup v${version.padEnd(24)}║`);
-    console.log('  ╚══════════════════════════════════════════╝');
-    console.log('');
-
-    const config = loadConfig();
-
-    // ──────────────── Paso 1: API Key de Arcality ────────────────
-    const currentKey = config.api_key || '';
-    const currentAnthropic = config.anthropic_api_key || '';
-
-    const maskedArc = currentKey
-        ? `✅ ${currentKey.slice(0, 6)}****${currentKey.slice(-4)}`
-        : '❌ (No configurada)';
-
-    const maskedAnt = currentAnthropic
-        ? `✅ ${currentAnthropic.slice(0, 6)}****${currentAnthropic.slice(-4)}`
-        : '❌ (No configurada)';
-
-    console.log(`  🔑 Arcality API Key (dummy/real):  ${maskedArc}`);
-    console.log(`  🧠 Anthropic API Key (corporativa): ${maskedAnt}`);
-    console.log('');
-
-    const newKey = await question('  👉 Ingresa Arcality API Key (Enter p. mantener): ');
-    if (newKey) {
-        if (!newKey.startsWith('arc_')) {
-            console.log('  ❌ La API Key debe iniciar con "arc_"');
-            process.exit(1);
-        }
-        config.api_key = newKey;
-    }
-
-    // API URL is internal-only (loaded via dotenv), always available
-    const hasSaaSBackend = !!process.env.ARCALITY_API_URL;
-
-    if (hasSaaSBackend) {
-        console.log('  🧠 Anthropic API Key (omitida — se usará el Cerebro SaaS)');
-        // Podemos limpiar la llave local por seguridad si queremos
-        if (config.anthropic_api_key) delete config.anthropic_api_key;
-    } else {
-        const newAnt = await question('  👉 Ingresa Anthropic API Key (Enter p. mantener): ');
-        if (newAnt) {
-            if (!newAnt.startsWith('sk-ant-')) {
-                console.log('  ⚠️  Formato de llave Anthropic inusual. Verifica que inicie con "sk-ant-"');
-            }
-            config.anthropic_api_key = newAnt;
-        }
-    }
-
-    // Configurar modelo por defecto
-    config.model = config.model || 'claude-sonnet-4-5';
-
-    // Guardar config
-    config.version = version;
-    config.setup_at = new Date().toISOString();
-    saveConfig(config);
-    console.log('');
-    console.log('  ✅ Configuración guardada correctamente.');
-
-    // ─── Paso 2: Instalar Chromium ───
-    console.log('');
-    console.log('  🌐 Instalando navegador (Chromium para Playwright)...');
-    console.log('');
-
-    try {
-        await new Promise((resolve, reject) => {
-            const child = spawn('npx', ['playwright', 'install', 'chromium'], {
-                stdio: 'inherit',
-                shell: true,
-                cwd: PACKAGE_ROOT
-            });
-            child.on('exit', code => code === 0 ? resolve() : reject(new Error(`Playwright install falló (exit code ${code})`)));
-            child.on('error', reject);
-        });
-        console.log('');
-        console.log('  ✅ Chromium instalado correctamente');
-    } catch (err) {
-        console.log('');
-        console.log(`  ⚠️  No se pudo instalar Chromium automáticamente: ${err.message}`);
-        console.log('     Puedes instalarlo manualmente ejecutando:');
-        console.log('     npx playwright install chromium');
-    }
-
-    // ─── Paso 3: Crear .env si no existe ───
-    const envFile = path.join(PACKAGE_ROOT, '.env');
-    const envExample = path.join(PACKAGE_ROOT, '.env.example');
-
-    if (!fs.existsSync(envFile) && fs.existsSync(envExample)) {
-        let content = fs.readFileSync(envExample, 'utf8');
-
-        // Inyectar la API Key
-        if (config.api_key) {
-            content = content.replace('ARCALITY_API_KEY=', `ARCALITY_API_KEY=${config.api_key}`);
-        }
-
-        fs.writeFileSync(envFile, content, 'utf8');
-        console.log('  ✅ .env creado desde .env.example');
-    } else if (fs.existsSync(envFile)) {
-        console.log('  ✅ .env existente (sin modificar)');
-    }
-
-    // ─── Resumen final ───
-    console.log('');
-    console.log('  ╔══════════════════════════════════════════╗');
-    console.log('  ║    ✅ SETUP COMPLETADO                    ║');
-    console.log('  ╚══════════════════════════════════════════╝');
-    console.log('');
-    console.log('  Para empezar, ejecuta:');
-    console.log('');
-    console.log('     arcality                         → Menú interactivo');
-    console.log('     arcality --agent "tu misión"     → Ejecución directa');
-    console.log('');
-}
-
-main().catch(err => {
-    console.error('  ❌ Error durante setup:', err.message);
-    process.exit(1);
-});
+#!/usr/bin/env node
+// scripts/setup.mjs - Command: arcality setup
+// Prepares the local machine for Arcality. Project configuration lives in `arcality init`.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { installPlaywrightAssets, getPlaywrightInstallCommand } from '../src/playwrightAssets.mjs';
+
+const CONFIG_DIR = path.join(os.homedir(), '.arcality');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_ROOT = process.env.ARCALITY_ROOT || path.resolve(__dirname, '..');
+
+function loadConfig() {
+    try {
+        if (!fs.existsSync(CONFIG_FILE)) return {};
+        let raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+        if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
+        return JSON.parse(raw);
+    } catch {
+        return {};
+    }
+}
+
+function saveConfig(config) {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
+}
+
+function getVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+        return pkg.version || 'unknown';
+    } catch {
+        return 'unknown';
+    }
+}
+
+function printHeader(version) {
+    console.log('');
+    console.log('  ARCALITY SETUP');
+    console.log(`  Version: ${version}`);
+    console.log('');
+    console.log('  Este comando prepara la maquina local para ejecutar misiones.');
+    console.log('  La configuracion del proyecto se hace con: arcality init');
+    console.log('');
+}
+
+async function main() {
+    const version = getVersion();
+    printHeader(version);
+
+    const config = loadConfig();
+    const removedLegacyKeys = [];
+
+    if (config.anthropic_api_key) {
+        delete config.anthropic_api_key;
+        removedLegacyKeys.push('anthropic_api_key');
+    }
+
+    if (config.model) {
+        delete config.model;
+        removedLegacyKeys.push('model');
+    }
+
+    config.version = version;
+    config.setup_at = new Date().toISOString();
+    saveConfig(config);
+
+    console.log('  [1/3] Configuracion global revisada.');
+    if (removedLegacyKeys.length > 0) {
+        console.log(`        Se removio configuracion legacy no usada: ${removedLegacyKeys.join(', ')}`);
+    } else {
+        console.log('        No se requiere ninguna llave de proveedor externo.');
+    }
+
+    console.log('');
+    console.log('  [2/3] Instalando assets de Playwright: Chromium + ffmpeg');
+    console.log('        Esto evita fallos de primera ejecucion al abrir el navegador o grabar video.');
+    console.log('');
+
+    let playwrightReady = false;
+    try {
+        await installPlaywrightAssets({ cwd: PACKAGE_ROOT });
+        playwrightReady = true;
+        console.log('');
+        console.log('        Playwright listo.');
+    } catch (err) {
+        console.log('');
+        console.log(`        No se pudieron instalar los assets automaticamente: ${err.message}`);
+        console.log('        Ejecuta manualmente:');
+        console.log(`        ${getPlaywrightInstallCommand()}`);
+    }
+
+    console.log('');
+    console.log('  [3/3] Siguientes pasos');
+    console.log('        En cada proyecto donde uses Arcality:');
+    console.log('        1. arcality init');
+    console.log('        2. arcality run');
+    console.log('');
+
+    if (!playwrightReady) {
+        console.log('  Setup finalizado con accion manual pendiente.');
+        process.exitCode = 1;
+        return;
+    }
+
+    console.log('  Setup completado correctamente.');
+}
+
+main().catch(err => {
+    console.error('  Error durante setup:', err.message);
+    process.exit(1);
+});

package/src/KnowledgeService.ts

@@ -30,13 +30,22 @@ export interface PortalContextResponse {
     fields: Array<{ field_identifier: string; field_type: string; is_required: boolean }>;
 }
 
-export interface ProjectDto {
-    id: string;
-    name: string;
-    base_url?: string;
-}
-
-export class KnowledgeService {
+export interface ProjectDto {
+    id: string;
+    name: string;
+    base_url?: string;
+}
+
+function isRealProjectId(projectId?: string | null): boolean {
+    const id = String(projectId || '').trim();
+    if (!id) return false;
+    if (id === 'undefined' || id === 'null') return false;
+    if (/^(local|mock)_/i.test(id)) return false;
+    if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id)) return false;
+    return true;
+}
+
+export class KnowledgeService {
     private static instance: KnowledgeService;
     private apiBase: string;
     private apiKey: string;
@@ -80,10 +89,10 @@ export class KnowledgeService {
     }
 
     public getProjectId(): string | null {
-        if (!this.projectId || this.projectId === 'undefined' || this.projectId === 'null') {
-            this.projectId = process.env.ARCALITY_PROJECT_ID || null;
-        }
-        return this.projectId;
+        if (!isRealProjectId(this.projectId)) {
+            this.projectId = process.env.ARCALITY_PROJECT_ID || null;
+        }
+        return isRealProjectId(this.projectId) ? this.projectId : null;
     }
 
     /**
@@ -98,7 +107,7 @@ export class KnowledgeService {
             const data = await res.json();
             return data.projects || [];
         } catch (e: any) {
-            console.warn(chalk.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
             return [];
         }
     }
@@ -116,7 +125,7 @@ export class KnowledgeService {
             if (!res.ok) return null;
             return await res.json();
         } catch (e: any) {
-            console.error(chalk.red(`[KnowledgeService] Falló creación de proyecto: ${e.message}`));
+            if (process.env.DEBUG) console.error(chalk.red(`[KnowledgeService] Falló creación de proyecto: ${e.message}`));
             return null;
         }
     }
@@ -125,8 +134,8 @@ export class KnowledgeService {
      * 2. Ingesta (Post-Percept)
      */
     public async ingest(payload: PortalIngestRequest): Promise<void> {
-        if (!payload.project_id || payload.project_id === 'undefined') {
-            console.warn(chalk.yellow(`[Knowledge] Ingesta cancelada: project_id es inválido.`));
+        if (!isRealProjectId(payload.project_id)) {
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Ingesta cancelada: project_id es inválido.`));
             return;
         }
 
@@ -148,7 +157,7 @@ export class KnowledgeService {
                 }
             }
         } catch (e: any) {
-            console.warn(chalk.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
         }
     }
 
@@ -170,7 +179,7 @@ export class KnowledgeService {
             if (!res.ok) return null;
             return await res.json();
         } catch (e: any) {
-            console.warn(chalk.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
             return null;
         }
     }
@@ -198,7 +207,7 @@ export class KnowledgeService {
                     severity
                 })
             });
-            console.log(chalk.green(`[Knowledge] Nueva regla registrada: ${title}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nueva regla registrada: ${title}`));
         } catch (e) { }
     }
 
@@ -224,7 +233,7 @@ export class KnowledgeService {
                     source: "agent_auto"
                 })
             });
-            console.log(chalk.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
         } catch (e) { }
     }
 
@@ -250,7 +259,7 @@ export class KnowledgeService {
                     source: "agent_auto"
                 })
             });
-            console.log(chalk.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
         } catch (e) { }
     }