beads-kanban-ui 0.1.0 → 0.1.1

package/.history/README_20260121193918.md

@@ -1,227 +0,0 @@
-# Beads Kanban UI
-
-**See all your tasks at a glance. Organize, and track progress across projects—no CLI required.**
-
-A beautiful visual Kanban board for the [Beads CLI](https://github.com/steveyegge/beads) task tracker. Beads stores tasks as git-native files (`.beads/issues.jsonl`), and this UI gives you the dashboard and board you've been missing.
-
-> **Works great with [Beads Orchestration](https://github.com/AvivK5498/Claude-Code-Beads-Orchestration)** — A multi-agent orchestration framework for Claude Code that uses beads for git-native task tracking with mandatory code review gates.
-
-## See It in Action
-
-**Dashboard** — All your projects in one place with status at a glance:
-![Dashboard with multi-project view, status donuts, and tags](Screenshots/dashboard.png)
-
-**Kanban Board** — Organize tasks across Open → In Progress → In Review → Closed:
-![Kanban board showing epic groups and task cards with git branch info](Screenshots/kanban-board.png)
-
-**Bead Details** — Dive into any task with full context and subtasks:
-![Bead detail panel showing epic with progress bar and subtasks](Screenshots/bead-detail.png)
-
-## What You Get
-
-- **Multi-project dashboard** — Manage all your beads projects in one place with status donut charts
-- **Kanban board** — Drag-and-drop columns: Open → In Progress → In Review → Closed
-- **Epic support** — Group related tasks, track progress with bars, view all subtasks
-- **Real-time sync** — File watcher auto-updates when beads files change on disk
-- **Git integration** — See branch status for each task at a glance
-- **Search & filter** — Quick filters for status, priority, owner, and tags
-- **Project tagging** — Organize with colored tags and filter by them
-
-## Quick Start (3 steps)
-
-### 1. Prerequisites
-```bash
-# Install beads CLI
-brew install steveyegge/beads/bd
-
-# You'll also need Node.js 18+ and Rust
-```
-
-### 2. Install and Run
-```bash
-git clone https://github.com/AvivK5498/beads-kanban-ui
-cd beads-kanban-ui
-npm install
-npm run dev:full
-```
-
-### 3. Open in Browser
-Navigate to **`http://localhost:3007`** and add your beads projects.
-
-That's it! The app watches for file changes and syncs in real-time.
-
----
-
-## Detailed Setup
-
-### Development Mode
-
-Run both frontend and backend together:
-```bash
-npm run dev:full
-```
-
-Or run separately:
-```bash
-# Terminal 1: Frontend (http://localhost:3007)
-npm run dev
-
-# Terminal 2: Backend (http://localhost:3008)
-npm run server:dev
-```
-
-The Rust backend builds automatically on first run. If you need to rebuild it:
-```bash
-cd server && cargo build --release && cd ..
-```
-
-### Production Build
-
-For a single binary deployment:
-```bash
-npm run build
-npm run server:build
-./server/target/release/beads-server
-```
-
-The production server embeds the frontend and serves everything from a single binary on port 3008.
-
----
-
-## How It Works
-
-### Dashboard
-1. Click **+ Add Project** and select a directory with a `.beads/` folder
-2. See all projects with status donuts showing task distribution
-3. Click any project to view its Kanban board
-
-### Kanban Board
-1. Tasks are organized by status: Open, In Progress, In Review, Closed
-2. Drag cards between columns to update status
-3. Click any task to see full details, comments, and related subtasks (for epics)
-
-### Features in Detail
-
-**Search & Filter**
-- Quick filters for status, priority, and assigned owner
-- Project tags for organization
-
-**Real-time Sync**
-- The app watches `.beads/issues.jsonl` and updates automatically
-- No refresh needed—changes appear instantly
-
-**Git Integration**
-- Each task shows its git branch status
-- Useful for tracking which branch a task lives on
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    Beads Kanban UI                      │
-├─────────────────────────────────────────────────────────┤
-│  Frontend (Next.js 14)          │  Backend (Rust/Axum) │
-│  ─────────────────────          │  ────────────────────│
-│  • React 18                     │  • SQLite (projects) │
-│  • shadcn/ui components         │  • beads CLI bridge  │
-│  • Tailwind CSS                 │  • File watcher      │
-│  • TypeScript                   │  • Git integration   │
-└─────────────────────────────────────────────────────────┘
-                           │
-                           ▼
-              ┌─────────────────────────┐
-              │   .beads/ directory     │
-              │   (issues.jsonl, etc.)  │
-              └─────────────────────────┘
-```
-
-### Tech Stack
-- **Frontend**: Next.js 14, React 18, Tailwind CSS, shadcn/ui
-- **Backend**: Rust with Axum framework
-- **Database**: SQLite for project metadata
-- **File Sync**: Real-time watcher for `.beads/` changes
-
-### Project Structure
-```
-beads-kanban-ui/
-├── src/
-│   ├── app/                 # Next.js pages and routes
-│   │   ├── page.tsx         # Projects dashboard
-│   │   ├── project/         # Kanban board view
-│   │   └── settings/        # Settings page
-│   ├── components/          # React components
-│   │   ├── ui/              # shadcn/ui components
-│   │   ├── kanban-column.tsx
-│   │   ├── bead-card.tsx
-│   │   └── bead-detail.tsx
-│   ├── hooks/               # Custom React hooks
-│   ├── lib/                 # Utilities and API client
-│   └── types/               # TypeScript type definitions
-├── server/
-│   └── src/
-│       ├── main.rs          # Axum server entry point
-│       ├── db.rs            # SQLite database layer
-│       └── routes/          # API route handlers
-└── package.json
-```
-
----
-
-## API Endpoints
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/health` | GET | Server health check |
-| `/api/projects` | GET/POST | List or create projects |
-| `/api/projects/:id` | GET/PUT/DELETE | Manage individual projects |
-| `/api/beads?path=` | GET | Read beads from a project path |
-| `/api/beads/comment` | POST | Add comment to a bead |
-| `/api/bd/command` | POST | Execute beads CLI commands |
-| `/api/git/branch-status` | GET | Get git branch status for a bead |
-| `/api/fs/list` | GET | List directory contents |
-| `/api/fs/exists` | GET | Check if a path exists |
-| `/api/watch/beads` | GET | Server-sent events for file changes |
-
-### Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PORT` | `3008` | Backend server port |
-| `NEXT_PUBLIC_BACKEND_URL` | `http://localhost:3008` | Backend URL for frontend API calls |
-
----
-
-## Development Commands
-
-```bash
-# Run both frontend and backend
-npm run dev:full
-
-# Run frontend only
-npm run dev
-
-# Run backend only
-npm run server:dev
-
-# Build for production
-npm run build
-npm run server:build
-
-# Linting
-npm run lint
-```
-
----
-
-## Related Projects
-
-- **[Beads CLI](https://github.com/steveyegge/beads)** — Git-native issue tracker (the core tool this UI wraps)
-- **[Beads Orchestration](https://github.com/AvivK5498/Claude-Code-Beads-Orchestration)** — Multi-agent orchestration framework for Claude Code using beads
-
----
-
-## License
-
-MIT

package/.history/README_20260121193921.md

@@ -1,227 +0,0 @@
-# Beads Kanban UI
-
-**See all your tasks at a glance. Organize, and track progress across projects - no CLI required.**
-
-A beautiful visual Kanban board for the [Beads CLI](https://github.com/steveyegge/beads) task tracker. Beads stores tasks as git-native files (`.beads/issues.jsonl`), and this UI gives you the dashboard and board you've been missing.
-
-> **Works great with [Beads Orchestration](https://github.com/AvivK5498/Claude-Code-Beads-Orchestration)** — A multi-agent orchestration framework for Claude Code that uses beads for git-native task tracking with mandatory code review gates.
-
-## See It in Action
-
-**Dashboard** — All your projects in one place with status at a glance:
-![Dashboard with multi-project view, status donuts, and tags](Screenshots/dashboard.png)
-
-**Kanban Board** — Organize tasks across Open → In Progress → In Review → Closed:
-![Kanban board showing epic groups and task cards with git branch info](Screenshots/kanban-board.png)
-
-**Bead Details** — Dive into any task with full context and subtasks:
-![Bead detail panel showing epic with progress bar and subtasks](Screenshots/bead-detail.png)
-
-## What You Get
-
-- **Multi-project dashboard** — Manage all your beads projects in one place with status donut charts
-- **Kanban board** — Drag-and-drop columns: Open → In Progress → In Review → Closed
-- **Epic support** — Group related tasks, track progress with bars, view all subtasks
-- **Real-time sync** — File watcher auto-updates when beads files change on disk
-- **Git integration** — See branch status for each task at a glance
-- **Search & filter** — Quick filters for status, priority, owner, and tags
-- **Project tagging** — Organize with colored tags and filter by them
-
-## Quick Start (3 steps)
-
-### 1. Prerequisites
-```bash
-# Install beads CLI
-brew install steveyegge/beads/bd
-
-# You'll also need Node.js 18+ and Rust
-```
-
-### 2. Install and Run
-```bash
-git clone https://github.com/AvivK5498/beads-kanban-ui
-cd beads-kanban-ui
-npm install
-npm run dev:full
-```
-
-### 3. Open in Browser
-Navigate to **`http://localhost:3007`** and add your beads projects.
-
-That's it! The app watches for file changes and syncs in real-time.
-
----
-
-## Detailed Setup
-
-### Development Mode
-
-Run both frontend and backend together:
-```bash
-npm run dev:full
-```
-
-Or run separately:
-```bash
-# Terminal 1: Frontend (http://localhost:3007)
-npm run dev
-
-# Terminal 2: Backend (http://localhost:3008)
-npm run server:dev
-```
-
-The Rust backend builds automatically on first run. If you need to rebuild it:
-```bash
-cd server && cargo build --release && cd ..
-```
-
-### Production Build
-
-For a single binary deployment:
-```bash
-npm run build
-npm run server:build
-./server/target/release/beads-server
-```
-
-The production server embeds the frontend and serves everything from a single binary on port 3008.
-
----
-
-## How It Works
-
-### Dashboard
-1. Click **+ Add Project** and select a directory with a `.beads/` folder
-2. See all projects with status donuts showing task distribution
-3. Click any project to view its Kanban board
-
-### Kanban Board
-1. Tasks are organized by status: Open, In Progress, In Review, Closed
-2. Drag cards between columns to update status
-3. Click any task to see full details, comments, and related subtasks (for epics)
-
-### Features in Detail
-
-**Search & Filter**
-- Quick filters for status, priority, and assigned owner
-- Project tags for organization
-
-**Real-time Sync**
-- The app watches `.beads/issues.jsonl` and updates automatically
-- No refresh needed—changes appear instantly
-
-**Git Integration**
-- Each task shows its git branch status
-- Useful for tracking which branch a task lives on
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    Beads Kanban UI                      │
-├─────────────────────────────────────────────────────────┤
-│  Frontend (Next.js 14)          │  Backend (Rust/Axum) │
-│  ─────────────────────          │  ────────────────────│
-│  • React 18                     │  • SQLite (projects) │
-│  • shadcn/ui components         │  • beads CLI bridge  │
-│  • Tailwind CSS                 │  • File watcher      │
-│  • TypeScript                   │  • Git integration   │
-└─────────────────────────────────────────────────────────┘
-                           │
-                           ▼
-              ┌─────────────────────────┐
-              │   .beads/ directory     │
-              │   (issues.jsonl, etc.)  │
-              └─────────────────────────┘
-```
-
-### Tech Stack
-- **Frontend**: Next.js 14, React 18, Tailwind CSS, shadcn/ui
-- **Backend**: Rust with Axum framework
-- **Database**: SQLite for project metadata
-- **File Sync**: Real-time watcher for `.beads/` changes
-
-### Project Structure
-```
-beads-kanban-ui/
-├── src/
-│   ├── app/                 # Next.js pages and routes
-│   │   ├── page.tsx         # Projects dashboard
-│   │   ├── project/         # Kanban board view
-│   │   └── settings/        # Settings page
-│   ├── components/          # React components
-│   │   ├── ui/              # shadcn/ui components
-│   │   ├── kanban-column.tsx
-│   │   ├── bead-card.tsx
-│   │   └── bead-detail.tsx
-│   ├── hooks/               # Custom React hooks
-│   ├── lib/                 # Utilities and API client
-│   └── types/               # TypeScript type definitions
-├── server/
-│   └── src/
-│       ├── main.rs          # Axum server entry point
-│       ├── db.rs            # SQLite database layer
-│       └── routes/          # API route handlers
-└── package.json
-```
-
----
-
-## API Endpoints
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/health` | GET | Server health check |
-| `/api/projects` | GET/POST | List or create projects |
-| `/api/projects/:id` | GET/PUT/DELETE | Manage individual projects |
-| `/api/beads?path=` | GET | Read beads from a project path |
-| `/api/beads/comment` | POST | Add comment to a bead |
-| `/api/bd/command` | POST | Execute beads CLI commands |
-| `/api/git/branch-status` | GET | Get git branch status for a bead |
-| `/api/fs/list` | GET | List directory contents |
-| `/api/fs/exists` | GET | Check if a path exists |
-| `/api/watch/beads` | GET | Server-sent events for file changes |
-
-### Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PORT` | `3008` | Backend server port |
-| `NEXT_PUBLIC_BACKEND_URL` | `http://localhost:3008` | Backend URL for frontend API calls |
-
----
-
-## Development Commands
-
-```bash
-# Run both frontend and backend
-npm run dev:full
-
-# Run frontend only
-npm run dev
-
-# Run backend only
-npm run server:dev
-
-# Build for production
-npm run build
-npm run server:build
-
-# Linting
-npm run lint
-```
-
----
-
-## Related Projects
-
-- **[Beads CLI](https://github.com/steveyegge/beads)** — Git-native issue tracker (the core tool this UI wraps)
-- **[Beads Orchestration](https://github.com/AvivK5498/Claude-Code-Beads-Orchestration)** — Multi-agent orchestration framework for Claude Code using beads
-
----
-
-## License
-
-MIT

package/.history/README_20260121193933.md

@@ -1,227 +0,0 @@
-# Beads Kanban UI
-
-**See all your tasks at a glance. Organize, and track progress across projects - no CLI required.**
-
-A beautiful visual Kanban board for the [Beads CLI](https://github.com/steveyegge/beads) task tracker. Beads stores tasks as git-native files (`.beads/issues.jsonl`), and this UI gives you the dashboard and board you've been missing.
-
-> **Works great with [Beads Orchestration](https://github.com/AvivK5498/Claude-Code-Beads-Orchestration)** — A multi-agent orchestration framework for Claude Code that uses beads for git-native task tracking..
-
-## See It in Action
-
-**Dashboard** — All your projects in one place with status at a glance:
-![Dashboard with multi-project view, status donuts, and tags](Screenshots/dashboard.png)
-
-**Kanban Board** — Organize tasks across Open → In Progress → In Review → Closed:
-![Kanban board showing epic groups and task cards with git branch info](Screenshots/kanban-board.png)
-
-**Bead Details** — Dive into any task with full context and subtasks:
-![Bead detail panel showing epic with progress bar and subtasks](Screenshots/bead-detail.png)
-
-## What You Get
-
-- **Multi-project dashboard** — Manage all your beads projects in one place with status donut charts
-- **Kanban board** — Drag-and-drop columns: Open → In Progress → In Review → Closed
-- **Epic support** — Group related tasks, track progress with bars, view all subtasks
-- **Real-time sync** — File watcher auto-updates when beads files change on disk
-- **Git integration** — See branch status for each task at a glance
-- **Search & filter** — Quick filters for status, priority, owner, and tags
-- **Project tagging** — Organize with colored tags and filter by them
-
-## Quick Start (3 steps)
-
-### 1. Prerequisites
-```bash
-# Install beads CLI
-brew install steveyegge/beads/bd
-
-# You'll also need Node.js 18+ and Rust
-```
-
-### 2. Install and Run
-```bash
-git clone https://github.com/AvivK5498/beads-kanban-ui
-cd beads-kanban-ui
-npm install
-npm run dev:full
-```
-
-### 3. Open in Browser
-Navigate to **`http://localhost:3007`** and add your beads projects.
-
-That's it! The app watches for file changes and syncs in real-time.
-
----
-
-## Detailed Setup
-
-### Development Mode
-
-Run both frontend and backend together:
-```bash
-npm run dev:full
-```
-
-Or run separately:
-```bash
-# Terminal 1: Frontend (http://localhost:3007)
-npm run dev
-
-# Terminal 2: Backend (http://localhost:3008)
-npm run server:dev
-```
-
-The Rust backend builds automatically on first run. If you need to rebuild it:
-```bash
-cd server && cargo build --release && cd ..
-```
-
-### Production Build
-
-For a single binary deployment:
-```bash
-npm run build
-npm run server:build
-./server/target/release/beads-server
-```
-
-The production server embeds the frontend and serves everything from a single binary on port 3008.
-
----
-
-## How It Works
-
-### Dashboard
-1. Click **+ Add Project** and select a directory with a `.beads/` folder
-2. See all projects with status donuts showing task distribution
-3. Click any project to view its Kanban board
-
-### Kanban Board
-1. Tasks are organized by status: Open, In Progress, In Review, Closed
-2. Drag cards between columns to update status
-3. Click any task to see full details, comments, and related subtasks (for epics)
-
-### Features in Detail
-
-**Search & Filter**
-- Quick filters for status, priority, and assigned owner
-- Project tags for organization
-
-**Real-time Sync**
-- The app watches `.beads/issues.jsonl` and updates automatically
-- No refresh needed—changes appear instantly
-
-**Git Integration**
-- Each task shows its git branch status
-- Useful for tracking which branch a task lives on
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    Beads Kanban UI                      │
-├─────────────────────────────────────────────────────────┤
-│  Frontend (Next.js 14)          │  Backend (Rust/Axum) │
-│  ─────────────────────          │  ────────────────────│
-│  • React 18                     │  • SQLite (projects) │
-│  • shadcn/ui components         │  • beads CLI bridge  │
-│  • Tailwind CSS                 │  • File watcher      │
-│  • TypeScript                   │  • Git integration   │
-└─────────────────────────────────────────────────────────┘
-                           │
-                           ▼
-              ┌─────────────────────────┐
-              │   .beads/ directory     │
-              │   (issues.jsonl, etc.)  │
-              └─────────────────────────┘
-```
-
-### Tech Stack
-- **Frontend**: Next.js 14, React 18, Tailwind CSS, shadcn/ui
-- **Backend**: Rust with Axum framework
-- **Database**: SQLite for project metadata
-- **File Sync**: Real-time watcher for `.beads/` changes
-
-### Project Structure
-```
-beads-kanban-ui/
-├── src/
-│   ├── app/                 # Next.js pages and routes
-│   │   ├── page.tsx         # Projects dashboard
-│   │   ├── project/         # Kanban board view
-│   │   └── settings/        # Settings page
-│   ├── components/          # React components
-│   │   ├── ui/              # shadcn/ui components
-│   │   ├── kanban-column.tsx
-│   │   ├── bead-card.tsx
-│   │   └── bead-detail.tsx
-│   ├── hooks/               # Custom React hooks
-│   ├── lib/                 # Utilities and API client
-│   └── types/               # TypeScript type definitions
-├── server/
-│   └── src/
-│       ├── main.rs          # Axum server entry point
-│       ├── db.rs            # SQLite database layer
-│       └── routes/          # API route handlers
-└── package.json
-```
-
----
-
-## API Endpoints
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/health` | GET | Server health check |
-| `/api/projects` | GET/POST | List or create projects |
-| `/api/projects/:id` | GET/PUT/DELETE | Manage individual projects |
-| `/api/beads?path=` | GET | Read beads from a project path |
-| `/api/beads/comment` | POST | Add comment to a bead |
-| `/api/bd/command` | POST | Execute beads CLI commands |
-| `/api/git/branch-status` | GET | Get git branch status for a bead |
-| `/api/fs/list` | GET | List directory contents |
-| `/api/fs/exists` | GET | Check if a path exists |
-| `/api/watch/beads` | GET | Server-sent events for file changes |
-
-### Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PORT` | `3008` | Backend server port |
-| `NEXT_PUBLIC_BACKEND_URL` | `http://localhost:3008` | Backend URL for frontend API calls |
-
----
-
-## Development Commands
-
-```bash
-# Run both frontend and backend
-npm run dev:full
-
-# Run frontend only
-npm run dev
-
-# Run backend only
-npm run server:dev
-
-# Build for production
-npm run build
-npm run server:build
-
-# Linting
-npm run lint
-```
-
----
-
-## Related Projects
-
-- **[Beads CLI](https://github.com/steveyegge/beads)** — Git-native issue tracker (the core tool this UI wraps)
-- **[Beads Orchestration](https://github.com/AvivK5498/Claude-Code-Beads-Orchestration)** — Multi-agent orchestration framework for Claude Code using beads
-
----
-
-## License
-
-MIT