raptor-aios 0.8.3 → 0.10.0

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to this project will be documented in this file.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.10.0] - 2026-06-11
+
+### Added
+
+- **Jira → spec: nomes de campo resolvidos + filtro de relevância (`packages/core/src/jira/`).** Um card de Jira corporativo carrega centenas de custom fields de configuração (o `CDPOS-6532` real: 1408 campos, 515 não-nulos) que antes inundavam a `## Problem Statement` com blocos `### customfield_NNNNN` ilegíveis. Agora:
+  - **Nomes resolvidos.** O dialeto Rovo (hospedado, OAuth) passa a enviar `expand: "names"`, então cada `customfield_NNNNN` ganha seu rótulo humano ("Critérios de Aceite"). O `mcp-atlassian` (≥ 0.11.2) tem o rótulo desembrulhado do wrapper `{value, name}` (ele nunca ecoa o mapa `names`); `renderedFields` deixou de ser pedido (o servidor o descarta e a combinação suprime custom fields em algumas versões).
+  - **Filtro de relevância (`filterCustomFields`).** Camadas determinísticas (PT/EN, singular+plural): valor-ruído (enums, datas, placeholders) e rótulos de config (Responsável, Relator, Categorias, Branch, Repositório, EI/EO/EQ, CMDB, Nova Data…) caem; allowlist de história (Requisitos, Cenários, Critérios de Aceite, Ressalva de testes, Figma, Traduções, Documentação, Anexo…) e links de ferramenta de design (figma/miro/zeplin/notion/confluence) ficam — avaliados ANTES do denylist. Desconhecidos só ficam com prosa substantiva (rede *lose-nothing*).
+  - **`jira.custom_fields` ganha `exclude` e force-keep** (chaves case-insensitive): `<campo>: exclude` derruba; `<campo>: <bucket>` força a manter.
+  - **Anexos de imagem** (`image/*`) entram como `### Attachments (images)` (links, não baixados); outros tipos ficam no card.
+  - **Critérios de Aceite agrupados por cenário** (`acceptanceLines`): blocos "Cenário N …" viram um `[AC-#]` cada (não um por linha de Gherkin).
+
+### Changed
+
+- **`flattenAdf` rende `taskItem` e `table`.** Uma matriz de aplicabilidade do Jira (grade de checkboxes) agora vira texto legível: **só os itens marcados `[x]` sobrevivem** (os desmarcados são ruído) e tabelas viram uma linha por row com células separadas por `|`. No `CDPOS-6532`, "Cenários aplicáveis" encolheu de 2528 → 607 chars, mostrando o escopo real.
+- **URL do card browsable.** `resolveUrl` prefere o `base_url` do `raptor.yml` ao `self` do gateway `api.atlassian.com` (que não abre no navegador); `jira.base_url` é encanado do `raptor.yml` ao cliente OAuth.
+- **`raptor jira pull`** imprime quantos custom fields foram filtrados (descoberta para o escape hatch); `--json` segue despejando tudo sem filtro. O `jira-refresh.md` (clarify) usa o mesmo filtro — os três consumidores (`new`, `pull`, `jira-refresh`) mostram o mesmo card.
+
+Doc: [`docs/jira-spec-enrichment.md`](docs/jira-spec-enrichment.md) (seções F1–F4 + F3½ + §4b card corporativo). Validado E2E contra o `CDPOS-6532` real via OAuth.
+
+## [0.9.0] - 2026-06-11
+
+### Added
+
+- **Preset `gol-smiles` (G1–G6), empilhável sobre `mobile-opinionated`.** Novo preset bundled (`packages/core/src/presets/gol-smiles.ts` + `gol-smiles-gates.ts`) focado no ecossistema Gol/Smiles (RN + Design System Tangerina, arquitetura `modernization/`): **G1** Tangerina-first UI (vocabulário fechado de componentes/receitas), **G2** arquitetura moderna (Zustand + RHF/Zod), **G3** i18n pt-BR/en/es, **G4** contrato de analytics, **G5** rollout por feature flag, **G6** paridade multi-marca — todos com opt-out honesto. Registrado no `REGISTRY` com aliases `gol`/`smiles`. `init --preset mobile-opinionated,gol-smiles` empilha os 12 artigos e 12 gates; `raptor preset add gol-smiles` ativa num projeto existente.
+- **Render multi-preset na constituição (D-10).** `raptor init --preset a,b` aceita um stack comma-separated e renderiza os artigos de **todos** os presets (`renderPresetsArticles`, atribuição de fonte por preset), gravando `presets:` no `raptor.yml`; `raptor preset add` **anexa** os artigos do novo preset à constituição (append seguro e idempotente, sem sobrescrever artigos do projeto).
+- **Knowledge pack via extensão de preset (D-3).** O schema `raptor.extension/v1` ganhou `provides.knowledge[]` e `requires.preset`; o scaffold instala extensões **condicionalmente ao preset ativo** (`installBundledExtensions`/`collectFrameworkFiles` filtram; `collectKnowledgeRefs` alimenta o bloco de contexto). `buildContextBlock` ganhou a seção "Knowledge packs". A extensão `extensions/gol-smiles/` traz 5 catálogos (Tangerina, kit interno com classificação A/B/C/D, receitas de composição, tokens, 19 regras de conformidade) + o dicionário Figma→Tangerina, referenciados no `CLAUDE.md`/`AGENTS.md`.
+- **Frontmatter ciente do preset (D-2).** `spec.md.hbs`/`plan.md.hbs` emitem os blocos G* (`ui`/`i18n`/`analytics`/`brands` na spec; `architecture`/`rollout` no plan) **somente** quando `gol-smiles` está ativo — projetos non-gol ficam intactos. Mirrors de doc sincronizados.
+- **Verificadores `raptor verify tangerina | i18n | arch` (Fase 3).** Runners reais que medem o código (`packages/core/src/verify/`): tokens literais/lista negra do kit/receita-base e receitas declaradas (tangerina, com modo `--design`), paridade de chaves pt-BR/en/es (i18n), imports banidos e aliases (arch). Achados carregam `regra`/`receita#asserção` + `arquivo:linha` + severidade (`error` bloqueia; `warning` só com `--strict`).
+- **Modo deep gate→verify (D-7), opt-in.** Com `gol_smiles.deep_verify: true` no `raptor.yml`, os gates G1/G2/G3 também executam os runners na avaliação e agregam o resultado em `details` (erro determinístico no código reprova o gate). Sem o opt-in, os gates seguem puramente declarativos (padrão dos gates mobile).
+
 ## [0.8.3] - 2026-06-10
 
 ### Documentation

