kanban-lite 1.2.2 → 1.2.4

package/src/standalone/server.ts

@@ -9,11 +9,11 @@ import type { StandaloneHttpHandler, StandaloneHttpPlugin } from '../sdk'
 import { createRouteMatcher, type StandaloneRequestContext, type StandaloneRouteHandler } from './internal/common'
 import { KANBAN_OPENAPI_SPEC } from './internal/openapi-spec'
 import { handleCardFileRoute, setupStandaloneLifecycle } from './internal/lifecycle'
-import { createStandaloneRuntime, indexHtml } from './internal/runtime'
+import { createStandaloneRuntime, getIndexHtml } from './internal/runtime'
 import { handleBoardRoutes } from './internal/routes/boards'
 import { handleSystemRoutes } from './internal/routes/system'
 import { handleTaskRoutes } from './internal/routes/tasks'
-import { getRequestAuthContext, mergeRequestAuthContext, setRequestAuthContext } from './authUtils'
+import { extractAuthContext, getRequestAuthContext, mergeRequestAuthContext, setRequestAuthContext } from './authUtils'
 import { attachWebSocketHandlers } from './internal/websocket'
 import { matchRoute, type IncomingMessageWithRawBody } from './httpUtils'
 
@@ -176,6 +176,7 @@ function collectStandaloneHttpHandlers(
 ): StandaloneHttpHandler[] {
   const plugins = ctx.sdk.capabilities?.standaloneHttpPlugins ?? []
   const registrationOptions = {
+    sdk: ctx.sdk,
     workspaceRoot: ctx.workspaceRoot,
     kanbanDir: ctx.absoluteKanbanDir,
     capabilities: ctx.sdk.capabilities?.providers ?? {
@@ -249,11 +250,15 @@ export function startServer(kanbanDir: string, port: number, webviewDir?: string
     ? { type: 'image/svg+xml', content: fs.readFileSync(swaggerUiLogoPath) }
     : null
 
-  const runtime = createStandaloneRuntime(kanbanDir, webviewDir, fastify.server)
+  const workspaceRoot = path.dirname(path.resolve(kanbanDir))
+  const config = readConfig(workspaceRoot)
+  const rawBase = config.basePath ?? ''
+  const basePath = rawBase ? (rawBase.startsWith('/') ? rawBase : '/' + rawBase).replace(/\/+$/, '') : ''
+
+  const runtime = createStandaloneRuntime(kanbanDir, webviewDir, fastify.server, basePath)
   const { ctx, resolvedWebviewDir } = runtime
 
-  const config = readConfig(ctx.workspaceRoot)
-  let resolvedIndexHtml = indexHtml
+  let resolvedIndexHtml = getIndexHtml(basePath)
   let customHead = config.customHeadHtml || ''
   if (config.customHeadHtmlFile) {
     try {
@@ -262,7 +267,7 @@ export function startServer(kanbanDir: string, port: number, webviewDir?: string
     } catch { /* file not found, fall back to customHeadHtml */ }
   }
   if (customHead) {
-    resolvedIndexHtml = indexHtml.replace('</head>', `${customHead}\n</head>`)
+    resolvedIndexHtml = resolvedIndexHtml.replace('</head>', `${customHead}\n</head>`)
   }
   const standaloneHttpPlugins = ctx.sdk.capabilities?.standaloneHttpPlugins ?? []
   const standaloneOpenApiSpec = buildStandaloneOpenApiSpec(standaloneHttpPlugins)
@@ -270,7 +275,7 @@ export function startServer(kanbanDir: string, port: number, webviewDir?: string
   // OpenAPI spec and interactive docs (served before the catch-all so Fastify prefers these routes)
   fastify.register(swagger, { openapi: standaloneOpenApiSpec as any })
   fastify.register(swaggerUi, {
-    routePrefix: '/api/docs',
+    routePrefix: `${basePath}/api/docs`,
     uiConfig: { docExpansion: 'list', deepLinking: false },
     logo: swaggerUiLogo,
     ...(swaggerUiStaticDir ? { baseDir: swaggerUiStaticDir } : {}),
@@ -313,6 +318,16 @@ export function startServer(kanbanDir: string, port: number, webviewDir?: string
       req._rawBody = request.body
     }
 
+    // Strip base path prefix so internal route handlers see root-relative paths
+    if (basePath) {
+      const rawUrl = req.url ?? '/'
+      if (rawUrl === basePath) {
+        req.url = '/'
+      } else if (rawUrl.startsWith(basePath + '/') || rawUrl.startsWith(basePath + '?')) {
+        req.url = rawUrl.slice(basePath.length)
+      }
+    }
+
     const requestContext = createRequestContext(ctx, req, reply.raw, resolvedWebviewDir, resolvedIndexHtml)
 
     await dispatchRequest(requestContext, middlewareHandlers)
@@ -324,7 +339,50 @@ export function startServer(kanbanDir: string, port: number, webviewDir?: string
     reply.hijack()
   })
 
-  attachWebSocketHandlers(ctx)
+  // Resolve auth context for WebSocket upgrade requests by running the middleware
+  // pipeline so session cookies set by auth plugins (e.g. kl-auth-plugin) are honoured.
+  const resolveWsAuthContext = async (req: http.IncomingMessage) => {
+    const silentRes = (() => {
+      const r: Record<string, unknown> = {
+        writableEnded: false,
+        writeHead() { return r },
+        setHeader() { return r },
+        removeHeader() { /* no-op */ },
+        getHeader() { return undefined },
+        getHeaders() { return {} },
+        end(..._args: unknown[]) { (r as { writableEnded: boolean }).writableEnded = true; return r },
+        write() { return false },
+      }
+      return r as unknown as import('http').ServerResponse
+    })()
+    const reqWithBody = req as IncomingMessageWithRawBody
+    const wsUrl = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`)
+    const requestContext: StandaloneRequestContext = {
+      ctx,
+      sdk: ctx.sdk,
+      workspaceRoot: ctx.workspaceRoot,
+      kanbanDir: ctx.absoluteKanbanDir,
+      req: reqWithBody,
+      res: silentRes,
+      url: wsUrl,
+      pathname: wsUrl.pathname,
+      method: 'GET',
+      resolvedWebviewDir,
+      indexHtml: resolvedIndexHtml,
+      route: createRouteMatcher('GET', wsUrl.pathname, matchRoute),
+      isApiRequest: false,
+      isPageRequest: false,
+      getAuthContext: () => getRequestAuthContext(req),
+      setAuthContext: (auth) => setRequestAuthContext(req, auth),
+      mergeAuthContext: (auth) => mergeRequestAuthContext(req, auth),
+    }
+    for (const handler of middlewareHandlers) {
+      if (await handler(requestContext)) break
+    }
+    return extractAuthContext(req)
+  }
+
+  attachWebSocketHandlers(ctx, resolveWsAuthContext)
   setupStandaloneLifecycle(ctx, fastify.server)
 
   const effectiveConfigPath = resolvedConfigPath ?? configPath(path.dirname(ctx.absoluteKanbanDir))
@@ -334,7 +392,7 @@ export function startServer(kanbanDir: string, port: number, webviewDir?: string
       console.error('Failed to start server:', err)
       process.exit(1)
     }
-    console.log(`Kanban board running at http://localhost:${port}`)
+    console.log(`Kanban board running at http://localhost:${port}${basePath}`)
     console.log(`API available at http://localhost:${port}/api`)
     console.log(`Kanban config: ${effectiveConfigPath}`)
     console.log(`Kanban directory: ${ctx.absoluteKanbanDir}`)

package/src/standalone/watcherSetup.ts

@@ -110,4 +110,13 @@ export function setupWatcher(ctx: StandaloneContext, server: http.Server): void
       ctx.wss.close()
     })
   }
+
+  // Watch .kanban.json for config changes and re-broadcast init on change
+  const configFilePath = path.join(ctx.workspaceRoot, '.kanban.json')
+  const configWatcher = chokidar.watch(configFilePath, {
+    ignoreInitial: true,
+    awaitWriteFinish: { stabilityThreshold: 100 }
+  })
+  configWatcher.on('change', () => handleFileChange(ctx, debounceRef))
+  server.on('close', () => configWatcher.close())
 }

package/src/webview/standalone-shim.ts

@@ -6,7 +6,8 @@ import type { ConnectionStatusMessage, ExtensionMessage, WebviewMessage } from '
 
 if (!('acquireVsCodeApi' in window)) {
 
-const WS_URL = `ws://${window.location.host}/ws`
+const kbBase = (window as unknown as { __KB_BASE__?: string }).__KB_BASE__ ?? ''
+const WS_URL = `${window.location.protocol === 'https:' ? 'wss' : 'ws'}://${window.location.host}${kbBase}/ws`
 const RECONNECT_DELAYS_MS = [250, 500, 1000, 2000, 4000] as const
 const MAX_RETRIES = RECONNECT_DELAYS_MS.length
 

package/tmp/screenshots-workspace/.kanban/.active-card.json

@@ -0,0 +1,5 @@
+{
+  "cardId": "1",
+  "boardId": "default",
+  "updatedAt": "2026-03-26T00:54:58.370Z"
+}

package/tmp/screenshots-workspace/.kanban/boards/default/deleted/1-dddd.md

@@ -0,0 +1,17 @@
+---
+version: 1
+id: "1"
+status: "deleted"
+priority: "medium"
+assignee: null
+dueDate: null
+created: "2026-03-26T00:54:50.866Z"
+modified: "2026-03-26T00:55:04.504Z"
+completedAt: null
+labels: []
+attachments:
+  - "1.log"
+order: "a0"
+---
+
+# dddd

package/tmp/screenshots-workspace/.kanban/boards/default/deleted/attachments/1.log

@@ -0,0 +1 @@
+2026-03-26T00:55:04.503Z [system] Status changed: `in-progress` → `deleted` {"previousStatus":"in-progress","status":"deleted","activity":{"type":"card.status.changed","qualifiesForUnread":true}}

package/tmp/screenshots-workspace/.kanban.json

@@ -0,0 +1,59 @@
+{
+  "version": 2,
+  "boards": {
+    "default": {
+      "name": "Default",
+      "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"
+        }
+      ],
+      "nextCardId": 1,
+      "defaultStatus": "backlog",
+      "defaultPriority": "medium"
+    }
+  },
+  "defaultBoard": "default",
+  "kanbanDirectory": ".kanban",
+  "aiAgent": "claude",
+  "defaultPriority": "medium",
+  "defaultStatus": "backlog",
+  "nextCardId": 2,
+  "showPriorityBadges": true,
+  "showAssignee": true,
+  "showDueDate": true,
+  "showLabels": true,
+  "showBuildWithAI": true,
+  "showFileName": false,
+  "compactMode": false,
+  "markdownEditorMode": false,
+  "showDeletedColumn": false,
+  "boardZoom": 100,
+  "cardZoom": 100,
+  "boardBackgroundMode": "fancy",
+  "boardBackgroundPreset": "aurora",
+  "port": 2954,
+  "labels": {}
+}