@fernando.zavaleta/ai-platform-core 0.0.9-beta → 0.0.12-beta

package/01-rules/global-base.md

@@ -0,0 +1,49 @@
+# Base Global Rules
+
+Role:
+You are a Senior AI Engineering Agent.
+
+Language Policy:
+
+- Internal framework configuration files must be written in ENGLISH.
+- User-facing documentation and generated QA artifacts must be in SPANISH.
+
+Execution Rules:
+
+- NEVER create .py files unless explicitly asked.
+- Prefer terminal commands (bash, curl, jq) for integrations.
+- Always read credentials from:
+
+00-config/credentials.json
+
+Output Rules:
+
+- All generated artifacts must be Markdown (.md)
+- Use professional Spanish
+- QA outputs must be stored in:
+
+05-output/agente-qa/[JIRA_ID]/
+
+# Artifact Policy
+
+Agents may consume external data (JSON, API responses, logs).
+
+However, intermediate data must not be stored in the repository output directories.
+
+Only final documentation artifacts are allowed in:
+
+05-output/
+
+Allowed formats:
+
+.md
+
+Disallowed formats:
+
+.json
+.log
+.tmp
+
+## Interaction Rule
+- Do not explain the plan unless explicitly asked.
+- Execute the commands immediately and only report completion or critical errors.

package/03-domains/03.1-qa/profile.json

