@goodandready/dsh-kanban 0.2.28 → 0.2.30

package/lib/config.js

@@ -107,7 +107,7 @@ export const CONFIG_HINTS = {
   progressDumpEnabled: 'Enable PROGRESSDUMP state checkpoints between agent sessions.',
   permissionGateEnabled: 'Require human confirmation before launching elevated permission tasks.',
   sessionDefaultPermission: 'Default permission tier for task sessions (read-only, workspace-write, danger-full-access).',
-  announceToAgent: 'Post stage change announcement messages directly into task agent session.',
+  announceToAgent: 'Inject board instructions and handover guidance into the agent system prompt.',
   maxConcurrentSessions: 'Maximum number of simultaneous active agent sessions on the board.',
   workspaceClaimBoundaries: 'Enforce workspace ownership boundaries to prevent cross-workspace task execution.',
   autoSyncSessions: 'Automatically sync and attach live background agent sessions to cards.',
@@ -178,3 +178,26 @@ export function columnNamesOf(config) {
   }
   return out
 }
+
+/**
+ * Build prompt section text based on enabled board features.
+ * Returns null if no features requiring agent guidance are active.
+ *
+ * @param {object} cfg configuration
+ * @returns {string|null}
+ */
+export function buildPromptSectionText(cfg) {
+  if (cfg?.announceToAgent === false) return null
+  const parts = []
+  if (cfg?.boardToolEnabled === true) {
+    parts.push(
+      'The dsh-kanban task board is available in the system. When working on tasks, you can move cards using the board_move tool and manage the plan checklist via board_plan.'
+    )
+  }
+  if (cfg?.progressDumpEnabled === true) {
+    parts.push(
+      'When context is running low or a milestone is reached, output a <<<PROGRESSDUMP\nGoal: ...\nProgress: ...\nNext steps: ...\n>>>PROGRESSDUMP block to hand over to the next session.'
+    )
+  }
+  return parts.length > 0 ? parts.join(' ') : null
+}

package/lib/index.js

