@andypai/agent-kanban 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 abpai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,306 @@
+# agent-kanban
+
+[![CI](https://github.com/abpai/agent-kanban/actions/workflows/ci.yml/badge.svg)](https://github.com/abpai/agent-kanban/actions/workflows/ci.yml)
+
+Agent-friendly kanban board CLI. Manage tasks via bash commands, parse structured JSON output.
+
+## Why
+
+Most project-management tools are built for humans clicking through UIs. `agent-kanban` is built for **CLI-first workflows** — AI agents and scripts get deterministic JSON they can parse, humans get a pretty-printed view and a web dashboard. Runs against a local SQLite file or a Linear backend.
+
+## Documentation
+
+- [`docs/README.md`](docs/README.md) for the documentation index
+- [`docs/WORKFLOW.md`](docs/WORKFLOW.md) for a common day-to-day workflow
+- [`docs/providers/linear.md`](docs/providers/linear.md) for Linear provider details
+- [`SKILL.md`](SKILL.md) for agent-specific repo usage instructions
+
+## Install
+
+```bash
+bun install -g @andypai/agent-kanban
+```
+
+`agent-kanban` targets the Bun runtime. Install Bun first if it is not already available on your machine.
+
+### Local development
+
+```bash
+git clone https://github.com/abpai/agent-kanban.git
+cd agent-kanban
+bun install
+cd ui && bun install && cd ..
+bun link
+```
+
+`bun link` makes `kanban` available globally while you work on the source checkout.
+
+## Getting started
+
+```bash
+kanban board init
+kanban task add "Set up CI pipeline" -p high -a alice
+kanban task add "Write integration tests" -c backlog
+kanban board view --pretty
+```
+
+Running `kanban` with no arguments is equivalent to `kanban board view`.
+
+## Providers
+
+All operations route through a provider backend. Set `KANBAN_PROVIDER` to choose one.
+
+| Variable          | Default       | Description                            |
+| ----------------- | ------------- | -------------------------------------- |
+| `KANBAN_PROVIDER` | `local`       | `local` or `linear`                    |
+| `KANBAN_DB_PATH`  | auto-resolved | SQLite database path                   |
+| `LINEAR_API_KEY`  | —             | Required when `KANBAN_PROVIDER=linear` |
+| `LINEAR_TEAM_ID`  | —             | Required when `KANBAN_PROVIDER=linear` |
+
+Without `KANBAN_DB_PATH`, the local provider resolves the database in this order:
+
+1. `./.kanban/board.db` if it exists in the current working directory
+2. `~/.kanban/board.db` if it exists
+3. `./.kanban/board.db` as the path to create
+
+### Linear quick start
+
+```bash
+export KANBAN_PROVIDER=linear
+export LINEAR_API_KEY=lin_api_...
+export LINEAR_TEAM_ID=<team-id>
+kanban board view
+```
+
+### Capability matrix
+
+| Capability              | Local | Linear |
+| ----------------------- | ----- | ------ |
+| task create/update/move | yes   | yes    |
+| task delete             | yes   | no     |
+| activity log            | yes   | no     |
+| metrics                 | yes   | no     |
+| column CRUD             | yes   | no     |
+| bulk operations         | yes   | no     |
+| config edit             | yes   | no     |
+
+Linear tasks carry an `externalRef` (e.g. `TEAM-123`) and a `url`. Commands accept either the internal ID or the external ref.
+
+Unsupported operations return error code `UNSUPPORTED_OPERATION` with exit code 1.
+
+## Commands
+
+### board
+
+| Command              | Description                                        |
+| -------------------- | -------------------------------------------------- |
+| `kanban board init`  | Initialize a new board with default columns        |
+| `kanban board view`  | View the full board (default command)              |
+| `kanban board reset` | Reset board — drops all data and restores defaults |
+
+Default columns: `recurring`, `backlog`, `in-progress`, `review`, `done`.
+
+### task
+
+| Command                               | Description                                      |
+| ------------------------------------- | ------------------------------------------------ |
+| `kanban task add <title>`             | Add a task                                       |
+| `kanban task list`                    | List tasks                                       |
+| `kanban task view <id>`               | View task details                                |
+| `kanban task update <id>`             | Update task fields                               |
+| `kanban task delete <id>`             | Delete a task                                    |
+| `kanban task move <id> <column>`      | Move task to a column                            |
+| `kanban task assign <id> <user>`      | Assign task to a user                            |
+| `kanban task prioritize <id> <level>` | Set priority (`low`, `medium`, `high`, `urgent`) |
+
+**Flags for `task add`:**
+
+| Flag               | Description                                                     |
+| ------------------ | --------------------------------------------------------------- |
+| `-d <text>`        | Description                                                     |
+| `-c <column>`      | Target column (default: `backlog`)                              |
+| `-p <level>`       | Priority: `low`, `medium`, `high`, `urgent` (default: `medium`) |
+| `-a <user>`        | Assignee                                                        |
+| `--project <name>` | Project tag                                                     |
+| `-m <json>`        | Arbitrary metadata (must be valid JSON)                         |
+
+**Flags for `task list`:**
+
+| Flag               | Description                                                    |
+| ------------------ | -------------------------------------------------------------- |
+| `-c <column>`      | Filter by column                                               |
+| `-p <level>`       | Filter by priority                                             |
+| `-a <user>`        | Filter by assignee                                             |
+| `--project <name>` | Filter by project                                              |
+| `-l <n>`           | Limit results                                                  |
+| `--sort <field>`   | Sort by: `priority`, `created`, `updated`, `position`, `title` |
+
+**Flags for `task update`:**
+
+| Flag               | Description     |
+| ------------------ | --------------- |
+| `--title <text>`   | New title       |
+| `-d <text>`        | New description |
+| `-p <level>`       | New priority    |
+| `-a <user>`        | New assignee    |
+| `--project <name>` | New project     |
+| `-m <json>`        | New metadata    |
+
+### column
+
+| Command                                       | Description             |
+| --------------------------------------------- | ----------------------- |
+| `kanban column add <name>`                    | Add a column            |
+| `kanban column list`                          | List all columns        |
+| `kanban column rename <id\|name> <new-name>`  | Rename a column         |
+| `kanban column reorder <id\|name> <position>` | Move column to position |
+| `kanban column delete <id\|name>`             | Delete an empty column  |
+
+**Flags for `column add`:**
+
+| Flag             | Description                    |
+| ---------------- | ------------------------------ |
+| `--position <n>` | Insert at position (0-indexed) |
+| `--color <hex>`  | Column color                   |
+
+### bulk
+
+| Command                            | Description                               |
+| ---------------------------------- | ----------------------------------------- |
+| `kanban bulk move-all <from> <to>` | Move all tasks from one column to another |
+| `kanban bulk clear-done`           | Delete all tasks in the `done` column     |
+
+### config
+
+| Command                               | Description                 |
+| ------------------------------------- | --------------------------- |
+| `kanban config show`                  | Show board config (default) |
+| `kanban config set-member <name>`     | Add or update a team member |
+| `kanban config remove-member <name>`  | Remove a team member        |
+| `kanban config add-project <name>`    | Register a project          |
+| `kanban config remove-project <name>` | Remove a project            |
+
+**Flags for `config set-member`:**
+
+| Flag                    | Description                    |
+| ----------------------- | ------------------------------ |
+| `--role <human\|agent>` | Member role (default: `human`) |
+
+### serve
+
+```bash
+kanban serve            # default port 3000
+kanban serve --port 8080
+```
+
+## Global flags
+
+| Flag               | Description                                                                                      |
+| ------------------ | ------------------------------------------------------------------------------------------------ |
+| `--pretty`         | Human-readable output instead of JSON                                                            |
+| `--db <path>`      | Database path (default: local first, then `~/.kanban`, else create local; env: `KANBAN_DB_PATH`) |
+| `--project <name>` | Filter or set project context                                                                    |
+| `-h`, `--help`     | Show help text                                                                                   |
+
+## Output format
+
+Every command returns a JSON envelope on stdout:
+
+```json
+{ "ok": true, "data": { ... } }
+```
+
+```json
+{ "ok": false, "error": { "code": "TASK_NOT_FOUND", "message": "No task with id 't_abc123'" } }
+```
+
+Exit codes: `0` success, `1` known error, `2` internal error.
+
+Pass `--pretty` for human-readable output — board view, task lists, and details are formatted for the terminal.
+
+## Web dashboard
+
+```bash
+kanban serve
+```
+
+In Linear mode the dashboard hides unsupported actions and shows Linear issue identifiers and links on task cards.
+
+Starts a Bun HTTP server with:
+
+- **REST API** at `/api/*` — same operations as the CLI (board, tasks, columns, activity, metrics, config)
+- **WebSocket** at `/ws` — push notifications on board mutations (clients receive `{"type":"refresh"}`)
+- **Static UI** served from `ui/dist/` (build with `bun run build:ui` or `bun run ui:build`)
+- **Health check** at `/api/health`
+
+## Scripts
+
+| Script               | Description            |
+| -------------------- | ---------------------- |
+| `bun run dev`        | Run with watch mode    |
+| `bun run start`      | Run once               |
+| `bun run build`      | Bundle to `dist/`      |
+| `bun run lint`       | ESLint                 |
+| `bun run format`     | Prettier write         |
+| `bun run typecheck`  | `tsc --noEmit`         |
+| `bun run check`      | Lint + typecheck       |
+| `bun run test`       | Bun test runner        |
+| `bun run test:watch` | Tests in watch mode    |
+| `bun run serve`      | Start web dashboard    |
+| `bun run ui:dev`     | UI dev server          |
+| `bun run dev:ui`     | API + UI dev servers   |
+| `bun run ui:build`   | Build UI to `ui/dist/` |
+| `bun run build:ui`   | Alias for `ui:build`   |
+
+## Deployment
+
+Build the Docker image:
+
+```bash
+docker build -t agent-kanban .
+```
+
+The same image works for both provider modes — only runtime env/volume config differs.
+
+### Local mode (SQLite)
+
+Mount a volume for the database directory. WAL mode creates `-wal` and `-shm` sibling files, so the volume must cover the directory, not just the `.db` file.
+
+```bash
+docker run -d \
+  -p 3000:3000 \
+  -v kanban-data:/data \
+  -e KANBAN_DB_PATH=/data/board.db \
+  agent-kanban
+```
+
+### Linear mode
+
+No volume needed — all state lives in Linear.
+
+```bash
+docker run -d \
+  -p 3000:3000 \
+  -e KANBAN_PROVIDER=linear \
+  -e LINEAR_API_KEY=lin_api_... \
+  -e LINEAR_TEAM_ID=team-id \
+  agent-kanban
+```
+
+### Dokploy
+
+Set the port via `PORT` env var (defaults to `3000`). Port resolution order: `--port` flag → `PORT` env → `3000`. Add provider env vars through Dokploy's environment configuration.
+
+## Community
+
+If you want to contribute or report an issue, start with these guides:
+
+- [CONTRIBUTING.md](CONTRIBUTING.md)
+- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+- [SECURITY.md](SECURITY.md)
+
+Longer product and workflow docs live under [`docs/`](docs/README.md).
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@andypai/agent-kanban",
+  "version": "0.1.0",
+  "description": "Agent-friendly kanban board CLI. Manage tasks via bash commands, parse structured JSON output.",
+  "homepage": "https://github.com/abpai/agent-kanban#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abpai/agent-kanban.git"
+  },
+  "bugs": {
+    "url": "https://github.com/abpai/agent-kanban/issues"
+  },
+  "keywords": [
+    "agent",
+    "kanban",
+    "cli",
+    "bun",
+    "sqlite",
+    "linear",
+    "automation"
+  ],
+  "bin": {
+    "kanban": "src/index.ts"
+  },
+  "type": "module",
+  "main": "src/index.ts",
+  "module": "src/index.ts",
+  "files": [
+    "src",
+    "ui/dist"
+  ],
+  "engines": {
+    "bun": ">=1.1.0"
+  },
+  "packageManager": "bun@1.3.3",
+  "license": "MIT",
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "start": "bun src/index.ts",
+    "build": "bun build ./src/index.ts --target bun --outdir ./dist",
+    "link": "bun link",
+    "lint": "bunx eslint .",
+    "format": "bunx prettier --write .",
+    "typecheck": "bunx tsc --noEmit",
+    "check": "bun run lint && bun run typecheck",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "seed:test": "bun --env-file=.env.test scripts/seed-test-db.ts",
+    "serve": "bun src/index.ts serve",
+    "ui:dev": "cd ui && bun run dev",
+    "ui:build": "cd ui && bun run build",
+    "dev:ui": "bun scripts/dev.ts",
+    "build:ui": "bun run ui:build",
+    "prepare": "if [ \"${HUSKY:-1}\" != \"0\" ] && command -v husky >/dev/null 2>&1; then husky install; fi",
+    "prepack": "cd ui && bun install --frozen-lockfile && bun run build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "@types/bun": "^1.1.22",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^8.0.3",
+    "lint-staged": "^15.2.0",
+    "prettier": "^3.7.4",
+    "typescript": "^5.7.2"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{css,html,json,md,scss,yaml,yml}": [
+      "prettier --write"
+    ]
+  }
+}

