@andypai/agent-kanban 0.1.0

package/src/providers/local.ts

@@ -0,0 +1,135 @@
+import type { Database } from 'bun:sqlite'
+import { listActivity } from '../activity.ts'
+import { getConfigPath, loadConfig, saveConfig } from '../config.ts'
+import {
+  addTask,
+  deleteTask,
+  getBoardView,
+  getDbPath,
+  getTask,
+  listColumns,
+  listTasks,
+  moveTask,
+  updateTask,
+} from '../db.ts'
+import { getBoardMetrics, getDiscoveredAssignees, getDiscoveredProjects } from '../metrics.ts'
+import type { BoardBootstrap, BoardConfig, Task } from '../types.ts'
+import { LOCAL_CAPABILITIES } from './capabilities.ts'
+import type {
+  CreateTaskInput,
+  KanbanProvider,
+  ProviderContext,
+  TaskListFilters,
+  UpdateTaskInput,
+} from './types.ts'
+
+function buildLocalConfig(
+  db: Database,
+  dbPath: string,
+  discoveredAssignees = getDiscoveredAssignees(db),
+  discoveredProjects = getDiscoveredProjects(db),
+): BoardConfig {
+  return {
+    ...loadConfig(dbPath),
+    provider: 'local',
+    discoveredAssignees,
+    discoveredProjects,
+  }
+}
+
+function enrichTask(task: Task): Task {
+  return {
+    ...task,
+    providerId: task.id,
+    externalRef: task.id,
+    url: null,
+  }
+}
+
+export class LocalProvider implements KanbanProvider {
+  readonly type = 'local' as const
+
+  constructor(
+    private readonly db: Database,
+    private readonly dbPath = getDbPath(),
+  ) {}
+
+  async getContext(): Promise<ProviderContext> {
+    return {
+      provider: this.type,
+      capabilities: LOCAL_CAPABILITIES,
+      team: null,
+    }
+  }
+
+  async getBootstrap(): Promise<BoardBootstrap> {
+    const metrics = getBoardMetrics(this.db)
+    return {
+      provider: this.type,
+      capabilities: LOCAL_CAPABILITIES,
+      board: await this.getBoard(),
+      config: buildLocalConfig(this.db, this.dbPath, metrics.assignees, metrics.projects),
+      metrics,
+      activity: listActivity(this.db, { limit: 50 }),
+      team: null,
+    }
+  }
+
+  async getBoard() {
+    const board = getBoardView(this.db)
+    return {
+      columns: board.columns.map((column) => ({
+        ...column,
+        tasks: column.tasks.map(enrichTask),
+      })),
+    }
+  }
+
+  async listColumns() {
+    return listColumns(this.db)
+  }
+
+  async listTasks(filters: TaskListFilters = {}) {
+    return listTasks(this.db, filters).map(enrichTask)
+  }
+
+  async getTask(idOrRef: string) {
+    return enrichTask(getTask(this.db, idOrRef))
+  }
+
+  async createTask(input: CreateTaskInput) {
+    return enrichTask(addTask(this.db, input.title, input))
+  }
+
+  async updateTask(idOrRef: string, input: UpdateTaskInput) {
+    return enrichTask(updateTask(this.db, idOrRef, input))
+  }
+
+  async moveTask(idOrRef: string, column: string) {
+    return enrichTask(moveTask(this.db, idOrRef, column))
+  }
+
+  async deleteTask(idOrRef: string) {
+    return enrichTask(deleteTask(this.db, idOrRef))
+  }
+
+  async getActivity(limit?: number, taskId?: string) {
+    return listActivity(this.db, { limit, taskId })
+  }
+
+  async getMetrics() {
+    return getBoardMetrics(this.db)
+  }
+
+  async getConfig(): Promise<BoardConfig> {
+    return buildLocalConfig(this.db, this.dbPath)
+  }
+
+  async patchConfig(input: Partial<BoardConfig>) {
+    const config = loadConfig(this.dbPath)
+    if (input.members) config.members = input.members
+    if (input.projects) config.projects = input.projects
+    saveConfig(getConfigPath(this.dbPath), config)
+    return this.getConfig()
+  }
+}

package/src/providers/types.ts

