redmine-context 1.0.0 → 1.2.0

package/dist/surfaces/tui/screens/issue-detail.js

@@ -35,29 +35,47 @@ import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-run
  */
 import { Box, Text, useInput } from 'ink';
 import { useEffect, useRef } from 'react';
+import { journalDetailLabel, journalDetailValue } from '../../../index.js';
 import { attachmentStatusColor, attachmentStatusLabel, deriveAttachmentExtractionStatus, } from '../attachment-status.js';
 import { Spinner } from '../components/spinner.js';
 import { ScrollView } from '../components/scroll-view.js';
 import { glyphs } from '../glyphs.js';
 import { humanizeFileSize } from '../format-file-size.js';
 import { useIssueDetail } from '../hooks/use-issue-detail.js';
-import { useTerminalHeight } from '../hooks/use-terminal-width.js';
+import { useTerminalHeight, useTerminalWidth } from '../hooks/use-terminal-width.js';
 import { useNavigation } from '../navigation.js';
 import { statusColor } from '../status-color.js';
 import { symbols } from '../symbols.js';
 import { useTheme } from '../theme.js';
+import { truncate } from '../truncate.js';
+import { wrapText } from '../wrap.js';
 import { useHomeSelection } from './home-selection.js';
 import { useLoadedIssue } from './loaded-issue-context.js';
 /**
- * Overhead de linhas FORA da viewport de descrição (breadcrumb + título + meta +
- * rodapé + paddings). A viewport cresce com o terminal: `altura - OVERHEAD`
- * (#190). Com a altura default dos testes (24) dá 10 — o valor histórico — então
- * os snapshots/asserções de rolagem seguem iguais; em terminal real a descrição
- * usa quase toda a tela e só rola quando passa DE VERDADE.
+ * Overhead de linhas FORA da viewport de descrição: breadcrumb, título, meta,
+ * rodapé e paddings DESTA tela.
+ *
+ * A moldura da aplicação não entra na conta: o shell já entrega a altura sem
+ * ela (`TerminalHeightProvider` em `../app.tsx`). Contar a menos faz o viewport
+ * pedir mais linhas do que cabem — o conteúdo transborda e o Ink, que redesenha
+ * por diff, sobrescreve linhas já impressas.
  */
 const CONTENT_OVERHEAD_ROWS = 14;
 /** Piso da viewport (terminais muito baixos). */
 const CONTENT_MIN_HEIGHT = 6;
+/**
+ * Colunas consumidas fora do texto: moldura da aplicação (2), padding da tela
+ * (2) e uma folga de 2.
+ *
+ * A folga existe porque errar para MENOS é pior que perder duas colunas: uma
+ * linha larga demais seria truncada com `…` bem no fim (ou, sem o truncate,
+ * quebrada pelo Ink, furando a conta do viewport).
+ */
+const CONTENT_WIDTH_OVERHEAD = 6;
+/** Piso da largura de texto (terminais muito estreitos). */
+const CONTENT_MIN_WIDTH = 20;
+/** Corte de cada lado de uma alteração de journal (ver `buildContentRows`). */
+const DETAIL_VALUE_WIDTH = 40;
 /** Placeholder discreto para campos ausentes (assignee, autor/data de journal, old/new value). ASCII no Windows legado (#84). */
 const EMPTY_PLACEHOLDER = glyphs.emptyPlaceholder;
 /** Metadados fixos no topo: id/subject, status/prioridade, autor/responsável, datas. */
