@neetru/cli 2.14.0 → 2.16.0

package/dist/lib/code-agent-session.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Orçamento de payload TOTAL do histórico antes de disparar auto-compact
+ * (GAP-M1-15). 3x o limite por mensagem — margem suficiente pra várias
+ * tool results grandes coexistirem sem se aproximar do teto de payload
+ * observado no provider (HTTP 413), sem compactar cedo demais em sessões
+ * normais (poucos turnos, resultados pequenos).
+ */
+export declare const MAX_HISTORY_TOTAL_CHARS: number;
+/**
+ * Máquina de estados da sessão do `neetru code` (Fase 2,
+ * NEETRU_CODE_ARCHITECTURE.md: "Estados da sessão" — "hoje isso esta
+ * implicito por prints; o proximo passo e transformar em estrutura
+ * testavel"). Pura, sem I/O — commands/code.ts chama `transition()` nos
+ * pontos do loop de turno; testes verificam a sequência sem mockar o
+ * AI Gateway inteiro.
+ */
+export type CodeAgentState = 'idle' | 'thinking' | 'tool_requested' | 'tool_running' | 'patch_ready' | 'awaiting_confirm' | 'applied' | 'failed' | 'aborted';
+export declare class CodeAgentStateMachine {
+    private current;
+    private readonly log;
+    get state(): CodeAgentState;
+    /** Histórico de estados desde a criação (ou último `reset`). Só leitura. */
+    get history(): readonly CodeAgentState[];
+    transition(next: CodeAgentState): void;
+    reset(): void;
+}
+export type CodeSessionRole = 'system' | 'user' | 'assistant';
+export interface CodeSessionMessage {
+    role: CodeSessionRole;
+    content: string;
+}
+export interface CodeSessionSnapshot {
+    cwd: string;
+    model: string;
+}
+export declare function compactCodeHistory<T extends CodeSessionMessage>(history: T[], keepRecent?: number): number;
+/**
+ * GAP-M1-15 (2026-07-10): `compactCodeHistory` só rodava via `/compact`
+ * manual — numa sessao com varias tool calls (cada resultado pode chegar a
+ * MAX_GATEWAY_SAFE_CHARS ~28k), o payload TOTAL da requisicao (soma de todas
+ * as mensagens) cresce sem limite ate estourar HTTP 413 (Payload Too Large)
+ * no provider, mesmo com cada mensagem individual dentro do limite. Achado
+ * rodando `neetru code` de verdade: 4 turnos com tool results grandes
+ * bastaram pra estourar o Groq.
+ *
+ * Compacta por TAMANHO (soma de `content.length`), nao por contagem —
+ * remove as mensagens mais antigas (preservando sempre `system` e a
+ * ultima mensagem, que e o turno atual) ate caber no orcamento. Diferente
+ * de `compactCodeHistory` (contagem fixa), aqui uma unica tool result
+ * gigante ja pode disparar a compactacao mesmo com poucas mensagens.
+ */
+export declare function compactHistoryToFit<T extends CodeSessionMessage>(history: T[], maxTotalChars: number): number;
+export declare function formatCodeSessionMarkdown(settings: CodeSessionSnapshot, history: CodeSessionMessage[]): string;
+export declare function saveCodeSession(settings: CodeSessionSnapshot, history: CodeSessionMessage[]): string;
+/**
+ * Retomar sessao por id (Fase 4, NEETRU_CODE_ARCHITECTURE.md) — mesmo padrao
+ * de UX de qualquer REPL com persistencia (lista sessoes salvas, numera,
+ * usuario escolhe). Nada disso vem de codigo alheio: e o jeito obvio de
+ * resolver "listar + escolher" numa CLI de terminal.
+ */
+export interface CodeSessionSummary {
+    /** Path relativo ao cwd (ex: `.neetru/code/sessions/2026-07-10T...-abc.md`). */
+    file: string;
+    timestamp: string;
+    messageCount: number;
+    /** Primeiras ~80 chars da primeira mensagem de usuario — ajuda a reconhecer a sessao na lista. */
+    preview: string;
+}
+/** Lista sessoes salvas, mais recente primeiro (nomes de arquivo ISO ordenam lexicograficamente). */
+export declare function listCodeSessions(cwd: string): CodeSessionSummary[];
+/** Carrega as mensagens de uma sessao salva (`file` relativo ao cwd, vindo de listCodeSessions). */
+export declare function loadCodeSession(cwd: string, file: string): CodeSessionMessage[];
+/**
+ * Log local de patch aplicado (Fase 4) — 1 linha por patch, append-only.
+ * Nao substitui git log/reflog; e so um resumo rapido "o que o agente mudou
+ * e quando", legivel sem abrir o git.
+ */
+export declare function logAppliedPatch(cwd: string, summary: string): void;