@@ -0,0 +1,65 @@
+import type {
+  ActivityEntry,
+  BoardBootstrap,
+  BoardConfig,
+  BoardMetrics,
+  BoardView,
+  Column,
+  Priority,
+  ProviderCapabilities,
+  ProviderTeamInfo,
+  Task,
+} from '../types.ts'
+
+export interface TaskListFilters {
+  column?: string
+  priority?: string
+  assignee?: string
+  project?: string
+  limit?: number
+  sort?: string
+}
+
+export interface CreateTaskInput {
+  title: string
+  description?: string
+  column?: string
+  priority?: Priority
+  assignee?: string
+  project?: string
+  metadata?: string
+}
+
+export interface UpdateTaskInput {
+  title?: string
+  description?: string
+  priority?: Priority
+  assignee?: string
+  project?: string
+  metadata?: string
+}
+
+export interface ProviderContext {
+  provider: 'local' | 'linear'
+  capabilities: ProviderCapabilities
+  team: ProviderTeamInfo | null
+}
+
+export interface KanbanProvider {
+  readonly type: 'local' | 'linear'
+
+  getContext(): Promise<ProviderContext>
+  getBootstrap(): Promise<BoardBootstrap>
+  getBoard(): Promise<BoardView>
+  listColumns(): Promise<Column[]>
+  listTasks(filters?: TaskListFilters): Promise<Task[]>
+  getTask(idOrRef: string): Promise<Task>
+  createTask(input: CreateTaskInput): Promise<Task>
+  updateTask(idOrRef: string, input: UpdateTaskInput): Promise<Task>
+  moveTask(idOrRef: string, column: string): Promise<Task>
+  deleteTask(idOrRef: string): Promise<Task>
+  getActivity(limit?: number, taskId?: string): Promise<ActivityEntry[]>
+  getMetrics(): Promise<BoardMetrics>
+  getConfig(): Promise<BoardConfig>
+  patchConfig(input: Partial<BoardConfig>): Promise<BoardConfig>
+}

package/src/server.ts

@@ -0,0 +1,91 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { handleRequest } from './api.ts'
+import type { ServerWebSocket } from 'bun'
+import type { KanbanProvider } from './providers/types.ts'
+
+const wsClients = new Set<ServerWebSocket<unknown>>()
+const CORS_HEADERS = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'GET, POST, PATCH, DELETE, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type',
+}
+
+function broadcast(data: unknown): void {
+  const msg = JSON.stringify(data)
+  for (const ws of wsClients) {
+    ws.send(msg)
+  }
+}
+
+function applyCorsHeaders(response: Response): void {
+  for (const [header, value] of Object.entries(CORS_HEADERS)) {
+    response.headers.set(header, value)
+  }
+}
+
+export function startServer(provider: KanbanProvider, port: number): void {
+  const distDir = join(import.meta.dir, '..', 'ui', 'dist')
+  const hasStatic = existsSync(distDir)
+
+  Bun.serve({
+    port,
+    websocket: {
+      open(ws) {
+        wsClients.add(ws)
+      },
+      close(ws) {
+        wsClients.delete(ws)
+      },
+      message() {
+        /* server-push only */
+      },
+    },
+    async fetch(req, server) {
+      const url = new URL(req.url)
+
+      // Handle OPTIONS preflight first (before /api routing)
+      if (req.method === 'OPTIONS') {
+        return new Response(null, { headers: CORS_HEADERS })
+      }
+
+      // WebSocket upgrade
+      if (url.pathname === '/ws') {
+        const upgraded = server.upgrade(req)
+        if (upgraded) return undefined as unknown as Response
+        return new Response('WebSocket upgrade failed', { status: 400 })
+      }
+
+      if (url.pathname === '/api/health') {
+        const context = await provider.getContext()
+        return Response.json({
+          ok: true,
+          data: { status: 'running', wsClients: wsClients.size, provider: context.provider },
+        })
+      }
+
+      if (url.pathname.startsWith('/api/')) {
+        const result = await handleRequest(provider, req)
+        applyCorsHeaders(result.response)
+        if (result.mutated && result.response.ok) {
+          broadcast({ type: 'refresh' })
+        }
+        return result.response
+      }
+
+      if (hasStatic) {
+        const filePath = join(distDir, url.pathname === '/' ? 'index.html' : url.pathname)
+        const file = Bun.file(filePath)
+        if (await file.exists()) return new Response(file)
+        return new Response(Bun.file(join(distDir, 'index.html')))
+      }
+
+      return new Response('Dashboard not built. Run: cd ui && bun run build', {
+        status: 503,
+        headers: { 'Content-Type': 'text/plain' },
+      })
+    },
+  })
+
+  console.info(`Dashboard running at http://localhost:${port}`)
+}

