@neetru/cli 2.20.3 → 2.22.0

package/dist/lib/code-agent-web-tools.js

@@ -0,0 +1,257 @@
+import { URL } from 'node:url';
+const WEB_TIMEOUT_MS = 15_000;
+const MAX_HTTP_BYTES = 900_000;
+const MAX_TOOL_OUTPUT_CHARS = 28_000;
+const DEFAULT_RESULTS = 5;
+const MAX_RESULTS = 10;
+function clipWebOutput(label, content) {
+    if (content.length <= MAX_TOOL_OUTPUT_CHARS)
+        return content;
+    return `${content.slice(0, MAX_TOOL_OUTPUT_CHARS)}\n\n[TRUNCADO: ${label} maior que ${MAX_TOOL_OUTPUT_CHARS} chars]`;
+}
+function parseLimit(value) {
+    const raw = typeof value === 'number' ? value : typeof value === 'string' ? Number.parseInt(value, 10) : NaN;
+    if (!Number.isFinite(raw))
+        return DEFAULT_RESULTS;
+    return Math.max(1, Math.min(MAX_RESULTS, Math.trunc(raw)));
+}
+function cleanText(value) {
+    return decodeHtml(value)
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<noscript[\s\S]*?<\/noscript>/gi, ' ')
+        .replace(/<svg[\s\S]*?<\/svg>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function decodeHtml(value) {
+    return value
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&nbsp;/g, ' ');
+}
+function assertSafePublicUrl(rawUrl) {
+    let parsed;
+    try {
+        parsed = new URL(rawUrl);
+    }
+    catch {
+        throw new Error(`URL invalida: ${rawUrl}`);
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol)) {
+        throw new Error('web_fetch aceita apenas http/https.');
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (host === 'localhost' ||
+        host.endsWith('.localhost') ||
+        host === 'metadata.google.internal' ||
+        host === '0.0.0.0' ||
+        host === '::1' ||
+        host === '[::1]' ||
+        /^127\./.test(host) ||
+        /^10\./.test(host) ||
+        /^192\.168\./.test(host) ||
+        /^169\.254\./.test(host) ||
+        /^172\.(1[6-9]|2\d|3[0-1])\./.test(host)) {
+        throw new Error(`Host bloqueado para evitar SSRF/local network: ${host}`);
+    }
+    return parsed;
+}
+async function fetchText(rawUrl, headers = {}) {
+    const url = assertSafePublicUrl(rawUrl);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), WEB_TIMEOUT_MS);
+    try {
+        const response = await fetch(url, {
+            headers: {
+                'accept': 'text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.3',
+                'user-agent': 'neetru-code/1.0 (+https://core.neetru.com)',
+                ...headers,
+            },
+            redirect: 'follow',
+            signal: controller.signal,
+        });
+        const contentLength = Number.parseInt(response.headers.get('content-length') ?? '', 10);
+        if (Number.isFinite(contentLength) && contentLength > MAX_HTTP_BYTES) {
+            throw new Error(`Resposta maior que ${MAX_HTTP_BYTES} bytes (${contentLength}).`);
+        }
+        const text = await response.text();
+        if (text.length > MAX_HTTP_BYTES) {
+            throw new Error(`Resposta maior que ${MAX_HTTP_BYTES} chars.`);
+        }
+        return {
+            url: response.url || url.toString(),
+            status: response.status,
+            contentType: response.headers.get('content-type') ?? '',
+            text,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function duckDuckGoUrl(rawHref) {
+    const href = decodeHtml(rawHref);
+    const full = href.startsWith('//') ? `https:${href}` : href;
+    try {
+        const url = new URL(full, 'https://duckduckgo.com');
+        const uddg = url.searchParams.get('uddg');
+        return uddg ? decodeURIComponent(uddg) : url.toString();
+    }
+    catch {
+        return href;
+    }
+}
+function parseDuckDuckGoHtml(html, limit) {
+    const results = [];
+    const seen = new Set();
+    const anchorRe = /<a[^>]+class=["'][^"']*result__a[^"']*["'][^>]+href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi;
+    let match;
+    while ((match = anchorRe.exec(html)) && results.length < limit) {
+        const url = duckDuckGoUrl(match[1]);
+        if (!/^https?:\/\//i.test(url) || seen.has(url))
+            continue;
+        seen.add(url);
+        const title = cleanText(match[2]);
+        const after = html.slice(anchorRe.lastIndex, anchorRe.lastIndex + 1800);
+        const snippetMatch = after.match(/class=["'][^"']*result__snippet[^"']*["'][^>]*>([\s\S]*?)<\/(?:a|div)>/i);
+        const snippet = snippetMatch ? cleanText(snippetMatch[1]) : undefined;
+        results.push({ title: title || url, url, snippet });
+    }
+    return results;
+}
+function formatSearchResults(label, query, results) {
+    if (results.length === 0)
+        return `${label}: nenhuma ocorrencia encontrada para "${query}".`;
+    const rows = [`${label}: "${query}"`, ''];
+    for (const [index, result] of results.entries()) {
+        rows.push(`${index + 1}. ${result.title}`);
+        rows.push(`   URL: ${result.url}`);
+        if (result.snippet)
+            rows.push(`   Trecho: ${result.snippet}`);
+    }
+    return clipWebOutput(label, rows.join('\n'));
+}
+export async function webSearchTool(query, limitValue) {
+    const trimmed = query.trim();
+    if (!trimmed)
+        return 'ERRO: web_search exige query string nao vazia.';
+    const limit = parseLimit(limitValue);
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(trimmed)}`;
+    const response = await fetchText(url);
+    if (response.status < 200 || response.status >= 300) {
+        return `ERRO: web_search HTTP ${response.status} em DuckDuckGo.`;
+    }
+    return formatSearchResults('web_search', trimmed, parseDuckDuckGoHtml(response.text, limit));
+}
+function htmlToReadableText(html) {
+    const title = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1];
+    const body = cleanText(html);
+    return [title ? `Titulo: ${cleanText(title)}` : '', body].filter(Boolean).join('\n\n');
+}
+export async function webFetchTool(rawUrl) {
+    const response = await fetchText(rawUrl);
+    if (response.status < 200 || response.status >= 300) {
+        return `ERRO: web_fetch HTTP ${response.status} em ${response.url}.`;
+    }
+    const isHtml = /html/i.test(response.contentType) || /<\/?[a-z][\s\S]*>/i.test(response.text);
+    const readable = isHtml ? htmlToReadableText(response.text) : response.text;
+    return clipWebOutput('web_fetch', [
+        `URL: ${response.url}`,
+        `status: ${response.status}`,
+        response.contentType ? `content-type: ${response.contentType}` : '',
+        '',
+        readable.trim() || '(sem corpo legivel)',
+    ].filter(Boolean).join('\n'));
+}
+async function fetchGithubJson(url) {
+    const response = await fetchText(url, {
+        accept: 'application/vnd.github+json',
+        'x-github-api-version': '2022-11-28',
+    });
+    if (response.status < 200 || response.status >= 300) {
+        return {
+            error: `GitHub HTTP ${response.status}`,
+            body: response.text.slice(0, 500),
+        };
+    }
+    return JSON.parse(response.text);
+}
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+export async function githubSearchTool(query, limitValue) {
+    const trimmed = query.trim();
+    if (!trimmed)
+        return 'ERRO: github_search exige query string nao vazia.';
+    const limit = parseLimit(limitValue);
+    const url = `https://api.github.com/search/repositories?q=${encodeURIComponent(trimmed)}&sort=stars&order=desc&per_page=${limit}`;
+    const payload = asRecord(await fetchGithubJson(url));
+    if (payload.error)
+        return `ERRO: ${String(payload.error)}\n${String(payload.body ?? '')}`.trim();
+    const items = Array.isArray(payload.items) ? payload.items.map(asRecord) : [];
+    const rows = [`github_search: "${trimmed}"`, ''];
+    for (const [index, item] of items.slice(0, limit).entries()) {
+        const fullName = typeof item.full_name === 'string' ? item.full_name : '(repo sem nome)';
+        const htmlUrl = typeof item.html_url === 'string' ? item.html_url : '';
+        const description = typeof item.description === 'string' && item.description ? item.description : '(sem descricao)';
+        const stars = typeof item.stargazers_count === 'number' ? item.stargazers_count : 0;
+        const language = typeof item.language === 'string' ? item.language : 'n/a';
+        const license = asRecord(item.license).spdx_id;
+        const topics = Array.isArray(item.topics) ? item.topics.filter((v) => typeof v === 'string') : [];
+        rows.push(`${index + 1}. ${fullName} (${stars} stars, ${language}, licenca ${typeof license === 'string' ? license : 'n/a'})`);
+        if (htmlUrl)
+            rows.push(`   URL: ${htmlUrl}`);
+        rows.push(`   Descricao: ${description}`);
+        if (topics.length)
+            rows.push(`   Topicos: ${topics.slice(0, 10).join(', ')}`);
+    }
+    if (items.length === 0)
+        rows.push('(nenhum repositorio encontrado)');
+    return clipWebOutput('github_search', rows.join('\n'));
+}
+function normalizeRepoName(value) {
+    const repo = value.trim().replace(/^https:\/\/github\.com\//i, '').replace(/\/+$/, '');
+    if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repo)) {
+        throw new Error('github_repo exige repo no formato owner/name.');
+    }
+    return repo;
+}
+export async function githubRepoTool(rawRepo) {
+    const repo = normalizeRepoName(rawRepo);
+    const metadata = asRecord(await fetchGithubJson(`https://api.github.com/repos/${repo}`));
+    if (metadata.error)
+        return `ERRO: ${String(metadata.error)}\n${String(metadata.body ?? '')}`.trim();
+    const readmeResponse = await fetchText(`https://api.github.com/repos/${repo}/readme`, {
+        accept: 'application/vnd.github.raw',
+        'x-github-api-version': '2022-11-28',
+    }).catch((error) => ({
+        url: `https://api.github.com/repos/${repo}/readme`,
+        status: 0,
+        contentType: '',
+        text: `README indisponivel: ${error instanceof Error ? error.message : String(error)}`,
+    }));
+    const license = asRecord(metadata.license).spdx_id;
+    const topics = Array.isArray(metadata.topics) ? metadata.topics.filter((v) => typeof v === 'string') : [];
+    const rows = [
+        `repo: ${typeof metadata.full_name === 'string' ? metadata.full_name : repo}`,
+        `URL: ${typeof metadata.html_url === 'string' ? metadata.html_url : `https://github.com/${repo}`}`,
+        `descricao: ${typeof metadata.description === 'string' && metadata.description ? metadata.description : '(sem descricao)'}`,
+        `stars: ${typeof metadata.stargazers_count === 'number' ? metadata.stargazers_count : 0}`,
+        `linguagem: ${typeof metadata.language === 'string' ? metadata.language : 'n/a'}`,
+        `licenca: ${typeof license === 'string' ? license : 'n/a'}`,
+        topics.length ? `topicos: ${topics.slice(0, 16).join(', ')}` : '',
+        '',
+        'README:',
+        readmeResponse.status >= 200 && readmeResponse.status < 300
+            ? readmeResponse.text.trim()
+            : `README indisponivel (HTTP ${readmeResponse.status}).`,
+    ].filter(Boolean);
+    return clipWebOutput('github_repo', rows.join('\n'));
+}
+//# sourceMappingURL=code-agent-web-tools.js.map

package/dist/lib/code-agent-web-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-web-tools.js","sourceRoot":"","sources":["../../src/lib/code-agent-web-tools.ts"],"names":[],"mappings":"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"}

package/dist/lib/code-agent-write-tools.d.ts

@@ -0,0 +1,5 @@
+import type { CodeToolRequest } from './code-agent-protocol.js';
+import type { CodeToolContext } from './code-agent-types.js';
+export declare function writeFileTool(rootDir: string, request: CodeToolRequest, ctx: CodeToolContext): Promise<string>;
+export declare function appendFileTool(rootDir: string, request: CodeToolRequest, ctx: CodeToolContext): Promise<string>;
+export declare function replaceInFileTool(rootDir: string, request: CodeToolRequest, ctx: CodeToolContext): Promise<string>;

package/dist/lib/code-agent-write-tools.js

@@ -0,0 +1,141 @@
+/**
+ * Ferramentas deterministicas de escrita do `neetru code` — write_file,
+ * append_file, replace_in_file (2026-07-13). Existem pra tirar do
+ * NEETRU_PATCH (unified diff cru gerado pelo modelo, so validado por `git
+ * apply --check`, sem reparo de hunk/CRLF/newline) o papel de UNICO caminho
+ * de escrita — achado em uso real (transcript colado pelo usuario: o modelo
+ * ficava preso reescrevendo o mesmo diff quebrado, esgotando o orcamento de
+ * turnos inteiro sem nunca conseguir mudar o arquivo) + diagnostico
+ * confirmado por revisao de codigo (Codex). NEETRU_PATCH continua existindo
+ * pra mudancas que precisam de diff multi-arquivo/multi-hunk num so turno;
+ * estas 3 ferramentas viram o caminho PRINCIPAL pra criar/editar UM arquivo.
+ *
+ * Nivel de cautela: local e reversivel (git mostra a mudanca depois, `git
+ * checkout`/`git restore` desfaz) — mesmo tier de git_commit/git_branch:
+ * `--yes`/`/yes` dispensa a pergunta, senao confirma mostrando o preview.
+ * Path sempre resolvido via `resolveInside` (contencao + symlink real path,
+ * mesma guarda de read_file); escrita em arquivo de segredo (.env/chave)
+ * bloqueada, espelhando o bloqueio de leitura.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { clipToolOutput, isSecretPath, resolveInside } from './code-agent-files.js';
+const MAX_WRITE_CONTENT_CHARS = 200_000;
+const PREVIEW_MAX_LINES = 12;
+const PREVIEW_MAX_CHARS = 600;
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function relativeOf(rootDir, fullPath) {
+    return path.relative(path.resolve(rootDir), fullPath).replace(/\\/g, '/');
+}
+/** Resolve+valida o path (contencao/symlink/segredo) — lanca em qualquer problema; `runCodeTool` converte pra `ERRO: ...`. */
+function guardPath(rootDir, inputPath) {
+    if (typeof inputPath !== 'string' || !inputPath.trim()) {
+        throw new Error('exige path string nao vazio.');
+    }
+    const full = resolveInside(rootDir, inputPath.trim());
+    const relative = relativeOf(rootDir, full);
+    if (isSecretPath(relative)) {
+        throw new Error(`escrita bloqueada: "${relative}" parece arquivo de segredo (.env/chave/credencial).`);
+    }
+    return { full, relative };
+}
+// Mesma lista de code-agent-git-tools.ts: ESC/CR no conteudo (que pode vir
+// "repetido" de um arquivo lido — prompt injection) nao pode reescrever
+// visualmente o preview de confirmacao.
+function sanitizeForPreview(value) {
+    return value.replace(/[\x00-\x08\x0B-\x1F\x7F-\x9F]/g, '');
+}
+function previewSnippet(content) {
+    const clipped = content.length > PREVIEW_MAX_CHARS ? `${content.slice(0, PREVIEW_MAX_CHARS)}…` : content;
+    const lines = sanitizeForPreview(clipped).split(/\r?\n/);
+    const shown = lines.slice(0, PREVIEW_MAX_LINES).map((l) => `    ${l}`);
+    if (lines.length > PREVIEW_MAX_LINES)
+        shown.push(`    ... mais ${lines.length - PREVIEW_MAX_LINES} linha(s)`);
+    return shown.join('\n');
+}
+function assertContentSize(tool, content) {
+    if (content.length > MAX_WRITE_CONTENT_CHARS) {
+        throw new Error(`${tool}: content maior que ${MAX_WRITE_CONTENT_CHARS} chars — quebre em partes menores.`);
+    }
+}
+export async function writeFileTool(rootDir, request, ctx) {
+    const guard = guardPath(rootDir, request.path);
+    const content = asString(request.content);
+    if (content === undefined)
+        return 'ERRO: write_file exige content string.';
+    assertContentSize('write_file', content);
+    const exists = fs.existsSync(guard.full);
+    const before = exists ? fs.statSync(guard.full).size : null;
+    const action = exists
+        ? `sobrescrever arquivo existente (${before} -> ${content.length} chars)`
+        : 'criar arquivo novo';
+    const preview = [
+        `write_file ${guard.relative}`,
+        `  acao: ${action}`,
+        '  conteudo:',
+        previewSnippet(content),
+    ].join('\n');
+    const approved = ctx.settings.yes || (await ctx.confirm(`${preview}\n\nEscrever este arquivo? [y/N] `));
+    if (!approved)
+        return 'ERRO: escrita cancelada pelo usuario.';
+    fs.mkdirSync(path.dirname(guard.full), { recursive: true });
+    fs.writeFileSync(guard.full, content, 'utf8');
+    return clipToolOutput('write_file', `OK: ${exists ? 'sobrescrito' : 'criado'} ${guard.relative} (${content.length} chars).`);
+}
+export async function appendFileTool(rootDir, request, ctx) {
+    const guard = guardPath(rootDir, request.path);
+    const content = asString(request.content);
+    if (content === undefined)
+        return 'ERRO: append_file exige content string.';
+    assertContentSize('append_file', content);
+    const preview = [
+        `append_file ${guard.relative}`,
+        '  conteudo a adicionar no final:',
+        previewSnippet(content),
+    ].join('\n');
+    const approved = ctx.settings.yes || (await ctx.confirm(`${preview}\n\nAdicionar ao final do arquivo? [y/N] `));
+    if (!approved)
+        return 'ERRO: escrita cancelada pelo usuario.';
+    fs.mkdirSync(path.dirname(guard.full), { recursive: true });
+    fs.appendFileSync(guard.full, content, 'utf8');
+    return clipToolOutput('append_file', `OK: adicionado ao final de ${guard.relative} (+${content.length} chars).`);
+}
+export async function replaceInFileTool(rootDir, request, ctx) {
+    const guard = guardPath(rootDir, request.path);
+    const oldString = asString(request.old_string);
+    const newString = asString(request.new_string);
+    if (!oldString)
+        return 'ERRO: replace_in_file exige old_string string nao vazio.';
+    if (newString === undefined)
+        return 'ERRO: replace_in_file exige new_string string.';
+    if (!fs.existsSync(guard.full))
+        return `ERRO: replace_in_file arquivo nao existe: ${guard.relative}`;
+    const before = fs.readFileSync(guard.full, 'utf8');
+    const occurrences = before.split(oldString).length - 1;
+    if (occurrences === 0) {
+        return `ERRO: old_string nao encontrado em ${guard.relative}. Releia o arquivo antes de tentar de novo.`;
+    }
+    const replaceAll = request.replace_all === true;
+    if (occurrences > 1 && !replaceAll) {
+        return (`ERRO: old_string aparece ${occurrences}x em ${guard.relative} — inclua mais contexto pra ficar unico, ` +
+            'ou use "replace_all":true de proposito.');
+    }
+    const after = replaceAll ? before.split(oldString).join(newString) : before.replace(oldString, newString);
+    assertContentSize('replace_in_file', after);
+    const preview = [
+        `replace_in_file ${guard.relative}`,
+        `  ocorrencias: ${occurrences}${replaceAll ? ' (todas)' : ''}`,
+        '  de:',
+        previewSnippet(oldString),
+        '  para:',
+        previewSnippet(newString),
+    ].join('\n');
+    const approved = ctx.settings.yes || (await ctx.confirm(`${preview}\n\nAplicar esta substituicao? [y/N] `));
+    if (!approved)
+        return 'ERRO: substituicao cancelada pelo usuario.';
+    fs.writeFileSync(guard.full, after, 'utf8');
+    return clipToolOutput('replace_in_file', `OK: ${occurrences} ocorrencia(s) substituida(s) em ${guard.relative}.`);
+}
+//# sourceMappingURL=code-agent-write-tools.js.map

package/dist/lib/code-agent-write-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-write-tools.js","sourceRoot":"","sources":["../../src/lib/code-agent-write-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,uBAAuB,GAAG,OAAO,CAAC;AACxC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,QAAgB;IACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED,8HAA8H;AAC9H,SAAS,SAAS,CAAC,OAAe,EAAE,SAAkB;IACpD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,sDAAsD,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,2EAA2E;AAC3E,wEAAwE;AACxE,wCAAwC;AACxC,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IACzG,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAiB;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,MAAM,GAAG,iBAAiB,WAAW,CAAC,CAAC;IAC9G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,OAAe;IACtD,IAAI,OAAO,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uBAAuB,uBAAuB,oCAAoC,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,OAAwB,EACxB,GAAoB;IAEpB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,wCAAwC,CAAC;IAC3E,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,mCAAmC,MAAM,OAAO,OAAO,CAAC,MAAM,SAAS;QACzE,CAAC,CAAC,oBAAoB,CAAC;IACzB,MAAM,OAAO,GAAG;QACd,cAAc,KAAK,CAAC,QAAQ,EAAE;QAC9B,WAAW,MAAM,EAAE;QACnB,aAAa;QACb,cAAc,CAAC,OAAO,CAAC;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,mCAAmC,CAAC,CAAC,CAAC;IACxG,IAAI,CAAC,QAAQ;QAAE,OAAO,uCAAuC,CAAC;IAE9D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,cAAc,CACnB,YAAY,EACZ,OAAO,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,UAAU,CACxF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,OAAwB,EACxB,GAAoB;IAEpB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,yCAAyC,CAAC;IAC5E,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG;QACd,eAAe,KAAK,CAAC,QAAQ,EAAE;QAC/B,kCAAkC;QAClC,cAAc,CAAC,OAAO,CAAC;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,2CAA2C,CAAC,CAAC,CAAC;IAChH,IAAI,CAAC,QAAQ;QAAE,OAAO,uCAAuC,CAAC;IAE9D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,cAAc,CAAC,aAAa,EAAE,8BAA8B,KAAK,CAAC,QAAQ,MAAM,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;AACnH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,OAAwB,EACxB,GAAoB;IAEpB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS;QAAE,OAAO,0DAA0D,CAAC;IAClF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,gDAAgD,CAAC;IACrF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,6CAA6C,KAAK,CAAC,QAAQ,EAAE,CAAC;IAErG,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACvD,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,sCAAsC,KAAK,CAAC,QAAQ,6CAA6C,CAAC;IAC3G,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC;IAChD,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACnC,OAAO,CACL,4BAA4B,WAAW,QAAQ,KAAK,CAAC,QAAQ,2CAA2C;YACxG,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1G,iBAAiB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG;QACd,mBAAmB,KAAK,CAAC,QAAQ,EAAE;QACnC,kBAAkB,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9D,OAAO;QACP,cAAc,CAAC,SAAS,CAAC;QACzB,SAAS;QACT,cAAc,CAAC,SAAS,CAAC;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,uCAAuC,CAAC,CAAC,CAAC;IAC5G,IAAI,CAAC,QAAQ;QAAE,OAAO,4CAA4C,CAAC;IAEnE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,cAAc,CAAC,iBAAiB,EAAE,OAAO,WAAW,oCAAoC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;AACpH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neetru/cli",
-  "version": "2.20.3",
+  "version": "2.22.0",
   "type": "module",
   "description": "Neetru Developer Kit — scaffold, AI assistant, publish, build e deploy de produtos SaaS Neetru via Core (VM-based agents)",
   "keywords": [