@andypai/agent-kanban 0.3.0 → 0.3.2

package/src/providers/jira-adf.ts

@@ -2,14 +2,14 @@
 //
 // This module is intentionally dependency-free: no imports from the rest of the
 // provider stack, no bun:sqlite, no fetch. It models only the subset of ADF
-// that agent-kanban round-trips through plain text:
+// that agent-kanban writes, plus a few Jira nodes it must preserve on read:
 //
-//   doc > { paragraph | bulletList | orderedList | codeBlock | heading }
-//   paragraph / heading / codeBlock > text(inline)
+//   doc > { paragraph | bulletList | orderedList | codeBlock | heading | card }
+//   paragraph / heading / codeBlock > text(inline) | inlineCard | hardBreak
 //   bulletList / orderedList > listItem > paragraph > text
 //
-// Unknown node types are tolerated on the read path (skipped silently) and
-// never emitted on the write path.
+// Other unknown node types are tolerated on the read path (skipped silently)
+// and never emitted on the write path.
 
 export interface AdfDocument {
   version: 1
@@ -17,10 +17,15 @@ export interface AdfDocument {
   content: AdfBlockNode[]
 }
 
+export interface AdfMark {
+  type: string
+  attrs?: Record<string, unknown>
+}
+
 export interface AdfTextNode {
   type: 'text'
   text: string
-  marks?: unknown[]
+  marks?: AdfMark[]
 }
 
 export interface AdfUnknownInlineNode {
@@ -92,7 +97,7 @@ function paragraphFromText(text: string): AdfParagraphNode {
   }
   return {
     type: 'paragraph',
-    content: [{ type: 'text', text }],
+    content: tokenizeInline(text),
   }
 }
 
@@ -103,6 +108,39 @@ function listItemFromText(text: string): AdfListItemNode {
   }
 }
 
