Paseo Kanban

A lightweight, responsive Kanban board plugin for Paseo workspaces. Organize tasks across customizable swimlanes, break them down into subtasks, associate cards with native Paseo projects, and manage workflow status with intuitive drag-and-drop.

Features

Flexible Swimlanes: Default lanes (To Plan, In Progress, Done) with full support for adding, renaming, and deleting custom lanes.
Rich Task Cards:
- Task title and multi-line markdown description.
- Subtasks checklist with completion toggles and live progress tracking.
- Native Paseo project association.
Project Filtering: Instantly filter board cards by linked Paseo project to keep context focused.
Smooth Drag-and-Drop: Real-time hit-testing for reordering cards within lanes and moving cards across lanes.
Versioned State Persistence: Persists board data through Paseo's settings API with optimistic concurrency control (CAS) to prevent race conditions and accidental overwrites.

Requirements

Paseo Host Runtime Commitment: >= 0.8.0 (declared in paseo-plugin.json). As a Paseo workspace plugin, production runtime execution is managed and hosted by the Paseo application environment. No consumer-side Node version restriction is imposed in package.json.
Development & CI Baseline: Node.js 24 (pinned in .nvmrc and .node-version). Node 24 is required for local contributors and CI automation workflows running quality checks (npm run check), type stripping (--experimental-strip-types), and native test suites (node --test).

Installation

Quick Install (Recommended)

No manual build or git cloning needed. You can install directly via npm or GitHub:

Via NPM (Release package):

paseo plugin install npm:paseo-kanban

Via GitHub:

paseo plugin add breathi3552/paseo-kanban

To explicitly track the latest updates on the main branch:

paseo plugin add breathi3552/paseo-kanban --ref main

Verify that the plugin is running:

paseo plugin ls

Once active, open Paseo. The Kanban icon (PanelsTopLeft) will appear in the sidebar. Click it to launch the board.

Local Development

To contribute or debug locally:

# 1. Clone repository and install dependencies
git clone https://github.com/breathi3552/paseo-kanban.git
cd paseo-kanban
npm install

# 2. Link this directory into your local Paseo daemon
paseo plugin link .

Development & Testing

Install Dependencies

npm install
# or clean install:
npm ci

Unified Quality Guardrails (Check)

Runs typecheck, automated test suites, linting, format verification, and release package checks in sequence:

npm run check

Individual Quality Tasks

Package Verification: Validates release package contents, entrypoints, and TypeScript AST relative imports:
```
npm run check:package
```
Run Tests: Cross-platform auto-discovery of all test/*.test.mjs suites:
```
npm test
```
Type Checking: Validates TypeScript types across client and server entry points:
```
npm run typecheck
```
Linting: Static code analysis with ESLint:
```
npm run lint
```
Formatting: Check or format code style with Prettier:
```
npm run format:check
npm run format
```

For comprehensive contribution guidelines, pre-publish package checks, and manual host acceptance steps, see the Development & Acceptance Guide.

Architecture & Design

The complete architectural breakdown and interactive visual diagram are archived in the repository:

Interactive Architecture Viewer: Open docs/architecture/paseo-kanban.architecture.html in your browser.
Architecture Schema & Model: docs/architecture/paseo-kanban.architecture.json.

License

MIT