@@ -67,7 +85,7 @@ function IssueMeta({ issue, theme }) {
 /** Constrói a linha de um único anexo: nome (texto derivado, puro) · tamanho humanizado · content_type · badge de status. */
 function buildAttachmentRow(attachment, theme) {
     const status = deriveAttachmentExtractionStatus(attachment);
-    return (_jsxs(Text, { children: [attachment.filename, ' ', _jsxs(Text, { color: theme.muted, children: ["(", humanizeFileSize(attachment.filesize), " ", glyphs.middleDot, " ", attachment.content_type ?? EMPTY_PLACEHOLDER, ")"] }), ' ', _jsxs(Text, { color: attachmentStatusColor(theme, status), children: ["[", attachmentStatusLabel(status), "]"] })] }, `attachment-${attachment.id}`));
+    return (_jsxs(Text, { wrap: "truncate", children: [attachment.filename, ' ', _jsxs(Text, { color: theme.muted, children: ["(", humanizeFileSize(attachment.filesize), " ", glyphs.middleDot, " ", attachment.content_type ?? EMPTY_PLACEHOLDER, ")"] }), ' ', _jsxs(Text, { color: attachmentStatusColor(theme, status), children: ["[", attachmentStatusLabel(status), "]"] })] }, `attachment-${attachment.id}`));
 }
 /** Constrói as linhas da seção de anexos (após os journals): cabeçalho + 1 linha por anexo, ou "(nenhum)". */
 function buildAttachmentRows(issue, theme) {
@@ -85,15 +103,18 @@ function buildAttachmentRows(issue, theme) {
     return rows;
 }
 /** Constrói as linhas da viewport rolável: bloco de descrição + histórico cronológico de journals. */
-function buildContentRows(issue, theme) {
+function buildContentRows(issue, theme, width, lookups) {
     const rows = [];
     rows.push(_jsx(Text, { color: theme.primary, children: "Descri\u00E7\u00E3o" }, "desc-header"));
     if (issue.description === undefined || issue.description === '') {
         rows.push(_jsx(Text, { color: theme.muted, children: "(sem descri\u00E7\u00E3o)" }, "desc-empty"));
     }
     else {
-        issue.description.split('\n').forEach((line, index) => {
-            rows.push(_jsx(Text, { children: line.length > 0 ? line : ' ' }, `desc-${index}`));
+        // Quebra na largura ANTES de virar item: o ScrollView conta itens como
+        // linhas de tela, e um parágrafo longo (o caso comum de um chamado) faria o
+        // Ink quebrá-lo sozinho em várias, estourando o viewport.
+        wrapText(issue.description, width).forEach((line, index) => {
+            rows.push(_jsx(Text, { wrap: "truncate", children: line.length > 0 ? line : ' ' }, `desc-${index}`));
         });
     }
     rows.push(_jsx(Text, { children: " " }, "desc-spacer"));
@@ -104,15 +125,29 @@ function buildContentRows(issue, theme) {
     else {
         // Cronológico: preserva a ordem já entregue por `getIssue`/`normalizeIssue`.
         issue.journals.forEach((journal) => {
-            rows.push(_jsxs(Text, { color: theme.muted, children: [journal.user?.name ?? EMPTY_PLACEHOLDER, " ", glyphs.middleDot, " ", journal.created_on] }, `journal-${journal.id}-head`));
+            rows.push(_jsxs(Text, { color: theme.muted, wrap: "truncate", children: [journal.user?.name ?? EMPTY_PLACEHOLDER, " ", glyphs.middleDot, " ", journal.created_on] }, `journal-${journal.id}-head`));
             if (journal.notes !== undefined && journal.notes !== '') {
-                journal.notes.split('\n').forEach((line, index) => {
-                    rows.push(_jsx(Text, { children: line }, `journal-${journal.id}-note-${index}`));
+                wrapText(journal.notes, width).forEach((line, index) => {
+                    rows.push(_jsx(Text, { wrap: "truncate", children: line }, `journal-${journal.id}-note-${index}`));
                 });
             }
-            // Details estruturais resumidos: `campo: antigo → novo`, sempre em muted.
+            // Details resumidos: `campo: antigo → novo`, sempre em muted. Rótulos e
+            // ids vêm da MESMA semântica do bundle (`journalDetailLabel`/`Value` do
+            // core) — sem ela a tela mostrava o cru do Redmine (`status_id: 12 → 7`,
+            // custom field pelo id). A marca `trusted` das partes não se aplica aqui:
+            // ela existe para a fence anti prompt-injection do bundle, e esta tela é
+            // interface, não prompt.
             journal.details.forEach((detail, index) => {
-                rows.push(_jsxs(Text, { color: theme.muted, children: ['  ', detail.name, ": ", detail.old_value ?? EMPTY_PLACEHOLDER, " ", symbols.arrowRight, ' ', detail.new_value ?? EMPTY_PLACEHOLDER] }, `journal-${journal.id}-detail-${index}`));
+                const label = journalDetailLabel(detail, issue).text;
+                // Valores de campo TEXTO (descrição/assunto) trazem o conteúdo inteiro:
+                // editar a descrição guarda os dois textos completos na alteração. No
+                // histórico interessa O QUE mudou, não o texto todo — o valor completo
+                // está no bundle, para o LLM. Sem o corte, uma linha de centenas de
+                // caracteres fura a conta do viewport (1 item = 1 linha de tela).
+                const short = (part) => truncate(part, DETAIL_VALUE_WIDTH);
+                const from = short(journalDetailValue(detail, detail.old_value, issue, lookups)?.text ?? EMPTY_PLACEHOLDER);
+                const to = short(journalDetailValue(detail, detail.new_value, issue, lookups)?.text ?? EMPTY_PLACEHOLDER);
+                rows.push(_jsxs(Text, { color: theme.muted, wrap: "truncate", children: ['  ', label, ": ", from, " ", symbols.arrowRight, " ", to] }, `journal-${journal.id}-detail-${index}`));
             });
             rows.push(_jsx(Text, { children: " " }, `journal-${journal.id}-spacer`));
         });
@@ -141,6 +176,10 @@ export function IssueDetailScreen() {
     // Viewport de descrição CRESCE com o terminal (#190) — só rola quando o conteúdo
     // passa da tela de verdade, em vez de uma janelinha fixa com espaço vazio embaixo.
     const contentHeight = Math.max(CONTENT_MIN_HEIGHT, useTerminalHeight() - CONTENT_OVERHEAD_ROWS);
+    // Largura útil do texto: o terminal menos a moldura da aplicação (2 colunas)
+    // e o padding desta tela (2). Sem descontar, o parágrafo encosta na borda e o
+    // Ink o requebra — o mesmo estouro que o wrap existe para evitar.
+    const contentWidth = Math.max(CONTENT_MIN_WIDTH, useTerminalWidth() - CONTENT_WIDTH_OVERHEAD);
     // Espelha a issue carregada no contexto leve consumido por `./export.js`
     // (#33) — ver o JSDoc do módulo e de `./loaded-issue-context.js` para a
     // escolha de reuso em memória em vez de refetch.
@@ -175,7 +214,7 @@ export function IssueDetailScreen() {
             retry();
         }
     });
-    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.primary, children: "Detalhe da issue" }), state.status === 'no-selection' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "Nenhuma issue selecionada." }) })) : null, state.status === 'loading' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Spinner, {}), " Carregando issue..."] }) })) : null, state.status === 'error-network' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " Falha ao carregar a issue: ", state.message] }) })) : null, state.status === 'error-forbidden' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " ", state.message] }) })) : null, state.status === 'error-not-found' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " ", state.message] }) })) : null, state.status === 'auth-aborted' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: state.message }) })) : null, state.status === 'loaded' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(IssueMeta, { issue: state.issue, theme: theme }), _jsx(Box, { marginTop: 1, children: _jsx(ScrollView, { lines: buildContentRows(state.issue, theme), height: contentHeight }) })] })) : null, _jsx(Box, { flexGrow: 1 }), _jsx(Footer, { showRetry: state.status === 'error-network' ||
+    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.primary, children: "Detalhe da issue" }), state.status === 'no-selection' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "Nenhuma issue selecionada." }) })) : null, state.status === 'loading' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Spinner, {}), " Carregando issue..."] }) })) : null, state.status === 'error-network' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " Falha ao carregar a issue: ", state.message] }) })) : null, state.status === 'error-forbidden' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " ", state.message] }) })) : null, state.status === 'error-not-found' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " ", state.message] }) })) : null, state.status === 'auth-aborted' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: state.message }) })) : null, state.status === 'loaded' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(IssueMeta, { issue: state.issue, theme: theme }), _jsx(Box, { marginTop: 1, children: _jsx(ScrollView, { lines: buildContentRows(state.issue, theme, contentWidth, state.lookups), height: contentHeight }) })] })) : null, _jsx(Box, { flexGrow: 1 }), _jsx(Footer, { showRetry: state.status === 'error-network' ||
                     state.status === 'error-forbidden' ||
                     state.status === 'error-not-found' ||
                     state.status === 'auth-aborted', showExport: state.status === 'loaded' })] }));