+const INLINE_MARK = /\*\*([^*\n]+)\*\*|\[([^\]\n]+)\]\((https?:\/\/[^)\s]+)\)/g
+
+function tokenizeInline(text: string): AdfTextNode[] {
+  const out: AdfTextNode[] = []
+  INLINE_MARK.lastIndex = 0
+  let cursor = 0
+  for (const match of text.matchAll(INLINE_MARK)) {
+    const start = match.index ?? 0
+    if (start > cursor) {
+      out.push({ type: 'text', text: text.slice(cursor, start) })
+    }
+    const boldText = match[1]
+    if (boldText !== undefined) {
+      out.push({
+        type: 'text',
+        text: boldText,
+        marks: [{ type: 'strong' }],
+      })
+    } else {
+      out.push({
+        type: 'text',
+        text: match[2]!,
+        marks: [{ type: 'link', attrs: { href: match[3]! } }],
+      })
+    }
+    cursor = start + match[0].length
+  }
+  if (cursor < text.length) {
+    out.push({ type: 'text', text: text.slice(cursor) })
+  }
+  return out
+}
+
 export function plainTextToAdf(text: string): AdfDocument {
   if (text.length === 0) {
     return { version: 1, type: 'doc', content: [] }
@@ -211,18 +249,79 @@ export function plainTextToAdf(text: string): AdfDocument {
   return { version: 1, type: 'doc', content: blocks }
 }
 
-function inlineText(nodes: AdfInlineNode[] | undefined): string {
+function inlineText(
+  nodes: AdfInlineNode[] | undefined,
+  opts: { renderMarks?: boolean } = {},
+): string {
   if (!nodes) return ''
+  const renderMarks = opts.renderMarks ?? true
   let out = ''
-  for (const node of nodes) {
+  for (let i = 0; i < nodes.length; i += 1) {
+    const node = nodes[i]!
     if (node.type === 'text') {
-      out += (node as AdfTextNode).text
+      const textNode = node as AdfTextNode
+      if (!renderMarks) {
+        out += textNode.text
+        continue
+      }
+      const nextNode = nodes[i + 1]
+      const labelColon = readPlainTextLeadingColon(nextNode)
+      if (labelColon && hasMark(textNode, 'strong')) {
+        out += renderTextNode({ ...textNode, text: `${textNode.text}:` })
+        out += labelColon.remainder
+        i += 1
+        continue
+      }
+      out += renderTextNode(textNode)
+      continue
     }
-    // Unknown inline nodes (mentions, emoji, hardBreak, etc.) are skipped.
+    if (node.type === 'inlineCard') {
+      const url = readCardUrl(node)
+      if (url) out += url
+      continue
+    }
+    if (node.type === 'hardBreak') {
+      out += '\n'
+      continue
+    }
+    // Other unknown inline nodes (mentions, emoji, etc.) are skipped.
+  }
+  return out
+}
+
+function hasMark(node: AdfTextNode, type: string): boolean {
+  return node.marks?.some((m) => m.type === type) ?? false
+}
+
+function readPlainTextLeadingColon(node: AdfInlineNode | undefined): { remainder: string } | null {
+  if (!node || node.type !== 'text') return null
+  const textNode = node as AdfTextNode
+  if (textNode.marks && textNode.marks.length > 0) return null
+  if (!textNode.text.startsWith(':')) return null
+  return { remainder: textNode.text.slice(1) }
+}
+
+function renderTextNode(node: AdfTextNode): string {
+  if (!node.marks || node.marks.length === 0) return node.text
+  const link = node.marks.find((m) => m.type === 'link')
+  let out = node.text
+  if (link) {
+    const href = link.attrs?.['href']
+    if (typeof href === 'string' && href.length > 0) out = `[${out}](${href})`
+  }
+  if (hasMark(node, 'strong')) {
+    out = `**${out}**`
   }
   return out
 }
 
+function readCardUrl(node: AdfInlineNode | AdfBlockNode): string | null {
+  const attrs = (node as { attrs?: Record<string, unknown> }).attrs
+  if (!attrs) return null
+  const url = attrs['url']
+  return typeof url === 'string' && url.length > 0 ? url : null
+}
+
 function listItemInnerText(item: AdfListItemNode): string {
   // Each list item wraps a paragraph (or nested blocks). We flatten to the
   // first paragraph's inline text, which is all the write path produces.
@@ -252,12 +351,17 @@ function renderBlock(node: AdfBlockNode): string | null {
     case 'codeBlock': {
       const code = node as AdfCodeBlockNode
       const language = code.attrs?.language ?? ''
-      const body = inlineText(code.content)
+      const body = inlineText(code.content, { renderMarks: false })
       const fence = language.length > 0 ? `\`\`\`${language}` : '```'
       return `${fence}\n${body}\n\`\`\``
     }
     case 'heading':
       return inlineText((node as AdfHeadingNode).content)
+    case 'blockCard':
+    case 'embedCard': {
+      const url = readCardUrl(node)
+      return url ?? null
+    }
     default:
       // Unknown block node — skip entirely, never throw.
       return null

package/src/providers/jira-cache.ts

@@ -1,5 +1,5 @@
 import type { Database } from 'bun:sqlite'
-import type { BoardView, ProviderTeamInfo, Task } from '../types.ts'
+import type { BoardView, ProviderTeamInfo, Task } from '../types'
 
 // Column ids are prefixed to avoid collisions across sources:
 // - board-sourced columns: 'board:<boardId>:<columnName>'

package/src/providers/jira-client.ts

@@ -1,6 +1,6 @@
 import { Buffer } from 'node:buffer'
-import { ErrorCode } from '../errors.ts'
-import { providerUpstreamError } from './errors.ts'
+import { ErrorCode } from '../errors'
+import { providerUpstreamError } from './errors'
 
 export interface JiraProject {
   id: string

package/src/providers/jira.ts

@@ -1,5 +1,5 @@
 import type { Database } from 'bun:sqlite'
-import { ErrorCode, KanbanError } from '../errors.ts'
+import { ErrorCode, KanbanError } from '../errors'
 import type {
   ActivityEntry,
   BoardBootstrap,
@@ -10,17 +10,12 @@ import type {
   Priority,
   TaskComment,
   Task,
-} from '../types.ts'
-import {
-  headerLower,
-  verifyHmacSha256,
-  type WebhookRequest,
-  type WebhookResult,
-} from '../webhooks.ts'
-import { adfToPlainText, plainTextToAdf, type AdfDocument } from './jira-adf.ts'
-import { JIRA_CAPABILITIES } from './capabilities.ts'
-import { providerUpstreamError, unsupportedOperation } from './errors.ts'
-import { JiraClient, type JiraComment, type JiraIssue } from './jira-client.ts'
+} from '../types'
+import { headerLower, verifyHmacSha256, type WebhookRequest, type WebhookResult } from '../webhooks'
+import { adfToPlainText, plainTextToAdf, type AdfDocument } from './jira-adf'
+import { JIRA_CAPABILITIES } from './capabilities'
+import { providerUpstreamError, unsupportedOperation } from './errors'
+import { JiraClient, type JiraComment, type JiraIssue } from './jira-client'
 import {
   adjustJiraIssueCommentCount,
   decodeColumnStatusIds,
@@ -45,7 +40,7 @@ import {
   upsertJiraUsers,
   type JiraActivityRow,
   type JiraSyncMeta,
-} from './jira-cache.ts'
+} from './jira-cache'
 import type {
   CreateTaskInput,
   KanbanProvider,
@@ -53,7 +48,7 @@ import type {
   ProviderSyncStatus,
   TaskListFilters,
   UpdateTaskInput,
-} from './types.ts'
+} from './types'
 
 const SYNC_INTERVAL_MS = 30_000
 const FULL_RECONCILE_INTERVAL_MS = 5 * 60_000

package/src/providers/linear-cache.ts

@@ -1,5 +1,5 @@
 import type { Database } from 'bun:sqlite'
-import type { BoardConfig, BoardView, ProviderTeamInfo, Task } from '../types.ts'
+import type { BoardConfig, BoardView, ProviderTeamInfo, Task } from '../types'
 
 export interface LinearStateRow {
   id: string

package/src/providers/linear-client.ts

@@ -1,5 +1,5 @@
-import { ErrorCode } from '../errors.ts'
-import { providerUpstreamError } from './errors.ts'
+import { ErrorCode } from '../errors'
+import { providerUpstreamError } from './errors'
 
 interface GraphQLResponse<T> {
   data?: T
@@ -57,7 +57,6 @@ interface LinearIssueNode {
   state: { id: string; name: string; position: number }
   labels?: { nodes: Array<{ id: string; name: string }> }
   comments?: {
-    totalCount?: number
     nodes: Array<{ id: string }>
     pageInfo?: { hasNextPage: boolean; endCursor: string | null }
   } | null
@@ -81,7 +80,7 @@ function toLinearIssue(node: LinearIssueNode): LinearIssue {
         }
       : null,
     labels: node.labels?.nodes.map((label) => label.name) ?? [],
-    commentCount: node.comments?.totalCount ?? node.comments?.nodes?.length ?? undefined,
+    commentCount: node.comments?.nodes?.length ?? undefined,
   }
 }
 
@@ -284,7 +283,6 @@ export class LinearClient {
                   nodes { id name }
                 }
                 comments(first: 250) {
-                  totalCount
                   nodes { id }
                   pageInfo { hasNextPage endCursor }
                 }
@@ -335,7 +333,6 @@ export class LinearClient {
               state { id name position }
               labels { nodes { id name } }
               comments(first: 250) {
-                totalCount
                 nodes { id }
                 pageInfo { hasNextPage endCursor }
               }

package/src/providers/linear.ts

@@ -1,5 +1,5 @@
 import type { Database } from 'bun:sqlite'
-import { ErrorCode, KanbanError } from '../errors.ts'
+import { ErrorCode, KanbanError } from '../errors'
 import type {
   ActivityEntry,
   BoardBootstrap,
@@ -8,14 +8,9 @@ import type {
   Column,
   TaskComment,
   Task,
-} from '../types.ts'
-import {
-  headerLower,
-  verifyHmacSha256,
-  type WebhookRequest,
-  type WebhookResult,
-} from '../webhooks.ts'
-import { LINEAR_CAPABILITIES } from './capabilities.ts'
+} from '../types'
+import { headerLower, verifyHmacSha256, type WebhookRequest, type WebhookResult } from '../webhooks'
+import { LINEAR_CAPABILITIES } from './capabilities'
 import {
   adjustLinearIssueCommentCount,
   deleteLinearIssue,
@@ -35,9 +30,9 @@ import {
   upsertProjects,
   upsertUsers,
   type LinearActivityRow,
-} from './linear-cache.ts'
-import { LinearClient, type LinearComment } from './linear-client.ts'
-import { unsupportedOperation } from './errors.ts'
+} from './linear-cache'
+import { LinearClient, type LinearComment } from './linear-client'
+import { unsupportedOperation } from './errors'
 import type {
   CreateTaskInput,
   KanbanProvider,
@@ -45,7 +40,7 @@ import type {
   ProviderSyncStatus,
   TaskListFilters,
   UpdateTaskInput,
-} from './types.ts'
+} from './types'
 
 const SYNC_INTERVAL_MS = 30_000
 const FULL_RECONCILIATION_INTERVAL_MS = 5 * 60_000

package/src/providers/local.ts

@@ -1,6 +1,6 @@
 import type { Database } from 'bun:sqlite'
-import { listActivity } from '../activity.ts'
-import { getConfigPath, loadConfig, saveConfig } from '../config.ts'
+import { listActivity } from '../activity'
+import { getConfigPath, loadConfig, saveConfig } from '../config'
 import {
   addComment,
   countComments,
@@ -17,11 +17,11 @@ import {
   moveTask,
   updateComment as updateTaskComment,
   updateTask,
-} from '../db.ts'
-import { getBoardMetrics, getDiscoveredAssignees, getDiscoveredProjects } from '../metrics.ts'
-import type { BoardBootstrap, BoardConfig, Task, TaskComment } from '../types.ts'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { LOCAL_CAPABILITIES } from './capabilities.ts'
+} from '../db'
+import { getBoardMetrics, getDiscoveredAssignees, getDiscoveredProjects } from '../metrics'
+import type { BoardBootstrap, BoardConfig, Task, TaskComment } from '../types'
+import { ErrorCode, KanbanError } from '../errors'
+import { LOCAL_CAPABILITIES } from './capabilities'
 import type {
   CreateTaskInput,
   KanbanProvider,
@@ -29,7 +29,7 @@ import type {
   ProviderSyncStatus,
   TaskListFilters,
   UpdateTaskInput,
-} from './types.ts'
+} from './types'
 
 function buildLocalConfig(
   db: Database,

package/src/providers/types.ts

@@ -1,4 +1,4 @@
-import type { WebhookRequest, WebhookResult } from '../webhooks.ts'
+import type { WebhookRequest, WebhookResult } from '../webhooks'
 import type {
   ActivityEntry,
   BoardBootstrap,
@@ -11,7 +11,7 @@ import type {
   ProviderTeamInfo,
   TaskComment,
   Task,
-} from '../types.ts'
+} from '../types'
 
 export interface TaskListFilters {
   column?: string

package/src/server.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
-import { handleRequest } from './api.ts'
+import { handleRequest } from './api'
 import type { ServerWebSocket } from 'bun'
-import type { KanbanProvider } from './providers/types.ts'
+import type { KanbanProvider } from './providers/types'
 
 const wsClients = new Set<ServerWebSocket<unknown>>()
 const CORS_HEADERS = {

package/src/types.ts

@@ -115,6 +115,7 @@ export interface ProviderCapabilities {
   taskMove: boolean
   taskDelete: boolean
   comment: boolean
+  /** True when provider-backed bootstrap/dashboard activity is exposed, not merely cached internally. */
   activity: boolean
   metrics: boolean
   columnCrud: boolean