@andypai/agent-kanban 0.3.0 → 0.3.2

package/README.md

@@ -2,11 +2,21 @@
 
 [![CI](https://github.com/abpai/agent-kanban/actions/workflows/ci.yml/badge.svg)](https://github.com/abpai/agent-kanban/actions/workflows/ci.yml)
 
-Agent-friendly kanban board CLI. Manage tasks via bash commands, parse structured JSON output.
+`agent-kanban` exists because browser-first project tools are a bad control
+plane for agents, shell scripts, and CI jobs. If automation has to click
+through a web app, scrape HTML, or learn a different integration for every
+tracker, the setup gets brittle fast.
 
-## Why
+This repo gives you one small contract across three modes: a local SQLite board,
+Linear, and Jira Cloud. The CLI stays the same. The JSON envelope stays the
+same. Humans still get an optional dashboard when they want a visual pass.
 
-Most project-management tools are built for humans clicking through UIs. `agent-kanban` is built for **CLI-first workflows** — AI agents and scripts get deterministic JSON they can parse, humans get a pretty-printed view and a web dashboard. Runs against a local SQLite file, a Linear backend, or a Jira Cloud project.
+That buys you a few things that are easy to miss at first:
+
+- You can prototype an agent against a local board, then point the same workflow at Linear or Jira later.
+- Remote modes use webhooks plus polling fallback, so missed events are less painful than with one-shot scripts or browser automation.
+- Local mode needs no external database or service, which makes scratch boards, demos, and CI setups much easier to spin up.
+- The repo also includes a reusable MCP layer, so sibling tools can reuse the same tracker semantics instead of growing their own tracker adapter.
 
 ## Documentation
 
@@ -107,6 +117,13 @@ kanban board view
 | webhooks                   | no    | yes    | yes  |
 
 Linear tasks carry an `externalRef` (e.g. `TEAM-123`) and a `url`. Commands accept either the internal ID or the external ref.
+Jira tasks can also be addressed by issue key (for example `ENG-123`).
+
+Local mode is still the only mode with built-in metrics, config mutation, bulk
+cleanup, and the dashboard/bootstrap activity feed. Linear and Jira do keep
+remote issue history and comment counts in their cache tables for sync and
+provider-backed flows, but those modes do not expose the same local analytics
+surface.
 
 Unsupported operations return error code `UNSUPPORTED_OPERATION` with exit code 1.
 
@@ -223,6 +240,16 @@ kanban serve --port 8080
 kanban serve --tunnel   # optional public URL for webhook testing
 ```
 
+### mcp
+
+```bash
+kanban mcp
+kanban mcp --db /path/to/board.db
+```
+
+Runs the bundled MCP server over stdio for local MCP clients such as Claude
+Desktop. See [`docs/mcp.md`](docs/mcp.md) for the tool surface and caveats.
+
 ## Global flags
 
 | Flag               | Description                                                                                      |
@@ -278,8 +305,10 @@ Comment routes:
 ## Reusable MCP core
 
 The repo also includes a reusable tracker MCP implementation under `src/mcp/`.
-It is intended for sibling workspaces and in-repo consumers rather than the
-`kanban` CLI itself.
+There are two ways to use it today:
+
+- run `kanban mcp` for a bundled stdio MCP server
+- import the helpers in `src/mcp/` from a sibling workspace or in-repo consumer
 
 See [`docs/mcp.md`](docs/mcp.md) for the current default tool set, the auth and
 policy model, and the caveats around source-level imports and `kanban serve`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andypai/agent-kanban",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Agent-friendly kanban board CLI. Manage tasks via bash commands, parse structured JSON output.",
   "homepage": "https://github.com/abpai/agent-kanban#readme",
   "repository": {

package/src/__tests__/activity.test.ts

@@ -9,8 +9,8 @@ import {
   moveTask,
   bulkMoveAll,
   bulkClearDone,
-} from '../db.ts'
-import { listActivity } from '../activity.ts'
+} from '../db'
+import { listActivity } from '../activity'
 
 let db: Database
 

package/src/__tests__/api.test.ts

@@ -1,8 +1,8 @@
 import { beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { initSchema, seedDefaultColumns, addTask } from '../db.ts'
-import { handleRequest } from '../api.ts'
-import { createProvider } from '../providers/index.ts'
+import { initSchema, seedDefaultColumns, addTask } from '../db'
+import { handleRequest } from '../api'
+import { createProvider } from '../providers/index'
 
 let db: Database
 let provider: ReturnType<typeof createProvider>

package/src/__tests__/commands/board.test.ts

@@ -1,8 +1,8 @@
 import { describe, expect, test, beforeEach } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { getBoardView, initSchema, seedDefaultColumns } from '../../db.ts'
-import { boardInit, boardReset } from '../../commands/board.ts'
-import { KanbanError } from '../../errors.ts'
+import { getBoardView, initSchema, seedDefaultColumns } from '../../db'
+import { boardInit, boardReset } from '../../commands/board'
+import { KanbanError } from '../../errors'
 
 let db: Database
 

package/src/__tests__/commands/bulk.test.ts

@@ -1,8 +1,8 @@
 import { describe, expect, test, beforeEach } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { initSchema, seedDefaultColumns, addTask, listTasks } from '../../db.ts'
-import { bulkMoveAllCmd, bulkClearDoneCmd } from '../../commands/bulk.ts'
-import { KanbanError } from '../../errors.ts'
+import { initSchema, seedDefaultColumns, addTask, listTasks } from '../../db'
+import { bulkMoveAllCmd, bulkClearDoneCmd } from '../../commands/bulk'
+import { KanbanError } from '../../errors'
 
 let db: Database
 

package/src/__tests__/commands/column.test.ts

@@ -1,15 +1,15 @@
 import { describe, expect, test, beforeEach } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { initSchema, seedDefaultColumns, addTask } from '../../db.ts'
+import { initSchema, seedDefaultColumns, addTask } from '../../db'
 import {
   columnAdd,
   columnList,
   columnRename,
   columnReorder,
   columnDelete,
-} from '../../commands/column.ts'
-import { KanbanError } from '../../errors.ts'
-import type { Column } from '../../types.ts'
+} from '../../commands/column'
+import { KanbanError } from '../../errors'
+import type { Column } from '../../types'
 
 let db: Database
 

package/src/__tests__/conflict.test.ts

@@ -1,8 +1,8 @@
 import { beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { initSchema, seedDefaultColumns } from '../db.ts'
-import { LocalProvider } from '../providers/local.ts'
-import { ErrorCode, KanbanError } from '../errors.ts'
+import { initSchema, seedDefaultColumns } from '../db'
+import { LocalProvider } from '../providers/local'
+import { ErrorCode, KanbanError } from '../errors'
 
 let db: Database
 let provider: LocalProvider

package/src/__tests__/db.test.ts

@@ -25,8 +25,8 @@ import {
   bulkClearDone,
   resetBoard,
   migrateSchema,
-} from '../db.ts'
-import { KanbanError } from '../errors.ts'
+} from '../db'
+import { KanbanError } from '../errors'
 
 let db: Database
 let originalCwd: string

package/src/__tests__/id.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test'
-import { generateId } from '../id.ts'
+import { generateId } from '../id'
 
 describe('generateId', () => {
   test('generates task IDs with t_ prefix', () => {

package/src/__tests__/index.test.ts

@@ -3,9 +3,9 @@ import { Database } from 'bun:sqlite'
 import { mkdtempSync, rmSync } from 'node:fs'
 import { join } from 'node:path'
 import { tmpdir } from 'node:os'
-import { ErrorCode, KanbanError, type ErrorCodeValue } from '../errors.ts'
-import type { Task } from '../types.ts'
-import { parseServeArgs, run } from '../index.ts'
+import { ErrorCode, KanbanError, type ErrorCodeValue } from '../errors'
+import type { Task } from '../types'
+import { parseServeArgs, run } from '../index'
 
 async function withTempDb(runTest: (dbPath: string) => Promise<void>): Promise<void> {
   const dir = mkdtempSync(join(tmpdir(), 'kanban-run-'))

package/src/__tests__/jira-adf.test.ts

@@ -1,5 +1,31 @@
 import { describe, expect, test } from 'bun:test'
-import { adfToPlainText, plainTextToAdf, type AdfDocument } from '../providers/jira-adf.ts'
+import {
+  adfToPlainText,
+  plainTextToAdf,
+  type AdfBulletListNode,
+  type AdfCodeBlockNode,
+  type AdfDocument,
+  type AdfInlineNode,
+  type AdfParagraphNode,
+} from '../providers/jira-adf'
+
+function firstParagraphContent(doc: AdfDocument): AdfInlineNode[] {
+  const paragraph = doc.content[0] as AdfParagraphNode
+  expect(paragraph.type).toBe('paragraph')
+  return paragraph.content ?? []
+}
+
+function firstCodeBlock(doc: AdfDocument): AdfCodeBlockNode {
+  const code = doc.content[0] as AdfCodeBlockNode
+  expect(code.type).toBe('codeBlock')
+  return code
+}
+
+function firstBulletList(doc: AdfDocument): AdfBulletListNode {
+  const list = doc.content[0] as AdfBulletListNode
+  expect(list.type).toBe('bulletList')
+  return list
+}
 
 describe('plainTextToAdf / adfToPlainText', () => {
   test('empty doc round-trip', () => {
@@ -91,6 +117,18 @@ describe('plainTextToAdf / adfToPlainText', () => {
     expect(adfToPlainText(doc)).toBe(input)
   })
 
+  test('garage-baton fenced comment round-trips byte-for-byte', () => {
+    const input =
+      'garage-triage: ✅ Accepted — abpai/garage-band\n\nIncrement SMOKE_TEST_TASK.md from current_count=1 to 2.\n\n```garage-baton\n{"v":1,"accepted":true,"repo":{"owner":"abpai","name":"garage-band"},"questions":[],"summary":"Increment smoke counter."}\n```'
+    const doc = plainTextToAdf(input)
+    const code = doc.content.find((node) => node.type === 'codeBlock') as
+      | { type: string; attrs?: { language?: string } }
+      | undefined
+
+    expect(code?.attrs?.language).toBe('garage-baton')
+    expect(adfToPlainText(doc)).toBe(input)
+  })
+
   test('mixed content (paragraph + list + code block) round-trip', () => {
     const input = 'intro paragraph\n\n- a\n- b\n\n```js\nconsole.log(1)\n```\n\nouttro'
     const doc = plainTextToAdf(input)
@@ -142,7 +180,7 @@ describe('plainTextToAdf / adfToPlainText', () => {
     expect(adfToPlainText(doc)).toBe('before\n\nafter')
   })
 
-  test('inline text marks are stripped on read', () => {
+  test('strong + link marks survive on read as markdown', () => {
     const doc: AdfDocument = {
       version: 1,
       type: 'doc',
@@ -151,12 +189,240 @@ describe('plainTextToAdf / adfToPlainText', () => {
           type: 'paragraph',
           content: [
             { type: 'text', text: 'bold', marks: [{ type: 'strong' }] },
-            { type: 'text', text: ' normal' },
+            { type: 'text', text: ' ' },
+            {
+              type: 'text',
+              text: 'click',
+              marks: [{ type: 'link', attrs: { href: 'https://example.com' } }],
+            },
+          ],
+        },
+      ],
+    }
+    expect(adfToPlainText(doc)).toBe('**bold** [click](https://example.com)')
+  })
+
+  test('write path emits **bold** as a strong mark', () => {
+    const input = 'hello **world**'
+    const doc = plainTextToAdf(input)
+    expect(firstParagraphContent(doc)).toEqual([
+      { type: 'text', text: 'hello ' },
+      { type: 'text', text: 'world', marks: [{ type: 'strong' }] },
+    ])
+    expect(adfToPlainText(doc)).toBe(input)
+  })
+
+  test('write path emits [label](https://...) as a link mark', () => {
+    const input = 'see [docs](https://example.com/x)'
+    const doc = plainTextToAdf(input)
+    expect(firstParagraphContent(doc)).toEqual([
+      { type: 'text', text: 'see ' },
+      {
+        type: 'text',
+        text: 'docs',
+        marks: [{ type: 'link', attrs: { href: 'https://example.com/x' } }],
+      },
+    ])
+    expect(adfToPlainText(doc)).toBe(input)
+  })
+
+  test('write path emits side-by-side bold and link as adjacent text nodes', () => {
+    const input = '**PR opened** — [repo#1](https://github.com/o/r/pull/1)'
+    const doc = plainTextToAdf(input)
+    expect(firstParagraphContent(doc)).toEqual([
+      { type: 'text', text: 'PR opened', marks: [{ type: 'strong' }] },
+      { type: 'text', text: ' — ' },
+      {
+        type: 'text',
+        text: 'repo#1',
+        marks: [{ type: 'link', attrs: { href: 'https://github.com/o/r/pull/1' } }],
+      },
+    ])
+    expect(adfToPlainText(doc)).toBe(input)
+  })
+
+  test('write path bolds bullet item field-name prefix', () => {
+    const input = '- **Marker:** drift:HUMAN REVIEW:516652'
+    const doc = plainTextToAdf(input)
+    const list = firstBulletList(doc)
+    const itemParagraph = list.content[0]!.content[0] as AdfParagraphNode
+    const itemContent = itemParagraph.content ?? []
+    expect(itemContent).toEqual([
+      { type: 'text', text: 'Marker:', marks: [{ type: 'strong' }] },
+      { type: 'text', text: ' drift:HUMAN REVIEW:516652' },
+    ])
+    expect(adfToPlainText(doc)).toBe(input)
+  })
+
+  test('inline tokenizer does NOT run inside fenced code blocks', () => {
+    const input = '```ts\nconst s = "**not bold** [x](https://e.com)"\n```'
+    const doc = plainTextToAdf(input)
+    const code = firstCodeBlock(doc)
+    const codeContent = code.content ?? []
+    expect(codeContent).toHaveLength(1)
+    expect(codeContent[0]?.text).toBe('const s = "**not bold** [x](https://e.com)"')
+    expect(codeContent[0]?.marks).toBeUndefined()
+    expect(adfToPlainText(doc)).toBe(input)
+  })
+
+  test('read: code block text marks stay literal', () => {
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [
+        {
+          type: 'codeBlock',
+          content: [
+            { type: 'text', text: '**not bold**', marks: [{ type: 'strong' }] },
+            {
+              type: 'text',
+              text: '\nhttps://example.com',
+              marks: [{ type: 'link', attrs: { href: 'https://example.com' } }],
+            },
+          ],
+        },
+      ],
+    }
+    expect(adfToPlainText(doc)).toBe('```\n**not bold**\nhttps://example.com\n```')
+  })
+
+  test('non-http link target is left as literal text (no link mark)', () => {
+    const input = 'see [docs](mailto:dev@example.com)'
+    const doc = plainTextToAdf(input)
+    expect(firstParagraphContent(doc)).toEqual([{ type: 'text', text: input }])
+  })
+
+  test('read: paragraph containing inlineCard emits the URL inline', () => {
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: 'Repo: ' },
+            { type: 'inlineCard', attrs: { url: 'https://github.com/abpai/garage-band' } },
+          ],
+        },
+      ],
+    }
+    expect(adfToPlainText(doc)).toBe('Repo: https://github.com/abpai/garage-band')
+  })
+
+  test('read: split strong field label keeps colon inside markdown', () => {
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: 'Repo', marks: [{ type: 'strong' }] },
+            { type: 'text', text: ': ' },
+            { type: 'inlineCard', attrs: { url: 'https://github.com/abpai/garage-band' } },
+          ],
+        },
+      ],
+    }
+    expect(adfToPlainText(doc)).toBe('**Repo:** https://github.com/abpai/garage-band')
+  })
+
+  test('read: blockCard renders as a standalone block with the URL', () => {
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [
+        { type: 'paragraph', content: [{ type: 'text', text: 'before' }] },
+        { type: 'blockCard', attrs: { url: 'https://github.com/abpai/garage-band' } },
+        { type: 'paragraph', content: [{ type: 'text', text: 'after' }] },
+      ],
+    }
+    expect(adfToPlainText(doc)).toBe('before\n\nhttps://github.com/abpai/garage-band\n\nafter')
+  })
+
+  test('read: embedCard also emits its URL', () => {
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [{ type: 'embedCard', attrs: { url: 'https://example.com/embed' } }],
+    }
+    expect(adfToPlainText(doc)).toBe('https://example.com/embed')
+  })
+
+  test('read: DXS-12-shaped description preserves smart-link Repo URL', () => {
+    // Captured shape from a real Jira description where a user pasted a URL
+    // and Jira auto-converted it to an inlineCard. Before the fix,
+    // adfToPlainText returned "Repo: " with the URL silently dropped.
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: 'Repo', marks: [{ type: 'strong' }] },
+            { type: 'text', text: ': ' },
+            { type: 'inlineCard', attrs: { url: 'https://github.com/abpai/garage-band' } },
+          ],
+        },
+        {
+          type: 'paragraph',
+          content: [{ type: 'text', text: 'Please make one minimal change.' }],
+        },
+        {
+          type: 'heading',
+          attrs: { level: 3 },
+          content: [{ type: 'text', text: 'Acceptance criteria:' }],
+        },
+        {
+          type: 'bulletList',
+          content: [
+            {
+              type: 'listItem',
+              content: [
+                {
+                  type: 'paragraph',
+                  content: [{ type: 'text', text: 'Change only SMOKE_TEST_TASK.md.' }],
+                },
+              ],
+            },
+            {
+              type: 'listItem',
+              content: [
+                {
+                  type: 'paragraph',
+                  content: [{ type: 'text', text: 'Increment current_count by exactly one.' }],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    }
+    const out = adfToPlainText(doc)
+    expect(out).toContain('Repo:')
+    expect(out).toContain('https://github.com/abpai/garage-band')
+    // Repo line carries the URL — agents grepping for the URL recover it.
+    const repoLine = out.split('\n').find((l) => l.includes('Repo:'))
+    expect(repoLine).toBe('**Repo:** https://github.com/abpai/garage-band')
+  })
+
+  test('read: hardBreak between text runs emits newline', () => {
+    const doc: AdfDocument = {
+      version: 1,
+      type: 'doc',
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: 'first line' },
+            { type: 'hardBreak' },
+            { type: 'text', text: 'second line' },
           ],
         },
       ],
     }
