CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to TESSERACT will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.5] - 2025-01-XX
+
+### Added
+- **Nested Kanban View** - Major feature implementation
+  - Parent tasks now appear in each column where they have subtasks
+  - Parent cards show "X of Y subtasks in this column" indicator
+  - Parent cards are expandable/collapsible to show children in that column
+  - Parent cards have distinct visual styling (thicker orange border, bold text)
+  - Only leaf tasks (tasks with no children) are draggable
+  - Parent cards automatically appear in multiple columns as children move
+- Helper functions for nested Kanban logic:
+  - `getDescendantsInStatus()` - Get all descendant tasks in a specific status
+  - `hasDescendantsInStatus()` - Check if parent has any descendants in a status
+
+### Changed
+- Kanban board now labeled "Kanban Board (Nested View)"
+- Parent task cards cannot be dragged (only leaf tasks)
+- Column task counts now include parent cards
+- Improved visual hierarchy with parent/child distinction
+
+### Improved
+- Better visualization of task distribution across statuses
+- Easier to see project structure while maintaining status-based organization
+- Parent tasks provide context for subtasks in each column
+
 ## [0.1.4] - 2025-01-XX
 
 ### Added

README.md

@@ -2,7 +2,7 @@
 
 **Task Decomposition Engine** - A self-hosted web application for managing deeply nested todo trees with advanced time tracking and project planning capabilities.
 
