cli: gadak issue prints the markdown source, and --json carries it

The text form printed adf.PlainText of the description and of every
comment, so a heading came out as a bare line and bold as bare words. The
web editor opens on adf.Present's Source (GDK-1386), which made the CLI
the one surface where read → edit -m - → write pressed formatting flat
even inside the markdown subset (GDK-1394).

store.Detail and DetailComment now carry DescriptionMD / BodyMD, derived
on read by the same adf.Present the server uses — one owner, never
stored, the mirror keeps the origin's shape. printIssue prints those;
--json gets description_md and body_md beside the ADF. Golden test:
heading + code mark + bold in a list prints as `##`, backticks and `**`,
and FromMarkdown of the printed text is the stored document.

Gates: go build/vet/test, gofmt, doc-checks (snapshot regenerated).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Author: midagedev

CHANGELOG.ko.md

@@ -4,6 +4,12 @@
 
 ## Unreleased
 
+- **`gadak issue` 가 눌린 평문이 아니라 마크다운을 찍는다.** 설명과 모든 코멘트가 웹
+  편집기가 여는 것과 같은 마크다운 원본으로 나온다 — 헤딩은 `##`, 굵게는 `**`, 코드
+  블록은 펜스 — 그래서 에이전트가 읽은 것이 곧 `edit -m -` 가 받는 것이고, 왕복이
+  서식을 눌러 버리지 않고 유지한다. `--json` 은 ADF 옆에 `description_md`·`body_md`
+  로 싣는다 ([GDK-1394]).
+
 - 툴바의 보드 버튼이 옆 컬럼 메뉴와 같은 세 기둥 글리프가 아니라 칸반 글리프를 단다 —
   손가락 하나 거리의 같은 표시 둘은 컨트롤 하나로 읽힌다. 뷰 컨트롤 넷을 설정 메뉴
   하나로 접는 것은 같은 이슈의 나머지이고 아직 열려 있다 ([GDK-1391]).
@@ -1440,3 +1446,4 @@ HTTP·sync·에이전트 계약을 담았습니다.
 [GDK-1388]: https://gadak.dev/backlog/#/?ks=GDK-1388
 [GDK-1390]: https://gadak.dev/backlog/#/?ks=GDK-1390
 [GDK-1391]: https://gadak.dev/backlog/#/?ks=GDK-1391
+[GDK-1394]: https://gadak.dev/backlog/#/?ks=GDK-1394

CHANGELOG.md

@@ -4,6 +4,13 @@
 
 ## Unreleased
 
+- **`gadak issue` prints the markdown, not the flattened text.** The
+  description and every comment come out as the same markdown source the
+  web editor opens with — a heading is `##`, bold is `**`, a code block is
+  fenced — so what an agent reads is what `edit -m -` takes back, and the
+  round trip keeps the formatting instead of pressing it flat. `--json`
+  carries it as `description_md` and `body_md` beside the ADF ([GDK-1394]).
+
 - The board button in the toolbar wears a kanban glyph, not the same three
   columns as the columns menu beside it — two identical marks a finger apart
   read as one control. Folding the four view controls into one settings menu
@@ -1499,3 +1506,4 @@ and the storage schema plus the HTTP, sync and agent contracts.
 [GDK-1388]: https://gadak.dev/backlog/#/?ks=GDK-1388
 [GDK-1390]: https://gadak.dev/backlog/#/?ks=GDK-1390
 [GDK-1391]: https://gadak.dev/backlog/#/?ks=GDK-1391
+[GDK-1394]: https://gadak.dev/backlog/#/?ks=GDK-1394

cmd/gadak/agent.go

@@ -590,10 +590,10 @@ func printIssue(l store.IssueLite, d *store.Detail, dur store.Spans) {
 		kv(alias, fmt.Sprint(l.Custom[alias]))
 	}
 