package/src/__tests__/activity.test.ts

@@ -0,0 +1,139 @@
+import { describe, expect, test, beforeEach } from 'bun:test'
+import { Database } from 'bun:sqlite'
+import {
+  initSchema,
+  seedDefaultColumns,
+  addTask,
+  updateTask,
+  deleteTask,
+  moveTask,
+  bulkMoveAll,
+  bulkClearDone,
+} from '../db.ts'
+import { listActivity, getTaskActivity, getColumnTimeEntries } from '../activity.ts'
+
+let db: Database
+
+beforeEach(() => {
+  db = new Database(':memory:')
+  db.run('PRAGMA foreign_keys = ON')
+  initSchema(db)
+  seedDefaultColumns(db)
+})
+
+describe('activity logging', () => {
+  test('addTask logs created activity', () => {
+    const task = addTask(db, 'Test task')
+    const activities = getTaskActivity(db, task.id)
+    expect(activities).toHaveLength(1)
+    expect(activities[0]!.action).toBe('created')
+    expect(activities[0]!.new_value).toBe('Test task')
+  })
+
+  test('updateTask logs field changes', () => {
+    const task = addTask(db, 'Original')
+    updateTask(db, task.id, { title: 'Updated', priority: 'high' })
+    const activities = getTaskActivity(db, task.id)
+    const actions = activities.map((a) => a.action)
+    expect(actions).toContain('updated')
+    expect(actions).toContain('prioritized')
+  })
+
+  test('updateTask logs assignee change as assigned', () => {
+    const task = addTask(db, 'Task')
+    updateTask(db, task.id, { assignee: 'alice' })
+    const activities = getTaskActivity(db, task.id)
+    const assigned = activities.find((a) => a.action === 'assigned')
+    expect(assigned).toBeDefined()
+    expect(assigned!.new_value).toBe('alice')
+  })
+
+  test('updateTask does not log when value unchanged', () => {
+    const task = addTask(db, 'Task', { priority: 'high' })
+    updateTask(db, task.id, { priority: 'high' })
+    const activities = getTaskActivity(db, task.id)
+    expect(activities.filter((a) => a.action === 'prioritized')).toHaveLength(0)
+  })
+
+  test('deleteTask logs deleted activity', () => {
+    const task = addTask(db, 'Doomed')
+    const taskId = task.id
+    deleteTask(db, taskId)
+    const activities = listActivity(db)
+    const deleted = activities.find((a) => a.task_id === taskId && a.action === 'deleted')
+    expect(deleted).toBeDefined()
+    expect(deleted!.old_value).toBe('Doomed')
+  })
+
+  test('moveTask logs moved activity', () => {
+    const task = addTask(db, 'Mobile', { column: 'recurring' })
+    moveTask(db, task.id, 'in-progress')
+    const activities = getTaskActivity(db, task.id)
+    const moved = activities.find((a) => a.action === 'moved')
+    expect(moved).toBeDefined()
+    expect(moved!.old_value).toBe('recurring')
+    expect(moved!.new_value).toBe('in-progress')
+  })
+
+  test('bulkMoveAll logs moved activity for each task', () => {
+    addTask(db, 'A', { column: 'recurring' })
+    addTask(db, 'B', { column: 'recurring' })
+    bulkMoveAll(db, 'recurring', 'in-progress')
+    const activities = listActivity(db)
+    const moves = activities.filter((a) => a.action === 'moved')
+    expect(moves).toHaveLength(2)
+  })
+
+  test('bulkClearDone logs deleted activity for each task', () => {
+    addTask(db, 'Done A', { column: 'done' })
+    addTask(db, 'Done B', { column: 'done' })
+    bulkClearDone(db)
+    const activities = listActivity(db)
+    const deletes = activities.filter((a) => a.action === 'deleted')
+    expect(deletes).toHaveLength(2)
+  })
+
+  test('listActivity returns most recent first', () => {
+    const task = addTask(db, 'Task')
+    updateTask(db, task.id, { title: 'Updated' })
+    const activities = getTaskActivity(db, task.id)
+    expect(activities[0]!.action).toBe('updated')
+    expect(activities[1]!.action).toBe('created')
+  })
+
+  test('listActivity respects limit', () => {
+    const task = addTask(db, 'Task')
+    updateTask(db, task.id, { title: 'V2' })
+    updateTask(db, task.id, { title: 'V3' })
+    const activities = listActivity(db, { limit: 2 })
+    expect(activities).toHaveLength(2)
+  })
+})
+
+describe('column time tracking', () => {
+  test('addTask creates enter record', () => {
+    const task = addTask(db, 'Task', { column: 'recurring' })
+    const entries = getColumnTimeEntries(db, task.id)
+    expect(entries).toHaveLength(1)
+    expect(entries[0]!.exited_at).toBeNull()
+  })
+
+  test('moveTask creates exit and enter records', () => {
+    const task = addTask(db, 'Task', { column: 'recurring' })
+    moveTask(db, task.id, 'in-progress')
+    const entries = getColumnTimeEntries(db, task.id)
+    expect(entries).toHaveLength(2)
+    expect(entries[0]!.exited_at).not.toBeNull()
+    expect(entries[1]!.exited_at).toBeNull()
+  })
+
+  test('deleteTask closes open time entry', () => {
+    const task = addTask(db, 'Task', { column: 'recurring' })
+    const taskId = task.id
+    deleteTask(db, taskId)
+    const entries = db
+      .query('SELECT * FROM column_time_tracking WHERE task_id = $id')
+      .all({ $id: taskId }) as { exited_at: string | null }[]
+    expect(entries[0]!.exited_at).not.toBeNull()
+  })
+})

