@goodandready/dsh-kanban 0.2.35 → 0.2.37

package/lib/pr-generator.js

@@ -0,0 +1,270 @@
+// Pull Request description and release notes generator (#379).
+// Zero Cyrillic literals in lib/ per Issue #366.
+
+import { inferScope } from './plan-generator.js'
+
+/**
+ * Parse one-line git log output into structured commit records.
+ *
+ * @param {string} logText Raw git log output
+ * @returns {Array<{ sha: string, message: string }>}
+ */
+export function parseGitLog(logText) {
+  if (typeof logText !== 'string' || !logText.trim()) return []
+  const lines = logText.trim().split('\n')
+  const commits = []
+
+  for (const line of lines) {
+    const trimmed = line.trim()
+    if (!trimmed) continue
+
+    // Tab-delimited (git log --pretty=format:%h%x09%s) or space-delimited
+    let sha = ''
+    let message = ''
+    if (trimmed.includes('\t')) {
+      const parts = trimmed.split('\t')
+      sha = parts[0].trim()
+      message = parts.slice(1).join('\t').trim()
+    } else {
+      const match = trimmed.match(/^([a-f0-9]{7,40})\s+(.+)$/i)
+      if (match) {
+        sha = match[1]
+        message = match[2].trim()
+      } else {
+        message = trimmed
+      }
+    }
+
+    if (sha || message) {
+      commits.push({ sha, message })
+    }
+  }
+
+  return commits
+}
+
+/**
+ * Parse git diff --stat output into structured file and line counts.
+ *
+ * @param {string} statText Raw git diff --stat output
+ * @returns {{ filesChanged: number, additions: number, deletions: number, files: Array<{ path: string, changes: string }> }}
+ */
+export function parseDiffStat(statText) {
+  if (typeof statText !== 'string' || !statText.trim()) {
+    return { filesChanged: 0, additions: 0, deletions: 0, files: [] }
+  }
+
+  const lines = statText.trim().split('\n')
+  const files = []
+  let filesChanged = 0
+  let additions = 0
+  let deletions = 0
+
+  for (const line of lines) {
+    const trimmed = line.trim()
+    if (!trimmed) continue
+
+    // Summary line: "3 files changed, 45 insertions(+), 12 deletions(-)"
+    const summaryMatch = trimmed.match(/(\d+)\s+files?\s+changed(?:,\s+(\d+)\s+insertions?\(\+\))?(?:,\s+(\d+)\s+deletions?\(-\))?/)
+    if (summaryMatch) {
+      filesChanged = parseInt(summaryMatch[1], 10) || 0
+      additions = parseInt(summaryMatch[2], 10) || 0
+      deletions = parseInt(summaryMatch[3], 10) || 0
+      continue
+    }
+
+    // File line: "lib/client.js | 14 +++++++-------"
+    const fileMatch = trimmed.match(/^(.+?)\s+\|\s+(\d+)\s*(.*)$/)
+    if (fileMatch) {
+      files.push({
+        path: fileMatch[1].trim(),
+        changes: fileMatch[2].trim(),
+      })
+    }
+  }
+
+  if (filesChanged === 0 && files.length > 0) {
+    filesChanged = files.length
+  }
+
+  return { filesChanged, additions, deletions, files }
+}
+
+/**
+ * Infer conventional commit / PR type (feat, fix, refactor, perf, docs, chore).
+ *
+ * @param {object} task Task object
+ * @param {Array<{ sha: string, message: string }>} [commits]
+ * @returns {string} PR type
+ */
+export function inferPrType(task, commits = []) {
+  const title = String(task?.title ?? '').toLowerCase()
+  const labels = Array.isArray(task?.labels) ? task.labels.map((l) => String(l).toLowerCase()) : []
+
+  for (const label of labels) {
+    if (label.startsWith('type/')) {
+      const t = label.slice(5)
+      if (t === 'bug') return 'fix'
+      if (t === 'feature') return 'feat'
+      return t
+    }
+  }
+
+  if (title.startsWith('fix:') || title.includes('fix') || title.includes('bug')) return 'fix'
+  if (title.startsWith('refactor:') || title.includes('refactor')) return 'refactor'
+  if (title.startsWith('perf:') || title.includes('performance')) return 'perf'
+  if (title.startsWith('docs:') || title.includes('document')) return 'docs'
+  if (title.startsWith('chore:') || title.includes('cleanup')) return 'chore'
+
+  for (const c of commits) {
+    const msg = String(c?.message ?? '').toLowerCase()
+    if (msg.startsWith('fix')) return 'fix'
+    if (msg.startsWith('refactor')) return 'refactor'
+    if (msg.startsWith('perf')) return 'perf'
+  }
+
+  return 'feat'
+}
+
+/**
+ * Generate canonical PR title according to conventional commits format.
+ *
+ * @param {object} task Task object
+ * @param {Array<{ sha: string, message: string }>} [commits]
+ * @returns {string} PR title
+ */
+export function generatePrTitle(task, commits = []) {
+  const type = inferPrType(task, commits)
+  const scope = inferScope(task)
+  let cleanTitle = String(task?.title ?? '').trim()
+
+  // Strip leading prefixes like "L: Feature:", "M: Fix:", "feat:", etc.
+  cleanTitle = cleanTitle.replace(/^[A-Z]:\s*(Feature|Bug|Fix|Refactor|Task):\s*/i, '')
+  cleanTitle = cleanTitle.replace(/^(feat|fix|refactor|perf|docs|chore)(\([^)]+\))?:\s*/i, '')
+
+  const issueNum = typeof task?.issueNumber === 'number' ? task.issueNumber : null
+  const issueRef = issueNum ? ` (#${issueNum})` : ''
+
+  return `${type}(${scope}): ${cleanTitle}${issueRef}`
+}
+
+/**
+ * Generate canonical, structured Pull Request description markdown (#379).
+ *
+ * @param {object} params
+ * @param {object} params.task Task record
+ * @param {Array<{ sha: string, message: string }>} [params.commits]
+ * @param {object} [params.diffStats]
+ * @param {object} [params.verification]
+ * @returns {string} Complete Markdown description for PR
+ */
+export function generatePrDescription({ task, commits = [], diffStats = null, verification = null }) {
+  const title = String(task?.title ?? '').trim()
+  const body = String(task?.body ?? '').trim()
+  const issueNum = typeof task?.issueNumber === 'number' ? task.issueNumber : null
+  const issueRef = issueNum ? `Closes #${issueNum}` : ''
+
+  const lines = []
+
+  // 1. Problem statement
+  lines.push('### Problem')
+  if (body) {
+    lines.push(body)
+  } else {
+    lines.push(`Implementation required for: ${title}`)
+  }
+  lines.push('')
+
+  // 2. Solution description
+  lines.push('### Solution')
+  if (task?.spec) {
+    // Extract key sections or summary from spec if present
+    const specLines = task.spec.split('\n')
+    const solutionLines = specLines.filter((l) => !l.startsWith('# Technical Specification') && !l.startsWith('## 1.'))
+    lines.push(solutionLines.slice(0, 15).join('\n').trim())
+  } else if (Array.isArray(task?.plan?.items) && task.plan.items.length > 0) {
+    lines.push('Implemented following plan:')
+    for (const item of task.plan.items) {
+      lines.push(`- ${item}`)
+    }
+  } else {
+    lines.push(`- Resolved requirements specified in ${title}`)
+  }
+  lines.push('')
+
+  // 3. Changed components & diff statistics
+  if (diffStats && (diffStats.files?.length > 0 || diffStats.filesChanged > 0)) {
+    lines.push('### Changed Components & Files')
+    lines.push(`- Total files changed: ${diffStats.filesChanged || diffStats.files.length}`)
+    if (diffStats.additions || diffStats.deletions) {
+      lines.push(`- Changes: +${diffStats.additions} / -${diffStats.deletions}`)
+    }
+    if (Array.isArray(diffStats.files) && diffStats.files.length > 0) {
+      for (const f of diffStats.files.slice(0, 12)) {
+        lines.push(`  - \`${f.path}\``)
+      }
+      if (diffStats.files.length > 12) {
+        lines.push(`  - ... and ${diffStats.files.length - 12} more files`)
+      }
+    }
+    lines.push('')
+  }
+
+  // 4. Commits list
+  if (Array.isArray(commits) && commits.length > 0) {
+    lines.push('### Commits')
+    for (const c of commits) {
+      const shaShort = c.sha ? `\`${c.sha.slice(0, 7)}\` ` : ''
+      lines.push(`- ${shaShort}${c.message}`)
+    }
+    lines.push('')
+  }
+
+  // 5. Verification status
+  const ver = verification || task?.report?.verification
+  if (ver) {
+    lines.push('### Verification Results')
+    const statusText = ver.status === 'passed' ? '✓ Tests Passed' : (ver.status === 'failed' ? '✗ Tests Failed' : 'Pending')
+    lines.push(`- Status: **${statusText}**`)
+    if (ver.command) {
+      lines.push(`- Command: \`${ver.command}\``)
+    }
+    if (ver.verifiedAt) {
+      lines.push(`- Timestamp: ${new Date(ver.verifiedAt).toISOString()}`)
+    }
+    lines.push('')
+  }
+
+  // 6. Issue reference closure
+  if (issueRef) {
+    lines.push(issueRef)
+  }
+
+  return lines.join('\n').trim()
+}
+
+/**
+ * Generate release notes entry for CHANGELOG.md.
+ *
+ * @param {object} params
+ * @param {object} params.task
+ * @param {Array<{ sha: string, message: string }>} [params.commits]
+ * @returns {string} Formatted release notes bullet
+ */
+export function generateReleaseNotes({ task, commits = [] }) {
+  const title = String(task?.title ?? '').trim()
+  const issueNum = typeof task?.issueNumber === 'number' ? ` (#${task.issueNumber})` : ''
+  const cleanTitle = title.replace(/^[A-Z]:\s*(Feature|Bug|Fix|Refactor|Task):\s*/i, '')
+
+  const lines = [`- **${cleanTitle}${issueNum}**:`]
+
+  if (Array.isArray(commits) && commits.length > 0) {
+    for (const c of commits.slice(0, 5)) {
+      lines.push(`  - ${c.message}`)
+    }
+  } else {
+    lines.push(`  - Implementation and automated verification complete.`)
+  }
+
+  return lines.join('\n')
+}

