redmine-context 1.0.0

package/dist/surfaces/tui/theme.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Tema central da TUI (M2-02).
+ *
+ * Fonte de literais de cor da TUI (junto de `palettes.ts`, #190, que guarda os
+ * hex das paletas como DADOS de objeto, não como props JSX): toda tela consome
+ * cores via {@link useTheme}, nunca com `color="magenta"` direto no JSX — a
+ * varredura `tests/surfaces/tui/no-hardcoded-colors.test.ts` garante isso em CI
+ * (ela pega `color=`/`backgroundColor=` com literal; as chaves `primary:` de
+ * `palettes.ts` não são props, por isso passam). Centralizar aqui/em `palettes.ts`
+ * torna trocar a paleta uma mudança localizada.
+ *
+ * ## Paleta e guideline de uso
+ *
+ * Combinação sóbria sobre fundo escuro (a paleta padrão de 16 cores do
+ * terminal, resolvida pelo próprio emulador — sem hex fixo, para respeitar o
+ * esquema de cores do usuário):
+ *
+ * - **primary** (`cyan`) — cor de identidade/foco: títulos, item selecionado,
+ *   estado ativo. É a cor mais usada na TUI; se uma tela parece "sem cor
+ *   nenhuma", provavelmente falta um `primary` nela.
+ * - **accent** (`magenta`) — destaque raro: uma call-to-action pontual (ex.:
+ *   a tecla que o usuário deve apertar agora). Usar com moderação — se
+ *   `accent` aparece em toda linha da tela, ele deixou de ser um destaque.
+ * - **muted** (`gray`) — texto secundário/de apoio: dicas, timestamps,
+ *   metadados. Substitui o uso solto de `dimColor` por um tom deliberado.
+ * - **success** (`green`) / **warning** (`yellow`) / **danger** (`red`) —
+ *   reservadas para *estado*, nunca para decoração: resultado de uma
+ *   operação (sucesso/erro) ou um alerta acionável. Não usar `danger` só
+ *   porque "fica bonito" — é reservada para sinalizar problema real.
+ *
+ * Reaproveita os nomes de cor nativos do Ink/chalk (paleta ANSI de 16 cores),
+ * então funciona em qualquer terminal sem depender de suporte a true color.
+ */
+import { createContext, useContext } from 'react';
+/** Tema padrão da TUI — ver guideline de uso na documentação do arquivo. */
+export const DEFAULT_THEME = {
+    primary: 'cyan',
+    accent: 'magenta',
+    muted: 'gray',
+    success: 'green',
+    warning: 'yellow',
+    danger: 'red',
+    border: 'gray',
+};
+const ThemeContext = createContext(undefined);
+/**
+ * Provider do tema — envolve toda a árvore da TUI em `app.tsx`.
+ *
+ * Aceita um `theme` customizado (para testes ou temas alternativos
+ * futuros); sem ele, usa {@link DEFAULT_THEME}.
+ */
+export function ThemeProvider({ theme = DEFAULT_THEME, children, }) {
+    return _jsx(ThemeContext.Provider, { value: theme, children: children });
+}
+/**
+ * Hook de tema consumido pelas telas — única forma permitida de obter uma
+ * cor na TUI (ver varredura anti-hardcode).
+ *
+ * @throws {Error} Se chamado fora de um `<ThemeProvider>` — indica erro de
+ *   composição (tela renderizada sem passar pelo roteador/`app.tsx`).
+ */
+export function useTheme() {
+    const theme = useContext(ThemeContext);
+    if (theme === undefined) {
+        throw new Error('useTheme() usado fora de <ThemeProvider>.');
+    }
+    return theme;
+}
+const ThemeControllerContext = createContext(undefined);
+/** Provider do controlador de paleta — montado pelo `App`. */
+export function ThemeControllerProvider({ value, children, }) {
+    return _jsx(ThemeControllerContext.Provider, { value: value, children: children });
+}
+/**
+ * Hook do controlador de paleta — usado pelo seletor de tema.
+ *
+ * @throws {Error} Se chamado fora de um `<ThemeControllerProvider>`.
+ */
+export function useThemeController() {
+    const controller = useContext(ThemeControllerContext);
+    if (controller === undefined) {
+        throw new Error('useThemeController() usado fora de <ThemeControllerProvider>.');
+    }
+    return controller;
+}

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

