kanban-lite 1.0.9 → 1.0.13

package/src/shared/config.ts

@@ -1,11 +1,44 @@
 import * as fs from 'fs'
 import * as path from 'path'
-import type { KanbanColumn, CardDisplaySettings, Priority, FeatureStatus } from './types'
+import type { KanbanColumn, CardDisplaySettings, Priority } from './types'
+import { DEFAULT_COLUMNS } from './types'
 
+// Per-board configuration
+export interface BoardConfig {
+  name: string
+  description?: string
+  columns: KanbanColumn[]
+  nextCardId: number
+  defaultStatus: string
+  defaultPriority: Priority
+}
+
+// V2 config with multi-board support
 export interface KanbanConfig {
+  version: 2
+  boards: Record<string, BoardConfig>
+  defaultBoard: string
   featuresDirectory: string
+  aiAgent: string
+  // Global display settings (fallback defaults for defaultPriority/defaultStatus)
   defaultPriority: Priority
-  defaultStatus: FeatureStatus
+  defaultStatus: string
+  showPriorityBadges: boolean
+  showAssignee: boolean
+  showDueDate: boolean
+  showLabels: boolean
+  showBuildWithAI: boolean
+  showFileName: boolean
+  compactMode: boolean
+  markdownEditorMode: boolean
+}
+
+// Legacy v1 config (for migration)
+interface KanbanConfigV1 {
+  version?: 1
+  featuresDirectory: string
+  defaultPriority: Priority
+  defaultStatus: string
   columns: KanbanColumn[]
   aiAgent: string
   nextCardId: number
@@ -19,19 +52,24 @@ export interface KanbanConfig {
   markdownEditorMode: boolean
 }
 
+const DEFAULT_BOARD_CONFIG: BoardConfig = {
+  name: 'Default',
+  columns: [...DEFAULT_COLUMNS],
+  nextCardId: 1,
+  defaultStatus: 'backlog',
+  defaultPriority: 'medium'
+}
+
 export const DEFAULT_CONFIG: KanbanConfig = {
+  version: 2,
+  boards: {
+    default: { ...DEFAULT_BOARD_CONFIG, columns: [...DEFAULT_COLUMNS] }
+  },
+  defaultBoard: 'default',
   featuresDirectory: '.kanban',
+  aiAgent: 'claude',
   defaultPriority: 'medium',
   defaultStatus: 'backlog',
-  columns: [
-    { id: 'backlog', name: 'Backlog', color: '#6b7280' },
-    { id: 'todo', name: 'To Do', color: '#3b82f6' },
-    { id: 'in-progress', name: 'In Progress', color: '#f59e0b' },
-    { id: 'review', name: 'Review', color: '#8b5cf6' },
-    { id: 'done', name: 'Done', color: '#22c55e' }
-  ],
-  aiAgent: 'claude',
-  nextCardId: 1,
   showPriorityBadges: true,
   showAssignee: true,
   showDueDate: true,
@@ -48,12 +86,69 @@ export function configPath(workspaceRoot: string): string {
   return path.join(workspaceRoot, CONFIG_FILENAME)
 }
 
+function migrateConfigV1ToV2(raw: Record<string, unknown>): KanbanConfig {
+  const v1Defaults: KanbanConfigV1 = {
+    featuresDirectory: '.kanban',
+    defaultPriority: 'medium',
+    defaultStatus: 'backlog',
+    columns: [...DEFAULT_COLUMNS],
+    aiAgent: 'claude',
+    nextCardId: 1,
+    showPriorityBadges: true,
+    showAssignee: true,
+    showDueDate: true,
+    showLabels: true,
+    showBuildWithAI: true,
+    showFileName: false,
+    compactMode: false,
+    markdownEditorMode: false
+  }
+  const v1 = { ...v1Defaults, ...raw } as KanbanConfigV1
+  return {
+    version: 2,
+    boards: {
+      default: {
+        name: 'Default',
+        columns: v1.columns,
+        nextCardId: v1.nextCardId,
+        defaultStatus: v1.defaultStatus,
+        defaultPriority: v1.defaultPriority
+      }
+    },
+    defaultBoard: 'default',
+    featuresDirectory: v1.featuresDirectory,
+    aiAgent: v1.aiAgent,
+    defaultPriority: v1.defaultPriority,
+    defaultStatus: v1.defaultStatus,
+    showPriorityBadges: v1.showPriorityBadges,
+    showAssignee: v1.showAssignee,
+    showDueDate: v1.showDueDate,
+    showLabels: v1.showLabels,
+    showBuildWithAI: v1.showBuildWithAI,
+    showFileName: v1.showFileName,
+    compactMode: v1.compactMode,
+    markdownEditorMode: v1.markdownEditorMode
+  }
+}
+
 export function readConfig(workspaceRoot: string): KanbanConfig {
   const filePath = configPath(workspaceRoot)
-  const defaults = { ...DEFAULT_CONFIG, columns: [...DEFAULT_CONFIG.columns] }
+  const defaults = { ...DEFAULT_CONFIG, boards: { default: { ...DEFAULT_BOARD_CONFIG, columns: [...DEFAULT_COLUMNS] } } }
   try {
     const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'))
-    return { ...defaults, ...raw }
+    if (!raw.version || raw.version === 1) {
+      // Migrate v1 to v2 and persist
+      const v2 = migrateConfigV1ToV2(raw)
+      writeConfig(workspaceRoot, v2)
+      return v2
+    }
+    // Merge with defaults for any missing fields
+    const config = { ...defaults, ...raw }
+    // Ensure boards object exists with at least default board
+    if (!config.boards || Object.keys(config.boards).length === 0) {
+      config.boards = defaults.boards
+    }
+    return config
   } catch {
     return defaults
   }
@@ -64,25 +159,52 @@ export function writeConfig(workspaceRoot: string, config: KanbanConfig): void {
   fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8')
 }
 
-/** Read and increment the nextCardId counter, returning the allocated ID */
-export function allocateCardId(workspaceRoot: string): number {
+/** Get the default board ID from config */
+export function getDefaultBoardId(workspaceRoot: string): string {
   const config = readConfig(workspaceRoot)
-  const id = config.nextCardId
-  writeConfig(workspaceRoot, { ...config, nextCardId: id + 1 })
+  return config.defaultBoard
+}
+
+/** Get board config, using default board if boardId is omitted */
+export function getBoardConfig(workspaceRoot: string, boardId?: string): BoardConfig {
+  const config = readConfig(workspaceRoot)
+  const resolvedId = boardId || config.defaultBoard
+  const board = config.boards[resolvedId]
+  if (!board) {
+    throw new Error(`Board '${resolvedId}' not found`)
+  }
+  return board
+}
+
+/** Read and increment the nextCardId counter for a board, returning the allocated ID */
+export function allocateCardId(workspaceRoot: string, boardId?: string): number {
+  const config = readConfig(workspaceRoot)
+  const resolvedId = boardId || config.defaultBoard
+  const board = config.boards[resolvedId]
+  if (!board) {
+    throw new Error(`Board '${resolvedId}' not found`)
+  }
+  const id = board.nextCardId
+  board.nextCardId = id + 1
+  writeConfig(workspaceRoot, config)
   return id
 }
 
-/** Ensure nextCardId is ahead of all existing numeric IDs */
-export function syncCardIdCounter(workspaceRoot: string, existingIds: number[]): void {
+/** Ensure nextCardId is ahead of all existing numeric IDs for a board */
+export function syncCardIdCounter(workspaceRoot: string, boardId: string, existingIds: number[]): void {
   if (existingIds.length === 0) return
   const maxId = Math.max(...existingIds)
   const config = readConfig(workspaceRoot)
-  if (config.nextCardId <= maxId) {
-    writeConfig(workspaceRoot, { ...config, nextCardId: maxId + 1 })
+  const resolvedId = boardId || config.defaultBoard
+  const board = config.boards[resolvedId]
+  if (!board) return
+  if (board.nextCardId <= maxId) {
+    board.nextCardId = maxId + 1
+    writeConfig(workspaceRoot, config)
   }
 }
 
-/** Extract CardDisplaySettings from a KanbanConfig */
+/** Extract CardDisplaySettings from a KanbanConfig (global settings + fallback defaults) */
 export function configToSettings(config: KanbanConfig): CardDisplaySettings {
   return {
     showPriorityBadges: config.showPriorityBadges,

package/src/shared/types.ts

@@ -1,7 +1,7 @@
 // Kanban types
 
 export type Priority = 'critical' | 'high' | 'medium' | 'low'
-export type FeatureStatus = 'backlog' | 'todo' | 'in-progress' | 'review' | 'done'
+export type FeatureStatus = string
 
 export interface Comment {
   id: string
@@ -12,6 +12,7 @@ export interface Comment {
 
 export interface Feature {
   id: string
+  boardId?: string
   status: FeatureStatus
   priority: Priority
   assignee: string | null
@@ -27,6 +28,12 @@ export interface Feature {
   filePath: string
 }
 
+export interface BoardInfo {
+  id: string
+  name: string
+  description?: string
+}
+
 // Parse title from the first # heading in markdown content, falling back to the first line
 export function getTitleFromContent(content: string): string {
   const match = content.match(/^#\s+(.+)$/m)
@@ -82,12 +89,12 @@ export interface CardDisplaySettings {
   compactMode: boolean
   markdownEditorMode: boolean
   defaultPriority: Priority
-  defaultStatus: FeatureStatus
+  defaultStatus: string
 }
 
 // Messages between extension and webview
 export type ExtensionMessage =
-  | { type: 'init'; features: Feature[]; columns: KanbanColumn[]; settings: CardDisplaySettings }
+  | { type: 'init'; features: Feature[]; columns: KanbanColumn[]; settings: CardDisplaySettings; boards?: BoardInfo[]; currentBoard?: string }
   | { type: 'featuresUpdated'; features: Feature[] }
   | { type: 'triggerCreateDialog' }
   | { type: 'featureContent'; featureId: string; content: string; frontmatter: FeatureFrontmatter; comments: Comment[] }
@@ -96,7 +103,7 @@ export type ExtensionMessage =
 // Frontmatter for editing
 export interface FeatureFrontmatter {
   id: string
-  status: FeatureStatus
+  status: string
   priority: Priority
   assignee: string | null
   dueDate: string | null
@@ -110,7 +117,7 @@ export interface FeatureFrontmatter {
 
 export type WebviewMessage =
   | { type: 'ready' }
-  | { type: 'createFeature'; data: { status: FeatureStatus; priority: Priority; content: string; assignee: string | null; dueDate: string | null; labels: string[] } }
+  | { type: 'createFeature'; data: { status: string; priority: Priority; content: string; assignee: string | null; dueDate: string | null; labels: string[] } }
   | { type: 'moveFeature'; featureId: string; newStatus: string; newOrder: number }
   | { type: 'deleteFeature'; featureId: string }
   | { type: 'updateFeature'; featureId: string; updates: Partial<Feature> }
@@ -129,3 +136,5 @@ export type WebviewMessage =
   | { type: 'addComment'; featureId: string; author: string; content: string }
   | { type: 'updateComment'; featureId: string; commentId: string; content: string }
   | { type: 'deleteComment'; featureId: string; commentId: string }
+  | { type: 'switchBoard'; boardId: string }
+  | { type: 'createBoard'; name: string }

package/src/standalone/__tests__/server.integration.test.ts

@@ -12,8 +12,9 @@ function createTempDir(): string {
 }
 
 // Helper: write a feature markdown file
+// Files are stored under boards/default/{status}/ in the multi-board layout
 function writeFeatureFile(dir: string, filename: string, content: string, subfolder?: string): string {
-  const targetDir = subfolder ? path.join(dir, subfolder) : dir
+  const targetDir = subfolder ? path.join(dir, 'boards', 'default', subfolder) : path.join(dir, 'boards', 'default')
   fs.mkdirSync(targetDir, { recursive: true })
   const filePath = path.join(targetDir, filename)
   fs.writeFileSync(filePath, content, 'utf-8')
@@ -366,8 +367,8 @@ describe('Standalone Server Integration', () => {
       expect(features[0].content).toBe('# My New Feature\n\nSome description')
       expect(features[0].labels).toEqual(['frontend'])
 
-      // Verify file exists on disk in todo/ subfolder
-      const todoDir = path.join(tempDir, 'todo')
+      // Verify file exists on disk in boards/default/todo/ subfolder
+      const todoDir = path.join(tempDir, 'boards', 'default', 'todo')
       const files = fs.readdirSync(todoDir).filter(f => f.endsWith('.md'))
       expect(files.length).toBe(1)
 
@@ -402,8 +403,8 @@ describe('Standalone Server Integration', () => {
       expect(features[0].status).toBe('done')
       expect(features[0].completedAt).toBeTruthy()
 
-      // File should be in done/ subfolder
-      const doneFiles = fs.readdirSync(path.join(tempDir, 'done')).filter(f => f.endsWith('.md'))
+      // File should be in boards/default/done/ subfolder
+      const doneFiles = fs.readdirSync(path.join(tempDir, 'boards', 'default', 'done')).filter(f => f.endsWith('.md'))
       expect(doneFiles.length).toBe(1)
     })
 
@@ -436,7 +437,7 @@ describe('Standalone Server Integration', () => {
       const backlogFeatures = features.filter(f => f.status === 'backlog')
       expect(backlogFeatures.length).toBe(2)
       // New feature should come after existing (order > 'a0')
-      expect(backlogFeatures[1].order > backlogFeatures[0].order).toBe(true)
+      expect((backlogFeatures[1].order as string) > (backlogFeatures[0].order as string)).toBe(true)
     })
 
     it('should preserve assignee and dueDate', async () => {
@@ -491,9 +492,9 @@ describe('Standalone Server Integration', () => {
       const features = response.features as Array<Record<string, unknown>>
       expect(features[0].status).toBe('in-progress')
 
-      // Verify file was moved to in-progress/ subfolder
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'move-me.md'))).toBe(false)
-      const fileContent = fs.readFileSync(path.join(tempDir, 'in-progress', 'move-me.md'), 'utf-8')
+      // Verify file was moved to boards/default/in-progress/ subfolder
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'move-me.md'))).toBe(false)
+      const fileContent = fs.readFileSync(path.join(tempDir, 'boards', 'default', 'in-progress', 'move-me.md'), 'utf-8')
       expect(fileContent).toContain('status: "in-progress"')
     })
 
@@ -521,9 +522,9 @@ describe('Standalone Server Integration', () => {
       expect(features[0].status).toBe('done')
       expect(features[0].completedAt).toBeTruthy()
 
-      // File should now be in done/ subfolder
-      expect(fs.existsSync(path.join(tempDir, 'review', 'finish-me.md'))).toBe(false)
-      expect(fs.existsSync(path.join(tempDir, 'done', 'finish-me.md'))).toBe(true)
+      // File should now be in boards/default/done/ subfolder
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'review', 'finish-me.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'done', 'finish-me.md'))).toBe(true)
     })
 
     it('should move file from done/ to target status folder', async () => {
@@ -550,9 +551,9 @@ describe('Standalone Server Integration', () => {
       expect(features[0].status).toBe('todo')
       expect(features[0].completedAt).toBeNull()
 
-      // File should be in todo/ subfolder
-      expect(fs.existsSync(path.join(tempDir, 'done', 'reopen-me.md'))).toBe(false)
-      expect(fs.existsSync(path.join(tempDir, 'todo', 'reopen-me.md'))).toBe(true)
+      // File should be in boards/default/todo/ subfolder
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'done', 'reopen-me.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'todo', 'reopen-me.md'))).toBe(true)
     })
 
     it('should compute correct fractional order between neighbors', async () => {
@@ -596,8 +597,8 @@ describe('Standalone Server Integration', () => {
       expect(todoFeatures[1].id).toBe('feat-move')
       expect(todoFeatures[2].id).toBe('feat-c')
       // Verify order is between a0 and a2
-      expect(todoFeatures[1].order > todoFeatures[0].order).toBe(true)
-      expect(todoFeatures[1].order < todoFeatures[2].order).toBe(true)
+      expect((todoFeatures[1].order as string) > (todoFeatures[0].order as string)).toBe(true)
+      expect((todoFeatures[1].order as string) < (todoFeatures[2].order as string)).toBe(true)
     })
   })
 
@@ -625,7 +626,7 @@ describe('Standalone Server Integration', () => {
       expect(features.length).toBe(0)
 
       // File should be removed
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'delete-me.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'delete-me.md'))).toBe(false)
     })
 
     it('should only delete the targeted feature', async () => {
@@ -646,7 +647,7 @@ describe('Standalone Server Integration', () => {
       const features = response.features as Array<Record<string, unknown>>
       expect(features.length).toBe(1)
       expect(features[0].id).toBe('keep-me')
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'keep-me.md'))).toBe(true)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'keep-me.md'))).toBe(true)
     })
 
     it('should handle deleting non-existent feature gracefully', async () => {
@@ -697,7 +698,7 @@ describe('Standalone Server Integration', () => {
       expect(features[0].labels).toEqual(['urgent'])
 
       // Verify persisted on disk
-      const fileContent = fs.readFileSync(path.join(tempDir, 'backlog', 'update-me.md'), 'utf-8')
+      const fileContent = fs.readFileSync(path.join(tempDir, 'boards', 'default', 'backlog', 'update-me.md'), 'utf-8')
       expect(fileContent).toContain('priority: "critical"')
       expect(fileContent).toContain('assignee: "alice"')
       expect(fileContent).toContain('labels: ["urgent"]')
@@ -813,9 +814,9 @@ describe('Standalone Server Integration', () => {
       expect(saved.assignee).toBe('charlie')
       expect(saved.labels).toEqual(['updated'])
 
-      // Verify on disk — file moved from backlog/ to in-progress/
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'save-me.md'))).toBe(false)
-      const fileContent = fs.readFileSync(path.join(tempDir, 'in-progress', 'save-me.md'), 'utf-8')
+      // Verify on disk — file moved from boards/default/backlog/ to boards/default/in-progress/
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'save-me.md'))).toBe(false)
+      const fileContent = fs.readFileSync(path.join(tempDir, 'boards', 'default', 'in-progress', 'save-me.md'), 'utf-8')
       expect(fileContent).toContain('status: "in-progress"')
       expect(fileContent).toContain('# Save Me Updated')
       expect(fileContent).toContain('assignee: "charlie"')
@@ -856,8 +857,8 @@ describe('Standalone Server Integration', () => {
         }
       }, 'init')
 
-      expect(fs.existsSync(path.join(tempDir, 'review', 'save-done.md'))).toBe(false)
-      expect(fs.existsSync(path.join(tempDir, 'done', 'save-done.md'))).toBe(true)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'review', 'save-done.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'done', 'save-done.md'))).toBe(true)
     })
   })
 
@@ -1088,8 +1089,8 @@ describe('Standalone Server Integration', () => {
       }
 
       // Files on disk should be updated
-      const file1 = fs.readFileSync(path.join(tempDir, 'backlog', 'legacy-1.md'), 'utf-8')
-      const file2 = fs.readFileSync(path.join(tempDir, 'backlog', 'legacy-2.md'), 'utf-8')
+      const file1 = fs.readFileSync(path.join(tempDir, 'boards', 'default', 'backlog', 'legacy-1.md'), 'utf-8')
+      const file2 = fs.readFileSync(path.join(tempDir, 'boards', 'default', 'backlog', 'legacy-2.md'), 'utf-8')
       const orderMatch1 = file1.match(/order: "(.+)"/)
       const orderMatch2 = file2.match(/order: "(.+)"/)
       expect(orderMatch1).toBeTruthy()
@@ -1118,9 +1119,9 @@ describe('Standalone Server Integration', () => {
 
       await sendAndReceive(ws, { type: 'ready' }, 'init')
 
-      // After load, file should have been migrated to done/
-      expect(fs.existsSync(path.join(tempDir, 'misplaced-done.md'))).toBe(false)
-      expect(fs.existsSync(path.join(tempDir, 'done', 'misplaced-done.md'))).toBe(true)
+      // After load, file should have been migrated to boards/default/done/
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'misplaced-done.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'done', 'misplaced-done.md'))).toBe(true)
     })
 
     it('should move mismatched file to correct status subfolder', async () => {
@@ -1137,9 +1138,9 @@ describe('Standalone Server Integration', () => {
 
       await sendAndReceive(ws, { type: 'ready' }, 'init')
 
-      // After load, file should have been moved to backlog/
-      expect(fs.existsSync(path.join(tempDir, 'done', 'misplaced-active.md'))).toBe(false)
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'misplaced-active.md'))).toBe(true)
+      // After load, file should have been moved to boards/default/backlog/
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'done', 'misplaced-active.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'misplaced-active.md'))).toBe(true)
     })
   })
 
@@ -1536,7 +1537,7 @@ describe('Standalone Server Integration', () => {
       expect(json.data.filePath).toBeUndefined()
 
       // Verify persisted on disk
-      const todoDir = path.join(tempDir, 'todo')
+      const todoDir = path.join(tempDir, 'boards', 'default', 'todo')
       const files = fs.readdirSync(todoDir).filter(f => f.endsWith('.md'))
       expect(files.length).toBe(1)
     })
@@ -1597,8 +1598,8 @@ describe('Standalone Server Integration', () => {
       expect(json.data.status).toBe('in-progress')
 
       // File should be moved
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'move-api.md'))).toBe(false)
-      expect(fs.existsSync(path.join(tempDir, 'in-progress', 'move-api.md'))).toBe(true)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'move-api.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'in-progress', 'move-api.md'))).toBe(true)
     })
 
     it('DELETE /api/tasks/:id should delete a task', async () => {
@@ -1617,7 +1618,7 @@ describe('Standalone Server Integration', () => {
       expect(json.ok).toBe(true)
 
       // File should be gone
-      expect(fs.existsSync(path.join(tempDir, 'backlog', 'delete-api.md'))).toBe(false)
+      expect(fs.existsSync(path.join(tempDir, 'boards', 'default', 'backlog', 'delete-api.md'))).toBe(false)
     })
 
     it('DELETE /api/tasks/:id should return 404 for non-existent task', async () => {