package/dist/lib/code-agent-session.js

@@ -0,0 +1,188 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { redactSecrets, MAX_GATEWAY_SAFE_CHARS } from './code-agent-files.js';
+/**
+ * Orçamento de payload TOTAL do histórico antes de disparar auto-compact
+ * (GAP-M1-15). 3x o limite por mensagem — margem suficiente pra várias
+ * tool results grandes coexistirem sem se aproximar do teto de payload
+ * observado no provider (HTTP 413), sem compactar cedo demais em sessões
+ * normais (poucos turnos, resultados pequenos).
+ */
+export const MAX_HISTORY_TOTAL_CHARS = MAX_GATEWAY_SAFE_CHARS * 3;
+const VALID_TRANSITIONS = {
+    idle: ['thinking'],
+    // thinking -> idle: turno terminou em texto final (sem tool nem patch).
+    thinking: ['tool_requested', 'patch_ready', 'idle', 'failed'],
+    tool_requested: ['tool_running'],
+    tool_running: ['thinking', 'failed'],
+    patch_ready: ['awaiting_confirm', 'applied', 'aborted'],
+    awaiting_confirm: ['applied', 'aborted'],
+    applied: ['idle'],
+    failed: ['idle'],
+    aborted: ['idle'],
+};
+export class CodeAgentStateMachine {
+    current = 'idle';
+    log = ['idle'];
+    get state() {
+        return this.current;
+    }
+    /** Histórico de estados desde a criação (ou último `reset`). Só leitura. */
+    get history() {
+        return this.log;
+    }
+    transition(next) {
+        const allowed = VALID_TRANSITIONS[this.current];
+        if (!allowed.includes(next)) {
+            throw new Error(`Transicao de estado invalida: ${this.current} -> ${next}`);
+        }
+        this.current = next;
+        this.log.push(next);
+    }
+    reset() {
+        this.current = 'idle';
+        this.log.length = 0;
+        this.log.push('idle');
+    }
+}
+export function compactCodeHistory(history, keepRecent = 8) {
+    if (history.length <= keepRecent + 1)
+        return 0;
+    const system = history.find((message) => message.role === 'system');
+    const recent = history.slice(-keepRecent);
+    const next = system ? [system, ...recent.filter((message) => message !== system)] : recent;
+    const removed = history.length - next.length;
+    history.splice(0, history.length, ...next);
+    return removed;
+}
+/**
+ * GAP-M1-15 (2026-07-10): `compactCodeHistory` só rodava via `/compact`
+ * manual — numa sessao com varias tool calls (cada resultado pode chegar a
+ * MAX_GATEWAY_SAFE_CHARS ~28k), o payload TOTAL da requisicao (soma de todas
+ * as mensagens) cresce sem limite ate estourar HTTP 413 (Payload Too Large)
+ * no provider, mesmo com cada mensagem individual dentro do limite. Achado
+ * rodando `neetru code` de verdade: 4 turnos com tool results grandes
+ * bastaram pra estourar o Groq.
+ *
+ * Compacta por TAMANHO (soma de `content.length`), nao por contagem —
+ * remove as mensagens mais antigas (preservando sempre `system` e a
+ * ultima mensagem, que e o turno atual) ate caber no orcamento. Diferente
+ * de `compactCodeHistory` (contagem fixa), aqui uma unica tool result
+ * gigante ja pode disparar a compactacao mesmo com poucas mensagens.
+ */
+export function compactHistoryToFit(history, maxTotalChars) {
+    const totalChars = (msgs) => msgs.reduce((sum, m) => sum + m.content.length, 0);
+    if (totalChars(history) <= maxTotalChars || history.length <= 1)
+        return 0;
+    const systemIdx = history.findIndex((m) => m.role === 'system');
+    const system = systemIdx >= 0 ? history[systemIdx] : null;
+    const rest = history.filter((_, i) => i !== systemIdx);
+    // Remove do mais antigo pro mais recente, sempre preservando a ultima
+    // mensagem (o turno atual) — sem ela o modelo perderia a propria pergunta.
+    while (rest.length > 1 && totalChars(system ? [system, ...rest] : rest) > maxTotalChars) {
+        rest.shift();
+    }
+    const next = system ? [system, ...rest] : rest;
+    const removed = history.length - next.length;
+    if (removed > 0)
+        history.splice(0, history.length, ...next);
+    return removed;
+}
+export function formatCodeSessionMarkdown(settings, history) {
+    const lines = [
+        '# Neetru Code Session',
+        '',
+        `- date: ${new Date().toISOString()}`,
+        `- cwd: ${settings.cwd}`,
+        `- model: ${settings.model}`,
+        `- messages: ${history.length}`,
+        '',
+        '## Conversa',
+        '',
+    ];
+    for (const message of history) {
+        lines.push(`### ${message.role}`);
+        lines.push('');
+        lines.push('```text');
+        lines.push(redactSecrets(message.content).slice(0, 40_000));
+        lines.push('```');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function saveCodeSession(settings, history) {
+    const dir = path.join(settings.cwd, '.neetru', 'code', 'sessions');
+    fs.mkdirSync(dir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const file = path.join(dir, `${stamp}.md`);
+    fs.writeFileSync(file, formatCodeSessionMarkdown(settings, history), 'utf8');
+    return path.relative(settings.cwd, file).replace(/\\/g, '/');
+}
+function sessionsDir(cwd) {
+    return path.join(cwd, '.neetru', 'code', 'sessions');
+}
+function parseSessionMarkdown(content) {
+    const dateMatch = content.match(/^- date: (.+)$/m);
+    const countMatch = content.match(/^- messages: (\d+)$/m);
+    const messages = [];
+    const blockRe = /### (system|user|assistant)\n\n```text\n([\s\S]*?)\n```/g;
+    let match;
+    while ((match = blockRe.exec(content))) {
+        messages.push({ role: match[1], content: match[2] });
+    }
+    return {
+        date: dateMatch?.[1] ?? '',
+        messageCount: countMatch ? Number.parseInt(countMatch[1], 10) : messages.length,
+        messages,
+    };
+}
+/** Lista sessoes salvas, mais recente primeiro (nomes de arquivo ISO ordenam lexicograficamente). */
+export function listCodeSessions(cwd) {
+    const dir = sessionsDir(cwd);
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith('.md')).sort().reverse();
+    return files.map((file) => {
+        const full = path.join(dir, file);
+        let content = '';
+        try {
+            content = fs.readFileSync(full, 'utf8');
+        }
+        catch {
+            content = '';
+        }
+        const parsed = parseSessionMarkdown(content);
+        const firstUser = parsed.messages.find((m) => m.role === 'user');
+        const preview = (firstUser?.content ?? '').replace(/\s+/g, ' ').trim().slice(0, 80);
+        return {
+            file: `.neetru/code/sessions/${file}`,
+            timestamp: parsed.date || file.replace(/\.md$/, ''),
+            messageCount: parsed.messageCount,
+            preview,
+        };
+    });
+}
+/** Carrega as mensagens de uma sessao salva (`file` relativo ao cwd, vindo de listCodeSessions). */
+export function loadCodeSession(cwd, file) {
+    const full = path.resolve(cwd, file);
+    if (!full.startsWith(path.resolve(sessionsDir(cwd)))) {
+        throw new Error(`Sessao fora do diretorio esperado: ${file}`);
+    }
+    if (!fs.existsSync(full)) {
+        throw new Error(`Sessao nao encontrada: ${file}`);
+    }
+    const content = fs.readFileSync(full, 'utf8');
+    return parseSessionMarkdown(content).messages;
+}
+/**
+ * Log local de patch aplicado (Fase 4) — 1 linha por patch, append-only.
+ * Nao substitui git log/reflog; e so um resumo rapido "o que o agente mudou
+ * e quando", legivel sem abrir o git.
+ */
+export function logAppliedPatch(cwd, summary) {
+    const dir = path.join(cwd, '.neetru', 'code');
+    fs.mkdirSync(dir, { recursive: true });
+    const file = path.join(dir, 'patches.log');
+    fs.appendFileSync(file, `${new Date().toISOString()} ${summary}\n`, 'utf8');
+}
+//# sourceMappingURL=code-agent-session.js.map

package/dist/lib/code-agent-session.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * Registro de ferramentas locais do `neetru code` — extraído de
+ * commands/code.ts (Fase 2, NEETRU_CODE_ARCHITECTURE.md: "separar núcleo de
+ * interface"). O system prompt é montado a partir do registro: Fase 3
+ * (run_tests, read_many_files, search_regex, project_symbols) só precisa
+ * adicionar entradas aqui — não editar o prompt à mão em vários lugares.
+ *
+ * Execução real das ferramentas (I/O de arquivo/git) mora em
+ * code-agent-files.ts — este módulo só descreve o protocolo pro modelo.
+ */
+export interface CodeToolDescriptor {
+    name: string;
+    /** Linha de invocação mostrada no system prompt (protocolo NEETRU_TOOL). */
+    usage: string;
+}
+export declare const CODE_TOOL_REGISTRY: CodeToolDescriptor[];
+export declare function buildSystemPrompt(): string;

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

@@ -0,0 +1,52 @@
+/**
+ * Registro de ferramentas locais do `neetru code` — extraído de
+ * commands/code.ts (Fase 2, NEETRU_CODE_ARCHITECTURE.md: "separar núcleo de
+ * interface"). O system prompt é montado a partir do registro: Fase 3
+ * (run_tests, read_many_files, search_regex, project_symbols) só precisa
+ * adicionar entradas aqui — não editar o prompt à mão em vários lugares.
+ *
+ * Execução real das ferramentas (I/O de arquivo/git) mora em
+ * code-agent-files.ts — este módulo só descreve o protocolo pro modelo.
+ */
+export const CODE_TOOL_REGISTRY = [
+    { name: 'read_file', usage: 'NEETRU_TOOL {"tool":"read_file","path":"caminho/relativo.ext"}' },
+    { name: 'list_files', usage: 'NEETRU_TOOL {"tool":"list_files","pattern":"texto opcional"}' },
+    { name: 'search', usage: 'NEETRU_TOOL {"tool":"search","query":"texto literal"}' },
+    { name: 'git_status', usage: 'NEETRU_TOOL {"tool":"git_status"}' },
+    { name: 'git_diff', usage: 'NEETRU_TOOL {"tool":"git_diff"}' },
+    { name: 'project_overview', usage: 'NEETRU_TOOL {"tool":"project_overview"}' },
+    // Fase 3 (NEETRU_CODE_ARCHITECTURE.md): ferramentas produtivas.
+    { name: 'read_many_files', usage: 'NEETRU_TOOL {"tool":"read_many_files","paths":["a.ts","b.ts"]}' },
+    { name: 'search_regex', usage: 'NEETRU_TOOL {"tool":"search_regex","pattern":"regex","flags":"i opcional"}' },
+    { name: 'run_tests', usage: 'NEETRU_TOOL {"tool":"run_tests"}' },
+    { name: 'project_symbols', usage: 'NEETRU_TOOL {"tool":"project_symbols","path":"opcional/um-arquivo.ts"}' },
+];
+export function buildSystemPrompt() {
+    const toolLines = CODE_TOOL_REGISTRY.map((tool) => tool.usage).join('\n');
+    return `
+Voce e o Neetru Code, um assistente local de codificacao da Neetru.
+Voce conversa com modelos do AI Gateway do Neetru Core, normalmente Groq/NVIDIA.
+Nao use Anthropic/Claude como caminho assumido.
+
+Voce nao tem tool calling nativo. Use exatamente estes protocolos textuais:
+
+${toolLines}
+
+Regras:
+- Peca arquivos antes de alterar codigo quando faltar contexto.
+- Use project_overview/git_status quando precisar entender o projeto antes de editar.
+- Use git_diff antes de revisar mudancas ja existentes.
+- Nunca invente conteudo de arquivo.
+- Peca uma tool por resposta, no maximo.
+- Quando estiver pronto para alterar, responda somente com um diff aplicavel por git:
+
+NEETRU_PATCH
+diff --git a/path b/path
+...
+NEETRU_END
+
+- Nao coloque explicacao dentro do bloco NEETRU_PATCH.
+- Se a tarefa nao exigir alteracao, responda em texto curto.
+`.trim();
+}
+//# sourceMappingURL=code-agent-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-tools.js","sourceRoot":"","sources":["../../src/lib/code-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,gEAAgE,EAAE;IAC9F,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,8DAA8D,EAAE;IAC7F,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,uDAAuD,EAAE;IAClF,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,mCAAmC,EAAE;IAClE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iCAAiC,EAAE;IAC9D,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,yCAAyC,EAAE;IAC9E,gEAAgE;IAChE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,gEAAgE,EAAE;IACpG,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,4EAA4E,EAAE;IAC7G,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kCAAkC,EAAE;IAChE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,wEAAwE,EAAE;CAC7G,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1E,OAAO;;;;;;;EAOP,SAAS;;;;;;;;;;;;;;;;;CAiBV,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/lib/code-agent-types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tipos compartilhados entre os módulos do `neetru code`
+ * (code.ts, code-agent-ui.ts, code-agent-gateway.ts, code-agent-tools.ts,
+ * code-agent-session.ts) — evita import circular de tipo entre eles.
+ */
+export type CodeRole = 'system' | 'user' | 'assistant';
+export interface CodeMessage {
+    role: CodeRole;
+    content: string;
+}
+export interface CodeCommandOptions {
+    cwd?: string;
+    file?: string[];
+    model?: string;
+    maxTurns?: string | number;
+    maxTokens?: string | number;
+    temperature?: string | number;
+    plan?: boolean;
+    apply?: boolean;
+    yes?: boolean;
+}
+export interface CodeSettings {
+    cwd: string;
+    files: string[];
+    model: string;
+    modelWarning?: string;
+    maxTurns: number;
+    maxTokens: number;
+    temperature: number;
+    apply: boolean;
+    yes: boolean;
+    timeoutMs: number;
+}
+export type ConfirmFn = (question: string) => Promise<boolean>;

package/dist/lib/code-agent-types.js

@@ -0,0 +1,7 @@
+/**
+ * Tipos compartilhados entre os módulos do `neetru code`
+ * (code.ts, code-agent-ui.ts, code-agent-gateway.ts, code-agent-tools.ts,
+ * code-agent-session.ts) — evita import circular de tipo entre eles.
+ */
+export {};
+//# sourceMappingURL=code-agent-types.js.map

package/dist/lib/code-agent-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-types.js","sourceRoot":"","sources":["../../src/lib/code-agent-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lib/code-agent-ui.d.ts

@@ -0,0 +1,49 @@
+import { type CodeToolRequest } from './code-agent-protocol.js';
+import type { CodeMessage, CodeSettings } from './code-agent-types.js';
+export declare function stripAnsi(text: string): string;
+export declare function visibleLength(text: string): number;
+export declare function padVisible(text: string, width: number): string;
+export declare function terminalWidth(): number;
+export declare function truncateMiddle(text: string, max: number): string;
+export declare function wrapPlain(text: string, width: number): string[];
+export declare function printBox(title: string, rows?: string[]): void;
+export declare function printStatusBar(settings: CodeSettings, mode: 'interactive' | 'oneshot' | 'doctor'): void;
+export declare function printDivider(label?: string): void;
+export declare function printEvent(kind: 'wait' | 'tool' | 'ok' | 'warn' | 'error', title: string, detail?: string): void;
+export interface TurnSpinner {
+    /** Atualiza o texto de detalhe (ex: "142 char(s) recebido(s)") na próxima animação. */
+    update(detail?: string): void;
+    /** Para o spinner e limpa a linha. */
+    stop(): void;
+}
+/**
+ * Spinner de turno — mostra progresso ao vivo (frame animado + cor rotativa +
+ * tempo decorrido MM:SS) enquanto o AI Gateway processa. Cobre TANTO o
+ * caminho de streaming quanto o fallback sem stream — antes o fallback ficava
+ * mudo até a resposta chegar ou o timeout estourar, sem nenhum feedback.
+ * Sem-op em saída não-TTY (pipe/CI/teste) — não faz sentido redesenhar linha.
+ */
+export declare function startTurnSpinner(label: string): TurnSpinner;
+export declare function summarizeToolResult(result: string): string;
+/**
+ * Resposta final do assistente — sem caixa ASCII (a caixa fazia `truncateMiddle`
+ * cortar linhas de prosa no meio, feio e ilegível). Marcador colorido + word-wrap
+ * natural do terminal, padrão comum de CLIs de chat modernas.
+ */
+export declare function printAssistantText(content: string): void;
+export declare function patchSummaryRows(patch: string): string[];
+export declare function printPatchPreview(patch: string): void;
+export declare function renderHeader(settings: CodeSettings, mode?: 'interactive' | 'oneshot' | 'doctor'): void;
+export declare function renderInteractiveHelp(): void;
+export declare function renderSessionStatus(settings: CodeSettings, history?: CodeMessage[]): void;
+export declare function renderPrompt(settings: CodeSettings): string;
+export declare function printFileSample(files: string[], total: number): void;
+/** Picker de arquivos (Fase 5) — lista numerada; `/pick` pede o(s) numero(s) ao usuario. */
+export declare function printFilePicker(files: string[], total: number): void;
+/** Lista sessoes salvas numeradas (Fase 4) — usuario escolhe pelo numero em `/resume`. */
+export declare function printSessionList(sessions: Array<{
+    timestamp: string;
+    messageCount: number;
+    preview: string;
+}>): void;
+export declare function toolDetail(tool: CodeToolRequest | null): string;