package/dist/surfaces/tui/screens/jobs.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * Painel de jobs da sessão (#34/M2-11) — empilhado a partir da home
  * (`./home.tsx`) ou do detalhe (`./issue-detail.tsx`) com a tecla `t`
@@ -40,6 +40,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { Box, Text, useInput } from 'ink';
 import { useRef } from 'react';
+import { Gauge } from '../components/gauge.js';
 import { Spinner } from '../components/spinner.js';
 import { glyphs } from '../glyphs.js';
 import { useListNavigation } from '../hooks/use-list-navigation.js';
@@ -51,7 +52,7 @@ import { useTheme } from '../theme.js';
 /** Uma linha do painel: ícone/spinner de status, rótulo, badge textual e, quando selecionada, o hint de cancelamento. */
 function JobRow({ job, selected, theme }) {
     const icon = jobStatusIcon(job.status);
-    return (_jsxs(Box, { children: [_jsx(Text, { color: theme.primary, children: selected ? `${symbols.pointerSmall} ` : '  ' }), job.status === 'processing' ? (_jsx(Spinner, {})) : (_jsx(Text, { color: jobStatusColor(theme, job.status), children: icon })), _jsx(Text, { children: " " }), _jsx(Text, { ...(selected ? { color: theme.primary } : {}), children: job.label }), _jsxs(Text, { color: theme.muted, children: [" [", jobStatusLabel(job.status), "]"] }), selected ? (_jsxs(Text, { color: theme.muted, children: [' ', job.cancelable === true ? '(Ctrl+C cancela)' : '(não cancelável)'] })) : null] }));
+    return (_jsxs(Box, { children: [_jsx(Text, { color: theme.primary, children: selected ? `${symbols.pointerSmall} ` : '  ' }), job.status === 'processing' ? (_jsx(Spinner, {})) : (_jsx(Text, { color: jobStatusColor(theme, job.status), children: icon })), _jsx(Text, { children: " " }), _jsx(Text, { ...(selected ? { color: theme.primary } : {}), children: job.label }), _jsxs(Text, { color: theme.muted, children: [" [", jobStatusLabel(job.status), "]"] }), job.progress !== undefined ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Gauge, { progress: job.progress, color: jobStatusColor(theme, job.status), trackColor: theme.muted })] })) : null, selected ? (_jsxs(Text, { color: theme.muted, children: [' ', job.cancelable === true ? '(Ctrl+C cancela)' : '(não cancelável)'] })) : null] }));
 }
 /**
  * Tela do painel de jobs: lista as operações da sessão (`../job-registry.tsx`),

package/dist/surfaces/tui/screens/welcome.js

@@ -20,7 +20,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useRef, useState } from 'react';
 import { Box, Text, useInput } from 'ink';
 import { resolveApiKey, TOOL_NAME, TOOL_VERSION } from '../../../index.js';
+import { bannerLines, selectBanner } from '../banner.js';
+import { GradientBanner } from '../components/gradient-banner.js';
 import { GradientText } from '../components/gradient-text.js';
+import { isUnicodeSupported } from '../glyphs.js';
+import { useTerminalWidth } from '../hooks/use-terminal-width.js';
 import { useEnvFallbackAllowed } from '../instance.js';
 import { useNavigation } from '../navigation.js';
 import { useTheme } from '../theme.js';
@@ -37,6 +41,10 @@ function instanceFromEnv(env) {
 export function WelcomeScreen() {
     const { navigate } = useNavigation();
     const theme = useTheme();
+    // Banner responsivo: a arte só entra quando cabe na largura atual e o terminal
+    // renderiza os blocos Unicode (ver ../banner.ts).
+    const variant = selectBanner(useTerminalWidth(), isUnicodeSupported());
+    const gradient = theme.gradient ?? [theme.primary];
     const [checking, setChecking] = useState(false);
     // Handlers ESTÁVEIS (useCallback+refs) — mesmo padrão do TextInput/app.tsx:
     // identidade nova por render des/re-subscreve o useInput e perde teclas.
@@ -91,5 +99,5 @@ export function WelcomeScreen() {
         }
     }, []);
     useInput(handleInput);
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(GradientText, { colors: theme.gradient ?? [theme.primary], children: TOOL_NAME }), _jsxs(Text, { color: theme.muted, children: ["v", TOOL_VERSION] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "Contexto completo de issues do Redmine, pronto para qualquer LLM." }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.muted, children: ["Pressione ", _jsx(Text, { color: theme.accent, children: "Enter" }), " para continuar,", ' ', _jsx(Text, { color: theme.accent, children: "?" }), " para atalhos,", ' ', _jsx(Text, { color: theme.accent, children: "d" }), " para o doctor,", ' ', _jsx(Text, { color: theme.accent, children: "c" }), " para configura\u00E7\u00E3o,", ' ', _jsx(Text, { color: theme.accent, children: "a" }), " para apar\u00EAncia,", ' ', _jsx(Text, { color: theme.accent, children: "q" }), " para sair."] }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [variant === 'plain' ? (_jsx(GradientText, { colors: gradient, children: TOOL_NAME })) : (_jsx(GradientBanner, { lines: bannerLines(variant), colors: gradient })), _jsxs(Text, { color: theme.muted, children: [variant === 'plain' ? '' : `${TOOL_NAME} `, "v", TOOL_VERSION] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "Contexto completo de issues do Redmine, pronto para qualquer LLM." }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.muted, children: ["Pressione ", _jsx(Text, { color: theme.accent, children: "Enter" }), " para continuar,", ' ', _jsx(Text, { color: theme.accent, children: "?" }), " para atalhos,", ' ', _jsx(Text, { color: theme.accent, children: "d" }), " para o doctor,", ' ', _jsx(Text, { color: theme.accent, children: "c" }), " para configura\u00E7\u00E3o,", ' ', _jsx(Text, { color: theme.accent, children: "a" }), " para apar\u00EAncia,", ' ', _jsx(Text, { color: theme.accent, children: "q" }), " para sair."] }) })] }));
 }

package/dist/surfaces/tui/status-color.d.ts

@@ -19,3 +19,24 @@ import type { Theme } from './theme.js';
  * statusColor(theme, 'Fechado') // theme.success
  */
 export declare function statusColor(theme: Theme, statusName: string): string;