package/README.md

@@ -360,14 +360,14 @@ Gates são checagens versionadas com um **nível**: 🔴 `critical` (bloqueia, i
 
 Cada gate exige campos no *frontmatter* de `spec.md` ou `plan.md` — declarativos, verificáveis e (para alguns) **mensuráveis** via `verify`.
 
-|                     Gate                      | Nível |                     Exige no frontmatter                     |  Verificável por   |
-| --------------------------------------------- | ----- | ------------------------------------------------------------ | ------------------ |
+|                     Gate                      | Nível |                                                 Exige no frontmatter                                                  |  Verificável por   |
+| --------------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------- | ------------------ |
 | **M1 — App/Play Store Compliance**            | 🟡     | `spec.stores.ios_permissions`, `.android_permissions` (ou `stores.no_restricted_apis: "<motivo>"` p/ opt-out honesto) | `verify stores`    |
-| **M2 — Privacidade & Residência (LGPD/GDPR)** | 🟡     | `plan.privacy.lawful_basis`, `.residency`, `.retention`      | —                  |
-| **M3 — Acessibilidade (WCAG AA)**             | 🟡     | `spec.a11y.wcag_level`, `.criteria`                          | `verify a11y`      |
-| **M4 — Matriz de SO**                         | 🟡     | `plan.os_matrix.ios_min`, `.android_min`                     | `verify os-matrix` |
-| **M5 — Orçamento de Performance**             | 🟡     | `plan.perf_budget.ttfi_ms`, `.interactions_ms`               | `verify perf`      |
-| **M6 — Crash-Free SLO & Observabilidade**     | 🔵     | `plan.crash_free_slo` (≥99.5), `plan.observability.provider` | —                  |
+| **M2 — Privacidade & Residência (LGPD/GDPR)** | 🟡     | `plan.privacy.lawful_basis`, `.residency`, `.retention`                                                               | —                  |
+| **M3 — Acessibilidade (WCAG AA)**             | 🟡     | `spec.a11y.wcag_level`, `.criteria`                                                                                   | `verify a11y`      |
+| **M4 — Matriz de SO**                         | 🟡     | `plan.os_matrix.ios_min`, `.android_min`                                                                              | `verify os-matrix` |
+| **M5 — Orçamento de Performance**             | 🟡     | `plan.perf_budget.ttfi_ms`, `.interactions_ms`                                                                        | `verify perf`      |
+| **M6 — Crash-Free SLO & Observabilidade**     | 🔵     | `plan.crash_free_slo` (≥99.5), `plan.observability.provider`                                                          | —                  |
 
 ### 🔗 M7 — Rastreabilidade código↔spec
 
@@ -454,17 +454,17 @@ Declarar não é cumprir. O Raptor **mede** e compara com o declarado:
 
 ## 🧰 Capacidades do Raptor
 
-|       Capacidade        |                                        Para que serve                                         |                       Comandos                        |
-| ----------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
-| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`, `lean`.   | `raptor preset list · add · info · remove`            |
+|       Capacidade        |                                           Para que serve                                           |                         Comandos                         |
+| ----------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`, `lean`.        | `raptor preset list · add · info · remove`               |
 | 🔁 **Workflows**         | Orquestram o ciclo via YAML, com gates de revisão humana. Bundled: `sdd-cycle`, `sdd-cycle-quick`. | `raptor workflow catalog · run · status · resume · list` |
-| 🤖 **Agentes**           | Materializa os slash commands por agente.                                                     | `raptor add-agent` · `raptor list-agents`             |
-| 🧠 **Skills**            | Habilidades reusáveis materializadas para os agentes.                                         | `raptor skill add · list · sync · remove`             |
-| 🔌 **MCP**               | Registra servidores MCP e materializa nas configs nativas dos agentes.                        | `raptor mcp add · list · sync · remove`               |
-| 🪝 **Hooks**             | Scripts disparados em **34 pontos** do ciclo (`before_*`/`after_*` de 17 comandos).           | `raptor hook list · run`                              |
-| 📦 **Extensões**         | Pacotes self-contained (templates/gates/hooks/workflows).                                     | `raptor extension add · list · info · remove`         |
-| 🎟️ **Jira**             | Puxa issues do Jira (somente leitura) para semear specs.                                      | `raptor jira connect · status · pull · disconnect`    |
-| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                             | `raptor audit query · show` · `raptor trace`          |
+| 🤖 **Agentes**           | Materializa os slash commands por agente.                                                          | `raptor add-agent` · `raptor list-agents`                |
+| 🧠 **Skills**            | Habilidades reusáveis materializadas para os agentes.                                              | `raptor skill add · list · sync · remove`                |
+| 🔌 **MCP**               | Registra servidores MCP e materializa nas configs nativas dos agentes.                             | `raptor mcp add · list · sync · remove`                  |
+| 🪝 **Hooks**             | Scripts disparados em **34 pontos** do ciclo (`before_*`/`after_*` de 17 comandos).                | `raptor hook list · run`                                 |
+| 📦 **Extensões**         | Pacotes self-contained (templates/gates/hooks/workflows).                                          | `raptor extension add · list · info · remove`            |
+| 🎟️ **Jira**             | Puxa issues do Jira (somente leitura) para semear specs.                                           | `raptor jira connect · status · pull · disconnect`       |
+| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                                  | `raptor audit query · show` · `raptor trace`             |
 
 ### 🎟️ Integração com Jira
 
@@ -554,15 +554,15 @@ CLAUDE.md                    # 📎 bloco de contexto do agente
 
 Comece pelo **[📖 Glossário Canônico](docs/glossary.md)** — a referência normativa de todos os termos, gates, hierarquias e anti-padrões do Raptor (Gate, ADR, Override, Canonical, Preset, M1–M8, C1–C5, traceability…). É a base de onboarding para usuários, mantenedores e agentes IA.
 
-| Documento | Sobre |
-| --- | --- |
-| **[📖 docs/glossary.md](docs/glossary.md)** | Glossário canônico: conceitos, hierarquias, catálogo de 42 gates e de comandos CLI |
-| [🛡️ docs/readiness-gates.md](docs/readiness-gates.md) | Gates de prontidão (`spec/plan/tasks.ready`) em detalhe |
-| [🎨 docs/design-gate.md](docs/design-gate.md) | Design gate, integração Figma e `assets-manifest.json` |
-| [🔗 docs/artifact-chain.md](docs/artifact-chain.md) | Cadeia de artefatos e rastreabilidade spec→plan→tasks→código |
-| [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md) | Enriquecimento de spec a partir de cards do Jira |
-| [📐 docs/templates-architecture.md](docs/templates-architecture.md) | Dualidade de templates (`.hbs` vs `*-template.md`) e Priority Stack |
-| [✅ docs/spec-kit-parity.md](docs/spec-kit-parity.md) | Paridade com o GitHub Spec Kit |
+|                             Documento                              |                                       Sobre                                        |
+| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
+| **[📖 docs/glossary.md](docs/glossary.md)**                         | Glossário canônico: conceitos, hierarquias, catálogo de 42 gates e de comandos CLI |
+| [🛡️ docs/readiness-gates.md](docs/readiness-gates.md)              | Gates de prontidão (`spec/plan/tasks.ready`) em detalhe                            |
+| [🎨 docs/design-gate.md](docs/design-gate.md)                       | Design gate, integração Figma e `assets-manifest.json`                             |
+| [🔗 docs/artifact-chain.md](docs/artifact-chain.md)                 | Cadeia de artefatos e rastreabilidade spec→plan→tasks→código                       |
+| [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md)    | Enriquecimento de spec a partir de cards do Jira                                   |
+| [📐 docs/templates-architecture.md](docs/templates-architecture.md) | Dualidade de templates (`.hbs` vs `*-template.md`) e Priority Stack                |
+| [✅ docs/spec-kit-parity.md](docs/spec-kit-parity.md)               | Paridade com o GitHub Spec Kit                                                     |
 
 ### Hierarquia de governança (quem manda)
 

package/dist/_core/dist/agents/context-file.js

@@ -21,6 +21,14 @@ export function buildContextBlock(opts) {
         lines.push(`\n## Applicable articles\n`);
         lines.push(`- ${opts.constitutionArticles.join(", ")}`);
     }
+    if (opts.knowledge && opts.knowledge.length > 0) {
+        lines.push(`\n## Knowledge packs\n`);
+        lines.push("Preset knowledge installed for this project. READ the relevant file before generating code so the output matches the house patterns (components, recipes, tokens, conventions):");
+        lines.push("");
+        for (const ref of opts.knowledge) {
+            lines.push(`- \`${ref}\``);
+        }
+    }
     lines.push("\n## Raptor Commands (slash commands)\n");
     lines.push("- `/raptor-new` — create a new feature spec");
     lines.push("- `/raptor-clarify` — detect and resolve [NEEDS CLARIFICATION] in spec");

package/dist/_core/dist/extensions/types.js

@@ -26,6 +26,7 @@ export const EXTENSION_JSON_SCHEMA = {
             type: "object",
             properties: {
                 raptor_version: { type: "string" },
+                preset: { type: "string" },
             },
             additionalProperties: false,
         },
@@ -37,6 +38,7 @@ export const EXTENSION_JSON_SCHEMA = {
                 hooks: { type: "array", items: { type: "string" } },
                 workflows: { type: "array", items: { type: "string" } },
                 presets: { type: "array", items: { type: "string" } },
+                knowledge: { type: "array", items: { type: "string" } },
             },
             additionalProperties: false,
         },

