@goodandready/dsh-kanban 0.2.28 → 0.2.29

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

@@ -94,12 +94,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 +371,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}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "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",