@@ -0,0 +1,31 @@
+/**
+ * Trunca `text` em `max` caracteres a partir do FIM, terminando com o marcador
+ * de corte quando corta. Uso padrão — subjects, rótulos, qualquer string onde
+ * o INÍCIO é a parte mais relevante.
+ *
+ * @param text - String candidata a corte.
+ * @param max - Largura máxima permitida (colunas). `max <= 0` retorna vazio.
+ * @param ellipsis - Marcador de corte (default: `glyphs.ellipsis`, ASCII no
+ *   terminal legado do Windows). Seu comprimento é descontado do orçamento.
+ * @returns `text` inalterado (couber) ou cortado com reticências ao final.
+ *
+ * @example
+ * truncate('Refatorar o pipeline de exportação de anexos', 20); // 'Refatorar o pipel…'
+ */
+export declare function truncate(text: string, max: number, ellipsis?: string): string;
+/**
+ * Trunca `text` em `max` caracteres a partir do INÍCIO, iniciando com o
+ * marcador de corte quando corta. Uso em caminhos/campos em edição — onde o
+ * FIM é a parte mais relevante (nome do arquivo ao final de um path, ou o
+ * cursor de digitação de um campo de texto ainda ativo).
+ *
+ * @param text - String candidata a corte.
+ * @param max - Largura máxima permitida (colunas). `max <= 0` retorna vazio.
+ * @param ellipsis - Marcador de corte (default: `glyphs.ellipsis`, ASCII no
+ *   terminal legado do Windows). Seu comprimento é descontado do orçamento.
+ * @returns `text` inalterado (couber) ou cortado com reticências no início.
+ *
+ * @example
+ * truncateStart('/home/usuario/projetos/redmine-context/saida', 20); // '…text/redmine-context/saida'.slice — ver teste para o valor exato
+ */
+export declare function truncateStart(text: string, max: number, ellipsis?: string): string;

package/dist/surfaces/tui/truncate.js