@@ -1,6 +1,6 @@
 {
   "name": "qa-engineer",
-  "version": "1.1.0",
+  "version": "0.0.1",
   "include_dirs": [
     "skills",
     "templates",

package/bin/cli.js

@@ -4,21 +4,40 @@ const path = require('path');
 
 const profileKey = process.argv[2];
 const PACKAGE_ROOT = path.join(__dirname, '..');
-// Cambiamos la ruta para que incluya el nombre del perfil y mantenga orden
 const TARGET_BASE_DIR = path.join(process.cwd(), '.cursor', 'ai-platform', profileKey);
 
+const USER_HOME = process.env.HOME || process.env.USERPROFILE;
+const GLOBAL_CONFIG_DIR = path.join(USER_HOME, '.ai-platform');
+const GLOBAL_CREDENTIALS_FILE = path.join(GLOBAL_CONFIG_DIR, 'credentials.json');
+
 const profiles = {
     "qa": "03.1-qa",
+    //"dev": "03.2-dev",
     "l3": "03.3-l3",
     "product": "03.4-product"
 };
 
 const domainFolder = profiles[profileKey];
 if (!domainFolder) {
-    console.error("❌ Perfil no válido. Usa: qa, l3 o product");
+    console.error("❌ Perfil no válido. Usa: qa, dev, l3 o product");
     process.exit(1);
 }
 
+if (!fs.existsSync(GLOBAL_CONFIG_DIR)) {
+    fs.mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+    console.log(`📁 Carpeta de configuración creada en: ${GLOBAL_CONFIG_DIR}`);
+}
+
+if (!fs.existsSync(GLOBAL_CREDENTIALS_FILE)) {
+    const templateConfig = {
+        jira: { base_url: "https://jiracorp.belcorp.biz", pat_token: "TU_TOKEN" },
+        confluence: { base_url: "https://confluence.belcorp.biz", pat_token: "TU_TOKEN" },
+        sdp: { base_url: "https://sdp.belcorp.biz/api/v3", technician_key: "TU_TOKEN" }
+    };
+    fs.writeFileSync(GLOBAL_CREDENTIALS_FILE, JSON.stringify(templateConfig, null, 2));
+    console.log(`📝 Template de credenciales creado. Por favor, edita: ${GLOBAL_CREDENTIALS_FILE}`);
+}
+
 const domainPath = path.join(PACKAGE_ROOT, '03-domains', domainFolder);
 const profileConfigPath = path.join(domainPath, 'profile.json');
 
@@ -29,7 +48,6 @@ if (!fs.existsSync(profileConfigPath)) {
 
 const config = JSON.parse(fs.readFileSync(profileConfigPath, 'utf8'));
 
-// Función para copiar carpetas completas manteniendo la estructura
 function copyRecursiveSync(src, dest) {
     const exists = fs.existsSync(src);
     const stats = exists && fs.statSync(src);
@@ -46,15 +64,13 @@ function copyRecursiveSync(src, dest) {
 
 console.log(`🚀 Instalando inteligencia estructurada para ${profileKey}...`);
 
-// 1. Proyectar el Agente (agent.md) si existe
 const agentFile = path.join(domainPath, 'agent.md');
 if (fs.existsSync(agentFile)) {
     if (!fs.existsSync(TARGET_BASE_DIR)) fs.mkdirSync(TARGET_BASE_DIR, { recursive: true });
     fs.copyFileSync(agentFile, path.join(TARGET_BASE_DIR, 'agent.md'));
-    console.log(`   🤖 Agente proyectado en la raíz del perfil.`);
+    console.log(`   🤖 Agente proyectado.`);
 }
 
-// 2. Proyectar carpetas del profile.json manteniendo su jerarquía
 config.include_dirs.forEach(dirName => {
     const sourceDir = path.join(domainPath, dirName);
     const targetDir = path.join(TARGET_BASE_DIR, dirName);
@@ -65,5 +81,5 @@ config.include_dirs.forEach(dirName => {
     }
 });
 
-console.log(`\n✨ Perfil ${profileKey} instalado en .cursor/ai-platform/${profileKey}`);
-console.log(`💡 Ahora puedes referenciar al agente con @agent.md desde esa carpeta.`);
+console.log(`\n✨ Perfil ${profileKey} listo.`);
+console.log(`👉 Configura el MCP en Cursor usando: ${GLOBAL_CREDENTIALS_FILE}`);

package/bin/mcp-server.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontextprotocol/sdk/types.js");
+const fs = require('fs');
+const path = require('path');
+const axios = require('axios');
+
+function loadCredentials() {
+    const envPath = process.env.AI_PLATFORM_CREDENTIALS;
+    const defaultPath = path.join(process.env.HOME || process.env.USERPROFILE, '.ai-platform', 'credentials.json');
+    
+    const configPath = envPath || defaultPath;
+
+    if (!fs.existsSync(configPath)) {
+        console.error(`❌ Error: No se encontró credentials.json en ${configPath}`);
+        process.exit(1);
+    }
+
+    try {
+        return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    } catch (error) {
+        console.error("❌ Error al parsear credentials.json:", error.message);
+        process.exit(1);
+    }
+}
+
+const credentials = loadCredentials();
+
+const server = new Server({
+    name: "tismart-belcorp-bridge",
+    version: "0.0.12-beta"
+}, {
+    capabilities: { tools: {} }
+});
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "get_jira_ticket",
+            description: "Consulta un ticket en el Jira de Belcorp para obtener resumen, descripción y estado.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    issueKey: { type: "string", description: "ID del ticket (ej: QA-123)" }
+                },
+                required: ["issueKey"]
+            }
+        },
+        {
+            name: "get_sdp_request",
+            description: "Obtiene los detalles de un requerimiento en Service Desk Plus (SDP) de Belcorp.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    requestId: { type: "string", description: "ID numérico de la solicitud" }
+                },
+                required: ["requestId"]
+            }
+        },
+        {
+            name: "search_confluence_rca",
+            description: "Realiza una búsqueda semántica de RCAs o documentos en Confluence Belcorp.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Término de búsqueda" }
+                },
+                required: ["query"]
+            }
+        }
+    ]
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    try {
+        switch (name) {
+            case "get_jira_ticket": {
+                const url = `${credentials.jira.base_url}/rest/api/2/issue/${args.issueKey}`;
+                const response = await axios.get(url, {
+                    headers: { 
+                        'Authorization': `Bearer ${credentials.jira.pat_token}`,
+                        'Content-Type': 'application/json'
+                    }
+                });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
+                };
+            }
+
+            case "get_sdp_request": {
+                const url = `${credentials.sdp.base_url}/requests/${args.requestId}`;
+                const response = await axios.get(url, {
+                    headers: { 
+                        'technician_key': credentials.sdp.technician_key,
+                        'Content-Type': 'application/json'
+                    }
+                });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
+                };
+            }
+
+            case "search_confluence_rca": {
+                const url = `${credentials.confluence.base_url}/rest/api/content/search?cql=text ~ "${args.query}"`;
+                const response = await axios.get(url, {
+                    headers: { 
+                        'Authorization': `Bearer ${credentials.confluence.pat_token}`,
+                        'Content-Type': 'application/json'
+                    }
+                });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response.data.results, null, 2) }]
+                };
+            }
+
+            default:
+                throw new Error(`Herramienta no reconocida: ${name}`);
+        }
+    } catch (error) {
+        return {
+            isError: true,
+            content: [{ 
+                type: "text", 
+                text: `Error en Belcorp Bridge [${name}]: ${error.response?.data?.errorMessages?.[0] || error.message}` 
+            }]
+        };
+    }
+});
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("🚀 MCP Server de Belcorp iniciado correctamente.");
+}
+
+main().catch(console.error);

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "@fernando.zavaleta/ai-platform-core",
-  "version": "0.0.9-beta",
+  "version": "0.0.12-beta",
   "description": "Enterprise AI Framework Distribution Tool",
   "main": "index.js",
   "bin": {
-    "ia-install": "./bin/cli.js"
+    "ia-install": "./bin/cli.js",
+    "ia-mcp": "./bin/mcp-server.js"
   },
   "files": [
     "03-domains",
     "02-mcp",
-    "00-config/global-base.md",
+    "01-rules/global-base.md",
     "bin"
   ],
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "axios": "^1.13.6"
   }
 }