package/src/types.ts

@@ -0,0 +1,123 @@
+export type Priority = 'low' | 'medium' | 'high' | 'urgent'
+
+export interface Column {
+  id: string
+  name: string
+  position: number
+  color: string | null
+  created_at: string
+  updated_at: string
+}
+
+export interface Task {
+  id: string
+  providerId?: string
+  externalRef?: string | null
+  url?: string | null
+  title: string
+  description: string
+  column_id: string
+  position: number
+  priority: Priority
+  assignee: string
+  project: string
+  metadata: string
+  created_at: string
+  updated_at: string
+}
+
+export interface TaskWithColumn extends Task {
+  column_name: string
+}
+
+export interface BoardView {
+  columns: (Column & { tasks: Task[] })[]
+}
+
+export interface CliResult<T = unknown> {
+  ok: true
+  data: T
+}
+
+export interface CliError {
+  ok: false
+  error: { code: string; message: string }
+}
+
+export type CliOutput<T = unknown> = CliResult<T> | CliError
+
+export type ActivityAction =
+  | 'created'
+  | 'moved'
+  | 'updated'
+  | 'deleted'
+  | 'assigned'
+  | 'prioritized'
+
+export interface ActivityEntry {
+  id: string
+  task_id: string
+  action: ActivityAction
+  field_changed: string | null
+  old_value: string | null
+  new_value: string | null
+  timestamp: string
+}
+
+export interface ColumnTimeEntry {
+  id: string
+  task_id: string
+  column_id: string
+  entered_at: string
+  exited_at: string | null
+}
+
+export interface BoardConfig {
+  members: { name: string; role: 'human' | 'agent' }[]
+  projects: string[]
+  provider?: 'local' | 'linear'
+  discoveredAssignees?: string[]
+  discoveredProjects?: string[]
+}
+
+export interface BoardMetrics {
+  tasksByColumn: { column_name: string; count: number }[]
+  tasksByPriority: { priority: string; count: number }[]
+  totalTasks: number
+  completedTasks: number
+  avgCompletionHours: number | null
+  recentActivity: ActivityEntry[]
+  tasksCreatedThisWeek: number
+  inProgressCount: number
+  completionPercent: number
+  assignees: string[]
+  projects: string[]
+}
+
+export interface ProviderCapabilities {
+  taskCreate: boolean
+  taskUpdate: boolean
+  taskMove: boolean
+  taskDelete: boolean
+  activity: boolean
+  metrics: boolean
+  columnCrud: boolean
+  bulk: boolean
+  configEdit: boolean
+}
+
+export interface ProviderTeamInfo {
+  id: string
+  key: string
+  name: string
+}
+
+export interface BoardBootstrap {
+  provider: 'local' | 'linear'
+  capabilities: ProviderCapabilities
+  board: BoardView
+  config: BoardConfig
+  metrics: BoardMetrics | null
+  activity: ActivityEntry[]
+  team: ProviderTeamInfo | null
+}

package/ui/dist/assets/index-DEnUD0fq.css