@@ -0,0 +1,81 @@
+/**
+ * Truncamento por largura, unificado (M2-16, #39) — fonte única para cortar
+ * strings que podem estourar a largura do terminal (subject da issue, valor
+ * de um `StatusRow` do doctor, caminho de destino/exportação etc.). Antes
+ * duplicado como função local em `screens/home.tsx`.
+ *
+ * Por que isso é necessário mesmo o Ink já quebrando `<Text>` automaticamente
+ * em várias linhas: dentro de um `<Box>` em linha (`flexDirection: 'row'`, o
+ * padrão do componente), CADA `<Text>` IRMÃ tenta se auto-ajustar à largura
+ * restante de forma independente — quando uma delas (ex.: o subject de uma
+ * issue) é mais longa que o espaço sobrando, o resultado observado é
+ * sobreposição ilegível entre o conteúdo dela e o das irmãs seguintes
+ * (confirmado empiricamente antes desta mudança: um subject comprido "vazava"
+ * por cima do badge de status da linha). Truncar explicitamente o campo
+ * variável ANTES de renderizar evita esse caso — diferente de um bloco de
+ * texto isolado (ex.: descrição/journals em `screens/issue-detail.tsx`), que
+ * pode seguir confiando no wrap nativo do Ink sem risco de sobreposição.
+  *
+ * LIMITAÇÃO ACEITA (review #126): mede em unidades UTF-16 (`.length`), não em
+ * largura visual de terminal — acentos PT-BR ocupam 1 coluna e funcionam;
+ * CJK/emoji (largura dupla) podem estourar o orçamento. Suporte real de
+ * largura visual (ex.: string-width) fica para quando houver demanda — ver
+ * issue de follow-up da responsividade.
+ *
+ * HARDENING WINDOWS LEGADO (M5-09, #84): o marcador de corte deixou de ser um
+ * literal fixo `'…'` e passa a vir de `./glyphs.ts`, que degrada para `'...'`
+ * no terminal legado do Windows (evitando o mojibake da reticência Unicode).
+ * Como o fallback ASCII tem LARGURA 3 (vs. 1 do `'…'`), a matemática de corte
+ * agora desconta `ellipsis.length` em vez de assumir 1 — do contrário o
+ * resultado ASCII estouraria a largura orçada. O marcador é um parâmetro com
+ * default (`glyphs.ellipsis`) para manter as funções puras e testáveis com
+ * qualquer largura de reticência.
+ */
+import { glyphs } from './glyphs.js';
+/**
+ * Trunca `text` em `max` caracteres a partir do FIM, terminando com o marcador
+ * de corte quando corta. Uso padrão — subjects, rótulos, qualquer string onde
+ * o INÍCIO é a parte mais relevante.
+ *
+ * @param text - String candidata a corte.
+ * @param max - Largura máxima permitida (colunas). `max <= 0` retorna vazio.
+ * @param ellipsis - Marcador de corte (default: `glyphs.ellipsis`, ASCII no
+ *   terminal legado do Windows). Seu comprimento é descontado do orçamento.
+ * @returns `text` inalterado (couber) ou cortado com reticências ao final.
+ *
+ * @example
+ * truncate('Refatorar o pipeline de exportação de anexos', 20); // 'Refatorar o pipel…'
+ */
+export function truncate(text, max, ellipsis = glyphs.ellipsis) {
+    if (max <= 0)
+        return '';
+    if (text.length <= max)
+        return text;
+    if (max <= ellipsis.length)
+        return ellipsis.slice(0, max);
+    return `${text.slice(0, max - ellipsis.length)}${ellipsis}`;
+}
+/**
+ * Trunca `text` em `max` caracteres a partir do INÍCIO, iniciando com o
+ * marcador de corte quando corta. Uso em caminhos/campos em edição — onde o
+ * FIM é a parte mais relevante (nome do arquivo ao final de um path, ou o
+ * cursor de digitação de um campo de texto ainda ativo).
+ *
+ * @param text - String candidata a corte.
+ * @param max - Largura máxima permitida (colunas). `max <= 0` retorna vazio.
+ * @param ellipsis - Marcador de corte (default: `glyphs.ellipsis`, ASCII no
+ *   terminal legado do Windows). Seu comprimento é descontado do orçamento.
+ * @returns `text` inalterado (couber) ou cortado com reticências no início.
+ *
+ * @example
+ * truncateStart('/home/usuario/projetos/redmine-context/saida', 20); // '…text/redmine-context/saida'.slice — ver teste para o valor exato
+ */
+export function truncateStart(text, max, ellipsis = glyphs.ellipsis) {
+    if (max <= 0)
+        return '';
+    if (text.length <= max)
+        return text;
+    if (max <= ellipsis.length)
+        return ellipsis.slice(0, max);
+    return `${ellipsis}${text.slice(text.length - (max - ellipsis.length))}`;
+}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "redmine-context",
+  "version": "1.0.0",
+  "description": "Consumidor de Redmine que entrega contexto completo de issues (texto + mídia extraída localmente) para qualquer LLM",
+  "type": "module",
+  "license": "MIT",
+  "author": "Victor Deserto",
+  "keywords": [
+    "redmine",
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "context",
+    "cli",
+    "tui",
+    "ink",
+    "ocr",
+    "transcription",
+    "issue-tracker"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vdeserto/redmine-context.git"
+  },
+  "homepage": "https://github.com/vdeserto/redmine-context#readme",
+  "bugs": {
+    "url": "https://github.com/vdeserto/redmine-context/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "redmine-context": "dist/surfaces/cli/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run --coverage",
+    "seed": "node scripts/seed.mjs",
+    "e2e": "node scripts/e2e.mjs",
+    "e2e:ci": "node scripts/e2e-ci.mjs",
+    "ci:e2e:up": "bash scripts/ci-e2e-up.sh",
+    "record:fixtures": "node scripts/record-fixtures.mjs",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.1",
+    "@types/node": "^20.19.43",
+    "@types/react": "^19.2.17",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.31.0",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.36.0",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@inkjs/ui": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@napi-rs/keyring": "^1.3.0",
+    "env-paths": "^4.0.0",
+    "figures": "^6.1.0",
+    "ink": "^6.8.0",
+    "ink-task-list": "^2.0.0",
+    "react": "^19.2.8",
+    "zod": "^4.4.3"
+  },
+  "optionalDependencies": {
+    "@napi-rs/keyring-darwin-arm64": "^1.3.0",
+    "@napi-rs/keyring-darwin-x64": "^1.3.0",
+    "@napi-rs/keyring-linux-x64-gnu": "^1.3.0",
+    "@napi-rs/keyring-win32-x64-msvc": "^1.3.0"
+  }
+}