kanban-lite 1.0.4

package/src/sdk/fileUtils.ts

@@ -0,0 +1,76 @@
+import * as path from 'path'
+import * as fs from 'fs/promises'
+
+export function getFeatureFilePath(featuresDir: string, status: string, filename: string): string {
+  return path.join(featuresDir, status, `${filename}.md`)
+}
+
+export async function ensureDirectories(featuresDir: string): Promise<void> {
+  await fs.mkdir(featuresDir, { recursive: true })
+}
+
+export async function moveFeatureFile(
+  currentPath: string,
+  featuresDir: string,
+  newStatus: string,
+  attachments?: string[]
+): Promise<string> {
+  const filename = path.basename(currentPath)
+  const targetDir = path.join(featuresDir, newStatus)
+  let targetPath = path.join(targetDir, filename)
+
+  if (currentPath === targetPath) return currentPath
+
+  const ext = path.extname(filename)
+  const base = path.basename(filename, ext)
+  let counter = 1
+  while (await fileExists(targetPath)) {
+    targetPath = path.join(targetDir, `${base}-${counter}${ext}`)
+    counter++
+  }
+
+  await fs.mkdir(targetDir, { recursive: true })
+  await fs.rename(currentPath, targetPath)
+
+  if (attachments && attachments.length > 0) {
+    const sourceDir = path.dirname(currentPath)
+    for (const attachment of attachments) {
+      const srcAttach = path.join(sourceDir, attachment)
+      const destAttach = path.join(targetDir, attachment)
+      try {
+        await fs.access(srcAttach)
+        await fs.rename(srcAttach, destAttach)
+      } catch {
+        // Best effort -- skip failed attachment moves
+      }
+    }
+  }
+
+  return targetPath
+}
+
+export async function renameFeatureFile(currentPath: string, newFilename: string): Promise<string> {
+  const dir = path.dirname(currentPath)
+  const newPath = path.join(dir, `${newFilename}.md`)
+  if (currentPath === newPath) return currentPath
+  await fs.rename(currentPath, newPath)
+  return newPath
+}
+
+export function getStatusFromPath(filePath: string, featuresDir: string): string | null {
+  const relative = path.relative(featuresDir, filePath)
+  const parts = relative.split(path.sep)
+  if (parts.length === 2) {
+    return parts[0]
+  }
+  return null
+}
+
+async function fileExists(filePath: string): Promise<boolean> {
+  try {
+    await fs.access(filePath)
+    return true
+  } catch {
+    return false
+  }
+}

package/src/sdk/index.ts

@@ -0,0 +1,6 @@
+export { KanbanSDK } from './KanbanSDK'
+export { parseFeatureFile, serializeFeature } from './parser'
+export { getFeatureFilePath, ensureDirectories, moveFeatureFile, getStatusFromPath } from './fileUtils'
+export type { CreateCardInput, BoardConfig } from './types'
+export type { Feature, FeatureStatus, Priority, KanbanColumn } from '../shared/types'
+export { getTitleFromContent, generateFeatureFilename, DEFAULT_COLUMNS } from '../shared/types'

package/src/sdk/parser.ts