package/lib/routes/board.js

@@ -4,6 +4,7 @@ import { columnStats, doneWithin, stale } from '../metrics.js'
 import { isStale } from '../time.js'
 import { facetsOf, facetsOfTask, groupByRepo, sortByLife } from '../filters.js'
 import { computeNextRun } from '../cron.js'
+import { computeBlocksMap, checkTaskBlocked } from '../dependencies.js'
 
 export function withPlan(task, liveOf, config, now, sameSession) {
   const plan = parsePlan(task.plan)
@@ -74,12 +75,15 @@ export function buildBoard({ store, config, board = 'main', repo, liveOf, sync,
     if (!bySession.has(id)) bySession.set(id, [])
     bySession.get(id).push(task)
   }
+  const blocksMap = computeBlocksMap(raw)
   const tasks = orderForBoard(
     raw.map((task) => {
       const enriched = withPlan(task, liveOf, config, now, bySession.get(task.sessionId) ?? [])
       if (task.isEpic) {
         enriched.subtasksCount = store.countSubtasks(task.id)
       }
+      enriched.blocks = blocksMap[task.id] || []
+      enriched.isBlocked = checkTaskBlocked(task, store).isBlocked
       return enriched
     }),
     columnsOf(store.boardKind(board)),

package/lib/routes/task-actions.js

@@ -1,3 +1,8 @@
+import { isTimeMachineAvailable, listTaskSnapshots, createCheckpointSnapshot, rollbackToSnapshot } from '../time-machine.js'
+import { generateTechnicalSpec, parseSpecMarkdown } from '../plan-generator.js'
+import { generatePrTitle, generatePrDescription, generateReleaseNotes } from '../pr-generator.js'
+import { getTaskCommits, getTaskDiffInspector } from '../worktree.js'
+
 /**
  * Extended actions for task route handlers (comments, reports, checklist, triage, subtasks, PR, nudge).
  * Zero Cyrillic in lib/ according to Issue #366.
@@ -249,7 +254,7 @@ export async function handleCreateTaskPr({ store, gitea, task, input }) {
   if (!head) return { status: 400, body: { error: 'branch-required' } }
   const base = String(input?.base || 'main').trim()
   const title = String(input?.title || task.title || `PR: ${task.title}`).trim()
-  const body = String(input?.body || (task.issueNumber ? `Closes #${task.issueNumber}` : '')).trim()
+  const body = String(input?.body || task.prDescription || (task.issueNumber ? `Closes #${task.issueNumber}` : '')).trim()
 
   try {
     const pr = await gitea.createPullRequest({
@@ -343,3 +348,157 @@ export async function handleTaskNudge({ store, id, prompt, agents, createMessage
     },
   }
 }
+
+/**
+ * Handle listing or creating snapshots via dsh-time-machine (#377).
+ */
+export async function handleTaskSnapshot({ ctx, store, id, method, body, config, env, cwdOf, logger }) {
+  const task = store.getTask(id)
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+
+  if (method === 'GET') {
+    const available = isTimeMachineAvailable(ctx)
+    const snapshots = available ? await listTaskSnapshots({ ctx, task }) : []
+    return {
+      status: 200,
+      body: {
+        available,
+        inceptionSnapshotId: task.inceptionSnapshotId || '',
+        snapshots,
+      },
+    }
+  }
+
+  if (method === 'POST') {
+    const label = typeof body?.label === 'string' ? body.label.trim() : ''
+    const res = await createCheckpointSnapshot({ ctx, task, label, config, env, cwdOf, logger })
+    if (!res.available) {
+      return {
+        status: 503,
+        body: {
+          error: 'time-machine-unavailable',
+          message: 'Plugin @goodandready/dsh-time-machine is not installed or active in this profile.',
+        },
+      }
+    }
+    if (!res.created) {
+      return { status: 500, body: { error: 'snapshot-failed', message: res.error } }
+    }
+    return { status: 201, body: { success: true, snapshot: res.snapshot } }
+  }
+
+  return { status: 405, body: { error: 'method-not-allowed' } }
+}
+
+/**
+ * Handle rolling back task worktree to inception or specified snapshot (#377).
+ */
+export async function handleTaskRollbackSnapshot({ ctx, store, id, body, config, env, cwdOf, logger, eventHub }) {
+  const task = store.getTask(id)
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+
+  const snapshotId = typeof body?.snapshotId === 'string' ? body.snapshotId.trim() : task.inceptionSnapshotId
+  const res = await rollbackToSnapshot({ ctx, task, snapshotId, config, env, cwdOf, logger })
+  if (!res.available) {
+    return { status: 503, body: { error: 'time-machine-unavailable', message: res.message } }
+  }
+  if (!res.rolledBack) {
+    return { status: 400, body: { error: res.error, message: res.message } }
+  }
+
+  if (eventHub && typeof eventHub.broadcast === 'function') {
+    eventHub.broadcast('task:change', { taskId: id, action: 'rollback', snapshotId: res.snapshotId })
+  }
+
+  return {
+    status: 200,
+    body: {
+      success: true,
+      snapshotId: res.snapshotId,
+      result: res.result,
+    },
+  }
+}
+
+
+/**
+ * Generate technical specification & plan for task (#376).
+ */
+export async function handleTaskGeneratePlan({ store, id, body, eventHub }) {
+  const task = store.getTask(id)
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+
+  const result = generateTechnicalSpec(task, body?.options || {})
+  const updated = store.updateTask(id, {
+    spec: result.spec,
+    plan: { items: result.items, current: 0 },
+  })
+
+  if (eventHub && typeof eventHub.broadcast === 'function') {
+    eventHub.broadcast('task:change', { taskId: id, action: 'plan-generated', spec: result.spec })
+  }
+
+  return {
+    status: 200,
+    body: {
+      success: true,
+      spec: result.spec,
+      items: result.items,
+      summary: result.summary,
+      task: updated,
+    },
+  }
+}
+
+/**
+ * Handle PR description generation and saving (#379).
+ */
+export async function handleTaskPrDescription({ store, id, method, body, gitRunner }) {
+  const task = store.getTask(id)
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+
+  if (method === 'POST' && typeof body?.prDescription === 'string') {
+    const updated = store.updateTask(id, { prDescription: body.prDescription })
+    return { status: 200, body: { success: true, prDescription: body.prDescription, task: updated } }
+  }
+
+  let commits = []
+  let diffStats = null
+
+  if (task.worktree) {
+    try {
+      commits = await getTaskCommits({ worktreePath: task.worktree, gitRunner })
+    } catch {
+      commits = []
+    }
+    try {
+      const inspector = await getTaskDiffInspector({ worktreePath: task.worktree, gitRunner })
+      if (inspector) {
+        diffStats = {
+          filesChanged: inspector.filesChanged || (inspector.files || []).length,
+          files: (inspector.files || []).map((f) => ({ path: f.file || f.path || f, changes: '' })),
+        }
+      }
+    } catch {
+      diffStats = null
+    }
+  }
+
+  const generatedTitle = generatePrTitle(task, commits)
+  const generatedDescription = generatePrDescription({ task, commits, diffStats })
+  const releaseNotes = generateReleaseNotes({ task, commits })
+
+  return {
+    status: 200,
+    body: {
+      success: true,
+      title: generatedTitle,
+      prDescription: task.prDescription || generatedDescription,
+      generatedDescription,
+      releaseNotes,
+      commits,
+      diffStats,
+    },
+  }
+}
+

package/lib/routes/task.js

@@ -1,6 +1,7 @@
 import { parseBody } from '../markdown.js'
 import { columnsOf, wipLimitField } from '../config.js'
 import { withPlan } from './board.js'
+import { checkMoveAllowed, validateDependencies, findUnblockedDependents } from '../dependencies.js'
 
 export function parseTaskPath(pathname) {
   const m = /^\/dsh-kanban\/task\/([^/]+)(?:\/([a-z-]+))?\/?$/.exec(pathname ?? '')
@@ -23,6 +24,17 @@ export function applyMove({ store, config, id, column, beforeId, afterId, source
     if (!allowed.includes(column)) {
       return { error: 'invalid-column', status: 400 }
     }
+    if (column === 'in-progress' && before.column !== 'in-progress') {
+      const moveCheck = checkMoveAllowed(before, column, store)
+      if (!moveCheck.allowed) {
+        return {
+          error: 'task-blocked',
+          status: 400,
+          message: moveCheck.reason,
+          pendingBlockers: moveCheck.pendingBlockers,
+        }
+      }
+    }
   }
   const task = store.moveTask(id, { column, beforeId, afterId })
   if (task.column !== before.column) {
@@ -32,7 +44,10 @@ export function applyMove({ store, config, id, column, beforeId, afterId, source
   }
   const limit = wipLimitField(config, task.column)
   const count = store.countInColumn(task.board, task.column)
-  return { task, overLimit: limit !== undefined && count > limit }
+  const unblocked = (task.column === 'done' && before.column !== 'done')
+    ? findUnblockedDependents(id, store, () => store.listTasks({ board: task.board }))
+    : []
+  return { task, overLimit: limit !== undefined && count > limit, unblocked }
 }
 
 /** Create local board task (not linked to Gitea). */
@@ -96,6 +111,17 @@ export function updateTask({ store, id, input }) {
     const val = input.forge.trim().toLowerCase()
     if (val === 'github' || val === 'gitea') patch.forge = val
   }
+  if (Array.isArray(input?.blockedBy)) {
+    const newBlockedBy = input.blockedBy.filter((b) => typeof b === 'string' && b.trim() !== '')
+    const check = validateDependencies(id, newBlockedBy, store)
+    if (!check.valid) {
+      return { error: 'circular-dependency', status: 400, message: check.error }
+    }
+    patch.blockedBy = newBlockedBy
+  }
+  if (typeof input?.inceptionSnapshotId === 'string') {
+    patch.inceptionSnapshotId = input.inceptionSnapshotId.trim()
+  }
   return { task: store.updateTask(id, patch) }
 }
 

package/lib/routes.js

@@ -69,4 +69,8 @@ export {
   handleToggleChecklistItem,
   handleCreateTaskPr,
   handleTaskNudge,
+  handleTaskSnapshot,
+  handleTaskRollbackSnapshot,
+  handleTaskGeneratePlan,
+  handleTaskPrDescription,
 } from './routes/task-actions.js'

package/lib/server/task-handler.js

@@ -30,6 +30,8 @@ import {
   handleToggleChecklistItem,
 } from '../routes.js'
 import { verifyAndRecordGate } from '../verification.js'
+import { handleTaskSnapshot, handleTaskRollbackSnapshot, handleTaskGeneratePlan, handleTaskPrDescription } from '../routes.js'
+import { createInceptionSnapshot } from '../time-machine.js'
 import { runTask, queueTask, unqueueTask, resolveModel, buildStartMessage, PERMISSION_RANKS } from '../launcher.js'
 import { dispatchMove, stopWork, MOVE_DETAIL, STOP_DETAIL } from '../commands.js'
 import { checkWorktreeDirty } from '../worktree.js'
@@ -257,6 +259,25 @@ export function createTaskRouteHandler(deps) {
                 out.dirtyFiles = dirty.files
               }
             }
+            if (out.task.column === 'in-progress' && was?.column !== 'in-progress') {
+              const cfg = getConfig()
+              if (cfg?.timeMachineEnabled !== false && cfg?.timeMachineAutoSnapshot !== false) {
+                createInceptionSnapshot({
+                  ctx,
+                  task: out.task,
+                  config: cfg,
+                  env: process.env,
+                  cwdOf: () => rootOf(cfg, () => process.cwd()).path,
+                  store,
+                  logger: ctx.logger,
+                }).catch(() => {})
+              }
+            }
+            if (Array.isArray(out.unblocked) && out.unblocked.length > 0) {
+              for (const dep of out.unblocked) {
+                eventHub.broadcast('task:change', { taskId: dep.id, action: 'unblocked', task: dep })
+              }
+            }
           }
           reply(res, out)
           return
@@ -400,6 +421,36 @@ export function createTaskRouteHandler(deps) {
           writeJson(res, resObj.status, resObj.body)
           return
         }
+        if ((req.method === 'GET' || req.method === 'POST') && action === 'snapshot') {
+          const cfg = getConfig()
+          const resObj = await handleTaskSnapshot({
+            ctx, store, id, method: req.method, body: input, config: cfg,
+            env: process.env, cwdOf: () => rootOf(cfg, () => process.cwd()).path, logger: ctx.logger,
+          })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && action === 'rollback-snapshot') {
+          const cfg = getConfig()
+          const resObj = await handleTaskRollbackSnapshot({
+            ctx, store, id, body: input, config: cfg,
+            env: process.env, cwdOf: () => rootOf(cfg, () => process.cwd()).path, logger: ctx.logger, eventHub,
+          })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && action === 'generate-plan') {
+          const resObj = await handleTaskGeneratePlan({ store, id, body: input, eventHub })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if ((req.method === 'GET' || req.method === 'POST') && action === 'pr-description') {
+          const cfg = getConfig()
+          const gitRunner = cfg.remoteMode ? createRemoteGitRunner(cfg) : undefined
+          const resObj = await handleTaskPrDescription({ store, id, method: req.method, body: input, gitRunner })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
         if (req.method === 'POST' && action === 'resume') {
           watchdog?.resumeTask?.({ store, taskId: id, eventHub })
           const task = store.getTask(id)

package/lib/store.js

@@ -79,6 +79,10 @@ CREATE TABLE IF NOT EXISTS tasks (
   stalled               INTEGER NOT NULL DEFAULT 0,
   stalledReason         TEXT NOT NULL DEFAULT '',
   stalledAt             INTEGER NOT NULL DEFAULT 0,
+  blockedBy             TEXT NOT NULL DEFAULT '[]',
+  inceptionSnapshotId   TEXT NOT NULL DEFAULT '',
+  spec                  TEXT NOT NULL DEFAULT '',
+  prDescription         TEXT NOT NULL DEFAULT '',
   updatedAt    INTEGER NOT NULL
 );
 CREATE INDEX IF NOT EXISTS tasks_board_col ON tasks(board, col, position);
@@ -114,6 +118,7 @@ const WRITABLE = [
   'verificationCommand', 'verificationStatus',
   'costMetrics', 'costLimitExceeded',
   'stalled', 'stalledReason', 'stalledAt',
+  'blockedBy', 'inceptionSnapshotId', 'spec', 'prDescription',
 ]
 
 /** Valid transition sources; unexpected values are rejected to preserve log integrity. */
@@ -121,7 +126,7 @@ const SOURCES = new Set(['manual', 'session', 'gitea', 'github', 'tool', 'workfl
 
 function rowToTask(row) {
   if (row === undefined) return undefined
-  const { col, labels, waiting, labelColors, runs, checklist, report, comments, rejectReason, rejectedAt, isEpic, parentId, stalled, ...rest } = row
+  const { col, labels, waiting, labelColors, runs, checklist, report, comments, rejectReason, rejectedAt, isEpic, parentId, stalled, blockedBy, inceptionSnapshotId, spec, prDescription, ...rest } = row
   let parsedChecklist = []
   try {
     const value = JSON.parse(checklist ?? '[]')
@@ -177,6 +182,15 @@ function rowToTask(row) {
       return rest.costMetrics && typeof rest.costMetrics === 'object' ? rest.costMetrics : null;
     })(),
     costLimitExceeded: rest.costLimitExceeded === 1 || rest.costLimitExceeded === true,
+    blockedBy: (() => {
+      try {
+        const val = JSON.parse(blockedBy ?? '[]')
+        return Array.isArray(val) ? val.filter((x) => typeof x === 'string') : []
+      } catch { return [] }
+    })(),
+    inceptionSnapshotId: typeof inceptionSnapshotId === 'string' ? inceptionSnapshotId : (typeof rest.inceptionSnapshotId === 'string' ? rest.inceptionSnapshotId : ''),
+    spec: typeof spec === 'string' ? spec : (typeof rest.spec === 'string' ? rest.spec : ''),
+    prDescription: typeof prDescription === 'string' ? prDescription : (typeof rest.prDescription === 'string' ? rest.prDescription : ''),
   }
 }
 
@@ -272,6 +286,10 @@ export function openStore({ dir }) {
     ['stalled', 'INTEGER NOT NULL DEFAULT 0'],
     ['stalledReason', "TEXT NOT NULL DEFAULT ''"],
     ['stalledAt', 'INTEGER NOT NULL DEFAULT 0'],
+    ['blockedBy', "TEXT NOT NULL DEFAULT '[]'"],
+    ['inceptionSnapshotId', "TEXT NOT NULL DEFAULT ''"],
+    ['spec', "TEXT NOT NULL DEFAULT ''"],
+    ['prDescription', "TEXT NOT NULL DEFAULT ''"],
   ]) {
     try { db.exec(`ALTER TABLE tasks ADD COLUMN ${column} ${definition}`) } catch { /* column already exists */ }
   }
@@ -602,7 +620,8 @@ export function openStore({ dir }) {
       for (const key of WRITABLE) {
         if (!Object.hasOwn(patch, key)) continue
         fields.push(`${key} = ?`)
-        if (key === 'labels') values.push(JSON.stringify(patch[key] ?? []))
+        if (key === 'plan') values.push(typeof patch[key] === 'string' ? patch[key] : JSON.stringify(patch[key] ?? { items: [], current: 0 }))
+        else if (key === 'labels') values.push(JSON.stringify(patch[key] ?? []))
         else if (key === 'labelColors') values.push(JSON.stringify(patch[key] ?? {}))
         else if (key === 'runs') values.push(typeof patch[key] === 'string' ? patch[key] : JSON.stringify(patch[key] ?? []))
         else if (key === 'checklist') values.push(typeof patch[key] === 'string' ? patch[key] : JSON.stringify(patch[key] ?? []))
@@ -614,6 +633,10 @@ export function openStore({ dir }) {
         else if (key === 'syncedAt') values.push(Number(patch[key]) || 0)
         else if (key === 'isEpic') values.push(patch[key] ? 1 : 0)
         else if (key === 'parentId') values.push(String(patch[key] ?? ''))
+        else if (key === 'blockedBy') values.push(Array.isArray(patch[key]) ? JSON.stringify(patch[key]) : (typeof patch[key] === 'string' ? patch[key] : '[]'))
+        else if (key === 'inceptionSnapshotId') values.push(String(patch[key] ?? ''))
+        else if (key === 'spec') values.push(String(patch[key] ?? ''))
+        else if (key === 'prDescription') values.push(String(patch[key] ?? ''))
         else values.push(patch[key] ?? null)
       }
       if (fields.length > 0) {