@fonlan/dsh-task-kanban 0.1.0

package/src/client/locales.ts

@@ -0,0 +1,127 @@
+// Locale namespace = the plugin's cordis id (kebab). DSH flat namespace keys
+// (settings + locale) use the internal id `task-kanban`; the scoped npm package
+// name is reserved for package-bound identifiers (exported `name`, module-loader
+// id, the /plugins/<pkg>/… route base).
+export const LOCALE_NS = 'task-kanban'
+
+export const zh = {
+  kanban: '任务看板',
+  openBoard: '打开任务看板',
+  closeBoard: '返回对话',
+  newTask: '新建任务',
+  requirement: '需求',
+  project: '所属项目',
+  model: '模型',
+  cancel: '取消',
+  close: '关闭',
+  addAndRefine: '添加并细化',
+  laneDemand: '需求',
+  laneQueue: '队列',
+  laneRunning: '运行中',
+  laneCompleted: '已完成',
+  laneMerged: '已合并',
+  statusDraft: '未细化',
+  statusRefining: '细化中',
+  statusPlanned: '已规划',
+  statusQueued: '排队中',
+  statusRunning: '实现中',
+  statusCompleted: '已完成',
+  statusMerging: '合并中',
+  statusMerged: '已合并',
+  statusError: '出错',
+  phaseProgress: '{current}/{total}',
+  retry: '重试',
+  stop: '停止',
+  delete: '删除',
+  deleteConfirm: '确定删除该任务？其 worktree 会被清理。',
+  openSession: '打开会话',
+  plan: '实现方案',
+  summary: '摘要',
+  phases: '阶段',
+  error: '错误',
+  requirementLabel: '需求文本',
+  requirementPlaceholder: '描述你要实现的需求……',
+  modelPlaceholder: '（使用默认模型）',
+  noWorkspace: '没有可用工作区，请先在侧边栏添加',
+  refresh: '刷新',
+  settingsTitle: '任务看板设置',
+  maxParallelWorkers: '全局并行 worker 数',
+  defaultModel: '默认模型',
+  saved: '已保存',
+  loadError: '加载任务失败',
+  noPlan: '该卡片还没有实现计划，请先点击"添加并细化"',
+  dragNoPlan: '还没有实现计划的卡片不能进入队列',
+  actionFailed: '操作失败：{message}',
+  sessionNotListed: '该会话不在当前列表，可能来自其他工作区',
+  interrupted: '已中断',
+  noBaseBranch: '项目没有 main/master 分支',
+  worktreeFailed: 'worktree 创建失败',
+  refineFailed: '细化失败',
+  phaseFailed: '阶段执行失败',
+  mergeFailed: '合并失败',
+  createFailed: '创建失败',
+  refinementLabel: '需求细化',
+  mergeLabel: '合并',
+  commitLabel: '提交',
+}
+
+export const en = {
+  kanban: 'Task Kanban',
+  openBoard: 'Open Task Kanban',
+  closeBoard: 'Back to chat',
+  newTask: 'New Task',
+  requirement: 'Requirement',
+  project: 'Project',
+  model: 'Model',
+  cancel: 'Cancel',
+  close: 'Close',
+  addAndRefine: 'Add & Refine',
+  laneDemand: 'Demands',
+  laneQueue: 'Queue',
+  laneRunning: 'Running',
+  laneCompleted: 'Completed',
+  laneMerged: 'Merged',
+  statusDraft: 'Unrefined',
+  statusRefining: 'Refining',
+  statusPlanned: 'Planned',
+  statusQueued: 'Queued',
+  statusRunning: 'Running',
+  statusCompleted: 'Completed',
+  statusMerging: 'Merging',
+  statusMerged: 'Merged',
+  statusError: 'Error',
+  phaseProgress: '{current}/{total}',
+  retry: 'Retry',
+  stop: 'Stop',
+  delete: 'Delete',
+  deleteConfirm: 'Delete this task? Its worktree will be cleaned up.',
+  openSession: 'Open session',
+  plan: 'Plan',
+  summary: 'Summary',
+  phases: 'Phases',
+  error: 'Error',
+  requirementLabel: 'Requirement',
+  requirementPlaceholder: 'Describe what you want to build…',
+  modelPlaceholder: '(use default model)',
+  noWorkspace: 'No workspaces available — add one in the sidebar first',
+  refresh: 'Refresh',
+  settingsTitle: 'Task Kanban Settings',
+  maxParallelWorkers: 'Global parallel workers',
+  defaultModel: 'Default model',
+  saved: 'Saved',
+  loadError: 'Failed to load tasks',
+  noPlan: 'This card has no plan yet — click "Add & Refine" first',
+  dragNoPlan: 'Cards without a plan cannot enter the queue',
+  actionFailed: 'Action failed: {message}',
+  sessionNotListed: 'Session is not listed here; it may belong to another workspace',
+  interrupted: 'Interrupted',
+  noBaseBranch: 'Project has no main/master branch',
+  worktreeFailed: 'Worktree creation failed',
+  refineFailed: 'Refinement failed',
+  phaseFailed: 'Phase failed',
+  mergeFailed: 'Merge failed',
+  createFailed: 'Creation failed',
+  refinementLabel: 'Refinement',
+  mergeLabel: 'Merge',
+  commitLabel: 'Commit',
+}

