{"id":"paseo-kanban","repo":"breathi3552/paseo-kanban","url":"https://github.com/breathi3552/paseo-kanban","package":"paseo-kanban","npm":{"package":"paseo-kanban","version":"0.1.1","integrity":"sha512-0xyEulDOlusyjj4m3l29CHj0bO/up4Uklp6sPFOQssUbByNYEtBLHnqLN3J9QTeOiISvsiLjJ22jX5vUeX8Upw==","publishedAt":"2026-09-19T14:43:28.066Z","downloadsLast30Days":262},"name":"paseo-kanban","description":"A lightweight, responsive Kanban board plugin for Paseo workspaces","categories":["productivity","orchestration"],"platforms":["windows"],"caveats":[],"images":[],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-20T16:11:52.885Z","addedAt":"2026-09-20T18:38:53+03:00","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-20T16:08:25.277Z","version":"0.1.1","integrity":"sha512-0xyEulDOlusyjj4m3l29CHj0bO/up4Uklp6sPFOQssUbByNYEtBLHnqLN3J9QTeOiISvsiLjJ22jX5vUeX8Upw=="},"version":"0.1.1","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-20T16:08:25.277Z","commit":"5344ece520d0d3a85342c8f86f3425d2474a31f2"},"author":"breathi3552","license":"MIT","paseoVersionRequirement":">=0.8.0","descriptionNodes":[{"type":"text","text":"A lightweight, responsive Kanban board plugin for Paseo workspaces"}],"caveatNodes":[],"manifest":{"id":"paseo-kanban","requirements":{"paseo":">=0.8.0"}},"repoMeta":{"stars":1,"defaultBranch":"main","pushedAt":"2026-09-19T14:45:09Z"},"owner":{"login":"breathi3552","avatarUrl":"https://avatars.githubusercontent.com/u/243264979?v=4"},"installNotesHtml":"

Quick Install (Recommended)

\n

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

\n

Via NPM (Release package):

\n
paseo plugin install npm:paseo-kanban\n
\n

Via GitHub:

\n
paseo plugin add breathi3552/paseo-kanban\n
\n

To explicitly track the latest updates on the main branch:

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

Verify that the plugin is running:

\n
paseo plugin ls\n
\n

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

\n

Local Development

\n

To contribute or debug locally:

\n
","readmeText":"# Paseo Kanban\n\n[简体中文](./README.zh-CN.md)\n\nA lightweight, responsive Kanban board plugin for [Paseo](https://paseo.sh) 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.\n\n---\n\n## Features\n\n- **Flexible Swimlanes**: Default lanes (`To Plan`, `In Progress`, `Done`) with full support for adding, renaming, and deleting custom lanes.\n- **Rich Task Cards**:\n - Task title and multi-line markdown description.\n - Subtasks checklist with completion toggles and live progress tracking.\n - Native Paseo project association.\n- **Project Filtering**: Instantly filter board cards by linked Paseo project to keep context focused.\n- **Smooth Drag-and-Drop**: Real-time hit-testing for reordering cards within lanes and moving cards across lanes.\n- **Versioned State Persistence**: Persists board data through Paseo's settings API with optimistic concurrency control (CAS) to prevent race conditions and accidental overwrites.\n\n---\n\n## Requirements\n\n- **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`.\n- **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`).\n\n---\n\n## Installation\n\n### Quick Install (Recommended)\n\nNo manual build or git cloning needed. You can install directly via npm or GitHub:\n\n**Via NPM (Release package):**\n\n```bash\npaseo plugin install npm:paseo-kanban\n```\n\n**Via GitHub:**\n\n```bash\npaseo plugin add breathi3552/paseo-kanban\n```\n\nTo explicitly track the latest updates on the `main` branch:\n\n```bash\npaseo plugin add breathi3552/paseo-kanban --ref main\n```\n\nVerify that the plugin is running:\n\n```bash\npaseo plugin ls\n```\n\nOnce active, open Paseo. The **Kanban** icon (`PanelsTopLeft`) will appear in the sidebar. Click it to launch the board.\n\n### Local Development\n\nTo contribute or debug locally:\n\n```bash\n# 1. Clone repository and install dependencies\ngit clone https://github.com/breathi3552/paseo-kanban.git\ncd paseo-kanban\nnpm install\n\n# 2. Link this directory into your local Paseo daemon\npaseo plugin link .\n```\n\n---\n\n## Development & Testing\n\n### Install Dependencies\n\n```bash\nnpm install\n# or clean install:\nnpm ci\n```\n\n### Unified Quality Guardrails (Check)\n\nRuns typecheck, automated test suites, linting, format verification, and release package checks in sequence:\n\n```bash\nnpm run check\n```\n\n### Individual Quality Tasks\n\n- **Package Verification**: Validates release package contents, entrypoints, and TypeScript AST relative imports:\n ```bash\n npm run check:package\n ```\n- **Run Tests**: Cross-platform auto-discovery of all `test/*.test.mjs` suites:\n ```bash\n npm test\n ```\n- **Type Checking**: Validates TypeScript types across client and server entry points:\n ```bash\n npm run typecheck\n ```\n- **Linting**: Static code analysis with ESLint:\n ```bash\n npm run lint\n ```\n- **Formatting**: Check or format code style with Prettier:\n ```bash\n npm run format:check\n npm run format\n ```\n\nFor comprehensive contribution guidelines, pre-publish package checks, and manual host acceptance steps, see the [Development & Acceptance Guide](./docs/development.md).\n\n---\n\n## Architecture & Design\n\nThe complete architectural breakdown and interactive visual diagram are archived in the repository:\n\n- **Interactive Architecture Viewer**: Open [`docs/architecture/paseo-kanban.architecture.html`](./docs/architecture/paseo-kanban.architecture.html) in your browser.\n- **Architecture Schema & Model**: [`docs/architecture/paseo-kanban.architecture.json`](./docs/architecture/paseo-kanban.architecture.json).\n\n---\n\n## License\n\nMIT\n"}