+/**
+ * Cor do badge do FILTRO rápido de status (`f` na home).
+ *
+ * Coerente com {@link statusColor}, que já pinta "fechado" de `success` e usa
+ * `primary` para o estado ativo — assim o badge do filtro e o badge de cada
+ * issue na lista não contam histórias diferentes sobre a mesma palavra.
+ *
+ * `all` fica em `muted` de propósito: é a ausência de filtro, e um badge
+ * chamativo aí competiria com o conteúdo. Qualquer estado FILTRADO puxa cor,
+ * que é o sinal de "tem filtro ligado".
+ *
+ * Contraste: todos são tokens do tema, calibrados por paleta (as claras usam
+ * cores saturadas, as escuras cores claras) — ver `./palettes.ts`.
+ *
+ * @param theme - Tema ativo.
+ * @param filter - Filtro corrente (agregado ou id de status da instância).
+ * @param label - Nome do status, quando o filtro é um id — permite casar a cor
+ *   com a que a lista usa para aquele mesmo status.
+ * @returns O token de cor do tema para o badge.
+ */
+export declare function statusFilterColor(theme: Theme, filter: 'open' | 'closed' | 'all' | number, label?: string): string;

package/dist/surfaces/tui/status-color.js

@@ -21,3 +21,36 @@ export function statusColor(theme, statusName) {
     }
     return theme.primary;
 }
