@neetru/cli 2.21.0 → 2.24.0

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":"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"}

package/dist/lib/dev-local-context.d.ts

@@ -0,0 +1,29 @@
+export type DevContextMode = 'core-product' | 'prototype';
+export interface LocalProductConfig {
+    slug?: string;
+    productId?: string;
+    tenantId?: string;
+    runtime?: string;
+    name?: string;
+}
+export interface DevLocalContext {
+    version: 1;
+    mode: DevContextMode;
+    productSlug?: string;
+    productId?: string;
+    workspaceId?: string;
+    environmentId?: string;
+    corePath?: string;
+    emulatorOnly?: string;
+    source?: 'manual' | 'core' | 'inferred';
+    updatedAt: string;
+}
+export declare const DEV_CONTEXT_REL = ".neetru/dev.json";
+export declare function devContextPath(cwd?: string): string;
+export declare function loadLocalProductConfig(cwd?: string): LocalProductConfig | null;
+export declare function normalizeDevContext(raw: unknown): DevLocalContext | null;
+export declare function loadDevContext(cwd?: string): DevLocalContext | null;
+export declare function saveDevContext(cwd: string, context: Omit<DevLocalContext, 'version' | 'updatedAt'> & Partial<Pick<DevLocalContext, 'updatedAt'>>): DevLocalContext;
+export declare function inferDevContext(cwd?: string): DevLocalContext | null;
+export declare function resolveDevContext(cwd?: string): DevLocalContext | null;
+export declare function describeDevContext(context: DevLocalContext | null): string;

package/dist/lib/dev-local-context.js

@@ -0,0 +1,114 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export const DEV_CONTEXT_REL = '.neetru/dev.json';
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringField(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+export function devContextPath(cwd = process.cwd()) {
+    return path.join(cwd, DEV_CONTEXT_REL);
+}
+export function loadLocalProductConfig(cwd = process.cwd()) {
+    for (const filename of ['neetru.config.json', '.neetru.json']) {
+        const filePath = path.join(cwd, filename);
+        if (!fs.existsSync(filePath))
+            continue;
+        try {
+            const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            if (!isObject(parsed))
+                return null;
+            return {
+                slug: stringField(parsed.slug),
+                productId: stringField(parsed.productId),
+                tenantId: stringField(parsed.tenantId),
+                runtime: stringField(parsed.runtime),
+                name: stringField(parsed.name),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+export function normalizeDevContext(raw) {
+    if (!isObject(raw))
+        return null;
+    const mode = raw.mode === 'core-product' || raw.mode === 'prototype' ? raw.mode : undefined;
+    if (!mode)
+        return null;
+    return {
+        version: 1,
+        mode,
+        productSlug: stringField(raw.productSlug),
+        productId: stringField(raw.productId),
+        workspaceId: stringField(raw.workspaceId),
+        environmentId: stringField(raw.environmentId),
+        corePath: stringField(raw.corePath),
+        emulatorOnly: stringField(raw.emulatorOnly),
+        source: raw.source === 'manual' || raw.source === 'core' || raw.source === 'inferred'
+            ? raw.source
+            : undefined,
+        updatedAt: stringField(raw.updatedAt) ?? new Date().toISOString(),
+    };
+}
+export function loadDevContext(cwd = process.cwd()) {
+    const filePath = devContextPath(cwd);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        return normalizeDevContext(JSON.parse(fs.readFileSync(filePath, 'utf8')));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveDevContext(cwd, context) {
+    const full = {
+        version: 1,
+        ...context,
+        updatedAt: context.updatedAt ?? new Date().toISOString(),
+    };
+    const filePath = devContextPath(cwd);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(full, null, 2) + '\n', 'utf8');
+    return full;
+}
+export function inferDevContext(cwd = process.cwd()) {
+    const local = loadLocalProductConfig(cwd);
+    if (!local?.slug && !local?.productId)
+        return null;
+    return {
+        version: 1,
+        mode: local.productId ? 'core-product' : 'prototype',
+        productSlug: local.slug,
+        productId: local.productId,
+        workspaceId: local.tenantId,
+        source: 'inferred',
+        updatedAt: new Date().toISOString(),
+    };
+}
+export function resolveDevContext(cwd = process.cwd()) {
+    const saved = loadDevContext(cwd);
+    const inferred = inferDevContext(cwd);
+    if (!saved)
+        return inferred;
+    return {
+        ...saved,
+        productSlug: saved.productSlug ?? inferred?.productSlug,
+        productId: saved.productId ?? inferred?.productId,
+        workspaceId: saved.workspaceId ?? inferred?.workspaceId,
+    };
+}
+export function describeDevContext(context) {
+    if (!context)
+        return 'sem contexto dev-local';
+    const product = context.productSlug ?? context.productId ?? 'sem produto';
+    const mode = context.mode === 'prototype' ? 'protótipo local' : 'produto Core';
+    const env = context.environmentId ? ` · env=${context.environmentId}` : '';
+    const workspace = context.workspaceId ? ` · workspace=${context.workspaceId}` : '';
+    return `${mode}: ${product}${env}${workspace}`;
+}
+//# sourceMappingURL=dev-local-context.js.map

package/dist/lib/dev-local-context.js.map

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

package/package.json

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