Axon 1943 issue with tasks descriptions having inconsistent format (#1657)

* AXON-1943: Fixed link display in edit mode

* AXON-1943: Fixed issue description losing line breaks

* AXON-1943: Update solution, added @atlaskit/editor-markdown-transformer

* AXON-1943: Update solution, remove @atlaskit/editor-markdown-transformer

* AXON-1943:  added JSONTransformer

* AXON-1943: clean code

* fix changelog

---------

Co-authored-by: Oleksandr Mazepa <omazepa@atlassian.com>
Co-authored-by: Christian Abella <cabella@atlassian.com>

Author: 3 people

CHANGELOG.md

@@ -1,5 +1,11 @@
 ### [Report an Issue](https://github.com/atlassian/atlascode/issues)
 
+## What's new in 4.0.21
+
+### Bug fixes
+
+- Fixed issue description losing line breaks and formatting in edit mode after save (HTML-to-ADF conversion now preserves line breaks as hardBreak nodes)
+
 ## What's new in 4.0.20
 
 ### Features

src/webviews/components/issue/common/adfToWikimarkup.ts

@@ -1,3 +1,4 @@
+import { JSONTransformer } from '@atlaskit/editor-json-transformer';
 import { WikiMarkupTransformer } from '@atlaskit/editor-wikimarkup-transformer';
 
 // ADF (Atlassian Document Format) node structure
@@ -85,17 +86,15 @@ export function convertAdfToWikimarkup(adf: AdfNode | string | null | undefined)
         // Check if it's valid ADF
         if (adfDoc && adfDoc.type === 'doc' && adfDoc.version === 1) {
             try {
-                // Validate ADF structure before transformation
                 if (!adfDoc.content || !Array.isArray(adfDoc.content)) {
                     console.warn('Invalid ADF structure: missing or invalid content array');
                     return extractPlainTextFromAdf(adfDoc);
                 }
 
-                // WikiMarkupTransformer provides its own schema
-                const transformer = new WikiMarkupTransformer();
-                // Convert ADF to WikiMarkup
-                const wikimarkup = transformer.encode(adfDoc);
-                return wikimarkup;
+                const jsonTransformer = new JSONTransformer();
+                const pmNode = jsonTransformer.parse(adfDoc);
+                const wikiTransformer = new WikiMarkupTransformer();
+                return wikiTransformer.encode(pmNode);
             } catch (transformError) {
                 console.warn('WikiMarkup transformer failed, falling back to plain text extraction:', transformError);
                 // Fallback to plain text extraction

src/webviews/components/issue/view-issue-screen/mainpanel/IssueMainPanel.tsx

@@ -92,21 +92,20 @@ const IssueMainPanel: React.FC<Props> = ({
 
     // Use centralized editor state
     const { openEditor, closeEditor, isEditorActive } = useEditorState();
-    // Handle descriptionText - convert ADF object to appropriate format for editor
+    // Use raw description (ADF or string) for the editor; no HTML→ADF conversion.
     const getDescriptionTextForEditor = React.useCallback(() => {
         if (
             typeof defaultDescription === 'object' &&
+            defaultDescription !== null &&
             defaultDescription.version === 1 &&
             defaultDescription.type === 'doc'
         ) {
-            // For new Atlaskit editor: convert ADF to JSON string
             if (isAtlaskitEditorEnabled) {
                 return JSON.stringify(defaultDescription);
             }
-            // For legacy editor: convert ADF to WikiMarkup
             return convertAdfToWikimarkup(defaultDescription);
         }
-        return defaultDescription || '';
+        return typeof defaultDescription === 'string' ? defaultDescription : '';
     }, [defaultDescription, isAtlaskitEditorEnabled]);
 
     const [descriptionText, setDescriptionText] = React.useState(() => getDescriptionTextForEditor());