+/**
+ * Cor do badge do FILTRO rápido de status (`f` na home).
+ *
+ * Coerente com {@link statusColor}, que já pinta "fechado" de `success` e usa
+ * `primary` para o estado ativo — assim o badge do filtro e o badge de cada
+ * issue na lista não contam histórias diferentes sobre a mesma palavra.
+ *
+ * `all` fica em `muted` de propósito: é a ausência de filtro, e um badge
+ * chamativo aí competiria com o conteúdo. Qualquer estado FILTRADO puxa cor,
+ * que é o sinal de "tem filtro ligado".
+ *
+ * Contraste: todos são tokens do tema, calibrados por paleta (as claras usam
+ * cores saturadas, as escuras cores claras) — ver `./palettes.ts`.
+ *
+ * @param theme - Tema ativo.
+ * @param filter - Filtro corrente (agregado ou id de status da instância).
+ * @param label - Nome do status, quando o filtro é um id — permite casar a cor
+ *   com a que a lista usa para aquele mesmo status.
+ * @returns O token de cor do tema para o badge.
+ */
+export function statusFilterColor(theme, filter, label) {
+    // Status ESPECÍFICO da instância: reusa a heurística por nome, para o badge
+    // do filtro e o badge de cada issue da lista combinarem ("Em Andamento" é
+    // warning nos dois lugares).
+    if (typeof filter === 'number') {
+        return label === undefined ? theme.primary : statusColor(theme, label);
+    }
+    if (filter === 'open')
+        return theme.primary;
+    if (filter === 'closed')
+        return theme.success;
+    return theme.muted;
+}