-![Version](https://img.shields.io/badge/version-0.1.4-orange)
+![Version](https://img.shields.io/badge/version-0.1.5-orange)
 ![License](https://img.shields.io/badge/license-MIT-blue)
 
 ## Overview
@@ -12,7 +12,9 @@ TESSERACT is designed for complex project management where tasks naturally decom
 ### Key Features
 
 - **Arbitrary-Depth Nesting**: Create tasks within tasks within tasks - no limits on hierarchy depth
-- **Dual View Modes**: Toggle between Tree View (hierarchical) and Kanban Board (status-based)
+- **Dual View Modes**:
+  - **Tree View**: Hierarchical collapsible tree with full nesting
+  - **Nested Kanban**: Status-based board where parent tasks appear in multiple columns
 - **Intelligent Time Tracking**:
   - Leaf-based time calculation (parent times = sum of descendant leaf tasks)
   - Automatic exclusion of completed tasks from time estimates
@@ -101,13 +103,29 @@ docker-compose down -v
 
 **Expand/Collapse**: Click chevron icon to show/hide subtasks
 
-#### Kanban View
+#### Kanban View (Nested)
 
-**Add Task**: Click "+" in any column to create a task with that status
+The Kanban board displays tasks in a nested hierarchy while maintaining status-based columns:
 
-**Move Tasks**: Drag and drop cards between columns to change status
+**Parent Cards**:
+- Appear in **every column** where they have subtasks
+- Display "X of Y subtasks in this column" counter
+- Have distinct styling (thick orange border, bold title)
+- Click chevron to expand/collapse and see children in that column
+- Cannot be dragged (only leaf tasks are draggable)
 
-**Edit Tasks**: Use the three-dot menu same as Tree View
+**Leaf Tasks**:
+- Appear only in their status column
+- Fully draggable between columns
+- Standard card styling
+
+**Add Task**: Click "+" in any column to create a root-level task
+
+**Move Tasks**: Drag and drop leaf task cards between columns
+
+**Edit Tasks**: Use the three-dot menu on any card (parent or leaf)
+
+**Example**: A project with backend (2 tasks in backlog, 1 in progress) and frontend (1 in done) will show the project card in all three columns with appropriate counts.
 
 ### Understanding Time Estimates
 
@@ -354,7 +372,6 @@ Ensure JSON structure matches schema. Common issues:
 See [CHANGELOG.md](CHANGELOG.md) for version history.
 
 ### v0.2.0 (Planned)
-- Nested Kanban view (parent cards split across columns)
 - Task dependencies and blocking relationships
 - Due dates and calendar view
 - Progress tracking (% complete)

frontend/src/App.jsx

@@ -13,7 +13,7 @@ function App() {
               <h1 className="text-2xl font-bold text-cyber-orange">
                 TESSERACT
                 <span className="ml-3 text-sm text-gray-500">Task Decomposition Engine</span>
-                <span className="ml-2 text-xs text-gray-600">v0.1.4</span>
+                <span className="ml-2 text-xs text-gray-600">v0.1.5</span>
               </h1>
             </div>
             <SearchBar />

frontend/src/components/KanbanView.jsx

@@ -1,5 +1,5 @@
 import { useState, useEffect } from 'react'
-import { Plus, Check, X, Flag, Clock } from 'lucide-react'
+import { Plus, Check, X, Flag, Clock, ChevronDown, ChevronRight } from 'lucide-react'
 import {
   getProjectTasks,
   createTask,
@@ -27,14 +27,31 @@ const FLAG_COLORS = {
   pink: 'bg-pink-500'
 }
 
-function TaskCard({ task, allTasks, onUpdate, onDragStart }) {
-  const [isEditing, setIsEditing] = useState(false)
-  const [editTitle, setEditTitle] = useState(task.title)
+// Helper function to get all descendant tasks of a parent in a specific status
+function getDescendantsInStatus(taskId, allTasks, status) {
+  const children = allTasks.filter(t => t.parent_task_id === taskId)
+  let descendants = []
 
-  // Find parent task if this is a subtask
-  const parentTask = task.parent_task_id
-    ? allTasks.find(t => t.id === task.parent_task_id)
-    : null
+  for (const child of children) {
+    if (child.status === status) {
+      descendants.push(child)
+    }
+    // Recursively get descendants
+    descendants = descendants.concat(getDescendantsInStatus(child.id, allTasks, status))
+  }
+
+  return descendants
+}
+
+// Helper function to check if a task has any descendants in a status
+function hasDescendantsInStatus(taskId, allTasks, status) {
+  return getDescendantsInStatus(taskId, allTasks, status).length > 0
+}
+
+function TaskCard({ task, allTasks, onUpdate, onDragStart, isParent, columnStatus }) {
+  const [isEditing, setIsEditing] = useState(false)
+  const [isExpanded, setIsExpanded] = useState(false)
+  const [editTitle, setEditTitle] = useState(task.title)
 
   const handleSave = async () => {
     try {
@@ -56,11 +73,20 @@ function TaskCard({ task, allTasks, onUpdate, onDragStart }) {
     }
   }
 
+  // For parent cards, get children in this column's status
+  const childrenInColumn = isParent ? getDescendantsInStatus(task.id, allTasks, columnStatus) : []
+  const totalChildren = isParent ? allTasks.filter(t => t.parent_task_id === task.id).length : 0
+
   return (
+    <div className="mb-2">
       <div
-      draggable={!isEditing}
-      onDragStart={(e) => onDragStart(e, task)}
-      className="bg-cyber-darkest border border-cyber-orange/30 rounded-lg p-3 mb-2 cursor-move hover:border-cyber-orange/60 transition-all group"
+        draggable={!isEditing && !isParent}
+        onDragStart={(e) => !isParent && onDragStart(e, task)}
+        className={`${
+          isParent
+            ? 'bg-cyber-darker border-2 border-cyber-orange/50'
+            : 'bg-cyber-darkest border border-cyber-orange/30'
+        } rounded-lg p-3 ${!isParent ? 'cursor-move' : ''} hover:border-cyber-orange/60 transition-all group`}
       >
         {isEditing ? (
           <div className="flex gap-2">
@@ -90,19 +116,33 @@ function TaskCard({ task, allTasks, onUpdate, onDragStart }) {
         ) : (
           <>
             <div className="flex justify-between items-start">
+              <div className="flex-1">
+                <div className="flex items-center gap-2">
+                  {/* Expand/collapse for parent cards */}
+                  {isParent && childrenInColumn.length > 0 && (
+                    <button
+                      onClick={() => setIsExpanded(!isExpanded)}
+                      className="text-cyber-orange hover:text-cyber-orange-bright"
+                    >
+                      {isExpanded ? <ChevronDown size={14} /> : <ChevronRight size={14} />}
+                    </button>
+                  )}
+
                   <div className="flex-1">
                     <div className="flex items-center gap-2 text-sm">
                       {/* Flag indicator */}
                       {task.flag_color && FLAG_COLORS[task.flag_color] && (
                         <Flag size={12} className={`${FLAG_COLORS[task.flag_color].replace('bg-', 'text-')}`} fill="currentColor" />
                       )}
-                <span className="text-gray-200">{task.title}</span>
+                      <span className={`${isParent ? 'font-semibold text-cyber-orange' : 'text-gray-200'}`}>
+                        {task.title}
+                      </span>
                     </div>
 
-              {/* Parent task context */}
-              {parentTask && (
+                    {/* Parent card info: show subtask count in this column */}
+                    {isParent && (
                       <div className="text-xs text-gray-500 mt-1">
-                  ↳ subtask of: <span className="text-cyber-orange">{parentTask.title}</span>
+                        {childrenInColumn.length} of {totalChildren} subtask{totalChildren !== 1 ? 's' : ''} in this column
                       </div>
                     )}
 
@@ -133,6 +173,8 @@ function TaskCard({ task, allTasks, onUpdate, onDragStart }) {
                       </div>
                     )}
                   </div>
+                </div>
+              </div>
 
               <div className="flex gap-1 opacity-0 group-hover:opacity-100 transition-opacity">
                 <TaskMenu
@@ -146,10 +188,28 @@ function TaskCard({ task, allTasks, onUpdate, onDragStart }) {
           </>
         )}
       </div>
+
+      {/* Expanded children */}
+      {isParent && isExpanded && childrenInColumn.length > 0 && (
+        <div className="ml-6 mt-2 space-y-2">
+          {childrenInColumn.map(child => (
+            <TaskCard
+              key={child.id}
+              task={child}
+              allTasks={allTasks}
+              onUpdate={onUpdate}
+              onDragStart={onDragStart}
+              isParent={false}
+              columnStatus={columnStatus}
+            />
+          ))}
+        </div>
+      )}
+    </div>
   )
 }
 
-function KanbanColumn({ status, tasks, allTasks, projectId, onUpdate, onDrop, onDragOver }) {
+function KanbanColumn({ status, allTasks, projectId, onUpdate, onDrop, onDragOver }) {
   const [showAddTask, setShowAddTask] = useState(false)
 
   const handleAddTask = async (taskData) => {
@@ -170,16 +230,37 @@ function KanbanColumn({ status, tasks, allTasks, projectId, onUpdate, onDrop, on
     }
   }
 
+  // Get tasks to display in this column:
+  // 1. All leaf tasks (no children) with this status
+  // 2. All parent tasks that have at least one descendant with this status
+  const leafTasks = allTasks.filter(t => {
+    const hasChildren = allTasks.some(child => child.parent_task_id === t.id)
+    return !hasChildren && t.status === status.key
+  })
+
+  const parentTasks = allTasks.filter(t => {
+    const hasChildren = allTasks.some(child => child.parent_task_id === t.id)
+    return hasChildren && hasDescendantsInStatus(t.id, allTasks, status.key)
+  })
+
+  // Only show root-level parents (not nested parents)
+  const rootParents = parentTasks.filter(t => !t.parent_task_id)
+
+  // Only show root-level leaf tasks (leaf tasks without parents)
+  const rootLeafTasks = leafTasks.filter(t => !t.parent_task_id)
+
+  const displayTasks = [...rootParents, ...rootLeafTasks]
+
   return (
     <div
-      className="flex-1 min-w-[280px] bg-cyber-darker rounded-lg p-4 border-t-4 ${status.color}"
+      className={`flex-1 min-w-[280px] bg-cyber-darker rounded-lg p-4 border-t-4 ${status.color}`}
       onDrop={(e) => onDrop(e, status.key)}
       onDragOver={onDragOver}
     >
       <div className="flex justify-between items-center mb-4">
         <h3 className="font-semibold text-gray-200">
           {status.label}
-          <span className="ml-2 text-xs text-gray-500">({tasks.length})</span>
+          <span className="ml-2 text-xs text-gray-500">({displayTasks.length})</span>
         </h3>
         <button
           onClick={() => setShowAddTask(true)}
@@ -200,7 +281,9 @@ function KanbanColumn({ status, tasks, allTasks, projectId, onUpdate, onDrop, on
       )}
 
       <div className="space-y-2">
-        {tasks.map(task => (
+        {displayTasks.map(task => {
+          const isParent = allTasks.some(t => t.parent_task_id === task.id)
+          return (
             <TaskCard
               key={task.id}
               task={task}
@@ -209,8 +292,11 @@ function KanbanColumn({ status, tasks, allTasks, projectId, onUpdate, onDrop, on
               onDragStart={(e, task) => {
                 e.dataTransfer.setData('taskId', task.id.toString())
               }}
+              isParent={isParent}
+              columnStatus={status.key}
             />
-        ))}
+          )
+        })}
       </div>
     </div>
   )
@@ -265,14 +351,13 @@ function KanbanView({ projectId }) {
 
   return (
     <div>
-      <h3 className="text-xl font-semibold text-gray-300 mb-4">Kanban Board</h3>
+      <h3 className="text-xl font-semibold text-gray-300 mb-4">Kanban Board (Nested View)</h3>
 
       <div className="flex gap-4 overflow-x-auto pb-4">
         {STATUSES.map(status => (
           <KanbanColumn
             key={status.key}
             status={status}
-            tasks={allTasks.filter(t => t.status === status.key)}
             allTasks={allTasks}
             projectId={projectId}
             onUpdate={loadTasks}