-    expect(adfToPlainText(doc)).toBe('bold normal')
+    expect(adfToPlainText(doc)).toBe('first line\nsecond line')
   })
 
   test('bullet item containing digits-dot substring is still a bullet', () => {

package/src/__tests__/jira-cache.test.ts

@@ -15,7 +15,7 @@ import {
   saveJiraSyncMeta,
   upsertJiraIssues,
   upsertJiraUsers,
-} from '../providers/jira-cache.ts'
+} from '../providers/jira-cache'
 
 let db: Database
 

package/src/__tests__/jira-client.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, test } from 'bun:test'
 import { Buffer } from 'node:buffer'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { JiraClient } from '../providers/jira-client.ts'
+import { ErrorCode, KanbanError } from '../errors'
+import { JiraClient } from '../providers/jira-client'
 
 const origFetch = globalThis.fetch
 let lastRequest: { url: string; init?: RequestInit } | null = null

package/src/__tests__/jira-provider-comment.test.ts

@@ -1,13 +1,13 @@
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { JiraClient } from '../providers/jira-client.ts'
-import { JiraProvider, type JiraProviderConfig } from '../providers/jira.ts'
+import { JiraClient } from '../providers/jira-client'
+import { JiraProvider, type JiraProviderConfig } from '../providers/jira'
 import {
   initJiraCacheSchema,
   saveJiraSyncMeta,
   saveTeamInfo,
   upsertJiraIssues,
-} from '../providers/jira-cache.ts'
+} from '../providers/jira-cache'
 
 const baseConfig: JiraProviderConfig = {
   baseUrl: 'https://example.atlassian.net',

package/src/__tests__/jira-provider-mutations.test.ts

@@ -1,8 +1,8 @@
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { JiraClient } from '../providers/jira-client.ts'
-import { JiraProvider, type JiraProviderConfig } from '../providers/jira.ts'
+import { ErrorCode, KanbanError } from '../errors'
+import { JiraClient } from '../providers/jira-client'
+import { JiraProvider, type JiraProviderConfig } from '../providers/jira'
 import {
   initJiraCacheSchema,
   replaceJiraColumns,
@@ -12,7 +12,7 @@ import {
   saveTeamInfo,
   upsertJiraIssues,
   upsertJiraUsers,
-} from '../providers/jira-cache.ts'
+} from '../providers/jira-cache'
 
 type FetchInit = RequestInit | undefined
 type StubCall = { url: string; method: string; body: string | null }

package/src/__tests__/jira-provider-read.test.ts

@@ -1,8 +1,8 @@
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { JiraClient } from '../providers/jira-client.ts'
-import { JiraProvider, type JiraProviderConfig } from '../providers/jira.ts'
+import { ErrorCode, KanbanError } from '../errors'
+import { JiraClient } from '../providers/jira-client'
+import { JiraProvider, type JiraProviderConfig } from '../providers/jira'
 import {
   getCachedColumns,
   getCachedTasks,
@@ -11,7 +11,7 @@ import {
   saveJiraSyncMeta,
   saveTeamInfo,
   initJiraCacheSchema,
-} from '../providers/jira-cache.ts'
+} from '../providers/jira-cache'
 
 type FetchInit = RequestInit | undefined
 type StubCall = { url: string; init?: FetchInit }
@@ -67,13 +67,14 @@ function makeIssue(opts: {
   updated?: string
   summary?: string
   assignee?: { accountId: string; displayName: string } | null
+  description?: unknown
 }): Record<string, unknown> {
   return {
     id: opts.id,
     key: opts.key,
     fields: {
       summary: opts.summary ?? opts.key,
-      description: null,
+      description: opts.description ?? null,
       status: { id: opts.statusId, name: 'Status ' + opts.statusId },
       issuetype: { id: '10000', name: 'Bug' },
       priority: { id: '2', name: 'High' },
@@ -353,7 +354,7 @@ describe('JiraProvider read path', () => {
     // Sync first (populates statuses-based columns)
     await provider.getBoard()
     // Overwrite with the test-scenario columns + issues directly.
-    const { replaceJiraColumns, upsertJiraIssues } = await import('../providers/jira-cache.ts')
+    const { replaceJiraColumns, upsertJiraIssues } = await import('../providers/jira-cache')
     replaceJiraColumns(db, [
       {
         id: 'board:3:Done',
@@ -429,6 +430,51 @@ describe('JiraProvider read path', () => {
     expect(byPrefixed.externalRef).toBe('ENG-1')
   })
 
+  test('description ADF with an inlineCard smart-link preserves the URL through getTask', async () => {
+    // Regression for the DXS-12 shape: a user pastes
+    // `Repo: https://github.com/abpai/garage-band` in the description, Jira
+    // auto-converts the URL to an inlineCard, and the previous
+    // adfToPlainText silently dropped attrs.url.
+    const description = {
+      version: 1,
+      type: 'doc',
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: 'Repo', marks: [{ type: 'strong' }] },
+            { type: 'text', text: ': ' },
+            { type: 'inlineCard', attrs: { url: 'https://github.com/abpai/garage-band' } },
+          ],
+        },
+        {
+          type: 'paragraph',
+          content: [{ type: 'text', text: 'Increment SMOKE_TEST_TASK.md by 1.' }],
+        },
+      ],
+    }
+    const searchHandler: StubHandler = () =>
+      jsonResponse({
+        startAt: 0,
+        maxResults: 100,
+        total: 1,
+        issues: [
+          makeIssue({
+            id: '20001',
+            key: 'ENG-12',
+            statusId: '10001',
+            description,
+          }),
+        ],
+      })
+    const { provider } = makeProvider(standardRoutes({ searchHandler }))
+    await provider.getBoard()
+    const task = await provider.getTask('ENG-12')
+    expect(task.description).toContain('Repo:')
+    expect(task.description).toContain('https://github.com/abpai/garage-band')
+    expect(task.description.split('\n')[0]).toBe('**Repo:** https://github.com/abpai/garage-band')
+  })
+
   test('getBootstrap returns provider=jira and the adapted BoardConfig', async () => {
     const { provider } = makeProvider(standardRoutes({}))
     const result = await provider.getBootstrap()