sdlc-hub/openspec/changes/wiki-render/proposal.md

Why

Описание и комментарии в карточке задачи веб-приложения показываются исходником вики-разметки Jira: h3. Контекст, # пункт, * пункт, *жирный* видны как символы, длинные структурированные описания (контекст, шаги воспроизведения, критерии готовности) читаются плохо. Хаб хранит эти поля как есть (description, body — wiki, требование «Таблица issue» data-model), разбора разметки в приложении нет — так записано в требовании «Карточка задачи».

Решения владельца 17.10.2026 (brainstorming, jira-hub#53):

• показывать описание и комментарии так, как их показывает Jira — рендер вики-разметки Jira, а не Markdown; Markdown-конструкции в наших описаниях (обратные кавычки, - пункт) выглядят так же, как в Jira;
• исходник остаётся доступен: кнопка у каждого блока — у «Описания» и у каждого комментария отдельно.

What Changes

• Веб-приложение, карточка задачи:
  • «Описание» и текст каждого комментария показываются отрендеренной вики-разметкой Jira: заголовки h1.–h6., *жирный*, _курсив_, -зачёркнутый-, +подчёркнутый+, ^верхний^, ~нижний~, {{моно}}, списки * / # / - с вложенностью, таблицы ||заголовок|| / |ячейка|, блоки {code}, {noformat}, {quote}, bq., ссылки [текст|url], [url] и голые URL, упоминания [~логин], ключи задач проекта (AURORA-123, открывают карточку в окне), ----, разрыв строки \\;
  • всё, что разборщик не знает ({panel}, {color}, картинки !файл! и прочее), выводится обычным текстом как есть;
  • у «Описания» (в заголовке раздела) и у каждого комментария (в строке автора) — кнопка «исходник» / «текст»; исходник выглядит как сейчас — текст с сохранёнными переносами; при каждом открытии карточки всё показано отрендеренным, выбор не запоминается;
  • свёртка длинного описания («развернуть» / «свернуть») работает в обоих режимах.
• Разметка разбирается в браузере собственным модулем на TypeScript в React-элементы; innerHTML / dangerouslySetInnerHTML не используются, новых зависимостей нет.

Non-Goals

• Хаб (API, данные, MCP) и агент не меняются; MCP issue по-прежнему отдаёт исходник.
• Markdown не разбирается.
• Полный набор макросов Jira ({panel}, {color}, {anchor}, {toc}, вложения-картинки, эмодзи :), типографика -- / ---) — нет; неразобранное видно текстом.
• Подсветка синтаксиса в {code} — нет.
• Рендер разметки вне карточки (список «Задачи», доска, «Служебные заметки») — нет.