@@ -0,0 +1,70 @@
+import * as path from 'path'
+import type { Feature, FeatureStatus, Priority } from '../shared/types'
+
+function extractIdFromFilename(filePath: string): string {
+  const basename = path.basename(filePath, '.md')
+  // New format: "42-some-slug" → "42"
+  const numericMatch = basename.match(/^(\d+)-/)
+  if (numericMatch) return numericMatch[1]
+  // Legacy format: full basename is the ID
+  return basename
+}
+
+export function parseFeatureFile(content: string, filePath: string): Feature | null {
+  content = content.replace(/\r\n/g, '\n')
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/)
+  if (!frontmatterMatch) return null
+
+  const frontmatter = frontmatterMatch[1]
+  const body = frontmatterMatch[2] || ''
+
+  const getValue = (key: string): string => {
+    const match = frontmatter.match(new RegExp(`^${key}:\\s*(.*)$`, 'm'))
+    if (!match) return ''
+    const value = match[1].trim().replace(/^["']|["']$/g, '')
+    return value === 'null' ? '' : value
+  }
+
+  const getArrayValue = (key: string): string[] => {
+    const match = frontmatter.match(new RegExp(`^${key}:\\s*\\[([^\\]]*)\\]`, 'm'))
+    if (!match) return []
+    return match[1].split(',').map(s => s.trim().replace(/^["']|["']$/g, '')).filter(Boolean)
+  }
+
+  return {
+    id: getValue('id') || extractIdFromFilename(filePath),
+    status: (getValue('status') as FeatureStatus) || 'backlog',
+    priority: (getValue('priority') as Priority) || 'medium',
+    assignee: getValue('assignee') || null,
+    dueDate: getValue('dueDate') || null,
+    created: getValue('created') || new Date().toISOString(),
+    modified: getValue('modified') || new Date().toISOString(),
+    completedAt: getValue('completedAt') || null,
+    labels: getArrayValue('labels'),
+    attachments: getArrayValue('attachments'),
+    order: getValue('order') || 'a0',
+    content: body.trim(),
+    filePath
+  }
+}
+
+export function serializeFeature(feature: Feature): string {
+  const frontmatter = [
+    '---',
+    `id: "${feature.id}"`,
+    `status: "${feature.status}"`,
+    `priority: "${feature.priority}"`,
+    `assignee: ${feature.assignee ? `"${feature.assignee}"` : 'null'}`,
+    `dueDate: ${feature.dueDate ? `"${feature.dueDate}"` : 'null'}`,
+    `created: "${feature.created}"`,
+    `modified: "${feature.modified}"`,
+    `completedAt: ${feature.completedAt ? `"${feature.completedAt}"` : 'null'}`,
+    `labels: [${feature.labels.map(l => `"${l}"`).join(', ')}]`,
+    `attachments: [${(feature.attachments || []).map(a => `"${a}"`).join(', ')}]`,
+    `order: "${feature.order}"`,
+    '---',
+    ''
+  ].join('\n')
+
+  return frontmatter + feature.content
+}

package/src/sdk/types.ts

@@ -0,0 +1,15 @@
+import type { FeatureStatus, KanbanColumn, Priority } from '../shared/types'
+
+export interface CreateCardInput {
+  content: string
+  status?: FeatureStatus
+  priority?: Priority
+  assignee?: string | null
+  dueDate?: string | null
+  labels?: string[]
+  attachments?: string[]
+}
+
+export interface BoardConfig {
+  columns: KanbanColumn[]
+}

package/src/shared/config.ts

@@ -0,0 +1,113 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import type { KanbanColumn, CardDisplaySettings, Priority, FeatureStatus } from './types'
+
+export interface KanbanConfig {
+  featuresDirectory: string
+  defaultPriority: Priority
+  defaultStatus: FeatureStatus
+  columns: KanbanColumn[]
+  aiAgent: string
+  nextCardId: number
+  showPriorityBadges: boolean
+  showAssignee: boolean
+  showDueDate: boolean
+  showLabels: boolean
+  showBuildWithAI: boolean
+  showFileName: boolean
+  compactMode: boolean
+  markdownEditorMode: boolean
+}
+
+export const DEFAULT_CONFIG: KanbanConfig = {
+  featuresDirectory: '.kanban',
+  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,
+  showLabels: true,
+  showBuildWithAI: true,
+  showFileName: false,
+  compactMode: false,
+  markdownEditorMode: false
+}
+
+export const CONFIG_FILENAME = '.kanban.json'
+
+export function configPath(workspaceRoot: string): string {
+  return path.join(workspaceRoot, CONFIG_FILENAME)
+}
+
+export function readConfig(workspaceRoot: string): KanbanConfig {
+  const filePath = configPath(workspaceRoot)
+  try {
+    const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'))
+    return { ...DEFAULT_CONFIG, ...raw }
+  } catch {
+    return { ...DEFAULT_CONFIG }
+  }
+}
+
+export function writeConfig(workspaceRoot: string, config: KanbanConfig): void {
+  const filePath = configPath(workspaceRoot)
+  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 {
+  const config = readConfig(workspaceRoot)
+  const id = config.nextCardId
+  writeConfig(workspaceRoot, { ...config, nextCardId: id + 1 })
+  return id
+}
+
+/** Ensure nextCardId is ahead of all existing numeric IDs */
+export function syncCardIdCounter(workspaceRoot: 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 })
+  }
+}
+
+/** Extract CardDisplaySettings from a KanbanConfig */
+export function configToSettings(config: KanbanConfig): CardDisplaySettings {
+  return {
+    showPriorityBadges: config.showPriorityBadges,
+    showAssignee: config.showAssignee,
+    showDueDate: config.showDueDate,
+    showLabels: config.showLabels,
+    showBuildWithAI: config.showBuildWithAI,
+    showFileName: config.showFileName,
+    compactMode: config.compactMode,
+    markdownEditorMode: config.markdownEditorMode,
+    defaultPriority: config.defaultPriority,
+    defaultStatus: config.defaultStatus
+  }
+}
+
+/** Merge CardDisplaySettings back into a KanbanConfig */
+export function settingsToConfig(config: KanbanConfig, settings: CardDisplaySettings): KanbanConfig {
+  return {
+    ...config,
+    showPriorityBadges: settings.showPriorityBadges,
+    showAssignee: settings.showAssignee,
+    showDueDate: settings.showDueDate,
+    showLabels: settings.showLabels,
+    showFileName: settings.showFileName,
+    compactMode: settings.compactMode,
+    defaultPriority: settings.defaultPriority,
+    defaultStatus: settings.defaultStatus
+  }
+}

package/src/shared/editorTypes.ts

@@ -0,0 +1,14 @@
+import type { FeatureFrontmatter } from './types'
+
+export type { FeatureFrontmatter }
+
+// Messages from the extension to the editor webview
+export type EditorExtensionMessage =
+  | { type: 'init'; content: string; frontmatter: FeatureFrontmatter | null; fileName: string }
+
+// Messages from the editor webview to the extension
+export type EditorWebviewMessage =
+  | { type: 'ready' }
+  | { type: 'frontmatterUpdate'; frontmatter: FeatureFrontmatter }
+  | { type: 'requestSave' }
+  | { type: 'startWithAI'; agent?: 'claude' | 'codex' | 'opencode'; permissionMode?: 'default' | 'plan' | 'acceptEdits' | 'bypassPermissions' }

package/src/shared/types.ts

@@ -0,0 +1,120 @@
+// Kanban types
+
+export type Priority = 'critical' | 'high' | 'medium' | 'low'
+export type FeatureStatus = 'backlog' | 'todo' | 'in-progress' | 'review' | 'done'
+
+export interface Feature {
+  id: string
+  status: FeatureStatus
+  priority: Priority
+  assignee: string | null
+  dueDate: string | null
+  created: string
+  modified: string
+  completedAt: string | null
+  labels: string[]
+  attachments: string[]
+  order: string
+  content: string
+  filePath: 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)
+  if (match) return match[1].trim()
+  const firstLine = content.split('\n').map(l => l.trim()).find(l => l.length > 0)
+  return firstLine || 'Untitled'
+}
+
+// Generate a filename-safe slug from a title
+export function generateSlug(title: string): string {
+  return title
+    .toLowerCase()
+    .replace(/[^a-z0-9\s-]/g, '') // Remove special characters
+    .replace(/\s+/g, '-') // Replace spaces with hyphens
+    .replace(/-+/g, '-') // Replace multiple hyphens with single
+    .replace(/^-|-$/g, '') // Trim hyphens from start/end
+    .slice(0, 50) || 'feature' // Limit length, fallback
+}
+
+// Generate a filename from an incremental ID and a title
+export function generateFeatureFilename(id: number, title: string): string {
+  const slug = generateSlug(title)
+  return `${id}-${slug}`
+}
+
+// Extract the numeric ID prefix from a filename or ID string like "42-build-dashboard"
+export function extractNumericId(filenameOrId: string): number | null {
+  const match = filenameOrId.match(/^(\d+)(?:-|$)/)
+  return match ? parseInt(match[1], 10) : null
+}
+
+export interface KanbanColumn {
+  id: string
+  name: string
+  color: string
+}
+
+export const DEFAULT_COLUMNS: KanbanColumn[] = [
+  { 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' }
+]
+
+export interface CardDisplaySettings {
+  showPriorityBadges: boolean
+  showAssignee: boolean
+  showDueDate: boolean
+  showLabels: boolean
+  showBuildWithAI: boolean
+  showFileName: boolean
+  compactMode: boolean
+  markdownEditorMode: boolean
+  defaultPriority: Priority
+  defaultStatus: FeatureStatus
+}
+
+// Messages between extension and webview
+export type ExtensionMessage =
+  | { type: 'init'; features: Feature[]; columns: KanbanColumn[]; settings: CardDisplaySettings }
+  | { type: 'featuresUpdated'; features: Feature[] }
+  | { type: 'triggerCreateDialog' }
+  | { type: 'featureContent'; featureId: string; content: string; frontmatter: FeatureFrontmatter }
+  | { type: 'showSettings'; settings: CardDisplaySettings }
+
+// Frontmatter for editing
+export interface FeatureFrontmatter {
+  id: string
+  status: FeatureStatus
+  priority: Priority
+  assignee: string | null
+  dueDate: string | null
+  created: string
+  modified: string
+  completedAt: string | null
+  labels: string[]
+  attachments: string[]
+  order: string
+}
+
+export type WebviewMessage =
+  | { type: 'ready' }
+  | { type: 'createFeature'; data: { status: FeatureStatus; 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> }
+  | { type: 'openFeature'; featureId: string }
+  | { type: 'saveFeatureContent'; featureId: string; content: string; frontmatter: FeatureFrontmatter }
+  | { type: 'closeFeature' }
+  | { type: 'openFile'; featureId: string }
+  | { type: 'addAttachment'; featureId: string }
+  | { type: 'openAttachment'; featureId: string; attachment: string }
+  | { type: 'removeAttachment'; featureId: string; attachment: string }
+  | { type: 'openSettings' }
+  | { type: 'saveSettings'; settings: CardDisplaySettings }
+  | { type: 'addColumn'; column: { name: string; color: string } }
+  | { type: 'editColumn'; columnId: string; updates: { name: string; color: string } }
+  | { type: 'removeColumn'; columnId: string }