package/src/__tests__/api.test.ts

@@ -0,0 +1,74 @@
+import { beforeEach, describe, expect, test } from 'bun:test'
+import { Database } from 'bun:sqlite'
+import { initSchema, seedDefaultColumns, addTask } from '../db.ts'
+import { handleRequest } from '../api.ts'
+import { createProvider } from '../providers/index.ts'
+
+let db: Database
+let provider: ReturnType<typeof createProvider>
+
+beforeEach(() => {
+  process.env['KANBAN_PROVIDER'] = 'local'
+  db = new Database(':memory:')
+  db.run('PRAGMA foreign_keys = ON')
+  initSchema(db)
+  seedDefaultColumns(db)
+  provider = createProvider(db, ':memory:')
+})
+
+describe('handleRequest', () => {
+  test('returns API 404 envelope for unknown route', async () => {
+    const req = new Request('http://localhost/api/not-a-route', { method: 'GET' })
+    const result = await handleRequest(provider, req)
+
+    expect(result.mutated).toBe(false)
+    expect(result.response.status).toBe(404)
+  })
+
+  test('marks failed PATCH mutation as not mutated', async () => {
+    const req = new Request('http://localhost/api/tasks/t_missing', {
+      method: 'PATCH',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ title: 'Nope' }),
+    })
+    const result = await handleRequest(provider, req)
+
+    expect(result.response.status).toBe(404)
+    expect(result.mutated).toBe(false)
+  })
+
+  test('marks successful task creation as mutated', async () => {
+    const req = new Request('http://localhost/api/tasks', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ title: 'Created via API' }),
+    })
+    const result = await handleRequest(provider, req)
+
+    expect(result.response.status).toBe(200)
+    expect(result.mutated).toBe(true)
+  })
+
+  test('marks successful task delete as mutated', async () => {
+    const task = addTask(db, 'Delete me')
+    const req = new Request(`http://localhost/api/tasks/${task.id}`, { method: 'DELETE' })
+    const result = await handleRequest(provider, req)
+
+    expect(result.response.status).toBe(200)
+    expect(result.mutated).toBe(true)
+  })
+
+  test('returns bootstrap payload', async () => {
+    const req = new Request('http://localhost/api/bootstrap', { method: 'GET' })
+    const result = await handleRequest(provider, req)
+    const body = (await result.response.json()) as {
+      ok: boolean
+      data: { provider: string; capabilities: { taskDelete: boolean } }
+    }
+
+    expect(result.response.status).toBe(200)
+    expect(body.ok).toBe(true)
+    expect(body.data.provider).toBe('local')
+    expect(body.data.capabilities.taskDelete).toBe(true)
+  })
+})

