@andypai/agent-kanban 0.3.0 → 0.3.1

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.1",
   "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,5 @@
 import { describe, expect, test } from 'bun:test'
-import { adfToPlainText, plainTextToAdf, type AdfDocument } from '../providers/jira-adf.ts'
+import { adfToPlainText, plainTextToAdf, type AdfDocument } from '../providers/jira-adf'
 
 describe('plainTextToAdf / adfToPlainText', () => {
   test('empty doc round-trip', () => {
@@ -91,6 +91,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)

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 }
@@ -353,7 +353,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',

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

@@ -3,9 +3,9 @@ import { Database } from 'bun:sqlite'
 import { mkdtempSync, rmSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { run } from '../index.ts'
-import { createProvider } from '../providers/index.ts'
+import { ErrorCode, KanbanError } from '../errors'
+import { run } from '../index'
+import { createProvider } from '../providers/index'
 
 const ENV_KEYS = [
   'KANBAN_PROVIDER',

package/src/__tests__/linear-cache-description-activity.test.ts

@@ -6,7 +6,7 @@ import {
   getCachedLinearActivity,
   initLinearCacheSchema,
   upsertIssues,
-} from '../providers/linear-cache.ts'
+} from '../providers/linear-cache'
 
 function mkIssue(overrides: Partial<Parameters<typeof upsertIssues>[1][0]> = {}) {
   return {

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

@@ -1,12 +1,12 @@
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { LinearProvider } from '../providers/linear.ts'
+import { LinearProvider } from '../providers/linear'
 import {
   initLinearCacheSchema,
   replaceStates,
   saveSyncMeta,
   upsertIssues,
-} from '../providers/linear-cache.ts'
+} from '../providers/linear-cache'
 
 let db: Database
 let originalFetch: typeof fetch

package/src/__tests__/linear-provider-sync.test.ts

@@ -1,6 +1,6 @@
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { LinearProvider } from '../providers/linear.ts'
+import { LinearProvider } from '../providers/linear'
 import {
   getCachedTasks,
   initLinearCacheSchema,
@@ -8,7 +8,7 @@ import {
   replaceStates,
   saveSyncMeta,
   upsertIssues,
-} from '../providers/linear-cache.ts'
+} from '../providers/linear-cache'
 
 let db: Database
 let originalFetch: typeof fetch
@@ -38,7 +38,6 @@ function linearIssue(
     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 }
     }
@@ -57,7 +56,7 @@ function linearIssue(
     project: null,
     state: { id: 'state-1', name: 'Todo', position: 0 },
     labels: { nodes: [] },
-    comments: { totalCount: 0, nodes: [], pageInfo: { hasNextPage: false, endCursor: null } },
+    comments: { nodes: [], pageInfo: { hasNextPage: false, endCursor: null } },
     ...overrides,
   }
 }
@@ -162,7 +161,6 @@ describe('LinearProvider sync', () => {
                   state: { id: 'state-1', name: 'Todo', position: 0 },
                   labels: { nodes: [] },
                   comments: {
-                    totalCount: 0,
                     nodes: [],
                     pageInfo: { hasNextPage: false, endCursor: null },
                   },
@@ -258,9 +256,7 @@ describe('LinearProvider sync', () => {
           JSON.stringify({
             data: {
               issues: {
-                nodes: [
-                  linearIssue({ comments: { totalCount: 2, nodes: [{ id: 'c1' }, { id: 'c2' }] } }),
-                ],
+                nodes: [linearIssue({ comments: { nodes: [{ id: 'c1' }, { id: 'c2' }] } })],
                 pageInfo: { hasNextPage: false, endCursor: null },
               },
             },
@@ -368,7 +364,6 @@ describe('LinearProvider sync', () => {
                 nodes: [
                   linearIssue({
                     comments: {
-                      totalCount: 7,
                       nodes: Array.from({ length: 7 }, (_, index) => ({ id: `c${index}` })),
                     },
                   }),

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

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

package/src/__tests__/mcp-core.test.ts

@@ -1,9 +1,9 @@
 import { beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { addTask, initSchema, seedDefaultColumns } from '../db.ts'
-import { createTrackerCore } from '../mcp/core.ts'
-import { TrackerMcpError } from '../mcp/errors.ts'
-import { LocalProvider } from '../providers/local.ts'
+import { addTask, initSchema, seedDefaultColumns } from '../db'
+import { createTrackerCore } from '../mcp/core'
+import { TrackerMcpError } from '../mcp/errors'
+import { LocalProvider } from '../providers/local'
 
 interface TestScope {
   actor: string

package/src/__tests__/mcp-server.test.ts

@@ -2,9 +2,9 @@ import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
 import { Client } from '@modelcontextprotocol/sdk/client'
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'
-import { addTask, initSchema, seedDefaultColumns } from '../db.ts'
-import { createTrackerCore, createTrackerMcpServer, TrackerMcpError } from '../mcp/index.ts'
-import { LocalProvider } from '../providers/local.ts'
+import { addTask, initSchema, seedDefaultColumns } from '../db'
+import { createTrackerCore, createTrackerMcpServer, TrackerMcpError } from '../mcp/index'
+import { LocalProvider } from '../providers/local'
 
 interface TestScope {
   actor: string

package/src/__tests__/metrics.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, test, beforeEach } from 'bun:test'
 import { Database } from 'bun:sqlite'
-import { initSchema, seedDefaultColumns, addTask } from '../db.ts'
-import { getBoardMetrics } from '../metrics.ts'
+import { initSchema, seedDefaultColumns, addTask } from '../db'
+import { getBoardMetrics } from '../metrics'
 
 let db: Database
 

package/src/__tests__/output.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test'
-import { success, error, formatOutput } from '../output.ts'
+import { success, error, formatOutput } from '../output'
 
 describe('success', () => {
   test('wraps data in ok envelope', () => {

package/src/__tests__/provider-capabilities.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, test } from 'bun:test'
+
+import {
+  JIRA_CAPABILITIES,
+  LINEAR_CAPABILITIES,
+  LOCAL_CAPABILITIES,
+} from '../providers/capabilities'
+
+describe('provider capabilities', () => {
+  test('remote providers share the same read/write baseline', () => {
+    expect(LINEAR_CAPABILITIES).toEqual(JIRA_CAPABILITIES)
+    expect(LINEAR_CAPABILITIES).toEqual({
+      taskCreate: true,
+      taskUpdate: true,
+      taskMove: true,
+      taskDelete: false,
+      comment: true,
+      activity: false,
+      metrics: false,
+      columnCrud: false,
+      bulk: false,
+      configEdit: false,
+    })
+  })
+
+  test('local provider exposes the full local board surface', () => {
+    expect(LOCAL_CAPABILITIES).toEqual({
+      taskCreate: true,
+      taskUpdate: true,
+      taskMove: true,
+      taskDelete: true,
+      comment: true,
+      activity: true,
+      metrics: true,
+      columnCrud: true,
+      bulk: true,
+      configEdit: true,
+    })
+  })
+})

package/src/__tests__/server.test.ts

@@ -1,13 +1,6 @@
 import { afterEach, describe, expect, test } from 'bun:test'
-import type {
-  BoardBootstrap,
-  BoardConfig,
-  BoardMetrics,
-  BoardView,
-  Column,
-  Task,
-} from '../types.ts'
-import { startServer, type StartedServer } from '../server.ts'
+import type { BoardBootstrap, BoardConfig, BoardMetrics, BoardView, Column, Task } from '../types'
+import { startServer, type StartedServer } from '../server'
 import type {
   CreateTaskInput,
   KanbanProvider,
@@ -15,7 +8,7 @@ import type {
   ProviderSyncStatus,
   TaskListFilters,
   UpdateTaskInput,
-} from '../providers/types.ts'
+} from '../providers/types'
 
 const emptyBoard: BoardView = { columns: [] }
 const emptyConfig: BoardConfig = { members: [], projects: [], provider: 'local' }

package/src/__tests__/webhooks.test.ts

@@ -1,10 +1,10 @@
 import { beforeEach, afterEach, describe, expect, test } from 'bun:test'
 import { Database } from 'bun:sqlite'
 import { createHmac } from 'node:crypto'
-import { verifyHmacSha256 } from '../webhooks.ts'
-import { JiraProvider, type JiraProviderConfig } from '../providers/jira.ts'
-import { JiraClient } from '../providers/jira-client.ts'
-import { LinearProvider } from '../providers/linear.ts'
+import { verifyHmacSha256 } from '../webhooks'
+import { JiraProvider, type JiraProviderConfig } from '../providers/jira'
+import { JiraClient } from '../providers/jira-client'
+import { LinearProvider } from '../providers/linear'
 import {
   getCachedActivity,
   getCachedTasks as getCachedJiraTasks,
@@ -13,7 +13,7 @@ import {
   saveTeamInfo,
   replaceJiraColumns,
   upsertJiraIssues,
-} from '../providers/jira-cache.ts'
+} from '../providers/jira-cache'
 import {
   getCachedTasks as getCachedLinearTasks,
   initLinearCacheSchema,
@@ -21,7 +21,7 @@ import {
   replaceStates,
   saveSyncMeta,
   upsertIssues,
-} from '../providers/linear-cache.ts'
+} from '../providers/linear-cache'
 
 function hmac(secret: string, body: string): string {
   return createHmac('sha256', secret).update(body).digest('hex')

package/src/activity.ts

@@ -1,6 +1,6 @@
 import { Database } from 'bun:sqlite'
-import { generateId } from './id.ts'
-import type { ActivityEntry, ActivityAction } from './types.ts'
+import { generateId } from './id'
+import type { ActivityEntry, ActivityAction } from './types'
 
 export function logActivity(
   db: Database,

package/src/api.ts

@@ -1,6 +1,6 @@
-import { KanbanError, ErrorCode } from './errors.ts'
-import type { BoardConfig, CliOutput, Task } from './types.ts'
-import type { CreateTaskInput, UpdateTaskInput, KanbanProvider } from './providers/types.ts'
+import { KanbanError, ErrorCode } from './errors'
+import type { BoardConfig, CliOutput, Task } from './types'
+import type { CreateTaskInput, UpdateTaskInput, KanbanProvider } from './providers/types'
 
 export type WsEvent =
   | { type: 'task:upsert'; task: Task; columnName: string }

package/src/commands/board.ts

@@ -1,8 +1,8 @@
 import type { Database } from 'bun:sqlite'
-import { initSchema, seedDefaultColumns, isInitialized, resetBoard } from '../db.ts'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { success } from '../output.ts'
-import type { CliOutput } from '../types.ts'
+import { initSchema, seedDefaultColumns, isInitialized, resetBoard } from '../db'
+import { ErrorCode, KanbanError } from '../errors'
+import { success } from '../output'
+import type { CliOutput } from '../types'
 
 export function boardInit(db: Database): CliOutput {
   if (isInitialized(db)) {

package/src/commands/bulk.ts

@@ -1,8 +1,8 @@
 import type { Database } from 'bun:sqlite'
-import { bulkMoveAll, bulkClearDone } from '../db.ts'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { success } from '../output.ts'
-import type { CliOutput } from '../types.ts'
+import { bulkMoveAll, bulkClearDone } from '../db'
+import { ErrorCode, KanbanError } from '../errors'
+import { success } from '../output'
+import type { CliOutput } from '../types'
 
 export function bulkMoveAllCmd(db: Database, args: { from?: string; to?: string }): CliOutput {
   if (!args.from || !args.to) {

package/src/commands/column.ts

@@ -1,8 +1,8 @@
 import type { Database } from 'bun:sqlite'
-import { addColumn, listColumns, renameColumn, reorderColumn, deleteColumn } from '../db.ts'
-import { ErrorCode, KanbanError } from '../errors.ts'
-import { success } from '../output.ts'
-import type { CliOutput } from '../types.ts'
+import { addColumn, listColumns, renameColumn, reorderColumn, deleteColumn } from '../db'
+import { ErrorCode, KanbanError } from '../errors'
+import { success } from '../output'
+import type { CliOutput } from '../types'
 
 export function columnAdd(
   db: Database,

package/src/commands/mcp.ts

@@ -6,9 +6,9 @@ import {
   type CallToolResult,
 } from '@modelcontextprotocol/sdk/types.js'
 import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv'
-import { createTrackerCore, defaultTools, TrackerMcpError } from '../mcp/index.ts'
-import type { TrackerMcpPolicy, TrackerMcpTool } from '../mcp/index.ts'
-import type { KanbanProvider } from '../providers/types.ts'
+import { createTrackerCore, defaultTools, TrackerMcpError } from '../mcp/index'
+import type { TrackerMcpPolicy, TrackerMcpTool } from '../mcp/index'
+import type { KanbanProvider } from '../providers/types'
 
 type LocalScope = Record<string, never>
 

package/src/config.ts

@@ -1,6 +1,6 @@
 import { readFileSync, writeFileSync, renameSync } from 'node:fs'
 import { dirname, join } from 'node:path'
-import type { BoardConfig } from './types.ts'
+import type { BoardConfig } from './types'
 
 const DEFAULT_CONFIG: BoardConfig = { members: [], projects: [] }
 

package/src/db.ts

@@ -2,10 +2,10 @@ import { Database } from 'bun:sqlite'
 import { existsSync, mkdirSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
-import { generateId } from './id.ts'
-import { ErrorCode, KanbanError } from './errors.ts'
-import type { BoardView, Column, Priority, Task, TaskComment, TaskWithColumn } from './types.ts'
-import { logActivity, enterColumn, exitColumn } from './activity.ts'
+import { generateId } from './id'
+import { ErrorCode, KanbanError } from './errors'
+import type { BoardView, Column, Priority, Task, TaskComment, TaskWithColumn } from './types'
+import { logActivity, enterColumn, exitColumn } from './activity'
 
 const DEFAULT_COLUMNS = [
   { name: 'recurring', position: 0 },

package/src/index.ts

@@ -2,22 +2,16 @@
 
 import { parseArgs } from 'node:util'
 import { Database } from 'bun:sqlite'
-import { KanbanError, ErrorCode } from './errors.ts'
-import { formatOutput, error, success } from './output.ts'
-import { openDb, getDbPath, initSchema, migrateSchema, seedDefaultColumns } from './db.ts'
-import { boardInit, boardReset } from './commands/board.ts'
-import {
-  columnAdd,
-  columnDelete,
-  columnList,
-  columnRename,
-  columnReorder,
-} from './commands/column.ts'
-import { bulkClearDoneCmd, bulkMoveAllCmd } from './commands/bulk.ts'
-import { getConfigPath, loadConfig, saveConfig } from './config.ts'
-import type { CliOutput, Priority } from './types.ts'
-import { createProvider } from './providers/index.ts'
-import { unsupportedOperation } from './providers/errors.ts'
+import { KanbanError, ErrorCode } from './errors'
+import { formatOutput, error, success } from './output'
+import { openDb, getDbPath, initSchema, migrateSchema, seedDefaultColumns } from './db'
+import { boardInit, boardReset } from './commands/board'
+import { columnAdd, columnDelete, columnList, columnRename, columnReorder } from './commands/column'
+import { bulkClearDoneCmd, bulkMoveAllCmd } from './commands/bulk'
+import { getConfigPath, loadConfig, saveConfig } from './config'
+import type { CliOutput, Priority } from './types'
+import { createProvider } from './providers/index'
+import { unsupportedOperation } from './providers/errors'
 
 interface ParsedArgs {
   values: Record<string, unknown>
@@ -415,7 +409,7 @@ if (import.meta.main) {
     const db = openDb(dbPath)
     migrateSchema(db)
     const provider = createProvider(db, dbPath)
-    const { startStdioMcpServer } = await import('./commands/mcp.ts')
+    const { startStdioMcpServer } = await import('./commands/mcp')
     await startStdioMcpServer(provider)
   } else if (argv[0] === 'serve') {
     const opts = parseServeArgs(argv)
@@ -424,11 +418,11 @@ if (import.meta.main) {
     const db = openDb(dbPath)
     migrateSchema(db)
     const provider = createProvider(db, dbPath)
-    const { startServer } = await import('./server.ts')
+    const { startServer } = await import('./server')
     startServer(provider, opts.port)
 
     if (opts.tunnel) {
-      const { startCloudflareTunnel } = await import('./tunnel.ts')
+      const { startCloudflareTunnel } = await import('./tunnel')
       try {
         const handle = startCloudflareTunnel(opts.port)
         const shutdown = (): void => {

package/src/mcp/core.ts

@@ -1,7 +1,7 @@
-import type { KanbanProvider } from '../providers/types.ts'
-import type { Task, TaskComment } from '../types.ts'
-import { TrackerMcpError, toTrackerMcpError } from './errors.ts'
-import type { TrackerMcpHooks, TrackerMcpPolicy } from './types.ts'
+import type { KanbanProvider } from '../providers/types'
+import type { Task, TaskComment } from '../types'
+import { TrackerMcpError, toTrackerMcpError } from './errors'
+import type { TrackerMcpHooks, TrackerMcpPolicy } from './types'
 
 export interface TrackerCore<TScope> {
   notifyAuthFailure(input: {

package/src/mcp/errors.ts

@@ -1,5 +1,5 @@
 import { McpError, ErrorCode as JsonRpcErrorCode } from '@modelcontextprotocol/sdk/types.js'
-import { ErrorCode, type ErrorCodeValue, KanbanError } from '../errors.ts'
+import { ErrorCode, type ErrorCodeValue, KanbanError } from '../errors'
 
 export type TrackerMcpErrorCode =
   | 'auth_failed'

package/src/mcp/index.ts

@@ -1,7 +1,7 @@
-export { createTrackerCore } from './core.ts'
-export { createTrackerMcpServer } from './server.ts'
-export { TrackerMcpError, type TrackerMcpErrorCode } from './errors.ts'
-export type { TrackerCore } from './core.ts'
+export { createTrackerCore } from './core'
+export { createTrackerMcpServer } from './server'
+export { TrackerMcpError, type TrackerMcpErrorCode } from './errors'
+export type { TrackerCore } from './core'
 export type {
   TrackerMcpAuthResolver,
   TrackerMcpHooks,
@@ -9,5 +9,5 @@ export type {
   TrackerMcpServer,
   TrackerMcpTool,
   TrackerMcpToolHandlerContext,
-} from './types.ts'
-export { defaultTools } from './server.ts'
+} from './types'
+export { defaultTools } from './server'

package/src/mcp/server.ts

@@ -13,9 +13,9 @@ import type {
   JsonSchemaValidatorResult,
   JsonSchemaType,
 } from '@modelcontextprotocol/sdk/validation'
-import type { TrackerCore } from './core.ts'
-import { TrackerMcpError, toMcpError, toTrackerMcpError, trackerMcpJsonRpcCode } from './errors.ts'
-import type { TrackerMcpAuthResolver, TrackerMcpServer, TrackerMcpTool } from './types.ts'
+import type { TrackerCore } from './core'
+import { TrackerMcpError, toMcpError, toTrackerMcpError, trackerMcpJsonRpcCode } from './errors'
+import type { TrackerMcpAuthResolver, TrackerMcpServer, TrackerMcpTool } from './types'
 
 const EMPTY_OBJECT_SCHEMA = {
   type: 'object',

package/src/mcp/types.ts

@@ -1,7 +1,7 @@
 import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'
 import type { JsonSchemaType } from '@modelcontextprotocol/sdk/validation'
-import type { TaskComment } from '../types.ts'
-import type { TrackerMcpError, TrackerMcpErrorCode } from './errors.ts'
+import type { TaskComment } from '../types'
+import type { TrackerMcpError, TrackerMcpErrorCode } from './errors'
 
 export type TrackerMcpAuthResolver<TScope> = (ctx: {
   request: Request

package/src/metrics.ts

@@ -1,5 +1,5 @@
 import { Database } from 'bun:sqlite'
-import type { ActivityEntry, BoardMetrics } from './types.ts'
+import type { ActivityEntry, BoardMetrics } from './types'
 
 function getDistinctTaskFieldValues(db: Database, field: 'assignee' | 'project'): string[] {
   return (

package/src/output.ts

@@ -1,4 +1,4 @@
-import type { CliOutput, BoardView, Task, TaskWithColumn, Column } from './types.ts'
+import type { CliOutput, BoardView, Task, TaskWithColumn, Column } from './types'
 
 export function success<T>(data: T): CliOutput<T> {
   return { ok: true, data }

package/src/providers/capabilities.ts

@@ -1,40 +1,30 @@
-import type { ProviderCapabilities } from '../types.ts'
+import type { ProviderCapabilities } from '../types'
 
-export const LOCAL_CAPABILITIES: ProviderCapabilities = {
-  taskCreate: true,
-  taskUpdate: true,
-  taskMove: true,
+function capabilities(overrides: Partial<ProviderCapabilities> = {}): ProviderCapabilities {
+  return {
+    taskCreate: true,
+    taskUpdate: true,
+    taskMove: true,
+    taskDelete: false,
+    comment: true,
+    activity: false,
+    metrics: false,
+    columnCrud: false,
+    bulk: false,
+    configEdit: false,
+    ...overrides,
+  }
+}
+
+export const LOCAL_CAPABILITIES: ProviderCapabilities = capabilities({
   taskDelete: true,
-  comment: true,
   activity: true,
   metrics: true,
   columnCrud: true,
   bulk: true,
   configEdit: true,
-}
+})
 
-export const LINEAR_CAPABILITIES: ProviderCapabilities = {
-  taskCreate: true,
-  taskUpdate: true,
-  taskMove: true,
-  taskDelete: false,
-  comment: true,
-  activity: false,
-  metrics: false,
-  columnCrud: false,
-  bulk: false,
-  configEdit: false,
-}
+export const LINEAR_CAPABILITIES: ProviderCapabilities = capabilities()
 
-export const JIRA_CAPABILITIES: ProviderCapabilities = {
-  taskCreate: true,
-  taskUpdate: true,
-  taskMove: true,
-  taskDelete: false,
-  comment: true,
-  activity: false,
-  metrics: false,
-  columnCrud: false,
-  bulk: false,
-  configEdit: false,
-}
+export const JIRA_CAPABILITIES: ProviderCapabilities = capabilities()

package/src/providers/errors.ts

@@ -1,4 +1,4 @@
-import { ErrorCode, type ErrorCodeValue, KanbanError } from '../errors.ts'
+import { ErrorCode, type ErrorCodeValue, KanbanError } from '../errors'
 
 export function unsupportedOperation(message: string): never {
   throw new KanbanError(ErrorCode.UNSUPPORTED_OPERATION, message)

package/src/providers/index.ts

@@ -1,10 +1,10 @@
 import type { Database } from 'bun:sqlite'
-import { getDbPath, initSchema, seedDefaultColumns } from '../db.ts'
-import { providerNotConfigured } from './errors.ts'
-import { JiraProvider } from './jira.ts'
-import { LinearProvider } from './linear.ts'
-import { LocalProvider } from './local.ts'
-import type { KanbanProvider } from './types.ts'
+import { getDbPath, initSchema, seedDefaultColumns } from '../db'
+import { providerNotConfigured } from './errors'
+import { JiraProvider } from './jira'
+import { LinearProvider } from './linear'
+import { LocalProvider } from './local'
+import type { KanbanProvider } from './types'
 
 export function createProvider(db: Database, dbPath = getDbPath()): KanbanProvider {
   const providerType = (process.env['KANBAN_PROVIDER'] ?? 'local') as 'local' | 'linear' | 'jira'

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