@linkup-ai/abap-ai 2.1.0 → 2.2.0

package/dist/adt-client.js

@@ -49,19 +49,38 @@ function createHttpClient() {
 const http = createHttpClient();
 exports.http = http;
 // ─── Sessão CSRF ──────────────────────────────────────────────────
+/** Máximo de tentativas para obter CSRF token */
+const CSRF_MAX_RETRIES = 3;
+/** Intervalo entre tentativas de CSRF (ms) */
+const CSRF_RETRY_DELAY = 1000;
 async function ensureSession() {
     if (session)
         return session.csrfToken;
-    const response = await http.get("/discovery", {
-        headers: { "X-CSRF-Token": "Fetch", Accept: "application/xml" },
-        validateStatus: (status) => status < 500, // 406 é esperado mas traz o CSRF token
-    });
-    const token = response.headers["x-csrf-token"];
-    if (!token) {
-        throw new AdtError("Falha ao obter CSRF token do SAP ADT. Verifique se o serviço /sap/bc/adt/discovery está ativo.", 0, "/discovery");
+    let lastError;
+    for (let attempt = 1; attempt <= CSRF_MAX_RETRIES; attempt++) {
+        try {
+            const response = await http.get("/discovery", {
+                headers: { "X-CSRF-Token": "Fetch", Accept: "application/xml" },
+                validateStatus: (status) => status < 500, // 406 é esperado mas traz o CSRF token
+            });
+            const token = response.headers["x-csrf-token"];
+            if (token) {
+                session = { csrfToken: token };
+                return token;
+            }
+            lastError = new AdtError("CSRF token não retornado pelo SAP ADT.", 0, "/discovery");
+        }
+        catch (error) {
+            lastError = error;
+        }
+        // Retry com backoff linear (1s, 2s, 3s)
+        if (attempt < CSRF_MAX_RETRIES) {
+            await new Promise((r) => setTimeout(r, CSRF_RETRY_DELAY * attempt));
+        }
     }
-    session = { csrfToken: token };
-    return token;
+    throw lastError instanceof AdtError
+        ? lastError
+        : new AdtError("Falha ao obter CSRF token do SAP ADT após 3 tentativas. Verifique se o serviço /sap/bc/adt/discovery está ativo.", 0, "/discovery");
 }
 function resetSession() {
     session = null;

package/dist/cli/init.js

@@ -218,7 +218,7 @@ async function promptSystem() {
         {
             type: "select",
             name: "environmentRole",
-            message: "Papel do ambiente (controla quais operações o LKPABAP.ia pode executar)",
+            message: "Papel do ambiente (controla quais operações o LKPABAP.ai pode executar)",
             choices: [
                 { title: "DEVELOPMENT — leitura + escrita + criação (padrão para DEV)", value: "DEVELOPMENT" },
                 { title: "QUALITY    — somente leitura (padrão para QAS/QA)", value: "QUALITY" },
@@ -252,7 +252,7 @@ async function promptSystem() {
 async function init() {
     console.log(`
   ╭─────────────────────────────────────╮
-  │  LKPABAP.ia — Setup                │
+  │  LKPABAP.ai — Setup                │
   │  Conecte o Claude ao seu SAP       │
   ╰─────────────────────────────────────╯
 `);

package/dist/cli/status.js

@@ -146,7 +146,7 @@ function countKnowledge() {
 async function status() {
     console.log(`
   ╭──────────────────────────────────────────────╮
-  │  LKPABAP.ia v${VERSION}${" ".repeat(30 - VERSION.length)}│
+  │  LKPABAP.ai v${VERSION}${" ".repeat(30 - VERSION.length)}│
   ╰──────────────────────────────────────────────╯`);
     // Licença
     console.log(`

package/dist/cli.js

@@ -8,7 +8,7 @@ const remove_js_1 = require("./cli/remove.js");
 const systems_js_1 = require("./cli/systems.js");
 const VERSION = "2.0.0";
 const HELP = `
-  LKPABAP.ia — AI-powered ABAP development for SAP
+  LKPABAP.ai — AI-powered ABAP development for SAP
 
   Uso:
     abap-ai <comando> [opções]
@@ -38,7 +38,7 @@ async function main() {
         return;
     }
     if (command === "--version" || command === "-v") {
-        console.log(`LKPABAP.ia v${VERSION}`);
+        console.log(`LKPABAP.ai v${VERSION}`);
         return;
     }
     switch (command) {

package/dist/index.js

@@ -57,10 +57,27 @@ const create_amdp_js_1 = require("./tools/create-amdp.js");
 const system_profile_js_1 = require("./system-profile.js");
 const security_policy_js_1 = require("./security-policy.js");
 const security_audit_js_1 = require("./security-audit.js");
+const license_guard_js_1 = require("./license-guard.js");
 const server = new mcp_js_1.McpServer({
     name: "abap-adt",
     version: "2.0.0",
 });
+// ─── License Guard (wraps all tool handlers) ─────────────────────
+// Intercepta server.tool para injetar licenseGuard() automaticamente.
+// Toda tool retorna erro amigável se a licença é ausente ou expirada.
+{
+    const _origTool = server.tool.bind(server);
+    server.tool = (...args) => {
+        const handler = args[args.length - 1];
+        args[args.length - 1] = async (...handlerArgs) => {
+            const licBlock = (0, license_guard_js_1.licenseGuard)();
+            if (licBlock)
+                return licBlock;
+            return await handler(...handlerArgs);
+        };
+        return _origTool.apply(server, args);
+    };
+}
 // ─── Security Guard ───────────────────────────────────────────────
 /**
  * Verifica se uma tool pode ser executada sob a security policy atual.
@@ -94,8 +111,8 @@ function securityGuard(toolName, transportRequest) {
 // Tool: abap_read
 server.tool("abap_read", "Lê o código-fonte de um objeto ABAP no sistema SAP via ADT API. Para tabelas (TABL/DT), estruturas (TABL/DS) e table types (TTYP/TT), retorna a lista de campos com tipo e descrição.", {
     object_type: zod_1.z
-        .enum(["PROG/P", "CLAS/OC", "FUGR/FF", "DOMA/D", "DTEL/D", "TABL/DT", "TABL/DS", "TTYP/TT", "INTF/OI", "DDLS/DF", "DDLX/MX", "SRVD/SRV", "BDEF/BDO", "SRVB/SVB"])
-        .describe("Tipo do objeto SAP. Ex: PROG/P (report), CLAS/OC (classe), DDLS/DF (CDS view), TABL/DT (tabela), TABL/DS (estrutura), TTYP/TT (table type)."),
+        .enum(["PROG/P", "CLAS/OC", "FUGR/FF", "DOMA/D", "DTEL/D", "TABL/DT", "TABL/DS", "TTYP/TT", "INTF/OI", "DDLS/DF", "DDLX/MX", "SRVD/SRV", "BDEF/BDO", "SRVB/SVB", "MSAG/N", "ENHO/EO"])
+        .describe("Tipo do objeto SAP. Ex: PROG/P (report), CLAS/OC (classe), DDLS/DF (CDS view), TABL/DT (tabela), MSAG/N (classe de mensagens), ENHO/EO (enhancement implementation)."),
     object_name: zod_1.z
         .string()
         .describe("Nome do objeto ABAP (ex: ZR_SD_PEDIDOS_ABERTOS)."),
@@ -1414,7 +1431,8 @@ async function main() {
     await server.connect(transport);
     const profile = (0, system_profile_js_1.getProfile)();
     const policy = (0, security_policy_js_1.getPolicy)();
-    process.stderr.write(`abap-mcp-server v2.1.0 iniciado | System: ${profile.system.type} | ABAP: ${profile.system.abapPlatform} | Security: ${policy.environment_role} (${policy.allowed_levels.join("+")})\n`);
+    const licLabel = (0, license_guard_js_1.licenseStatusLabel)();
+    process.stderr.write(`abap-mcp-server v2.2.0 iniciado | License: ${licLabel} | System: ${profile.system.type} | ABAP: ${profile.system.abapPlatform} | Security: ${policy.environment_role} (${policy.allowed_levels.join("+")})\n`);
 }
 main().catch((err) => {
     process.stderr.write(`Falha ao iniciar servidor: ${err}\n`);

package/dist/license-guard.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * License Guard — valida licença antes de executar qualquer tool.
+ *
+ * Singleton: lê ~/.abap-ai/license.json uma vez e cacheia.
+ * licenseGuard() retorna null se OK, ou MCP error response se bloqueado.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLicense = getLicense;
+exports.reloadLicense = reloadLicense;
+exports.licenseGuard = licenseGuard;
+exports.licenseStatusLabel = licenseStatusLabel;
+const activate_js_1 = require("./cli/activate.js");
+// ─── Singleton ───────────────────────────────────────────────────
+let cachedLicense = undefined;
+/**
+ * Retorna a licença cacheada. null = arquivo não existe ou inválido.
+ */
+function getLicense() {
+    if (cachedLicense === undefined) {
+        cachedLicense = (0, activate_js_1.readLicense)();
+    }
+    return cachedLicense;
+}
+/**
+ * Força releitura do license.json (útil após activate).
+ */
+function reloadLicense() {
+    cachedLicense = undefined;
+    return getLicense();
+}
+function daysUntilExpiry(expiresStr) {
+    const expires = new Date(expiresStr + "T23:59:59");
+    const now = new Date();
+    return Math.ceil((expires.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+}
+/**
+ * Verifica se a licença é válida.
+ * Retorna null se OK, ou MCP error response se bloqueado.
+ */
+function licenseGuard() {
+    const license = getLicense();
+    if (!license) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "LKPABAP.ai — Licença não encontrada.\n\n" +
+                        "Para usar as ferramentas, ative sua licença:\n\n" +
+                        "  abap-ai activate LK-XXXX-XXXX-XXXX\n\n" +
+                        "Adquira em: https://lkpabap.ai",
+                }],
+            isError: true,
+        };
+    }
+    const daysLeft = daysUntilExpiry(license.expires);
+    if (daysLeft <= 0) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `LKPABAP.ai — Licença expirada em ${license.expires}.\n\n` +
+                        "Renove sua licença:\n\n" +
+                        "  abap-ai activate <NOVA-CHAVE>\n\n" +
+                        "Renove em: https://lkpabap.ai",
+                }],
+            isError: true,
+        };
+    }
+    return null;
+}
+/**
+ * Retorna string de status para log no startup.
+ */
+function licenseStatusLabel() {
+    const license = getLicense();
+    if (!license)
+        return "SEM LICENÇA";
+    const daysLeft = daysUntilExpiry(license.expires);
+    if (daysLeft <= 0)
+        return "EXPIRADA";
+    return `${license.plan} até ${license.expires}`;
+}

package/dist/security-policy.js

@@ -2,7 +2,7 @@
 /**
  * Security Policy — controle de acesso por camada de ambiente SAP.
  *
- * Implementa o princípio: "O LKPABAP.ia NUNCA sobrepõe as restrições de
+ * Implementa o princípio: "O LKPABAP.ai NUNCA sobrepõe as restrições de
  * segurança do SAP. Em PRD, só leitura. Em QAS, leitura + debug.
  * Em DEV, tudo liberado. abap_release_transport sempre bloqueado."
  *
@@ -205,7 +205,7 @@ function checkToolAccess(toolName, policy) {
     if (toolName === "abap_release_transport") {
         return {
             allowed: false,
-            reason: `BLOQUEADO: abap_release_transport é sempre bloqueado pelo LKPABAP.ia. `
+            reason: `BLOQUEADO: abap_release_transport é sempre bloqueado pelo LKPABAP.ai. `
                 + `Liberar transportes é uma operação irreversível que pode propagar mudanças para ambientes produtivos. `
                 + `Execute esta operação manualmente na transação SE09/SE10 do SAP GUI.`,
         };
@@ -290,10 +290,10 @@ function listEnvironmentRoles() {
 function describeEnvironmentRestriction(role) {
     switch (role) {
         case "PRODUCTION":
-            return "Em ambientes PRODUTIVOS, o LKPABAP.ia opera somente em modo leitura. "
+            return "Em ambientes PRODUTIVOS, o LKPABAP.ai opera somente em modo leitura. "
                 + "Qualquer modificação deve ser feita via transporte a partir do ambiente de desenvolvimento.";
         case "QUALITY":
-            return "Em ambientes de QUALIDADE (QAS), o LKPABAP.ia opera somente em modo leitura. "
+            return "Em ambientes de QUALIDADE (QAS), o LKPABAP.ai opera somente em modo leitura. "
                 + "Modificações devem ser transportadas a partir do ambiente de desenvolvimento.";
         case "DEVELOPMENT":
             return ""; // DEV não tem restrição descritiva

package/dist/tools/activate.js

@@ -32,6 +32,9 @@ async function abapActivate(input) {
         },
         params: { method: "activate", preauditRequested: "true" },
         responseType: "text",
+        // Aceita 200 (ativação OK) e 400 (erros de sintaxe) — sem isso, axios rejeita non-2xx
+        // e o erro pode não ser propagado corretamente pelo MCP SDK
+        validateStatus: (status) => status === 200 || status === 400,
     });
     const { success, alreadyActive, messages } = parseActivationResponse(response.data);
     if (!success) {

package/dist/tools/read.js

@@ -4,6 +4,7 @@ exports.abapReadTool = void 0;
 exports.abapRead = abapRead;
 const adt_client_js_1 = require("../adt-client.js");
 const object_versions_js_1 = require("./object-versions.js");
+const message_class_js_1 = require("./message-class.js");
 function resolveSourcePath(adtPath, name, objectType, classInclude) {
     if (objectType === "CLAS/OC" && classInclude && classInclude !== "main") {
         return `/${adtPath}/${name}/includes/${classInclude}/source/main`;
@@ -106,6 +107,10 @@ async function abapRead(input) {
     const { object_type, object_name, class_include } = input;
     const name = object_name.toUpperCase();
     const adtPath = (0, adt_client_js_1.resolveAdtPath)(object_type);
+    // MSAG/N: delegar para abapMessageClass que já faz parsing do XML
+    if (object_type === "MSAG/N") {
+        return (0, message_class_js_1.abapMessageClass)({ message_class_name: name });
+    }
     // Para TABL/DT, TABL/DS e TTYP/TT: tentar /source/main primeiro (CDS DDL), se 404 ler metadados XML
     if (DDIC_METADATA_TYPES.includes(object_type)) {
         const nameLower = name.toLowerCase();
@@ -155,7 +160,7 @@ exports.abapReadTool = {
             object_type: {
                 type: "string",
                 description: "Tipo do objeto SAP. Exemplos: PROG/P (report), CLAS/OC (classe), FUGR/FF (function module), DDLS/DF (CDS view), TABL/DT (tabela transparente), TABL/DS (estrutura), INTF/OI (interface).",
-                enum: ["PROG/P", "CLAS/OC", "FUGR/FF", "DOMA/D", "DTEL/D", "TABL/DT", "TABL/DS", "INTF/OI", "DDLS/DF", "DDLX/MX", "SRVD/SRV", "BDEF/BDO", "SRVB/SVB"],
+                enum: ["PROG/P", "CLAS/OC", "FUGR/FF", "DOMA/D", "DTEL/D", "TABL/DT", "TABL/DS", "TTYP/TT", "INTF/OI", "DDLS/DF", "DDLX/MX", "SRVD/SRV", "BDEF/BDO", "SRVB/SVB", "MSAG/N", "ENHO/EO"],
             },
             object_name: {
                 type: "string",

package/dist/tools/system-info.js

@@ -233,18 +233,19 @@ function detectSystemType(discoveryXml, basisVersion, platform) {
     if (discoveryXml.includes("bw/modelingtools") || discoveryXml.includes("bw/querydesigner")) {
         return "SAP_BW";
     }
-    // S/4HANA = BASIS 750+ com certas capabilities
-    if (bv >= 750) {
-        // Verifica se tem RAP-related collections (mais provável S/4)
-        if (discoveryXml.includes("behaviordefinitions") || discoveryXml.includes("ServiceBindings")) {
-            return "ON_PREMISE_S4";
-        }
-    }
-    // ECC ou sistema antigo
+    // ECC ou sistema antigo (BASIS < 750 é sempre ECC)
     if (bv < 750)
         return "ON_PREMISE_ECC";
-    // Default para on-premise S/4
-    return "ON_PREMISE_S4";
+    // BASIS 750+: distinguir S/4HANA de ECC EHP8 (ambos têm BASIS 750)
+    // S/4HANA sempre inclui collections RAP/Service no discovery XML.
+    // ECC 750 NÃO tem esses endpoints — essa é a diferença chave.
+    const hasS4Collections = discoveryXml.includes("behaviordefinitions") ||
+        discoveryXml.includes("ServiceBindings") ||
+        discoveryXml.includes("ddic/srvd/sources");
+    if (hasS4Collections)
+        return "ON_PREMISE_S4";
+    // BASIS 750 sem collections S/4 = ECC EHP8
+    return "ON_PREMISE_ECC";
 }
 function detectRelease(basisVersion) {
     const bv = parseInt(basisVersion, 10) || 0;

package/dist/tools/transports.js

@@ -29,7 +29,8 @@ async function abapListTransports(input) {
     });
     const requests = parseTransportResponse(response.data);
     if (requests.length === 0) {
-        return `Nenhuma ordem de transporte aberta encontrada para ${user.toUpperCase()}.`;
+        return `Nenhuma ordem de transporte aberta encontrada para ${user.toUpperCase()}.\n` +
+            `Para criar uma nova request, use abap_create_transport ou crie manualmente via SE09/SE10 no SAP GUI.`;
     }
     const header = `Ordens de transporte abertas — ${user.toUpperCase()} (${requests.length}):\n`;
     const rows = requests.map((r) => {

package/dist/tools/write.js

@@ -31,6 +31,12 @@ async function abapWrite(input) {
             await (0, adt_client_js_1.adtPut)(sourcePath, source, etag, transport_request);
         }
         catch (putError) {
+            // Detectar erro de transport request obrigatória
+            if (isTransportRequiredError(putError) && !transport_request) {
+                throw new Error(`Objeto ${name} requer transport request para gravação (pacote não-local).\n` +
+                    `Use abap_list_transports para verificar requests abertas, ou abap_create_transport para criar uma nova.\n` +
+                    `Depois, informe o parâmetro transport_request (ex: "DEVK900123").`);
+            }
             // Workaround: em on-premise S/4, o GET retorna ETag com sufixo diferente do esperado pelo PUT.
             // Se o PUT falha com 412, extrai o ETag correto da mensagem de erro e tenta novamente.
             if ((0, system_profile_js_1.getProfile)().quirks.etagRequiresManualFix && is412Error(putError)) {
@@ -54,6 +60,19 @@ async function abapWrite(input) {
     }
     return `Objeto ${object_name} gravado com sucesso.`;
 }
+/** Detecta erros do SAP indicando que transport request é obrigatória */
+function isTransportRequiredError(error) {
+    if (error instanceof adt_client_js_1.AdtError) {
+        const msg = (error.sapMessage ?? error.message).toLowerCase();
+        return msg.includes("correction") || msg.includes("transport") || msg.includes("request");
+    }
+    const data = error.response?.data;
+    if (typeof data === "string") {
+        const lower = data.toLowerCase();
+        return lower.includes("correction") || lower.includes("transport request") || lower.includes("corrNr");
+    }
+    return false;
+}
 function is412Error(error) {
     return typeof error === "object" && error !== null &&
         "response" in error &&

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linkup-ai/abap-ai",
-  "version": "2.1.0",
-  "description": "LKPABAP.ia — AI-powered ABAP development tools for SAP S/4HANA via ADT REST API",
+  "version": "2.2.0",
+  "description": "LKPABAP.ai — AI-powered ABAP development tools for SAP S/4HANA via ADT REST API",
   "main": "dist/index.js",
   "bin": {
     "abap-ai": "dist/cli.js"