package/src/__tests__/commands/board.test.ts

@@ -0,0 +1,51 @@
+import { describe, expect, test, beforeEach } from 'bun:test'
+import { Database } from 'bun:sqlite'
+import { initSchema, seedDefaultColumns } from '../../db.ts'
+import { boardInit, boardView, boardReset } from '../../commands/board.ts'
+import { KanbanError } from '../../errors.ts'
+
+let db: Database
+
+beforeEach(() => {
+  db = new Database(':memory:')
+  db.run('PRAGMA foreign_keys = ON')
+})
+
+describe('boardInit', () => {
+  test('initializes a fresh database', () => {
+    const result = boardInit(db)
+    expect(result.ok).toBe(true)
+  })
+
+  test('throws if already initialized', () => {
+    initSchema(db)
+    seedDefaultColumns(db)
+    expect(() => boardInit(db)).toThrow(KanbanError)
+  })
+})
+
+describe('boardView', () => {
+  test('returns board view after init', () => {
+    initSchema(db)
+    seedDefaultColumns(db)
+    const result = boardView(db)
+    expect(result.ok).toBe(true)
+    if (result.ok) {
+      const data = result.data as { columns: unknown[] }
+      expect(data.columns).toHaveLength(5)
+    }
+  })
+
+  test('throws if not initialized', () => {
+    expect(() => boardView(db)).toThrow(KanbanError)
+  })
+})
+
+describe('boardReset', () => {
+  test('resets board to defaults', () => {
+    initSchema(db)
+    seedDefaultColumns(db)
+    const result = boardReset(db)
+    expect(result.ok).toBe(true)
+  })
+})