redmine-context 1.0.0

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

@@ -0,0 +1,168 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Tela de exportação do bundle (#33) — aberta a partir do detalhe da issue
+ * (`e`, ver `./issue-detail.tsx`), SOMENTE quando a issue já terminou de
+ * carregar (`state.status === 'loaded'` naquela tela).
+ *
+ * Reusa a issue já normalizada em memória via `./loaded-issue-context.js`
+ * (ver o JSDoc daquele módulo para a escolha de reuso vs. refetch) e chama
+ * `../hooks/use-export-bundle.js`, que empacota com `buildMarkdownBundle`/
+ * `buildJsonBundle` (fronteira do core, `../../../index.js`) e grava
+ * `<id>.md`/`<id>.json` no destino informado.
+ *
+ * Dois campos alternados por `Tab` (mesmo padrão de
+ * `./onboarding/login.tsx`): formato — lista navegável (↑/↓,
+ * `../hooks/use-list-navigation.js`) entre `md`/`json`/`both` — e destino —
+ * `../components/text-input.js`, com `process.cwd()` como valor inicial
+ * (`~` é expandido pelo hook antes de gravar). `Enter` em qualquer um dos
+ * dois campos confirma a exportação.
+ *
+ * #34 (M2-11): PRIMEIRO produtor real do registro de jobs da sessão
+ * (`../job-registry.js`, ver o JSDoc daquele módulo para o contrato) — ao
+ * confirmar (Enter), registra um job em `processing` (exportação não tem fase
+ * de fila: começa a gravar assim que confirmada) e o transiciona para
+ * `done`/`failed` conforme `useExportBundle` resolve. `useExportBundle` em si
+ * permanece intocado (fronteira do core, ADR-005) — a integração vive só
+ * aqui, na tela, mantendo o hook puro. Exportação NÃO é cancelável
+ * (`cancelable` fica `false`/omitido) — o painel (`../screens/jobs.js`)
+ * mostra "(não cancelável)" para ela.
+ *
+ * 4 estados visuais: formulário (`idle`), progresso (`Spinner` existente,
+ * igual a `./issue-detail.tsx`), sucesso (caminho(s) absoluto(s) gravado(s) +
+ * `b` para voltar) e erro (`theme.danger` + ação corretiva — diretório
+ * inexistente ou sem permissão de escrita, ver o hook). `b` (ou `Esc`, atalho
+ * global de `../app.tsx`) volta ao detalhe em qualquer estado que não seja
+ * `exporting` — a pilha já preserva a navegação (a issue é buscada de novo
+ * pelo detalhe ao remontar, mesmo comportamento já existente ao voltar da
+ * home para o detalhe).
+ *
+ * M2-16 (#39): o campo de destino usa `maxWidth` do `TextInput`
+ * (`../components/text-input.js`) — o valor exibido é truncado a partir do
+ * INÍCIO (preserva o fim, onde o usuário está digitando) quando o caminho
+ * excede o espaço restante do terminal, o mesmo `Box` em linha que sofreria
+ * sobreposição sem isso (ver o JSDoc de `../truncate.ts`). Os caminhos
+ * gravados exibidos em `success`/`error` truncam do FIM (`../truncate.js`,
+ * `truncate`) — são texto estático, não um campo em edição.
+ */
+import { Box, Text, useInput } from 'ink';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Spinner } from '../components/spinner.js';
+import { TextInput } from '../components/text-input.js';
+import { glyphs } from '../glyphs.js';
+import { useExportBundle } from '../hooks/use-export-bundle.js';
+import { useListNavigation } from '../hooks/use-list-navigation.js';
+import { useJobRegistry } from '../job-registry.js';
+import { useTerminalWidth } from '../hooks/use-terminal-width.js';
+import { useNavigation } from '../navigation.js';
+import { symbols } from '../symbols.js';
+import { useTheme } from '../theme.js';
+import { truncate } from '../truncate.js';
+import { useLoadedIssue } from './loaded-issue-context.js';
+/** `paddingX={1}` dos dois lados do `Box` raiz da tela. */
+const SCREEN_PADDING_X = 2;
+/** Recuo (`{'  '}`) na frente de cada caminho gravado, na tela de sucesso. */
+const SUCCESS_PATH_INDENT_WIDTH = 2;
+/** Largura mínima garantida a um caminho exibido, mesmo em terminais muito estreitos. */
+const MIN_PATH_WIDTH = 8;
+/** Alterna entre os dois campos do formulário. */
+function otherField(field) {
+    return field === 'format' ? 'destination' : 'format';
+}
+/** As 3 opções de formato exigidas pela AC: MD, JSON, ou ambos. */
+const FORMAT_OPTIONS = [
+    { value: 'md', label: 'Markdown (.md)' },
+    { value: 'json', label: 'JSON (.json)' },
+    { value: 'both', label: 'Ambos (.md + .json)' },
+];
+/** Uma linha da lista de formato: ponteiro quando é a linha selecionada, negrito quando o campo está focado. */
+function FormatRow({ label, selected, focused }) {
+    const theme = useTheme();
+    return (_jsxs(Box, { children: [_jsx(Text, { color: theme.primary, children: selected ? `${symbols.pointerSmall} ` : '  ' }), _jsx(Text, { color: selected && focused ? theme.primary : theme.muted, children: label })] }));
+}
+/** Rótulo fixo à esquerda do campo de destino: ponteiro/espaço (1) + `" Destino: "` (10). */
+const DESTINATION_LABEL_WIDTH = 11;
+/** Largura mínima garantida ao campo de destino/caminhos exibidos, mesmo em terminais muito estreitos. */
+const MIN_DESTINATION_WIDTH = 8;
+/** Tela de exportação: escolhe formato + destino, grava via o core, mostra progresso/sucesso/erro. */
+export function ExportScreen() {
+    const theme = useTheme();
+    const { pop } = useNavigation();
+    const { issue } = useLoadedIssue();
+    const { state, runExport, reset } = useExportBundle(issue);
+    // #34 (M2-11): registro de jobs da sessão — exportação é o PRIMEIRO
+    // produtor real (ver o JSDoc do módulo para o contrato completo).
+    const { registerJob, updateJobStatus } = useJobRegistry();
+    const terminalWidth = useTerminalWidth();
+    const destinationMaxWidth = Math.max(terminalWidth - SCREEN_PADDING_X - DESTINATION_LABEL_WIDTH, MIN_DESTINATION_WIDTH);
+    const pathMaxWidth = Math.max(terminalWidth - SCREEN_PADDING_X - SUCCESS_PATH_INDENT_WIDTH, MIN_PATH_WIDTH);
+    const [field, setField] = useState('format');
+    const [destination, setDestination] = useState(() => process.cwd());
+    const isFormActive = state.status === 'idle';
+    // Id do job da tentativa de exportação EM ANDAMENTO (ou da última, após
+    // terminar) — `undefined` antes da primeira confirmação. Um `ref` (não
+    // estado) porque só é lido pelo efeito abaixo, nunca pelo JSX.
+    const currentJobIdRef = useRef(undefined);
+    const handleSubmit = useCallback((formatIndex) => {
+        const format = FORMAT_OPTIONS[formatIndex]?.value ?? 'md';
+        if (issue !== undefined) {
+            // Novo `id` a cada confirmação (mesmo após um erro + "r" de retry) —
+            // cada tentativa vira uma entrada distinta no painel (histórico da
+            // sessão), nunca uma reescrita silenciosa da anterior.
+            const jobId = `export-${issue.id}-${Date.now()}`;
+            currentJobIdRef.current = jobId;
+            registerJob({
+                id: jobId,
+                label: `Exportar #${issue.id} (${format})`,
+                status: 'processing',
+                startedAt: Date.now(),
+                // Exportação não é cancelável — grava direto no disco, sem uma
+                // etapa segura para abortar no meio (ver o JSDoc do módulo).
+                cancelable: false,
+            });
+        }
+        void runExport(format, destination);
+    }, [runExport, destination, issue, registerJob]);
+    // Espelha o resultado da exportação no job registrado acima — SEM tocar em
+    // `useExportBundle` (fronteira do core intocada, ver o JSDoc do módulo).
+    useEffect(() => {
+        const jobId = currentJobIdRef.current;
+        if (jobId === undefined) {
+            return;
+        }
+        if (state.status === 'success') {
+            updateJobStatus(jobId, 'done');
+        }
+        else if (state.status === 'error') {
+            updateJobStatus(jobId, 'failed');
+        }
+    }, [state.status, updateJobStatus]);
+    const { selectedIndex: formatIndex } = useListNavigation(FORMAT_OPTIONS.length, {
+        isActive: isFormActive && field === 'format',
+        onSelect: handleSubmit,
+    });
+    // Handlers ESTÁVEIS (refs + useCallback, padrão do repo): identidade nova a
+    // cada render des/re-subscreve o useInput e pode perder uma tecla rápida.
+    const stateStatusRef = useRef(state.status);
+    stateStatusRef.current = state.status;
+    const popRef = useRef(pop);
+    popRef.current = pop;
+    const resetRef = useRef(reset);
+    resetRef.current = reset;
+    const handleControlInput = useCallback((input, key) => {
+        if (key.tab && stateStatusRef.current === 'idle') {
+            setField(otherField);
+            return;
+        }
+        // "b" não interrompe uma exportação em andamento — evita voltar no meio
+        // de uma gravação em disco.
+        if (input === 'b' && stateStatusRef.current !== 'exporting') {
+            popRef.current();
+            return;
+        }
+        if (input === 'r' && stateStatusRef.current === 'error') {
+            resetRef.current();
+        }
+    }, []);
+    useInput(handleControlInput);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.primary, children: "Exportar bundle" }), issue === undefined ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "Nenhuma issue carregada \u2014 volte ao detalhe e tente de novo." }) })) : null, issue !== undefined && state.status === 'idle' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.muted, children: ["Issue #", issue.id] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: field === 'format' ? theme.primary : theme.muted, children: "Formato:" }), FORMAT_OPTIONS.map((option, index) => (_jsx(FormatRow, { label: option.label, selected: index === formatIndex, focused: field === 'format' }, option.value)))] }), _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: field === 'destination' ? theme.primary : theme.muted, children: [field === 'destination' ? symbols.pointer : ' ', " Destino:", ' '] }), _jsx(TextInput, { value: destination, onChange: setDestination, onSubmit: () => handleSubmit(formatIndex), isActive: field === 'destination', maxWidth: destinationMaxWidth })] })] })) : null, state.status === 'exporting' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Spinner, {}), " Exportando..."] }) })) : null, state.status === 'success' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.success, children: [symbols.tick, " Bundle gravado:"] }), state.files.map((file) => (_jsxs(Text, { color: theme.muted, children: ['  ', truncate(file.path, pathMaxWidth)] }, file.path)))] })) : null, state.status === 'error' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.danger, children: [symbols.cross, " Falha ao gravar o bundle: ", state.message] }), _jsx(Text, { color: theme.muted, children: "Verifique se o diret\u00F3rio existe e se voc\u00EA tem permiss\u00E3o de escrita nele, ou informe outro destino." })] })) : null, _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.muted, children: [state.status === 'idle' ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.accent, children: `${glyphs.arrowUp}/${glyphs.arrowDown}` }), ' ', "escolhe o formato,", ' ', _jsx(Text, { color: theme.accent, children: "Tab" }), ' ', "alterna formato/destino,", ' ', _jsx(Text, { color: theme.accent, children: "Enter" }), ' ', "exporta,", ' '] })) : null, state.status === 'error' ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.accent, children: "r" }), ' ', "tenta de novo,", ' '] })) : null, _jsx(Text, { color: theme.accent, children: "b" }), ' ', "volta ao detalhe."] }) })] }));
+}