-	desc := strings.TrimSpace(adf.PlainText(d.DescriptionADF))
-	if desc == "" {
-		desc = strings.TrimSpace(d.DescriptionText)
-	}
+	// The markdown source, not PlainText (GDK-1394): what this prints is
+	// what `edit -m -` takes back, so a heading read here must still be a
+	// heading after the round trip. Same owner as the web editor.
+	desc := strings.TrimSpace(d.DescriptionMD)
 	if desc != "" {
 		fmt.Printf("\ndescription\n%s\n", indent(desc))
 	} else {
@@ -605,10 +605,7 @@ func printIssue(l store.IssueLite, d *store.Detail, dur store.Spans) {
 	if len(d.Comments) > 0 {
 		fmt.Printf("\ncomments (%d)\n", len(d.Comments))
 		for _, c := range d.Comments {
-			body := strings.TrimSpace(c.Body)
-			if body == "" {
-				body = strings.TrimSpace(adf.PlainText(c.BodyADF))
-			}
+			body := strings.TrimSpace(c.BodyMD)
 			if mark := commentMark(c); mark != "" {
 				if body != "" {
 					body = mark + " " + body

cmd/gadak/agent_test.go

@@ -4,6 +4,7 @@ import (
 	"bytes"
 	"context"
 	"encoding/json"
+	"fmt"
 	"io"
 	"mime"
 	"mime/multipart"
@@ -15,6 +16,7 @@ import (
 	"strings"
 	"testing"
 
+	"github.com/midagedev/gadak/internal/adf"
 	"github.com/midagedev/gadak/internal/config"
 	"github.com/midagedev/gadak/internal/jira"
 	"github.com/midagedev/gadak/internal/origin"
@@ -2837,3 +2839,78 @@ func TestIssueDeriveReportsAnIncompleteCategoryMap(t *testing.T) {
 		t.Errorf("--derive claimed agreement while the category map was short:\n%s", out)
 	}
 }
+
+// GDK-1394: the text form prints the markdown source, so what an agent reads
+// is what `edit -m -` takes back. A heading must come out as `##`, bold as
+// `**`, and FromMarkdown of the printed text must be the stored document —
+// PlainText pressed all of that flat and made the CLI round trip lossy while
+// the web editor (same adf.Present) kept it.
+func TestIssuePrintsMarkdownSource(t *testing.T) {
+	mirror(t, "https://unused.example.com")
+	db, err := store.Open(filepath.Join(os.Getenv("GADAK_HOME"), "gadak.db"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	rich := json.RawMessage(`{"type":"doc","version":1,"content":[` +
+		`{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"Repro"}]},` +
+		`{"type":"paragraph","content":[{"type":"text","text":"run "},{"type":"text","text":"bd ready","marks":[{"type":"code"}]},{"type":"text","text":" twice"}]},` +
+		`{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"second call "},{"type":"text","text":"drops","marks":[{"type":"strong"}]},{"type":"text","text":" the key"}]}]}]}]}`)
+	commentADF := json.RawMessage(`{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"seen on "},{"type":"text","text":"staging","marks":[{"type":"em"}]}]}]}`)
+	if _, err := db.UpsertIssues(context.Background(), store.Batch{
+		Records: []store.IssueRecord{{
+			Item: store.Item{
+				ID: "jira:1003", SourceID: "jira", Kind: "issue", ExternalID: "1003", Key: "NMB-3",
+				Title: "formatted body", BodyText: "Repro\nrun bd ready twice\nsecond call drops the key",
+				CreatedAt: "2026-08-01T00:00:00.000Z", UpdatedAt: "2026-08-01T00:00:00.000Z",
+			},
+			Issue: store.Issue{ProjectKey: "NMB", StatusCategory: "new", Status: "To Do", DescriptionADF: rich},
+			Comments: []store.Comment{{
+				ID: "jira:c-3", ExternalID: "c-3", Author: "Marco Reyes",
+				BodyADF: commentADF, BodyText: "seen on staging", CreatedAt: "2026-08-02T00:00:00.000Z",
+			}},
+		}},
+	}); err != nil {
+		t.Fatal(err)
+	}
+	if err := db.Close(); err != nil {
+		t.Fatal(err)
+	}
+
+	out, err := capture(t, func() error { return cmdIssue([]string{"NMB-3"}) })
+	if err != nil {
+		t.Fatalf("issue: %v", err)
+	}
+	wantDesc := "## Repro\n\nrun `bd ready` twice\n\n- second call **drops** the key"
+	if !strings.Contains(out, "\ndescription\n"+indent(wantDesc)+"\n") {
+		t.Fatalf("description must print as markdown source:\n%s", out)
+	}
+	if !strings.Contains(out, indent("seen on _staging_")) {
+		t.Fatalf("comment must print as markdown source:\n%s", out)
+	}
+	// The round trip: the printed source parses back to the stored document.
+	if got := string(adf.FromMarkdown(wantDesc)); got != string(rich) {
+		var a, b any
+		_ = json.Unmarshal([]byte(got), &a)
+		_ = json.Unmarshal(rich, &b)
+		if fmt.Sprint(a) != fmt.Sprint(b) {
+			t.Fatalf("printed source does not round-trip:\n got %s\nwant %s", got, rich)
+		}
+	}
+
+	out, err = capture(t, func() error { return cmdIssue([]string{"NMB-3", "--json"}) })
+	if err != nil {
+		t.Fatalf("issue --json: %v", err)
+	}
+	var doc struct {
+		DescriptionMD string `json:"description_md"`
+		Comments      []struct {
+			BodyMD string `json:"body_md"`
+		} `json:"comments"`
+	}
+	if err := json.Unmarshal([]byte(out), &doc); err != nil {
+		t.Fatalf("json: %v\n%s", err, out)
+	}
+	if doc.DescriptionMD != wantDesc || len(doc.Comments) != 1 || doc.Comments[0].BodyMD != "seen on _staging_" {
+		t.Fatalf("--json must carry description_md/body_md: %+v", doc)
+	}
+}

examples/backlog-snapshot.tar.gz

@@ -380,7 +380,8 @@ type DetailComment struct {
 	Author     string          `json:"author"`
 	AuthorID   string          `json:"author_id"`
 	BodyADF    json.RawMessage `json:"body_adf"`
-	Body       string          `json:"body"` // flattened; the client's fallback when ADF will not render
+	Body       string          `json:"body"`              // flattened; the client's fallback when ADF will not render
+	BodyMD     string          `json:"body_md,omitempty"` // adf.Present Source (GDK-1394)
 	CreatedAt  string          `json:"created_at"`
 	UpdatedAt  string          `json:"updated_at"`
 	// VisibilityType/VisibilityValue are empty when the origin sent no
@@ -440,11 +441,15 @@ type Detail struct {
 	// DescriptionText is items.body_text. Linear (and any source that does not
 	// store ADF) lands markdown/plain here; surfaces fall back to it when
 	// DescriptionADF is empty. Never stuff markdown into DescriptionADF.
-	DescriptionText string             `json:"description_text,omitempty"`
-	Comments        []DetailComment    `json:"comments"`
-	Attachments     []DetailAttachment `json:"attachments"`
-	History         []DetailChange     `json:"history"`
-	LinkedIssues    []DetailLink       `json:"linked_issues"`
+	DescriptionText string `json:"description_text,omitempty"`
+	// DescriptionMD is the markdown an editor opens with — adf.Present's
+	// Source, the one owner the web and the CLI share (GDK-1394). Derived on
+	// read, never stored: the mirror keeps the origin's shape.
+	DescriptionMD string             `json:"description_md,omitempty"`
+	Comments      []DetailComment    `json:"comments"`
+	Attachments   []DetailAttachment `json:"attachments"`
+	History       []DetailChange     `json:"history"`
+	LinkedIssues  []DetailLink       `json:"linked_issues"`
 	// RefPages are wiki pages this issue's body/comments mention (item_refs,
 	// target_kind=page). Only pages present in the mirror; empty omitted.
 	RefPages []PageLite `json:"ref_pages,omitempty"`
@@ -470,7 +475,7 @@ type Detail struct {
 // handler can answer 404 without importing database/sql.
 func (db *DB) Detail(ctx context.Context, key string) (*Detail, error) {
 	var itemID string
-	var adf *string
+	var descADF *string
 	var customJSON string
 	var bodyText string
 	var createdAt string
@@ -479,15 +484,15 @@ func (db *DB) Detail(ctx context.Context, key string) (*Detail, error) {
 		       COALESCE(it.created_at, '')
 		FROM issues i JOIN items it ON it.id = i.item_id
 		WHERE i.key = ?`, key).
-		Scan(&itemID, &adf, &customJSON, &bodyText, &createdAt); err != nil {
+		Scan(&itemID, &descADF, &customJSON, &bodyText, &createdAt); err != nil {
 		if errors.Is(err, sql.ErrNoRows) {
 			return nil, ErrNotFound
 		}
 		return nil, err
 	}
 	d := &Detail{
 		IssueKey:        key,
-		DescriptionADF:  rawOrNull(adf),
+		DescriptionADF:  rawOrNull(descADF),
 		DescriptionText: bodyText,
 		Comments:        []DetailComment{},
 		Attachments:     []DetailAttachment{},
@@ -498,6 +503,7 @@ func (db *DB) Detail(ctx context.Context, key string) (*Detail, error) {
 		Created: createdAt,
 	}
 	_ = json.Unmarshal([]byte(customJSON), &d.Custom)
+	d.DescriptionMD = adf.Present(d.DescriptionADF, d.DescriptionText).Source
 
 	if err := each(ctx, db.sql, `
 		SELECT id, COALESCE(external_id,''), COALESCE(author,''), COALESCE(author_id,''),
@@ -513,6 +519,7 @@ func (db *DB) Detail(ctx context.Context, key string) (*Detail, error) {
 				return err
 			}
 			c.BodyADF = rawOrNull(body)
+			c.BodyMD = adf.Present(c.BodyADF, c.Body).Source
 			c.JsdPublic = jsdPublicFromSQL(jsd)
 			d.Comments = append(d.Comments, c)
 			return nil