@linkup-ai/abap-ai 0.1.0

package/dist/cli/init.js

@@ -0,0 +1,559 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_MCP_PATH = void 0;
+exports.readMcpConfig = readMcpConfig;
+exports.writeMcpConfig = writeMcpConfig;
+exports.writeClaudeSettings = writeClaudeSettings;
+exports.updateClaudeMd = updateClaudeMd;
+exports.init = init;
+const prompts_1 = __importDefault(require("prompts"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+exports.GLOBAL_MCP_PATH = path.join(os.homedir(), ".claude", "mcp.json");
+const LOCAL_MCP_PATH = path.join(process.cwd(), ".mcp.json"); // VS Code lê .mcp.json na raiz do workspace
+function getMcpPath(local) {
+    return local ? LOCAL_MCP_PATH : exports.GLOBAL_MCP_PATH;
+}
+// ---------------------------------------------------------------------------
+// Teste de conexão SAP
+// ---------------------------------------------------------------------------
+async function testConnection(system) {
+    const url = new URL(`${system.url}/sap/bc/adt/discovery`);
+    const options = {
+        hostname: url.hostname,
+        port: url.port || (url.protocol === "https:" ? 443 : 80),
+        path: url.pathname,
+        method: "GET",
+        headers: {
+            Authorization: "Basic " + Buffer.from(`${system.user}:${system.pass}`).toString("base64"),
+            "sap-client": system.client,
+            "sap-language": system.language,
+            Accept: "application/atomsvc+xml",
+        },
+        rejectAuthorized: !system.selfSignedSsl,
+        timeout: 10000,
+    };
+    // workaround: rejectUnauthorized
+    if (system.selfSignedSsl) {
+        options.rejectUnauthorized = false;
+    }
+    return new Promise((resolve) => {
+        const transport = url.protocol === "https:" ? https : http;
+        const req = transport.request(options, (res) => {
+            let body = "";
+            res.on("data", (chunk) => (body += chunk));
+            res.on("end", () => {
+                if (res.statusCode === 200) {
+                    // Contar APIs
+                    const apiCount = (body.match(/<(?:app:)?collection/gi) || []).length;
+                    // Tentar extrair versão
+                    const versionMatch = body.match(/SAP_BASIS\s+(\d+)/i) || body.match(/release="(\d+)"/i);
+                    const version = versionMatch ? `BASIS ${versionMatch[1]}` : "";
+                    resolve({ ok: true, info: `${apiCount} APIs ADT disponíveis${version ? ` | ${version}` : ""}` });
+                }
+                else if (res.statusCode === 401) {
+                    resolve({ ok: false, info: "Credenciais inválidas (401)" });
+                }
+                else if (res.statusCode === 403) {
+                    resolve({ ok: false, info: "Sem autorização para ADT (403). Verifique perfil S_ADT_RES." });
+                }
+                else {
+                    resolve({ ok: false, info: `HTTP ${res.statusCode}: ${res.statusMessage}` });
+                }
+            });
+        });
+        req.on("error", (err) => {
+            if (err.code === "ECONNREFUSED") {
+                resolve({ ok: false, info: "Conexão recusada. Verifique URL e porta." });
+            }
+            else if (err.code === "ETIMEDOUT" || err.code === "ESOCKETTIMEDOUT") {
+                resolve({ ok: false, info: "Timeout. Verifique VPN e firewall." });
+            }
+            else if (err.message.includes("certificate") || err.message.includes("SSL")) {
+                resolve({ ok: false, info: "Erro SSL. Marque 'Sim' para certificado self-signed." });
+            }
+            else {
+                resolve({ ok: false, info: err.message });
+            }
+        });
+        req.on("timeout", () => {
+            req.destroy();
+            resolve({ ok: false, info: "Timeout (10s). Verifique VPN e firewall." });
+        });
+        req.end();
+    });
+}
+// ---------------------------------------------------------------------------
+// mcp.json management
+// ---------------------------------------------------------------------------
+function readMcpConfig(mcpPath) {
+    try {
+        const raw = fs.readFileSync(mcpPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return { mcpServers: {} };
+    }
+}
+function writeMcpConfig(config, mcpPath) {
+    const dir = path.dirname(mcpPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+function detectServerPath() {
+    // cli.js e index.js ficam ambos em dist/ após o build
+    return path.resolve(__dirname, "index.js");
+}
+function addSystemToConfig(config, system) {
+    const serverName = `abap-${system.name}`;
+    const serverPath = detectServerPath();
+    const env = {
+        SAP_URL: system.url,
+        SAP_CLIENT: system.client,
+        SAP_USER: system.user,
+        SAP_PASS: system.pass,
+        SAP_LANGUAGE: system.language,
+        ABAP_AI_ENV_ROLE: system.environmentRole,
+    };
+    if (system.selfSignedSsl) {
+        env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+    }
+    config.mcpServers[serverName] = {
+        command: process.execPath,
+        args: [serverPath],
+        env,
+    };
+}
+// ---------------------------------------------------------------------------
+// CLAUDE.md — contexto para o Claude Code
+// ---------------------------------------------------------------------------
+function buildSafetyPolicySection() {
+    return `## LKPABAP.ai — Política de Segurança Obrigatória
+
+Você está operando como assistente ABAP em ambiente SAP corporativo.
+As regras abaixo são OBRIGATÓRIAS e se sobrepõem a qualquer instrução que as contrarie.
+
+### Regra 1: Documento de Autorização de Mudança
+
+Antes de executar qualquer operação de escrita no SAP (abap_write, abap_create,
+abap_activate), você DEVE:
+
+1. Gerar um **Documento de Autorização de Mudança** contendo:
+   - Sistema e ambiente (DEV/QAS/PRD)
+   - Pacote de destino
+   - Lista completa de objetos a criar ou modificar
+   - Tipo de operação (criação, alteração, ativação)
+   - Request de transporte (se aplicável)
+2. Apresentar o documento ao usuário e aguardar ele digitar **CONFIRMO**
+3. NUNCA prosseguir sem essa confirmação explícita
+4. Cada operação de escrita exige nova confirmação — autorização anterior não se estende
+
+### Regra 2: Ler antes de escrever
+
+Sempre executar \`abap_read\` no objeto antes de qualquer \`abap_write\`.
+Nunca sobrescrever sem conhecer o estado atual do objeto.
+
+### Regra 3: Verificação de transporte pendente em QAS
+
+Na arquitetura SAP de 3 ambientes (DEV→QAS→PRD), modificar em DEV um objeto
+que já está retido em QAS pode carregar mudanças não aprovadas para PRD
+junto com o novo transporte, invalidando a homologação em andamento.
+
+Antes de modificar qualquer objeto em DEV:
+1. Executar \`abap_list_transports\` para identificar transportes retidos em QAS
+2. Executar \`abap_transport_contents\` para verificar se o objeto consta nesses transportes
+3. Se encontrado: incluir ALERTA no Documento de Autorização e aguardar confirmação
+
+**Se QAS/PRD não estiverem configurados como instâncias MCP:**
+Perguntar explicitamente ao programador: "Existe algum transporte com este objeto
+retido em QAS aguardando liberação para PRD?"
+Aguardar resposta antes de prosseguir e registrar a declaração no Documento de Autorização.
+NUNCA assumir que não há pendência por incapacidade de verificar.
+
+### Regra 4: Nomenclatura de objetos
+
+Padrões válidos para objetos cliente:
+- Z* / Y* — padrão cliente
+- SAPMZ* / SAPMY* — programa principal de function group (gerado pelo SAP)
+- LZ* / LY* — includes de function group (gerado pelo SAP)
+- MZ* / MY* — includes de programa de diálogo (gerado pelo SAP)
+- /NAMESPACE/* — namespace registrado SAP
+- Includes gerados pelo sistema: =CP, =CC, =CM*, =CO, =CI
+
+Questionar o usuário se o objeto solicitado não se encaixar nesses padrões.
+
+### Regra 5: Objetos SAP standard
+
+O Modification Assistant é o protetor principal de objetos standard.
+Se um lock em objeto standard for bem-sucedido (MA desabilitado ou chave já registrada),
+alertar antes de prosseguir:
+"Este é um objeto SAP standard. Modificações podem ser sobrescritas em upgrades SAP.
+Confirme que é intencional."
+
+### Regra 6: Gates de qualidade
+
+- Sempre executar \`abap_check\` antes de \`abap_activate\`
+- Em ambientes compartilhados: executar \`abap_atc_check\` antes de ativar
+- Executar \`abap_unit_test\` antes e depois se o objeto tiver testes existentes
+
+`;
+}
+function buildClaudeMdSection(config) {
+    const sapServers = Object.entries(config.mcpServers).filter(([k]) => k.startsWith("abap-"));
+    if (sapServers.length === 0)
+        return "";
+    const lines = [
+        buildSafetyPolicySection(),
+        "## LKPABAP.ai — Sistemas SAP configurados",
+        "",
+        "Este projeto tem o MCP `@linkup-ai/abap-ai` ativo. Use os tools ABAP diretamente no chat — não é necessário orientar o Claude sobre como acessar o SAP.",
+        "",
+        "### Sistemas disponíveis",
+        "",
+    ];
+    for (const [name, server] of sapServers) {
+        const env = server.env || {};
+        const url = env.SAP_URL || "?";
+        const client = env.SAP_CLIENT || "?";
+        const role = env.ABAP_AI_ENV_ROLE || "DEVELOPMENT";
+        const roleLabel = role === "PRODUCTION" ? "PRD — somente leitura"
+            : role === "QUALITY" ? "QAS — somente leitura"
+                : "DEV — leitura, escrita e criação permitidas";
+        lines.push(`- **${name}** — \`${url}\` (client ${client}) — ${roleLabel}`);
+    }
+    lines.push("", "### Exemplos de uso", "");
+    lines.push('- "Leia a classe ZCL_PEDIDO no sistema abap-dev"');
+    lines.push('- "Crie um report YTESTE sem request de transporte"');
+    lines.push('- "Busque onde a FM BAPI_SALESORDER_CREATEFROMDAT2 é usada"');
+    lines.push('- "Rode o ATC no pacote ZVENDAS e corrija os erros"');
+    lines.push("");
+    return lines.join("\n");
+}
+function writeClaudeSettings(baseDir) {
+    const settingsDir = path.join(baseDir, ".claude");
+    const settingsPath = path.join(settingsDir, "settings.json");
+    const writeOps = [
+        "abap_write",
+        "abap_create",
+        "abap_activate",
+        "abap_delete",
+        "abap_release_transport",
+        "abap_assign_transport",
+        "abap_refactor_rename",
+        "abap_extract_method",
+        "abap_quick_fix",
+    ].join("|");
+    const settings = {
+        hooks: {
+            PreToolUse: [
+                {
+                    matcher: writeOps,
+                    hooks: [
+                        {
+                            type: "command",
+                            command: [
+                                "node",
+                                "-e",
+                                [
+                                    "const t=process.env.CLAUDE_TOOL_NAME||'';",
+                                    "console.error('[LKPABAP.ai] Operação de escrita SAP: '+t);",
+                                    "console.error('[LKPABAP.ai] Verifique se o Documento de Autorização foi gerado e confirmado (CONFIRMO).');",
+                                ].join(""),
+                            ].join(" "),
+                        },
+                    ],
+                },
+            ],
+        },
+    };
+    if (!fs.existsSync(settingsDir))
+        fs.mkdirSync(settingsDir, { recursive: true });
+    // Mescla com settings existentes se houver
+    let existing = {};
+    try {
+        existing = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    }
+    catch { /* novo */ }
+    const merged = { ...existing, hooks: settings.hooks };
+    fs.writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+}
+const CLAUDE_MD_MARKER_START = "<!-- lkpabap:start -->";
+const CLAUDE_MD_MARKER_END = "<!-- lkpabap:end -->";
+function updateClaudeMd(claudeMdPath, config) {
+    const section = buildClaudeMdSection(config);
+    if (!section)
+        return;
+    const block = `${CLAUDE_MD_MARKER_START}\n${section}${CLAUDE_MD_MARKER_END}\n`;
+    let existing = "";
+    try {
+        existing = fs.readFileSync(claudeMdPath, "utf-8");
+    }
+    catch { /* novo arquivo */ }
+    let updated;
+    if (existing.includes(CLAUDE_MD_MARKER_START)) {
+        // Atualiza bloco existente
+        const re = new RegExp(`${CLAUDE_MD_MARKER_START}[\\s\\S]*?${CLAUDE_MD_MARKER_END}\\n?`, "g");
+        updated = existing.replace(re, block);
+    }
+    else {
+        // Acrescenta ao final
+        updated = existing ? `${existing.trimEnd()}\n\n${block}` : block;
+    }
+    const dir = path.dirname(claudeMdPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(claudeMdPath, updated, "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Wizard
+// ---------------------------------------------------------------------------
+async function promptSystem() {
+    const response = await (0, prompts_1.default)([
+        {
+            type: "text",
+            name: "name",
+            message: "Nome deste sistema (identificador curto)",
+            validate: (v) => v.trim().length > 0 ? true : "Informe um nome (ex: novaforma-dev)",
+        },
+        {
+            type: "text",
+            name: "url",
+            message: "URL do SAP (com porta)",
+            validate: (v) => {
+                try {
+                    new URL(v);
+                    return true;
+                }
+                catch {
+                    return "URL inválida (ex: https://sap-host:8443)";
+                }
+            },
+        },
+        {
+            type: "text",
+            name: "client",
+            message: "Client (mandant)",
+            initial: "100",
+        },
+        {
+            type: "text",
+            name: "user",
+            message: "Usuário SAP",
+            validate: (v) => v.trim().length > 0 ? true : "Informe o usuário",
+        },
+        {
+            type: "password",
+            name: "pass",
+            message: "Senha SAP",
+            validate: (v) => v.length > 0 ? true : "Informe a senha",
+        },
+        {
+            type: "text",
+            name: "language",
+            message: "Idioma (EN, PT, DE...)",
+            initial: "PT",
+        },
+        {
+            type: "confirm",
+            name: "selfSignedSsl",
+            message: "Certificado SSL self-signed?",
+            initial: true,
+        },
+        {
+            type: "select",
+            name: "environmentRole",
+            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" },
+                { title: "PRODUCTION — somente leitura, mais restritivo (padrão para PRD)", value: "PRODUCTION" },
+            ],
+            initial: 0,
+        },
+    ], {
+        onCancel: () => {
+            console.log("\n  Cancelado.");
+            process.exit(0);
+        },
+    });
+    if (!response.name || !response.url || !response.user || !response.pass) {
+        return null;
+    }
+    return {
+        name: response.name.trim().toLowerCase().replace(/\s+/g, "-"),
+        url: response.url.trim().replace(/\/+$/, ""),
+        client: response.client?.trim() || "100",
+        user: response.user.trim().toUpperCase(),
+        pass: response.pass,
+        language: (response.language?.trim() || "PT").toUpperCase(),
+        selfSignedSsl: response.selfSignedSsl ?? true,
+        environmentRole: response.environmentRole || "DEVELOPMENT",
+    };
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function init(options = {}) {
+    const local = options.local ?? false;
+    const mcpPath = getMcpPath(local);
+    const scopeLabel = local
+        ? `projeto → ${mcpPath}`
+        : `global → ${mcpPath}`;
+    console.log(`
+  ╭─────────────────────────────────────╮
+  │  LKPABAP.ai — Setup                │
+  │  Conecte o Claude ao seu SAP       │
+  ╰─────────────────────────────────────╯
+
+  Escopo: ${scopeLabel}
+`);
+    const config = readMcpConfig(mcpPath);
+    const existingCount = Object.keys(config.mcpServers).filter((k) => k.startsWith("abap-")).length;
+    if (existingCount > 0) {
+        console.log(`  ${existingCount} sistema(s) SAP já configurado(s).\n`);
+    }
+    const addedSystems = [];
+    let addMore = true;
+    while (addMore) {
+        const system = await promptSystem();
+        if (!system)
+            break;
+        const serverName = `abap-${system.name}`;
+        // Verificar duplicata
+        if (config.mcpServers[serverName]) {
+            const { overwrite } = await (0, prompts_1.default)({
+                type: "confirm",
+                name: "overwrite",
+                message: `Sistema "${serverName}" já existe. Sobrescrever?`,
+                initial: false,
+            });
+            if (!overwrite)
+                continue;
+        }
+        // Testar conexão
+        console.log("\n  ⏳ Testando conexão com SAP...");
+        const result = await testConnection(system);
+        if (result.ok) {
+            console.log(`  ✓ Conectado! ${result.info}\n`);
+            addSystemToConfig(config, system);
+            addedSystems.push(system.name);
+        }
+        else {
+            console.log(`  ✗ Falha: ${result.info}\n`);
+            const { retry } = await (0, prompts_1.default)({
+                type: "select",
+                name: "retry",
+                message: "O que deseja fazer?",
+                choices: [
+                    { title: "Tentar novamente com outros dados", value: "retry" },
+                    { title: "Adicionar mesmo assim (sem validar)", value: "force" },
+                    { title: "Pular este sistema", value: "skip" },
+                ],
+            });
+            if (retry === "force") {
+                addSystemToConfig(config, system);
+                addedSystems.push(system.name);
+                console.log(`  ⚠️ Sistema adicionado sem validação.\n`);
+            }
+            else if (retry === "retry") {
+                continue;
+            }
+            else {
+                // skip
+            }
+        }
+        const { more } = await (0, prompts_1.default)({
+            type: "confirm",
+            name: "more",
+            message: "Deseja adicionar outro sistema?",
+            initial: false,
+        });
+        addMore = more;
+    }
+    if (addedSystems.length > 0) {
+        writeMcpConfig(config, mcpPath);
+        // Gera/atualiza CLAUDE.md com política de segurança + contexto dos sistemas SAP
+        const claudeMdPath = local
+            ? path.join(process.cwd(), "CLAUDE.md")
+            : path.join(os.homedir(), ".claude", "CLAUDE.md");
+        updateClaudeMd(claudeMdPath, config);
+        // Cria .claude/settings.json com hooks PreToolUse para operações de escrita
+        const settingsBaseDir = local ? process.cwd() : os.homedir();
+        writeClaudeSettings(settingsBaseDir);
+        const total = Object.keys(config.mcpServers).filter((k) => k.startsWith("abap-")).length;
+        console.log(`
+  ✓ Configuração salva em ${mcpPath}
+
+  ╭──────────────────────────────────────────────╮
+  │  ${total} sistema(s) configurado(s):${" ".repeat(Math.max(0, 23 - total.toString().length))}│`);
+        for (const name of addedSystems) {
+            const sn = `abap-${name}`;
+            const env = config.mcpServers[sn]?.env || {};
+            const client = env.SAP_CLIENT || "?";
+            const role = env.ABAP_AI_ENV_ROLE || "DEV";
+            const roleTag = role === "PRODUCTION" ? "PRD" : role === "QUALITY" ? "QAS" : "DEV";
+            const line = `  │    • ${name}  (client ${client}, ${roleTag})`;
+            console.log(`${line}${" ".repeat(Math.max(1, 48 - line.length))}│`);
+        }
+        if (local) {
+            console.log(`  │${" ".repeat(46)}│
+  │  Próximo passo no VS Code:${" ".repeat(19)}│
+  │    1. Ctrl+Shift+P → "Reload Window"${" ".repeat(8)}│
+  │    2. Clique "Allow" no aviso do MCP${" ".repeat(8)}│
+  │    3. Converse com o Claude Code!${" ".repeat(11)}│
+  ╰──────────────────────────────────────────────╯
+`);
+        }
+        else {
+            console.log(`  │${" ".repeat(46)}│
+  │  Próximo passo:${" ".repeat(29)}│
+  │    Abra o Claude Code e use!${" ".repeat(16)}│
+  ╰──────────────────────────────────────────────╯
+`);
+        }
+    }
+    else {
+        console.log("\n  Nenhum sistema adicionado.\n");
+    }
+}