package/dist/surfaces/tui/screens/home-selection.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Estado de seleção da home (#31), compartilhado entre `./home.tsx` e
+ * `./issue-detail.tsx` sem prop-drilling.
+ *
+ * O roteador (`../screen.ts`/`../app.tsx`) renderiza cada tela SEM props e só
+ * mantém montado o TOPO da pilha — ao empilhar `issue-detail` (Enter sobre
+ * uma issue na home), `HomeScreen` é desmontada. Isso cria dois problemas que
+ * este módulo resolve com um único contexto:
+ *
+ * 1. **Qual issue abrir**: `issue-detail` precisa saber o `id` da issue
+ *    selecionada para buscá-la via `../hooks/use-issue-detail.js` — sem
+ *    props entre telas, o único jeito de repassar essa informação é um
+ *    estado compartilhado escrito pela home (`setSelectedIssueId`) e lido
+ *    pelo detalhe (`selectedIssueId`).
+ * 2. **Posição da lista ao voltar**: `selectedIndex` de
+ *    `../hooks/use-list-navigation.js` vive num `useState` LOCAL ao
+ *    componente — ele reseta para `0` a cada remount. Sem preservá-lo aqui,
+ *    Esc/`b` a partir do detalhe devolveria o usuário ao topo da lista,
+ *    mesmo que a issue aberta fosse a 10ª.
+ *
+ * Instanciado uma vez em `../app.tsx`, envolvendo toda a árvore de telas —
+ * mesmo padrão do `OnboardingProvider` (`./onboarding/onboarding-context.tsx`),
+ * que resolve o mesmo tipo de problema (estado compartilhado entre telas sem
+ * props) para o fluxo de onboarding.
+ *
+ * ## Alternativas descartadas
+ *
+ * - **Adicionar parâmetros às telas** (`SCREENS` passaria a aceitar props):
+ *   afetaria as 12 telas do registro (`../screen.ts`) e o contrato do
+ *   roteador inteiro por uma necessidade de só duas telas — desproporcional.
+ * - **Singleton de módulo** (uma variável fora de qualquer componente React,
+ *   sem `Context`): funciona em produção, mas vaza estado entre execuções de
+ *   teste (`render()` de um teste não reresetaria o singleton do teste
+ *   seguinte) — um `Context` reinstanciado a cada `render()` evita esse
+ *   acoplamento oculto.
+ * - **Guardar no próprio `NavigationValue`** (`../navigation.tsx`): esse
+ *   contrato é sobre QUAIS telas existem na pilha, não sobre o estado interno
+ *   de uma tela específica — misturar os dois tornaria `navigation.tsx`
+ *   acoplado a detalhes da home/detalhe de issue.
+ */
+import { type ReactNode } from 'react';
+/** Valor exposto pelo contexto de seleção da home. */
+export interface HomeSelectionValue {
+    /**
+     * Índice da linha destacada na lista da home — sobrevive ao push/pop de
+     * `issue-detail` (ver o JSDoc do módulo). Semente lida por `initialIndex`
+     * de `../hooks/use-list-navigation.js`.
+     */
+    selectedIndex: number;
+    /** Atualiza o índice destacado — chamado pela home a cada mudança do cursor. */
+    setSelectedIndex: (index: number) => void;
+    /** Id da issue aberta em `issue-detail`, ou `undefined` antes de qualquer seleção. */
+    selectedIssueId: number | undefined;
+    /** Registra a issue selecionada — chamado pela home ao empilhar `issue-detail` (Enter). */
+    setSelectedIssueId: (id: number) => void;
+}
+/**
+ * Provider do contexto de seleção da home — instanciado uma vez em
+ * `../app.tsx`, envolvendo toda a árvore de telas (ver o JSDoc do módulo).
+ */
+export declare function HomeSelectionProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Hook de seleção da home consumido por `./home.tsx`/`./issue-detail.tsx`.
+ *
+ * @throws {Error} Se chamado fora de um `<HomeSelectionProvider>` — indica
+ *   erro de composição (tela renderizada sem passar pelo roteador).
+ */
+export declare function useHomeSelection(): HomeSelectionValue;

package/dist/surfaces/tui/screens/home-selection.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Estado de seleção da home (#31), compartilhado entre `./home.tsx` e
+ * `./issue-detail.tsx` sem prop-drilling.
+ *
+ * O roteador (`../screen.ts`/`../app.tsx`) renderiza cada tela SEM props e só
+ * mantém montado o TOPO da pilha — ao empilhar `issue-detail` (Enter sobre
+ * uma issue na home), `HomeScreen` é desmontada. Isso cria dois problemas que
+ * este módulo resolve com um único contexto:
+ *
+ * 1. **Qual issue abrir**: `issue-detail` precisa saber o `id` da issue
+ *    selecionada para buscá-la via `../hooks/use-issue-detail.js` — sem
+ *    props entre telas, o único jeito de repassar essa informação é um
+ *    estado compartilhado escrito pela home (`setSelectedIssueId`) e lido
+ *    pelo detalhe (`selectedIssueId`).
+ * 2. **Posição da lista ao voltar**: `selectedIndex` de
+ *    `../hooks/use-list-navigation.js` vive num `useState` LOCAL ao
+ *    componente — ele reseta para `0` a cada remount. Sem preservá-lo aqui,
+ *    Esc/`b` a partir do detalhe devolveria o usuário ao topo da lista,
+ *    mesmo que a issue aberta fosse a 10ª.
+ *
+ * Instanciado uma vez em `../app.tsx`, envolvendo toda a árvore de telas —
+ * mesmo padrão do `OnboardingProvider` (`./onboarding/onboarding-context.tsx`),
+ * que resolve o mesmo tipo de problema (estado compartilhado entre telas sem
+ * props) para o fluxo de onboarding.
+ *
+ * ## Alternativas descartadas
+ *
+ * - **Adicionar parâmetros às telas** (`SCREENS` passaria a aceitar props):
+ *   afetaria as 12 telas do registro (`../screen.ts`) e o contrato do
+ *   roteador inteiro por uma necessidade de só duas telas — desproporcional.
+ * - **Singleton de módulo** (uma variável fora de qualquer componente React,
+ *   sem `Context`): funciona em produção, mas vaza estado entre execuções de
+ *   teste (`render()` de um teste não reresetaria o singleton do teste
+ *   seguinte) — um `Context` reinstanciado a cada `render()` evita esse
+ *   acoplamento oculto.
+ * - **Guardar no próprio `NavigationValue`** (`../navigation.tsx`): esse
+ *   contrato é sobre QUAIS telas existem na pilha, não sobre o estado interno
+ *   de uma tela específica — misturar os dois tornaria `navigation.tsx`
+ *   acoplado a detalhes da home/detalhe de issue.
+ */
+import { createContext, useCallback, useContext, useState } from 'react';
+const HomeSelectionContext = createContext(undefined);
+/**
+ * Provider do contexto de seleção da home — instanciado uma vez em
+ * `../app.tsx`, envolvendo toda a árvore de telas (ver o JSDoc do módulo).
+ */
+export function HomeSelectionProvider({ children }) {
+    const [selectedIndex, setSelectedIndexState] = useState(0);
+    const [selectedIssueId, setSelectedIssueIdState] = useState(undefined);
+    // Identidades ESTÁVEIS (useCallback sem deps, padrão do repo) — evita
+    // resubscrições desnecessárias em quem os usa como dependência de efeito
+    // (ex.: `../screens/home.tsx`).
+    const setSelectedIndex = useCallback((index) => {
+        setSelectedIndexState(index);
+    }, []);
+    const setSelectedIssueId = useCallback((id) => {
+        setSelectedIssueIdState(id);
+    }, []);
+    const value = {
+        selectedIndex,
+        setSelectedIndex,
+        selectedIssueId,
+        setSelectedIssueId,
+    };
+    return _jsx(HomeSelectionContext.Provider, { value: value, children: children });
+}
+/**
+ * Hook de seleção da home consumido por `./home.tsx`/`./issue-detail.tsx`.
+ *
+ * @throws {Error} Se chamado fora de um `<HomeSelectionProvider>` — indica
+ *   erro de composição (tela renderizada sem passar pelo roteador).
+ */
+export function useHomeSelection() {
+    const value = useContext(HomeSelectionContext);
+    if (value === undefined) {
+        throw new Error('useHomeSelection() usado fora de <HomeSelectionProvider>.');
+    }
+    return value;
+}

package/dist/surfaces/tui/screens/home.d.ts

@@ -0,0 +1,2 @@
+/** Tela home: lista "minhas issues", `↑/↓`/`j`/`k` navegam, `Enter` abre o detalhe. */
+export declare function HomeScreen(): import("react").JSX.Element;

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

@@ -0,0 +1,200 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Tela home da TUI (M2-06, #29): "minhas issues" (`assigned_to_id=me`) via o
+ * core, com seleção por teclado (`../hooks/use-list-navigation.js`) e os 4
+ * estados visuais exigidos pela AC — carregando (`Spinner`), vazio, erro de
+ * rede (banner `theme.danger` + tecla `r` para tentar de novo) e 403
+ * (mensagem específica de permissão). Vira o destino pós-onboarding (ver
+ * `onboarding/success.tsx`, que faz `resetTo('home')`) e o Enter da
+ * `welcome.tsx` quando já há credencial salva na cascata.
+ *
+ * A busca em si vive em `../hooks/use-my-issues.js` (deps injetáveis,
+ * fronteira do core via `../../../index.js`) — esta tela só formata os
+ * estados. `Enter` sobre a issue selecionada empilha `issue-detail`
+ * (`./issue-detail.js`, detalhe real desde a #31).
+ *
+ * Fix do review do PR #120: `useMyIssues` agora envolve a busca com
+ * `useAuthGuard` (#36) — 401 relogina e retoma a busca sozinho (o estado
+ * fica `loading` até lá, nenhuma tela nova aqui). Se o re-login for
+ * abandonado (Esc), o hook expõe o 5º estado `auth-aborted` (neutro, não um
+ * erro) — renderizado aqui igual aos banners de erro, com o mesmo `r` de
+ * retry.
+ *
+ * M2-07 (#30) acrescenta a busca/filtros inline: `/` abre um `TextInput`
+ * QUANDO a home está ativa; `f` cicla o filtro com a busca FECHADA (badge no
+ * cabeçalho); Esc fecha a busca sem refetch, interceptado via
+ * `../hooks/use-escape-interceptor.ts` para não desempilhar a home.
+ *
+ * #31 (detalhe) acrescenta `./home-selection.js`: a tela é DESMONTADA ao
+ * empilhar `issue-detail`, então seleção (`selectedIndex` + issue escolhida)
+ * vive num contexto acima da pilha (padrão do `OnboardingProvider`) — ver o
+ * JSDoc de `./home-selection.js`.
+ *
+ * M2-16 (#39): o subject de cada linha é truncado (`../truncate.js`) com um
+ * orçamento de largura CALCULADO por linha (`../hooks/use-terminal-width.js`
+ * menos o espaço fixo de ponteiro/`#id`/badge de status, ver
+ * `fixedRowOverhead` abaixo) — sem isso, um subject comprido sobrepõe o badge
+ * de status da mesma linha em terminais estreitos (o Ink não reflui `<Text>`
+ * IRMÃS dentro de um `<Box>` em linha; ver o JSDoc de `../truncate.ts`).
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Box, Text, useInput } from 'ink';
+import { Spinner } from '../components/spinner.js';
+import { TextInput } from '../components/text-input.js';
+import { glyphs } from '../glyphs.js';
+import { useEscapeInterceptor } from '../hooks/use-escape-interceptor.js';
+import { useIssueSearch } from '../hooks/use-issue-search.js';
+import { useListNavigation } from '../hooks/use-list-navigation.js';
+import { useMyIssues } from '../hooks/use-my-issues.js';
+import { 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 { useHomeSelection } from './home-selection.js';
+/** Largura mínima garantida ao subject, mesmo em terminais muito estreitos. */
+const MIN_SUBJECT_WIDTH = 8;
+/** `paddingX={1}` dos dois lados do `Box` raiz da tela (ver o JSX abaixo). */
+const SCREEN_PADDING_X = 2;
+// Nit do review #120: referência ESTÁVEL para os estados sem lista — um
+// literal `[]` inline em cada render seria recriado a cada chamada,
+// invalidando memoizações a jusante (`useListNavigation`) sem necessidade.
+const EMPTY_ISSUES = [];
+/** Rótulo do badge de cada filtro rápido de status (tecla `f` cicla, M2-07/#30). */
+const STATUS_FILTER_LABELS = {
+    open: 'aberta',
+    closed: 'fechada',
+    all: 'todas',
+};
+/** Próximo filtro no ciclo `aberta → fechada → todas → aberta` (tecla `f`). */
+function nextStatusFilter(current) {
+    if (current === 'open')
+        return 'closed';
+    if (current === 'closed')
+        return 'all';
+    return 'open';
+}
+/**
+ * Espaço fixo ocupado pela linha FORA do subject (M2-16, #39): ponteiro (2),
+ * `#id ` (id + `#`/espaço), 1 espaço final após o subject, `[status]`
+ * (colchetes + nome) e o `paddingX` da tela. O que sobrar da largura do
+ * terminal é o orçamento do subject.
+ */
+function fixedRowOverhead(idLength, statusLength) {
+    const POINTER_WIDTH = 2;
+    const ID_PREFIX_WIDTH = 1 + idLength + 1; // "#" + dígitos + espaço
+    const SUBJECT_TRAILING_SPACE = 1;
+    const STATUS_BRACKETS_WIDTH = 2 + statusLength; // "[" + nome + "]"
+    return POINTER_WIDTH + ID_PREFIX_WIDTH + SUBJECT_TRAILING_SPACE + STATUS_BRACKETS_WIDTH + SCREEN_PADDING_X;
+}
+/** Uma linha da lista: `#id` em `theme.muted`, subject truncado ao orçamento de largura, badge de status. */
+function IssueRow({ issue, selected }) {
+    const theme = useTheme();
+    const terminalWidth = useTerminalWidth();
+    const overhead = fixedRowOverhead(String(issue.id).length, issue.statusName.length);
+    const subjectBudget = Math.max(terminalWidth - overhead, MIN_SUBJECT_WIDTH);
+    return (_jsxs(Box, { children: [_jsx(Text, { color: theme.primary, children: selected ? `${symbols.pointerSmall} ` : '  ' }), _jsxs(Text, { color: theme.muted, children: ["#", issue.id, " "] }), _jsxs(Text, { ...(selected ? { color: theme.primary } : {}), children: [truncate(issue.subject, subjectBudget), ' '] }), _jsxs(Text, { color: statusColor(theme, issue.statusName), children: ["[", issue.statusName, "]"] })] }));
+}
+/** Tela home: lista "minhas issues", `↑/↓`/`j`/`k` navegam, `Enter` abre o detalhe. */
+export function HomeScreen() {
+    const theme = useTheme();
+    const { push } = useNavigation();
+    const { state, retry } = useMyIssues();
+    // #31: índice preservado entre remounts + registro de qual issue foi aberta
+    // (ver o JSDoc do módulo e de `./home-selection.js`).
+    const { selectedIndex: persistedIndex, setSelectedIndex: persistIndex, setSelectedIssueId } = useHomeSelection();
+    // --- Busca/filtros inline (M2-07, #30) ---
+    const [isSearching, setIsSearching] = useState(false);
+    const [query, setQuery] = useState('');
+    const [statusFilter, setStatusFilter] = useState('all');
+    const search = useIssueSearch(query, statusFilter);
+    // Handler ESTÁVEL: `search.clear` é a única dependência mutável (mas já é
+    // estável por construção, ver `use-issue-search.ts`) — fecha a busca e
+    // restaura os 3 estados neutros de uma vez (query/filtro/hook de busca).
+    const closeSearch = useCallback(() => {
+        setIsSearching(false);
+        setQuery('');
+        setStatusFilter('all');
+        search.clear();
+    }, [search.clear]);
+    // Desvia o Esc GLOBAL (`../app.tsx`) enquanto a busca está aberta — sem
+    // isso, Esc desempilharia a home inteira em vez de só fechar a busca.
+    useEscapeInterceptor(isSearching, closeSearch);
+    const issues = state.status === 'loaded' ? state.issues : EMPTY_ISSUES;
+    // Handlers ESTÁVEIS (useCallback + refs, padrão do repo): identidade nova a
+    // cada render des/re-subscreve o useInput e pode perder uma tecla rápida.
+    const pushRef = useRef(push);
+    pushRef.current = push;
+    const setSelectedIssueIdRef = useRef(setSelectedIssueId);
+    setSelectedIssueIdRef.current = setSelectedIssueId;
+    const handleSelect = useCallback((index) => {
+        const issue = issues[index];
+        if (issue !== undefined) {
+            setSelectedIssueIdRef.current(issue.id);
+            pushRef.current('issue-detail');
+        }
+    }, [issues]);
+    // #30: navegação desligada com a busca aberta; #31: cursor semeado com a
+    // última posição persistida (sobrevive ao unmount via home-selection).
+    const { selectedIndex } = useListNavigation(issues.length, {
+        onSelect: handleSelect,
+        isActive: !isSearching,
+        initialIndex: persistedIndex,
+    });
+    // Espelha `selectedIndex` ao contexto — a cópia externa sobrevive ao
+    // unmount desta tela (ver ./home-selection.js).
+    const persistIndexRef = useRef(persistIndex);
+    persistIndexRef.current = persistIndex;
+    useEffect(() => {
+        persistIndexRef.current(selectedIndex);
+    }, [selectedIndex]);
+    const retryRef = useRef(retry);
+    retryRef.current = retry;
+    const statusRef = useRef(state.status);
+    statusRef.current = state.status;
+    const isSearchingRef = useRef(isSearching);
+    isSearchingRef.current = isSearching;
+    const handleRetryInput = useCallback((input) => {
+        // M2-07 (#30): "r" digitado como texto de busca não deve disparar retry.
+        if (isSearchingRef.current)
+            return;
+        if (input === 'r' &&
+            (statusRef.current === 'error-network' ||
+                statusRef.current === 'error-forbidden' ||
+                // Fix do review #120: abandono do re-login (Esc) também tem retry.
+                statusRef.current === 'auth-aborted')) {
+            retryRef.current();
+        }
+    }, []);
+    useInput(handleRetryInput);
+    // "/" abre a busca; "f" cicla o filtro rápido de status (só com a busca já
+    // aberta). Reason: dentro do campo de texto, "f" digitado NÃO vira
+    // caractere da query — é a tecla de controle do filtro, trade-off
+    // Com a busca ABERTA, toda letra pertence à query (buscar "workflow" exige
+    // digitar "f") — o ciclo de filtro por "f" só vale com a busca fechada.
+    const handleSearchControlInput = useCallback((input) => {
+        if (input === '/' && !isSearchingRef.current) {
+            setIsSearching(true);
+            return;
+        }
+        if (input === 'f' && !isSearchingRef.current) {
+            setStatusFilter((current) => nextStatusFilter(current));
+        }
+    }, []);
+    useInput(handleSearchControlInput);
+    // #34 (M2-11): "t" abre o painel de jobs da sessão (`./jobs.js`) — só fora
+    // da busca (mesma guarda de "/"/"f" acima: dentro do campo, "t" é texto da
+    // query, não um atalho).
+    const handleJobsShortcut = useCallback((input) => {
+        if (input === 't' && !isSearchingRef.current) {
+            pushRef.current('jobs');
+        }
+    }, []);
+    useInput(handleJobsShortcut);
+    const searchState = search.state;
+    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.primary, children: "Minhas issues" }), _jsxs(Text, { color: theme.muted, children: [" [", STATUS_FILTER_LABELS[statusFilter], "]"] }), !isSearching ? (_jsx(Text, { color: theme.muted, children: `  / busca ${glyphs.middleDot} f filtro ${glyphs.middleDot} t jobs` })) : null] }), isSearching ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.primary, children: "Buscar: " }), _jsx(TextInput, { value: query, onChange: setQuery, placeholder: `digite para buscar${glyphs.ellipsis}`, isActive: isSearching }), _jsxs(Text, { color: theme.muted, children: [" [", STATUS_FILTER_LABELS[statusFilter], "]"] })] }), searchState.status === 'idle' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "Digite para buscar ou pressione f para ciclar o filtro de status." }) })) : null, searchState.status === 'loading' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Spinner, {}), " Buscando..."] }) })) : null, searchState.status === 'loaded' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [searchState.degraded ? (_jsxs(Text, { color: theme.warning, children: [symbols.warning, " ", searchState.warnings.join(' ')] })) : null, _jsx(Text, { children: searchState.content })] })) : null, searchState.status === 'error-network' || searchState.status === 'error-forbidden' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.danger, children: [symbols.cross, " ", searchState.message] }) })) : null, searchState.status === 'auth-aborted' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: searchState.message }) })) : null] })) : (_jsxs(_Fragment, { children: [state.status === 'loading' ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Spinner, {}), " Carregando issues..."] }) })) : null, state.status === 'empty' ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "nenhuma issue atribu\u00EDda" }) })) : null, state.status === 'error-network' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.danger, children: [symbols.cross, " Falha ao carregar suas issues: ", state.message] }), _jsxs(Text, { color: theme.muted, children: ["Pressione", ' ', _jsx(Text, { color: theme.accent, children: "r" }), ' ', "para tentar de novo."] })] })) : null, state.status === 'error-forbidden' ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.danger, children: [symbols.cross, " ", state.message] }), _jsxs(Text, { color: theme.muted, children: ["Pressione", ' ', _jsx(Text, { color: theme.accent, children: "r" }), ' ', "para tentar de novo."] })] })) : null, state.status === 'auth-aborted' ? (
+                    // Fix do review #120: estado NEUTRO (abandono consciente do re-login,
+                    // Esc) — `theme.muted`, não `theme.danger` (não é uma falha).
+                    _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Text, { color: theme.muted, children: state.message }) })) : null, state.status === 'loaded' ? (_jsx(Box, { marginTop: 1, flexDirection: "column", children: state.issues.map((issue, index) => (_jsx(IssueRow, { issue: issue, selected: index === selectedIndex }, issue.id))) })) : null] })), _jsx(Box, { flexGrow: 1 }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: isSearching ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.accent, children: "Esc" }), ' ', "fecha a busca,", ' ', _jsx(Text, { color: theme.accent, children: "f" }), ' ', "cicla o filtro."] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.accent, children: `${glyphs.arrowUp}/${glyphs.arrowDown}` }), ' ', "navega,", ' ', _jsx(Text, { color: theme.accent, children: "Enter" }), ' ', "abre a issue,", ' ', _jsx(Text, { color: theme.accent, children: "/" }), ' ', "busca,", ' ', _jsx(Text, { color: theme.accent, children: "t" }), ' ', "jobs,", ' ', _jsx(Text, { color: theme.accent, children: "Esc" }), ' ', "volta."] })) }) })] }));
+}

package/dist/surfaces/tui/screens/issue-detail.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tela de detalhe: metadados fixos + descrição/journals em viewport rolável.
+ * `b` (ou `Esc`, atalho global) volta para a home — `selectedIndex` da lista
+ * é preservado via `./home-selection.js`.
+ */
+export declare function IssueDetailScreen(): import("react").JSX.Element;