package/src/client/sections.tsx

@@ -0,0 +1,209 @@
+import { useEffect, useRef, useState } from 'react'
+import { IconChecklistOutline14 } from '@deepseek-ai/dsh-client-ui-primitives'
+import { api } from './api'
+import { toggleBoard, useBoardOpen } from './kanban-state'
+import type { KanbanSettingsShape } from '../shared/card'
+
+interface FooterActionProps {
+  wide?: boolean
+  t?: (key: string) => string
+}
+
+/** Sidebar footer entry: toggles the kanban board main view.
+ *  The shell renders footer actions on their own row ABOVE the settings row,
+ *  so the button is reparented into the settings area to sit on the same
+ *  line, right of the Settings trigger (see board.css .kb-settings-row). */
+export function KanbanFooterButton({ wide, t }: FooterActionProps): JSX.Element {
+  const open = useBoardOpen()
+  const ref = useRef<HTMLButtonElement | null>(null)
+  const label = t !== undefined ? t(open ? 'closeBoard' : 'openBoard') : 'Task Kanban'
+
+  useEffect(() => {
+    const btn = ref.current
+    if (btn === null) return
+    let foot: Element | null = null
+    let disposed = false
+
+    // Locate the sidebar foot area WITHOUT moving any DOM: it is the ancestor
+    // of the button whose LAST child contains the settings trigger and which
+    // is itself the last child of its parent (root > footArea > settingsArea).
+    // The slot machinery wraps entries in an anonymous div, so the search
+    // tolerates extra wrapper levels. Styling is pure CSS (see board.css
+    // .kb-foot-row), so a failed lookup only leaves the button in its natural
+    // slot row — it can never vanish.
+    const findFoot = (): Element | null => {
+      let el: Element | null = btn.parentElement
+      while (el !== null && el !== document.body && el.parentElement !== null) {
+        const last = el.lastElementChild
+        const hasTrigger =
+          last !== null &&
+          (last.querySelector?.('button[aria-haspopup="dialog"]') !== null ||
+            last.querySelector?.('button[aria-haspopup="menu"]') !== null)
+        const isLastChild = el.parentElement.lastElementChild === el
+        if (hasTrigger && isLastChild) return el
+        el = el.parentElement
+      }
+      return null
+    }
+
+    const tryApply = (): boolean => {
+      if (foot === null) {
+        try {
+          foot = findFoot()
+        } catch {
+          foot = null
+        }
+      }
+      if (foot === null) return false
+      try {
+        foot.classList.add('kb-foot-row')
+        foot.classList.toggle('kb-foot-rail', wide !== true)
+      } catch {
+        // element already gone; retry will re-locate
+      }
+      return true
+    }
+
+    let applied = false
+    try {
+      applied = tryApply()
+    } catch (error) {
+      console.error('[@fonlan/dsh-task-kanban] foot placement error:', error)
+    }
+    if (!applied) {
+      // The settings entry may mount later than this entry (plugin load
+      // order); retry on DOM mutations AND on a short interval until the
+      // foot area is found (give up after 15s).
+      const observer = new MutationObserver(() => {
+        if (disposed) return
+        if (tryApply()) observer.disconnect()
+      })
+      observer.observe(document.body, { childList: true, subtree: true })
+      const timer = window.setInterval(() => {
+        if (disposed) {
+          window.clearInterval(timer)
+          return
+        }
+        if (tryApply()) {
+          observer.disconnect()
+          window.clearInterval(timer)
+        }
+      }, 1000)
+      window.setTimeout(() => {
+        observer.disconnect()
+        window.clearInterval(timer)
+        if (foot === null) {
+          // report the DOM chain so the next report carries evidence
+          const chain: string[] = []
+          let el: Element | null = btn.parentElement
+          while (el !== null && chain.length < 8) {
+            chain.push(el.tagName + '.' + String(el.className).slice(0, 60))
+            el = el.parentElement
+          }
+          console.warn('[@fonlan/dsh-task-kanban] could not locate the sidebar foot area:', chain)
+        }
+      }, 15000)
+      return () => {
+        disposed = true
+        observer.disconnect()
+        window.clearInterval(timer)
+        try {
+          foot?.classList.remove('kb-foot-row')
+          foot?.classList.remove('kb-foot-rail')
+        } catch {
+          // already gone
+        }
+      }
+    }
+    return () => {
+      try {
+        foot?.classList.remove('kb-foot-row')
+        foot?.classList.remove('kb-foot-rail')
+      } catch {
+        // already gone
+      }
+    }
+  }, [wide])
+
+  return (
+    <button
+      ref={ref}
+      type="button"
+      className={'kb-footer-action' + (wide === true ? ' kb-footer-action-wide' : '') + (open ? ' kb-footer-action-active' : '')}
+      aria-label={label}
+      title={label}
+      onClick={() => toggleBoard()}
+    >
+      <IconChecklistOutline14 size={wide === true ? 16 : 18} />
+      {wide === true && <span className="kb-footer-label">{t !== undefined ? t('kanban') : 'Kanban'}</span>}
+    </button>
+  )
+}
+
+interface SettingsSectionProps {
+  t?: (key: string) => string
+}
+
+/** Plugin settings section: global parallel workers + default model. */
+export function KanbanSettingsSection({ t }: SettingsSectionProps): JSX.Element {
+  const tr = t ?? ((key: string) => key)
+  const [settings, setSettings] = useState<KanbanSettingsShape>({ maxParallelWorkers: 1, defaultModel: '' })
+  const [models, setModels] = useState<Array<{ provider: string; id: string; name?: string }>>([])
+  const [saved, setSaved] = useState(false)
+
+  useEffect(() => {
+    let alive = true
+    api.settingsGet()
+      .then((s) => { if (alive) setSettings(s) })
+      .catch(() => undefined)
+    api.models()
+      .then((list) => { if (alive) setModels(list) })
+      .catch(() => undefined)
+    return () => { alive = false }
+  }, [])
+
+  const commit = async (patch: Partial<KanbanSettingsShape>): Promise<void> => {
+    try {
+      const next = await api.settingsSet(patch)
+      setSettings(next)
+      setSaved(true)
+      window.setTimeout(() => setSaved(false), 1500)
+    } catch {
+      // keep the previous value
+    }
+  }
+
+  return (
+    <div className="kb-settings">
+      <label className="kb-field kb-field-row">
+        <span>{tr('maxParallelWorkers')}</span>
+        <input
+          className="kb-input kb-input-number"
+          type="number"
+          min={1}
+          step={1}
+          value={settings.maxParallelWorkers}
+          onChange={(e) => {
+            const value = Math.max(1, Math.floor(Number(e.target.value) || 1))
+            setSettings((s) => ({ ...s, maxParallelWorkers: value }))
+            void commit({ maxParallelWorkers: value })
+          }}
+        />
+      </label>
+      <label className="kb-field kb-field-row">
+        <span>{tr('defaultModel')}</span>
+        <select
+          className="kb-input"
+          value={settings.defaultModel}
+          onChange={(e) => { void commit({ defaultModel: e.target.value }) }}
+        >
+          <option value="">—</option>
+          {models.map((m) => (
+            <option key={m.provider + '/' + m.id} value={m.id}>{m.name ?? m.id}</option>
+          ))}
+        </select>
+      </label>
+      {saved && <div className="kb-settings-saved">{tr('saved')}</div>}
+    </div>
+  )
+}