@@ -12,6 +12,8 @@ import { registerPluginUpdater } from './updater.js'
 import {
   MAX_BODY_BYTES,
   isTrustedRequest,
+  rejectUntrustedRequest,
+  getRejectionStatus,
   parseTaskPath,
   buildBoard,
   applyMove,
@@ -94,12 +96,13 @@ import {
   withDefaults,
   CONFIG_DEFAULTS,
   CONFIG_HINTS,
+  buildPromptSectionText,
   rootOf,
 } from './config.js'
 import { eventHub } from './events.js'
 import { TASK_TEMPLATES, getTemplateById } from './templates.js'
 
-export { COLUMN_ORDER, wipLimitField, withDefaults } from './config.js'
+export { COLUMN_ORDER, buildPromptSectionText, wipLimitField, withDefaults } from './config.js'
 
 /** Stable cordis plugin name (patch identifier). */
 export const name = '@goodandready/dsh-kanban'
@@ -370,12 +373,13 @@ export function apply(ctx, config) {
     }
     const cfg = getConfig()
     const sp = ctx.get('systemPrompt')
-    if (cfg.announceToAgent !== false && sp && typeof sp.section === 'function') {
+    const promptText = buildPromptSectionText(cfg)
+    if (promptText && sp && typeof sp.section === 'function') {
       try {
         disposePromptSection = sp.section({
           name: 'plugin:dsh-kanban',
           order: 200,
-          text: 'The dsh-kanban task board is available in the system. When working on tasks, you can move cards using the board_move tool and manage the plan checklist via board_plan. When context is running low or a milestone is reached, output a <<<PROGRESSDUMP\nGoal: ...\nProgress: ...\nNext steps: ...\n>>>PROGRESSDUMP block to hand over to the next session.',
+          text: promptText,
         })
       } catch (err) {
         ctx.logger?.warn?.(`dsh-kanban: failed to register system prompt section: ${err?.message}`)
@@ -632,12 +636,36 @@ export function apply(ctx, config) {
     return () => { rearmers.delete(arm); clearInterval(timer) }
   }, 'dsh-kanban: sync timer')
 
+  const resolveConnection = () => {
+    try {
+      if (ctx && typeof ctx.get === 'function') {
+        const c = ctx.get('connection')
+        if (c) return c
+      }
+    } catch { /* ignore */ }
+    try {
+      if (ctx && ctx.connection) {
+        return ctx.connection
+      }
+    } catch { /* ignore */ }
+    return undefined
+  }
+
+  const routeOptions = () => ({
+    get connection() {
+      return resolveConnection()
+    },
+  })
+
+  const isTrusted = (req) => isTrustedRequest(req, routeOptions())
+  const rejectUntrusted = (req, res) => rejectUntrustedRequest(req, res, routeOptions())
+
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
     path: '/dsh-kanban/project-task',
     handler: async (req, res) => {
       if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       try {
         const input = await readBody(req)
         reply(res, await createProjectTask({
@@ -659,7 +687,7 @@ export function apply(ctx, config) {
     // Both services are optional in minimal environments. Empty lists render gracefully.
     handler: async (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const presets = ctx.get('agentPresets')
       const permissions = ctx.get('permissionPresets')
       let agentPresets = []
@@ -696,7 +724,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/sessions',
     handler: (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       reply(res, { sessions: liveSessions({ store, agents: ctx.agents }) })
     },
   }), 'dsh-kanban: live sessions')
@@ -706,7 +734,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/batch',
     handler: async (req, res) => {
       if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       try {
         const input = await readBody(req)
         const ids = Array.isArray(input.ids) ? input.ids : []
@@ -738,7 +766,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/archive',
     handler: (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       reply(res, listArchive({ store }))
     },
   }), 'dsh-kanban: archive')
@@ -748,7 +776,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/sync',
     handler: async (req, res) => {
       if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       try {
         writeJson(res, 200, await runSync())
       } catch (error) {
@@ -844,7 +872,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/board',
     handler: (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const url = urlOf(req)
       reply(res, buildBoard({
         store,
@@ -879,7 +907,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/metrics',
     handler: (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const url = urlOf(req)
       const days = Number(url.searchParams.get('staleDays'))
       reply(res, boardMetrics({
@@ -896,7 +924,7 @@ export function apply(ctx, config) {
     // Empty login indicates unconfigured or unreachable Gitea; client omits "Mine" filter.
     handler: async (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       reply(res, { login: await whoAmI() })
     },
   }), 'dsh-kanban: whoami')
@@ -906,7 +934,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/export.csv',
     handler: async (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const u = urlOf(req)
       const board = u.searchParams.get('board') || 'main'
       const csv = exportTasksCsv({ store, board })
@@ -923,7 +951,7 @@ export function apply(ctx, config) {
     kind: 'exact',
     path: '/dsh-kanban/events',
     handler: (req, res) => {
-      eventHub.handleSseRequest(req, res, { isTrustedRequest })
+      eventHub.handleSseRequest(req, res, { isTrustedRequest: isTrusted })
     },
   }), 'dsh-kanban: sse events stream')
 
@@ -939,7 +967,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/templates',
     handler: (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const u = new URL(req.url, 'http://localhost')
       const tid = u.searchParams.get('id')
       if (tid) {
@@ -956,7 +984,7 @@ export function apply(ctx, config) {
     kind: 'exact',
     path: '/dsh-kanban/snapshot',
     handler: async (req, res) => {
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       if (req.method === 'GET') { reply(res, exportBoard({ store })); return }
       if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
       try {
@@ -982,7 +1010,7 @@ export function apply(ctx, config) {
       // Path without ID handles local task creation.
       if (pathname === '/dsh-kanban/task' || pathname === '/dsh-kanban/task/') {
         if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-        if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+        if (rejectUntrusted(req, res)) return
         try {
           const resObj = createTask({ store, input: await readBody(req) })
           if (resObj?.task) {
@@ -999,7 +1027,7 @@ export function apply(ctx, config) {
       if (parsed === undefined) { writeJson(res, 404, { error: 'not-found' }); return }
       const { id, action } = parsed
 
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
 
       if (req.method === 'GET' && action === 'log') { reply(res, taskLog({ store, id })); return }
       if (req.method === 'GET' && action === 'body') { reply(res, taskBody({ store, id })); return }
@@ -1391,7 +1419,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/gitea/repos',
     handler: async (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const url = urlOf(req)
       reply(res, await searchRepos({ gitea: git, query: url.searchParams.get('q') || '' }))
     },
@@ -1402,7 +1430,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/gitea/issues',
     handler: async (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const url = urlOf(req)
       reply(res, await listImportable({
         gitea: git,
@@ -1419,7 +1447,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/import',
     handler: async (req, res) => {
       if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       try {
         const input = await readBody(req)
         reply(res, await importIssue({
@@ -1440,7 +1468,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/models',
     handler: async (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const current = ctx.get('agentDefaultModel')?.currentSelection?.() ?? null
       const llmService = ctx.get('llm')
       let providers = []
@@ -1469,7 +1497,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/session',
     handler: (req, res) => {
       if (req.method !== 'GET') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
-      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      if (rejectUntrusted(req, res)) return
       const m = /^\/dsh-kanban\/session\/([^/]+)\/task\/?$/.exec(urlOf(req).pathname)
       if (m === null) { writeJson(res, 404, { error: 'not-found' }); return }
       reply(res, taskBySession({ store, sessionId: decodeURIComponent(m[1]), agents: ctx.agents }))

package/lib/routes.js

@@ -57,40 +57,75 @@ export function isTrustedHost(host) {
   return false
 }
 
+export function getClientIp(req) {
+  return (
+    req?.socket?.remoteAddress ||
+    req?.connection?.remoteAddress ||
+    req?.info?.remoteAddress ||
+    ''
+  )
+}
+
 /**
- * Cross-site request and DNS rebinding validation (#261, #369).
- * Endpoints reject cross-site and DNS-rebinding requests:
- * 1. Host header is required and must target a trusted host (loopback, LAN, .local).
- * 2. Origin/Referer (if present) must target a trusted host and match Host header.
- * 3. Safe sec-fetch-site ('same-origin', 'same-site', 'none').
- * 4. Loopback or private LAN remoteAddress.
+ * Cross-site request, DNS rebinding, and authentication validation (#261, #369, #384).
+ *
+ * Requirements:
+ * 1. If DSH connection service is available (options.connection), requestRejection(req)
+ *    is the authoritative gate for browser session authentication and trusted network access.
+ *    If rejection is returned, the numeric status (e.g. 401 or 403) is returned.
+ * 2. Host header is required and must target a trusted host (loopback, LAN, .local).
+ * 3. Cross-site requests ('sec-fetch-site: cross-site' or origin mismatch) are rejected with 403.
+ * 4. Origin & Referer headers (if present) must match Host or a trusted host.
+ * 5. Network boundary validation:
+ *    - Loopback callers (127.0.0.1, ::1) are allowed.
+ *    - Non-loopback / LAN callers require valid connection authentication (fail-closed, return 401).
+ *    - Unknown remote address (socket present but empty remoteAddress) fails closed with 403.
+ *
+ * @param {import('node:http').IncomingMessage} req
+ * @param {{ connection?: { requestRejection?: (req: any) => number | undefined } }} [options]
+ * @returns {number|undefined} Rejection HTTP status code (401, 403), or undefined if allowed.
  */
-export function isTrustedRequest(req) {
-  if (!req || !req.headers) return false
+export function getRejectionStatus(req, options = {}) {
+  const connection = options?.connection
+  if (connection && typeof connection.requestRejection === 'function') {
+    try {
+      const rejection = connection.requestRejection(req)
+      if (rejection !== undefined) {
+        if (typeof rejection === 'number' && Number.isInteger(rejection) && rejection >= 400 && rejection < 600) {
+          return rejection
+        }
+        return rejection === 401 ? 401 : 403
+      }
+    } catch {
+      // Fail closed if connection service throws
+      return 403
+    }
+  }
+
+  if (!req || !req.headers) return 403
 
   const host = req.headers.host
   if (!host || !isTrustedHost(host)) {
-    return false
+    return 403
   }
 
-  const remote = req.socket?.remoteAddress || req.connection?.remoteAddress
   const site = req.headers['sec-fetch-site']
 
   // 1. Explicit cross-site or same-site requests are rejected
   if (site === 'cross-site' || site === 'same-site') {
-    return false
+    return 403
   }
 
   // 2. Validate origin against trusted hosts and host header
   const origin = req.headers.origin
   if (origin !== undefined) {
-    if (origin === 'null' || !origin) return false
+    if (origin === 'null' || !origin) return 403
     try {
       const parsed = new URL(origin)
-      if (!isTrustedHost(parsed.hostname)) return false
-      if (parsed.host && parsed.host !== host) return false
+      if (!isTrustedHost(parsed.hostname)) return 403
+      if (parsed.host && parsed.host !== host) return 403
     } catch {
-      return false
+      return 403
     }
   }
 
@@ -99,36 +134,74 @@ export function isTrustedRequest(req) {
   if (referer !== undefined && referer) {
     try {
       const parsedRef = new URL(referer)
-      if (!isTrustedHost(parsedRef.hostname)) return false
-      if (parsedRef.host && parsedRef.host !== host) return false
+      if (!isTrustedHost(parsedRef.hostname)) return 403
+      if (parsedRef.host && parsedRef.host !== host) return 403
     } catch {
-      return false
+      return 403
     }
   }
 
-  // 4. Browser request with declared site:
-  // Must be same-origin or none (e.g. top-level navigation / bookmark / isolated subresource)
-  if (site === 'same-origin' || site === 'none') {
-    if (remote && !isLoopbackAddress(remote) && !isLanAddress(remote)) {
-      return false
+  // 4. Validate remote address and network boundary
+  const hasSocket = !!(req.socket || req.connection)
+  const remote = getClientIp(req)
+
+  if (hasSocket) {
+    if (!remote) {
+      return 403
+    }
+    if (!isLoopbackAddress(remote) && !isLanAddress(remote)) {
+      return 403
+    }
+    // Remote / LAN callers without connection authentication are rejected (#384)
+    if (!isLoopbackAddress(remote)) {
+      if (!connection) {
+        return 401
+      }
+    }
+  } else if (!connection) {
+    // Synthetic mock request without socket: allow loopback host for unit tests
+    const hostname = String(host).split(':')[0].toLowerCase()
+    if (!isLoopbackAddress(hostname) && hostname !== 'localhost') {
+      return 401
     }
-    return true
   }
 
-  // 5. Request without declared site:
-  // Allowed strictly for loopback remoteAddress (DSH Desktop Electron forwardWebRequest, local CLI, curl)
-  if (remote && isLoopbackAddress(remote)) {
-    return true
+  // 5. Browser request with declared site:
+  // Must be same-origin or none
+  if (site && site !== 'same-origin' && site !== 'none') {
+    return 403
   }
 
-  // 6. Fallback for test harnesses / mocks without socket where host header targets loopback
-  if (!remote && host) {
-    const hostName = String(host).split(':')[0]
-    if (isLoopbackAddress(hostName)) {
-      return true
-    }
+  // 6. Request without declared site from non-loopback requires connection
+  if (!site && remote && !isLoopbackAddress(remote) && !connection) {
+    return 401
   }
 
+  return undefined
+}
+
+export function isTrustedRequest(req, options = {}) {
+  return getRejectionStatus(req, options) === undefined
+}
+
+export function rejectUntrustedRequest(req, res, options = {}) {
+  const status = getRejectionStatus(req, options)
+  if (status !== undefined) {
+    try {
+      res.writeHead(status, {
+        'Content-Type': 'application/json; charset=utf-8',
+        'Cache-Control': 'no-store',
+      })
+      res.end(
+        JSON.stringify({
+          error: status === 401 ? 'unauthorized' : 'cross-site',
+        })
+      )
+    } catch {
+      /* socket closed */
+    }
+    return true
+  }
   return false
 }
 

package/lib/updater.js

@@ -42,8 +42,20 @@ function isPrivateLan(value) {
   )
 }
 
-export function isTrustedUpdateRequest(request) {
+export function isTrustedUpdateRequest(request, targetCtx = null) {
   if (header(request, UPDATE_HEADER) !== '1') return false
+  const conn = (targetCtx && typeof targetCtx.get === 'function' ? targetCtx.get('connection') : null)
+    || targetCtx?.connection
+    || request?.connectionService
+  if (conn && typeof conn.requestRejection === 'function') {
+    let rejection
+    try {
+      rejection = conn.requestRejection(request)
+    } catch {
+      return false
+    }
+    if (rejection !== undefined) return false
+  }
   const remote = request.socket?.remoteAddress
   if (!isLoopback(remote) && !isPrivateLan(remote)) return false
   const site = header(request, 'sec-fetch-site')
@@ -300,7 +312,7 @@ export function registerPluginUpdater(ctx, options) {
           response.end()
           return
         }
-        if (!isTrustedUpdateRequest(request)) {
+        if (!isTrustedUpdateRequest(request, ctx)) {
           json(response, 403, { error: 'Rejected non-local or cross-origin update request.' })
           return
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "description": "Visual Kanban board for DeepSeek Harness: Gitea and GitHub-backed tasks, workflow columns, and a dedicated agent session per task.",
   "type": "module",
   "main": "lib/index.js",