@@ -0,0 +1 @@
+*,*:before,*:after{box-sizing:border-box;margin:0;padding:0}:root{--bg-primary: #0f1117;--bg-secondary: #1a1d27;--bg-card: #1e2130;--bg-hover: #252838;--border: #2a2d3a;--border-light: #353849;--text-primary: rgba(255, 255, 255, .92);--text-secondary: #9ca3af;--text-muted: #6b7280;--accent: #6366f1;--accent-hover: #818cf8;--priority-urgent: #ef4444;--priority-high: #f97316;--priority-medium: #eab308;--priority-low: #22c55e;--col-recurring: #6b7280;--col-backlog: #f59e0b;--col-in-progress: #3b82f6;--col-review: #8b5cf6;--col-done: #22c55e;--section-radius: 10px}body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,sans-serif;background:var(--bg-primary);color:var(--text-primary);min-height:100vh}#root{width:100%;max-width:1800px;margin:0 auto;padding:16px 24px}.header{padding:12px 0 16px;border-bottom:1px solid var(--border);margin-bottom:16px}.headerTop{display:flex;align-items:center;justify-content:space-between;margin-bottom:14px}.header h1{font-size:20px;font-weight:700;letter-spacing:-.02em}.header h1 span{color:var(--accent)}.newTaskBtn{background:var(--accent);color:#fff;border:none;padding:8px 18px;border-radius:8px;font-size:13px;font-weight:600;cursor:pointer;transition:background .15s}.newTaskBtn:hover{background:var(--accent-hover)}.statsBar{display:flex;gap:12px;margin-bottom:14px}.statCard{background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:10px 16px;display:flex;align-items:baseline;gap:8px}.statValue{font-size:20px;font-weight:700;color:var(--accent)}.statLabel{font-size:12px;color:var(--text-muted)}.filterBar{display:flex;align-items:center;justify-content:space-between;gap:12px}.filterGroup{display:flex;gap:6px;align-items:center}.filterBtn{background:var(--bg-secondary);border:1px solid var(--border);color:var(--text-secondary);padding:5px 14px;border-radius:20px;font-size:12px;cursor:pointer;transition:all .15s}.filterBtn:hover{border-color:var(--border-light);color:var(--text-primary)}.filterBtn.active{background:var(--accent);border-color:var(--accent);color:#fff}.projectDropdown{background:var(--bg-secondary);border:1px solid var(--border);color:var(--text-secondary);padding:5px 28px 5px 14px;border-radius:20px;font-size:12px;cursor:pointer;-webkit-appearance:none;-moz-appearance:none;appearance:none;background-image:url("data:image/svg+xml,%3Csvg width='10' height='6' viewBox='0 0 10 6' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M1 1L5 5L9 1' stroke='%236b7280' stroke-width='1.5' stroke-linecap='round'/%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 10px center}.projectDropdown:focus{outline:none;border-color:var(--accent)}.board{display:flex;gap:12px;overflow-x:auto;padding-bottom:8px;min-height:calc(100vh - 220px)}.column{flex:1;min-width:240px;background:var(--bg-secondary);border:1px solid var(--border);border-radius:var(--section-radius);display:flex;flex-direction:column}.columnHeader{padding:12px 14px;border-bottom:1px solid var(--border);display:flex;align-items:center;gap:10px}.columnDot{width:8px;height:8px;border-radius:50%;flex-shrink:0}.columnName{font-size:13px;font-weight:600;text-transform:capitalize;flex:1}.columnCount{background:var(--border);color:var(--text-secondary);padding:2px 8px;border-radius:10px;font-size:11px;min-width:22px;text-align:center}.columnAddBtn{background:none;border:none;color:var(--text-muted);cursor:pointer;font-size:16px;line-height:1;padding:0 2px;transition:color .15s}.columnAddBtn:hover{color:var(--accent)}.columnBody{padding:8px;display:flex;flex-direction:column;gap:6px;min-height:60px;flex:1}.emptyColumn{display:flex;align-items:center;justify-content:center;color:var(--text-muted);font-size:13px;flex:1}.taskCard{background:var(--bg-card);border:1px solid var(--border);border-radius:8px;padding:12px 14px;cursor:pointer;transition:border-color .15s,background .15s}.taskCard:hover{border-color:var(--border-light);background:var(--bg-hover)}.taskCard.selected{border-color:var(--accent);box-shadow:0 0 0 1px var(--accent)}.taskCardHeader{display:flex;align-items:flex-start;gap:8px;margin-bottom:6px}.taskTitle{font-size:13px;font-weight:500;line-height:1.4;flex:1}.taskDescription{font-size:12px;color:var(--text-muted);line-height:1.4;margin-bottom:10px;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}.taskFooter{display:flex;align-items:center;justify-content:space-between;gap:8px}.taskFooterLeft{display:flex;align-items:center;gap:8px;min-width:0}.assigneeAvatar{width:22px;height:22px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:11px;font-weight:600;color:#fff;flex-shrink:0}.assigneeName{font-size:12px;color:var(--text-secondary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.projectTag{font-size:11px;padding:2px 8px;border-radius:4px;background:#6366f126;color:var(--accent);white-space:nowrap}.timestamp{font-size:11px;color:var(--text-muted);white-space:nowrap;flex-shrink:0}.priorityDot{width:8px;height:8px;border-radius:50%;flex-shrink:0;margin-top:4px}.priorityDot.urgent{background:var(--priority-urgent)}.priorityDot.high{background:var(--priority-high)}.priorityDot.medium{background:var(--priority-medium)}.priorityDot.low{background:var(--priority-low)}.taskDetailOverlay{position:fixed;top:0;right:0;bottom:0;left:0;background:#0006;z-index:9}.taskDetail{position:fixed;top:0;right:0;width:420px;height:100vh;background:var(--bg-secondary);border-left:1px solid var(--border);padding:24px;overflow-y:auto;z-index:10}.taskDetail .closeBtn{position:absolute;top:16px;right:16px;background:none;border:1px solid var(--border);color:var(--text-secondary);cursor:pointer;padding:4px 10px;border-radius:6px;font-size:14px}.taskDetail .closeBtn:hover{border-color:var(--accent);color:var(--text-primary)}.detailTitle{font-size:18px;font-weight:600;margin-bottom:20px;padding-right:40px;line-height:1.4}.detailField{margin-bottom:16px}.detailLabel{font-size:11px;color:var(--text-muted);text-transform:uppercase;letter-spacing:.05em;margin-bottom:4px}.detailValue{font-size:14px}.detailActions{display:flex;gap:8px;margin-top:24px;padding-top:16px;border-top:1px solid var(--border)}.detailSelect{background:var(--bg-card);border:1px solid var(--border);color:var(--text-primary);padding:6px 12px;border-radius:6px;font-size:13px;flex:1}.detailSelect:focus{outline:none;border-color:var(--accent)}.deleteBtn{background:#ef44441a;border:1px solid rgba(239,68,68,.3);color:#ef4444;padding:6px 16px;border-radius:6px;font-size:13px;cursor:pointer;transition:all .15s}.deleteBtn:hover{background:#ef444433;border-color:#ef444480}.modalOverlay{position:fixed;top:0;right:0;bottom:0;left:0;background:#0009;display:flex;align-items:center;justify-content:center;z-index:20}.modal{background:var(--bg-secondary);border:1px solid var(--border);border-radius:12px;padding:28px;width:480px;max-width:90vw;max-height:90vh;overflow-y:auto}.modal h2{font-size:18px;font-weight:600;margin-bottom:20px}.formField{margin-bottom:16px}.formLabel{display:block;font-size:12px;color:var(--text-secondary);margin-bottom:6px;font-weight:500}.formInput{width:100%;background:var(--bg-card);border:1px solid var(--border);color:var(--text-primary);padding:8px 12px;border-radius:6px;font-size:14px;font-family:inherit}.formInput:focus{outline:none;border-color:var(--accent)}textarea.formInput{resize:vertical;min-height:80px}select.formInput{-webkit-appearance:none;-moz-appearance:none;appearance:none;padding-right:28px;background-image:url("data:image/svg+xml,%3Csvg width='10' height='6' viewBox='0 0 10 6' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M1 1L5 5L9 1' stroke='%236b7280' stroke-width='1.5' stroke-linecap='round'/%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 10px center}.formRow{display:grid;grid-template-columns:1fr 1fr;gap:12px}.modalActions{display:flex;justify-content:flex-end;gap:10px;margin-top:24px}.btnSecondary{background:var(--bg-card);border:1px solid var(--border);color:var(--text-secondary);padding:8px 18px;border-radius:8px;font-size:13px;cursor:pointer;transition:all .15s}.btnSecondary:hover{border-color:var(--border-light);color:var(--text-primary)}.btnPrimary{background:var(--accent);border:none;color:#fff;padding:8px 18px;border-radius:8px;font-size:13px;font-weight:600;cursor:pointer;transition:background .15s}.btnPrimary:hover{background:var(--accent-hover)}.btnPrimary:disabled{opacity:.5;cursor:not-allowed}.appLayout{display:grid;grid-template-columns:1fr;gap:0}.loading{display:flex;align-items:center;justify-content:center;padding:40px;color:var(--text-secondary)}.errorBanner{background:#ef44441a;border:1px solid rgba(239,68,68,.3);color:#ef4444;padding:10px 16px;border-radius:8px;font-size:13px;margin-bottom:12px}.wsIndicator{width:8px;height:8px;border-radius:50%;display:inline-block}.wsIndicator.connected{background:var(--col-done)}.wsIndicator.disconnected{background:var(--text-muted)}