package/src/client/slot-augment.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Declare this plugin's locale namespace so slot registrations can type-check
+ * the `locale` seat and receive the typed `t` prop. zh is the key source
+ * of truth; en must carry the exact same key set (checked at runtime by the
+ * locale registry).
+ */
+import type { zh } from './locales'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    'task-kanban': keyof typeof zh
+  }
+}
+
+export {}

package/src/index.ts

@@ -0,0 +1,34 @@
+/**
+ * @fonlan/dsh-task-kanban host half: the task kanban engine.
+ *
+ * Mounts a file-backed task store under each workspace's
+ * `.dsh/task-kanban/`, runs refinement/phase/merge sessions through
+ * `ctx.agents` (standard coding-agent preset + kanban-scoped tools), and
+ * serves the fenced JSON API the board UI calls.
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import z from '@deepseek-ai/schemastery'
+import { registerSettings } from './server/settings.js'
+import { TaskStore } from './server/task-store.js'
+import { KanbanRunner } from './server/runner.js'
+import { registerApiRoutes } from './server/rpc.js'
+
+export const name = '@fonlan/dsh-task-kanban'
+
+export const inject = ['webServer', 'agents']
+
+export const Config = z.object({})
+
+export function apply(ctx: Context, _config: unknown): void {
+  const settings = registerSettings(ctx)
+  const store = new TaskStore()
+  const runner = new KanbanRunner(ctx, store, settings)
+
+  ctx.effect(() => {
+    void runner.recoverInterrupted()
+    runner.start()
+    return () => runner.stop()
+  }, 'task-kanban: runner lifecycle')
+
+  ctx.effect(() => registerApiRoutes(ctx, runner, settings), 'task-kanban: api routes')
+}

package/src/server/git.ts

@@ -0,0 +1,68 @@
+/** Thin typed wrapper over the git CLI (all merge/web-tree flow runs here). */
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+
+const execFileAsync = promisify(execFile)
+
+export interface GitResult {
+  code: number
+  stdout: string
+  stderr: string
+}
+
+export async function runGit(cwd: string, args: string[]): Promise<GitResult> {
+  try {
+    const { stdout, stderr } = await execFileAsync('git', args, { cwd, maxBuffer: 128 * 1024 * 1024, timeout: 600000 })
+    return { code: 0, stdout: String(stdout), stderr: String(stderr) }
+  } catch (error: unknown) {
+    const e = error as { code?: number | string; stdout?: string | Buffer; stderr?: string | Buffer }
+    return {
+      code: typeof e.code === 'number' ? e.code : 1,
+      stdout: e.stdout !== undefined ? String(e.stdout) : '',
+      stderr: e.stderr !== undefined ? String(e.stderr) : String(error),
+    }
+  }
+}
+
+export async function isGitRepo(dir: string): Promise<boolean> {
+  const r = await runGit(dir, ['rev-parse', '--is-inside-work-tree'])
+  return r.code === 0 && r.stdout.trim() === 'true'
+}
+
+export async function hasBranch(dir: string, name: string): Promise<boolean> {
+  const r = await runGit(dir, ['rev-parse', '--verify', `refs/heads/${name}`])
+  return r.code === 0
+}
+
+export async function detectBaseRef(dir: string): Promise<string | undefined> {
+  if (await hasBranch(dir, 'main')) return 'main'
+  if (await hasBranch(dir, 'master')) return 'master'
+  return undefined
+}
+
+export async function currentBranch(dir: string): Promise<string | undefined> {
+  const r = await runGit(dir, ['symbolic-ref', '--short', 'HEAD'])
+  return r.code === 0 && r.stdout.trim() !== '' ? r.stdout.trim() : undefined
+}
+
+export async function revParse(dir: string, ref: string): Promise<string | undefined> {
+  const r = await runGit(dir, ['rev-parse', ref])
+  return r.code === 0 ? r.stdout.trim() : undefined
+}
+
+/** True when the working tree has tracked changes (staged or unstaged). */
+export async function isTreeDirty(dir: string): Promise<boolean> {
+  const r = await runGit(dir, ['status', '--porcelain', '--untracked-files=no'])
+  return r.code === 0 && r.stdout.trim() !== ''
+}
+
+export async function hasStashMessage(dir: string, message: string): Promise<boolean> {
+  const r = await runGit(dir, ['stash', 'list'])
+  return r.code === 0 && r.stdout.includes(message)
+}
+
+/** Unmerged path list after a conflicted merge (empty when clean). */
+export async function unmergedPaths(dir: string): Promise<string> {
+  const r = await runGit(dir, ['diff', '--name-only', '--diff-filter=U'])
+  return r.code === 0 ? r.stdout.trim() : ''
+}