package/dist/surfaces/tui/wrap.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Quebra de linha por LARGURA para as viewports roláveis da TUI.
+ *
+ * `../components/scroll-view.tsx` mostra `height` ITENS do array `lines` e
+ * assume que cada item ocupa UMA linha na tela. Texto vindo do Redmine não
+ * respeita isso: a descrição de um chamado costuma ter parágrafos de centenas
+ * de caracteres, o Ink os quebra sozinho em várias linhas visuais, e a conta do
+ * viewport passa a errar — o conteúdo escapa da janela, o começo das frases
+ * some e a moldura da aplicação aparece em pedaços no meio do texto.
+ *
+ * Quebrando ANTES de montar as linhas, cada item volta a ser uma linha visual e
+ * o ScrollView fica correto sem precisar saber medir texto.
+ *
+ * A medida é em code points (`[...text]`), a mesma convenção de `./truncate.ts`:
+ * suficiente para o conteúdo latino dos chamados e sem trazer dependência de
+ * largura de glifo (CJK/emoji contariam 2 colunas).
+ */
+/**
+ * Quebra um parágrafo em linhas de no máximo `width` colunas, sem cortar
+ * palavras (exceto quando a palavra sozinha excede a largura).
+ *
+ * @param text - Uma linha lógica (sem `\n`).
+ * @param width - Largura disponível em colunas; `<= 0` devolve o texto inteiro
+ *   numa linha só (não há o que quebrar de forma útil).
+ * @returns As linhas resultantes; nunca vazio — texto vazio devolve `['']` para
+ *   preservar a linha em branco do original.
+ * @example
+ * wrapLine('uma frase bem comprida', 10); // ['uma frase', 'bem', 'comprida']
+ */
+export declare function wrapLine(text: string, width: number): string[];
+/**
+ * Quebra um texto multi-linha, preservando as linhas em branco do original.
+ *
+ * @param text - Texto com `\n` (descrição de issue, nota de journal).
+ * @param width - Largura disponível em colunas.
+ * @returns Todas as linhas já ajustadas à largura.
+ */
+export declare function wrapText(text: string, width: number): string[];