package/dist/_core/dist/jira/dialects.js

@@ -12,7 +12,7 @@ export const ROVO_DIALECT = {
         transition: ["transitionJiraIssue"],
     },
     args: {
-        getIssue: (cloudId, key) => ({ cloudId, issueIdOrKey: key }),
+        getIssue: (cloudId, key) => ({ cloudId, issueIdOrKey: key, expand: "names" }),
         search: (cloudId, jql, max) => ({ cloudId, jql, maxResults: max }),
         projects: (cloudId) => ({ cloudId }),
         createIssue: (input) => ({
@@ -53,7 +53,7 @@ export const MCP_ATLASSIAN_DIALECT = {
         getIssue: (_cloudId, key) => ({
             issue_key: key,
             fields: "*all",
-            expand: "names,renderedFields",
+            expand: "names",
             comment_limit: 10,
         }),
         search: (_cloudId, jql, max) => ({ jql, limit: max }),

package/dist/_core/dist/jira/index.js

@@ -3,4 +3,4 @@ export * from "./credentials.js";
 export { AtlassianOAuthProvider, isAccessTokenExpired, openBrowser, startCallbackServer, } from "./oauth.js";
 export { connectJira, connectMcpServer, makeJiraClient, clientToToolCaller, decodeToolResult, unwrapEnvelope, expandEnv, missingEnvRefs, } from "./mcp-client.js";
 export { ROVO_DIALECT, MCP_ATLASSIAN_DIALECT, DIALECTS, resolveDialect, detectDialect, } from "./dialects.js";
-export { parseJiraIssue, parseCreatedIssue, extractComments, extractCustomFields, classifyField, flattenFieldValue, mapIssueToSpecContext, flattenAdf, extractAcceptanceCriteria, } from "./mapper.js";
+export { parseJiraIssue, parseCreatedIssue, extractComments, extractCustomFields, extractAttachments, classifyField, filterCustomFields, isBoilerplateValue, isTemplateValue, acceptanceLines, flattenFieldValue, mapIssueToSpecContext, flattenAdf, extractAcceptanceCriteria, } from "./mapper.js";

package/dist/_core/dist/jira/mapper.js

@@ -33,18 +33,49 @@ export function parseJiraIssue(raw, baseUrl) {
         acceptanceCriteria: extractAcceptanceCriteria(fields, description),
         comments: extractComments(fields),
         customFields,
+        attachments: extractAttachments(fields),
         ...(url ? { url } : {}),
     };
 }
+export function extractAttachments(fields) {
+    const list = Array.isArray(fields["attachment"])
+        ? fields["attachment"]
+        : Array.isArray(fields["attachments"])
+            ? fields["attachments"]
+            : [];
+    const out = [];
+    for (const a of list) {
+        if (!isRecord(a))
+            continue;
+        const filename = str(a["filename"]);
+        if (!filename)
+            continue;
+        out.push({
+            filename,
+            mimeType: str(a["mimeType"]) || str(a["content_type"]),
+            url: str(a["content"]) || str(a["url"]),
+        });
+    }
+    return out;
+}
 export function extractCustomFields(fields, names) {
     const out = [];
     for (const [id, raw] of Object.entries(fields)) {
         if (!/^customfield_/i.test(id))
             continue;
-        const value = flattenFieldValue(raw);
+        let label = str(names[id]);
+        let inner = raw;
+        if (isRecord(raw) &&
+            "value" in raw &&
+            Object.keys(raw).every((k) => k === "value" || k === "name")) {
+            if (!label)
+                label = str(raw["name"]);
+            inner = raw["value"];
+        }
+        const value = flattenFieldValue(inner);
         if (!value)
             continue;
-        const name = str(names[id]) || id;
+        const name = label || id;
         out.push({ id, name, value, bucket: classifyField(name) });
     }
     return out;
@@ -55,21 +86,102 @@ export function classifyField(label) {
         return "acceptance";
     if (/cen[áa]rio|scenario/.test(l))
         return "scenarios";
-    if (/n[ãa]o[-\s]?funcional|non[-\s]?functional|\brnf\b/.test(l))
+    if (/n[ãa]o[-\s]?funcional|non[-\s]?functional|\brnf\b|ressalva/.test(l))
         return "nonFunctional";
     if (/requisito|requirement|\brf\b/.test(l))
         return "functional";
     if (/fora do escopo|out of scope|n[ãa]o escopo/.test(l))
         return "outOfScope";
-    if (/documenta|documentation|link|refer[êe]ncia|design|figma/.test(l))
+    if (/documenta|documentation|link|refer[êe]ncia|design|figma|tradu[çc]|translation/.test(l))
         return "docs";
     return "other";
 }
+const ENUM_NOISE = /^(?:sim|n[ãa]o|yes|no|true|false|n\/a|na|none|nenhum|classificar|backlog|portal|no prazo|⏳|✅|❌|-+)$/i;
+const PLACEHOLDER_LINE = /^(?:inserir|informar|descrever|preencher|selecionar|indicar|exportar|insira|informe|descreva|preencha|selecione|indique)\b/i;
+const CARD_CONFIG_LABEL = /\b(?:respons[áa]ve(?:l|is)|relator(?:a|es|as)?|reporter|assignee|aprovador(?:a|es|as)?|squads?|categorias?|data\s+limite|nova\s+data|due\s*date|prazos?|branch(?:es)?|reposit[óo]rios?|repositor(?:y|ies)|entradas?\s+externas?|sa[íi]das?\s+externas?|consultas?\s+externas?|\bei\b|\beo\b|\beq\b|cmdb|aplica[çc][ãa]o\s+afetada|epic\s*links?|rank|development|sprints?|itera[çc](?:[ãa]o|[õo]es)|iterations?|quarters?|garantias?|story\s*points?|time\s*tracking)\b/i;
+const ESSENTIAL_LABEL = /aceite|aceita[çc][ãa]o|acceptance|cen[áa]rio|scenario|requisito|requirement|\brnf\b|\brf\b|ressalva|figma|tradu[çc]|translation|documenta[çc]|documentation|refer[êe]ncia|\bdesign\b|anexo|attachment|prot[óo]tipo|prototype|hist[óo]ria|user\s*stor|fora\s+do\s+escopo|out\s+of\s+scope/i;
+const DOC_TOOL_URL = /\b(?:figma\.com|miro\.com|zeplin\.(?:io|app)|notion\.so|atlassian\.net\/wiki)\b/i;
+export function isBoilerplateValue(value) {
+    const v = value.trim();
+    if (!v)
+        return true;
+    if (ENUM_NOISE.test(v))
+        return true;
+    if (!v.includes("\n") && /^[\d|:.,\-T+Z\s/]+$/.test(v))
+        return true;
+    if (/^(?:espa[çc]o para inser[çc][ãa]o|campos a seguir)/i.test(v))
+        return true;
+    return false;
+}
+export function isTemplateValue(value) {
+    const v = value.trim();
+    if (v.length < 200)
+        return true;
+    if (v.includes("{panel") || v.includes("🚨"))
+        return true;
+    if (/^\{(?:pullrequest|dataType|json)\b/.test(v))
+        return true;
+    const segments = v
+        .split("\n")
+        .flatMap((l) => l.split(" | "))
+        .map((s) => s.replace(/^[-*\d.)\s]+/, "").trim())
+        .filter(Boolean);
+    return segments.filter((s) => PLACEHOLDER_LINE.test(s)).length >= 2;
+}
+export function filterCustomFields(fields, overrides = {}) {
+    const ovByKey = {};
+    for (const [k, v] of Object.entries(overrides))
+        ovByKey[k.toLowerCase()] = v;
+    const out = [];
+    for (const cf of fields) {
+        const ov = ovByKey[cf.id.toLowerCase()] ?? ovByKey[cf.name.toLowerCase()];
+        if (ov && ov.toLowerCase() === "exclude")
+            continue;
+        if (ov) {
+            out.push({ ...cf, bucket: ov });
+            continue;
+        }
+        if (isBoilerplateValue(cf.value))
+            continue;
+        if (ESSENTIAL_LABEL.test(cf.name)) {
+            out.push(cf);
+            continue;
+        }
+        if (DOC_TOOL_URL.test(cf.value)) {
+            out.push({ ...cf, bucket: "docs" });
+            continue;
+        }
+        if (CARD_CONFIG_LABEL.test(cf.name))
+            continue;
+        if (isTemplateValue(cf.value))
+            continue;
+        out.push(cf);
+    }
+    return out;
+}
+export function acceptanceLines(value) {
+    const lines = toLines(value);
+    const isStart = (l) => /^(?:cen[áa]rio|scenario)\b/i.test(l);
+    const starts = lines.filter(isStart).length;
+    const hasGherkin = lines.some((l) => /^(?:dado|quando|ent[ãa]o|given|when|then)\b/i.test(l));
+    if (starts === 0 || (starts === 1 && !hasGherkin))
+        return lines;
+    const blocks = [];
+    for (const l of lines) {
+        if (isStart(l) || blocks.length === 0)
+            blocks.push([l]);
+        else
+            blocks[blocks.length - 1].push(l);
+    }
+    return blocks.map((b) => b.join(" "));
+}
 export function flattenFieldValue(raw) {
     if (raw == null)
         return "";
     if (typeof raw === "string")
         return raw.trim();
+    if (typeof raw === "number" || typeof raw === "boolean")
+        return String(raw);
     if (Array.isArray(raw)) {
         return raw.map(flattenFieldValue).filter(Boolean).join("\n").trim();
     }
@@ -113,11 +225,7 @@ export function extractComments(fields) {
     return out;
 }
 export function mapIssueToSpecContext(issue, opts = {}) {
-    const overrides = opts.fieldBuckets ?? {};
-    const custom = (issue.customFields ?? []).map((cf) => {
-        const ov = overrides[cf.id] ?? overrides[cf.name.toLowerCase()];
-        return ov ? { ...cf, bucket: ov } : cf;
-    });
+    const custom = filterCustomFields(issue.customFields ?? [], opts.fieldBuckets);
     const ac = [];
     const seen = new Set();
     const pushAc = (line) => {
@@ -130,13 +238,19 @@ export function mapIssueToSpecContext(issue, opts = {}) {
     issue.acceptanceCriteria.forEach(pushAc);
     for (const cf of custom)
         if (cf.bucket === "acceptance")
-            toLines(cf.value).forEach(pushAc);
+            acceptanceLines(cf.value).forEach(pushAc);
     const sections = custom
         .filter((cf) => cf.bucket !== "acceptance")
         .map((cf) => ({ title: cf.name, body: cf.value, bucket: cf.bucket }));
+    const images = (issue.attachments ?? []).filter((a) => /^image\//i.test(a.mimeType));
     const ticketBody = [
         issue.description,
         ...sections.map((s) => `### ${s.title}\n${s.body}`),
+        images.length
+            ? `### Attachments (images)\n${images
+                .map((a) => `- [${a.filename}](${a.url})`)
+                .join("\n")}`
+            : "",
     ]
         .filter((s) => s && s.trim())
         .join("\n\n");
@@ -175,6 +289,18 @@ export function flattenAdf(node) {
         if (url)
             return type === "inlineCard" ? url : `${url}\n`;
     }
+    if (type === "taskItem") {
+        const attrs = isRecord(node["attrs"]) ? node["attrs"] : {};
+        if (attrs["state"] !== "DONE")
+            return "";
+        return `- [x] ${flattenAdf(node["content"]).trim()}\n`;
+    }
+    if (type === "tableRow") {
+        const cells = Array.isArray(node["content"])
+            ? node["content"].map((c) => flattenAdf(c).trim().replace(/\s*\n\s*/g, " · "))
+            : [];
+        return `${cells.join(" | ")}\n`;
+    }
     const inner = flattenAdf(node["content"]);
     const blockTypes = new Set([
         "paragraph",
@@ -184,6 +310,8 @@ export function flattenAdf(node) {
         "listItem",
         "codeBlock",
         "blockquote",
+        "table",
+        "taskList",
     ]);
     if (type === "hardBreak")
         return "\n";
@@ -256,13 +384,17 @@ function resolveUrl(issue, fields, key, baseUrl) {
     if (direct)
         return direct;
     const self = str(issue["self"]);
-    if (self) {
+    const selfOrigin = (() => {
         try {
-            return `${new URL(self).origin}/browse/${key}`;
+            const u = new URL(self);
+            return u.hostname === "api.atlassian.com" ? undefined : u.origin;
         }
         catch {
+            return undefined;
         }
-    }
+    })();
+    if (selfOrigin)
+        return `${selfOrigin}/browse/${key}`;
     if (baseUrl) {
         try {
             return `${new URL(baseUrl).origin}/browse/${key}`;
@@ -270,6 +402,13 @@ function resolveUrl(issue, fields, key, baseUrl) {
         catch {
         }
     }
+    if (self) {
+        try {
+            return `${new URL(self).origin}/browse/${key}`;
+        }
+        catch {
+        }
+    }
     return undefined;
 }
 function nestedName(v) {

package/dist/_core/dist/jira/mcp-client.js

@@ -90,6 +90,7 @@ export async function connectJira(opts = {}) {
     }
     return makeJiraClient(await clientToToolCaller(client), {
         dialect: ROVO_DIALECT,
+        ...(opts.baseUrl ? { baseUrl: opts.baseUrl } : {}),
     });
 }
 export async function connectMcpServer(cfg) {