package/src/server/models.ts

@@ -0,0 +1,20 @@
+import type { Context } from '@deepseek-ai/cordis'
+import type { ModelOption } from '../shared/card.js'
+
+/** Available models from every registered LLM provider (advisory catalog). */
+export async function listModels(ctx: Context): Promise<ModelOption[]> {
+  const llm = ctx.get('llm') as
+    | { listProviders(): Array<{ id: string; name?: string }>; listModels(provider: string): Promise<Array<{ id: string; name?: string }>> }
+    | undefined
+  if (llm === undefined) return []
+  const out: ModelOption[] = []
+  for (const provider of llm.listProviders()) {
+    try {
+      const models = await llm.listModels(provider.id)
+      for (const m of models) out.push({ provider: provider.id, id: m.id, name: m.name ?? m.id })
+    } catch {
+      // provider without a model catalog: skip
+    }
+  }
+  return out
+}

package/src/server/prompts.ts

@@ -0,0 +1,54 @@
+import type { KanbanCard } from '../shared/card.js'
+
+/** Refinement session prompt: analyze the repo read-only and write back a plan. */
+export function refinementPrompt(requirement: string, workspacePath: string): string {
+  return `你是一个需求分析师。请分析下面的需求，并为它在指定项目中的实现制定一个可执行的分阶段实现计划。
+
+【需求】
+${requirement}
+
+【项目目录】
+${workspacePath}
+
+【要求】
+1. 先浏览项目目录了解现状（阅读 README、关键源码与文档；本会话只做只读探索，不要修改任何文件）。
+2. 把需求拆解为按顺序串行执行的实现阶段（phase）。简单需求 1 个 phase 即可；复杂需求拆多个 phase，每个 phase 必须是独立的、可串行执行的实现单元，后面的 phase 依赖前面 phase 的产出。
+3. 每个 phase 必须包含：id（如 p1/p2/p3）、标题、目标（goal，说明该 phase 要交付什么）。
+4. 完成后调用 kanban_write_plan 工具把完整计划写回（title、summary、phases）。这是唯一写回方式，不要把计划 JSON 直接输出到对话里。
+5. 不要向用户提问，自主决策。`
+}
+
+/** Phase implementation session prompt; identical on retries (the model reads git status/diff itself). */
+export function phasePrompt(card: KanbanCard, phaseIndex: number, workdir: string): string {
+  const plan = card.plan!
+  const phase = plan.phases[phaseIndex]
+  return `你是一个软件实现工程师。请实现下面计划中的第 ${phaseIndex + 1}/${plan.phases.length} 个 phase。你的工作目录是 ${workdir}，只允许在这个目录内工作。
+
+【完整实现计划】
+${JSON.stringify(plan, null, 2)}
+
+【当前 phase】
+id: ${phase.id}
+标题: ${phase.title}
+目标: ${phase.goal}
+
+【要求】
+1. 先查看工作目录现状（git status、目录与文件结构、已有代码），判断此前已完成的工作，然后实现当前 phase 的目标。如果这是一次重试/续跑，请先搞清楚现场再继续。
+2. 只做当前 phase 范围内的实现；后续 phase 由其他会话完成。不要进入 plan mode。
+3. 禁止执行 git commit / git push / git merge / git rebase / git stash / git reset（提交与合并由外部系统负责）；允许 git status / git diff 等只读命令。
+4. 不要向用户提问，自主决策；不要调用 kanban_write_plan。
+5. 完成后必须调用 kanban_phase_complete 工具，并在 summary 中简要说明本 phase 完成了什么。只有显式调用该工具才算完成。`
+}
+
+/** Merge-conflict resolution session prompt: resolve conflicts only, never commit. */
+export function mergePrompt(workdir: string, conflicts: string): string {
+  return `你是一个 git 合并冲突解决专家。目录 ${workdir} 中存在合并冲突，请逐个解决。
+
+【冲突文件】
+${conflicts}
+
+【要求】
+1. 逐个查看冲突文件（阅读文件内容、git diff），手动解决所有冲突标记（<<<<<<<、=======、>>>>>>>）。
+2. 只修改冲突文件以解决冲突，不要做任何无关改动；不要执行 git commit / git add / git merge / git stash。
+3. 解决完成后调用 kanban_merge_resolved 工具声明完成（可附简短说明）。`
+}