package/dist/surfaces/tui/wrap.js

@@ -0,0 +1,82 @@
+/**
+ * Quebra de linha por LARGURA para as viewports roláveis da TUI.
+ *
+ * `../components/scroll-view.tsx` mostra `height` ITENS do array `lines` e
+ * assume que cada item ocupa UMA linha na tela. Texto vindo do Redmine não
+ * respeita isso: a descrição de um chamado costuma ter parágrafos de centenas
+ * de caracteres, o Ink os quebra sozinho em várias linhas visuais, e a conta do
+ * viewport passa a errar — o conteúdo escapa da janela, o começo das frases
+ * some e a moldura da aplicação aparece em pedaços no meio do texto.
+ *
+ * Quebrando ANTES de montar as linhas, cada item volta a ser uma linha visual e
+ * o ScrollView fica correto sem precisar saber medir texto.
+ *
+ * A medida é em code points (`[...text]`), a mesma convenção de `./truncate.ts`:
+ * suficiente para o conteúdo latino dos chamados e sem trazer dependência de
+ * largura de glifo (CJK/emoji contariam 2 colunas).
+ */
+/**
+ * Quebra um parágrafo em linhas de no máximo `width` colunas, sem cortar
+ * palavras (exceto quando a palavra sozinha excede a largura).
+ *
+ * @param text - Uma linha lógica (sem `\n`).
+ * @param width - Largura disponível em colunas; `<= 0` devolve o texto inteiro
+ *   numa linha só (não há o que quebrar de forma útil).
+ * @returns As linhas resultantes; nunca vazio — texto vazio devolve `['']` para
+ *   preservar a linha em branco do original.
+ * @example
+ * wrapLine('uma frase bem comprida', 10); // ['uma frase', 'bem', 'comprida']
+ */
+export function wrapLine(text, width) {
+    if (width <= 0)
+        return [text];
+    const chars = [...text];
+    if (chars.length <= width)
+        return [text];
+    const lines = [];
+    let current = '';
+    const pushCurrent = () => {
+        if (current.length > 0) {
+            lines.push(current);
+            current = '';
+        }
+    };
+    for (const word of text.split(' ')) {
+        const wordLength = [...word].length;
+        const currentLength = [...current].length;
+        // Palavra maior que a largura (URL, hash, caminho): quebra à força, em
+        // pedaços do tamanho da linha — melhor que estourar o viewport.
+        if (wordLength > width) {
+            pushCurrent();
+            let rest = [...word];
+            while (rest.length > width) {
+                lines.push(rest.slice(0, width).join(''));
+                rest = rest.slice(width);
+            }
+            current = rest.join('');
+            continue;
+        }
+        if (currentLength === 0) {
+            current = word;
+        }
+        else if (currentLength + 1 + wordLength <= width) {
+            current = `${current} ${word}`;
+        }
+        else {
+            pushCurrent();
+            current = word;
+        }
+    }
+    pushCurrent();
+    return lines.length > 0 ? lines : [''];
+}
+/**
+ * Quebra um texto multi-linha, preservando as linhas em branco do original.
+ *
+ * @param text - Texto com `\n` (descrição de issue, nota de journal).
+ * @param width - Largura disponível em colunas.
+ * @returns Todas as linhas já ajustadas à largura.
+ */
+export function wrapText(text, width) {
+    return text.split('\n').flatMap((line) => wrapLine(line, width));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redmine-context",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Consumidor de Redmine que entrega contexto completo de issues (texto + mídia extraída localmente) para qualquer LLM",
   "type": "module",
   "license": "MIT",